SpyBara
Go Premium

env-vars.md 2026-10-02 22:59 UTC to 2026-10-03 04:00 UTC

This page contains 382 additions and 380 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 04: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 separador de dígitos además de dígitos simples, excepto cuando la fila de una variable indica que solo acepta dígitos simples. Por ejemplo, Claude Code lee 2e3 como 2000 y 64_000 como 64000. Antes de v2.1.211, estas 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 está establecida, 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 que apruebes la clave una vez antes de que sobrescriba tu suscripción. Para usar tu suscripción en su lugar, ejecuta unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN Valor personalizado para el encabezado Authorization (el valor que establezcas aquí tendrá el prefijo Bearer )
ANTHROPIC_AWS_API_KEY Clave de API del espacio de trabajo para Claude Platform on AWS, generada en la consola de AWS. Se envía como x-api-key y tiene precedencia sobre AWS SigV4
ANTHROPIC_AWS_BASE_URL 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 está desactivado de forma predeterminada. Establece ENABLE_TOOL_SEARCH=true si tu proxy reenvía bloques tool_reference. A partir de v2.1.196, Remote Control se desactiva cuando esta variable apunta a un host distinto de api.anthropic.com, igual que su comportamiento en Amazon Bedrock, Agent Platform de Google Cloud 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 para incluir en las solicitudes a la API. Claude Code ya envía los encabezados beta que necesita; usa esta variable para participar en una beta de la API de Anthropic antes de que Claude Code agregue soporte nativo. A diferencia del flag --betas, que requiere autenticación con clave de API, esta variable funciona con todos los métodos de autenticación, incluida la suscripción de Claude.ai
ANTHROPIC_CUSTOM_HEADERS Encabezados personalizados para agregar a las solicitudes (formato Name: Value, separados por saltos de línea para varios encabezados). Si un nombre o valor contiene un carácter que un encabezado HTTP no puede llevar, 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 necesita aprobación cuando lo entrega la configuración administrada por el servidor. Desde la configuración del proyecto o local, un valor así sigue las reglas sobre cuándo se aplican los valores de env
ANTHROPIC_CUSTOM_MODEL_OPTION ID de modelo para agregar como entrada personalizada en el selector /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 para mostrar de la entrada de modelo personalizado en el selector /model. Si no se establece, el valor predeterminado es Custom model (<model-id>)
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Nombre para mostrar de la entrada de modelo personalizado en el selector /model. Si 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 de terceros. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Descripción para mostrar del modelo Fable fijado en el selector /model. Si no se establece, la fila muestra una descripción predeterminada que comienza con Custom Fable model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Nombre para mostrar del modelo Fable fijado en el selector /model. Si 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 para mostrar del modelo Haiku fijado en el selector /model. Si no se establece, la fila muestra una descripción predeterminada que comienza con Custom Haiku model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Nombre para mostrar del modelo Haiku fijado en el selector /model. Si 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 comienzan las sesiones nuevas de forma predeterminada. 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 para mostrar del modelo Opus fijado en el selector /model. Si no se establece, la fila muestra una descripción predeterminada que comienza con Custom Opus model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Nombre para mostrar del modelo Opus fijado en el selector /model. Si 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 para mostrar del modelo Sonnet fijado en el selector /model. Si no se establece, la fila muestra una descripción predeterminada que comienza con Custom Sonnet model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Nombre para mostrar del modelo Sonnet fijado en el selector /model. Si 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 una clave de API. Consulta precedencia de autenticación
ANTHROPIC_SMALL_FAST_MODEL [OBSOLETO] Nombre del modelo de clase Haiku para tareas en segundo plano
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Sobrescribe la región de AWS para el modelo de clase Haiku al usar Amazon Bedrock o Amazon Bedrock Mantle. En Amazon Bedrock, esto solo surte efecto cuando también está establecida 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 Agent Platform de Google Cloud. Úsala para endpoints personalizados de Agent Platform de Google Cloud o al enrutar a través de un gateway de LLM. Consulta Agent Platform de Google Cloud
ANTHROPIC_VERTEX_PROJECT_ID ID del proyecto de GCP al que se dirigen las solicitudes de Agent Platform de Google Cloud. Consulta Configurar las credenciales de GCP
ANTHROPIC_WORKSPACE_ID ID del espacio de trabajo para workload identity federation. Establécela cuando tu regla de federación abarque más de un espacio de trabajo, para que el intercambio de tokens sepa a qué espacio de trabajo dirigirse
API_FORCE_IDLE_TIMEOUT Sobrescribe el tiempo de espera de inactividad del cuerpo de 5 minutos que interrumpe una respuesta del modelo en streaming cuando no llegan bytes. Establécela en 0 para desactivar el tiempo de espera, por ejemplo cuando un gateway lento o un modelo local hace pausas de más de 5 minutos entre fragmentos, o en 1 para mantenerlo activo con todos los proveedores. Si no 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 establecida. Los watchdogs de streaming se ejecutan de forma independiente y interrumpen 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 superiores al 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 de la herramienta Bash o PowerShell en primer plano, 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 salida de bash que Claude Code vuelve a leer 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 de la herramienta Bash o PowerShell en primer plano, 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 tracing beta detallado: con ENABLE_BETA_TRACING_DETAILED=1, los registros y las trazas van 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 Establécela en 1 para forzar que claude --cloud empaquete y suba tu repositorio local en lugar de clonarlo desde su remoto
CLAUDECODE Se establece en 1 en los subprocesos que Claude Code genera (herramientas Bash y PowerShell, sesiones de tmux, comandos de hook, 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 cuadro de diálogo de AskUserQuestion sin responder. Predeterminado 20000 (20 segundos), con un límite igual 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 transcurren antes de que un cuadro de diálogo de 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 está establecida, 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 cuadro de 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 Establécela en 1 para desactivar todos los tipos de subagentes integrados, como Explore y Plan. Solo se aplica en modo no interactivo (el flag -p). Útil para usuarios del SDK que quieren empezar desde cero. Esto también elimina general-purpose, el subagente que Claude Code ejecuta cuando una llamada a la herramienta Agent omite subagent_type. Una llamada así falla entonces con subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIX Establécela en 1 para omitir el prefijo mcp__<server>__ en los nombres de herramientas de 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 streaming está activado, el valor predeterminado aumenta con él, como se describe en Manejar respuestas de API lentas o bloqueadas. El temporizador se reinicia con cada evento de progreso del streaming; si no llega progreso dentro del intervalo, Claude Code interrumpe 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 superiores al porcentaje predeterminado. Solo se aplica en sesiones que compactan antes del límite de contexto del modelo. Se aplica tanto a las conversaciones principales como a los subagentes
CLAUDE_AUTO_BACKGROUND_TASKS Establécela en 1 para forzar la activación del envío automático a segundo plano de tareas de agente de larga duración. Cuando está activada, 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 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 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 Establécela en 1 para renderizar una salida adecuada para lectores de pantalla: texto plano sin bordes decorativos ni animaciones. Establécela en 0 para forzar la desactivación del modo de lector de pantalla incluso cuando axScreenReader es true. El flag --ax-screen-reader tiene precedencia. 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 la interrumpa nueva salida. Predeterminado 3000. Establece 0 para renderizar de inmediato. Claude Code limita la retención a 600000 (10 minutos). Tu primera pulsación de tecla termina la retención antes de tiempo. Requiere Claude Code v2.1.217 o posterior
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR Vuelve al directorio de trabajo original después de cada comando de Bash o PowerShell en la sesión principal
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS Tiempo de espera en milisegundos para el watchdog de inactividad de streaming a nivel de bytes; cuando está establecida, tiene precedencia sobre CLAUDE_STREAM_IDLE_TIMEOUT_MS para ese watchdog y deja sin cambios el watchdog a nivel de eventos. Claude Code limita esta variable a un valor entre 10 segundos y 30 minutos. Requiere Claude Code v2.1.210 o posterior
CLAUDE_CLIENT_PRESENCE_FILE Ruta a un archivo que una herramienta externa, como un listener de bloqueo de pantalla, crea cuando desbloqueas la pantalla y elimina cuando la bloqueas. Mientras el archivo existe, Claude Code omite las notificaciones push móviles de Remote Control, para que dejes de recibir notificaciones 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 activa una notificación push en lugar de sondearlo. Requiere Claude Code v2.1.181 o posterior
CLAUDE_CODE_ACCESSIBILITY Establécela en 1 para mantener visible el cursor nativo de la terminal y desactivar el indicador de cursor 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 Establécela 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 Establécela en 1 para volver a pintar 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 la activa automáticamente para las sesiones en segundo plano y la vista de agentes en Windows
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT Establécela en 1 para enviar el parámetro de esfuerzo con cada solicitud, incluso cuando Claude Code no reconoce el ID del modelo como compatible con esfuerzo. Úsala al enrutar a través de un gateway de LLM o un proveedor de terceros que sirve modelos con identificadores personalizados. Los modelos que rechazan el parámetro de esfuerzo en la API, incluidos 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 en el que se deben actualizar las credenciales (al usar apiKeyHelper)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN Establécela en 0 para evitar que Claude Code abra el navegador automáticamente cuando se publica un nuevo artefacto
CLAUDE_CODE_ARTIFACT_COMMENTS Establécela en 0 para que Claude deje de leer y responder 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 Establécela en 0 para que Claude deje de responder por su cuenta a los comentarios que se le envían. Requiere Claude Code v2.1.228 o posterior
CLAUDE_CODE_ATTRIBUTION_HEADER Establécela en 0 para omitir el bloque de atribución, que contiene la versión del cliente y una huella del prompt, del inicio del prompt del sistema. El almacenamiento en caché en una conexión directa a la API de Anthropic no se ve afectado en ningún caso. En algunas configuraciones de conexión directa, Claude Code mantiene el bloque en las solicitudes del clasificador del modo automático incluso cuando estableces 0. En Bloque de atribución del prompt del sistema, comprueba qué conexiones y credenciales abarca esto. Antes de v2.1.181, el bloque incluía un token por solicitud en URLs base personalizadas y 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 de terceros, o cuando te conectes directamente a Microsoft Foundry
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS Cuando CLAUDE_AUTO_BACKGROUND_TASKS está activada, segundos entre recordatorios a Claude para que revise los subagentes en segundo plano que todavía se están ejecutando. Solo acepta un entero simple de 1 a 86400; cualquier otro valor o escritura se lee como no establecida. Si no está establecida, no hay recordatorios de revisión. Requiere Claude Code v2.1.248 o posterior
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 al IDE. De forma predeterminada, Claude Code se conecta automáticamente cuando se inicia dentro de la terminal integrada de un IDE compatible. Establécela en false para evitarlo. Establécela en true para forzar un intento de conexión cuando falla la detección automática, por ejemplo cuando tmux oculta la terminal principal. Tiene precedencia sobre el ajuste de configuración global autoConnectIde
CLAUDE_CODE_AUTO_MODE_SERVER Controla si Claude Code pide al servidor que revise las acciones del modo automático. Establécela en 0 para usar en su lugar las propias solicitudes del 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 a partir de qué versión. Requiere Claude Code v2.1.271 o posterior
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS Tiempo en milisegundos que Claude Code espera a que la cadena de proveedores de credenciales predeterminada de AWS produzca credenciales antes de que la solicitud falle con AWS default-chain credential resolve timed out (predeterminado: 60000). 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 Establécela en 0 para desactivar el diff de los archivos que cambiaron mientras se ejecutaba un comando de Bash, o en 1 para registrarlo en todos los modos de permisos. Tiene precedencia sobre el ajuste bashEditDiffEnabled. Requiere Claude Code v2.1.269 o posterior
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING Establécela en 0 para que una sesión no interactiva informe un estado inactivo a su host al final de cada turno, incluso mientras todavía se ejecuta trabajo en segundo plano. 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 un flujo de trabajo, sigue activo. Esto evita que un host que observa 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 valor predeterminado del estado en ejecución 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 hook 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 en formato session_, el mismo identificador que aparece en la URL claude.ai/code de la sesión, para que un script pueda enlazar 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 Establécela 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 entornos de ejecución 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 hook 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 manera 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 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 de 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. Establécela en verbose para incluir diagnósticos de gran volumen, como la salida completa del comando de la línea de estado, o súbela a error para reducir el ruido
CLAUDE_CODE_DISABLE_1M_CONTEXT Establécela en 1 para desactivar la compatibilidad con la ventana de contexto de 1M. Cuando está establecida, 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 esa limitación. Útil para entornos empresariales con requisitos de cumplimiento. Para su función al corregir 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 Establécela en 1 para desactivar el razonamiento adaptativo en Opus 4.6 y Sonnet 4.6 y recurrir al presupuesto de pensamiento fijo controlado por MAX_THINKING_TOKENS. No tiene efecto en los modelos Fable, Sonnet 5 y posteriores, ni Opus 4.7 y posteriores, que siempre usan razonamiento adaptativo
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION Establécela en 1 para evitar que Claude Code combine por clave los bloques env de la configuración administrada entre fuentes de administración, de modo que solo se aplique el bloque env completo de la fuente de mayor prioridad, como antes de 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 Establécela 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 Establécela en 1 para desactivar los agentes en segundo plano y la vista de agentes: claude agents, --bg, /background y el supervisor bajo demanda. Equivale al ajuste disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Establécela en 1 para desactivar el renderizado 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 Establécela en 1 para desactivar la herramienta Artifact, que publica la salida de la sesión como una página web privada en claude.ai. Una vez establecida, ningún archivo de configuración vuelve a activar la herramienta. Para desactivar la herramienta desde un archivo de configuración, establece enableArtifact en false; la clave obsoleta disableArtifact también la desactiva
CLAUDE_CODE_DISABLE_ATTACHMENTS Establécela en 1 para desactivar el procesamiento de archivos adjuntos. Las menciones de archivos con la sintaxis @ se envían como texto plano en lugar de expandirse al contenido del archivo
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Establécela en 1 para que un proceso de Claude Code ejecute por sí mismo su comando gcpAuthRefresh o awsAuthRefresh en lugar de esperar mientras otro proceso lo ejecuta. Requiere Claude Code v2.1.286 o posterior
CLAUDE_CODE_DISABLE_AUTO_MEMORY Establécela en 1 para desactivar la memoria automática. Establécela en 0 para forzar la activación de la memoria automática incluso cuando el modo --bare o autoMemoryEnabled: false la desactivarían. Cuando está desactivada, Claude no crea ni carga archivos de memoria automática
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS Establécela en 1 para 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 Establécela 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 supone 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 vuelve a emitir el stream como server-sent events; Claude Code lee entonces el cuerpo sin encabezado como server-sent events. Requiere Claude Code v2.1.239 o posterior
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Establécela en 1 para omitir la comprobación de que una respuesta en streaming de Amazon Bedrock lleva el content-type application/vnd.amazon.eventstream. Sin esta variable, cuando una respuesta lleva un content-type distinto, Claude Code hace fallar la solicitud con un error que indica ese tipo, lo que significa que un gateway o proxy está transformando la respuesta. Configura el gateway para que reenvíe el encabezado Content-Type y el cuerpo sin modificar en lugar de establecer esta variable. Requiere Claude Code v2.1.208 o posterior
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF Establécela en 1 para detener los comandos de shell en segundo plano en ejecución, los flujos de trabajo dinámicos y, a partir de v2.1.198, los subagentes en segundo plano de una sesión 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 ambas cosas. Requiere Claude Code v2.1.196 o posterior
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Establécela en 1 para evitar que Claude Code termine los comandos de shell en segundo plano bajo presión de memoria. De forma predeterminada, en macOS y Linux, Claude Code termina los shells en segundo plano cuando el sistema operativo informa una presión de memoria crítica y la sesión ha estado inactiva durante 30 minutos sin ningún turno ni subagente en ejecución. Windows no tiene una 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 Establécela en 1 para desactivar los skills y flujos de trabajo incluidos con Claude Code: los skills y flujos de trabajo incluidos se eliminan por completo, mientras que los comandos integrados como /init se pueden seguir escribiendo pero 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 Establécela en 1 para mantener disponibles las herramientas de navegador de Claude in Chrome mientras se omiten la sección de Chrome del prompt del sistema y el skill incluido /claude-in-chrome. Para hosts que integran Claude Code y proporcionan su propia guía de navegador. Requiere Claude Code v2.1.257 o posterior
CLAUDE_CODE_DISABLE_CLAUDE_MDS Establécela en 1 para evitar que se cargue cualquier archivo de memoria CLAUDE.md en el contexto, incluidos los archivos de memoria de usuario, de proyecto y de memoria automática
CLAUDE_CODE_DISABLE_CRON Establécela en 1 para desactivar las tareas programadas. El skill /loop y las herramientas cron dejan de estar disponibles y cualquier tarea ya programada deja de dispararse, incluidas las tareas que ya se están ejecutando a mitad de la sesión
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT Establécela en 1 para desactivar el límite de tiempo en las solicitudes de permiso de eliminación de rutas críticas. En el modo auto, Claude Code envía entonces estas eliminaciones al clasificador, y en el 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 Establécela 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 las capacidades preliminares enumera lo que elimina la variable, incluido MCP Tool Search, y lo que Claude Code sigue enviando
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS Establécela en 1 para desactivar los subagentes Explore y Plan integrados. Claude explora con sus herramientas de búsqueda o con el subagente de propósito general en su lugar, y el modo plan lee los archivos directamente en lugar de lanzar los agentes Explore y Plan. Los subagentes personalizados llamados Explore o Plan no se ven afectados. Para eliminar todos los tipos de subagentes integrados en el Agent SDK o en modo no interactivo, usa CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS en su lugar. Requiere Claude Code v2.1.198 o posterior
CLAUDE_CODE_DISABLE_FAST_MODE Establécela en 1 para desactivar el modo rápido
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Establécela en 1 para desactivar las encuestas de calidad de sesión "How is Claude doing?". Las encuestas también se desactivan cuando DISABLE_TELEMETRY, DO_NOT_TRACK o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC están establecidas, 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 Establécela en 1 para desactivar el checkpointing de archivos. El comando /rewind no podrá restaurar los cambios de código. Sobrescribe el ajuste fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS Establécela 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 está establecida
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Establécela 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 intencionalmente un modelo anterior. La reasignación no se ejecuta en Amazon Bedrock, Agent Platform de Google Cloud ni Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Establécela en 1 para evitar que Claude Code en Amazon Bedrock y Agent Platform de Google Cloud 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 de modelo ante ese rechazo, y las comprobaciones de modelo al inicio siguen recurriendo a un modelo de respaldo al iniciar. Requiere Claude Code v2.1.285 o posterior
CLAUDE_CODE_DISABLE_MOUSE Establécela 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 Establécela en 1 para desactivar el manejo de clics, arrastre y paso del puntero 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 ni abran enlaces. CLAUDE_CODE_DISABLE_MOUSE tiene precedencia cuando ambas están establecidas. Requiere Claude Code v2.1.195 o posterior
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION Establécela en 1 para evitar que Claude Code vuelva a leer el certificado y la clave de cliente mTLS cuando una solicitud a la API falla con un error de 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 la próxima vez que aplica la configuración o en el siguiente inicio. Requiere Claude Code v2.1.232 o posterior
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Establécela en cualquier valor no vacío, como 1, para desactivar el tráfico de red no esencial: actualizaciones automáticas, telemetría, informes de errores, el comando /feedback, los comentarios redactados por Claude, las notas de la versión, las comprobaciones de la insignia de estado de PR y MR y las comprobaciones de disponibilidad, como la del modo rápido. También detiene las ejecuciones en segundo plano de 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/desactivación; quita la variable para volver a permitirlo. También desactiva la obtención de feature flags, lo que hace que Remote Control y las demás funciones que necesitan la obtención de feature flags no estén disponibles. La instalación automática del marketplace oficial de plugins no está incluida; desactívala con CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. No afecta al descubrimiento de modelos del gateway, que tiene su propia activación opcional
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Establécela 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 una ejecución duplicada de herramientas
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Establécela en 1 para enviar la notificación de escritorio de la herramienta PushNotification incluso mientras escribes en la terminal o esta tiene el foco. De forma predeterminada, la herramienta omite tanto la notificación de escritorio como la notificación push móvil cuando detecta actividad reciente del teclado o el foco en la terminal. Esta variable desactiva solo esa comprobación local, por lo que el servidor aún puede suprimir la notificación push móvil cuando detecta que estás activo. Requiere Claude Code v2.1.193 o posterior
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL Establécela en 1 para desactivar el registro automático del marketplace oficial de plugins. Claude Code lee la variable cuando está a punto de registrar el marketplace, normalmente durante el primer inicio interactivo en una máquina. Si la variable está establecida en ese momento, Claude Code omite el registro de forma permanente. Quitar la variable más adelante no deshace la omisión. Ejecuta claude plugin marketplace add anthropics/claude-plugins-official para registrar el marketplace en cualquier momento
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS Establécela en 1 para 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 la forma en que Claude Desktop y la extensión de VS Code alojan Claude Code. No tiene efecto en sesiones de terminal. Requiere Claude Code v2.1.233 o posterior
CLAUDE_CODE_DISABLE_POLICY_SKILLS Establécela en 1 para omitir la carga de skills desde el directorio de skills administrados de todo el sistema. Útil para sesiones de contenedor o de CI que no deben cargar skills aprovisionados por el operador
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY Establécela en 1 para desactivar la comprobación de la herramienta PowerShell que deniega los comandos integrados de cmd rd, rmdir, del y erase en una ruta del sistema, como la raíz de una unidad o tu directorio home. Claude Code ignora esta variable en el bloque env de un archivo de configuración. Requiere Claude Code v2.1.283 o posterior
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS Establécela en 1 para evitar que Claude Code envíe el campo de salida estructurada output_config.format y el valor anthropic-beta que lo acompaña, para un gateway de LLM cuyo servicio 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 Establécela 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 Establécela en 1 para desactivar las actualizaciones automáticas del título de la terminal basadas en el contexto de la conversación. Esto también omite la solicitud en segundo plano al modelo pequeño/rápido que genera un título de sesión
CLAUDE_CODE_DISABLE_THINKING Establécela en 1 para omitir por completo el parámetro thinking de las solicitudes a la API. Es una opción de compatibilidad para proxies y gateways que rechazan el parámetro. En los modelos que piensan de forma predeterminada, omitir el parámetro significa que el modelo 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 los modelos Fable, en los que no se puede desactivar el pensamiento. En proveedores de terceros, MAX_THINKING_TOKENS=0 también omite el parámetro, por lo que ambas variables se comportan igual allí
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT Establécela en 1 para omitir la compactación automática proactiva cuando Claude Code no reconoce el ID del modelo, como un alias de un gateway de LLM. Sin esta variable, Claude Code compacta según la ventana de contexto que asume para el ID. CLAUDE_CODE_MAX_CONTEXT_TOKENS puede corregir 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 Establécela en 1 para desactivar el desplazamiento virtual en el renderizado de pantalla completa y renderizar todos los mensajes de la transcripción. Úsala si al desplazarte en el modo de pantalla completa aparecen regiones en blanco donde deberían aparecer mensajes
CLAUDE_CODE_DISABLE_WEB_FETCH Establécela en 1 para desactivar la herramienta WebFetch. La herramienta WebSearch sigue disponible. Requiere Claude Code v2.1.285 o posterior
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER Establécela en 1 para iniciar los comandos de la herramienta PowerShell en Windows directamente en lugar de a través del lanzador cmd.exe. De forma predeterminada, el lanzador permite que un comando de PowerShell que se ejecuta en segundo plano pase al siguiente proceso de la sesión, por ejemplo 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 Establécela 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, Agent Platform de Google Cloud, Microsoft Foundry y las sesiones del Claude apps gateway con sesión iniciada. 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 de la opción de /config. Establécela en 1 para forzar la activación de los resúmenes cuando awaySummaryEnabled es false. Tiene precedencia sobre el ajuste y la opción 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 el 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ían datos de la encuesta a Anthropic. Se aplica cuando se establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY o DO_NOT_TRACK, y no tiene efecto en 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 colgó. Activada de forma predeterminada en la Anthropic API. En Amazon Bedrock y Google Cloud's Agent Platform, se activa por modelo cuando el contenedor implementado lo admite. Establécela en 0 para desactivarla. Establécela en 1 para forzar su activación cuando enrutas a través de un proxy mediante ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL o ANTHROPIC_BEDROCK_BASE_URL. Desactivada de forma predeterminada en Microsoft Foundry y en las conexiones de gateway
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Establécela en 1 para llenar el selector de /model desde el endpoint /v1/models de tu gateway cuando ANTHROPIC_BASE_URL apunta a un gateway compatible con Anthropic, como LiteLLM, Kong o un proxy interno. Desactivada de forma predeterminada porque, de lo contrario, los gateways respaldados por una clave de API compartida mostrarían a cada usuario todos los modelos a los que puede acceder la clave. Los modelos descubiertos se siguen filtrando según una lista de permitidos availableModels que reciba 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 tu entrada de prompt. Tiene precedencia sobre el ajuste promptSuggestionEnabled, que es lo que escribe el interruptor Prompt suggestions de /config. Claude Code también pausa las sugerencias cuando tu cuenta está cerca de su límite de uso o lo alcanzó. Establécela en true para mantenerlas activas 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. 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 en el shell y usaban la copia que hubiera heredado el proceso supervisor en segundo plano
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Sobrescribe el límite de tokens predeterminado para la lectura de archivos. Útil cuando necesitas leer archivos más grandes por completo
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Establécela en 1 para forzar la persistencia de transcripciones, 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 primero 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 tachada de ~~text~~ en las respuestas de Claude cuando tu terminal la admite pero no se detecta automáticamente, por ejemplo a través de SSH sin reenviar TERM_PROGRAM. Sin esto, las terminales no detectadas muestran los marcadores ~~ literales en lugar de mostrar el texto tachado. Requiere Claude Code v2.1.186 o posterior
CLAUDE_CODE_FORCE_SYNC_OUTPUT Establécela en 1 para forzar la activación de la salida sincronizada del modo privado DEC 2026 cuando tu terminal la admite pero no se detecta automáticamente. Útil para emuladores como eat de Emacs que implementan BSU/ESU pero no responden al sondeo de capacidades. No tiene efecto bajo tmux. A diferencia de CLAUDE_CODE_NO_FLICKER, que cambia a la representación en pantalla completa, esto no cambia el renderizador
CLAUDE_CODE_FORK_SUBAGENT Controla el modo fork, que permite a Claude generar por sí mismo subagentes bifurcados y está activado de forma predeterminada solo en las 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 los bloques de texto y de pensamiento de los subagentes en la salida de claude -p --output-format stream-json, el mismo comportamiento que el flag --forward-subagent-text. Usa la variable cuando un harness invoca claude y no puede pasar el flag por sí mismo. A diferencia del flag, que termina con un error fuera del modo no interactivo con salida stream-json, la variable se ignora 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 Anthropic API, 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 iniciar. 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 ni sh, Claude Code ignora la variable y detecta automáticamente Git Bash como si no estuviera establecida, y registra una advertencia visible con --debug. Antes de v2.1.219, Claude Code se cerraba al iniciar cuando la ruta no existía, y usaba cualquier archivo existente como shell sin comprobar que fuera bash o sh. Consulta Configuración en Windows
CLAUDE_CODE_GLOB_HIDDEN Establécela en false para excluir los dotfiles de los resultados cuando Claude invoca la herramienta Glob. Se incluyen de forma predeterminada. No afecta al autocompletado de archivos con @, a ls, a Grep ni a Read
CLAUDE_CODE_GLOB_NO_IGNORE Establécela en false para que la herramienta Glob respete los patrones de .gitignore. De forma predeterminada, Glob devuelve todos los archivos coincidentes, incluidos los ignorados por Git. No afecta al autocompletado de archivos con @, que tiene su propio ajuste respectGitignore
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Tiempo de espera en segundos para 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 es una semana. Claude Code trata cualquier otro valor como no establecido y usa el valor 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 logotipo de inicio. Útil al compartir pantalla o en grabaciones donde la ruta expone tu nombre de usuario del sistema operativo
CLAUDE_CODE_IDE_HOST_OVERRIDE Sobrescribe la dirección de 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 las 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 está en ejecución
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Cuántos subagentes pueden estar en ejecución en una sesión antes de que la herramienta Agent se niegue a generar otro (predeterminado: 20). Acepta un número entero positivo en dígitos simples; cualquier otra cosa se ignora, por lo que la variable puede ajustar el límite pero no desactivarlo. Requiere Claude Code v2.1.217 o posterior
CLAUDE_CODE_MAX_CONTEXT_TOKENS Sobrescribe el tamaño de la ventana de contexto que Claude Code supone para el modelo activo. A partir de v2.1.193, la forma en que 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 cuando enrutas 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 otra cosa se ignora y se aplica el valor 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 máximo de tokens de salida. Claude Code reduce al límite un valor que supere el límite de un modelo. Para un ID de modelo que Claude Code no puede resolver a un modelo que conoce, el valor predeterminado es 32000 y el límite es 128000. Aumentar este valor reduce la ventana de contexto efectiva disponible antes de que se active la compactación automática
CLAUDE_CODE_MAX_RETRIES Sobrescribe el número de veces que se reintentan las solicitudes a la API fallidas (predeterminado: 10). Limitado a 15 a partir de v2.1.186; a partir de v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG aumenta el valor predeterminado y elimina el límite. Para sesiones desatendidas que necesitan esperar durante interrupciones más largas, establece CLAUDE_CODE_RETRY_WATCHDOG en su lugar
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Eliminada en 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 se siguen aplicando
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 valor 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 valor predeterminado a 3. Acepta un número entero positivo en dígitos simples; cualquier otra cosa 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 sea un entero positivo se rechaza al iniciar 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 llamadas posteriores a WebSearch devuelven un aviso que le indica que continúe con la información que ya recopiló. Acepta un número entero positivo sin límite superior. Cualquier otra cosa se ignora y se aplica el valor predeterminado, por lo que el límite se puede aumentar pero no desactivar. Requiere Claude Code v2.1.212 o posterior
CLAUDE_CODE_MCP_ALLOWLIST_ENV Establécela en 1 para iniciar los servidores MCP stdio solo con un entorno base seguro más el env configurado del servidor, en lugar de heredar el entorno de tu shell
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Tiempo transcurrido en milisegundos antes de que una llamada a herramienta MCP que sigue en ejecución pase a una tarea en segundo plano (predeterminado: 120000, o 2 minutos). Establécela en 0 para desactivar el paso automático a segundo plano. 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 todavía 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 aborta con un error en lugar de esperar al MCP_TOOL_TIMEOUT general. Sobrescribe los valores predeterminados por transporte de 300000 (5 minutos) para los servidores de red y de 1800000 (30 minutos) para los servidores stdio. Establécela en 0 para desactivar 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 proceso padre, y los mensajes que llegan a él pasan por los controles de entrada de la sesión. Los bloques env de la configuración no pueden establecerla. Requiere Claude Code v2.1.224 o posterior
CLAUDE_CODE_MESSAGING_TOKEN La establece Claude Code, no tú: en las sesiones que vinculan un socket de bandeja de entrada, Claude Code exporta este token por sesión a los hooks y a los comandos de Bash junto con CLAUDE_CODE_MESSAGING_SOCKET. Un script que publica en el socket puede enviar {"type":"auth","token":"<token>"} como primera línea para demostrar que pertenece a la sesión. En Windows nativo, Claude Code exige esta línea y cierra cualquier conexión que no comience con una válida. Las reglas de proceso 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 propio cursor de la terminal en el punto de inserción en lugar de un bloque dibujado. El cursor respeta la configuración 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 en modo de control de tmux en pausa o una conexión SSH detenida, no pueda congelar Claude Code a mitad de la sesión. Se aplica en macOS, Linux y WSL cuando stdout es una terminal. Requiere Claude Code v2.1.261 o posterior
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Limita cuántas veces Claude Code vuelve a enviar una solicitud sin streaming cuando se agota su tiempo de espera. 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 reintento para el tiempo de espera. Requiere Claude Code v2.1.285 o posterior
CLAUDE_CODE_NO_FLICKER Establécela en 1 para habilitar la representación en pantalla completa, una vista previa de investigación que reduce el parpadeo y mantiene estable el uso de memoria en conversaciones largas. Sobrescribe el ajuste tui; también puedes cambiar con /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKEN Token de actualización de OAuth para la autenticación de Claude.ai. Cuando se establece, claude auth login intercambia este token directamente en lugar de abrir un navegador. Requiere CLAUDE_CODE_OAUTH_SCOPES. Útil para aprovisionar la autenticación en entornos automatizados
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 los 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 estableciste durante toda la sesión. Para reemplazar un token caducado, genera uno nuevo y reinicia
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Eliminada en v2.1.160 y ahora no tiene efecto. Anteriormente fijaba el modo rápido en Claude Opus 4.6 en lugar del valor predeterminado actual. Opus 4.6 ya no admite el modo rápido
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Longitud máxima de los atributos de OpenTelemetry que contienen contenido (respuestas del modelo, contenido de herramientas, prompts del sistema, cuerpos sin procesar de la API), incluido el marcador de truncamiento, en unidades de código UTF-16 (predeterminado: 61440, es decir, 60 KB). Auméntala solo si tu backend de telemetría acepta valores de atributo mayores de 64 KB, o redúcela para disminuir el volumen de telemetría. Requiere Claude Code v2.1.214 o posterior. Consulta Monitoreo
CLAUDE_CODE_OTEL_DIAG_STDERR Establécela en 1 para escribir en stderr los errores de diagnóstico del exportador de OpenTelemetry. De forma predeterminada, estos errores solo aparecen con --debug, por lo que, de lo contrario, un exportador mal configurado, como uno con 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 de OpenTelemetry pendientes (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 contra escritura compatible con Perforce. Cuando se establece, Edit, Write y NotebookEdit fallan con una sugerencia p4 edit <file> si el archivo de destino no tiene el bit de escritura del propietario, que Perforce borra en los archivos sincronizados hasta que p4 edit los abre. Esto evita que Claude Code eluda el seguimiento de cambios de Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIR Sobrescribe el directorio raíz de los plugins. A pesar del nombre, establece el directorio padre, no la caché en sí: los marketplaces y la caché de plugins se encuentran en subdirectorios de esta ruta. El valor predeterminado es ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS Directorios de plugins que se cargan para la sesión, cada uno cargado del mismo modo en que lo carga un flag --plugin-dir. Separa varias rutas con : en Unix o con ; 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 acceder al remoto o autenticarse en él. Útil en entornos sin conexión o aislados, donde volver a clonar fallaría de la misma manera. Consulta Las actualizaciones del marketplace fallan en entornos sin conexión
CLAUDE_CODE_PLUGIN_PREFER_HTTPS Establécela en 1 para clonar las fuentes abreviadas owner/repo de GitHub mediante HTTPS en lugar de SSH. Se aplica a la instalación y actualización de plugins, y a /plugin marketplace add y update. Útil en runners de CI, contenedores o cualquier entorno sin una clave SSH configurada para github.com
CLAUDE_CODE_PLUGIN_SEED_DIR Ruta a uno o más directorios semilla de plugins de solo lectura, separados por : en Unix o por ; en Windows. Úsala para incluir un directorio de plugins rellenado previamente en una imagen de contenedor. Claude Code registra los marketplaces de estos directorios al iniciar y usa los plugins almacenados previamente en caché sin volver a clonarlos. Consulta Rellenar previamente 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 Restricted como valor predeterminado. 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 último turno 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 en segundo plano simples. 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 local no puede establecerla. Equivale al ajuste processWrapper, que requiere Claude Code v2.1.210 o posterior; esta variable tiene precedencia cuando ambos están establecidos. La extensión de VS Code configura su propio lanzador por separado mediante su ajuste claudeProcessWrapper. Se ignora en Windows. Consulta Ejecutar Claude Code detrás de un lanzador corporativo para conocer el formato del valor, qué cubre el lanzador y el contrato que debe cumplir el lanzador. 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 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 en línea con ellos. Tiene precedencia sobre el ajuste promptCacheTtl y sobre ENABLE_PROMPT_CACHING_1H, y FORCE_PROMPT_CACHING_5M la sobrescribe. La API factura las escrituras 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 Anthropic API. Agregada 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 pueda 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 tenga 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 se sigue aplicando 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 mediante 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, igual que al 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 volver a enviar el prompt. Para desactivarla, quita la variable o establécela en 0. Para el panel de chat de VS Code, consulta Continuar las 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 que inician agentes de larga duración pueden establecerla para que un reinicio con una transcripción antigua no vuelva a ejecutar un prompt obsoleto. Claude Code establece por sí mismo un límite de una hora cuando reinicia una sesión de la vista de agentes que falló y que heredó su conversación de una sesión interactiva. Requiere Claude Code v2.1.211 o posterior
CLAUDE_CODE_RESUME_PROMPT Sobrescribe el mensaje de continuación que Claude Code envía a Claude cuando CLAUDE_CODE_RESUME_INTERRUPTED_TURN continúa un turno interrumpido en lugar de volver a enviar su prompt, o cuando reanudas una llamada a herramienta diferida con -p. El valor predeterminado es Continue from where you left off.. Una cadena vacía usa el valor predeterminado
CLAUDE_CODE_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 indica un límite de gasto o créditos de uso agotados, incluso uno procedente de un límite de gasto del gateway que se restablece según una programación. 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 restablezca el límite cuando la respuesta incluye un tiempo de restablecimiento del rate limit, por lo 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, tiempos de espera agotados y conexiones interrumpidas, lo que equivale aproximadamente a tres horas de espera, y elimina el límite de 15 de 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 la memoria automática no se cargan, para solucionar problemas de una configuración dañada. La directiva de configuración administrada se sigue aplicando, incluidos los hooks, la línea de estado y los comandos de sugerencia de archivos configurados por directiva; los plugins administrados, los skills administrados, el CLAUDE.md administrado y los servidores MCP configurados por directiva no. Equivale a pasar --safe-mode. Los procesos hijos iniciados directamente heredan la variable
CLAUDE_CODE_SCRIPT_CAPS Objeto JSON que limita cuántas veces se pueden invocar scripts específicos por sesión cuando se establece CLAUDE_CODE_SUBPROCESS_ENV_SCRUB. Las claves son subcadenas que se comparan con el texto del comando; los valores son límites de llamadas enteros. Por ejemplo, {"deploy.sh": 2} permite llamar a deploy.sh como máximo dos veces. La coincidencia se basa en subcadenas, por lo que los 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 propia gestión 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 tiene 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, se siguen aplicando
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 los 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 --resume sin un ID explícito, es posible que reciba en su lugar el ID del inicio original. Úsala para correlacionar scripts y herramientas externas con la sesión de Claude Code que los inició
CLAUDE_CODE_SHELL Establece el shell que Claude Code usa para ejecutar los comandos de la herramienta Bash. Acepta una ruta a un binario de bash o zsh, por ejemplo /opt/homebrew/bin/bash. 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 bash que funcione encontrado 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: las llamadas a la herramienta Bash, los comandos de hooks, los comandos de la línea de estado y los comandos de inicio de los 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. Desactiva 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 pasas con --add-dir se siguen cargando. 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 excluirte incluso en los modelos en los que el experimento o la configuración del servidor la 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, al usar 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 de "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, al usar un gateway de LLM)
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY Las comprobaciones de modelos al iniciar en Amazon Bedrock y Google Cloud's Agent Platform recuerdan en esta máquina qué modelos encontraron 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 del historial de prompts y de las transcripciones de sesión en el disco. Las sesiones iniciadas con esta variable establecida no aparecen en --resume, --continue ni en el historial de la flecha hacia arriba. Útil para sesiones efímeras con scripts
CLAUDE_CODE_SKIP_VERTEX_AUTH Omite la autenticación de Google para Google Cloud's Agent Platform (por ejemplo, al usar un gateway de LLM)
CLAUDE_CODE_STARTUP_FAILURE_RESULTS Establécela en 1 para que una sesión iniciada con --output-format stream-json escriba un mensaje de resultado que indique por qué Claude Code se negó a iniciar para los fallos de inicio que de otro modo terminan solo con stderr. Requiere Claude Code v2.1.274 o posterior
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Número máximo de veces consecutivas que un hook Stop o SubagentStop puede impedir que el turno termine antes de que Claude Code lo sobrescriba y termine el turno de todos modos (predeterminado: 8). Establécela en 0 para desactivar el límite. Auméntala si tu hook necesita legítimamente más iteraciones para resolverse
CLAUDE_CODE_SUBAGENT_MODEL El modelo predeterminado para los subagentes, los compañeros de un equipo de agentes y los agentes de flujos de trabajo a los que no se les asigna un modelo de otra manera. Acepta un alias como haiku o un nombre de modelo completo. Dos fuentes tienen precedencia sobre ella: un modelo que Claude pasa cuando genera el agente y un campo model en la definición del agente, incluido inherit. Para cambiar eso, establece CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Consulta Elegir un modelo para ver el orden completo. Establecerla en inherit equivale a 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 de las solicitudes fuera de la conversación principal, como los subagentes, los flujos de trabajo y el trabajo en segundo plano. Tiene precedencia sobre el ajuste subagentPromptCacheTtl y sobre ENABLE_PROMPT_CACHING_1H, y FORCE_PROMPT_CACHING_5M la sobrescribe. La API factura las escrituras 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 (herramienta Bash, hooks, servidores MCP stdio): las credenciales de Anthropic y de los proveedores de nube, cualquier otra variable que Claude Code reconozca como credencial y las credenciales incrustadas en las URL de los registros de paquetes. El proceso padre de Claude conserva estas credenciales para las llamadas a la API, pero los procesos hijos no pueden leerlas, lo que reduce la exposición a ataques de inyección de prompts que intentan exfiltrar secretos mediante la expansión del shell. En v2.1.251 o posterior, la limpieza también elimina las propias variables de Claude Code que apuntan al almacén de configuración (como CLAUDE_CONFIG_DIR), por lo que un proceso hijo no puede localizar un directorio de configuración reubicado. No establezcas la limpieza si un subproceso necesita estas variables. En Linux, esto también ejecuta los subprocesos de Bash en un espacio de nombres de PID aislado para que no puedan leer los entornos de los procesos del host mediante /proc; como efecto secundario, ps, pgrep y kill no pueden ver los procesos del host ni enviarles señales. claude-code-action la establece automáticamente cuando se configura allowed_non_write_users
CLAUDE_CODE_SYNC_PLUGIN_INSTALL Establécela en 1 en modo no interactivo (el flag -p) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y es posible que no estén disponibles en el primer turno. Combínala con CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS para limitar la espera
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS Tiempo de espera en milisegundos para la instalación síncrona de plugins. Cuando se supera, Claude Code continúa sin plugins y registra un error. Sin valor predeterminado: sin esta variable, la instalación síncrona espera hasta completarse
CLAUDE_CODE_SYNC_SKILLS Establécela en 1 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 los vuelven a sincronizar 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 aplicación creada con el Agent SDK recarga los skills (predeterminado: 30000). Cuando se supera, la recarga continúa con los skills que hayan llegado, y las descargas restantes terminan en segundo plano
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS Tiempo de espera en milisegundos durante el cual la primera consulta espera la lista inicial de skills cuando 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 desactivar el resaltado de sintaxis en la salida de diff. Útil cuando los colores interfieren con la configuración de tu terminal. Para desactivar también el resaltado en los bloques de código y en las vistas previas de archivos, usa el ajuste syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_ID Comparte una lista de tareas entre sesiones. Establece el mismo ID en varias instancias de Claude Code para coordinarte en una lista de tareas compartida, en las 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 valor 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 valor predeterminado del sistema cuando tu sobrescritura es una ruta larga, ya que algunas herramientas fallan cuando las rutas temporales son demasiado largas. Los comandos de Bash sin sandbox heredan el $TMPDIR de tu shell cuando está establecido. En Windows nativo, cuando tu shell no establece $TMPDIR, un comando de Bash que hace referencia a $TMPDIR recibe tu sobrescritura, o %TEMP% cuando no estableciste 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 y desactivación; quita la variable para restaurar la limitación a 256 colores. De forma predeterminada, Claude Code limita la salida 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 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 herramientas, como mcp o lsp. Establece none para limitar todos los tipos, o all-new para limitar solo los comandos de las herramientas Bash, PowerShell y Monitor. Claude Code mantiene los comandos de las herramientas Bash, PowerShell y Monitor bajo el límite 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 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 haya activado o desactivado el límite, un valor modificado entra en vigor la próxima vez que inicies claude. Requiere Claude Code v2.1.233 o posterior
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Plazo en milisegundos antes de que Claude Code cancele un diálogo que reenvía a un cliente remoto, como un 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 desatendida. Controlar los mensajes entrantes y Sesiones no interactivas cubren las reglas completas de vencimiento de los mensajes retenidos, incluidos los casos en los que no se aplica el plazo. Sobrescribe el ajuste dialogExpiry. 0 o un valor negativo desactiva 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 de 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 el número de milisegundos durante los que WebFetch mantiene en caché la respuesta de cada URL obtenida. El valor predeterminado es 900000, que son 15 minutos. Solo acepta dígitos simples; 0, un decimal o cualquier otra forma de escritura mantiene el valor predeterminado. Claude Code lee el valor una vez por inicio, por lo que un cambio en un bloque env de la configuración se aplica la próxima vez que inicies claude. Requiere Claude Code v2.1.233 o posterior
CLAUDE_CODE_WEBFETCH_DEADLINE_MS Límite superior en milisegundos de cuánto tiempo espera WebFetch a que se descargue una página, incluidas las redirecciones que sigue. Una descarga que no se haya completado para entonces falla con un error de plazo. El valor predeterminado es 300000, que son cinco minutos. Establécela en 0 para eliminar el límite. Solo acepta dígitos simples; un decimal o cualquier otra forma de escritura mantiene el valor predeterminado. Requiere Claude Code v2.1.268 o posterior
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS Cuántos agentes ejecuta a la vez una sola ejecución de un 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 a 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 admite dígitos simples; los valores fuera de rango y otras formas de escribirlos mantienen el valor predeterminado. Requiere Claude Code v2.1.269 o posterior
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Límite superior, en milisegundos, de cuánto tiempo espera un agente de un flujo de trabajo a que comience la primera respuesta de un agente hermano con el mismo prefijo antes de enviar su propia primera solicitud. Cuando una distribución en abanico inicia varios agentes que comparten un prefijo de caché de prompts, Claude Code retiene a todos menos al primer agente hasta este tiempo para que el resto lea el prefijo almacenado en caché en lugar de que cada uno lo procese sin caché. Valor 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 conservarlo 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 conservarí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 de esfuerzo
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 a un gateway alcanzado mediante ANTHROPIC_BASE_URL o ANTHROPIC_AWS_BASE_URL; antes de v2.1.222 no se ejecutaba en esas conexiones a gateways, por lo que el watchdog a nivel de eventos podía informar de un bloqueo allí incluso mientras llegaban pings de keep-alive. Para los tiempos de espera y cómo interactúan los temporizadores, consulta Watchdogs de inactividad de streaming
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Establé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 en streaming de Bedrock. Desactivada 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 con este, consulta Watchdogs de inactividad de streaming
CLAUDE_ENV_FILE Ruta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando 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 elimina la sesión
CLAUDE_PID Claude Code la establece con su propio ID de proceso en los subprocesos que genera: los comandos de las herramientas Bash y PowerShell y los comandos de hooks. En Linux, la integración de shell de la herramienta Bash la usa para rechazar un patrón de pkill que coincidiría con el propio proceso de Claude Code; consulta la referencia de errores. Léela desde tus propios scripts para identificar o enviar señales deliberadamente al proceso padre 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 en 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 pausas prolongadas de pensamiento y el almacenamiento en búfer de proxies, y el watchdog a nivel de bytes limita el valor a 30 minutos. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS tiene precedencia sobre esta variable para el watchdog a nivel de bytes. Para los valores predeterminados sin establecer de cada watchdog, consulta Watchdogs de inactividad de streaming
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS Se eliminó en v2.1.260 y ahora no tiene efecto. Anteriormente limitaba cuánto tiempo, en milisegundos, podía ejecutarse 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 espacios 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. claude update manual sigue funcionando. Usa DISABLE_UPDATES para bloquear ambas
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 configuración /doctor y su alias /checkup. Útil en despliegues administrados donde los usuarios no deberían ejecutar diagnósticos de configuración desde una sesión. No afecta al comando de terminal claude doctor. Antes de v2.1.205, esta variable ocultaba el comando de 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 por la misma vía; antes de v2.1.212 eran alias de /feedback, por lo que el comando quedaba desactivado con todos 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 deja la obtención activada. El registro de eventos de telemetría sigue 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 se usan proveedores de terceros (Amazon Bedrock, Agent Platform de Google Cloud o Microsoft Foundry)
DISABLE_INTERLEAVED_THINKING Establécela en 1 para evitar el envío del encabezado beta de pensamiento intercalado. Útil cuando tu gateway de LLM o 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 claude update y claude install manuales. 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, incluido 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 que reconocen 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 que Claude Code deje de obtener los servidores MCP de claude.ai. Activada de forma predeterminada para los usuarios con sesión iniciada. Para desactivarla por proyecto o por organización, establece en su lugar disableClaudeAiConnectors en la configuración
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 con suscripción dentro del uso incluido reciben automáticamente el TTL de 1 hora en la conversación principal. Los usuarios con suscripción que consumen créditos de uso pueden establecerla para mantener el TTL de 1 hora. Las escrituras en caché de 1 hora se facturan a una tarifa más alta. Para elegir el TTL por grupo de solicitudes, usa en su lugar 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 MCP Tool Search. Sin establecer, 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 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 cada modelo cuando no hay un modelo de respaldo configurado. Establecerla en 0 o false también activa esto, 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 manera en los modelos que reconoce como 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 al 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 que la terminal los admite. 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 que la terminal los admite, 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 de demostración: 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 de demostración, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para desactivarlo. Útil al transmitir o grabar una sesión
MAX_MCP_OUTPUT_TOKENS Número máximo de tokens permitidos en las respuestas de herramientas MCP. Claude Code muestra una advertencia cuando la salida supera los 10,000 tokens. Las herramientas que declaran anthropic/maxResultSizeChars usan en su lugar ese límite de caracteres para el contenido de texto, pero el contenido de imagen de esas herramientas sigue sujeto a esta variable (predeterminado: 25000)
MAX_STRUCTURED_OUTPUT_RETRIES Número 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; tras 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 un 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 en su lugar el parámetro thinking. 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. Claude Code ignora los valores distintos de cero en los modelos de razonamiento adaptativo, excepto en los modelos en los que 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, en milisegundos, espera 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 cumplirse el plazo continúan conectándose en segundo plano. Distinta de MCP_TIMEOUT, que limita el intento de conexión de un servidor individual
MCP_DISCOVERY_CACHE Activa o desactiva la caché de descubrimiento de MCP. Con la caché activada, un servidor HTTP o SSE remoto que hayas usado antes puede mostrar el estado cached, y Claude Code lo conecta en su primera llamada a herramienta en lugar de al inicio. La caché está desactivada de forma predeterminada a menos que un lanzamiento gradual la haya activado para tu cuenta. Establécela en 1 para activarla, o en 0 para mantenerla desactivada incluso cuando el lanzamiento 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, Claude Code la descarta y conecta el servidor al inicio, como lo hace con la caché desactivada. Claude Code limita el valor a 7 días. Antes de v2.1.238, el valor predeterminado era 86400, o 24 horas, y Claude Code no limitaba el valor
MCP_DISCOVERY_CACHE_STRIKES En un inicio en el que una entrada de la caché de descubrimiento es más antigua que MCP_DISCOVERY_CACHE_TTL_S, Claude Code la actualiza en segundo plano. Esta variable establece cuántas actualizaciones seguidas pueden fallar antes de que Claude Code descarte la entrada y conecte el servidor en el siguiente inicio (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, Claude Code la sigue usando pero la actualiza en segundo plano. Una vez que la entrada es más antigua que MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code la descarta. 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 del protocolo MCP 2026-07-28. Establece auto para sondear los servidores HTTP, de conectores de claude.ai y stdio; un servidor que no responde al sondeo se conecta en su lugar con el protocolo anterior, como siempre hacen los servidores SSE y WebSocket. Establece legacy para omitir el sondeo en todos los servidores. Sin la variable, Claude Code sondea los servidores HTTP y también los servidores de conectores de claude.ai en las sesiones en las que obtiene feature flags. Cualquier otro valor se ignora con una advertencia en el registro de depuración. Requiere Claude Code v2.1.221 o posterior
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE Número máximo de servidores MCP remotos (HTTP/SSE) que se conectan en paralelo durante el inicio (predeterminado: 20)
MCP_SDK_GENERATION Fija el entorno de ejecución del cliente MCP con el que este proceso se conecta 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 Número máximo de servidores MCP locales (stdio) que se conectan en paralelo durante el inicio (predeterminado: 3)
MCP_TIMEOUT Tiempo de espera en milisegundos para el inicio del servidor MCP (predeterminado: 30000, o 30 segundos)
MCP_TOOL_TIMEOUT Tiempo de espera en milisegundos para la ejecución de herramientas MCP (predeterminado: 100000000, unas 28 horas). Para un servidor HTTP, SSE o de conector de claude.ai, cada solicitud también agota su tiempo de espera tras 60 segundos de forma predeterminada; establece esta variable, o el timeout por servidor, por encima de 60000 para aumentar ese límite por solicitud. Un valor más bajo sigue acortando el tiempo de espera general de ejecución de la herramienta, 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 esto 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 cancela antes; este mínimo requiere Claude Code v2.1.203 o posterior. Para la variable de entorno, los valores inferiores a 1000 se elevan a un segundo; para el campo por servidor, los valores inferiores a 1000 se ignoran
NO_PROXY Lista de dominios e IP a los que las solicitudes se enviarán directamente, omitiendo 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, de modo que el marcador de truncamiento quede dentro del límite del SDK. Claude Code lee las variantes OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT y OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT de la misma manera, y el menor valor establecido se aplica a todas las señales. Requiere Claude Code v2.1.214 o posterior. Consulta Monitoreo
OTEL_LOG_ASSISTANT_RESPONSES Establécela en 1 para incluir el texto de respuesta del modelo en los eventos de registro assistant_response de OpenTelemetry. Cuando no está establecida, Claude Code usa en su lugar el valor de OTEL_LOG_USER_PROMPTS. Establécela en 0 para mantener las respuestas ocultas 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 con datos ocultos, y un resumen SHA-256 de la configuración antes de ocultar los datos, a los eventos de registro managed_settings_resolved de OpenTelemetry. 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 solicitud y respuesta de la API Messages 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 cuerpos sin truncar en el disco y emitir en su lugar una ruta body_ref. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configura el límite de contenido, 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 tool.output de OpenTelemetry. Los atributos de span llevan el contenido de las herramientas bajo sus propios controles. Requiere rastreo. Desactivada de forma predeterminada para proteger los 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 los servidores MCP; los nombres de los flujos de trabajo creados por el usuario; las cadenas de error sin procesar en los fallos de herramientas; la category de rechazo en los eventos api_refusal; los nombres reales de agentes, skills, plugins y servidores MCP en las métricas de costos y tokens; y otros detalles de las herramientas en las métricas, trazas y registros de OpenTelemetry. Desactivada de forma predeterminada para proteger la información de identificación personal. 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 ocultan). 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 las 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 las métricas (predeterminado: excluido). Se agregó 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 las 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 las 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 las 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 se escala dinámicamente al 1% de la ventana de contexto, con un valor de respaldo de 8,000 caracteres. Se mantiene el nombre heredado 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 el número máximo de caracteres de la salida de una tarea en segundo plano que conservaba la herramienta TaskOutput. Claude lee en su lugar el archivo de salida de una tarea en segundo plano con Read
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 para Claude 3.5 Haiku al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_3_5_SONNET Sobrescribe la región para Claude 3.5 Sonnet al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_3_7_SONNET Sobrescribe la región para Claude 3.7 Sonnet al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_0_OPUS Sobrescribe la región para Claude 4.0 Opus al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_0_SONNET Sobrescribe la región para Claude 4.0 Sonnet al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_1_OPUS Sobrescribe la región para Claude 4.1 Opus al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_5_OPUS Sobrescribe la región para Claude Opus 4.5 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_5_SONNET Sobrescribe la región para Claude Sonnet 4.5 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_6_OPUS Sobrescribe la región para Claude Opus 4.6 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_6_SONNET Sobrescribe la región para Claude Sonnet 4.6 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_7_OPUS Sobrescribe la región para Claude Opus 4.7 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_8_OPUS Sobrescribe la región para Claude Opus 4.8 al usar Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_5_5_OPUS Sobrescribe la región para Claude Opus 5.5 al usar Agent Platform de Google Cloud. Se agregó en v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Sobrescribe la región para Claude Sonnet 5.5 al usar Agent Platform de Google Cloud. Se agregó en v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Sobrescribe la región para Claude Opus 5 al usar Agent Platform de Google Cloud. Se agregó en v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Sobrescribe la región para Claude Sonnet 5 al usar Agent Platform de Google Cloud. Se agregó en v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Sobrescribe la región para Claude Fable 5 al usar Agent Platform de Google Cloud. Se agregó en v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Sobrescribe la región para Claude Fable 5.1 al usar Agent Platform de Google Cloud. Se agregó en v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Sobrescribe la región para Claude Haiku 4.5 al usar Agent Platform de Google Cloud

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

Establece CLAUDE_CODE_ENABLE_TELEMETRY y las variables de OpenTelemetry que activan la exportación, eligen su destino o capturan contenido en tu shell, en la configuración de usuario o en la configuración administrada. Claude Code las ignora en la configuración de proyecto y local, salvo los valores de desactivación que describe esa sección. OTEL_RESOURCE_ATTRIBUTES y las variables de intervalo, tiempo de espera y compresión de la exportación, como OTEL_METRIC_EXPORT_INTERVAL, siguen aplicándose desde la configuración de proyecto y local.

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

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

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

Con la obtención desactivada, usted no puede:

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

En su primera sesión después de instalar Claude Code, o actualizar a una versión que añade una característica, una característica protegida por bandera puede estar ausente. Esa sesión también puede iniciarse en un modo de permiso diferente al que sus sesiones posteriores hacen. Claude Code obtiene las banderas durante esa sesión, por lo que su próxima sesión tiene la característica y el modo de permiso inicial habitual.

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

Véase también