Pular para o conteúdo 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 suporta as seguintes variáveis de ambiente para controlar seu comportamento. Configure-as no seu shell antes de iniciar claude, ou configure-as em settings.json sob a chave env para aplicá-las a cada sessão ou distribuí-las em sua equipe.
VariávelPropósito
ANTHROPIC_API_KEYChave de API enviada como cabeçalho X-Api-Key. Quando definida, essa chave é usada em vez de sua assinatura Claude Pro, Max, Team ou Enterprise, mesmo que você esteja conectado. Em modo não interativo (-p), a chave é sempre usada quando presente. Em modo interativo, você é solicitado a aprovar a chave uma vez antes de ela substituir sua assinatura. Para usar sua assinatura em vez disso, execute unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKENValor personalizado para o cabeçalho Authorization (o valor que você definir aqui será prefixado com Bearer )
ANTHROPIC_AWS_API_KEYChave de API do workspace para Claude Platform on AWS, gerada no AWS Console. Enviada como x-api-key e tem precedência sobre AWS SigV4
ANTHROPIC_AWS_BASE_URLSubstitua a URL do endpoint Claude Platform on AWS. Use para regiões personalizadas ou ao rotear através de um gateway LLM. Padrão é https://aws-external-anthropic.{AWS_REGION}.api.aws
ANTHROPIC_AWS_WORKSPACE_IDObrigatório para Claude Platform on AWS. Enviado em cada solicitação como cabeçalho anthropic-workspace-id
ANTHROPIC_BASE_URLSubstitua o endpoint da API para rotear solicitações através de um proxy ou gateway. Quando definido para um host que não é de primeira parte, busca de ferramentas MCP é desabilitada por padrão. Defina ENABLE_TOOL_SEARCH=true se seu proxy encaminha blocos tool_reference
ANTHROPIC_BEDROCK_BASE_URLSubstitua a URL do endpoint Bedrock. Use para endpoints Bedrock personalizados ou ao rotear através de um gateway LLM. Veja Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URLSubstitua a URL do endpoint Bedrock Mantle. Veja endpoint Mantle
ANTHROPIC_BEDROCK_SERVICE_TIERBedrock service tier (default, flex ou priority). Enviado como cabeçalho X-Amzn-Bedrock-Service-Tier. Veja Amazon Bedrock
ANTHROPIC_BETASLista separada por vírgula de valores de cabeçalho anthropic-beta adicionais para incluir em solicitações de API. Claude Code já envia os cabeçalhos beta que precisa; use isso para optar por um beta da API Anthropic antes que Claude Code adicione suporte nativo. Diferentemente da flag --betas, que requer autenticação de chave de API, essa variável funciona com todos os métodos de autenticação, incluindo assinatura Claude.ai
ANTHROPIC_CUSTOM_HEADERSCabeçalhos personalizados para adicionar às solicitações (formato Name: Value, separados por quebra de linha para múltiplos cabeçalhos)
ANTHROPIC_CUSTOM_MODEL_OPTIONID do modelo para adicionar como entrada personalizada no seletor /model. Use isso para tornar um modelo não padrão ou específico de gateway selecionável sem substituir aliases integrados. Veja Configuração de modelo
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTIONDescrição de exibição para a entrada de modelo personalizado no seletor /model. Padrão é Custom model (<model-id>) quando não definido
ANTHROPIC_CUSTOM_MODEL_OPTION_NAMENome de exibição para a entrada de modelo personalizado no seletor /model. Padrão é o ID do modelo quando não definido
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIESVeja Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODELVeja Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTIONVeja Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAMEVeja Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIESVeja Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODELVeja Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTIONVeja Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_NAMEVeja Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIESVeja Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODELVeja Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTIONVeja Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_NAMEVeja Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIESVeja Configuração de modelo
ANTHROPIC_FOUNDRY_API_KEYChave de API para autenticação do Microsoft Foundry (veja Microsoft Foundry)
ANTHROPIC_FOUNDRY_BASE_URLURL base completa para o recurso Foundry (por exemplo, https://my-resource.services.ai.azure.com/anthropic). Alternativa para ANTHROPIC_FOUNDRY_RESOURCE (veja Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCENome do recurso Foundry (por exemplo, my-resource). Obrigatório se ANTHROPIC_FOUNDRY_BASE_URL não estiver definido (veja Microsoft Foundry)
ANTHROPIC_MODELNome da configuração de modelo a usar (veja Configuração de modelo)
ANTHROPIC_SMALL_FAST_MODEL[DEPRECATED] Nome do modelo da classe Haiku para tarefas em segundo plano
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGIONSubstitua a região AWS para o modelo da classe Haiku ao usar Bedrock ou Bedrock Mantle. Em Bedrock, isso só tem efeito quando ANTHROPIC_DEFAULT_HAIKU_MODEL ou o descontinuado ANTHROPIC_SMALL_FAST_MODEL também está definido, já que Bedrock de outra forma usa o modelo primário para tarefas em segundo plano
ANTHROPIC_VERTEX_BASE_URLSubstitua a URL do endpoint Vertex AI. Use para endpoints Vertex personalizados ou ao rotear através de um gateway LLM. Veja Google Vertex AI
ANTHROPIC_VERTEX_PROJECT_IDID do projeto GCP para solicitações Vertex AI. Substituído por GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT ou o projeto no seu arquivo de credenciais GOOGLE_APPLICATION_CREDENTIALS. Veja Google Vertex AI
ANTHROPIC_WORKSPACE_IDID do workspace para federação de identidade de carga de trabalho. Defina isso quando sua regra de federação está no escopo de mais de um workspace para que a troca de token saiba qual workspace direcionar
API_TIMEOUT_MSTempo limite para solicitações de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente isso quando as solicitações expiram em redes lentas ou ao rotear através de um proxy. Valores acima do máximo causam overflow do temporizador subjacente e fazem com que as solicitações falhem imediatamente
AWS_BEARER_TOKEN_BEDROCKChave de API do Bedrock para autenticação (veja Chaves de API do Bedrock)
BASH_DEFAULT_TIMEOUT_MSTempo limite padrão para comandos bash de longa duração (padrão: 120000, ou 2 minutos)
BASH_MAX_OUTPUT_LENGTHNúmero máximo de caracteres nas saídas bash antes da saída completa ser salva em um arquivo e Claude receber o caminho mais uma visualização curta. Veja Comportamento da ferramenta Bash
BASH_MAX_TIMEOUT_MSTempo limite máximo que o modelo pode definir para comandos bash de longa duração (padrão: 600000, ou 10 minutos)
CCR_FORCE_BUNDLEDefina como 1 para forçar claude --remote a agrupar e fazer upload do seu repositório local mesmo quando o acesso ao GitHub está disponível
CLAUDECODEDefina como 1 em ambientes de shell que Claude Code gera (ferramenta Bash, sessões tmux). Não definido em hooks ou comandos de linha de status. Use para detectar quando um script está sendo executado dentro de um shell gerado por Claude Code
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTSDefina como 1 para desabilitar todos os tipos de subagente integrados, como Explore e Plan. Aplica-se apenas em modo não interativo (a flag -p). Útil para usuários do SDK que desejam uma tela em branco
CLAUDE_AGENT_SDK_MCP_NO_PREFIXDefina como 1 para pular o prefixo mcp__<server>__ em nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas uso do SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSTempo limite de travamento em milissegundos para subagentes em segundo plano. Padrão 600000 (10 minutos). O temporizador é reiniciado em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o subagente é abortado e a tarefa é marcada como falha, exibindo qualquer resultado parcial para o pai
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEDefina a porcentagem da capacidade de contexto (1-100) na qual a auto-compactação é acionada. Por padrão, a auto-compactação é acionada em aproximadamente 95% de capacidade. Use valores mais baixos como 50 para compactar mais cedo. Valores acima do limite padrão não têm efeito. Aplica-se a conversas principais e subagentes. Esta porcentagem se alinha com o campo context_window.used_percentage disponível na linha de status
CLAUDE_AUTO_BACKGROUND_TASKSDefina como 1 para forçar a habilitação do envio automático para segundo plano de tarefas de agente de longa duração. Quando habilitado, subagentes são movidos para o segundo plano após executarem por aproximadamente dois minutos
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIRRetorne ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal
CLAUDE_CODE_ACCESSIBILITYDefina como 1 para manter o cursor do terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDDefina como 1 para carregar arquivos de memória de diretórios especificados com --add-dir. Carrega CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md e CLAUDE.local.md. Por padrão, diretórios adicionais não carregam arquivos de memória
CLAUDE_CODE_API_KEY_HELPER_TTL_MSIntervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar apiKeyHelper)
CLAUDE_CODE_ATTRIBUTION_HEADERDefina como 0 para omitir o bloco de atribuição (versão do cliente e impressão digital do prompt) do início do prompt do sistema. Desabilitá-lo melhora as taxas de acerto do cache de prompt ao rotear através de um gateway LLM. O cache da API Anthropic não é afetado
CLAUDE_CODE_AUTO_COMPACT_WINDOWDefina a capacidade de contexto em tokens usada para cálculos de auto-compactação. Padrão é a janela de contexto do modelo: 200K para modelos padrão ou 1M para modelos de contexto estendido. Use um valor mais baixo como 500000 em um modelo de 1M para tratar a janela como 500K para fins de compactação. O valor é limitado à janela de contexto real do modelo. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE é aplicado como uma porcentagem deste valor. Definir esta variável desacopla o limite de compactação do used_percentage da linha de status, que sempre usa a janela de contexto completa do modelo
CLAUDE_CODE_AUTO_CONNECT_IDESubstitua a conexão IDE automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE suportada. Defina como false para evitar isso. Defina como true para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global autoConnectIde
CLAUDE_CODE_CERT_STORELista separada por vírgula de fontes de certificado CA para conexões TLS. bundled é o conjunto de CA Mozilla fornecido com Claude Code. system é o armazenamento de confiança do sistema operacional. Padrão é bundled,system
CLAUDE_CODE_CLIENT_CERTCaminho para arquivo de certificado do cliente para autenticação mTLS
CLAUDE_CODE_CLIENT_KEYCaminho para arquivo de chave privada do cliente para autenticação mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASEFrase-passe para CLAUDE_CODE_CLIENT_KEY criptografada (opcional)
CLAUDE_CODE_DEBUG_LOGS_DIRSubstitua o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja habilitado separadamente via --debug, /debug ou a variável de ambiente DEBUG: definir apenas essa variável não habilita o logging. A flag --debug-file faz ambos de uma vez. Padrão é ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVELNível de log mínimo escrito no arquivo de log de depuração. Valores: verbose, debug (padrão), info, warn, error. Defina como verbose para incluir diagnósticos de alto volume como saída completa de comando de linha de status, ou aumente para error para reduzir ruído
CLAUDE_CODE_DISABLE_1M_CONTEXTDefina como 1 para desabilitar suporte a janela de contexto de 1M. Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo. Útil para ambientes corporativos com requisitos de conformidade
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKINGDefina como 1 para desabilitar raciocínio adaptativo em Opus 4.6 e Sonnet 4.6 e voltar ao orçamento de pensamento fixo controlado por MAX_THINKING_TOKENS. Não tem efeito em Opus 4.7, que sempre usa raciocínio adaptativo
CLAUDE_CODE_DISABLE_AGENT_VIEWDefina como 1 para desativar agentes em segundo plano e visualização de agentes: claude agents, --bg, /background e o supervisor sob demanda. Equivalente à configuração disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREENDefina como 1 para desabilitar renderização em tela cheia e usar o renderizador de tela principal clássico. A conversa permanece no scrollback nativo do seu terminal para que Cmd+f e modo de cópia tmux funcionem como de costume. Tem precedência sobre CLAUDE_CODE_NO_FLICKER e a configuração tui. Você também pode alternar com /tui default
CLAUDE_CODE_DISABLE_ATTACHMENTSDefina como 1 para desabilitar o processamento de anexos. Menções de arquivo com sintaxe @ são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo
CLAUDE_CODE_DISABLE_AUTO_MEMORYDefina como 1 para desabilitar memória automática. Defina como 0 para forçar a memória automática mesmo quando --bare mode ou autoMemoryEnabled: false desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSDefina como 1 para desabilitar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro run_in_background em ferramentas Bash e subagent, auto-backgrounding e o atalho Ctrl+B
CLAUDE_CODE_DISABLE_CLAUDE_MDSDefina como 1 para evitar carregar qualquer arquivo de memória CLAUDE.md no contexto, incluindo arquivos de usuário, projeto e memória automática
CLAUDE_CODE_DISABLE_CRONDefina como 1 para desabilitar tarefas agendadas. A skill /loop e ferramentas cron ficam indisponíveis e qualquer tarefa já agendada para de disparar, incluindo tarefas que já estão em execução no meio da sessão
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASDefina como 1 para remover cabeçalhos de solicitação anthropic-beta específicos do Anthropic e campos de esquema de ferramenta beta (como defer_loading e eager_input_streaming) de solicitações de API. Use isso quando um gateway proxy rejeita solicitações com erros como “Unexpected value(s) for the anthropic-beta header” ou “Extra inputs are not permitted”. Campos padrão (name, description, input_schema, cache_control) são preservados.
CLAUDE_CODE_DISABLE_FAST_MODEDefina como 1 para desabilitar modo rápido
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEYDefina como 1 para desabilitar as pesquisas de qualidade de sessão “Como Claude está se saindo?”. Pesquisas também são desabilitadas quando DISABLE_TELEMETRY, DO_NOT_TRACK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definido, a menos que CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL opte por participar novamente. Para definir uma taxa de amostra em vez de desabilitar completamente, use a configuração feedbackSurveyRate. Veja Pesquisas de qualidade de sessão
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGDefina como 1 para desabilitar checkpointing de arquivo. O comando /rewind não será capaz de restaurar alterações de código
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSDefina como 1 para remover instruções de fluxo de trabalho de commit e PR integradas e o snapshot de status git do prompt do sistema do Claude. Útil ao usar suas próprias skills de fluxo de trabalho git. Tem precedência sobre a configuração includeGitInstructions quando definido
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAPDefina como 1 para evitar remapeamento automático de Opus 4.0 e 4.1 para a versão Opus atual na API Anthropic. Use quando você deseja intencionalmente fixar um modelo mais antigo. O remapeamento não é executado em Bedrock, Vertex ou Foundry
CLAUDE_CODE_DISABLE_MOUSEDefina como 1 para desabilitar rastreamento de mouse em renderização em tela cheia. A rolagem por teclado com PgUp e PgDn ainda funciona. Use isso para manter o comportamento nativo de cópia ao selecionar do seu terminal
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICEquivalente a definir DISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING e DISABLE_TELEMETRY
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACKDefina como 1 para desabilitar o fallback não-streaming quando uma solicitação de streaming falha no meio do stream. Erros de streaming se propagam para a camada de retry em vez disso. Útil quando um proxy ou gateway causa o fallback para produzir execução de ferramenta duplicada
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALLDefina como 1 para pular a adição automática do marketplace de plugin oficial na primeira execução
CLAUDE_CODE_DISABLE_POLICY_SKILLSDefina como 1 para pular o carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de contêiner ou CI que não devem carregar skills provisionadas pelo operador
CLAUDE_CODE_DISABLE_TERMINAL_TITLEDefina como 1 para desabilitar atualizações automáticas de título do terminal com base no contexto da conversa
CLAUDE_CODE_DISABLE_THINKINGDefina como 1 para forçar a desabilitação de pensamento estendido independentemente do suporte do modelo ou outras configurações. Mais direto que MAX_THINKING_TOKENS=0
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLLDefina como 1 para desabilitar rolagem virtual em renderização em tela cheia e renderizar cada mensagem na transcrição. Use isso se a rolagem em modo tela cheia mostrar regiões em branco onde as mensagens deveriam aparecer
CLAUDE_CODE_EFFORT_LEVELDefina o nível de esforço para modelos suportados. Valores: low, medium, high, xhigh, max ou auto para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre /effort e a configuração effortLevel. Veja Ajustar nível de esforço
CLAUDE_CODE_ENABLE_AWAY_SUMMARYSubstitua a disponibilidade de recapitulação de sessão. Defina como 0 para forçar recapitulações desativadas independentemente do toggle /config. Defina como 1 para forçar recapitulações ativadas quando awaySummaryEnabled é false. Tem precedência sobre a configuração e toggle /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESHDefina como 1 para atualizar o estado do plugin em limites de turno em modo não interativo após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o prompt do sistema no meio da sessão, o que invalida prompt caching para esse turno
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELDefina como 1 para rotear a pesquisa de qualidade de sessão “Como Claude está se saindo?” para seu próprio coletor OpenTelemetry quando o tráfego não essencial vinculado ao Anthropic está bloqueado. As classificações de pesquisa são emitidas apenas como eventos OTEL para seu coletor configurado. Nenhum dado de pesquisa é enviado ao Anthropic neste modo. Aplica-se quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY ou DO_NOT_TRACK está definido, e não tem efeito caso contrário. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY e a política de feedback do produto da organização têm precedência
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMINGControla se as entradas de chamada de ferramenta são transmitidas da API conforme Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como uma escrita de arquivo longa, chega apenas após Claude terminar de gerá-la, o que pode parecer que está travando. Habilitado por padrão na API Anthropic. Em Bedrock e Vertex, habilitado por modelo onde o contêiner implantado suporta. Defina como 0 para optar por não participar. Defina como 1 para forçar a habilitação ao rotear através de um proxy via ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL ou ANTHROPIC_BEDROCK_BASE_URL. Desativado por padrão em Foundry e conexões gateway
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYDefina como 1 para popular o seletor /model a partir do endpoint /v1/models do seu gateway quando ANTHROPIC_BASE_URL aponta para um gateway compatível com Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque gateways apoiados por uma chave de API compartilhada mostrariam de outra forma cada usuário cada modelo que a chave pode acessar. Modelos descobertos ainda são filtrados pela lista de permissões availableModels
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODEDefina como 1 para executar modo rápido em Claude Opus 4.7 em vez de Opus 4.6. Com a variável definida, /fast muda para Opus 4.7; sem ela, /fast continua a usar Opus 4.6
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONDefina como false para desabilitar sugestões de prompt (o toggle “Prompt suggestions” em /config). Estas são as previsões acinzentadas que aparecem na sua entrada de prompt após Claude responder. Veja Sugestões de prompt
CLAUDE_CODE_ENABLE_TASKSDefina como 1 para habilitar o sistema de rastreamento de tarefas em modo não interativo (a flag -p). As tarefas estão ativadas por padrão em modo interativo. Veja Lista de tarefas
CLAUDE_CODE_ENABLE_TELEMETRYDefina como 1 para habilitar coleta de dados OpenTelemetry para métricas e logging. Obrigatório antes de configurar exportadores OTel. Veja Monitoramento
CLAUDE_CODE_EXIT_AFTER_STOP_DELAYTempo em milissegundos para aguardar após o loop de consulta ficar ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts usando modo SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSDefina como 1 para habilitar equipes de agentes. As equipes de agentes são experimentais e desabilitadas por padrão
CLAUDE_CODE_EXTRA_BODYObjeto JSON para mesclar no nível superior de cada corpo de solicitação de API. Útil para passar parâmetros específicos do provedor que Claude Code não expõe diretamente
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSSubstitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores na íntegra
CLAUDE_CODE_FORCE_SYNC_OUTPUTDefina como 1 para forçar a habilitação do modo privado DEC 2026 saída sincronizada quando seu terminal suporta mas não é detectado automaticamente. Útil para emuladores como eat do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux
CLAUDE_CODE_FORK_SUBAGENTDefina como 1 para habilitar subagentes bifurcados. Um subagente bifurcado herda o contexto de conversa completo da sessão principal em vez de começar do zero. Quando habilitado, /fork gera um subagente bifurcado em vez de agir como um alias para /branch, e todos os spawns de subagente são executados em segundo plano. Funciona em modo interativo e via SDK ou claude -p
CLAUDE_CODE_GIT_BASH_PATHApenas Windows: caminho para o executável Git Bash (bash.exe). Use quando Git Bash está instalado mas não está no seu PATH. Veja Configuração do Windows
CLAUDE_CODE_GLOB_HIDDENDefina como false para excluir dotfiles dos resultados quando Claude invoca a ferramenta Glob. Incluído por padrão. Não afeta autocomplete de arquivo @, ls, Grep ou Read
CLAUDE_CODE_GLOB_NO_IGNOREDefina como false para fazer a ferramenta Glob respeitar padrões .gitignore. Por padrão, Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo git. Não afeta autocomplete de arquivo @, que tem sua própria configuração respectGitignore
CLAUDE_CODE_GLOB_TIMEOUT_SECONDSTempo limite em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL
CLAUDE_CODE_HIDE_CWDDefina como 1 para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO
CLAUDE_CODE_IDE_HOST_OVERRIDESubstitua o endereço de host usado para conectar à extensão IDE. Por padrão, Claude Code detecta automaticamente o endereço correto, incluindo roteamento WSL-para-Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLPule a auto-instalação de extensões IDE. Equivalente a definir autoInstallIdeExtension como false
CLAUDE_CODE_IDE_SKIP_VALID_CHECKDefina como 1 para pular validação de entradas de arquivo de bloqueio IDE durante a conexão. Use quando a auto-conexão falha em encontrar sua IDE apesar dela estar em execução
CLAUDE_CODE_MAX_CONTEXT_TOKENSSubstitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. Só tem efeito quando DISABLE_COMPACT também está definido. Use isso ao rotear para um modelo através de ANTHROPIC_BASE_URL cuja janela de contexto não corresponde ao tamanho integrado para seu nome
CLAUDE_CODE_MAX_OUTPUT_TOKENSDefina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja max output tokens. Aumentar este valor reduz a janela de contexto efetiva disponível antes que auto-compactação seja acionada.
CLAUDE_CODE_MAX_RETRIESSubstitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10)
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYNúmero máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo mas consomem mais recursos
CLAUDE_CODE_MAX_TURNSLimite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar --max-turns, que tem precedência quando ambos estão definidos. Um valor que não é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite
CLAUDE_CODE_MCP_ALLOWLIST_ENVDefina como 1 para gerar servidores MCP stdio com apenas um ambiente de linha de base segura mais o env configurado do servidor, em vez de herdar seu ambiente de shell
CLAUDE_CODE_NATIVE_CURSORDefina como 1 para mostrar o cursor próprio do terminal no cursor de entrada em vez de um bloco desenhado. O cursor respeita as configurações de piscar, forma e foco do terminal
CLAUDE_CODE_NEW_INITDefina como 1 para fazer /init executar um fluxo de configuração interativo. O fluxo pergunta quais arquivos gerar, incluindo CLAUDE.md, skills e hooks, antes de explorar a base de código e escrevê-los. Sem essa variável, /init gera um CLAUDE.md automaticamente sem solicitar.
CLAUDE_CODE_NO_FLICKERDefina como 1 para habilitar renderização em tela cheia, uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Equivalente à configuração tui; você também pode alternar com /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKENToken de atualização OAuth para autenticação Claude.ai. Quando definido, claude auth login troca esse token diretamente em vez de abrir um navegador. Requer CLAUDE_CODE_OAUTH_SCOPES. Útil para provisionar autenticação em ambientes automatizados
CLAUDE_CODE_OAUTH_SCOPESEscopos OAuth separados por espaço com os quais o token de atualização foi emitido, como "user:profile user:inference user:sessions:claude_code". Obrigatório quando CLAUDE_CODE_OAUTH_REFRESH_TOKEN está definido
CLAUDE_CODE_OAUTH_TOKENToken de acesso OAuth para autenticação Claude.ai. Alternativa a /login para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas em keychain. Gere um com claude setup-token
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDEDefina como 1 para manter modo rápido em Claude Opus 4.6. Tem precedência sobre CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE, então defina isso se você precisar fixar Opus 4.6 independentemente de como o padrão muda
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MSTempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja Monitoramento
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MSIntervalo para atualizar cabeçalhos OpenTelemetry dinâmicos em milissegundos (padrão: 1740000 / 29 minutos). Veja Cabeçalhos dinâmicos
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MSTempo limite em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja Monitoramento
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEDefina como 1 para permitir que Claude Code execute o comando de atualização do seu gerenciador de pacotes em segundo plano quando uma nova versão estiver disponível. Aplica-se a instalações Homebrew e WinGet. Outros gerenciadores de pacotes continuam a mostrar o comando de atualização sem executá-lo. Veja Auto updates
CLAUDE_CODE_PERFORCE_MODEDefina como 1 para habilitar proteção de escrita ciente de Perforce. Quando definido, Edit, Write e NotebookEdit falham com uma dica p4 edit <file> se o arquivo de destino não tiver o bit de escrita do proprietário, que Perforce limpa em arquivos sincronizados até que p4 edit os abra. Isso evita que Claude Code contorne o rastreamento de mudanças do Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIRSubstitua o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: marketplaces e o cache de plugin vivem em subdiretórios sob este caminho. Padrão é ~/.claude/plugins
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSTempo limite em milissegundos para operações git ao instalar ou atualizar plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Veja Operações Git expiram
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILUREDefina como 1 para manter o cache de marketplace existente quando um git pull falha em vez de limpar e re-clonar. Útil em ambientes offline ou airgapped onde re-clonar falharia da mesma forma. Veja Atualizações de marketplace falham em ambientes offline
CLAUDE_CODE_PLUGIN_PREFER_HTTPSDefina como 1 para clonar fontes de plugin GitHub owner/repo via HTTPS em vez de SSH. Útil em executores CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para github.com
CLAUDE_CODE_PLUGIN_SEED_DIRCaminho para um ou mais diretórios de seed de plugin somente leitura, separados por : em Unix ou ; no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de contêiner. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja Pré-popular plugins para contêineres
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOSTDefinido por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, seleção de provedor, endpoint e variáveis de autenticação como CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY em arquivos de configuração são ignorados para que configurações de usuário não possam substituir o roteamento do host. O opt-out automático de telemetria para Bedrock, Vertex e Foundry também é ignorado, então a telemetria segue o opt-out padrão DISABLE_TELEMETRY. Veja Comportamentos padrão por provedor de API
CLAUDE_CODE_PROXY_RESOLVES_HOSTSDefina como 1 para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host
CLAUDE_CODE_REMOTEDefinido automaticamente como true quando Claude Code está em execução como uma sessão em nuvem. Leia isso de um hook ou script de configuração para detectar se você está em um ambiente em nuvem
CLAUDE_CODE_REMOTE_SESSION_IDDefinido automaticamente em sessões em nuvem para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja Vincular artefatos de volta à sessão
CLAUDE_CODE_RESUME_INTERRUPTED_TURNDefina como 1 para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt
CLAUDE_CODE_RESUME_PROMPTSubstitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é Continue from where you left off.. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de inicialização mais diretiva. Uma string vazia usa o padrão
CLAUDE_CODE_SCRIPT_CAPSObjeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando CLAUDE_CODE_SUBPROCESS_ENV_SCRUB está definido. As chaves são substrings correspondidas contra o texto do comando; os valores são limites de chamadas inteiras. Por exemplo, {"deploy.sh": 2} permite que deploy.sh seja chamado no máximo duas vezes. A correspondência é baseada em substring, então truques de expansão de shell como ./scripts/deploy.sh $(evil) ainda contam contra o limite. Fan-out em tempo de execução via xargs ou find -exec não é detectado; este é um controle de defesa em profundidade
CLAUDE_CODE_SCROLL_SPEEDDefina o multiplicador de rolagem da roda do mouse em renderização em tela cheia. Aceita valores de 1 a 20. Defina como 3 para corresponder a vim se seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio tratamento de rolagem
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MSSubstitua o orçamento de tempo em milissegundos para hooks SessionEnd. Aplica-se à saída de sessão, /clear e alternância de sessões via /resume interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o timeout por hook mais alto configurado em arquivos de configuração, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento
CLAUDE_CODE_SESSION_IDDefinido automaticamente em subprocessos de ferramenta Bash e PowerShell para o ID da sessão atual. Corresponde ao campo session_id passado para hooks. Atualizado em /clear. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou
CLAUDE_CODE_SHELLSubstitua a detecção automática de shell. Útil quando seu shell de login difere do seu shell de trabalho preferido (por exemplo, bash vs zsh)
CLAUDE_CODE_SHELL_PREFIXPrefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos hook e comandos de inicialização de servidor MCP stdio. Útil para logging ou auditoria. Exemplo: definir /path/to/logger.sh executa cada comando como /path/to/logger.sh <command>
CLAUDE_CODE_SIMPLEDefina como 1 para executar com um prompt do sistema mínimo e apenas as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de --mcp-config ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. A flag CLI --bare define isso
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTDefina como 1 para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como 0, false, no ou off para optar por não participar mesmo em modelos onde o experimento ou configuração do servidor habilitaria de outra forma. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTHPule autenticação do lado do cliente para Claude Platform on AWS, para gateways que assinam solicitações por conta própria
CLAUDE_CODE_SKIP_BEDROCK_AUTHPule autenticação AWS para Bedrock (por exemplo, ao usar um gateway LLM)
CLAUDE_CODE_SKIP_FOUNDRY_AUTHPule autenticação Azure para Microsoft Foundry (por exemplo, ao usar um gateway LLM)
CLAUDE_CODE_SKIP_MANTLE_AUTHPule autenticação AWS para Bedrock Mantle (por exemplo, ao usar um gateway LLM)
CLAUDE_CODE_SKIP_PROMPT_HISTORYDefina como 1 para pular a escrita de histórico de prompt e transcrições de sessão em disco. Sessões iniciadas com essa variável definida não aparecem em --resume, --continue ou histórico de seta para cima. Útil para sessões com script efêmeras
CLAUDE_CODE_SKIP_VERTEX_AUTHPule autenticação Google para Vertex (por exemplo, ao usar um gateway LLM)
CLAUDE_CODE_SUBAGENT_MODELVeja Configuração de modelo
CLAUDE_CODE_SUBPROCESS_ENV_SCRUBDefina como 1 para remover credenciais do Anthropic e do provedor de nuvem de ambientes de subprocesso (ferramenta Bash, hooks, servidores MCP stdio). O processo Claude pai mantém essas credenciais para chamadas de API, mas processos filhos não podem lê-las, reduzindo a exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão de shell. No Linux, isso também executa subprocessos Bash em um namespace PID isolado para que não possam ler ambientes de processo do host via /proc; como efeito colateral, ps, pgrep e kill não podem ver ou sinalizar processos do host. claude-code-action define isso automaticamente quando allowed_non_write_users está configurado
CLAUDE_CODE_SYNC_PLUGIN_INSTALLDefina como 1 em modo não interativo (a flag -p) para aguardar a conclusão da instalação de plugin antes da primeira consulta. Sem isso, plugins instalam em segundo plano e podem não estar disponíveis na primeira volta. Combine com CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS para limitar a espera
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MSTempo limite em milissegundos para instalação síncrona de plugin. Quando excedido, Claude Code prossegue sem plugins e registra um erro. Sem padrão: sem essa variável, instalação síncrona aguarda até a conclusão
CLAUDE_CODE_SYNTAX_HIGHLIGHTDefina como false para desabilitar destaque de sintaxe na saída de diff. Útil quando cores interferem com sua configuração de terminal. Para também desabilitar destaque em blocos de código e visualizações de arquivo, use a configuração syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_IDCompartilhe uma lista de tarefas entre sessões. Defina o mesmo ID em múltiplas instâncias do Claude Code para coordenar em uma lista de tarefas compartilhada. Veja Lista de tarefas
CLAUDE_CODE_TEAM_NAMENome da equipe de agentes à qual este companheiro pertence. Definido automaticamente em membros de equipe de agentes
CLAUDE_CODE_TMPDIRSubstitua o diretório temporário usado para arquivos temporários internos. Claude Code acrescenta /claude-{uid}/ (Unix) ou /claude/ (Windows) a este caminho. Padrão: /tmp em macOS, os.tmpdir() em Linux/Windows
CLAUDE_CODE_TMUX_TRUECOLORDefina como 1 para permitir saída truecolor de 24 bits dentro de tmux. Por padrão, Claude Code limita a 256 cores quando $TMUX está definido porque tmux não passa sequências de escape truecolor a menos que esteja configurado para isso. Defina isso após adicionar set -ga terminal-overrides ',*:Tc' ao seu ~/.tmux.conf. Veja Configuração de terminal para outras configurações 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 o endpoint Mantle do Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCHDefina como 1 para descobrir comandos personalizados, subagentes e estilos de saída usando APIs de arquivo Node.js em vez de ripgrep. Defina isso se o binário ripgrep agrupado estiver indisponível ou bloqueado em seu ambiente. Não afeta as ferramentas Grep ou busca de arquivo
CLAUDE_CODE_USE_POWERSHELL_TOOLControla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é habilitada automaticamente; defina como 0 para desabilitá-la. No Windows com Git Bash instalado, a ferramenta está sendo lançada progressivamente: defina como 1 para optar por participar ou 0 para optar por não participar. No Linux, macOS e WSL, defina como 1 para habilitá-la, o que requer pwsh no seu PATH. Quando habilitada no Windows, Claude pode executar comandos PowerShell nativamente em vez de rotear através do Git Bash. Veja Ferramenta PowerShell
CLAUDE_CODE_USE_VERTEXUse Vertex
CLAUDE_CONFIG_DIRSubstitua o diretório de configuração (padrão: ~/.claude). Todas as configurações, credenciais, histórico de sessão e plugins são armazenados sob este caminho. Útil para executar múltiplas contas lado a lado: por exemplo, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
CLAUDE_EFFORTDefinido automaticamente em subprocessos de ferramenta Bash e comandos hook para o nível de esforço ativo para a volta: low, medium, high, xhigh ou max. Corresponde ao campo effort.level passado para hooks. Apenas definido quando o modelo atual suporta o parâmetro de esforço
CLAUDE_ENABLE_BYTE_WATCHDOGDefina como 1 para forçar a habilitação do watchdog ocioso de nível de byte, ou defina como 0 para forçar a desabilitação. Quando não definido, o watchdog é habilitado por padrão para conexões da API Anthropic. O watchdog de byte aborta uma conexão quando nenhum byte chega no fio pela duração definida por CLAUDE_STREAM_IDLE_TIMEOUT_MS, com um mínimo de 5 minutos, independente do watchdog de nível de evento
CLAUDE_ENABLE_STREAM_WATCHDOGDefina como 1 para habilitar o watchdog ocioso de streaming de nível de evento. Desativado por padrão. Para Bedrock, Vertex e Foundry, este é o único watchdog ocioso disponível. Configure o tempo limite com CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENV_FILECaminho para um script de shell cujo conteúdo Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que as exportações no arquivo sejam visíveis para o comando. Use para persistir ativação de virtualenv ou conda entre comandos. Também preenchido dinamicamente por hooks SessionStart, Setup, CwdChanged e FileChanged
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIXPrefixo para nomes de sessão Remote Control gerados automaticamente quando nenhum nome explícito é fornecido. Padrão é o nome do host da sua máquina, produzindo nomes como myhost-graceful-unicorn. A flag CLI --remote-control-session-name-prefix define o mesmo valor para uma única invocação
CLAUDE_STREAM_IDLE_TIMEOUT_MSTempo limite em milissegundos antes que o watchdog ocioso de streaming feche uma conexão travada. Padrão e mínimo 300000 (5 minutos) para ambos os watchdogs de nível de byte e de nível de evento; valores mais baixos são silenciosamente fixados para absorver pausas de pensamento estendido e buffering de proxy. Para provedores de terceiros, requer CLAUDE_ENABLE_STREAM_WATCHDOG=1
DEBUGDefina como 1 para habilitar modo de depuração, equivalente a iniciar com --debug. Logs de depuração são escritos em ~/.claude/debug/<session-id>.txt, ou no caminho definido por CLAUDE_CODE_DEBUG_LOGS_DIR. Apenas os valores verdadeiros 1, true, yes e on habilitam modo de depuração, então padrões de namespace como DEBUG=express:* definidos para outras ferramentas não o acionam
DISABLE_AUTOUPDATERDefina como 1 para desabilitar atualizações automáticas em segundo plano. Manual claude update ainda funciona. Use DISABLE_UPDATES para bloquear ambos
DISABLE_AUTO_COMPACTDefina como 1 para desabilitar compactação automática ao se aproximar do limite de contexto. O comando manual /compact permanece disponível. Use quando você deseja controle explícito sobre quando a compactação ocorre
DISABLE_COMPACTDefina como 1 para desabilitar toda compactação: tanto compactação automática quanto o comando manual /compact
DISABLE_COST_WARNINGSDefina como 1 para desabilitar mensagens de aviso de custo
DISABLE_DOCTOR_COMMANDDefina como 1 para ocultar o comando /doctor. Útil para implantações gerenciadas onde usuários não devem executar diagnósticos de instalação
DISABLE_ERROR_REPORTINGDefina como 1 para optar por não participar do relatório de erros do Sentry
DISABLE_EXTRA_USAGE_COMMANDDefina como 1 para ocultar o comando /extra-usage que permite aos usuários comprar uso adicional além dos limites de taxa
DISABLE_FEEDBACK_COMMANDDefina como 1 para desabilitar o comando /feedback. O nome mais antigo DISABLE_BUG_COMMAND também é aceito
DISABLE_GROWTHBOOKDefina como 1 para desabilitar busca de flag de recurso GrowthBook e usar padrões de código para cada flag. Logging de eventos de telemetria permanece ativado a menos que DISABLE_TELEMETRY também esteja definido
DISABLE_INSTALLATION_CHECKSDefina como 1 para desabilitar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, pois isso pode mascarar problemas com instalações padrão
DISABLE_INSTALL_GITHUB_APP_COMMANDDefina como 1 para ocultar o comando /install-github-app. Já oculto ao usar provedores de terceiros (Bedrock, Vertex ou Foundry)
DISABLE_INTERLEAVED_THINKINGDefina como 1 para evitar enviar o cabeçalho beta de pensamento intercalado. Útil quando seu gateway LLM ou provedor não suporta pensamento intercalado
DISABLE_LOGIN_COMMANDDefina como 1 para ocultar o comando /login. Útil quando a autenticação é tratada externamente via chaves de API ou apiKeyHelper
DISABLE_LOGOUT_COMMANDDefina como 1 para ocultar o comando /logout
DISABLE_PROMPT_CACHINGDefina como 1 para desabilitar cache de prompt para todos os modelos (tem precedência sobre configurações por modelo)
DISABLE_PROMPT_CACHING_HAIKUDefina como 1 para desabilitar cache de prompt para modelos Haiku
DISABLE_PROMPT_CACHING_OPUSDefina como 1 para desabilitar cache de prompt para modelos Opus
DISABLE_PROMPT_CACHING_SONNETDefina como 1 para desabilitar cache de prompt para modelos Sonnet
DISABLE_TELEMETRYDefina como 1 para optar por não participar da telemetria. Eventos de telemetria não incluem dados do usuário como código, caminhos de arquivo ou comandos bash. Também desabilita flags de recurso, então alguns recursos que ainda estão sendo lançados podem não estar disponíveis
DISABLE_UPDATESDefina como 1 para bloquear todas as atualizações, incluindo manual claude update e claude install. Mais rigoroso que DISABLE_AUTOUPDATER. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar
DISABLE_UPGRADE_COMMANDDefina como 1 para ocultar o comando /upgrade
DO_NOT_TRACKDefina como 1 para optar por não participar da telemetria. Equivalente a definir DISABLE_TELEMETRY. Honrado como a convenção padrão entre ferramentas
ENABLE_CLAUDEAI_MCP_SERVERSDefina como false para desabilitar servidores MCP claude.ai no Claude Code. Habilitado por padrão para usuários conectados
ENABLE_PROMPT_CACHING_1HDefina como 1 para solicitar um TTL de cache de prompt de 1 hora em vez do padrão de 5 minutos. Destinado para usuários de chave de API, Bedrock, Vertex, Foundry e Claude Platform on AWS. Usuários de assinatura recebem TTL de 1 hora automaticamente. Escritas de cache de 1 hora são cobradas a uma taxa mais alta
ENABLE_PROMPT_CACHING_1H_BEDROCKDescontinuado. Use ENABLE_PROMPT_CACHING_1H em vez disso
ENABLE_TOOL_SEARCHControla busca de ferramentas MCP. Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em Vertex AI ou quando ANTHROPIC_BASE_URL aponta para um host que não é de primeira parte. Valores: true (sempre adia e envia o cabeçalho beta; solicitações falham em Vertex AI ou proxies que não suportam tool_reference), auto (modo de limite: carrega antecipadamente se as ferramentas se encaixarem em 10% do contexto), auto:N (limite personalizado, por exemplo, auto:5 para 5%), false (carrega tudo antecipadamente)
FALLBACK_FOR_ALL_PRIMARY_MODELSDefina como qualquer valor não vazio para acionador fallback para --fallback-model após erros de sobrecarga repetidos em qualquer modelo primário. Por padrão, apenas modelos Opus acionam o fallback
FORCE_AUTOUPDATE_PLUGINSDefina como 1 para forçar auto-atualizações de plugins mesmo quando o auto-atualizador principal está desabilitado via DISABLE_AUTOUPDATER
FORCE_PROMPT_CACHING_5MDefina como 1 para forçar o TTL de cache de prompt de 5 minutos mesmo quando o TTL de 1 hora se aplicaria de outra forma. Substitui ENABLE_PROMPT_CACHING_1H
HTTP_PROXYEspecifique servidor proxy HTTP para conexões de rede
HTTPS_PROXYEspecifique servidor proxy HTTPS para conexões de rede
IS_DEMODefina como 1 para habilitar modo demo: oculta seu email e nome da organização do cabeçalho e saída /status, e pula onboarding. Útil ao fazer streaming ou gravar uma sessão
MAX_MCP_OUTPUT_TOKENSNúmero máximo de tokens permitidos em respostas de ferramentas MCP. Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram anthropic/maxResultSizeChars usam esse limite de caracteres para conteúdo de texto em vez disso, mas conteúdo de imagem dessas ferramentas ainda está sujeito a essa variável (padrão: 25000)
MAX_STRUCTURED_OUTPUT_RETRIESNúmero de vezes para tentar novamente quando a resposta do modelo falha na validação contra o --json-schema em modo não interativo (a flag -p). Padrão é 5
MAX_THINKING_TOKENSSubstitua o orçamento de token de pensamento estendido. O teto é o max output tokens do modelo menos um. Defina como 0 para desabilitar pensamento inteiramente. Em modelos com raciocínio adaptativo, o orçamento é ignorado a menos que raciocínio adaptativo seja desabilitado via CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING
MCP_CLIENT_SECRETSegredo do cliente OAuth para servidores MCP que requerem credenciais pré-configuradas. Evita o prompt interativo ao adicionar um servidor com --client-secret
MCP_CONNECTION_NONBLOCKINGDefina como true em modo não interativo (-p) para pular a espera de conexão MCP inteiramente. Útil para pipelines com script onde ferramentas MCP não são necessárias. Sem essa variável, a primeira consulta aguarda até 5 segundos para conexões de servidor --mcp-config. Servidores configurados com alwaysLoad: true sempre bloqueiam a inicialização independentemente dessa variável, já que suas ferramentas devem estar presentes quando o primeiro prompt é construído
MCP_CONNECT_TIMEOUT_MSQuanto tempo a primeira consulta aguarda, em milissegundos, para o lote de conexão MCP antes de tirar um snapshot da lista de ferramentas (padrão: 5000). Servidores ainda pendentes no prazo continuam se conectando em segundo plano mas não aparecerão até a próxima consulta. Distinto de MCP_TIMEOUT, que limita a tentativa de conexão de um servidor individual. Mais relevante para sessões não interativas que emitem uma única consulta e precisam que servidores de conexão lenta sejam visíveis
MCP_OAUTH_CALLBACK_PORTPorta fixa para o callback de redirecionamento OAuth, como alternativa a --callback-port ao adicionar um servidor MCP com credenciais pré-configuradas
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZENúmero máximo de servidores MCP remotos (HTTP/SSE) para conectar em paralelo durante a inicialização (padrão: 20)
MCP_SERVER_CONNECTION_BATCH_SIZENúmero máximo de servidores MCP locais (stdio) para conectar em paralelo durante a inicialização (padrão: 3)
MCP_TIMEOUTTempo limite em milissegundos para inicialização do servidor MCP (padrão: 30000, ou 30 segundos)
MCP_TOOL_TIMEOUTTempo limite em milissegundos para execução de ferramentas MCP (padrão: 100000000, aproximadamente 28 horas)
NO_PROXYLista de domínios e IPs para os quais as solicitações serão emitidas diretamente, contornando proxy
OTEL_LOG_RAW_API_BODIESEmita solicitação e resposta JSON da API Anthropic Messages como eventos de log api_request_body / api_response_body. Defina como 1 para corpos inline truncados em 60 KB, ou file:<dir> para escrever corpos não truncados em disco e emitir um caminho body_ref em vez disso. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Veja Monitoramento
OTEL_LOG_TOOL_CONTENTDefina como 1 para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja Monitoramento
OTEL_LOG_TOOL_DETAILSDefina como 1 para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, strings de erro bruto em falhas de ferramenta e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja Monitoramento
OTEL_LOG_USER_PROMPTSDefina como 1 para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Veja Monitoramento
OTEL_METRICS_INCLUDE_ACCOUNT_UUIDDefina como false para excluir UUID da conta dos atributos de métricas (padrão: incluído). Veja Monitoramento
OTEL_METRICS_INCLUDE_SESSION_IDDefina como false para excluir ID de sessão dos atributos de métricas (padrão: incluído). Veja Monitoramento
OTEL_METRICS_INCLUDE_VERSIONDefina como true para incluir versão do Claude Code em atributos de métricas (padrão: excluído). Veja Monitoramento
SLASH_COMMAND_TOOL_CHAR_BUDGETSubstitua o orçamento de caracteres para metadados de skill mostrados à ferramenta Skill. O orçamento escala dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores
TASK_MAX_OUTPUT_LENGTHNúmero máximo de caracteres na saída de subagente antes de truncamento (padrão: 32000, máximo: 160000). Quando truncado, a saída completa é salva em disco e o caminho é incluído na resposta truncada
USE_BUILTIN_RIPGREPDefina como 0 para usar rg instalado no sistema em vez de rg incluído com Claude Code
VERTEX_REGION_CLAUDE_3_5_HAIKUSubstitua região para Claude 3.5 Haiku ao usar Vertex AI
VERTEX_REGION_CLAUDE_3_5_SONNETSubstitua região para Claude 3.5 Sonnet ao usar Vertex AI
VERTEX_REGION_CLAUDE_3_7_SONNETSubstitua região para Claude 3.7 Sonnet ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_0_OPUSSubstitua região para Claude 4.0 Opus ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_0_SONNETSubstitua região para Claude 4.0 Sonnet ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_1_OPUSSubstitua região para Claude 4.1 Opus ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_5_OPUSSubstitua região para Claude Opus 4.5 ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_5_SONNETSubstitua região para Claude Sonnet 4.5 ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_6_OPUSSubstitua região para Claude Opus 4.6 ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_6_SONNETSubstitua região para Claude Sonnet 4.6 ao usar Vertex AI
VERTEX_REGION_CLAUDE_4_7_OPUSSubstitua região para Claude Opus 4.7 ao usar Vertex AI
VERTEX_REGION_CLAUDE_HAIKU_4_5Substitua região para Claude Haiku 4.5 ao usar Vertex AI
Variáveis padrão do exportador 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 e variantes específicas de sinal) também são suportadas. Veja Monitoramento para detalhes de configuração.

​
Veja também