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 em seu shell ou em um arquivo de configurações
Verificar qual valor se aplica quando um comportamento pode ser definido de mais de uma forma
Procurar as variáveis que Claude Code lê
Ver quais recursos deixam de funcionar quando uma variável desativa a busca de sinalizadores de recursos

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.

$env:API_TIMEOUT_MS = "1200000"
claude

Para defini-la para cada sessão, execute [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") e abra um novo terminal.

set API_TIMEOUT_MS=1200000
claude

Para defini-la para cada sessão, execute setx API_TIMEOUT_MS "1200000" e abra um novo terminal.

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

echo $env:API_TIMEOUT_MS

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`). O Claude Code recusa uma URL ou nome de host. Obrigatório se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definido (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 em sessões não supervisionadas. O limite de tempo em segundo plano requer o 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 em sessões não supervisionadas. O limite de tempo em segundo plano requer o 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` de pré-lançamento, os campos do corpo associados a eles e os campos beta de schema de ferramentas, como `defer_loading` e `eager_input_streaming`. Use isto quando um gateway de proxy rejeitar requisições com um erro `Unexpected value(s)` para o cabeçalho `anthropic-beta` ou um erro `Extra inputs are not permitted`. Desativar recursos de pré-lançamento lista o que a variável remove, incluindo o MCP Tool Search, e o que o Claude Code continua enviando
`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_STRUCTURED_OUTPUTS`	Defina como `1` para impedir que o Claude Code envie o campo de saída estruturada `output_config.format` e o valor `anthropic-beta` associado a ele, para um gateway de LLM cujo upstream os rejeita. Isso mantém ativados os outros recursos de pré-lançamento que `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` desativa. Requer Claude Code v2.1.288 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:

Executar /auto-mode-setup para rascunhar entradas autoMode.environment
Usar Controle Remoto com CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DISABLE_GROWTHBOOK definido. Para DISABLE_TELEMETRY e DO_NOT_TRACK, consulte os requisitos do Controle Remoto
Enviar mensagens de sessões além desta máquina quando Controle Remoto não estiver disponível. Mensagens entre sessões nesta máquina funcionam com a busca desativada
Executar claude import ou o comando /import
Executar /skill-doctor ou abrir seu relatório na aba Stats do /plugin
Sincronizar as skills e plugins ativados para sua conta claude.ai em suas sessões de terminal
Usar a ferramenta advisor
Ler ou responder a comentários em um artefato
Ter Claude lendo o artefato público de outra organização
Ter Claude Code sondar servidores de conector claude.ai para revisão de protocolo MCP 2026-07-28 a menos que você defina MCP_PROTOCOL_NEGOTIATION=auto
Obter a ferramenta PowerShell por padrão para contas claude.ai e Console no Windows com Git Bash instalado; Claude Code roteia comandos shell através do Git Bash a menos que você defina CLAUDE_CODE_USE_POWERSHELL_TOOL=1. No Windows sem Git Bash, a ferramenta permanece ativada
Obter feedback rascunhado por Claude, que Claude Code ativa através de uma flag buscada
Ter Claude tratar grandes colagens como texto colado em vez de texto digitado; o conteúdo atrás de um espaço reservado [Pasted text #N] chega a Claude sem marcação
Ter Claude Code excluir ferramentas MCP cujo esquema de entrada a API rejeitaria; ele envia o esquema mesmo assim, e uma solicitação que o inclui falha com um erro 400 nomeando a ferramenta por sua posição

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

Configurações: todas as configurações settings.json, incluindo a chave env
Referência CLI: flags de tempo de inicialização
Configuração de rede: configuração de proxy e TLS
Monitoramento: configuração OpenTelemetry

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

Variáveis de ambiente

Definir variáveis de ambiente

No seu shell

Em arquivos de configurações

Precedência

Variáveis

Recursos que precisam de busca de feature-flag

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

Veja também

env-vars.md +1 −0