Variáveis de ambiente - Claude Code Docs

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.

Definir variáveis no seu shell

Defina a variável antes de iniciar claude:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

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:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

Definir variáveis 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.

~/.claude/settings.json

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

Claude Code copia esses valores para o seu ambiente exatamente como escritos. Nenhum shell os processa, então abreviações como ~ ou $HOME permanecem como digitadas. Para uma variável que recebe um caminho, como CLAUDE_CONFIG_DIR, escreva o caminho absoluto: "CLAUDE_CONFIG_DIR": "/home/you/.claude-work". 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 Definir variáveis 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 da variável indicar 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 como 1.

Para variáveis que ativam ou desativam um comportamento, defina 1, true, yes ou on para ativá-lo e 0, false, no ou off para desativá-lo, com qualquer combinação de maiúsculas e minúsculas.Algumas variáveis verificam apenas se você as definiu, de modo que qualquer valor não vazio, incluindo 0, ativa o comportamento, e você desativa o comportamento removendo a variável ou definindo-a com um valor vazio. Estas variáveis funcionam dessa forma:

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
DISABLE_TELEMETRY
DISABLE_ERROR_REPORTING
CLAUDE_CODE_TMUX_TRUECOLOR
FALLBACK_FOR_ALL_PRIMARY_MODELS
IS_DEMO

Uma outra variável tem sua própria regra: FORCE_HYPERLINK lê um número, então apenas 0 a desativa. A linha de cada variável também informa sua própria regra.

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ê esteja logado. No modo não interativo (`-p`), a chave é sempre usada quando presente. No modo interativo, você precisa aprovar a chave uma vez antes que ela sobrescreva sua assinatura. Para usar sua assinatura, execute `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valor personalizado para o cabeçalho `Authorization` (o valor definido aqui receberá o prefixo `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 meio de 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 usada no Amazon Bedrock
`ANTHROPIC_AWS_WORKSPACE_ID`	Obrigatória para o Claude Platform on AWS. Enviada em cada requisição como o cabeçalho `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Sobrescreve o endpoint da API para rotear requisições por meio de um proxy ou gateway. Quando definida com um host que não seja próprio da Anthropic, o MCP Tool Search é 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 é 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 meio de 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 do derivado da região da AWS. Ignorada nas regiões AWS GovCloud. Requer o 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 esta variável 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 nova 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 o Claude Code v2.1.227 ou posterior. Invalid request header value 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 entregue por configurações gerenciadas pelo servidor. A partir de configurações de projeto ou locais, tal valor segue as regras sobre quando os valores de `env` se aplicam
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID do modelo a adicionar como entrada personalizada no seletor de `/model`. Use para tornar selecionável um modelo não padrão ou específico de um 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 de `/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 de `/model`. Quando não definida, a entrada mostra o nome do modelo se o Claude Code reconhecer o ID e, caso contrário, o ID do modelo
`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 de terceiros. Consulte Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Descrição exibida para o modelo Fable fixado no seletor de `/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 de `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. 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 de `/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 de `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. 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 o 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 `opusplan` usa enquanto o Plan Mode está ativo. Consulte Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descrição exibida para o modelo Opus fixado no seletor de `/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 de `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. 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 `opusplan` usa quando o Plan Mode não está ativo. Consulte Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Descrição exibida para o modelo Sonnet fixado no seletor de `/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 de `/model`. Quando não definida, a linha mostra o nome do modelo se o Claude Code reconhecer o ID fixado e, caso contrário, o ID fixado. 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 a Workload Identity Federation. Quando você a define junto com `ANTHROPIC_ORGANIZATION_ID`, o Claude Code seleciona as credenciais de federação, que têm prioridade sobre sua credencial de `/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 o Claude Code v2.1.203 ou posterior
`ANTHROPIC_FOUNDRY_BASE_URL`	URL base completa do 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ória se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definida (consulte Microsoft Foundry)
`ANTHROPIC_MODEL`	Nome da configuração de modelo a usar (consulte Configuração de modelo)
`ANTHROPIC_ORGANIZATION_ID`	ID da organização para a 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, só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou a descontinuada `ANTHROPIC_SMALL_FAST_MODEL` também estiver 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 meio de 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 a workload identity federation. Defina-a quando sua regra de federação abranger mais de um workspace, para que a troca de tokens saiba qual workspace usar
`API_FORCE_IDLE_TIMEOUT`	Sobrescreve o timeout de inatividade do corpo de 5 minutos que aborta uma resposta de modelo por 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 blocos, ou como `1` para mantê-lo ativo em 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 streaming funcionam independentemente dele e abortam uma longa pausa silenciosa 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 meio de um proxy. Valores acima do máximo causam overflow no temporizador 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 da ferramenta Bash ou PowerShell em primeiro plano, em milissegundos (padrão: 120000, ou 2 minutos). Um valor acima do limite de tempo padrão para comandos em segundo plano substitui esse padrão 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 da ferramenta Bash ou PowerShell em primeiro plano, em milissegundos (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre este valor e `BASH_DEFAULT_TIMEOUT_MS`. Um teto efetivo superior a 2 horas também se torna o limite de tempo para comandos em segundo plano máximo 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/HTTP para o tracing beta detalhado: com `ENABLE_BETA_TRACING_DETAILED=1`, logs e traces são enviados para ele em vez dos exportadores configurados. Defina-a no seu shell, nas configurações de usuário ou nas configurações gerenciadas. Ignorada nas 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 do remoto
`CLAUDECODE`	Definida como `1` em subprocessos que o Claude Code inicia (ferramentas Bash e PowerShell, sessões do tmux, comandos de hook, comandos de linha de status, subprocessos de servidor MCP stdio). As 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`
`CLAUDE_AFK_COUNTDOWN_MS`	Quantos milissegundos antes da continuação automática a contagem regressiva aparece na tela em um diálogo `AskUserQuestion` não respondido. Padrão `20000` (20 segundos), limitado ao timeout da 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`. Ignorada nas configurações de projeto e locais. Requer o Claude Code v2.1.198 ou posterior
`CLAUDE_AFK_TIMEOUT_MS`	Quantos milissegundos de inatividade antes que um diálogo `AskUserQuestion` não respondido 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 o diálogo imediatamente. Ignorada nas configurações de projeto e locais. Antes da v2.1.200, a continuação automática ficava ativada por padrão com um timeout de `60000` (60 segundos). Requer o 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`. Tal 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. Também abrange agentes de workflow no Claude Code v2.1.286 ou posterior. 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, conforme descrito em Lidar com respostas de API lentas ou travadas
`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 menores, como `50`, para compactar mais cedo; a variável não pode elevar 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, um subagente passa para o segundo plano após ser executado por aproximadamente dois minutos. Se o Claude enfileirou uma chamada de ferramenta, como uma edição de arquivo, atrás do subagente, o subagente termina em primeiro plano antes que essa chamada comece. 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 o Claude Code v2.1.233 ou posterior
`CLAUDE_AX_SCREEN_READER`	Defina como `1` para renderizar uma saída adequada a leitores de tela: texto simples sem bordas decorativas nem animações. Defina como `0` para forçar a desativação do modo de leitor de tela mesmo quando `axScreenReader` for `true`. A flag `--ax-screen-reader` tem precedência. Requer o Claude Code v2.1.181 ou posterior
`CLAUDE_AX_STARTUP_QUIET_MS`	No modo de leitor de tela, por 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 ler 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). Seu primeiro pressionamento de tecla encerra a retenção antecipadamente. Requer o 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 não altera o watchdog no nível de eventos. O Claude Code restringe esta variável a um valor entre 10 segundos e 30 minutos. Requer o Claude Code v2.1.210 ou posterior
`CLAUDE_CLIENT_PRESENCE_FILE`	Caminho para um arquivo que uma ferramenta externa, como um monitor de bloqueio de tela, cria quando você desbloqueia a tela e exclui quando você a bloqueia. Enquanto o arquivo existir, o Claude Code ignora 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 está ausente ou ilegível, as notificações são enviadas normalmente. O Claude Code verifica o arquivo uma vez por evento que aciona um push, em vez de consultá-lo periodicamente. Requer o 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 se o modo de tela cheia mostrar fragmentos de texto desatualizados ou fora do lugar. O Claude Code ativa isso 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 todas as requisições, 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 com identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo Claude Opus 4.1, Claude Sonnet 4.5, Claude Haiku 4.5 e modelos anteriores, 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 o 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 aos comentários enviados a ele. Requer o Claude Code v2.1.228 ou posterior
`CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS`	Defina como `0` para impedir que o Claude aplique pequenas alterações ao arquivo de um artefato como parte da publicação. O Claude então edita o arquivo com suas ferramentas de edição de arquivos e o publica como uma etapa separada. Requer Claude Code v2.1.300 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 em conexões do Microsoft Foundry; portanto, nessas versões, defina-a como `0` quando o seu gateway de LLM fizer cache com base no corpo da requisição ou encaminhar requisições para um provedor de terceiros, ou quando você se conectar diretamente ao Microsoft Foundry
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	Removida na v2.1.283. Use `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE`
`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 é medido em relação à janela de contexto completa do modelo; portanto, depois que esta variável é definida, essa porcentagem deixa de indicar quando a compactação será executada
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Sobrescreve a conexão automática com o IDE. Por padrão, o Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de um 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 ações do modo auto. Defina como `0` para usar as próprias requisições de classificador do Claude Code. Em uma conexão direta com a API da Anthropic, requer a 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 o Claude Code v2.1.271 ou posterior
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tempo em milissegundos que o Claude Code espera a cadeia padrão de provedores de credenciais da AWS produzir 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 `aws-vault`. Aplica-se no Amazon Bedrock, no Claude Platform on AWS e no endpoint Mantle. Consulte cache de credenciais e timeout de resolução. Requer o 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 como `1` para registrá-lo em todos os modos de permissão. Tem precedência sobre a configuração `bashEditDiffEnabled`. Requer o Claude Code v2.1.269 ou posterior
`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`	Defina como `0` para fazer uma sessão não interativa informar um status ocioso ao seu host ao final de cada turno, mesmo enquanto houver trabalho em segundo plano em execução. Por padrão, a sessão continua informando um status de execução após o final do turno enquanto um trabalho em segundo plano, como um agente em segundo plano ou uma execução de workflow, ainda estiver ativo. Isso impede que um host que monitora 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 o 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 criar um link para a sessão que o executou. Requer o Claude Code v2.1.199 ou posterior. Em sessões na nuvem, leia `CLAUDE_CODE_REMOTE_SESSION_ID`
`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 como `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 apaga 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, de comandos de hook e de comandos de 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 variável é definida apenas pelo próprio Claude Code quando ele inicia um subprocesso, e não por extensões de IDE, de modo que ela distingue de forma confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado ao 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 o 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`	Frase secreta para a CLAUDE_CODE_CLIENT_KEY criptografada (opcional)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Removida na v2.1.186 e agora não tem efeito. Antes, definia um timeout separado para a fase de conexão, TLS e cabeçalhos de resposta de uma requisição de API por streaming. Use `API_TIMEOUT_MS` para o timeout por requisição. Para a fase de cabeçalhos de resposta de uma requisição por 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, é 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 registro em log. 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. O Claude Code remove as variantes de modelo `[1m]` do seletor de modelos e limita a uma janela de 200K os modelos que, por padrão, são executados com a janela de 1M. Consulte Desativar o contexto de 1M. Ú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, no Haiku 5.5 ou 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 administração, 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 o 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, de modo que 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 histórico de rolagem 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 a 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 de definida, nenhum arquivo de configuração reativa a ferramenta. Para desativar a ferramenta a partir de um arquivo de configuração, 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 a arquivos com a sintaxe `@` são enviadas como texto simples em vez de serem expandidas no conteúdo do arquivo. Ignorada nas configurações de projeto e locais
`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`	Defina como `1` para fazer um processo do Claude Code executar ele mesmo o comando `gcpAuthRefresh` ou `awsAuthRefresh`, em vez de esperar enquanto outro processo o executa. Requer o 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 todas as funcionalidades 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 de streaming do Amazon Bedrock com um cabeçalho `Content-Type` ausente ou vazio como o stream de eventos binário do Amazon Bedrock. Por padrão, o Claude Code presume que um gateway removeu o cabeçalho de uma resposta que, de resto, não foi modificada; então ele decodifica o corpo e o streaming continua funcionando. Defina-a 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 o Claude Code v2.1.239 ou posterior
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Defina como `1` para ignorar a verificação de que uma resposta de streaming do Amazon Bedrock tem o content-type `application/vnd.amazon.eventstream`. Sem esta variável, quando uma resposta tem 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 o 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, os workflows dinâmicos e, a partir da v2.1.198, os subagentes em segundo plano de uma sessão 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` continua transferindo o trabalho em segundo plano 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 RAM 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 nele. Requer o 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: as skills incluídas e os workflows incluídos são removidos por completo, enquanto comandos integrados como `/init` continuam podendo ser digitados, mas ficam ocultos do modelo. `/doctor` continua podendo ser digitado como os comandos integrados; oculte-o com `DISABLE_DOCTOR_COMMAND`. Skills de plugins, de `.claude/skills/` e de `.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 enquanto omite a seção do Chrome do system prompt e a skill incluída `/claude-in-chrome`. Destinada a hosts que incorporam o Claude Code e fornecem suas próprias orientações de navegador. Requer o 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 de cron ficam indisponíveis, e quaisquer tarefas já agendadas deixam de ser disparadas, 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 então 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 o Claude Code v2.1.281 ou posterior
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Defina como `1` para remover os cabeçalhos de requisição `anthropic-beta` de pré-lançamento, os campos do corpo associados a eles e os campos beta de esquema de ferramentas, como `defer_loading` e `eager_input_streaming`, das requisições de API. Use quando um gateway 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 explora com suas ferramentas de busca ou com o subagente general-purpose, 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`. Requer o 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 ficam 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 desativar 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 poderá restaurar alterações de código. Sobrescreve a configuração `fileCheckpointingEnabled`
`CLAUDE_CODE_DISABLE_FILE_MENTIONS`	Defina como `1` para impedir que o Claude Code expanda menções com `@` de arquivos e diretórios. Em vez disso, o Claude recebe os caminhos mencionados com uma observação para lê-los usando suas ferramentas de arquivo. Ignorada em configurações de projeto e locais. Requer Claude Code v2.1.299 ou posterior
`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 git status. Ú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_INLINE_SHELL_RM_PROMPT`	Defina como `1` para impedir que o Claude Code leia scripts passados a um shell com `-c`, como `bash -c 'rm -rf ~'`, em busca de remoções de caminhos críticos. O Claude Code ainda verifica os destinos de variáveis de shell e parâmetros posicionais nesses scripts, e as outras verificações de caminhos críticos continuam sendo executadas. 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 o Claude Code v2.1.288 ou posterior
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Defina como `1` para impedir o remapeamento automático do Opus 4 e do Opus 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 dela; 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 o 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 pelo teclado com `PgUp` e `PgDn` continua funcionando. Use para manter o comportamento nativo do seu terminal de copiar ao selecionar
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Defina como `1` para desativar o tratamento de cliques, arrastos e passagem do mouse na renderização em tela cheia, mantendo a rolagem com a roda do mouse. Use quando quiser que a rolagem com a roda funcione dentro do Claude Code, mas não quiser que os 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 o 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 do cliente mTLS quando uma requisição de API falha com um erro no nível da 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 as configurações ou na próxima inicialização. Requer o 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 selo de status de PR e MR e verificações de disponibilidade, como a 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 podem acionar instalações de dependências. Defini-la como `0` ou `false` ainda desativa esse tráfego, diferentemente da maioria das variáveis de ativação/desativação; remova a variável para permiti-lo novamente. Também desativa a busca de feature flags, o que torna indisponíveis o Remote Control e os outros recursos que precisam da busca de feature flags. 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
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Defina como `1` para desativar o fallback sem streaming quando uma requisição por streaming falha no meio do stream. Os erros de streaming são propagados para a camada de retry. Útil quando um proxy ou gateway faz o fallback produzir 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ê estiver digitando no terminal ou com ele em foco. Por padrão, a ferramenta ignora tanto a notificação de desktop quanto o push móvel quando detecta atividade recente de 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 detectar que você está ativo. Requer o 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 ignora o registro permanentemente. Remover a variável posteriormente 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 o Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Defina como `1` para ignorar o carregamento de skills do diretório de skills gerenciadas de todo o sistema. Útil para sessões em contêineres ou de 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 integrados 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 o Claude Code v2.1.283 ou posterior
`CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK`	Defina como `1` para desativar a troca automática de modelo quando um classificador de segurança sinaliza uma requisição, o comportamento que a configuração `switchModelsOnFlag` controla
`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 de `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 o Claude Code v2.1.288 ou posterior
`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`	Defina como `1` para desativar a verificação de caminhos críticos para um `rm` recursivo cujo destino é inteiramente a saída de uma substituição de comando, como `rm -rf "$(pwd)"`. As outras verificações de caminhos críticos continuam sendo executadas. 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 o 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 e desativa os relatórios de status para o seu terminal
`CLAUDE_CODE_DISABLE_THINKING`	Defina como `1` para omitir completamente 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`. Nenhuma das duas variáveis desativa o pensamento no Opus 5.5, no Sonnet 5.5, no Haiku 5.5 ou nos modelos Fable, nos quais o pensamento não pode ser desativado. Em provedores de terceiros, `MAX_THINKING_TOKENS=0` também omite o parâmetro, então as duas variáveis se comportam da mesma forma nesses casos
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Defina como `1` para ignorar 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 presume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela presumida; consulte Corrigir a janela para um gateway ou ID de modelo personalizado para saber quando cada variável se aplica. Requer o 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 se a rolagem no modo de tela cheia mostrar regiões em branco onde as mensagens deveriam aparecer
`CLAUDE_CODE_DISABLE_WEB_FETCH`	Defina como `1` para desativar a ferramenta WebFetch. A ferramenta WebSearch continua disponível. Requer o Claude Code v2.1.285 ou posterior
`CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER`	Defina como `1` para iniciar os comandos da ferramenta PowerShell no Windows diretamente, em vez de por meio do inicializador `cmd.exe`. Por padrão, o inicializador 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 o 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 os 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_EMIT_SESSION_STATE_EVENTS`	Defina como `1` para adicionar mensagens `session_state_changed`, que carregam o estado da sessão, ao fluxo de mensagens. Requer o Agent SDK ou `--print`, `--output-format stream-json` e `--verbose`
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Aceita por 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, Agent Platform do Google Cloud, Microsoft Foundry e sessões conectadas do gateway de apps do Claude. Da v2.1.158 à v2.1.206, definir esta variável como `1` era necessário 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 sobre 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 depois que uma instalação em segundo plano for concluída. Desativada por padrão porque a atualização altera o system prompt no meio da sessão, o que invalida o cache de prompt naquele turno
`CLAUDE_CODE_ENABLE_CFC`	Defina como `1` para iniciar uma sessão da CLI com a integração com o Chrome ativada, ou `0` para iniciá-la desativada. Tem precedência sobre a configuração `claudeInChromeDefaultEnabled`. As flags `--chrome` e `--no-chrome` têm precedência sobre ambas. O Claude Code ignora `1` nas configurações de projeto e locais
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Defina como `1` para encaminhar a pesquisa de qualidade de sessão “How is Claude doing?” ao 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 nesse 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 das chamadas de ferramenta são transmitidas pela API à medida que o Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como a gravação de um arquivo longo, chega somente depois que o Claude termina de gerá-la, o que pode parecer um travamento. Ativada por padrão na API da Anthropic. No Amazon Bedrock e no Agent Platform do Google Cloud, ativada 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`. Desativada por padrão no Microsoft Foundry e em conexões por 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. Desativada por padrão porque 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; entregue a lista por meio de MDM ou de um arquivo de configurações gerenciadas, já que a entrega gerenciada pelo servidor não está disponível em configurações com gateway
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Removida na v2.1.142, quando o padrão do modo rápido passou do Opus 4.6 para o Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Defina como `false` para desativar as sugestões de prompt, as previsões esmaecidas 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 do limite de uso ou o atingiu. Defina como `true` para mantê-las ativas até atingir o limite. Requer o 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 nas 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 apenas nos modelos listados em Disponibilidade da ferramenta Task. `CLAUDE_CODE_ENABLE_TASKS` ainda seleciona as ferramentas Task ou `TodoWrite`. Requer o 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 as 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 do corpo de cada requisição à 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 no shell e usavam a 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, que é de 25.000 tokens. Útil quando você precisa ler arquivos maiores por inteiro. Uma leitura que o Claude faz com o parâmetro `allow_large` pode ultrapassar esse limite quando a janela de contexto tem espaço
`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 do `screen` ou de um inicializador em segundo plano iniciado primeiro pela ferramenta Bash do Claude Code, fizer com que uma sessão genuinamente de nível superior 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 na 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 do Claude quando o seu terminal oferece suporte, mas não é detectado automaticamente, como via SSH sem `TERM_PROGRAM` encaminhada. Sem isso, terminais não detectados mostram os marcadores `~~` literais em vez de renderizar o texto como tachado. Requer o 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 o 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. Ao contrário de `CLAUDE_CODE_NO_FLICKER`, que muda para a renderização em tela cheia, esta não altera o renderizador
`CLAUDE_CODE_FORCE_TERMINAL_IMAGES`	Defina como `1` para desenhar elementos `Image` de mods como imagens quando o seu terminal desenha imagens do protocolo gráfico kitty com placeholders Unicode, mas não é detectado automaticamente. Consulte quais terminais o Claude Code detecta e por que isso não ajuda dentro do tmux ou do screen
`CLAUDE_CODE_FORK_SUBAGENT`	Controla o modo fork, que permite ao próprio Claude gerar subagentes bifurcados e fica ativado por padrão apenas 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 todos os tipos de sessão. Você pode executar `/subtask` independentemente de o modo fork estar ativado. O padrão interativo requer o 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 consegue passar a flag por conta própria. Ao contrário 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 estiver definida para todo o processo. Requer o 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 de terceiros, 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 o 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 o 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 o 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 estiver 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 o 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 em espera antes que o Claude Code peça ao 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 equivale a uma semana. O Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer o Claude Code v2.1.234 ou posterior
`CLAUDE_CODE_GZIP_REQUEST_BODIES`	Defina como `0` para desativar a compressão gzip dos corpos de requisições da API do Claude, de telemetria e de publicação de artefatos enviados para `api.anthropic.com`. Por padrão, o Claude Code comprime corpos de requisição grandes em conexões diretas e ignora a compressão quando você envia requisições por meio de um proxy, configura um certificado de cliente ou define `NODE_EXTRA_CA_CERTS`. Use `0` se um proxy com inspeção de TLS que o Claude Code não consegue detectar tratar incorretamente requisições comprimidas
`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 o seu nome de usuário do sistema operacional
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Sobrescreve o endereço de host usado para se conectar à extensão do IDE. Por padrão, o Claude Code detecta automaticamente o endereço correto, incluindo o roteamento do WSL para o Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Defina como `1` para ignorar a instalação automática de extensões de IDE. Equivalente a definir `autoInstallIdeExtension` como `false`
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Defina como `1` para ignorar a validação das entradas do lockfile do IDE durante a conexão. Use quando a conexão automática não encontrar o seu IDE mesmo com ele em execução
`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`	Tamanho do contexto, em tokens, a partir do qual a compactação por inatividade se aplica a uma conversa (padrão: `200000`). Aceita um número inteiro positivo, e qualquer outra coisa é ignorada. Valores abaixo de `100000` são elevados para `100000`, o limite mais baixo. A compactação por inatividade fica ativada por padrão para conversas que atendem às suas condições. Para desativá-la, defina `idleCompaction` como `false`. Requer o Claude Code v2.1.290 ou posterior
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	Quantos subagentes podem estar em execução em uma sessão antes que a ferramenta Agent se recuse a gerar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outro valor é ignorado, portanto a variável pode ajustar o limite, mas não desativá-lo. Requer o 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 ela 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 quando rotear para um modelo por meio de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho interno 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. O valor que você define substitui ambos os limites padrão: 4096, e 16384 para a descrição de uma ferramenta que o Claude carrega por meio da busca de ferramentas. O Claude Code trunca textos mais longos. Aceita um número inteiro positivo em dígitos simples. Qualquer outro valor é ignorado e os padrões se aplicam. 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 o 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 à API que falharam (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 sem efeito. Anteriormente limitava o número total de subagentes que o Claude podia gerar com a ferramenta Agent em uma sessão (padrão: 200); gerar 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, os subagentes podem gerar seus próprios subagentes, e um subagente na terceira camada não pode gerar outros; 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 gerar 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, portanto o limite pode ser ajustado, mas não removido. Requer o 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 de chamadas de WebSearch (padrão: 200). Quando o Claude atinge o limite, chamadas adicionais 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, portanto o limite pode ser aumentado, mas não desativado. Requer o Claude Code v2.1.212 ou posterior
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Defina como `1` para iniciar servidores MCP stdio apenas com um ambiente básico 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 o 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 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; em um ambiente auto-hospedado, altera apenas quanto tempo a espera dura. Defina como `0` para ignorar a espera. Um servidor de `--permission-prompt-tool` mantém sua própria espera de `MCP_TIMEOUT` independentemente do valor. Requer o 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 de conector do claude.ai não envia nenhuma 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 em `.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 SDK em processo. Requer o 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 começa com mensagens ativadas, o Claude Code vincula o socket antes de qualquer hook ser executado. Outras sessões na máquina entregam mensagens a este caminho. Cada sessão exporta seu próprio socket em vez de um herdado de um processo pai, e as mensagens que chegam nele passam pelos controles de entrada da sessão. Blocos `env` de configurações não podem defini-la. Requer o 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 publica no 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` de configurações não podem defini-la. Requer o 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, forma e foco do terminal. Definir `0` equivale a deixar a variável não definida, portanto não traz de volta o bloco desenhado em uma sessão em que o cursor do próprio terminal já está ativado
`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 pare de ler, como um painel do tmux em modo de controle pausado ou uma conexão SSH travada, não congele o Claude Code no meio da sessão. Aplica-se no macOS, Linux e WSL quando o stdout é um terminal. Requer o Claude Code v2.1.261 ou posterior
`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`	Limita quantas vezes o Claude Code reenvia uma requisição sem streaming que atinge o timeout. Com `0`, a requisição falha no primeiro timeout. Consulte Ajustar o comportamento de novas tentativas para o timeout. Requer o Claude Code v2.1.285 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 no Claude.ai. Quando definida, `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 no claude.ai. Alternativa ao `/login` para o 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 sem 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 de 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 o 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 só aparecem com `--debug`, então um exportador mal configurado, como uma colisão de porta do Prometheus, falha silenciosamente. Requer o 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_OVERLOADED_RETRY_BASE_DELAY_MS`	Atraso inicial em milissegundos, no lugar do padrão de 500, do backoff exponencial entre novas tentativas automáticas de uma requisição que a API rejeita com um erro `529` de sobrecarga. Aumente-o para distribuir as novas tentativas por uma janela mais longa quando a API estiver na capacidade máxima. Informe milissegundos inteiros de 500 a 32000 em dígitos simples; o Claude Code trata qualquer outro valor como não definido. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida como `1`, ou quando a requisição rejeitada foi enviada no modo rápido. Requer o Claude Code v2.1.292 ou posterior
`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`	Teto em milissegundos, no lugar do padrão de 32000, do backoff exponencial entre novas tentativas automáticas de uma requisição que a API rejeita com um erro `529` de sobrecarga. Aumente-o para que as novas tentativas posteriores continuem se espaçando quando a API estiver no limite de capacidade. Informe milissegundos inteiros de 32000 a 64000 em dígitos simples; o Claude Code trata qualquer outro valor como não definido. Não tem efeito quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida como `1`, ou quando a requisição rejeitada foi enviada no modo rápido. Requer o Claude Code v2.1.296 ou posterior
`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 contra gravação compatível com o 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 gravação do proprietário, que o Perforce remove nos arquivos sincronizados até que `p4 edit` os abra. Isso impede que o Claude Code contorne o controle de alterações do Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Sobrescreve o diretório raiz dos plugins. Apesar do nome, isto define o diretório pai, não o cache em si: 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 serem carregados na sessão, cada um carregado da mesma forma que uma flag `--plugin-dir` o carrega. Separe vários caminhos com `:` no Unix ou `;` no Windows. Informe cada caminho como um caminho absoluto ou comece-o com `~`, porque o Claude Code ignora caminhos relativos. Requer o Claude Code v2.1.280 ou posterior. Consulte Carregar um plugin para uma sessão
`CLAUDE_CODE_PLUGIN_DIR_WATCH`	Controla se o Claude Code recarrega um mod quando os arquivos do mod mudam. O recarregamento se aplica a um mod que você carrega de um diretório com `--plugin-dir` e fica ativado por padrão em sessões interativas. Defina como `1` para ativá-lo também em sessões não interativas, ou `0` para desativá-lo em todas as sessões. Requer o Claude Code v2.1.287 ou posterior. Consulte configurações e variáveis de ambiente de mods
`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 timed out
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Defina como `1` para ignorar a tentativa de nova clonagem e continuar usando o checkout existente do marketplace quando uma atualização do marketplace não consegue alcançar o remoto ou se autenticar nele. Útil em ambientes offline ou isolados (airgapped) em que a nova clonagem 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 semente de plugins somente leitura, separados por `:` no Unix ou `;` no Windows. Use para incluir um diretório de plugins pré-preenchido em uma imagem de contêiner. O Claude Code registra os 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, e respeitar 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 `MachinePolicy` ou `UserPolicy` da Política de Grupo, independentemente desta configuração
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Teto em milissegundos para a espera ociosa por trabalho em segundo plano, como subagentes e fluxos de trabalho, após o turno final no modo não interativo com a flag `-p`. A espera ociosa recomeça cada vez que o Claude usa um turno para tratar um resultado em segundo plano. Padrão: `600000`, ou 10 minutos. Quando a espera ociosa atinge o teto, o Claude Code para de aguardar as tarefas em segundo plano restantes. Um comando em segundo plano em execução iniciado pela conversa principal mantém a execução aberta além dele. Defina como `0` para aguardar indefinidamente. Requer o Claude Code v2.1.182 ou posterior
`CLAUDE_CODE_PROCESS_WRAPPER`	Inicia os processos que o Claude Code inicia a partir do seu próprio binário, como o serviço em segundo plano que hospeda as sessões da visualização de agentes, por meio de um inicializador corporativo informado como um prefixo de argv, como `/opt/corp/launcher`. Defina-a no bloco `env` das configurações de usuário ou das configurações gerenciadas, não como uma exportação 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 o 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 cumprir. Requer o 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/` no 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` os 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 o 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, de `-p` e do SDK, além dos auxiliares executados junto 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 tarifa mais alta. Requer o 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 servidores MCP HTTP, e a variável de ambiente `TRACEPARENT` para subprocessos de Bash, PowerShell e hooks. Por padrão, a propagação só é ativada quando há conexão direta com a API da Anthropic. Adicionada na v2.1.152. Consulte Traces (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Definida por plataformas hospedeiras que incorporam o Claude Code e gerenciam o roteamento de provedores de modelo 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, de modo que as configurações de usuário não possam sobrescrever o roteamento do hospedeiro. 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 hospedeiro 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 hospedeiro forneça a sua própria. O Claude Code também ignora a desativação automática de telemetria que, de outra forma, aplica em provedores de terceiros 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 faça a resolução de DNS em vez do chamador. Opcional para ambientes em que o proxy deve cuidar da 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 em 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 o 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 desativá-la, 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 ignora a retomada automática de `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e sua mensagem de continuação `CLAUDE_CODE_RESUME_PROMPT`, e a sessão começa ociosa para que você continue explicitamente. Não definida ou `0` não define limite, exceto que alguns turnos só são retomados dentro de seis horas após sua última mensagem, como um que terminou com um erro da API. 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 defini-la para que um reinício sobre uma transcrição antiga não execute novamente um prompt desatualizado. O próprio Claude Code define um limite de uma hora quando reinicia uma sessão da visualização de agentes que travou e herdou sua conversa de uma sessão interativa. Requer o Claude Code v2.1.211 ou posterior
`CLAUDE_CODE_RESUME_PROMPT`	Sobrescreve a mensagem de continuação que o Claude Code envia ao 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 indefinidamente erros de capacidade `429` e `529` 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 que venha 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 no modo rápido, consulte Lidar com rate limits. O watchdog espera até 5 minutos entre as tentativas, ou até que o limite seja redefinido quando a resposta inclui 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 o número padrão de novas tentativas para outros erros transitórios, como erros de servidor, timeouts e conexões interrompidas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. Requer o Claude Code v2.1.186 ou posterior
`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`	Tempo máximo, em milissegundos, que cada requisição à API passa aguardando erros `429` e `529` quando `CLAUDE_CODE_RETRY_WATCHDOG` está definida. Depois que esse tempo se esgota, o próximo erro desse tipo encerra a requisição. Informe um número inteiro positivo em dígitos simples, como `1800000` para 30 minutos. Quando não definida, a espera não tem limite. Requer o Claude Code v2.1.295 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 solucionar problemas de uma configuração com defeito. A política de 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. O fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade
`CLAUDE_CODE_SCROLL_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 os eventos da roda. Defina como `3` para corresponder ao `vim` se o seu terminal enviar um evento de roda por clique sem amplificação. Ignorada no terminal dos 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 pelo Claude em uma sessão. Defina como `1` para ativá-lo onde sua conta já tiver 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 de 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 de hooks fornecidos por plugins não aumentam o orçamento
`CLAUDE_CODE_SESSION_ID`	Definida automaticamente com o ID da sessão atual nos subprocessos das ferramentas Bash e PowerShell, nos subprocessos de comandos de hook e nos 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. Em `--resume <session-id>`, ele recebe o ID retomado, correspondendo aos hooks e ao Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID inicial da inicialização. 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 os 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 suportados. Se o valor não for um caminho `bash` ou `zsh` funcional, o Claude Code o ignora e recorre à detecção automática. A detecção automática usa o 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 do 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 o 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` continuam sendo carregadas. Tokens OAuth e credenciais do keychain não são lidos, então a autenticação na Anthropic deve vir de `ANTHROPIC_API_KEY` ou de um `apiKeyHelper` em `--settings`. Equivalente a passar `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Escolhe entre o system prompt completo do Claude Code e um mais curto com descrições de ferramentas abreviadas. Quando não definida, o Haiku 4.5, o Sonnet 5, o Opus 4.7 e modelos anteriores dessas famílias usam o prompt completo por padrão, e os modelos mais novos usam o mais curto. Defina como `1` para usar o prompt mais curto em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para usar o prompt completo em qualquer modelo, mesmo quando um experimento ou uma configuração do servidor selecionaria o mais curto. Qualquer um dos prompts mantém o conjunto completo de ferramentas, hooks, servidores MCP e a descoberta de CLAUDE.md
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Ignora 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 de credenciais resolvidas a partir da cadeia de provedores de credenciais padrão da AWS, para que o Claude Code resolva a cadeia a cada requisição à API. Com o cache desativado, um perfil baseado em SSO solicita credenciais ao IAM Identity Center a cada requisição. Consulte cache de credenciais e timeout de resolução. Requer o Claude Code v2.1.207 ou posterior
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Ignora 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 que falhou como disponível, para redes que bloqueiam a requisição direta da verificação a `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 ignorar 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 no modo rápido quando a sua organização tem o modo rápido desativado
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Ignora 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 as 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`	Ignora 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 elas constataram que sua conta não pode invocar, por até um dia. Defina como `1` para desativar essa memória. Requer o 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 scripts
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Ignora 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 o stderr. Requer o 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 se resolver
`CLAUDE_CODE_SUBAGENT_MODEL`	O modelo padrão para subagentes, colegas de equipe de agentes e agentes de workflow que não recebem um modelo de outra forma. Aceita um alias como `haiku` ou um nome completo de modelo. Duas fontes têm precedência sobre ela: um modelo que o Claude passa ao gerar 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 não definida. 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, colegas de equipe e agentes de workflow. Executar todos os subagentes em um único modelo informa qual é esse modelo. Requer o 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 tarifa mais alta. Requer o Claude Code v2.1.242 ou posterior
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Defina como `1` para remover credenciais dos ambientes dos subprocessos que o Claude Code inicia, como comandos Bash, hooks e servidores MCP stdio. A limpeza reconhece uma credencial pelo nome da variável ou pelo seu valor, e mantém os tokens do GitHub e as configurações de proxy. Consulte O que a limpeza do ambiente de subprocessos remove. `claude-code-action` define esta variável 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 os 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 a sua conta do claude.ai naquela execução e aguardar a lista delas, até `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de executar a primeira consulta. Requer autenticação no claude.ai. Sessões de terminal em que você faz login com sua conta do claude.ai sincronizam essas skills sem esta variável, então defina-a apenas quando uma execução com `-p` precisar das suas skills atuais na primeira consulta
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Timeout em milissegundos para a ressincronização de skills executada no meio da sessão quando um app construído com o Agent SDK recarrega as 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 o 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 desativar também 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 até 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 o 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 a sua substituição é um caminho longo, já que algumas ferramentas falham quando os caminhos temporários ficam longos demais. Comandos Bash fora do sandbox herdam o `$TMPDIR` do seu shell quando ele está definido. No Windows nativo, quando o seu shell não define `$TMPDIR`, um comando Bash que referencia `$TMPDIR` recebe a sua substituição, ou `%TEMP%` quando você não definiu uma. Os próprios arquivos temporários do Claude Code sempre usam a 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, ao contrário da maioria das variáveis de ativar/desativar; remova a definição da variável para restaurar a limitação a 256 cores. Por padrão, o Claude Code limita a 256 cores quando `$TMUX` está definida, porque o tmux não repassa sequências de escape truecolor a menos que esteja configurado para isso. Defina-a 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 os 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 o 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 tiver ativado ou desativado o limite, um valor alterado entra em vigor na próxima vez que você iniciar `claude`. Requer o Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_TRANSCRIPT_LOCAL_GC`	Defina como `1` para limitar o quanto o arquivo de transcrição de uma sessão longa de `-p` ou do Agent SDK cresce. Após cada compactação, quando o arquivo ultrapassa 5 MB, o Claude Code remove o histórico anterior a essa compactação. Retomar a sessão restaura a mesma conversa, quer o arquivo tenha sido reduzido ou não. Defina-a no ambiente a partir do qual você inicia o Claude Code, já que um bloco `env` de configurações não pode ativá-la. Requer o Claude Code v2.1.287 ou posterior
`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`	Prazo em milissegundos antes que o Claude Code cancele uma caixa de diálogo que ele 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 do `AskUserQuestion` usam seus próprios fluxos e não são regidos por ela. No Claude Code v2.1.236 ou posterior, ela também limita o prompt de consentimento de créditos de uso do Fable exibido no meio da sessão, em uma sessão que possa estar sendo executada sem supervisão. Controlar mensagens recebidas 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. Ignorada em configurações de projeto e locais
`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 APIs de arquivo do Node.js em vez do ripgrep. Defina isso se o binário do ripgrep incluído estiver indisponível ou bloqueado no seu ambiente. Não afeta as ferramentas Grep ou de pesquisa 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, o Claude pode executar comandos do PowerShell nativamente em vez de passar pelo Git Bash. Consulte Ferramenta PowerShell
`CLAUDE_CODE_USE_VERTEX`	Usar o Agent Platform do Google Cloud
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	Defina como o número de milissegundos durante os quais o WebFetch mantém em cache a resposta de cada URL buscada. O padrão é `900000`, que equivale a 15 minutos. Aceita apenas dígitos simples; `0`, um número decimal ou qualquer outra grafia mantém o padrão. O Claude Code lê o valor uma vez por inicialização, portanto uma alteração em um bloco `env` das configurações se aplica na próxima vez que você iniciar o `claude`. Requer Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	Limite máximo, em milissegundos, de quanto tempo o WebFetch espera o download de uma página, incluindo quaisquer redirecionamentos que ele segue. Um download que não tiver sido concluído até lá falha com um erro de prazo. O padrão é `300000`, que equivale a cinco minutos. Defina como `0` para remover o limite. Aceita apenas dígitos simples; um número decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior
`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`	Taxa na qual o limite de WebSearch de uma sessão é reabastecido, em chamadas por hora. O padrão é `100` em uma sessão interativa no terminal. Em uma sessão não interativa, o padrão é `0`, o que desativa o reabastecimento. Aceita apenas dígitos simples; qualquer outra grafia é tratada como não definida. Requer Claude Code v2.1.290 ou posterior
`CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE`	Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está definida como `1`, quanto tempo o Claude Code espera antes de cada lembrete para que o Claude verifique subagentes em segundo plano que ainda estão em execução. Aceita uma ou mais esperas separadas por vírgula, em segundos inteiros de `1` a `86400`, como `600` ou `600,1800,3600`. Cada valor é a espera antes do próximo lembrete, e o último valor se repete. Aceita apenas dígitos simples; qualquer outro valor ou grafia é tratado como não definido. Quando não definida, não há lembretes. Requer Claude Code v2.1.283 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()` na fila aguardam um espaço livre. A transcrição de cada agente em execução permanece na memória do Claude Code, portanto 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 máximo, 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 exceto o primeiro agente 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_CODE_YOU_SHOULD_KNOW_DEBUG`	Defina como `1` para mostrar, acima do prompt, uma linha para cada uma das últimas três verificações que o mod You should know fez nesta sessão. Use-a para confirmar que o mod está verificando quando nenhuma nota aparece. Requer Claude Code v2.1.287 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. Em um arquivo de configurações, escreva o caminho absoluto. Ignorada em 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 que você confirme antes de colocar em segundo plano e, em seguida, interrompe as tarefas que de outra forma 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 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 ociosidade de streaming em nível de byte, ou defina como `0` para forçar sua desativação. `0` também desativa o prazo do primeiro byte nas conexões em que esse prazo é aplicado. Quando não definida, o watchdog fica 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 acessadas 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 uma paralisação nelas mesmo enquanto pings de keep-alive estavam chegando. Para timeouts e como os temporizadores interagem, consulte Watchdogs de ociosidade de streaming
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Defina como `1` para ativar o watchdog de ociosidade de streaming em nível de byte em respostas `vnd.amazon.eventstream` do Amazon Bedrock, o que também ativa o prazo do primeiro byte em 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 ociosidade de streaming em nível de evento, ou defina 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 em outros provedores. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para os outros temporizadores de paralisação executados junto com este, consulte Watchdogs de ociosidade 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 persistir a ativação de virtualenv ou conda entre comandos. Comandos do PowerShell também recebem suas variáveis, na v2.1.296 ou posterior, sob as condições descritas em Variáveis persistidas em comandos do PowerShell. 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 como 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 solicitam permissão, e o diretório é removido quando a sessão é excluída
`CLAUDE_PID`	O Claude Code define esta variável com seu próprio ID de 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 `pkill` que corresponderia ao próprio processo do Claude Code; consulte a referência de erros. Leia-a em 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 nome de host 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 é aplicado. 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 definir, consulte No response from API. Requer Claude Code v2.1.242 ou posterior
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Timeout em milissegundos antes que os watchdogs de ociosidade de streaming em nível de evento e de byte fechem uma conexão paralisada. 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 o 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 ociosidade de streaming
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	Removida na v2.1.260 e agora não tem efeito. Anteriormente limitava por quanto tempo um comando de shell em segundo plano iniciado por um subagente podia ser executado, em milissegundos, com um 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`. Apenas os valores verdadeiros `1`, `true`, `yes` e `on` ativam o modo de depuração, portanto 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, junto com a compactação por inatividade. 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 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 como 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 qualquer nome. O nome mais 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 cada flag. 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 a 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 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 como 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 restritiva que `DISABLE_AUTOUPDATER`. Use ao distribuir o Claude Code pelos seus próprios canais quando os usuários não devem se atualizar por conta própria
`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 que `DISABLE_TELEMETRY`, inclusive sobre a busca de feature flags. O Claude Code lê esta variável como um booleano padrão, portanto `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`, e defina `BETA_TRACING_ENDPOINT` com o endpoint do seu coletor OTLP/HTTP, para ativar o rastreamento 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 em 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 conectados. 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 do padrão de 5 minutos. Destinada a usuários de chave de API, do Amazon Bedrock, do Agent Platform do Google Cloud, do Microsoft Foundry e do 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 utilizam créditos de uso podem defini-la para manter o TTL de 1 hora. Gravações em 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 e, em vez disso, as carrega antecipadamente quando `ANTHROPIC_BASE_URL` aponta para um host que não é primário. `true` as mantém adiadas também nesse tipo de host. `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. Para os modelos e implantações que carregam todas as ferramentas antecipadamente independentemente deste valor, consulte Configurar a busca de ferramentas
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Defina como qualquer valor não vazio, como `1`, para fazer o Claude Code parar de tentar novamente em erros de sobrecarga repetidos para todos os modelos quando nenhum modelo de fallback estiver configurado. Defini-la como `0` ou `false` ainda ativa isso, 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 modelos 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 sua cadeia de modelos de fallback configurada em erros de sobrecarga repetidos para qualquer modelo principal, portanto esta variável não afeta a mudança para um modelo de fallback
`FORCE_AUTOUPDATE_PLUGINS`	Defina como `1` para forçar 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 oferece suporte a eles, mas não é detectado automaticamente, ou `0` para desativá-los. Quando não definida, o Claude Code ativa hyperlinks apenas quando detecta suporte no terminal. O Claude Code interpreta este valor como um número, não como um booleano, portanto um valor como `false`, `no` ou `off` ativa hyperlinks em vez de desativá-los. O badge de PR ou merge request no rodapé é renderizado como hyperlink mesmo quando o Claude Code não consegue detectar suporte no 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 seria aplicado. 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 como 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 em respostas de ferramentas MCP (padrão: 25000). 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 conteúdo de texto, mas o conteúdo de imagem dessas ferramentas ainda está sujeito a esta variável. Um resultado de texto bem-sucedido com mais de 50.000 caracteres de uma ferramenta sem essa anotação é salvo em um arquivo independentemente desta variável
`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 malsucedidas 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 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, modelos com raciocínio adaptativo escolhem sua própria profundidade de pensamento, e outros modelos usam o limite. Defina como `0` para desativar o pensamento na API da Anthropic, exceto no Opus 5.5, Sonnet 5.5, Haiku 5.5 e nos modelos Fable, que não permitem desativar o pensamento. Em provedores de terceiros, `0` omite o parâmetro `thinking` em vez disso. 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. Para um valor positivo, o Claude Code ignora o próprio número em modelos com raciocínio adaptativo, exceto quando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desativa o raciocínio adaptativo
`MCP_CLIENT_SECRET`	Segredo de cliente 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 os servidores MCP se conectarem 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 os servidores se conectarem 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 os servidores ainda pendentes antes do primeiro turno, independentemente desta variável. Quando você passa `--mcp-config` explicitamente, a espera tem um prazo mais longo; consulte a entrada dessa flag para a exceção de servidores em cache
`MCP_CONNECT_TIMEOUT_MS`	Quanto tempo a inicialização bloqueante do MCP espera, em milissegundos, 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 sua 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 malsucedida 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 é de 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`	Apenas 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 conector do claude.ai e stdio, ou `legacy` para não sondar nenhum. Com a variável sem definição, o Claude Code sonda os servidores descritos em Runtimes de cliente MCP. 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 a 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 ociosidade para as chamadas de ferramenta desse servidor, de modo que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as interrompa 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 da resposta do modelo nos eventos de log `assistant_response` do OpenTelemetry. 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 em 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 ocultadas, e um digest SHA-256 das configurações antes da ocultação, aos eventos de log `managed_settings_resolved` do OpenTelemetry. 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 sem truncamento em disco e emitir um caminho `body_ref` em vez disso. `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 em 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 `tool.output` do OpenTelemetry. Os atributos de span carregam o conteúdo da ferramenta sob suas próprias condições. Requer rastreamento. 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 em 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 em eventos `api_refusal`; nomes reais de agentes, skills, plugins e servidores MCP em 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 em 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 em 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 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 datapoints 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 para a ferramenta Skill. O orçamento escala dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores
`TASK_MAX_OUTPUT_LENGTH`	Removida na v2.1.277 e agora não tem 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 lê o arquivo de saída de uma tarefa em segundo plano com `Read` em vez disso
`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 para o Claude 3.5 Haiku ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Sobrescreve a região para o Claude 3.5 Sonnet ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Sobrescreve a região para o Claude 3.7 Sonnet ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Sobrescreve a região do Claude Opus 4 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Sobrescreve a região do Claude Sonnet 4 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Sobrescreve a região do Claude Opus 4.1 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Sobrescreve a região para o Claude Opus 4.5 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Sobrescreve a região para o Claude Sonnet 4.5 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Sobrescreve a região para o Claude Opus 4.6 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Sobrescreve a região para o Claude Sonnet 4.6 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Sobrescreve a região para o Claude Opus 4.7 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Sobrescreve a região para o Claude Opus 4.8 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_5_5_OPUS`	Sobrescreve a região para o Claude Opus 5.5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.280
`VERTEX_REGION_CLAUDE_5_5_SONNET`	Sobrescreve a região para o Claude Sonnet 5.5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.284
`VERTEX_REGION_CLAUDE_5_OPUS`	Sobrescreve a região para o Claude Opus 5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.219
`VERTEX_REGION_CLAUDE_5_SONNET`	Sobrescreve a região para o Claude Sonnet 5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Sobrescreve a região para o Claude Fable 5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.170
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Sobrescreve a região para o Claude Fable 5.1 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.257
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Sobrescreve a região para o Claude Haiku 4.5 ao usar o Agent Platform do Google Cloud
`VERTEX_REGION_CLAUDE_HAIKU_5_5`	Sobrescreve a região para o Claude Haiku 5.5 ao usar o Agent Platform do Google Cloud. Adicionada na v2.1.293

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, timeout e compressão da exportação, como OTEL_METRIC_EXPORT_INTERVAL, ainda se aplicam a partir das configurações de projeto e locais.

O que a limpeza do ambiente de subprocessos remove

Quando você define CLAUDE_CODE_SUBPROCESS_ENV_SCRUB como 1, o Claude Code remove credenciais dos ambientes dos subprocessos que ele inicia, como comandos Bash, hooks e servidores MCP stdio. Isso reduz o que um ataque de injeção de prompt pode ler. O processo do Claude Code mantém as credenciais para suas próprias chamadas de API. A limpeza reconhece uma credencial pelo nome da variável ou pelo formato do seu valor, portanto use-a como uma camada junto com regras de permissão restritas, e não como o único controle. A tabela mostra o que a limpeza faz com variáveis de exemplo:

Variável de exemplo	O que a limpeza faz
`ANTHROPIC_API_KEY`, `AWS_SECRET_ACCESS_KEY`	Remove a variável
`NPM_TOKEN`, `DB_PASSWORD`	Remove a variável, porque o nome parece uma credencial
`DATABASE_URL` que contém uma senha	Remove a variável, porque o valor parece uma credencial
`PIP_INDEX_URL` ou `NPM_CONFIG_REGISTRY` que contém uma senha	Mantém a URL e remove dela o nome de usuário e a senha
`CLAUDE_CONFIG_DIR`	Remove a variável
`GITHUB_TOKEN`, `GH_TOKEN`, `GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN`	Mantém a variável, para que o `gh` e os scripts que chamam a API do GitHub continuem funcionando
`HTTP_PROXY`, `HTTPS_PROXY`	Mantém a variável, incluindo um nome de usuário e senha na URL. O sandbox pode definir essas variáveis por conta própria para comandos executados em sandbox
`GIT_CONFIG_COUNT`, `GIT_CONFIG_KEY_<n>`, `GIT_CONFIG_VALUE_<n>`	Mantém a variável, seja qual for o seu conteúdo
Um segredo cujo nome de variável e valor não parecem uma credencial	Mantém a variável

Como a limpeza mantém o GITHUB_TOKEN, conceda a um job do GitHub Actions as permissions mais restritas de que ele precisa. Para remover um token do GitHub de comandos Bash executados em sandbox, adicione uma entrada deny em sandbox.credentials. Deixe a limpeza desativada se um subprocesso precisar de uma das variáveis removidas. No Linux, a limpeza também executa subprocessos Bash em um namespace de PID isolado, para que eles não possam ler os ambientes dos processos do host por meio de /proc. Como efeito colateral, ps, pgrep e kill não conseguem ver nem enviar sinais para processos do host. Antes da v2.1.251, a limpeza removia ANTHROPIC_API_KEY e AWS_SECRET_ACCESS_KEY e deixava inalteradas as demais variáveis de exemplo da tabela.

Recursos que precisam da busca de feature flags

O Claude Code ativa alguns recursos por meio de feature flags que ele busca na Anthropic. O Claude Code ignora essa busca nestas sessões:

Uma sessão em que 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 informa quais valores desativam a busca
Uma sessão em um provedor de terceiros, como Amazon Bedrock, Claude Platform on AWS, Agent Platform do Google Cloud ou Microsoft Foundry, a menos que uma plataforma host que incorpora o Claude Code defina CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
Uma sessão do Claude apps gateway

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

Executar /auto-mode-setup para rascunhar entradas de autoMode.environment
Usar o Remote Control com CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DISABLE_GROWTHBOOK definidos. Para DISABLE_TELEMETRY e DO_NOT_TRACK, consulte os requisitos do Remote Control
Enviar mensagens para sessões além desta máquina quando o Remote Control não estiver disponível. O envio de mensagens entre sessões nesta máquina funciona com a busca desativada
Executar claude import ou o comando /import
Executar /skill-doctor ou abrir o relatório dele na aba Stats do /plugin
Sincronizar as skills e os plugins habilitados para sua conta do claude.ai nas suas sessões de terminal
Ativar o mod You should know
Usar a ferramenta advisor
Ler ou responder a comentários em um artefato
Fazer o Claude ler o artefato público de outra organização
Obter a ferramenta PowerShell por padrão para contas do claude.ai e do Console no Windows com o Git Bash instalado; o Claude Code encaminha os comandos de shell pelo Git Bash, a menos que você defina CLAUDE_CODE_USE_POWERSHELL_TOOL=1. No Windows sem o Git Bash, a ferramenta permanece ativada
Obter feedback rascunhado pelo Claude, que o Claude Code ativa por meio de uma flag buscada
Fazer o Claude tratar colagens grandes como texto colado em vez de digitado; o conteúdo por trás de um placeholder [Pasted text #N] chega ao Claude sem marcação
Fazer o Claude Code excluir ferramentas MCP cujo esquema de entrada a API rejeitaria; ele envia o esquema mesmo assim, e uma requisição que o inclui falha com um erro 400 que identifica a ferramenta pela sua posição
Fazer o Claude Code compactar uma conversa longa enquanto sua sessão de terminal está ociosa, pouco antes de um cache de prompt de uma hora expirar

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

Na sua primeira sessão após instalar o Claude Code, ou atualizar para uma versão que adiciona um recurso, um recurso controlado por flag pode estar ausente. Essa sessão também pode iniciar em um modo de permissão diferente do das suas sessões posteriores. Quando o Claude Code busca as flags durante essa sessão, ele as salva na máquina, de modo que sua próxima sessão nessa máquina tenha o recurso e o modo de permissão inicial habitual. Após uma instalação nova, em uma sessão não interativa, como claude -p, o Agent SDK ou a extensão do VS Code, o Claude Code pode obter as flags antes de escolher o modo de permissão inicial, mas nem sempre espera por elas. Em configurações como estas, as sessões após a primeira também iniciam sem flags buscadas recentemente:

Um ambiente limpo a cada execução: se cada execução começa em um contêiner de CI, ou em qualquer outro ambiente sem as flags que uma sessão anterior salvou, cada execução é uma primeira sessão
Um token de gateway sem chave de API: se você se autentica com ANTHROPIC_AUTH_TOKEN e sem chave de API, e ANTHROPIC_BASE_URL aponta para um host diferente do da Anthropic, como um gateway de LLM, o Claude Code não tem nenhuma credencial com a qual buscar as flags

Para escolher o modo de permissão em que as sessões nessas configurações iniciam, consulte Iniciar em um modo de permissão diferente.

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

​Definir variáveis de ambiente

​Definir variáveis no seu shell

​Definir variáveis em arquivos de configurações

​Precedência

​Variáveis

​O que a limpeza do ambiente de subprocessos remove

​Recursos que precisam da busca de feature flags

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

​Veja também