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.

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, então confirme se a variável está definida imprimindo-a no mesmo shell antes de executar claude:

macOS, Linux, WSL
Windows PowerShell
Windows CMD

echo $API_TIMEOUT_MS

echo $env:API_TIMEOUT_MS

echo %API_TIMEOUT_MS%

Em arquivos de configurações

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

~/.claude/settings.json

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

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

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

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

Precedência

Alguns comportamentos têm tanto uma variável de ambiente quanto uma chave de configurações dedicada, e qual delas Claude Code lê primeiro difere por chave. Para ANTHROPIC_MODEL e CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code lê a variável primeiro e usa a configuração model ou autoConnectIde apenas quando a variável não está definida. Para o par que você está configurando, verifique a linha da variável abaixo e a entrada da chave na referência de configurações. Quando a mesma variável está definida tanto no seu shell quanto em um bloco env do arquivo de configurações, o valor do arquivo de configurações se aplica. Claude Code escreve cada entrada env no ambiente do processo, substituindo o valor herdado do shell. A configuração env diz quando ela se aplica. Algumas variáveis são casos especiais; a configuração env lista as exceções. Em um arquivo de configurações você pode definir uma variável, mas não pode remover uma. Para substituir uma variável que você não pode desativar, como uma CLAUDE_CODE_USE_VERTEX obsoleta exportada por um perfil de shell que você não controla, defina-a como uma string vazia no bloco env: "CLAUDE_CODE_USE_VERTEX": "". Claude Code trata o valor vazio como não definido para seleção de provedor. Subprocessos ainda herdam o valor vazio. Entre arquivos de configurações, os valores env seguem a precedência de configurações, então uma entrada de configurações gerenciada substitui a mesma variável nas configurações de usuário ou projeto. Configurações de projeto e locais não podem definir algumas variáveis, como CLAUDE_CONFIG_DIR e as variáveis do exportador OpenTelemetry. Variáveis que Claude Code ignora em env lista-as, junto com os valores desativados do OpenTelemetry que ainda se aplicam. Como uma variável de ambiente interage com sinalizadores CLI e comandos em sessão varia por recurso: --model e /model substituem ANTHROPIC_MODEL, enquanto CLAUDE_CODE_EFFORT_LEVEL substitui --effort e /effort. Quando uma variável interage com outra fonte de configuração, sua linha na lista Variáveis declara a precedência ou vincula à página que a documenta. Claude Code lê variáveis de ambiente do shell na inicialização, então as alterações nelas entram em vigor na próxima vez que você inicia claude. As variáveis definidas sob a chave env em arquivos de configurações são reaplicadas a uma sessão em execução quando o arquivo muda, com a exceção somente na inicialização descrita em Em arquivos de configurações.

Variáveis

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

Para variáveis que ativam ou desativam um comportamento, defina 1 ou true para ativar e 0 ou false para desativar, em qualquer capitalização.Algumas variáveis leem apenas se você as definiu, então qualquer valor não vazio, incluindo 0, ativa o comportamento, e você desativa o comportamento ao desconfigurar a variável ou defini-la como um valor vazio. Essas 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 declara sua própria regra.

Variável	Propósito
`ANTHROPIC_API_KEY`	Chave de API enviada como cabeçalho `X-Api-Key`. Quando definida, essa chave é usada em vez de sua assinatura Claude Pro, Max, Team ou Enterprise, mesmo que você esteja conectado. Em modo não interativo (`-p`), a chave é sempre usada quando presente. Em modo interativo, você é solicitado a aprovar a chave uma vez antes de ela substituir sua assinatura. Para usar sua assinatura, execute `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valor personalizado para o cabeçalho `Authorization` (o valor que você definir aqui será prefixado com `Bearer` )
`ANTHROPIC_AWS_API_KEY`	Chave de API do workspace para Claude Platform on AWS, gerada no AWS Console. Enviada como `x-api-key` e tem precedência sobre AWS SigV4
`ANTHROPIC_AWS_BASE_URL`	Substitua a URL do endpoint Claude Platform on AWS. Use para regiões personalizadas ou ao rotear através de um gateway LLM. Padrão: `https://aws-external-anthropic.{region}.api.aws`. Claude Code resolve a região com a mesma precedência que no Amazon Bedrock
`ANTHROPIC_AWS_WORKSPACE_ID`	Obrigatório para Claude Platform on AWS. Enviado em cada solicitação como o cabeçalho `anthropic-workspace-id`
`ANTHROPIC_BASE_URL`	Substitua o endpoint da API para rotear solicitações através de um proxy ou gateway. Quando definido para um host que não é de primeira parte, busca de ferramentas MCP é desabilitada por padrão. Defina `ENABLE_TOOL_SEARCH=true` se seu proxy encaminha blocos `tool_reference`. A partir da v2.1.196, Remote Control é desabilitado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento no Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry
`ANTHROPIC_BEDROCK_BASE_URL`	Substitua a URL do endpoint Amazon Bedrock. Use para endpoints Amazon Bedrock personalizados ou ao rotear através de um gateway LLM. Veja Amazon Bedrock
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Substitua a URL do endpoint Amazon Bedrock Mantle. Veja endpoint Mantle
`ANTHROPIC_BEDROCK_REGION_PREFIX`	Prefixo do perfil de inferência entre regiões (`us`, `eu`, `apac`, `jp`, `au` ou `global`) que Claude Code tenta primeiro em vez do derivado da região AWS. Ignorado em regiões AWS GovCloud. Requer Claude Code v2.1.224 ou posterior. Veja Amazon Bedrock
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Nível de serviço Amazon Bedrock (`default`, `flex` ou `priority`). Enviado como o cabeçalho `X-Amzn-Bedrock-Service-Tier`. Veja Amazon Bedrock
`ANTHROPIC_BETAS`	Lista separada por vírgulas de valores de cabeçalho `anthropic-beta` adicionais para incluir em solicitações de API. Claude Code já envia os cabeçalhos beta que precisa; use isso para optar por um beta da API Anthropic antes de Claude Code adicionar suporte nativo. Diferentemente da flag `--betas`, que requer autenticação de chave de API, essa variável funciona com todos os métodos de autenticação, incluindo assinatura Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	Cabeçalhos personalizados para adicionar a solicitações (formato `Name: Value`, separados por quebra de linha para múltiplos cabeçalhos). Se um nome ou valor contiver um caractere que um cabeçalho HTTP não pode carregar, como uma aspas curva ou um espaço de largura zero, a solicitação falha com um erro que identifica o par por posição. Requer Claude Code v2.1.227 ou posterior. Valor de cabeçalho de solicitação inválido lista o conjunto exato de caracteres e onde a verificação é executada. Um valor que define um cabeçalho de credencial, org ou tenant, roteamento ou comportamento de API, como `Authorization` ou `Host`, conta como uma configuração que precisa de aprovação quando as configurações gerenciadas pelo servidor a entregam. A partir de configurações de projeto ou local, tal valor segue as regras para quando valores `env` se aplicam
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID do modelo para adicionar como entrada personalizada no seletor `/model`. Use isso para tornar um modelo não padrão ou específico de gateway selecionável sem substituir aliases integrados. Veja Configuração de modelo
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Descrição de exibição para a entrada de modelo personalizado no seletor `/model`. Padrão: `Custom model (<model-id>)` quando não definido
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	Nome de exibição para a entrada de modelo personalizado no seletor `/model`. Quando não definido, a entrada mostra o nome do modelo se Claude Code reconhecer o ID, e o ID do modelo caso contrário
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Lista separada por vírgulas de capacidades que o modelo personalizado suporta, por exemplo `effort,thinking`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL`	ID do modelo que o alias `fable` resolve para, e o ID que Claude Code reconhece como um modelo Fable para fallback automático de modelo em provedores de terceiros. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Descrição de exibição para o modelo Fable fixado no seletor `/model`. Quando não definido, a linha mostra uma descrição padrão que começa com `Custom Fable model`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Nome de exibição para o modelo Fable fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Veja 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`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	ID do modelo que o alias `haiku` resolve para, também usado para funcionalidade em background. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Descrição de exibição para o modelo Haiku fixado no seletor `/model`. Quando não definido, a linha mostra uma descrição padrão que começa com `Custom Haiku model`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Nome de exibição para o modelo Haiku fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Veja 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`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_MODEL`	Modelo em que novas sessões começam por padrão. Requer Claude Code v2.1.236 ou posterior. Veja Defina um modelo padrão para novas sessões
`ANTHROPIC_DEFAULT_OPUS_MODEL`	ID do modelo que o alias `opus` resolve para, e que `opusplan` usa enquanto Plan Mode está ativo. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Descrição de exibição para o modelo Opus fixado no seletor `/model`. Quando não definido, a linha mostra uma descrição padrão que começa com `Custom Opus model`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Nome de exibição para o modelo Opus fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Veja 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`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL`	ID do modelo que o alias `sonnet` resolve para, e que `opusplan` usa quando Plan Mode não está ativo. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Descrição de exibição para o modelo Sonnet fixado no seletor `/model`. Quando não definido, a linha mostra uma descrição padrão que começa com `Custom Sonnet model`. Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Nome de exibição para o modelo Sonnet fixado no seletor `/model`. Quando não definido, a linha mostra o nome do modelo se Claude Code reconhecer o ID fixado, e o ID fixado caso contrário. Veja 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`. Veja Configuração de modelo
`ANTHROPIC_FEDERATION_RULE_ID`	ID da regra de federação para Workload Identity Federation. Quando você a define junto com `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleciona credenciais de federação, que têm precedência sobre sua credencial `/login`. Veja precedência de autenticação
`ANTHROPIC_FOUNDRY_API_KEY`	Chave de API para autenticação Microsoft Foundry (veja Microsoft Foundry)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Token Bearer para autenticação Microsoft Foundry, como um token de acesso Microsoft Entra. Claude Code o envia como o cabeçalho `Authorization: Bearer`. Tem precedência sobre `ANTHROPIC_FOUNDRY_API_KEY` e sobre a cadeia de credencial padrão do Azure. Veja Microsoft Foundry. Requer Claude Code v2.1.203 ou posterior
`ANTHROPIC_FOUNDRY_BASE_URL`	URL base completa para o recurso Microsoft Foundry (por exemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (veja Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nome do recurso Microsoft Foundry (por exemplo, `my-resource`). Obrigatório se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definido (veja Microsoft Foundry)
`ANTHROPIC_MODEL`	Nome da configuração de modelo a usar (veja Configuração de Modelo)
`ANTHROPIC_ORGANIZATION_ID`	ID da organização para Workload Identity Federation. Defina junto com `ANTHROPIC_FEDERATION_RULE_ID`. Veja precedência de autenticação
`ANTHROPIC_PROFILE`	Nome do perfil Anthropic para autenticar, como um criado por `ant auth login` ou por entrar em uma conta Console sem uma chave de API. Veja precedência de autenticação
`ANTHROPIC_SMALL_FAST_MODEL`	[DEPRECATED] Nome de modelo classe Haiku para tarefas em background
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Substitua a região AWS para o modelo classe Haiku ao usar Amazon Bedrock ou Amazon Bedrock Mantle. No Amazon Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou o deprecated `ANTHROPIC_SMALL_FAST_MODEL` também está definido, já que Amazon Bedrock caso contrário executa tarefas em background no modelo Sonnet padrão ou no modelo primário na região da sessão
`ANTHROPIC_VERTEX_BASE_URL`	Substitua a URL do endpoint Google Cloud’s Agent Platform. Use para endpoints Google Cloud’s Agent Platform personalizados ou ao rotear através de um gateway LLM. Veja Google Cloud’s Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID do projeto GCP para o qual as solicitações Google Cloud’s Agent Platform são endereçadas. Veja Configurar credenciais GCP
`ANTHROPIC_WORKSPACE_ID`	ID do workspace para federação de identidade de carga de trabalho. Defina isso quando sua regra de federação está no escopo de mais de um workspace para que a troca de token saiba qual workspace direcionar
`API_FORCE_IDLE_TIMEOUT`	Substitua o timeout de inatividade do corpo de 5 minutos que aborta uma resposta de modelo de streaming quando nenhum byte chega. Defina como `0` para desativar o timeout, por exemplo quando um gateway lento ou modelo local pausa por mais de 5 minutos entre chunks, ou `1` para mantê-lo ativo para cada provedor. Quando não definido, o timeout está ativo em provedores diferentes da API Anthropic direta e Claude Platform on AWS. Os watchdogs de stream funcionam independentemente e abortam uma pausa longa silenciosa mesmo quando você define `0` aqui
`API_TIMEOUT_MS`	Timeout para solicitações de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente isso quando as solicitações expiram em redes lentas ou ao rotear através de um proxy. Valores acima do máximo causam overflow do timer subjacente e fazem as solicitações falharem imediatamente
`AWS_BEARER_TOKEN_BEDROCK`	Chave de API Amazon Bedrock para autenticação (veja Chaves de API Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Timeout padrão para comandos bash de longa duração (padrão: 120000, ou 2 minutos)
`BASH_MAX_OUTPUT_LENGTH`	Número máximo de caracteres de saída bash que Claude Code lê de volta para o resultado de um comando (padrão: 30000; máximo: 150000). Se você definir a configuração `bashOutputMaxChars`, Claude Code ignora essa variável. Veja Limites de saída
`BASH_MAX_TIMEOUT_MS`	Timeout máximo que o modelo pode definir para comandos bash de longa duração (padrão: 600000, ou 10 minutos). O teto efetivo é o maior entre isso e `BASH_DEFAULT_TIMEOUT_MS`
`BETA_TRACING_ENDPOINT`	Endpoint OTLP para rastreamento beta detalhado: com `ENABLE_BETA_TRACING_DETAILED=1`, logs e rastreamentos vão para lá em vez de para os exportadores configurados. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local
`CCR_FORCE_BUNDLE`	Defina como `1` para forçar `claude --cloud` a agrupar e fazer upload do seu repositório local em vez de clonar de seu remoto
`CLAUDECODE`	Defina como `1` em subprocessos que Claude Code gera (ferramentas Bash e PowerShell, sessões tmux, comandos hook, comandos status line, subprocessos servidor MCP stdio). Extensões IDE também definem isso em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso gerado por Claude Code. Para verificar se o processo atual foi gerado diretamente por uma chamada de ferramenta ou hook, em vez de dentro de um servidor MCP stdio que Claude Code iniciou, use `CLAUDE_CODE_CHILD_SESSION`
`CLAUDE_AFK_COUNTDOWN_MS`	Quantos milissegundos antes de auto-continuar a contagem regressiva na tela aparece em um diálogo `AskUserQuestion` sem resposta. Padrão `20000` (20 segundos), limitado ao timeout de auto-continuação. Não tem efeito a menos que auto-continuação esteja ativada; veja a configuração `askUserQuestionTimeout` e `CLAUDE_AFK_TIMEOUT_MS`. Requer Claude Code v2.1.198 ou posterior
`CLAUDE_AFK_TIMEOUT_MS`	Quantos milissegundos de tempo ocioso antes de um diálogo `AskUserQuestion` sem resposta auto-continuar sem você. Auto-continuação está desativada por padrão; opte por ela com a configuração `askUserQuestionTimeout`. Essa variável é uma substituição para demos e testes automatizados: quando definida, tem precedência sobre essa configuração e ativa auto-continuação mesmo quando a configuração não está definida ou é `never`. Definir `0` não desativa o timeout; fecha o diálogo imediatamente. Na v2.1.198 e v2.1.199, auto-continuação estava ativada por padrão com um timeout de `60000` (60 segundos). Requer Claude Code v2.1.198 ou posterior
`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`	Defina como `1` para desabilitar todos os tipos de subagente integrados, como Explore e Plan. Aplica-se apenas em modo não interativo (flag `-p`). Útil para usuários SDK que querem uma tela em branco. Isso também remove `general-purpose`, o subagente que Claude Code executa quando uma chamada de 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 pular o prefixo `mcp__<server>__` em nomes de ferramentas de servidores MCP criados por SDK. As ferramentas usam seus nomes originais. Apenas uso SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Timeout de travamento em milissegundos para subagentes. Padrão `600000` (10 minutos); se você aumentar `CLAUDE_STREAM_IDLE_TIMEOUT_MS` enquanto o watchdog de stream está ativo, o padrão sobe com ele, como Lidar com respostas de API lentas ou travadas descreve. O timer reinicia em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, Claude Code aborta o subagente e relata o travamento ao pai
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Defina a porcentagem (1-100) da janela de auto-compactação em que a auto-compactação é acionada. Use valores mais baixos como `50` para compactar mais cedo; a variável não pode aumentar o limite, então valores acima da porcentagem padrão são ignorados. Aplica-se apenas em sessões que compactam antes do limite de contexto do modelo. Aplica-se a conversas principais e subagentes
`CLAUDE_AUTO_BACKGROUND_TASKS`	Defina como `1` para forçar a ativação do backgrounding automático de tarefas de agente de longa duração. Quando ativado, subagentes são movidos para o background após executar por aproximadamente dois minutos. Também ativa backgrounding automático de chamadas de ferramentas MCP longas em modo não interativo no Claude Code v2.1.212 ou posterior
`CLAUDE_AX_PREPARK_MS`	Em modo leitor de tela, quantos milissegundos Claude Code aguarda, com o cursor no início da linha, antes de escrever uma linha nova ou alterada. Padrão `50`. Defina `0` para escrever imediatamente. Claude Code limita a espera a `5000`. Requer Claude Code v2.1.233 ou posterior
`CLAUDE_AX_SCREEN_READER`	Defina como `1` para renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Defina como `0` para forçar o modo leitor de tela desativado mesmo quando `axScreenReader` é `true`. A flag `--ax-screen-reader` tem precedência. Requer Claude Code v2.1.181 ou posterior
`CLAUDE_AX_STARTUP_QUIET_MS`	Em modo leitor de tela, quantos milissegundos Claude Code mantém a primeira renderização de interface após a linha de confirmação de inicialização, para que seu leitor de tela possa falar a linha completamente antes que nova saída a interrompa. Padrão `3000`. Defina `0` para renderizar imediatamente. Claude Code limita a retenção a `600000` (10 minutos). Seu primeiro pressionamento de tecla encerra a retenção mais cedo. Requer Claude Code v2.1.217 ou posterior
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Retorne 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 em nível de byte; quando definido, tem precedência sobre `CLAUDE_STREAM_IDLE_TIMEOUT_MS` para esse watchdog e deixa o watchdog em nível de evento inalterado. Claude Code limita essa variável entre 10 segundos e 30 minutos. Requer Claude Code v2.1.210 ou posterior
`CLAUDE_CLIENT_PRESENCE_FILE`	Caminho para um arquivo que uma ferramenta externa, como um ouvinte de bloqueio de tela, cria quando você desbloqueia sua tela e exclui quando você a bloqueia. Enquanto o arquivo existe, Claude Code pula notificações push móveis Remote Control, para que você pare de receber pushes enquanto está usando ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. Claude Code verifica o arquivo uma vez por evento de disparo de push em vez de fazer polling. Requer Claude Code v2.1.181 ou posterior
`CLAUDE_CODE_ACCESSIBILITY`	Defina como `1` para manter o cursor do terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor
`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_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 repintar a tela inteira em cada quadro em renderização fullscreen em vez de enviar atualizações incrementais. Use isso se o modo fullscreen mostrar fragmentos de texto obsoletos ou deslocados. Claude Code ativa isso automaticamente para sessões em background e agent view no Windows
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Defina como `1` para enviar o parâmetro effort com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de effort. Use isso ao rotear através de um gateway LLM ou provedor de terceiros que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro effort na API, incluindo modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, ainda são excluídos para que as solicitações não falhem
`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`	Intervalo em milissegundos em que as credenciais devem ser atualizadas (ao usar `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Defina como `0` para impedir que Claude Code abra o navegador automaticamente quando um novo artifact é publicado
`CLAUDE_CODE_ARTIFACT_COMMENTS`	Defina como `0` para parar Claude de ler e responder a comentários em um artifact. Não tem efeito quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` desativou artifacts. Requer Claude Code v2.1.221 ou posterior
`CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT`	Defina como `0` para parar Claude de responder por conta própria a comentários enviados para ele. Requer Claude Code v2.1.228 ou posterior
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Defina como `0` para omitir o bloco de atribuição, que carrega a versão do cliente e uma impressão digital de prompt, do início do prompt do sistema. O cache em uma conexão direta com a API Anthropic não é afetado de qualquer forma. Em algumas configurações de conexão direta, Claude Code mantém o bloco em solicitações do classificador modo auto mesmo quando você define `0`. Em Bloco de atribuição de prompt do sistema, verifique quais conexões e credenciais isso cobre. Antes da v2.1.181, o bloco incluía um token por solicitação em URLs de base personalizadas e conexões Microsoft Foundry, então nessas versões defina como `0` quando seu gateway LLM faz cache no corpo da solicitação ou encaminha solicitações para um provedor de terceiros, ou quando você se conecta ao Microsoft Foundry diretamente
`CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS`	Quando `CLAUDE_AUTO_BACKGROUND_TASKS` está ativado, segundos entre lembretes para Claude verificar subagentes em background que ainda estão em execução. Aceita um inteiro simples de `1` a `86400` apenas; qualquer outro valor ou grafia lê como não definido. Quando não definido, não há lembretes de check-in. Requer Claude Code v2.1.248 ou posterior
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Defina a janela de auto-compactação em tokens, de `100000` a `1000000`. Aceita apenas um inteiro simples como `500000`: um valor como `500k` lê como `500` e é limitado 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`. A `used_percentage` da status line sempre mede contra a janela de contexto completo do modelo, então uma vez que essa variável está definida, essa porcentagem não indica mais quando a compactação será executada
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Substitua a conexão IDE automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro de um terminal integrado de IDE suportado. Defina como `false` para evitar isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global `autoConnectIde`
`CLAUDE_CODE_AUTO_MODE_SERVER`	Controla se Claude Code pede ao servidor para revisar ações de modo auto. Defina como `0` para usar as solicitações do classificador próprio de Claude Code. Em uma conexão direta com a API Anthropic, requer v2.1.281 ou posterior. A seção vinculada lista quais sessões pedem ao servidor quando a variável não está definida, e a partir de qual versão. Requer Claude Code v2.1.271 ou posterior
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tempo em milissegundos que Claude Code aguarda a cadeia de provedor de credencial padrão AWS produzir credenciais antes da solicitação falhar com `AWS default-chain credential resolve timed out` (padrão: `60000`). Aumente quando uma etapa em sua cadeia legitimamente precisa de mais tempo, como um sign-in baseado em navegador com MFA através de um wrapper como `aws-vault`. Aplica-se em qualquer lugar que Claude Code assine com a cadeia padrão: Amazon Bedrock, Claude Platform on AWS e o endpoint Mantle. Requer Claude Code v2.1.207 ou posterior
`CLAUDE_CODE_BASH_EDIT_DIFF`	Defina como `0` para desativar o diff dos arquivos que mudaram enquanto um comando Bash foi executado, ou `1` para registrá-lo em cada modo de permissão. Tem precedência sobre a configuração `bashEditDiffEnabled`. Requer Claude Code v2.1.269 ou posterior
`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`	Defina como `0` para fazer uma sessão não interativa relatar um status ocioso ao seu host no final de cada turno, mesmo enquanto o trabalho em background ainda está em execução. Por padrão, a sessão continua relatando um status em execução após o final do turno enquanto trabalho em background, como um agente em background ou uma execução de workflow, ainda está ativo. Isso mantém um host que observa o status, como uma lista de sessão remota, de anunciar que Claude está aguardando sua entrada no meio do trabalho. Comandos shell em background, como um servidor dev, não mantêm o status em execução. O padrão de status em execução e a opção de desativação `0` requerem Claude Code v2.1.269 ou posterior; em versões anteriores, defina `1` para manter o status em execução
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Defina automaticamente em subprocessos de ferramenta Bash e comando hook enquanto a sessão tem uma conexão Remote Control ativa, e removido quando a conexão termina. O valor é o ID da sessão em forma `session_`, o mesmo identificador que aparece na URL `claude.ai/code` da sessão, para que um script possa vincular de volta à sessão que o executou. Requer Claude Code v2.1.199 ou posterior. Em sessões em nuvem, leia `CLAUDE_CODE_REMOTE_SESSION_ID`
`CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`	Defina como `0` para fazer Claude Code ler o byte `0x08`, também escrito `^H`, como Backspace simples, ou `1` para lê-lo como Ctrl+Backspace. Qualquer valor substitui o padrão da plataforma. Por padrã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 Linux. Defina `0` em um terminal Windows onde Backspace exclui uma palavra inteira
`CLAUDE_CODE_CERT_STORE`	Lista separada por vírgulas de fontes de certificado CA para conexões TLS. `bundled` é o conjunto Mozilla CA enviado com Claude Code. `system` é o armazenamento 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 npm. Veja Armazenamento de certificado CA. Padrão é `bundled,system`
`CLAUDE_CODE_CHILD_SESSION`	Defina como `1` em subprocessos que Claude Code gera via ferramentas Bash, PowerShell e Monitor, comandos hook e comandos status line. Não definido para subprocessos servidor MCP stdio, que são de longa duração e sobrevivem à sessão que os gerou. Diferentemente de `CLAUDECODE`, isso é definido apenas por Claude Code quando ele inicia um subprocesso e não por extensões IDE, então distingue confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado IDE. Um `claude` TUI interativo aninhado iniciado dessa forma é automaticamente excluído de `--resume`, `--continue`, histórico de seta para cima e a lista `claude agents`. Sessões não interativas `claude -p` ainda persistem. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para substituir essa exclusão. Requer Claude Code v2.1.172 ou posterior
`CLAUDE_CODE_CLIENT_CERT`	Caminho para arquivo de certificado de cliente para autenticação mTLS
`CLAUDE_CODE_CLIENT_KEY`	Caminho para arquivo de chave privada de cliente para autenticação mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Frase-passe para CLAUDE_CODE_CLIENT_KEY criptografado (opcional)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Removido na v2.1.186 e agora é um no-op. Anteriormente definia um timeout separado para a fase de conexão, TLS e cabeçalho de resposta de uma solicitação de API de streaming. Use `API_TIMEOUT_MS` para o timeout por solicitação. Para a fase de cabeçalho de resposta de uma solicitação de streaming, veja `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Substitua o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja ativado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas essa variável não ativa o logging. A flag `--debug-file` faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_LEVEL`	Nível de log mínimo escrito no arquivo de log de depuração. Valores: `verbose`, `debug` (padrão), `info`, `warn`, `error`. Defina como `verbose` para incluir diagnósticos de alto volume como saída completa de comando de status line, ou aumente para `error` para reduzir ruído
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Defina como `1` para desabilitar suporte a janela de contexto 1M. Quando definido, variantes de modelo 1M não estão disponíveis no seletor de modelo, e Claude Code mantém sessões em modelos com uma janela nativa 1M, como Sonnet 5.5 e os modelos Fable, para uma janela 200K; veja Contexto estendido para como a retenção é aplicada. Útil para ambientes empresariais com requisitos de conformidade. Para seu papel em corrigir a janela para um ID de modelo não reconhecido `[1m]`, veja Corrigir a janela para um ID de modelo de gateway ou personalizado
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	Defina como `1` para desabilitar raciocínio adaptativo em Opus 4.6 e Sonnet 4.6 e voltar ao orçamento de pensamento fixo controlado por `MAX_THINKING_TOKENS`. Não tem efeito em modelos Fable, Sonnet 5 ou Opus 4.7 e posterior, que sempre usam raciocínio adaptativo
`CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION`	Defina como `1` para parar Claude Code de mesclar blocos `env` de configurações gerenciadas por chave em fontes de admin, para que apenas o bloco `env` da fonte de prioridade mais alta se aplique, como antes da v2.1.223. Defina no ambiente que inicia Claude Code, já que Claude Code ignora uma cópia entregue através de um bloco `env` de configurações. Requer Claude Code v2.1.223 ou posterior
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Defina como `1` para desabilitar a ferramenta advisor. O comando `/advisor` fica indisponível, qualquer `advisorModel` configurado é ignorado, e a flag `--advisor` é aceita mas não tem efeito, para que scripts existentes que a passam continuem funcionando sem erros
`CLAUDE_CODE_DISABLE_AGENT_VIEW`	Defina como `1` para desativar agentes em background e agent view: `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Defina como `1` para desabilitar renderização fullscreen e usar o renderizador de tela principal clássico. A conversa fica no scrollback nativo do seu terminal para que `Cmd+f` e modo de cópia tmux funcionem como de costume. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração `tui`. Você também pode alternar com `/tui default`. Não se aplica a sessões em background abertas de agent view, que sempre usam renderização fullscreen
`CLAUDE_CODE_DISABLE_ARTIFACT`	Defina como `1` para desativar a ferramenta Artifact, que publica saída de sessão como uma página web privada em claude.ai. Uma vez que você a define, nenhum arquivo de configurações ativa a ferramenta novamente. Para desativar a ferramenta de um arquivo de configurações, defina `enableArtifact` como `false`; a chave deprecated `disableArtifact` também a desativa
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Defina como `1` para desabilitar processamento de anexos. Menções de arquivo com sintaxe `@` são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Defina como `1` para desabilitar memória automática. Defina como `0` para forçar memória automática ativada mesmo quando modo `--bare` ou `autoMemoryEnabled: false` desabilitaria. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Defina como `1` para desabilitar toda funcionalidade de tarefa em background, incluindo o parâmetro `run_in_background` em ferramentas Bash e subagente, auto-backgrounding e o atalho Ctrl+B
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT`	Defina como `1` para parar Claude Code de tratar uma resposta de streaming Amazon Bedrock com cabeçalho `Content-Type` ausente ou vazio como fluxo de evento binário Amazon Bedrock. Por padrão, Claude Code assume que um gateway descartou o cabeçalho de uma resposta caso contrário não modificada, para que decodifique o corpo e o streaming continue funcionando. Defina isso apenas para um gateway que também re-emite o stream como eventos enviados pelo servidor; Claude Code então lê o corpo sem cabeçalho como eventos enviados pelo servidor. Requer Claude Code v2.1.239 ou posterior
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Defina como `1` para pular a verificação de que uma resposta de streaming Amazon Bedrock carrega o tipo de conteúdo `application/vnd.amazon.eventstream`. Sem essa variável, quando uma resposta carrega um tipo de conteúdo diferente, Claude Code falha a solicitação com um erro nomeando 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 não modificados em vez de definir essa variável. Requer Claude Code v2.1.208 ou posterior
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	Defina como `1` para parar os comandos shell em background em execução de uma sessão em background, workflows dinâmicos, e, a partir da v2.1.198, subagentes em background 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 esse handoff: backgrounding uma sessão com `←` ou `/background` ainda carrega trabalho em voo, 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 parar Claude Code de encerrar comandos shell em background sob pressão de memória. Por padrão, no macOS e Linux, Claude Code encerra shells em background quando o sistema operacional relata pressão de memória crítica e a sessão está ociosa há 30 minutos sem turno ou subagente em execução. Windows não tem sinal de pressão de memória, então essa variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior
`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`	Defina como `1` para desabilitar as skills e workflows inclusos com Claude Code: skills inclusos e workflows são removidos completamente, enquanto comandos integrados como `/init` permanecem digitáveis mas são ocultados do modelo. `/doctor` permanece digitável como os comandos integrados; ocultá-lo com `DISABLE_DOCTOR_COMMAND`. Skills de plugins, `.claude/skills/` e `.claude/commands/` não são afetadas. Equivalente à configuração `disableBundledSkills`
`CLAUDE_CODE_DISABLE_CFC_PROMPT`	Defina como `1` para manter as ferramentas de navegador Claude in Chrome disponíveis enquanto omite a seção Chrome do prompt do sistema e a skill incluída `/claude-in-chrome`. Para hosts que incorporam Claude Code e fornecem sua própria orientação de navegador. Requer Claude Code v2.1.257 ou posterior
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Defina como `1` para evitar carregar qualquer arquivo de memória CLAUDE.md em contexto, incluindo arquivos de memória de usuário, projeto e automática
`CLAUDE_CODE_DISABLE_CRON`	Defina como `1` para desabilitar tarefas agendadas. A skill `/loop` e ferramentas cron ficam indisponíveis e qualquer tarefa já agendada para de disparar, incluindo tarefas que já estão em execução no meio da sessão
`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`	Defina como `1` para desativar o limite de tempo em prompts de remoção de caminho crítico. Em modo `auto`, Claude Code então envia essas remoções para o classificador, e em modo `bypassPermissions`, o prompt aguarda sua resposta. Defina no ambiente que inicia Claude Code, já que Claude Code ignora uma cópia entregue através de um bloco `env` de configurações. Requer Claude Code v2.1.281 ou posterior
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Defina como `1` para remover cabeçalhos de solicitação `anthropic-beta` específicos de Anthropic e campos de esquema de ferramenta beta (como `defer_loading` e `eager_input_streaming`) de solicitações de API. Use isso quando um gateway proxy rejeita solicitações com erros como “Unexpected value(s) for the `anthropic-beta` header” ou “Extra inputs are not permitted”. Campos padrão (`name`, `description`, `input_schema`, `cache_control`) são preservados. Busca de ferramentas MCP é desabilitada e todas as ferramentas MCP carregam antecipadamente, mesmo quando você define `ENABLE_TOOL_SEARCH`. No Claude Code v2.1.227 ou posterior, configurações gerenciadas podem manter a busca de ferramentas ativada. Desabilitar capacidades de pré-lançamento cobre onde a substituição se aplica
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Defina como `1` para desabilitar os subagentes Explore e Plan integrados. Claude explora com suas ferramentas de busca ou o subagente de propósito geral, e modo plan lê arquivos diretamente em vez de iniciar agentes Explore e Plan. Subagentes personalizados nomeados `Explore` ou `Plan` não são afetados. Para remover todo tipo de subagente integrado no Agent SDK ou modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Requer Claude Code v2.1.198 ou posterior
`CLAUDE_CODE_DISABLE_FAST_MODE`	Defina como `1` para desabilitar modo rápido
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Defina como `1` para desabilitar as pesquisas de qualidade de sessão “How is Claude doing?”. As pesquisas também são desabilitadas quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` opte por voltar. Para definir uma taxa de amostra em vez de desabilitar completamente, use a configuração `feedbackSurveyRate`. Veja Pesquisas de qualidade de sessão
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Defina como `1` para desabilitar checkpointing de arquivo. O comando `/rewind` não será capaz de restaurar alterações de código. Substitui a configuração `fileCheckpointingEnabled`
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Defina como `1` para remover instruções de workflow de commit e PR integradas e o snapshot de status git do contexto de Claude. Útil ao usar suas próprias skills de workflow git. Tem precedência sobre a configuração `includeGitInstructions` quando definido
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP`	Defina como `1` para evitar remapeamento automático de Opus 4.0 e 4.1 para a versão Opus atual na API Anthropic. Use quando você intencionalmente quer fixar um modelo mais antigo. O remapeamento não é executado no Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft Foundry
`CLAUDE_CODE_DISABLE_MOUSE`	Defina como `1` para desabilitar rastreamento de mouse em renderização fullscreen. Rolagem de teclado com `PgUp` e `PgDn` ainda funciona. Use isso para manter o comportamento de cópia ao selecionar nativo do seu terminal
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Defina como `1` para desabilitar manipulação de clique, arrasto e hover em renderização fullscreen enquanto mantém rolagem de roda do mouse. Use isso quando você quer que a rolagem de roda funcione dentro de Claude Code mas não quer que cliques posicionem o cursor, expandam saída de ferramenta ou abram links. `CLAUDE_CODE_DISABLE_MOUSE` tem precedência quando ambos estão definidos. Requer Claude Code v2.1.195 ou posterior
`CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION`	Defina como `1` para parar Claude Code de re-ler o certificado de cliente mTLS e chave quando uma solicitação de API falha com um erro em nível de conexão, como uma redefinição de conexão ou erro de handshake TLS. Com o recarregamento desabilitado, Claude Code carrega arquivos rotacionados apenas quando aplica configurações novamente ou na próxima inicialização. Requer Claude Code v2.1.232 ou posterior
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Defina como qualquer valor não vazio, como `1`, para desabilitar tráfego de rede não essencial: auto-atualizações, telemetria, relatório de erros, comando `/feedback`, feedback redigido por Claude, notas de lançamento, verificações de badge de status PR e MR e verificações de disponibilidade como a verificação de modo rápido. Também para as execuções em background de fontes de `command` de plugin, que são comandos locais em vez de tráfego de rede, porque podem disparar instalações de dependência. Defini-lo como `0` ou `false` ainda desabilita esse tráfego, diferentemente da maioria das variáveis on/off; desconfigurar a variável para permitir novamente. Também desabilita busca de sinalizador de recurso, o que torna Remote Control e os outros recursos que precisam de busca de sinalizador de recurso indisponíveis. Auto-instalação do marketplace de plugin oficial não é coberta; desabilite com `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Não afeta descoberta de modelo de gateway, que tem seu próprio opt-in
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Defina como `1` para desabilitar o fallback não-streaming quando uma solicitação de streaming falha no meio do stream. Erros de streaming se propagam para a camada de retry. Útil quando um proxy ou gateway causa o fallback produzir execução de ferramenta duplicada
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Defina como `1` para enviar a notificação de desktop da ferramenta `PushNotification` mesmo enquanto você está digitando ou focado no terminal. Por padrão, a ferramenta pula tanto a notificação de desktop quanto o push móvel quando detecta atividade de teclado recente ou foco de terminal. Essa variável desabilita apenas essa verificação local, para que o servidor ainda possa suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Defina como `1` para desabilitar registro automático do marketplace de plugin oficial. Claude Code lê a variável quando está prestes a registrar o marketplace, geralmente durante o primeiro lançamento interativo de uma máquina. Se a variável estiver definida nesse ponto, Claude Code pula o registro permanentemente. Desconfigurar a variável depois não desfaz o pulo. 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 parar Claude Code de executar seus hooks `Notification` para solicitações de permissão sem resposta em sessões onde Claude Code as envia para o callback `canUseTool` do Agent SDK, que é como Claude Desktop e a extensão VS Code hospedam Claude Code. Não tem efeito em sessões de terminal. Requer Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Defina como `1` para pular carregamento de skills do diretório de skills gerenciadas em todo o sistema. Útil para sessões de container ou CI que não devem carregar skills provisionadas por operador
`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`	Defina como `1` para desativar a verificação da ferramenta PowerShell que nega os built-ins `cmd` `rd`, `rmdir`, `del` e `erase` em um caminho do sistema, como uma raiz de unidade ou seu diretório inicial. Claude Code ignora essa variável em um bloco `env` de arquivo de configurações. Requer Claude Code v2.1.283 ou posterior
`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`	Defina como `1` para desativar a verificação de caminho crítico para um `rm` recursivo cujo alvo é inteiramente a saída de uma substituição de comando, como `rm -rf "$(pwd)"`. As outras verificações de caminho crítico continuam em execução. Defina no ambiente que inicia Claude Code, já que Claude Code ignora uma cópia entregue através de um bloco `env` de configurações. Requer Claude Code v2.1.281 ou posterior
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Defina como `1` para desabilitar atualizações automáticas de título de terminal com base no contexto de conversa. Isso também pula a solicitação de modelo pequeno/rápido em background que gera um título de sessão
`CLAUDE_CODE_DISABLE_THINKING`	Defina como `1` para omitir o parâmetro `thinking` de solicitações de API completamente. 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 desabilitar explicitamente pensamento estendido na API Anthropic, use `MAX_THINKING_TOKENS=0`. Nenhuma variável desativa pensamento em Opus 5.5, Sonnet 5.5 ou modelos Fable, que não podem ter pensamento desativado. Em provedores de terceiros, `MAX_THINKING_TOKENS=0` igualmente omite o parâmetro, para que as duas variáveis se comportem igual lá
`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT`	Defina como `1` para pular auto-compactação proativa quando Claude Code não reconhece o ID do modelo, como um alias de gateway LLM. Sem essa variável, Claude Code compacta na janela de contexto que assume para o ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` pode corrigir a janela assumida; veja Corrigir a janela para um ID de modelo de gateway ou personalizado para quando cada variável se aplica. Requer Claude Code v2.1.223 ou posterior
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Defina como `1` para desabilitar rolagem virtual em renderização fullscreen e renderizar cada mensagem na transcrição. Use isso se a rolagem em modo fullscreen mostrar regiões em branco onde mensagens devem aparecer
`CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER`	Defina como `1` para iniciar comandos da ferramenta PowerShell no Windows diretamente em vez de através do launcher `cmd.exe`. Por padrão, o launcher permite que um comando PowerShell em execução em background seja transferido para o próximo processo da sessão, como quando você coloca a sessão em background. Se você definir a variável, um comando PowerShell em background para quando o processo da sessão sai. Comandos Bash não são afetados. Requer Claude Code v2.1.269 ou posterior
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Defina como `1` para desabilitar workflows. Equivalente à configuração `disableWorkflows`
`CLAUDE_CODE_EFFORT_LEVEL`	Defina o nível de effort para modelos suportados. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `--effort`, `/effort` e as configurações `modelSettings` e `effortLevel`. Um limite `maxEffortLevel` ainda se aplica. Veja Ajustar nível de effort
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Aceito para compatibilidade com versões mais antigas e não tem efeito. Modo auto está disponível por padrão em cada provedor, incluindo Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry e sessões gateway de aplicativos Claude conectadas. Na v2.1.158 através v2.1.206, definir isso como `1` era necessário para tornar modo auto disponível nesses provedores
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Substitua disponibilidade de recapitulação de sessão. Defina como `0` para forçar recapitulações desativadas independentemente do toggle `/config`. Defina como `1` para forçar recapitulações ativadas quando `awaySummaryEnabled` é `false`. Tem precedência sobre a configuração e toggle `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Defina como `1` para atualizar estado de plugin em limites de turno em modo não interativo após uma instalação em background ser concluída. Desativado por padrão porque a atualização muda o prompt do sistema no meio da sessão, o que invalida cache de prompt para esse turno
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Defina como `1` para rotear a pesquisa de qualidade de sessão “How is Claude doing?” para seu próprio coletor OpenTelemetry quando tráfego não essencial vinculado a Anthropic é bloqueado. Classificações de pesquisa são emitidas apenas como eventos OTEL para seu coletor configurado. Nenhum dado de pesquisa é enviado para Anthropic neste modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` está definido, e não tem efeito caso contrário. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e a política de feedback de produto da organização têm precedência
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controla se entradas de chamada de ferramenta fazem stream da API conforme Claude as gera. Com isso desativado, uma entrada de ferramenta grande como uma escrita de arquivo longa chega apenas após Claude terminar de gerá-la, o que pode parecer que está travando. Ativado por padrão na API Anthropic. No Amazon Bedrock e Google Cloud’s Agent Platform, ativado por modelo onde o container implantado o suporta. Defina como `0` para desativar. Defina como `1` para forçar ativado ao rotear através de um proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Desativado por padrão em Microsoft Foundry e conexões gateway
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Defina como `1` para popular o seletor `/model` do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` aponta para um gateway compatível com Anthropic como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque gateways apoiados por uma chave de API compartilhada mostrariam cada usuário cada modelo que a chave pode acessar. Modelos descobertos ainda são filtrados por uma lista de permissão `availableModels` que a sessão recebe; entregue a lista através de MDM ou arquivo de configurações gerenciadas, já que entrega gerenciada pelo servidor não está disponível em configurações de gateway
`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`	Removido na v2.1.142, quando o padrão de modo rápido se moveu de Opus 4.6 para Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Defina como `false` para desativar sugestões de prompt, as previsões acinzentadas que aparecem em sua entrada de prompt. Tem precedência sobre a configuração `promptSuggestionEnabled`, que é o que o toggle Prompt suggestions em `/config` escreve. Claude Code também pausa sugestões enquanto sua conta está próxima ou no limite de uso. Defina como `true` para mantê-las ativadas até atingir o limite. Requer Claude Code v2.1.238 ou posterior. Veja Sugestões de prompt
`CLAUDE_CODE_ENABLE_TASKS`	Seleciona quais ferramentas de rastreamento de tarefas Claude Code fornece em sessões que as têm. Por padrão, Claude Code fornece as ferramentas Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Defina como `0` para obter a ferramenta legacy `TodoWrite`. Veja Lista de tarefas
`CLAUDE_CODE_ENABLE_TELEMETRY`	Defina como `1` para ativar coleta de dados OpenTelemetry para métricas e logging. Necessário antes de configurar exportadores OTel. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local. Veja Monitoramento
`CLAUDE_CODE_ENABLE_TODO_TOOLS`	Defina como `1` para obter as ferramentas de rastreamento de tarefas em cada modelo. Sem isso, Claude Code as fornece por padrão apenas nos modelos listados em Disponibilidade de ferramenta Task. `CLAUDE_CODE_ENABLE_TASKS` ainda seleciona as ferramentas Task ou `TodoWrite`. Requer Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tempo em milissegundos para aguardar após o loop de consulta ficar ocioso antes de sair automaticamente. Útil para workflows automatizados e scripts usando modo SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Defina como `1` para ativar equipes de agentes. Equipes de agentes são experimentais e desabilitadas por padrão
`CLAUDE_CODE_EXTRA_BODY`	Objeto JSON para mesclar no nível superior de cada corpo de solicitação de API. Útil para passar parâmetros específicos do provedor que Claude Code não expõe diretamente. Um valor exportado em seu shell também se aplica às sessões em background que você despacha com `claude agents` ou `--bg`. Antes da v2.1.206, sessões em background ignoravam um valor exportado em shell e usavam qualquer cópia que o processo supervisor em background herdasse
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Substitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores completamente
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Defina como `1` para forçar persistência de transcrição, histórico de prompt e registro `claude agents` mesmo quando este `claude` foi iniciado de dentro de outra sessão Claude Code. Use quando um valor `CLAUDE_CODE_CHILD_SESSION` herdado, por exemplo de uma sessão `screen` ou um launcher em background iniciado primeiro pela ferramenta Bash de Claude Code, causa uma sessão genuína de nível superior a ser mal classificada como aninhada. A partir da v2.1.178, Claude Code detecta o caso tmux automaticamente e ignora o marcador herdado, para que tmux não precise mais dessa variável. Também honrado na v2.1.169 e anterior; não tem efeito na v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que substitui foi removida
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Defina como `1` para forçar renderização de tachado para `~~text~~` nas respostas de Claude quando seu terminal o suporta mas não é auto-detectado, como sobre SSH sem `TERM_PROGRAM` encaminhado. Sem isso, terminais não detectados mostram os marcadores literais `~~` em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior
`CLAUDE_CODE_FORCE_SYNC_OUTPUT`	Defina como `1` para forçar ativação do modo privado DEC 2026 saída sincronizada quando seu terminal o suporta mas não é auto-detectado. Útil para emuladores como `eat` do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux. Diferentemente de `CLAUDE_CODE_NO_FLICKER`, que muda para renderização fullscreen, isso não muda o renderizador
`CLAUDE_CODE_FORK_SUBAGENT`	Controla modo fork, que permite Claude gerar subagentes bifurcados e está ativado por padrão apenas em sessões interativas. Defina como `1` para ativá-lo em `claude -p` e Agent SDK também, ou `0` para desativá-lo em todo tipo de sessão. Você pode executar `/subtask` independentemente de modo fork estar ativado. O padrão interativo requer Claude Code v2.1.232 ou posterior; em versões anteriores, defina a variável como `1` para ativar modo fork
`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`	Defina como `1` para emitir blocos de texto e pensamento de subagente em saída `claude -p --output-format stream-json`, o mesmo comportamento que a flag `--forward-subagent-text`. Use a variável quando um harness invoca `claude` e não pode passar a flag. Diferentemente da flag, que sai com um erro fora do modo não interativo com saída stream-json, a variável é ignorada lá para que invocações aninhadas continuem funcionando quando está definida em todo o processo. Requer Claude Code v2.1.211 ou posterior
`CLAUDE_CODE_GATEWAY_HINT_HEADERS`	Defina como `1` para enviar os cabeçalhos de dica de gateway, como `x-claude-code-request-class` e `x-claude-code-compaction`, em um proxy personalizado ou provedor de terceiros como Amazon Bedrock ou Claude Platform on AWS. Defina como `0` para parar de enviá-los em cada conexão, incluindo uma conexão direta com a API Anthropic, onde Claude Code os envia por padrão. Requer Claude Code v2.1.273 ou posterior
`CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS`	Timeout em milissegundos para a solicitação de descoberta de modelo de gateway que `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` ativa (padrão: `3000`). Aumente quando seu gateway precisa de mais de três segundos para responder `/v1/models` na inicialização. Aceita apenas dígitos simples; `0`, valores negativos e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior
`CLAUDE_CODE_GIT_BASH_PATH`	Apenas Windows: caminho para o executável Git Bash (`bash.exe`). Use quando Git Bash está instalado mas não em seu PATH. Se o caminho não existir ou o arquivo não for nomeado `bash.exe`, `sh.exe`, `bash` ou `sh`, Claude Code ignora a variável e auto-detecta Git Bash como se não estivesse definida, registrando um aviso visível com `--debug`. Antes da v2.1.219, Claude Code saía na inicialização quando o caminho não existia e usava qualquer arquivo existente como shell sem verificar que era bash ou sh. Veja Configuração Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Defina como `false` para excluir dotfiles dos resultados quando Claude invoca a ferramenta Glob. Incluído por padrão. Não afeta autocompletar `@`, `ls`, Grep ou Read
`CLAUDE_CODE_GLOB_NO_IGNORE`	Defina como `false` para fazer a ferramenta Glob respeitar padrões `.gitignore`. Por padrão, Glob retorna todos os arquivos correspondentes, incluindo os ignorados por git. Não afeta autocompletar `@`, que tem sua própria configuração `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Timeout em segundos para descoberta de arquivo da ferramenta Glob. Padrão 20 segundos na maioria das plataformas e 60 segundos no WSL
`CLAUDE_CODE_GOAL_CHECKIN_MINUTES`	Quantos minutos o trabalho em background pode manter uma meta ativa aguardando antes de Claude Code pedir a Claude para verificá-la. Padrão `30`. Defina `0` para desativar check-ins. Dê minutos inteiros em dígitos simples, no máximo `10080`, que é uma semana. Claude Code trata qualquer outro valor como não definido e usa o padrão. Requer Claude Code v2.1.234 ou posterior
`CLAUDE_CODE_HIDE_CWD`	Defina como `1` para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO
`CLAUDE_CODE_IDE_HOST_OVERRIDE`	Substitua o endereço de host usado para conectar à extensão IDE. Por padrão, Claude Code auto-detecta o endereço correto, incluindo roteamento WSL-para-Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Defina como `1` para pular auto-instalação de extensões IDE. Equivalente a definir `autoInstallIdeExtension` como `false`
`CLAUDE_CODE_IDE_SKIP_VALID_CHECK`	Defina como `1` para pular validação de entradas de arquivo de bloqueio IDE durante conexão. Use quando auto-conexão falha em encontrar seu IDE apesar dele estar em execução
`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`	Quantos subagentes podem estar em execução em uma sessão antes da ferramenta Agent recusar gerar outro (padrão: 20). Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, para que a variável possa ajustar o limite mas não desabilitá-lo. Requer Claude Code v2.1.217 ou posterior
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. A partir da v2.1.193, como se aplica depende de como Claude Code resolve o ID do modelo; veja Corrigir a janela para um ID de modelo de gateway ou personalizado. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome
`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`	Comprimento máximo em caracteres de cada descrição de ferramenta MCP e instruções de cada servidor MCP que Claude Code envia ao modelo (padrão: 2048). Claude Code trunca texto mais longo. Aceita um número inteiro positivo em dígitos simples. Qualquer outra coisa é ignorada e o padrão se aplica. Requer Claude Code v2.1.280 ou posterior
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Defina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja max output tokens. Claude Code padrão para 32000 para IDs de modelo que não reconhece, como nomes específicos de gateway, e reduz valores acima do limite de um modelo para o limite. Aumentar esse valor reduz a janela de contexto efetiva disponível antes de auto-compactação ser acionada
`CLAUDE_CODE_MAX_RETRIES`	Substitua o número de vezes para tentar novamente solicitações de API falhadas (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 através de interrupções mais longas, defina `CLAUDE_CODE_RETRY_WATCHDOG`
`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`	Removido na v2.1.224 e agora é um no-op. Anteriormente limitava o número total de subagentes que Claude poderia 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 subagente concorrente e o limite de profundidade ainda se aplicam
`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`	Número de camadas de subagente permitidas abaixo da conversa principal (padrão: 3). No padrão, subagentes podem gerar seus próprios subagentes, e um subagente na terceira camada não pode gerar mais; defina `1` para desativar aninhamento. Na v2.1.217 através v2.1.218, o padrão era 1, para que um subagente não pudesse gerar seu próprio a menos que você aumentasse o limite; v2.1.219 aumentou o padrão para 3. Aceita um número inteiro positivo em dígitos simples; qualquer outra coisa é ignorada, para que o limite possa ser ajustado mas não removido. Requer Claude Code v2.1.217 ou posterior
`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`	Número máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam paralelismo mas consomem mais recursos
`CLAUDE_CODE_MAX_TURNS`	Limite 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 é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite
`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`	Limite no número total de chamadas WebSearch que uma sessão pode fazer (padrão: 200). Quando Claude atinge o limite, chamadas WebSearch adicionais retornam um aviso dizendo a ele para continuar com as informações que já reuniu. Aceita um número inteiro positivo sem limite superior. Qualquer outra coisa é ignorada e o padrão se aplica, para que o limite possa ser aumentado mas não desativado. Requer Claude Code v2.1.212 ou posterior
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Defina como `1` para gerar servidores MCP stdio com apenas um ambiente de linha de base seguro mais o `env` configurado do servidor, em vez de herdar seu ambiente de shell
`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`	Tempo decorrido em milissegundos antes de uma chamada de ferramenta MCP ainda em execução se mover para uma tarefa em background (padrão: 120000, ou 2 minutos). Defina como `0` para desativar backgrounding automático. Requer Claude Code v2.1.212 ou posterior
`CLAUDE_CODE_MCP_STARTUP_WAIT_MS`	Quanto tempo em milissegundos o primeiro turno de uma sessão não interativa aguarda servidores MCP que ainda estão se conectando, no lugar da espera de primeiro turno padrão. Quando definido, a espera cobre cada servidor pendente. Defina como `0` para pular a espera. Um servidor `--permission-prompt-tool` mantém sua própria espera `MCP_TIMEOUT` independentemente do valor. Requer Claude Code v2.1.274 ou posterior
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Timeout de inatividade em milissegundos para chamadas de ferramenta MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou conector claude.ai não envia resposta e nenhuma notificação de progresso por esse tempo, a chamada de ferramenta aborta com um erro em vez de aguardar o `MCP_TOOL_TIMEOUT` geral. Substitui os padrões por transporte de 300000 (5 minutos) para servidores de rede e 1800000 (30 minutos) para servidores stdio. Defina como `0` para desabilitar a verificação de inatividade. Valores abaixo de 1000 são aumentados para um segundo, e o valor é limitado ao `MCP_TOOL_TIMEOUT` efetivo. Um `timeout` por servidor em `.mcp.json` de pelo menos 1000 aumenta a janela de inatividade desse servidor para pelo menos o valor `timeout`. Não se aplica a servidores IDE ou servidores em processo SDK. Requer Claude Code v2.1.187 ou posterior. Antes da v2.1.203, servidores stdio eram isentos do timeout de inatividade
`CLAUDE_CODE_MESSAGING_SOCKET`	Defina por Claude Code, não por você: em sessões que vinculam um socket de caixa de entrada, 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, Claude Code vincula o socket antes de qualquer hook ser executado. Outras sessões na máquina entregam mensagens para esse caminho. Cada sessão exporta seu próprio socket em vez de um herdado de um pai, e mensagens chegando nele passam pelos controles de entrada da sessão. Blocos `env` de configurações não podem defini-lo. Requer Claude Code v2.1.224 ou posterior
`CLAUDE_CODE_MESSAGING_TOKEN`	Defina por Claude Code, não por você: em sessões que vinculam um socket de caixa de entrada, Claude Code exporta esse token por sessão para hooks e comandos Bash junto com `CLAUDE_CODE_MESSAGING_SOCKET`. Um script postando no socket pode enviar `{"type":"auth","token":"<token>"}` como sua primeira linha para provar que pertence à sessão. No Windows nativo, Claude Code requer essa linha e fecha qualquer conexão que não abra com uma válida. As regras de filho próprio dizem quando 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-lo. Requer Claude Code v2.1.228 ou posterior
`CLAUDE_CODE_NATIVE_CURSOR`	Defina como `1` para mostrar o cursor próprio do terminal na marca de inserção em vez de um bloco desenhado. O cursor respeita as configurações de piscar, forma e foco do terminal
`CLAUDE_CODE_NEW_INIT`	Defina como `1` para fazer `/init` executar um fluxo de configuração interativo. O fluxo pergunta quais arquivos gerar, incluindo CLAUDE.md, skills e hooks, antes de explorar a base de código e escrevê-los. Sem essa variável, `/init` gera um CLAUDE.md automaticamente sem solicitar
`CLAUDE_CODE_NONBLOCKING_STDOUT`	Defina como `1` para escrever saída de terminal através de um segundo descritor de arquivo não bloqueante, para que um terminal que para de ler, como um painel tmux control-mode pausado ou uma conexão SSH travada, não possa congelar Claude Code no meio da sessão. Aplica-se em macOS, Linux e WSL quando stdout é um terminal. Requer Claude Code v2.1.261 ou posterior
`CLAUDE_CODE_NO_FLICKER`	Defina como `1` para ativar renderização fullscreen, uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Substitui 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 Claude.ai. Quando definido, `claude auth login` troca esse token diretamente em vez de abrir um navegador. Requer `CLAUDE_CODE_OAUTH_SCOPES`. Útil para provisionar autenticação em ambientes automatizados
`CLAUDE_CODE_OAUTH_SCOPES`	Escopos OAuth separados por espaço que o token de atualização foi emitido com, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatório quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definido
`CLAUDE_CODE_OAUTH_TOKEN`	Token de acesso OAuth para autenticação claude.ai. Alternativa a `/login` para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas em keychain. Gere um com `claude setup-token`. A menos que você execute `/login`, Claude Code usa o token que você define para a sessão inteira. Para substituir um token expirado, gere um novo e reinicie
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Removido na v2.1.160 e agora é um no-op. Anteriormente fixava modo rápido em Claude Opus 4.6 em vez do padrão atual. Opus 4.6 não suporta mais modo rápido
`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`	Comprimento máximo de atributos OpenTelemetry que carregam conteúdo (respostas de modelo, conteúdo de ferramenta, prompts do sistema, corpos de API brutos), marcador de truncamento incluído, em unidades de código UTF-16 (padrão: 61440, ou seja, 60 KB). Aumente apenas se seu backend de telemetria aceita valores de atributo maiores que 64 KB, ou reduza para cortar volume de telemetria. Requer Claude Code v2.1.214 ou posterior. Veja Monitoramento
`CLAUDE_CODE_OTEL_DIAG_STDERR`	Defina como `1` para escrever erros de diagnóstico do exportador OpenTelemetry para stderr. Por padrão, esses erros aparecem apenas com `--debug`, para que um exportador mal configurado como uma colisão de porta Prometheus falhe silenciosamente. Requer Claude Code v2.1.179 ou posterior. Veja Monitoramento
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Timeout em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja Monitoramento
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalo para atualizar cabeçalhos OpenTelemetry dinâmicos em milissegundos (padrão: 1740000 / 29 minutos). Veja Cabeçalhos dinâmicos
`CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS`	Timeout em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja Monitoramento
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Defina como `1` para permitir que Claude Code execute o comando de upgrade do seu gerenciador de pacotes em background quando uma nova versão está disponível. Aplica-se a instalações Homebrew e WinGet. Outros gerenciadores de pacotes continuam mostrando o comando de upgrade sem executá-lo. Veja Auto-atualizações
`CLAUDE_CODE_PERFORCE_MODE`	Defina como `1` para ativar proteção de escrita ciente de Perforce. Quando definido, Edit, Write e NotebookEdit falham com uma dica `p4 edit <file>` se o arquivo de destino não tiver o bit de escrita do proprietário, que Perforce limpa em arquivos sincronizados até `p4 edit` abri-los. Isso evita que Claude Code contorne rastreamento de mudança Perforce
`CLAUDE_CODE_PLUGIN_CACHE_DIR`	Substitua o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: marketplaces e o cache de plugin vivem em subdiretórios sob esse caminho. Padrão é `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_DIRS`	Diretórios de plugin para carregar para a sessão, cada um carregado da forma que uma flag `--plugin-dir` carrega. Separe múltiplos caminhos com `:` em Unix ou `;` no Windows. Dê cada caminho como um caminho absoluto ou comece com `~`, porque Claude Code pula caminhos relativos. Requer Claude Code v2.1.280 ou posterior. Veja Carregar um plugin para uma sessão
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Timeout em milissegundos para clonar ou atualizar um marketplace de plugin (padrão: 120000). Aumente esse valor para repositórios grandes ou conexões de rede lentas. Veja Git clone expirou
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Defina como `1` para pular a tentativa de re-clone e continuar usando o checkout de marketplace existente quando uma atualização de marketplace não consegue alcançar ou autenticar no remoto. Útil em ambientes offline ou airgapped onde re-clonar falharia da mesma forma. Veja Atualizações de Marketplace falham em ambientes offline
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Defina como `1` para clonar fontes de atalho GitHub `owner/repo` sobre HTTPS em vez de SSH. Aplica-se a instalação e atualização de plugin, e a `/plugin marketplace add` e `update`. Útil em runners CI, containers ou qualquer ambiente sem uma chave SSH configurada para `github.com`
`CLAUDE_CODE_PLUGIN_SEED_DIR`	Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por `:` em Unix ou `;` no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de container. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja Pré-popular plugins para containers
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Defina como `1` para parar Claude Code de passar `-ExecutionPolicy Bypass` ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de status line, e respeitar a política de execução efetiva da máquina. Por padrão, Claude Code contorna política de execução em escopo de processo para que scripts `.ps1` e importações de módulo funcionem em instalações Windows padrão com Restricted. Bypass em escopo de processo nunca substitui `MachinePolicy` ou `UserPolicy` de Group Policy independentemente dessa configuração
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Teto em milissegundos na espera ociosa por subagentes em background e workflows após o turno final em modo não interativo com a flag `-p`. A espera ociosa começa novamente cada vez que Claude toma um turno para lidar com um resultado em background. Padrão: `600000`, ou 10 minutos. Quando a espera ociosa atinge o teto, Claude Code para de aguardar as tarefas em background restantes e sai. Defina como `0` para aguardar indefinidamente. Esse limite é separado do período de graça de cinco segundos que se aplica a shells em background simples. Requer Claude Code v2.1.182 ou posterior
`CLAUDE_CODE_PROCESS_WRAPPER`	Inicie os processos que Claude Code começa de seu próprio binário, como o serviço em background que hospeda sessões agent view, através de um launcher corporativo dado como um prefixo argv como `/opt/corp/launcher`. Defina no bloco `env` de configurações de usuário ou gerenciadas, não como exportação de shell, para que o serviço em background desanexado o herde; configurações de projeto e local não podem defini-lo. Equivalente à configuração `processWrapper`, que requer Claude Code v2.1.210 ou posterior; essa variável tem precedência quando ambas estão definidas. A extensão VS Code configura seu próprio launcher separadamente através de sua configuração `claudeProcessWrapper`. Ignorado no Windows. Veja Executar Claude Code atrás de um launcher corporativo para o formato de valor, o que o launcher cobre e o contrato que o launcher deve satisfazer. Requer Claude Code v2.1.208 ou posterior
`CLAUDE_CODE_PROJECT_DIR_NAME`	Defina junto com `CLAUDE_CONFIG_DIR` para escolher o nome do diretório `projects/` em que Claude Code armazena transcrições dessa sessão e memória automática, no lugar de um derivado do caminho do diretório de trabalho. Por exemplo, iniciar Claude Code com `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` armazena sob `/srv/tenant-a/projects/work/`. Claude Code ignora essa variável quando `CLAUDE_CONFIG_DIR` não está definido, e a lê apenas do ambiente em que você inicia `claude`, nunca de um bloco `env` de arquivo de configurações. Veja Nomeie o diretório de projeto você mesmo. Requer Claude Code v2.1.234 ou posterior
`CLAUDE_CODE_PROMPT_CACHE_TTL`	Defina `5m` ou `1h`, os únicos valores que Claude Code aceita, para escolher o TTL de cache de prompt para a conversa principal: seus turnos interativos, `-p` e SDK, mais os helpers que executam inline com eles. Tem precedência sobre a configuração `promptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a substitui. A API cobra escritas de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior
`CLAUDE_CODE_PROPAGATE_TRACEPARENT`	Defina como `1` para propagar contexto de rastreamento W3C quando `ANTHROPIC_BASE_URL` aponta para um proxy personalizado. A propagação cobre o cabeçalho `traceparent` em solicitações de modelo e MCP HTTP e a variável de ambiente `TRACEPARENT` para subprocessos Bash, PowerShell e hook. Por padrão, a propagação é ativada apenas quando conectado diretamente à API Anthropic. Adicionado na v2.1.152. Veja Rastreamentos (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Defina por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, Claude Code ignora variáveis de seleção de provedor, endpoint e autenticação como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` em arquivos de configurações, para que configurações de usuário não possam substituir o roteamento do host. Claude Code também ignora chaves de seleção de modelo como `model`, `fallbackModel` e `modelOverrides` em configurações gerenciadas, qualquer que seja a fonte gerenciada que as entregue, para que a configuração de modelo do host tenha precedência sobre um pin de modelo desatualizado. 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 lista de permissão `availableModels` em configurações gerenciadas ainda se aplica a menos que o host forneça a sua. Claude Code também pula o opt-out de telemetria automática que de outra forma se aplica em provedores de terceiros como Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform e Microsoft Foundry, para que telemetria siga o opt-out padrão `DISABLE_TELEMETRY`. Veja Comportamentos padrão por provedor de API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Defina como `1` para permitir que o proxy execute resolução de DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host
`CLAUDE_CODE_REMOTE`	Defina automaticamente como `true` quando Claude Code está em execução como uma sessão em nuvem. Leia isso de um hook ou script de configuração para detectar se você está em uma sessão em nuvem
`CLAUDE_CODE_REMOTE_SESSION_ID`	Defina automaticamente em sessões em nuvem para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja Vincular saída de volta à sessão
`CLAUDE_CODE_RESTRICTED`	Defina como `1` para iniciar a sessão em modo restrito, o mesmo que passar `--restricted`. Claude Code ignora essa variável em um bloco `env` de arquivo de configurações. Requer Claude Code v2.1.248 ou posterior
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de um turno. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt. Para desativar isso, desconfigurar a variável ou defini-la como `0`. Antes da v2.1.221, Claude Code ignorava `0` e outros valores falsos, para que definir `0` ainda acionasse a retomada em modo não interativo e desconfigurar a variável era a única forma de desativar
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS`	Idade máxima em milissegundos da última mensagem de transcrição para uma sessão que terminou no meio de um turno para continuar automaticamente na retomada. Quando a última mensagem é mais antiga que esse limite, Claude Code pula a retomada automática `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 definido ou `0` significa sem limite, exceto que um turno cuja última solicitação falhou com um erro de API retoma apenas enquanto esse erro tem menos de seis horas. Um valor positivo limita cada turno, incluindo aqueles; um valor negativo ou não numérico aplica um limite de uma hora. Scripts de spawn para agentes de longa duração podem definir isso para que uma reinicialização contra uma transcrição antiga não re-execute um prompt obsoleto. Claude Code define um limite de uma hora a si mesmo quando reinicia uma sessão agent view travada que herdou sua conversa de uma sessão interativa. Requer Claude Code v2.1.211 ou posterior
`CLAUDE_CODE_RESUME_PROMPT`	Substitua a mensagem de continuação que Claude Code envia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua um turno interrompido em vez de reenviar seu prompt, ou quando você retoma uma chamada de ferramenta adiada com `-p`. 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 eval, trabalhos CI ou workers remotos. Tenta novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após tentativas `CLAUDE_CODE_MAX_RETRIES`. Claude Code falha imediatamente quando uma solicitação de velocidade padrão recebe um `429` que relata um limite de gastos ou créditos de uso esgotados, mesmo um de um limite de gastos de gateway que reinicia em um cronograma. Antes da v2.1.239, o watchdog tentava novamente esses indefinidamente. Para solicitações de modo rápido, veja Lidar com limites de taxa. O watchdog recua até 5 minutos entre tentativas, ou até o limite ser reiniciado quando a resposta carrega um tempo de reinicialização de limite de taxa, para que uma sessão que atinge um limite de uso aguarde a janela restante. Na v2.1.199 ou posterior, também aumenta a contagem de tentativa padrão para outros erros transitórios, como erros de servidor, timeouts e conexões descartadas, para 300, aproximadamente três horas de recuo, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. Requer Claude Code v2.1.186 ou posterior
`CLAUDE_CODE_SAFE_MODE`	Defina como `1` para iniciar em modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de status line e sugestão de arquivo, servidores LSP e memória automática não carregam, para solução de problemas de uma configuração quebrada. A política de configurações gerenciadas ainda se aplica, incluindo hooks, status line e comandos de sugestão de arquivo 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 diretamente gerados herdam a variável
`CLAUDE_CODE_SCRIPT_CAPS`	Objeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` está definido. As chaves são substrings correspondidas contra o texto do comando; valores são limites de chamada inteiros. Por exemplo, `{"deploy.sh": 2}` permite que `deploy.sh` seja chamado no máximo duas vezes. A correspondência é baseada em substring para que truques de expansão de shell como `./scripts/deploy.sh $(evil)` ainda contem contra o limite. Fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade
`CLAUDE_CODE_SCROLL_SPEED`	Defina o multiplicador de rolagem de roda do mouse em renderização fullscreen. Aceita qualquer valor positivo até 20, incluindo valores fracionários abaixo de 1 como `0.5` para desacelerar rolagem de trackpad e roda acelerada em terminais que já amplificam eventos de roda. Defina como `3` para corresponder `vim` se seu terminal envia um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio manuseio de rolagem
`CLAUDE_CODE_SEND_FEEDBACK`	Defina como `0` para desativar feedback redigido por Claude para uma sessão. Defina como `1` para ativá-lo onde sua conta já tem acesso; a variável não pode conceder acesso a si mesma, e os outros switches que desativam feedback, como `DISABLE_FEEDBACK_COMMAND` e o valor `off` da configuração `feedbackDrafts`, ainda se aplicam
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Substitua o orçamento de tempo em milissegundos para hooks SessionEnd. O valor também é o timeout para cada hook que não define seu próprio `timeout`. Aplica-se à saída de sessão, `/clear` e alternância de sessões via `/resume` interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o `timeout` por hook mais alto configurado em arquivos de configurações, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento
`CLAUDE_CODE_SESSION_ID`	Defina automaticamente para o ID da sessão atual em subprocessos de ferramenta Bash e PowerShell, subprocessos comando hook e subprocessos servidor MCP stdio. Para Bash, PowerShell e hooks, isso corresponde ao campo `session_id` na entrada JSON do hook e é atualizado em `/clear`. Um subprocesso de servidor MCP retém o ID com o qual foi gerado. Em `--resume <session-id>` recebe o ID retomado, correspondendo hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito pode receber o ID de inicialização inicial. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que os iniciou
`CLAUDE_CODE_SHELL`	Defina o shell que Claude Code usa para executar comandos de 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` funcionando, Claude Code o ignora e volta para auto-detecção. Auto-detecção usa seu `$SHELL` quando aponta para `bash` ou `zsh`, caso contrário escolhe o primeiro `zsh` funcionando depois `bash` encontrado em seu `PATH` e locais de instalação padrão
`CLAUDE_CODE_SHELL_PREFIX`	Prefixo de comando que envolve comandos de shell que Claude Code gera: chamadas de ferramenta Bash, comandos hook, comandos status line e comandos de inicialização servidor MCP stdio. Hooks de forma exec e PowerShell executam 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 shell-quoted em `$1`, para que o wrapper deva re-avaliar `$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 de ferramenta Bash, `$1` contém a invocação de shell completa que Claude Code monta, incluindo configuração de ambiente, não apenas o comando que Claude executou
`CLAUDE_CODE_SIMPLE`	Defina como `1` para executar com um prompt do sistema mínimo e apenas ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de `--mcp-config` ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, comandos personalizados, subagentes, plugins instalados, servidores MCP, memória automática e CLAUDE.md. Skills em um diretório que você passa com `--add-dir` ainda carregam. Tokens OAuth e credenciais de keychain não são lidos, para que autenticação Anthropic deva vir de `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em `--settings`. Equivalente a passar `--bare`
`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`	Defina como `1` para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como `0`, `false`, `no` ou `off` para desativar mesmo em modelos onde o experimento ou configuração do servidor ativaria. O conjunto completo de ferramentas, descoberta de hooks, servidores MCP e CLAUDE.md permanecem ativados
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Pule autenticação do lado do cliente para Claude Platform on AWS, para gateways que assinam solicitações a si mesmos
`CLAUDE_CODE_SKIP_AWS_CRED_CACHE`	Defina como `1` para desativar o cache em processo de credenciais resolvidas da cadeia de provedor de credencial padrão AWS, para que Claude Code resolva a cadeia em cada solicitação de API. Com o cache desativado, um perfil apoiado por SSO solicita credenciais do IAM Identity Center em cada solicitação. Veja cache de credencial e timeout de resolução. Requer Claude Code v2.1.207 ou posterior
`CLAUDE_CODE_SKIP_BEDROCK_AUTH`	Pule autenticação AWS para Amazon Bedrock (por exemplo, ao usar um gateway LLM)
`CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS`	Defina como `1` para tratar uma verificação de disponibilidade de modo rápido falhada como disponível, para redes que bloqueiam a solicitação direta da verificação para `api.anthropic.com`. Claude Code ainda honra uma resposta “desabilitado pela sua organização”
`CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK`	Defina como `1` para pular a verificação de disponibilidade de modo rápido do lado do cliente, para proxies que interceptam a solicitação da verificação em vez de recusá-la. A API ainda rejeita solicitações de modo rápido quando sua organização tem modo rápido desabilitado
`CLAUDE_CODE_SKIP_FOUNDRY_AUTH`	Pule autenticação Azure para Microsoft Foundry, para um proxy ou gateway que injeta seu próprio cabeçalho `Authorization`. Claude Code envia solicitações sem uma credencial Azure e preserva o cabeçalho `Authorization` que você fornece, por exemplo através de `ANTHROPIC_CUSTOM_HEADERS`. Ignorado quando `ANTHROPIC_FOUNDRY_API_KEY` ou `ANTHROPIC_FOUNDRY_AUTH_TOKEN` está definido. Antes da v2.1.203, essa variável deixava o cliente Microsoft Foundry incapaz de enviar solicitações a menos que uma chave de API também estivesse definida
`CLAUDE_CODE_SKIP_MANTLE_AUTH`	Pule autenticação AWS para Amazon Bedrock Mantle (por exemplo, ao usar um gateway LLM)
`CLAUDE_CODE_SKIP_PROMPT_HISTORY`	Defina como `1` para pular escrita de histórico de prompt e transcrições de sessão em disco. Sessões iniciadas com essa variável definida não aparecem em `--resume`, `--continue` ou histórico de seta para cima. Útil para sessões de script efêmeras
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Pule autenticação Google para Google Cloud’s Agent Platform (por exemplo, ao usar um gateway LLM)
`CLAUDE_CODE_STARTUP_FAILURE_RESULTS`	Defina como `1` para fazer uma sessão iniciada com `--output-format stream-json` escrever uma mensagem de resultado nomeando por que Claude Code recusou iniciar para falhas de inicialização que de outra forma terminam apenas com stderr. Requer Claude Code v2.1.274 ou posterior
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Número máximo de vezes consecutivas que um hook Stop ou SubagentStop pode bloquear o turno de terminar antes de Claude Code substituí-lo e terminar o turno mesmo assim (padrão: 8). Defina como `0` para desabilitar o limite. Aumente isso se seu hook legitimamente precisa de mais iterações para resolver
`CLAUDE_CODE_SUBAGENT_MODEL`	O modelo padrão para subagentes, equipe de agentes companheiros e agentes workflow que não são atribuídos a um modelo de outra forma. Aceita um alias como `haiku` ou um nome de modelo completo. Duas fontes têm precedência sobre ele: um modelo que Claude passa quando gera o agente, e um campo `model` na definição do agente, incluindo `inherit`. Para mudar isso, defina `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`. Veja Escolha um modelo para a ordem completa. Defini-lo como `inherit` é o mesmo que deixá-lo não definido. Antes da v2.1.251, essa variável substituía 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 modelo em subagentes, companheiros e agentes de workflow. Executar cada subagente em um modelo diz qual modelo é. Requer Claude Code v2.1.257 ou posterior
`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`	Defina `5m` ou `1h`, os únicos valores que Claude Code aceita, para escolher o TTL de cache de prompt para solicitações fora da conversa principal, como subagentes, workflows e trabalho em background. Tem precedência sobre a configuração `subagentPromptCacheTtl` e sobre `ENABLE_PROMPT_CACHING_1H`, e `FORCE_PROMPT_CACHING_5M` a substitui. A API cobra escritas de cache de 1 hora a uma taxa mais alta. Requer Claude Code v2.1.242 ou posterior
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Defina como `1` para remover credenciais de ambientes de subprocesso (ferramenta Bash, hooks, servidores MCP stdio): credenciais Anthropic e provedor de nuvem, qualquer outra variável que Claude Code reconhece como credencial e credenciais incorporadas em URLs de registro de pacotes. O processo Claude pai mantém essas credenciais para chamadas de API, mas processos filhos não podem lê-las, reduzindo exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão de shell. Na v2.1.251 ou posterior, o scrub também remove variáveis de ponteiro de armazenamento de configuração de Claude Code (como `CLAUDE_CONFIG_DIR`), para que um processo filho não possa localizar um diretório de configuração realocado. Deixe o scrub não definido se um subprocesso precisa dessas variáveis. No Linux, isso também executa subprocessos Bash em um namespace PID isolado para que não possam ler ambientes de processo host via `/proc`; como efeito colateral, `ps`, `pgrep` e `kill` não podem ver ou sinalizar processos host. `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Defina como `1` em modo não interativo (flag `-p`) para aguardar a conclusão da instalação de plugin antes da primeira consulta. Sem isso, plugins instalam em background 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 instalação de plugin síncrona. Quando excedido, Claude Code prossegue sem plugins e registra um erro. Sem padrão: sem essa variável, instalação síncrona aguarda até conclusão
`CLAUDE_CODE_SYNC_SKILLS`	Defina como `1` em modo não interativo com a flag `-p` para fazer Claude Code baixar as skills ativadas para sua conta claude.ai nessa execução e aguardar a lista delas, até `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, antes de executar a primeira consulta. Os downloads em si terminam em background, e Claude aguarda o download de uma skill quando a invoca. Requer autenticação claude.ai. Sessões de terminal onde você entra com sua conta claude.ai baixam essas skills em `~/.claude/skills/synced/` e ressincronizam aproximadamente a cada 10 minutos sem essa variável, para que a defina apenas quando uma execução `-p` precisa de suas skills atuais em sua primeira consulta. Antes da v2.1.273, sessões de terminal as baixavam apenas em uma execução `-p` com essa variável definida. O nome da pasta `synced` é reservado para esse download. Antes da v2.1.227, as skills baixavam em `~/.claude/skills/` diretamente. Claude Code aplica regras extras às skills baixadas, como não executar seus comandos `!` em sua máquina
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Timeout em milissegundos para a ressincronização de skills que executa no meio da sessão quando um app construído no Agent SDK recarrega skills (padrão: 30000). Quando excedido, o recarregamento continua com quaisquer skills que chegaram, e os downloads restantes terminam em background
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Timeout em milissegundos para a primeira consulta aguardar a lista de skills inicial quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 5000). Quando excedido, a primeira consulta executa com quaisquer skills que chegaram. Os downloads terminam em background de qualquer forma, e Claude aguarda o download de uma skill quando a invoca
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Defina como `false` para desabilitar destaque de sintaxe em saída de diff. Útil quando cores interferem com sua configuração de terminal. Para também desabilitar destaque em blocos de código e visualizações de arquivo, use a configuração `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Compartilhe uma lista de tarefas entre sessões. Defina o mesmo ID em múltiplas instâncias Claude Code para coordenar em uma lista de tarefas compartilhada, em sessões que têm as ferramentas Task. Veja Lista de tarefas
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Substitua, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para sua equipe de agentes terminar de desmontar. Aceita 1000 a 60000; um valor fora do intervalo é ignorado e o padrão de 10000 se aplica. Requer Claude Code v2.1.206 ou posterior
`CLAUDE_CODE_TMPDIR`	Substitua o diretório temporário usado para arquivos temporários internos. Claude Code acrescenta `/claude-{uid}/` em Unix ou `/claude/` no Windows a esse caminho. Padrão: `/tmp` em macOS, `os.tmpdir()` em Linux e Windows. Em macOS e Linux, subprocessos Bash sandboxed recebem um fallback `$TMPDIR` curto sob o padrão do sistema quando sua substituição é um caminho longo, já que algumas ferramentas falham quando caminhos temporários ficam muito longos. Comandos Bash não sandboxed herdam seu `$TMPDIR` de shell quando está definido. Os próprios arquivos temporários de Claude Code sempre usam sua substituição. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local
`CLAUDE_CODE_TMUX_TRUECOLOR`	Defina como qualquer valor não vazio, como `1`, para permitir saída truecolor de 24 bits dentro de tmux. Defini-lo como `0` ou `false` ainda permite truecolor, diferentemente da maioria das variáveis on/off; desconfigurar a variável para restaurar o clamp de 256 cores. Por padrão, Claude Code limita a 256 cores quando `$TMUX` está definido porque tmux não passa sequências de escape truecolor a menos que configurado. Defina isso após adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Veja Configuração de terminal para outras configurações tmux
`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`	Em Linux e WSL, defina como uma lista separada por vírgulas dos tipos de processos que Claude Code exclui do limite de memória de ferramenta, como `mcp` ou `lsp`. Defina `none` para limitar cada tipo, ou `all-new` para limitar apenas comandos de ferramentas Bash, PowerShell e Monitor. Claude Code mantém comandos de ferramentas Bash, PowerShell e Monitor sob o limite qualquer que você liste. Requer Claude Code v2.1.246 ou posterior
`CLAUDE_CODE_TOOL_MEMORY_LIMIT`	Em Linux e WSL, defina como um tamanho como `4G` para limitar a memória que comandos de ferramentas Bash e PowerShell podem usar, e comandos de 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. Uma vez que o primeiro processo que Claude Code inicia tenha ativado ou desativado o limite, um valor alterado tem efeito na próxima vez que você inicia `claude`. Requer Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`	Prazo em milissegundos antes de Claude Code cancelar um diálogo que encaminha para um cliente remoto como um Remote Control ou host SDK, ou o diálogo de aprovação para uma mensagem entre sessões retida; prompts de permissão e perguntas `AskUserQuestion` usam seus próprios fluxos e não são governados por ele. No Claude Code v2.1.236 ou posterior, também limita o prompt de consentimento de créditos de uso Fable no meio da sessão em uma sessão que pode estar em execução sem supervisão. Controlar mensagens de entrada e sessões não interativas cobrem as regras de expiração de mensagem retida completas, incluindo os casos onde o prazo não se aplica. Substitui a configuração `dialogExpiry`. `0` ou um valor negativo desabilita o prazo
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Use Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Use Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Use Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Use o endpoint Mantle 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 Node.js em vez de ripgrep. Defina isso se o binário ripgrep incluído não estiver disponível ou bloqueado em seu ambiente. Não afeta as ferramentas Grep ou busca de arquivo
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é ativada automaticamente; defina como `0` para desabilitá-la. No Windows com Git Bash instalado, a ferramenta está ativada por padrão para contas claude.ai e Console; defina como `1` para ativá-la em sessões Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry, ou `0` para desativá-la. Em Linux, macOS e WSL, defina como `1` para ativá-la, o que requer `pwsh` em seu `PATH`. Quando ativada no Windows, Claude pode executar comandos PowerShell nativamente em vez de rotear através de Git Bash. Veja Ferramenta PowerShell
`CLAUDE_CODE_USE_VERTEX`	Use Google Cloud’s Agent Platform
`CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS`	Defina como o número de milissegundos que WebFetch mantém cada resposta de URL buscada em cache. O padrão é `900000`, que é 15 minutos. Aceita apenas dígitos simples; `0`, um decimal ou qualquer outra grafia mantém o padrão. Claude Code lê o valor uma vez por lançamento, para que uma mudança em um bloco `env` de configurações se aplique quando você próximo inicia `claude`. Requer Claude Code v2.1.233 ou posterior
`CLAUDE_CODE_WEBFETCH_DEADLINE_MS`	Limite superior em milissegundos em quanto tempo WebFetch aguarda uma página fazer download, incluindo qualquer redirecionamento que segue. Um download que não foi concluído até então falha com um erro de prazo. O padrão é `300000`, que é cinco minutos. Defina como `0` para remover o limite. Aceita apenas dígitos simples; um decimal ou qualquer outra grafia mantém o padrão. Requer Claude Code v2.1.268 ou posterior
`CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS`	Quantos agentes uma execução de workflow executa de uma vez, de `1` a `256`. Por padrão, uma execução executa até 16 agentes de uma vez, menos quando Claude Code tem menos CPUs disponíveis; chamadas `agent()` enfileiradas aguardam um slot livre. A transcrição de cada agente em execução fica na memória de Claude Code, para que valores mais altos aumentem o uso de memória. Aceita apenas dígitos simples; valores fora do intervalo e outras grafias mantêm o padrão. Requer Claude Code v2.1.269 ou posterior
`CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS`	Limite superior em milissegundos em quanto tempo um agente workflow aguarda a primeira resposta de um irmão de mesmo prefixo começar antes de enviar sua própria primeira solicitação. Quando um fan-out começa vários agentes que compartilham um prefixo de cache de prompt, Claude Code mantém todos exceto o primeiro agente por até esse tempo para que o resto leia o prefixo em cache em vez de cada um processá-lo sem cache. Padrão `5000`. Defina como `0` para desabilitar a espera. Quando `DISABLE_PROMPT_CACHING` está definido, agentes nunca aguardam. Requer Claude Code v2.1.229 ou posterior
`CLAUDE_CONFIG_DIR`	Substitua o diretório de configuração (padrão: `~/.claude`). Todas as configurações, histórico de sessão e plugins são armazenados sob esse caminho. Para credenciais, veja onde Claude Code armazena credenciais. Útil para executar múltiplas contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local
`CLAUDE_DISABLE_ADOPT`	Defina como `1` para parar trabalho em background em voo em vez de carregá-lo quando você coloca uma sessão em background pressionando `←` ou com `/background`. Claude Code pede confirmação antes de colocar em background, depois para as tarefas que de outra forma seriam carregadas. Requer Claude Code v2.1.195 ou posterior
`CLAUDE_EFFORT`	Defina automaticamente em subprocessos de ferramenta Bash e comandos hook para o nível de effort em efeito quando o subprocesso começa: `low`, `medium`, `high`, `xhigh` ou `max`. Corresponde ao campo `effort.level` passado para hooks. Apenas definido quando o modelo atual suporta o parâmetro effort
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Defina como `1` para forçar ativação do watchdog de inatividade de streaming em nível de byte, ou defina como `0` para forçar desativação. `0` também desativa o prazo de primeiro byte nas conexões onde esse prazo é executado. Quando não definido, o watchdog é ativado por padrão para conexões diretas de API Anthropic e Claude Platform on AWS, e para respostas de streaming em conexões gateway alcançadas através de `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AWS_BASE_URL`; antes da v2.1.222, não era executado nessas conexões de gateway, para que o watchdog em nível de evento pudesse relatar um travamento lá mesmo enquanto pings keep-alive estavam chegando. Para timeouts e como os timers interagem, veja Watchdogs de inatividade de streaming
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Defina como `1` para ativar o watchdog de inatividade de streaming em nível de byte em respostas Amazon Bedrock `vnd.amazon.eventstream`, que também ativa o prazo de primeiro byte em solicitações de streaming Bedrock. Desativado por padrão. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Defina como `0` para forçar desativação do watchdog de inatividade de streaming em nível de evento, ou defina como `1` para forçar ativação. Quando não definido, o watchdog está ativado por padrão para todos os provedores. Antes da v2.1.196, o padrão não definido era controlado pelo servidor na API Anthropic direta e desativado em outros provedores. Configure o timeout com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; para os outros timers de travamento que executam junto com este, veja Watchdogs de inatividade de streaming
`CLAUDE_ENV_FILE`	Caminho para um script de shell cujo conteúdo Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que exportações no arquivo sejam visíveis ao comando. Use para persistir ativação de virtualenv ou conda entre comandos. Também populado dinamicamente por hooks SessionStart, Setup, CwdChanged e FileChanged
`CLAUDE_JOB_DIR`	Defina por Claude Code em cada sessão em background para o diretório `~/.claude/jobs/<id>` dessa sessão. Comandos de shell que a sessão executa o herdam. Escreva arquivos de rascunho para `$CLAUDE_JOB_DIR/tmp`. Chamadas `Write` e `Edit` de Claude lá não solicitam permissão, e o diretório é removido quando a sessão é excluída
`CLAUDE_PID`	Claude Code define isso para seu próprio ID de processo nos subprocessos que gera: comandos de ferramenta Bash e PowerShell e comandos hook. No Linux, a integração de shell da ferramenta Bash o usa para recusar um padrão `pkill` que corresponderia ao próprio processo Claude Code; veja a referência de erro. Leia-o de seus próprios scripts para identificar ou sinalizar o processo Claude Code pai deliberadamente. Requer Claude Code v2.1.214 ou posterior
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefixo para nomes de sessão Remote Control gerados automaticamente quando nenhum nome explícito é fornecido. Padrão é o nome de host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. A flag CLI `--remote-control-session-name-prefix` define o mesmo valor para uma única invocação
`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`	Prazo em milissegundos para o primeiro byte de resposta de uma solicitação de streaming, nas conexões onde o prazo de primeiro byte é executado. Para como Claude Code o limita, o tempo extra que adiciona para corpos de solicitação grandes e como escolhe o prazo quando você deixa isso não definido, veja Sem resposta da API. Requer Claude Code v2.1.242 ou posterior
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Timeout em milissegundos antes dos watchdogs de inatividade de streaming em nível de evento e byte fecharem uma conexão travada. Quando você define essa variável explicitamente, o mínimo é `300000` (5 minutos); valores mais baixos são silenciosamente limitados para absorver pausas de pensamento estendido e buffering de proxy, e o watchdog em nível de byte limita o valor a 30 minutos. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` tem precedência sobre essa variável para o watchdog em nível de byte. Para os padrões não definidos por watchdog, veja Watchdogs de inatividade de streaming
`CLAUDE_SUBAGENT_BG_SHELL_MAX_MS`	Removido na v2.1.260 e agora é um no-op. Anteriormente limitava quanto tempo um comando shell em background que um subagente iniciou poderia executar, em milissegundos, com um padrão de 60 minutos. Veja as regras de tempo de vida de comando em background
`DEBUG`	Defina como `1` para ativar modo de depuração, equivalente a iniciar com `--debug`. Logs de depuração são escritos em `~/.claude/debug/<session-id>.txt`, ou no caminho definido por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Apenas os valores truthy `1`, `true`, `yes` e `on` ativam modo de depuração, para que padrões de namespace como `DEBUG=express:*` definidos para outras ferramentas não o acionem
`DISABLE_AUTOUPDATER`	Defina como `1` para desabilitar atualizações automáticas em background. `claude update` manual ainda funciona. Use `DISABLE_UPDATES` para bloquear ambos
`DISABLE_AUTO_COMPACT`	Defina como `1` para desabilitar compactação automática ao se aproximar do limite de contexto. O comando manual `/compact` permanece disponível. Use quando você quer controle explícito sobre quando a compactação ocorre. Substitui a configuração `autoCompactEnabled`
`DISABLE_COMPACT`	Defina como `1` para desabilitar toda compactação: tanto compactação automática quanto o comando manual `/compact`
`DISABLE_COST_WARNINGS`	Defina como `1` para desabilitar mensagens de aviso de custo
`DISABLE_DOCTOR_COMMAND`	Defina como `1` para ocultar a skill `/doctor` de verificação de configuração e seu alias `/checkup`. Útil para implantações gerenciadas onde usuários não devem executar diagnósticos de configuração de uma sessão. Não afeta o comando de terminal `claude doctor`. Antes da v2.1.205, essa variável ocultava a tela de diagnósticos `/doctor`
`DISABLE_ERROR_REPORTING`	Defina como qualquer valor não vazio, como `1`, para desativar relatório de erros. Defini-lo como `0` ou `false` ainda desativa, diferentemente da maioria das variáveis on/off; desconfigurar a variável para ativar relatório de erros novamente
`DISABLE_EXTRA_USAGE_COMMAND`	Defina como `1` para ocultar o comando `/usage-credits` que permite aos usuários comprar uso adicional além de limites de taxa
`DISABLE_FEEDBACK_COMMAND`	Defina como `1` para desabilitar o comando `/feedback` e feedback redigido por Claude. Também desabilita `/bug` e `/share`, que relatam através do mesmo caminho; antes da v2.1.212 eram aliases de `/feedback`, para que o comando fosse desabilitado sob cada nome. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito
`DISABLE_GROWTHBOOK`	Defina como `1` ou `true` para desabilitar busca de sinalizador de recurso GrowthBook e usar padrões de código para cada sinalizador. Isso torna Remote Control e os outros recursos que precisam de busca de sinalizador de recurso indisponíveis. Defini-lo como `0` ou `false` deixa a busca ativada. Logging de evento de telemetria permanece ativado a menos que `DISABLE_TELEMETRY` também esteja definido
`DISABLE_INSTALLATION_CHECKS`	Defina como `1` para desabilitar avisos de instalação. Use apenas ao gerenciar manualmente o local de instalação, pois isso pode mascarar problemas com instalações padrão
`DISABLE_INSTALL_GITHUB_APP_COMMAND`	Defina como `1` para ocultar o comando `/install-github-app`. Já oculto ao usar provedores de terceiros (Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft Foundry)
`DISABLE_INTERLEAVED_THINKING`	Defina como `1` para evitar enviar o cabeçalho beta de pensamento intercalado. Útil quando seu gateway LLM ou provedor não suporta pensamento intercalado
`DISABLE_LOGIN_COMMAND`	Defina como `1` para ocultar o comando `/login`. Útil quando autenticação é tratada externamente via chaves de API ou `apiKeyHelper`
`DISABLE_LOGOUT_COMMAND`	Defina como `1` para ocultar o comando `/logout`
`DISABLE_PROMPT_CACHING`	Defina como `1` para desabilitar cache de prompt para todos os modelos (tem precedência sobre configurações por modelo)
`DISABLE_PROMPT_CACHING_FABLE`	Defina como `1` para desabilitar cache de prompt para modelos Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Defina como `1` para desabilitar cache de prompt para modelos Haiku
`DISABLE_PROMPT_CACHING_OPUS`	Defina como `1` para desabilitar cache de prompt para modelos Opus
`DISABLE_PROMPT_CACHING_SONNET`	Defina como `1` para desabilitar cache de prompt para modelos Sonnet
`DISABLE_TELEMETRY`	Defina como qualquer valor não vazio, como `1`, para desativar telemetria. Defini-lo como `0` ou `false` ainda desativa, diferentemente da maioria das variáveis on/off; desconfigurar a variável para ativar telemetria novamente. Eventos de telemetria não incluem dados de usuário como código, caminhos de arquivo ou comandos bash. Também desabilita busca de sinalizador de recurso com o mesmo efeito que `DISABLE_GROWTHBOOK`, o que torna Remote Control e os outros recursos que precisam de busca de sinalizador de recurso indisponíveis. Veja Desativar telemetria para sua organização
`DISABLE_UPDATES`	Defina como `1` para bloquear todas as atualizações, incluindo `claude update` manual e `claude install`. Mais rigoroso que `DISABLE_AUTOUPDATER`. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar
`DISABLE_UPGRADE_COMMAND`	Defina como `1` para ocultar o comando `/upgrade`
`DO_NOT_TRACK`	Defina como `1` para desativar telemetria, com o mesmo efeito que `DISABLE_TELEMETRY`, incluindo tornar Remote Control e os outros recursos que precisam de busca de sinalizador de recurso indisponíveis. Claude Code lê essa variável como um booleano padrão, para que `0` deixe telemetria ativada e a honre como a convenção entre ferramentas reconhecida por muitos CLIs de desenvolvedor
`ENABLE_BETA_TRACING_DETAILED`	Defina como `1`, junto com `BETA_TRACING_ENDPOINT`, para ativar rastreamento beta detalhado, que adiciona atributos de span que carregam conteúdo e o span `claude_code.hook`. Sessões CLI interativas também requerem que sua organização seja adicionada à lista de permissão para o beta. Ambas as variáveis são ignoradas em configurações de projeto e local
`ENABLE_CLAUDEAI_MCP_SERVERS`	Defina como `false` para parar Claude Code de buscar servidores MCP claude.ai. Ativado por padrão para usuários conectados. Para desabilitar por projeto ou por org, defina `disableClaudeAiConnectors` em 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. Destinado a usuários de chave de API, Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry e Claude Platform on AWS. Usuários de assinatura dentro do uso incluído recebem o TTL de 1 hora automaticamente na conversa principal. Usuários de assinatura sacando créditos de uso podem defini-lo para manter o TTL de 1 hora. Escritas de cache de 1 hora são cobradas a uma taxa mais alta. Para escolher o TTL por bucket de solicitação, use `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, que têm precedência sobre essa variável
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Deprecated. Use `ENABLE_PROMPT_CACHING_1H`
`ENABLE_TOOL_SEARCH`	Controla busca de ferramentas MCP. Não definido, Claude Code adia todas as ferramentas MCP por padrão. Ainda as carrega antecipadamente em modelos Google Cloud’s Agent Platform anteriores à geração Claude 4.5, em uma implantação Microsoft Foundry hospedada no Azure e quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte. `true` sempre adia e envia o cabeçalho beta, exceto nesses mesmos modelos Agent Platform e implantações Microsoft Foundry; solicitações falham em proxies que não suportam `tool_reference`. `auto` carrega antecipadamente quando definições de ferramenta cabem em 10% de contexto. `auto:N` define um limite personalizado, como `auto:5` para 5%. `false` carrega todas as ferramentas antecipadamente. Um valor que você define a si mesmo é ignorado quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está definido. Antes da v2.1.221, Claude Code desabilitava busca de ferramentas para todos os modelos em Google Cloud’s Agent Platform a menos que você definisse essa variável como `true`
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Defina como qualquer valor não vazio, como `1`, para fazer Claude Code parar de tentar novamente em erros de sobrecarga repetidos para cada modelo quando nenhum modelo de fallback está configurado. Defini-lo como `0` ou `false` ainda ativa isso, diferentemente da maioria das variáveis on/off; desconfigurar a variável para restaurar o comportamento de retry padrão. Sem isso, Claude Code para de tentar novamente dessa forma em modelos que reconhece como Opus, Fable ou Mythos quando você autentica com uma chave de API ou um provedor de terceiros em vez de uma assinatura Claude. No Claude Code v2.1.160 ou posterior, Claude Code muda para sua cadeia de modelo de fallback configurada em erros de sobrecarga repetidos para qualquer modelo primário, para que essa variável não afete a mudança para um modelo de fallback
`FORCE_AUTOUPDATE_PLUGINS`	Defina como `1` para forçar auto-atualizações de plugin mesmo quando o auto-atualizador principal é desabilitado via `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Defina como `1` para ativar hiperlinks OSC 8 clicáveis quando seu terminal os suporta mas não é auto-detectado, ou `0` para desabilitá-los. Quando não definido, Claude Code ativa hiperlinks apenas quando detecta suporte de terminal. Claude Code analisa esse valor como um número, não um Booleano, para que um valor como `false`, `no` ou `off` ative hiperlinks em vez de desabilitá-los. O badge de solicitação de pull ou merge request do rodapé é renderizado como um hiperlink mesmo quando Claude Code não consegue detectar suporte de terminal, como sobre 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 TTL de 1 hora se aplicaria de outra forma. Substitui `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e as configurações `promptCacheTtl` e `subagentPromptCacheTtl`
`HTTP_PROXY`	Especifique servidor proxy HTTP para conexões de rede
`HTTPS_PROXY`	Especifique servidor proxy HTTPS para conexões de rede
`IS_DEMO`	Defina como qualquer valor não vazio, como `1`, para ativar modo demo: oculta seu email e nome da organização do cabeçalho e saída `/status`, e pula onboarding. Defini-lo como `0` ou `false` ainda ativa modo demo, diferentemente da maioria das variáveis on/off; desconfigurar a variável para desativá-lo. Útil ao fazer stream ou gravar uma sessão
`MAX_MCP_OUTPUT_TOKENS`	Número máximo de tokens permitidos em respostas de ferramenta MCP. Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram `anthropic/maxResultSizeChars` usam esse limite de caracteres para conteúdo de texto, mas conteúdo de imagem dessas ferramentas ainda está sujeito a essa variável (padrão: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Número de tentativas que Claude Code permite quando a resposta do modelo falha na validação contra o `--json-schema` em modo não interativo com a flag `-p`; após esse muitas tentativas falhadas 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. Padrão 5, uma primeira tentativa mais quatro retentativas
`MAX_THINKING_TOKENS`	Orçamento de token fixo para pensamento estendido. Claude Code o limita a um token abaixo dos tokens de saída máximos da solicitação e nunca abaixo de 1.024. Veja `CLAUDE_CODE_MAX_OUTPUT_TOKENS` para como esse limite é definido. Quando não definido e 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 desabilitar pensamento na API Anthropic, exceto em Opus 5.5, Sonnet 5.5 e modelos Fable, que não podem ter pensamento desativado. Em provedores de terceiros, `0` omite o parâmetro `thinking`. Com pensamento desativado na API Anthropic, Claude Code envia effort `high` em vez de um nível mais alto para modelos que sabe não aceitam essa combinação, como Opus 5. Claude Code ignora valores não zero em modelos de raciocínio adaptativo, exceto nos modelos onde `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` desativa raciocínio adaptativo
`MCP_CLIENT_SECRET`	Segredo de cliente OAuth para servidores MCP que requerem credenciais pré-configuradas. Evita o prompt interativo ao adicionar um servidor com `--client-secret`
`MCP_CONNECTION_NONBLOCKING`	Controla se a inicialização aguarda servidores MCP se conectarem antes da primeira consulta. Inicialização MCP é não bloqueante por padrão: servidores se conectam em background e suas ferramentas ficam disponíveis conforme terminam. Defina como `0` para fazer Claude Code aguardar servidores se conectarem antes da primeira consulta. Servidores configurados com `alwaysLoad: true` ainda fazem a inicialização aguardar independentemente, exceto quando servidos do cache de descoberta, já que suas ferramentas devem estar presentes quando o primeiro prompt é construído. Em modo não interativo (`-p`) sem `--input-format stream-json`, Claude Code também aguarda servidores ainda pendentes antes do primeiro turno independentemente dessa variável. Quando você passa `--mcp-config` explicitamente, a espera tem um prazo mais longo; veja a entrada dessa flag para a exceção de servidor em cache
`MCP_CONNECT_TIMEOUT_MS`	Quanto tempo a inicialização MCP bloqueante aguarda, em milissegundos, para o lote de conexão antes de tirar um snapshot da lista de ferramentas (padrão: 5000). Aplica-se quando `MCP_CONNECTION_NONBLOCKING=0` ou para servidores marcados `alwaysLoad: true`. Servidores ainda pendentes no prazo continuam se conectando em background. Distinto de `MCP_TIMEOUT`, que limita a tentativa de conexão de um servidor individual
`MCP_DISCOVERY_CACHE`	Ativa ou desativa o cache de descoberta MCP. Com o cache ativado, um servidor HTTP ou SSE remoto que você usou antes pode mostrar o status `cached`, e Claude Code o conecta em sua primeira chamada de ferramenta em vez de na inicialização. O cache está desativado por padrão a menos que um rollout gradual o tenha ativado para sua conta. Defina como `1` para ativá-lo, ou `0` para mantê-lo desativado mesmo quando o rollout o ativou. Antes da v2.1.238, o cache estava 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 de cache de descoberta (padrão: 14400, ou 4 horas). Em um início onde a entrada é mais antiga que isso, Claude Code a descarta e conecta o servidor na inicialização, como faz com o cache desativado. Claude Code limita o valor a 7 dias. Antes da v2.1.238, o padrão era 86400, ou 24 horas, e Claude Code não limitava o valor
`MCP_DISCOVERY_CACHE_STRIKES`	Em um início onde uma entrada de cache de descoberta é mais antiga que `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code a atualiza em background. Essa variável define quantas atualizações seguidas podem falhar antes de Claude Code descartar a entrada e conectar o servidor no próximo início (padrão: 1). Aumente se sua conexão de rede cair ocasionalmente, para que uma atualização falhada não descarte a entrada. Requer Claude Code v2.1.238 ou posterior
`MCP_DISCOVERY_CACHE_TTL_S`	Segundos pelos quais Claude Code usa uma entrada de cache de descoberta sem atualizá-la (padrão: 900). Em um início onde a entrada é mais antiga que isso, Claude Code ainda a usa mas a atualiza em background. Uma vez que a entrada é mais antiga que `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code a descarta. Claude Code limita o valor a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, que é 4 horas por padrão. Antes da v2.1.238, 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`	No runtime de cliente MCP v2 apenas, se Claude Code sonda servidores para revisão de protocolo MCP 2026-07-28. Defina `auto` para sondar servidores HTTP, conector claude.ai e stdio; um servidor que não responde à sonda se conecta no protocolo anterior, como servidores SSE e WebSocket sempre fazem. Defina `legacy` para pular a sonda para cada servidor. Sem a variável, Claude Code sonda servidores HTTP, e também sonda servidores conector claude.ai em sessões onde busca sinalizadores de recurso. 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) para conectar em paralelo durante a inicialização (padrão: 20)
`MCP_SDK_GENERATION`	Fixe qual runtime de cliente MCP este processo se conecta a servidores MCP com: `v1`, construído no MCP TypeScript SDK 1.x, ou `v2`, construído no MCP TypeScript SDK 2.0. Sem a variável, Claude Code usa v2, começando com as versões listadas naquela seção. No Claude Code v2.1.221 ou posterior, o runtime v2 verifica o emissor que um servidor OAuth MCP retorna em sua resposta de autorização e falha o sign-in com um erro que começa `Issuer mismatch in authorization response` quando não corresponde. O runtime v1 não executa essa verificação. Se você definir um valor não reconhecido, Claude Code o ignora e escreve um aviso no log de depuraçã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) para conectar em paralelo durante a inicialização (padrão: 3)
`MCP_TIMEOUT`	Timeout em milissegundos para inicialização de servidor MCP (padrão: 30000, ou 30 segundos)
`MCP_TOOL_TIMEOUT`	Timeout em milissegundos para execução de ferramenta MCP (padrão: 100000000, aproximadamente 28 horas). Para um servidor HTTP, SSE ou conector claude.ai, cada solicitação também expira após 60 segundos por padrão; defina essa variável ou o `timeout` por servidor acima de 60000 para aumentar esse limite por solicitação. Um valor mais baixo ainda encurta o timeout de execução de ferramenta geral mas deixa o limite por solicitação em 60 segundos. Servidores stdio e WebSocket não têm timer por solicitação. Um campo `timeout` por servidor em `.mcp.json` substitui isso para esse servidor. Um `timeout` por servidor de pelo menos 1000 também define a janela de inatividade mínima para chamadas de ferramenta desse servidor, para que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborte mais cedo; este piso requer Claude Code v2.1.203 ou posterior. Para a variável env, valores abaixo de 1000 são limitados a 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 solicitações serão emitidas diretamente, contornando proxy
`OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT`	Limite padrão do SDK OpenTelemetry no comprimento do valor de atributo. Claude Code limita atributos de telemetria que carregam conteúdo ao menor entre isso e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, para que o marcador de truncamento fique dentro do limite do SDK. 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. Veja Monitoramento
`OTEL_LOG_ASSISTANT_RESPONSES`	Defina como `1` para incluir o texto de resposta do modelo em eventos de log OpenTelemetry `assistant_response`. Quando não definido, Claude Code usa o valor de `OTEL_LOG_USER_PROMPTS`. Defina como `0` para manter respostas redatadas mesmo quando `OTEL_LOG_USER_PROMPTS` está definido. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local. Requer Claude Code v2.1.193 ou posterior. Veja Monitoramento
`OTEL_LOG_MANAGED_SETTINGS`	Defina como `1` para adicionar as configurações gerenciadas redatadas e um resumo SHA-256 das configurações antes da redação aos eventos de log OpenTelemetry `managed_settings_resolved`. Desabilitado por padrão. Defina em seu shell, configurações de usuário ou configurações gerenciadas; um valor em configurações de projeto ou local não o ativa. Requer Claude Code v2.1.274 ou posterior. Veja Monitoramento
`OTEL_LOG_RAW_API_BODIES`	Emita JSON de solicitação e resposta da API Anthropic Messages 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 escrever corpos não truncados em disco e emitir um caminho `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura o limite de conteúdo, 60 KB por padrão. Desabilitado por padrão; corpos incluem o histórico de conversa inteiro. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local. Veja Monitoramento
`OTEL_LOG_TOOL_CONTENT`	Defina como `1` para incluir conteúdo de ferramenta no evento de span OpenTelemetry `tool.output`. Atributos de span carregam conteúdo de ferramenta sob seus próprios gates. Requer rastreamento. Desabilitado por padrão para proteger dados sensíveis. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local, além dos valores desativados que essa seção descreve. Veja Monitoramento
`OTEL_LOG_TOOL_DETAILS`	Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, nomes de workflow redigidos pelo usuário, strings de erro bruto em falhas de ferramenta, a `category` de recusa em eventos `api_refusal` e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local, além dos valores desativados que essa seção descreve. Veja Monitoramento
`OTEL_LOG_USER_PROMPTS`	Defina como `1` para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Defina em seu shell, configurações de usuário ou configurações gerenciadas. Ignorado em configurações de projeto e local, além dos valores desativados que essa seção descreve. Veja Monitoramento
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Defina como `false` para excluir UUID de conta de atributos de métricas (padrão: incluído). Veja Monitoramento
`OTEL_METRICS_INCLUDE_ENTRYPOINT`	Defina como `true` para incluir o ponto de entrada da sessão em atributos de métricas (padrão: excluído). Adicionado na v2.1.152. Veja Monitoramento
`OTEL_METRICS_INCLUDE_REPOSITORY`	Defina como `true` para marcar métricas e eventos OpenTelemetry com atributos `vcs.*` identificando o repositório da sessão (padrão: excluído). Requer Claude Code v2.1.269 ou posterior. Veja Atributos de repositório
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partir da v2.1.161, Claude Code anexa chaves `OTEL_RESOURCE_ATTRIBUTES` aos rótulos de ponto de dados de métrica. Defina como `false` para excluí-las (padrão: incluído). Veja Monitoramento
`OTEL_METRICS_INCLUDE_SESSION_ID`	Defina como `false` para excluir ID de sessão de atributos de métricas (padrão: incluído). Veja Monitoramento
`OTEL_METRICS_INCLUDE_VERSION`	Defina como `true` para incluir versão de Claude Code em atributos de métricas (padrão: excluído). Veja Monitoramento
`SLASH_COMMAND_TOOL_CHAR_BUDGET`	Substitua o orçamento de caracteres para metadados de skill mostrados à ferramenta Skill. O orçamento escala dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores
`TASK_MAX_OUTPUT_LENGTH`	Removido na v2.1.277 e agora é um no-op, junto com a ferramenta `TaskOutput` que dimensionava. Anteriormente definia o número máximo de caracteres de saída de uma tarefa em background que a ferramenta `TaskOutput` mantinha. Claude lê um arquivo de saída de tarefa em background com `Read`
`USE_BUILTIN_RIPGREP`	Defina como `0` para usar `rg` instalado no sistema em vez de `rg` incluído com Claude Code
`VERTEX_REGION_CLAUDE_3_5_HAIKU`	Substitua região para Claude 3.5 Haiku ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Substitua região para Claude 3.5 Sonnet ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Substitua região para Claude 3.7 Sonnet ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Substitua região para Claude 4.0 Opus ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Substitua região para Claude 4.0 Sonnet ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Substitua região para Claude 4.1 Opus ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Substitua região para Claude Opus 4.5 ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Substitua região para Claude Sonnet 4.5 ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Substitua região para Claude Opus 4.6 ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Substitua região para Claude Sonnet 4.6 ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Substitua região para Claude Opus 4.7 ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Substitua região para Claude Opus 4.8 ao usar Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_5_5_OPUS`	Substitua região para Claude Opus 5.5 ao usar Google Cloud’s Agent Platform. Adicionado na v2.1.280
`VERTEX_REGION_CLAUDE_5_5_SONNET`	Substitua região para Claude Sonnet 5.5 ao usar Google Cloud’s Agent Platform. Adicionado na v2.1.284
`VERTEX_REGION_CLAUDE_5_OPUS`	Substitua região para Claude Opus 5 ao usar Google Cloud’s Agent Platform. Adicionado na v2.1.219
`VERTEX_REGION_CLAUDE_5_SONNET`	Substitua região para Claude Sonnet 5 ao usar Google Cloud’s Agent Platform. Adicionado na v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Substitua região para Claude Fable 5 ao usar Google Cloud’s Agent Platform. Adicionado na v2.1.170
`VERTEX_REGION_CLAUDE_FABLE_5_1`	Substitua região para Claude Fable 5.1 ao usar Google Cloud’s Agent Platform. Adicionado na v2.1.257
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Substitua região para Claude Haiku 4.5 ao usar Google Cloud’s Agent Platform

Variáveis de exportador OpenTelemetry padrão (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES e variantes específicas de sinal) também são suportadas. Veja Monitoramento para detalhes de configuração. Defina CLAUDE_CODE_ENABLE_TELEMETRY e as variáveis OpenTelemetry que ativam exportação, escolhem seu destino ou capturam conteúdo em seu shell, configurações de usuário ou configurações gerenciadas. Claude Code as ignora em configurações de projeto e local, além dos valores desativados que essa seção descreve. OTEL_RESOURCE_ATTRIBUTES e as variáveis de intervalo de exportação, timeout e compressão, como OTEL_METRIC_EXPORT_INTERVAL, ainda se aplicam de configurações de projeto e local.

Recursos que precisam de busca de feature-flag

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

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

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

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

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

Na sua primeira sessão após instalar Claude Code, ou atualizar para uma versão que adiciona um recurso, um recurso com gate de flag pode estar faltando. Essa sessão também pode iniciar em um modo de permissão diferente daquele em que suas sessões posteriores iniciam. Claude Code busca as flags durante essa sessão, então sua próxima sessão tem o recurso e o modo de permissão inicial usual. Após uma instalação limpa, em uma sessão não interativa como claude -p, o Agent SDK, ou a extensão VS Code, Claude Code ainda pode pegar as flags antes de escolher o modo de permissão inicial.

Veja também

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

​Definir variáveis de ambiente

​No seu shell

​Em arquivos de configurações

​Precedência

​Variáveis

​Recursos que precisam de busca de feature-flag

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

​Veja também