Variables de entorno - Claude Code Docs

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:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

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:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

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.

~/.claude/settings.json

{
  "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. La configuración de proyecto y local no puede establecer algunas variables, como CLAUDE_CONFIG_DIR y las variables del exportador de OpenTelemetry. Variables que Claude Code ignora en env las enumera, junto con los valores de desactivación de OpenTelemetry que aún se aplican. 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.

Para variables que activan o desactivan un comportamiento, establezca 1 o true para activarlo y 0 o false para desactivarlo, en cualquier mayúscula.Algunas variables solo leen si las establece en absoluto, por lo que cualquier valor no vacío, incluido 0, activa el comportamiento, y desactiva el comportamiento desestableciendo la variable o estableciéndola en un valor vacío. Estas variables funcionan de esa manera:

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
DISABLE_TELEMETRY
DISABLE_ERROR_REPORTING
CLAUDE_CODE_TMUX_TRUECOLOR
FALLBACK_FOR_ALL_PRIMARY_MODELS
IS_DEMO

Otra variable tiene su propia regla: FORCE_HYPERLINK lee un número, por lo que solo 0 la desactiva. La fila de cada variable también establece su propia regla.

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 se desactiva de forma predeterminada. Establezca `ENABLE_TOOL_SEARCH=true` si su proxy reenvía bloques `tool_reference`. A partir de v2.1.196, Remote Control se desactiva 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. Consulte Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Anule la URL del punto de conexión de Amazon Bedrock Mantle. Consulte 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. Consulte 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`. Consulte 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 exacto de caracteres 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 el 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. Consulte 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`. Consulte Configuración de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID de modelo al que se resuelve el alias `fable`, y el ID que Claude Code reconoce como modelo Fable para alternancia automática de modelo en proveedores de terceros. Consulte 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`. Consulte 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. Consulte 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`. Consulte 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. Consulte 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`. Consulte 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. Consulte 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`. Consulte 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. Consulte 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. Consulte 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`. Consulte 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. Consulte 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`. Consulte 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. Consulte 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`. Consulte 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. Consulte 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`. Consulte 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`. Consulte precedencia de autenticación
`ANTHROPIC_FOUNDRY_API_KEY`	Clave de API para autenticación de Microsoft Foundry (consulte 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. Consulte 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` (consulte Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nombre del recurso de Microsoft Foundry (por ejemplo, `my-resource`). Requerido si `ANTHROPIC_FOUNDRY_BASE_URL` no se establece (consulte Microsoft Foundry)
`ANTHROPIC_MODEL`	Nombre de la configuración del modelo a usar (consulte Configuración de modelo)
`ANTHROPIC_ORGANIZATION_ID`	ID de organización para Workload Identity Federation. Establézcalo junto con `ANTHROPIC_FEDERATION_RULE_ID`. Consulte 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 una clave de API. Consulte 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 `ANTHROPIC_SMALL_FAST_MODEL` deprecado 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. Consulte 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. Consulte 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 (consulte 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. Consulte 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 clonarlo 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-continuar. No tiene efecto a menos que auto-continuar esté activado; consulte 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 continúe automáticamente sin usted. Auto-continuar está desactivado de forma predeterminada; opte por 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 auto-continuar 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, auto-continuar estaba activado 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 desactivar 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 tanto a conversaciones principales como a subagentes
`CLAUDE_AUTO_BACKGROUND_TASKS`	Establezca en `1` para forzar la activación de la puesta en segundo plano automática 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 puesta en segundo plano automática 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 desactivar 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 desde 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 del clasificador de 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`. El `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 la terminal integrada de un IDE compatible. Establezca en `false` para evitar esto. Establezca en `true` para forzar un intento de conexión cuando la detección automática falla, como cuando tmux oculta la terminal padre. Tiene precedencia sobre la configuración global `autoConnectIde`
`CLAUDE_CODE_AUTO_MODE_SERVER`	Controla si Claude Code solicita al servidor que revise acciones de modo automático. Establezca en `0` para usar las solicitudes del clasificador propio de Claude Code en su lugar. En una conexión directa a la API de Anthropic, requiere v2.1.281 o posterior. La sección vinculada enumera qué sesiones solicitan al servidor cuando la variable no se establece, y desde qué versión. Requiere Claude Code v2.1.271 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 el diff de los archivos que cambiaron mientras se ejecutaba 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 al final de cada turno, incluso mientras el trabajo de fondo aún se está ejecutando. De forma predeterminada, la sesión sigue 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 sesiones remotas, 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 la opción de exclusión 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 herramientas Bash y comando hook mientras la sesión tiene una conexión activa de Remote Control, 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. Consulte 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 una terminal integrada de IDE. Un `claude` TUI interactivo anidado iniciado 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, consulte `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 completa de comandos de línea de estado, o aumente a `error` para reducir ruido
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Establezca en `1` para desactivar 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.5 y los modelos Fable, a una ventana de 200K; consulte 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 no reconocido `[1m]`, consulte Corregir la ventana para un ID de modelo de puerta de enlace o personalizado
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Establezca en `1` para desactivar 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 y posterior, 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 entre fuentes de administrador, por lo que solo se aplica el bloque `env` completo 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 desactivar la herramienta de 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 desactivar 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 deprecada `disableArtifact` también la desactiva
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Establezca en `1` para desactivar el procesamiento de archivos adjuntos. Las menciones de archivos con sintaxis `@` se envían como texto simple en lugar de expandirse al contenido del archivo
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Establezca en `1` para desactivar memoria automática. Establezca en `0` para forzar la memoria automática incluso cuando el modo `--bare` o `autoMemoryEnabled: false` la desactivaría de otra manera. Cuando está desactivada, Claude no crea ni carga archivos de memoria automática
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Establezca en `1` para desactivar toda la funcionalidad de tareas de fondo, incluido el parámetro `run_in_background` en herramientas Bash y subagente, auto-puesta en 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 por lo demás sin modificar, por lo que decodifica el cuerpo y la transmisión sigue 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. Afecta solo esa entrega: poner una sesión en 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 bajo presión de memoria. De forma predeterminada, en macOS y Linux, Claude Code termina shells de fondo cuando el sistema operativo informa presión de memoria crítica y la sesión ha estado inactiva durante 30 minutos sin turno o subagente en ejecución. 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 desactivar las skills y 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 de 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 guía 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 desactivar 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_DANGEROUS_RM_TIMEOUT`	Establezca en `1` para desactivar el límite de tiempo en solicitudes de ruta crítica de eliminación. En modo `auto`, Claude Code entonces envía estas eliminaciones al clasificador en su lugar, y en modo `bypassPermissions`, el prompt espera su respuesta. 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.281 o posterior
`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` e `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 se desactiva 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. Desactivar capacidades de pre-lanzamiento cubre dónde se aplica la anulación
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Establezca en `1` para desactivar 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 modo plan 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 desactivar modo rápido
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Establezca en `1` para desactivar las encuestas de calidad de sesión “¿Cómo está Claude?”. Las encuestas también se desactivan 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 desactivar completamente, use la configuración `feedbackSurveyRate`. Consulte Encuestas de calidad de sesión
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Establezca en `1` para desactivar el punto de control 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 contexto de Claude. Útil cuando se usan 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ática 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 desactivar 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 nativa de su terminal
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Establezca en `1` para desactivar 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 desactivada, Claude Code carga archivos rotados solo cuando aplica la 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 desactivar 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 desactiva este tráfico, a diferencia de la mayoría de variables de encendido/apagado; desestablezca la variable para permitirlo de nuevo. También desactiva 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; desactívela con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. No afecta el descubrimiento de modelos de puerta de enlace, que tiene su propio opt-in
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Establezca en `1` para desactivar 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 escribe en o se enfoca 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 desactiva 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 desactivar 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 desde el directorio de skills administradas en todo el sistema. Útil para sesiones de contenedor o CI que no deben cargar skills aprovisionadas por operadores
`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`	Establezca en `1` para desactivar la verificación de la herramienta PowerShell que niega los comandos integrados `cmd` `rd`, `rmdir`, `del`, y `erase` en una ruta del sistema, como una raíz de unidad o su directorio de inicio. Claude Code ignora esta variable en un bloque `env` de archivo de configuración. Requiere Claude Code v2.1.283 o posterior
`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`	Establezca en `1` para desactivar la verificación de ruta crítica para un `rm` recursivo cuyo objetivo es completamente la salida de una sustitución de comando, como `rm -rf "$(pwd)"`. Las otras verificaciones de ruta crítica siguen ejecutándose. 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.281 o posterior
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Establezca en `1` para desactivar las actualizaciones automáticas del título de la terminal basadas en el contexto de la 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 desactivar 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, Sonnet 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 la 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; consulte 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 desactivar 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 PowerShell ejecutándose en segundo plano se traslade al siguiente proceso de la sesión, como cuando pone la sesión en segundo plano. Si establece la variable, un comando PowerShell puesto en segundo plano se detiene cuando el proceso de la sesión sale. Los comandos Bash no se ven afectados. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Establezca en `1` para desactivar 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. Consulte 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 el 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 el almacenamiento en caché de prompts 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 de 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. No se envían datos de encuesta 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 Prompt suggestions 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. Consulte 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 `TodoWrite` heredada en su lugar. Consulte Lista de tareas
`CLAUDE_CODE_ENABLE_TELEMETRY`	Establezca en `1` para habilitar la recopilación de datos de OpenTelemetry para métricas y registro. Requerido antes de configurar exportadores OTel. Establézcalo en su shell, configuración de usuario o configuración administrada. Se ignora en configuración de proyecto y local. Consulte 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 desactivados 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 tokens 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 automáticamente el caso de tmux 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 las respuestas de Claude cuando su terminal lo admite pero no se detecta automáticamente, 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 el modo privado DEC 2026 salida sincronizada cuando su terminal lo admite pero no se detecta automáticamente. Ú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 fork, 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 fork 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 fork
`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 sigan 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 modelos 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 detecta automáticamente Git Bash como si no se estableciera, 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. Consulte Configuración de Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Establezca en `false` para excluir dotfiles de resultados cuando Claude invoca la herramienta Glob. Se incluye de forma predeterminada. No afecta la autocompletación de archivos `@`, `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 la autocompletación de archivos `@`, que tiene su propia configuración `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Tiempo de espera en segundos para el descubrimiento de archivos de la 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 solicite 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 detecta automáticamente 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 no encuentra 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 desactivarlo. 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; consulte 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 según el modelo; consulte tokens de salida máximos. Claude Code usa un 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 la 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 fallaba 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 agentes 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 la puesta en segundo plano automática. 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 desactivar 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 de 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 símbolo de intercalación de entrada en lugar de un bloque dibujado. El cursor respeta la configuración de parpadeo, forma y 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 de 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 aprovisionar autenticación en entornos automatizados
`CLAUDE_CODE_OAUTH_SCOPES`	Alcances de 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 de 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 de 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 más grandes que 64 KB, o redúzcalo para reducir el volumen de telemetría. Requiere Claude Code v2.1.214 o posterior. Consulte Monitoreo
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Establezca en `1` para escribir errores de diagnóstico del exportador de OpenTelemetry a stderr. De forma predeterminada, estos errores solo aparecen con `--debug`, por lo que un exportador mal configurado como una colisión de puerto de Prometheus falla silenciosamente de otra manera. Requiere Claude Code v2.1.179 o posterior. Consulte Monitoreo
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Tiempo de espera en milisegundos para vaciar tramos de OpenTelemetry pendientes (predeterminado: 5000). Consulte Monitoreo
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalo para actualizar encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulte Encabezados dinámicos
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagar (predeterminado: 2000). Aumente si se pierden métricas al salir. Consulte 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 segundo plano cuando hay una nueva versión disponible. Se aplica a instalaciones de Homebrew y WinGet. Otros gestores de paquetes continúan mostrando el comando de actualización sin ejecutarlo. Consulte Auto-actualizaciones
`CLAUDE_CODE_PERFORCE_MODE`	Establezca en `1` para habilitar la 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. Consulte Cargar un plugin para una sesión
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Tiempo de espera en milisegundos para clonar o actualizar un mercado de plugins (predeterminado: 120000). Aumente este valor para repositorios grandes o conexiones de red lentas. Consulte Git clone agotó 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 checkout de mercado existente cuando una actualización de mercado no puede alcanzar o autenticarse en el remoto. Útil en entornos sin conexión o aislados donde la re-clonación fallaría de la misma manera. Consulte Las actualizaciones del mercado siguen fallando sin conexión
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Establezca en `1` para clonar fuentes de acceso directo de GitHub `owner/repo` sobre HTTPS en lugar de SSH. Se aplica a la 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 desde estos directorios al inicio y usa plugins pre-almacenados en caché sin re-clonar. Consulte Pre-rellenar plugins para contenedores
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Establezca en `1` para evitar que Claude Code pase `-ExecutionPolicy Bypass` cuando genera 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 predeterminadas restringidas. El bypass de alcance de proceso nunca anula la `MachinePolicy` o `UserPolicy` de Group Policy independientemente de esta configuración
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Techo en milisegundos en la espera inactiva de 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 a 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. Consulte 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` almacena bajo `/srv/tenant-a/projects/work/`. Claude Code ignora esta variable cuando `CLAUDE_CONFIG_DIR` no se establece, y la lee solo desde el entorno desde el que inicia `claude`, nunca desde un bloque `env` de archivo de configuración. Consulte Nombrar 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. La API factura escrituras de caché de 1 hora a una tasa más alta. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Establezca en `1` para propagar el 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 se habilita solo cuando se conecta directamente a la API de Anthropic. Agregado en v2.1.152. Consulte 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, para que la configuración de usuario no pueda 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, para que la configuración de modelo del host tenga 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 opción de 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, para que la telemetría siga la opción de exclusión estándar `DISABLE_TELEMETRY`. Consulte 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. Opción de participación 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. Consulte Vincular 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 un bloque `env` de 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 desencadenaba 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 la reanudación automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` y su mensaje de continuación `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 aquellos; 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 se bloqueó 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 que Claude Code envía a Claude cuando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continúa un turno interrumpido en lugar de reenviar su prompt, o cuando reanuda una llamada de herramienta diferida con `-p`. El valor predeterminado es `Continue from where you left off.`. 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. Reintenta errores de capacidad `429` y `529` 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, consulte Manejar límites de velocidad. El perro guardián se retira hasta 5 minutos entre intentos, o hasta que se reinicia 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 personalizados y agentes, 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. 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 se basa 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 velocidad 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 la 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 la 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 herramientas 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 se generó. 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 los lanzó
`CLAUDE_CODE_SHELL`	Establezca el shell que Claude Code usa para ejecutar comandos de herramientas 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 `bash` o `zsh` funcional, Claude Code la ignora y vuelve a la detección automática. La detección automática usa su `$SHELL` cuando apunta a `bash` o `zsh`, de lo contrario elige el primer `zsh` funcional 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 herramientas 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 herramientas 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. Desactiva el descubrimiento automático de hooks, skills, comandos personalizados, subagentes, plugins instalados, servidores MCP, memoria automática, y CLAUDE.md. Las skills en un directorio que pasa con `--add-dir` aún se cargan. Los tokens de OAuth y las 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 lo habilitaría de otra manera. El conjunto completo de herramientas, 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 desde la cadena de proveedores de credenciales predeterminada de AWS, para que Claude Code resuelva 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. Consulte 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 usa una puerta de enlace LLM)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	Establezca en `1` para tratar una verificación de disponibilidad de modo rápido fallida como disponible, para redes que bloquean la solicitud directa de la verificación a `api.anthropic.com`. Claude Code aún honra una respuesta “desactivado por su organización”
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	Establezca en `1` para omitir la verificación de disponibilidad de modo rápido del lado del cliente, para proxies que interceptan la solicitud de la verificación en lugar de rechazarla. La API aún rechaza solicitudes de modo rápido cuando su organización tiene modo rápido desactivado
`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 usa 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 scripts efímeros
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Omita la autenticación de Google para Google Cloud’s Agent Platform (por ejemplo, cuando usa 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 desactivar 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`. Consulte 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. La API factura escrituras de caché de 1 hora 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 subprocesos (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 padre de Claude 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 propio de Claude Code (como `CLAUDE_CONFIG_DIR`), para que un proceso secundario no pueda 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 procesos 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 segundo plano 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 la instalación sincrónica de plugins. Cuando se excede, Claude Code procede sin plugins e 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 segundo plano, 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 se resincronizan aproximadamente cada 10 minutos sin esta variable, por lo que establézcala solo cuando una ejecución `-p` necesita 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 adicionales 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 las skills que han llegado, y las descargas restantes se completan en segundo plano
`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 las skills que han llegado. Las descargas se completan en segundo plano de cualquier manera, y Claude espera la descarga de una skill cuando la invoca
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Establezca en `false` para desactivar el resaltado de sintaxis en la salida de diff. Útil cuando los colores interfieren con su configuración de terminal. Para también desactivar el resaltado en bloques de código y vistas previas de archivos, 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. Consulte 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 aislados 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 aislados heredan su `$TMPDIR` de shell cuando se establece. 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 encendido/apagado; desestablezca la variable para restaurar el fijación de 256 colores. De forma predeterminada, Claude Code fija 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`. Consulte 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 desactiva 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 archivos
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controla la herramienta PowerShell. En Windows sin Git Bash, la herramienta se habilita automáticamente; establezca en `0` para desactivarla. 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 enrutar a través de Git Bash. Consulte 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 cada respuesta de 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 ejecuta una única ejecución de flujo de trabajo 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 valores más altos aumentan el uso de memoria. Solo acepta dígitos simples; 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 desactivar 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 sesiones, y plugins se almacenan bajo esta ruta. Para credenciales, consulte 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 pone una sesión en segundo plano presionando `←` o con `/background`. Claude Code le solicita que confirme antes de poner en 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 herramientas 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 desactivació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 se habilita 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, consulte 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 predeterminado. Configure el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Establezca en `0` para forzar la desactivació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, consulte 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, para que las exportaciones en el archivo sean 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 sesión. Los comandos de shell que la sesión ejecuta lo heredan. Escriba archivos de scratch a `$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 a 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 de Claude Code en sí; consulte la referencia de errores. Léalo desde sus propios scripts para identificar o señalar deliberadamente el proceso padre de Claude Code. Requiere Claude Code v2.1.214 o posterior
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefijo para nombres de sesión generados automáticamente de Remote Control 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, consulte 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 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, consulte 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. Consulte 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 desencadenan
`DISABLE_AUTOUPDATER`	Establezca en `1` para desactivar las 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 desactivar la compactación automática cuando se aproxima 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 desactivar toda la compactación: tanto la compactación automática como el comando manual `/compact`
`DISABLE_COST_WARNINGS`	Establezca en `1` para desactivar 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 deben 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 diagnósticos `/doctor`
`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 encendido/apagado; 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 desactivar el comando `/feedback` y retroalimentación redactada por Claude. También desactiva `/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 desactivaba bajo cada nombre. El nombre anterior `DISABLE_BUG_COMMAND` también se acepta
`DISABLE_GROWTHBOOK`	Establezca en `1` o `true` para desactivar 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 desactivar 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 desactivar el almacenamiento en caché de prompts para todos los modelos (tiene precedencia sobre configuraciones por modelo)
`DISABLE_PROMPT_CACHING_FABLE`	Establezca en `1` para desactivar el almacenamiento en caché de prompts para modelos Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Establezca en `1` para desactivar el almacenamiento en caché de prompts para el modelo Haiku predeterminado, dondequiera que se ejecute
`DISABLE_PROMPT_CACHING_OPUS`	Establezca en `1` para desactivar el almacenamiento en caché de prompts para modelos Opus
`DISABLE_PROMPT_CACHING_SONNET`	Establezca en `1` para desactivar el almacenamiento en caché de prompts 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 encendido/apagado; 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 desactiva la obtención de banderas de características. Consulte 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 deben 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 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 CLIs 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 de CLI interactivas también requieren que su organización esté en la lista blanca 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 desactivar 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`	Deprecado. Use `ENABLE_PROMPT_CACHING_1H` en su lugar
`ENABLE_TOOL_SEARCH`	Controla la 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 desactivaba 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 encendido/apagado; 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á desactivado 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 detectan automáticamente, o `0` para desactivarlos. 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 desactivarlos. 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 encendido/apagado; 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 esos muchos 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. Consulte `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 desactivar el pensamiento en la API de Anthropic, excepto en Opus 5.5, Sonnet 5.5, y los modelos Fable, que no pueden tener el pensamiento desactivado. En proveedores de terceros, `0` omite el parámetro `thinking` en su lugar. Con el pensamiento desactivado 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 de OAuth para servidores MCP que requieren credenciales preconfiguradas. Evita el prompt interactivo cuando se agrega 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 no es bloqueante de forma predeterminada: los servidores se conectan en segundo plano 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 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; consulte 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 siguen conectándose en segundo plano. 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 lo 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 segundo plano. 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 una actualización fallida 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 segundo plano. 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` cuando se agrega 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 responde 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 sesiones donde 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, comenzando con 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 MCP de OAuth 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 el inicio del servidor MCP (predeterminado: 30000, o 30 segundos)
`MCP_TOOL_TIMEOUT`	Tiempo de espera en milisegundos para la 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`, para que el marcador de truncamiento permanezca 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 el valor más pequeño establecido se aplica a todas las señales. Requiere Claude Code v2.1.214 o posterior. Consulte Monitoreo
`OTEL_LOG_ASSISTANT_RESPONSES`	Establezca en `1` para incluir el texto de respuesta del modelo en eventos de registro de OpenTelemetry `assistant_response`. Cuando no se establece, Claude Code 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. Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local. Requiere Claude Code v2.1.193 o posterior. Consulte 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 de OpenTelemetry `managed_settings_resolved`. Desactivado 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. Consulte Monitoreo
`OTEL_LOG_RAW_API_BODIES`	Emita JSON de solicitud y respuesta 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. Desactivado 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. Consulte Monitoreo
`OTEL_LOG_TOOL_CONTENT`	Establezca en `1` para incluir contenido de herramientas en el evento de tramo de OpenTelemetry `tool.output`. Los atributos de tramo llevan contenido de herramientas bajo sus propias puertas. Requiere rastreo. Desactivado de forma predeterminada para proteger datos sensibles. Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local, aparte de los valores desactivados que esa sección describe. Consulte 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. Desactivado de forma predeterminada para proteger PII. Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local, aparte de los valores desactivados que esa sección describe. Consulte Monitoreo
`OTEL_LOG_USER_PROMPTS`	Establezca en `1` para incluir texto de prompt de usuario en rastreos y registros de OpenTelemetry. Desactivado de forma predeterminada (los prompts se redactan). Establézcalo en su shell, configuración de usuario, o configuración administrada. Se ignora en configuración de proyecto y local, aparte de los valores desactivados que esa sección describe. Consulte Monitoreo
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Establezca en `false` para excluir UUID de cuenta de atributos de métricas (predeterminado: incluido). Consulte 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. Consulte Monitoreo
`OTEL_METRICS_INCLUDE_REPOSITORY`	Establezca en `true` para etiquetar métricas y eventos de OpenTelemetry con atributos `vcs.*` que identifican el repositorio de la sesión (predeterminado: excluido). Requiere Claude Code v2.1.269 o posterior. Consulte Atributos de repositorio
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partir de v2.1.161, Claude Code adjunta claves `OTEL_RESOURCE_ATTRIBUTES` a etiquetas de puntos de datos de métricas. Establezca en `false` para excluirlas (predeterminado: incluidas). Consulte Monitoreo
`OTEL_METRICS_INCLUDE_SESSION_ID`	Establezca en `false` para excluir ID de sesión de atributos de métricas (predeterminado: incluido). Consulte Monitoreo
`OTEL_METRICS_INCLUDE_VERSION`	Establezca en `true` para incluir la versión de Claude Code en atributos de métricas (predeterminado: excluido). Consulte Monitoreo
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Anule el presupuesto de caracteres para metadatos de skills 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 la salida de una tarea de fondo que la herramienta `TaskOutput` mantenía. Claude lee el archivo de salida de una 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_5_SONNET`	Anule la región para Claude Sonnet 5.5 cuando use Google Cloud’s Agent Platform. Agregado en v2.1.284
`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 estándar del exportador de OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES, y variantes específicas de señal). Consulte Monitoreo para detalles de configuración. Establezca CLAUDE_CODE_ENABLE_TELEMETRY y las variables de OpenTelemetry que activan la exportación, eligen su destino, o capturan contenido en su shell, configuración de usuario, o configuración administrada. Claude Code las ignora en configuración de proyecto y local, aparte de los valores desactivados que esa sección describe. OTEL_RESOURCE_ATTRIBUTES y el intervalo de exportación, tiempo de espera, y variables de compresión, como OTEL_METRIC_EXPORT_INTERVAL, aún se aplican desde configuración de proyecto y local.

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:

Ejecutar /auto-mode-setup para redactar entradas de autoMode.environment
Usar Control Remoto con CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_GROWTHBOOK establecidos. Para DISABLE_TELEMETRY y DO_NOT_TRACK, consulte los requisitos de Control Remoto
Enviar mensajes a sesiones más allá de esta máquina cuando Control Remoto no esté disponible. 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. Esa sesión también puede iniciarse en un modo de permiso diferente al que sus sesiones posteriores hacen. Claude Code obtiene las banderas durante esa sesión, por lo que su próxima sesión tiene la característica y el modo de permiso inicial habitual. 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

​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