Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Code admite las siguientes variables de entorno para controlar su comportamiento. Establézcalas en su shell antes de lanzar claude, o configúrelas en settings.json bajo la clave env para aplicarlas a cada sesión o implementarlas en su equipo.
VariablePropósito
ANTHROPIC_API_KEYClave de API enviada como encabezado X-Api-Key. Cuando se establece, esta clave se utiliza en lugar de su suscripción de Claude Pro, Max, Team o Enterprise incluso si ha iniciado sesión. En modo no interactivo (-p), la clave siempre se utiliza cuando está presente. En modo interactivo, se le solicita que apruebe la clave una vez antes de que anule su suscripción. Para utilizar su suscripción en su lugar, ejecute unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKENValor personalizado para el encabezado Authorization (el valor que establezca aquí tendrá el prefijo Bearer )
ANTHROPIC_AWS_API_KEYClave 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_URLAnule la URL del endpoint de Claude Platform on AWS. Utilice para regiones personalizadas o cuando enrute a través de una puerta de enlace LLM. El valor predeterminado es https://aws-external-anthropic.{AWS_REGION}.api.aws
ANTHROPIC_AWS_WORKSPACE_IDRequerido para Claude Platform on AWS. Se envía en cada solicitud como encabezado anthropic-workspace-id
ANTHROPIC_BASE_URLAnule el endpoint de API para enrutar solicitudes a través de un proxy o puerta de enlace. Cuando se establece en un host que no es de primera parte, búsqueda de herramientas MCP está deshabilitada de forma predeterminada. Establezca ENABLE_TOOL_SEARCH=true si su proxy reenvía bloques tool_reference
ANTHROPIC_BEDROCK_BASE_URLAnule la URL del endpoint de Bedrock. Utilice para endpoints de Bedrock personalizados o cuando enrute a través de una puerta de enlace LLM. Consulte Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URLAnule la URL del endpoint de Bedrock Mantle. Consulte Endpoint Mantle
ANTHROPIC_BEDROCK_SERVICE_TIERNivel de servicio de Bedrock (default, flex o priority). Se envía como encabezado X-Amzn-Bedrock-Service-Tier. Consulte Amazon Bedrock
ANTHROPIC_BETASLista separada por comas de valores de encabezado anthropic-beta adicionales para incluir en solicitudes de API. Claude Code ya envía los encabezados beta que necesita; utilice esto para optar por un beta de API de Anthropic antes de que Claude Code agregue soporte nativo. A diferencia de la bandera --betas, que requiere autenticación de clave de API, esta variable funciona con todos los métodos de autenticación, incluida la suscripción de Claude.ai
ANTHROPIC_CUSTOM_HEADERSEncabezados personalizados para agregar a las solicitudes (formato Name: Value, separados por saltos de línea para múltiples encabezados)
ANTHROPIC_CUSTOM_MODEL_OPTIONID de modelo para agregar como entrada personalizada en el selector /model. Utilice esto para hacer que un modelo no estándar o específico de puerta de enlace sea seleccionable sin reemplazar alias integrados. Consulte Configuración de modelo
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTIONDescripción de visualización para la entrada de modelo personalizado en el selector /model. El valor predeterminado es Custom model (<model-id>) cuando no se establece
ANTHROPIC_CUSTOM_MODEL_OPTION_NAMENombre de visualización para la entrada de modelo personalizado en el selector /model. El valor predeterminado es el ID de modelo cuando no se establece
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIESConsulte Configuración de modelo
ANTHROPIC_DEFAULT_HAIKU_MODELConsulte Configuración de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTIONConsulte Configuración de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAMEConsulte Configuración de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIESConsulte Configuración de modelo
ANTHROPIC_DEFAULT_OPUS_MODELConsulte Configuración de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTIONConsulte Configuración de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_NAMEConsulte Configuración de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIESConsulte Configuración de modelo
ANTHROPIC_DEFAULT_SONNET_MODELConsulte Configuración de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTIONConsulte Configuración de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_NAMEConsulte Configuración de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIESConsulte Configuración de modelo
ANTHROPIC_FOUNDRY_API_KEYClave de API para autenticación de Microsoft Foundry (consulte Microsoft Foundry)
ANTHROPIC_FOUNDRY_BASE_URLURL base completa para el recurso Foundry (por ejemplo, https://my-resource.services.ai.azure.com/anthropic). Alternativa a ANTHROPIC_FOUNDRY_RESOURCE (consulte Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCENombre del recurso Foundry (por ejemplo, my-resource). Requerido si ANTHROPIC_FOUNDRY_BASE_URL no está establecido (consulte Microsoft Foundry)
ANTHROPIC_MODELNombre de la configuración de modelo a utilizar (consulte Configuración de modelo)
ANTHROPIC_SMALL_FAST_MODEL[DEPRECATED] Nombre de modelo de clase Haiku para tareas en segundo plano
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONAnule la región de AWS para el modelo de clase Haiku al usar Bedrock o Bedrock Mantle. En Bedrock, esto solo tiene efecto cuando ANTHROPIC_DEFAULT_HAIKU_MODEL o el deprecated ANTHROPIC_SMALL_FAST_MODEL también está establecido, ya que Bedrock de otra manera utiliza el modelo principal para tareas en segundo plano
ANTHROPIC_VERTEX_BASE_URLAnule la URL del endpoint de Vertex AI. Utilice para endpoints de Vertex personalizados o cuando enrute a través de una puerta de enlace LLM. Consulte Google Vertex AI
ANTHROPIC_VERTEX_PROJECT_IDID de proyecto de GCP para solicitudes de Vertex AI. Anulado por GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT o el proyecto en su archivo de credenciales GOOGLE_APPLICATION_CREDENTIALS. Consulte Google Vertex AI
ANTHROPIC_WORKSPACE_IDID de espacio de trabajo para federación de identidad de carga de trabajo. Establezca esto cuando su regla de federación esté limitada a más de un espacio de trabajo para que el intercambio de tokens sepa a qué espacio de trabajo dirigirse
API_TIMEOUT_MSTiempo de espera para solicitudes de API en milisegundos (predeterminado: 600000, o 10 minutos; máximo: 2147483647). Aumente esto cuando las solicitudes agoten el tiempo de espera en redes lentas o cuando enrute a través de un proxy. Los valores por encima del máximo desbordan el temporizador subyacente y causan que las solicitudes fallen inmediatamente
AWS_BEARER_TOKEN_BEDROCKClave de API de Bedrock para autenticación (consulte Claves de API de Bedrock)
BASH_DEFAULT_TIMEOUT_MSTiempo de espera predeterminado para comandos bash de larga duración (predeterminado: 120000, o 2 minutos)
BASH_MAX_OUTPUT_LENGTHNúmero máximo de caracteres en salidas bash antes de que la salida completa se guarde en un archivo y Claude reciba la ruta más una vista previa corta. Consulte Comportamiento de la herramienta Bash
BASH_MAX_TIMEOUT_MSTiempo de espera máximo que el modelo puede establecer para comandos bash de larga duración (predeterminado: 600000, o 10 minutos)
CCR_FORCE_BUNDLEEstablezca en 1 para forzar claude --remote a agrupar y cargar su repositorio local incluso cuando el acceso a GitHub está disponible
CLAUDECODEEstablezca en 1 en entornos de shell que Claude Code genera (herramienta Bash, sesiones tmux). No se establece en comandos hooks o línea de estado. Utilice para detectar cuándo un script se está ejecutando dentro de un shell generado por Claude Code
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSEstablezca en 1 para deshabilitar todos los tipos de subagentes integrados, como Explore y Plan. Solo se aplica en modo no interactivo (la bandera -p). Útil para usuarios de SDK que desean una pizarra en blanco
CLAUDE_AGENT_SDK_MCP_NO_PREFIXEstablezca en 1 para omitir el prefijo mcp__<server>__ en nombres de herramientas de servidores MCP creados por SDK. Las herramientas utilizan sus nombres originales. Solo uso de SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSTiempo de espera de estancamiento en milisegundos para subagentes en segundo plano. Predeterminado 600000 (10 minutos). El temporizador se reinicia en cada evento de progreso de transmisión; si no llega progreso dentro de la ventana, el subagente se aborta y la tarea se marca como fallida, mostrando cualquier resultado parcial al padre
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEEstablezca el porcentaje de capacidad de contexto (1-100) en el que se activa la compactación automática. De forma predeterminada, la compactación automática se activa aproximadamente al 95% de capacidad. Utilice valores más bajos como 50 para compactar antes. Los valores por encima del umbral predeterminado no tienen efecto. Se aplica tanto a conversaciones principales como a subagentes. Este porcentaje se alinea con el campo context_window.used_percentage disponible en línea de estado
CLAUDE_AUTO_BACKGROUND_TASKSEstablezca en 1 para forzar la habilitación del envío automático a segundo plano de tareas de agentes de larga duración. Cuando se habilita, los subagentes se mueven al segundo plano después de ejecutarse durante aproximadamente dos minutos
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIRVuelva al directorio de trabajo original después de cada comando Bash o PowerShell en la sesión principal
CLAUDE_CODE_ACCESSIBILITYEstablezca en 1 para mantener visible el cursor del terminal nativo y deshabilitar el indicador de cursor de texto invertido. Permite que ampliadores de pantalla como macOS Zoom rastreen la posición del cursor
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDEstablezca en 1 para cargar archivos de memoria desde directorios especificados con --add-dir. Carga CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md y CLAUDE.local.md. De forma predeterminada, los directorios adicionales no cargan archivos de memoria
CLAUDE_CODE_API_KEY_HELPER_TTL_MSIntervalo en milisegundos en el que se deben actualizar las credenciales (al usar apiKeyHelper)
CLAUDE_CODE_ATTRIBUTION_HEADEREstablezca en 0 para omitir el bloque de atribución (versión del cliente e huella digital del indicador) desde el inicio del indicador del sistema. Deshabilitarlo mejora las tasas de acierto de caché de indicadores cuando se enruta a través de una puerta de enlace LLM. El almacenamiento en caché de API de Anthropic no se ve afectado
CLAUDE_CODE_AUTO_COMPACT_WINDOWEstablezca la capacidad de contexto en tokens utilizada para cálculos de compactación automática. El valor predeterminado es la ventana de contexto del modelo: 200K para modelos estándar o 1M para modelos de contexto extendido. Utilice un valor más bajo como 500000 en un modelo de 1M para tratar la ventana como 500K para propósitos de compactación. El valor se limita a la ventana de contexto real del modelo. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE se aplica como porcentaje de este valor. Establecer esta variable desvincula el umbral de compactación del used_percentage de la línea de estado, que siempre utiliza la ventana de contexto completa del modelo
CLAUDE_CODE_AUTO_CONNECT_IDEAnule la conexión automática de IDE. De forma predeterminada, Claude Code se conecta automáticamente cuando se lanza dentro del terminal integrado de un IDE compatible. Establezca en false para evitar esto. Establezca en true para forzar un intento de conexión cuando la detección automática falla, como cuando tmux oculta el terminal principal. Tiene precedencia sobre la configuración global autoConnectIde
CLAUDE_CODE_CERT_STORELista separada por comas de fuentes de certificados CA para conexiones TLS. bundled es el conjunto de CA de Mozilla incluido con Claude Code. system es el almacén de confianza del sistema operativo. El valor predeterminado es bundled,system
CLAUDE_CODE_CLIENT_CERTRuta al archivo de certificado de cliente para autenticación mTLS
CLAUDE_CODE_CLIENT_KEYRuta al archivo de clave privada de cliente para autenticación mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASEFrase de contraseña para CLAUDE_CODE_CLIENT_KEY cifrada (opcional)
CLAUDE_CODE_DEBUG_LOGS_DIRAnule la ruta del archivo de registro de depuración. A pesar del nombre, esta es una ruta de archivo, no un directorio. Requiere que el modo de depuración se habilite por separado a través de --debug, /debug o la variable de entorno DEBUG: establecer esta variable sola no habilita el registro. La bandera --debug-file hace ambas cosas a la vez. El valor predeterminado es ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVELNivel de registro mínimo escrito en el archivo de registro de depuración. Valores: verbose, debug (predeterminado), info, warn, error. Establezca en verbose para incluir diagnósticos de alto volumen como salida completa de comandos de línea de estado, o aumente a error para reducir ruido
CLAUDE_CODE_DISABLE_1M_CONTEXTEstablezca en 1 para deshabilitar el soporte de ventana de contexto de 1M. Cuando se establece, las variantes de modelo de 1M no están disponibles en el selector de modelo. Útil para entornos empresariales con requisitos de cumplimiento
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGEstablezca en 1 para deshabilitar razonamiento adaptativo en Opus 4.6 y Sonnet 4.6 y volver al presupuesto de pensamiento fijo controlado por MAX_THINKING_TOKENS. No tiene efecto en Opus 4.7, que siempre utiliza razonamiento adaptativo
CLAUDE_CODE_DISABLE_AGENT_VIEWEstablezca en 1 para desactivar agentes en segundo plano y vista de agentes: claude agents, --bg, /background y el supervisor bajo demanda. Equivalente a la configuración disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREENEstablezca en 1 para deshabilitar renderizado a pantalla completa y utilizar el renderizador de pantalla principal clásico. La conversación permanece en el desplazamiento nativo de su terminal para que Cmd+f y el modo de copia de tmux funcionen como de costumbre. Tiene precedencia sobre CLAUDE_CODE_NO_FLICKER y la configuración tui. También puede cambiar con /tui default
CLAUDE_CODE_DISABLE_ATTACHMENTSEstablezca en 1 para deshabilitar el procesamiento de archivos adjuntos. Las menciones de archivos con sintaxis @ se envían como texto sin formato en lugar de expandirse en contenido de archivo
CLAUDE_CODE_DISABLE_AUTO_MEMORYEstablezca en 1 para deshabilitar memoria automática. Establezca en 0 para forzar la memoria automática incluso cuando el modo --bare o autoMemoryEnabled: false la deshabilitaría de otra manera. Cuando se deshabilita, Claude no crea ni carga archivos de memoria automática
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSEstablezca en 1 para deshabilitar toda la funcionalidad de tareas en segundo plano, incluido el parámetro run_in_background en herramientas Bash y subagentes, auto-backgrounding y el atajo Ctrl+B
CLAUDE_CODE_DISABLE_CLAUDE_MDSEstablezca en 1 para evitar cargar cualquier archivo de memoria CLAUDE.md en contexto, incluidos archivos de usuario, proyecto y memoria automática
CLAUDE_CODE_DISABLE_CRONEstablezca en 1 para deshabilitar tareas programadas. La skill /loop y las herramientas cron no estarán disponibles y cualquier tarea ya programada dejará de ejecutarse, incluidas las tareas que ya se están ejecutando en mitad de sesión
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASEstablezca en 1 para eliminar encabezados de solicitud anthropic-beta específicos de Anthropic y campos de esquema de herramienta beta (como defer_loading y eager_input_streaming) de solicitudes de API. Utilice esto cuando una puerta de enlace proxy rechace solicitudes con errores como “Unexpected value(s) for the anthropic-beta header” o “Extra inputs are not permitted”. Los campos estándar (name, description, input_schema, cache_control) se conservan.
CLAUDE_CODE_DISABLE_FAST_MODEEstablezca en 1 para deshabilitar modo rápido
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEYEstablezca en 1 para deshabilitar las encuestas de calidad de sesión “¿Cómo está funcionando Claude?”. Las encuestas también se deshabilitan cuando se establece DISABLE_TELEMETRY, DO_NOT_TRACK o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, a menos que CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL opte por participar nuevamente. Para establecer una tasa de muestreo en lugar de deshabilitar completamente, utilice la configuración feedbackSurveyRate. Consulte Encuestas de calidad de sesión
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGEstablezca en 1 para deshabilitar el checkpointing de archivos. El comando /rewind no podrá restaurar cambios de código
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSEstablezca en 1 para eliminar las instrucciones de flujo de trabajo de confirmación y PR integradas y la instantánea de estado de git del indicador del sistema de Claude. Útil cuando se utilizan sus propias skills de flujo de trabajo de git. Tiene precedencia sobre la configuración includeGitInstructions cuando se establece
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPEstablezca en 1 para evitar el remapeo automático de Opus 4.0 y 4.1 a la versión actual de Opus en la API de Anthropic. Utilice cuando desee fijar intencionalmente un modelo anterior. El remapeo no se ejecuta en Bedrock, Vertex o Foundry
CLAUDE_CODE_DISABLE_MOUSEEstablezca en 1 para deshabilitar el seguimiento del ratón en renderizado a pantalla completa. El desplazamiento por teclado con PgUp y PgDn sigue funcionando. Utilice esto para mantener el comportamiento nativo de copiar al seleccionar de su terminal
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICEquivalente a establecer DISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING y DISABLE_TELEMETRY
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACKEstablezca en 1 para deshabilitar el respaldo no transmitido cuando una solicitud transmitida falla a mitad de transmisión. Los errores de transmisión se propagan a la capa de reintento en su lugar. Útil cuando un proxy o puerta de enlace causa que el respaldo produzca ejecución de herramientas duplicadas
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALLEstablezca en 1 para omitir la adición automática del marketplace oficial de plugins en la primera ejecución
CLAUDE_CODE_DISABLE_POLICY_SKILLSEstablezca en 1 para omitir la carga de skills desde el directorio de skills administradas en todo el sistema. Útil para sesiones de contenedor o CI que no deben cargar skills aprovisionadas por operadores
CLAUDE_CODE_DISABLE_TERMINAL_TITLEEstablezca en 1 para deshabilitar las actualizaciones automáticas del título del terminal basadas en el contexto de la conversación
CLAUDE_CODE_DISABLE_THINKINGEstablezca en 1 para forzar la deshabilitación de pensamiento extendido independientemente del soporte del modelo u otras configuraciones. Más directo que MAX_THINKING_TOKENS=0
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLLEstablezca en 1 para deshabilitar el desplazamiento virtual en renderizado a pantalla completa y renderizar cada mensaje en la transcripción. Utilice esto si el desplazamiento en modo pantalla completa muestra regiones en blanco donde deberían aparecer mensajes
CLAUDE_CODE_EFFORT_LEVELEstablezca el nivel de esfuerzo para 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 y la configuración effortLevel. Consulte Ajustar nivel de esfuerzo
CLAUDE_CODE_ENABLE_AWAY_SUMMARYAnule la disponibilidad de resumen de sesión. Establezca en 0 para forzar los resúmenes desactivados independientemente del toggle /config. Establezca en 1 para forzar los resúmenes activados cuando awaySummaryEnabled es false. Tiene precedencia sobre la configuración y el toggle /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESHEstablezca en 1 para actualizar el estado del plugin en los límites de turno en modo no interactivo después de que se complete una instalación en segundo plano. Desactivado de forma predeterminada porque la actualización cambia el indicador del sistema a mitad de sesión, lo que invalida el almacenamiento en caché de indicadores para ese turno
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELEstablezca en 1 para enrutar la encuesta de calidad de sesión “¿Cómo está funcionando Claude?” a su propio recopilador de OpenTelemetry cuando el tráfico no esencial vinculado a Anthropic está bloqueado. Las calificaciones de encuesta se emiten solo como eventos OTEL a su recopilador configurado. No se envían datos de encuesta a Anthropic en este modo. Se aplica cuando se establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY o DO_NOT_TRACK, y no tiene efecto de otra manera. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY y la política de comentarios del producto de la organización tienen precedencia
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMINGControla si las entradas de llamadas de herramientas se transmiten desde la API mientras Claude las genera. Con esto desactivado, una entrada de herramienta grande como una escritura de archivo larga llega solo después de que Claude termina de generarla, lo que puede parecer que se está colgando. Habilitado de forma predeterminada en la API de Anthropic. En Bedrock y Vertex, habilitado por modelo donde el contenedor implementado lo admite. Establezca en 0 para optar por no participar. Establezca en 1 para forzar la habilitación cuando se enruta a través de un proxy a través de ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL o ANTHROPIC_BEDROCK_BASE_URL. Desactivado de forma predeterminada en Foundry y conexiones de puerta de enlace
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYEstablezca en 1 para rellenar el selector /model desde el endpoint /v1/models de su puerta de enlace cuando ANTHROPIC_BASE_URL apunta a una puerta de enlace compatible con Anthropic como LiteLLM, Kong o un proxy interno. Desactivado de forma predeterminada porque las puertas de enlace respaldadas por una clave de API compartida de otra manera mostrarían a cada usuario cada modelo que la clave puede acceder. Los modelos descubiertos aún se filtran por la lista de permitidos availableModels
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODEEstablezca en 1 para ejecutar modo rápido en Claude Opus 4.7 en lugar de Opus 4.6. Con la variable establecida, /fast cambia a Opus 4.7; sin ella, /fast continúa usando Opus 4.6
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONEstablezca en false para deshabilitar sugerencias de indicador (el toggle “Prompt suggestions” en /config). Estas son las predicciones atenuadas que aparecen en su entrada de indicador después de que Claude responda. Consulte Sugerencias de indicador
CLAUDE_CODE_ENABLE_TASKSEstablezca en 1 para habilitar el sistema de seguimiento de tareas en modo no interactivo (la bandera -p). Las tareas están activadas de forma predeterminada en modo interactivo. Consulte Lista de tareas
CLAUDE_CODE_ENABLE_TELEMETRYEstablezca en 1 para habilitar la recopilación de datos de OpenTelemetry para métricas y registro. Requerido antes de configurar exportadores de OTel. Consulte Monitoreo
CLAUDE_CODE_EXIT_AFTER_STOP_DELAYTiempo en milisegundos a esperar después de que el bucle de consulta se vuelva inactivo antes de salir automáticamente. Útil para flujos de trabajo automatizados y scripts que utilizan modo SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSEstablezca en 1 para habilitar equipos de agentes. Los equipos de agentes son experimentales y están deshabilitados de forma predeterminada
CLAUDE_CODE_EXTRA_BODYObjeto JSON para fusionar en el nivel superior de cada cuerpo de solicitud de API. Útil para pasar parámetros específicos del proveedor que Claude Code no expone directamente
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSAnule el límite de tokens predeterminado para lecturas de archivos. Útil cuando necesita leer archivos más grandes en su totalidad
CLAUDE_CODE_FORCE_SYNC_OUTPUTEstablezca en 1 para forzar la habilitación del modo privado DEC 2026 salida sincronizada cuando su terminal lo admite pero no se detecta automáticamente. Útil para emuladores como eat de Emacs que implementan BSU/ESU pero no responden a la sonda de capacidad. No tiene efecto bajo tmux
CLAUDE_CODE_FORK_SUBAGENTEstablezca en 1 para habilitar subagentes bifurcados. Un subagente bifurcado hereda el contexto de conversación completo de la sesión principal en lugar de comenzar desde cero. Cuando se habilita, /fork genera un subagente bifurcado en lugar de actuar como un alias para /branch, y todos los despliegues de subagentes se ejecutan en segundo plano. Funciona en modo interactivo y a través del SDK o claude -p
CLAUDE_CODE_GIT_BASH_PATHSolo Windows: ruta al ejecutable de Git Bash (bash.exe). Utilice cuando Git Bash está instalado pero no en su PATH. Consulte Configuración de Windows
CLAUDE_CODE_GLOB_HIDDENEstablezca en false para excluir dotfiles de los resultados cuando Claude invoca la herramienta Glob. Se incluye de forma predeterminada. No afecta a la autocompletación de archivos @, ls, Grep o Read
CLAUDE_CODE_GLOB_NO_IGNOREEstablezca en false para hacer que la herramienta Glob respete patrones .gitignore. De forma predeterminada, Glob devuelve todos los archivos coincidentes, incluidos los ignorados por git. No afecta a la autocompletación de archivos @, que tiene su propia configuración respectGitignore
CLAUDE_CODE_GLOB_TIMEOUT_SECONDSTiempo de espera en segundos para el descubrimiento de archivos de la herramienta Glob. El valor predeterminado es 20 segundos en la mayoría de plataformas y 60 segundos en WSL
CLAUDE_CODE_HIDE_CWDEstablezca en 1 para ocultar el directorio de trabajo en el logo de inicio. Útil para compartir pantalla o grabaciones donde la ruta expone su nombre de usuario del SO
CLAUDE_CODE_IDE_HOST_OVERRIDEAnule la dirección de host utilizada para conectarse a la extensión de 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_INSTALLOmita la instalación automática de extensiones de IDE. Equivalente a establecer autoInstallIdeExtension en false
CLAUDE_CODE_IDE_SKIP_VALID_CHECKEstablezca en 1 para omitir la validación de entradas de archivo de bloqueo de IDE durante la conexión. Utilice cuando la conexión automática no encuentra su IDE a pesar de que se está ejecutando
CLAUDE_CODE_MAX_CONTEXT_TOKENSAnule el tamaño de la ventana de contexto que Claude Code asume para el modelo activo. Solo tiene efecto cuando DISABLE_COMPACT también está establecido. Utilice esto cuando enrute 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_OUTPUT_TOKENSEstablezca el número máximo de tokens de salida para la mayoría de solicitudes. Los valores predeterminados y máximos varían según el modelo; consulte tokens de salida máximos. Aumentar este valor reduce la ventana de contexto efectiva disponible antes de que se active la compactación automática.
CLAUDE_CODE_MAX_RETRIESAnule el número de veces para reintentar solicitudes de API fallidas (predeterminado: 10)
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYNúmero máximo de herramientas de solo lectura y subagentes que pueden ejecutarse en paralelo (predeterminado: 10). Los valores más altos aumentan el paralelismo pero consumen más recursos
CLAUDE_CODE_MAX_TURNSLimite el número de turnos agentivos cuando no se pasa un límite explícito. Equivalente a pasar --max-turns, que tiene precedencia cuando ambos se establecen. Un valor que no es un entero positivo se rechaza al inicio con un error en lugar de tratarse como sin límite
CLAUDE_CODE_MCP_ALLOWLIST_ENVEstablezca en 1 para generar servidores MCP stdio con solo un entorno de línea base segura más el env configurado del servidor, en lugar de heredar su entorno de shell
CLAUDE_CODE_NATIVE_CURSOREstablezca en 1 para mostrar el cursor propio del terminal en el símbolo de inserción en lugar de un bloque dibujado. El cursor respeta la configuración de parpadeo, forma y enfoque del terminal
CLAUDE_CODE_NEW_INITEstablezca en 1 para hacer que /init ejecute un flujo de configuración interactivo. El flujo pregunta qué archivos generar, incluidos CLAUDE.md, skills y hooks, antes de explorar la base de código y escribirlos. Sin esta variable, /init genera un CLAUDE.md automáticamente sin solicitar.
CLAUDE_CODE_NO_FLICKEREstablezca en 1 para habilitar renderizado a pantalla completa, una vista previa de investigación que reduce el parpadeo y mantiene la memoria plana en conversaciones largas. Equivalente a la configuración tui; también puede cambiar con /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKENToken de actualización de OAuth para autenticación de Claude.ai. Cuando se establece, claude auth login intercambia este token directamente en lugar de abrir un navegador. Requiere CLAUDE_CODE_OAUTH_SCOPES. Útil para aprovisionar autenticación en entornos automatizados
CLAUDE_CODE_OAUTH_SCOPESAlcances de OAuth separados por espacios con los que se emitió el token de actualización, como "user:profile user:inference user:sessions:claude_code". Requerido cuando se establece CLAUDE_CODE_OAUTH_REFRESH_TOKEN
CLAUDE_CODE_OAUTH_TOKENToken de acceso de OAuth para autenticación de Claude.ai. Alternativa a /login para SDK y entornos automatizados. Tiene precedencia sobre credenciales almacenadas en llavero. Genere uno con claude setup-token
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDEEstablezca en 1 para mantener modo rápido en Claude Opus 4.6. Tiene precedencia sobre CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE, por lo que establezca esto si necesita fijar Opus 4.6 independientemente de cómo cambie el valor predeterminado
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MSTiempo de espera en milisegundos para vaciar spans de OpenTelemetry pendientes (predeterminado: 5000). Consulte Monitoreo
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MSIntervalo para actualizar encabezados dinámicos de OpenTelemetry en milisegundos (predeterminado: 1740000 / 29 minutos). Consulte Encabezados dinámicos
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MSTiempo de espera en milisegundos para que el exportador de OpenTelemetry termine al apagar (predeterminado: 2000). Aumente si las métricas se descartan al salir. Consulte Monitoreo
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEEstablezca en 1 para permitir que Claude Code ejecute el comando de actualización de su gestor de paquetes en segundo plano cuando una nueva versión esté disponible. Se aplica a instalaciones de Homebrew y WinGet. Otros gestores de paquetes continúan mostrando el comando de actualización sin ejecutarlo. Consulte Actualizaciones automáticas
CLAUDE_CODE_PERFORCE_MODEEstablezca en 1 para habilitar la protección de escritura consciente de Perforce. Cuando se establece, Edit, Write y NotebookEdit fallan con una sugerencia p4 edit <file> si el archivo de destino carece del bit de escritura del propietario, que Perforce borra en archivos sincronizados hasta que p4 edit los abre. Esto evita que Claude Code omita el seguimiento de cambios de Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIRAnule el directorio raíz de plugins. A pesar del nombre, esto establece el directorio principal, no el caché en sí: los marketplaces y el caché de plugins viven en subdirectorios bajo esta ruta. El valor predeterminado es ~/.claude/plugins
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSTiempo de espera en milisegundos para operaciones de git al instalar o actualizar plugins (predeterminado: 120000). Aumente este valor para repositorios grandes o conexiones de red lentas. Consulte Las operaciones de Git agotan el tiempo de espera
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILUREEstablezca en 1 para mantener el caché de marketplace existente cuando un git pull falla en lugar de borrar y volver a clonar. Útil en entornos sin conexión o aislados donde volver a clonar fallaría de la misma manera. Consulte Las actualizaciones de Marketplace fallan en entornos sin conexión
CLAUDE_CODE_PLUGIN_PREFER_HTTPSEstablezca en 1 para clonar fuentes de plugins de GitHub owner/repo sobre HTTPS en lugar de SSH. Útil en ejecutores de CI, contenedores o cualquier entorno sin una clave SSH configurada para github.com
CLAUDE_CODE_PLUGIN_SEED_DIRRuta a uno o más directorios de semilla de plugins de solo lectura, separados por : en Unix o ; en Windows. Utilice esto para agrupar un directorio de plugins previamente poblado en una imagen de contenedor. Claude Code registra mercados desde estos directorios al inicio y utiliza plugins almacenados en caché previamente sin volver a clonar. Consulte Pre-popular plugins para contenedores
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTSe establece por plataformas host que incrustan Claude Code y administran el enrutamiento del proveedor de modelo en su nombre. Cuando se establece, la selección de proveedor, endpoint y variables de autenticación como CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY en archivos de configuración se ignoran para que la configuración del usuario no pueda anular el enrutamiento del host. La opción de exclusión automática de telemetría para Bedrock, Vertex y Foundry también se omite, por lo que la telemetría sigue la opción de exclusión estándar DISABLE_TELEMETRY. Consulte Comportamientos predeterminados por proveedor de API
CLAUDE_CODE_PROXY_RESOLVES_HOSTSEstablezca en 1 para permitir que el proxy realice la resolución de DNS en lugar de la persona que llama. Opción de inclusión para entornos donde el proxy debe manejar la resolución de nombres de host
CLAUDE_CODE_REMOTESe establece automáticamente en true cuando Claude Code se ejecuta como una sesión en la nube. Lea esto desde un hook o script de configuración para detectar si se encuentra en un entorno en la nube
CLAUDE_CODE_REMOTE_SESSION_IDSe establece automáticamente en sesiones en la nube en el ID de la sesión actual. Lea esto para construir un enlace de vuelta a la transcripción de la sesión. Consulte Vincular artefactos de vuelta a la sesión
CLAUDE_CODE_RESUME_INTERRUPTED_TURNEstablezca en 1 para reanudar automáticamente si la sesión anterior terminó a mitad de turno. Se utiliza en modo SDK para que el modelo continúe sin requerir que el SDK reenvíe el indicador
CLAUDE_CODE_RESUME_PROMPTAnule el mensaje de continuación inyectado al reanudar una sesión que terminó a mitad de turno. El valor predeterminado es Continue from where you left off.. Los scripts de generación para agentes de larga duración pueden establecer esto en un mensaje de arranque más directivo. Una cadena vacía utiliza el valor predeterminado
CLAUDE_CODE_SCRIPT_CAPSObjeto JSON que limita cuántas veces se pueden invocar scripts específicos por sesión cuando se establece CLAUDE_CODE_SUBPROCESS_ENV_SCRUB. Las claves son subcadenas coincidentes contra el texto del comando; los valores son límites de llamadas enteros. Por ejemplo, {"deploy.sh": 2} permite que deploy.sh se llame como máximo dos veces. La coincidencia se basa en subcadenas, por lo que trucos de expansión de shell como ./scripts/deploy.sh $(evil) siguen contando contra el límite. El fan-out en tiempo de ejecución a través de xargs o find -exec no se detecta; este es un control de defensa en profundidad
CLAUDE_CODE_SCROLL_SPEEDEstablezca el multiplicador de desplazamiento de la rueda del ratón en renderizado a pantalla completa. Acepta valores de 1 a 20. Establezca en 3 para coincidir con vim si su terminal envía un evento de rueda por muesca sin amplificación. Se ignora en el terminal de IDE de JetBrains, donde Claude Code utiliza su propio manejo de desplazamiento
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSAnule el presupuesto de tiempo en milisegundos para hooks SessionEnd. Se aplica a la salida de sesión, /clear y cambio de sesiones a través de /resume interactivo. De forma predeterminada, el presupuesto es de 1,5 segundos, aumentado automáticamente al timeout más alto por hook configurado en archivos de configuración, hasta 60 segundos. Los tiempos de espera en hooks proporcionados por plugins no aumentan el presupuesto
CLAUDE_CODE_SESSION_IDSe establece automáticamente en subprocesos de herramientas Bash y PowerShell en el ID de sesión actual. Coincide con el campo session_id pasado a hooks. Se actualiza en /clear. Utilice para correlacionar scripts y herramientas externas con la sesión de Claude Code que las lanzó
CLAUDE_CODE_SHELLAnule la detección automática de shell. Útil cuando su shell de inicio difiere de su shell de trabajo preferido (por ejemplo, bash vs zsh)
CLAUDE_CODE_SHELL_PREFIXPrefijo de comando que envuelve comandos shell que Claude Code genera: llamadas de herramienta Bash, comandos hook y comandos de inicio de servidor MCP stdio. Útil para registro o auditoría. Ejemplo: establecer /path/to/logger.sh ejecuta cada comando como /path/to/logger.sh <command>
CLAUDE_CODE_SIMPLEEstablezca en 1 para ejecutar con un indicador del sistema mínimo y solo las herramientas Bash, lectura de archivo y edición de archivo. Las herramientas MCP de --mcp-config siguen estando disponibles. Deshabilita el descubrimiento automático de hooks, skills, plugins, servidores MCP, memoria automática y CLAUDE.md. La bandera CLI --bare establece esto
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTEstablezca en 1 para utilizar un indicador del sistema más corto y descripciones de herramientas abreviadas en cualquier modelo. Establezca en 0, false, no u off para optar por no participar incluso en modelos donde el experimento o la configuración del servidor lo habilitaría de otra manera. El conjunto completo de herramientas, hooks, servidores MCP y descubrimiento de CLAUDE.md permanecen habilitados
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTHOmita la autenticación del lado del cliente para Claude Platform on AWS, para puertas de enlace que firman solicitudes por sí mismas
CLAUDE_CODE_SKIP_BEDROCK_AUTHOmita la autenticación de AWS para Bedrock (por ejemplo, cuando se utiliza una puerta de enlace LLM)
CLAUDE_CODE_SKIP_FOUNDRY_AUTHOmita la autenticación de Azure para Microsoft Foundry (por ejemplo, cuando se utiliza una puerta de enlace LLM)
CLAUDE_CODE_SKIP_MANTLE_AUTHOmita la autenticación de AWS para Bedrock Mantle (por ejemplo, cuando se utiliza una puerta de enlace LLM)
CLAUDE_CODE_SKIP_PROMPT_HISTORYEstablezca en 1 para omitir escribir historial de indicadores y transcripciones de sesiones en disco. Las sesiones iniciadas con esta variable establecida no aparecen en --resume, --continue o historial de flecha hacia arriba. Útil para sesiones con scripts efímeros
CLAUDE_CODE_SKIP_VERTEX_AUTHOmita la autenticación de Google para Vertex (por ejemplo, cuando se utiliza una puerta de enlace LLM)
CLAUDE_CODE_SUBAGENT_MODELConsulte Configuración de modelo
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBEstablezca en 1 para eliminar credenciales de Anthropic y proveedores de nube de entornos de subprocesos (herramienta Bash, hooks, servidores MCP stdio). El proceso Claude principal mantiene estas credenciales para llamadas de API, pero los procesos secundarios no pueden leerlas, reduciendo la exposición a ataques de inyección de indicadores que intentan exfiltrar secretos a través de expansión de shell. En Linux, esto también ejecuta subprocesos Bash en un espacio de nombres PID aislado para que no puedan leer entornos de procesos de host a través de /proc; como efecto secundario, ps, pgrep y kill no pueden ver ni señalar procesos de host. claude-code-action establece esto automáticamente cuando se configura allowed_non_write_users
CLAUDE_CODE_SYNC_PLUGIN_INSTALLEstablezca en 1 en modo no interactivo (la bandera -p) para esperar a que se complete la instalación de plugins antes de la primera consulta. Sin esto, los plugins se instalan en segundo plano y pueden no estar disponibles en el primer turno. Combine con CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS para limitar la espera
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MSTiempo de espera en milisegundos para la instalación sincrónica de plugins. Cuando se excede, Claude Code continúa sin plugins y registra un error. Sin predeterminado: sin esta variable, la instalación sincrónica espera hasta completarse
CLAUDE_CODE_SYNTAX_HIGHLIGHTEstablezca en false para deshabilitar el resaltado de sintaxis en salida de diff. Útil cuando los colores interfieren con su configuración de terminal. Para también deshabilitar el resaltado en bloques de código y vistas previas de archivos, utilice la configuración syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_IDComparta una lista de tareas entre sesiones. Establezca el mismo ID en múltiples instancias de Claude Code para coordinar una lista de tareas compartida. Consulte Lista de tareas
CLAUDE_CODE_TEAM_NAMENombre del equipo de agentes al que pertenece este compañero de equipo. Se establece automáticamente en miembros de equipo de agentes
CLAUDE_CODE_TMPDIRAnule el directorio temporal utilizado para archivos temporales internos. Claude Code añade /claude-{uid}/ (Unix) o /claude/ (Windows) a esta ruta. Predeterminado: /tmp en macOS, os.tmpdir() en Linux/Windows
CLAUDE_CODE_TMUX_TRUECOLOREstablezca en 1 para permitir salida de truecolor de 24 bits dentro de tmux. De forma predeterminada, Claude Code se limita a 256 colores cuando se establece $TMUX porque tmux no pasa a través de secuencias de escape de truecolor a menos que se configure. Establezca esto después de agregar set -ga terminal-overrides ',*:Tc' a su ~/.tmux.conf. Consulte Configuración de terminal para otras configuraciones de tmux
CLAUDE_CODE_USE_ANTHROPIC_AWSUse Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCKUse Bedrock
CLAUDE_CODE_USE_FOUNDRYUse Microsoft Foundry
CLAUDE_CODE_USE_MANTLEUse el endpoint Mantle de Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCHEstablezca en 1 para descubrir comandos personalizados, subagentes y estilos de salida utilizando APIs de archivo de Node.js en lugar de ripgrep. Establezca esto si el binario ripgrep incluido no está disponible o está bloqueado en su entorno. No afecta a las herramientas Grep o búsqueda de archivos
CLAUDE_CODE_USE_POWERSHELL_TOOLControla la herramienta PowerShell. En Windows sin Git Bash, la herramienta se habilita automáticamente; establezca en 0 para deshabilitarla. En Windows con Git Bash instalado, la herramienta se está implementando progresivamente: establezca en 1 para optar por participar o 0 para optar por no participar. En Linux, macOS y WSL, establezca en 1 para habilitarla, lo que requiere pwsh en su PATH. Cuando se habilita en Windows, Claude puede ejecutar comandos de PowerShell de forma nativa en lugar de enrutarlos a través de Git Bash. Consulte Herramienta PowerShell
CLAUDE_CODE_USE_VERTEXUse Vertex
CLAUDE_CONFIG_DIRAnule el directorio de configuración (predeterminado: ~/.claude). Todos los ajustes, credenciales, historial de sesiones y plugins se almacenan bajo esta ruta. Útil para ejecutar múltiples cuentas lado a lado: por ejemplo, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
CLAUDE_EFFORTSe establece automáticamente en subprocesos de herramientas Bash y comandos hook en el nivel de esfuerzo activo para el turno: low, medium, high, xhigh o max. Coincide con el campo effort.level pasado a hooks. Solo se establece cuando el modelo actual admite el parámetro de esfuerzo
CLAUDE_ENABLE_BYTE_WATCHDOGEstablezca en 1 para forzar la habilitación del perro guardián de inactividad de transmisión a nivel de byte, o establezca en 0 para forzar su deshabilitación. Cuando no se establece, el perro guardián se habilita de forma predeterminada para conexiones de API de Anthropic. El perro guardián de byte aborta una conexión cuando no llegan bytes en el cable durante la duración establecida por CLAUDE_STREAM_IDLE_TIMEOUT_MS, con un mínimo de 5 minutos, independientemente del perro guardián a nivel de evento
CLAUDE_ENABLE_STREAM_WATCHDOGEstablezca en 1 para habilitar el perro guardián de inactividad de transmisión a nivel de evento. Desactivado de forma predeterminada. Para Bedrock, Vertex y Foundry, este es el único perro guardián de inactividad disponible. Configure el tiempo de espera con CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENV_FILERuta a un script de shell cuyo contenido Claude Code ejecuta antes de cada comando Bash en el mismo proceso de shell, por lo que las exportaciones en el archivo son visibles para el comando. Utilice para persistir la activación de virtualenv o conda entre comandos. También se completa dinámicamente por hooks SessionStart, Setup, CwdChanged y FileChanged
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIXPrefijo para nombres de sesión de Control Remoto generados automáticamente cuando no se proporciona un nombre explícito. El valor predeterminado es el nombre de host de su máquina, produciendo nombres como myhost-graceful-unicorn. La bandera CLI --remote-control-session-name-prefix establece el mismo valor para una única invocación
CLAUDE_STREAM_IDLE_TIMEOUT_MSTiempo de espera en milisegundos antes de que el perro guardián de inactividad de transmisión cierre una conexión estancada. Predeterminado y mínimo 300000 (5 minutos) para ambos perros guardianes a nivel de byte y a nivel de evento; los valores más bajos se fijan silenciosamente para absorber pausas de pensamiento extendido y almacenamiento en búfer de proxy. Para proveedores de terceros, requiere CLAUDE_ENABLE_STREAM_WATCHDOG=1
DEBUGEstablezca en 1 para habilitar el modo de depuración, equivalente a lanzar con --debug. Los registros de depuración se escriben en ~/.claude/debug/<session-id>.txt, o en la ruta establecida por CLAUDE_CODE_DEBUG_LOGS_DIR. Solo los valores verdaderos 1, true, yes y on habilitan el modo de depuración, por lo que patrones de espacio de nombres como DEBUG=express:* establecidos para otras herramientas no lo activan
DISABLE_AUTOUPDATEREstablezca en 1 para deshabilitar actualizaciones automáticas en segundo plano. El comando manual claude update sigue funcionando. Use DISABLE_UPDATES para bloquear ambos
DISABLE_AUTO_COMPACTEstablezca en 1 para deshabilitar la compactación automática cuando se aproxime al límite de contexto. El comando manual /compact sigue estando disponible. Utilice cuando desee control explícito sobre cuándo ocurre la compactación
DISABLE_COMPACTEstablezca en 1 para deshabilitar toda la compactación: tanto la compactación automática como el comando manual /compact
DISABLE_COST_WARNINGSEstablezca en 1 para deshabilitar mensajes de advertencia de costo
DISABLE_DOCTOR_COMMANDEstablezca en 1 para ocultar el comando /doctor. Útil para despliegues administrados donde los usuarios no deben ejecutar diagnósticos de instalación
DISABLE_ERROR_REPORTINGEstablezca en 1 para optar por no participar en el informe de errores de Sentry
DISABLE_EXTRA_USAGE_COMMANDEstablezca en 1 para ocultar el comando /extra-usage que permite a los usuarios comprar uso adicional más allá de los límites de velocidad
DISABLE_FEEDBACK_COMMANDEstablezca en 1 para deshabilitar el comando /feedback. El nombre anterior DISABLE_BUG_COMMAND también se acepta
DISABLE_GROWTHBOOKEstablezca en 1 para deshabilitar la obtención de banderas de características de GrowthBook y utilizar valores predeterminados de código para cada bandera. El registro de eventos de telemetría permanece activado a menos que DISABLE_TELEMETRY también esté establecido
DISABLE_INSTALLATION_CHECKSEstablezca en 1 para deshabilitar advertencias de instalación. Utilice solo cuando administre manualmente la ubicación de instalación, ya que esto puede enmascarar problemas con instalaciones estándar
DISABLE_INSTALL_GITHUB_APP_COMMANDEstablezca en 1 para ocultar el comando /install-github-app. Ya está oculto cuando se utilizan proveedores de terceros (Bedrock, Vertex o Foundry)
DISABLE_INTERLEAVED_THINKINGEstablezca en 1 para evitar enviar el encabezado beta de pensamiento intercalado. Útil cuando su puerta de enlace LLM o proveedor no admite pensamiento intercalado
DISABLE_LOGIN_COMMANDEstablezca en 1 para ocultar el comando /login. Útil cuando la autenticación se maneja externamente a través de claves de API o apiKeyHelper
DISABLE_LOGOUT_COMMANDEstablezca en 1 para ocultar el comando /logout
DISABLE_PROMPT_CACHINGEstablezca en 1 para deshabilitar el almacenamiento en caché de indicadores para todos los modelos (tiene precedencia sobre la configuración por modelo)
DISABLE_PROMPT_CACHING_HAIKUEstablezca en 1 para deshabilitar el almacenamiento en caché de indicadores para modelos Haiku
DISABLE_PROMPT_CACHING_OPUSEstablezca en 1 para deshabilitar el almacenamiento en caché de indicadores para modelos Opus
DISABLE_PROMPT_CACHING_SONNETEstablezca en 1 para deshabilitar el almacenamiento en caché de indicadores para modelos Sonnet
DISABLE_TELEMETRYEstablezca en 1 para optar por no participar en la telemetría. Los eventos de telemetría no incluyen datos de usuario como código, rutas de archivo o comandos bash. También deshabilita banderas de características, por lo que algunas características que aún se están implementando pueden no estar disponibles
DISABLE_UPDATESEstablezca en 1 para bloquear todas las actualizaciones, incluido el comando manual claude update y claude install. Más estricto que DISABLE_AUTOUPDATER. Utilice cuando distribuya Claude Code a través de sus propios canales y los usuarios no deben auto-actualizarse
DISABLE_UPGRADE_COMMANDEstablezca en 1 para ocultar el comando /upgrade
DO_NOT_TRACKEstablezca en 1 para optar por no participar en la telemetría. Equivalente a establecer DISABLE_TELEMETRY. Honrado como la convención estándar entre herramientas
ENABLE_CLAUDEAI_MCP_SERVERSEstablezca en false para deshabilitar servidores MCP de claude.ai en Claude Code. Habilitado de forma predeterminada para usuarios conectados
ENABLE_PROMPT_CACHING_1HEstablezca en 1 para solicitar un TTL de caché de indicador de 1 hora en lugar de los 5 minutos predeterminados. Destinado a usuarios de clave de API, Bedrock, Vertex, Foundry y Claude Platform on AWS. Los usuarios de suscripción reciben TTL de 1 hora automáticamente. Las escrituras de caché de 1 hora se facturan a una tasa más alta
ENABLE_PROMPT_CACHING_1H_BEDROCKDeprecated. Use ENABLE_PROMPT_CACHING_1H instead
ENABLE_TOOL_SEARCHControla búsqueda de herramientas MCP. Sin establecer: todas las herramientas MCP diferidas de forma predeterminada, pero cargadas por adelantado en Vertex AI o cuando ANTHROPIC_BASE_URL apunta a un host que no es de primera parte. Valores: true (siempre diferir e incluir el encabezado beta, las solicitudes fallan en Vertex AI o proxies que no admiten tool_reference), auto (modo de umbral: cargar por adelantado si las herramientas caben dentro del 10% del contexto), auto:N (umbral personalizado, p. ej., auto:5 para 5%), false (cargar todo por adelantado)
FALLBACK_FOR_ALL_PRIMARY_MODELSEstablezca en cualquier valor no vacío para activar el respaldo a --fallback-model después de errores de sobrecarga repetidos en cualquier modelo principal. De forma predeterminada, solo los modelos Opus activan el respaldo
FORCE_AUTOUPDATE_PLUGINSEstablezca en 1 para forzar actualizaciones automáticas de plugins incluso cuando el actualizador automático principal está deshabilitado mediante DISABLE_AUTOUPDATER
FORCE_PROMPT_CACHING_5MEstablezca en 1 para forzar el TTL de caché de indicador de 5 minutos incluso cuando el TTL de 1 hora se aplicaría de otra manera. Anula ENABLE_PROMPT_CACHING_1H
HTTP_PROXYEspecifique el servidor proxy HTTP para conexiones de red
HTTPS_PROXYEspecifique el servidor proxy HTTPS para conexiones de red
IS_DEMOEstablezca en 1 para habilitar el modo de demostración: oculta su correo electrónico y nombre de organización del encabezado y salida de /status, y omite la incorporación. Útil cuando transmite o graba una sesión
MAX_MCP_OUTPUT_TOKENSNúmero máximo de tokens permitidos en respuestas de herramientas MCP. Claude Code muestra una advertencia cuando la salida excede 10,000 tokens. Las herramientas que declaran anthropic/maxResultSizeChars utilizan ese límite de caracteres para contenido de texto en su lugar, pero el contenido de imagen de esas herramientas sigue estando sujeto a esta variable (predeterminado: 25000)
MAX_STRUCTURED_OUTPUT_RETRIESNúmero de veces para reintentar cuando la respuesta del modelo falla la validación contra el --json-schema en modo no interactivo (la bandera -p). El valor predeterminado es 5
MAX_THINKING_TOKENSAnule el presupuesto de tokens de pensamiento extendido. El techo es el máximo de tokens de salida del modelo menos uno. Establezca en 0 para deshabilitar el pensamiento completamente. En modelos con razonamiento adaptativo, el presupuesto se ignora a menos que el razonamiento adaptativo esté deshabilitado a través de CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING
MCP_CLIENT_SECRETSecreto de cliente OAuth para servidores MCP que requieren credenciales preconfiguradas. Evita el indicador interactivo al agregar un servidor con --client-secret
MCP_CONNECTION_NONBLOCKINGEstablezca en true en modo no interactivo (-p) para omitir completamente la espera de conexión MCP. Útil para canalizaciones con scripts donde las herramientas MCP no son necesarias. Sin esta variable, la primera consulta espera hasta 5 segundos para que se conecten los servidores --mcp-config. Los servidores configurados con alwaysLoad: true siempre bloquean el inicio independientemente de esta variable, ya que sus herramientas deben estar presentes cuando se construye el primer indicador
MCP_CONNECT_TIMEOUT_MSCuánto tiempo espera la primera consulta, en milisegundos, para que se complete el lote de conexión MCP antes de tomar una instantánea de la lista de herramientas (predeterminado: 5000). Los servidores aún pendientes en la fecha límite continúan conectándose en segundo plano pero no aparecerán hasta la siguiente consulta. Distinto de MCP_TIMEOUT, que limita el intento de conexión de un servidor individual. Más relevante para sesiones no interactivas que emiten una única consulta y necesitan que servidores de conexión lenta sean visibles
MCP_OAUTH_CALLBACK_PORTPuerto fijo para la devolución de llamada de redirección de OAuth, como alternativa a --callback-port al agregar un servidor MCP con credenciales preconfiguradas
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZENúmero máximo de servidores MCP remotos (HTTP/SSE) para conectar en paralelo durante el inicio (predeterminado: 20)
MCP_SERVER_CONNECTION_BATCH_SIZENúmero máximo de servidores MCP locales (stdio) para conectar en paralelo durante el inicio (predeterminado: 3)
MCP_TIMEOUTTiempo de espera en milisegundos para el inicio del servidor MCP (predeterminado: 30000, o 30 segundos)
MCP_TOOL_TIMEOUTTiempo de espera en milisegundos para la ejecución de herramientas MCP (predeterminado: 100000000, aproximadamente 28 horas)
NO_PROXYLista de dominios e IPs a los que se emitirán solicitudes directamente, omitiendo el proxy
OTEL_LOG_RAW_API_BODIESEmita el JSON completo de solicitud y respuesta de la API de Mensajes de Anthropic como eventos de registro api_request_body / api_response_body. Establezca en 1 para cuerpos en línea truncados en 60 KB, o file:<dir> para escribir cuerpos sin truncar en disco y emitir una ruta body_ref en su lugar. Deshabilitado de forma predeterminada; los cuerpos incluyen todo el historial de conversación. Consulte Monitoreo
OTEL_LOG_TOOL_CONTENTEstablezca en 1 para incluir contenido de entrada y salida de herramientas en eventos de span de OpenTelemetry. Deshabilitado de forma predeterminada para proteger datos sensibles. Consulte Monitoreo
OTEL_LOG_TOOL_DETAILSEstablezca en 1 para incluir argumentos de entrada de herramientas, nombres de servidores MCP, cadenas de error sin procesar en fallos de herramientas y otros detalles de herramientas en trazas y registros de OpenTelemetry. Deshabilitado de forma predeterminada para proteger PII. Consulte Monitoreo
OTEL_LOG_USER_PROMPTSEstablezca en 1 para incluir texto de indicador de usuario en trazas y registros de OpenTelemetry. Deshabilitado de forma predeterminado (los indicadores se redactan). Consulte Monitoreo
OTEL_METRICS_INCLUDE_ACCOUNT_UUIDEstablezca en false para excluir UUID de cuenta de atributos de métricas (predeterminado: incluido). Consulte Monitoreo
OTEL_METRICS_INCLUDE_SESSION_IDEstablezca en false para excluir ID de sesión de atributos de métricas (predeterminado: incluido). Consulte Monitoreo
OTEL_METRICS_INCLUDE_VERSIONEstablezca en true para incluir la versión de Claude Code en atributos de métricas (predeterminado: excluido). Consulte Monitoreo
SLASH_COMMAND_TOOL_CHAR_BUDGETAnule el presupuesto de caracteres para metadatos de skills mostrados a la herramienta Skill. El presupuesto se escala dinámicamente al 1% de la ventana de contexto, con un respaldo de 8,000 caracteres. Nombre heredado mantenido para compatibilidad hacia atrás
TASK_MAX_OUTPUT_LENGTHNúmero máximo de caracteres en salida de subagentes antes del truncamiento (predeterminado: 32000, máximo: 160000). Cuando se trunca, la salida completa se guarda en disco y la ruta se incluye en la respuesta truncada
USE_BUILTIN_RIPGREPEstablezca en 0 para utilizar rg instalado en el sistema en lugar de rg incluido con Claude Code
VERTEX_REGION_CLAUDE_3_5_HAIKUAnule la región para Claude 3.5 Haiku al usar Vertex AI
VERTEX_REGION_CLAUDE_3_5_SONNETAnule la región para Claude 3.5 Sonnet al usar Vertex AI
VERTEX_REGION_CLAUDE_3_7_SONNETAnule la región para Claude 3.7 Sonnet al usar Vertex AI
VERTEX_REGION_CLAUDE_4_0_OPUSAnule la región para Claude 4.0 Opus al usar Vertex AI
VERTEX_REGION_CLAUDE_4_0_SONNETAnule la región para Claude 4.0 Sonnet al usar Vertex AI
VERTEX_REGION_CLAUDE_4_1_OPUSAnule la región para Claude 4.1 Opus al usar Vertex AI
VERTEX_REGION_CLAUDE_4_5_OPUSAnule la región para Claude Opus 4.5 al usar Vertex AI
VERTEX_REGION_CLAUDE_4_5_SONNETAnule la región para Claude Sonnet 4.5 al usar Vertex AI
VERTEX_REGION_CLAUDE_4_6_OPUSAnule la región para Claude Opus 4.6 al usar Vertex AI
VERTEX_REGION_CLAUDE_4_6_SONNETAnule la región para Claude Sonnet 4.6 al usar Vertex AI
VERTEX_REGION_CLAUDE_4_7_OPUSAnule la región para Claude Opus 4.7 al usar Vertex AI
VERTEX_REGION_CLAUDE_HAIKU_4_5Anule la región para Claude Haiku 4.5 al usar Vertex AI
También se admiten variables estándar de exportador de OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES y variantes específicas de señal). Consulte Monitoreo para detalles de configuración.

​
Véase también