SpyBara
Go Premium

env-vars.md 2026-10-04 23:58 UTC to 2026-10-05 12:02 UTC

This page contains 321 additions and 321 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 12:57

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 admite 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 a 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 tenga prioridad sobre tu suscripción. Para usar tu suscripción en su lugar, ejecuta unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN Valor personalizado para el encabezado Authorization (el valor que establezcas aquí llevará el prefijo Bearer )
ANTHROPIC_AWS_API_KEY Clave de API del espacio de trabajo para Claude Platform on AWS, generada en la consola de AWS. Se envía como x-api-key y tiene precedencia sobre AWS SigV4
ANTHROPIC_AWS_BASE_URL Sobrescribe la URL del endpoint de Claude Platform on AWS. Úsala para regiones personalizadas o al enrutar a través de un gateway de LLM. El valor predeterminado es https://aws-external-anthropic.{region}.api.aws. Claude Code resuelve la región con la misma precedencia que en Amazon Bedrock
ANTHROPIC_AWS_WORKSPACE_ID Obligatoria para Claude Platform on AWS. Se envía en cada solicitud como el encabezado anthropic-workspace-id
ANTHROPIC_BASE_URL Sobrescribe el endpoint de la API para enrutar las solicitudes a través de un proxy o gateway. Cuando se establece en un host que no es de Anthropic, MCP Tool Search se desactiva 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, Google Cloud's Agent Platform y Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL Sobrescribe la URL del endpoint de Amazon Bedrock. Úsala para endpoints personalizados de Amazon Bedrock o al enrutar a través de un gateway de LLM. Consulta Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Sobrescribe la URL del endpoint de Amazon Bedrock Mantle. Consulta Endpoint de Mantle
ANTHROPIC_BEDROCK_REGION_PREFIX Prefijo del perfil de inferencia entre regiones (us, eu, apac, jp, au o global) que Claude Code prueba primero en lugar del derivado de la región de AWS. Se ignora en las regiones de AWS GovCloud. Requiere Claude Code v2.1.224 o posterior. Consulta Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Nivel de servicio de Amazon Bedrock (default, flex o priority). Se envía como el encabezado X-Amzn-Bedrock-Service-Tier. Consulta Amazon Bedrock
ANTHROPIC_BETAS Lista separada por comas de valores adicionales del encabezado anthropic-beta que se incluirán en las solicitudes a la API. Claude Code ya envía los encabezados beta que necesita; usa esta variable para optar por una beta de la API de Anthropic antes de que Claude Code añada compatibilidad nativa. A diferencia del flag --betas, que requiere autenticación con clave de API, esta variable funciona con todos los métodos de autenticación, incluida la suscripción a Claude.ai
ANTHROPIC_CUSTOM_HEADERS Encabezados personalizados que se añaden a las solicitudes (formato Name: Value, separados por saltos de línea para varios encabezados). Si un nombre o valor contiene un carácter que un encabezado HTTP no puede transportar, como una comilla tipográfica o un espacio de ancho cero, la solicitud falla con un error que identifica el par por su posición. Requiere Claude Code v2.1.227 o posterior. Invalid request header value enumera el conjunto exacto de caracteres y dónde se ejecuta la comprobación. Un valor que establece un encabezado de credenciales, organización o tenant, enrutamiento o comportamiento de la API, como Authorization o Host, cuenta como un ajuste que necesita aprobación cuando lo entrega la configuración administrada por el servidor. Desde la configuración de proyecto o local, dicho valor sigue las reglas sobre cuándo se aplican los valores de env
ANTHROPIC_CUSTOM_MODEL_OPTION ID de modelo que se añade como entrada personalizada en el selector de /model. Úsala para que un modelo no estándar o específico de un gateway se pueda seleccionar sin reemplazar los alias integrados. Consulta Configuración del modelo
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION Descripción que se muestra para la entrada del modelo personalizado en el selector de /model. Si no está establecida, el valor predeterminado es Custom model (<model-id>)
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Nombre que se muestra para la entrada del modelo personalizado en el selector de /model. Si no está establecida, la entrada muestra el nombre del modelo si Claude Code reconoce el ID, y el ID del modelo en caso contrario
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES Lista separada por comas de capacidades que admite el modelo personalizado, por ejemplo effort,thinking. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL ID de modelo al que se resuelve el alias fable, y el ID que Claude Code reconoce como modelo Fable para el respaldo automático de modelo en proveedores externos. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Descripción que se muestra para el modelo Fable fijado en el selector de /model. Si no está establecida, la fila muestra una descripción predeterminada que comienza con Custom Fable model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Nombre que se muestra para el modelo Fable fijado en el selector de /model. Si no está establecida, 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 capacidades que admite el modelo Fable fijado, por ejemplo effort,thinking. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL ID de modelo al que se resuelve el alias haiku, que también se usa para la funcionalidad en segundo plano. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION Descripción que se muestra para el modelo Haiku fijado en el selector de /model. Si no está establecida, la fila muestra una descripción predeterminada que comienza con Custom Haiku model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Nombre que se muestra para el modelo Haiku fijado en el selector de /model. Si no está establecida, 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 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 las sesiones nuevas
ANTHROPIC_DEFAULT_OPUS_MODEL ID de modelo al que se resuelve el alias opus, y que opusplan usa mientras el modo plan está activo. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION Descripción que se muestra para el modelo Opus fijado en el selector de /model. Si no está establecida, la fila muestra una descripción predeterminada que comienza con Custom Opus model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Nombre que se muestra para el modelo Opus fijado en el selector de /model. Si no está establecida, 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 capacidades que admite el modelo Opus fijado, por ejemplo effort,thinking. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_SONNET_MODEL ID de modelo al que se resuelve el alias sonnet, y que opusplan usa cuando el modo plan no está activo. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION Descripción que se muestra para el modelo Sonnet fijado en el selector de /model. Si no está establecida, la fila muestra una descripción predeterminada que comienza con Custom Sonnet model. Consulta Configuración del modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Nombre que se muestra para el modelo Sonnet fijado en el selector de /model. Si no está establecida, 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 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 en Microsoft Foundry (consulta Microsoft Foundry)
ANTHROPIC_FOUNDRY_AUTH_TOKEN Token de portador para la autenticación en Microsoft Foundry, como un token de acceso de Microsoft Entra. Claude Code lo envía como el encabezado Authorization: Bearer. Tiene precedencia sobre ANTHROPIC_FOUNDRY_API_KEY y sobre la cadena de credenciales predeterminada de Azure. Consulta Microsoft Foundry. Requiere Claude Code v2.1.203 o posterior
ANTHROPIC_FOUNDRY_BASE_URL URL base completa del recurso de Microsoft Foundry (por ejemplo, https://my-resource.services.ai.azure.com/anthropic). Alternativa a ANTHROPIC_FOUNDRY_RESOURCE (consulta Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCE Nombre del recurso de Microsoft Foundry (por ejemplo, my-resource). Claude Code rechaza una URL o un nombre de host. Obligatoria si ANTHROPIC_FOUNDRY_BASE_URL no está establecida (consulta Microsoft Foundry)
ANTHROPIC_MODEL Nombre del ajuste de modelo que se usará (consulta Configuración del modelo)
ANTHROPIC_ORGANIZATION_ID ID de organización para Workload Identity Federation. Establécela junto con ANTHROPIC_FEDERATION_RULE_ID. Consulta precedencia de autenticación
ANTHROPIC_PROFILE Nombre del perfil de Anthropic con el que autenticarse, como uno creado por ant auth login o al iniciar sesión en una cuenta de Console sin clave de API. Consulta precedencia de autenticación
ANTHROPIC_SMALL_FAST_MODEL [OBSOLETO] Nombre del modelo de clase Haiku para tareas en segundo plano
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Sobrescribe la región de AWS para el modelo de clase Haiku al usar Amazon Bedrock o Amazon Bedrock Mantle. En Amazon Bedrock, solo tiene efecto cuando también 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 Google Cloud's Agent Platform. Úsala para endpoints personalizados de Google Cloud's Agent Platform o al enrutar a través de un gateway de LLM. Consulta Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID ID del proyecto de GCP al que se dirigen las solicitudes de Google Cloud's Agent Platform. Consulta Configurar las credenciales de GCP
ANTHROPIC_WORKSPACE_ID ID del espacio de trabajo para workload identity federation. Establécela cuando tu regla de federación abarque más de un espacio de trabajo, para que el intercambio de tokens sepa a qué espacio de trabajo dirigirse
API_FORCE_IDLE_TIMEOUT Sobrescribe el tiempo de espera de inactividad del cuerpo de 5 minutos que aborta una respuesta del modelo en streaming cuando no llegan bytes. Establécela en 0 para desactivar el tiempo de espera, por ejemplo cuando un gateway lento o un modelo local hace pausas de más de 5 minutos entre fragmentos, o en 1 para mantenerlo activo en 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 abortan una pausa silenciosa larga incluso cuando estableces 0 aquí
API_TIMEOUT_MS Tiempo de espera para las solicitudes a la API en milisegundos (predeterminado: 600000, o 10 minutos; máximo: 2147483647). Auméntalo cuando se agote el tiempo de espera de las solicitudes en redes lentas o al enrutar a través de un proxy. Los valores 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 en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 120000, o 2 minutos). Un valor predeterminado superior a 30 minutos también se convierte en el límite de tiempo predeterminado para los comandos en segundo plano en sesiones desatendidas. El límite de tiempo en segundo plano requiere Claude Code v2.1.285 o posterior
BASH_MAX_OUTPUT_LENGTH Número máximo de caracteres de la salida de bash que Claude Code 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 en primer plano de la herramienta Bash o PowerShell, en milisegundos (predeterminado: 600000, o 10 minutos). El límite efectivo es el mayor entre este valor y BASH_DEFAULT_TIMEOUT_MS. Un límite efectivo superior a 2 horas también se convierte en el límite de tiempo máximo para los 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 rastreo beta detallado: con ENABLE_BETA_TRACING_DETAILED=1, los registros y las trazas se envían allí en lugar de a los exportadores configurados. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local
CCR_FORCE_BUNDLE Establécela en 1 para forzar que claude --cloud empaquete y suba tu repositorio local en lugar de clonarlo desde su remoto
CLAUDECODE Se establece en 1 en los subprocesos que genera Claude Code (herramientas Bash y PowerShell, sesiones de tmux, comandos de hooks, comandos de la línea de estado, subprocesos de servidores MCP stdio). Las extensiones de IDE también la establecen en sus terminales integradas. Úsala para detectar cuándo un script se ejecuta dentro de un subproceso generado por Claude Code. Para comprobar si el proceso actual fue generado directamente por una llamada a herramienta o un hook, y no 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), limitado al tiempo de espera de la continuación automática. No tiene efecto a menos que la continuación automática esté activada; consulta el ajuste askUserQuestionTimeout y CLAUDE_AFK_TIMEOUT_MS. Requiere Claude Code v2.1.198 o posterior
CLAUDE_AFK_TIMEOUT_MS Cuántos milisegundos de inactividad deben pasar antes de que un 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. Dicha llamada 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 las herramientas de los servidores MCP creados por el SDK. Las herramientas usan sus nombres originales. Solo para uso con el SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS Tiempo de espera por bloqueo en milisegundos para los 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 Gestionar respuestas de la API lentas o bloqueadas. El temporizador se reinicia con cada evento de progreso del streaming; si no llega ningún progreso dentro del intervalo, Claude Code aborta el subagente e informa el 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 las 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 las llamadas largas a herramientas MCP en modo no interactivo en Claude Code v2.1.212 o posterior
CLAUDE_AX_PREPARK_MS En el modo de lector de pantalla, cuántos milisegundos espera Claude Code antes de escribir una línea nueva o modificada. Predeterminado 0, por lo que Claude Code no espera. Antes de 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 generar una salida adaptada a lectores de pantalla: texto plano sin bordes decorativos ni animaciones. Establécela en 0 para forzar la desactivación del modo de lector de pantalla incluso cuando axScreenReader es true. El flag --ax-screen-reader tiene precedencia. Requiere Claude Code v2.1.181 o posterior
CLAUDE_AX_STARTUP_QUIET_MS En el modo de lector de pantalla, cuántos milisegundos retiene Claude Code el primer renderizado de la interfaz después de la línea de confirmación de inicio, para que tu lector de pantalla pueda leer la línea completa antes de que una nueva salida la interrumpa. Predeterminado 3000. Establece 0 para renderizar de inmediato. Claude Code limita la retención a 600000 (10 minutos). Tu primera pulsación de tecla 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 del 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 detector de bloqueo de pantalla, crea cuando desbloqueas la pantalla y elimina cuando la bloqueas. Mientras el archivo existe, Claude Code omite las notificaciones push móviles de Remote Control, para que dejes de recibir notificaciones mientras usas activamente la computadora. Cuando el archivo no existe o no se puede leer, las notificaciones se envían con normalidad. Claude Code comprueba el archivo una vez por cada evento que desencadena una notificación push, en lugar de consultarlo periódicamente. Requiere Claude Code v2.1.181 o posterior
CLAUDE_CODE_ACCESSIBILITY Establécela en 1 para mantener visible el cursor nativo de la terminal y desactivar el indicador de cursor de texto invertido. Permite que las lupas de pantalla, como el 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 dibujar toda la pantalla en cada fotograma en el renderizado a pantalla completa en lugar de enviar actualizaciones incrementales. Úsala si el modo de pantalla completa muestra fragmentos de texto 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 el esfuerzo. Úsala al enrutar a través de un gateway de LLM o un proveedor externo que sirve modelos con identificadores personalizados. Los modelos que rechazan el parámetro de esfuerzo en la API, incluidos los modelos Claude 3, Sonnet 4.0 y 4.5, Opus 4.0 y 4.1 y Haiku 4.5, siguen excluidos para que las solicitudes no fallen
CLAUDE_CODE_API_KEY_HELPER_TTL_MS Intervalo en milisegundos con el que 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 a los comentarios en un artefacto. No tiene efecto cuando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC desactivó 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 al 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 las URL base personalizadas y las conexiones de Microsoft Foundry, así que en esas versiones establécela en 0 cuando tu gateway de LLM almacene en caché según el cuerpo de la solicitud o reenvíe las solicitudes a un proveedor externo, o cuando te conectes directamente a Microsoft Foundry
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS Eliminada en v2.1.283. Usa CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE en su lugar
CLAUDE_CODE_AUTO_COMPACT_WINDOW Establece la ventana de compactación automática en tokens, de 100000 a 1000000. Solo acepta un entero simple como 500000: un valor como 500k se lee como 500 y se ajusta al mínimo de 100K. La ventana efectiva también está limitada a la ventana de contexto del modelo. Tiene precedencia sobre el comando /autocompact, el flag --autocompact y el ajuste autoCompactWindow. El used_percentage de la línea de estado siempre se mide respecto a la ventana de contexto completa del modelo, por lo que, una vez establecida esta variable, ese porcentaje ya no indica cuándo se ejecutará la compactación
CLAUDE_CODE_AUTO_CONNECT_IDE Sobrescribe la conexión automática con el IDE. De forma predeterminada, Claude Code se conecta automáticamente cuando se inicia dentro de la terminal integrada de un IDE compatible. 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 solicitudes al clasificador propias 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 predeterminada de proveedores de credenciales de AWS produzca credenciales antes de que la solicitud falle con AWS default-chain credential resolve timed out (predeterminado: 60000). Auméntalo cuando un paso de tu cadena necesite legítimamente más tiempo, como un inicio de sesión SSO en el navegador con MFA mediante un contenedor 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 sigue en ejecución trabajo en segundo plano. De forma predeterminada, la sesión sigue informando un estado de ejecución después del final del turno mientras sigue activo trabajo en segundo plano, como un agente en segundo plano o la ejecución de un flujo de trabajo. Esto evita que un host que supervisa el estado, como una lista de sesiones remotas, anuncie que Claude está esperando tu entrada a mitad del trabajo. Los comandos de shell en segundo plano, como un servidor de desarrollo, no mantienen el estado de ejecución. El estado de ejecución predeterminado y la desactivación con 0 requieren Claude Code v2.1.269 o posterior; en versiones anteriores, establece 1 para mantener el estado de ejecución
CLAUDE_CODE_BRIDGE_SESSION_ID Se establece automáticamente en los subprocesos de la herramienta Bash y de los comandos de hooks mientras la sesión tiene una conexión activa de Remote Control, y se elimina cuando la conexión termina. El valor es el ID de la sesión en formato session_, el mismo identificador que aparece en la URL claude.ai/code de la sesión, para que un script pueda enlazar de vuelta a la sesión que lo ejecutó. Requiere Claude Code v2.1.199 o posterior. En las sesiones en la nube, lee CLAUDE_CODE_REMOTE_SESSION_ID en su lugar
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE Establécela en 0 para que Claude Code lea el byte 0x08, también escrito ^H, como 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 orígenes de certificados de CA para las conexiones TLS. bundled es el conjunto de CA de Mozilla incluido con Claude Code. system es el almacén de confianza del sistema operativo, que solo se lee en entornos de ejecución con tls.getCACertificates: el binario nativo, o Node 22.15 o posterior para instalaciones con npm. Consulta Almacén de certificados de CA. El valor predeterminado es bundled,system
CLAUDE_CODE_CHILD_SESSION Se establece en 1 en los subprocesos que Claude Code genera mediante las herramientas Bash, PowerShell y Monitor, los comandos de hooks y los comandos de la línea de estado. No se establece para los subprocesos de servidores MCP stdio, que son de larga duración y sobreviven a la sesión que los generó. A diferencia de CLAUDECODE, solo la establece el propio Claude Code cuando inicia un subproceso y no las extensiones de IDE, por lo que distingue de forma fiable una sesión anidada de un claude de nivel superior iniciado en una terminal integrada de un IDE. Una TUI interactiva de claude anidada iniciada de esta forma se excluye automáticamente de --resume, --continue, del historial con la flecha hacia arriba y de la lista de claude agents. Las sesiones no interactivas de claude -p siguen persistiendo. Establece CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 para anular esta exclusión. Requiere Claude Code v2.1.172 o posterior
CLAUDE_CODE_CLIENT_CERT Ruta al archivo del certificado de cliente para la autenticación mTLS
CLAUDE_CODE_CLIENT_KEY Ruta al archivo de la clave privada del cliente para la autenticación mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE Frase de contraseña para la CLAUDE_CODE_CLIENT_KEY cifrada (opcional)
CLAUDE_CODE_CONNECT_TIMEOUT_MS Eliminada en v2.1.186 y ahora no tiene efecto. Anteriormente establecía un tiempo de espera separado para la fase de conexión, TLS y encabezados de respuesta de una solicitud a la API en streaming. Usa API_TIMEOUT_MS para el tiempo de espera por solicitud. Para la fase de encabezados de respuesta de una solicitud en streaming, consulta CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
CLAUDE_CODE_DEBUG_LOGS_DIR Sobrescribe la ruta del archivo de registro de depuración. A pesar del nombre, es una ruta de archivo, no un directorio. Requiere que el modo de depuración se active por separado mediante --debug, /debug o la variable de entorno DEBUG: establecer solo esta variable no activa el registro. El flag --debug-file hace ambas cosas a la vez. El valor predeterminado es ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL Nivel mínimo de registro que se escribe en el archivo de registro de depuración. Valores: verbose, debug (predeterminado), info, warn, error. Establécela en verbose para incluir diagnósticos de alto 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 modelos de 1M no están disponibles en el selector de modelos y Claude Code limita a una ventana de 200K las sesiones en modelos con una ventana nativa de 1M, como Sonnet 5.5 y los modelos Fable; consulta Contexto extendido para ver cómo se aplica ese límite. Útil para entornos empresariales con requisitos de cumplimiento normativo. Para conocer su papel en la corrección de la ventana para 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 clave por clave los bloques env de la configuración administrada entre los orígenes de administración, de modo que solo se aplique el bloque env completo del origen 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, cualquier advisorModel configurado se ignora y el flag --advisor se acepta pero no tiene efecto, por lo que los scripts existentes que lo pasan siguen funcionando sin errores
CLAUDE_CODE_DISABLE_AGENT_VIEW Establécela en 1 para desactivar los agentes en segundo plano y la vista de agentes: claude agents, --bg, /background y el supervisor bajo demanda. Equivale al ajuste disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Establécela en 1 para desactivar el renderizado a pantalla completa y usar el renderizador clásico de pantalla principal. La conversación permanece en el historial de desplazamiento nativo de tu terminal, por lo que Cmd+f y el modo de copia de tmux funcionan como de costumbre. Tiene precedencia sobre CLAUDE_CODE_NO_FLICKER y el ajuste tui. También puedes cambiar con /tui default. No se aplica a las sesiones en segundo plano abiertas desde la vista de agentes, que siempre usan el renderizado a pantalla completa
CLAUDE_CODE_DISABLE_ARTIFACT Establécela en 1 para desactivar la herramienta Artifact, que publica la salida de la sesión como una página web privada en claude.ai. Una vez que la estableces, ningún archivo de configuración vuelve a activar la herramienta. Para desactivar la herramienta desde un archivo de configuración, establece enableArtifact en false; la clave obsoleta disableArtifact también la desactiva
CLAUDE_CODE_DISABLE_ATTACHMENTS Establécela en 1 para desactivar el procesamiento de archivos adjuntos. Las menciones de archivos con la sintaxis @ se envían como texto sin formato 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 flujo de eventos binario de Amazon Bedrock. De forma predeterminada, Claude Code asume que un gateway eliminó el encabezado de una respuesta que por lo demás no se modificó, por lo que decodifica el cuerpo y el streaming sigue funcionando. Establécela solo para un gateway que además vuelva a emitir el stream como eventos enviados por el servidor; Claude Code lee entonces el cuerpo sin encabezado como eventos enviados por el servidor. Requiere Claude Code v2.1.239 o posterior
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Establécela en 1 para omitir la comprobación de que una respuesta en streaming de Amazon Bedrock lleva el content-type application/vnd.amazon.eventstream. Sin esta variable, cuando una respuesta lleva un content-type diferente, 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 transferirlos al siguiente proceso de la sesión. Solo afecta a esa transferencia: 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 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 se ocultan al modelo. /doctor se puede seguir escribiendo como los comandos integrados; para ocultarlo, usa DISABLE_DOCTOR_COMMAND. 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 omite la sección de Chrome del prompt del sistema y el skill incluido /claude-in-chrome. Pensada para hosts que integran Claude Code y proporcionan sus propias indicaciones sobre el navegador. Requiere Claude Code v2.1.257 o posterior
CLAUDE_CODE_DISABLE_CLAUDE_MDS Establécela en 1 para evitar que se cargue en el contexto cualquier archivo de memoria CLAUDE.md, incluidos los archivos de memoria de usuario, de proyecto y de memoria automática
CLAUDE_CODE_DISABLE_CRON Establécela en 1 para desactivar las tareas programadas. El skill /loop y las herramientas de cron dejan de estar disponibles, y las tareas ya programadas dejan de ejecutarse, incluidas las que ya están en ejecución 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 confirmación de eliminación en 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 eliminar de las solicitudes a la API los encabezados de solicitud anthropic-beta de versiones preliminares, los campos del cuerpo que los acompañan y los campos beta del esquema de herramientas, como defer_loading y eager_input_streaming. Úsala cuando un gateway proxy rechaza las solicitudes con un error Unexpected value(s) para el encabezado anthropic-beta o un error Extra inputs are not permitted. Desactivar las capacidades de versiones 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, y el modo plan lee los archivos directamente en lugar de iniciar los agentes Explore y Plan. Los subagentes personalizados llamados Explore o Plan no se ven afectados. Para eliminar todos los tipos de subagentes integrados en el Agent SDK o en modo no interactivo, usa CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS en su lugar. Requiere Claude Code v2.1.198 o posterior
CLAUDE_CODE_DISABLE_FAST_MODE Establécela en 1 para desactivar el modo rápido
CLAUDE_CODE_DISABLE_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 está establecida DISABLE_TELEMETRY, DO_NOT_TRACK o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, a menos que CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL las vuelva a activar. Para establecer una tasa de muestreo en lugar de desactivarlas por completo, usa el ajuste feedbackSurveyRate. Consulta Encuestas de calidad de sesión
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING Establécela en 1 para desactivar el checkpointing de archivos. El comando /rewind no podrá restaurar los cambios de código. Tiene prioridad sobre el ajuste fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS Establécela en 1 para eliminar del contexto de Claude las instrucciones integradas de flujo de trabajo de commits y PR, así como 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_INLINE_SHELL_RM_PROMPT Establécela en 1 para evitar que Claude Code lea los scripts que se pasan a un shell con -c, como bash -c 'rm -rf ~', en busca de eliminaciones en rutas críticas. Claude Code sigue comprobando los destinos que son variables del shell y parámetros posicionales en esos scripts, y las demás comprobaciones de rutas críticas siguen ejecutándose. Establécela en el entorno que inicia Claude Code, ya que Claude Code ignora una copia entregada a través de un bloque env de la configuración. Requiere Claude Code v2.1.288 o posterior
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP 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, Google Cloud's Agent Platform ni Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Establécela en 1 para evitar que Claude Code en Amazon Bedrock y Google Cloud's Agent Platform cambie a un modelo anterior cuando tu cuenta pierde el acceso al modelo de una sesión a mitad de la sesión; en su lugar, la solicitud rechazada falla de inmediato. Una cadena de modelos de respaldo que configures sigue cambiando ante ese rechazo, y las comprobaciones de modelo al inicio siguen recurriendo a un respaldo al iniciar. Requiere Claude Code v2.1.285 o posterior
CLAUDE_CODE_DISABLE_MOUSE Establécela en 1 para desactivar el seguimiento del mouse en el renderizado a pantalla completa. El desplazamiento con el teclado mediante PgUp y PgDn sigue funcionando. Úsala para conservar el comportamiento nativo de copiar al seleccionar de tu terminal
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Establécela en 1 para desactivar la gestión de clics, arrastres y desplazamiento del puntero en el renderizado a pantalla completa manteniendo el desplazamiento con la rueda del mouse. Úsala cuando quieras que el desplazamiento con la rueda funcione dentro de Claude Code, pero no quieras que los clics posicionen el cursor, expandan la salida de las herramientas o abran enlaces. CLAUDE_CODE_DISABLE_MOUSE tiene precedencia cuando ambas están establecidas. Requiere Claude Code v2.1.195 o posterior
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION Establécela en 1 para evitar que Claude Code vuelva a leer el certificado y la clave de cliente mTLS cuando una solicitud a la API falla con un error a nivel de conexión, como un restablecimiento de la conexión o un error en el protocolo de enlace TLS. Con la recarga desactivada, Claude Code carga los archivos rotados solo la próxima vez que aplica la configuración o en el siguiente inicio. Requiere Claude Code v2.1.232 o posterior
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Establécela en cualquier valor no vacío, como 1, para desactivar el tráfico de red no esencial: actualizaciones automáticas, telemetría, informes de errores, el comando /feedback, los comentarios redactados por Claude, las notas de la versión, las comprobaciones de la insignia de estado de PR y MR y las comprobaciones de disponibilidad, como la comprobación del modo rápido. También detiene las ejecuciones en segundo plano de los orígenes command de plugins, que son comandos locales y no tráfico de red, porque pueden desencadenar instalaciones de dependencias. Establecerla en 0 o false sigue desactivando este tráfico, a diferencia de la mayoría de las variables de activación y desactivación; elimina la variable para volver a permitirlo. También desactiva la obtención de feature flags, lo que hace que Remote Control y las demás funciones que necesitan la obtención de feature flags no estén disponibles. La instalación automática del marketplace oficial de plugins no está 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 ejecuciones duplicadas de herramientas
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Establécela en 1 para enviar la notificación de escritorio de la herramienta PushNotification incluso mientras escribes en la terminal o esta tiene el foco. De forma predeterminada, la herramienta omite tanto la notificación de escritorio como la notificación push móvil cuando detecta actividad reciente del teclado o que la terminal tiene el foco. Esta variable solo desactiva esa comprobación local, por lo que el servidor aún puede suprimir la notificación push móvil cuando detecta que estás activo. Requiere Claude Code v2.1.193 o posterior
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL Establécela en 1 para desactivar el registro automático del marketplace oficial de plugins. Claude Code lee la variable cuando está a punto de registrar el marketplace, normalmente durante el primer inicio interactivo en una máquina. Si la variable está establecida en ese momento, Claude Code omite el registro de forma permanente. Eliminar la variable más tarde no deshace la omisión. Ejecuta claude plugin marketplace add anthropics/claude-plugins-official para registrar el marketplace en cualquier momento
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS Establécela en 1 para evitar que Claude Code ejecute tus hooks Notification para solicitudes de permiso sin responder en las sesiones en las que Claude Code las envía al callback canUseTool del Agent SDK, que es como Claude Desktop y la extensión de VS Code alojan Claude Code. No tiene efecto en las 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 en contenedores o de CI que no deben cargar skills aprovisionados por el operador
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY Establécela en 1 para desactivar la comprobación de la herramienta PowerShell que deniega los comandos integrados de cmd rd, rmdir, del y erase en una ruta del sistema, como la raíz de una unidad o tu directorio home. Claude Code ignora esta variable en el bloque env de un archivo de configuración. Requiere Claude Code v2.1.283 o posterior
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK Establécela en 1 para desactivar el cambio automático de modelo cuando un clasificador de seguridad marca una solicitud, el comportamiento que controla el ajuste switchModelsOnFlag
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS Establécela en 1 para evitar que Claude Code envíe el campo de salida estructurada output_config.format y el valor de anthropic-beta que lo acompaña, para un gateway de LLM cuyo servicio de origen los rechaza. Esto deja activadas las demás capacidades de versiones 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 íntegramente 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 y 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 el pensamiento no se puede desactivar. En proveedores externos, 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 en su lugar la ventana asumida; 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 a pantalla completa y renderizar todos los mensajes de la transcripción. Úsala si al desplazarte en el modo de pantalla completa aparecen regiones en blanco donde deberían aparecer mensajes
CLAUDE_CODE_DISABLE_WEB_FETCH Establécela en 1 para desactivar la herramienta WebFetch. La herramienta WebSearch sigue disponible. Requiere Claude Code v2.1.285 o posterior
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER Establécela en 1 para iniciar los comandos de la herramienta PowerShell en Windows directamente en lugar de a través del lanzador cmd.exe. De forma predeterminada, el lanzador permite que un comando de PowerShell que se ejecuta en segundo plano se traslade al siguiente proceso de la sesión, como cuando envías la sesión a segundo plano. Si estableces la variable, un comando de PowerShell en segundo plano se detiene cuando el proceso de la sesión termina. 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 ningún efecto. El modo automático está disponible de forma predeterminada en todos los proveedores, incluidos Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry y las sesiones con sesión iniciada del Claude apps gateway. De la v2.1.158 a la v2.1.206, era necesario establecer esta variable en 1 para que el modo automático estuviera disponible en esos proveedores
CLAUDE_CODE_ENABLE_AWAY_SUMMARY Sobrescribe la disponibilidad del resumen de sesión. Establécela en 0 para forzar la desactivación de los resúmenes independientemente del interruptor de /config. Establécela en 1 para forzar su activación cuando awaySummaryEnabled es false. Tiene precedencia sobre el ajuste y el interruptor de /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Establécela en 1 para actualizar el estado de los plugins entre turnos en el modo no interactivo después de que finalice una instalación en segundo plano. Está desactivada de forma predeterminada porque la actualización cambia el prompt del sistema a mitad de la sesión, lo que invalida la caché de prompts para ese turno
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL Establécela en 1 para enviar la encuesta de calidad de sesión "How is Claude doing?" a tu propio recopilador de OpenTelemetry cuando el tráfico no esencial dirigido a Anthropic está bloqueado. Las calificaciones de la encuesta se emiten solo como eventos OTEL a tu recopilador configurado. En este modo no se envía ningún dato de la encuesta a Anthropic. Se aplica cuando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY o DO_NOT_TRACK está establecida, 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. Si está desactivada, una entrada de herramienta grande, como la escritura de un archivo largo, llega solo después de que Claude termina de generarla, lo que puede parecer que se quedó colgado. Está activada de forma predeterminada en la API de Anthropic. En Amazon Bedrock y Google Cloud's Agent Platform, se activa por modelo cuando el contenedor desplegado lo admite. Establécela en 0 para desactivarla. Establécela en 1 para forzar su activación al enrutar a través de un proxy mediante ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL o ANTHROPIC_BEDROCK_BASE_URL. Está desactivada de forma predeterminada en Microsoft Foundry y en las conexiones a través de un gateway
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Establécela en 1 para llenar el selector de /model con 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. Está 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 mediante una lista de modelos permitidos availableModels que recibe la sesión; entrega la lista mediante MDM o un archivo de configuración administrada, ya que la entrega administrada por el servidor no está disponible en configuraciones con gateway
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE Se eliminó en la v2.1.142, cuando el valor predeterminado del modo rápido pasó de Opus 4.6 a Opus 4.7
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION Establécela en false para desactivar las sugerencias de prompts, las predicciones en gris que aparecen en la entrada del prompt. Tiene precedencia sobre el ajuste promptSuggestionEnabled, que es el 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 activar la recopilación de datos de OpenTelemetry para métricas y registros. Es obligatoria antes de configurar los exportadores de OTel. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local. Consulta Monitoreo
CLAUDE_CODE_ENABLE_TODO_TOOLS Establécela en 1 para obtener las herramientas de seguimiento de tareas en todos los modelos. Sin ella, Claude Code las proporciona de forma predeterminada solo en los modelos indicados en Disponibilidad de la herramienta Task. CLAUDE_CODE_ENABLE_TASKS sigue seleccionando entre 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. Es útil para flujos de trabajo automatizados y scripts que usan el modo SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS Establécela en 1 para activar los equipos de agentes. Los equipos de agentes son experimentales y están desactivados de forma predeterminada
CLAUDE_CODE_EXTRA_BODY Objeto JSON que se combina en el nivel superior del cuerpo de cada solicitud a la API. Es ú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 lanzas con claude agents o --bg. Antes de la 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. Es útil cuando necesitas leer archivos más grandes completos
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Establécela en 1 para forzar la persistencia de la transcripción, el historial de prompts y el registro en claude agents incluso cuando este claude se inició desde dentro de otra sesión de Claude Code. Úsala cuando un valor heredado de CLAUDE_CODE_CHILD_SESSION, por ejemplo de una sesión de screen o de un lanzador en segundo plano iniciado por primera vez por la herramienta Bash de Claude Code, provoca que una sesión genuina de nivel superior se clasifique erróneamente como anidada. A partir de la v2.1.178, Claude Code detecta automáticamente el caso de tmux e ignora el marcador heredado, por lo que tmux ya no necesita esta variable. También se respeta en la v2.1.169 y anteriores; no tiene efecto en la v2.1.170 ni en la v2.1.171, donde se eliminó la detección de sesiones anidadas que sobrescribe
CLAUDE_CODE_FORCE_STRIKETHROUGH Establécela en 1 para forzar la representación tachada de ~~text~~ en las respuestas de Claude cuando tu terminal lo admite pero no se detecta automáticamente, como a través de SSH sin reenviar TERM_PROGRAM. Sin ella, las terminales no detectadas muestran los marcadores ~~ literales en lugar de representar el texto como 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. Es útil para emuladores como eat de Emacs, que implementan BSU/ESU pero no responden a la consulta de capacidades. No tiene efecto dentro de tmux. A diferencia de CLAUDE_CODE_NO_FLICKER, que cambia a la representación en pantalla completa, esta variable no cambia el renderizador
CLAUDE_CODE_FORK_SUBAGENT Controla el modo de bifurcación, que permite a Claude generar por sí mismo subagentes bifurcados y está activado de forma predeterminada solo en sesiones interactivas. Establécela en 1 para activarlo también en claude -p y el Agent SDK, o en 0 para desactivarlo en todos los tipos de sesión. Puedes ejecutar /subtask tanto si el modo de bifurcación 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 de bifurcación
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 arnés invoca claude y no puede pasar el flag por sí mismo. A diferencia del flag, que termina con un error fuera del modo no interactivo con salida stream-json, la variable se ignora en ese caso para que las invocaciones anidadas sigan funcionando cuando está establecida 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 indicación para gateways, como x-claude-code-request-class y x-claude-code-compaction, en un proxy personalizado o un proveedor externo como Amazon Bedrock o Claude Platform on AWS. Establécela en 0 para dejar de enviarlos en todas las conexiones, incluida una conexión directa a la API de Anthropic, donde Claude Code los envía de forma predeterminada. Requiere Claude Code v2.1.273 o posterior
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS Tiempo de espera en milisegundos para la solicitud de descubrimiento de modelos del gateway que activa CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY (predeterminado: 3000). Auméntalo cuando tu gateway necesite más de tres segundos para responder a /v1/models al 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 o 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 la v2.1.219, Claude Code salía 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 archivos ocultos (dotfiles) de los resultados cuando Claude invoca la herramienta Glob. Se incluyen de forma predeterminada. No afecta al autocompletado de archivos con @, ls, Grep ni 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. Establécela en 0 para desactivar las revisiones. Indica minutos enteros en dígitos simples, como máximo 10080, que equivale a una semana. Claude Code trata cualquier otro valor como no establecido y usa el predeterminado. Requiere Claude Code v2.1.234 o posterior
CLAUDE_CODE_HIDE_CWD Establécela en 1 para ocultar el directorio de trabajo en el logotipo de inicio. Es ú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 del host que se usa para conectarse a la extensión del IDE. De forma predeterminada, Claude Code detecta automáticamente la dirección correcta, incluido el enrutamiento de WSL a Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL Establécela en 1 para omitir la instalación automática de 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 se está ejecutando
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 otro valor se ignora, por lo que la variable puede ajustar el límite pero no desactivarlo. Requiere Claude Code v2.1.217 o posterior
CLAUDE_CODE_MAX_CONTEXT_TOKENS Sobrescribe el tamaño de la ventana de contexto que Claude Code asume para el modelo activo. A partir de la 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 otro valor se ignora y se aplica el predeterminado. Requiere Claude Code v2.1.280 o posterior
CLAUDE_CODE_MAX_OUTPUT_TOKENS Establece el número máximo de tokens de salida para la mayoría de las solicitudes. Los valores predeterminados y los límites varían según el modelo; consulta tokens de salida máximos. Claude Code reduce al límite un valor que supera el límite de un modelo. Para un ID de modelo que Claude Code no puede resolver a un modelo conocido, 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 la v2.1.186; a partir de la v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG aumenta el valor predeterminado y elimina el límite. Para sesiones desatendidas que necesitan esperar a que pasen interrupciones más largas, establece CLAUDE_CODE_RETRY_WATCHDOG en su lugar
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Se eliminó en la v2.1.224 y ahora no tiene ningún efecto. Anteriormente limitaba el número total de subagentes que Claude podía generar con la herramienta Agent en una sesión (predeterminado: 200); generar más allá del límite fallaba con Subagent spawn limit reached. El límite de subagentes simultáneos y el límite de profundidad siguen aplicándose
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Número de capas de subagentes permitidas por debajo de la conversación principal (predeterminado: 3). Con el valor predeterminado, los subagentes pueden generar sus propios subagentes, y un subagente en la tercera capa no puede generar más; establécela en 1 para desactivar el anidamiento. De la v2.1.217 a la v2.1.218, el valor predeterminado era 1, por lo que un subagente no podía generar los suyos a menos que aumentaras el límite; la v2.1.219 aumentó el valor predeterminado a 3. Acepta un número entero positivo en dígitos simples; cualquier otro valor se ignora, por lo que el límite se puede ajustar pero no eliminar. Requiere Claude Code v2.1.217 o posterior
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY Número máximo de herramientas de solo lectura y subagentes que se pueden ejecutar en paralelo (predeterminado: 10). Los valores más altos aumentan el paralelismo pero consumen más recursos
CLAUDE_CODE_MAX_TURNS Limita el número de turnos agénticos cuando no se pasa un límite explícito. Equivale a pasar --max-turns, que tiene precedencia cuando ambos están establecidos. Un valor que no es un entero positivo se rechaza al 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 siguientes llamadas 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 otro valor se ignora y se aplica el predeterminado, por lo que el límite se puede aumentar pero no desactivar. Requiere Claude Code v2.1.212 o posterior
CLAUDE_CODE_MCP_ALLOWLIST_ENV Establécela en 1 para iniciar los servidores MCP stdio solo con un entorno base seguro más el env configurado del servidor, en lugar de heredar el entorno de tu shell
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Tiempo transcurrido en milisegundos antes de que una llamada a herramienta MCP que sigue en ejecución pase a una tarea en segundo plano (predeterminado: 120000, o 2 minutos). Establécela en 0 para desactivar el paso automático a segundo plano. Requiere Claude Code v2.1.212 o posterior
CLAUDE_CODE_MCP_STARTUP_WAIT_MS Cuánto tiempo en milisegundos espera el primer turno de una sesión no interactiva a los servidores MCP que todavía se están conectando, en lugar de la espera del primer turno predeterminada. Cuando está establecida, la espera cubre 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 un conector de claude.ai no envía ninguna respuesta ni ninguna notificación de progreso durante este tiempo, la llamada a herramienta se aborta con un error en lugar de esperar al MCP_TOOL_TIMEOUT general. Sobrescribe los valores predeterminados por transporte de 300000 (5 minutos) para servidores de red y de 1800000 (30 minutos) para 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 de al menos 1000 en .mcp.json eleva la ventana de inactividad de ese servidor al menos al 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 la v2.1.203, los servidores stdio estaban exentos del tiempo de espera por inactividad
CLAUDE_CODE_MESSAGING_SOCKET La establece Claude Code, no tú: en las sesiones que vinculan un socket de bandeja de entrada, Claude Code exporta la ruta de ese socket a los hooks y 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 una sesión principal, 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 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 procesos hijos propios indican cuándo consulta Claude Code el token. Cada sesión exporta su propio token, nunca uno heredado de una sesión principal. 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 de tmux en modo de control en pausa o una conexión SSH detenida, no pueda congelar Claude Code a mitad de la sesión. Se aplica en macOS, Linux y WSL cuando stdout es una terminal. Requiere Claude Code v2.1.261 o posterior
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Limita cuántas veces Claude Code vuelve a enviar una solicitud sin streaming cuyo tiempo de espera se agota. Con 0, la solicitud falla en el primer tiempo de espera agotado. No está establecida de forma predeterminada, por lo que CLAUDE_CODE_MAX_RETRIES limita estos reenvíos. Consulta Ajustar el comportamiento de reintentos para conocer el tiempo de espera. Requiere Claude Code v2.1.285 o posterior
CLAUDE_CODE_NO_FLICKER Establécela en 1 para activar 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 está establecida, claude auth login intercambia este token directamente en lugar de abrir un navegador. Requiere CLAUDE_CODE_OAUTH_SCOPES. Es ú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". Es obligatoria cuando CLAUDE_CODE_OAUTH_REFRESH_TOKEN está establecida
CLAUDE_CODE_OAUTH_TOKEN Token de acceso de OAuth para la autenticación de claude.ai. Alternativa a /login para el SDK y entornos automatizados. Tiene precedencia sobre las credenciales almacenadas en el llavero. Genera uno con claude setup-token. A menos que ejecutes /login, Claude Code usa el token que estableces durante toda la sesión. Para reemplazar un token caducado, genera uno nuevo y reinicia
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Se eliminó en la v2.1.160 y ahora no tiene ningún efecto. Anteriormente fijaba el modo rápido a Claude Opus 4.6 en lugar del predeterminado actual. Opus 4.6 ya no admite el modo rápido
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Longitud máxima de los atributos de OpenTelemetry que contienen contenido (respuestas del modelo, contenido de herramientas, prompts del sistema, cuerpos sin procesar de la API), incluido el marcador de truncamiento, en unidades de código UTF-16 (predeterminado: 61440, es decir, 60 KB). Auméntala solo si tu backend de telemetría acepta valores de atributos superiores a 64 KB, o redúcela para disminuir el volumen de telemetría. Requiere Claude Code v2.1.214 o posterior. Consulta Monitoreo
CLAUDE_CODE_OTEL_DIAG_STDERR Establécela en 1 para escribir en stderr los errores de diagnóstico del exportador de OpenTelemetry. De forma predeterminada, estos errores solo aparecen con --debug, por lo que un exportador mal configurado, como uno con una colisión de puertos de Prometheus, de otro modo falla silenciosamente. Requiere Claude Code v2.1.179 o posterior. Consulta Monitoreo
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS Tiempo de espera en milisegundos para vaciar los spans pendientes de OpenTelemetry (predeterminado: 5000). Consulta Monitoreo
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervalo para actualizar los encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulta Encabezados dinámicos
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS Tiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagarse (predeterminado: 2000). Auméntalo si se pierden métricas al salir. Consulta Monitoreo
CLAUDE_CODE_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 hay una nueva versión disponible. Se aplica a 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 activar la protección contra escritura compatible con Perforce. Cuando está establecida, Edit, Write y NotebookEdit fallan con una sugerencia de p4 edit <file> si el archivo de destino no tiene el bit de escritura del propietario, que Perforce borra en los archivos sincronizados hasta que p4 edit los abre. Esto evita que Claude Code omita 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 principal, no la caché en sí: los marketplaces y la caché de plugins se encuentran en subdirectorios bajo esta ruta. El valor predeterminado es ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS Directorios de plugins que se cargan para la sesión, cada uno de la misma forma en que lo carga un flag --plugin-dir. Separa varias rutas con : en Unix o con ; en Windows. Indica cada ruta como una ruta absoluta o haz que empiece 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 Se agotó el tiempo de espera de git clone
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE Establécela en 1 para omitir el intento de volver a clonar y seguir usando la copia existente del marketplace cuando una actualización del marketplace no puede acceder al remoto o autenticarse en él. Es útil en entornos sin conexión o aislados (airgapped) donde volver a clonar fallaría de la misma forma. Consulta Las actualizaciones del marketplace fallan en entornos sin conexión
CLAUDE_CODE_PLUGIN_PREFER_HTTPS Establécela en 1 para clonar los orígenes abreviados owner/repo de GitHub a través de HTTPS en lugar de SSH. Se aplica a la instalación y actualización de plugins, y a /plugin marketplace add y update. Es ú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 previamente llenado 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 Llenar previamente los plugins para contenedores
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY Establécela en 1 para que Claude Code deje de pasar -ExecutionPolicy Bypass al iniciar PowerShell para llamadas a herramientas, hooks y comandos de la línea de estado, y respete en su lugar la directiva de ejecución efectiva de la máquina. De forma predeterminada, Claude Code omite la directiva de ejecución en el alcance del proceso para que los scripts .ps1 y las importaciones de módulos funcionen en instalaciones de Windows con Restricted de forma predeterminada. La omisión en el alcance del proceso nunca sobrescribe las directivas de grupo MachinePolicy ni UserPolicy, independientemente de este ajuste
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Límite máximo en milisegundos de la espera inactiva del trabajo en segundo plano, como subagentes y flujos de trabajo, después del turno final en el 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 lanza desde su propio binario, como el servicio en segundo plano que aloja las sesiones de agent view, a través de un lanzador corporativo indicado como prefijo 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 desvinculado 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/ bajo el cual 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 los 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 Establécela en 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, con -p y del SDK, además de los asistentes 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 cubre 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á activada cuando hay una conexión directa a la API de Anthropic. Se agregó en la v2.1.152. Consulta Trazas (beta)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST La establecen las plataformas host que integran Claude Code y gestionan el enrutamiento del proveedor del modelo en su nombre. Cuando está establecida, Claude Code ignora en los archivos de configuración las variables de selección de proveedor, endpoint y autenticación, como CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY, de modo que la configuración de usuario no puede sobrescribir el enrutamiento del host. Claude Code también ignora las claves de selección de modelo, como model, fallbackModel y modelOverrides, en la configuración administrada, sea cual sea el origen administrado que las entregue, de modo que la configuración de modelo del host tiene precedencia sobre una fijación de modelo administrada desactualizada. Claude Code también ignora las variables de selección de modelo, como ANTHROPIC_MODEL y la familia ANTHROPIC_DEFAULT_*_MODEL, en un bloque env administrado; una lista de modelos 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 aplica en otros casos en proveedores externos como Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform y Microsoft Foundry, de modo que la telemetría sigue la exclusión estándar con 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. Es una 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 regreso a la transcripción de la sesión. Consulta Enlazar la salida de vuelta a la sesión
CLAUDE_CODE_RESTRICTED Establécela en 1 para iniciar la sesión en modo restringido, lo mismo que pasar --restricted. Claude Code ignora esta variable en el bloque env de un archivo de configuración. Requiere Claude Code v2.1.248 o posterior
CLAUDE_CODE_RESUME_INTERRUPTED_TURN Establécela en 1 para reanudar automáticamente si la sesión anterior terminó a mitad de un turno. Se usa en el modo SDK para que el modelo continúe sin que el SDK tenga que volver a enviar el prompt. Para desactivarla, elimina la variable o establécela en 0. Para el panel de chat de VS Code, consulta Continuar conversaciones después de recargar
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS Antigüedad máxima en milisegundos del último mensaje de la transcripción para que una sesión que terminó a mitad de un turno continúe automáticamente al reanudarse. Cuando el último mensaje es más antiguo que este límite, Claude Code omite la reanudación automática de CLAUDE_CODE_RESUME_INTERRUPTED_TURN y su mensaje de continuación CLAUDE_CODE_RESUME_PROMPT, y la sesión se inicia inactiva para que continúes de forma explícita. Sin establecer o 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 sobre una transcripción antigua no vuelva a ejecutar un prompt obsoleto. Claude Code establece por sí mismo un límite de una hora cuando reinicia una sesión de agent view 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 arneses de evaluación, trabajos de CI o trabajadores remotos. Reintenta indefinidamente los errores de capacidad 429 y 529 en lugar de fallar después de CLAUDE_CODE_MAX_RETRIES intentos. Claude Code falla de inmediato cuando una solicitud de velocidad estándar recibe un 429 que informa de un límite de gasto o de créditos de uso agotados, incluso uno procedente de un límite de gasto del gateway que se restablece según una programación. Antes de la 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 una hora de restablecimiento del rate limit, de modo que una sesión que alcanza un límite de uso espera a que pase la ventana restante. En la v2.1.199 o posterior, también aumenta a 300 el número predeterminado de reintentos para otros errores transitorios, como errores del servidor, tiempos de espera agotados y conexiones interrumpidas, lo que equivale aproximadamente a tres horas de espera, y elimina el límite de 15 en CLAUDE_CODE_MAX_RETRIES si estableces esa variable explícitamente. Requiere Claude Code v2.1.186 o posterior
CLAUDE_CODE_SAFE_MODE Establécela en 1 para iniciar en modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos y agentes personalizados, estilos de salida, flujos de trabajo, temas personalizados, atajos de teclado personalizados, comandos de la línea de estado y de sugerencia de archivos, servidores LSP y memoria automática no se cargan, para solucionar problemas de una configuración dañada. La política de configuración administrada sigue aplicándose, incluidos los hooks, la línea de estado y los comandos de sugerencia de archivos configurados por la política; los plugins administrados, los skills administrados, el CLAUDE.md administrado y los servidores MCP configurados por la política no se cargan. Equivale a pasar --safe-mode. Los procesos hijos iniciados directamente heredan la variable
CLAUDE_CODE_SCRIPT_CAPS Objeto JSON que limita cuántas veces se pueden invocar scripts específicos por sesión cuando CLAUDE_CODE_SUBPROCESS_ENV_SCRUB está establecida. Las claves son subcadenas que se comparan con el texto del comando; los valores son límites enteros de llamadas. Por ejemplo, {"deploy.sh": 2} permite llamar a deploy.sh como máximo dos veces. La coincidencia se basa en subcadenas, por lo que trucos de expansión del shell como ./scripts/deploy.sh $(evil) siguen contando para el límite. La ramificación en tiempo de ejecución mediante xargs o find -exec no se detecta; 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 de hasta 20, incluidos valores fraccionarios inferiores a 1, como 0.5, para ralentizar el desplazamiento acelerado del trackpad y de la rueda en terminales que ya amplifican los eventos de la rueda. Establécela en 3 para igualar a vim si tu terminal envía un evento de rueda por muesca sin amplificación. Se ignora en la terminal del IDE de JetBrains, donde Claude Code usa su propio manejo del desplazamiento
CLAUDE_CODE_SEND_FEEDBACK Establécela en 0 para desactivar los comentarios redactados por Claude en una sesión. Establécela en 1 para activarlos cuando tu cuenta ya tiene acceso; la variable no puede conceder el acceso por sí misma, y los demás interruptores que desactivan los comentarios, como DISABLE_FEEDBACK_COMMAND y el valor off del ajuste feedbackDrafts, siguen aplicándose
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS Sobrescribe el presupuesto de tiempo en milisegundos para los hooks SessionEnd. El valor también es el tiempo de espera de cada hook que no establece su propio timeout. Se aplica al salir de la sesión, a /clear y al cambiar de sesión mediante /resume interactivo. De forma predeterminada, el presupuesto es de 1,5 segundos y se eleva automáticamente al timeout por hook más alto configurado en los archivos de configuración, hasta 60 segundos. Los tiempos de espera de los hooks proporcionados por plugins no elevan el presupuesto
CLAUDE_CODE_SESSION_ID Se establece automáticamente con el ID de la sesión actual en los subprocesos de las herramientas Bash y PowerShell, en los subprocesos de los comandos de hooks y en los subprocesos de los servidores MCP stdio. Para Bash, PowerShell y 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 inicial del arranque. Úsala para correlacionar scripts y herramientas externas con la sesión de Claude Code que los inició
CLAUDE_CODE_SHELL Establece el shell que usa Claude Code para ejecutar los comandos de la herramienta Bash. Acepta una ruta a un binario de bash o zsh, por ejemplo /opt/homebrew/bin/bash. Otros shells, como fish, no son compatibles. Si el valor no es una ruta funcional de bash o zsh, Claude Code lo ignora y recurre a la detección automática. La detección automática usa tu $SHELL cuando apunta a bash o zsh; de lo contrario, elige el primer zsh funcional y luego bash que encuentre en tu PATH y en las ubicaciones de instalación estándar
CLAUDE_CODE_SHELL_PREFIX Prefijo de comando que envuelve los comandos de shell que inicia Claude Code: llamadas a la herramienta Bash, comandos de hooks, comandos de la línea de estado y comandos de inicio de servidores MCP stdio. Los hooks de PowerShell y los hooks en formato exec se ejecutan sin el prefijo. Es ú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 envoltorio recibe la línea de comandos como un único argumento entrecomillado para el shell en $1, por lo que el envoltorio 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 siguen cargándose. No se leen los tokens de OAuth ni las credenciales del llavero, por lo que la autenticación de Anthropic debe provenir de ANTHROPIC_API_KEY o de un apiKeyHelper en --settings. Equivale a pasar --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT Establécela en 1 para usar un prompt del sistema más corto y descripciones de herramientas abreviadas en cualquier modelo. Establécela en 0, false, no u off para desactivarlo incluso en modelos en los que el experimento o la configuración del servidor lo activarían en otro caso. El conjunto completo de herramientas, los hooks, los servidores MCP y el descubrimiento de CLAUDE.md siguen activados
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 a partir de la cadena de proveedores de credenciales predeterminada de AWS, de modo que Claude Code resuelva la cadena en cada solicitud a la API. Con la caché desactivada, un perfil respaldado por SSO solicita credenciales a IAM Identity Center en cada solicitud. Consulta almacenamiento en caché de credenciales y tiempo de espera de resolución. Requiere Claude Code v2.1.207 o posterior
CLAUDE_CODE_SKIP_BEDROCK_AUTH Omite la autenticación de AWS para Amazon Bedrock (por ejemplo, al usar un gateway de LLM)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS Establécela en 1 para tratar una comprobación fallida de disponibilidad del modo rápido como disponible, para redes que bloquean la solicitud directa de la comprobación a api.anthropic.com. Claude Code sigue respetando una respuesta "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 desactivado
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 ANTHROPIC_FOUNDRY_API_KEY o ANTHROPIC_FOUNDRY_AUTH_TOKEN está establecida. Antes de la v2.1.203, esta variable dejaba al cliente de Microsoft Foundry sin poder enviar solicitudes a menos que también se estableciera una clave de API
CLAUDE_CODE_SKIP_MANTLE_AUTH Omite la autenticación de AWS para Amazon Bedrock Mantle (por ejemplo, al usar un gateway de LLM)
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY Las comprobaciones de modelos al iniciar en Amazon Bedrock y Google Cloud's Agent Platform recuerdan en esta máquina, durante un máximo de un día, qué modelos detectaron que tu cuenta no puede invocar. 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 no escribir en disco el historial de prompts ni las transcripciones de sesión. Las sesiones iniciadas con esta variable establecida no aparecen en --resume, --continue ni en el historial de la flecha hacia arriba. Es ú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 en los fallos de inicio que, de lo contrario, terminan solo con stderr. Requiere Claude Code v2.1.274 o posterior
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Número máximo de veces consecutivas que un hook Stop o SubagentStop puede impedir que termine el turno antes de que Claude Code lo sobrescriba y termine el turno de todos modos (predeterminado: 8). Establécela en 0 para desactivar el límite. Auméntalo 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 asigna un modelo de otra forma. Acepta un alias como haiku o un nombre de modelo completo. Dos orígenes tienen precedencia sobre ella: un modelo que Claude pasa cuando genera el agente y un campo model en la definición del agente, incluido inherit. Para cambiar eso, establece CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Consulta Elegir un modelo para ver el orden completo. Establecerla en inherit es lo mismo que dejarla sin establecer. Antes de la v2.1.251, esta variable sobrescribía tanto el modelo por invocación como el campo model de la definición
CLAUDE_CODE_SUBAGENT_MODEL_FORCE Establécela en 1 para forzar un único modelo en los subagentes, los compañeros de equipo y los agentes de flujos de trabajo. Ejecutar todos los subagentes con un solo modelo indica qué modelo es. Requiere Claude Code v2.1.257 o posterior
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL Establécela en 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 que inicia Claude Code, como los comandos de Bash, los hooks y los servidores MCP stdio. La limpieza reconoce una credencial por el nombre de su variable o por su valor, y deja intactos los tokens de GitHub y la configuración de proxy. Consulta Qué elimina la limpieza del entorno de los subprocesos. claude-code-action la establece automáticamente cuando se configura allowed_non_write_users
CLAUDE_CODE_SYNC_PLUGIN_INSTALL Establécela en 1 en el modo no interactivo (el flag -p) para esperar a que finalice la instalación de los plugins antes de la primera consulta. Sin ella, 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 los plugins y registra un error. No tiene valor predeterminado: sin esta variable, la instalación síncrona espera hasta completarse
CLAUDE_CODE_SYNC_SKILLS Establécela en 1 en el modo no interactivo con el flag -p para que Claude Code descargue en esa ejecución los skills activados para tu cuenta de claude.ai y espere su lista, 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 la 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 la 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 CLAUDE_CODE_SYNC_SKILLS está establecida (predeterminado: 5000). Cuando se supera, la primera consulta se ejecuta con los skills que hayan llegado. Las descargas terminan en segundo plano en cualquier caso, y Claude espera la descarga de un skill cuando invoca ese skill
CLAUDE_CODE_SYNTAX_HIGHLIGHT Establécela en false para desactivar el resaltado de sintaxis en la salida de los diffs. Es ú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 coordinarse en una lista de tareas compartida, en sesiones que tienen las herramientas Task. Consulta Lista de tareas
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS Sobrescribe, en milisegundos, cuánto tiempo espera una sesión no interactiva al salir a que su equipo de agentes termine de cerrarse. Acepta de 1000 a 60000; un valor fuera de rango se ignora y se aplica el predeterminado de 10000. Requiere Claude Code v2.1.206 o posterior
CLAUDE_CODE_TMPDIR Sobrescribe el directorio temporal que se usa para los archivos temporales internos. Claude Code agrega /claude-{uid}/ a esta ruta en Unix, o /claude/ en Windows. Predeterminado: /tmp en macOS, os.tmpdir() en Linux y Windows. En macOS y Linux, los subprocesos de Bash en sandbox reciben un $TMPDIR alternativo corto bajo el predeterminado del sistema cuando tu sobrescritura es una ruta larga, ya que algunas herramientas fallan cuando las rutas temporales son demasiado largas. Los comandos de Bash sin sandbox heredan el $TMPDIR de tu shell cuando está establecido. En Windows nativo, cuando tu shell no establece $TMPDIR, un comando de Bash que hace referencia a $TMPDIR recibe tu sobrescritura, o %TEMP% cuando no has establecido una. Los propios archivos temporales de Claude Code siempre usan tu sobrescritura. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local
CLAUDE_CODE_TMUX_TRUECOLOR Establécela en cualquier valor no vacío, como 1, para permitir la salida truecolor de 24 bits dentro de tmux. Establecerla en 0 o false sigue permitiendo truecolor, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para restaurar la limitación a 256 colores. De forma predeterminada, Claude Code se limita a 256 colores cuando $TMUX está establecida, porque tmux no transmite las secuencias de escape de 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 ver otros ajustes de tmux
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE En Linux y WSL, establécela en una lista separada por comas de los tipos de procesos que Claude Code excluye del límite de memoria de las herramientas, como mcp o lsp. Establécela en none para limitar todos los tipos, o en 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 indiques. Requiere Claude Code v2.1.246 o posterior
CLAUDE_CODE_TOOL_MEMORY_LIMIT En Linux y WSL, establécela en un tamaño como 4G para limitar la memoria que pueden usar los comandos de las herramientas Bash y PowerShell, y de la herramienta Monitor en la v2.1.246 o posterior. Escribe el tamaño en dígitos simples, solo para un número de bytes o con un sufijo K, M, G o T. Establécela en 0 u off para desactivar el límite. Una vez que el primer proceso que inicia Claude Code ha activado o desactivado el límite, un valor modificado surte efecto la próxima vez que inicies claude. Requiere Claude Code v2.1.233 o posterior
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC Establécela en 1 para limitar cuánto crece el archivo de transcripción de una sesión larga con -p o del Agent SDK. Después de cada compactación, una vez que el archivo supera los 5 MB, Claude Code elimina el historial anterior a esa compactación. Reanudar la sesión restaura la misma conversación tanto si el archivo se recortó como si no. Establécela en el entorno desde el que inicias Claude Code, ya que un bloque env de la configuración no puede activarla. Requiere Claude Code v2.1.287 o posterior
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Plazo en milisegundos antes de que Claude Code cancele un diálogo que reenvía a un cliente remoto, como un host de Remote Control o del SDK, o el diálogo de aprobación de un mensaje entre sesiones retenido; las solicitudes de permiso y las preguntas de AskUserQuestion usan sus propios flujos y no se rigen por esta variable. En Claude Code v2.1.236 o posterior, también limita la solicitud de consentimiento de créditos de uso de Fable a mitad de la sesión en una sesión que puede estar ejecutándose sin supervisión. Controlar los mensajes entrantes y sesiones no interactivas cubren las reglas completas de caducidad de los mensajes retenidos, incluidos los casos en los que el plazo no se aplica. 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 Mantle de Amazon Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH Establécela en 1 para descubrir comandos personalizados, subagentes y estilos de salida usando 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 activa automáticamente; establécela en 0 para desactivarla. 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 activarla en 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 activarla, lo que requiere pwsh en tu PATH. Cuando está activada en Windows, Claude puede ejecutar comandos de PowerShell de forma nativa en lugar de enrutarlos a través de Git Bash. Consulta Herramienta PowerShell
CLAUDE_CODE_USE_VERTEX Usa Google Cloud's Agent Platform
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS Establécela en la cantidad de milisegundos que WebFetch mantiene en caché la respuesta de cada URL obtenida. El valor predeterminado es 900000, que equivale a 15 minutos. Solo acepta dígitos simples; 0, un decimal o cualquier otra forma de escribirlo 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 del tiempo que WebFetch espera a que se descargue una página, incluidas las redirecciones que sigue. Una descarga que no se haya completado para entonces falla con un error de plazo. El valor predeterminado es 300000, que equivale a cinco minutos. Establécela en 0 para eliminar el límite. Solo acepta dígitos simples; un decimal o cualquier otra forma de escribirlo mantiene el valor predeterminado. Requiere Claude Code v2.1.268 o posterior
CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE Cuando CLAUDE_AUTO_BACKGROUND_TASKS está establecida en 1, el tiempo que Claude Code espera antes de cada recordatorio a Claude para que revise los subagentes en segundo plano que todavía se están ejecutando. Acepta una o más esperas separadas por comas en segundos enteros de 1 a 86400, como 600 o 600,1800,3600. Cada valor es la espera antes del siguiente recordatorio, y el último valor se repite. Solo acepta dígitos simples; cualquier otro valor o forma de escribirlo se interpreta como no establecido. Cuando no está establecida, no hay recordatorios. Requiere Claude Code v2.1.283 o posterior
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS Cuántos agentes ejecuta a la vez una sola ejecución de workflow, de 1 a 256. De forma predeterminada, una ejecución ejecuta hasta 16 agentes a la vez, o 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 acepta dígitos simples; los valores fuera de rango y otras formas de escribirlo mantienen el valor predeterminado. Requiere Claude Code v2.1.269 o posterior
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Límite superior en milisegundos del tiempo que un agente de workflow espera a que comience la primera respuesta de un agente hermano con el mismo prefijo antes de enviar su propia primera solicitud. Cuando un fan-out inicia varios agentes que comparten un prefijo de caché de prompts, Claude Code retiene a todos menos al primer agente hasta este tiempo para que el resto lea el prefijo en caché en lugar de que cada uno lo procese sin caché. Valor predeterminado: 5000. Establé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 (valor predeterminado: ~/.claude). Toda la configuración, el historial de sesiones y los plugins se almacenan en esta ruta. Para las credenciales, consulta dónde almacena Claude Code las credenciales. Útil para ejecutar varias cuentas en paralelo: por ejemplo, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local
CLAUDE_DISABLE_ADOPT Establécela en 1 para detener el trabajo en segundo plano en curso en lugar de trasladarlo cuando envías una sesión a segundo plano presionando ← o con /background. Claude Code te pide que confirmes antes de enviarla a segundo plano y luego detiene las tareas que de otro modo se trasladarían. Requiere Claude Code v2.1.195 o posterior
CLAUDE_EFFORT Se establece automáticamente en los subprocesos de la herramienta Bash y en los comandos de hooks con el nivel de esfuerzo vigente cuando se inicia el subproceso: low, medium, high, xhigh o max. Coincide con el campo effort.level que se pasa a los hooks. Solo se establece cuando el modelo actual admite el parámetro effort
CLAUDE_ENABLE_BYTE_WATCHDOG Establécela en 1 para forzar la activación del watchdog de inactividad de streaming a nivel de bytes, o en 0 para forzar su desactivación. 0 también desactiva el plazo del primer byte en las conexiones donde se aplica ese plazo. Cuando no está establecida, el watchdog está activado de forma predeterminada para las conexiones directas a la API de Anthropic y a Claude Platform on AWS, y para las respuestas en streaming en conexiones de gateway a las que se accede mediante ANTHROPIC_BASE_URL o ANTHROPIC_AWS_BASE_URL; antes de v2.1.222 no se ejecutaba en esas conexiones de gateway, por lo que el watchdog a nivel de eventos podía informar un bloqueo allí incluso mientras llegaban pings de keep-alive. Para los tiempos de espera y cómo interactúan los temporizadores, consulta Watchdogs de inactividad de streaming
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Establécela en 1 para activar el watchdog de inactividad de streaming a nivel de bytes en las respuestas vnd.amazon.eventstream de Amazon Bedrock, lo que también activa el plazo del primer byte en las solicitudes de streaming de Bedrock. Desactivado de forma predeterminada. Configura el tiempo de espera con CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENABLE_STREAM_WATCHDOG Establécela en 0 para forzar la desactivación del watchdog de inactividad de streaming a nivel de eventos, o en 1 para forzar su activación. Cuando no está establecida, el watchdog está activado de forma predeterminada para todos los proveedores. Antes de v2.1.196, el valor predeterminado sin establecer lo controlaba el servidor en la API directa de Anthropic y estaba desactivado en otros proveedores. Configura el tiempo de espera con CLAUDE_STREAM_IDLE_TIMEOUT_MS; para los otros temporizadores de bloqueo que se ejecutan junto con este, consulta Watchdogs de inactividad de streaming
CLAUDE_ENV_FILE Ruta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando de Bash en el mismo proceso de shell, de modo que las exportaciones del archivo sean visibles para el comando. Úsala para mantener la activación de virtualenv o conda entre comandos. También la rellenan dinámicamente los hooks SessionStart, Setup, CwdChanged y FileChanged
CLAUDE_JOB_DIR Claude Code la establece en cada sesión en segundo plano con el directorio ~/.claude/jobs/<id> de esa sesión. Los comandos de shell que ejecuta la sesión la heredan. Escribe los archivos temporales en $CLAUDE_JOB_DIR/tmp. Las llamadas Write y Edit de Claude allí no solicitan permiso, y el directorio se elimina cuando se borra la sesión
CLAUDE_PID Claude Code la establece con su propio ID de proceso en los subprocesos que genera: los comandos de las herramientas Bash y PowerShell y los comandos de hooks. En Linux, la integración de shell de la herramienta Bash la usa para rechazar un patrón de pkill que coincidiría con el propio proceso de Claude Code; consulta la referencia de errores. Léela desde tus propios scripts para identificar o enviar señales deliberadamente al proceso 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 de streaming, en las conexiones donde se aplica el plazo del primer byte. Para saber cómo lo limita Claude Code, el tiempo adicional que añade 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 más bajos se ajustan silenciosamente para absorber las pausas de pensamiento extendido y el almacenamiento en búfer del proxy, y el watchdog a nivel de bytes limita el valor a 30 minutos. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS tiene precedencia sobre esta variable para el watchdog a nivel de bytes. Para los valores predeterminados sin establecer de cada watchdog, consulta Watchdogs de inactividad de streaming
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS Eliminada en v2.1.260 y ahora no tiene efecto. Anteriormente limitaba, en milisegundos, cuánto tiempo 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 espacio de nombres como DEBUG=express:* establecidos para otras herramientas no lo activan
DISABLE_AUTOUPDATER Establécela en 1 para desactivar las actualizaciones automáticas en segundo plano. 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 controlar explícitamente 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 costo
DISABLE_DOCTOR_COMMAND Establécela en 1 para ocultar el skill de revisión de configuración /doctor y su alias /checkup. Útil para despliegues administrados en los que los usuarios no deberían ejecutar diagnósticos de configuración desde una sesión. No afecta al comando de terminal claude doctor. Antes de v2.1.205, esta variable ocultaba el comando de pantalla de diagnóstico /doctor
DISABLE_ERROR_REPORTING Establé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 cualquier nombre. 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 todos los flags. Esto hace que Remote Control y las demás funciones que necesitan la obtención de feature flags no estén disponibles. Establecerla en 0 o false mantiene la obtención activada. El registro de eventos de telemetría 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 la instalación, ya que 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, Google Cloud's Agent Platform o Microsoft Foundry)
DISABLE_INTERLEAVED_THINKING Establécela en 1 para evitar enviar el encabezado beta de interleaved-thinking. Ú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 del usuario como código, rutas de archivos o comandos de 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 actualizarse por su cuenta
DISABLE_UPGRADE_COMMAND Establécela en 1 para ocultar el comando /upgrade
DO_NOT_TRACK Establécela en 1 para excluirte de la telemetría, con el mismo efecto que DISABLE_TELEMETRY, incluso en la obtención de feature flags. Claude Code lee esta variable como un booleano estándar, por lo que 0 mantiene la telemetría activada, y la respeta como la convención entre herramientas reconocida por muchas CLI para desarrolladores
ENABLE_BETA_TRACING_DETAILED Establécela en 1, junto con BETA_TRACING_ENDPOINT, para activar el rastreo beta detallado, que añade atributos de span con contenido y el span claude_code.hook. Las sesiones interactivas de la CLI también requieren que tu organización esté en la lista de permitidos de la beta. Ambas variables se ignoran en la configuración de proyecto y local
ENABLE_CLAUDEAI_MCP_SERVERS Establécela en false para que Claude Code deje de obtener 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 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, Google Cloud's Agent Platform, 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 conservar 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 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 Google Cloud's Agent Platform 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 en el 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 Google Cloud's Agent Platform a menos que establecieras esta variable en true
FALLBACK_FOR_ALL_PRIMARY_MODELS Establécela en cualquier valor no vacío, como 1, para que Claude Code deje de reintentar ante errores de sobrecarga repetidos para todos los modelos cuando no hay un modelo de respaldo configurado. Establecerla en 0 o false también lo activa, a diferencia de la mayoría de las variables de activación/desactivación; elimina la variable para restaurar el comportamiento de reintento predeterminado. Sin ella, Claude Code deja de reintentar de esta manera en los modelos que reconoce como modelos Opus, Fable o Mythos cuando te autenticas con una clave de API o un proveedor de terceros en lugar de una suscripción a Claude. En Claude Code v2.1.160 o posterior, Claude Code cambia a tu cadena de modelos de respaldo configurada ante errores de sobrecarga repetidos para cualquier modelo principal, por lo que esta variable no afecta 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 compatibilidad en la terminal. Claude Code interpreta este valor como un número, no como un booleano, por lo que un valor como false, no u off activa los hipervínculos en lugar de desactivarlos. La insignia de PR o merge request del pie de página se muestra como hipervínculo incluso cuando Claude Code no puede detectar la compatibilidad de la terminal, por ejemplo a través de SSH. Establécela en 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 Cantidad máxima de tokens permitidos en las respuestas de herramientas MCP (valor predeterminado: 25000). Claude Code muestra una advertencia cuando la salida supera los 10,000 tokens. Las herramientas que declaran anthropic/maxResultSizeChars usan ese límite de caracteres para el contenido de texto, pero el contenido de imagen de esas herramientas sigue sujeto a esta variable. Un resultado de texto correcto de más de 50,000 caracteres de una herramienta sin esa anotación se guarda en un archivo independientemente de esta variable
MAX_STRUCTURED_OUTPUT_RETRIES Cantidad de intentos que Claude Code permite cuando la respuesta del modelo no supera la validación contra el --json-schema en modo no interactivo con el flag -p; 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 workflow 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 menos que el 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 cambio 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 más alto a los modelos que sabe que no aceptan esa combinación, como Opus 5. Para un valor positivo, Claude Code ignora el número en sí en los modelos con razonamiento adaptativo, excepto cuando CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING desactiva el razonamiento adaptativo
MCP_CLIENT_SECRET Secreto de cliente OAuth para servidores MCP que requieren credenciales preconfiguradas. Evita la solicitud interactiva al añadir 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 esperar al inicio de todos modos, excepto cuando se sirven desde la caché de descubrimiento, ya que sus herramientas deben estar presentes cuando se construye el primer prompt. En modo no interactivo (-p) sin --input-format stream-json, Claude Code también espera a los servidores aún pendientes antes del primer turno independientemente de esta variable. Cuando pasas --mcp-config explícitamente, la espera tiene un plazo más largo; consulta la entrada de ese flag para la excepción de servidores en caché
MCP_CONNECT_TIMEOUT_MS Cuánto tiempo espera el inicio bloqueante de MCP, en milisegundos, al lote de conexiones antes de tomar una instantánea de la lista de herramientas (valor predeterminado: 5000). Se aplica cuando MCP_CONNECTION_NONBLOCKING=0 o para los servidores marcados con alwaysLoad: true. Los servidores que siguen pendientes al llegar el plazo continúan conectándose en segundo plano. Distinta de MCP_TIMEOUT, que limita el intento de conexión de un servidor individual
MCP_DISCOVERY_CACHE Activa o desactiva la caché de descubrimiento de MCP. Con la caché activada, un servidor HTTP o SSE remoto que hayas usado antes puede mostrar el estado cached, y Claude Code lo conecta en su primera llamada a herramienta en lugar de al inicio. La caché está desactivada de forma predeterminada a menos que un despliegue gradual la haya activado para tu cuenta. Establécela en 1 para activarla, o en 0 para mantenerla desactivada incluso cuando el despliegue la haya activado. Antes de v2.1.238, la caché estaba activada de forma predeterminada. El estado cached requiere Claude Code v2.1.221 o posterior
MCP_DISCOVERY_CACHE_MAX_STALE_S Antigüedad máxima, en segundos, de una entrada de la caché de descubrimiento (valor predeterminado: 14400, o 4 horas). En un inicio en el que la entrada es más antigua que eso, Claude Code la descarta y conecta el servidor al inicio, como lo hace con la caché desactivada. Claude Code limita el valor a 7 días. Antes de v2.1.238, el valor predeterminado era 86400, o 24 horas, y Claude Code no limitaba el valor
MCP_DISCOVERY_CACHE_STRIKES En un inicio en el que una entrada de la caché de descubrimiento es más antigua que MCP_DISCOVERY_CACHE_TTL_S, Claude Code la actualiza en segundo plano. Esta variable establece cuántas actualizaciones seguidas pueden fallar antes de que Claude Code descarte la entrada y conecte el servidor en el siguiente inicio (valor predeterminado: 1). Auméntala si tu conexión de red se cae ocasionalmente, para que una actualización fallida no descarte la entrada. Requiere Claude Code v2.1.238 o posterior
MCP_DISCOVERY_CACHE_TTL_S Segundos durante los cuales Claude Code usa una entrada de la caché de descubrimiento sin actualizarla (valor predeterminado: 900). En un inicio en el que la entrada es más antigua que eso, Claude Code la sigue usando pero la actualiza en segundo plano. Una vez que la entrada es más antigua que MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code la descarta. 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 el callback de redirección de OAuth, como alternativa a --callback-port al añadir un servidor MCP con credenciales preconfiguradas
MCP_PROTOCOL_NEGOTIATION Solo en el runtime de cliente MCP v2, si Claude Code sondea los servidores para la revisión 2026-07-28 del protocolo MCP. Establécela en auto para sondear los servidores HTTP, de conectores de claude.ai y stdio, o en legacy para no sondear ninguno. Con la variable sin establecer, Claude Code sondea los servidores descritos en Runtimes de cliente MCP. Cualquier otro valor se ignora con una advertencia en el registro de depuración. Requiere Claude Code v2.1.221 o posterior
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE Cantidad máxima de servidores MCP remotos (HTTP/SSE) que se conectan en paralelo durante el inicio (valor predeterminado: 20)
MCP_SDK_GENERATION Fija con qué runtime de cliente MCP se conecta este proceso a los servidores MCP: v1, basado en MCP TypeScript SDK 1.x, o v2, basado en MCP TypeScript SDK 2.0. Sin la variable, Claude Code usa v2, a partir de las versiones indicadas en esa sección. En Claude Code v2.1.221 o posterior, el runtime 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 runtime v1 no realiza esta comprobación. Si estableces un valor no reconocido, Claude Code lo ignora y escribe una advertencia en el registro de depuración. Claude Code lee el valor una vez por proceso. Requiere Claude Code v2.1.218 o posterior
MCP_SERVER_CONNECTION_BATCH_SIZE Cantidad máxima de servidores MCP locales (stdio) que se conectan en paralelo durante el inicio (valor predeterminado: 3)
MCP_TIMEOUT Tiempo de espera en milisegundos para el inicio del servidor MCP (valor predeterminado: 30000, o 30 segundos)
MCP_TOOL_TIMEOUT Tiempo de espera en milisegundos para la ejecución de herramientas MCP (valor 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 mínima de inactividad para las llamadas a herramientas de ese servidor, de modo que CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT nunca las aborte antes; este mínimo requiere Claude Code v2.1.203 o posterior. Para la variable de entorno, los valores inferiores a 1000 se redondean a un segundo; para el campo por servidor, los valores inferiores a 1000 se ignoran
NO_PROXY Lista de dominios e IP a los que las solicitudes se enviarán directamente, sin pasar por el proxy
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT Límite estándar del SDK de OpenTelemetry para la longitud del valor de los atributos. Claude Code limita los atributos de telemetría con contenido al menor entre este valor y CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, para 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 de OpenTelemetry assistant_response. 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 añadir 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 de OpenTelemetry managed_settings_resolved. Desactivada de forma predeterminada. Establécela en tu shell, en la configuración de usuario o en la configuración administrada; un valor en la configuración de proyecto o local no la activa. Requiere Claude Code v2.1.274 o posterior. Consulta Monitoreo
OTEL_LOG_RAW_API_BODIES Emite el JSON de solicitud y respuesta de la Messages API de Anthropic como eventos de registro api_request_body / api_response_body. Establécela en 1 para cuerpos en línea truncados en el límite de contenido, o en file:<dir> para escribir los cuerpos sin truncar en el disco y emitir en su lugar una ruta body_ref. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configura el límite de contenido, de 60 KB de forma predeterminada. Desactivada de forma predeterminada; los cuerpos incluyen todo el historial de la conversación. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local. Consulta Monitoreo
OTEL_LOG_TOOL_CONTENT Establécela en 1 para incluir el contenido de las herramientas en el evento de span de OpenTelemetry tool.output. Los atributos de span llevan el contenido de las herramientas según 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 workflows creados por el usuario; las cadenas de error sin procesar en los fallos de herramientas; la category de rechazo en los eventos api_refusal; los nombres reales de agentes, skills, plugins y servidores MCP en las métricas de costo y tokens; y otros detalles de herramientas en las métricas, trazas y registros de OpenTelemetry. Desactivada de forma predeterminada para proteger la PII. Establécela en tu shell, en la configuración de usuario o en la configuración administrada. Se ignora en la configuración de proyecto y local, salvo los valores de desactivación que describe esa sección. Consulta Monitoreo
OTEL_LOG_USER_PROMPTS Establécela en 1 para incluir el texto de los prompts del usuario en las trazas y registros de OpenTelemetry. Desactivada de forma predeterminada (los prompts se 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 (valor 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 (valor predeterminado: excluido). Añadida 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 (valor 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 (valor 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 (valor 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 (valor 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 ajusta dinámicamente al 1% de la ventana de contexto, con un valor de respaldo de 8,000 caracteres. Se conserva el nombre heredado por compatibilidad con versiones anteriores
TASK_MAX_OUTPUT_LENGTH Eliminada en v2.1.277 y ahora no tiene efecto, junto con la herramienta TaskOutput cuyo tamaño definía. Anteriormente establecía la cantidad máxima de caracteres de la salida de una tarea en segundo plano que conservaba la herramienta TaskOutput. Claude ahora lee 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 Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_3_5_SONNET Sobrescribe la región para Claude 3.5 Sonnet al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_3_7_SONNET Sobrescribe la región para Claude 3.7 Sonnet al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_0_OPUS Sobrescribe la región para Claude 4.0 Opus al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_0_SONNET Sobrescribe la región para Claude 4.0 Sonnet al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_1_OPUS Sobrescribe la región para Claude 4.1 Opus al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_5_OPUS Sobrescribe la región para Claude Opus 4.5 al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_5_SONNET Sobrescribe la región para Claude Sonnet 4.5 al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_6_OPUS Sobrescribe la región para Claude Opus 4.6 al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_6_SONNET Sobrescribe la región para Claude Sonnet 4.6 al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_7_OPUS Sobrescribe la región para Claude Opus 4.7 al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_4_8_OPUS Sobrescribe la región para Claude Opus 4.8 al usar Google Cloud's Agent Platform
VERTEX_REGION_CLAUDE_5_5_OPUS Sobrescribe la región para Claude Opus 5.5 al usar Google Cloud's Agent Platform. Añadida en v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Sobrescribe la región para Claude Sonnet 5.5 al usar Google Cloud's Agent Platform. Añadida en v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Sobrescribe la región para Claude Opus 5 al usar Google Cloud's Agent Platform. Añadida en v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Sobrescribe la región para Claude Sonnet 5 al usar Google Cloud's Agent Platform. Añadida en v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Sobrescribe la región para Claude Fable 5 al usar Google Cloud's Agent Platform. Añadida en v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Sobrescribe la región para Claude Fable 5.1 al usar Google Cloud's Agent Platform. Añadida en v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Sobrescribe la región para Claude Haiku 4.5 al usar Google Cloud's Agent Platform

También se admiten las variables estándar de exportadores de OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES y las variantes específicas de cada señal). Consulta Monitoreo para obtener 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 de exportación, tiempo de espera y compresión, como OTEL_METRIC_EXPORT_INTERVAL, siguen aplicándose desde la configuración de proyecto y local.

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

Cuando estableces CLAUDE_CODE_SUBPROCESS_ENV_SCRUB en 1, Claude Code elimina las credenciales de los entornos de los subprocesos que inicia, como los comandos de Bash, los hooks y los servidores MCP stdio. Esto reduce lo que un ataque de inyección de prompts puede leer mediante la expansión del shell. El proceso de Claude Code conserva las credenciales para sus propias llamadas a la API.

La depuración reconoce una credencial por el nombre de su variable o por la forma de su valor, así que úsala como una capa más junto con reglas de permisos acotadas, en lugar de como el único control.

La tabla muestra lo que hace la depuración con algunas variables de ejemplo:

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

Como la depuración deja intacto GITHUB_TOKEN, asigna a un trabajo de GitHub Actions los permissions más restringidos que necesite. Para eliminar un token de GitHub de los comandos de Bash que se ejecutan en el sandbox, agrega una entrada deny en sandbox.credentials.

No establezcas la depuración si un subproceso necesita alguna de las variables eliminadas.

En Linux, la depuración también ejecuta los subprocesos de Bash en un espacio de nombres PID aislado para que no puedan leer los entornos de los procesos del host a través de /proc. Como efecto secundario, ps, pgrep y kill no pueden ver los procesos del host ni enviarles señales.

Funciones que requieren la obtención de feature flags

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

  • Una sesión en la que estableces DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; la fila de cada variable en la tabla de variables indica qué valores desactivan la obtención
  • Una sesión en un proveedor externo, como Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform o Microsoft Foundry, a menos que una plataforma anfitriona que integre Claude Code establezca CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • Una sesión del gateway de aplicaciones de Claude

Con la obtención desactivada, no puedes:

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

En tu primera sesión después de instalar Claude Code, o de actualizar a una versión que añade una función, puede faltar una función controlada por flags. Esa sesión también puede iniciarse en un modo de permisos distinto al de tus sesiones posteriores. Cuando Claude Code obtiene los flags durante esa sesión, los guarda en la máquina, de modo que tu siguiente sesión en esa máquina tiene la función y el modo de permisos inicial habitual.

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

En configuraciones como estas, las sesiones posteriores a la primera también se inician sin flags recién obtenidos:

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

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

Véase también