Variables de entorno

Referencia para variables de entorno que controlan el comportamiento de Claude Code.

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 campo de 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 en su shell o en un archivo de configuración
Verificar qué valor se aplica cuando un comportamiento se puede establecer de más de una manera
Buscar las variables que Claude Code lee
Ver qué características dejan de funcionar cuando una variable desactiva la obtención de marcas de características

Establecer variables de entorno

Una variable que establezca en su shell dura durante 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:

export API_TIMEOUT_MS="1200000"
claude

Para establecerla para cada sesión, agregue la línea export a ~/.bashrc, ~/.zshrc, o el archivo de perfil de su shell.

$env:API_TIMEOUT_MS = "1200000"
claude

Para establecerla para cada sesión, ejecute [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") y abra una nueva terminal.

set API_TIMEOUT_MS=1200000
claude

Para establecerla para cada sesión, ejecute setx API_TIMEOUT_MS "1200000" y abra una nueva terminal.

La línea de asignación no imprime nada en caso de éxito, así que confirme que la variable está establecida imprimiéndola en el mismo shell antes de ejecutar claude:

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

En archivos de configuración

Agregue variables bajo la clave env en un archivo settings.json, creando el archivo si no existe. Claude Code las lee directamente del archivo, por lo que surten efecto sin importar cómo se haya lanzado claude. Una sesión en ejecución aplica valores nuevos y modificados a su entorno cuando guarda el archivo, pero una característica que lee sus variables una sola vez al inicio, como monitoreo de OpenTelemetry, mantiene sus valores de inicio hasta que relance. Eliminar una variable del archivo no la desestablece en una sesión en ejecución; la eliminación surte efecto la próxima vez que lance claude.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

El archivo que elija controla a quién se aplican las variables:

Archivo	Se aplica a
`~/.claude/settings.json`	Usted, en cada proyecto
`.claude/settings.json`	Todos los que trabajan en el proyecto, registrado en el control de fuente
`.claude/settings.local.json`	Usted, solo en este proyecto, ignorado por git cuando Claude Code guarda una configuración en él; agréguelo a su gitignore si lo crea manualmente
Configuración administrada	Todos en su organización, implementado por un administrador

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

Algunos comportamientos tienen tanto una variable de entorno como una clave de configuración dedicada, y cuál lee primero Claude Code difiere según la clave. Para ANTHROPIC_MODEL y CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code lee primero la variable y utiliza la configuración model o autoConnectIde solo cuando la variable no está establecida. Para el par que está configurando, verifique la fila de la variable a continuación y la entrada de la clave en la referencia de configuración.

Cuando la misma variable se establece tanto en su shell como en un bloque env de archivo de configuración, se aplica el valor del archivo de configuración. Claude Code escribe cada entrada env en el entorno del proceso, reemplazando el valor heredado del shell. La configuración env indica cuándo se aplica. Algunas variables tienen casos especiales; la configuración env enumera las excepciones.

En un archivo de configuración puede establecer una variable pero no puede eliminar una. Para anular una variable que no puede desestablecer, como una CLAUDE_CODE_USE_VERTEX obsoleta exportada por un perfil de shell que no controla, establézcala en una cadena vacía en el bloque env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code trata el valor vacío como no establecido para la selección de proveedor. Los subprocesos aún heredan el valor vacío.

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 según la característica: --model y /model anulan ANTHROPIC_MODEL, mientras que CLAUDE_CODE_EFFORT_LEVEL anula --effort y /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 las variables de entorno del shell al iniciar, por lo que los cambios en ellas surten efecto la próxima vez que inicia claude. Las variables establecidas bajo la clave env en archivos de configuración se reaplicarán a una sesión en ejecución cuando el archivo cambie, con la excepción de solo inicio descrita en En archivos de configuración.

Variables

Las variables numéricas como tiempos de espera, presupuestos de tokens y conteos de reintentos aceptan notación científica y deletreos con separadores de dígitos además de dígitos simples, excepto donde la fila de una variable indica que solo acepta dígitos simples. Por ejemplo, Claude Code lee 2e3 como 2000 y 64_000 como 64000. Antes de v2.1.211, estos deletreos podían establecer silenciosamente un valor mucho más pequeño, como 1e6 estableciendo un tiempo de espera a 1.

Variable	Propósito
`ANTHROPIC_API_KEY`	Clave de API enviada como encabezado `X-Api-Key`. Cuando se establece, esta clave se usa en lugar de su suscripción a Claude Pro, Max, Team o Enterprise incluso si ha iniciado sesión. En modo no interactivo (`-p`), la clave siempre se usa cuando está presente. En modo interactivo, se le solicita que apruebe la clave una vez antes de que anule su suscripción. Para usar su suscripción en su lugar, ejecute `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valor personalizado para el encabezado `Authorization` (el valor que establezca aquí tendrá el prefijo `Bearer` )
`ANTHROPIC_AWS_API_KEY`	Clave de API del espacio de trabajo para Claude Platform on AWS, generada en la Consola de AWS. Se envía como `x-api-key` y tiene precedencia sobre AWS SigV4
`ANTHROPIC_AWS_BASE_URL`	Anule la URL del punto de conexión de Claude Platform on AWS. Use para regiones personalizadas o cuando enrute a través de una puerta de enlace LLM. El valor predeterminado es `https://aws-external-anthropic.{region}.api.aws`. Claude Code resuelve la región con la misma precedencia que en Amazon Bedrock
`ANTHROPIC_AWS_WORKSPACE_ID`	Requerido para Claude Platform on AWS. Se envía en cada solicitud como el encabezado `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Anule el punto de conexión de la API para enrutar solicitudes a través de un proxy o puerta de enlace. Cuando se establece en un host que no es de primera parte, la búsqueda de herramientas MCP está deshabilitada de forma predeterminada. Establezca `ENABLE_TOOL_SEARCH=true` si su proxy reenvía bloques `tool_reference`. A partir de v2.1.196, Remote Control está deshabilitado cuando esto apunta a un host que no sea `api.anthropic.com`, coincidiendo con su comportamiento en Amazon Bedrock, Google Cloud's Agent Platform y Microsoft Foundry
`ANTHROPIC_BEDROCK_BASE_URL`	Anule la URL del punto de conexión de Amazon Bedrock. Use para puntos de conexión personalizados de Amazon Bedrock o cuando enrute a través de una puerta de enlace LLM. Vea Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Anule la URL del punto de conexión de Amazon Bedrock Mantle. Vea Punto de conexión Mantle
`ANTHROPIC_BEDROCK_REGION_PREFIX`	Prefijo del perfil de inferencia entre regiones (`us`, `eu`, `apac`, `jp`, `au`, o `global`) que Claude Code intenta primero en lugar del derivado de la región de AWS. Se ignora en regiones de AWS GovCloud. Requiere Claude Code v2.1.224 o posterior. Vea Amazon Bedrock
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Nivel de servicio de Amazon Bedrock (`default`, `flex`, o `priority`). Se envía como el encabezado `X-Amzn-Bedrock-Service-Tier`. Vea Amazon Bedrock
`ANTHROPIC_BETAS`	Lista separada por comas de valores de encabezado `anthropic-beta` adicionales para incluir en solicitudes de API. Claude Code ya envía los encabezados beta que necesita; use esto para optar por una versión beta de la API de Anthropic antes de que Claude Code agregue soporte nativo. A diferencia de la bandera `--betas`, que requiere autenticación de clave de API, esta variable funciona con todos los métodos de autenticación, incluida la suscripción a Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	Encabezados personalizados para agregar a solicitudes (formato `Name: Value`, separados por saltos de línea para múltiples encabezados). Si un nombre o valor contiene un carácter que un encabezado HTTP no puede llevar, como una comilla curva o un espacio de ancho cero, la solicitud falla con un error que identifica el par por posición. Requiere Claude Code v2.1.227 o posterior. Valor de encabezado de solicitud inválido enumera el conjunto de caracteres exacto y dónde se ejecuta la verificación. Un valor que establece un encabezado de credencial, organización o inquilino, enrutamiento o comportamiento de API, como `Authorization` o `Host`, cuenta como una configuración que necesita aprobación cuando la configuración administrada por servidor la entrega. Desde la configuración de proyecto o local, tal valor sigue las reglas para cuándo se aplican los valores `env`
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID de modelo para agregar como entrada personalizada en el selector `/model`. Use esto para hacer que un modelo no estándar o específico de puerta de enlace sea seleccionable sin reemplazar alias integrados. Vea Configuración de modelo
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Descripción de visualización para la entrada de modelo personalizado en el selector `/model`. El valor predeterminado es `Custom model (<model-id>)` cuando no se establece
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	Nombre de visualización para la entrada de modelo personalizado en el selector `/model`. Cuando no se establece, la entrada muestra el nombre del modelo si Claude Code reconoce el ID, y el ID del modelo en caso contrario
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Lista separada por comas de capacidades que el modelo personalizado admite, por ejemplo `effort,thinking`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID de modelo al que se resuelve el alias `fable`, e ID que Claude Code reconoce como modelo Fable para alternancia automática de modelo en proveedores de terceros. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Descripción de visualización para el modelo Fable fijado en el selector `/model`. Cuando no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Fable model`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Nombre de visualización para el modelo Fable fijado en el selector `/model`. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de capacidades que el modelo Fable fijado admite, por ejemplo `effort,thinking`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	ID de modelo al que se resuelve el alias `haiku`, también usado para funcionalidad de fondo. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Descripción de visualización para el modelo Haiku fijado en el selector `/model`. Cuando no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Haiku model`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Nombre de visualización para el modelo Haiku fijado en el selector `/model`. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de capacidades que el modelo Haiku fijado admite, por ejemplo `effort,thinking`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_MODEL`	Modelo en el que las nuevas sesiones comienzan de forma predeterminada. Requiere Claude Code v2.1.236 o posterior. Vea Establecer un modelo predeterminado para nuevas sesiones
`ANTHROPIC_DEFAULT_OPUS_MODEL`	ID de modelo al que se resuelve el alias `opus`, y que `opusplan` usa mientras Plan Mode está activo. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descripción de visualización para el modelo Opus fijado en el selector `/model`. Cuando no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Opus model`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nombre de visualización para el modelo Opus fijado en el selector `/model`. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de capacidades que el modelo Opus fijado admite, por ejemplo `effort,thinking`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL`	ID de modelo al que se resuelve el alias `sonnet`, y que `opusplan` usa cuando Plan Mode no está activo. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Descripción de visualización para el modelo Sonnet fijado en el selector `/model`. Cuando no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Sonnet model`. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Nombre de visualización para el modelo Sonnet fijado en el selector `/model`. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. Vea Configuración de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de capacidades que el modelo Sonnet fijado admite, por ejemplo `effort,thinking`. Vea Configuración de modelo
`ANTHROPIC_FEDERATION_RULE_ID`	ID de regla de federación para Workload Identity Federation. Cuando lo establece junto con `ANTHROPIC_ORGANIZATION_ID`, Claude Code selecciona credenciales de federación, que tienen rango superior a su credencial `/login`. Vea precedencia de autenticación
`ANTHROPIC_FOUNDRY_API_KEY`	Clave de API para autenticación de Microsoft Foundry (vea Microsoft Foundry)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Token portador para autenticación de Microsoft Foundry, como un token de acceso de Microsoft Entra. Claude Code lo envía como el encabezado `Authorization: Bearer`. Tiene precedencia sobre `ANTHROPIC_FOUNDRY_API_KEY` y sobre la cadena de credenciales predeterminada de Azure. Vea Microsoft Foundry. Requiere Claude Code v2.1.203 o posterior
`ANTHROPIC_FOUNDRY_BASE_URL`	URL base completa para el recurso de Microsoft Foundry (por ejemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (vea Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nombre del recurso de Microsoft Foundry (por ejemplo, `my-resource`). Requerido si `ANTHROPIC_FOUNDRY_BASE_URL` no se establece (vea Microsoft Foundry)
`ANTHROPIC_MODEL`	Nombre de la configuración de modelo a usar (vea Configuración de modelo)
`ANTHROPIC_ORGANIZATION_ID`	ID de organización para Workload Identity Federation. Establézcalo junto con `ANTHROPIC_FEDERATION_RULE_ID`. Vea precedencia de autenticación
`ANTHROPIC_PROFILE`	Nombre del perfil de Anthropic con el que autenticarse, como uno creado por `ant auth login` o por iniciar sesión en una cuenta de Console sin clave de API. Vea precedencia de autenticación
`ANTHROPIC_SMALL_FAST_MODEL`	[DEPRECATED] Nombre de modelo de clase Haiku para tareas de fondo
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Anule la región de AWS para el modelo de clase Haiku cuando use Amazon Bedrock o Amazon Bedrock Mantle. En Amazon Bedrock, esto solo tiene efecto cuando `ANTHROPIC_DEFAULT_HAIKU_MODEL` o el deprecated `ANTHROPIC_SMALL_FAST_MODEL` también se establece, ya que Amazon Bedrock de otra manera ejecuta tareas de fondo en el modelo Sonnet predeterminado o el modelo principal en la región de sesión
`ANTHROPIC_VERTEX_BASE_URL`	Anule la URL del punto de conexión de Google Cloud's Agent Platform. Use para puntos de conexión personalizados de Google Cloud's Agent Platform o cuando enrute a través de una puerta de enlace LLM. Vea Google Cloud's Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID de proyecto de GCP al que se dirigen las solicitudes de Google Cloud's Agent Platform. Vea Configurar credenciales de GCP
`ANTHROPIC_WORKSPACE_ID`	ID de espacio de trabajo para federación de identidad de carga de trabajo. Establézcalo cuando su regla de federación tenga un alcance de más de un espacio de trabajo para que el intercambio de tokens sepa a qué espacio de trabajo dirigirse
`API_FORCE_IDLE_TIMEOUT`	Anule el tiempo de espera de inactividad del cuerpo de 5 minutos que aborta una respuesta del modelo de transmisión cuando no llegan bytes. Establezca en `0` para desactivar el tiempo de espera, por ejemplo cuando una puerta de enlace lenta o un modelo local hace una pausa más larga que 5 minutos entre fragmentos, o `1` para mantenerlo activado para cada proveedor. Cuando no se establece, el tiempo de espera está activo en proveedores que no sean la API directa de Anthropic y Claude Platform on AWS. Los perros guardianes de transmisión se ejecutan independientemente de él y abortan una pausa larga silenciosa incluso cuando establece `0` aquí
`API_TIMEOUT_MS`	Tiempo de espera para solicitudes de API en milisegundos (predeterminado: 600000, o 10 minutos; máximo: 2147483647). Aumente esto cuando las solicitudes agoten el tiempo de espera en redes lentas o cuando enrute a través de un proxy. Los valores por encima del máximo desbordan el temporizador subyacente y causan que las solicitudes fallen inmediatamente
`AWS_BEARER_TOKEN_BEDROCK`	Clave de API de Amazon Bedrock para autenticación (vea Claves de API de Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Tiempo de espera predeterminado para comandos bash de larga duración (predeterminado: 120000, o 2 minutos)
`BASH_MAX_OUTPUT_LENGTH`	Número máximo de caracteres de salida de bash que Claude Code lee en el resultado de un comando (predeterminado: 30000; máximo: 150000). Si establece la configuración `bashOutputMaxChars`, Claude Code ignora esta variable. Vea Límites de salida
`BASH_MAX_TIMEOUT_MS`	Tiempo de espera máximo que el modelo puede establecer para comandos bash de larga duración (predeterminado: 600000, o 10 minutos). El techo efectivo es el mayor de este y `BASH_DEFAULT_TIMEOUT_MS`
`BETA_TRACING_ENDPOINT`	Punto de conexión OTLP para rastreo beta detallado: con `ENABLE_BETA_TRACING_DETAILED=1`, los registros y rastreos van allí en lugar de a los exportadores configurados. Establézcalo en su shell, configuración de usuario o configuración administrada. Se ignora en configuración de proyecto y local
`CCR_FORCE_BUNDLE`	Establezca en `1` para forzar `claude --cloud` a agrupar y cargar su repositorio local en lugar de clonar desde su remoto
`CLAUDECODE`	Establezca en `1` en subprocesos que Claude Code genera (herramientas Bash y PowerShell, sesiones tmux, comandos hook, comandos línea de estado, subprocesos de servidor MCP stdio). Las extensiones IDE también establecen esto en sus terminales integrados. Use para detectar cuándo un script se ejecuta dentro de un subproceso generado por Claude Code. Para verificar si el proceso actual fue generado directamente por una llamada de herramienta o hook, en lugar de dentro de un servidor MCP stdio que Claude Code inició, use `CLAUDE_CODE_CHILD_SESSION` en su lugar
`CLAUDE_AFK_COUNTDOWN_MS`	Cuántos milisegundos antes de auto-continuar aparece la cuenta regresiva en pantalla en un diálogo `AskUserQuestion` sin respuesta. Predeterminado `20000` (20 segundos), limitado al tiempo de espera de auto-continuación. No tiene efecto a menos que la auto-continuación esté activada; vea la configuración `askUserQuestionTimeout` y `CLAUDE_AFK_TIMEOUT_MS`. Requiere Claude Code v2.1.198 o posterior
`CLAUDE_AFK_TIMEOUT_MS`	Cuántos milisegundos de tiempo inactivo antes de que un diálogo `AskUserQuestion` sin respuesta se auto-continúe sin usted. La auto-continuación está desactivada de forma predeterminada; opte por ella con la configuración `askUserQuestionTimeout`. Esta variable es una anulación para demostraciones y pruebas automatizadas: cuando se establece, tiene precedencia sobre esa configuración y activa la auto-continuación incluso cuando la configuración no se establece o es `never`. Establecer `0` no desactiva el tiempo de espera; cierra el diálogo inmediatamente. En v2.1.198 y v2.1.199, la auto-continuación estaba activada de forma predeterminada con un tiempo de espera de `60000` (60 segundos). Requiere Claude Code v2.1.198 o posterior
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	Establezca en `1` para desabilitar todos los tipos de subagente integrados como Explore y Plan. Solo se aplica en modo no interactivo (la bandera `-p`). Útil para usuarios de SDK que desean una pizarra en blanco. Esto también elimina `general-purpose`, el subagente que Claude Code ejecuta cuando una llamada de herramienta de Agent omite `subagent_type`. Tal llamada entonces falla con `subagent_type is required`
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	Establezca en `1` para omitir el prefijo `mcp__<server>__` en nombres de herramientas de servidores MCP creados por SDK. Las herramientas usan sus nombres originales. Solo uso de SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Tiempo de espera de estancamiento en milisegundos para subagentes. Predeterminado `600000` (10 minutos); si aumenta `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mientras el perro guardián de transmisión está activado, el predeterminado aumenta con él, como Manejar respuestas de API lentas o estancadas describe. El temporizador se reinicia en cada evento de progreso de transmisión; si no llega progreso dentro de la ventana, Claude Code aborta el subagente e informa el estancamiento al padre
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Establezca el porcentaje (1-100) de la ventana de auto-compactación en la que se activa la auto-compactación. Use valores más bajos como `50` para compactar antes; la variable no puede aumentar el umbral, por lo que los valores por encima del porcentaje predeterminado se ignoran. Solo se aplica en sesiones que compactan antes del límite de contexto del modelo. Se aplica a conversaciones principales y subagentes
`CLAUDE_AUTO_BACKGROUND_TASKS`	Establezca en `1` para forzar la habilitación del envío automático a segundo plano de tareas de agente de larga duración. Cuando está habilitado, los subagentes se mueven al fondo después de ejecutarse durante aproximadamente dos minutos. También habilita envío automático a segundo plano de llamadas de herramientas MCP largas en modo no interactivo en Claude Code v2.1.212 o posterior
`CLAUDE_AX_PREPARK_MS`	En modo de lector de pantalla, cuántos milisegundos Claude Code espera, con el cursor al inicio de la línea, antes de escribir una línea nueva o cambiada. Predeterminado `50`. Establezca `0` para escribir inmediatamente. Claude Code limita la espera a `5000`. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_AX_SCREEN_READER`	Establezca en `1` para renderizar salida amigable con lector de pantalla: texto plano sin bordes decorativos o animaciones. Establezca en `0` para forzar el modo de lector de pantalla desactivado incluso cuando `axScreenReader` es `true`. La bandera `--ax-screen-reader` tiene precedencia. Requiere Claude Code v2.1.181 o posterior
`CLAUDE_AX_STARTUP_QUIET_MS`	En modo de lector de pantalla, cuántos milisegundos Claude Code mantiene el primer renderizado de interfaz después de la línea de confirmación de inicio, para que su lector de pantalla pueda hablar la línea en su totalidad antes de que la nueva salida la interrumpa. Predeterminado `3000`. Establezca `0` para renderizar inmediatamente. Claude Code limita la retención a `600000` (10 minutos). Su primer pulsación de tecla termina la retención temprano. Requiere Claude Code v2.1.217 o posterior
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Vuelva al directorio de trabajo original después de cada comando Bash o PowerShell en la sesión principal
`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS`	Tiempo de espera en milisegundos para el perro guardián de inactividad de transmisión a nivel de byte; cuando se establece, tiene precedencia sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para ese perro guardián y deja el perro guardián a nivel de evento sin cambios. Claude Code fija esta variable entre 10 segundos y 30 minutos. Requiere Claude Code v2.1.210 o posterior
`CLAUDE_CLIENT_PRESENCE_FILE`	Ruta a un archivo que una herramienta externa, como un oyente de bloqueo de pantalla, crea cuando desbloquea su pantalla y elimina cuando la bloquea. Mientras el archivo existe, Claude Code omite notificaciones push móviles de Remote Control, por lo que deja de recibir notificaciones mientras usa activamente la computadora. Cuando el archivo está ausente o no se puede leer, las notificaciones se envían normalmente. Claude Code verifica el archivo una vez por evento de activación de notificación en lugar de sondear. Requiere Claude Code v2.1.181 o posterior
`CLAUDE_CODE_ACCESSIBILITY`	Establezca en `1` para mantener visible el cursor de terminal nativo y desabilitar el indicador de cursor de texto invertido. Permite que ampliadores de pantalla como macOS Zoom rastreen la posición del cursor
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`	Establezca en `1` para cargar archivos de memoria de directorios especificados con `--add-dir`. Carga `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, y `CLAUDE.local.md`. De forma predeterminada, los directorios adicionales no cargan archivos de memoria
`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT`	Establezca en `1` para repintar la pantalla completa en cada fotograma en renderizado de pantalla completa en lugar de enviar actualizaciones incrementales. Use esto si el modo de pantalla completa muestra fragmentos de texto obsoletos o mal colocados. Claude Code habilita esto automáticamente para sesiones de fondo y vista de agente en Windows
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Establezca en `1` para enviar el parámetro effort con cada solicitud, incluso cuando Claude Code no reconoce el ID del modelo como capaz de esfuerzo. Use esto cuando enrute a través de una puerta de enlace LLM o proveedor de terceros que sirve modelos bajo identificadores personalizados. Los modelos que rechazan el parámetro de esfuerzo en la API, incluidos los modelos Claude 3, Sonnet 4.0 y 4.5, Opus 4.0 y 4.1, y Haiku 4.5, aún se excluyen para que las solicitudes no fallen
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	Intervalo en milisegundos en el que se deben actualizar las credenciales (cuando se usa `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Establezca en `0` para evitar que Claude Code abra el navegador automáticamente cuando se publica un nuevo artefacto
`CLAUDE_CODE_ARTIFACT_COMMENTS`	Establezca en `0` para evitar que Claude lea y responda a comentarios en un artefacto. No tiene efecto cuando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha desactivado artefactos. Requiere Claude Code v2.1.221 o posterior
`CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT`	Establezca en `0` para evitar que Claude responda por su cuenta a comentarios enviados a él. Requiere Claude Code v2.1.228 o posterior
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Establezca en `0` para omitir el bloque de atribución, que lleva la versión del cliente y una huella digital del prompt, desde el inicio del prompt del sistema. El almacenamiento en caché en una conexión directa a la API de Anthropic no se ve afectado de ninguna manera. En algunas configuraciones de conexión directa, Claude Code mantiene el bloque en solicitudes de clasificador modo automático incluso cuando establece `0`. En Bloque de atribución del prompt del sistema, verifique qué conexiones y credenciales cubre esto. Antes de v2.1.181, el bloque incluía un token por solicitud en URLs base personalizadas y conexiones de Microsoft Foundry, por lo que en esas versiones establézcalo en `0` cuando su puerta de enlace LLM almacena en caché el cuerpo de la solicitud o reenvía solicitudes a un proveedor de terceros, o cuando se conecta a Microsoft Foundry directamente
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	Cuando `CLAUDE_AUTO_BACKGROUND_TASKS` está habilitado, segundos entre recordatorios a Claude para verificar subagentes de fondo que aún se están ejecutando. Solo acepta un entero simple de `1` a `86400`; cualquier otro valor o deletreo se lee como no establecido. Cuando no se establece, no hay recordatorios de verificación. Requiere Claude Code v2.1.248 o posterior
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Establezca la ventana de auto-compactación en tokens, de `100000` a `1000000`. Solo acepta un entero simple como `500000`: un valor como `500k` se lee como `500` y se fija al mínimo de 100K. La ventana efectiva también se limita a la ventana de contexto del modelo. Tiene precedencia sobre el comando `/autocompact`, la bandera `--autocompact` y la configuración `autoCompactWindow`. La `used_percentage` de la línea de estado siempre mide contra la ventana de contexto completa del modelo, por lo que una vez que se establece esta variable, ese porcentaje ya no indica cuándo se ejecutará la compactación
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Anule la conexión IDE automática. De forma predeterminada, Claude Code se conecta automáticamente cuando se inicia dentro de un terminal integrado de IDE compatible. Establezca en `false` para evitar esto. Establezca en `true` para forzar un intento de conexión cuando la auto-detección falla, como cuando tmux oscurece la terminal padre. Tiene precedencia sobre la configuración global `autoConnectIde`
`CLAUDE_CODE_AUTO_MODE_SERVER`	Controla si Claude Code le pide al servidor que revise acciones de modo automático. Cuando no se establece, Claude Code le pide al servidor en Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, y Claude Platform on AWS, y cuando apunta `ANTHROPIC_BASE_URL` a una puerta de enlace LLM o proxy. Establezca en `0` para usar las solicitudes de clasificador propias de Claude Code en su lugar. No se lee en una conexión directa a la API de Anthropic. Requiere Claude Code v2.1.271 o posterior; pedirle al servidor de forma predeterminada requiere v2.1.278 o posterior
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tiempo en milisegundos que Claude Code espera a que la cadena de proveedores de credenciales predeterminada de AWS produzca credenciales antes de que la solicitud falle con `AWS default-chain credential resolve timed out` (predeterminado: `60000`). Aumente cuando un paso en su cadena legítimamente necesita más tiempo, como un inicio de sesión SSO basado en navegador con MFA a través de un contenedor como `aws-vault`. Se aplica dondequiera que Claude Code firme con la cadena predeterminada: Amazon Bedrock, Claude Platform on AWS, y el punto de conexión Mantle. Requiere Claude Code v2.1.207 o posterior
`CLAUDE_CODE_BASH_EDIT_DIFF`	Establezca en `0` para desactivar la diferencia de los archivos que cambió un comando Bash, o `1` para registrarlo en cada modo de permiso. Tiene precedencia sobre la configuración `bashEditDiffEnabled`. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`	Establezca en `0` para hacer que una sesión no interactiva informe un estado inactivo a su host en cada final de turno, incluso mientras el trabajo de fondo aún se está ejecutando. De forma predeterminada, la sesión continúa informando un estado de ejecución después del final del turno mientras el trabajo de fondo como un agente de fondo o una ejecución de flujo de trabajo aún está activo. Esto mantiene un host que observa el estado, como una lista de sesión remota, de anunciar que Claude está esperando su entrada a mitad del trabajo. Los comandos de shell de fondo, como un servidor de desarrollo, no mantienen el estado de ejecución. El predeterminado de estado de ejecución y el opt-out de `0` requieren Claude Code v2.1.269 o posterior; en versiones anteriores, establezca `1` para mantener el estado de ejecución
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Se establece automáticamente en subprocesos de herramienta Bash y comando hook mientras la sesión tiene una conexión Remote Control activa, y se elimina cuando la conexión termina. El valor es el ID de la sesión en forma `session_`, el mismo identificador que aparece en la URL `claude.ai/code` de la sesión, para que un script pueda vincularse de nuevo a la sesión que lo ejecutó. Requiere Claude Code v2.1.199 o posterior. En sesiones en la nube, lea `CLAUDE_CODE_REMOTE_SESSION_ID` en su lugar
`CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`	Establezca en `0` para hacer que Claude Code lea el byte `0x08`, también escrito `^H`, como Retroceso simple, o `1` para leerlo como Ctrl+Retroceso. Cualquier valor reemplaza el predeterminado de la plataforma. De forma predeterminada, Claude Code lo lee como Ctrl+Retroceso en Windows, excepto cuando `TERM_PROGRAM` es `mintty` o `TERM` es `cygwin`, y como Retroceso simple en macOS y Linux. Establezca `0` en una terminal de Windows donde Retroceso elimina una palabra completa
`CLAUDE_CODE_CERT_STORE`	Lista separada por comas de fuentes de certificados de CA para conexiones TLS. `bundled` es el conjunto de CA de Mozilla enviado con Claude Code. `system` es el almacén de confianza del sistema operativo, leído solo en tiempos de ejecución con `tls.getCACertificates`: el binario nativo, o Node 22.15 o posterior para instalaciones npm. Vea Almacén de certificados de CA. El predeterminado es `bundled,system`
`CLAUDE_CODE_CHILD_SESSION`	Se establece en `1` en subprocesos que Claude Code genera a través de las herramientas Bash, PowerShell y Monitor, comandos hook, y comandos línea de estado. No se establece para subprocesos de servidor MCP stdio, que son de larga duración y sobreviven a la sesión que los generó. A diferencia de `CLAUDECODE`, esto solo se establece por Claude Code mismo cuando inicia un subproceso y no por extensiones IDE, por lo que distingue de manera confiable una sesión anidada de un `claude` de nivel superior lanzado en un terminal integrado de IDE. Una `claude` TUI interactiva anidada iniciada de esta manera se excluye automáticamente de `--resume`, `--continue`, historial de flecha hacia arriba, y la lista `claude agents`. Las sesiones `claude -p` no interactivas aún persisten. Establezca `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para anular esta exclusión. Requiere Claude Code v2.1.172 o posterior
`CLAUDE_CODE_CLIENT_CERT`	Ruta al archivo de certificado de cliente para autenticación mTLS
`CLAUDE_CODE_CLIENT_KEY`	Ruta al archivo de clave privada de cliente para autenticación mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Frase de contraseña para CLAUDE_CODE_CLIENT_KEY cifrado (opcional)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Eliminado en v2.1.186 y ahora es un no-op. Anteriormente establecía un tiempo de espera separado para la fase de conexión, TLS y encabezado de respuesta de una solicitud de API de transmisión. Use `API_TIMEOUT_MS` para el tiempo de espera por solicitud. Para la fase de encabezado de respuesta de una solicitud de transmisión, vea `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Anule la ruta del archivo de registro de depuración. A pesar del nombre, esta es una ruta de archivo, no un directorio. Requiere que el modo de depuración se habilite por separado a través de `--debug`, `/debug`, o la variable de entorno `DEBUG`: establecer solo esta variable no habilita el registro. La bandera `--debug-file` hace ambas cosas a la vez. El valor predeterminado es `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	Nivel de registro mínimo escrito en el archivo de registro de depuración. Valores: `verbose`, `debug` (predeterminado), `info`, `warn`, `error`. Establezca en `verbose` para incluir diagnósticos de alto volumen como salida de comando de línea de estado completa, o aumente a `error` para reducir ruido
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Establezca en `1` para desabilitar el soporte de ventana de contexto de 1M. Cuando se establece, las variantes de modelo de 1M no están disponibles en el selector de modelo, y Claude Code mantiene sesiones en modelos con una ventana nativa de 1M, como Sonnet 5 y los modelos Fable, a una ventana de 200K; vea Contexto extendido para cómo se aplica la retención. Útil para entornos empresariales con requisitos de cumplimiento. Para su papel en corregir la ventana para un ID de modelo [1m] no reconocido, vea Corregir la ventana para un ID de modelo de puerta de enlace o personalizado
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Establezca en `1` para desabilitar razonamiento adaptativo en Opus 4.6 y Sonnet 4.6 y volver al presupuesto de pensamiento fijo controlado por `MAX_THINKING_TOKENS`. No tiene efecto en modelos Fable, Sonnet 5, u Opus 4.7 y posterior, que siempre usan razonamiento adaptativo
`CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION`	Establezca en `1` para evitar que Claude Code fusione bloques `env` de configuración administrada por clave en todas las fuentes de administrador, por lo que solo se aplica el bloque `env` de la fuente de mayor prioridad, como antes de v2.1.223. Establézcalo en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada a través de un bloque `env` de configuración. Requiere Claude Code v2.1.223 o posterior
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Establezca en `1` para desabilitar la herramienta asesor. El comando `/advisor` se vuelve no disponible, cualquier `advisorModel` configurado se ignora, y la bandera `--advisor` se acepta pero no tiene efecto, por lo que los scripts existentes que la pasan continúan funcionando sin errores
`CLAUDE_CODE_DISABLE_AGENT_VIEW`	Establezca en `1` para desactivar agentes de fondo y vista de agente: `claude agents`, `--bg`, `/background`, y el supervisor bajo demanda. Equivalente a la configuración `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Establezca en `1` para desabilitar renderizado de pantalla completa y usar el renderizador de pantalla principal clásico. La conversación permanece en el desplazamiento nativo de su terminal para que `Cmd+f` y el modo de copia de tmux funcionen como de costumbre. Tiene precedencia sobre `CLAUDE_CODE_NO_FLICKER` y la configuración `tui`. También puede cambiar con `/tui default`. No se aplica a sesiones de fondo abiertas desde vista de agente, que siempre usan renderizado de pantalla completa
`CLAUDE_CODE_DISABLE_ARTIFACT`	Establezca en `1` para desactivar la herramienta Artifact, que publica la salida de sesión como una página web privada en claude.ai. Una vez que lo establece, ningún archivo de configuración activa la herramienta de nuevo. Para desactivar la herramienta desde un archivo de configuración en su lugar, establezca `enableArtifact` en `false`; la clave deprecated `disableArtifact` también la desactiva
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Establezca en `1` para desabilitar el procesamiento de archivos adjuntos. Las menciones de archivo con sintaxis `@` se envían como texto simple en lugar de expandirse en contenido de archivo
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Establezca en `1` para desabilitar memoria automática. Establezca en `0` para forzar la memoria automática incluso cuando el modo `--bare` o `autoMemoryEnabled: false` la deshabilitaría de otra manera. Cuando está deshabilitada, Claude no crea ni carga archivos de memoria automática
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Establezca en `1` para desabilitar toda la funcionalidad de tareas de fondo, incluido el parámetro `run_in_background` en herramientas Bash y subagente, auto-envío a segundo plano, y el atajo Ctrl+B
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT`	Establezca en `1` para evitar que Claude Code trate una respuesta de transmisión de Amazon Bedrock con un encabezado `Content-Type` faltante o vacío como flujo de eventos binario de Amazon Bedrock. De forma predeterminada, Claude Code asume que una puerta de enlace eliminó el encabezado de una respuesta de otra manera sin modificar, por lo que decodifica el cuerpo y la transmisión continúa funcionando. Establezca esto solo para una puerta de enlace que también re-emita la transmisión como eventos enviados por servidor; Claude Code entonces lee el cuerpo sin encabezado como eventos enviados por servidor en su lugar. Requiere Claude Code v2.1.239 o posterior
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Establezca en `1` para omitir la verificación de que una respuesta de transmisión de Amazon Bedrock lleve el tipo de contenido `application/vnd.amazon.eventstream`. Sin esta variable, cuando una respuesta lleva un tipo de contenido diferente, Claude Code falla la solicitud con un error que nombra ese tipo, lo que significa que una puerta de enlace o proxy está transformando la respuesta. Configure la puerta de enlace para reenviar el encabezado `Content-Type` y el cuerpo sin modificar en lugar de establecer esta variable. Requiere Claude Code v2.1.208 o posterior
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	Establezca en `1` para evitar que los comandos de shell de fondo en ejecución de una sesión de fondo, flujos de trabajo dinámicos, y, a partir de v2.1.198, subagentes de fondo cuando el supervisor detiene, reinicia o actualiza el proceso de esa sesión, en lugar de entregarlos al siguiente proceso de la sesión. Solo afecta esa entrega: enviar una sesión a segundo plano con `←` o `/background` aún lleva el trabajo en vuelo, y `CLAUDE_DISABLE_ADOPT` desactiva ambos. Requiere Claude Code v2.1.196 o posterior
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Establezca en `1` para evitar que Claude Code termine comandos de shell de fondo cuando el sistema operativo informa presión de memoria. De forma predeterminada, en macOS y Linux, Claude Code termina un shell de fondo iniciado en la sesión principal en una señal de presión de memoria una vez que la sesión ha estado inactiva durante 30 minutos y ningún turno o subagente se está ejecutando. Windows no tiene señal de presión de memoria, por lo que esta variable no tiene efecto allí. Requiere Claude Code v2.1.193 o posterior
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Establezca en `1` para desabilitar las skills e flujos de trabajo incluidos con Claude Code: las skills agrupadas y los flujos de trabajo se eliminan completamente, mientras que los comandos integrados como `/init` permanecen escribibles pero se ocultan del modelo. `/doctor` permanece escribible como los comandos integrados; ocúltalo con `DISABLE_DOCTOR_COMMAND` en su lugar. Las skills de plugins, `.claude/skills/`, y `.claude/commands/` no se ven afectadas. Equivalente a la configuración `disableBundledSkills`
`CLAUDE_CODE_DISABLE_CFC_PROMPT`	Establezca en `1` para mantener las herramientas de navegador Claude in Chrome disponibles mientras omite la sección de Chrome del prompt del sistema y la skill agrupada `/claude-in-chrome`. Para hosts que incrustan Claude Code y suministran su propia orientación de navegador. Requiere Claude Code v2.1.257 o posterior
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Establezca en `1` para evitar cargar archivos de memoria CLAUDE.md en contexto, incluidos archivos de memoria de usuario, proyecto y automática
`CLAUDE_CODE_DISABLE_CRON`	Establezca en `1` para desabilitar tareas programadas. La skill `/loop` y las herramientas cron se vuelven no disponibles y cualquier tarea ya programada deja de activarse, incluidas las tareas que ya se están ejecutando a mitad de sesión
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Establezca en `1` para eliminar encabezados de solicitud `anthropic-beta` específicos de Anthropic y campos de esquema de herramienta beta (como `defer_loading` y `eager_input_streaming`) de solicitudes de API. Use esto cuando una puerta de enlace proxy rechace solicitudes con errores como "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". Los campos estándar (`name`, `description`, `input_schema`, `cache_control`) se conservan. La búsqueda de herramientas MCP está deshabilitada y todas las herramientas MCP se cargan por adelantado, incluso cuando establece `ENABLE_TOOL_SEARCH`. En Claude Code v2.1.227 o posterior, la configuración administrada puede mantener la búsqueda de herramientas activada. Desabilitar capacidades de pre-lanzamiento cubre dónde se aplica la anulación
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Establezca en `1` para desabilitar los subagentes Explore y Plan integrados. Claude explora con sus herramientas de búsqueda o el subagente de propósito general en su lugar, y plan mode lee archivos directamente en lugar de lanzar agentes Explore y Plan. Los subagentes personalizados nombrados `Explore` o `Plan` no se ven afectados. Para eliminar cada tipo de subagente integrado en el Agent SDK o modo no interactivo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` en su lugar. Requiere Claude Code v2.1.198 o posterior
`CLAUDE_CODE_DISABLE_FAST_MODE`	Establezca en `1` para desabilitar modo rápido
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Establezca en `1` para desabilitar las encuestas de calidad de sesión "¿Cómo está Claude?". Las encuestas también se desabilitan cuando `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` se establece, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` opte por volver a entrar. Para establecer una tasa de muestreo en lugar de desabilitar completamente, use la configuración `feedbackSurveyRate`. Vea Encuestas de calidad de sesión
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Establezca en `1` para desabilitar checkpointing de archivo. El comando `/rewind` no podrá restaurar cambios de código. Anula la configuración `fileCheckpointingEnabled`
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Establezca en `1` para eliminar instrucciones de flujo de trabajo de commit y PR integradas y la instantánea de estado de git del prompt del sistema de Claude. Útil cuando usa sus propias skills de flujo de trabajo de git. Tiene precedencia sobre la configuración `includeGitInstructions` cuando se establece
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Establezca en `1` para evitar la remapeo automático de Opus 4.0 y 4.1 a la versión actual de Opus en la API de Anthropic. Use cuando desee fijar intencionalmente un modelo más antiguo. El remapeo no se ejecuta en Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry
`CLAUDE_CODE_DISABLE_MOUSE`	Establezca en `1` para desabilitar el seguimiento del ratón en renderizado de pantalla completa. El desplazamiento por teclado con `PgUp` y `PgDn` aún funciona. Use esto para mantener el comportamiento de copia al seleccionar nativo de su terminal
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Establezca en `1` para desabilitar el manejo de clics, arrastres y desplazamientos en renderizado de pantalla completa mientras mantiene el desplazamiento de rueda del ratón. Use esto cuando desee que el desplazamiento de rueda funcione dentro de Claude Code pero no desee que los clics posicionen el cursor, expandan la salida de herramientas, o abran enlaces. `CLAUDE_CODE_DISABLE_MOUSE` tiene precedencia cuando ambos se establecen. Requiere Claude Code v2.1.195 o posterior
`CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION`	Establezca en `1` para evitar que Claude Code vuelva a leer el certificado de cliente mTLS y la clave cuando una solicitud de API falla con un error a nivel de conexión, como un reinicio de conexión o un error de protocolo de enlace TLS. Con la recarga deshabilitada, Claude Code carga archivos rotados solo cuando aplica configuración nuevamente o en el siguiente inicio. Requiere Claude Code v2.1.232 o posterior
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Establezca en cualquier valor no vacío, como `1`, para desabilitar el tráfico de red no esencial: auto-actualizaciones, telemetría, informes de errores, el comando `/feedback`, retroalimentación redactada por Claude, notas de lanzamiento, las comprobaciones de insignia de estado de PR y MR, y comprobaciones de disponibilidad como la comprobación de modo rápido. También detiene las ejecuciones de fondo de fuentes de comando de plugin, que son comandos locales en lugar de tráfico de red, porque pueden desencadenar instalaciones de dependencias. Establecerlo en `0` o `false` aún desabilita este tráfico, a diferencia de la mayoría de variables de activación/desactivación; desestablezca la variable para permitirlo de nuevo. También desabilita la obtención de banderas de características, lo que hace que Remote Control y las otras características que necesitan obtención de banderas de características no estén disponibles. La auto-instalación del mercado de plugins oficial no se cubre; deshabilitela con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. No afecta descubrimiento de modelo de puerta de enlace, que tiene su propio opt-in
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Establezca en `1` para desabilitar el respaldo no transmitido cuando una solicitud de transmisión falla a mitad de transmisión. Los errores de transmisión se propagan a la capa de reintento en su lugar. Útil cuando un proxy o puerta de enlace causa que el respaldo produzca ejecución de herramientas duplicada
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Establezca en `1` para enviar la notificación de escritorio de la herramienta `PushNotification` incluso mientras está escribiendo en o enfocado en la terminal. De forma predeterminada, la herramienta omite tanto la notificación de escritorio como el push móvil cuando detecta actividad de teclado reciente o enfoque de terminal. Esta variable desabilita solo esa verificación local, por lo que el servidor aún puede suprimir el push móvil cuando detecta que está activo. Requiere Claude Code v2.1.193 o posterior
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Establezca en `1` para desabilitar el registro automático del mercado de plugins oficial. Claude Code lee la variable cuando está a punto de registrar el mercado, generalmente durante el primer lanzamiento interactivo de una máquina. Si la variable se establece en ese punto, Claude Code omite el registro permanentemente. Desestablecerla más tarde no deshace la omisión. Ejecute `claude plugin marketplace add anthropics/claude-plugins-official` para registrar el mercado en cualquier momento
`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`	Establezca en `1` para evitar que Claude Code ejecute sus hooks de Notification para solicitudes de permiso sin respuesta en sesiones donde Claude Code las envía a la devolución de llamada `canUseTool` del Agent SDK, que es cómo Claude Desktop y la extensión VS Code alojan Claude Code. No tiene efecto en sesiones de terminal. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Establezca en `1` para omitir la carga de skills del directorio de skills administrado en todo el sistema. Útil para sesiones de contenedor o CI que no deben cargar skills aprovisionadas por operador
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Establezca en `1` para desabilitar actualizaciones automáticas del título de terminal basadas en contexto de conversación. Esto también omite la solicitud de modelo pequeño/rápido de fondo que genera un título de sesión
`CLAUDE_CODE_DISABLE_THINKING`	Establezca en `1` para omitir completamente el parámetro `thinking` de solicitudes de API. Esta es una opción de compatibilidad para proxies y puertas de enlace que rechazan el parámetro. En modelos que piensan de forma predeterminada, omitir el parámetro significa que el modelo aún puede pensar. Para desabilitar explícitamente pensamiento extendido en la API de Anthropic, use `MAX_THINKING_TOKENS=0` en su lugar. Ninguna variable desactiva el pensamiento en Opus 5.5 o los modelos Fable, que no pueden tener el pensamiento desactivado. En proveedores de terceros, `MAX_THINKING_TOKENS=0` de manera similar omite el parámetro, por lo que las dos variables se comportan igual allí
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Establezca en `1` para omitir auto-compactación proactiva cuando Claude Code no reconoce el ID del modelo, como un alias de puerta de enlace LLM. Sin esta variable, Claude Code compacta en la ventana de contexto que asume para el ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` puede corregir la ventana asumida en su lugar; vea Corregir la ventana para un ID de modelo de puerta de enlace o personalizado para cuándo se aplica cada variable. Requiere Claude Code v2.1.223 o posterior
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Establezca en `1` para desabilitar el desplazamiento virtual en renderizado de pantalla completa y renderizar cada mensaje en la transcripción. Use esto si el desplazamiento en modo de pantalla completa muestra regiones en blanco donde deberían aparecer mensajes
`CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER`	Establezca en `1` para iniciar comandos de herramienta PowerShell en Windows directamente en lugar de a través del lanzador `cmd.exe`. De forma predeterminada, el lanzador permite que un comando de PowerShell ejecutándose en el fondo se lleve al siguiente proceso de la sesión, como cuando envía la sesión a segundo plano. Si establece la variable, un comando de PowerShell enviado a segundo plano se detiene cuando sale el proceso de la sesión. Los comandos Bash no se ven afectados. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Establezca en `1` para desabilitar flujos de trabajo. Equivalente a la configuración `disableWorkflows`
`CLAUDE_CODE_EFFORT_LEVEL`	Establezca el nivel de esfuerzo para modelos compatibles. Valores: `low`, `medium`, `high`, `xhigh`, `max`, o `auto` para usar el predeterminado del modelo. Los niveles disponibles dependen del modelo. Tiene precedencia sobre `--effort`, `/effort`, y las configuraciones `modelSettings` y `effortLevel`. Un límite `maxEffortLevel` aún se aplica. Vea Ajustar nivel de esfuerzo
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Aceptado para compatibilidad con versiones anteriores y no tiene efecto. El modo automático está disponible de forma predeterminada en cada proveedor, incluidos Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, y sesiones de puerta de enlace de aplicaciones Claude con sesión iniciada. En v2.1.158 a través de v2.1.206, establecer esto en `1` era necesario para hacer que modo automático estuviera disponible en esos proveedores
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Anule la disponibilidad de resumen de sesión. Establezca en `0` para forzar los resúmenes desactivados independientemente del toggle `/config`. Establezca en `1` para forzar los resúmenes activados cuando `awaySummaryEnabled` es `false`. Tiene precedencia sobre la configuración y toggle `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Establezca en `1` para actualizar el estado del plugin en límites de turno en modo no interactivo después de que se complete una instalación de fondo. Desactivado de forma predeterminada porque la actualización cambia el prompt del sistema a mitad de sesión, lo que invalida almacenamiento en caché de prompt para ese turno
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Establezca en `1` para enrutar la encuesta de calidad de sesión "¿Cómo está Claude?" a su propio recopilador OpenTelemetry cuando el tráfico no esencial vinculado a Anthropic está bloqueado. Las calificaciones de encuesta se emiten solo como eventos OTEL a su recopilador configurado. Ningún dato de encuesta se envía a Anthropic en este modo. Se aplica cuando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, o `DO_NOT_TRACK` se establece, y no tiene efecto de otra manera. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` y la política de retroalimentación del producto de la organización tienen precedencia
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controla si las entradas de llamadas de herramientas se transmiten desde la API mientras Claude las genera. Con esto desactivado, una entrada de herramienta grande como una escritura de archivo larga llega solo después de que Claude termina de generarla, lo que puede parecer que se cuelga. Habilitado de forma predeterminado en la API de Anthropic. En Amazon Bedrock y Google Cloud's Agent Platform, habilitado por modelo donde el contenedor implementado lo admite. Establezca en `0` para optar por no participar. Establezca en `1` para forzar cuando enrute a través de un proxy a través de `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL`, o `ANTHROPIC_BEDROCK_BASE_URL`. Desactivado de forma predeterminada en Microsoft Foundry y conexiones de puerta de enlace
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Establezca en `1` para rellenar el selector `/model` desde el punto de conexión `/v1/models` de su puerta de enlace cuando `ANTHROPIC_BASE_URL` apunta a una puerta de enlace compatible con Anthropic como LiteLLM, Kong, o un proxy interno. Desactivado de forma predeterminada porque las puertas de enlace respaldadas por una clave de API compartida de otra manera mostrarían a cada usuario cada modelo que la clave puede acceder. Los modelos descubiertos aún se filtran por una lista de permitidos `availableModels` que la sesión recibe; entregue la lista a través de MDM o un archivo de configuración administrada, ya que la entrega administrada por servidor no está disponible en configuraciones de puerta de enlace
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Eliminado en v2.1.142, cuando el predeterminado de modo rápido se movió de Opus 4.6 a Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Establezca en `false` para desactivar sugerencias de prompt, las predicciones atenuadas que aparecen en su entrada de prompt. Tiene precedencia sobre la configuración `promptSuggestionEnabled`, que es lo que el toggle Sugerencias de prompt en `/config` escribe. Claude Code también pausa sugerencias mientras su cuenta está cerca o en su límite de uso. Establezca en `true` para mantenerlas activadas hasta que alcance el límite. Requiere Claude Code v2.1.238 o posterior. Vea Sugerencias de prompt
`CLAUDE_CODE_ENABLE_TASKS`	Selecciona qué herramientas de seguimiento de tareas proporciona Claude Code en sesiones que las tienen. De forma predeterminada, Claude Code proporciona las herramientas Task `TaskCreate`, `TaskUpdate`, `TaskGet`, y `TaskList`. Establezca en `0` para obtener la herramienta legacy `TodoWrite` en su lugar. Vea Lista de tareas
`CLAUDE_CODE_ENABLE_TELEMETRY`	Establezca en `1` para habilitar la recopilación de datos OpenTelemetry para métricas y registro. Requerido antes de configurar exportadores OTel. Vea Monitoreo
`CLAUDE_CODE_ENABLE_TODO_TOOLS`	Establezca en `1` para obtener las herramientas de seguimiento de tareas en cada modelo. Sin él, Claude Code las proporciona de forma predeterminada solo en los modelos enumerados en Disponibilidad de herramienta Task. `CLAUDE_CODE_ENABLE_TASKS` aún selecciona las herramientas Task o `TodoWrite`. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tiempo en milisegundos para esperar después de que el bucle de consulta se vuelva inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que usan modo SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Establezca en `1` para habilitar equipos de agentes. Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada
`CLAUDE_CODE_EXTRA_BODY`	Objeto JSON para fusionar en el nivel superior de cada cuerpo de solicitud de API. Útil para pasar parámetros específicos del proveedor que Claude Code no expone directamente. Un valor exportado en su shell también se aplica a las sesiones de fondo que distribuye con `claude agents` o `--bg`. Antes de v2.1.206, las sesiones de fondo ignoraban un valor exportado por shell y usaban cualquier copia que el proceso supervisor de fondo heredara
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Anule el límite de token predeterminado para lecturas de archivo. Útil cuando necesita leer archivos más grandes en su totalidad
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Establezca en `1` para forzar la persistencia de transcripción, historial de prompts, y registro de `claude agents` incluso cuando este `claude` se lanzó desde dentro de otra sesión de Claude Code. Use cuando un valor heredado de `CLAUDE_CODE_CHILD_SESSION`, por ejemplo de una sesión `screen` o un lanzador de fondo iniciado primero por la herramienta Bash de Claude Code, causa que una sesión genuina de nivel superior se clasifique erróneamente como anidada. A partir de v2.1.178, Claude Code detecta el caso de tmux automáticamente e ignora el marcador heredado, por lo que tmux ya no necesita esta variable. También se honra en v2.1.169 y anterior; no tiene efecto en v2.1.170 y v2.1.171, donde se eliminó la detección de sesión anidada que anula
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Establezca en `1` para forzar el renderizado de tachado para `~~text~~` en respuestas de Claude cuando su terminal lo admite pero no se auto-detecta, como sobre SSH sin `TERM_PROGRAM` reenviado. Sin esto, los terminales no detectados muestran los marcadores literales `~~` en lugar de renderizar el texto como tachado. Requiere Claude Code v2.1.186 o posterior
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	Establezca en `1` para forzar la habilitación del modo privado DEC 2026 salida sincronizada cuando su terminal lo admite pero no se auto-detecta. Útil para emuladores como `eat` de Emacs que implementan BSU/ESU pero no responden a la sonda de capacidad. No tiene efecto bajo tmux. A diferencia de `CLAUDE_CODE_NO_FLICKER`, que cambia a renderizado de pantalla completa, esto no cambia el renderizador
`CLAUDE_CODE_FORK_SUBAGENT`	Controla modo bifurcación, que permite que Claude genere subagentes bifurcados a sí mismo y está activado de forma predeterminada solo en sesiones interactivas. Establezca en `1` para activarlo en `claude -p` y el Agent SDK también, o `0` para desactivarlo en cada tipo de sesión. Puede ejecutar `/subtask` independientemente de si el modo bifurcación está activado. El predeterminado interactivo requiere Claude Code v2.1.232 o posterior; en versiones anteriores, establezca la variable en `1` para activar el modo bifurcación
`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`	Establezca en `1` para emitir bloques de texto y pensamiento de subagente en la salida `claude -p --output-format stream-json`, el mismo comportamiento que la bandera `--forward-subagent-text`. Use la variable cuando un arnés invoca `claude` y no puede pasar la bandera a sí mismo. A diferencia de la bandera, que sale con un error fuera del modo no interactivo con salida stream-json, la variable se ignora allí para que las invocaciones anidadas continúen funcionando cuando se establece en todo el proceso. Requiere Claude Code v2.1.211 o posterior
`CLAUDE_CODE_GATEWAY_HINT_HEADERS`	Establezca en `1` para enviar los encabezados de sugerencia de puerta de enlace, como `x-claude-code-request-class` y `x-claude-code-compaction`, en un proxy personalizado o un proveedor de terceros como Amazon Bedrock o Claude Platform on AWS. Establezca en `0` para dejar de enviarlos en cada conexión, incluida una conexión directa a la API de Anthropic, donde Claude Code los envía de forma predeterminada. Requiere Claude Code v2.1.273 o posterior
`CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS`	Tiempo de espera en milisegundos para la solicitud de descubrimiento de modelo de puerta de enlace que `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` activa (predeterminado: `3000`). Aumente cuando su puerta de enlace necesita más de tres segundos para responder `/v1/models` al inicio. Solo acepta dígitos simples; `0`, valores negativos, y otros deletreos mantienen el predeterminado. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_GIT_BASH_PATH`	Solo Windows: ruta al ejecutable de Git Bash (`bash.exe`). Use cuando Git Bash está instalado pero no en su PATH. Si la ruta no existe o el archivo no se nombra `bash.exe`, `sh.exe`, `bash`, o `sh`, Claude Code ignora la variable y auto-detecta Git Bash como si no estuviera establecida, registrando una advertencia visible con `--debug`. Antes de v2.1.219, Claude Code salía al inicio cuando la ruta no existía, y usaba cualquier archivo existente como shell sin verificar que fuera bash o sh. Vea Configuración de Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Establezca en `false` para excluir dotfiles de resultados cuando Claude invoca la herramienta Glob. Incluido de forma predeterminada. No afecta autocompletado de archivo `@`, `ls`, Grep, o Read
`CLAUDE_CODE_GLOB_NO_IGNORE`	Establezca en `false` para hacer que la herramienta Glob respete patrones `.gitignore`. De forma predeterminada, Glob devuelve todos los archivos coincidentes incluidos los ignorados por git. No afecta autocompletado de archivo `@`, que tiene su propia configuración `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Tiempo de espera en segundos para descubrimiento de archivos de herramienta Glob. El valor predeterminado es 20 segundos en la mayoría de plataformas y 60 segundos en WSL
`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`	Cuántos minutos el trabajo de fondo puede mantener un objetivo activo esperando antes de que Claude Code le pida a Claude que lo verifique. Predeterminado `30`. Establezca `0` para desactivar las verificaciones. Dé minutos completos en dígitos simples, como máximo `10080`, que es una semana. Claude Code trata cualquier otro valor como no establecido y usa el predeterminado. Requiere Claude Code v2.1.234 o posterior
`CLAUDE_CODE_HIDE_CWD`	Establezca en `1` para ocultar el directorio de trabajo en el logo de inicio. Útil para comparticiones de pantalla o grabaciones donde la ruta expone su nombre de usuario del SO
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Anule la dirección de host utilizada para conectarse a la extensión IDE. De forma predeterminada, Claude Code auto-detecta la dirección correcta, incluido el enrutamiento de WSL a Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Establezca en `1` para omitir la auto-instalación de extensiones IDE. Equivalente a establecer `autoInstallIdeExtension` en `false`
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Establezca en `1` para omitir la validación de entradas de archivo de bloqueo IDE durante la conexión. Use cuando la auto-conexión falla para encontrar su IDE a pesar de que se está ejecutando
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	Cuántos subagentes pueden estar ejecutándose en una sesión antes de que la herramienta Agent se niegue a generar otro (predeterminado: 20). Acepta un número entero positivo en dígitos simples; cualquier otra cosa se ignora, por lo que la variable puede ajustar el límite pero no deshabilitarlo. Requiere Claude Code v2.1.217 o posterior
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Anule el tamaño de la ventana de contexto que Claude Code asume para el modelo activo. A partir de v2.1.193, cómo se aplica depende de cómo Claude Code resuelve el ID del modelo; vea Corregir la ventana para un ID de modelo de puerta de enlace o personalizado. Use esto cuando enrute a un modelo a través de `ANTHROPIC_BASE_URL` cuya ventana de contexto no coincida con el tamaño integrado para su nombre
`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`	Longitud máxima en caracteres de cada descripción de herramienta MCP e instrucciones de cada servidor MCP que Claude Code envía al modelo (predeterminado: 2048). Claude Code trunca texto más largo. Acepta un número entero positivo en dígitos simples. Cualquier otra cosa se ignora y se aplica el predeterminado. Requiere Claude Code v2.1.280 o posterior
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Establezca el número máximo de tokens de salida para la mayoría de solicitudes. Los valores predeterminados y límites varían por modelo; vea tokens de salida máximos. Claude Code tiene un valor predeterminado de 32000 para IDs de modelo que no reconoce, como nombres específicos de puerta de enlace, y reduce valores por encima del límite de un modelo al límite. Aumentar este valor reduce la ventana de contexto efectiva disponible antes de que se active auto-compactación
`CLAUDE_CODE_MAX_RETRIES`	Anule el número de veces para reintentar solicitudes de API fallidas (predeterminado: 10). Limitado a 15 a partir de v2.1.186; a partir de v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta el predeterminado y elimina el límite. Para sesiones desatendidas que necesitan esperar a través de interrupciones más largas, establezca `CLAUDE_CODE_RETRY_WATCHDOG` en su lugar
`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`	Eliminado en v2.1.224 y ahora es un no-op. Anteriormente limitaba el número total de subagentes que Claude podía generar con la herramienta Agent en una sesión (predeterminado: 200); generar más allá del límite falló con `Subagent spawn limit reached`. El límite de subagente concurrente y el límite de profundidad aún se aplican
`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	Número de capas de subagente permitidas debajo de la conversación principal (predeterminado: 3). En el predeterminado, los subagentes pueden generar sus propios subagentes, y un subagente en la tercera capa no puede generar más; establezca `1` para desactivar el anidamiento. En v2.1.217 a través de v2.1.218, el predeterminado era 1, por lo que un subagente no podía generar el suyo a menos que aumentara el límite; v2.1.219 aumentó el predeterminado a 3. Acepta un número entero positivo en dígitos simples; cualquier otra cosa se ignora, por lo que el límite puede ajustarse pero no eliminarse. Requiere Claude Code v2.1.217 o posterior
`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`	Número máximo de herramientas de solo lectura y subagentes que pueden ejecutarse en paralelo (predeterminado: 10). Los valores más altos aumentan el paralelismo pero consumen más recursos
`CLAUDE_CODE_MAX_TURNS`	Limite el número de turnos agénticos cuando no se pasa un límite explícito. Equivalente a pasar `--max-turns`, que tiene precedencia cuando ambos se establecen. Un valor que no es un entero positivo se rechaza al inicio con un error en lugar de tratarse como sin límite
`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`	Límite en el número total de llamadas WebSearch que una sesión puede hacer (predeterminado: 200). Cuando Claude alcanza el límite, las llamadas WebSearch adicionales devuelven un aviso diciéndole que continúe con la información que ya ha reunido. Acepta un número entero positivo sin límite superior. Cualquier otra cosa se ignora y se aplica el predeterminado, por lo que el límite puede aumentarse pero no desactivarse. Requiere Claude Code v2.1.212 o posterior
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Establezca en `1` para generar servidores MCP stdio con solo un entorno de línea base segura más el `env` configurado del servidor, en lugar de heredar su entorno de shell
`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`	Tiempo transcurrido en milisegundos antes de que una llamada de herramienta MCP aún en ejecución se mueva a una tarea de fondo (predeterminado: 120000, o 2 minutos). Establezca en `0` para desactivar el envío automático a segundo plano. Requiere Claude Code v2.1.212 o posterior
`CLAUDE_CODE_MCP_STARTUP_WAIT_MS`	Cuánto tiempo en milisegundos el primer turno de una sesión no interactiva espera a que los servidores MCP que aún se están conectando, en lugar de la espera de primer turno predeterminada. Cuando se establece, la espera cubre cada servidor pendiente. Establezca en `0` para omitir la espera. Un servidor `--permission-prompt-tool` mantiene su propia espera `MCP_TIMEOUT` independientemente del valor. Requiere Claude Code v2.1.274 o posterior
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Tiempo de espera de inactividad en milisegundos para llamadas de herramientas MCP. Cuando un servidor MCP stdio, HTTP, SSE, WebSocket, o conector claude.ai no envía respuesta ni notificación de progreso durante este tiempo, la llamada de herramienta se aborta con un error en lugar de esperar el `MCP_TOOL_TIMEOUT` general. Anula los valores predeterminados por transporte de 300000 (5 minutos) para servidores de red y 1800000 (30 minutos) para servidores stdio. Establezca en `0` para desabilitar la verificación de inactividad. Los valores por debajo de 1000 se aumentan a un segundo, y el valor se limita al `MCP_TOOL_TIMEOUT` efectivo. Un `timeout` por servidor en `.mcp.json` de al menos 1000 aumenta la ventana de inactividad de ese servidor a al menos el valor `timeout`. No se aplica a servidores IDE o servidores en proceso del SDK. Requiere Claude Code v2.1.187 o posterior. Antes de v2.1.203, los servidores stdio estaban exentos del tiempo de espera de inactividad
`CLAUDE_CODE_MESSAGING_SOCKET`	Se establece por Claude Code, no por usted: en sesiones que vinculan un socket de bandeja de entrada, Claude Code exporta la ruta de ese socket a hooks y comandos Bash cuando vincula el socket. En una sesión que comienza con mensajería activada, Claude Code vincula el socket antes de que se ejecute cualquier hook. Otras sesiones en la máquina entregan mensajes a esta ruta. Cada sesión exporta su propio socket en lugar de uno heredado de un padre, y los mensajes que llegan en él pasan a través de los controles de entrada de la sesión. Los bloques `env` de configuración no pueden establecerlo. Requiere Claude Code v2.1.224 o posterior
`CLAUDE_CODE_MESSAGING_TOKEN`	Se establece por Claude Code, no por usted: en sesiones que vinculan un socket de bandeja de entrada, Claude Code exporta este token por sesión a hooks y comandos Bash junto a `CLAUDE_CODE_MESSAGING_SOCKET`. Un script que publica en el socket puede enviar `{"type":"auth","token":"<token>"}` como su primera línea para probar que pertenece a la sesión. En Windows nativo, Claude Code requiere esta línea y cierra cualquier conexión que no se abra con una válida. Las reglas de hijo propio dicen cuándo Claude Code consulta el token. Cada sesión exporta su propio token, nunca uno heredado de una sesión padre. Los bloques `env` de configuración no pueden establecerlo. Requiere Claude Code v2.1.228 o posterior
`CLAUDE_CODE_NATIVE_CURSOR`	Establezca en `1` para mostrar el cursor propio de la terminal en el cursor de entrada en lugar de un bloque dibujado. El cursor respeta el parpadeo, forma y configuración de enfoque de la terminal
`CLAUDE_CODE_NEW_INIT`	Establezca en `1` para hacer que `/init` ejecute un flujo de configuración interactivo. El flujo pregunta qué archivos generar, incluidos CLAUDE.md, skills, y hooks, antes de explorar la base de código y escribirlos. Sin esta variable, `/init` genera un CLAUDE.md automáticamente sin preguntar
`CLAUDE_CODE_NONBLOCKING_STDOUT`	Establezca en `1` para escribir la salida del terminal a través de un segundo descriptor de archivo no bloqueante, para que una terminal que deja de leer, como un panel de modo de control de tmux pausado o una conexión SSH estancada, no pueda congelar Claude Code a mitad de sesión. Se aplica en macOS, Linux, y WSL cuando stdout es una terminal. Requiere Claude Code v2.1.261 o posterior
`CLAUDE_CODE_NO_FLICKER`	Establezca en `1` para habilitar renderizado de pantalla completa, una vista previa de investigación que reduce el parpadeo y mantiene la memoria plana en conversaciones largas. Anula la configuración `tui`; también puede cambiar con `/tui fullscreen`
`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`	Token de actualización OAuth para autenticación de Claude.ai. Cuando se establece, `claude auth login` intercambia este token directamente en lugar de abrir un navegador. Requiere `CLAUDE_CODE_OAUTH_SCOPES`. Útil para provisionar autenticación en entornos automatizados
`CLAUDE_CODE_OAUTH_SCOPES`	Alcances OAuth separados por espacios con los que se emitió el token de actualización, como `"user:profile user:inference user:sessions:claude_code"`. Requerido cuando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` se establece
`CLAUDE_CODE_OAUTH_TOKEN`	Token de acceso OAuth para autenticación de claude.ai. Alternativa a `/login` para SDK y entornos automatizados. Tiene precedencia sobre credenciales almacenadas en llavero. Genere uno con `claude setup-token`. A menos que ejecute `/login`, Claude Code usa el token que establece para toda la sesión. Para reemplazar un token expirado, genere uno nuevo y reinicie
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Eliminado en v2.1.160 y ahora es un no-op. Anteriormente fijaba modo rápido a Claude Opus 4.6 en lugar del predeterminado actual. Opus 4.6 ya no admite modo rápido
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Longitud máxima de atributos OpenTelemetry que llevan contenido (respuestas del modelo, contenido de herramientas, prompts del sistema, cuerpos de API sin procesar), marcador de truncamiento incluido, en unidades de código UTF-16 (predeterminado: 61440, es decir, 60 KB). Aumente solo si su backend de telemetría acepta valores de atributo mayores que 64 KB, o reduzca para cortar volumen de telemetría. Requiere Claude Code v2.1.214 o posterior. Vea Monitoreo
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Establezca en `1` para escribir errores de diagnóstico del exportador OpenTelemetry en stderr. De forma predeterminada, estos errores solo aparecen con `--debug`, por lo que un exportador mal configurado como una colisión de puerto Prometheus de otra manera falla silenciosamente. Requiere Claude Code v2.1.179 o posterior. Vea Monitoreo
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Tiempo de espera en milisegundos para vaciar tramos OpenTelemetry pendientes (predeterminado: 5000). Vea Monitoreo
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalo para actualizar encabezados OpenTelemetry dinámicos en milisegundos (predeterminado: 1740000 / 29 minutos). Vea Encabezados dinámicos
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Tiempo de espera en milisegundos para que el exportador OpenTelemetry termine al apagar (predeterminado: 2000). Aumente si se descartan métricas al salir. Vea Monitoreo
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Establezca en `1` para permitir que Claude Code ejecute el comando de actualización de su gestor de paquetes en el fondo cuando una nueva versión esté disponible. Se aplica a instalaciones de Homebrew y WinGet. Otros gestores de paquetes continúan mostrando el comando de actualización sin ejecutarlo. Vea Auto-actualizaciones
`CLAUDE_CODE_PERFORCE_MODE`	Establezca en `1` para habilitar protección de escritura consciente de Perforce. Cuando se establece, Edit, Write, y NotebookEdit fallan con una sugerencia `p4 edit <file>` si el archivo de destino carece del bit de escritura del propietario, que Perforce borra en archivos sincronizados hasta que `p4 edit` los abre. Esto evita que Claude Code evite el seguimiento de cambios de Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Anule el directorio raíz de plugins. A pesar del nombre, esto establece el directorio padre, no el caché en sí: los mercados y el caché de plugins viven en subdirectorios bajo esta ruta. El valor predeterminado es `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_DIRS`	Directorios de plugins para cargar para la sesión, cada uno cargado de la manera que una bandera `--plugin-dir` lo carga. Separe múltiples rutas con `:` en Unix o `;` en Windows. Dé cada ruta como una ruta absoluta o comience con `~`, porque Claude Code omite rutas relativas. Requiere Claude Code v2.1.280 o posterior
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Tiempo de espera en milisegundos para operaciones de git al instalar o actualizar plugins (predeterminado: 120000). Aumente este valor para repositorios grandes o conexiones de red lentas. Vea Las operaciones de Git agotan el tiempo de espera
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Establezca en `1` para omitir el intento de re-clonación y mantener el uso del caché de mercado existente cuando un `git pull` falla. Útil en entornos sin conexión o aislados donde la re-clonación fallaría de la misma manera. Vea Las actualizaciones del mercado fallan en entornos sin conexión
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Establezca en `1` para clonar fuentes de abreviatura de GitHub `owner/repo` sobre HTTPS en lugar de SSH. Se aplica a instalación y actualización de plugins, y a `/plugin marketplace add` y `update`. Útil en ejecutores de CI, contenedores, o cualquier entorno sin una clave SSH configurada para `github.com`
`CLAUDE_CODE_PLUGIN_SEED_DIR`	Ruta a uno o más directorios de semilla de plugins de solo lectura, separados por `:` en Unix o `;` en Windows. Use esto para agrupar un directorio de plugins pre-poblado en una imagen de contenedor. Claude Code registra mercados de estos directorios al inicio y usa plugins pre-almacenados en caché sin re-clonar. Vea Pre-poblar plugins para contenedores
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Establezca en `1` para evitar que Claude Code pase `-ExecutionPolicy Bypass` al generar PowerShell para llamadas de herramientas, hooks, y comandos de línea de estado, y respete la política de ejecución efectiva de la máquina en su lugar. De forma predeterminada, Claude Code evita la política de ejecución en el alcance del proceso para que los scripts `.ps1` e importaciones de módulos funcionen en instalaciones de Windows con Restricted predeterminado. El bypass de alcance de proceso nunca anula la política de grupo `MachinePolicy` o `UserPolicy` independientemente de esta configuración
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Techo en milisegundos en la espera inactiva para subagentes de fondo y flujos de trabajo después del turno final en modo no interactivo con la bandera `-p`. La espera inactiva comienza de nuevo cada vez que Claude toma un turno para manejar un resultado de fondo. Predeterminado: `600000`, o 10 minutos. Cuando la espera inactiva alcanza el techo, Claude Code deja de esperar las tareas de fondo restantes y sale. Establezca en `0` para esperar indefinidamente. Este límite es separado del período de gracia de cinco segundos que se aplica a shells de fondo simples. Requiere Claude Code v2.1.182 o posterior
`CLAUDE_CODE_PROCESS_WRAPPER`	Lance los procesos que Claude Code inicia desde su propio binario, como el servicio de fondo que aloja sesiones de vista de agente, a través de un lanzador corporativo dado como un prefijo argv como `/opt/corp/launcher`. Establézcalo en el bloque `env` de configuración de usuario o administrada, no como una exportación de shell, para que el servicio de fondo desconectado lo herede; la configuración de proyecto y local no puede establecerlo. Equivalente a la configuración `processWrapper`, que requiere Claude Code v2.1.210 o posterior; esta variable tiene precedencia cuando ambas se establecen. La extensión VS Code configura su propio lanzador por separado a través de su configuración `claudeProcessWrapper`. Se ignora en Windows. Vea Ejecutar Claude Code detrás de un lanzador corporativo para el formato de valor, qué cubre el lanzador, y el contrato que el lanzador debe satisfacer. Requiere Claude Code v2.1.208 o posterior
`CLAUDE_CODE_PROJECT_DIR_NAME`	Establezca junto con `CLAUDE_CONFIG_DIR` para elegir el nombre del directorio `projects/` donde Claude Code almacena las transcripciones y memoria automática de esa sesión, en lugar de uno derivado de la ruta del directorio de trabajo. Por ejemplo, iniciar Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` las almacena bajo `/srv/tenant-a/projects/work/`. Claude Code ignora esta variable cuando `CLAUDE_CONFIG_DIR` no se establece, y la lee solo del entorno desde el que inicia `claude`, nunca desde un bloque `env` de archivo de configuración. Vea Nombre el directorio del proyecto usted mismo. Requiere Claude Code v2.1.234 o posterior
`CLAUDE_CODE_PROMPT_CACHE_TTL`	Establezca `5m` o `1h`, los únicos valores que Claude Code acepta, para elegir el TTL de caché de prompt para la conversación principal: sus turnos interactivos, `-p`, y SDK, más los ayudantes que se ejecutan en línea con ellos. Tiene precedencia sobre la configuración `promptCacheTtl` y sobre `ENABLE_PROMPT_CACHING_1H`, y `FORCE_PROMPT_CACHING_5M` la anula. Las escrituras de caché de 1 hora se facturan a una tasa más alta. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Establezca en `1` para propagar contexto de rastreo W3C cuando `ANTHROPIC_BASE_URL` apunta a un proxy personalizado. La propagación cubre el encabezado `traceparent` en solicitudes de modelo y MCP HTTP y la variable de entorno `TRACEPARENT` para subprocesos Bash, PowerShell, y hook. De forma predeterminada, la propagación está habilitada solo cuando se conecta directamente a la API de Anthropic. Agregado en v2.1.152. Vea Rastreos (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Se establece por plataformas host que incrustan Claude Code y administran el enrutamiento del proveedor de modelo en su nombre. Cuando se establece, Claude Code ignora variables de selección de proveedor, punto de conexión, y autenticación como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, y `ANTHROPIC_API_KEY` en archivos de configuración, por lo que la configuración de usuario no puede anular el enrutamiento del host. Claude Code también ignora claves de selección de modelo como `model`, `fallbackModel`, y `modelOverrides` en configuración administrada, cualquiera que sea la fuente administrada que las entregue, por lo que la configuración de modelo del host tiene precedencia sobre un pin de modelo administrado desactualizado. Claude Code también ignora variables de selección de modelo como `ANTHROPIC_MODEL` y la familia `ANTHROPIC_DEFAULT_*_MODEL` en un bloque `env` administrado; una lista de permitidos `availableModels` en configuración administrada aún se aplica a menos que el host suministre la suya. Claude Code también omite la exclusión de telemetría automática que de otra manera aplica en proveedores de terceros como Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, y Microsoft Foundry, por lo que la telemetría sigue el opt-out estándar `DISABLE_TELEMETRY`. Vea Comportamientos predeterminados por proveedor de API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Establezca en `1` para permitir que el proxy realice la resolución de DNS en lugar de la persona que llama. Opt-in para entornos donde el proxy debe manejar la resolución de nombres de host
`CLAUDE_CODE_REMOTE`	Se establece automáticamente en `true` cuando Claude Code se ejecuta como una sesión en la nube. Lea esto desde un hook o script de configuración para detectar si está en una sesión en la nube
`CLAUDE_CODE_REMOTE_SESSION_ID`	Se establece automáticamente en sesiones en la nube al ID de la sesión actual. Lea esto para construir un enlace de vuelta a la transcripción de la sesión. Vea Enlace de salida de vuelta a la sesión
`CLAUDE_CODE_RESTRICTED`	Establezca en `1` para iniciar la sesión en modo restringido, lo mismo que pasar `--restricted`. Claude Code ignora esta variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.248 o posterior
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Establezca en `1` para reanudar automáticamente si la sesión anterior terminó a mitad de turno. Se usa en modo SDK para que el modelo continúe sin requerir que el SDK reenvíe el prompt. Para desactivar esto, desestablezca la variable o establézcala en `0`. Antes de v2.1.221, Claude Code ignoraba `0` y otros valores falsos, por lo que establecer `0` aún activaba la reanudación en modo no interactivo y desestablecerla era la única forma de desactivarla
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS`	Edad máxima en milisegundos del último mensaje de transcripción para una sesión que terminó a mitad de turno para continuar automáticamente al reanudar. Cuando el último mensaje es más antiguo que este límite, Claude Code omite tanto la reanudación automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` como el mensaje de continuación inyectado de `CLAUDE_CODE_RESUME_PROMPT`, y la sesión comienza inactiva para que continúe explícitamente. Sin establecer o `0` significa sin límite, excepto que un turno cuya última solicitud falló con un error de API se reanuda solo mientras ese error tiene menos de seis horas. Un valor positivo limita cada turno, incluidos esos; un valor negativo o no numérico aplica un límite de una hora. Los scripts de generación para agentes de larga duración pueden establecer esto para que un reinicio contra una transcripción antigua no re-ejecute un prompt obsoleto. Claude Code establece un límite de una hora a sí mismo cuando reinicia una sesión de vista de agente que heredó su conversación de una sesión interactiva. Requiere Claude Code v2.1.211 o posterior
`CLAUDE_CODE_RESUME_PROMPT`	Anule el mensaje de continuación inyectado cuando se reanuda una sesión que terminó a mitad de turno. El valor predeterminado es `Continue from where you left off.`. Los scripts de generación para agentes de larga duración pueden establecer esto en un mensaje de arranque más directivo. Una cadena vacía usa el predeterminado
`CLAUDE_CODE_RETRY_WATCHDOG`	Establezca en `1` para sesiones desatendidas como arneses de evaluación, trabajos de CI, o trabajadores remotos. Reintentos `429` y `529` errores de capacidad indefinidamente en lugar de fallar después de intentos de `CLAUDE_CODE_MAX_RETRIES`. Claude Code falla de inmediato cuando una solicitud de velocidad estándar obtiene un `429` que informa un límite de gasto o créditos de uso agotados, incluso uno de un límite de gasto de puerta de enlace que se reinicia en un horario. Antes de v2.1.239, el perro guardián reintentaba estos indefinidamente. Para solicitudes de modo rápido, vea Manejar límites de velocidad. El perro guardián se retira hasta 5 minutos entre intentos, o hasta que se reinicie el límite cuando la respuesta lleva un tiempo de reinicio de límite de velocidad, por lo que una sesión que alcanza un límite de uso espera la ventana restante. En v2.1.199 o posterior también aumenta el conteo de reintento predeterminado para otros errores transitorios, como errores de servidor, tiempos de espera, y conexiones caídas, a 300, aproximadamente tres horas de retroceso, y elimina el límite de 15 en `CLAUDE_CODE_MAX_RETRIES` si establece esa variable explícitamente. Requiere Claude Code v2.1.186 o posterior
`CLAUDE_CODE_SAFE_MODE`	Establezca en `1` para iniciar en modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos y agentes personalizados, estilos de salida, flujos de trabajo, temas personalizados, atajos de teclado personalizados, comandos de línea de estado y sugerencia de archivo, servidores LSP, y memoria automática no se cargan, para solucionar problemas de una configuración rota. La política de configuración administrada aún se aplica, incluidos hooks configurados por política, línea de estado, y comandos de sugerencia de archivo; plugins administrados, skills administradas, CLAUDE.md administrado, y servidores MCP configurados por política no lo hacen. Equivalente a pasar `--safe-mode`. Los procesos secundarios generados directamente heredan la variable
`CLAUDE_CODE_SCRIPT_CAPS`	Objeto JSON que limita cuántas veces se pueden invocar scripts específicos por sesión cuando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` se establece. Las claves son subcadenas coincidentes contra el texto del comando; los valores son límites de llamadas enteros. Por ejemplo, `{"deploy.sh": 2}` permite que `deploy.sh` se llame como máximo dos veces. La coincidencia es basada en subcadenas para que trucos de expansión de shell como `./scripts/deploy.sh $(evil)` aún cuenten contra el límite. El fan-out en tiempo de ejecución a través de `xargs` o `find -exec` no se detecta; esto es un control de defensa en profundidad
`CLAUDE_CODE_SCROLL_SPEED`	Establezca el multiplicador de desplazamiento de rueda del ratón en renderizado de pantalla completa. Acepta cualquier valor positivo hasta 20, incluidos valores fraccionarios por debajo de 1 como `0.5` para ralentizar el desplazamiento de trackpad y rueda acelerado en terminales que ya amplifican eventos de rueda. Establezca en `3` para coincidir con `vim` si su terminal envía un evento de rueda por muesca sin amplificación. Se ignora en el terminal IDE de JetBrains, donde Claude Code usa su propio manejo de desplazamiento
`CLAUDE_CODE_SEND_FEEDBACK`	Establezca en `0` para desactivar retroalimentación redactada por Claude para una sesión. Establezca en `1` para activarla donde su cuenta ya tiene acceso; la variable no puede otorgar acceso a sí misma, y los otros interruptores que desactivan la retroalimentación, como `DISABLE_FEEDBACK_COMMAND` y el valor `off` de la configuración `feedbackDrafts`, aún se aplican
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Anule el presupuesto de tiempo en milisegundos para hooks SessionEnd. El valor es también el tiempo de espera para cada hook que no establece su propio `timeout`. Se aplica a salida de sesión, `/clear`, y cambio de sesiones a través de `/resume` interactivo. De forma predeterminada, el presupuesto es 1.5 segundos, aumentado automáticamente al `timeout` por hook más alto configurado en archivos de configuración, hasta 60 segundos. Los tiempos de espera en hooks proporcionados por plugins no aumentan el presupuesto
`CLAUDE_CODE_SESSION_ID`	Se establece automáticamente al ID de sesión actual en subprocesos de herramienta Bash y PowerShell, subprocesos de comando hook, y subprocesos de servidor MCP stdio. Para Bash, PowerShell, y hooks, esto coincide con el campo `session_id` en la entrada JSON del hook y se actualiza en `/clear`. Un subproceso de servidor MCP retiene el ID con el que fue generado. En `--resume <session-id>` recibe el ID reanudado, coincidiendo con hooks y Bash. En `--continue` o `--resume` sin un ID explícito puede recibir el ID de inicio inicial en su lugar. Use para correlacionar scripts y herramientas externas con la sesión de Claude Code que las lanzó
`CLAUDE_CODE_SHELL`	Establezca el shell que Claude Code usa para ejecutar comandos de herramienta Bash. Acepta una ruta a un binario `bash` o `zsh`, por ejemplo `/opt/homebrew/bin/bash`. Otros shells como `fish` no son compatibles. Si el valor no es una ruta de trabajo `bash` o `zsh`, Claude Code lo ignora y vuelve a la auto-detección. La auto-detección usa su `$SHELL` cuando apunta a `bash` o `zsh`, de otra manera elige el primer `zsh` que funciona y luego `bash` encontrado en su `PATH` y ubicaciones de instalación estándar
`CLAUDE_CODE_SHELL_PREFIX`	Prefijo de comando que envuelve comandos de shell que Claude Code genera: llamadas de herramienta Bash, comandos hook, comandos línea de estado, y comandos de inicio de servidor MCP stdio. Los hooks de PowerShell y hooks de forma exec se ejecutan sin el prefijo. Útil para registro o auditoría. Establecer una ruta de ejecutable simple como `/path/to/logger.sh` ejecuta cada comando como `/path/to/logger.sh '<command>'`. El contenedor recibe la línea de comando como un argumento de shell único entre comillas en `$1`, por lo que el contenedor debe re-evaluar `$1` con un shell, por ejemplo `exec bash -c "$1"`. Tratar `$1` como una ruta de ejecutable simple rompe servidores MCP stdio que pasan argumentos como `npx -y <package>`. Para llamadas de herramienta Bash, `$1` contiene la invocación de shell completa que Claude Code ensambla, incluida la configuración del entorno, no solo el comando que Claude ejecutó
`CLAUDE_CODE_SIMPLE`	Establezca en `1` para ejecutar con un prompt del sistema mínimo y solo las herramientas Bash, lectura de archivo, y edición de archivo. Las herramientas MCP de `--mcp-config` aún están disponibles. Desabilita el auto-descubrimiento de hooks, skills, comandos personalizados, subagentes, plugins, servidores MCP, memoria automática, y CLAUDE.md. Las skills en un directorio que pasa con `--add-dir` aún se cargan. Los tokens OAuth y credenciales de llavero no se leen, por lo que la autenticación de Anthropic debe provenir de `ANTHROPIC_API_KEY` o un `apiKeyHelper` en `--settings`. Equivalente a pasar `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Establezca en `1` para usar un prompt del sistema más corto y descripciones de herramientas abreviadas en cualquier modelo. Establezca en `0`, `false`, `no`, u `off` para optar por no participar incluso en modelos donde el experimento o la configuración del servidor de otra manera lo habilitaría. El conjunto completo de herramientas, descubrimiento de hooks, servidores MCP, y descubrimiento de CLAUDE.md permanecen habilitados
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Omita la autenticación del lado del cliente para Claude Platform on AWS, para puertas de enlace que firman solicitudes a sí mismas
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	Establezca en `1` para desactivar el caché en proceso de credenciales resueltas de la cadena de proveedores de credenciales predeterminada de AWS, por lo que Claude Code resuelve la cadena en cada solicitud de API. Con el caché desactivado, un perfil respaldado por SSO solicita credenciales de IAM Identity Center en cada solicitud. Vea almacenamiento en caché de credenciales y tiempo de espera de resolución. Requiere Claude Code v2.1.207 o posterior
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Omita la autenticación de AWS para Amazon Bedrock (por ejemplo, cuando Use una puerta de enlace LLM)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	Establezca en `1` para tratar una comprobación de disponibilidad de modo rápido fallida como disponible, para redes que bloquean la solicitud directa de la comprobación a `api.anthropic.com`. Claude Code aún honra una respuesta "deshabilitada por su organización"
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	Establezca en `1` para omitir la comprobación de disponibilidad de modo rápido del lado del cliente, para proxies que interceptan la solicitud de la comprobación en lugar de rechazarla. La API aún rechaza solicitudes de modo rápido cuando su organización tiene modo rápido deshabilitado
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Omita la autenticación de Azure para Microsoft Foundry, para un proxy o puerta de enlace que inyecta su propio encabezado `Authorization`. Claude Code envía solicitudes sin una credencial de Azure y preserva el encabezado `Authorization` que suministra, por ejemplo a través de `ANTHROPIC_CUSTOM_HEADERS`. Se ignora cuando `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN` se establece. Antes de v2.1.203, esta variable dejó al cliente de Microsoft Foundry incapaz de enviar solicitudes a menos que también se estableciera una clave de API
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Omita la autenticación de AWS para Amazon Bedrock Mantle (por ejemplo, cuando Use una puerta de enlace LLM)
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	Establezca en `1` para omitir escribir historial de prompts y transcripciones de sesión en disco. Las sesiones iniciadas con esta variable establecida no aparecen en `--resume`, `--continue`, o historial de flecha hacia arriba. Útil para sesiones de script efímeras
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Omita la autenticación de Google para Google Cloud's Agent Platform (por ejemplo, cuando Use una puerta de enlace LLM)
`CLAUDE_CODE_STARTUP_FAILURE_RESULTS`	Establezca en `1` para que una sesión iniciada con `--output-format stream-json` escriba un mensaje de resultado que nombre por qué Claude Code se negó a iniciar para fallos de inicio que de otra manera terminan solo con stderr. Requiere Claude Code v2.1.274 o posterior
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Número máximo de veces consecutivas que un hook Stop o SubagentStop puede bloquear el final del turno antes de que Claude Code lo anule y termine el turno de todas formas (predeterminado: 8). Establezca en `0` para desabilitar el límite. Aumente esto si su hook legítimamente necesita más iteraciones para resolver
`CLAUDE_CODE_SUBAGENT_MODEL`	El modelo predeterminado para subagentes, compañeros de equipo de agentes, y agentes de flujo de trabajo que no se asignan un modelo de otra manera. Acepta un alias como `haiku` o un nombre de modelo completo. Dos fuentes tienen precedencia sobre él: un modelo que Claude pasa cuando genera el agente, y un campo `model` en la definición del agente, incluido `inherit`. Para cambiar eso, establezca `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`. Vea Elegir un modelo para el orden completo. Establecerlo en `inherit` es lo mismo que dejarlo sin establecer. Antes de v2.1.251, esta variable anulaba tanto el modelo por invocación como el campo `model` de la definición
`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`	Establezca en `1` para forzar un modelo en subagentes, compañeros, y agentes de flujo de trabajo. Ejecutar cada subagente en un modelo dice cuál es ese modelo. Requiere Claude Code v2.1.257 o posterior
`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`	Establezca `5m` o `1h`, los únicos valores que Claude Code acepta, para elegir el TTL de caché de prompt para solicitudes fuera de la conversación principal, como subagentes, flujos de trabajo, y trabajo de fondo. Tiene precedencia sobre la configuración `subagentPromptCacheTtl` y sobre `ENABLE_PROMPT_CACHING_1H`, y `FORCE_PROMPT_CACHING_5M` la anula. Las escrituras de caché de 1 hora se facturan a una tasa más alta. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Establezca en `1` para eliminar credenciales de entornos de subproceso (herramienta Bash, hooks, servidores MCP stdio): credenciales de Anthropic y proveedor de nube, cualquier otra variable que Claude Code reconozca como credencial, y credenciales incrustadas en URLs de registro de paquetes. El proceso Claude padre mantiene estas credenciales para llamadas de API, pero los procesos secundarios no pueden leerlas, reduciendo la exposición a ataques de inyección de prompts que intentan exfiltrar secretos a través de expansión de shell. En v2.1.251 o posterior, el scrub también elimina variables de puntero de almacén de configuración de Claude Code (como `CLAUDE_CONFIG_DIR`), por lo que un proceso secundario no puede ubicar un directorio de configuración reubicado. Deje el scrub sin establecer si un subproceso necesita estas variables. En Linux, esto también ejecuta subprocesos Bash en un espacio de nombres PID aislado para que no puedan leer entornos de proceso host a través de `/proc`; como efecto secundario, `ps`, `pgrep`, y `kill` no pueden ver o señalar procesos host. `claude-code-action` establece esto automáticamente cuando `allowed_non_write_users` se configura
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Establezca en `1` en modo no interactivo (la bandera `-p`) para esperar a que se complete la instalación del plugin antes de la primera consulta. Sin esto, los plugins se instalan en el fondo y pueden no estar disponibles en el primer turno. Combine con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar la espera
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`	Tiempo de espera en milisegundos para instalación sincrónica de plugins. Cuando se excede, Claude Code procede sin plugins y registra un error. Sin predeterminado: sin esta variable, la instalación sincrónica espera hasta completarse
`CLAUDE_CODE_SYNC_SKILLS`	Establezca en `1` en modo no interactivo con la bandera `-p` para hacer que Claude Code descargue las skills habilitadas para su cuenta de claude.ai en esa ejecución y espere la lista de ellas, hasta `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de ejecutar la primera consulta. Las descargas en sí se completan en el fondo, y Claude espera la descarga de una skill cuando la invoca. Requiere autenticación de claude.ai. Las sesiones de terminal donde inicia sesión con su cuenta de claude.ai descargan estas skills en `~/.claude/skills/synced/` y resincronizan aproximadamente cada 10 minutos sin esta variable, por lo que establézcala solo cuando una ejecución `-p` necesite sus skills actuales en su primera consulta. Antes de v2.1.273, las sesiones de terminal las descargaban solo en una ejecución `-p` con esta variable establecida. El nombre de carpeta `synced` está reservado para esta descarga. Antes de v2.1.227, las skills se descargaban en `~/.claude/skills/` directamente. Claude Code aplica reglas extra a las skills descargadas, como no ejecutar sus comandos `!` en su máquina
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Tiempo de espera en milisegundos para la resincronización de skills que se ejecuta a mitad de sesión cuando una aplicación construida en el Agent SDK recarga skills (predeterminado: 30000). Cuando se excede, la recarga continúa con cualquiera que sea las skills que hayan llegado, y las descargas restantes se completan en el fondo
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Tiempo de espera en milisegundos para que la primera consulta espere la lista de skills inicial cuando `CLAUDE_CODE_SYNC_SKILLS` se establece (predeterminado: 5000). Cuando se excede, la primera consulta se ejecuta con cualquiera que sea las skills que hayan llegado. Las descargas se completan en el fondo de cualquier forma, y Claude espera la descarga de una skill cuando la invoca
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Establezca en `false` para desabilitar el resaltado de sintaxis en la salida de diferencia. Útil cuando los colores interfieren con su configuración de terminal. Para también desabilitar el resaltado en bloques de código y vistas previas de archivo, use la configuración `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Comparta una lista de tareas entre sesiones. Establezca el mismo ID en múltiples instancias de Claude Code para coordinar en una lista de tareas compartida, en sesiones que tienen las herramientas Task. Vea Lista de tareas
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Anule, en milisegundos, cuánto tiempo una sesión no interactiva espera al salir para que su equipo de agentes termine de desmantelarse. Acepta 1000 a 60000; un valor fuera de rango se ignora y se aplica el predeterminado de 10000. Requiere Claude Code v2.1.206 o posterior
`CLAUDE_CODE_TMPDIR`	Anule el directorio temporal utilizado para archivos temporales internos. Claude Code añade `/claude-{uid}/` en Unix o `/claude/` en Windows a esta ruta. Predeterminado: `/tmp` en macOS, `os.tmpdir()` en Linux y Windows. En macOS y Linux, los subprocesos Bash sandboxed reciben un `$TMPDIR` de respaldo corto bajo el predeterminado del sistema cuando su anulación es una ruta larga, ya que algunas herramientas fallan cuando las rutas temporales se vuelven demasiado largas. Los comandos Bash no sandboxed heredan su `$TMPDIR` de shell sin cambios. Los archivos temporales propios de Claude Code siempre usan su anulación. Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local
`CLAUDE_CODE_TMUX_TRUECOLOR`	Establezca en cualquier valor no vacío, como `1`, para permitir salida de truecolor de 24 bits dentro de tmux. Establecerlo en `0` o `false` aún permite truecolor, a diferencia de la mayoría de variables de activación/desactivación; desestablezca la variable para restaurar el límite de 256 colores. De forma predeterminada, Claude Code se limita a 256 colores cuando `$TMUX` se establece porque tmux no pasa secuencias de escape de truecolor a menos que se configure. Establezca esto después de agregar `set -ga terminal-overrides ',*:Tc'` a su `~/.tmux.conf`. Vea Configuración de terminal para otras configuraciones de tmux
`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`	En Linux y WSL, establezca en una lista separada por comas de los tipos de procesos que Claude Code excluye del límite de memoria de herramientas, como `mcp` o `lsp`. Establezca `none` para limitar cada tipo, o `all-new` para limitar solo comandos de herramientas Bash, PowerShell, y Monitor. Claude Code mantiene comandos de herramientas Bash, PowerShell, y Monitor bajo el límite cualquiera que sea lo que enumere. Requiere Claude Code v2.1.246 o posterior
`CLAUDE_CODE_TOOL_MEMORY_LIMIT`	En Linux y WSL, establezca en un tamaño como `4G` para limitar la memoria que los comandos de herramientas Bash y PowerShell pueden usar, y comandos de herramientas Monitor en v2.1.246 o posterior. Escriba el tamaño en dígitos simples, solo para un número de bytes o con un sufijo `K`, `M`, `G`, o `T`. Establezca `0` u `off` para desactivar el límite. Una vez que el primer proceso que Claude Code inicia ha activado o desactivado el límite, un valor cambiado tiene efecto la próxima vez que inicia `claude`. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`	Plazo en milisegundos antes de que Claude Code cancele un diálogo que reenvía a un cliente remoto como un Remote Control o host SDK, o el diálogo de aprobación para un mensaje entre sesiones retenido; los prompts de permiso y las preguntas `AskUserQuestion` usan sus propios flujos y no se rigen por él. En Claude Code v2.1.236 o posterior, también limita el prompt de consentimiento de créditos de uso de Fable a mitad de sesión en una sesión que puede estar ejecutándose desatendida. Controlar mensajes entrantes y sesiones no interactivas cubren las reglas de vencimiento de mensaje retenido completo, incluidos los casos donde el plazo no se aplica. Anula la configuración `dialogExpiry`. `0` o un valor negativo desabilita el plazo
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Use Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Use Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Use Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Use el punto de conexión Mantle de Amazon Bedrock
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	Establezca en `1` para descubrir comandos personalizados, subagentes, y estilos de salida usando APIs de archivo de Node.js en lugar de ripgrep. Establezca esto si el binario ripgrep agrupado no está disponible o está bloqueado en su entorno. No afecta las herramientas Grep o búsqueda de archivo
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controla la herramienta PowerShell. En Windows sin Git Bash, la herramienta está habilitada automáticamente; establezca en `0` para deshabilitarla. En Windows con Git Bash instalado, la herramienta está activada de forma predeterminada para cuentas de claude.ai y Console; establezca en `1` para habilitarla en sesiones de Amazon Bedrock, Google Cloud's Agent Platform, y Microsoft Foundry, o `0` para desactivarla. En Linux, macOS, y WSL, establezca en `1` para habilitarla, que requiere `pwsh` en su `PATH`. Cuando está habilitada en Windows, Claude puede ejecutar comandos de PowerShell de forma nativa en lugar de enrutarlos a través de Git Bash. Vea Herramienta PowerShell
`CLAUDE_CODE_USE_VERTEX`	Use Google Cloud's Agent Platform
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	Establezca en el número de milisegundos que WebFetch mantiene la respuesta de cada URL obtenida en caché. El predeterminado es `900000`, que es 15 minutos. Solo acepta dígitos simples; `0`, un decimal, o cualquier otro deletreo mantiene el predeterminado. Claude Code lee el valor una vez por lanzamiento, por lo que un cambio en un bloque `env` de configuración se aplica cuando inicia `claude` nuevamente. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	Límite superior en milisegundos en cuánto tiempo WebFetch espera a que se descargue una página, incluidos los redireccionamientos que sigue. Una descarga que no se ha completado para entonces falla con un error de plazo. El predeterminado es `300000`, que es cinco minutos. Establezca en `0` para eliminar el límite. Solo acepta dígitos simples; un decimal o cualquier otro deletreo mantiene el predeterminado. Requiere Claude Code v2.1.268 o posterior
`CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS`	Cuántos agentes un único flujo de trabajo ejecuta a la vez, de `1` a `256`. De forma predeterminada, una ejecución ejecuta hasta 16 agentes a la vez, menos cuando Claude Code tiene menos CPUs disponibles; las llamadas `agent()` en cola esperan un espacio libre. La transcripción de cada agente en ejecución permanece en la memoria de Claude Code, por lo que los valores más altos aumentan el uso de memoria. Solo acepta dígitos simples; los valores fuera de rango y otros deletreos mantienen el predeterminado. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS`	Límite superior en milisegundos en cuánto tiempo un agente de flujo de trabajo espera a que la primera respuesta de un hermano con el mismo prefijo comience antes de enviar su propia primera solicitud. Cuando un fan-out inicia varios agentes que comparten un prefijo de caché de prompt, Claude Code mantiene todos excepto el primer agente durante hasta este tiempo para que el resto lea el prefijo en caché en lugar de procesarlo sin caché. Predeterminado `5000`. Establezca en `0` para desabilitar la espera. Cuando `DISABLE_PROMPT_CACHING` se establece, los agentes nunca esperan. Requiere Claude Code v2.1.229 o posterior
`CLAUDE_CONFIG_DIR`	Anule el directorio de configuración (predeterminado: `~/.claude`). Toda la configuración, historial de sesión, y plugins se almacenan bajo esta ruta. Para credenciales, vea dónde Claude Code almacena credenciales. Útil para ejecutar múltiples cuentas lado a lado: por ejemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local
`CLAUDE_DISABLE_ADOPT`	Establezca en `1` para detener el trabajo de fondo en vuelo en lugar de llevarlo cuando envía una sesión a segundo plano presionando `←` o con `/background`. Claude Code le pide que confirme antes de enviar a segundo plano, luego detiene las tareas que de otra manera se llevarían. Requiere Claude Code v2.1.195 o posterior
`CLAUDE_EFFORT`	Se establece automáticamente en subprocesos de herramienta Bash y comandos hook al nivel de esfuerzo en efecto cuando el subproceso comienza: `low`, `medium`, `high`, `xhigh`, o `max`. Ultracode no es un nivel distinto e informa como `xhigh`. Coincide con el campo `effort.level` pasado a hooks. Solo se establece cuando el modelo actual admite el parámetro de esfuerzo
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Establezca en `1` para forzar la habilitación del perro guardián de inactividad de transmisión a nivel de byte, o establezca en `0` para forzar su deshabilitación. `0` también desactiva el plazo de primer byte en las conexiones donde se ejecuta ese plazo. Cuando no se establece, el perro guardián está habilitado de forma predeterminada para conexiones directas de API de Anthropic y Claude Platform on AWS, y para respuestas de transmisión en conexiones de puerta de enlace alcanzadas a través de `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; antes de v2.1.222 no se ejecutaba en esas conexiones de puerta de enlace, por lo que el perro guardián a nivel de evento podría informar un estancamiento allí incluso mientras se llegaban pings de mantenimiento. Para tiempos de espera y cómo interactúan los temporizadores, vea Perros guardianes de inactividad de transmisión
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Establezca en `1` para habilitar el perro guardián de inactividad de transmisión a nivel de byte en respuestas de Amazon Bedrock `vnd.amazon.eventstream`, que también habilita el plazo de primer byte en solicitudes de transmisión de Bedrock. Desactivado de forma predeterminada. Configure el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Establezca en `0` para forzar la deshabilitación del perro guardián de inactividad de transmisión a nivel de evento, o establezca en `1` para forzar su habilitación. Cuando no se establece, el perro guardián está activado de forma predeterminada para todos los proveedores. Antes de v2.1.196, el predeterminado sin establecer era controlado por servidor en la API directa de Anthropic y desactivado en otros proveedores. Configure el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para los otros temporizadores de estancamiento que se ejecutan junto a este, vea Perros guardianes de inactividad de transmisión
`CLAUDE_ENV_FILE`	Ruta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando Bash en el mismo proceso de shell, por lo que las exportaciones en el archivo son visibles para el comando. Use para persistir activación de virtualenv o conda entre comandos. También se rellena dinámicamente por hooks SessionStart, Setup, CwdChanged, y FileChanged
`CLAUDE_JOB_DIR`	Se establece por Claude Code en cada sesión de fondo a ese directorio `~/.claude/jobs/<id>` de la sesión. Los comandos de shell que la sesión ejecuta lo heredan. Escriba archivos de borrador en `$CLAUDE_JOB_DIR/tmp`. Las llamadas `Write` y `Edit` de Claude allí no solicitan permiso, y el directorio se elimina cuando se elimina la sesión
`CLAUDE_PID`	Claude Code establece esto en su propio ID de proceso en los subprocesos que genera: comandos de herramientas Bash y PowerShell y comandos hook. En Linux, la integración de shell de la herramienta Bash lo usa para rechazar un patrón `pkill` que coincidiría con el proceso Claude Code en sí; vea la referencia de error. Léalo desde sus propios scripts para identificar o señalar deliberadamente el proceso Claude Code padre. Requiere Claude Code v2.1.214 o posterior
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefijo para nombres de sesión Remote Control generados automáticamente cuando no se proporciona un nombre explícito. El valor predeterminado es el nombre de host de su máquina, produciendo nombres como `myhost-graceful-unicorn`. La bandera CLI `--remote-control-session-name-prefix` establece el mismo valor para una única invocación
`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`	Plazo en milisegundos para el primer byte de respuesta de una solicitud de transmisión, en las conexiones donde se ejecuta el plazo de primer byte. Para cómo Claude Code lo fija, el tiempo extra que agrega para cuerpos de solicitud grandes, y cómo elige el plazo cuando deja esto sin establecer, vea Sin respuesta de API. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Tiempo de espera en milisegundos antes de que los perros guardianes de inactividad de transmisión a nivel de evento y byte cierren una conexión estancada. Cuando establece esta variable explícitamente, el mínimo es `300000` (5 minutos); los valores más bajos se fijan silenciosamente al mínimo para absorber pausas de pensamiento extendido y almacenamiento en búfer de proxy, y el perro guardián a nivel de byte limita el valor a 30 minutos. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` tiene precedencia sobre esta variable para el perro guardián a nivel de byte. Para los valores predeterminados sin establecer por perro guardián, vea Perros guardianes de inactividad de transmisión
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	Eliminado en v2.1.260 y ahora es un no-op. Anteriormente limitaba cuánto tiempo un comando de shell de fondo que un subagente iniciaba podía ejecutarse, en milisegundos, con un predeterminado de 60 minutos. Vea las reglas de vida útil del comando de fondo
`DEBUG`	Establezca en `1` para habilitar el modo de depuración, equivalente a lanzar con `--debug`. Los registros de depuración se escriben en `~/.claude/debug/<session-id>.txt`, o en la ruta establecida por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo los valores verdaderos `1`, `true`, `yes`, y `on` habilitan el modo de depuración, por lo que patrones de espacio de nombres como `DEBUG=express:*` establecidos para otras herramientas no lo activan
`DISABLE_AUTOUPDATER`	Establezca en `1` para desabilitar actualizaciones automáticas de fondo. El `claude update` manual aún funciona. Use `DISABLE_UPDATES` para bloquear ambos
`DISABLE_AUTO_COMPACT`	Establezca en `1` para desabilitar la compactación automática cuando se acerca al límite de contexto. El comando manual `/compact` permanece disponible. Use cuando desee control explícito sobre cuándo ocurre la compactación. Anula la configuración `autoCompactEnabled`
`DISABLE_COMPACT`	Establezca en `1` para desabilitar toda la compactación: tanto la compactación automática como el comando manual `/compact`
`DISABLE_COST_WARNINGS`	Establezca en `1` para desabilitar mensajes de advertencia de costo
`DISABLE_DOCTOR_COMMAND`	Establezca en `1` para ocultar la skill `/doctor` de verificación de configuración y su alias `/checkup`. Útil para implementaciones administradas donde los usuarios no deberían ejecutar diagnósticos de configuración desde una sesión. No afecta el comando de terminal `claude doctor`. Antes de v2.1.205, esta variable ocultaba la pantalla de comando `/doctor` de diagnósticos
`DISABLE_ERROR_REPORTING`	Establezca en cualquier valor no vacío, como `1`, para optar por no participar en informes de errores. Establecerlo en `0` o `false` aún opta por no participar, a diferencia de la mayoría de variables de activación/desactivación; desestablezca la variable para volver a activar los informes de errores
`DISABLE_EXTRA_USAGE_COMMAND`	Establezca en `1` para ocultar el comando `/usage-credits` que permite a los usuarios comprar uso adicional más allá de límites de velocidad
`DISABLE_FEEDBACK_COMMAND`	Establezca en `1` para desabilitar el comando `/feedback` y retroalimentación redactada por Claude. También desabilita `/bug` y `/share`, que informan a través de la misma ruta; antes de v2.1.212 eran alias de `/feedback`, por lo que el comando se deshabilitaba bajo cada nombre. El nombre anterior `DISABLE_BUG_COMMAND` también se acepta
`DISABLE_GROWTHBOOK`	Establezca en `1` o `true` para desabilitar la obtención de banderas de características de GrowthBook y usar valores predeterminados de código para cada bandera. Esto hace que Remote Control y las otras características que necesitan obtención de banderas de características no estén disponibles. Establecerlo en `0` o `false` deja la obtención activada. El registro de eventos de telemetría permanece activado a menos que `DISABLE_TELEMETRY` también se establezca
`DISABLE_INSTALLATION_CHECKS`	Establezca en `1` para desabilitar advertencias de instalación. Use solo cuando administre manualmente la ubicación de instalación, ya que esto puede enmascarar problemas con instalaciones estándar
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Establezca en `1` para ocultar el comando `/install-github-app`. Ya está oculto cuando se usan proveedores de terceros (Amazon Bedrock, Google Cloud's Agent Platform, o Microsoft Foundry)
`DISABLE_INTERLEAVED_THINKING`	Establezca en `1` para evitar enviar el encabezado beta de pensamiento intercalado. Útil cuando su puerta de enlace LLM o proveedor no admite pensamiento intercalado
`DISABLE_LOGIN_COMMAND`	Establezca en `1` para ocultar el comando `/login`. Útil cuando la autenticación se maneja externamente a través de claves de API o `apiKeyHelper`
`DISABLE_LOGOUT_COMMAND`	Establezca en `1` para ocultar el comando `/logout`
`DISABLE_PROMPT_CACHING`	Establezca en `1` para desabilitar almacenamiento en caché de prompt para todos los modelos (tiene precedencia sobre configuraciones por modelo)
`DISABLE_PROMPT_CACHING_FABLE`	Establezca en `1` para desabilitar el almacenamiento en caché de prompt para modelos Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Establezca en `1` para desabilitar el almacenamiento en caché de prompt para modelos Haiku
`DISABLE_PROMPT_CACHING_OPUS`	Establezca en `1` para desabilitar el almacenamiento en caché de prompt para modelos Opus
`DISABLE_PROMPT_CACHING_SONNET`	Establezca en `1` para desabilitar el almacenamiento en caché de prompt para modelos Sonnet
`DISABLE_TELEMETRY`	Establezca en cualquier valor no vacío, como `1`, para optar por no participar en telemetría. Establecerlo en `0` o `false` aún opta por no participar, a diferencia de la mayoría de variables de activación/desactivación; desestablezca la variable para volver a activar la telemetría. Los eventos de telemetría no incluyen datos de usuario como código, rutas de archivo, o comandos bash. También desabilita la obtención de banderas de características con el mismo efecto que `DISABLE_GROWTHBOOK`, que hace que Remote Control y las otras características que necesitan obtención de banderas de características no estén disponibles. Vea Desactivar telemetría para su organización
`DISABLE_UPDATES`	Establezca en `1` para bloquear todas las actualizaciones, incluido el `claude update` manual y `claude install`. Más estricto que `DISABLE_AUTOUPDATER`. Use cuando distribuya Claude Code a través de sus propios canales y los usuarios no deberían auto-actualizar
`DISABLE_UPGRADE_COMMAND`	Establezca en `1` para ocultar el comando `/upgrade`
`DO_NOT_TRACK`	Establezca en `1` para optar por no participar en telemetría, con el mismo efecto que `DISABLE_TELEMETRY`, incluida la no disponibilidad de Remote Control y las otras características que necesitan obtención de banderas de características. Claude Code lee esta variable como un booleano estándar, por lo que `0` deja la telemetría activada, y la honra como la convención entre herramientas reconocida por muchas CLI de desarrollador
`ENABLE_BETA_TRACING_DETAILED`	Establezca en `1`, junto con `BETA_TRACING_ENDPOINT`, para activar rastreo beta detallado, que agrega atributos que llevan contenido y el tramo `claude_code.hook`. Las sesiones CLI interactivas también requieren que su organización esté en la lista de permitidos para la beta. Ambas variables se ignoran en configuración de proyecto y local
`ENABLE_CLAUDEAI_MCP_SERVERS`	Establezca en `false` para evitar que Claude Code obtenga servidores MCP de claude.ai. Habilitado de forma predeterminada para usuarios con sesión iniciada. Para desabilitar por proyecto u organización, establezca `disableClaudeAiConnectors` en configuración en su lugar
`ENABLE_PROMPT_CACHING_1H`	Establezca en `1` para solicitar un TTL de caché de prompt de 1 hora en lugar del predeterminado de 5 minutos. Destinado a usuarios de clave de API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, y Claude Platform on AWS. Los usuarios de suscripción dentro del uso incluido reciben el TTL de 1 hora automáticamente en la conversación principal. Los usuarios de suscripción que extraen créditos de uso pueden establecerlo para mantener el TTL de 1 hora. Las escrituras de caché de 1 hora se facturan a una tasa más alta. Para elegir el TTL por depósito de solicitud en su lugar, use `CLAUDE_CODE_PROMPT_CACHE_TTL` y `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que tienen precedencia sobre esta variable
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Deprecated. Use `ENABLE_PROMPT_CACHING_1H` en su lugar
`ENABLE_TOOL_SEARCH`	Controla búsqueda de herramientas MCP. Sin establecer, Claude Code difiere todas las herramientas MCP de forma predeterminada. Aún las carga por adelantado en modelos de Google Cloud's Agent Platform anteriores a la generación Claude 4.5, en una implementación de Microsoft Foundry alojada en Azure, y cuando `ANTHROPIC_BASE_URL` apunta a un host que no es de primera parte. `true` siempre difiere y envía el encabezado beta, excepto en esos mismos modelos de Agent Platform e implementaciones de Microsoft Foundry; las solicitudes fallan en proxies que no admiten `tool_reference`. `auto` carga por adelantado cuando las definiciones de herramientas caben dentro del 10% del contexto. `auto:N` establece un umbral personalizado, como `auto:5` para 5%. `false` carga todas las herramientas por adelantado. Un valor que establece usted mismo se ignora cuando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` se establece. Antes de v2.1.221, Claude Code deshabilitaba la búsqueda de herramientas para todos los modelos en Google Cloud's Agent Platform a menos que estableciera esta variable en `true`
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Establezca en cualquier valor no vacío, como `1`, para hacer que Claude Code deje de reintentar en errores de sobrecarga repetidos para cada modelo cuando no hay modelo de respaldo configurado. Establecerlo en `0` o `false` aún habilita esto, a diferencia de la mayoría de variables de activación/desactivación; desestablezca la variable para restaurar el comportamiento de reintento predeterminado. Sin él, Claude Code deja de reintentar de esta manera en modelos que reconoce como modelos Opus, Fable, o Mythos cuando se autentica con una clave de API o un proveedor de terceros en lugar de una suscripción a Claude. En Claude Code v2.1.160 o posterior, Claude Code cambia a su cadena de modelo de respaldo configurada en errores de sobrecarga repetidos para cualquier modelo principal, por lo que esta variable no afecta el cambio a un modelo de respaldo
`FORCE_AUTOUPDATE_PLUGINS`	Establezca en `1` para forzar auto-actualizaciones de plugins incluso cuando el auto-actualizador principal está deshabilitado a través de `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Establezca en `1` para habilitar hipervínculos OSC 8 clicables cuando su terminal los admite pero no se auto-detecta, o `0` para deshabilitarlos. Cuando no se establece, Claude Code habilita hipervínculos solo cuando detecta soporte de terminal. Claude Code analiza este valor como un número, no un booleano, por lo que un valor como `false`, `no`, u `off` habilita hipervínculos en lugar de deshabilitarlos. El pie de página insignia de estado de PR o solicitud de fusión se renderiza como un hipervínculo incluso cuando Claude Code no puede detectar soporte de terminal, como sobre SSH. Establezca `0` para renderizar la insignia como texto simple
`FORCE_PROMPT_CACHING_5M`	Establezca en `1` para forzar el TTL de caché de prompt de 5 minutos incluso cuando el TTL de 1 hora se aplicaría de otra manera. Anula `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H`, y las configuraciones `promptCacheTtl` y `subagentPromptCacheTtl`
`HTTP_PROXY`	Especifique el servidor proxy HTTP para conexiones de red
`HTTPS_PROXY`	Especifique el servidor proxy HTTPS para conexiones de red
`IS_DEMO`	Establezca en cualquier valor no vacío, como `1`, para habilitar el modo de demostración: oculta su correo electrónico y nombre de organización del encabezado y salida `/status`, y omite la incorporación. Establecerlo en `0` o `false` aún habilita el modo de demostración, a diferencia de la mayoría de variables de activación/desactivación; desestablezca la variable para desactivarlo. Útil cuando transmite o graba una sesión
`MAX_MCP_OUTPUT_TOKENS`	Número máximo de tokens permitidos en respuestas de herramientas MCP. Claude Code muestra una advertencia cuando la salida excede 10,000 tokens. Las herramientas que declaran `anthropic/maxResultSizeChars` usan ese límite de caracteres para contenido de texto en su lugar, pero el contenido de imagen de esas herramientas aún está sujeto a esta variable (predeterminado: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Número de intentos que Claude Code permite cuando la respuesta del modelo falla en la validación contra el `--json-schema` en modo no interactivo con la bandera `-p`; después de esa cantidad de intentos fallidos sin salida válida, la ejecución falla. El mismo límite se aplica cuando la salida estructurada de un subagente de flujo de trabajo falla en la validación. El valor predeterminado es 5, un primer intento más cuatro reintentos
`MAX_THINKING_TOKENS`	Presupuesto de token fijo para pensamiento extendido. Claude Code lo limita a un token por debajo de los tokens de salida máximos de la solicitud y nunca por debajo de 1,024. Vea `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para cómo se establece ese límite. Cuando no se establece y el pensamiento está habilitado, los modelos con razonamiento adaptativo eligen su propia profundidad de pensamiento, y otros modelos usan el límite. Establezca en `0` para desabilitar el pensamiento en la API de Anthropic, excepto en Opus 5.5 y los modelos Fable, que no pueden tener el pensamiento deshabilitado. En proveedores de terceros, `0` omite el parámetro `thinking` en su lugar. Con el pensamiento deshabilitado en la API de Anthropic, Claude Code envía esfuerzo `high` en lugar de un nivel más alto a modelos que sabe que no aceptan esa combinación, como Opus 5. Claude Code ignora valores distintos de cero en modelos de razonamiento adaptativo, excepto en los modelos donde `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desactiva el razonamiento adaptativo
`MCP_CLIENT_SECRET`	Secreto de cliente OAuth para servidores MCP que requieren credenciales preconfiguradas. Evita el prompt interactivo al agregar un servidor con `--client-secret`
`MCP_CONNECTION_NONBLOCKING`	Controla si el inicio espera a que los servidores MCP se conecten antes de la primera consulta. El inicio de MCP es no bloqueante de forma predeterminada: los servidores se conectan en el fondo y sus herramientas se vuelven disponibles a medida que terminan. Establezca en `0` para hacer que Claude Code espere a que los servidores se conecten antes de la primera consulta. Los servidores configurados con `alwaysLoad: true` aún hacen que el inicio espere independientemente, excepto cuando se sirven desde el caché de descubrimiento, ya que sus herramientas deben estar presentes cuando se construye el primer prompt. En modo no interactivo (`-p`) sin `--input-format stream-json`, Claude Code también espera a los servidores aún pendientes antes del primer turno independientemente de esta variable. Cuando pasa `--mcp-config` explícitamente, la espera tiene un plazo más largo; vea esa entrada de bandera para la excepción de servidor en caché
`MCP_CONNECT_TIMEOUT_MS`	Cuánto tiempo espera el inicio de MCP bloqueante, en milisegundos, para el lote de conexión antes de tomar una instantánea de la lista de herramientas (predeterminado: 5000). Se aplica cuando `MCP_CONNECTION_NONBLOCKING=0` o para servidores marcados `alwaysLoad: true`. Los servidores aún pendientes en el plazo continúan conectándose en el fondo. Distinto de `MCP_TIMEOUT`, que limita el intento de conexión de un servidor individual
`MCP_DISCOVERY_CACHE`	Activa o desactiva el caché de descubrimiento de MCP. Con el caché activado, un servidor HTTP o SSE remoto que ha usado antes puede mostrar el estado `cached`, y Claude Code se conecta en su primera llamada de herramienta en lugar de al inicio. El caché está desactivado de forma predeterminada a menos que un lanzamiento gradual lo haya habilitado para su cuenta. Establezca en `1` para activarlo, o `0` para mantenerlo desactivado incluso cuando el lanzamiento lo ha habilitado. Antes de v2.1.238, el caché estaba activado de forma predeterminada. El estado `cached` requiere Claude Code v2.1.221 o posterior
`MCP_DISCOVERY_CACHE_MAX_STALE_S`	Edad máxima, en segundos, de una entrada de caché de descubrimiento (predeterminado: 14400, o 4 horas). En un inicio donde la entrada es más antigua que eso, Claude Code la descarta y conecta el servidor al inicio, como lo hace con el caché desactivado. Claude Code limita el valor a 7 días. Antes de v2.1.238, el predeterminado era 86400, o 24 horas, y Claude Code no limitaba el valor
`MCP_DISCOVERY_CACHE_STRIKES`	En un inicio donde una entrada de caché de descubrimiento es más antigua que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la actualiza en el fondo. Esta variable establece cuántas actualizaciones seguidas pueden fallar antes de que Claude Code descarte la entrada y conecte el servidor en el siguiente inicio en su lugar (predeterminado: 1). Aumente si su conexión de red se cae ocasionalmente, para que un fallo de actualización no descarte la entrada. Requiere Claude Code v2.1.238 o posterior
`MCP_DISCOVERY_CACHE_TTL_S`	Segundos durante los cuales Claude Code usa una entrada de caché de descubrimiento sin actualizarla (predeterminado: 900). En un inicio donde la entrada es más antigua que eso, Claude Code aún la usa pero la actualiza en el fondo. Una vez que la entrada es más antigua que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la descarta en su lugar. Claude Code limita el valor a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, que es 4 horas de forma predeterminada. Antes de v2.1.238, Claude Code no limitaba el valor
`MCP_OAUTH_CALLBACK_PORT`	Puerto fijo para la devolución de llamada de redireccionamiento de OAuth, como alternativa a `--callback-port` al agregar un servidor MCP con credenciales preconfiguradas
`MCP_PROTOCOL_NEGOTIATION`	En el tiempo de ejecución del cliente MCP v2 solo, si Claude Code sondea servidores para la revisión del protocolo MCP 2026-07-28. Establezca `auto` para sondear servidores HTTP, conector de claude.ai, y stdio; un servidor que no responda al sondeo se conecta en el protocolo anterior en su lugar, como los servidores SSE y WebSocket siempre lo hacen. Establezca `legacy` para omitir el sondeo para cada servidor. Sin la variable, Claude Code sondea servidores HTTP, y también sondea servidores de conector de claude.ai en las sesiones en las que obtiene banderas de características. Cualquier otro valor se ignora con una advertencia en el registro de depuración. Requiere Claude Code v2.1.221 o posterior
`MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE`	Número máximo de servidores MCP remotos (HTTP/SSE) para conectar en paralelo durante el inicio (predeterminado: 20)
`MCP_SDK_GENERATION`	Fije qué tiempo de ejecución del cliente MCP este proceso se conecta a servidores MCP con: `v1`, construido en MCP TypeScript SDK 1.x, o `v2`, construido en MCP TypeScript SDK 2.0. Sin la variable, Claude Code usa v2, a partir de las versiones enumeradas en esa sección. En Claude Code v2.1.221 o posterior, el tiempo de ejecución v2 verifica el emisor que un servidor OAuth de MCP devuelve en su respuesta de autorización y falla el inicio de sesión con un error que comienza `Issuer mismatch in authorization response` cuando no coincide. El tiempo de ejecución v1 no ejecuta esta verificación. Si establece un valor no reconocido, Claude Code lo ignora y escribe una advertencia en el registro de depuración. Claude Code lee el valor una vez por proceso. Requiere Claude Code v2.1.218 o posterior
`MCP_SERVER_CONNECTION_BATCH_SIZE`	Número máximo de servidores MCP locales (stdio) para conectar en paralelo durante el inicio (predeterminado: 3)
`MCP_TIMEOUT`	Tiempo de espera en milisegundos para inicio de servidor MCP (predeterminado: 30000, o 30 segundos)
`MCP_TOOL_TIMEOUT`	Tiempo de espera en milisegundos para ejecución de herramientas MCP (predeterminado: 100000000, aproximadamente 28 horas). Para un servidor HTTP, SSE, o conector de claude.ai, cada solicitud también agota el tiempo de espera después de 60 segundos de forma predeterminada; establezca esta variable, o el `timeout` por servidor, por encima de 60000 para aumentar ese límite por solicitud. Un valor más bajo aún acorta el tiempo de espera general de ejecución de herramientas pero deja el límite por solicitud en 60 segundos. Los servidores Stdio y WebSocket no tienen temporizador por solicitud. Un campo `timeout` por servidor en `.mcp.json` anula esto para ese servidor. Un `timeout` por servidor de al menos 1000 también establece la ventana de inactividad mínima para las llamadas de herramientas de ese servidor, por lo que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca las aborta antes; este piso requiere Claude Code v2.1.203 o posterior. Para la variable env, los valores por debajo de 1000 se fijan a un segundo; para el campo por servidor, los valores por debajo de 1000 se ignoran
`NO_PROXY`	Lista de dominios e IPs a los que se emitirán solicitudes directamente, omitiendo el proxy
`OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT`	Límite estándar del SDK de OpenTelemetry en la longitud del valor del atributo. Claude Code limita los atributos de telemetría que llevan contenido al menor de este y `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, por lo que el marcador de truncamiento permanece dentro del límite del SDK. Claude Code lee las variantes `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` y `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` de la misma manera, y se aplica el valor más pequeño establecido a todas las señales. Requiere Claude Code v2.1.214 o posterior. Vea Monitoreo
`OTEL_LOG_ASSISTANT_RESPONSES`	Establezca en `1` para incluir el texto de respuesta del modelo en eventos de registro OpenTelemetry `assistant_response`. Cuando no se establece, se usa el valor de `OTEL_LOG_USER_PROMPTS` en su lugar. Establezca en `0` para mantener las respuestas redactadas incluso cuando `OTEL_LOG_USER_PROMPTS` se establece. Requiere Claude Code v2.1.193 o posterior. Vea Monitoreo
`OTEL_LOG_MANAGED_SETTINGS`	Establezca en `1` para agregar la configuración administrada redactada, y un resumen SHA-256 de la configuración antes de la redacción, a eventos de registro OpenTelemetry `managed_settings_resolved`. Deshabilitado de forma predeterminada. Establézcalo en su shell, configuración de usuario, o configuración administrada; un valor en configuración de proyecto o local no lo activa. Requiere Claude Code v2.1.274 o posterior. Vea Monitoreo
`OTEL_LOG_RAW_API_BODIES`	Emita solicitud y respuesta JSON de la API de Mensajes de Anthropic como eventos de registro `api_request_body` / `api_response_body`. Establezca en `1` para cuerpos en línea truncados en el límite de contenido, o `file:<dir>` para escribir cuerpos sin truncar en disco y emitir una ruta `body_ref` en su lugar. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura el límite de contenido, 60 KB de forma predeterminada. Deshabilitado de forma predeterminada; los cuerpos incluyen el historial de conversación completo. Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local. Vea Monitoreo
`OTEL_LOG_TOOL_CONTENT`	Establezca en `1` para incluir contenido de herramientas en el evento de tramo OpenTelemetry `tool.output`. Los atributos de tramo llevan contenido de herramientas bajo sus propias puertas. Requiere rastreo. Deshabilitado de forma predeterminada para proteger datos sensibles. Vea Monitoreo
`OTEL_LOG_TOOL_DETAILS`	Establezca en `1` para incluir argumentos de entrada de herramientas, nombres de servidores MCP, nombres de flujos de trabajo creados por el usuario, cadenas de error sin procesar en fallos de herramientas, la `category` de rechazo en eventos `api_refusal`, y otros detalles de herramientas en rastreos y registros de OpenTelemetry. Deshabilitado de forma predeterminada para proteger PII. Vea Monitoreo
`OTEL_LOG_USER_PROMPTS`	Establezca en `1` para incluir texto de prompt de usuario en rastreos y registros de OpenTelemetry. Deshabilitado de forma predeterminada (los prompts se redactan). Vea Monitoreo
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Establezca en `false` para excluir UUID de cuenta de atributos de métricas (predeterminado: incluido). Vea Monitoreo
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Establezca en `true` para incluir el punto de entrada de sesión en atributos de métricas (predeterminado: excluido). Agregado en v2.1.152. Vea Monitoreo
`OTEL_METRICS_INCLUDE_REPOSITORY`	Establezca en `true` para etiquetar métricas y eventos de OpenTelemetry con atributos `vcs.*` que identifiquen el repositorio de la sesión (predeterminado: excluido). Requiere Claude Code v2.1.269 o posterior. Vea Atributos de repositorio
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partir de v2.1.161, Claude Code adjunta claves `OTEL_RESOURCE_ATTRIBUTES` a etiquetas de punto de datos de métrica. Establezca en `false` para excluirlas (predeterminado: incluidas). Vea Monitoreo
`OTEL_METRICS_INCLUDE_SESSION_ID`	Establezca en `false` para excluir ID de sesión de atributos de métricas (predeterminado: incluido). Vea Monitoreo
`OTEL_METRICS_INCLUDE_VERSION`	Establezca en `true` para incluir la versión de Claude Code en atributos de métricas (predeterminado: excluido). Vea Monitoreo
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Anule el presupuesto de caracteres para metadatos de skill mostrados a la herramienta Skill. El presupuesto se escala dinámicamente al 1% de la ventana de contexto, con un respaldo de 8,000 caracteres. Nombre heredado mantenido para compatibilidad hacia atrás
`TASK_MAX_OUTPUT_LENGTH`	Eliminado en v2.1.277 y ahora es un no-op, junto con la herramienta `TaskOutput` que dimensionaba. Anteriormente establecía el número máximo de caracteres de salida de una tarea de fondo que la herramienta `TaskOutput` mantenía. Claude lee un archivo de salida de tarea de fondo con `Read` en su lugar
`USE_BUILTIN_RIPGREP`	Establezca en `0` para usar `rg` instalado en el sistema en lugar de `rg` incluido con Claude Code
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Anule la región para Claude 3.5 Haiku cuando use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Anule la región para Claude 3.5 Sonnet cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Anule la región para Claude 3.7 Sonnet cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Anule la región para Claude 4.0 Opus cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Anule la región para Claude 4.0 Sonnet cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Anule la región para Claude 4.1 Opus cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Anule la región para Claude Opus 4.5 cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Anule la región para Claude Sonnet 4.5 cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Anule la región para Claude Opus 4.6 cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Anule la región para Claude Sonnet 4.6 cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Anule la región para Claude Opus 4.7 cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Anule la región para Claude Opus 4.8 cuando Use Google Cloud's Agent Platform
`VERTEX_REGION_CLAUDE_5_5_OPUS`	Anule la región para Claude Opus 5.5 cuando Use Google Cloud's Agent Platform. Agregado en v2.1.280
`VERTEX_REGION_CLAUDE_5_OPUS`	Anule la región para Claude Opus 5 cuando Use Google Cloud's Agent Platform. Agregado en v2.1.219
`VERTEX_REGION_CLAUDE_5_SONNET`	Anule la región para Claude Sonnet 5 cuando Use Google Cloud's Agent Platform. Agregado en v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Anule la región para Claude Fable 5 cuando Use Google Cloud's Agent Platform. Agregado en v2.1.170
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Anule la región para Claude Fable 5.1 cuando Use Google Cloud's Agent Platform. Agregado en v2.1.257
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Anule la región para Claude Haiku 4.5 cuando Use Google Cloud's Agent Platform

También se admiten variables de exportador OpenTelemetry estándar (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). Vea Monitoreo para detalles de configuración.

Características que necesitan obtención de banderas de características

Claude Code activa algunas características a través de banderas de características que obtiene de Anthropic. Claude Code omite esa obtención en estas sesiones:

Una sesión donde usted establece DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK, o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; la fila de cada variable en la tabla de variables indica qué valores desactivan la obtención
Una sesión en un proveedor de terceros, como Amazon Bedrock, Claude Platform en AWS, Agent Platform de Google Cloud, o Microsoft Foundry, a menos que una plataforma anfitriona que integre Claude Code establezca CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
Una sesión de puerta de enlace de aplicaciones Claude

Con la obtención desactivada, usted no puede:

Iniciar sesiones en modo automático de forma predeterminada en planes Pro, Max y Team
Hacer que la extensión de VS Code lea archivos de configuración para el modo de permiso inicial
Ejecutar /auto-mode-setup para redactar entradas de autoMode.environment
Usar Control Remoto
Enviar mensajes a sesiones más allá de esta máquina; la mensajería entre sesiones en esta máquina funciona con la obtención desactivada
Ejecutar claude import o el comando /import
Ejecutar /skill-doctor o abrir su informe en la pestaña Stats de /plugin
Sincronizar las skills y plugins habilitados para su cuenta de claude.ai en sus sesiones de terminal
Usar la herramienta asesor
Leer o responder a comentarios en un artefacto
Hacer que Claude Code sondee servidores conectores de claude.ai para revisión del protocolo MCP 2026-07-28 a menos que usted establezca MCP_PROTOCOL_NEGOTIATION=auto
Obtener la herramienta PowerShell de forma predeterminada para cuentas de claude.ai y Console en Windows con Git Bash instalado; Claude Code enruta comandos de shell a través de Git Bash a menos que usted establezca CLAUDE_CODE_USE_POWERSHELL_TOOL=1. En Windows sin Git Bash, la herramienta permanece activada
Obtener comentarios redactados por Claude, que Claude Code activa a través de una bandera obtenida
Hacer que Claude trate pastas grandes como texto pegado en lugar de texto escrito; el contenido detrás de un marcador de posición [Pasted text #N] llega a Claude sin marcar
Hacer que Claude Code excluya herramientas MCP cuyo esquema de entrada la API rechazaría; envía el esquema de todas formas, y una solicitud que lo incluye falla con un error 400 que nombra la herramienta por su posición

Primera sesión después de una instalación o actualización

En su primera sesión después de instalar Claude Code, o actualizar a una versión que añade una característica, una característica protegida por bandera puede estar ausente, y la sesión puede iniciarse en modo Manual en un plan que de otro modo se iniciaría en modo automático. Claude Code obtiene las banderas durante esa sesión, por lo que ambas están presentes en su próxima sesión.

Después de una instalación nueva, en una sesión no interactiva como claude -p, el SDK del Agent, o la extensión de VS Code, Claude Code aún puede obtener las banderas antes de elegir el modo de permiso inicial.

Véase también

Configuración: todas las configuraciones de settings.json, incluida la clave env
Referencia de CLI: banderas de tiempo de lanzamiento
Configuración de red: configuración de proxy y TLS
Monitoreo: configuración de OpenTelemetry

env-vars.md 2026-09-23 23:57 UTC to 2026-09-24 22:57 UTC

Variables de entorno

Establecer variables de entorno

En su shell

En archivos de configuración

Precedencia

Variables

Características que necesitan obtención de banderas de características

Primera sesión después de una instalación o actualización

Véase también

env-vars.md +2 −2