SpyBara
Go Premium

env-vars.md 2026-10-03 23:57 UTC to 2026-10-04 18:58 UTC

This page contains 344 additions and 305 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 19:59

Variables de entorno

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

Las variables de entorno pueden controlar el comportamiento de Claude Code, como la selección de modelo, autenticación, enrutamiento de solicitudes y alternadores de características. Muchos de los mismos comportamientos también se pueden configurar a través de un campo de archivo de configuración, una bandera CLI o un comando en sesión como /model.

Esta página cubre cómo:

Establecer variables de entorno

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

En su shell

Establezca la variable antes de lanzar claude:

export API_TIMEOUT_MS="1200000"
claude

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

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

echo $API_TIMEOUT_MS

En archivos de configuración

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

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

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

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

Consulte Archivos de configuración para saber dónde vive cada archivo y Precedencia de configuración para saber cómo se combinan cuando más de uno establece la misma variable.

Precedencia

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

Cuando la misma variable se establece tanto en su shell como en un bloque env de archivo de configuración, se aplica el valor del archivo de configuración 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 inicia claude. Las variables establecidas bajo la clave env en archivos de configuración se reaplicarán a una sesión en ejecución cuando el archivo cambie, con la excepción de solo inicio descrita en En archivos de configuración.

Variables

Las variables numéricas, como los tiempos de espera, los presupuestos de tokens y los recuentos de reintentos, aceptan notación científica y escrituras con 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 la v2.1.211, estas escrituras podían establecer silenciosamente un valor mucho menor, como 1e6, que establecía un tiempo de espera de 1.

Variable Propósito
ANTHROPIC_API_KEY Clave de API enviada como encabezado X-Api-Key. Cuando se establece, esta clave se usa en lugar de tu suscripción Claude Pro, Max, Team o Enterprise, incluso si iniciaste sesión. En modo no interactivo (-p), la clave siempre se usa cuando está presente. En modo interactivo, se te pide aprobar 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 (al valor que establezcas aquí se le antepondrá 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. Cuando se establece en un host que no es de primera parte, MCP Tool Search se desactiva de forma predeterminada. Establece ENABLE_TOOL_SEARCH=true si tu proxy reenvía bloques tool_reference. 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). Se envía como el encabezado X-Amzn-Bedrock-Service-Tier. Consulta Amazon Bedrock
ANTHROPIC_BETAS Lista separada por comas de valores adicionales del encabezado anthropic-beta que se incluirán en las solicitudes a la API. Claude Code ya envía los encabezados beta que necesita; usa esto 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 que se agregarán a las solicitudes (formato Name: Value, separados por saltos de línea para varios encabezados). Si un nombre o un 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, de organización o tenant, de enrutamiento o de comportamiento de la API, como Authorization o Host, cuenta como un ajuste que requiere aprobación cuando lo entrega la configuración administrada por el servidor. Desde la configuración del proyecto o local, dicho valor sigue las reglas sobre cuándo se aplican los valores de env
ANTHROPIC_CUSTOM_MODEL_OPTION ID de modelo que se agregará como entrada personalizada en el selector /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 /model. El valor predeterminado es Custom model (<model-id>) cuando no se establece
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Nombre que se muestra para la entrada del modelo personalizado en el selector /model. Cuando no se establece, la entrada muestra el nombre del modelo si Claude Code reconoce el ID, y el ID del modelo en caso contrario
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES Lista separada por comas de 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 modelo Fable para el respaldo automático de modelo en proveedores externos. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Descripción que se muestra para el modelo Fable fijado en el selector /model. Cuando no se establece, la fila muestra una descripción predeterminada que comienza con Custom Fable model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Nombre que se muestra para el modelo Fable fijado en el selector /model. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. 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 /model. Cuando 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 /model. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. 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 inician 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 /model. Cuando 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 /model. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. 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 /model. Cuando 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 /model. Cuando no se establece, la fila muestra el nombre del modelo si Claude Code reconoce el ID fijado, y el ID fijado en caso contrario. 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 la 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 por ant auth login o al iniciar sesión en una cuenta de Console sin 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 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. Establece 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 1 para mantenerlo activo en todos los proveedores. Cuando no está establecida, el tiempo de espera está activo en los proveedores distintos de la API directa de Anthropic, Claude Platform on AWS y Amazon Bedrock con CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 establecido. Los watchdogs de streaming se ejecutan de forma independiente y abortan una pausa silenciosa larga incluso cuando estableces 0 aquí
API_TIMEOUT_MS Tiempo de espera para las solicitudes a la API en milisegundos (predeterminado: 600000, o 10 minutos; máximo: 2147483647). Auméntalo cuando se agote el tiempo de espera de las solicitudes en redes lentas o al enrutar a través de un proxy. Los valores por encima del máximo desbordan el temporizador subyacente y hacen que las solicitudes fallen de inmediato
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 predeterminado de más de 30 minutos también se convierte en el límite de tiempo predeterminado para comandos en segundo plano en 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 lee de vuelta en el 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 de más de 2 horas también se convierte en el límite de tiempo máximo para comandos en segundo plano en sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior
BETA_TRACING_ENDPOINT Endpoint OTLP para el trazado 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 del proyecto y local
CCR_FORCE_BUNDLE Establece 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 genera Claude Code (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, en lugar de dentro de un servidor MCP stdio que Claude Code inició, usa CLAUDE_CODE_CHILD_SESSION en su lugar
CLAUDE_AFK_COUNTDOWN_MS Cuántos milisegundos antes de la continuación automática aparece la cuenta regresiva en pantalla en un diálogo AskUserQuestion sin responder. Predeterminado 20000 (20 segundos), limitado al tiempo de espera de la continuación automática. No tiene efecto a menos que la continuación automática esté activada; consulta el ajuste askUserQuestionTimeout y CLAUDE_AFK_TIMEOUT_MS. Requiere Claude Code v2.1.198 o posterior
CLAUDE_AFK_TIMEOUT_MS Cuántos milisegundos de inactividad deben pasar antes de que un diálogo AskUserQuestion sin responder continúe automáticamente sin ti. La continuación automática está desactivada de forma predeterminada; actívala con el ajuste askUserQuestionTimeout. Esta variable es una sobrescritura para demostraciones y pruebas automatizadas: cuando se establece, tiene precedencia sobre ese ajuste y activa la continuación automática incluso cuando el ajuste no está establecido o es never. Establecer 0 no desactiva el tiempo de espera; cierra el diálogo de inmediato. En v2.1.198 y v2.1.199, la continuación automática estaba activada de forma predeterminada con un tiempo de espera de 60000 (60 segundos). Requiere Claude Code v2.1.198 o posterior
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS Establece 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. Esa llamada falla entonces con subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIX Establece en 1 para omitir el prefijo mcp__<server>__ en los nombres de las herramientas de los servidores MCP creados por el SDK. Las herramientas usan sus nombres originales. Solo para uso del SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS Tiempo de espera por bloqueo en milisegundos para subagentes. Predeterminado 600000 (10 minutos); si aumentas CLAUDE_STREAM_IDLE_TIMEOUT_MS mientras el watchdog de stream está activo, el valor predeterminado aumenta con él, como se describe en Gestionar respuestas de la API lentas o bloqueadas. El temporizador se reinicia con cada evento de progreso del streaming; si no llega ningún progreso dentro del intervalo, Claude Code aborta el subagente e informa del bloqueo al agente principal
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 elevar el umbral, por lo que se ignoran los valores por encima del 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 Establece en 1 para forzar la activación del envío automático a segundo plano de las tareas de agente de larga duración. Cuando está activado, los subagentes se mueven a segundo plano después de ejecutarse durante aproximadamente dos minutos. También activa el envío automático a segundo plano de las 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, por lo que Claude Code no espera. Antes de la v2.1.287, el valor predeterminado era 50. Claude Code limita la espera a 5000. Requiere Claude Code v2.1.233 o posterior
CLAUDE_AX_SCREEN_READER Establece en 1 para renderizar una salida apta para lectores de pantalla: texto plano sin bordes decorativos ni animaciones. Establece 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. 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, para que tu lector de pantalla pueda 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 finaliza la retención antes de tiempo. 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 se establece, 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 detector 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 push 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 Establece en 1 para mantener visible el cursor nativo de la terminal y desactivar el indicador de cursor de texto invertido. Permite que las lupas de pantalla como Zoom de macOS sigan la posición del cursor
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD Establece en 1 para cargar archivos de memoria desde 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 Establece en 1 para volver a dibujar toda la pantalla en cada fotograma en el renderizado de pantalla completa en lugar de enviar actualizaciones incrementales. Úsala si el modo de pantalla completa muestra fragmentos de texto obsoletos o mal ubicados. Claude Code activa esto automáticamente para las sesiones en segundo plano y la vista de agentes en Windows
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT Establece 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 esfuerzo. Úsala al enrutar a través de un gateway de LLM o un proveedor externo que sirve modelos con identificadores personalizados. Los modelos que rechazan el parámetro de esfuerzo en la API, incluidos los modelos Claude 3, Sonnet 4.0 y 4.5, Opus 4.0 y 4.1, y Haiku 4.5, siguen excluidos para que las solicitudes no fallen
CLAUDE_CODE_API_KEY_HELPER_TTL_MS Intervalo en milisegundos con el que deben actualizarse las credenciales (al usar apiKeyHelper)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN Establece en 0 para evitar que Claude Code abra el navegador automáticamente cuando se publica un nuevo artefacto
CLAUDE_CODE_ARTIFACT_COMMENTS Establece en 0 para que Claude deje de leer y responder los 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 Establece 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_ATTRIBUTION_HEADER Establece en 0 para omitir del inicio del prompt del sistema el bloque de atribución, que contiene la versión del cliente y una huella del prompt. 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 cuando estableces 0. En Bloque de atribución del prompt del sistema, consulta qué conexiones y credenciales abarca esto. Antes de la v2.1.181, el bloque incluía un token por solicitud en las URL base personalizadas y en las conexiones de Microsoft Foundry, por lo 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 externo, o cuando te conectes directamente a Microsoft Foundry
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS Se eliminó en la 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 en tokens, de 100000 a 1000000. Solo acepta un entero simple como 500000: un valor como 500k se lee como 500 y se ajusta al mínimo de 100K. La ventana efectiva también está limitada a la ventana de contexto del modelo. Tiene precedencia sobre el comando /autocompact, el flag --autocompact y el ajuste autoCompactWindow. El used_percentage de la línea de estado siempre se mide respecto a la ventana de contexto completa del modelo, por lo que, una vez establecida esta variable, ese porcentaje ya no indica cuándo se ejecutará la compactación
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. Establece en false para evitarlo. Establece en true para forzar un intento de conexión cuando falla la detección automática, como cuando tmux oculta la terminal principal. Tiene precedencia sobre el ajuste de configuración global autoConnectIde
CLAUDE_CODE_AUTO_MODE_SERVER Controla si Claude Code pide al servidor que revise las acciones del modo automático. Establece 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_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 necesite legítimamente 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 siempre que Claude Code firma con la cadena predeterminada: Amazon Bedrock, Claude Platform on AWS y el endpoint de Mantle. Requiere Claude Code v2.1.207 o posterior
CLAUDE_CODE_BASH_EDIT_DIFF Establece 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 Establece en 0 para que una sesión no interactiva informe un estado inactivo a su host al final de cada turno, incluso mientras todavía hay trabajo en segundo plano en ejecución. De forma predeterminada, la sesión sigue informando un estado en 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 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 entrada a mitad del trabajo. Los comandos de shell en segundo plano, como un servidor de desarrollo, no mantienen el estado en ejecución. El estado en 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 en 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 termina la conexión. El valor es el ID de la sesión con formato session_, el mismo identificador que aparece en la URL claude.ai/code de la sesión, para que un script pueda enlazar de vuelta a la sesión que lo ejecutó. Requiere Claude Code v2.1.199 o posterior. En sesiones en la nube, lee CLAUDE_CODE_REMOTE_SESSION_ID en su lugar
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE Establece en 0 para que Claude Code lea el byte 0x08, también escrito ^H, como Backspace simple, o en 1 para leerlo como Ctrl+Backspace. Cualquiera de los dos valores reemplaza el valor predeterminado de la plataforma. De forma predeterminada, Claude Code lo lee como Ctrl+Backspace en Windows, excepto cuando TERM_PROGRAM es mintty o TERM es cygwin, y como Backspace simple en macOS y Linux. Establece 0 en una terminal de Windows donde Backspace borra una palabra completa
CLAUDE_CODE_CERT_STORE Lista separada por comas de fuentes de certificados de CA para conexiones TLS. bundled es el conjunto de CA de Mozilla incluido con Claude Code. system es el almacén de confianza del sistema operativo, que solo se lee en runtimes con tls.getCACertificates: el binario nativo, o Node 22.15 o posterior para 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 de un IDE. Una TUI interactiva de claude anidada iniciada de esta forma se excluye automáticamente de --resume, --continue, el historial de flecha arriba y la lista de claude agents. Las sesiones no interactivas de claude -p siguen persistiendo. 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 del cliente para la autenticación mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE Frase de contraseña para CLAUDE_CODE_CLIENT_KEY cifrada (opcional)
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 para el tiempo de espera por solicitud. 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. Establece en verbose para incluir diagnósticos de gran volumen, como la salida completa del comando de la línea de estado, o súbelo a error para reducir el ruido
CLAUDE_CODE_DISABLE_1M_CONTEXT Establece en 1 para desactivar la compatibilidad con la ventana de contexto de 1M. Cuando se establece, las variantes de modelo de 1M no están disponibles en el selector de modelos, y Claude Code limita las sesiones en modelos con una ventana nativa de 1M, como Sonnet 5.5 y los modelos Fable, a una ventana de 200K; consulta Contexto extendido para ver cómo se aplica ese límite. Útil para entornos empresariales con requisitos de cumplimiento. Para conocer su función en la corrección de la ventana de un ID de modelo [1m] no reconocido, consulta Corregir la ventana para un ID de modelo de gateway o personalizado
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING Establece en 1 para desactivar el razonamiento adaptativo en Opus 4.6 y Sonnet 4.6 y recurrir al presupuesto fijo de pensamiento controlado por MAX_THINKING_TOKENS. No tiene efecto en los modelos Fable, Sonnet 5 y posteriores, ni Opus 4.7 y posteriores, que siempre usan razonamiento adaptativo
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION Establece en 1 para evitar que Claude Code combine por clave los bloques env de la configuración administrada entre las fuentes de administración, de modo que solo se aplique el bloque env completo de la fuente de mayor prioridad, como antes de la v2.1.223. Establécela 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.223 o posterior
CLAUDE_CODE_DISABLE_ADVISOR_TOOL Establece en 1 para desactivar la herramienta advisor. El comando /advisor deja de estar disponible, se ignora cualquier advisorModel configurado, 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 Establece 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 Establece en 1 para desactivar el renderizado de 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 de pantalla completa
CLAUDE_CODE_DISABLE_ARTIFACT Establece 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 que la estableces, 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 Establece 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
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Establece 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 Establece en 1 para desactivar la memoria automática. Establece 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 Establece en 1 para desactivar toda la funcionalidad de tareas en segundo plano, incluido el parámetro run_in_background en las herramientas Bash y de subagentes, el envío automático a segundo plano y el atajo Ctrl+B
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT Establece en 1 para evitar que Claude Code trate una respuesta en streaming de Amazon Bedrock con un encabezado Content-Type ausente o vacío como el stream 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ó, por lo que decodifica el cuerpo y el streaming sigue funcionando. Establécela solo para un gateway que también vuelva a emitir el stream como server-sent events; Claude Code entonces lee el cuerpo sin encabezado como server-sent events. Requiere Claude Code v2.1.239 o posterior
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Establece 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 diferente, 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 Establece en 1 para que se detengan los comandos de shell en segundo plano en ejecución de una sesión en segundo plano, sus flujos de trabajo dinámicos y, a partir de la v2.1.198, sus subagentes en segundo plano cuando el supervisor detiene, reinicia o actualiza el proceso de esa sesión, en lugar de entregarlos al siguiente proceso de la sesión. Solo afecta a esa entrega: enviar una sesión a segundo plano con ← o /background sigue trasladando el trabajo en curso, y CLAUDE_DISABLE_ADOPT desactiva ambos. Requiere Claude Code v2.1.196 o posterior
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Establece 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 de 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_BUNDLED_SKILLS Establece 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 quedan ocultos para el 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 Establece en 1 para mantener disponibles las herramientas de navegador de Claude in Chrome y, a la vez, omitir la sección de Chrome del prompt del sistema y el skill incluido /claude-in-chrome. Para hosts que integran Claude Code y proporcionan sus propias instrucciones para el navegador. Requiere Claude Code v2.1.257 o posterior
CLAUDE_CODE_DISABLE_CLAUDE_MDS Establece en 1 para evitar cargar en el contexto cualquier archivo de memoria CLAUDE.md, incluidos los archivos de memoria de usuario, de proyecto y de memoria automática
CLAUDE_CODE_DISABLE_CRON Establece en 1 para desactivar las tareas programadas. El skill /loop y las herramientas de cron dejan de estar disponibles y cualquier tarea ya programada deja de ejecutarse, incluidas las tareas que ya se están ejecutando a mitad de la sesión
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT Establece en 1 para desactivar el límite de tiempo de las solicitudes de confirmación de eliminación de rutas críticas. En modo auto, Claude Code envía entonces estas eliminaciones al clasificador, y en modo bypassPermissions la solicitud espera tu respuesta. Establécela 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.281 o posterior
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Establece en 1 para quitar 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 solicitudes con un error Unexpected value(s) para el encabezado anthropic-beta o un error Extra inputs are not permitted. Desactivar capacidades preliminares enumera lo que elimina la variable, incluida MCP Tool Search, y lo que Claude Code sigue enviando
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS Establece en 1 para desactivar los subagentes Explore y Plan integrados. En su lugar, Claude explora con sus herramientas de búsqueda o con el subagente de propósito general, y el modo plan lee los archivos directamente en lugar de lanzar 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 Establece en 1 para desactivar el modo rápido
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Establece 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 tasa de muestreo en lugar de desactivarlas por completo, usa el ajuste feedbackSurveyRate. Consulta Encuestas de calidad de sesión
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING Establece 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_GIT_INSTRUCTIONS Establece en 1 para quitar 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. Tiene precedencia sobre el ajuste includeGitInstructions cuando se establece
CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT Establece en 1 para evitar que Claude Code lea 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 de parámetros posicionales en esos scripts, y las demás comprobaciones de rutas críticas siguen ejecutándose. Establécela 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.288 o posterior
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Establece en 1 para evitar la reasignación automática de Opus 4.0 y 4.1 a la versión actual de Opus en la API de Anthropic. Úsala cuando quieras fijar intencionadamente un modelo anterior. La reasignación no se ejecuta en Amazon Bedrock, Google Cloud's Agent Platform ni Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Establece 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_MOUSE Establece en 1 para desactivar el seguimiento del mouse en el renderizado de pantalla completa. El desplazamiento con el teclado mediante PgUp y PgDn sigue funcionando. Úsala para mantener el comportamiento nativo de copiar al seleccionar de tu terminal
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Establece en 1 para desactivar el manejo de clics, arrastres y hover en el renderizado de pantalla completa manteniendo 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 Establece 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 de handshake TLS. Con la recarga desactivada, Claude Code carga los archivos rotados solo cuando vuelve a aplicar 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 las fuentes 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 y 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á cubierta; desactívala con CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. No afecta al descubrimiento de modelos del gateway, que tiene su propia activación opcional
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Establece en 1 para desactivar el respaldo sin streaming cuando una solicitud en streaming falla a mitad del stream. 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 Establece 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 el 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 Establece 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 Establece en 1 para evitar que Claude Code ejecute tus hooks Notification para solicitudes de permiso sin responder en sesiones donde Claude Code las envía al 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 Establece en 1 para omitir la carga de skills desde el directorio de skills administrados de todo el sistema. Útil para sesiones en contenedores o de CI que no deben cargar skills aprovisionados por el operador
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY Establece 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 Establece 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 Establece en 1 para evitar que Claude Code envíe el campo de salida estructurada output_config.format y el valor de anthropic-beta que lo acompaña, para un gateway de LLM cuyo upstream 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 Establece en 1 para desactivar la comprobación de rutas críticas para un rm recursivo cuyo destino es enteramente la salida de una sustitución de comandos, como rm -rf "$(pwd)". Las demás comprobaciones de rutas críticas siguen ejecutándose. Establécela 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.281 o posterior
CLAUDE_CODE_DISABLE_TERMINAL_TITLE Establece 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
CLAUDE_CODE_DISABLE_THINKING Establece 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 aún puede pensar. 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 ni en los modelos Fable, en los que no se puede desactivar el pensamiento. En proveedores externos, MAX_THINKING_TOKENS=0 también omite el parámetro, por lo que las dos variables se comportan igual allí
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT Establece en 1 para omitir la compactación automática proactiva cuando Claude Code no reconoce el ID del modelo, como un alias de 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 la ventana asumida en su lugar; consulta Corregir la ventana para un ID de modelo de gateway o personalizado para saber cuándo se aplica cada variable. Requiere Claude Code v2.1.223 o posterior
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL Establece en 1 para desactivar el desplazamiento virtual en el renderizado de pantalla completa y renderizar cada mensaje 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 Establece 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 Establece 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 pase al siguiente proceso de la sesión, como cuando envías 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 Establece en 1 para desactivar los flujos de trabajo. Equivale al ajuste disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Establece el nivel de esfuerzo para los modelos compatibles. Valores: low, medium, high, xhigh, max o auto para usar el valor predeterminado del modelo. Los niveles disponibles dependen del modelo. Tiene precedencia sobre --effort, /effort y los ajustes modelSettings y effortLevel. Un límite de maxEffortLevel sigue aplicándose. Consulta Ajustar el nivel de esfuerzo
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 el Claude apps gateway. De v2.1.158 a v2.1.206, era necesario establecer esta variable 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 es false. Tiene precedencia sobre el ajuste y el interruptor de /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Establécela en 1 para actualizar el estado de los plugins en los límites de turno 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_FEEDBACK_SURVEY_FOR_OTEL Establécela en 1 para enviar la encuesta de calidad de sesión "How is Claude doing?" a tu propio recopilador de OpenTelemetry cuando el tráfico no esencial dirigido a Anthropic está bloqueado. Las calificaciones de la encuesta se emiten solo como eventos OTEL a tu recopilador configurado. En este modo no se envía ningún dato 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 caso contrario. 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 dar la impresión de que se ha bloqueado. 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 al enrutar 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 las conexiones de gateway
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Establécela en 1 para completar 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 puede acceder la clave. Los modelos descubiertos siguen filtrándose por una lista de 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 de gateway
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE Eliminada en 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 de tu prompt. Tiene precedencia sobre el ajuste promptSuggestionEnabled, que es lo que escribe el interruptor Prompt suggestions en /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 mantenerlas activadas hasta que alcances el límite. Requiere Claude Code v2.1.238 o posterior. Consulta Sugerencias de prompts
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 obligatoria 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 enumerados 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_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_EXTRA_BODY Objeto JSON que se combina en el nivel superior del cuerpo de cada solicitud a la API. Ú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 despachas con claude agents o --bg. Antes de v2.1.206, las sesiones en segundo plano ignoraban un valor exportado desde 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. Útil cuando necesitas leer archivos más grandes por completo
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 inició 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, hace que una sesión genuina de nivel superior se clasifique erróneamente como anidada. A partir de v2.1.178, Claude Code detecta automáticamente el caso de tmux e ignora el marcador heredado, por lo que tmux ya no necesita esta variable. También se respeta en v2.1.169 y anteriores; no tiene efecto en v2.1.170 ni en 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 del tachado para ~~text~~ en las respuestas de Claude cuando tu terminal lo admite pero no se detecta automáticamente, como a través de SSH sin reenviar TERM_PROGRAM. Sin esto, las terminales no detectadas muestran los marcadores ~~ literales en lugar de mostrar el texto tachado. Requiere Claude Code v2.1.186 o posterior
CLAUDE_CODE_FORCE_SYNC_OUTPUT Establécela en 1 para forzar la habilitació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 dentro de tmux. A diferencia de CLAUDE_CODE_NO_FLICKER, que cambia a la representación en pantalla completa, esta variable no cambia el renderizador
CLAUDE_CODE_FORK_SUBAGENT Controla el modo fork, que permite a Claude generar subagentes bifurcados por sí mismo y está activado de forma predeterminada solo en sesiones interactivas. Establécela en 1 para activarlo también en claude -p y en el Agent SDK, o en 0 para desactivarlo en todo tipo de sesión. Puedes ejecutar /subtask tanto si el modo fork está activado como si no. El valor predeterminado interactivo requiere Claude Code v2.1.232 o posterior; en versiones anteriores, establece la variable en 1 para activar 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 sale con un error fuera del modo no interactivo con salida stream-json, la variable se ignora allí para que las invocaciones anidadas sigan funcionando cuando se establece 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 del gateway, 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 formas de escritura 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 o 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 v2.1.219, Claude Code salía al inicio 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 el descubrimiento de archivos de la herramienta Glob. 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. Predeterminado: 30. Establece 0 para desactivar las revisiones. Indica minutos enteros en dígitos simples, como máximo 10080, que equivale a una semana. Claude Code trata cualquier otro valor como no establecido y usa el predeterminado. Requiere Claude Code v2.1.234 o posterior
CLAUDE_CODE_HIDE_CWD Establécela en 1 para ocultar el directorio de trabajo en el logo de inicio. Útil al compartir pantalla o en 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 omitir la instalación automática de extensiones del IDE. Equivale a establecer autoInstallIdeExtension en false
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 encuentra tu IDE a pesar de que se está ejecutando
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Cuántos subagentes pueden estar ejecutándose en una sesión antes de que la herramienta Agent se niegue a generar otro (predeterminado: 20). Acepta un número entero positivo en dígitos simples; cualquier otro valor se ignora, por lo que la variable puede ajustar el límite pero no deshabilitarlo. Requiere Claude Code v2.1.217 o posterior
CLAUDE_CODE_MAX_CONTEXT_TOKENS Sobrescribe el tamaño de la ventana de contexto que Claude Code asume para el modelo activo. A partir de v2.1.193, cómo se aplica depende de cómo Claude Code resuelve el ID del modelo; consulta Corregir la ventana para un gateway o un ID de modelo personalizado. Úsala al enrutar a un modelo a través de ANTHROPIC_BASE_URL cuya ventana de contexto no coincide con el tamaño integrado para su nombre
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Longitud máxima en caracteres de cada descripción de herramienta MCP y de las instrucciones de cada servidor MCP que Claude Code envía al modelo (predeterminado: 2048). Claude Code trunca el texto más largo. Acepta un número entero positivo en dígitos simples. Cualquier otro valor se ignora y se aplica el predeterminado. 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 un valor superior al límite de un modelo hasta ese límite. Para un ID de modelo que Claude Code no puede resolver a un modelo que conoce, el 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). Limitado a 15 a partir de v2.1.186; a partir de v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG aumenta el predeterminado y elimina el límite. Para sesiones desatendidas que necesitan esperar durante interrupciones más largas, establece CLAUDE_CODE_RETRY_WATCHDOG en su lugar
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Eliminada en v2.1.224 y ahora no tiene efecto. Anteriormente limitaba el número total de subagentes que Claude podía generar con la herramienta Agent en una sesión (predeterminado: 200); generar más allá del límite fallaba con Subagent spawn limit reached. El límite de subagentes simultáneos 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 en la tercera capa no puede generar más; establece 1 para desactivar el anidamiento. De v2.1.217 a v2.1.218, el predeterminado era 1, por lo que un subagente no podía generar los suyos a menos que aumentaras el límite; v2.1.219 aumentó el predeterminado a 3. Acepta un número entero positivo en 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_TOOL_USE_CONCURRENCY Número máximo de herramientas de solo lectura y subagentes que pueden ejecutarse en paralelo (predeterminado: 10). Los valores más altos aumentan el paralelismo pero consumen más recursos
CLAUDE_CODE_MAX_TURNS 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 es un entero positivo se rechaza al inicio con un error en lugar de tratarse como sin límite
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Límite del número total de llamadas a WebSearch que puede hacer una sesión (predeterminado: 200). Cuando Claude alcanza el límite, las siguientes llamadas a WebSearch devuelven un aviso que le indica continuar con la información que ya reunió. Acepta un número entero positivo sin límite superior. Cualquier otro valor se ignora y se aplica el 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. 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. Cuando se establece, la espera abarca todos los servidores pendientes. Establécela en 0 para omitir la espera. Un servidor de --permission-prompt-tool mantiene su propia espera de MCP_TIMEOUT independientemente del valor. 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 notificación de progreso durante este tiempo, la llamada a herramienta se interrumpe 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 al menos hasta el valor de timeout. No se aplica a los servidores del IDE ni a los servidores en proceso del SDK. Requiere Claude Code v2.1.187 o posterior. Antes de v2.1.203, los servidores stdio estaban exentos del tiempo de espera 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 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 requiere esta línea y cierra cualquier conexión que no comience con una válida. Las reglas de hijo propio 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 en lugar de un bloque dibujado. El cursor respeta los ajustes de parpadeo, forma y foco de la terminal
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 pausado 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 reenvía una solicitud sin streaming cuyo tiempo de espera se agota. Con 0, la solicitud falla la primera vez que se agota el tiempo de espera. No está establecida de forma predeterminada, por lo que CLAUDE_CODE_MAX_RETRIES limita estos reenvíos. Consulta Ajustar el comportamiento de los reintentos 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
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
CLAUDE_CODE_OAUTH_TOKEN Token de acceso de OAuth para la autenticación de claude.ai. Alternativa a /login para el SDK y entornos automatizados. 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 estableces 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 v2.1.160 y ahora no tiene efecto. Anteriormente fijaba el modo rápido a Claude Opus 4.6 en lugar del 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 atributo de más de 64 KB, o redúcela para recortar 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 los errores de diagnóstico del exportador de OpenTelemetry en stderr. De forma predeterminada, estos errores solo aparecen con --debug, por lo que un exportador mal configurado, por ejemplo por una colisión de puertos de Prometheus, falla en silencio. 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 pendientes de OpenTelemetry (predeterminado: 5000). Consulta Monitoreo
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervalo en milisegundos para actualizar los encabezados dinámicos de OpenTelemetry (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_PACKAGE_MANAGER_AUTO_UPDATE Establécela en 1 para permitir que Claude Code ejecute el comando de actualización de tu gestor de paquetes en segundo plano 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 de escritura compatible con Perforce. Cuando se establece, Edit, Write y NotebookEdit fallan con una sugerencia p4 edit <file> si el archivo de destino carece del bit de escritura del propietario, que Perforce borra en los archivos sincronizados hasta que p4 edit los abre. Esto evita que Claude Code eluda el seguimiento de cambios de Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIR Sobrescribe el directorio raíz de 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 dentro 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 de la misma forma en que lo carga un flag --plugin-dir. Separa varias rutas con : en Unix o ; en Windows. Indica cada ruta como ruta absoluta o iníciala 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_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 el checkout 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 la 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 ya 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 Rellenar previamente los 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 MachinePolicy ni UserPolicy de la directiva de grupo, independientemente de este ajuste
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Límite máximo en milisegundos de la espera inactiva de subagentes y flujos de trabajo en segundo plano 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 gestionar 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 y sale. Establécela en 0 para esperar indefinidamente. Este límite es independiente del período de gracia de cinco segundos que se aplica a los shells simples en segundo plano. Requiere Claude Code v2.1.182 o posterior
CLAUDE_CODE_PROCESS_WRAPPER Inicia los procesos que Claude Code arranca desde su propio binario, como el servicio en segundo plano que aloja las sesiones de la vista de agentes, 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 la local no pueden 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, qué cubre el lanzador y el contrato que este 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 de un bloque env de un archivo de configuración. Consulta Nombrar tú mismo el 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 junto 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 en 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 v2.1.152. Consulta Trazas (beta)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST La establecen las plataformas host 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, de modo que la configuración de usuario no puede sobrescribir el enrutamiento del host. 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 host 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 permitidos availableModels en la configuración administrada sigue aplicándose a menos que el host proporcione la suya. Claude Code también omite la exclusión automática de la telemetría que de otro modo aplica 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
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_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 reenviar 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 explícitamente. Sin establecer o 0 significa sin límite, excepto que un turno cuya última solicitud falló con un error de la API solo se reanuda mientras ese error tenga menos de seis horas de antigüedad. 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 de inicio de 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 él 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 reenviar 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 predeterminado
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 procedente de un límite de gasto del gateway que se restablece según un calendario. Antes de v2.1.239, el watchdog los reintentaba indefinidamente. Para las solicitudes en modo rápido, consulta Gestionar los rate limits. El watchdog espera hasta 5 minutos entre intentos, o hasta que se restablece 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 termine la ventana restante. En v2.1.199 o posterior también aumenta a 300 el número predeterminado de reintentos para otros errores transitorios, como errores del servidor, agotamientos del tiempo de espera y conexiones interrumpidas, lo que equivale aproximadamente a tres horas de espera, y elimina el límite de 15 en CLAUDE_CODE_MAX_RETRIES si estableces esa variable explícitamente. Requiere Claude Code v2.1.186 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 línea de estado y de sugerencia de archivos, servidores LSP y 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 hijo 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 se establece CLAUDE_CODE_SUBPROCESS_ENV_SCRUB. 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. No se detecta la multiplicación en tiempo de ejecución mediante xargs o find -exec; este es un control de defensa en profundidad
CLAUDE_CODE_SCROLL_SPEED Establece el multiplicador de desplazamiento de la rueda del mouse en la representación en pantalla completa. Acepta cualquier valor positivo hasta 20, incluidos valores fraccionarios menores que 1, como 0.5, para ralentizar el desplazamiento acelerado del trackpad y de 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 conceder 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 de 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 los comandos de hooks y en los subprocesos de los servidores MCP stdio. Para Bash, PowerShell y hooks, coincide con el campo session_id de la entrada JSON del hook 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 con --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 usa Claude Code para ejecutar los comandos de la herramienta Bash. Acepta una ruta a un binario bash o zsh, por ejemplo /opt/homebrew/bin/bash. No se admiten otros shells como fish. Si el valor no es una ruta de bash o zsh que funcione, 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 el primer bash que funcionen y 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 arma 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, memoria automática y CLAUDE.md. Los skills de un directorio que pases con --add-dir siguen cargándose. No se leen los tokens de OAuth ni las credenciales del llavero, 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 Establécela en 1 para usar un prompt del sistema más corto y descripciones de herramientas abreviadas en cualquier modelo. Establécela en 0, false, no u off para desactivarlo incluso en modelos en los que el experimento o la configuración del servidor lo habilitarían de otro modo. El conjunto completo de herramientas, los hooks, los servidores MCP y el descubrimiento de CLAUDE.md siguen habilitados
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, cuando usas un gateway de LLM)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS Establécela en 1 para tratar como disponible una comprobación fallida de disponibilidad del modo rápido, para redes que bloquean la solicitud directa de la comprobación a api.anthropic.com. Claude Code sigue respetando una respuesta "disabled by your organization"
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK Establécela en 1 para omitir la comprobación de disponibilidad del modo rápido del lado del cliente, 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 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, cuando usas 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 detectaron que tu cuenta no puede invocar, durante un máximo de un día. Establécela en 1 para desactivar esa memoria. 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, en --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, cuando usas 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 iniciarse 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 el turno termine 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 los equipos de agentes y los agentes de flujos de trabajo a los que no se les asigna un modelo de otra forma. Acepta un alias como haiku o un nombre de modelo completo. Dos fuentes tienen precedencia sobre ella: un modelo que Claude pasa al generar 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 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 en un 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 para las solicitudes fuera de la conversación principal, como subagentes, flujos de trabajo y 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 en 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 comandos de Bash, hooks y servidores MCP stdio. La limpieza reconoce una credencial por el nombre de su variable o por su valor, y deja intactos los tokens de GitHub y los ajustes de 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. No tiene valor predeterminado: sin esta variable, la instalación síncrona espera hasta completarse
CLAUDE_CODE_SYNC_SKILLS Establécela en 1 en modo no interactivo con el flag -p para que Claude Code descargue los skills habilitados para tu cuenta de claude.ai en esa ejecución y espere la lista de ellos, hasta CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS, antes de ejecutar la primera consulta. Las descargas en sí terminan en segundo plano, y Claude espera la descarga de un skill cuando invoca ese skill. Requiere autenticación de claude.ai. Las sesiones de terminal en las que inicias sesión con tu cuenta de claude.ai descargan estos skills en ~/.claude/skills/synced/ y vuelven a sincronizarlos aproximadamente cada 10 minutos sin esta variable, así que establécela solo cuando una ejecución con -p necesite tus skills actuales en su primera consulta. Antes de v2.1.273, las sesiones de terminal los descargaban solo en una ejecución con -p con esta variable establecida. El nombre de carpeta synced está reservado para esta descarga. Antes de v2.1.227, los skills se descargaban directamente en ~/.claude/skills/. Claude Code aplica reglas adicionales a los skills descargados, como no ejecutar sus comandos ! en tu máquina
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS Tiempo de espera en milisegundos para la resincronización de skills que se ejecuta a mitad de la sesión cuando una app 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 se establece CLAUDE_CODE_SYNC_SKILLS (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 bloques de código y 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 coordinarlas en una lista de tareas compartida, en sesiones que tienen las herramientas Task. Consulta Lista de tareas
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS Sobrescribe, en milisegundos, cuánto tiempo espera una sesión no interactiva al salir a que su equipo de agentes termine de desmontarse. Acepta de 1000 a 60000; un valor fuera de rango se ignora y se aplica el predeterminado de 10000. Requiere Claude Code v2.1.206 o posterior
CLAUDE_CODE_TMPDIR 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 dentro del 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% si no has establecido una. Los propios archivos temporales 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 truecolor de 24 bits dentro de tmux. Establecerla en 0 o false sigue permitiendo truecolor, 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 truecolor a menos que esté configurado para hacerlo. Establécela después de agregar set -ga terminal-overrides ',*:Tc' a tu ~/.tmux.conf. Consulta Configuración de la terminal para conocer 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 dentro del límite independientemente de lo que enumeres. 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 v2.1.246 o posterior. Escribe el tamaño en dígitos simples, solos para indicar 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. Reanudar la sesión restaura la misma conversación tanto si el archivo se recortó como si no. 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 la sesión en una sesión que puede estar ejecutándose sin supervisión. Controlar los mensajes entrantes y Sesiones no interactivas cubren las reglas completas de vencimiento de los mensajes retenidos, incluidos los casos en los que el plazo no se aplica. Sobrescribe el ajuste dialogExpiry. 0 o un valor negativo deshabilita el plazo
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_NATIVE_FILE_SEARCH Establécela en 1 para descubrir comandos personalizados, subagentes y estilos de salida mediante las API de archivos de Node.js en lugar de ripgrep. Establécela si el binario de ripgrep incluido no está disponible o está bloqueado en tu entorno. No afecta a Grep ni a las herramientas de búsqueda de archivos
CLAUDE_CODE_USE_POWERSHELL_TOOL Controla la herramienta PowerShell. En Windows sin Git Bash, la herramienta se habilita automáticamente; establécela 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écela en 1 para habilitarla en las sesiones de Amazon Bedrock, Google Cloud's Agent Platform y Microsoft Foundry, o en 0 para desactivarla. En Linux, macOS y WSL, establécela 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 enrutarlos a través de Git Bash. Consulta Herramienta PowerShell
CLAUDE_CODE_USE_VERTEX Usa Google Cloud's Agent Platform
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS Establécela en la cantidad de milisegundos 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, así 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 del tiempo que WebFetch espera 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 límite. El valor predeterminado es 300000, que equivale a cinco minutos. Establécela 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_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 establecido. 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 del tiempo que un agente de flujo de trabajo espera a que comience la primera respuesta de un agente hermano con el mismo prefijo antes de enviar su propia primera solicitud. Cuando un 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é. Predeterminado: 5000. Establécela 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_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é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_DISABLE_ADOPT Establécela en 1 para detener el trabajo en segundo plano en curso en lugar de trasladarlo cuando envías una sesión a segundo plano presionando ← o con /background. Claude Code te pide confirmación antes de enviarla a segundo plano y luego detiene las tareas que de otro modo se trasladarían. Requiere Claude Code v2.1.195 o posterior
CLAUDE_EFFORT Se establece automáticamente en los subprocesos de la herramienta Bash y en los comandos de hooks con el 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écela en 1 para forzar la activación del watchdog de inactividad de streaming a nivel de bytes, o en 0 para forzar su desactivación. 0 también desactiva el plazo del primer byte en las conexiones donde se aplica ese plazo. Cuando no está establecida, el watchdog está activado 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 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écela en 1 para activar el watchdog de inactividad de streaming a nivel de bytes en las respuestas vnd.amazon.eventstream de Amazon Bedrock, lo que también activa 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écela en 0 para forzar la desactivación del watchdog de inactividad de streaming a nivel de eventos, o en 1 para forzar su activació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 otros proveedores. Configura el tiempo de espera con CLAUDE_STREAM_IDLE_TIMEOUT_MS; para los otros temporizadores de bloqueo que se ejecutan junto a 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 Bash en el mismo proceso de shell, de modo que las exportaciones del archivo sean visibles para el comando. Úsala para mantener la activación de virtualenv o conda entre comandos. 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 allí no solicitan permiso, y el directorio se elimina cuando se borra 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 o enviar señales deliberadamente al proceso principal de Claude Code. 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 aplica el plazo del primer byte. Para saber cómo lo limita Claude Code, el tiempo adicional que agrega para cuerpos de solicitud grandes y cómo elige el plazo cuando no la estableces, 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 prolongadas de pensamiento 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 de cada watchdog cuando no está establecida, consulta Watchdogs de inactividad de streaming
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS Se eliminó en v2.1.260 y ahora no tiene efecto. Anteriormente limitaba cuánto tiempo podía ejecutarse, en milisegundos, un comando de shell en segundo plano iniciado por un subagente, con un valor predeterminado de 60 minutos. Consulta las reglas de duración de los comandos en segundo plano
DEBUG Establécela en 1 para activar 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 activan 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écela en 1 para desactivar las actualizaciones automáticas en segundo plano. El claude update manual sigue funcionando. Usa DISABLE_UPDATES para bloquear ambos
DISABLE_AUTO_COMPACT Establécela en 1 para desactivar la compactación automática al acercarse al límite de contexto. 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écela en 1 para desactivar toda la compactación: tanto la compactación automática como el comando manual /compact
DISABLE_COST_WARNINGS Establécela en 1 para desactivar los mensajes de advertencia de costos
DISABLE_DOCTOR_COMMAND Establécela en 1 para ocultar el skill de revisión de la configuración /doctor y su alias /checkup. Útil para despliegues administrados donde los usuarios no deben 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 la pantalla de diagnóstico /doctor
DISABLE_ERROR_REPORTING Establécela en cualquier valor no vacío, como 1, para excluirte del informe de errores. Establecerla 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 el informe de errores
DISABLE_EXTRA_USAGE_COMMAND Establécela 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écela en 1 para desactivar el comando /feedback y los comentarios redactados por Claude. También desactiva /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 se desactivaba con cualquiera de sus nombres. También se acepta el nombre anterior DISABLE_BUG_COMMAND
DISABLE_GROWTHBOOK Establécela en 1 o true para desactivar la obtención de feature flags de GrowthBook y usar los valores predeterminados del código para cada flag. Esto hace que Remote Control y las demás funciones que necesitan la obtención de feature flags no estén disponibles. Establecerla en 0 o false mantiene la obtención activada. El registro de eventos de telemetría permanece activado a menos que también se establezca DISABLE_TELEMETRY
DISABLE_INSTALLATION_CHECKS Establécela en 1 para desactivar las advertencias de instalación. Úsala solo cuando administres manualmente la ubicación de instalación, ya que esto puede ocultar problemas con las instalaciones estándar
DISABLE_INSTALL_GITHUB_APP_COMMAND Establécela en 1 para ocultar el comando /install-github-app. Ya está oculto cuando usas proveedores de terceros (Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry)
DISABLE_INTERLEAVED_THINKING Establécela en 1 para evitar enviar el encabezado beta de pensamiento intercalado. Útil cuando tu gateway de LLM o tu proveedor no admite el pensamiento intercalado
DISABLE_LOGIN_COMMAND Establécela 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écela en 1 para ocultar el comando /logout
DISABLE_PROMPT_CACHING Establécela en 1 para desactivar la caché de prompts para todos los modelos (tiene precedencia sobre la configuración por modelo)
DISABLE_PROMPT_CACHING_FABLE Establécela en 1 para desactivar la caché de prompts para los modelos Fable
DISABLE_PROMPT_CACHING_HAIKU Establécela en 1 para desactivar la caché de prompts para el modelo Haiku predeterminado, dondequiera que se ejecute
DISABLE_PROMPT_CACHING_OPUS Establécela en 1 para desactivar la caché de prompts para el modelo Opus predeterminado
DISABLE_PROMPT_CACHING_SONNET Establécela en 1 para desactivar la caché de prompts para el modelo Sonnet predeterminado
DISABLE_TELEMETRY Establécela en cualquier valor no vacío, como 1, para excluirte de la telemetría. Establecerla 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 o comandos Bash. También desactiva la obtención de feature flags. Consulta Desactivar la telemetría para tu organización
DISABLE_UPDATES Establécela en 1 para bloquear todas las actualizaciones, incluidos los comandos manuales claude update y claude install. Más estricta que DISABLE_AUTOUPDATER. Úsala cuando distribuyas Claude Code a través de tus propios canales y los usuarios no deban actualizarlo por su cuenta
DISABLE_UPGRADE_COMMAND Establécela en 1 para ocultar el comando /upgrade
DO_NOT_TRACK Establécela en 1 para excluirte de la telemetría, con el mismo efecto que DISABLE_TELEMETRY, incluso sobre la obtención de feature flags. Claude Code lee esta variable como un booleano estándar, por lo que 0 deja la telemetría activada, y la respeta como la convención entre herramientas reconocida por muchas CLI para desarrolladores
ENABLE_BETA_TRACING_DETAILED Establécela en 1, junto con BETA_TRACING_ENDPOINT, para activar el rastreo beta detallado, que agrega 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 para la beta. Ambas variables se ignoran en la configuración de proyecto y local
ENABLE_CLAUDEAI_MCP_SERVERS Establécela en false para impedir que Claude Code obtenga los servidores MCP de claude.ai. Activada de forma predeterminada para los usuarios con sesión iniciada. Para desactivarlo 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, Agent Platform de Google Cloud, Microsoft Foundry y Claude Platform on AWS. Los usuarios de suscripción dentro del uso incluido reciben automáticamente el TTL de 1 hora en la conversación principal. Los usuarios de 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 grupo de solicitudes en su lugar, 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
ENABLE_TOOL_SEARCH Controla la búsqueda de herramientas MCP. Si no está establecida, Claude Code difiere todas las herramientas MCP de forma predeterminada. Aun así, las carga por adelantado en los modelos de Agent Platform de Google Cloud anteriores a la generación Claude 4.5, en un despliegue de Microsoft Foundry alojado en Azure y cuando ANTHROPIC_BASE_URL apunta a un host que no es de primera parte. true siempre difiere y envía el encabezado beta, excepto en esos mismos modelos de Agent Platform y despliegues de Microsoft Foundry; las solicitudes fallan en los proxies que no admiten tool_reference. auto carga por adelantado cuando las definiciones de herramientas caben dentro del 10% del contexto. auto:N establece un umbral personalizado, como auto:5 para el 5%. false carga todas las herramientas por adelantado. Un valor que establezcas tú mismo se ignora cuando CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS está establecida. Antes de v2.1.221, Claude Code desactivaba la búsqueda de herramientas para todos los modelos en Agent Platform de Google Cloud a menos que establecieras esta variable en true
FALLBACK_FOR_ALL_PRIMARY_MODELS Establécela en cualquier valor no vacío, como 1, para que Claude Code deje de reintentar ante errores de sobrecarga repetidos para todos los modelos cuando no hay ningún modelo de respaldo configurado. Establecerla en 0 o false también lo activa, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para restaurar el comportamiento de reintento predeterminado. Sin ella, Claude Code deja de reintentar de esta forma en los modelos que reconoce como modelos Opus, Fable o Mythos cuando te autenticas con una clave de API o un proveedor de terceros en lugar de una suscripción a Claude. En Claude Code v2.1.160 o posterior, Claude Code cambia a tu cadena de modelos de respaldo configurada ante errores de sobrecarga repetidos para cualquier modelo principal, por lo que esta variable no afecta el cambio a un modelo de respaldo
FORCE_AUTOUPDATE_PLUGINS Establécela en 1 para forzar las actualizaciones automáticas de plugins incluso cuando el actualizador automático principal está desactivado mediante DISABLE_AUTOUPDATER
FORCE_HYPERLINK Establécela en 1 para activar los hipervínculos OSC 8 en los que se puede hacer clic cuando tu terminal los admite pero no se detecta automáticamente, o en 0 para desactivarlos. Cuando no está establecida, Claude Code activa los hipervínculos solo cuando detecta compatibilidad en la terminal. Claude Code interpreta este valor como un número, no como un booleano, por lo que un valor como false, no u off activa los hipervínculos en lugar de desactivarlos. La insignia de PR o merge request del pie de página se muestra como hipervínculo incluso cuando Claude Code no puede detectar la compatibilidad de la terminal, como a través de SSH. Establece 0 para mostrar la insignia como texto sin formato
FORCE_PROMPT_CACHING_5M Establécela 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écela en cualquier valor no vacío, como 1, para activar 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. Establecerla en 0 o false también activa 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 en streaming o grabar una sesión
MAX_MCP_OUTPUT_TOKENS Cantidad máxima de tokens permitida en las respuestas de herramientas MCP. 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 imágenes de esas herramientas sigue sujeto a esta variable (predeterminado: 25000)
MAX_STRUCTURED_OUTPUT_RETRIES Cantidad de intentos que Claude Code permite cuando la respuesta del modelo no supera la validación contra el --json-schema en modo no interactivo con el flag -p; después de esa cantidad de intentos fallidos sin una 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 saber cómo se establece ese límite. Cuando no está establecida y el pensamiento está activado, los modelos con razonamiento adaptativo eligen su propia profundidad de pensamiento, y los demás modelos usan el límite. Establécela en 0 para desactivar el pensamiento en la API de Anthropic, excepto en Opus 5.5, Sonnet 5.5 y los modelos Fable, en los que no se puede desactivar el pensamiento. En proveedores de terceros, 0 omite el parámetro thinking en su lugar. Con el pensamiento desactivado en la API de Anthropic, Claude Code envía 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écela 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 que el inicio espere 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 conocer la excepción de los servidores en caché
MCP_CONNECT_TIMEOUT_MS Cuánto tiempo espera, en milisegundos, el inicio bloqueante de MCP 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 llegar el plazo continúan conectándose en segundo plano. Es 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 iniciar. La caché está desactivada de forma predeterminada a menos que un despliegue gradual la haya activado para tu cuenta. Establécela en 1 para activarla, o en 0 para mantenerla desactivada incluso cuando el despliegue la haya activado. 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 iniciar, 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, en su lugar, conecte el servidor en el siguiente inicio (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 aún la usa, pero la actualiza en segundo plano. Una vez que la entrada es más antigua que MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code la descarta en su lugar. Claude Code limita el valor a MCP_DISCOVERY_CACHE_MAX_STALE_S, que es 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 entorno de ejecución del cliente MCP v2, indica si Claude Code sondea los servidores para la revisión 2026-07-28 del protocolo MCP. Establece auto para sondear los servidores HTTP, de conector de claude.ai y stdio, o legacy para no sondear ninguno. Con la variable sin establecer, Claude Code sondea los servidores descritos en Entornos de ejecución del cliente MCP. 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 Cantidad máxima 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 del 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 por 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 Cantidad máxima 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, cada solicitud también agota su tiempo de espera después de 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 de inactividad mínima 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 se enviarán las solicitudes 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 atributos. Claude Code limita los atributos de telemetría con contenido al menor entre este valor y CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, para que el marcador de truncamiento se mantenga 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écela en 1 para incluir el texto de respuesta del modelo en los eventos de registro de OpenTelemetry assistant_response. Cuando no está establecida, Claude Code usa el valor de OTEL_LOG_USER_PROMPTS en su lugar. Establécela en 0 para mantener las respuestas censuradas incluso cuando OTEL_LOG_USER_PROMPTS está establecida. 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. Requiere Claude Code v2.1.193 o posterior. Consulta Monitoreo
OTEL_LOG_MANAGED_SETTINGS Establécela en 1 para agregar la configuración administrada censurada, y un resumen SHA-256 de la configuración antes de la censura, a los eventos de registro de OpenTelemetry managed_settings_resolved. Desactivada de forma predeterminada. Establécela 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 la activa. Requiere Claude Code v2.1.274 o posterior. Consulta Monitoreo
OTEL_LOG_RAW_API_BODIES Emite el JSON de solicitudes y respuestas de la Messages API de Anthropic como eventos de registro api_request_body / api_response_body. Establécela en 1 para 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. Desactivada de forma predeterminada; los cuerpos incluyen todo el historial de la conversación. 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
OTEL_LOG_TOOL_CONTENT Establécela en 1 para incluir el contenido de las herramientas en el evento de span de OpenTelemetry tool.output. Los atributos de span llevan el contenido de las herramientas bajo sus propias condiciones. Requiere rastreo. Desactivada de forma predeterminada para proteger datos confidenciales. 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, salvo los valores de desactivación que describe esa sección. Consulta Monitoreo
OTEL_LOG_TOOL_DETAILS Establécela en 1 para incluir los argumentos de entrada de las herramientas; los nombres de servidores MCP; los nombres de flujos de trabajo creados por el usuario; las cadenas de error sin procesar en los fallos de herramientas; la category de 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 herramientas en las métricas, trazas y registros de OpenTelemetry. Desactivada de forma predeterminada para proteger la PII. 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, salvo los valores de desactivación que describe esa sección. Consulta Monitoreo
OTEL_LOG_USER_PROMPTS Establécela en 1 para incluir el texto de los prompts del usuario en las trazas y registros de OpenTelemetry. Desactivada de forma predeterminada (los prompts se censuran). 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, 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 (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 (predeterminado: excluido). Agregada en v2.1.152. Consulta Monitoreo
OTEL_METRICS_INCLUDE_REPOSITORY Establécela en true para etiquetar las métricas y eventos de OpenTelemetry con atributos vcs.* que identifican el repositorio de la sesión (predeterminado: excluido). Requiere Claude Code v2.1.269 o posterior. 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 métricas. Establécela 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 (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 (predeterminado: excluida). Consulta Monitoreo
SLASH_COMMAND_TOOL_CHAR_BUDGET Sobrescribe el presupuesto de caracteres para los metadatos de 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 mantiene por compatibilidad con versiones anteriores
TASK_MAX_OUTPUT_LENGTH Se eliminó en v2.1.277 y ahora no tiene efecto, junto con la herramienta TaskOutput cuyo tamaño definía. Anteriormente establecía la cantidad máxima de caracteres de la salida de una tarea en segundo plano que conservaba la herramienta TaskOutput. Claude lee el archivo de salida de una tarea en segundo plano con Read en su lugar
USE_BUILTIN_RIPGREP Establécela 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 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_3_5_SONNET Sobrescribe la región de Claude 3.5 Sonnet al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_3_7_SONNET Sobrescribe la región de Claude 3.7 Sonnet al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_0_OPUS Sobrescribe la región de Claude 4.0 Opus al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_0_SONNET Sobrescribe la región de Claude 4.0 Sonnet al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_1_OPUS Sobrescribe la región de Claude 4.1 Opus al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_5_OPUS Sobrescribe la región de Claude Opus 4.5 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_5_SONNET Sobrescribe la región de Claude Sonnet 4.5 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_6_OPUS Sobrescribe la región de Claude Opus 4.6 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_6_SONNET Sobrescribe la región de Claude Sonnet 4.6 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_7_OPUS Sobrescribe la región de Claude Opus 4.7 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_8_OPUS Sobrescribe la región de Claude Opus 4.8 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_5_5_OPUS Sobrescribe la región de Claude Opus 5.5 al usar Agent Platform de Google Cloud. Agregada en v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Sobrescribe la región de Claude Sonnet 5.5 al usar Agent Platform de Google Cloud. Agregada en v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Sobrescribe la región de Claude Opus 5 al usar Agent Platform de Google Cloud. Agregada en v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Sobrescribe la región de Claude Sonnet 5 al usar Agent Platform de Google Cloud. Agregada en v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Sobrescribe la región de Claude Fable 5 al usar Agent Platform de Google Cloud. Agregada en v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Sobrescribe la región de Claude Fable 5.1 al usar Agent Platform de Google Cloud. Agregada en v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Sobrescribe la región de Claude Haiku 4.5 al usar Agent Platform de Google Cloud

También se admiten las variables estándar de 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 conocer 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 mediante la expansión del shell. 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. Requiere Claude Code v2.1.251 o posterior
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.

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 DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; la fila de cada variable en la tabla de variables indica qué valores desactivan la obtención
  • Una sesión en un proveedor 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:

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. Esa sesión también puede iniciarse en un modo de permisos distinto al de tus sesiones posteriores. Cuando Claude Code obtiene los 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 y el modo de permisos inicial habitual.

Después de una instalación nueva, en una sesión no interactiva como claude -p, el Agent SDK o la extensión de VS Code, Claude Code puede obtener los flags antes de elegir el modo de permisos inicial, pero no siempre los espera.

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

Para elegir el modo de permisos en el que se inician las sesiones en estas configuraciones, consulta Iniciar en un modo de permisos diferente.

Véase también