Skip to main content
Las variables de entorno pueden controlar el comportamiento de Claude Code, como la selección de modelo, autenticación, enrutamiento de solicitudes y alternadores de características. Muchos de los mismos comportamientos también se pueden configurar a través de un archivo de configuración, una bandera CLI o un comando en sesión como /model. Esta página cubre cómo:

Establecer variables de entorno

Una variable que establezca en su shell dura para esa sesión de terminal, mientras que una variable en un archivo de configuración se aplica cada vez que se ejecuta claude.

En su shell

Establezca la variable antes de lanzar claude:
Para establecerlo para cada sesión, agregue la línea export a ~/.bashrc, ~/.zshrc o el archivo de perfil de su shell.

En archivos de configuración

Agregue variables bajo la clave env en un archivo settings.json. Claude Code las lee directamente del archivo al inicio, por lo que surten efecto sin importar cómo se lanzó claude.
~/.claude/settings.json
El archivo que elija controla a quién se aplican las variables: Consulte Archivos de configuración para saber dónde vive cada archivo y Precedencia de configuración para saber cómo se combinan cuando más de uno establece la misma variable.

Precedencia

Cuando el mismo comportamiento tiene tanto una variable de entorno como un campo de configuración, la variable de entorno tiene precedencia. Por ejemplo, ANTHROPIC_MODEL anula la configuración model, y CLAUDE_CODE_AUTO_CONNECT_IDE anula autoConnectIde. El campo de configuración se aplica cuando la variable de entorno no está establecida. Cuando la misma variable se establece tanto en su shell como en un archivo de configuración bloque env, se aplica el valor del archivo de configuración. Claude Code escribe cada entrada env en el entorno del proceso al inicio, reemplazando el valor heredado del shell. Algunas variables tienen casos especiales; la configuración env enumera las excepciones. Entre archivos de configuración, los valores env siguen la precedencia de configuración, por lo que una entrada de configuración administrada anula la misma variable en la configuración de usuario o proyecto. Cómo una variable de entorno interactúa con banderas CLI y comandos en sesión varía por característica: --model y /model anulan ANTHROPIC_MODEL, mientras que CLAUDE_CODE_EFFORT_LEVEL anula /effort. Cuando una variable interactúa con otra fuente de configuración, su fila en la lista Variables indica la precedencia o vincula a la página que la documenta. Claude Code lee variables de entorno al inicio, por lo que los cambios surten efecto la próxima vez que lance claude.

Variables

También se admiten variables estándar de exportador de OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES y variantes específicas de señal). Consulte Monitoreo para detalles de configuración.

Véase también