SpyBara
Go Premium

env-vars.md 2026-10-01 23:59 UTC to 2026-10-02 07:00 UTC

This page contains 381 additions and 378 deletions.

2026
Thu 1 23:59 Fri 2 08:03

Variáveis de ambiente

Referência para variáveis de ambiente que controlam o comportamento do Claude Code.

Variáveis de ambiente podem controlar o comportamento do Claude Code, como seleção de modelo, autenticação, roteamento de requisições e alternâncias de recursos. Muitos dos mesmos comportamentos também podem ser configurados através de um campo de arquivo de configurações, um sinalizador CLI ou um comando em sessão como /model.

Esta página aborda como:

Definir variáveis de ambiente

Uma variável que você define no seu shell dura para essa sessão de terminal, enquanto uma variável em um arquivo de configurações se aplica toda vez que claude é executado.

No seu shell

Defina a variável antes de iniciar claude:

export API_TIMEOUT_MS="1200000"
claude

Para defini-la para cada sessão, adicione a linha export a ~/.bashrc, ~/.zshrc, ou ao arquivo de perfil do seu shell.

A linha de atribuição não imprime nada em caso de sucesso. Para confirmar que a variável está definida, imprima-a no mesmo shell:

echo $API_TIMEOUT_MS

Em arquivos de configurações

Adicione variáveis sob a chave env em um arquivo settings.json, criando o arquivo se ele não existir. Claude Code as lê diretamente do arquivo, então elas entram em vigor independentemente de como claude foi iniciado. Uma sessão em execução aplica valores novos e alterados ao seu ambiente quando você salva o arquivo, mas um recurso que lê suas variáveis uma vez na inicialização, como monitoramento OpenTelemetry, mantém seus valores de inicialização até que você reinicie. Remover uma variável do arquivo não a desativa em uma sessão em execução; a remoção entra em vigor na próxima vez que você iniciar claude.

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

O arquivo que você escolhe controla a quem as variáveis se aplicam:

Arquivo Aplica-se a
~/.claude/settings.json Você, em cada projeto
.claude/settings.json Todos que trabalham no projeto, verificado no controle de origem
.claude/settings.local.json Você, apenas neste projeto, ignorado pelo git quando Claude Code salva uma configuração nele; adicione-o ao seu gitignore se você o criar manualmente
Configurações gerenciadas Todos na sua organização, implantados por um administrador

Veja Arquivos de configurações para saber onde cada arquivo fica e Precedência de configurações para saber como eles se combinam quando mais de um define a mesma variável.

Precedência

Alguns comportamentos têm tanto uma variável de ambiente quanto uma chave de configurações dedicada, e qual delas Claude Code lê primeiro difere por chave. Para ANTHROPIC_MODEL e CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code lê a variável primeiro e usa a configuração model ou autoConnectIde apenas quando a variável não está definida. Para o par que você está configurando, verifique a linha da variável abaixo e a entrada da chave na referência de configurações.

Quando a mesma variável está definida tanto no seu shell quanto em um bloco env do arquivo de configurações, o valor do arquivo de configurações se aplica na maioria das sessões. Claude Code escreve cada entrada env no ambiente do processo, substituindo o valor herdado do shell. Como os valores env interagem com seu shell cobre as sessões que mantêm o valor herdado em vez disso, e a configuração env diz quando ela se aplica. Algumas variáveis são casos especiais; a configuração env lista as exceções.

Em um arquivo de configurações você pode definir uma variável, mas não pode remover uma. Para substituir uma variável que você não pode desativar, como uma CLAUDE_CODE_USE_VERTEX obsoleta exportada por um perfil de shell que você não controla, defina-a como uma string vazia no bloco env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code trata o valor vazio como não definido para seleção de provedor. Subprocessos ainda herdam o valor vazio.

Entre arquivos de configurações, os valores env seguem a precedência de configurações, então uma entrada de configurações gerenciada substitui a mesma variável nas configurações de usuário ou projeto. Configurações de projeto e locais não podem definir algumas variáveis, como CLAUDE_CONFIG_DIR e as variáveis do exportador OpenTelemetry. Variáveis que Claude Code ignora em env lista-as, junto com os valores desativados do OpenTelemetry que ainda se aplicam.

Como uma variável de ambiente interage com sinalizadores CLI e comandos em sessão varia por recurso: --model e /model substituem ANTHROPIC_MODEL, enquanto CLAUDE_CODE_EFFORT_LEVEL substitui --effort e /effort. Quando uma variável interage com outra fonte de configuração, sua linha na lista Variáveis declara a precedência ou vincula à página que a documenta.

Claude Code lê variáveis de ambiente do shell na inicialização, então as alterações nelas entram em vigor na próxima vez que você inicia claude. As variáveis definidas sob a chave env em arquivos de configurações são reaplicadas a uma sessão em execução quando o arquivo muda, com a exceção somente na inicialização descrita em Em arquivos de configurações.

Variáveis

Variáveis numéricas, como timeouts, orçamentos de tokens e contagens de novas tentativas, aceitam notação científica e grafias com separador de dígitos, além de dígitos simples, exceto quando a linha de uma variável indica que ela aceita apenas dígitos simples. Por exemplo, o Claude Code lê 2e3 como 2000 e 64_000 como 64000. Antes da v2.1.211, essas grafias podiam definir silenciosamente um valor muito menor, como 1e6 definindo um timeout de 1.

Variável Finalidade
ANTHROPIC_API_KEY Chave de API enviada como cabeçalho X-Api-Key. Quando definida, essa chave é usada em vez da sua assinatura Claude Pro, Max, Team ou Enterprise, mesmo que você tenha feito login. No modo não interativo (-p), a chave é sempre usada quando presente. No modo interativo, você é solicitado a aprovar a chave uma vez antes que ela sobrescreva sua assinatura. Para usar sua assinatura em vez disso, execute unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN Valor personalizado para o cabeçalho Authorization (o valor que você definir aqui será prefixado com Bearer )
ANTHROPIC_AWS_API_KEY Chave de API do workspace para o Claude Platform on AWS, gerada no AWS Console. Enviada como x-api-key e tem precedência sobre o AWS SigV4
ANTHROPIC_AWS_BASE_URL Sobrescreve a URL do endpoint do Claude Platform on AWS. Use para regiões personalizadas ou ao rotear por um gateway de LLM. O padrão é https://aws-external-anthropic.{region}.api.aws. O Claude Code resolve a região com a mesma precedência que no Amazon Bedrock
ANTHROPIC_AWS_WORKSPACE_ID Obrigatória para o Claude Platform on AWS. Enviada em toda requisição como o cabeçalho anthropic-workspace-id
ANTHROPIC_BASE_URL Sobrescreve o endpoint da API para rotear requisições por um proxy ou gateway. Quando definida para um host que não é first-party, o MCP Tool Search fica desativado por padrão. Defina ENABLE_TOOL_SEARCH=true se o seu proxy encaminhar blocos tool_reference. A partir da v2.1.196, o Remote Control fica desativado quando esta variável aponta para um host diferente de api.anthropic.com, correspondendo ao seu comportamento no Amazon Bedrock, no Google Cloud's Agent Platform e no Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL Sobrescreve a URL do endpoint do Amazon Bedrock. Use para endpoints personalizados do Amazon Bedrock ou ao rotear por um gateway de LLM. Consulte Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Sobrescreve a URL do endpoint do Amazon Bedrock Mantle. Consulte Endpoint Mantle
ANTHROPIC_BEDROCK_REGION_PREFIX Prefixo do perfil de inferência entre regiões (us, eu, apac, jp, au ou global) que o Claude Code tenta primeiro em vez daquele derivado da região da AWS. Ignorada nas regiões AWS GovCloud. Requer Claude Code v2.1.224 ou posterior. Consulte Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Nível de serviço do Amazon Bedrock (default, flex ou priority). Enviado como o cabeçalho X-Amzn-Bedrock-Service-Tier. Consulte Amazon Bedrock
ANTHROPIC_BETAS Lista separada por vírgulas de valores adicionais do cabeçalho anthropic-beta a incluir nas requisições de API. O Claude Code já envia os cabeçalhos beta de que precisa; use isto para aderir a um beta da API da Anthropic antes que o Claude Code adicione suporte nativo. Diferentemente da flag --betas, que requer autenticação por chave de API, esta variável funciona com todos os métodos de autenticação, incluindo a assinatura do Claude.ai
ANTHROPIC_CUSTOM_HEADERS Cabeçalhos personalizados a adicionar às requisições (formato Name: Value, separados por quebra de linha para vários cabeçalhos). Se um nome ou valor contiver um caractere que um cabeçalho HTTP não pode transportar, como uma aspa curva ou um espaço de largura zero, a requisição falha com um erro que identifica o par pela posição. Requer Claude Code v2.1.227 ou posterior. Valor de cabeçalho de requisição inválido lista o conjunto exato de caracteres e onde a verificação é executada. Um valor que define um cabeçalho de credencial, organização ou tenant, roteamento ou comportamento da API, como Authorization ou Host, conta como uma configuração que precisa de aprovação quando configurações gerenciadas pelo servidor o entregam. A partir de configurações de projeto ou locais, esse valor segue as regras de quando os valores env se aplicam
ANTHROPIC_CUSTOM_MODEL_OPTION ID do modelo a adicionar como uma entrada personalizada no seletor /model. Use isto para tornar selecionável um modelo não padrão ou específico de gateway sem substituir os aliases integrados. Consulte Configuração de modelo
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION Descrição exibida para a entrada de modelo personalizado no seletor /model. O padrão é Custom model (<model-id>) quando não definida
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Nome exibido para a entrada de modelo personalizado no seletor /model. Quando não definida, a entrada mostra o nome do modelo se o Claude Code reconhecer o ID, e o ID do modelo caso contrário
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES Lista separada por vírgulas de capacidades que o modelo personalizado suporta, por exemplo effort,thinking. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_FABLE_MODEL ID do modelo para o qual o alias fable é resolvido, e o ID que o Claude Code reconhece como um modelo Fable para o fallback automático de modelo em provedores terceiros. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Descrição exibida para o modelo Fable fixado no seletor /model. Quando não definida, a linha mostra uma descrição padrão que começa com Custom Fable model. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Nome exibido para o modelo Fable fixado no seletor /model. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES Lista separada por vírgulas de capacidades que o modelo Fable fixado suporta, por exemplo effort,thinking. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL ID do modelo para o qual o alias haiku é resolvido, também usado para funcionalidades em segundo plano. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION Descrição exibida para o modelo Haiku fixado no seletor /model. Quando não definida, a linha mostra uma descrição padrão que começa com Custom Haiku model. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Nome exibido para o modelo Haiku fixado no seletor /model. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES Lista separada por vírgulas de capacidades que o modelo Haiku fixado suporta, por exemplo effort,thinking. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_MODEL Modelo com o qual novas sessões começam por padrão. Requer Claude Code v2.1.236 ou posterior. Consulte Definir um modelo padrão para novas sessões
ANTHROPIC_DEFAULT_OPUS_MODEL ID do modelo para o qual o alias opus é resolvido, e que o opusplan usa enquanto o modo de planejamento está ativo. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION Descrição exibida para o modelo Opus fixado no seletor /model. Quando não definida, a linha mostra uma descrição padrão que começa com Custom Opus model. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Nome exibido para o modelo Opus fixado no seletor /model. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES Lista separada por vírgulas de capacidades que o modelo Opus fixado suporta, por exemplo effort,thinking. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL ID do modelo para o qual o alias sonnet é resolvido, e que o opusplan usa quando o modo de planejamento não está ativo. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION Descrição exibida para o modelo Sonnet fixado no seletor /model. Quando não definida, a linha mostra uma descrição padrão que começa com Custom Sonnet model. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Nome exibido para o modelo Sonnet fixado no seletor /model. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Consulte Configuração de modelo
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES Lista separada por vírgulas de capacidades que o modelo Sonnet fixado suporta, por exemplo effort,thinking. Consulte Configuração de modelo
ANTHROPIC_FEDERATION_RULE_ID ID da regra de federação para Workload Identity Federation. Quando você a define junto com ANTHROPIC_ORGANIZATION_ID, o Claude Code seleciona credenciais de federação, que têm prioridade sobre sua credencial do /login. Consulte precedência de autenticação
ANTHROPIC_FOUNDRY_API_KEY Chave de API para autenticação no Microsoft Foundry (consulte Microsoft Foundry)
ANTHROPIC_FOUNDRY_AUTH_TOKEN Token Bearer para autenticação no Microsoft Foundry, como um token de acesso do Microsoft Entra. O Claude Code o envia como o cabeçalho Authorization: Bearer. Tem precedência sobre ANTHROPIC_FOUNDRY_API_KEY e sobre a cadeia de credenciais padrão do Azure. Consulte Microsoft Foundry. Requer Claude Code v2.1.203 ou posterior
ANTHROPIC_FOUNDRY_BASE_URL URL base completa para o recurso do Microsoft Foundry (por exemplo, https://my-resource.services.ai.azure.com/anthropic). Alternativa a ANTHROPIC_FOUNDRY_RESOURCE (consulte Microsoft Foundry)
ANTHROPIC_FOUNDRY_RESOURCE Nome do recurso do Microsoft Foundry (por exemplo, my-resource). Obrigatória se ANTHROPIC_FOUNDRY_BASE_URL não estiver definida (consulte Microsoft Foundry)
ANTHROPIC_MODEL Nome da configuração de modelo a usar (consulte Configuração de modelo)
ANTHROPIC_ORGANIZATION_ID ID da organização para Workload Identity Federation. Defina-a junto com ANTHROPIC_FEDERATION_RULE_ID. Consulte precedência de autenticação
ANTHROPIC_PROFILE Nome do perfil da Anthropic com o qual autenticar, como um criado por ant auth login ou ao entrar em uma conta do Console sem uma chave de API. Consulte precedência de autenticação
ANTHROPIC_SMALL_FAST_MODEL [DESCONTINUADA] Nome do modelo da classe Haiku para tarefas em segundo plano
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Sobrescreve a região da AWS para o modelo da classe Haiku ao usar o Amazon Bedrock ou o Amazon Bedrock Mantle. No Amazon Bedrock, isso só tem efeito quando ANTHROPIC_DEFAULT_HAIKU_MODEL ou a descontinuada ANTHROPIC_SMALL_FAST_MODEL também está definida, pois, caso contrário, o Amazon Bedrock executa tarefas em segundo plano no modelo Sonnet padrão ou no modelo principal na região da sessão
ANTHROPIC_VERTEX_BASE_URL Sobrescreve a URL do endpoint do Google Cloud's Agent Platform. Use para endpoints personalizados do Google Cloud's Agent Platform ou ao rotear por um gateway de LLM. Consulte Google Cloud's Agent Platform
ANTHROPIC_VERTEX_PROJECT_ID ID do projeto GCP ao qual as requisições do Google Cloud's Agent Platform são endereçadas. Consulte Configurar credenciais do GCP
ANTHROPIC_WORKSPACE_ID ID do workspace para workload identity federation. Defina isto quando sua regra de federação tiver escopo em mais de um workspace, para que a troca de tokens saiba qual workspace usar como destino
API_FORCE_IDLE_TIMEOUT Sobrescreve o timeout de inatividade do corpo de 5 minutos que interrompe uma resposta de modelo em streaming quando nenhum byte chega. Defina como 0 para desativar o timeout, por exemplo quando um gateway lento ou um modelo local pausa por mais de 5 minutos entre chunks, ou 1 para mantê-lo ativo para todos os provedores. Quando não definida, o timeout fica ativo em provedores diferentes da API direta da Anthropic, do Claude Platform on AWS e do Amazon Bedrock com CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 definida. Os watchdogs de stream funcionam independentemente dele e interrompem uma pausa silenciosa longa mesmo quando você define 0 aqui
API_TIMEOUT_MS Timeout para requisições de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente-o quando as requisições atingirem o timeout em redes lentas ou ao rotear por um proxy. Valores acima do máximo estouram o timer subjacente e fazem as requisições falharem imediatamente
AWS_BEARER_TOKEN_BEDROCK Chave de API do Amazon Bedrock para autenticação (consulte Chaves de API do Amazon Bedrock)
BASH_DEFAULT_TIMEOUT_MS Timeout padrão para um comando em primeiro plano da ferramenta Bash ou PowerShell, em milissegundos (padrão: 120000, ou 2 minutos). Um padrão maior que 30 minutos também se torna o limite de tempo padrão para comandos em segundo plano. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior
BASH_MAX_OUTPUT_LENGTH Número máximo de caracteres da saída do bash que o Claude Code lê de volta no resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração bashOutputMaxChars, o Claude Code ignora esta variável. Consulte Limites de saída
BASH_MAX_TIMEOUT_MS Timeout máximo que o modelo pode definir para um comando em primeiro plano da ferramenta Bash ou PowerShell, em milissegundos (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre este valor e BASH_DEFAULT_TIMEOUT_MS. Um teto efetivo maior que 2 horas também se torna o limite de tempo máximo para comandos em segundo plano. O limite de tempo em segundo plano requer Claude Code v2.1.285 ou posterior
BETA_TRACING_ENDPOINT Endpoint OTLP para tracing beta detalhado: com ENABLE_BETA_TRACING_DETAILED=1, logs e traces vão para lá em vez de para os exportadores configurados. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada em configurações de projeto e locais
CCR_FORCE_BUNDLE Defina como 1 para forçar o claude --cloud a empacotar e enviar seu repositório local em vez de cloná-lo a partir do seu remoto
CLAUDECODE Definida como 1 em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões tmux, comandos de hook, comandos da linha de status, subprocessos de servidor MCP stdio). Extensões de IDE também a definem em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso iniciado pelo Claude Code. Para verificar se o processo atual foi iniciado diretamente por uma chamada de ferramenta ou hook, e não dentro de um servidor MCP stdio que o Claude Code iniciou, use CLAUDE_CODE_CHILD_SESSION em vez disso
CLAUDE_AFK_COUNTDOWN_MS Quantos milissegundos antes da continuação automática a contagem regressiva na tela aparece em uma caixa de diálogo AskUserQuestion não respondida. Padrão 20000 (20 segundos), limitado ao timeout de continuação automática. Não tem efeito a menos que a continuação automática esteja ativada; consulte a configuração askUserQuestionTimeout e CLAUDE_AFK_TIMEOUT_MS. Requer Claude Code v2.1.198 ou posterior
CLAUDE_AFK_TIMEOUT_MS Quantos milissegundos de inatividade antes que uma caixa de diálogo AskUserQuestion não respondida continue automaticamente sem você. A continuação automática fica desativada por padrão; ative-a com a configuração askUserQuestionTimeout. Esta variável é uma substituição para demonstrações e testes automatizados: quando definida, tem precedência sobre essa configuração e ativa a continuação automática mesmo quando a configuração não está definida ou é never. Definir 0 não desativa o timeout; fecha a caixa de diálogo imediatamente. Nas v2.1.198 e v2.1.199, a continuação automática ficava ativada por padrão com um timeout de 60000 (60 segundos). Requer Claude Code v2.1.198 ou posterior
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS Defina como 1 para desativar todos os tipos de subagente integrados, como Explore e Plan. Aplica-se apenas no modo não interativo (a flag -p). Útil para usuários do SDK que querem começar do zero. Isso também remove general-purpose, o subagente que o Claude Code executa quando uma chamada da ferramenta Agent omite subagent_type. Essa chamada então falha com subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIX Defina como 1 para omitir o prefixo mcp__<server>__ nos nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas para uso com o SDK
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS Timeout de travamento em milissegundos para subagentes. Padrão 600000 (10 minutos); se você aumentar CLAUDE_STREAM_IDLE_TIMEOUT_MS enquanto o watchdog de stream estiver ativo, o padrão aumenta junto, como descrito em Lidar com respostas de API lentas ou travadas. O timer é reiniciado a cada evento de progresso do streaming; se nenhum progresso chegar dentro da janela, o Claude Code interrompe o subagente e relata o travamento ao pai
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE Define a porcentagem (1-100) da janela de compactação automática na qual a compactação automática é acionada. Use valores mais baixos, como 50, para compactar mais cedo; a variável não pode aumentar o limite, então valores acima da porcentagem padrão são ignorados. Aplica-se apenas em sessões que compactam antes do limite de contexto do modelo. Aplica-se tanto às conversas principais quanto aos subagentes
CLAUDE_AUTO_BACKGROUND_TASKS Defina como 1 para forçar a ativação do envio automático para segundo plano de tarefas de agente de longa duração. Quando ativado, os subagentes são movidos para segundo plano após executarem por aproximadamente dois minutos. Também ativa o envio automático para segundo plano de chamadas longas de ferramentas MCP no modo não interativo no Claude Code v2.1.212 ou posterior
CLAUDE_AX_PREPARK_MS No modo de leitor de tela, quantos milissegundos o Claude Code espera antes de escrever uma linha nova ou alterada. Padrão 0, então o Claude Code não espera. Antes da v2.1.287, o padrão era 50. O Claude Code limita a espera a 5000. Requer Claude Code v2.1.233 ou posterior
CLAUDE_AX_SCREEN_READER Defina como 1 para renderizar uma saída compatível com leitores de tela: texto simples sem bordas decorativas ou animações. Defina como 0 para forçar a desativação do modo de leitor de tela mesmo quando axScreenReader é true. A flag --ax-screen-reader tem precedência. Requer Claude Code v2.1.181 ou posterior
CLAUDE_AX_STARTUP_QUIET_MS No modo de leitor de tela, quantos milissegundos o Claude Code retém a primeira renderização da interface após a linha de confirmação de inicialização, para que seu leitor de tela possa falar a linha por completo antes que uma nova saída a interrompa. Padrão 3000. Defina 0 para renderizar imediatamente. O Claude Code limita a retenção a 600000 (10 minutos). Sua primeira tecla pressionada encerra a retenção antecipadamente. Requer Claude Code v2.1.217 ou posterior
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR Retorna ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS Timeout em milissegundos para o watchdog de inatividade de streaming no nível de bytes; quando definida, tem precedência sobre CLAUDE_STREAM_IDLE_TIMEOUT_MS para esse watchdog e deixa o watchdog no nível de eventos inalterado. O Claude Code limita esta variável a um valor entre 10 segundos e 30 minutos. Requer Claude Code v2.1.210 ou posterior
CLAUDE_CLIENT_PRESENCE_FILE Caminho para um arquivo que uma ferramenta externa, como um listener de bloqueio de tela, cria quando você desbloqueia a tela e exclui quando você a bloqueia. Enquanto o arquivo existir, o Claude Code omite as notificações push móveis do Remote Control, para que você pare de receber pushes enquanto estiver usando ativamente o computador. Quando o arquivo estiver ausente ou ilegível, as notificações são enviadas normalmente. O Claude Code verifica o arquivo uma vez por evento que dispara push, em vez de consultá-lo periodicamente. Requer Claude Code v2.1.181 ou posterior
CLAUDE_CODE_ACCESSIBILITY Defina como 1 para manter o cursor nativo do terminal visível e desativar o indicador de cursor com texto invertido. Permite que ampliadores de tela, como o Zoom do macOS, acompanhem a posição do cursor
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD Defina 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_ALT_SCREEN_FULL_REPAINT Defina como 1 para redesenhar a tela inteira a cada quadro na renderização em tela cheia em vez de enviar atualizações incrementais. Use isto se o modo de tela cheia mostrar fragmentos de texto desatualizados ou fora do lugar. O Claude Code ativa isto automaticamente para sessões em segundo plano e para a visualização de agentes no Windows
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT Defina como 1 para enviar o parâmetro de esforço em toda requisição, mesmo quando o Claude Code não reconhece o ID do modelo como compatível com esforço. Use isto ao rotear por um gateway de LLM ou provedor terceiro que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo os modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, continuam excluídos para que as requisições não falhem
CLAUDE_CODE_API_KEY_HELPER_TTL_MS Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar apiKeyHelper)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN Defina como 0 para impedir que o Claude Code abra o navegador automaticamente quando um novo artefato for publicado
CLAUDE_CODE_ARTIFACT_COMMENTS Defina como 0 para impedir que o Claude leia e responda a comentários em um artefato. Não tem efeito quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC desativou os artefatos. Requer Claude Code v2.1.221 ou posterior
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT Defina como 0 para impedir que o Claude responda por conta própria a comentários enviados a ele. Requer Claude Code v2.1.228 ou posterior
CLAUDE_CODE_ATTRIBUTION_HEADER Defina como 0 para omitir o bloco de atribuição, que contém a versão do cliente e uma impressão digital do prompt, do início do system prompt. O cache em uma conexão direta com a API da Anthropic não é afetado em nenhum dos casos. Em algumas configurações de conexão direta, o Claude Code mantém o bloco nas requisições do classificador do modo auto mesmo quando você define 0. Em Bloco de atribuição do system prompt, verifique quais conexões e credenciais isso abrange. Antes da v2.1.181, o bloco incluía um token por requisição em URLs base personalizadas e conexões com o Microsoft Foundry, então, nessas versões, defina-a como 0 quando seu gateway de LLM fizer cache com base no corpo da requisição ou encaminhar requisições a um provedor terceiro, ou quando você se conectar diretamente ao Microsoft Foundry
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS Quando CLAUDE_AUTO_BACKGROUND_TASKS está ativada, segundos entre lembretes para o Claude verificar subagentes em segundo plano que ainda estão em execução. Aceita apenas um inteiro simples de 1 a 86400; qualquer outro valor ou grafia é lido como não definido. Quando não definida, não há lembretes de verificação. Requer Claude Code v2.1.248 ou posterior
CLAUDE_CODE_AUTO_COMPACT_WINDOW Define a janela de compactação automática em tokens, de 100000 a 1000000. Aceita apenas um inteiro simples, como 500000: um valor como 500k é lido como 500 e ajustado ao mínimo de 100K. A janela efetiva também é limitada à janela de contexto do modelo. Tem precedência sobre o comando /autocompact, a flag --autocompact e a configuração autoCompactWindow. O used_percentage da linha de status sempre mede em relação à janela de contexto completa do modelo, então, uma vez definida esta variável, essa porcentagem não indica mais quando a compactação será executada
CLAUDE_CODE_AUTO_CONNECT_IDE Sobrescreve a conexão automática com a IDE. Por padrão, o Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE compatível. Defina como false para impedir isso. Defina como true para forçar uma tentativa de conexão quando a detecção automática falhar, como quando o tmux oculta o terminal pai. Tem precedência sobre a configuração global autoConnectIde
CLAUDE_CODE_AUTO_MODE_SERVER Controla se o Claude Code pede ao servidor para revisar as ações do modo auto. Defina como 0 para usar as próprias requisições de classificador do Claude Code em vez disso. Em uma conexão direta com a API da Anthropic, requer v2.1.281 ou posterior. A seção vinculada lista quais sessões consultam o servidor quando a variável não está definida, e a partir de qual versão. Requer Claude Code v2.1.271 ou posterior
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS Tempo em milissegundos que o Claude Code espera até que a cadeia padrão de provedores de credenciais da AWS produza credenciais antes que a requisição falhe com AWS default-chain credential resolve timed out (padrão: 60000). Aumente-o quando uma etapa da sua cadeia legitimamente precisar de mais tempo, como um login SSO baseado em navegador com MFA por meio de um wrapper como o aws-vault. Aplica-se sempre que o Claude Code assina com a cadeia padrão: Amazon Bedrock, Claude Platform on AWS e o endpoint Mantle. Requer Claude Code v2.1.207 ou posterior
CLAUDE_CODE_BASH_EDIT_DIFF Defina como 0 para desativar o diff dos arquivos que mudaram enquanto um comando Bash era executado, ou 1 para registrá-lo em todos os modos de permissão. Tem precedência sobre a configuração bashEditDiffEnabled. Requer Claude Code v2.1.269 ou posterior
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING Defina como 0 para fazer uma sessão não interativa relatar um status ocioso ao seu host ao final de cada turno, mesmo enquanto trabalho em segundo plano ainda estiver em execução. Por padrão, a sessão continua relatando um status de execução após o fim do turno enquanto um trabalho em segundo plano, como um agente em segundo plano ou uma execução de workflow, ainda estiver ativo. Isso evita que um host que observa o status, como uma lista de sessões remotas, anuncie que o Claude está aguardando sua entrada no meio do trabalho. Comandos de shell em segundo plano, como um servidor de desenvolvimento, não mantêm o status de execução. O padrão de status de execução e a desativação com 0 requerem Claude Code v2.1.269 ou posterior; em versões anteriores, defina 1 para manter o status de execução
CLAUDE_CODE_BRIDGE_SESSION_ID Definida automaticamente nos subprocessos da ferramenta Bash e de comandos de hook enquanto a sessão tem uma conexão ativa do Remote Control, e removida quando a conexão termina. O valor é o ID da sessão no formato session_, o mesmo identificador que aparece na URL claude.ai/code da sessão, para que um script possa apontar de volta para a sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em sessões na nuvem, leia CLAUDE_CODE_REMOTE_SESSION_ID em vez disso
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE Defina como 0 para fazer o Claude Code ler o byte 0x08, também escrito ^H, como Backspace simples, ou 1 para lê-lo como Ctrl+Backspace. Qualquer um dos valores substitui o padrão da plataforma. Por padrão, o Claude Code o lê como Ctrl+Backspace no Windows, exceto quando TERM_PROGRAM é mintty ou TERM é cygwin, e como Backspace simples no macOS e no Linux. Defina 0 em um terminal do Windows em que o Backspace exclui uma palavra inteira
CLAUDE_CODE_CERT_STORE Lista separada por vírgulas de fontes de certificados de CA para conexões TLS. bundled é o conjunto de CAs da Mozilla distribuído com o Claude Code. system é o repositório de confiança do sistema operacional, lido apenas em runtimes com tls.getCACertificates: o binário nativo, ou Node 22.15 ou posterior para instalações via npm. Consulte Repositório de certificados de CA. O padrão é bundled,system
CLAUDE_CODE_CHILD_SESSION Definida como 1 em subprocessos que o Claude Code inicia por meio das ferramentas Bash, PowerShell e Monitor, comandos de hook e comandos da linha de status. Não é definida para subprocessos de servidor MCP stdio, que são de longa duração e sobrevivem à sessão que os iniciou. Diferentemente de CLAUDECODE, esta só é definida pelo próprio Claude Code quando ele inicia um subprocesso, e não por extensões de IDE, então distingue de forma confiável uma sessão aninhada de um claude de nível superior iniciado em um terminal integrado à IDE. Uma TUI claude interativa aninhada iniciada dessa forma é automaticamente excluída de --resume, --continue, do histórico da seta para cima e da lista claude agents. Sessões não interativas claude -p continuam sendo persistidas. Defina CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 para sobrescrever essa exclusão. Requer Claude Code v2.1.172 ou posterior
CLAUDE_CODE_CLIENT_CERT Caminho para o arquivo de certificado do cliente para autenticação mTLS
CLAUDE_CODE_CLIENT_KEY Caminho para o arquivo de chave privada do cliente para autenticação mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE Senha para a CLAUDE_CODE_CLIENT_KEY criptografada (opcional)
CLAUDE_CODE_CONNECT_TIMEOUT_MS Removida na v2.1.186 e agora não tem efeito. Anteriormente definia um timeout separado para a fase de conexão, TLS e cabeçalhos de resposta de uma requisição de API em streaming. Use API_TIMEOUT_MS para o timeout por requisição. Para a fase de cabeçalhos de resposta de uma requisição em streaming, consulte CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
CLAUDE_CODE_DEBUG_LOGS_DIR Sobrescreve 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 ativado separadamente via --debug, /debug ou a variável de ambiente DEBUG: definir apenas esta variável não ativa o logging. A flag --debug-file faz as duas coisas de uma vez. O padrão é ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL Nível mínimo de log gravado 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 a saída completa do comando da linha de status, ou aumente para error para reduzir o ruído
CLAUDE_CODE_DISABLE_1M_CONTEXT Defina como 1 para desativar o suporte à janela de contexto de 1M. Quando definida, as variantes de modelo de 1M ficam indisponíveis no seletor de modelo, e o Claude Code restringe as sessões em modelos com uma janela nativa de 1M, como o Sonnet 5.5 e os modelos Fable, a uma janela de 200K; consulte Contexto estendido para saber como a restrição é aplicada. Útil para ambientes corporativos com requisitos de conformidade. Para seu papel na correção da janela para um ID de modelo [1m] não reconhecido, consulte Corrigir a janela para um gateway ou ID de modelo personalizado
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING Defina como 1 para desativar o raciocínio adaptativo no Opus 4.6 e no Sonnet 4.6 e recorrer ao orçamento fixo de pensamento controlado por MAX_THINKING_TOKENS. Não tem efeito nos modelos Fable, no Sonnet 5 e posteriores, nem no Opus 4.7 e posteriores, que sempre usam raciocínio adaptativo
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION Defina como 1 para impedir que o Claude Code mescle por chave os blocos env das configurações gerenciadas entre fontes de administrador, de modo que apenas o bloco env inteiro da fonte de maior prioridade se aplique, como antes da v2.1.223. Defina-a no ambiente que inicia o Claude Code, pois o Claude Code ignora uma cópia entregue por meio de um bloco env de configurações. Requer Claude Code v2.1.223 ou posterior
CLAUDE_CODE_DISABLE_ADVISOR_TOOL Defina como 1 para desativar a ferramenta advisor. O comando /advisor fica indisponível, qualquer advisorModel configurado é ignorado, e a flag --advisor é aceita, mas não tem efeito, então scripts existentes que a passam continuam funcionando sem erros
CLAUDE_CODE_DISABLE_AGENT_VIEW Defina como 1 para desativar os agentes em segundo plano e a visualização de agentes: claude agents, --bg, /background e o supervisor sob demanda. Equivalente à configuração disableAgentView
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN Defina como 1 para desativar a renderização em tela cheia e usar o renderizador clássico da tela principal. A conversa permanece no scrollback nativo do seu terminal, para que Cmd+f e o modo de cópia do tmux funcionem normalmente. Tem precedência sobre CLAUDE_CODE_NO_FLICKER e a configuração tui. Você também pode alternar com /tui default. Não se aplica a sessões em segundo plano abertas a partir da visualização de agentes, que sempre usam renderização em tela cheia
CLAUDE_CODE_DISABLE_ARTIFACT Defina como 1 para desativar a ferramenta Artifact, que publica a saída da sessão como uma página web privada no claude.ai. Depois que você a define, nenhum arquivo de configurações reativa a ferramenta. Para desativar a ferramenta a partir de um arquivo de configurações, defina enableArtifact como false; a chave descontinuada disableArtifact também a desativa
CLAUDE_CODE_DISABLE_ATTACHMENTS Defina como 1 para desativar o processamento de anexos. Menções de arquivos com a sintaxe @ são enviadas como texto simples em vez de serem expandidas para o conteúdo do arquivo
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Defina como 1 para fazer um processo do Claude Code executar ele mesmo seu comando gcpAuthRefresh ou awsAuthRefresh em vez de esperar enquanto outro processo o executa. Requer Claude Code v2.1.286 ou posterior
CLAUDE_CODE_DISABLE_AUTO_MEMORY Defina como 1 para desativar a memória automática. Defina como 0 para forçar a ativação da memória automática mesmo quando o modo --bare ou autoMemoryEnabled: false a desativaria. Quando desativada, o Claude não cria nem carrega arquivos de memória automática
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS Defina como 1 para desativar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro run_in_background nas ferramentas Bash e de subagente, o envio automático para segundo plano e o atalho Ctrl+B
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT Defina como 1 para impedir que o Claude Code trate uma resposta em streaming do Amazon Bedrock com um cabeçalho Content-Type ausente ou vazio como o event stream binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, de outra forma, não foi modificada, então ele decodifica o corpo e o streaming continua funcionando. Defina isto apenas para um gateway que também reemite o stream como server-sent events; o Claude Code então lê o corpo sem cabeçalho como server-sent events. Requer Claude Code v2.1.239 ou posterior
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Defina como 1 para pular a verificação de que uma resposta em streaming do Amazon Bedrock carrega o content-type application/vnd.amazon.eventstream. Sem esta variável, quando uma resposta carrega um content-type diferente, o Claude Code faz a requisição falhar com um erro que nomeia esse tipo, o que significa que um gateway ou proxy está transformando a resposta. Configure o gateway para encaminhar o cabeçalho Content-Type e o corpo sem modificações, em vez de definir esta variável. Requer Claude Code v2.1.208 ou posterior
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF Defina como 1 para interromper os comandos de shell em segundo plano em execução de uma sessão em segundo plano, os workflows dinâmicos e, a partir da v2.1.198, os subagentes em segundo plano quando o supervisor para, reinicia ou atualiza o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas essa entrega: enviar uma sessão para segundo plano com ← ou /background ainda transfere o trabalho em andamento, e CLAUDE_DISABLE_ADOPT desativa ambos. Requer Claude Code v2.1.196 ou posterior
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Defina como 1 para impedir que o Claude Code encerre comandos de shell em segundo plano sob pressão de memória. Por padrão, no macOS e no Linux, o Claude Code encerra shells em segundo plano quando o sistema operacional relata pressão crítica de memória e a sessão está ociosa há 30 minutos sem nenhum turno ou subagente em execução. O Windows não tem sinal de pressão de memória, então esta variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS Defina como 1 para desativar as skills e os workflows incluídos no Claude Code: skills e workflows incluídos são removidos por completo, enquanto comandos integrados como /init continuam podendo ser digitados, mas ficam ocultos para o modelo. /doctor continua podendo ser digitado, como os comandos integrados; oculte-o com DISABLE_DOCTOR_COMMAND em vez disso. Skills de plugins, .claude/skills/ e .claude/commands/ não são afetadas. Equivalente à configuração disableBundledSkills
CLAUDE_CODE_DISABLE_CFC_PROMPT Defina como 1 para manter as ferramentas de navegador do Claude in Chrome disponíveis, omitindo a seção do Chrome do system prompt e a skill incluída /claude-in-chrome. Para hosts que incorporam o Claude Code e fornecem sua própria orientação de navegador. Requer Claude Code v2.1.257 ou posterior
CLAUDE_CODE_DISABLE_CLAUDE_MDS Defina como 1 para impedir o carregamento de quaisquer arquivos de memória CLAUDE.md no contexto, incluindo arquivos de memória de usuário, de projeto e de memória automática
CLAUDE_CODE_DISABLE_CRON Defina como 1 para desativar as tarefas agendadas. A skill /loop e as ferramentas cron ficam indisponíveis e quaisquer tarefas já agendadas param de disparar, incluindo tarefas que já estão em execução no meio da sessão
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT Defina como 1 para desativar o limite de tempo nos prompts de remoção de caminhos críticos. No modo auto, o Claude Code passa a enviar essas remoções ao classificador, e no modo bypassPermissions o prompt aguarda sua resposta. Defina-a no ambiente que inicia o Claude Code, pois o Claude Code ignora uma cópia entregue por meio de um bloco env de configurações. Requer Claude Code v2.1.281 ou posterior
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Defina como 1 para remover das requisições de API os cabeçalhos de requisição anthropic-beta específicos da Anthropic e os campos beta de schema de ferramenta (como defer_loading e eager_input_streaming). Use isto quando um gateway proxy rejeitar requisições com erros como "Unexpected value(s) for the anthropic-beta header" ou "Extra inputs are not permitted". Os campos padrão (name, description, input_schema, cache_control) são preservados. O MCP Tool Search é desativado e todas as ferramentas MCP são carregadas antecipadamente, mesmo quando você define ENABLE_TOOL_SEARCH. No Claude Code v2.1.227 ou posterior, as configurações gerenciadas podem manter o tool search ativado. Desativar recursos de pré-lançamento explica onde essa substituição se aplica
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS Defina como 1 para desativar os subagentes Explore e Plan integrados. O Claude passa a explorar com suas ferramentas de busca ou com o subagente de uso geral, e o modo de planejamento lê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados chamados Explore ou Plan não são afetados. Para remover todos os tipos de subagente integrados no Agent SDK ou no modo não interativo, use CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS em vez disso. Requer Claude Code v2.1.198 ou posterior
CLAUDE_CODE_DISABLE_FAST_MODE Defina como 1 para desativar o modo rápido
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Defina como 1 para desativar as pesquisas de qualidade de sessão "How is Claude doing?". As pesquisas também são desativadas quando DISABLE_TELEMETRY, DO_NOT_TRACK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definida, a menos que CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL as reative. Para definir uma taxa de amostragem em vez de desativá-las completamente, use a configuração feedbackSurveyRate. Consulte Pesquisas de qualidade de sessão
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING Defina como 1 para desativar o checkpointing de arquivos. O comando /rewind não conseguirá restaurar alterações de código. Sobrescreve a configuração fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS Defina como 1 para remover do contexto do Claude as instruções integradas de fluxo de trabalho de commit e PR e o snapshot do status do git. Útil ao usar suas próprias skills de fluxo de trabalho do git. Tem precedência sobre a configuração includeGitInstructions quando definida
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Defina como 1 para impedir o remapeamento automático do Opus 4.0 e 4.1 para a versão atual do Opus na API da Anthropic. Use quando quiser intencionalmente fixar um modelo mais antigo. O remapeamento não é executado no Amazon Bedrock, no Google Cloud's Agent Platform nem no Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Defina como 1 para impedir que o Claude Code no Amazon Bedrock e no Google Cloud's Agent Platform mude para um modelo mais antigo quando sua conta perde o acesso ao modelo de uma sessão no meio da sessão; em vez disso, a requisição recusada falha imediatamente. Uma cadeia de modelos de fallback que você configurar ainda muda de modelo nessa recusa, e as verificações de modelo na inicialização ainda recorrem ao fallback na inicialização. Requer Claude Code v2.1.285 ou posterior
CLAUDE_CODE_DISABLE_MOUSE Defina como 1 para desativar o rastreamento do mouse na renderização em tela cheia. A rolagem por teclado com PgUp e PgDn continua funcionando. Use isto para manter o comportamento nativo de copiar ao selecionar do seu terminal
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Defina como 1 para desativar o tratamento de cliques, arrastos e hover na renderização em tela cheia, mantendo a rolagem com a roda do mouse. Use isto quando quiser que a rolagem com a roda funcione dentro do Claude Code, mas não quiser que cliques posicionem o cursor, expandam a saída de ferramentas ou abram links. CLAUDE_CODE_DISABLE_MOUSE tem precedência quando ambas estão definidas. Requer Claude Code v2.1.195 ou posterior
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION Defina como 1 para impedir que o Claude Code releia o certificado e a chave de cliente mTLS quando uma requisição de API falha com um erro no nível de conexão, como um reset de conexão ou um erro de handshake TLS. Com a releitura desativada, o Claude Code carrega arquivos rotacionados apenas na próxima vez que aplicar configurações ou na próxima inicialização. Requer Claude Code v2.1.232 ou posterior
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Defina com qualquer valor não vazio, como 1, para desativar o tráfego de rede não essencial: atualizações automáticas, telemetria, relatórios de erros, o comando /feedback, o feedback redigido pelo Claude, notas de versão, as verificações do badge de status de PR e MR e verificações de disponibilidade, como a verificação do modo rápido. Também interrompe as execuções em segundo plano de fontes command de plugins, que são comandos locais e não tráfego de rede, porque elas podem disparar instalações de dependências. Defini-la como 0 ou false ainda desativa esse tráfego, diferentemente da maioria das variáveis de ativar/desativar; remova a definição da variável para permiti-lo novamente. Também desativa a busca de feature flags, o que torna o Remote Control e os outros recursos que precisam da busca de feature flags indisponíveis. A instalação automática do marketplace oficial de plugins não é abrangida; desative-a com CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. Não afeta a descoberta de modelos do gateway, que tem sua própria ativação opcional
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Defina como 1 para desativar o fallback sem streaming quando uma requisição em streaming falha no meio do stream. Em vez disso, os erros de streaming são propagados para a camada de retry. Útil quando um proxy ou gateway faz com que o fallback produza execução duplicada de ferramentas
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Defina como 1 para enviar a notificação de desktop da ferramenta PushNotification mesmo enquanto você está digitando no terminal ou com ele em foco. Por padrão, a ferramenta omite tanto a notificação de desktop quanto o push móvel quando detecta atividade recente do teclado ou foco no terminal. Esta variável desativa apenas essa verificação local, então o servidor ainda pode suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL Defina como 1 para desativar o registro automático do marketplace oficial de plugins. O Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante a primeira inicialização interativa em uma máquina. Se a variável estiver definida nesse momento, o Claude Code pula o registro permanentemente. Remover a definição da variável depois não desfaz essa omissão. Execute claude plugin marketplace add anthropics/claude-plugins-official para registrar o marketplace a qualquer momento
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS Defina como 1 para impedir que o Claude Code execute seus hooks Notification para solicitações de permissão não respondidas em sessões nas quais o Claude Code as envia ao callback canUseTool do Agent SDK, que é como o Claude Desktop e a extensão do VS Code hospedam o Claude Code. Não tem efeito em sessões de terminal. Requer Claude Code v2.1.233 ou posterior
CLAUDE_CODE_DISABLE_POLICY_SKILLS Defina como 1 para pular o carregamento de skills do diretório de skills gerenciadas de todo o sistema. Útil para sessões de contêiner ou CI que não devem carregar skills provisionadas pelo operador
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY Defina como 1 para desativar a verificação da ferramenta PowerShell que nega os comandos internos do cmd rd, rmdir, del e erase em um caminho do sistema, como a raiz de uma unidade ou seu diretório pessoal. O Claude Code ignora esta variável no bloco env de um arquivo de configurações. Requer Claude Code v2.1.283 ou posterior
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT Defina como 1 para desativar a verificação de caminho crítico para um rm recursivo cujo alvo é inteiramente a saída de uma substituição de comando, como rm -rf "$(pwd)". As outras verificações de caminho crítico continuam em execução. Defina-a no ambiente que inicia o Claude Code, pois o Claude Code ignora uma cópia entregue por meio de um bloco env de configurações. Requer Claude Code v2.1.281 ou posterior
CLAUDE_CODE_DISABLE_TERMINAL_TITLE Defina como 1 para desativar as atualizações automáticas do título do terminal com base no contexto da conversa. Isso também pula a requisição em segundo plano ao modelo pequeno/rápido que gera um título de sessão
CLAUDE_CODE_DISABLE_THINKING Defina como 1 para omitir totalmente o parâmetro thinking das requisições de API. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. Em modelos que pensam por padrão, omitir o parâmetro significa que o modelo ainda pode pensar. Para desativar explicitamente o pensamento estendido na API da Anthropic, use MAX_THINKING_TOKENS=0 em vez disso. Nenhuma das variáveis desativa o pensamento no Opus 5.5, no Sonnet 5.5 ou nos modelos Fable, que não permitem desativar o pensamento. Em provedores terceiros, MAX_THINKING_TOKENS=0 também omite o parâmetro, então as duas variáveis se comportam da mesma forma lá
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT Defina como 1 para pular a compactação automática proativa quando o Claude Code não reconhece o ID do modelo, como um alias de gateway de LLM. Sem esta variável, o Claude Code compacta na janela de contexto que ele presume para o ID. CLAUDE_CODE_MAX_CONTEXT_TOKENS pode corrigir a janela presumida em vez disso; consulte Corrigir a janela para um gateway ou ID de modelo personalizado para saber quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL Defina como 1 para desativar a rolagem virtual na renderização em tela cheia e renderizar todas as mensagens da transcrição. Use isto se a rolagem no modo de tela cheia mostrar regiões em branco onde deveriam aparecer mensagens
CLAUDE_CODE_DISABLE_WEB_FETCH Defina como 1 para desativar a ferramenta WebFetch. A ferramenta WebSearch continua disponível. Requer Claude Code v2.1.285 ou posterior
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER Defina como 1 para iniciar comandos da ferramenta PowerShell no Windows diretamente, em vez de por meio do launcher cmd.exe. Por padrão, o launcher permite que um comando PowerShell em execução em segundo plano seja transferido para o próximo processo da sessão, como quando você envia a sessão para segundo plano. Se você definir a variável, um comando PowerShell em segundo plano é interrompido quando o processo da sessão termina. Comandos Bash não são afetados. Requer Claude Code v2.1.269 ou posterior
CLAUDE_CODE_DISABLE_WORKFLOWS Defina como 1 para desativar os workflows. Equivalente à configuração disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Define o nível de esforço para modelos compatíveis. 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, /effort e as configurações modelSettings e effortLevel. Um limite maxEffortLevel ainda se aplica. Consulte Ajustar o nível de esforço
CLAUDE_CODE_ENABLE_AUTO_MODE Aceita para compatibilidade com versões mais antigas e não tem efeito. O modo auto está disponível por padrão em todos os provedores, incluindo Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e sessões do Claude apps gateway com login feito. Da v2.1.158 à v2.1.206, era necessário definir esta variável como 1 para disponibilizar o modo auto nesses provedores
CLAUDE_CODE_ENABLE_AWAY_SUMMARY Sobrescreve a disponibilidade do resumo da sessão. Defina como 0 para forçar a desativação dos resumos, independentemente da opção em /config. Defina como 1 para forçar a ativação dos resumos quando awaySummaryEnabled for false. Tem precedência sobre a configuração e a opção em /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Defina como 1 para atualizar o estado dos plugins nos limites de turno no modo não interativo após a conclusão de uma instalação em segundo plano. Desativada por padrão porque a atualização altera o system prompt no meio da sessão, o que invalida o cache de prompt para esse turno
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL Defina como 1 para encaminhar a pesquisa de qualidade de sessão "How is Claude doing?" para o seu próprio coletor OpenTelemetry quando o tráfego não essencial destinado à Anthropic estiver bloqueado. As avaliações da pesquisa são emitidas apenas como eventos OTEL para o coletor configurado. Nenhum dado da pesquisa é enviado à Anthropic neste modo. Aplica-se quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY ou DO_NOT_TRACK está definida, e não tem efeito caso contrário. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY e a política de feedback de produto da organização têm precedência
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING Controla se as entradas de chamadas de ferramenta são transmitidas pela API à medida que Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como a escrita de um arquivo longo, chega somente depois que Claude termina de gerá-la, o que pode parecer travado. Ativado por padrão na API da Anthropic. No Amazon Bedrock e no Agent Platform do Google Cloud, ativado por modelo quando o contêiner implantado oferece suporte. Defina como 0 para desativar. Defina como 1 para forçar a ativação ao rotear por um proxy via ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL ou ANTHROPIC_BEDROCK_BASE_URL. Desativado por padrão no Microsoft Foundry e em conexões de gateway
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Defina como 1 para preencher o seletor /model a partir do endpoint /v1/models do seu gateway quando ANTHROPIC_BASE_URL apontar para um gateway compatível com a Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque, caso contrário, gateways baseados em uma chave de API compartilhada mostrariam a todos os usuários todos os modelos que a chave pode acessar. Os modelos descobertos ainda são filtrados por uma allowlist availableModels que a sessão recebe; forneça a lista por meio de MDM ou um arquivo de configurações gerenciadas, já que a entrega gerenciada pelo servidor não está disponível em configurações de gateway
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE Removida na v2.1.142, quando o padrão do modo rápido mudou de Opus 4.6 para Opus 4.7
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION Defina como false para desativar as sugestões de prompt, as previsões em cinza que aparecem na entrada do prompt. Tem precedência sobre a configuração promptSuggestionEnabled, que é o que a opção Prompt suggestions em /config grava. O Claude Code também pausa as sugestões enquanto sua conta está próxima ou no limite de uso. Defina como true para mantê-las ativadas até atingir o limite. Requer Claude Code v2.1.238 ou posterior. Consulte Sugestões de prompt
CLAUDE_CODE_ENABLE_TASKS Seleciona quais ferramentas de acompanhamento de tarefas o Claude Code fornece em sessões que as têm. Por padrão, o Claude Code fornece as ferramentas Task TaskCreate, TaskUpdate, TaskGet e TaskList. Defina como 0 para obter a ferramenta legada TodoWrite em vez disso. Consulte Lista de tarefas
CLAUDE_CODE_ENABLE_TELEMETRY Defina como 1 para ativar a coleta de dados do OpenTelemetry para métricas e logs. Necessária antes de configurar exportadores OTel. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais. Consulte Monitoramento
CLAUDE_CODE_ENABLE_TODO_TOOLS Defina como 1 para obter as ferramentas de acompanhamento de tarefas em todos os modelos. Sem ela, o Claude Code as fornece por padrão somente nos modelos listados em Disponibilidade da ferramenta Task. CLAUDE_CODE_ENABLE_TASKS ainda seleciona as ferramentas Task ou TodoWrite. Requer Claude Code v2.1.233 ou posterior
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY Tempo em milissegundos a aguardar depois que o loop de consulta fica ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts que usam o modo SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS Defina como 1 para ativar equipes de agentes. As equipes de agentes são experimentais e ficam desativadas por padrão
CLAUDE_CODE_EXTRA_BODY Objeto JSON a ser mesclado no nível superior de todo corpo de requisição da API. Útil para passar parâmetros específicos do provedor que o Claude Code não expõe diretamente. Um valor exportado no seu shell também se aplica às sessões em segundo plano que você despacha com claude agents ou --bg. Antes da v2.1.206, as sessões em segundo plano ignoravam um valor exportado pelo shell e usavam qualquer cópia que o processo supervisor em segundo plano tivesse herdado
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Sobrescreve o limite padrão de tokens para leituras de arquivos. Útil quando você precisa ler arquivos maiores por completo
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Defina como 1 para forçar a persistência da transcrição, o histórico de prompts e o registro em claude agents mesmo quando este claude foi iniciado de dentro de outra sessão do Claude Code. Use quando um valor herdado de CLAUDE_CODE_CHILD_SESSION, por exemplo de uma sessão screen ou de um inicializador em segundo plano iniciado primeiro pela ferramenta Bash do Claude Code, fizer com que uma sessão de nível superior genuína seja classificada erroneamente como aninhada. A partir da v2.1.178, o Claude Code detecta o caso do tmux automaticamente e ignora o marcador herdado, então o tmux não precisa mais desta variável. Também respeitada na v2.1.169 e anteriores; não tem efeito na v2.1.170 e v2.1.171, nas quais a detecção de sessão aninhada que ela sobrescreve foi removida
CLAUDE_CODE_FORCE_STRIKETHROUGH Defina como 1 para forçar a renderização tachada de ~~text~~ nas respostas de Claude quando seu terminal oferece suporte, mas não é detectado automaticamente, como via SSH sem TERM_PROGRAM encaminhado. Sem isso, terminais não detectados mostram os marcadores ~~ literais em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior
CLAUDE_CODE_FORCE_SYNC_OUTPUT Defina como 1 para forçar a ativação da saída sincronizada do modo privado DEC 2026 quando seu terminal oferece suporte, mas não é detectado automaticamente. Útil para emuladores como o eat do Emacs, que implementam BSU/ESU, mas não respondem à sondagem de capacidade. Não tem efeito no tmux. Diferentemente de CLAUDE_CODE_NO_FLICKER, que muda para a renderização em tela cheia, esta não altera o renderizador
CLAUDE_CODE_FORK_SUBAGENT Controla o modo fork, que permite que Claude crie subagentes bifurcados por conta própria e fica ativado por padrão somente em sessões interativas. Defina como 1 para ativá-lo também em claude -p e no Agent SDK, ou 0 para desativá-lo em todo tipo de sessão. Você pode executar /subtask com o modo fork ativado ou não. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como 1 para ativar o modo fork
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT Defina como 1 para emitir blocos de texto e de pensamento de subagentes na saída de claude -p --output-format stream-json, o mesmo comportamento da flag --forward-subagent-text. Use a variável quando um harness invoca claude e não pode passar a flag por conta própria. Diferentemente da flag, que encerra com erro fora do modo não interativo com saída stream-json, a variável é ignorada nesses casos para que invocações aninhadas continuem funcionando quando ela é definida para todo o processo. Requer Claude Code v2.1.211 ou posterior
CLAUDE_CODE_GATEWAY_HINT_HEADERS Defina como 1 para enviar os cabeçalhos de dica de gateway, como x-claude-code-request-class e x-claude-code-compaction, em um proxy personalizado ou em um provedor terceirizado, como Amazon Bedrock ou Claude Platform on AWS. Defina como 0 para parar de enviá-los em todas as conexões, incluindo uma conexão direta com a API da Anthropic, onde o Claude Code os envia por padrão. Requer Claude Code v2.1.273 ou posterior
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS Timeout em milissegundos para a requisição de descoberta de modelos do gateway que CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY ativa (padrão: 3000). Aumente-o quando seu gateway precisar de mais de três segundos para responder a /v1/models na inicialização. Aceita apenas dígitos simples; 0, valores negativos e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior
CLAUDE_CODE_GIT_BASH_PATH Somente Windows: caminho para o executável do Git Bash (bash.exe). Use quando o Git Bash estiver instalado, mas não no seu PATH. Se o caminho não existir ou o arquivo não se chamar bash.exe, sh.exe, bash ou sh, o Claude Code ignora a variável e detecta automaticamente o Git Bash como se ela não estivesse definida, registrando um aviso visível com --debug. Antes da v2.1.219, o Claude Code encerrava na inicialização quando o caminho não existia e usava qualquer arquivo existente como shell sem verificar se era bash ou sh. Consulte Configuração no Windows
CLAUDE_CODE_GLOB_HIDDEN Defina como false para excluir dotfiles dos resultados quando Claude invoca a ferramenta Glob. Incluídos por padrão. Não afeta o preenchimento automático de arquivos com @, ls, Grep ou Read
CLAUDE_CODE_GLOB_NO_IGNORE Defina como false para fazer a ferramenta Glob respeitar os padrões do .gitignore. Por padrão, o Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo git. Não afeta o preenchimento automático de arquivos com @, que tem sua própria configuração respectGitignore
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Timeout em segundos para a descoberta de arquivos da ferramenta Glob. O padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL
CLAUDE_CODE_GOAL_CHECKIN_MINUTES Quantos minutos o trabalho em segundo plano pode manter uma meta ativa aguardando antes que o Claude Code peça a Claude para verificá-la. Padrão 30. Defina 0 para desativar as verificações. Informe minutos inteiros em dígitos simples, no máximo 10080, que é uma semana. O Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer Claude Code v2.1.234 ou posterior
CLAUDE_CODE_HIDE_CWD Defina como 1 para ocultar o diretório de trabalho no logotipo de inicialização. Útil para compartilhamentos de tela ou gravações em que o caminho expõe seu nome de usuário do sistema operacional
CLAUDE_CODE_IDE_HOST_OVERRIDE Sobrescreve o endereço de host usado para conectar à extensão da IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento de WSL para Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL Defina como 1 para pular a instalação automática de extensões da IDE. Equivalente a definir autoInstallIdeExtension como false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK Defina como 1 para pular a validação das entradas do lockfile da IDE durante a conexão. Use quando a conexão automática não encontrar sua IDE mesmo ela estando em execução
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Quantos subagentes podem estar em execução em uma sessão antes que a ferramenta Agent se recuse a criar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outro valor é ignorado, então a variável pode ajustar o limite, mas não desativá-lo. Requer Claude Code v2.1.217 ou posterior
CLAUDE_CODE_MAX_CONTEXT_TOKENS Sobrescreve o tamanho da janela de contexto que o Claude Code assume para o modelo ativo. A partir da v2.1.193, a forma como se aplica depende de como o Claude Code resolve o ID do modelo; consulte Corrigir a janela para um gateway ou ID de modelo personalizado. Use isto ao rotear para um modelo via ANTHROPIC_BASE_URL cuja janela de contexto não corresponde ao tamanho integrado para o seu nome
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Comprimento máximo em caracteres de cada descrição de ferramenta MCP e das instruções de cada servidor MCP que o Claude Code envia ao modelo (padrão: 2048). O Claude Code trunca textos mais longos. Aceita um número inteiro positivo em dígitos simples. Qualquer outro valor é ignorado e o padrão se aplica. Requer Claude Code v2.1.280 ou posterior
CLAUDE_CODE_MAX_OUTPUT_TOKENS Define o número máximo de tokens de saída para a maioria das requisições. Os padrões e limites variam por modelo; consulte máximo de tokens de saída. O Claude Code reduz um valor acima do limite de um modelo para esse limite. Para um ID de modelo que o Claude Code não consegue resolver para um modelo conhecido, o padrão é 32000 e o limite é 128000. Aumentar este valor reduz a janela de contexto efetiva disponível antes que a compactação automática seja acionada
CLAUDE_CODE_MAX_RETRIES Sobrescreve o número de vezes para tentar novamente requisições de API com falha (padrão: 10). Limitado a 15 a partir da v2.1.186; a partir da v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG aumenta o padrão e remove o limite. Para sessões não supervisionadas que precisam aguardar interrupções mais longas, defina CLAUDE_CODE_RETRY_WATCHDOG em vez disso
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Removida na v2.1.224 e agora não tem efeito. Anteriormente limitava o número total de subagentes que Claude podia criar com a ferramenta Agent em uma sessão (padrão: 200); criar além do limite falhava com Subagent spawn limit reached. O limite de subagentes simultâneos e o limite de profundidade ainda se aplicam
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Número de camadas de subagentes permitidas abaixo da conversa principal (padrão: 3). No padrão, subagentes podem criar seus próprios subagentes, e um subagente na terceira camada não pode criar mais; defina 1 para desativar o aninhamento. Da v2.1.217 à v2.1.218, o padrão era 1, então um subagente não podia criar os seus próprios a menos que você aumentasse o limite; a v2.1.219 aumentou o padrão para 3. Aceita um número inteiro positivo em dígitos simples; qualquer outro valor é ignorado, então o limite pode ser ajustado, mas não removido. Requer Claude Code v2.1.217 ou posterior
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY Número máximo de ferramentas somente leitura e subagentes que podem ser executados em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo, mas consomem mais recursos
CLAUDE_CODE_MAX_TURNS Limita o número de turnos agênticos 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 seja um inteiro positivo é rejeitado na inicialização com um erro, em vez de ser tratado como ausência de limite
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Limite do número total de chamadas de WebSearch que uma sessão pode fazer (padrão: 200). Quando Claude atinge o limite, outras chamadas de WebSearch retornam um aviso dizendo para continuar com as informações já reunidas. Aceita um número inteiro positivo sem limite superior. Qualquer outro valor é ignorado e o padrão se aplica, então o limite pode ser aumentado, mas não desativado. Requer Claude Code v2.1.212 ou posterior
CLAUDE_CODE_MCP_ALLOWLIST_ENV Defina como 1 para iniciar servidores MCP stdio apenas com um ambiente base seguro mais o env configurado do servidor, em vez de herdar o ambiente do seu shell
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Tempo decorrido em milissegundos antes que uma chamada de ferramenta MCP ainda em execução passe para uma tarefa em segundo plano (padrão: 120000, ou 2 minutos). Defina como 0 para desativar a passagem automática para segundo plano. Requer Claude Code v2.1.212 ou posterior
CLAUDE_CODE_MCP_STARTUP_WAIT_MS Quanto tempo em milissegundos o primeiro turno de uma sessão não interativa aguarda por servidores MCP que ainda estão se conectando, no lugar da espera padrão do primeiro turno. Quando definida, a espera abrange todos os servidores pendentes. Defina como 0 para pular a espera. Um servidor de --permission-prompt-tool mantém sua própria espera de MCP_TIMEOUT independentemente do valor. Requer Claude Code v2.1.274 ou posterior
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT Timeout de inatividade em milissegundos para chamadas de ferramentas MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou conector do claude.ai não envia resposta nem notificação de progresso por esse tempo, a chamada de ferramenta é abortada com um erro em vez de aguardar o MCP_TOOL_TIMEOUT geral. Sobrescreve os padrões por transporte de 300000 (5 minutos) para servidores de rede e 1800000 (30 minutos) para servidores stdio. Defina como 0 para desativar a verificação de inatividade. Valores abaixo de 1000 são elevados para um segundo, e o valor é limitado ao MCP_TOOL_TIMEOUT efetivo. Um timeout por servidor no .mcp.json de pelo menos 1000 eleva a janela de inatividade desse servidor para pelo menos o valor de timeout. Não se aplica a servidores de IDE nem a servidores em processo do SDK. Requer Claude Code v2.1.187 ou posterior. Antes da v2.1.203, os servidores stdio estavam isentos do timeout de inatividade
CLAUDE_CODE_MESSAGING_SOCKET Definida pelo Claude Code, não por você: em sessões que vinculam um socket de caixa de entrada, o Claude Code exporta o caminho desse socket para hooks e comandos Bash quando vincula o socket. Em uma sessão que inicia com mensagens ativadas, o Claude Code vincula o socket antes da execução de qualquer hook. Outras sessões na máquina entregam mensagens para esse caminho. Cada sessão exporta seu próprio socket em vez de um herdado de uma sessão pai, e as mensagens que chegam nele passam pelos controles de entrada da sessão. Blocos env das configurações não podem defini-la. Requer Claude Code v2.1.224 ou posterior
CLAUDE_CODE_MESSAGING_TOKEN Definida pelo Claude Code, não por você: em sessões que vinculam um socket de caixa de entrada, o Claude Code exporta este token por sessão para hooks e comandos Bash junto com CLAUDE_CODE_MESSAGING_SOCKET. Um script que envia para o socket pode enviar {"type":"auth","token":"<token>"} como primeira linha para provar que pertence à sessão. No Windows nativo, o Claude Code exige essa linha e fecha qualquer conexão que não comece com uma válida. As regras de processo filho próprio dizem quando o Claude Code consulta o token. Cada sessão exporta seu próprio token, nunca um herdado de uma sessão pai. Blocos env das configurações não podem defini-la. Requer Claude Code v2.1.228 ou posterior
CLAUDE_CODE_NATIVE_CURSOR Defina como 1 para mostrar o cursor do próprio terminal no ponto de inserção em vez de um bloco desenhado. O cursor respeita as configurações de piscar, formato e foco do terminal
CLAUDE_CODE_NEW_INIT Defina 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 gravá-los. Sem esta variável, /init gera um CLAUDE.md automaticamente sem perguntar
CLAUDE_CODE_NONBLOCKING_STDOUT Defina como 1 para gravar a saída do terminal por meio de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel do modo de controle do tmux pausado ou uma conexão SSH travada, não possa congelar o Claude Code no meio da sessão. Aplica-se no macOS, Linux e WSL quando stdout é um terminal. Requer Claude Code v2.1.261 ou posterior
CLAUDE_CODE_NO_FLICKER Defina como 1 para ativar a renderização em tela cheia, uma prévia de pesquisa que reduz a cintilação e mantém a memória estável em conversas longas. Sobrescreve a configuração tui; você também pode alternar com /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKEN Token de atualização OAuth para autenticação do Claude.ai. Quando definido, claude auth login troca este token diretamente em vez de abrir um navegador. Requer CLAUDE_CODE_OAUTH_SCOPES. Útil para provisionar autenticação em ambientes automatizados
CLAUDE_CODE_OAUTH_SCOPES Escopos 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ória quando CLAUDE_CODE_OAUTH_REFRESH_TOKEN está definida
CLAUDE_CODE_OAUTH_TOKEN Token de acesso OAuth para autenticação do claude.ai. Alternativa ao /login para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas no keychain. Gere um com claude setup-token. A menos que você execute /login, o Claude Code usa o token definido durante toda a sessão. Para substituir um token expirado, gere um novo e reinicie
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Removida na v2.1.160 e agora não tem efeito. Anteriormente fixava o modo rápido no Claude Opus 4.6 em vez do padrão atual. O Opus 4.6 não oferece mais suporte ao modo rápido
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Comprimento máximo dos atributos do OpenTelemetry que carregam conteúdo (respostas do modelo, conteúdo de ferramentas, system prompts, corpos brutos da API), incluindo o marcador de truncamento, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente-o somente se o seu backend de telemetria aceitar valores de atributo maiores que 64 KB, ou reduza-o para diminuir o volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Consulte Monitoramento
CLAUDE_CODE_OTEL_DIAG_STDERR Defina como 1 para gravar erros de diagnóstico do exportador OpenTelemetry no stderr. Por padrão, esses erros aparecem apenas com --debug, então um exportador mal configurado, como em uma colisão de porta do Prometheus, falharia silenciosamente. Requer Claude Code v2.1.179 ou posterior. Consulte Monitoramento
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS Timeout em milissegundos para descarregar spans pendentes do OpenTelemetry (padrão: 5000). Consulte Monitoramento
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervalo para atualizar cabeçalhos dinâmicos do OpenTelemetry em milissegundos (padrão: 1740000 / 29 minutos). Consulte Cabeçalhos dinâmicos
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS Timeout em milissegundos para o exportador OpenTelemetry concluir no encerramento (padrão: 2000). Aumente se métricas forem descartadas na saída. Consulte Monitoramento
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE Defina como 1 para permitir que o 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 via Homebrew e WinGet. Outros gerenciadores de pacotes continuam mostrando o comando de atualização sem executá-lo. Consulte Atualizações automáticas
CLAUDE_CODE_PERFORCE_MODE Defina como 1 para ativar a proteção de escrita compatível com Perforce. Quando definida, 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 o Perforce remove em arquivos sincronizados até que p4 edit os abra. Isso impede que o Claude Code contorne o rastreamento de alterações do Perforce
CLAUDE_CODE_PLUGIN_CACHE_DIR Sobrescreve o diretório raiz de plugins. Apesar do nome, isto define o diretório pai, não o próprio cache: os marketplaces e o cache de plugins ficam em subdiretórios sob este caminho. O padrão é ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS Diretórios de plugins a carregar para a sessão, cada um carregado da forma como uma flag --plugin-dir o carrega. Separe vários caminhos com : no Unix ou ; no Windows. Informe cada caminho como um caminho absoluto ou inicie-o com ~, porque o Claude Code ignora caminhos relativos. Requer Claude Code v2.1.280 ou posterior. Consulte Carregar um plugin para uma sessão
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS Timeout em milissegundos para clonar ou atualizar um marketplace de plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Consulte Git clone atingiu o timeout
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE Defina como 1 para pular a tentativa de clonar novamente e continuar usando o checkout existente do marketplace quando uma atualização do marketplace não consegue alcançar ou se autenticar no remoto. Útil em ambientes offline ou isolados (airgapped), onde clonar novamente falharia da mesma forma. Consulte Atualizações do marketplace falham em ambientes offline
CLAUDE_CODE_PLUGIN_PREFER_HTTPS Defina como 1 para clonar fontes abreviadas owner/repo do GitHub via HTTPS em vez de SSH. Aplica-se à instalação e atualização de plugins, e a /plugin marketplace add e update. Útil em runners de CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para github.com
CLAUDE_CODE_PLUGIN_SEED_DIR Caminho para um ou mais diretórios seed de plugins somente leitura, separados por : no Unix ou ; no Windows. Use isto para incluir um diretório de plugins pré-preenchido em uma imagem de contêiner. O Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem clonar novamente. Consulte Pré-preencher plugins para contêineres
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY Defina como 1 para impedir que o Claude Code passe -ExecutionPolicy Bypass ao iniciar o PowerShell para chamadas de ferramenta, hooks e comandos da linha de status, respeitando em vez disso a política de execução efetiva da máquina. Por padrão, o Claude Code contorna a política de execução no escopo do processo para que scripts .ps1 e importações de módulos funcionem em instalações do Windows com o padrão Restricted. O bypass no escopo do processo nunca sobrescreve as políticas de grupo MachinePolicy ou UserPolicy, independentemente desta configuração
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Limite máximo em milissegundos da espera ociosa por subagentes e fluxos de trabalho em segundo plano após o turno final no modo não interativo com a flag -p. A espera ociosa recomeça cada vez que Claude usa um turno para tratar um resultado em segundo plano. Padrão: 600000, ou 10 minutos. Quando a espera ociosa atinge o limite, o Claude Code para de aguardar as tarefas em segundo plano restantes e encerra. Defina como 0 para aguardar indefinidamente. Este limite é separado do período de tolerância de cinco segundos que se aplica a shells simples em segundo plano. Requer Claude Code v2.1.182 ou posterior
CLAUDE_CODE_PROCESS_WRAPPER Inicia os processos que o Claude Code executa a partir do seu próprio binário, como o serviço em segundo plano que hospeda as sessões do agent view, por meio de um inicializador corporativo informado como prefixo de argv, como /opt/corp/launcher. Defina-a no bloco env das configurações de usuário ou configurações gerenciadas, não como um export do shell, para que o serviço em segundo plano desanexado a herde; as configurações de projeto e locais não podem defini-la. Equivalente à configuração processWrapper, que requer Claude Code v2.1.210 ou posterior; esta variável tem precedência quando ambas estão definidas. A extensão do VS Code configura seu próprio inicializador separadamente por meio da configuração claudeProcessWrapper. Ignorada no Windows. Consulte Executar o Claude Code por trás de um inicializador corporativo para o formato do valor, o que o inicializador abrange e o contrato que o inicializador deve satisfazer. Requer Claude Code v2.1.208 ou posterior
CLAUDE_CODE_PROJECT_DIR_NAME Defina junto com CLAUDE_CONFIG_DIR para escolher o nome do diretório em projects/ sob o qual o Claude Code armazena as transcrições e a memória automática dessa sessão, no lugar de um derivado do caminho do diretório de trabalho. Por exemplo, iniciar o Claude Code com CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude as armazena em /srv/tenant-a/projects/work/. O Claude Code ignora esta variável quando CLAUDE_CONFIG_DIR não está definida e a lê apenas do ambiente a partir do qual você inicia claude, nunca de um bloco env de arquivo de configurações. Consulte Nomear o diretório do projeto você mesmo. Requer Claude Code v2.1.234 ou posterior
CLAUDE_CODE_PROMPT_CACHE_TTL Defina 5m ou 1h, os únicos valores que o Claude Code aceita, para escolher o TTL do cache de prompt da conversa principal: seus turnos interativos, -p e do SDK, além dos auxiliares executados em linha com eles. Tem precedência sobre a configuração promptCacheTtl e sobre ENABLE_PROMPT_CACHING_1H, e FORCE_PROMPT_CACHING_5M a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior
CLAUDE_CODE_PROPAGATE_TRACEPARENT Defina como 1 para propagar o contexto de rastreamento W3C quando ANTHROPIC_BASE_URL apontar para um proxy personalizado. A propagação abrange o cabeçalho traceparent em requisições ao modelo e a MCP HTTP e a variável de ambiente TRACEPARENT para subprocessos de Bash, PowerShell e hooks. Por padrão, a propagação fica ativada somente quando conectado diretamente à API da Anthropic. Adicionada na v2.1.152. Consulte Traces (beta)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST Definida por plataformas host que incorporam o Claude Code e gerenciam o roteamento do provedor de modelos em seu nome. Quando definida, o Claude Code ignora variáveis de seleção de provedor, endpoint e autenticação, como CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY, em arquivos de configurações, para que as configurações de usuário não possam sobrescrever o roteamento do host. O Claude Code também ignora chaves de seleção de modelo, como model, fallbackModel e modelOverrides, nas configurações gerenciadas, qualquer que seja a fonte gerenciada que as entregue, para que a configuração de modelo do host tenha precedência sobre uma fixação de modelo gerenciada desatualizada. O Claude Code também ignora variáveis de seleção de modelo, como ANTHROPIC_MODEL e a família ANTHROPIC_DEFAULT_*_MODEL, em um bloco env gerenciado; uma allowlist availableModels nas configurações gerenciadas ainda se aplica, a menos que o host forneça a sua própria. O Claude Code também pula a desativação automática de telemetria que, de outra forma, aplica em provedores terceirizados, como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud e Microsoft Foundry, de modo que a telemetria segue a desativação padrão via DISABLE_TELEMETRY. Consulte Comportamentos padrão por provedor de API
CLAUDE_CODE_PROXY_RESOLVES_HOSTS Defina como 1 para permitir que o proxy realize a resolução de DNS em vez do chamador. Opção para ambientes em que o proxy deve lidar com a resolução de nomes de host
CLAUDE_CODE_REMOTE Definida automaticamente como true quando o Claude Code está sendo executado como uma sessão na nuvem. Leia-a a partir de um hook ou script de configuração para detectar se você está em uma sessão na nuvem
CLAUDE_CODE_REMOTE_SESSION_ID Definida automaticamente em sessões na nuvem com o ID da sessão atual. Leia-a para construir um link de volta para a transcrição da sessão. Consulte Vincular a saída de volta à sessão
CLAUDE_CODE_RESTRICTED Defina como 1 para iniciar a sessão no modo restrito, o mesmo que passar --restricted. O Claude Code ignora esta variável no bloco env de um arquivo de configurações. Requer Claude Code v2.1.248 ou posterior
CLAUDE_CODE_RESUME_INTERRUPTED_TURN Defina como 1 para retomar automaticamente se a sessão anterior terminou no meio de um turno. Usada no modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt. Para desativar, remova a definição da variável ou defina-a como 0. Para o painel de chat do VS Code, consulte Continuar conversas após um recarregamento
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS Idade máxima em milissegundos da última mensagem da transcrição para que uma sessão que terminou no meio de um turno continue automaticamente ao ser retomada. Quando a última mensagem é mais antiga que esse limite, o Claude Code pula a retomada automática de CLAUDE_CODE_RESUME_INTERRUPTED_TURN e sua mensagem de continuação CLAUDE_CODE_RESUME_PROMPT, e a sessão inicia ociosa para que você continue explicitamente. Não definida ou 0 significa sem limite, exceto que um turno cuja última requisição falhou com um erro de API só é retomado enquanto esse erro tiver menos de seis horas. Um valor positivo limita todos os turnos, incluindo esses; um valor negativo ou não numérico aplica um limite de uma hora. Scripts de inicialização para agentes de longa duração podem definir isto para que uma reinicialização sobre uma transcrição antiga não execute novamente um prompt obsoleto. O Claude Code define por conta própria um limite de uma hora quando reinicia uma sessão do agent view que travou e herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior
CLAUDE_CODE_RESUME_PROMPT Sobrescreve a mensagem de continuação que o Claude Code envia a Claude quando CLAUDE_CODE_RESUME_INTERRUPTED_TURN continua um turno interrompido em vez de reenviar seu prompt, ou quando você retoma uma chamada de ferramenta adiada com -p. O padrão é Continue from where you left off.. Uma string vazia usa o padrão
CLAUDE_CODE_RETRY_WATCHDOG Defina como 1 para sessões não supervisionadas, como harnesses de avaliação, jobs de CI ou workers remotos. Tenta novamente erros de capacidade 429 e 529 indefinidamente em vez de falhar após CLAUDE_CODE_MAX_RETRIES tentativas. O Claude Code falha imediatamente quando uma requisição de velocidade padrão recebe um 429 que informa um limite de gastos ou créditos de uso esgotados, mesmo um vindo de um limite de gastos do gateway que é redefinido em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses casos indefinidamente. Para requisições do modo rápido, consulte Lidar com rate limits. O watchdog aguarda até 5 minutos entre as tentativas, ou até que o limite seja redefinido quando a resposta traz um horário de redefinição do rate limit, de modo que uma sessão que atinge um limite de uso aguarda o restante da janela. Na v2.1.199 ou posterior, também aumenta a contagem padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões perdidas, para 300, cerca de três horas de espera, e remove o limite de 15 em CLAUDE_CODE_MAX_RETRIES se você definir essa variável explicitamente. Requer Claude Code v2.1.186 ou posterior
CLAUDE_CODE_SAFE_MODE Defina como 1 para iniciar no modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, fluxos de trabalho, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e de sugestão de arquivos, servidores LSP e memória automática não são carregados, para a solução de problemas de uma configuração quebrada. A política das configurações gerenciadas ainda se aplica, incluindo hooks, linha de status e comandos de sugestão de arquivos configurados por política; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Equivalente a passar --safe-mode. Processos filhos iniciados diretamente herdam a variável
CLAUDE_CODE_SCRIPT_CAPS Objeto JSON que limita quantas vezes scripts específicos podem ser invocados por sessão quando CLAUDE_CODE_SUBPROCESS_ENV_SCRUB está definida. As chaves são substrings comparadas com o texto do comando; os valores são limites inteiros de chamadas. 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 do shell como ./scripts/deploy.sh $(evil) ainda contam para o limite. A expansão em tempo de execução via xargs ou find -exec não é detectada; este é um controle de defesa em profundidade
CLAUDE_CODE_SCROLL_SPEED Define o multiplicador de rolagem da roda do mouse na renderização em tela cheia. Aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1, como 0.5, para desacelerar a rolagem acelerada do trackpad e da roda em terminais que já amplificam eventos da roda. Defina como 3 para corresponder ao vim se o seu terminal envia um evento da roda por entalhe sem amplificação. Ignorada no terminal das IDEs JetBrains, onde o Claude Code usa seu próprio tratamento de rolagem
CLAUDE_CODE_SEND_FEEDBACK Defina como 0 para desativar o feedback redigido por Claude em uma sessão. Defina como 1 para ativá-lo onde sua conta já tem acesso; a variável não pode conceder acesso por si só, e as outras opções que desativam o feedback, como DISABLE_FEEDBACK_COMMAND e o valor off da configuração feedbackDrafts, ainda se aplicam
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS Sobrescreve o orçamento de tempo em milissegundos para hooks SessionEnd. O valor também é o timeout para cada hook que não define seu próprio timeout. Aplica-se à saída da sessão, a /clear e à troca de sessões via /resume interativo. Por padrão, o orçamento é de 1,5 segundo, elevado automaticamente para o maior timeout por hook configurado nos arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugins não elevam o orçamento
CLAUDE_CODE_SESSION_ID Definida automaticamente com o ID da sessão atual em subprocessos das ferramentas Bash e PowerShell, subprocessos de comandos de hook e subprocessos de servidores MCP stdio. Para Bash, PowerShell e hooks, corresponde ao campo session_id na entrada JSON do hook e é atualizada em /clear. Um subprocesso de servidor MCP mantém o ID com o qual foi iniciado. Com --resume <session-id>, ele recebe o ID retomado, correspondendo aos hooks e ao Bash. Com --continue ou --resume sem um ID explícito, ele pode receber o ID da inicialização original em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão do Claude Code que os iniciou
CLAUDE_CODE_SHELL Define o shell que o Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário bash ou zsh, por exemplo /opt/homebrew/bin/bash. Outros shells, como fish, não são compatíveis. Se o valor não for um caminho funcional de bash ou zsh, o Claude Code o ignora e recorre à detecção automática. A detecção automática usa seu $SHELL quando ele aponta para bash ou zsh; caso contrário, escolhe o primeiro zsh e depois bash funcional encontrado no seu PATH e nos locais de instalação padrão
CLAUDE_CODE_SHELL_PREFIX Prefixo de comando que envolve os comandos de shell que o Claude Code inicia: chamadas da ferramenta Bash, comandos de hook, comandos da linha de status e comandos de inicialização de servidores MCP stdio. Hooks do PowerShell e hooks no formato exec são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples, como /path/to/logger.sh, executa cada comando como /path/to/logger.sh '<command>'. O wrapper recebe a linha de comando como um único argumento entre aspas de shell em $1, então o wrapper deve reavaliar $1 com um shell, por exemplo exec bash -c "$1". Tratar $1 como um caminho de executável simples quebra servidores MCP stdio que passam argumentos como npx -y <package>. Para chamadas da ferramenta Bash, $1 contém a invocação completa do shell que o Claude Code monta, incluindo a configuração do ambiente, e não apenas o comando que Claude executou
CLAUDE_CODE_SIMPLE Defina como 1 para executar com um system prompt mínimo e apenas as ferramentas Bash, de leitura de arquivos e de edição de arquivos. As ferramentas MCP de --mcp-config continuam disponíveis. Desativa a descoberta automática de hooks, skills, comandos personalizados, subagentes, plugins instalados, servidores MCP, memória automática e CLAUDE.md. Skills em um diretório que você passa com --add-dir ainda são carregadas. Tokens OAuth e credenciais do keychain não são lidos, então a autenticação da Anthropic deve vir de ANTHROPIC_API_KEY ou de um apiKeyHelper em --settings. Equivalente a passar --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT Defina como 1 para usar um system prompt mais curto e descrições de ferramentas abreviadas em qualquer modelo. Defina como 0, false, no ou off para desativar mesmo em modelos nos quais o experimento ou a configuração do servidor a ativaria. O conjunto completo de ferramentas, hooks, servidores MCP e a descoberta de CLAUDE.md permanecem ativados
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH Pula a autenticação do lado do cliente para o Claude Platform on AWS, para gateways que assinam as requisições por conta própria
CLAUDE_CODE_SKIP_AWS_CRED_CACHE Defina como 1 para desativar o cache em processo das credenciais resolvidas a partir da cadeia padrão de provedores de credenciais da AWS, para que o Claude Code resolva a cadeia em toda requisição de API. Com o cache desativado, um perfil baseado em SSO solicita credenciais ao IAM Identity Center em toda requisição. Consulte cache de credenciais e timeout de resolução. Requer Claude Code v2.1.207 ou posterior
CLAUDE_CODE_SKIP_BEDROCK_AUTH Pula a autenticação da AWS para o Amazon Bedrock (por exemplo, ao usar um gateway de LLM)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS Defina como 1 para tratar uma verificação de disponibilidade do modo rápido com falha como disponível, para redes que bloqueiam a requisição direta da verificação para api.anthropic.com. O Claude Code ainda respeita uma resposta "disabled by your organization"
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK Defina como 1 para pular a verificação de disponibilidade do modo rápido do lado do cliente, para proxies que interceptam a requisição da verificação em vez de recusá-la. A API ainda rejeita requisições do modo rápido quando sua organização tem o modo rápido desativado
CLAUDE_CODE_SKIP_FOUNDRY_AUTH Pula a autenticação do Azure para o Microsoft Foundry, para um proxy ou gateway que injeta seu próprio cabeçalho Authorization. O Claude Code envia requisições sem uma credencial do Azure e preserva o cabeçalho Authorization que você fornece, por exemplo por meio de ANTHROPIC_CUSTOM_HEADERS. Ignorada quando ANTHROPIC_FOUNDRY_API_KEY ou ANTHROPIC_FOUNDRY_AUTH_TOKEN está definida. Antes da v2.1.203, esta variável deixava o cliente do Microsoft Foundry incapaz de enviar requisições, a menos que uma chave de API também estivesse definida
CLAUDE_CODE_SKIP_MANTLE_AUTH Pula a autenticação da AWS para o Amazon Bedrock Mantle (por exemplo, ao usar um gateway de LLM)
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY As verificações de modelo na inicialização no Amazon Bedrock e no Agent Platform do Google Cloud lembram, nesta máquina, quais modelos descobriram que sua conta não pode invocar, por até um dia. Defina como 1 para desativar essa memória. Requer Claude Code v2.1.285 ou posterior
CLAUDE_CODE_SKIP_PROMPT_HISTORY Defina como 1 para não gravar o histórico de prompts e as transcrições de sessão em disco. Sessões iniciadas com esta variável definida não aparecem em --resume, --continue nem no histórico da seta para cima. Útil para sessões efêmeras executadas por script
CLAUDE_CODE_SKIP_VERTEX_AUTH Pula a autenticação do Google para o Agent Platform do Google Cloud (por exemplo, ao usar um gateway de LLM)
CLAUDE_CODE_STARTUP_FAILURE_RESULTS Defina como 1 para que uma sessão iniciada com --output-format stream-json grave uma mensagem de resultado informando por que o Claude Code se recusou a iniciar para falhas de inicialização que, de outra forma, terminam apenas com stderr. Requer Claude Code v2.1.274 ou posterior
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Número máximo de vezes consecutivas que um hook Stop ou SubagentStop pode impedir o término do turno antes que o Claude Code o sobrescreva e encerre o turno mesmo assim (padrão: 8). Defina como 0 para desativar o limite. Aumente-o se o seu hook legitimamente precisar de mais iterações para ser resolvido
CLAUDE_CODE_SUBAGENT_MODEL O modelo padrão para subagentes, membros de equipes de agentes e agentes de workflow que não recebem um modelo de outra forma. Aceita um alias como haiku ou um nome de modelo completo. Duas fontes têm precedência sobre ela: um modelo que Claude passa ao criar o agente e um campo model na definição do agente, incluindo inherit. Para mudar isso, defina CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Consulte Escolher um modelo para a ordem completa. Defini-la como inherit é o mesmo que deixá-la sem definição. Antes da v2.1.251, esta variável sobrescrevia tanto o modelo por invocação quanto o campo model da definição
CLAUDE_CODE_SUBAGENT_MODEL_FORCE Defina como 1 para forçar um único modelo em subagentes, membros de equipes e agentes de workflow. Executar todos os subagentes em um modelo informa qual é esse modelo. Requer Claude Code v2.1.257 ou posterior
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL Defina 5m ou 1h, os únicos valores que o Claude Code aceita, para escolher o TTL do cache de prompt para requisições fora da conversa principal, como subagentes, fluxos de trabalho e trabalho em segundo plano. Tem precedência sobre a configuração subagentPromptCacheTtl e sobre ENABLE_PROMPT_CACHING_1H, e FORCE_PROMPT_CACHING_5M a sobrescreve. A API cobra gravações de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB Defina como 1 para remover credenciais dos ambientes de subprocessos (ferramenta Bash, hooks, servidores MCP stdio): credenciais da Anthropic e de provedores de nuvem, qualquer outra variável que o Claude Code reconheça como credencial e credenciais incorporadas em URLs de registros de pacotes. O processo pai do Claude mantém essas credenciais para chamadas de API, mas os 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 do shell. Na v2.1.251 ou posterior, a limpeza também remove as próprias variáveis do Claude Code que apontam para o armazenamento de configuração (como CLAUDE_CONFIG_DIR), para que um processo filho não consiga localizar um diretório de configuração realocado. Deixe a limpeza sem definição se um subprocesso precisar dessas variáveis. No Linux, isto também executa subprocessos Bash em um namespace de PID isolado para que não possam ler os ambientes de processos do host via /proc; como efeito colateral, ps, pgrep e kill não conseguem ver nem enviar sinais para processos do host. claude-code-action define isto automaticamente quando allowed_non_write_users está configurado
CLAUDE_CODE_SYNC_PLUGIN_INSTALL Defina como 1 no modo não interativo (a flag -p) para aguardar a conclusão da instalação de plugins antes da primeira consulta. Sem isso, os plugins são instalados em segundo plano e podem não estar disponíveis no primeiro turno. Combine com CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS para limitar a espera
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS Timeout em milissegundos para a instalação síncrona de plugins. Quando excedido, o Claude Code prossegue sem plugins e registra um erro em log. Sem padrão: sem esta variável, a instalação síncrona aguarda até a conclusão
CLAUDE_CODE_SYNC_SKILLS Defina como 1 no modo não interativo com a flag -p para fazer o Claude Code baixar as skills ativadas para sua conta do claude.ai nessa execução e aguardar a lista delas, até CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS, antes de executar a primeira consulta. Os downloads em si terminam em segundo plano, e Claude aguarda o download de uma skill quando a invoca. Requer autenticação do claude.ai. Sessões de terminal em que você faz login com sua conta do claude.ai baixam essas skills para ~/.claude/skills/synced/ e as ressincronizam a cada 10 minutos aproximadamente sem esta variável, então defina-a somente quando uma execução com -p precisar das suas skills atuais na primeira consulta. Antes da v2.1.273, as sessões de terminal as baixavam somente em uma execução com -p com esta variável definida. O nome da pasta synced é reservado para esse download. Antes da v2.1.227, as skills eram baixadas diretamente para ~/.claude/skills/. O Claude Code aplica regras extras às skills baixadas, como não executar seus comandos ! na sua máquina
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS Timeout em milissegundos para a ressincronização de skills que ocorre no meio da sessão quando um app construído com o Agent SDK recarrega skills (padrão: 30000). Quando excedido, o recarregamento continua com as skills que já chegaram, e os downloads restantes terminam em segundo plano
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS Timeout em milissegundos para a primeira consulta aguardar a lista inicial de skills quando CLAUDE_CODE_SYNC_SKILLS está definida (padrão: 5000). Quando excedido, a primeira consulta é executada com as skills que já chegaram. Os downloads terminam em segundo plano de qualquer forma, e Claude aguarda o download de uma skill quando a invoca
CLAUDE_CODE_SYNTAX_HIGHLIGHT Defina como false para desativar o realce de sintaxe na saída de diff. Útil quando as cores interferem na configuração do seu terminal. Para também desativar o realce em blocos de código e pré-visualizações de arquivos, use a configuração syntaxHighlightingDisabled
CLAUDE_CODE_TASK_LIST_ID Compartilha uma lista de tarefas entre sessões. Defina o mesmo ID em várias instâncias do Claude Code para coordenar em uma lista de tarefas compartilhada, em sessões que têm as ferramentas Task. Consulte Lista de tarefas
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS Sobrescreve, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para que sua equipe de agentes termine de ser desmontada. Aceita de 1000 a 60000; um valor fora do intervalo é ignorado e o padrão de 10000 se aplica. Requer Claude Code v2.1.206 ou posterior
CLAUDE_CODE_TMPDIR Sobrescreve o diretório temporário usado para arquivos temporários internos. O Claude Code acrescenta /claude-{uid}/ a este caminho no Unix, ou /claude/ no Windows. Padrão: /tmp no macOS, os.tmpdir() no Linux e no Windows. No macOS e no Linux, subprocessos Bash em sandbox recebem um $TMPDIR de fallback curto sob o padrão do sistema quando sua substituição é um caminho longo, já que algumas ferramentas falham quando os caminhos temporários ficam longos demais. Comandos Bash fora da sandbox herdam o $TMPDIR do seu shell quando ele está definido. No Windows nativo, quando seu shell não define $TMPDIR, um comando Bash que referencia $TMPDIR recebe sua substituição, ou %TEMP% quando você não definiu uma. Os próprios arquivos temporários do Claude Code sempre usam sua substituição. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais
CLAUDE_CODE_TMUX_TRUECOLOR Defina com qualquer valor não vazio, como 1, para permitir saída truecolor de 24 bits dentro do tmux. Defini-la como 0 ou false ainda permite truecolor, diferentemente da maioria das variáveis de ativar/desativar; remova a definição da variável para restaurar a restrição a 256 cores. Por padrão, o Claude Code restringe a 256 cores quando $TMUX está definida, porque o tmux não repassa sequências de escape truecolor a menos que seja configurado para isso. Defina isto depois de adicionar set -ga terminal-overrides ',*:Tc' ao seu ~/.tmux.conf. Consulte Configuração do terminal para outras configurações do tmux
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE No Linux e no WSL, defina com uma lista separada por vírgulas dos tipos de processos que o Claude Code exclui do limite de memória das ferramentas, como mcp ou lsp. Defina none para limitar todos os tipos, ou all-new para limitar apenas comandos das ferramentas Bash, PowerShell e Monitor. O Claude Code mantém os comandos das ferramentas Bash, PowerShell e Monitor sob o limite independentemente do que você listar. Requer Claude Code v2.1.246 ou posterior
CLAUDE_CODE_TOOL_MEMORY_LIMIT No Linux e no WSL, defina com um tamanho como 4G para limitar a memória que os comandos das ferramentas Bash e PowerShell podem usar, e os comandos da ferramenta Monitor na v2.1.246 ou posterior. Escreva o tamanho em dígitos simples, sozinho para um número de bytes ou com um sufixo K, M, G ou T. Defina 0 ou off para desativar o limite. Depois que o primeiro processo iniciado pelo Claude Code ativou ou desativou o limite, um valor alterado entra em vigor na próxima vez que você iniciar claude. Requer Claude Code v2.1.233 ou posterior
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Prazo em milissegundos antes que o Claude Code cancele uma caixa de diálogo que encaminha para um cliente remoto, como um host de Remote Control ou do SDK, ou a caixa de diálogo de aprovação de uma mensagem entre sessões retida; prompts de permissão e perguntas de AskUserQuestion usam seus próprios fluxos e não são regidos por ela. No Claude Code v2.1.236 ou posterior, também limita o prompt de consentimento de créditos de uso do Fable no meio da sessão em uma sessão que pode estar sendo executada sem supervisão. Controlar mensagens de entrada e sessões não interativas abordam as regras completas de expiração de mensagens retidas, incluindo os casos em que o prazo não se aplica. Sobrescreve a configuração dialogExpiry. 0 ou um valor negativo desativa o prazo
CLAUDE_CODE_USE_ANTHROPIC_AWS Usar o Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCK Usar o Amazon Bedrock
CLAUDE_CODE_USE_FOUNDRY Usar o Microsoft Foundry
CLAUDE_CODE_USE_MANTLE Usar o endpoint Mantle do Amazon Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH Defina como 1 para descobrir comandos personalizados, subagentes e estilos de saída usando as APIs de arquivos do Node.js em vez do ripgrep. Defina isto se o binário do ripgrep incluído não estiver disponível ou estiver bloqueado no seu ambiente. Não afeta as ferramentas Grep ou de busca de arquivos
CLAUDE_CODE_USE_POWERSHELL_TOOL Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é ativada automaticamente; defina como 0 para desativá-la. No Windows com Git Bash instalado, a ferramenta fica ativada por padrão para contas do claude.ai e do Console; defina como 1 para ativá-la em sessões do Amazon Bedrock, do Agent Platform do Google Cloud e do Microsoft Foundry, ou 0 para desativá-la. No Linux, macOS e WSL, defina como 1 para ativá-la, o que requer pwsh no seu PATH. Quando ativada no Windows, Claude pode executar comandos do PowerShell nativamente em vez de roteá-los pelo Git Bash. Consulte Ferramenta PowerShell
CLAUDE_CODE_USE_VERTEX Usar o Agent Platform do Google Cloud
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS Defina com o número de milissegundos que o WebFetch mantém em cache a resposta de cada URL buscada. O padrão é 900000, que corresponde a 15 minutos. Aceita apenas dígitos simples; 0, um decimal ou qualquer outra grafia mantém o padrão. O Claude Code lê o valor uma vez por inicialização, então uma alteração em um bloco env das configurações se aplica na próxima vez que você iniciar claude. Requer Claude Code v2.1.233 ou posterior
CLAUDE_CODE_WEBFETCH_DEADLINE_MS Limite superior em milissegundos de quanto tempo o WebFetch aguarda o download de uma página, incluindo quaisquer redirecionamentos que ele siga. Um download que não tiver sido concluído até lá falha com um erro de prazo. O padrão é 300000, que corresponde a cinco minutos. Defina como 0 para remover o limite. Aceita apenas dígitos simples; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS Quantos agentes uma única execução de workflow executa ao mesmo tempo, de 1 a 256. Por padrão, uma execução executa até 16 agentes ao mesmo tempo, menos quando o Claude Code tem menos CPUs disponíveis; chamadas agent() enfileiradas aguardam um espaço livre. A transcrição de cada agente em execução permanece na memória do Claude Code, então valores mais altos aumentam o uso de memória. Aceita apenas dígitos simples; valores fora do intervalo e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Limite superior, em milissegundos, de quanto tempo um agente de workflow espera que a primeira resposta de um agente irmão com o mesmo prefixo comece antes de enviar sua própria primeira requisição. Quando um fan-out inicia vários agentes que compartilham um prefixo de cache de prompt, o Claude Code retém todos os agentes, exceto o primeiro, por até esse tempo, para que os demais leiam o prefixo em cache em vez de cada um processá-lo sem cache. Padrão 5000. Defina como 0 para desativar a espera. Quando DISABLE_PROMPT_CACHING está definida, os agentes nunca esperam. Requer Claude Code v2.1.229 ou posterior
CLAUDE_CONFIG_DIR Sobrescreve o diretório de configuração (padrão: ~/.claude). Todas as configurações, o histórico de sessões e os plugins são armazenados nesse caminho. Para credenciais, consulte onde o Claude Code armazena credenciais. Útil para executar várias contas lado a lado: por exemplo, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais
CLAUDE_DISABLE_ADOPT Defina como 1 para interromper o trabalho em segundo plano em andamento em vez de transferi-lo quando você coloca uma sessão em segundo plano pressionando ← ou com /background. O Claude Code pede sua confirmação antes de colocar em segundo plano e, em seguida, interrompe as tarefas que seriam transferidas. Requer Claude Code v2.1.195 ou posterior
CLAUDE_EFFORT Definida automaticamente em subprocessos da ferramenta Bash e em comandos de hook com o nível de esforço em vigor quando o subprocesso é iniciado: low, medium, high, xhigh ou max. Corresponde ao campo effort.level passado para os hooks. Definida apenas quando o modelo atual oferece suporte ao parâmetro de esforço
CLAUDE_ENABLE_BYTE_WATCHDOG Defina como 1 para forçar a ativação do watchdog de inatividade de streaming em nível de byte, ou como 0 para forçar sua desativação. 0 também desativa o prazo do primeiro byte nas conexões em que esse prazo é executado. Quando não definida, o watchdog é ativado por padrão para conexões diretas com a API da Anthropic e com o Claude Platform on AWS, e para respostas de streaming em conexões de gateway alcançadas por meio de ANTHROPIC_BASE_URL ou ANTHROPIC_AWS_BASE_URL; antes da v2.1.222 ele não era executado nessas conexões de gateway, então o watchdog em nível de evento podia relatar um travamento ali mesmo enquanto pings de keep-alive estavam chegando. Para timeouts e como os temporizadores interagem, consulte Watchdogs de inatividade de streaming
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Defina como 1 para ativar o watchdog de inatividade de streaming em nível de byte nas respostas vnd.amazon.eventstream do Amazon Bedrock, o que também ativa o prazo do primeiro byte nas requisições de streaming do Bedrock. Desativado por padrão. Configure o timeout com CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENABLE_STREAM_WATCHDOG Defina como 0 para forçar a desativação do watchdog de inatividade de streaming em nível de evento, ou como 1 para forçar sua ativação. Quando não definida, o watchdog fica ativado por padrão para todos os provedores. Antes da v2.1.196, o padrão sem definição era controlado pelo servidor na API direta da Anthropic e desativado nos outros provedores. Configure o timeout com CLAUDE_STREAM_IDLE_TIMEOUT_MS; para os outros temporizadores de travamento que são executados junto com este, consulte Watchdogs de inatividade de streaming
CLAUDE_ENV_FILE Caminho para um script de shell cujo conteúdo o Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que as exportações no arquivo fiquem visíveis para o comando. Use para manter a ativação de virtualenv ou conda entre comandos. Também é preenchida dinamicamente pelos hooks SessionStart, Setup, CwdChanged e FileChanged
CLAUDE_JOB_DIR Definida pelo Claude Code em cada sessão em segundo plano com o diretório ~/.claude/jobs/<id> dessa sessão. Os comandos de shell que a sessão executa a herdam. Grave arquivos temporários em $CLAUDE_JOB_DIR/tmp. As chamadas Write e Edit do Claude nesse local não pedem permissão, e o diretório é removido quando a sessão é excluída
CLAUDE_PID O Claude Code define esta variável com o ID do seu próprio processo nos subprocessos que ele cria: comandos das ferramentas Bash e PowerShell e comandos de hook. No Linux, a integração de shell da ferramenta Bash a usa para recusar um padrão de pkill que corresponderia ao próprio processo do Claude Code; consulte a referência de erros. Leia-a nos seus próprios scripts para identificar ou sinalizar deliberadamente o processo pai do Claude Code. Requer Claude Code v2.1.214 ou posterior
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX Prefixo para nomes de sessão do Remote Control gerados automaticamente quando nenhum nome explícito é fornecido. O padrão é o hostname da sua máquina, produzindo nomes como myhost-graceful-unicorn. A flag de CLI --remote-control-session-name-prefix define o mesmo valor para uma única invocação
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS Prazo, em milissegundos, para o primeiro byte de resposta de uma requisição de streaming, nas conexões em que o prazo do primeiro byte é executado. Para saber como o Claude Code limita esse valor, o tempo extra que ele adiciona para corpos de requisição grandes e como ele escolhe o prazo quando você deixa esta variável sem definição, consulte Nenhuma resposta da API. Requer Claude Code v2.1.242 ou posterior
CLAUDE_STREAM_IDLE_TIMEOUT_MS Timeout em milissegundos antes que os watchdogs de inatividade de streaming em nível de evento e de byte fechem uma conexão travada. Quando você define esta variável explicitamente, o mínimo é 300000 (5 minutos); valores menores são ajustados silenciosamente para absorver pausas de pensamento estendido e buffering de proxy, e o watchdog em nível de byte limita o valor a 30 minutos. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS tem precedência sobre esta variável para o watchdog em nível de byte. Para os padrões sem definição de cada watchdog, consulte Watchdogs de inatividade de streaming
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS Removida na v2.1.260 e agora sem efeito. Anteriormente limitava, em milissegundos, por quanto tempo um comando de shell em segundo plano iniciado por um subagente podia ser executado, com padrão de 60 minutos. Consulte as regras de tempo de vida de comandos em segundo plano
DEBUG Defina como 1 para ativar o modo de depuração, equivalente a iniciar com --debug. Os logs de depuração são gravados em ~/.claude/debug/<session-id>.txt ou no caminho definido por CLAUDE_CODE_DEBUG_LOGS_DIR. Somente os valores verdadeiros 1, true, yes e on ativam o modo de depuração, então padrões de namespace como DEBUG=express:* definidos para outras ferramentas não o acionam
DISABLE_AUTOUPDATER Defina como 1 para desativar as atualizações automáticas em segundo plano. O claude update manual continua funcionando. Use DISABLE_UPDATES para bloquear ambos
DISABLE_AUTO_COMPACT Defina como 1 para desativar a compactação automática ao se aproximar do limite de contexto. O comando manual /compact continua disponível. Use quando quiser controle explícito sobre quando a compactação ocorre. Sobrescreve a configuração autoCompactEnabled
DISABLE_COMPACT Defina como 1 para desativar toda a compactação: tanto a compactação automática quanto o comando manual /compact
DISABLE_COST_WARNINGS Defina como 1 para desativar as mensagens de aviso de custo
DISABLE_DOCTOR_COMMAND Defina como 1 para ocultar a skill de verificação de configuração /doctor e seu alias /checkup. Útil para implantações gerenciadas em que os usuários não devem executar diagnósticos de configuração a partir de uma sessão. Não afeta o comando de terminal claude doctor. Antes da v2.1.205, esta variável ocultava o comando da tela de diagnóstico /doctor
DISABLE_ERROR_REPORTING Defina com qualquer valor não vazio, como 1, para desativar o relatório de erros. Defini-la como 0 ou false ainda desativa, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para reativar o relatório de erros
DISABLE_EXTRA_USAGE_COMMAND Defina como 1 para ocultar o comando /usage-credits, que permite aos usuários comprar uso adicional além dos rate limits
DISABLE_FEEDBACK_COMMAND Defina como 1 para desativar o comando /feedback e o feedback redigido pelo Claude. Também desativa /bug e /share, que enviam relatórios pelo mesmo caminho; antes da v2.1.212 eles eram aliases de /feedback, então o comando era desativado com todos os nomes. O nome antigo DISABLE_BUG_COMMAND também é aceito
DISABLE_GROWTHBOOK Defina como 1 ou true para desativar a busca de feature flags do GrowthBook e usar os padrões do código para todas as flags. Isso torna indisponíveis o Remote Control e os outros recursos que precisam da busca de feature flags. Defini-la como 0 ou false mantém a busca ativada. O registro de eventos de telemetria permanece ativado, a menos que DISABLE_TELEMETRY também esteja definida
DISABLE_INSTALLATION_CHECKS Defina como 1 para desativar os 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_COMMAND Defina como 1 para ocultar o comando /install-github-app. Já fica oculto ao usar provedores de terceiros (Amazon Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry)
DISABLE_INTERLEAVED_THINKING Defina como 1 para impedir o envio do cabeçalho beta de interleaved-thinking. Útil quando seu gateway de LLM ou provedor não oferece suporte ao pensamento intercalado
DISABLE_LOGIN_COMMAND Defina como 1 para ocultar o comando /login. Útil quando a autenticação é tratada externamente por meio de chaves de API ou apiKeyHelper
DISABLE_LOGOUT_COMMAND Defina como 1 para ocultar o comando /logout
DISABLE_PROMPT_CACHING Defina como 1 para desativar o cache de prompt para todos os modelos (tem precedência sobre as configurações por modelo)
DISABLE_PROMPT_CACHING_FABLE Defina como 1 para desativar o cache de prompt para os modelos Fable
DISABLE_PROMPT_CACHING_HAIKU Defina como 1 para desativar o cache de prompt para o modelo Haiku padrão, onde quer que ele seja executado
DISABLE_PROMPT_CACHING_OPUS Defina como 1 para desativar o cache de prompt para o modelo Opus padrão
DISABLE_PROMPT_CACHING_SONNET Defina como 1 para desativar o cache de prompt para o modelo Sonnet padrão
DISABLE_TELEMETRY Defina com qualquer valor não vazio, como 1, para desativar a telemetria. Defini-la como 0 ou false ainda desativa, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para reativar a telemetria. Os eventos de telemetria não incluem dados do usuário como código, caminhos de arquivo ou comandos Bash. Também desativa a busca de feature flags. Consulte Desativar a telemetria para sua organização
DISABLE_UPDATES Defina como 1 para bloquear todas as atualizações, incluindo claude update e claude install manuais. Mais rigorosa que DISABLE_AUTOUPDATER. Use ao distribuir o Claude Code pelos seus próprios canais quando os usuários não devem se autoatualizar
DISABLE_UPGRADE_COMMAND Defina como 1 para ocultar o comando /upgrade
DO_NOT_TRACK Defina como 1 para desativar a telemetria, com o mesmo efeito de DISABLE_TELEMETRY, inclusive sobre a busca de feature flags. O Claude Code lê esta variável como um booleano padrão, então 0 mantém a telemetria ativada, e a respeita como a convenção entre ferramentas reconhecida por muitas CLIs de desenvolvedor
ENABLE_BETA_TRACING_DETAILED Defina como 1, junto com BETA_TRACING_ENDPOINT, para ativar o tracing beta detalhado, que adiciona atributos de span com conteúdo e o span claude_code.hook. Sessões interativas da CLI também exigem que sua organização esteja na lista de permissões do beta. Ambas as variáveis são ignoradas nas configurações de projeto e locais
ENABLE_CLAUDEAI_MCP_SERVERS Defina como false para impedir que o Claude Code busque servidores MCP do claude.ai. Ativada por padrão para usuários que fizeram login. Para desativar por projeto ou por organização, defina disableClaudeAiConnectors nas configurações
ENABLE_PROMPT_CACHING_1H Defina como 1 para solicitar um TTL de cache de prompt de 1 hora em vez dos 5 minutos padrão. Destinada a usuários de chave de API, Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry e Claude Platform on AWS. Usuários de assinatura dentro do uso incluído recebem o TTL de 1 hora automaticamente na conversa principal. Usuários de assinatura que consomem créditos de uso podem defini-la para manter o TTL de 1 hora. Gravações de cache de 1 hora são cobradas a uma taxa mais alta. Para escolher o TTL por grupo de requisições, use CLAUDE_CODE_PROMPT_CACHE_TTL e CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, que têm precedência sobre esta variável
ENABLE_PROMPT_CACHING_1H_BEDROCK Descontinuada. Use ENABLE_PROMPT_CACHING_1H em vez disso
ENABLE_TOOL_SEARCH Controla o MCP Tool Search. Sem definição, o Claude Code adia todas as ferramentas MCP por padrão. Ele ainda as carrega antecipadamente em modelos da Agent Platform do Google Cloud anteriores à geração Claude 4.5, em uma implantação do Microsoft Foundry hospedada no Azure e quando ANTHROPIC_BASE_URL aponta para um host que não é first-party. true sempre adia e envia o cabeçalho beta, exceto nesses mesmos modelos da Agent Platform e implantações do Microsoft Foundry; as requisições falham em proxies que não oferecem suporte a tool_reference. auto carrega antecipadamente quando as definições de ferramentas cabem em 10% do contexto. auto:N define um limite personalizado, como auto:5 para 5%. false carrega todas as ferramentas antecipadamente. Um valor que você mesmo define é ignorado quando CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS está definida. Antes da v2.1.221, o Claude Code desativava o tool search para todos os modelos na Agent Platform do Google Cloud, a menos que você definisse esta variável como true
FALLBACK_FOR_ALL_PRIMARY_MODELS Defina com qualquer valor não vazio, como 1, para fazer o Claude Code parar de tentar novamente após erros de sobrecarga repetidos para todos os modelos quando nenhum modelo de fallback estiver configurado. Defini-la como 0 ou false ainda ativa esse comportamento, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para restaurar o comportamento padrão de novas tentativas. Sem ela, o Claude Code para de tentar novamente dessa forma em modelos que reconhece como Opus, Fable ou Mythos quando você se autentica com uma chave de API ou um provedor de terceiros em vez de uma assinatura do Claude. No Claude Code v2.1.160 ou posterior, o Claude Code muda para a sua cadeia de modelos de fallback configurada após erros de sobrecarga repetidos para qualquer modelo principal, então esta variável não afeta a mudança para um modelo de fallback
FORCE_AUTOUPDATE_PLUGINS Defina como 1 para forçar as atualizações automáticas de plugins mesmo quando o atualizador automático principal estiver desativado via DISABLE_AUTOUPDATER
FORCE_HYPERLINK Defina como 1 para ativar hyperlinks OSC 8 clicáveis quando seu terminal os suporta, mas não é detectado automaticamente, ou como 0 para desativá-los. Quando não definida, o Claude Code ativa hyperlinks apenas quando detecta suporte do terminal. O Claude Code interpreta este valor como um número, não um booleano, então um valor como false, no ou off ativa os hyperlinks em vez de desativá-los. O badge de PR ou merge request do rodapé é renderizado como hyperlink mesmo quando o Claude Code não consegue detectar suporte do terminal, como via SSH. Defina 0 para renderizar o badge como texto simples
FORCE_PROMPT_CACHING_5M Defina como 1 para forçar o TTL de cache de prompt de 5 minutos mesmo quando o TTL de 1 hora se aplicaria. Sobrescreve CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H e as configurações promptCacheTtl e subagentPromptCacheTtl
HTTP_PROXY Especifica o servidor proxy HTTP para conexões de rede
HTTPS_PROXY Especifica o servidor proxy HTTPS para conexões de rede
IS_DEMO Defina com qualquer valor não vazio, como 1, para ativar o modo de demonstração: oculta seu e-mail e o nome da organização do cabeçalho e da saída de /status, e pula o onboarding. Defini-la como 0 ou false ainda ativa o modo de demonstração, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para desativá-lo. Útil ao transmitir ou gravar uma sessão
MAX_MCP_OUTPUT_TOKENS Número máximo de tokens permitidos nas respostas de ferramentas MCP. O Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram anthropic/maxResultSizeChars usam esse limite de caracteres para o conteúdo de texto, mas o conteúdo de imagem dessas ferramentas continua sujeito a esta variável (padrão: 25000)
MAX_STRUCTURED_OUTPUT_RETRIES Número de tentativas que o Claude Code permite quando a resposta do modelo falha na validação contra o --json-schema no modo não interativo com a flag -p; após essa quantidade de tentativas com falha sem saída válida, a execução falha. O mesmo limite se aplica quando a saída estruturada de um subagente de workflow falha na validação. O padrão é 5, uma primeira tentativa mais quatro novas tentativas
MAX_THINKING_TOKENS Orçamento fixo de tokens para o pensamento estendido. O Claude Code o limita a um token abaixo do máximo de tokens de saída da requisição e nunca abaixo de 1.024. Consulte CLAUDE_CODE_MAX_OUTPUT_TOKENS para saber como esse limite é definido. Quando não definida e o pensamento está ativado, os modelos com raciocínio adaptativo escolhem a própria profundidade de pensamento, e os outros modelos usam o limite. Defina como 0 para desativar o pensamento na API da Anthropic, exceto no Opus 5.5, no Sonnet 5.5 e nos modelos Fable, que não permitem desativar o pensamento. Em provedores de terceiros, 0 omite o parâmetro thinking. Com o pensamento desativado na API da Anthropic, o Claude Code envia o esforço high em vez de um nível mais alto para modelos que ele sabe que não aceitam essa combinação, como o Opus 5. O Claude Code ignora valores diferentes de zero em modelos de raciocínio adaptativo, exceto nos modelos em que CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING desativa o raciocínio adaptativo
MCP_CLIENT_SECRET Client secret OAuth para servidores MCP que exigem credenciais pré-configuradas. Evita o prompt interativo ao adicionar um servidor com --client-secret
MCP_CONNECTION_NONBLOCKING Controla se a inicialização espera que os servidores MCP se conectem antes da primeira consulta. A inicialização do MCP não é bloqueante por padrão: os servidores se conectam em segundo plano e suas ferramentas ficam disponíveis à medida que terminam. Defina como 0 para fazer o Claude Code esperar que os servidores se conectem antes da primeira consulta. Servidores configurados com alwaysLoad: true ainda fazem a inicialização esperar de qualquer forma, exceto quando servidos a partir do cache de descoberta, pois suas ferramentas precisam estar presentes quando o primeiro prompt é montado. No modo não interativo (-p) sem --input-format stream-json, o Claude Code também espera pelos servidores ainda pendentes antes do primeiro turno, independentemente desta variável. Quando você passa --mcp-config explicitamente, a espera tem um prazo maior; consulte a entrada dessa flag para a exceção de servidores em cache
MCP_CONNECT_TIMEOUT_MS Quanto tempo, em milissegundos, a inicialização bloqueante do MCP espera pelo lote de conexões antes de capturar a lista de ferramentas (padrão: 5000). Aplica-se quando MCP_CONNECTION_NONBLOCKING=0 ou para servidores marcados com alwaysLoad: true. Servidores ainda pendentes no prazo continuam se conectando em segundo plano. Diferente de MCP_TIMEOUT, que limita a tentativa de conexão de um servidor individual
MCP_DISCOVERY_CACHE Ativa ou desativa o cache de descoberta do MCP. Com o cache ativado, um servidor HTTP ou SSE remoto que você já usou pode exibir o status cached, e o Claude Code o conecta na primeira chamada de ferramenta em vez de na inicialização. O cache fica desativado por padrão, a menos que uma implantação gradual o tenha ativado para sua conta. Defina como 1 para ativá-lo, ou 0 para mantê-lo desativado mesmo quando a implantação gradual o tiver ativado. Antes da v2.1.238, o cache ficava ativado por padrão. O status cached requer Claude Code v2.1.221 ou posterior
MCP_DISCOVERY_CACHE_MAX_STALE_S Idade máxima, em segundos, de uma entrada do cache de descoberta (padrão: 14400, ou 4 horas). Em uma inicialização em que a entrada é mais antiga que isso, o Claude Code a descarta e conecta o servidor na inicialização, como faz com o cache desativado. O Claude Code limita o valor a 7 dias. Antes da v2.1.238, o padrão era 86400, ou 24 horas, e o Claude Code não limitava o valor
MCP_DISCOVERY_CACHE_STRIKES Em uma inicialização em que uma entrada do cache de descoberta é mais antiga que MCP_DISCOVERY_CACHE_TTL_S, o Claude Code a atualiza em segundo plano. Esta variável define quantas atualizações seguidas podem falhar antes que o Claude Code descarte a entrada e conecte o servidor na próxima inicialização (padrão: 1). Aumente-a se sua conexão de rede cair ocasionalmente, para que uma única atualização com falha não descarte a entrada. Requer Claude Code v2.1.238 ou posterior
MCP_DISCOVERY_CACHE_TTL_S Segundos durante os quais o Claude Code usa uma entrada do cache de descoberta sem atualizá-la (padrão: 900). Em uma inicialização em que a entrada é mais antiga que isso, o Claude Code ainda a usa, mas a atualiza em segundo plano. Quando a entrada fica mais antiga que MCP_DISCOVERY_CACHE_MAX_STALE_S, o Claude Code a descarta. O Claude Code limita o valor a MCP_DISCOVERY_CACHE_MAX_STALE_S, que é 4 horas por padrão. Antes da v2.1.238, o Claude Code não limitava o valor
MCP_OAUTH_CALLBACK_PORT Porta fixa para o callback de redirecionamento OAuth, como alternativa a --callback-port ao adicionar um servidor MCP com credenciais pré-configuradas
MCP_PROTOCOL_NEGOTIATION Somente no runtime de cliente MCP v2, define se o Claude Code sonda os servidores em busca da revisão de protocolo MCP 2026-07-28. Defina auto para sondar servidores HTTP, de conectores do claude.ai e stdio; um servidor que não responde à sondagem se conecta pelo protocolo anterior, como os servidores SSE e WebSocket sempre fazem. Defina legacy para pular a sondagem para todos os servidores. Sem a variável, o Claude Code sonda servidores HTTP e também sonda servidores de conectores do claude.ai em sessões em que busca feature flags. Qualquer outro valor é ignorado com um aviso no log de depuração. Requer Claude Code v2.1.221 ou posterior
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE Número máximo de servidores MCP remotos (HTTP/SSE) a conectar em paralelo durante a inicialização (padrão: 20)
MCP_SDK_GENERATION Fixa qual runtime de cliente MCP este processo usa para se conectar aos servidores MCP: v1, construído sobre o MCP TypeScript SDK 1.x, ou v2, construído sobre o MCP TypeScript SDK 2.0. Sem a variável, o Claude Code usa o v2, a partir das versões listadas nessa seção. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor OAuth do MCP retorna em sua resposta de autorização e faz o login falhar com um erro que começa com Issuer mismatch in authorization response quando ele não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, o Claude Code o ignora e grava um aviso no log de depuração. O Claude Code lê o valor uma vez por processo. Requer Claude Code v2.1.218 ou posterior
MCP_SERVER_CONNECTION_BATCH_SIZE Número máximo de servidores MCP locais (stdio) a conectar em paralelo durante a inicialização (padrão: 3)
MCP_TIMEOUT Timeout em milissegundos para a inicialização do servidor MCP (padrão: 30000, ou 30 segundos)
MCP_TOOL_TIMEOUT Timeout em milissegundos para a execução de ferramentas MCP (padrão: 100000000, cerca de 28 horas). Para um servidor HTTP, SSE ou de conector do claude.ai, cada requisição também atinge o timeout após 60 segundos por padrão; defina esta variável, ou o timeout por servidor, acima de 60000 para aumentar esse limite por requisição. Um valor menor ainda encurta o timeout geral de execução da ferramenta, mas mantém o limite por requisição em 60 segundos. Servidores stdio e WebSocket não têm temporizador por requisição. Um campo timeout por servidor em .mcp.json sobrescreve este valor para esse servidor. Um timeout por servidor de pelo menos 1000 também define a janela mínima de inatividade para as chamadas de ferramenta desse servidor, para que CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT nunca as aborte antes; esse piso requer Claude Code v2.1.203 ou posterior. Para a variável de ambiente, valores abaixo de 1000 são arredondados para um segundo; para o campo por servidor, valores abaixo de 1000 são ignorados
NO_PROXY Lista de domínios e IPs para os quais as requisições serão enviadas diretamente, ignorando o proxy
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT Limite padrão do SDK do OpenTelemetry para o comprimento de valores de atributos. O Claude Code limita os atributos de telemetria com conteúdo ao menor valor entre este e CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, para que o marcador de truncamento fique dentro do limite do SDK. O Claude Code lê as variantes OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT e OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT da mesma forma, e o menor valor definido se aplica a todos os sinais. Requer Claude Code v2.1.214 ou posterior. Consulte Monitoramento
OTEL_LOG_ASSISTANT_RESPONSES Defina como 1 para incluir o texto de resposta do modelo nos eventos de log do OpenTelemetry assistant_response. Quando não definida, o Claude Code usa o valor de OTEL_LOG_USER_PROMPTS. Defina como 0 para manter as respostas ocultadas mesmo quando OTEL_LOG_USER_PROMPTS estiver definida. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais. Requer Claude Code v2.1.193 ou posterior. Consulte Monitoramento
OTEL_LOG_MANAGED_SETTINGS Defina como 1 para adicionar as configurações gerenciadas com dados ocultados, e um digest SHA-256 das configurações antes da ocultação, aos eventos de log do OpenTelemetry managed_settings_resolved. Desativada por padrão. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas; um valor nas configurações de projeto ou locais não a ativa. Requer Claude Code v2.1.274 ou posterior. Consulte Monitoramento
OTEL_LOG_RAW_API_BODIES Emite o JSON de requisição e resposta da Messages API da Anthropic como eventos de log api_request_body / api_response_body. Defina como 1 para corpos inline truncados no limite de conteúdo, ou file:<dir> para gravar corpos não truncados em disco e emitir um caminho body_ref. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configura o limite de conteúdo, 60 KB por padrão. Desativada por padrão; os corpos incluem todo o histórico da conversa. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais. Consulte Monitoramento
OTEL_LOG_TOOL_CONTENT Defina como 1 para incluir o conteúdo da ferramenta no evento de span do OpenTelemetry tool.output. Os atributos de span carregam o conteúdo da ferramenta sob suas próprias condições. Requer tracing. Desativada por padrão para proteger dados sensíveis. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais, exceto pelos valores de desativação descritos nessa seção. Consulte Monitoramento
OTEL_LOG_TOOL_DETAILS Defina como 1 para incluir argumentos de entrada de ferramentas; nomes de servidores MCP; nomes de workflows criados pelo usuário; strings de erro brutas em falhas de ferramentas; a category de recusa nos eventos api_refusal; nomes reais de agentes, skills, plugins e servidores MCP nas métricas de custo e tokens; e outros detalhes de ferramentas em métricas, traces e logs do OpenTelemetry. Desativada por padrão para proteger PII. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais, exceto pelos valores de desativação descritos nessa seção. Consulte Monitoramento
OTEL_LOG_USER_PROMPTS Defina como 1 para incluir o texto do prompt do usuário em traces e logs do OpenTelemetry. Desativada por padrão (os prompts são ocultados). Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas configurações de projeto e locais, exceto pelos valores de desativação descritos nessa seção. Consulte Monitoramento
OTEL_METRICS_INCLUDE_ACCOUNT_UUID Defina como false para excluir o UUID da conta dos atributos de métricas (padrão: incluído). Consulte Monitoramento
OTEL_METRICS_INCLUDE_ENTRYPOINT Defina como true para incluir o ponto de entrada da sessão nos atributos de métricas (padrão: excluído). Adicionada na v2.1.152. Consulte Monitoramento
OTEL_METRICS_INCLUDE_REPOSITORY Defina como true para marcar as métricas e eventos do OpenTelemetry com atributos vcs.* que identificam o repositório da sessão (padrão: excluído). Requer Claude Code v2.1.269 ou posterior. Consulte Atributos de repositório
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES A partir da v2.1.161, o Claude Code anexa as chaves de OTEL_RESOURCE_ATTRIBUTES aos rótulos dos pontos de dados de métricas. Defina como false para excluí-las (padrão: incluídas). Consulte Monitoramento
OTEL_METRICS_INCLUDE_SESSION_ID Defina como false para excluir o ID da sessão dos atributos de métricas (padrão: incluído). Consulte Monitoramento
OTEL_METRICS_INCLUDE_VERSION Defina como true para incluir a versão do Claude Code nos atributos de métricas (padrão: excluída). Consulte Monitoramento
SLASH_COMMAND_TOOL_CHAR_BUDGET Sobrescreve o orçamento de caracteres para os metadados de skills exibidos à ferramenta Skill. O orçamento escala dinamicamente em 1% da janela de contexto, com fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores
TASK_MAX_OUTPUT_LENGTH Removida na v2.1.277 e agora sem efeito, junto com a ferramenta TaskOutput cujo tamanho ela definia. Anteriormente definia o número máximo de caracteres da saída de uma tarefa em segundo plano que a ferramenta TaskOutput mantinha. O Claude agora lê o arquivo de saída de uma tarefa em segundo plano com Read
USE_BUILTIN_RIPGREP Defina como 0 para usar o rg instalado no sistema em vez do rg incluído no Claude Code
VERTEX_REGION_CLAUDE_3_5_HAIKU Sobrescreve a região do Claude 3.5 Haiku ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_3_5_SONNET Sobrescreve a região do Claude 3.5 Sonnet ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_3_7_SONNET Sobrescreve a região do Claude 3.7 Sonnet ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_0_OPUS Sobrescreve a região do Claude 4.0 Opus ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_0_SONNET Sobrescreve a região do Claude 4.0 Sonnet ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_1_OPUS Sobrescreve a região do Claude 4.1 Opus ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_5_OPUS Sobrescreve a região do Claude Opus 4.5 ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_5_SONNET Sobrescreve a região do Claude Sonnet 4.5 ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_6_OPUS Sobrescreve a região do Claude Opus 4.6 ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_6_SONNET Sobrescreve a região do Claude Sonnet 4.6 ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_7_OPUS Sobrescreve a região do Claude Opus 4.7 ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_4_8_OPUS Sobrescreve a região do Claude Opus 4.8 ao usar a Agent Platform do Google Cloud
VERTEX_REGION_CLAUDE_5_5_OPUS Sobrescreve a região do Claude Opus 5.5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Sobrescreve a região do Claude Sonnet 5.5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Sobrescreve a região do Claude Opus 5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Sobrescreve a região do Claude Sonnet 5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Sobrescreve a região do Claude Fable 5 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Sobrescreve a região do Claude Fable 5.1 ao usar a Agent Platform do Google Cloud. Adicionada na v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Sobrescreve a região do Claude Haiku 4.5 ao usar a Agent Platform do Google Cloud

As variáveis padrão de exportador do 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. Consulte Monitoramento para detalhes de configuração.

Defina CLAUDE_CODE_ENABLE_TELEMETRY e as variáveis do OpenTelemetry que ativam a exportação, escolhem seu destino ou capturam conteúdo no seu shell, nas configurações de usuário ou nas configurações gerenciadas. O Claude Code as ignora nas configurações de projeto e locais, exceto pelos valores de desativação descritos nessa seção. OTEL_RESOURCE_ATTRIBUTES e as variáveis de intervalo de exportação, timeout e compressão, como OTEL_METRIC_EXPORT_INTERVAL, continuam se aplicando a partir das configurações de projeto e locais.

Recursos que precisam de busca de feature-flag

Claude Code ativa alguns recursos através de feature flags que busca da Anthropic. Claude Code pula essa busca nestas sessões:

  • Uma sessão onde você define DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK, ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; a linha de cada variável na tabela de variáveis diz quais valores desativam a busca
  • Uma sessão em um provedor de terceiros, como Amazon Bedrock, Claude Platform na AWS, Agent Platform do Google Cloud, ou Microsoft Foundry, a menos que uma plataforma host que incorpora Claude Code defina CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • Uma sessão de gateway de aplicativos Claude

Com a busca desativada, você não pode:

Primeira sessão após uma instalação ou atualização

Na sua primeira sessão após instalar Claude Code, ou atualizar para uma versão que adiciona um recurso, um recurso com gate de flag pode estar faltando. Essa sessão também pode iniciar em um modo de permissão diferente daquele em que suas sessões posteriores iniciam. Claude Code busca as flags durante essa sessão, então sua próxima sessão tem o recurso e o modo de permissão inicial usual.

Após uma instalação limpa, em uma sessão não interativa como claude -p, o Agent SDK, ou a extensão VS Code, Claude Code ainda pode pegar as flags antes de escolher o modo de permissão inicial.

Veja também