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 estableces en tu 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.

Establecer variables en tu shell

Establece 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, agrega la línea export a ~/.bashrc, ~/.zshrc, o el archivo de perfil de tu shell.

$env:API_TIMEOUT_MS = "1200000"
claude

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

set API_TIMEOUT_MS=1200000
claude

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

La línea de asignación no imprime nada en caso de éxito. Para confirmar que la variable está establecida, imprímela en el mismo shell:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

Establecer variables en archivos de configuración

Agrega 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 guardas 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 relances. 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 lances claude.

~/.claude/settings.json

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

Claude Code copia estos valores en su entorno tal como están escritos. Ningún shell los procesa, por lo que abreviaturas como ~ o $HOME se mantienen tal como se escribieron. Para una variable que recibe una ruta, como CLAUDE_CONFIG_DIR, escribe la ruta absoluta: "CLAUDE_CONFIG_DIR": "/home/you/.claude-work". El archivo que elijas controla a quién se aplican las variables:

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

Consulta 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 en la mayoría de las sesiones. Claude Code escribe cada entrada env en el entorno del proceso, reemplazando el valor heredado del shell. Cómo los valores env interactúan con su shell cubre las sesiones que mantienen el valor heredado en su lugar, y 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 inicies claude. Las variables establecidas bajo la clave env en archivos de configuración se vuelven a aplicar a una sesión en ejecución cuando el archivo cambia, con la excepción de solo inicio descrita en Establecer variables en archivos de configuración.

Variables

Las variables numéricas, como tiempos de espera, presupuestos de tokens y recuentos de reintentos, aceptan notación científica y separadores de dígitos además de dígitos simples, excepto cuando 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, estas formas podían establecer silenciosamente un valor mucho menor, como 1e6, que establecía un tiempo de espera de 1.

Para las variables que activan o desactivan un comportamiento, establece 1, true, yes u on para activarlo y 0, false, no u off para desactivarlo, con cualquier combinación de mayúsculas y minúsculas.Algunas variables solo comprueban si las estableciste o no, por lo que cualquier valor no vacío, incluido 0, activa el comportamiento, y para desactivarlo debes eliminar la variable o establecerla 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
IS_DEMO

La fila de cada variable también indica su propia regla.

Variable	Propósito
`ANTHROPIC_API_KEY`	Clave de API enviada como encabezado `X-Api-Key`. Cuando está establecida, esta clave se usa en lugar de tu suscripción Claude Pro, Max, Ultra, Team o Enterprise, incluso si has iniciado sesión. En modo no interactivo (`-p`), la clave siempre se usa cuando está presente. En modo interactivo, se te pide que apruebes la clave una vez antes de que sobrescriba tu suscripción. Para usar tu suscripción en su lugar, ejecuta `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valor personalizado para el encabezado `Authorization` (el valor que establezcas aquí llevará 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`	Sobrescribe la URL del endpoint de Claude Platform on AWS. Úsala para regiones personalizadas o al enrutar a través de un gateway de 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`	Obligatoria para Claude Platform on AWS. Se envía en cada solicitud como el encabezado `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Sobrescribe el endpoint de la API para enrutar las solicitudes a través de un proxy o gateway. Para saber qué ocurre cuando ese gateway rechaza la búsqueda de herramientas MCP, consulta Búsqueda de herramientas a través de un gateway de LLM. A partir de la v2.1.196, Remote Control se desactiva cuando apunta a un host distinto de `api.anthropic.com`, igual que su comportamiento en Amazon Bedrock, Google Cloud’s Agent Platform y Microsoft Foundry
`ANTHROPIC_BEDROCK_BASE_URL`	Sobrescribe la URL del endpoint de Amazon Bedrock. Úsala para endpoints personalizados de Amazon Bedrock o al enrutar a través de un gateway de LLM. Consulta Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Sobrescribe la URL del endpoint de Amazon Bedrock Mantle. Consulta Endpoint de Mantle
`ANTHROPIC_BEDROCK_REGION_PREFIX`	Prefijo del perfil de inferencia entre regiones (`us`, `eu`, `apac`, `jp`, `au` o `global`) que Claude Code prueba primero en lugar del derivado de la región de AWS. Se ignora en las regiones de AWS GovCloud. Requiere Claude Code v2.1.224 o posterior. Consulta Amazon Bedrock
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Nivel de servicio de Amazon Bedrock (`default`, `flex` o `priority`). Consulta Amazon Bedrock
`ANTHROPIC_BETAS`	Lista separada por comas de valores adicionales del encabezado `anthropic-beta` para incluir en las solicitudes a la API. Claude Code ya envía los encabezados beta que necesita; usa esta variable para optar por una beta de la API de Anthropic antes de que Claude Code agregue compatibilidad nativa. A diferencia del flag `--betas`, que requiere autenticación con clave de API, esta variable funciona con todos los métodos de autenticación, incluida la suscripción de Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	Encabezados personalizados para agregar a las solicitudes (formato `Name: Value`, separados por saltos de línea para varios encabezados). Si un nombre o valor contiene un carácter que un encabezado HTTP no puede transportar, como una comilla tipográfica o un espacio de ancho cero, la solicitud falla con un error que identifica el par por su posición. Requiere Claude Code v2.1.227 o posterior. Invalid request header value enumera el conjunto exacto de caracteres y dónde se ejecuta la comprobación. Un valor que establece un encabezado de credenciales, organización o tenant, enrutamiento o comportamiento de la API, como `Authorization` o `Host`, cuenta como un ajuste que necesita aprobación cuando lo entrega la configuración administrada por el servidor. Desde la configuración de proyecto o local, dicho valor sigue las reglas sobre cuándo se aplican los valores de `env`
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID de modelo para agregar como entrada personalizada en el selector de `/model`. Úsala para que un modelo no estándar o específico de un gateway sea seleccionable sin reemplazar los alias integrados. Consulta Configuración del modelo
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Descripción que se muestra para la entrada del modelo personalizado en el selector de `/model`. Si no se establece, el valor predeterminado es `Custom model (<model-id>)`
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	Nombre que se muestra para la entrada del modelo personalizado en el selector de `/model`. Si no se establece, la entrada muestra el nombre del modelo si Claude Code reconoce el ID y, de lo contrario, el ID del modelo
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Lista separada por comas de las capacidades que admite el modelo personalizado, por ejemplo `effort,thinking`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID de modelo al que se resuelve el alias `fable`, y el ID que Claude Code reconoce como un modelo Fable para el respaldo automático de modelo en proveedores de terceros. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Descripción que se muestra para el modelo Fable fijado en el selector de `/model`. Si no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Fable model`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Nombre que se muestra para el modelo Fable fijado en el selector de `/model`. Si no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado y, de lo contrario, el ID fijado. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de las capacidades que admite el modelo Fable fijado, por ejemplo `effort,thinking`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	ID de modelo al que se resuelve el alias `haiku`, que también se usa para la funcionalidad en segundo plano. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Descripción que se muestra para el modelo Haiku fijado en el selector de `/model`. Si no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Haiku model`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Nombre que se muestra para el modelo Haiku fijado en el selector de `/model`. Si no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado y, de lo contrario, el ID fijado. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de las capacidades que admite el modelo Haiku fijado, por ejemplo `effort,thinking`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_MODEL`	Modelo con el que comienzan de forma predeterminada las sesiones nuevas. Requiere Claude Code v2.1.236 o posterior. Consulta Establecer un modelo predeterminado para sesiones nuevas
`ANTHROPIC_DEFAULT_OPUS_MODEL`	ID de modelo al que se resuelve el alias `opus`, y que `opusplan` usa mientras el modo plan está activo. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descripción que se muestra para el modelo Opus fijado en el selector de `/model`. Si no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Opus model`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nombre que se muestra para el modelo Opus fijado en el selector de `/model`. Si no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado y, de lo contrario, el ID fijado. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de las capacidades que admite el modelo Opus fijado, por ejemplo `effort,thinking`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL`	ID de modelo al que se resuelve el alias `sonnet`, y que `opusplan` usa cuando el modo plan no está activo. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Descripción que se muestra para el modelo Sonnet fijado en el selector de `/model`. Si no se establece, la fila muestra una descripción predeterminada que comienza con `Custom Sonnet model`. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Nombre que se muestra para el modelo Sonnet fijado en el selector de `/model`. Si no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado y, de lo contrario, el ID fijado. Consulta Configuración del modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Lista separada por comas de las capacidades que admite el modelo Sonnet fijado, por ejemplo `effort,thinking`. Consulta Configuración del modelo
`ANTHROPIC_FEDERATION_RULE_ID`	ID de regla de federación para Workload Identity Federation. Cuando la estableces junto con `ANTHROPIC_ORGANIZATION_ID`, Claude Code selecciona las credenciales de federación, que tienen prioridad sobre tu credencial de `/login`. Consulta precedencia de autenticación
`ANTHROPIC_FOUNDRY_API_KEY`	Clave de API para la autenticación de Microsoft Foundry (consulta Microsoft Foundry)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Token bearer para la 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. Consulta Microsoft Foundry. Requiere Claude Code v2.1.203 o posterior
`ANTHROPIC_FOUNDRY_BASE_URL`	URL base completa del recurso de Microsoft Foundry (por ejemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulta Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nombre del recurso de Microsoft Foundry (por ejemplo, `my-resource`). Claude Code rechaza una URL o un nombre de host. Obligatoria si `ANTHROPIC_FOUNDRY_BASE_URL` no está establecida (consulta Microsoft Foundry)
`ANTHROPIC_MODEL`	Nombre del ajuste de modelo que se usará (consulta Configuración del modelo)
`ANTHROPIC_ORGANIZATION_ID`	ID de organización para Workload Identity Federation. Establécela junto con `ANTHROPIC_FEDERATION_RULE_ID`. Consulta precedencia de autenticación
`ANTHROPIC_PROFILE`	Nombre del perfil de Anthropic con el que autenticarse, como uno creado con `ant auth login` o al iniciar sesión en una cuenta de Console sin una clave de API. Consulta precedencia de autenticación
`ANTHROPIC_SMALL_FAST_MODEL`	[OBSOLETO] Nombre del modelo de clase Haiku para tareas en segundo plano
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Sobrescribe la región de AWS para el modelo de clase Haiku al usar Amazon Bedrock o Amazon Bedrock Mantle. En Amazon Bedrock, solo tiene efecto cuando también se establece `ANTHROPIC_DEFAULT_HAIKU_MODEL` o la obsoleta `ANTHROPIC_SMALL_FAST_MODEL`, ya que, de lo contrario, Amazon Bedrock ejecuta las tareas en segundo plano en el modelo Sonnet predeterminado o el modelo principal en la región de la sesión
`ANTHROPIC_VERTEX_BASE_URL`	Sobrescribe la URL del endpoint de Google Cloud’s Agent Platform. Úsala para endpoints personalizados de Google Cloud’s Agent Platform o al enrutar a través de un gateway de LLM. Consulta Google Cloud’s Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID del proyecto de GCP al que se dirigen las solicitudes de Google Cloud’s Agent Platform. Consulta Configurar las credenciales de GCP
`ANTHROPIC_WORKSPACE_ID`	ID del espacio de trabajo para workload identity federation. Establécela cuando tu regla de federación abarque más de un espacio de trabajo, para que el intercambio de tokens sepa a qué espacio de trabajo dirigirse
`API_FORCE_IDLE_TIMEOUT`	Sobrescribe el tiempo de espera de inactividad del cuerpo de 5 minutos que aborta una respuesta del modelo en streaming cuando no llegan bytes. Establécela en `0` para desactivar el tiempo de espera, por ejemplo cuando un gateway lento o un modelo local hace pausas de más de 5 minutos entre fragmentos, o en `1` para mantenerlo activo con todos los proveedores. Si no se establece, el tiempo de espera está activo en proveedores distintos de la API directa de Anthropic, Claude Platform on AWS y Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` establecida. Los watchdogs de streaming se ejecutan de forma independiente y abortan una pausa silenciosa prolongada incluso si estableces `0` aquí
`API_TIMEOUT_MS`	Tiempo en milisegundos que tiene cada intento de solicitud a la API para recibir sus encabezados de respuesta. No limita cuánto dura después una respuesta en streaming. El valor predeterminado es 600000, es decir, 10 minutos, y el máximo es 2147483647. Cuando estableces un valor positivo, cada intento de una solicitud sin streaming tiene que terminar dentro de ese tiempo. Auméntalo cuando se agote el tiempo de espera de las solicitudes en redes lentas o al enrutar a través de un proxy. Establécela en `0` para quitar este límite, lo que requiere Claude Code v2.1.305 o posterior. Con `0`, a un intento sin streaming igual se le agota el tiempo de espera después de 300 segundos en una sesión local
`AWS_BEARER_TOKEN_BEDROCK`	Clave de API de Amazon Bedrock para la autenticación (consulta Claves de API de Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Tiempo de espera predeterminado para un comando en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 120000, o 2 minutos). Un valor superior al límite de tiempo predeterminado para los comandos en segundo plano reemplaza ese valor predeterminado en las sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior
`BASH_MAX_OUTPUT_LENGTH`	Número máximo de caracteres de la salida de bash que Claude Code incorpora al resultado de un comando (predeterminado: 30000; máximo: 150000). Si estableces el ajuste `bashOutputMaxChars`, Claude Code ignora esta variable. Consulta Límites de salida
`BASH_MAX_TIMEOUT_MS`	Tiempo de espera máximo que el modelo puede establecer para un comando en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 600000, o 10 minutos). El límite efectivo es el mayor entre este valor y `BASH_DEFAULT_TIMEOUT_MS`. Un límite efectivo superior a 2 horas también se convierte en el límite de tiempo para los comandos en segundo plano máximo en las sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior
`BETA_TRACING_ENDPOINT`	Endpoint OTLP/HTTP para el rastreo beta detallado: con `ENABLE_BETA_TRACING_DETAILED=1`, los registros y las trazas se envían allí en lugar de a los exportadores configurados. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local
`CCR_FORCE_BUNDLE`	Establécela en `1` para forzar que `claude --cloud` empaquete y suba tu repositorio local en lugar de clonarlo desde su remoto
`CLAUDECODE`	Se establece en `1` en los subprocesos que Claude Code genera (herramientas Bash y PowerShell, sesiones de tmux, comandos de hooks, comandos de la línea de estado, subprocesos de servidores MCP stdio). Las extensiones de IDE también la establecen en sus terminales integradas. Úsala para detectar cuándo un script se ejecuta dentro de un subproceso generado por Claude Code. Para comprobar si el proceso actual fue generado directamente por una llamada a herramienta o un hook, y no dentro de un servidor MCP stdio que Claude Code inició, usa `CLAUDE_CODE_CHILD_SESSION` en su lugar
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	Establécela en `1` para desactivar todos los tipos de subagentes integrados, como Explore y Plan. Solo se aplica en modo no interactivo (el flag `-p`). Útil para usuarios del SDK que quieren empezar desde cero. Esto también elimina `general-purpose`, el subagente que Claude Code ejecuta cuando una llamada a la herramienta Agent omite `subagent_type`. En ese caso, dicha llamada falla con `subagent_type is required`
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	Establécela en `1` para omitir el prefijo `mcp__<server>__` en los nombres de las herramientas de los servidores MCP creados con el SDK. Las herramientas usan sus nombres originales. Solo para uso con el SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Tiempo de espera por estancamiento en milisegundos para los subagentes. También abarca los agentes de flujos de trabajo en Claude Code v2.1.286 o posterior. Predeterminado `600000` (10 minutos); si aumentas `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mientras el watchdog de streaming está activado, el valor predeterminado aumenta con él, como describe Manejar respuestas de la API lentas o estancadas
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Establece el porcentaje (1-100) de la ventana de compactación automática en el que se activa la compactación automática. Usa valores más bajos como `50` para compactar antes; la variable no puede aumentar el umbral, por lo que se ignoran los valores superiores al porcentaje predeterminado. Solo se aplica en sesiones que compactan antes del límite de contexto del modelo. Se aplica tanto a las conversaciones principales como a los subagentes
`CLAUDE_AUTO_BACKGROUND_TASKS`	Establécela en `1` para forzar la activación del paso automático a segundo plano de las tareas de agente de larga duración. Cuando está activada, un subagente pasa a segundo plano después de ejecutarse durante aproximadamente dos minutos. Si Claude puso en cola una llamada a herramienta, como una edición de archivo, detrás del subagente, el subagente termina en primer plano antes de que esa llamada comience. También activa el paso automático a segundo plano de llamadas largas a herramientas MCP en modo no interactivo en Claude Code v2.1.212 o posterior
`CLAUDE_AX_PREPARK_MS`	En el modo de lector de pantalla, cuántos milisegundos espera Claude Code antes de escribir una línea nueva o modificada. Predeterminado `0`, así que Claude Code no espera. Antes de v2.1.287, el valor predeterminado era `50`. Claude Code limita la espera a `5000`. Se ignora en la configuración de proyecto y local. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_AX_SCREEN_READER`	Establécela en `1` para mostrar una salida adaptada a lectores de pantalla: texto plano sin bordes decorativos ni animaciones. Establécela en `0` para forzar la desactivación del modo de lector de pantalla incluso cuando `axScreenReader` es `true`. El flag `--ax-screen-reader` tiene precedencia. Se ignora en la configuración de proyecto y local. Requiere Claude Code v2.1.181 o posterior
`CLAUDE_AX_STARTUP_QUIET_MS`	En el modo de lector de pantalla, cuántos milisegundos retiene Claude Code el primer renderizado de la interfaz después de la línea de confirmación de inicio. Así tu lector de pantalla puede leer la línea completa antes de que una nueva salida la interrumpa. Predeterminado `3000`. Establece `0` para renderizar de inmediato. Claude Code limita la retención a `600000` (10 minutos). Tu primera pulsación de tecla termina la retención antes de tiempo. Se ignora en la configuración de proyecto y local. Requiere Claude Code v2.1.217 o posterior
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Vuelve al directorio de trabajo original después de cada comando de Bash o PowerShell en la sesión principal
`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS`	Tiempo de espera en milisegundos para el watchdog de inactividad de streaming a nivel de bytes; cuando está establecida, tiene precedencia sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para ese watchdog y deja sin cambios el watchdog a nivel de eventos. Claude Code limita esta variable a un valor 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 listener de bloqueo de pantalla, crea cuando desbloqueas la pantalla y elimina cuando la bloqueas. Mientras el archivo existe, Claude Code omite las notificaciones push móviles de Remote Control, para que dejes de recibir notificaciones mientras usas activamente la computadora. Cuando el archivo no existe o no se puede leer, las notificaciones se envían con normalidad. Claude Code comprueba el archivo una vez por cada evento que desencadena una notificación push, en lugar de consultarlo periódicamente. Requiere Claude Code v2.1.181 o posterior
`CLAUDE_CODE_ACCESSIBILITY`	Establécela en `1` para mantener visible el cursor nativo de la terminal y desactivar el indicador de cursor con texto invertido. Permite que los ampliadores de pantalla, como Zoom de macOS, sigan la posición del cursor
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`	Establécela en `1` para cargar archivos de memoria de los 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`	Establécela en `1` para volver a pintar toda la pantalla en cada fotograma en el renderizado a pantalla completa en lugar de enviar actualizaciones incrementales. Úsala si el modo de pantalla completa muestra fragmentos de texto desactualizados o mal ubicados. Claude Code la activa automáticamente para las sesiones en segundo plano y la vista de agentes en Windows
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Establécela en `1` para enviar el parámetro de esfuerzo con cada solicitud, incluso cuando Claude Code no reconoce el ID del modelo como compatible con el esfuerzo. Úsala al enrutar a través de un gateway de LLM o un proveedor de terceros que sirve modelos con identificadores personalizados. Los modelos que rechazan el parámetro de esfuerzo en la API, incluidos Claude Opus 4.1, Claude Sonnet 4.5, Claude Haiku 4.5 y los modelos anteriores, siguen excluidos para que las solicitudes no fallen
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	Intervalo en milisegundos en el que se deben actualizar las credenciales (al usar `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Establécela en `0` para evitar que Claude Code abra el navegador automáticamente cuando se publica un nuevo artefacto
`CLAUDE_CODE_ARTIFACT_COMMENTS`	Establécela en `0` para que Claude deje de leer y responder comentarios en un artefacto. No tiene efecto cuando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha desactivado los artefactos. Requiere Claude Code v2.1.221 o posterior
`CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT`	Establécela en `0` para que Claude deje de responder por su cuenta a los comentarios que se le envían. Requiere Claude Code v2.1.228 o posterior
`CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS`	Establécelo en `0` para que Claude deje de aplicar pequeños cambios al archivo de un artefacto como parte de su publicación. Claude entonces edita el archivo con sus herramientas de edición de archivos y lo publica como un paso aparte. Requiere Claude Code v2.1.300 o posterior
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Establécela en `0` para omitir el bloque de atribución, que contiene la versión del cliente y una huella del prompt, del inicio del prompt del sistema. El almacenamiento en caché en una conexión directa a la API de Anthropic no se ve afectado en ningún caso. En algunas configuraciones de conexión directa, Claude Code mantiene el bloque en las solicitudes del clasificador del modo automático incluso si estableces `0`. En Bloque de atribución del prompt del sistema, comprueba qué conexiones y credenciales abarca esto. Antes de v2.1.181, el bloque incluía un token por solicitud en las URL base personalizadas y las conexiones de Microsoft Foundry, así que en esas versiones establécela en `0` cuando tu gateway de LLM almacene en caché según el cuerpo de la solicitud o reenvíe solicitudes a un proveedor de terceros, o cuando te conectes directamente a Microsoft Foundry
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	Eliminada en v2.1.283. Usa `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` en su lugar
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Establece la ventana de compactación automática, es decir, cuánto se llena el contexto antes de la compactación, de `100000` a `1000000` tokens. Los valores con sufijo, como `200k`, requieren v2.1.304 o posterior. Para conocer la precedencia sobre las otras formas de establecer la ventana y el efecto en el `used_percentage` de la línea de estado, consulta Establecer la ventana de compactación automática
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Sobrescribe la conexión automática con el IDE. De forma predeterminada, Claude Code se conecta automáticamente cuando se inicia dentro de la terminal integrada de un IDE compatible. Establécela en `false` para evitarlo. Establécela en `true` para forzar un intento de conexión cuando falla la detección automática, por ejemplo cuando tmux oculta la terminal principal. Tiene precedencia sobre el ajuste de configuración global `autoConnectIde`
`CLAUDE_CODE_AUTO_MODE_MODEL`	Establece el modelo para las solicitudes del clasificador que Claude Code envía en el modo automático. Usa un ID de modelo completo como `claude-sonnet-4-6`. Para los casos en que Claude Code la ignora, consulta Elegir el modelo del clasificador. Requiere Claude Code v2.1.302 o posterior
`CLAUDE_CODE_AUTO_MODE_SERVER`	Controla si Claude Code pide al servidor que revise las acciones del modo automático. Establécela en `0` para usar en su lugar las propias solicitudes de clasificador de Claude Code. En una conexión directa a la API de Anthropic, requiere v2.1.281 o posterior. La sección enlazada indica qué sesiones consultan al servidor cuando la variable no está establecida, y desde qué versión. Requiere Claude Code v2.1.271 o posterior
`CLAUDE_CODE_AUTOMOUNT_ROOTS`	Carpetas raíz de automontaje que Claude Code debe omitir cuando busca, en las carpetas por encima de tu directorio de trabajo, archivos como `CLAUDE.md`, skills y `.mcp.json`. Establécela cuando esas búsquedas tengan que esperar a tu automontador. Separa varias rutas con `:` en Unix o `;` en Windows, e indica cada una como una ruta absoluta que no contenga ningún enlace simbólico. Requiere Claude Code v2.1.323 o posterior
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tiempo en milisegundos que Claude Code espera a que la cadena predeterminada de proveedores de credenciales de AWS produzca credenciales antes de que la solicitud falle con `AWS default-chain credential resolve timed out` (predeterminado: `60000`). Auméntalo cuando un paso de tu cadena legítimamente necesite más tiempo, como un inicio de sesión SSO basado en navegador con MFA a través de un wrapper como `aws-vault`. Se aplica en Amazon Bedrock, Claude Platform on AWS y el endpoint de Mantle. Consulta almacenamiento en caché de credenciales y tiempo de espera de resolución. Requiere Claude Code v2.1.207 o posterior
`CLAUDE_CODE_BASH_EDIT_DIFF`	Establécela en `0` para desactivar el diff de los archivos que cambiaron mientras se ejecutaba un comando de Bash, o en `1` para registrarlo en todos los modos de permisos. Tiene precedencia sobre el ajuste `bashEditDiffEnabled`. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`	Establécela en `0` para que una sesión no interactiva informe un estado inactivo a su host al final de cada turno, incluso mientras aún se ejecuta trabajo en segundo plano. De forma predeterminada, la sesión sigue informando un estado de ejecución después del final del turno mientras el trabajo en segundo plano, como un agente en segundo plano o una ejecución de un flujo de trabajo, sigue activo. Esto evita que un host que vigila el estado, como una lista de sesiones remotas, anuncie que Claude espera tu respuesta en medio del trabajo. Los comandos de shell en segundo plano, como un servidor de desarrollo, no mantienen el estado de ejecución. El estado de ejecución predeterminado y la exclusión con `0` requieren Claude Code v2.1.269 o posterior; en versiones anteriores, establece `1` para mantener el estado de ejecución
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Se establece automáticamente en los subprocesos de la herramienta Bash y de los comandos de hooks 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 con el formato `session_`, el mismo identificador que aparece en la URL `claude.ai/code` de la sesión, para que un script pueda enlazar con la sesión que lo ejecutó. Requiere Claude Code v2.1.199 o posterior. En las sesiones en la nube, lee `CLAUDE_CODE_REMOTE_SESSION_ID` en su lugar
`CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`	Establécela en `0` para que Claude Code lea el byte `0x08`, también escrito `^H`, como Retroceso simple, o en `1` para leerlo como Ctrl+Retroceso. Cualquiera de los dos valores 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. Establece `0` en una terminal de Windows donde Retroceso elimina una palabra completa
`CLAUDE_CODE_CERT_STORE`	Lista separada por comas de orígenes de certificados de CA para las conexiones TLS. `bundled` es el conjunto de CA de Mozilla incluido con Claude Code. `system` es el almacén de confianza del sistema operativo, que solo se lee en entornos de ejecución con `tls.getCACertificates`: el binario nativo, o Node 22.15 o posterior para las instalaciones con npm. Consulta Almacén de certificados de CA. El valor predeterminado es `bundled,system`
`CLAUDE_CODE_CHILD_SESSION`	Se establece en `1` en los subprocesos que Claude Code genera mediante las herramientas Bash, PowerShell y Monitor, los comandos de hooks y los comandos de la línea de estado. No se establece para los subprocesos de servidores MCP stdio, que son de larga duración y sobreviven a la sesión que los generó. A diferencia de `CLAUDECODE`, solo la establece el propio Claude Code cuando inicia un subproceso y no las extensiones de IDE, por lo que distingue de forma fiable una sesión anidada de un `claude` de nivel superior iniciado en una terminal integrada en un IDE. Una TUI interactiva anidada de `claude` iniciada de esta forma se excluye automáticamente de `--resume`, `--continue`, el historial de la flecha hacia arriba y la lista de `claude agents`. Las sesiones no interactivas de `claude -p` se siguen conservando. Establece `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para sobrescribir esta exclusión. Requiere Claude Code v2.1.172 o posterior
`CLAUDE_CODE_CLIENT_CERT`	Ruta al archivo de certificado de cliente para la autenticación mTLS
`CLAUDE_CODE_CLIENT_KEY`	Ruta al archivo de clave privada de cliente para la autenticación mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Frase de contraseña para el CLAUDE_CODE_CLIENT_KEY cifrado (opcional)
`CLAUDE_CODE_CONFIG_LOCK_WAIT_MS`	Milisegundos durante los que un comando que agrega o elimina un servidor MCP con alcance `user` o `local`, como `claude mcp add`, sigue intentando obtener el bloqueo de `~/.claude.json` antes de fallar. Si no está configurada, el comando espera entre 10 y 20 segundos aproximadamente, y un valor menor no cambia nada. Requiere Claude Code v2.1.318 o posterior
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Se eliminó en la v2.1.186 y ahora no tiene efecto. Anteriormente establecía un tiempo de espera independiente para la fase de conexión, TLS y encabezados de respuesta de una solicitud a la API en streaming. Usa `API_TIMEOUT_MS` en su lugar. Para la fase de encabezados de respuesta de una solicitud en streaming, consulta `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Sobrescribe la ruta del archivo de registro de depuración. A pesar del nombre, es una ruta de archivo, no un directorio. Requiere que el modo de depuración se active por separado mediante `--debug`, `/debug` o la variable de entorno `DEBUG`: establecer solo esta variable no activa el registro. El flag `--debug-file` hace ambas cosas a la vez. El valor predeterminado es `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	Nivel mínimo de registro que se escribe en el archivo de registro de depuración. Valores: `verbose`, `debug` (predeterminado), `info`, `warn`, `error`. Establécela en `verbose` para incluir diagnósticos de gran volumen, como la salida completa del comando de la línea de estado, o súbela a `error` para reducir el ruido
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Establécela en `1` para desactivar la compatibilidad con la ventana de contexto de 1M. Claude Code elimina las variantes de modelo `[1m]` del selector de modelos y limita a una ventana de 200K los modelos que se ejecutan con la ventana de 1M de forma predeterminada. Consulta Desactivar el contexto de 1M. Útil para entornos empresariales con requisitos de cumplimiento. Para conocer su función al corregir la ventana de un ID de modelo `[1m]` no reconocido, consulta Corregir la ventana para un gateway o un ID de modelo personalizado
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Establécela en `1` para desactivar el razonamiento adaptativo en Opus 4.6 y Sonnet 4.6 y recurrir al presupuesto de pensamiento fijo controlado por `MAX_THINKING_TOKENS`. No tiene efecto en los modelos Fable, Sonnet 5 y posteriores, Haiku 5.5, ni Opus 4.7 y posteriores, que siempre usan razonamiento adaptativo
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Establécela en `1` para desactivar la herramienta advisor. El comando `/advisor` deja de estar disponible, cualquier `advisorModel` configurado se ignora y el flag `--advisor` se acepta pero no tiene efecto, por lo que los scripts existentes que lo pasan siguen funcionando sin errores
`CLAUDE_CODE_DISABLE_AGENT_VIEW`	Establécela en `1` para desactivar los agentes en segundo plano y la vista de agentes: `claude agents`, `--bg`, `/background` y el supervisor bajo demanda. Equivale al ajuste `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Establécela en `1` para desactivar el renderizado a pantalla completa y usar el renderizador clásico de pantalla principal. La conversación permanece en el historial de desplazamiento nativo de tu terminal, por lo que `Cmd+f` y el modo de copia de tmux funcionan como de costumbre. Tiene precedencia sobre `CLAUDE_CODE_NO_FLICKER` y el ajuste `tui`. También puedes cambiar con `/tui default`. No se aplica a las sesiones en segundo plano abiertas desde la vista de agentes, que siempre usan el renderizado a pantalla completa
`CLAUDE_CODE_DISABLE_ARTIFACT`	Establécela en `1` para desactivar la herramienta Artifact, que publica la salida de la sesión como una página web privada en claude.ai. Una vez establecida, ningún archivo de configuración vuelve a activar la herramienta. Para desactivar la herramienta desde un archivo de configuración, establece `enableArtifact` en `false`; la clave obsoleta `disableArtifact` también la desactiva
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Establécela en `1` para desactivar el procesamiento de archivos adjuntos. Las menciones de archivos con la sintaxis `@` se envían como texto plano en lugar de expandirse al contenido del archivo. Se ignora en la configuración de proyecto y local
`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`	Establécela en `1` para que un proceso de Claude Code ejecute por sí mismo su comando `gcpAuthRefresh` o `awsAuthRefresh` en lugar de esperar mientras otro proceso lo ejecuta. Requiere Claude Code v2.1.286 o posterior
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Establécela en `1` para desactivar la memoria automática. Establécela en `0` para forzar la activación de la memoria automática incluso cuando el modo `--bare` o `autoMemoryEnabled: false` la desactivarían. Cuando está desactivada, Claude no crea ni carga archivos de memoria automática
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Establécela en `1` para eliminar el parámetro `run_in_background` de las herramientas Bash, PowerShell y de subagentes, y para desactivar el atajo Ctrl+B y las ejecuciones en segundo plano de los skills bifurcados. Claude Code también deja entonces de pasar automáticamente a segundo plano los subagentes, las llamadas largas a herramientas de MCP y los comandos de shell que agotan el tiempo de espera. Las tareas de MCP y la herramienta Monitor se siguen ejecutando en segundo plano. Para desactivar también las sesiones en segundo plano, establece `CLAUDE_CODE_DISABLE_AGENT_VIEW` en `1`
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT`	Establécela en `1` para que Claude Code deje de tratar una respuesta en streaming de Amazon Bedrock con un encabezado `Content-Type` ausente o vacío como el flujo de eventos binario de Amazon Bedrock. De forma predeterminada, Claude Code asume que un gateway eliminó el encabezado de una respuesta que por lo demás no se modificó, así que decodifica el cuerpo y el streaming sigue funcionando. Establécela solo para un gateway que además reemite el flujo como eventos enviados por el servidor; Claude Code lee entonces el cuerpo sin encabezado como eventos enviados por el servidor. Requiere Claude Code v2.1.239 o posterior
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Establécela en `1` para omitir la comprobación de que una respuesta en streaming de Amazon Bedrock lleva el content-type `application/vnd.amazon.eventstream`. Sin esta variable, cuando una respuesta lleva un content-type distinto, Claude Code hace fallar la solicitud con un error que nombra ese tipo, lo que significa que un gateway o proxy está transformando la respuesta. Configura el gateway para que reenvíe 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`	Establécela en `1` para detener el trabajo en curso de una sesión en segundo plano cuando el supervisor detiene, reinicia o actualiza el proceso de esa sesión, en lugar de traspasarlo al siguiente proceso de la sesión. Ese trabajo son los comandos de shell en segundo plano en ejecución de la sesión, además de los subagentes en segundo plano a partir de v2.1.198. Solo afecta a ese traspaso: pasar una sesión a segundo plano con `←` o `/background` sigue trasladando el trabajo en segundo plano en curso. Requiere Claude Code v2.1.196 o posterior
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Establécela en `1` para evitar que Claude Code termine los comandos de shell en segundo plano bajo presión de memoria. De forma predeterminada, en macOS y Linux, Claude Code termina los shells en segundo plano cuando el sistema operativo informa una presión de memoria crítica y la sesión ha estado inactiva durante 30 minutos sin ningún turno ni 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_BG_STABLE_PATH`	En macOS con el instalador nativo, establécela en `1` para ejecutar el proceso host de cada sesión en segundo plano desde el binario instalado, no desde `~/.local/share/claude/ClaudeCode.app`. Es posible que macOS vuelva a pedir permisos como el acceso a carpetas, incluso después de cada actualización. Establécela en el bloque `env` de la configuración de usuario, un archivo de configuración administrada o una política de MDM, no en tu shell. Para eliminar `ClaudeCode.app`, bórralo tú mismo. Requiere Claude Code v2.1.295 o posterior
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Establécela en `1` para desactivar los skills y flujos de trabajo incluidos con Claude Code: los skills y flujos de trabajo incluidos se eliminan por completo, mientras que los comandos integrados como `/init` se pueden seguir escribiendo pero se ocultan al modelo. `/doctor` se puede seguir escribiendo como los comandos integrados; ocúltalo con `DISABLE_DOCTOR_COMMAND` en su lugar. Los skills de plugins, `.claude/skills/` y `.claude/commands/` no se ven afectados. Equivale al ajuste `disableBundledSkills`
`CLAUDE_CODE_DISABLE_CFC_PROMPT`	Para hosts que integran Claude Code y proporcionan su propia guía para el navegador. Establécela en `1` para mantener disponibles las herramientas de navegador de Claude in Chrome y omitir la sección de Chrome del prompt del sistema y el skill incluido `/claude-in-chrome`. En VS Code, la extensión en v2.1.314 o posterior también omite las instrucciones de Claude in Chrome de los mensajes de una sesión. Requiere Claude Code v2.1.257 o posterior
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Establécela en `1` para evitar cargar cualquier archivo de memoria CLAUDE.md en el contexto, incluidos los archivos de memoria de usuario, de proyecto y de memoria automática
`CLAUDE_CODE_DISABLE_CRON`	Establécela en `1` para desactivar las tareas programadas con alcance de sesión. El skill `/loop` y `CronCreate` dejan de estar disponibles y cualquier tarea ya programada deja de ejecutarse, incluidas las tareas que ya están en ejecución a mitad de sesión
`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`	Establécela en `1` para desactivar el límite de tiempo y las denegaciones de `auto` y `bypassPermissions` en las eliminaciones de rutas críticas. En ese caso, estas eliminaciones pasan al clasificador en el modo `auto` y reciben una solicitud sin límite de tiempo en el modo `bypassPermissions` siempre que Claude Code pueda mostrar una. Establécela en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada mediante un bloque `env` de la configuración. Requiere Claude Code v2.1.281 o posterior
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Establécela en `1` para eliminar de las solicitudes a la API los encabezados de solicitud `anthropic-beta` de versiones preliminares, los campos del cuerpo que los acompañan y los campos beta del esquema de herramientas, como `defer_loading` y `eager_input_streaming`. Úsala cuando un gateway proxy rechace las solicitudes con un error `Unexpected value(s)` para el encabezado `anthropic-beta` o un error `Extra inputs are not permitted`. Desactivar las capacidades preliminares enumera lo que elimina la variable, incluido MCP Tool Search, y lo que Claude Code sigue enviando
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Establécela en `1` para desactivar los subagentes Explore y Plan integrados. Claude explora con sus herramientas de búsqueda o con el subagente de propósito general en su lugar, y el modo plan lee los archivos directamente en lugar de iniciar los agentes Explore y Plan. Los subagentes personalizados llamados `Explore` o `Plan` no se ven afectados. Para eliminar todos los tipos de subagentes integrados en el Agent SDK o en modo no interactivo, usa `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` en su lugar. Requiere Claude Code v2.1.198 o posterior
`CLAUDE_CODE_DISABLE_FAST_MODE`	Establécela en `1` para desactivar el modo rápido
`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`	Establécela en `1` para desactivar la obtención de feature flags. Requiere Claude Code v2.1.319 o posterior. Con esta variable establecida, Remote Control y las demás funciones que necesitan la obtención de feature flags no están disponibles. El registro de eventos de telemetría sigue activo a menos que también se establezca `DISABLE_TELEMETRY`. El nombre anterior, `DISABLE_GROWTHBOOK`, sigue funcionando, y es el único que leen las versiones v2.1.124 a v2.1.318
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Establécela en `1` para desactivar las encuestas de calidad de sesión “How is Claude doing?”. Las encuestas también se desactivan cuando se establece `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` las vuelva a activar. Para establecer una frecuencia de muestreo en lugar de desactivarlas por completo, usa el ajuste `feedbackSurveyRate`. Consulta Encuestas de calidad de sesión
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Establécela en `1` para desactivar el checkpointing de archivos. El comando `/rewind` no podrá restaurar los cambios de código. Sobrescribe el ajuste `fileCheckpointingEnabled`
`CLAUDE_CODE_DISABLE_FILE_MENTIONS`	Establécela en `1` para que Claude Code deje de expandir las menciones con `@` de archivos y directorios. En su lugar, Claude recibe las rutas mencionadas con una nota para leerlas usando sus herramientas de archivos. Se ignora en la configuración del proyecto y local. Requiere Claude Code v2.1.299 o posterior
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Establécela en `1` para eliminar del contexto de Claude las instrucciones integradas del flujo de trabajo de commits y PR, y la instantánea del estado de git. Útil cuando usas tus propios skills de flujo de trabajo de git. Cuando está establecida, tiene precedencia sobre el ajuste `includeGitInstructions`
`CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT`	Establécela en `1` para que Claude Code deje de leer los scripts que se pasan a un shell con `-c`, como `bash -c 'rm -rf ~'`, en busca de eliminaciones de rutas críticas. Claude Code sigue comprobando los destinos de variables de shell y parámetros posicionales en esos scripts, y las demás comprobaciones de rutas críticas se siguen ejecutando. Establécela en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada mediante un bloque `env` de la configuración. Requiere Claude Code v2.1.288 o posterior
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Establécela en `1` para impedir la reasignación automática de Opus 4 y Opus 4.1 a la versión actual de Opus en la API de Anthropic. Úsala cuando quieras fijar intencionalmente un modelo anterior. La reasignación no se ejecuta en Amazon Bedrock, Google Cloud’s Agent Platform ni Microsoft Foundry
`CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND`	Establécela en `1` para que Claude espere el resultado de una tarea MCP en una sesión interactiva. Mientras el paso automático a segundo plano esté activado, la llamada se sigue moviendo a segundo plano después de dos minutos de forma predeterminada. Requiere Claude Code v2.1.304 o posterior
`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK`	Establécela en `1` para evitar que Claude Code en Amazon Bedrock y Google Cloud’s Agent Platform cambie a un modelo anterior cuando tu cuenta pierde el acceso al modelo de una sesión a mitad de la sesión; en su lugar, la solicitud rechazada falla de inmediato. Una cadena de modelos de respaldo que configures sigue cambiando ante ese rechazo, y las comprobaciones de modelo al inicio siguen recurriendo a un respaldo al iniciar. Requiere Claude Code v2.1.285 o posterior
`CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT`	Establécela en `1` para desactivar la solicitud de confirmación de unidades montadas para rutas como `/Volumes/USB`. Establécela en el entorno que inicia Claude Code, porque Claude Code la ignora en un bloque `env` de la configuración. Requiere Claude Code v2.1.304 o posterior
`CLAUDE_CODE_DISABLE_MOUSE`	Establécela en `1` para desactivar el seguimiento del mouse en el renderizado a pantalla completa. El desplazamiento con el teclado mediante `PgUp` y `PgDn` sigue funcionando. Úsala para conservar el comportamiento nativo de copiar al seleccionar de tu terminal
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Establécela en `1` para desactivar el manejo de clics, arrastres y desplazamiento del puntero sobre elementos en el renderizado a pantalla completa mientras se mantiene el desplazamiento con la rueda del mouse. Úsala cuando quieras que el desplazamiento con la rueda funcione dentro de Claude Code pero no quieras que los clics posicionen el cursor, expandan la salida de las herramientas o abran enlaces. `CLAUDE_CODE_DISABLE_MOUSE` tiene precedencia cuando ambas están establecidas. Requiere Claude Code v2.1.195 o posterior
`CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION`	Establécela en `1` para evitar que Claude Code vuelva a leer el certificado y la clave de cliente mTLS cuando una solicitud a la API falla con un error a nivel de conexión, como un restablecimiento de la conexión o un error del protocolo de enlace TLS. Con la recarga desactivada, Claude Code carga los archivos rotados solo la próxima vez que aplica la configuración o en el siguiente inicio. Requiere Claude Code v2.1.232 o posterior
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Establécela en cualquier valor no vacío, como `1`, para desactivar el tráfico de red no esencial: actualizaciones automáticas, telemetría, informes de errores, el comando `/feedback`, los comentarios redactados por Claude, las notas de la versión, las comprobaciones de la insignia de estado de PR y MR y las comprobaciones de disponibilidad, como la del modo rápido. También detiene las ejecuciones en segundo plano de los orígenes `command` de plugins, que son comandos locales y no tráfico de red, porque pueden desencadenar instalaciones de dependencias. Establecerla en `0` o `false` sigue desactivando este tráfico, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para volver a permitirlo. También desactiva la obtención de feature flags, lo que hace que Remote Control y las demás funciones que necesitan la obtención de feature flags no estén disponibles. La instalación automática del marketplace oficial de plugins no está incluida; desactívala con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. No afecta al descubrimiento de modelos del gateway, que tiene su propia activación
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Establécela en `1` para desactivar el respaldo sin streaming cuando una solicitud en streaming falla a mitad del flujo. En su lugar, los errores de streaming se propagan a la capa de reintentos. Útil cuando un proxy o gateway hace que el respaldo produzca ejecuciones duplicadas de herramientas
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Establécela en `1` para enviar la notificación de escritorio de la herramienta `PushNotification` incluso mientras escribes en la terminal o esta tiene el foco. De forma predeterminada, la herramienta omite tanto la notificación de escritorio como la notificación push móvil cuando detecta actividad reciente del teclado o foco en la terminal. Esta variable solo desactiva esa comprobación local, por lo que el servidor aún puede suprimir la notificación push móvil cuando detecta que estás activo. Requiere Claude Code v2.1.193 o posterior
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Establécela en `1` para desactivar el registro automático del marketplace oficial de plugins. Claude Code lee la variable cuando está a punto de registrar el marketplace, normalmente durante el primer inicio interactivo en una máquina. Si la variable está establecida en ese momento, Claude Code omite el registro de forma permanente. Eliminar la variable más tarde no deshace la omisión. Ejecuta `claude plugin marketplace add anthropics/claude-plugins-official` para registrar el marketplace en cualquier momento
`CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS`	Establécela en `1` para que Claude Code deje de ejecutar tus hooks `Notification` para solicitudes de permiso sin responder en sesiones donde Claude Code las envía a la callback `canUseTool` del Agent SDK, que es como Claude Desktop y la extensión de 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`	Establécela en `1` para omitir la carga de skills desde el directorio de skills administrados de todo el sistema. Útil para sesiones de contenedores o de CI que no deben cargar skills aprovisionados por el operador
`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`	Establécela en `1` para desactivar la comprobación de la herramienta PowerShell que deniega los comandos integrados de `cmd` `rd`, `rmdir`, `del` y `erase` en una ruta del sistema, como la raíz de una unidad o tu directorio home. Claude Code ignora esta variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.283 o posterior
`CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK`	Establécela en `1` para desactivar el cambio automático de modelo cuando un clasificador de seguridad marca una solicitud, el comportamiento que controla el ajuste `switchModelsOnFlag`
`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS`	Establécela en `1` para que Claude Code deje de enviar el campo de salida estructurada `output_config.format` y el valor de `anthropic-beta` que lo acompaña, para un gateway de LLM cuyo servicio ascendente los rechaza. Esto deja activadas las demás capacidades preliminares que `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` desactiva. Requiere Claude Code v2.1.288 o posterior
`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`	Establécela en `1` para desactivar la comprobación de rutas críticas para un `rm` recursivo cuyo destino es completamente la salida de una sustitución de comandos, como `rm -rf "$(pwd)"`. Las demás comprobaciones de rutas críticas se siguen ejecutando. Establécela en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada mediante un bloque `env` de la configuración. Requiere Claude Code v2.1.281 o posterior
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Establécela 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 en segundo plano al modelo pequeño/rápido que genera un título de sesión, y desactiva los informes de estado a tu terminal
`CLAUDE_CODE_DISABLE_THINKING`	Establécela en `1` para omitir por completo el parámetro `thinking` de las solicitudes a la API. Es una opción de compatibilidad para proxies y gateways que rechazan el parámetro. En los modelos que piensan de forma predeterminada, omitir el parámetro significa que el modelo puede seguir pensando. Para desactivar explícitamente el pensamiento extendido en la API de Anthropic, usa `MAX_THINKING_TOKENS=0` en su lugar. Ninguna de las dos variables desactiva el pensamiento en Opus 5.5, Sonnet 5.5, Haiku 5.5 ni en los modelos Fable, en los que no se puede desactivar el pensamiento. En proveedores de terceros, `MAX_THINKING_TOKENS=0` también omite el parámetro, por lo que allí ambas variables se comportan igual
`CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK`	Establécela en `1` para que `claude ultrareview` no termine con `Error: Workspace not trusted` en una carpeta en la que no confiaste cuando no puede pedirte que confíes en ella, como en CI. Establécela en el entorno que inicia Claude Code, no en un bloque `env` de la configuración, y solo donde cada una de esas ejecuciones comience en una carpeta en la que confías. Las ejecuciones que pueden preguntar siguen preguntando. Requiere Claude Code v2.1.309 o posterior
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Establécela en `1` para omitir la compactación automática proactiva cuando Claude Code no reconoce el ID del modelo, como un alias de un gateway de LLM. Sin esta variable, Claude Code compacta según la ventana de contexto que asume para el ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` puede corregir en su lugar la ventana asumida; consulta Corregir la ventana para un gateway o un ID de modelo personalizado para saber cuándo se aplica cada variable. Requiere Claude Code v2.1.223 o posterior
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Establécela en `1` para desactivar el desplazamiento virtual en el renderizado a pantalla completa y renderizar todos los mensajes de la transcripción. Úsala si al desplazarte en el modo de pantalla completa aparecen regiones en blanco donde deberían aparecer mensajes
`CLAUDE_CODE_DISABLE_WEB_FETCH`	Establécela en `1` para desactivar la herramienta WebFetch. La herramienta WebSearch sigue disponible. Requiere Claude Code v2.1.285 o posterior
`CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER`	Establécela en `1` para iniciar los comandos de la herramienta PowerShell en Windows directamente en lugar de a través del lanzador `cmd.exe`. De forma predeterminada, el lanzador permite que un comando de PowerShell que se ejecuta en segundo plano se traslade al siguiente proceso de la sesión, por ejemplo cuando pasas la sesión a segundo plano. Si estableces la variable, un comando de PowerShell en segundo plano se detiene cuando termina el proceso de la sesión. Los comandos de Bash no se ven afectados. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Establécela en `1` para desactivar los flujos de trabajo. Equivale al ajuste `disableWorkflows`
`CLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOL`	Establécela en `1` para descartar una llamada a herramienta diferida cuya herramienta no está disponible cuando reanudas con `-p`. Sin esta variable, la llamada queda pendiente y un prompt que envíes no llega a Claude. Requiere Claude Code v2.1.319 o posterior
`CLAUDE_CODE_EFFORT_LEVEL`	Establece el nivel de esfuerzo para los modelos compatibles. Valores: `low`, `medium`, `high`, `xhigh` o `max`. Los niveles disponibles dependen del modelo. Tiene precedencia sobre `--effort`, `/effort` y los ajustes `modelSettings` y `effortLevel`. Un límite `maxEffortLevel` sigue aplicándose. Establécela en `auto` o `unset` para que Claude Code no envíe ningún nivel de esfuerzo, de modo que la API aplique su propio valor predeterminado para el modelo. Consulta Ajustar el nivel de esfuerzo
`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS`	Establécela en `1` para agregar al flujo de mensajes los mensajes `session_state_changed`, que contienen el estado de la sesión. Requiere el Agent SDK o bien `--print`, `--output-format stream-json` y `--verbose`
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Se acepta por compatibilidad con versiones anteriores y no tiene efecto. El modo automático está disponible de forma predeterminada en todos los proveedores, incluidos Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry y las sesiones con sesión iniciada en Claude apps gateway. De la v2.1.158 a la v2.1.206, era necesario establecerla en `1` para que el modo automático estuviera disponible en esos proveedores
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Sobrescribe la disponibilidad del resumen de sesión. Establécela en `0` para forzar la desactivación de los resúmenes independientemente del interruptor de `/config`. Establécela en `1` para forzar su activación cuando `awaySummaryEnabled` sea `false`. Tiene precedencia sobre el ajuste y sobre el interruptor de `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Establécela en `1` para actualizar el estado de los plugins entre turnos en modo no interactivo después de que se complete una instalación en segundo plano. Desactivada de forma predeterminada porque la actualización cambia el prompt del sistema a mitad de la sesión, lo que invalida la caché de prompts para ese turno
`CLAUDE_CODE_ENABLE_CFC`	Establécela en `1` para iniciar una sesión de la CLI con la integración con Chrome activada, o en `0` para iniciarla desactivada. Tiene precedencia sobre el ajuste `claudeInChromeDefaultEnabled`. Los flags `--chrome` y `--no-chrome` tienen precedencia sobre ambos. Claude Code ignora `1` en la configuración de proyecto y local
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Establécela en `1` para dirigir la encuesta de calidad de sesión “How is Claude doing?” a tu propio recolector de OpenTelemetry cuando el tráfico no esencial destinado a Anthropic está bloqueado. Las calificaciones de la encuesta se emiten solo como eventos OTEL a tu recolector configurado. En este modo no se envían datos de la encuesta a Anthropic. Se aplica cuando se establece `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, y no tiene efecto en otro caso. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` y la política de comentarios sobre el producto de la organización tienen precedencia
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controla si las entradas de las llamadas a herramientas se transmiten desde la API a medida que Claude las genera. Con esto desactivado, una entrada de herramienta grande, como la escritura de un archivo largo, llega solo después de que Claude termina de generarla, lo que puede parecer que se ha quedado colgado. Activada de forma predeterminada en la API de Anthropic. En Amazon Bedrock y Google Cloud’s Agent Platform, se activa por modelo cuando el contenedor desplegado lo admite. Establécela en `0` para desactivarla. Establécela en `1` para forzar su activación cuando enrutas a través de un proxy mediante `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Desactivada de forma predeterminada en Microsoft Foundry y en conexiones a través de un gateway
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Establécela en `1` para llenar el selector de `/model` desde el endpoint `/v1/models` de tu gateway cuando `ANTHROPIC_BASE_URL` apunta a un gateway compatible con Anthropic, como LiteLLM, Kong o un proxy interno. Desactivada de forma predeterminada porque, de lo contrario, los gateways respaldados por una clave de API compartida mostrarían a cada usuario todos los modelos a los que la clave puede acceder. Los modelos descubiertos siguen filtrándose mediante una lista de modelos permitidos `availableModels` que recibe la sesión; entrega la lista mediante MDM o un archivo de configuración administrada, ya que la entrega administrada por el servidor no está disponible en configuraciones con gateway
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Eliminada en la v2.1.142, cuando el valor predeterminado del modo rápido pasó de Opus 4.6 a Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Establécela en `false` para desactivar las sugerencias de prompts, las predicciones en gris que aparecen en la entrada del prompt. Tiene precedencia sobre el ajuste `promptSuggestionEnabled`, que es lo que escribe el interruptor Prompt suggestions de `/config`. Claude Code también pausa las sugerencias mientras tu cuenta está cerca de su límite de uso o lo ha alcanzado. Establécela en `true` para evitar que esa pausa se aplique hasta que alcances el límite. Requiere Claude Code v2.1.238 o posterior. Consulta Sugerencias de prompts
`CLAUDE_CODE_ENABLE_SHARE_BUNDLE`	Establécela en `1` para que `/share` guarde su informe y la transcripción completa de la sesión en un archivo local en `~/.claude/feedback-bundles/` en lugar de enviar el informe a Anthropic. Si la política de tu organización desactiva `/share`, no puedes volver a activarlo con esta variable. Requiere Claude Code v2.1.299 o posterior
`CLAUDE_CODE_ENABLE_TASKS`	Selecciona qué herramientas de seguimiento de tareas proporciona Claude Code en las sesiones que las tienen. De forma predeterminada, Claude Code proporciona las herramientas Task `TaskCreate`, `TaskUpdate`, `TaskGet` y `TaskList`. Establécela en `0` para obtener en su lugar la herramienta heredada `TodoWrite`. Consulta Lista de tareas
`CLAUDE_CODE_ENABLE_TELEMETRY`	Establécela en `1` para habilitar la recopilación de datos de OpenTelemetry para métricas y registros. Es necesaria antes de configurar los exportadores de OTel. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local. Consulta Monitoreo
`CLAUDE_CODE_ENABLE_TODO_TOOLS`	Establécela en `1` para obtener las herramientas de seguimiento de tareas en todos los modelos. Sin ella, Claude Code las proporciona de forma predeterminada solo en los modelos indicados en Disponibilidad de la herramienta Task. `CLAUDE_CODE_ENABLE_TASKS` sigue seleccionando las herramientas Task o `TodoWrite`. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS`	Establécela en `1` para ejecutar comandos `rm` peligrosos sin solicitud en el modo `bypassPermissions`, lo que elimina una solicitud de seguridad para los borrados destructivos. La sección enlazada indica dónde no tiene efecto. Establécela en el entorno que inicia Claude Code, porque Claude Code la ignora en un bloque `env` de la configuración. Requiere Claude Code v2.1.311 o posterior
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tiempo en milisegundos que se espera después de que el bucle de consultas queda inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que usan el modo SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Establécela en `1` para habilitar los equipos de agentes. Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada
`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE`	Establécela en `1` para iniciar las sesiones en Code Mode, una función experimental. Establécela en `0` para mantenerlo desactivado, o en la configuración administrada para bloquearlo para una organización. La variable no cuenta en todos los archivos de configuración. Consulta los requisitos de versión y de cuenta
`CLAUDE_CODE_EXTRA_BODY`	Objeto JSON que se combina en el nivel superior de los cuerpos de las solicitudes al modelo, excepto en algunas solicitudes fuera de la conversación, como las comprobaciones de `/model`. Útil para pasar parámetros específicos del proveedor que Claude Code no expone directamente. Un valor exportado en tu shell también se aplica a las sesiones en segundo plano que inicias con `claude agents` o `--bg`. Antes de v2.1.206, las sesiones en segundo plano ignoraban un valor exportado en el shell y usaban la copia que hubiera heredado el proceso supervisor en segundo plano
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Sobrescribe el límite de tokens predeterminado para la lectura de archivos, que es de 25,000 tokens. Útil cuando necesitas leer archivos más grandes completos. Una lectura que Claude hace con el parámetro `allow_large` puede superar este límite cuando la ventana de contexto tiene espacio
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Establécela en `1` para forzar la persistencia de la transcripción, el historial de prompts y el registro en `claude agents` incluso cuando este `claude` se haya iniciado desde dentro de otra sesión de Claude Code. Úsala cuando un valor heredado de `CLAUDE_CODE_CHILD_SESSION`, por ejemplo de una sesión de `screen` o de un lanzador en segundo plano iniciado por primera vez por la herramienta Bash de Claude Code, haga que una sesión genuina de nivel superior se clasifique erróneamente como anidada. A partir de la 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 respeta en la v2.1.169 y anteriores; no tiene efecto en la v2.1.170 ni en la v2.1.171, donde se eliminó la detección de sesiones anidadas que sobrescribe
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Establécela en `1` para forzar la representación tachada de `~~text~~` en las respuestas de Claude cuando tu terminal lo admite pero no se detecta automáticamente, por ejemplo a través de SSH sin reenviar `TERM_PROGRAM`. Sin esto, las terminales no detectadas muestran los marcadores `~~` literales en lugar de representar el texto tachado. Requiere Claude Code v2.1.186 o posterior
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	Establécela en `1` para forzar la activación de la salida sincronizada del modo privado DEC 2026 cuando tu terminal la 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 capacidades. No tiene efecto bajo tmux. A diferencia de `CLAUDE_CODE_NO_FLICKER`, que cambia a la representación en pantalla completa, esta no cambia el renderizador
`CLAUDE_CODE_FORCE_TERMINAL_IMAGES`	Establécelo en `1` para dibujar los elementos `Image` de mods como imágenes cuando tu terminal dibuja imágenes del protocolo de gráficos de kitty con marcadores de posición Unicode y aun así ves el texto `alt` atenuado de un `Image`. Consulta qué terminales dibujan un `Image` y dónde no establecer esta variable
`CLAUDE_CODE_FORK_SUBAGENT`	Controla el modo fork, que está activado de forma predeterminada y permite que Claude inicie forks por su cuenta. Mientras el modo fork está activado, Claude tampoco puede esperar a un subagente en sesiones interactivas de terminal, VS Code o escritorio en tu máquina. Establécela en `0` para desactivar el modo fork. Para las versiones, consulta Desactivar el modo fork
`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`	Establécela en `1` para emitir el texto y los bloques de pensamiento de los subagentes en la salida de `claude -p --output-format stream-json`, el mismo comportamiento que el flag `--forward-subagent-text`. Usa la variable cuando un harness invoca `claude` y no puede pasar el flag por sí mismo. A diferencia del flag, que termina con un error fuera del modo no interactivo con salida stream-json, la variable se ignora en esos casos para que las invocaciones anidadas sigan funcionando cuando se establece para todo el proceso. Requiere Claude Code v2.1.211 o posterior
`CLAUDE_CODE_GATEWAY_HINT_HEADERS`	Establécela en `1` para enviar los encabezados de sugerencia para gateways, como `x-claude-code-request-class` y `x-claude-code-compaction`, en un proxy personalizado o en un proveedor externo como Amazon Bedrock o Claude Platform on AWS. Establécela en `0` para dejar de enviarlos en todas las conexiones, 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 del gateway que activa `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (predeterminado: `3000`). Auméntalo cuando tu gateway necesite más de tres segundos para responder a `/v1/models` al inicio. Solo acepta dígitos simples; `0`, los valores negativos y otras escrituras mantienen el valor predeterminado. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_GIT_BASH_PATH`	Solo Windows: ruta al ejecutable de Git Bash (`bash.exe`). Úsala cuando Git Bash esté instalado pero no esté en tu PATH. Si la ruta no existe o el archivo no se llama `bash.exe`, `sh.exe`, `bash` ni `sh`, Claude Code ignora la variable y detecta Git Bash automáticamente como si no estuviera establecida, y registra una advertencia visible con `--debug`. Antes de la v2.1.219, Claude Code terminaba al iniciar cuando la ruta no existía, y usaba cualquier archivo existente como shell sin comprobar que fuera bash o sh. Consulta Configuración en Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Establécela en `false` para excluir los dotfiles de los resultados cuando Claude invoca la herramienta Glob. Se incluyen de forma predeterminada. No afecta al autocompletado de archivos con `@`, a `ls`, a Grep ni a Read
`CLAUDE_CODE_GLOB_NO_IGNORE`	Establécela en `false` para que la herramienta Glob respete los patrones de `.gitignore`. De forma predeterminada, Glob devuelve todos los archivos coincidentes, incluidos los ignorados por git. No afecta al autocompletado de archivos con `@`, que tiene su propio ajuste `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Tiempo de espera en segundos para las búsquedas de las herramientas Glob y Grep. El valor predeterminado es de 20 segundos en la mayoría de las plataformas y de 60 segundos en WSL
`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`	Cuántos minutos puede el trabajo en segundo plano mantener en espera un objetivo activo antes de que Claude Code le pida a Claude que lo revise. Valor predeterminado: `30`. Establécela en `0` para desactivar las revisiones. Indica minutos enteros con 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_GZIP_REQUEST_BODIES`	Establécela en `0` para desactivar la compresión gzip de los cuerpos de las solicitudes a la API de Claude, de telemetría y de publicación de artefactos enviadas a `api.anthropic.com`. De forma predeterminada, Claude Code comprime los cuerpos de solicitud grandes en conexiones directas y omite la compresión cuando envías solicitudes a través de un proxy, configuras un certificado de cliente o estableces `NODE_EXTRA_CA_CERTS`. Usa `0` si un proxy de inspección TLS que Claude Code no puede detectar maneja mal las solicitudes comprimidas
`CLAUDE_CODE_HIDE_CWD`	Establécela en `1` para ocultar el directorio de trabajo en el logotipo de inicio. Útil para compartir pantalla o grabaciones en las que la ruta expone tu nombre de usuario del sistema operativo
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Sobrescribe la dirección del host que se usa para conectarse a la extensión del 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`	Establécela en `1` para impedir que `/ide` instale la extensión del IDE. Equivale a establecer `autoInstallIdeExtension` en `false`. Las versiones de Claude Code anteriores a la v2.1.318 también instalan o actualizan la extensión cuando inicias `claude` en una terminal de VS Code, Cursor o Devin Desktop. Esta variable también lo impide
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Establécela en `1` para omitir la validación de las entradas del archivo de bloqueo del IDE durante la conexión. Úsala cuando la conexión automática no encuentre tu IDE aunque esté en ejecución
`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`	Tamaño del contexto, en tokens, a partir del cual la compactación por inactividad se aplica a una conversación (valor predeterminado: `200000`). Acepta un número entero positivo, y cualquier otro valor se ignora. Los valores inferiores a `100000` se elevan a `100000`, el umbral más bajo. La compactación por inactividad está activada de forma predeterminada para las conversaciones que cumplen sus condiciones. Para desactivarla, establece `idleCompaction` en `false`. Requiere Claude Code v2.1.290 o posterior
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	Cuántos subagentes pueden estar en ejecución en una sesión antes de que la herramienta Agent se niegue a generar otro (predeterminado: 20). Acepta un número entero positivo con dígitos simples; cualquier otro valor 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`	Sobrescribe el tamaño de la ventana de contexto que Claude Code supone para el modelo activo. A partir de la v2.1.193, cómo se aplica depende de cómo resuelve Claude Code el ID del modelo; consulta Corregir la ventana para un gateway o un ID de modelo personalizado. Úsala cuando enrutes 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 las descripciones de herramientas MCP y de las instrucciones de servidores MCP que Claude Code envía al modelo. El valor que establezcas reemplaza ambos límites predeterminados: 4096, y 16384 para la descripción de una herramienta que Claude carga mediante la búsqueda de herramientas. Acepta un número entero positivo en dígitos simples. Cualquier otro valor se ignora y se aplican los predeterminados. Requiere Claude Code v2.1.280 o posterior
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Establece el número máximo de tokens de salida para la mayoría de las solicitudes. Los valores predeterminados y los límites varían según el modelo; consulta tokens de salida máximos. Claude Code reduce al límite un valor que supere el límite de un modelo. Para un ID de modelo que Claude Code no puede resolver a un modelo que conozca, el valor predeterminado es 32000 y el límite es 128000. Aumentar este valor reduce la ventana de contexto efectiva disponible antes de que se active la compactación automática
`CLAUDE_CODE_MAX_RETRIES`	Sobrescribe el número de veces que se reintentan las solicitudes fallidas a la API (predeterminado: 10). Los reintentos pueden detenerse antes ante errores `529` de sobrecarga. Por ejemplo, con una clave de API en un modelo Opus, se detiene en el tercer `529` y muestra Repeated 529 Overloaded errors. Si estableces un modelo de respaldo, Claude Code cambia a ese modelo en lugar de mostrar el error. Limitada a 15 a partir de la v2.1.186; a partir de la v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta el valor predeterminado y elimina el límite. Para sesiones desatendidas que necesitan esperar durante interrupciones más largas, establece `CLAUDE_CODE_RETRY_WATCHDOG` en su lugar
`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`	Eliminada en la v2.1.224 y ahora no tiene efecto. Antes 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 subagentes concurrentes y el límite de profundidad siguen aplicándose
`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	Número de capas de subagentes permitidas por debajo de la conversación principal (predeterminado: 3). Con el valor predeterminado, los subagentes pueden generar sus propios subagentes, y un subagente de la tercera capa no puede generar más; establécela en `1` para desactivar el anidamiento. De la v2.1.217 a la v2.1.218, el valor predeterminado era 1, por lo que un subagente no podía generar los suyos a menos que aumentaras el límite; la v2.1.219 aumentó el valor predeterminado a 3. Acepta un número entero positivo con dígitos simples; cualquier otro valor se ignora, por lo que el límite se puede ajustar pero no eliminar. Requiere Claude Code v2.1.217 o posterior
`CLAUDE_CODE_MAX_TURNS`	Limita el número de turnos agénticos cuando no se pasa un límite explícito. Equivale a pasar `--max-turns`, que tiene precedencia cuando ambos están establecidos. Un valor que no sea 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 de llamadas a WebSearch (valor predeterminado: 200). Cuando Claude alcanza el límite, las siguientes llamadas a WebSearch devuelven un aviso que le indica que continúe con la información que ya recopiló y que lo mencione en su respuesta. Acepta un número entero positivo sin límite superior. Cualquier otra cosa se ignora y se aplica el valor predeterminado, por lo que el límite se puede aumentar pero no desactivar. Requiere Claude Code v2.1.212 o posterior
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Establécela en `1` para iniciar los servidores MCP stdio solo con un entorno base seguro más el `env` configurado del servidor, en lugar de heredar el entorno de tu shell
`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`	Tiempo transcurrido en milisegundos antes de que una llamada a herramienta MCP que sigue en ejecución pase a una tarea en segundo plano (predeterminado: 120000, o 2 minutos). Establécela en `0` para desactivar el paso automático a segundo plano y, en una sesión interactiva, para que Claude espere a las tareas MCP. Requiere Claude Code v2.1.212 o posterior
`CLAUDE_CODE_MCP_STARTUP_WAIT_MS`	Cuánto tiempo en milisegundos espera el primer turno de una sesión no interactiva a los servidores MCP que aún se están conectando, en lugar de la espera del primer turno predeterminada. En un entorno autoalojado, solo cambia cuánto dura la espera. Algunos servidores mantienen una espera propia independientemente del valor; Tiempos de conexión los enumera. Establécela en `0` para omitir la espera para todos los demás servidores. Requiere Claude Code v2.1.274 o posterior
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Tiempo de espera por inactividad en milisegundos para las llamadas a herramientas MCP. Cuando un servidor MCP stdio, HTTP, SSE, WebSocket o de conector de claude.ai no envía ninguna respuesta ni ninguna notificación de progreso durante este tiempo, la llamada a herramienta se aborta con un error en lugar de esperar el `MCP_TOOL_TIMEOUT` general. Sobrescribe los valores predeterminados por transporte de 300000 (5 minutos) para servidores de red y 1800000 (30 minutos) para servidores stdio. Establécela en `0` para deshabilitar la comprobación de inactividad. Los valores inferiores a 1000 se elevan a un segundo, y el valor se limita al `MCP_TOOL_TIMEOUT` efectivo. Un `timeout` por servidor en `.mcp.json` de al menos 1000 eleva la ventana de inactividad de ese servidor a al menos el valor de `timeout`. No se aplica a servidores del IDE ni a servidores en proceso del SDK. Requiere Claude Code v2.1.187 o posterior. Antes de la v2.1.203, los servidores stdio estaban exentos del tiempo de espera por inactividad
`CLAUDE_CODE_MESSAGING_SOCKET`	La establece Claude Code, no tú: en las sesiones que vinculan un socket de bandeja de entrada, Claude Code exporta la ruta de ese socket a los hooks y a los comandos de Bash cuando vincula el socket. En una sesión que se inicia con la mensajería activada, Claude Code vincula el socket antes de que se ejecute cualquier hook. Otras sesiones de la máquina entregan mensajes a esta ruta. Cada sesión exporta su propio socket en lugar de uno heredado de un proceso padre, y los mensajes que llegan a él pasan por los controles de entrada de la sesión. Los bloques `env` de la configuración no pueden establecerla. Requiere Claude Code v2.1.224 o posterior
`CLAUDE_CODE_MESSAGING_TOKEN`	La establece Claude Code, no tú: en las sesiones que vinculan un socket de bandeja de entrada, Claude Code exporta este token por sesión a los hooks y a los comandos de Bash junto con `CLAUDE_CODE_MESSAGING_SOCKET`. Un script que publica en el socket puede enviar `{"type":"auth","token":"<token>"}` como su primera línea para demostrar que pertenece a la sesión. En Windows nativo, Claude Code exige esta línea y cierra cualquier conexión que no comience con una válida. Las reglas de procesos hijos propios indican cuándo consulta Claude Code el token. Cada sesión exporta su propio token, nunca uno heredado de una sesión padre. Los bloques `env` de la configuración no pueden establecerla. Requiere Claude Code v2.1.228 o posterior
`CLAUDE_CODE_NATIVE_CURSOR`	Establécela en `1` para mostrar el cursor propio de la terminal en el punto de inserción de la entrada en lugar de un bloque dibujado. El cursor respeta la configuración de parpadeo, forma y foco de la terminal. Establecerla en `0` equivale a dejar la variable sin establecer, por lo que no recupera el bloque dibujado en una sesión donde el cursor propio de la terminal ya está activado
`CLAUDE_CODE_NEW_INIT`	Establécela en `1` para 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`	Establécela en `1` para escribir la salida de la terminal a través de un segundo descriptor de archivo no bloqueante, de modo que una terminal que deja de leer, como un panel de tmux en modo de control en pausa o una conexión SSH detenida, no pueda congelar Claude Code a mitad de la sesión. Se aplica en macOS, Linux y WSL cuando stdout es una terminal. Requiere Claude Code v2.1.261 o posterior
`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`	Limita cuántas veces Claude Code vuelve a enviar una solicitud sin streaming cuyo tiempo de espera se agota. Con `0`, la solicitud falla al primer agotamiento del tiempo de espera. Consulta Ajustar el comportamiento de reintento para el tiempo de espera. Requiere Claude Code v2.1.285 o posterior
`CLAUDE_CODE_NO_FLICKER`	Establécela en `1` para habilitar la representación en pantalla completa, una vista previa de investigación que reduce el parpadeo y mantiene estable el uso de memoria en conversaciones largas. Sobrescribe el ajuste `tui`; también puedes cambiar con `/tui fullscreen`
`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`	Token de actualización de OAuth para la 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 la autenticación en entornos automatizados. Se ignora en la configuración de proyecto y local
`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"`. Obligatoria cuando se establece `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`. Se ignora en la configuración de proyecto y local
`CLAUDE_CODE_OAUTH_TOKEN`	Token de acceso de OAuth para la autenticación de claude.ai. Alternativa a `/login` para entornos de SDK y automatizados. Se ignora en la configuración de proyecto y local. Tiene precedencia sobre las credenciales almacenadas en el llavero. Genera uno con `claude setup-token`. A menos que ejecutes `/login`, Claude Code usa el token que estableciste durante toda la sesión. Para reemplazar un token caducado, genera uno nuevo y reinicia
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Eliminada en la v2.1.160 y ahora no tiene efecto. Antes fijaba el modo rápido en Claude Opus 4.6 en lugar del valor predeterminado actual. Opus 4.6 ya no admite el modo rápido
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Longitud máxima de los atributos de OpenTelemetry que contienen contenido (respuestas del modelo, contenido de herramientas, prompts del sistema, cuerpos sin procesar de la API), incluido el marcador de truncamiento, en unidades de código UTF-16 (predeterminado: 61440, es decir, 60 KB). Auméntala solo si tu backend de telemetría acepta valores de atributos de más de 64 KB, o redúcela para disminuir el volumen de telemetría. Requiere Claude Code v2.1.214 o posterior. Consulta Monitoreo
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Establécela en `1` para escribir en stderr los errores de diagnóstico del exportador de OpenTelemetry. De forma predeterminada, estos errores solo aparecen con `--debug`, por lo que un exportador mal configurado, como una colisión de puertos de Prometheus, falla silenciosamente en otro caso. Requiere Claude Code v2.1.179 o posterior. Consulta Monitoreo
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Tiempo de espera en milisegundos para vaciar los spans de OpenTelemetry pendientes (predeterminado: 5000). Consulta Monitoreo
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalo para actualizar los encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulta Encabezados dinámicos
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagarse (predeterminado: 2000). Auméntalo si se pierden métricas al salir. Consulta Monitoreo
`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`	Retraso inicial en milisegundos del backoff entre reintentos de una solicitud que la API rechaza con un error `529` de sobrecarga (predeterminado: 500). Auméntalo para repartir los reintentos en un intervalo más largo cuando la API está al límite de su capacidad. Indica milisegundos enteros de 500 a 32000 en dígitos simples; Claude Code trata cualquier otro valor como no establecido. Consulta cuándo no tiene efecto. Requiere Claude Code v2.1.292 o posterior
`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`	Tope en milisegundos del backoff entre reintentos de una solicitud que la API rechaza con un error `529` de sobrecarga (predeterminado: 32000). Auméntalo para que los reintentos posteriores sigan espaciándose. Indica milisegundos enteros de 32000 a 300000 en dígitos simples; Claude Code trata cualquier otro valor como no establecido. Los valores superiores a 64000 requieren v2.1.323 o posterior. Consulta cuándo no tiene efecto. Requiere Claude Code v2.1.296 o posterior
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Establécela en `1` para permitir que Claude Code ejecute en segundo plano el comando de actualización de tu gestor de paquetes cuando haya una nueva versión disponible. Se aplica a las instalaciones con Homebrew y WinGet. Los demás gestores de paquetes siguen mostrando el comando de actualización sin ejecutarlo. Consulta Actualizaciones automáticas
`CLAUDE_CODE_PERFORCE_MODE`	Establécela en `1` para habilitar la protección contra escritura compatible con Perforce. Cuando se establece, Edit, Write y NotebookEdit fallan con una indicación de `p4 edit <file>` si el archivo de destino no tiene el bit de escritura del propietario, que Perforce borra en los archivos sincronizados hasta que `p4 edit` los abre. Esto impide que Claude Code eluda el seguimiento de cambios de Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Sobrescribe el directorio raíz de los plugins. A pesar del nombre, establece el directorio padre, no la caché en sí: los marketplaces y la caché de plugins se encuentran en subdirectorios de esta ruta. El valor predeterminado es `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_DIRS`	Directorios de plugins que se cargan para la sesión, cada uno cargado de la misma forma que lo carga un flag `--plugin-dir`. Separa varias rutas con `:` en Unix o `;` en Windows. Indica cada ruta como ruta absoluta o comienza con `~`, porque Claude Code omite las rutas relativas. Requiere Claude Code v2.1.280 o posterior. Consulta Cargar un plugin para una sesión
`CLAUDE_CODE_PLUGIN_DIR_WATCH`	Controla si un mod se recarga cuando cambian sus archivos. De forma predeterminada, los mods en directorios de skills se recargan en cualquier sesión que abarque más de un prompt, incluidas las no interactivas. Los mods en directorios de `--plugin-dir` se recargan solo en sesiones interactivas de terminal. Establécela en `1` para recargarlos como lo hacen los mods de directorios de skills, o en `0` para desactivar la recarga en todas partes. Requiere Claude Code v2.1.287 o posterior
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Tiempo de espera en milisegundos para clonar o actualizar un marketplace de plugins (predeterminado: 120000). Aumenta este valor para repositorios grandes o conexiones de red lentas. Consulta Git clone timed out
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Establécela en `1` para omitir el intento de volver a clonar y seguir usando la copia existente del marketplace cuando una actualización del marketplace no puede alcanzar el remoto o autenticarse en él. Útil en entornos sin conexión o aislados donde volver a clonar fallaría de la misma manera. Consulta Las actualizaciones del marketplace fallan en entornos sin conexión
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Establécela en `1` para clonar las fuentes abreviadas `owner/repo` de GitHub mediante 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 runners 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 semilla de plugins de solo lectura, separados por `:` en Unix o `;` en Windows. Úsala para incluir un directorio de plugins previamente poblado en una imagen de contenedor. Claude Code registra los marketplaces de estos directorios al inicio y usa los plugins almacenados previamente en caché sin volver a clonarlos. Consulta Prepoblar plugins para contenedores
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Establécela en `1` para que Claude Code deje de pasar `-ExecutionPolicy Bypass` al iniciar PowerShell para llamadas a herramientas, hooks y comandos de la línea de estado, y respete en su lugar la directiva de ejecución efectiva de la máquina. De forma predeterminada, Claude Code omite la directiva de ejecución en el alcance del proceso para que los scripts `.ps1` y las importaciones de módulos funcionen en instalaciones de Windows con la directiva Restricted predeterminada. La omisión en el alcance del proceso nunca sobrescribe las directivas de grupo `MachinePolicy` ni `UserPolicy`, independientemente de este ajuste
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Límite máximo en milisegundos de la espera inactiva por el trabajo en segundo plano, como subagentes y flujos de trabajo, después del turno final en modo no interactivo con el flag `-p`. La espera inactiva se reinicia cada vez que Claude toma un turno para manejar un resultado en segundo plano. Predeterminado: `600000`, o 10 minutos. Cuando la espera inactiva alcanza el límite, Claude Code deja de esperar las tareas en segundo plano restantes. Un comando en segundo plano en ejecución que inició la conversación principal mantiene la ejecución abierta más allá de ese límite. Establécela en `0` para esperar indefinidamente. Requiere Claude Code v2.1.182 o posterior
`CLAUDE_CODE_PROCESS_WRAPPER`	Inicia los procesos que Claude Code lanza desde su propio binario, como el servicio en segundo plano que aloja las sesiones de agent view, a través de un lanzador corporativo indicado como prefijo de argv, como `/opt/corp/launcher`. Establécela en el bloque `env` de la configuración de usuario o de la configuración administrada, no como una exportación del shell, para que el servicio en segundo plano desacoplado la herede; la configuración de proyecto y local no puede establecerla. Equivale al ajuste `processWrapper`, que requiere Claude Code v2.1.210 o posterior; esta variable tiene precedencia cuando ambos están establecidos. La extensión de VS Code configura su propio lanzador por separado mediante su ajuste `claudeProcessWrapper`. Se ignora en Windows. Consulta Ejecutar Claude Code detrás de un lanzador corporativo para conocer el formato del valor, lo que abarca el lanzador y el contrato que debe cumplir. Requiere Claude Code v2.1.208 o posterior
`CLAUDE_CODE_PROJECT_DIR_NAME`	Establécela junto con `CLAUDE_CONFIG_DIR` para elegir el nombre del directorio dentro de `projects/` en el que Claude Code almacena las transcripciones y la memoria automática de esa sesión, en lugar de uno derivado de la ruta del directorio de trabajo. Por ejemplo, iniciar Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` las almacena en `/srv/tenant-a/projects/work/`. Claude Code ignora esta variable cuando `CLAUDE_CONFIG_DIR` no está establecida, y solo la lee del entorno desde el que inicias `claude`, nunca del bloque `env` de un archivo de configuración. Consulta Asignar tú mismo el nombre del directorio del proyecto. Requiere Claude Code v2.1.234 o posterior
`CLAUDE_CODE_PROMPT_CACHE_TTL`	Establece `5m` o `1h`, los únicos valores que acepta Claude Code, para elegir el TTL de la caché de prompts de la conversación principal: tus turnos interactivos, de `-p` y del SDK, además de los auxiliares que se ejecutan en línea con ellos. Tiene precedencia sobre el ajuste `promptCacheTtl` y sobre `ENABLE_PROMPT_CACHING_1H`, y `FORCE_PROMPT_CACHING_5M` la sobrescribe. La API factura las escrituras de caché de 1 hora a una tarifa más alta. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Establécela en `1` para propagar el contexto de traza W3C cuando `ANTHROPIC_BASE_URL` apunta a un proxy personalizado. La propagación abarca el encabezado `traceparent` en las solicitudes al modelo y a MCP por HTTP, y la variable de entorno `TRACEPARENT` para los subprocesos de Bash, PowerShell y hooks. De forma predeterminada, la propagación solo está habilitada cuando hay una conexión directa a la API de Anthropic. Se agregó en la v2.1.152. Consulta Trazas (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	La establecen las plataformas anfitrionas que integran Claude Code y administran el enrutamiento del proveedor de modelos en su nombre. Cuando se establece, Claude Code ignora las variables de selección de proveedor, de endpoint y de autenticación, como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` y `ANTHROPIC_API_KEY`, en los archivos de configuración, por lo que la configuración de usuario no puede sobrescribir el enrutamiento del anfitrión. Claude Code también ignora las claves de selección de modelo, como `model`, `fallbackModel` y `modelOverrides`, en la configuración administrada, sea cual sea la fuente administrada que las entregue, de modo que la configuración de modelos del anfitrión tiene precedencia sobre una fijación de modelo administrada desactualizada. Claude Code también ignora las variables de selección de modelo, como `ANTHROPIC_MODEL` y la familia `ANTHROPIC_DEFAULT_*_MODEL`, en un bloque `env` administrado; una lista de modelos permitidos `availableModels` en la configuración administrada sigue aplicándose a menos que el anfitrión proporcione la suya. Claude Code también omite la exclusión automática de telemetría que aplica en otros casos en proveedores externos como Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform y Microsoft Foundry, por lo que la telemetría sigue la exclusión estándar de `DISABLE_TELEMETRY`. Consulta Comportamientos predeterminados por proveedor de API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Establécela en `1` para permitir que el proxy realice la resolución DNS en lugar del llamador. Opción para entornos en los que el proxy debe encargarse de la resolución de nombres de host. Cuando `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` está establecida, establece esta variable en el entorno del proceso que inicia Claude Code
`CLAUDE_CODE_REMOTE`	Se establece automáticamente en `true` cuando Claude Code se ejecuta como una sesión en la nube. Léela desde un hook o un script de configuración para detectar si estás en una sesión en la nube
`CLAUDE_CODE_REMOTE_SESSION_ID`	Se establece automáticamente en las sesiones en la nube con el ID de la sesión actual. Léela para construir un enlace de vuelta a la transcripción de la sesión. Consulta Enlazar la salida de vuelta a la sesión
`CLAUDE_CODE_RESTRICTED`	Establécela en `1` para iniciar la sesión en modo restringido, lo mismo que pasar `--restricted`. Claude Code ignora esta variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.248 o posterior
`CLAUDE_CODE_RESUME_HINT_COMMAND`	En un script contenedor que inicia Claude Code, establécela en el nombre que escribes para ejecutar el contenedor, como `mytool`. Así, una sesión local imprime `mytool --resume <session-id>` al salir en lugar de `claude --resume <session-id>`. Claude Code ignora un nombre que no coincide con `^\w[\w-]*$`. También ignora la variable en el bloque `env` de un archivo de configuración. Requiere Claude Code v2.1.323 o posterior
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Establécela en `1` para reanudar automáticamente si la sesión anterior terminó a mitad de un turno. Se usa en el modo SDK para que el modelo continúe sin que el SDK tenga que volver a enviar el prompt. Para desactivarla, elimina la variable o establécela en `0`. Para el panel de chat de VS Code, consulta Continuar conversaciones después de recargar
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS`	Antigüedad máxima en milisegundos del último mensaje de la transcripción para que una sesión que terminó a mitad de un turno continúe automáticamente al reanudarse. 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 se inicia inactiva para que continúes de forma explícita. Sin establecer o con `0` no hay límite, salvo que algunos turnos solo se reanudan dentro de las seis horas posteriores a su último mensaje, como uno que terminó con un error de la API. Un valor positivo limita todos los turnos, incluidos esos; un valor negativo o no numérico aplica un límite de una hora. Los scripts que inician agentes de larga duración pueden establecerla para que un reinicio sobre una transcripción antigua no vuelva a ejecutar un prompt obsoleto. Claude Code establece por sí mismo un límite de una hora cuando reinicia una sesión de la vista de agentes que falló y que heredó su conversación de una sesión interactiva. Requiere Claude Code v2.1.211 o posterior
`CLAUDE_CODE_RESUME_PROMPT`	Sobrescribe 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 volver a enviar su prompt, o cuando reanudas una llamada a herramienta diferida con `-p`. El valor predeterminado es `Continue from where you left off.`. Una cadena vacía usa el valor predeterminado
`CLAUDE_CODE_RESUME_SHOWS_CUT_OFF_CALLS`	Establécela en `1` para conservar las llamadas a herramientas interrumpidas, marcadas como cortadas, en un turno que continúa `CLAUDE_CODE_RESUME_INTERRUPTED_TURN`. Cuando no está establecida, esas llamadas se descartan antes de que el turno continúe. Algunas llamadas siguen descartándose, como las llamadas a subagentes, skills, flujos de trabajo y herramientas que esperan a una persona. Para el panel de chat de VS Code, consulta Continuar conversaciones después de una recarga. Requiere Claude Code v2.1.309 o posterior
`CLAUDE_CODE_RETRY_WATCHDOG`	Establécela en `1` para sesiones desatendidas, como harnesses de evaluación, trabajos de CI o workers remotos. Reintenta indefinidamente los errores de capacidad `429` y `529` en lugar de fallar después de `CLAUDE_CODE_MAX_RETRIES` intentos. Claude Code falla de inmediato cuando una solicitud de velocidad estándar recibe un `429` que informa de un límite de gasto o de créditos de uso agotados, incluso uno de un límite de gasto del gateway que se restablece según un calendario. Antes de la v2.1.239, el watchdog reintentaba estos errores indefinidamente. Para las solicitudes en modo rápido, consulta Manejar los rate limits. El watchdog espera hasta 5 minutos entre intentos, o hasta que se restablezca el límite cuando la respuesta incluye una hora de restablecimiento del rate limit, de modo que una sesión que alcanza un límite de uso espera a que transcurra la ventana restante. En la v2.1.199 o posterior, también aumenta a 300 el número predeterminado de reintentos para otros errores transitorios, como errores del servidor, tiempos de espera agotados y conexiones interrumpidas, lo que equivale aproximadamente a tres horas de backoff, y elimina el límite de 15 en `CLAUDE_CODE_MAX_RETRIES` si estableces esa variable de forma explícita. Requiere Claude Code v2.1.186 o posterior
`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`	Tiempo máximo en milisegundos que cada solicitud a la API dedica a esperar a que pasen los errores `429` y `529` cuando `CLAUDE_CODE_RETRY_WATCHDOG` está establecida. Una vez agotado ese tiempo, el siguiente error de ese tipo termina la solicitud. Indica un número entero positivo con dígitos simples, como `1800000` para 30 minutos. Cuando no está establecida, la espera no tiene límite. Requiere Claude Code v2.1.295 o posterior
`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`	Intervalo mínimo en milisegundos entre comprobaciones de si un límite de uso ya se levantó, mientras una solicitud espera a que ese límite se restablezca con `CLAUDE_CODE_RETRY_WATCHDOG` establecida. Cuando una comprobación detecta que el límite se levantó, la solicitud se envía de inmediato. Indica un número entero en dígitos simples desde `60000`, un minuto, hasta `10800000`, tres horas. Las comprobaciones solo se realizan para el límite de sesión o semanal de una suscripción de claude.ai mientras no se están usando créditos de uso, y no mientras `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está establecida. Cuando esta variable no está establecida o su valor está fuera de ese rango, no se realizan comprobaciones. Requiere Claude Code v2.1.305 o posterior
`CLAUDE_CODE_SAFE_MODE`	Establécela en `1` para iniciar en modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos y agentes personalizados, estilos de salida, flujos de trabajo, temas personalizados, atajos de teclado personalizados, comandos de la línea de estado y de sugerencia de archivos, servidores LSP y la memoria automática no se cargan, para solucionar problemas de una configuración rota. La política de configuración administrada sigue aplicándose, incluidos los hooks, la línea de estado y los comandos de sugerencia de archivos configurados por política; los plugins administrados, los skills administrados, el CLAUDE.md administrado y los servidores MCP configurados por política no se aplican. Equivale a pasar `--safe-mode`. Los procesos hijos iniciados 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` está establecida. Las claves son subcadenas que se comparan con el texto del comando; los valores son límites enteros de llamadas. Por ejemplo, `{"deploy.sh": 2}` permite llamar a `deploy.sh` como máximo dos veces. La coincidencia se basa en subcadenas, por lo que trucos de expansión del shell como `./scripts/deploy.sh $(evil)` siguen contando para el límite. La ramificación en tiempo de ejecución mediante `xargs` o `find -exec` no se detecta; se trata de un control de defensa en profundidad
`CLAUDE_CODE_SCROLL_SPEED`	Establece el multiplicador de desplazamiento de la rueda del ratón en la representación en pantalla completa. Acepta cualquier valor positivo hasta 20, incluidos valores fraccionarios inferiores a 1, como `0.5`, para ralentizar el desplazamiento acelerado del trackpad y la rueda en terminales que ya amplifican los eventos de la rueda. Establécela en `3` para igualar a `vim` si tu terminal envía un evento de rueda por muesca sin amplificación. Se ignora en la terminal del IDE de JetBrains, donde Claude Code usa su propio manejo del desplazamiento
`CLAUDE_CODE_SEND_FEEDBACK`	Establécela en `0` para desactivar los comentarios redactados por Claude en una sesión. Establécela en `1` para activarlos cuando tu cuenta ya tenga acceso; la variable no puede otorgar acceso por sí misma, y los demás interruptores que desactivan los comentarios, como `DISABLE_FEEDBACK_COMMAND` y el valor `off` del ajuste `feedbackDrafts`, siguen aplicándose
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Sobrescribe el presupuesto de tiempo en milisegundos para los hooks SessionEnd. El valor también es el tiempo de espera para cada hook que no establece su propio `timeout`. Se aplica al salir de la sesión, a `/clear` y al cambiar de sesión mediante `/resume` interactivo. De forma predeterminada, el presupuesto es de 1.5 segundos, y se eleva automáticamente al `timeout` por hook más alto configurado en los archivos de configuración, hasta 60 segundos. Los tiempos de espera de los hooks proporcionados por plugins no elevan el presupuesto
`CLAUDE_CODE_SESSION_ID`	Se establece automáticamente con el ID de la sesión actual en los subprocesos de las herramientas Bash y PowerShell, en los subprocesos de comandos de hooks y en los subprocesos de servidores MCP stdio. Para Bash, PowerShell y los hooks, coincide con el campo `session_id` de la entrada JSON de los hooks y se actualiza con `/clear`. Un subproceso de servidor MCP conserva el ID con el que se inició. Con `--resume <session-id>` recibe el ID reanudado, igual que los hooks y Bash. Con `--continue` o `--resume` sin un ID explícito, puede recibir en su lugar el ID inicial de arranque. Úsala para correlacionar scripts y herramientas externas con la sesión de Claude Code que los inició
`CLAUDE_CODE_SHELL`	Establece el shell que Claude Code usa para ejecutar los comandos de la herramienta Bash. Acepta una ruta a un binario de `bash` o `zsh`, por ejemplo `/opt/homebrew/bin/bash`. Otros shells, como `fish`, no son compatibles. Si el valor no es una ruta funcional de `bash` o `zsh`, Claude Code lo ignora y recurre a la detección automática. La detección automática usa tu `$SHELL` cuando apunta a `bash` o `zsh`; de lo contrario, elige el primer `zsh` y luego `bash` funcional que encuentre en tu `PATH` y en las ubicaciones de instalación estándar
`CLAUDE_CODE_SHELL_PREFIX`	Prefijo de comando que envuelve los comandos de shell que inicia Claude Code: llamadas a la herramienta Bash, comandos de hooks, comandos de la línea de estado y comandos de inicio de servidores MCP stdio. Los hooks de PowerShell y los hooks en 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 wrapper recibe la línea de comandos como un único argumento entrecomillado para el shell en `$1`, por lo que el wrapper debe volver a evaluar `$1` con un shell, por ejemplo `exec bash -c "$1"`. Tratar `$1` como una ruta de ejecutable simple rompe los servidores MCP stdio que pasan argumentos como `npx -y <package>`. Para las llamadas a la herramienta Bash, `$1` contiene la invocación completa del shell que ensambla Claude Code, incluida la configuración del entorno, no solo el comando que ejecutó Claude
`CLAUDE_CODE_SIMPLE`	Establécela en `1` para ejecutar con un prompt del sistema mínimo y solo las herramientas Bash, de lectura de archivos y de edición de archivos. Las herramientas MCP de `--mcp-config` siguen disponibles. Deshabilita el descubrimiento automático de hooks, skills, comandos personalizados, subagentes, plugins instalados, servidores MCP, la memoria automática y CLAUDE.md. Los skills de un directorio que pases con `--add-dir` se siguen cargando. Los tokens de OAuth y las credenciales del llavero no se leen, por lo que la autenticación de Anthropic debe provenir de `ANTHROPIC_API_KEY` o de un `apiKeyHelper` en `--settings`. Equivale a pasar `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Elige entre el prompt del sistema completo de Claude Code y uno más corto con descripciones de herramientas abreviadas. Cuando no está establecida, Haiku 4.5, Sonnet 5, Opus 4.7 y los modelos anteriores de esas familias usan el prompt completo de forma predeterminada, y los modelos más recientes usan el más corto. Establécela en `1` para usar el prompt más corto en cualquier modelo. Establécela en `0`, `false`, `no` u `off` para usar el prompt completo en cualquier modelo, incluso cuando un experimento o la configuración del servidor seleccionaría de otro modo el más corto. Ambos prompts conservan el conjunto completo de herramientas, los hooks, los servidores MCP y el descubrimiento de CLAUDE.md
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Omite la autenticación del lado del cliente para Claude Platform on AWS, para gateways que firman las solicitudes por sí mismos
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	Establécela en `1` para desactivar la caché en proceso de las credenciales resueltas desde la cadena de proveedores de credenciales predeterminada de AWS, de modo que Claude Code resuelva la cadena en cada solicitud a la API. Con la caché desactivada, un perfil respaldado por SSO solicita credenciales a IAM Identity Center en cada solicitud. Consulta 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`	Omite la autenticación de AWS para Amazon Bedrock (por ejemplo, al usar un gateway de LLM)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	Establécela en `1` para tratar una comprobación fallida de disponibilidad del modo rápido como disponible, para redes que bloquean la solicitud directa de la comprobación a `api.anthropic.com`. Claude Code sigue respetando una respuesta de “deshabilitado por tu organización”
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	Establécela en `1` para omitir la comprobación del lado del cliente de la disponibilidad del modo rápido, para proxies que interceptan la solicitud de la comprobación en lugar de rechazarla. La API sigue rechazando las solicitudes en modo rápido cuando tu organización tiene el modo rápido deshabilitado
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Omite la autenticación de Azure para Microsoft Foundry, para un proxy o gateway que inyecta su propio encabezado `Authorization`. Claude Code envía las solicitudes sin una credencial de Azure y conserva el encabezado `Authorization` que proporcionas, por ejemplo mediante `ANTHROPIC_CUSTOM_HEADERS`. Se ignora cuando se establece `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. Antes de la v2.1.203, esta variable dejaba al cliente de Microsoft Foundry sin poder enviar solicitudes a menos que también se estableciera una clave de API
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Omite la autenticación de AWS para Amazon Bedrock Mantle (por ejemplo, al usar un gateway de LLM)
`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY`	Las comprobaciones de modelos al inicio en Amazon Bedrock y Google Cloud’s Agent Platform recuerdan en esta máquina qué modelos encontraron que tu cuenta no puede invocar, durante hasta un día. Establécela en `1` para desactivar ese recuerdo. Requiere Claude Code v2.1.285 o posterior
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	Establécela en `1` para omitir la escritura en disco del historial de prompts y de las transcripciones de sesión. Las sesiones iniciadas con esta variable establecida no aparecen en `--resume`, `--continue` ni en el historial de la flecha hacia arriba. Útil para sesiones efímeras con scripts
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Omite la autenticación de Google para Google Cloud’s Agent Platform (por ejemplo, al usar un gateway de LLM)
`CLAUDE_CODE_STARTUP_FAILURE_RESULTS`	Establécela en `1` para que una sesión iniciada con `--output-format stream-json` escriba un mensaje de resultado que indique por qué Claude Code se negó a iniciar para los fallos de inicio que de otro modo 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 impedir que termine el turno antes de que Claude Code lo sobrescriba y termine el turno de todos modos (predeterminado: 8). Establécela en `0` para deshabilitar el límite. Auméntala si tu hook necesita legítimamente más iteraciones para resolverse
`CLAUDE_CODE_SUBAGENT_MODEL`	El modelo predeterminado para los subagentes, los compañeros de un equipo de agentes y los agentes de flujos de trabajo a los que no se les asigna un modelo de otra manera. Acepta un alias como `haiku` o un nombre de modelo completo. Dos fuentes tienen precedencia sobre ella: un modelo que Claude pasa cuando genera el agente y un campo `model` en la definición del agente, incluido `inherit`. Para cambiar eso, establece `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`. Consulta Elegir un modelo para ver el orden completo. Establecerla en `inherit` es lo mismo que dejarla sin establecer. Antes de la v2.1.251, esta variable sobrescribía tanto el modelo por invocación como el campo `model` de la definición
`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`	Establécela en `1` para forzar un único modelo en los subagentes, los compañeros de equipo y los agentes de flujos de trabajo. Ejecutar todos los subagentes con un solo modelo indica cuál es ese modelo. Requiere Claude Code v2.1.257 o posterior
`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`	Establece `5m` o `1h`, los únicos valores que acepta Claude Code, para elegir el TTL de la caché de prompts de las solicitudes fuera de la conversación principal, como los subagentes, los flujos de trabajo y el trabajo en segundo plano. Tiene precedencia sobre el ajuste `subagentPromptCacheTtl` y sobre `ENABLE_PROMPT_CACHING_1H`, y `FORCE_PROMPT_CACHING_5M` la sobrescribe. La API factura las escrituras de caché de 1 hora a una tarifa más alta. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Establécela en `1` para eliminar las credenciales de los entornos de los subprocesos que inicia Claude Code, como los comandos de Bash, los hooks y los servidores MCP stdio. La limpieza reconoce una credencial por el nombre de su variable o por su valor, y deja en su lugar los tokens de GitHub y la configuración del proxy. Consulta Qué elimina la limpieza del entorno de los subprocesos. `claude-code-action` la establece automáticamente cuando se configura `allowed_non_write_users`
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Establécela en `1` en modo no interactivo (el flag `-p`) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y es posible que no estén disponibles en el primer turno. Combínala 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 síncrona de plugins. Cuando se supera, Claude Code continúa sin plugins y registra un error. Sin valor predeterminado: sin esta variable, la instalación síncrona espera hasta completarse
`CLAUDE_CODE_SYNC_SKILLS`	Establécela en `1` para que Claude Code descargue los skills habilitados para tu cuenta de claude.ai. En modo no interactivo con el flag `-p`, Claude Code también espera hasta `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` la lista de skills antes de ejecutar la primera consulta. Requiere autenticación con claude.ai. Las sesiones de terminal en las que inicias sesión con tu cuenta de claude.ai sincronizan estos skills sin esta variable. En una sesión interactiva, la variable requiere v2.1.323 o posterior
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Tiempo de espera en milisegundos para la resincronización de skills que se ejecuta a mitad de la sesión cuando una aplicación creada con el Agent SDK recarga los skills (predeterminado: 30000). Cuando se supera, la recarga continúa con los skills que hayan llegado, y las descargas restantes terminan en segundo plano
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Tiempo de espera en milisegundos durante el cual la primera consulta espera la lista inicial de skills cuando `CLAUDE_CODE_SYNC_SKILLS` está establecida (predeterminado: 5000). Cuando se supera, la primera consulta se ejecuta con los skills que hayan llegado. Las descargas terminan en segundo plano en cualquier caso, y Claude espera la descarga de un skill cuando invoca ese skill
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Establécela en `false` para deshabilitar el resaltado de sintaxis en la salida de diff. Útil cuando los colores interfieren con la configuración de tu terminal. Para deshabilitar también el resaltado en los bloques de código y en las vistas previas de archivos, usa el ajuste `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Comparte una lista de tareas entre sesiones. Establece el mismo ID en varias instancias de Claude Code para coordinarse en una lista de tareas compartida, en sesiones que tienen las herramientas Task. Consulta Lista de tareas
`CLAUDE_CODE_TMPDIR`	Sobrescribe el directorio temporal que se usa para los archivos temporales internos. Claude Code agrega `/claude-{uid}/` a esta ruta en Unix, o `/claude/` en Windows. Predeterminado: `/tmp` en macOS, `os.tmpdir()` en Linux y Windows. En macOS y Linux, los subprocesos de Bash en sandbox reciben un `$TMPDIR` de respaldo corto bajo el directorio predeterminado del sistema cuando tu sobrescritura es una ruta larga, ya que algunas herramientas fallan cuando las rutas temporales son demasiado largas. Los comandos de Bash sin sandbox heredan el `$TMPDIR` de tu shell cuando está establecido. En Windows nativo, cuando tu shell no establece `$TMPDIR`, un comando de Bash que hace referencia a `$TMPDIR` recibe tu sobrescritura, o `%TEMP%` cuando no has establecido una. Los archivos temporales propios de Claude Code siempre usan tu sobrescritura. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local
`CLAUDE_CODE_TMUX_TRUECOLOR`	Establécela en cualquier valor no vacío, como `1`, para permitir la salida de color verdadero de 24 bits dentro de tmux. Establecerla en `0` o `false` sigue permitiendo el color verdadero, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para restaurar la limitación a 256 colores. De forma predeterminada, Claude Code se limita a 256 colores cuando `$TMUX` está establecida, porque tmux no transmite las secuencias de escape de color verdadero a menos que esté configurado para ello. Establécela después de agregar `set -ga terminal-overrides ',*:Tc'` a tu `~/.tmux.conf`. Consulta Configuración de la terminal para ver otros ajustes de tmux
`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`	En Linux y WSL, establécela en una lista separada por comas de los tipos de procesos que Claude Code excluye del límite de memoria de las herramientas, como `mcp` o `lsp`. Establece `none` para limitar todos los tipos, o `all-new` para limitar solo los comandos de las herramientas Bash, PowerShell y Monitor. Claude Code mantiene los comandos de las herramientas Bash, PowerShell y Monitor bajo el límite sea lo que sea que indiques. Requiere Claude Code v2.1.246 o posterior
`CLAUDE_CODE_TOOL_MEMORY_LIMIT`	En Linux y WSL, establécela en un tamaño como `4G` para limitar la memoria que pueden usar los comandos de las herramientas Bash y PowerShell, y los comandos de la herramienta Monitor en la v2.1.246 o posterior. Escribe el tamaño con dígitos simples, solo para un número de bytes o con un sufijo `K`, `M`, `G` o `T`. Establece `0` u `off` para desactivar el límite. Una vez que el primer proceso que inicia Claude Code ha activado o desactivado el límite, un valor modificado surte efecto la próxima vez que inicies `claude`. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`	Establécela en `1` para limitar cuánto crece el archivo de transcripción de una sesión larga de `-p` o del Agent SDK. Después de cada compactación, una vez que el archivo supera los 5 MB, Claude Code elimina el historial anterior a esa compactación. En v2.1.296 o posterior, el archivo se mantiene igual cuando eliminar ese historial lo reduciría en menos del 10%. Reanudar la sesión restaura la misma conversación, se haya recortado o no el archivo. Establécela en el entorno desde el que inicias Claude Code, ya que un bloque `env` de la configuración no puede activarla. Requiere Claude Code v2.1.287 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 host de Remote Control o del SDK, o el diálogo de aprobación de un mensaje entre sesiones retenido; las solicitudes de permiso y las preguntas de `AskUserQuestion` usan sus propios flujos y no se rigen por él. En Claude Code v2.1.236 o posterior, también limita la solicitud de consentimiento de créditos de uso de Fable a mitad de sesión en una sesión que puede estar ejecutándose sin supervisión. Controlar mensajes entrantes y sesiones no interactivas cubren las reglas completas de expiración de los mensajes retenidos, incluidos los casos en que el plazo no se aplica. Sobrescribe el ajuste `dialogExpiry`. `0` o un valor negativo desactiva el plazo. Se ignora en la configuración de proyecto y local
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Usa Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Usa Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Usa Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Usa el endpoint Mantle de Amazon Bedrock
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controla la herramienta PowerShell. En Windows sin Git Bash, la herramienta se habilita automáticamente; establécelo en `0` para deshabilitarla. En Windows con Git Bash instalado, la herramienta está activada de forma predeterminada para las cuentas de claude.ai y de Console; establécelo en `1` para habilitarla en sesiones de Amazon Bedrock, Google Cloud’s Agent Platform y Microsoft Foundry, o en `0` para desactivarla. En Linux, macOS y WSL, establécelo en `1` para habilitarla, lo que requiere `pwsh` en tu `PATH`. Cuando está habilitada en Windows, Claude puede ejecutar comandos de PowerShell de forma nativa en lugar de pasar por Git Bash. Consulta herramienta PowerShell
`CLAUDE_CODE_USE_VERTEX`	Usa Google Cloud’s Agent Platform
`CLAUDE_CODE_WARN_DISK_FREE_GIB`	Defínela con un número entero de GiB, como `10`, para que Claude Code avise a Claude cuando el espacio libre en el sistema de archivos del directorio de trabajo caiga por debajo de esa cantidad. El aviso es un recordatorio del sistema que indica cuánto espacio queda libre. El recordatorio está desactivado cuando la variable no está definida, es `0` o no son dígitos simples. Defínela en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada a través de un bloque `env` de la configuración. Requiere Claude Code v2.1.304 o posterior
`CLAUDE_CODE_WARN_MEMORY_FREE_GIB`	En Linux y WSL, defínela con un número entero de GiB, como `4`, para que Claude Code avise a Claude cuando la memoria disponible caiga por debajo de esa cantidad. El aviso es un recordatorio del sistema que indica cuánta memoria hay disponible. El recordatorio está desactivado cuando la variable no está definida, es `0` o no son dígitos simples. Defínela en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada a través de un bloque `env` de la configuración. Requiere Claude Code v2.1.304 o posterior
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	Establécelo en el número de milisegundos durante los que WebFetch mantiene en caché la respuesta de cada URL obtenida. El valor predeterminado es `900000`, que equivale a 15 minutos. Solo acepta dígitos simples; `0`, un decimal o cualquier otra escritura mantiene el valor predeterminado. Claude Code lee el valor una vez por inicio, por lo que un cambio en un bloque `env` de la configuración se aplica la próxima vez que inicies `claude`. Requiere Claude Code v2.1.233 o posterior
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	Límite superior en milisegundos de cuánto tiempo espera WebFetch a que se descargue una página, incluidas las redirecciones que sigue. Una descarga que no se haya completado para entonces falla con un error de plazo. El valor predeterminado es `300000`, que equivale a cinco minutos. Establécelo en `0` para eliminar el límite. Solo acepta dígitos simples; un decimal o cualquier otra escritura mantiene el valor predeterminado. Requiere Claude Code v2.1.268 o posterior
`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`	Ritmo al que se recarga el límite de WebSearch de una sesión, en llamadas por hora. El valor predeterminado es `100` en una sesión de terminal interactiva. En una sesión no interactiva, el valor predeterminado es `0`, lo que desactiva la recarga. Solo acepta dígitos simples; cualquier otra escritura se interpreta como no establecida. Requiere Claude Code v2.1.290 o posterior
`CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE`	Cuando `CLAUDE_AUTO_BACKGROUND_TASKS` está establecida en `1`, cuánto tiempo espera Claude Code antes de cada recordatorio a Claude para que revise los subagentes en segundo plano que siguen ejecutándose. Acepta una o más esperas separadas por comas en segundos enteros de `1` a `86400`, como `600` o `600,1800,3600`. Cada valor es la espera antes del siguiente recordatorio, y el último valor se repite. Solo acepta dígitos simples; cualquier otro valor o escritura se interpreta como no establecida. Cuando no está establecida, no hay recordatorios. Requiere Claude Code v2.1.283 o posterior
`CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS`	Cuántos agentes ejecuta a la vez una sola ejecución de flujo de trabajo, de `1` a `256`. De forma predeterminada, una ejecución ejecuta hasta 16 agentes a la vez, menos cuando Claude Code tiene menos CPU disponibles; las llamadas `agent()` en cola esperan a que haya un espacio libre. La transcripción de cada agente en ejecución permanece en la memoria de Claude Code, por lo que los valores más altos aumentan el uso de memoria. Solo acepta dígitos simples; los valores fuera de rango y otras escrituras mantienen el valor predeterminado. Requiere Claude Code v2.1.269 o posterior
`CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS`	Límite superior en milisegundos de cuánto tiempo espera un agente de flujo de trabajo a que comience la primera respuesta de un agente hermano con el mismo prefijo antes de enviar su propia primera solicitud. Cuando una distribución en abanico (fan-out) inicia varios agentes que comparten un prefijo de caché de prompts, Claude Code retiene a todos los agentes excepto al primero hasta este tiempo para que el resto lea el prefijo en caché en lugar de que cada uno lo procese sin caché. Valor predeterminado: `5000`. Establécelo en `0` para desactivar la espera. Cuando `DISABLE_PROMPT_CACHING` está establecida, los agentes nunca esperan. Requiere Claude Code v2.1.229 o posterior
`CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG`	Establécela en `1` para mostrar, encima del prompt, una línea por cada una de las últimas tres comprobaciones que hizo el mod You should know en esta sesión. Úsala para confirmar que el mod está haciendo comprobaciones cuando no aparece ninguna nota. Requiere Claude Code v2.1.287 o posterior
`CLAUDE_CONFIG_DIR`	Sobrescribe el directorio de configuración (predeterminado: `~/.claude`). Toda la configuración, el historial de sesiones y los plugins se almacenan en esta ruta. Para las credenciales, consulta dónde almacena Claude Code las credenciales. Útil para ejecutar varias cuentas en paralelo: por ejemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Establécelo en tu shell, en la configuración de usuario o en la configuración administrada. En un archivo de configuración, escribe la ruta absoluta. Se ignora en la configuración de proyecto y local
`CLAUDE_EFFORT`	Se establece automáticamente en los subprocesos de la herramienta Bash y en los comandos de hooks con el ajuste de nivel de esfuerzo vigente cuando se inicia el subproceso: `low`, `medium`, `high`, `xhigh` o `max`. Coincide con el campo `effort.level` que se pasa a los hooks. Solo se establece cuando el modelo actual admite el parámetro effort
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Establécelo en `1` para forzar la habilitación del watchdog de inactividad de streaming a nivel de bytes, o en `0` para forzar su deshabilitación. `0` también desactiva el plazo del primer byte en las conexiones donde se ejecuta ese plazo. Cuando no está establecida, el watchdog está habilitado de forma predeterminada para las conexiones directas a la API de Anthropic y a Claude Platform on AWS, y para las respuestas en streaming en conexiones de gateway a las que se accede mediante `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; antes de v2.1.222 no se ejecutaba en esas conexiones de gateway, por lo que el watchdog a nivel de eventos podía informar de un bloqueo allí incluso mientras llegaban pings de keep-alive. Para los tiempos de espera y cómo interactúan los temporizadores, consulta Watchdogs de inactividad de streaming
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Establécelo en `1` para habilitar el watchdog de inactividad de streaming a nivel de bytes en las respuestas `vnd.amazon.eventstream` de Amazon Bedrock, lo que también habilita el plazo del primer byte en las solicitudes de streaming de Bedrock. Desactivado de forma predeterminada. Configura el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Establécelo en `0` para forzar la deshabilitación del watchdog de inactividad de streaming a nivel de eventos, o en `1` para forzar su habilitación. Cuando no está establecida, el watchdog está activado de forma predeterminada para todos los proveedores. Antes de v2.1.196, el valor predeterminado sin establecer lo controlaba el servidor en la API directa de Anthropic y estaba desactivado en los demás proveedores. Configura el tiempo de espera con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para los otros temporizadores de bloqueo que se ejecutan junto con este, consulta Watchdogs de inactividad de streaming
`CLAUDE_ENV_FILE`	Ruta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando de Bash en el mismo proceso de shell, de modo que las exportaciones del archivo sean visibles para el comando. Úsala para conservar la activación de virtualenv o conda entre comandos. Los comandos de PowerShell también reciben sus variables, en v2.1.296 o posterior, bajo las condiciones descritas en Variables persistentes en comandos de PowerShell. También la rellenan dinámicamente los hooks SessionStart, Setup, CwdChanged y FileChanged
`CLAUDE_JOB_DIR`	Claude Code la establece en cada sesión en segundo plano con el directorio `~/.claude/jobs/<id>` de esa sesión. Los comandos de shell que ejecuta la sesión la heredan. Escribe los archivos temporales en `$CLAUDE_JOB_DIR/tmp`. Las llamadas `Write` y `Edit` de Claude en ese directorio no piden permiso, y el directorio se elimina cuando se elimina la sesión
`CLAUDE_PID`	Claude Code la establece con su propio ID de proceso en los subprocesos que genera: los comandos de las herramientas Bash y PowerShell y los comandos de hooks. En Linux, la integración de shell de la herramienta Bash la usa para rechazar un patrón de `pkill` que coincidiría con el propio proceso de Claude Code; consulta la referencia de errores. Léela desde tus propios scripts para identificar deliberadamente el proceso padre de Claude Code o enviarle señales. Requiere Claude Code v2.1.214 o posterior
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefijo para los nombres de sesión de Remote Control generados automáticamente cuando no se proporciona un nombre explícito. De forma predeterminada es el nombre de host de tu máquina, lo que produce nombres como `myhost-graceful-unicorn`. El flag de CLI `--remote-control-session-name-prefix` establece el mismo valor para una sola invocación
`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`	Plazo en milisegundos para el primer byte de respuesta de una solicitud de streaming, en las conexiones donde se ejecuta el plazo del primer byte. Para saber cómo lo limita Claude Code, el tiempo adicional que añade para los cuerpos de solicitud grandes y cómo elige el plazo cuando no estableces esta variable, consulta No response from API. Requiere Claude Code v2.1.242 o posterior
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Tiempo de espera en milisegundos antes de que los watchdogs de inactividad de streaming a nivel de eventos y de bytes cierren una conexión bloqueada. Cuando estableces esta variable explícitamente, el mínimo es `300000` (5 minutos); los valores inferiores se ajustan silenciosamente para absorber las pausas del pensamiento extendido y el almacenamiento en búfer del proxy, y el watchdog a nivel de bytes limita el valor a 30 minutos. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` tiene precedencia sobre esta variable para el watchdog a nivel de bytes. Para los valores predeterminados sin establecer de cada watchdog, consulta Watchdogs de inactividad de streaming
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	Eliminada en v2.1.260 y ahora no tiene efecto. Anteriormente limitaba cuánto tiempo podía ejecutarse un comando de shell en segundo plano iniciado por un subagente, en milisegundos, con un valor predeterminado de 60 minutos. Consulta las reglas de duración de los comandos en segundo plano
`DEBUG`	Establécelo en `1` para habilitar el modo de depuración, equivalente a iniciar 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 los patrones de espacio de nombres como `DEBUG=express:*` establecidos para otras herramientas no lo activan
`DISABLE_AUTOUPDATER`	Establécelo en `1` para deshabilitar las actualizaciones automáticas en segundo plano. El comando manual `claude update` sigue funcionando. Usa `DISABLE_UPDATES` para bloquear ambos
`DISABLE_AUTO_COMPACT`	Establécela en `1` para deshabilitar la compactación automática al acercarse al límite de contexto, junto con la compactación por inactividad. El comando manual `/compact` sigue disponible. Úsala cuando quieras un control explícito sobre cuándo se produce la compactación. Sobrescribe el ajuste `autoCompactEnabled`
`DISABLE_COMPACT`	Establécelo en `1` para deshabilitar toda la compactación: tanto la compactación automática como el comando manual `/compact`
`DISABLE_COST_WARNINGS`	Establécelo en `1` para deshabilitar los mensajes de advertencia de costos
`DISABLE_DOCTOR_COMMAND`	Establécelo en `1` para ocultar el skill de revisión de la configuración inicial `/doctor` y su alias `/checkup`. Útil para despliegues administrados en los que los usuarios no deberían ejecutar diagnósticos de configuración desde una sesión. No afecta al comando de terminal `claude doctor`. Antes de v2.1.205, esta variable ocultaba el comando de pantalla de diagnóstico `/doctor`
`DISABLE_ERROR_REPORTING`	Establécelo en cualquier valor no vacío, como `1`, para excluirte de los informes de errores. Establecerlo en `0` o `false` también te excluye, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para volver a activar los informes de errores
`DISABLE_EXTRA_USAGE_COMMAND`	Establécelo en `1` para ocultar el comando `/usage-credits`, que permite a los usuarios comprar uso adicional más allá de los rate limits
`DISABLE_FEEDBACK_COMMAND`	Establécelo en `1` para deshabilitar el comando `/feedback` y los comentarios redactados por Claude. También deshabilita `/bug` y `/share`, que informan a través de la misma vía; antes de v2.1.212 eran alias de `/feedback`, por lo que el comando quedaba deshabilitado con cualquiera de sus nombres. También se acepta el nombre anterior `DISABLE_BUG_COMMAND`
`DISABLE_GROWTHBOOK`	Establécela en `1` para desactivar la obtención de feature flags. Requiere Claude Code v2.1.124 o posterior. Reemplazada por `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`, que requiere v2.1.319 o posterior: usa ese nombre, salvo que una máquina con v2.1.318 o anterior lea la configuración. Este nombre sigue funcionando
`DISABLE_INSTALLATION_CHECKS`	Establécelo en `1` para deshabilitar las advertencias de instalación. Úsalo solo cuando administres manualmente la ubicación de la instalación, ya que esto puede ocultar problemas de las instalaciones estándar
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Establécelo en `1` para ocultar el comando `/install-github-app`. Ya está oculto cuando se usan proveedores externos (Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry)
`DISABLE_INTERLEAVED_THINKING`	Establécelo en `1` para evitar que se envíe el encabezado beta de interleaved-thinking. Útil cuando tu gateway de LLM o tu proveedor no admite el pensamiento intercalado
`DISABLE_LOGIN_COMMAND`	Establécelo en `1` para ocultar el comando `/login`. Útil cuando la autenticación se gestiona externamente mediante claves de API o `apiKeyHelper`
`DISABLE_LOGOUT_COMMAND`	Establécelo en `1` para ocultar el comando `/logout`
`DISABLE_PROMPT_CACHING`	Establécelo en `1` para deshabilitar la caché de prompts para todos los modelos (tiene precedencia sobre los ajustes por modelo)
`DISABLE_PROMPT_CACHING_FABLE`	Establécelo en `1` para deshabilitar la caché de prompts para los modelos Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Establécelo en `1` para deshabilitar la caché de prompts para el modelo Haiku predeterminado, dondequiera que se ejecute
`DISABLE_PROMPT_CACHING_OPUS`	Establécelo en `1` para deshabilitar la caché de prompts para el modelo Opus predeterminado
`DISABLE_PROMPT_CACHING_SONNET`	Establécelo en `1` para deshabilitar la caché de prompts para el modelo Sonnet predeterminado
`DISABLE_TELEMETRY`	Establécelo en cualquier valor no vacío, como `1`, para excluirte de la telemetría. Establecerlo en `0` o `false` también te excluye, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para volver a activar la telemetría. Los eventos de telemetría no incluyen datos de usuario como código, rutas de archivos ni comandos de Bash. También deshabilita la obtención de feature flags. Consulta Desactivar la telemetría para tu organización
`DISABLE_UPDATES`	Establécelo en `1` para bloquear todas las actualizaciones, incluidos `claude update` y `claude install` manuales. Más estricto que `DISABLE_AUTOUPDATER`. Úsalo cuando distribuyas Claude Code a través de tus propios canales y los usuarios no deban actualizarlo por su cuenta
`DISABLE_UPGRADE_COMMAND`	Establécelo en `1` para ocultar el comando `/upgrade`
`DO_NOT_TRACK`	Establécelo en `1` para excluirte de la telemetría, con el mismo efecto que `DISABLE_TELEMETRY`, incluido sobre la obtención de feature flags. Claude Code lee esta variable como un booleano estándar, por lo que `0` mantiene la telemetría activada, y la respeta como la convención entre herramientas reconocida por muchas CLI para desarrolladores
`ENABLE_BETA_TRACING_DETAILED`	Establécelo en `1`, y establece `BETA_TRACING_ENDPOINT` en el endpoint de tu colector OTLP/HTTP, para activar el rastreo beta detallado, que añade atributos de span con contenido y el span `claude_code.hook`. Las sesiones interactivas de la CLI también requieren que tu organización esté en la lista de permitidos de la beta. Ambas variables se ignoran en la configuración de proyecto y local
`ENABLE_CLAUDEAI_MCP_SERVERS`	Establécelo en `false` para impedir que Claude Code obtenga los servidores MCP de claude.ai. Habilitado de forma predeterminada para los usuarios que han iniciado sesión. Para deshabilitarlo por proyecto o por organización, establece `disableClaudeAiConnectors` en la configuración en su lugar
`ENABLE_PROMPT_CACHING_1H`	Establécela en `1` para solicitar un TTL de caché de prompts de 1 hora en lugar de los 5 minutos predeterminados. Pensada para usuarios de clave de API, Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry y Claude Platform on AWS. Para los usuarios con suscripción dentro del uso incluido, Claude Code solicita automáticamente el TTL de 1 hora en la conversación principal. Los usuarios con suscripción que consumen créditos de uso pueden establecerla para mantener el TTL de 1 hora. Las escrituras en caché de 1 hora se facturan a una tarifa más alta. Para elegir el TTL por separado para la conversación principal y para las solicitudes fuera de ella, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` y `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que tienen precedencia sobre esta variable
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Obsoleta. Usa `ENABLE_PROMPT_CACHING_1H` en su lugar. No tiene efecto en las sesiones de Claude apps gateway, incluso cuando el gateway enruta a Amazon Bedrock
`ENABLE_TOOL_SEARCH`	Controla MCP Tool Search. Sin definir o `true` difiere las herramientas MCP, excepto en los casos que mantienen desactivada la búsqueda de herramientas. `auto` activa la búsqueda de herramientas una vez que las definiciones alcanzan el 10 % de la ventana de contexto. `auto:N` establece un umbral personalizado, como `auto:5` para el 5 %. `false` carga todas las herramientas por adelantado. Si un gateway rechaza la búsqueda de herramientas, consulta Búsqueda de herramientas a través de un gateway de LLM
`FORCE_AUTOUPDATE_PLUGINS`	Establécelo en `1` para forzar las actualizaciones automáticas de plugins incluso cuando el actualizador automático principal está deshabilitado mediante `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Establécela en `1` para habilitar hipervínculos OSC 8 en los que se puede hacer clic cuando tu terminal los admite pero no se detecta automáticamente. Cuando no está establecida, Claude Code habilita la mayoría de los hipervínculos solo cuando detecta que la terminal los admite. La insignia de PR o merge request del pie y las URL largas de inicio de sesión son enlaces en cualquier caso. Establece `0`, `false`, `no` u `off` para mostrarlos todos como texto sin formato. Antes de v2.1.314, `false`, `no` y `off` habilitaban en cambio los hipervínculos
`FORCE_PROMPT_CACHING_5M`	Establécelo en `1` para forzar el TTL de caché de prompts de 5 minutos incluso cuando de otro modo se aplicaría el TTL de 1 hora. Sobrescribe `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` y los ajustes `promptCacheTtl` y `subagentPromptCacheTtl`
`HTTP_PROXY`	Especifica el servidor proxy HTTP para las conexiones de red
`HTTPS_PROXY`	Especifica el servidor proxy HTTPS para las conexiones de red
`IS_DEMO`	Establécelo en cualquier valor no vacío, como `1`, para habilitar el modo demo: oculta tu correo electrónico y el nombre de tu organización del encabezado y de la salida de `/status`, y omite la incorporación. Establecerlo en `0` o `false` también habilita el modo demo, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para desactivarlo. Útil al transmitir o grabar una sesión
`MAX_MCP_OUTPUT_TOKENS`	Número máximo de tokens permitidos en las respuestas de las herramientas MCP (predeterminado: 25000). Claude Code muestra una advertencia cuando la salida supera los 10,000 tokens. Las herramientas que declaran `anthropic/maxResultSizeChars` usan ese límite de caracteres para el contenido de texto en su lugar, pero el contenido de imagen de esas herramientas sigue sujeto a esta variable. Un resultado de texto correcto de más de 50,000 caracteres de una herramienta sin esa anotación se guarda en un archivo independientemente de esta variable
`MAX_STRUCTURED_OUTPUT_RETRIES`	Número de intentos que Claude Code permite cuando la respuesta del modelo no supera la validación con el `--json-schema` en modo no interactivo con el flag `-p`; tras esa cantidad de intentos fallidos sin salida válida, la ejecución falla. El mismo límite se aplica cuando la salida estructurada de un subagente de flujo de trabajo no supera la validación. El valor predeterminado es 5: un primer intento más cuatro reintentos
`MAX_THINKING_TOKENS`	Presupuesto fijo de tokens para el pensamiento extendido. Claude Code lo limita a un token por debajo del máximo de tokens de salida de la solicitud y nunca por debajo de 1,024. Consulta `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para ver cómo se establece ese límite. Cuando no está establecida y el pensamiento está habilitado, los modelos con razonamiento adaptativo eligen su propia profundidad de pensamiento, y los demás modelos usan el límite. Establécelo en `0` para deshabilitar el pensamiento en la API de Anthropic, excepto en Opus 5.5, Sonnet 5.5, Haiku 5.5 y los modelos Fable, en los que no se puede desactivar el pensamiento. En proveedores externos, `0` omite el parámetro `thinking` en su lugar. Con el pensamiento desactivado en la API de Anthropic, Claude Code envía el esfuerzo `high` en lugar de un nivel superior a los modelos que sabe que no aceptan esa combinación, como Opus 5. Para un valor positivo, Claude Code ignora el número en sí en los modelos de razonamiento adaptativo, excepto cuando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desactiva el razonamiento adaptativo
`MCP_CLIENT_SECRET`	Secreto de cliente OAuth para los servidores MCP que requieren credenciales preconfiguradas. Evita la solicitud interactiva al agregar un servidor con `--client-secret`
`MCP_CONNECTION_NONBLOCKING`	Controla si el inicio espera a que los servidores MCP se conecten antes de la primera consulta. El inicio de MCP no es bloqueante de forma predeterminada: los servidores se conectan en segundo plano y sus herramientas quedan disponibles a medida que terminan. Establécelo en `0` para que Claude Code espere a que los servidores se conecten antes de la primera consulta. Los servidores configurados con `alwaysLoad: true` siguen haciendo esperar al inicio de todos modos, excepto cuando se sirven desde la caché de descubrimiento, ya que sus herramientas deben estar presentes cuando se construye el primer prompt. En modo no interactivo (`-p`) sin `--input-format stream-json`, Claude Code también espera a los servidores aún pendientes antes del primer turno, independientemente de esta variable. Cuando pasas `--mcp-config` explícitamente, la espera tiene un plazo más largo; consulta la entrada de ese flag para ver la excepción de los servidores en caché
`MCP_CONNECT_TIMEOUT_MS`	Cuánto tiempo espera el inicio bloqueante de MCP, en milisegundos, al lote de conexiones antes de tomar una instantánea de la lista de herramientas (predeterminado: 5000). Se aplica cuando `MCP_CONNECTION_NONBLOCKING=0` o para los servidores marcados con `alwaysLoad: true`. Los servidores que siguen pendientes al cumplirse el plazo continúan conectándose en segundo plano. Distinta de `MCP_TIMEOUT`, que limita el intento de conexión de un servidor individual
`MCP_DISCOVERY_CACHE`	Activa o desactiva la caché de descubrimiento de MCP. Con la caché activada, un servidor HTTP o SSE remoto que hayas usado antes puede mostrar el estado `cached`, y Claude Code lo conecta en su primera llamada a herramienta en lugar de al inicio. La caché está desactivada de forma predeterminada a menos que un despliegue gradual la haya habilitado para tu cuenta. Establécelo en `1` para activarla, o en `0` para mantenerla desactivada incluso cuando el despliegue la haya habilitado. Antes de v2.1.238, la caché estaba activada de forma predeterminada. El estado `cached` requiere Claude Code v2.1.221 o posterior
`MCP_DISCOVERY_CACHE_MAX_STALE_S`	Antigüedad máxima, en segundos, de una entrada de la caché de descubrimiento (predeterminado: 14400, o 4 horas). En un inicio en el que la entrada es más antigua que eso, Claude Code la descarta y conecta el servidor al inicio, como lo hace con la caché desactivada. Claude Code limita el valor a 7 días. Antes de v2.1.238, el valor predeterminado era 86400, o 24 horas, y Claude Code no limitaba el valor
`MCP_DISCOVERY_CACHE_STRIKES`	En un inicio en el que una entrada de la 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). Auméntala si tu conexión de red se cae ocasionalmente, para que una sola 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 la caché de descubrimiento sin actualizarla (predeterminado: 900). En un inicio en el que la entrada es más antigua que eso, Claude Code la sigue usando 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 de 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 redirección de OAuth, como alternativa a `--callback-port` al agregar un servidor MCP con credenciales preconfiguradas
`MCP_PROTOCOL_NEGOTIATION`	Solo en el runtime de cliente MCP v2, controla si Claude Code sondea a los servidores para la revisión 2026-07-28 del protocolo MCP. Establece `legacy` para mantener todos los servidores en el protocolo de enlace anterior, o `auto` para sondear los tipos de servidor que lo admiten. Sin definir, Claude Code los sondea, pero puede omitir algunos servidores. 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) que se conectan en paralelo durante el inicio (predeterminado: 20)
`MCP_SDK_GENERATION`	Fija con qué entorno de ejecución de cliente MCP se conecta este proceso a los servidores MCP: `v1`, basado en MCP TypeScript SDK 1.x, o `v2`, basado en MCP TypeScript SDK 2.0. Sin la variable, Claude Code usa v2, a partir de las versiones indicadas en esa sección. En Claude Code v2.1.221 o posterior, el entorno de ejecución v2 comprueba el emisor que devuelve un servidor OAuth de MCP en su respuesta de autorización y hace fallar el inicio de sesión con un error que comienza con `Issuer mismatch in authorization response` cuando no coincide. El entorno de ejecución v1 no realiza esta comprobación. Si estableces 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) que se conectan 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, unas 28 horas). Para un servidor HTTP, SSE o de conector de claude.ai, a cada solicitud también se le agota el tiempo de espera tras 60 segundos de forma predeterminada; establece esta variable, o el `timeout` por servidor, por encima de 60000 para aumentar ese límite por solicitud. Un valor más bajo sigue acortando 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` sobrescribe este valor para ese servidor. Un `timeout` por servidor de al menos 1000 también establece la ventana mínima de inactividad para las llamadas a herramientas de ese servidor, de modo que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca las aborte antes; este mínimo requiere Claude Code v2.1.203 o posterior. Para la variable de entorno, los valores inferiores a 1000 se elevan a un segundo; para el campo por servidor, los valores inferiores a 1000 se ignoran
`NO_PROXY`	Lista de dominios e IP a los que las solicitudes se enviarán directamente, sin pasar por el proxy
`OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT`	Límite estándar del SDK de OpenTelemetry sobre la longitud de los valores de los atributos. Claude Code limita los atributos de telemetría con contenido al menor entre este valor y `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, de modo que el marcador de truncamiento quede 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 menor valor establecido se aplica a todas las señales. Requiere Claude Code v2.1.214 o posterior. Consulta Monitoreo
`OTEL_LOG_ASSISTANT_RESPONSES`	Establécelo en `1` para incluir el texto de respuesta del modelo en los eventos de registro `assistant_response` de OpenTelemetry. Cuando no está establecida, Claude Code usa el valor de `OTEL_LOG_USER_PROMPTS` en su lugar. Establécelo en `0` para mantener las respuestas ocultas incluso cuando `OTEL_LOG_USER_PROMPTS` está establecida. Establécelo en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local. Requiere Claude Code v2.1.193 o posterior. Consulta Monitoreo
`OTEL_LOG_MANAGED_SETTINGS`	Establécelo en `1` para añadir la configuración administrada con los datos sensibles ocultos, y un resumen SHA-256 de la configuración antes de ocultarlos, a los eventos de registro `managed_settings_resolved` de OpenTelemetry. Deshabilitado de forma predeterminada. Establécelo en tu shell, en la configuración de usuario o en la configuración administrada; un valor en la configuración de proyecto o local no lo activa. Requiere Claude Code v2.1.274 o posterior. Consulta Monitoreo
`OTEL_LOG_RAW_API_BODIES`	Emite el JSON de solicitud y respuesta de la Messages API de Anthropic como eventos de registro `api_request_body` / `api_response_body`. Establécelo en `1` para obtener los cuerpos en línea truncados en el límite de contenido, o en `file:<dir>` para escribir los cuerpos sin truncar en el disco y emitir una ruta `body_ref` en su lugar. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura el límite de contenido, de 60 KB de forma predeterminada. Deshabilitado de forma predeterminada; los cuerpos incluyen todo el historial de la conversación. Establécelo en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local. Consulta Monitoreo
`OTEL_LOG_TOOL_CONTENT`	Establécelo en `1` para incluir el contenido de las herramientas en el evento de span `tool.output` de OpenTelemetry. Los atributos de span llevan el contenido de las herramientas bajo sus propias condiciones. Requiere rastreo. Deshabilitado de forma predeterminada para proteger los datos sensibles. Establécelo en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local, salvo los valores de desactivación que describe esa sección. Consulta Monitoreo
`OTEL_LOG_TOOL_DETAILS`	Establécelo en `1` para incluir los argumentos de entrada de las herramientas; los nombres de los servidores MCP; los nombres de los flujos de trabajo creados por el usuario; las cadenas de error sin procesar en los fallos de herramientas; la `category` del rechazo en los eventos `api_refusal`; los nombres reales de agentes, skills, plugins y servidores MCP en las métricas de costo y tokens; y otros detalles de las herramientas en las métricas, trazas y registros de OpenTelemetry. Deshabilitado de forma predeterminada para proteger la PII. Establécelo en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local, salvo los valores de desactivación que describe esa sección. Consulta Monitoreo
`OTEL_LOG_USER_PROMPTS`	Establécelo en `1` para incluir el texto de los prompts del usuario en las trazas y registros de OpenTelemetry. Deshabilitado de forma predeterminada (los prompts se ocultan). Establécelo en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local, salvo los valores de desactivación que describe esa sección. Consulta Monitoreo
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Establécela en `false` para excluir el UUID de la cuenta de los atributos de métricas y eventos (predeterminado: incluido). Consulta Monitoreo
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Establécela en `true` para incluir el punto de entrada de la sesión en los atributos de métricas y eventos (predeterminado: excluido). Se añadió en v2.1.152. Consulta Monitoreo
`OTEL_METRICS_INCLUDE_REPOSITORY`	Establécelo en `true` para etiquetar las métricas y los eventos de OpenTelemetry con atributos `vcs.*` que identifican el repositorio de la sesión (predeterminado: excluido). Requiere Claude Code v2.1.269 o posterior. Consulta Atributos del repositorio
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partir de v2.1.161, Claude Code adjunta las claves de `OTEL_RESOURCE_ATTRIBUTES` a las etiquetas de los puntos de datos de las métricas. Establécelo en `false` para excluirlas (predeterminado: incluidas). Consulta Monitoreo
`OTEL_METRICS_INCLUDE_SESSION_ID`	Establécela en `false` para excluir el ID de sesión de los atributos de métricas y eventos (predeterminado: incluido). Consulta Monitoreo
`OTEL_METRICS_INCLUDE_VERSION`	Establécela en `true` para incluir la versión de Claude Code en los atributos de métricas y eventos (predeterminado: excluida). Consulta Monitoreo
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Sobrescribe el presupuesto de caracteres para los metadatos de los skills que se muestran a la herramienta Skill. El presupuesto escala dinámicamente al 1% de la ventana de contexto, con un valor de respaldo de 8,000 caracteres. Nombre heredado que se conserva por compatibilidad con versiones anteriores
`TASK_MAX_OUTPUT_LENGTH`	Eliminada en v2.1.277 y ahora no tiene efecto, junto con la herramienta `TaskOutput` cuyo tamaño definía. Anteriormente establecía el número máximo de caracteres de la salida de una tarea en segundo plano que conservaba la herramienta `TaskOutput`. Ahora Claude lee el archivo de salida de una tarea en segundo plano con `Read`
`USE_BUILTIN_RIPGREP`	Establécelo en `0` para usar el `rg` instalado en el sistema en lugar del `rg` incluido con Claude Code
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Sobrescribe la región de Claude 3.5 Haiku cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Sobrescribe la región de Claude 3.5 Sonnet cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Sobrescribe la región de Claude 3.7 Sonnet cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Sobrescribe la región para Claude Opus 4 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Sobrescribe la región para Claude Sonnet 4 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Sobrescribe la región para Claude Opus 4.1 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Sobrescribe la región de Claude Opus 4.5 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Sobrescribe la región de Claude Sonnet 4.5 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Sobrescribe la región de Claude Opus 4.6 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Sobrescribe la región de Claude Sonnet 4.6 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Sobrescribe la región de Claude Opus 4.7 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Sobrescribe la región de Claude Opus 4.8 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_5_5_OPUS`	Sobrescribe la región de Claude Opus 5.5 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.280
`VERTEX_REGION_CLAUDE_5_5_SONNET`	Sobrescribe la región de Claude Sonnet 5.5 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.284
`VERTEX_REGION_CLAUDE_5_OPUS`	Sobrescribe la región de Claude Opus 5 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.219
`VERTEX_REGION_CLAUDE_5_SONNET`	Sobrescribe la región de Claude Sonnet 5 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Sobrescribe la región de Claude Fable 5 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.170
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Sobrescribe la región de Claude Fable 5.1 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.257
`VERTEX_REGION_CLAUDE_FABLE_5_2`	Sobrescribe la región para Claude Fable 5.2 al usar Google Cloud’s Agent Platform. Se agregó en v2.1.321
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Sobrescribe la región de Claude Haiku 4.5 cuando se usa Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_HAIKU_5_5`	Sobrescribe la región de Claude Haiku 5.5 cuando se usa Google Cloud’s Agent Platform. Añadida en v2.1.293

También se admiten las variables estándar de los exportadores 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 las variantes específicas de cada señal). Consulta Monitoreo para ver los detalles de configuración. Establece CLAUDE_CODE_ENABLE_TELEMETRY y las variables de OpenTelemetry que activan la exportación, eligen su destino o capturan contenido en tu shell, en la configuración de usuario o en la configuración administrada. Claude Code las ignora en la configuración de proyecto y local, salvo los valores de desactivación que describe esa sección. OTEL_RESOURCE_ATTRIBUTES y las variables de intervalo, tiempo de espera y compresión de la exportación, como OTEL_METRIC_EXPORT_INTERVAL, siguen aplicándose desde la configuración de proyecto y local.

Qué elimina la depuración del entorno de los subprocesos

Cuando estableces CLAUDE_CODE_SUBPROCESS_ENV_SCRUB en 1, Claude Code elimina las credenciales de los entornos de los subprocesos que inicia, como los comandos de Bash, los hooks y los servidores MCP stdio. Esto reduce lo que un ataque de inyección de prompts puede leer. El proceso de Claude Code conserva las credenciales para sus propias llamadas a la API. La depuración reconoce una credencial por el nombre de su variable o por la forma de su valor, así que úsala como una capa más junto con reglas de permisos acotadas, en lugar de como el único control. La tabla muestra lo que hace la depuración con algunas variables de ejemplo:

Variable de ejemplo	Lo que hace la depuración
`ANTHROPIC_API_KEY`, `AWS_SECRET_ACCESS_KEY`	La elimina
`NPM_TOKEN`, `DB_PASSWORD`	La elimina, porque el nombre parece el de una credencial
`DATABASE_URL` que contiene una contraseña	La elimina, porque el valor parece una credencial
`PIP_INDEX_URL` o `NPM_CONFIG_REGISTRY` que contiene una contraseña	Conserva la URL y le quita el nombre de usuario y la contraseña
`CLAUDE_CONFIG_DIR`	La elimina
`GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN`	La deja intacta, para que `gh` y los scripts que llaman a la API de GitHub sigan funcionando
`HTTP_PROXY`, `HTTPS_PROXY`	La deja intacta, incluido un nombre de usuario y contraseña en la URL. El sandbox puede establecer estas variables por sí mismo para los comandos que se ejecutan en el sandbox
`GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>`	La deja intacta, sin importar lo que contenga
Un secreto cuyo nombre de variable y valor no parecen una credencial	La deja intacta

Como la depuración deja intacto GITHUB_TOKEN, asigna a un trabajo de GitHub Actions los permissions más restringidos que necesite. Para eliminar un token de GitHub de los comandos de Bash que se ejecutan en el sandbox, agrega una entrada deny en sandbox.credentials. No establezcas la depuración si un subproceso necesita alguna de las variables eliminadas. En Linux, la depuración también ejecuta los subprocesos de Bash en un espacio de nombres PID aislado para que no puedan leer los entornos de los procesos del host a través de /proc. Como efecto secundario, ps, pgrep y kill no pueden ver los procesos del host ni enviarles señales. Antes de la v2.1.251, la depuración eliminaba ANTHROPIC_API_KEY y AWS_SECRET_ACCESS_KEY y dejaba sin cambios las demás variables de ejemplo de la tabla.

Funciones que requieren la obtención de feature flags

Claude Code activa algunas funciones mediante feature flags que obtiene de Anthropic. Claude Code omite esa obtención en estas sesiones:

Una sesión en la que estableces CLAUDE_CODE_DISABLE_FEATURE_FLAGS, 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 externo, como Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform o Microsoft Foundry, a menos que una plataforma anfitriona que integre Claude Code establezca CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
Una sesión del gateway de aplicaciones de Claude

Con la obtención desactivada, no puedes:

Usar Remote Control con CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o CLAUDE_CODE_DISABLE_FEATURE_FLAGS establecidas. Para DISABLE_TELEMETRY y DO_NOT_TRACK, consulta los requisitos de Remote Control
Enviar mensajes a sesiones fuera de esta máquina cuando Remote Control no está disponible. El envío de mensajes entre sesiones en esta máquina funciona con la obtención desactivada
Ejecutar claude import o el comando /import
Ejecutar /skill-doctor ni abrir su informe en la pestaña Stats de /plugin
Ejecutar /restart en los planes Pro, Max y Ultra
Sincronizar los skills y plugins habilitados para tu cuenta de claude.ai en tus sesiones de terminal
Activar el mod You should know
Usar la herramienta advisor, excepto en Claude Platform on AWS con Claude Code v2.1.300 o posterior
Usar tareas de MCP
Activar Code Mode
Leer o responder comentarios en un artefacto
Hacer que Claude lea el artefacto público de otra organización
Obtener la herramienta PowerShell de forma predeterminada para cuentas de claude.ai y Console en Windows con Git Bash instalado; Claude Code enruta los comandos de shell a través de Git Bash a menos que establezcas CLAUDE_CODE_USE_POWERSHELL_TOOL=1. En Windows sin Git Bash, la herramienta permanece activada
Obtener comentarios redactados por Claude, que Claude Code activa mediante un flag obtenido
Hacer que Claude trate los pegados 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 las herramientas MCP cuyo esquema de entrada rechazaría la API

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

En tu primera sesión después de instalar Claude Code, o de actualizar a una versión que añade una función, puede faltar una función controlada por flags. Cuando Claude Code obtiene sus feature flags durante esa sesión, los guarda en la máquina, de modo que tu siguiente sesión en esa máquina tiene la función. En configuraciones como estas, las sesiones posteriores a la primera también se inician sin flags recién obtenidos:

Un entorno limpio en cada ejecución: si cada ejecución se inicia en un contenedor de CI, o en cualquier otro entorno sin los flags que guardó una sesión anterior, cada ejecución es una primera sesión
Un token de gateway sin clave de API: si te autenticas con ANTHROPIC_AUTH_TOKEN y sin clave de API, y ANTHROPIC_BASE_URL apunta a un host distinto al de Anthropic, como un gateway de LLM, Claude Code no tiene ninguna credencial con la que obtener los flags

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