Variáveis de ambiente - Claude Code Docs

As variáveis de ambiente podem controlar o comportamento do Claude Code, como seleção de modelo, autenticação, roteamento de solicitaçõ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, uma flag CLI ou um comando em sessão como /model. Esta página aborda como:

Definir variáveis de ambiente no 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ê

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 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.

Em arquivos de configurações

Adicione variáveis sob a chave env em um arquivo settings.json. Claude Code as lê diretamente do arquivo na inicialização, então elas entram em efeito não importa como claude foi iniciado.

~/.claude/settings.json

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

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

Arquivo	Aplica-se a
`~/.claude/settings.json`	Você, em cada projeto
`.claude/settings.json`	Todos trabalhando no projeto, verificado no controle de origem
`.claude/settings.local.json`	Você, apenas neste projeto (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 onde cada arquivo reside e Precedência de configurações para como eles se combinam quando mais de um define a mesma variável.

Precedência

Quando o mesmo comportamento tem tanto uma variável de ambiente quanto um campo de configurações, a variável de ambiente tem precedência. Por exemplo, ANTHROPIC_MODEL substitui a configuração model, e CLAUDE_CODE_AUTO_CONNECT_IDE substitui autoConnectIde. O campo de configurações se aplica quando a variável de ambiente não está definida. Quando a mesma variável é definida tanto no seu shell quanto em um arquivo de configurações no bloco env, o valor do arquivo de configurações se aplica. Claude Code escreve cada entrada env no ambiente do processo na inicialização, substituindo o valor herdado do shell. Algumas variáveis são tratadas como casos especiais; a configuração env lista as exceções. 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. Como uma variável de ambiente interage com flags CLI e comandos em sessão varia por recurso: --model e /model substituem ANTHROPIC_MODEL, enquanto CLAUDE_CODE_EFFORT_LEVEL substitui /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 na inicialização, então as mudanças entram em efeito na próxima vez que você inicia claude.

Variáveis

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 em vez disso, execute `unset ANTHROPIC_API_KEY`
`ANTHROPIC_AUTH_TOKEN`	Valor personalizado para o cabeçalho `Authorization` (o valor que você definir aqui será prefixado com `Bearer` )
`ANTHROPIC_AWS_API_KEY`	Chave de API do workspace para 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.{AWS_REGION}.api.aws`
`ANTHROPIC_AWS_WORKSPACE_ID`	Obrigatório para Claude Platform on AWS. Enviado em cada solicitação como 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 de v2.1.196, Remote Control é desabilitado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento em 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_SERVICE_TIER`	Amazon Bedrock service tier (`default`, `flex` ou `priority`). Enviado como cabeçalho `X-Amzn-Bedrock-Service-Tier`. Veja Amazon Bedrock
`ANTHROPIC_BETAS`	Lista separada por vírgula de valores de cabeçalho `anthropic-beta` adicionais para incluir em solicitações de API. Claude Code já envia os cabeçalhos beta que precisa; use isso para optar por um beta da API Anthropic antes que Claude Code adicione suporte nativo. Diferentemente da flag `--betas`, que requer autenticação de chave de API, essa variável funciona com todos os métodos de autenticação, incluindo assinatura Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	Cabeçalhos personalizados para adicionar às solicitações (formato `Name: Value`, separados por quebra de linha para múltiplos cabeçalhos)
`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`. Padrão é o ID do modelo quando não definido
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Veja Configuração de modelo
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Veja Configuração de modelo
`ANTHROPIC_FOUNDRY_API_KEY`	Chave de API para autenticação do Microsoft Foundry (veja Microsoft Foundry)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Token Bearer para autenticação do Microsoft Foundry, como um token de acesso Microsoft Entra. Claude Code o envia como 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 para `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_SMALL_FAST_MODEL`	[DEPRECATED] Nome do modelo da classe Haiku para tarefas em segundo plano
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Substitua a região AWS para o modelo da classe Haiku ao usar Amazon Bedrock ou Amazon Bedrock Mantle. Em Amazon Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou o descontinuado `ANTHROPIC_SMALL_FAST_MODEL` também está definido, já que Amazon Bedrock de outra forma executa tarefas em segundo plano no modelo Sonnet padrão ou 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 solicitações Google Cloud’s Agent Platform. Substituído por `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` ou o projeto no seu arquivo de credenciais `GOOGLE_APPLICATION_CREDENTIALS`. Veja Google Cloud’s Agent Platform
`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 tempo limite de inatividade de 5 minutos que aborta uma resposta de modelo de streaming quando nenhum byte chega. Defina como `0` para desabilitar o tempo limite, por exemplo, quando um gateway lento ou modelo local pausa por mais de 5 minutos entre chunks. Defina como `1` para manter o tempo limite em cada provedor. Quando não definido, o tempo limite está inativo em conexões diretas da API Anthropic e Claude Platform on AWS, onde o próprio watchdog de stream de nível de byte do Claude Code é executado, e ativo em cada outro provedor, incluindo Google Cloud’s Agent Platform, Microsoft Foundry, Mantle, Amazon Bedrock e conexões de gateway, para que um stream travado seja abortado em vez de ficar pendurado. A partir de v2.1.169
`API_TIMEOUT_MS`	Tempo limite para solicitações de API em milissegundos (padrão: 600000, ou 10 minutos; máximo: 2147483647). Aumente isso quando as solicitações expiram em redes lentas ou ao rotear através de um proxy. Valores acima do máximo causam overflow do temporizador subjacente e fazem com que as solicitações falhem imediatamente
`AWS_BEARER_TOKEN_BEDROCK`	Chave de API do Amazon Bedrock para autenticação (veja Chaves de API do Amazon Bedrock)
`BASH_DEFAULT_TIMEOUT_MS`	Tempo limite 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 nas saídas bash antes da saída completa ser salva em um arquivo e Claude receber o caminho mais uma visualização curta. Veja Comportamento da ferramenta Bash
`BASH_MAX_TIMEOUT_MS`	Tempo limite máximo que o modelo pode definir para comandos bash de longa duração (padrão: 600000, ou 10 minutos)
`CCR_FORCE_BUNDLE`	Defina como `1` para forçar `claude --cloud` a agrupar e fazer upload do seu repositório local mesmo quando o acesso ao GitHub está disponível
`CLAUDECODE`	Defina como `1` em subprocessos que Claude Code gera (ferramentas Bash e PowerShell, sessões tmux, hook comandos, linha de status comandos, 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` em vez disso
`CLAUDE_AFK_COUNTDOWN_MS`	Quantos milissegundos antes da auto-continuação a contagem regressiva na tela aparece em um diálogo `AskUserQuestion` não respondido. Padrão `20000` (20 segundos), limitado ao tempo limite 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` não respondido auto-continuar sem você. Auto-continuação está desativada por padrão; opte por participar com a configuração `askUserQuestionTimeout`. Esta variável é um override 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 tempo limite; fecha o diálogo imediatamente. Em v2.1.198 e v2.1.199, auto-continuação estava ativada por padrão com um tempo limite 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 (a flag `-p`). Útil para usuários do SDK que desejam uma tela em branco
`CLAUDE_AGENT_SDK_MCP_NO_PREFIX`	Defina como `1` para pular o prefixo `mcp__<server>__` em nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas uso do SDK
`CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`	Tempo limite de travamento em milissegundos para subagentes em segundo plano. Padrão `600000` (10 minutos). O temporizador é reiniciado em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o subagente é abortado e a tarefa é marcada como falha, exibindo qualquer resultado parcial para o pai
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Defina a porcentagem (1-100) da janela de auto-compactação na qual a auto-compactação é acionada. Use valores mais baixos como `50` para compactar mais cedo. Esta variável só causa compactação mais cedo quando Claude Code compacta proativamente: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` está definido, em sessões em nuvem e em Sonnet 4.6 e Opus 4.6 sem contexto estendido, que compactam no limite de 200K por padrão. Em Sonnet 5, compactação proativa se aplica no limite padrão do modelo. Em outros casos, como uma sessão local em Opus 4.8, auto-compactação é acionada quando a conversa atinge o limite de contexto do modelo. O override só pode baixar o limite, então valores acima do padrão não têm efeito. Aplica-se a conversas principais e subagentes
`CLAUDE_AUTO_BACKGROUND_TASKS`	Defina como `1` para forçar a habilitação do envio automático para segundo plano de tarefas de agente de longa duração. Quando habilitado, subagentes são movidos para o segundo plano após executarem por aproximadamente dois minutos
`CLAUDE_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_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Retorne ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal
`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 de 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 em tela cheia em vez de enviar atualizações incrementais. Use isso se o modo tela cheia mostrar fragmentos de texto obsoletos ou deslocados. Claude Code habilita isso automaticamente para sessões em segundo plano e visualização de agentes no Windows
`CLAUDE_CODE_ALWAYS_ENABLE_EFFORT`	Defina como `1` para enviar o parâmetro esforço com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de esforço. 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 de esforço 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 no qual as credenciais devem ser atualizadas (ao usar `apiKeyHelper`)
`CLAUDE_CODE_ARTIFACT_AUTO_OPEN`	Defina como `0` para parar Claude Code de abrir o navegador automaticamente quando um novo artefato é publicado. Republicar um artefato existente não abre o navegador independentemente dessa configuração
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Defina como `0` para omitir o bloco de atribuição (versão do cliente e impressão digital do prompt) do início do prompt do sistema. Desabilitá-lo melhora as taxas de acerto do cache de prompt ao rotear através de um gateway LLM. O cache da API Anthropic não é afetado
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Defina a capacidade de contexto em tokens usada para cálculos de auto-compactação. Padrão é a janela de contexto do modelo: 200K para modelos padrão ou 1M para modelos de contexto estendido, exceto em Sonnet 5, que tem seu próprio limite padrão. Use um valor mais baixo como `500000` em um modelo de 1M para tratar a janela como 500K para fins de compactação. O valor é limitado à janela de contexto real do modelo. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` é aplicado como uma porcentagem deste valor. Definir esta variável desacopla o limite de compactação do `used_percentage` da linha de status, que sempre usa a janela de contexto completa do modelo
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Substitua a conexão IDE automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE suportada. Defina como `false` para evitar isso. Defina como `true` para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global `autoConnectIde`
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Tempo em milissegundos que Claude Code aguarda para que a cadeia de provedor de credencial padrão AWS produza 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 SSO baseado em navegador com MFA através de um wrapper como `aws-vault`. Aplica-se onde Claude Code assina com a cadeia padrão: Amazon Bedrock, Claude Platform on AWS e o endpoint Mantle. Requer Claude Code v2.1.207 ou posterior
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Definido 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` em vez disso
`CLAUDE_CODE_CERT_STORE`	Lista separada por vírgula de fontes de certificado CA para conexões TLS. `bundled` é o conjunto de CA Mozilla fornecido com Claude Code. `system` é o armazenamento de confiança do sistema operacional, somente leitura em tempos de execução 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, hook comandos e linha de status comandos. 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 pelo Claude Code quando ele inicia um subprocesso e não por extensões IDE, então distingue de forma confiável uma sessão aninhada de um `claude` de nível superior iniciado em um terminal integrado IDE. Uma `claude` TUI interativa aninhada iniciada desta forma é automaticamente excluída de `--resume`, `--continue`, histórico de seta para cima e a lista `claude agents`. Sessões `claude -p` não interativas ainda persistem. Defina `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` para substituir esta exclusão. Requer Claude Code v2.1.172 ou posterior
`CLAUDE_CODE_CLIENT_CERT`	Caminho para arquivo de certificado do cliente para autenticação mTLS
`CLAUDE_CODE_CLIENT_KEY`	Caminho para arquivo de chave privada do cliente para autenticação mTLS
`CLAUDE_CODE_CLIENT_KEY_PASSPHRASE`	Frase-passe para `CLAUDE_CODE_CLIENT_KEY` criptografada (opcional)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Removido em v2.1.186 e agora é um no-op. Anteriormente definia um tempo limite 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 tempo limite por solicitação
`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 habilitado separadamente via `--debug`, `/debug` ou a variável de ambiente `DEBUG`: definir apenas essa variável não habilita o logging. A flag `--debug-file` faz ambos de uma vez. Padrão é `~/.claude/debug/<session-id>.txt`
`CLAUDE_CODE_DEBUG_LOG_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 linha de status, ou aumente para `error` para reduzir ruído
`CLAUDE_CODE_DISABLE_1M_CONTEXT`	Defina como `1` para desabilitar suporte a janela de contexto de 1M. Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo, e sessões Sonnet 5 são tratadas como tendo uma janela de 200K. Útil para ambientes corporativos com requisitos de conformidade
`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`. A partir de v2.1.111, não tem efeito em Fable 5, Sonnet 5 ou Opus 4.7 e posterior, que sempre usam raciocínio adaptativo
`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 segundo plano e visualização de agentes: `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração `disableAgentView`
`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`	Defina como `1` para desabilitar renderização em tela cheia e usar o renderizador de tela principal clássico. A conversa permanece no scrollback nativo do seu terminal para que `Cmd+f` e modo de cópia tmux funcionem como de costume. Tem precedência sobre `CLAUDE_CODE_NO_FLICKER` e a configuração `tui`. Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas de visualização de agentes, que sempre usam renderização em tela cheia
`CLAUDE_CODE_DISABLE_ARTIFACT`	Defina como `1` para desabilitar a ferramenta Artifact, que publica saída de sessão como uma página web privada em claude.ai. Equivalente à configuração `disableArtifact`
`CLAUDE_CODE_DISABLE_ATTACHMENTS`	Defina como `1` para desabilitar o processamento de anexos. Menções de arquivo com sintaxe `@` são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	Defina como `1` para desabilitar memória automática. Defina como `0` para forçar a memória automática mesmo quando `--bare` mode ou `autoMemoryEnabled: false` desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática
`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`	Defina como `1` para desabilitar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro `run_in_background` em ferramentas Bash e subagent, auto-backgrounding e o atalho Ctrl+B
`CLAUDE_CODE_DISABLE_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, uma resposta com um tipo de conteúdo diferente falha com um erro nomeando esse tipo de conteúdo, o que significa que um gateway ou proxy está transformando a resposta. Defina apenas quando o gateway reescreve o cabeçalho `Content-Type` mas passa o corpo do event-stream binário inalterado; se o corpo em si foi transformado, as solicitações falham com `Truncated event message received` em vez disso. Requer Claude Code v2.1.208 ou posterior
`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`	Defina como `1` para parar os comandos de shell em segundo plano em execução de uma sessão em segundo plano, fluxos de trabalho dinâmicos e, a partir de v2.1.198, subagentes em segundo plano quando o supervisor para, reinicia ou atualiza o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas esse handoff: colocar uma sessão em segundo plano com `←` ou `/background` ainda carrega o trabalho em andamento, e `CLAUDE_DISABLE_ADOPT` desativa ambos. Requer Claude Code v2.1.196 ou posterior
`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`	Defina como `1` para parar Claude Code de encerrar comandos de shell em segundo plano quando o sistema operacional relata pressão de memória. Por padrão, em macOS e Linux, Claude Code encerra um shell em segundo plano iniciado na sessão principal em um sinal de pressão de memória uma vez que a sessão ficou ociosa por 30 minutos e nenhuma volta ou subagente está 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 que vêm com Claude Code: skills agrupadas e workflows integrados são removidos inteiramente, enquanto comandos slash 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` em vez disso. Skills de plugins, `.claude/skills/` e `.claude/commands/` não são afetadas. Equivalente à configuração `disableBundledSkills`; `0` não a substitui
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Defina como `1` para evitar carregar qualquer arquivo de memória CLAUDE.md no contexto, incluindo arquivos de usuário, projeto e memória automática
`CLAUDE_CODE_DISABLE_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_EXPERIMENTAL_BETAS`	Defina como `1` para remover cabeçalhos de solicitação `anthropic-beta` específicos do Anthropic e campos de esquema de ferramenta beta (como `defer_loading` e `eager_input_streaming`) de solicitações de API. Use isso quando um gateway proxy rejeita solicitações com erros como “Unexpected value(s) for the `anthropic-beta` header” ou “Extra inputs are not permitted”. Campos padrão (`name`, `description`, `input_schema`, `cache_control`) são preservados. Busca de ferramentas MCP é desabilitada e todas as ferramentas MCP carregam antecipadamente, mesmo quando `ENABLE_TOOL_SEARCH` está definido
`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 em vez disso, 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 todos os tipos de subagentes integrados no Agent SDK ou modo não interativo, use `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` em vez disso. Requer Claude Code v2.1.198 ou posterior
`CLAUDE_CODE_DISABLE_FAST_MODE`	Defina como `1` para desabilitar modo rápido
`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`	Defina como `1` para desabilitar as pesquisas de qualidade de sessão “Como Claude está se saindo?”. Pesquisas também são desabilitadas quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` está definido, a menos que `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` opte por participar novamente. Para definir uma taxa de amostra em vez de desabilitar completamente, use a configuração `feedbackSurveyRate`. Veja Pesquisas de qualidade de sessão
`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`	Defina como `1` para desabilitar checkpointing de arquivo. O comando `/rewind` não será capaz de restaurar alterações de código
`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`	Defina como `1` para remover instruções de fluxo de trabalho de commit e PR integradas e o snapshot de status git do prompt do sistema do Claude. Útil ao usar suas próprias skills de fluxo de trabalho git. Tem precedência sobre a configuração `includeGitInstructions` quando definido
`CLAUDE_CODE_DISABLE_LEGACY_MODEL_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ê deseja intencionalmente fixar um modelo mais antigo. O remapeamento não é executado em 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 em tela cheia. A rolagem por teclado com `PgUp` e `PgDn` ainda funciona. Use isso para manter o comportamento nativo de cópia ao selecionar do seu terminal
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Defina como `1` para desabilitar clique, arrasto e manipulação de hover em renderização em tela cheia enquanto mantém a rolagem da roda do mouse. Use isso quando você quer que a rolagem da roda funcione dentro do 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_NONESSENTIAL_TRAFFIC`	Equivalente a definir `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY`
`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 em vez disso. Útil quando um proxy ou gateway causa o fallback para 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 no terminal. Esta variável desabilita apenas essa verificação local, então o servidor ainda pode suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior
`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`	Defina como `1` para pular a adição automática do marketplace de plugin oficial na primeira execução
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Defina como `1` para pular o carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de contêiner ou CI que não devem carregar skills provisionadas pelo operador
`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`	Defina como `1` para desabilitar atualizações automáticas de título do terminal com base no contexto da conversa. Em sessões Agent SDK e `claude -p`, isso também pula a solicitação de Haiku em segundo plano que gera o título da sessão
`CLAUDE_CODE_DISABLE_THINKING`	Defina como `1` para omitir o parâmetro `thinking` de solicitações de API inteiramente. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. O comportamento da variável é inalterado em relação a versões anteriores; 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` em vez disso, que também é ineficaz em Fable 5 já que não pode ter pensamento desligado. Em provedores de terceiros, `0` igualmente omite o parâmetro, então as duas variáveis se comportam da mesma forma lá
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Defina como `1` para desabilitar rolagem virtual em renderização em tela cheia e renderizar cada mensagem na transcrição. Use isso se a rolagem em modo tela cheia mostrar regiões em branco onde as mensagens deveriam aparecer
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Defina como `1` para desabilitar workflows. Equivalente à configuração `disableWorkflows`
`CLAUDE_CODE_EFFORT_LEVEL`	Defina o nível de esforço para modelos suportados. Valores: `low`, `medium`, `high`, `xhigh`, `max` ou `auto` para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre `/effort` e a configuração `effortLevel`. Veja Ajustar nível de esforço
`CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT`	Defina como `1` para habilitar a adição de texto extra ao final do prompt do sistema de cada subagente. A flag `--append-subagent-system-prompt` fornece o texto adicionado e define esta variável automaticamente, então você não precisa defini-la você mesmo. Requer Claude Code v2.1.205 ou posterior
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Aceito para compatibilidade com versões mais antigas e não tem efeito. Modo automático 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. Em v2.1.158 através v2.1.206, definir isso como `1` era necessário para disponibilizar modo automático nesses provedores
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Substitua a disponibilidade de recapitulação de sessão. Defina como `0` para forçar recapitulações desativadas independentemente do toggle `/config`. Defina como `1` para forçar recapitulações ativadas quando `awaySummaryEnabled` é `false`. Tem precedência sobre a configuração e toggle `/config`
`CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH`	Defina como `1` para atualizar o estado do plugin em limites de turno em modo não interativo após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o prompt do sistema no meio da sessão, o que invalida prompt caching para esse turno
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Defina como `1` para rotear a pesquisa de qualidade de sessão “Como Claude está se saindo?” para seu próprio coletor OpenTelemetry quando o tráfego não essencial vinculado ao Anthropic está bloqueado. As classificações de pesquisa são emitidas apenas como eventos OTEL para seu coletor configurado. Nenhum dado de pesquisa é enviado ao Anthropic neste modo. Aplica-se quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` está definido, e não tem efeito caso contrário. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e a política de feedback do produto da organização têm precedência
`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING`	Controla se as entradas de chamada de ferramenta são transmitidas da API conforme Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como uma escrita de arquivo longa, chega apenas após Claude terminar de gerá-la, o que pode parecer que está travando. Habilitado por padrão na API Anthropic. Em Amazon Bedrock e Google Cloud’s Agent Platform, habilitado por modelo onde o contêiner implantado suporta. Defina como `0` para optar por não participar. Defina como `1` para forçar a habilitação ao rotear através de um proxy via `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL`. Desativado por padrão em Microsoft Foundry e conexões gateway
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`	Defina como `1` para popular o seletor `/model` a partir do endpoint `/v1/models` do seu gateway quando `ANTHROPIC_BASE_URL` aponta para um gateway compatível com Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque gateways apoiados por uma chave de API compartilhada mostrariam de outra forma cada usuário cada modelo que a chave pode acessar. Modelos descobertos ainda são filtrados pela lista de permissões `availableModels` que a sessão recebe; entregue a lista através de MDM ou um arquivo de configurações gerenciado, 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 em v2.1.142, quando o padrão de modo rápido mudou de Opus 4.6 para Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Defina como `false` para desabilitar sugestões de prompt (o toggle “Prompt suggestions” em `/config`). Estas são as previsões acinzentadas que aparecem na sua entrada de prompt após Claude responder. Veja Sugestões de prompt
`CLAUDE_CODE_ENABLE_TASKS`	Controla se as sessões usam as ferramentas Task estruturadas (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou a ferramenta legada `TodoWrite`. A partir do Claude Code v2.1.142, as ferramentas Task são o padrão em todos os modos. Defina como `0` para reverter para `TodoWrite`. Veja Lista de tarefas e Migrar para ferramentas Task
`CLAUDE_CODE_ENABLE_TELEMETRY`	Defina como `1` para habilitar coleta de dados OpenTelemetry para métricas e logging. Obrigatório antes de configurar exportadores OTel. Veja Monitoramento
`CLAUDE_CODE_EXIT_AFTER_STOP_DELAY`	Tempo em milissegundos para aguardar após o loop de consulta ficar ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts usando modo SDK
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Defina como `1` para habilitar equipes de agentes. As 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 segundo plano que você despacha com `claude agents` ou `--bg`. Antes de v2.1.206, sessões em segundo plano ignoravam um valor exportado em shell e usavam qualquer cópia que o processo supervisor em segundo plano herdou
`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 na íntegra
`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 lançador em segundo plano iniciado pela primeira vez pela ferramenta Bash do Claude Code, causa uma sessão genuína de nível superior a ser classificada incorretamente como aninhada. A partir de v2.1.178, Claude Code detecta o caso tmux automaticamente e ignora o marcador herdado, então tmux não precisa mais dessa variável. Também honrado em v2.1.169 e anterior; não tem efeito em v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que ele substitui foi removida
`CLAUDE_CODE_FORCE_STRIKETHROUGH`	Defina como `1` para forçar renderização de tachado para `~~text~~` nas respostas do Claude quando seu terminal suporta mas não é detectado automaticamente, 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 a habilitação do modo privado DEC 2026 saída sincronizada quando seu terminal suporta mas não é detectado automaticamente. Útil para emuladores como `eat` do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux. Diferentemente de `CLAUDE_CODE_NO_FLICKER`, que muda para renderização em tela cheia, isso não altera o renderizador
`CLAUDE_CODE_FORK_SUBAGENT`	Defina como `1` para permitir subagentes bifurcados, ou `0` para desabilitá-los, substituindo qualquer rollout do lado do servidor. Quando habilitado, Claude pode solicitar o tipo de subagente `fork` para gerar uma bifurcação, um subagente que herda o contexto de conversa completo em vez de começar do zero. Spawns sem um tipo de subagente ainda usam o subagente de propósito geral, e todos os spawns de subagente são executados em segundo plano. O comando `/fork` explícito funciona sem essa variável. Funciona em modo interativo e via SDK ou `claude -p`
`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 está no seu PATH. Veja Configuração do 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 autocomplete de arquivo `@`, `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 pelo git. Não afeta autocomplete de arquivo `@`, que tem sua própria configuração `respectGitignore`
`CLAUDE_CODE_GLOB_TIMEOUT_SECONDS`	Tempo limite em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL
`CLAUDE_CODE_HIDE_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 detecta automaticamente o endereço correto, incluindo roteamento WSL-para-Windows
`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`	Defina como `1` para pular a 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 a conexão. Use quando a auto-conexão falha em encontrar sua IDE apesar dela estar em execução
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. A partir de v2.1.193, aplicado diretamente para nomes de modelo que Claude Code não reconhece como um modelo Claude; para modelos Claude reconhecidos, só tem efeito quando `DISABLE_COMPACT` também está definido. Use isso ao rotear para um modelo através de `ANTHROPIC_BASE_URL` cuja janela de contexto não corresponde ao tamanho integrado para seu nome
`CLAUDE_CODE_MAX_OUTPUT_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. Aumentar este valor reduz a janela de contexto efetiva disponível antes que auto-compactação seja 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 de v2.1.186; a partir de 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` em vez disso
`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 o paralelismo mas consomem mais recursos
`CLAUDE_CODE_MAX_TURNS`	Limite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar `--max-turns`, que tem precedência quando ambos estão definidos. Um valor que não é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite
`CLAUDE_CODE_MCP_ALLOWLIST_ENV`	Defina como `1` para gerar servidores MCP stdio com apenas um ambiente de linha de base segura mais o `env` configurado do servidor, em vez de herdar seu ambiente de shell
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	Tempo limite de inatividade em milissegundos para chamadas de ferramentas MCP. Quando um servidor MCP stdio, HTTP, SSE, WebSocket ou conector claude.ai não envia resposta e nenhuma notificação de progresso por este 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 do SDK. Requer Claude Code v2.1.187 ou posterior. Antes de v2.1.203, servidores stdio eram isentos do tempo limite de inatividade
`CLAUDE_CODE_NATIVE_CURSOR`	Defina como `1` para mostrar o cursor próprio do terminal no cursor de entrada em vez de um bloco desenhado. O cursor respeita as configurações de piscar, forma e foco do terminal
`CLAUDE_CODE_NEW_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_NO_FLICKER`	Defina como `1` para habilitar renderização em tela cheia, uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Equivalente à configuração `tui`; você também pode alternar com `/tui fullscreen`
`CLAUDE_CODE_OAUTH_REFRESH_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 com os quais o token de atualização foi emitido, como `"user:profile user:inference user:sessions:claude_code"`. Obrigatório quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` está definido
`CLAUDE_CODE_OAUTH_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`
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Removido em 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_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`, então um exportador mal configurado, como uma colisão de porta Prometheus, falha silenciosamente de outra forma. Requer Claude Code v2.1.179 ou posterior. Veja Monitoramento
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Tempo limite 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`	Tempo limite em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja Monitoramento
`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`	Defina como `1` para permitir que Claude Code execute o comando de atualização do seu gerenciador de pacotes em segundo plano quando uma nova versão estiver disponível. Aplica-se a instalações Homebrew e WinGet. Outros gerenciadores de pacotes continuam a mostrar o comando de atualização sem executá-lo. Veja Auto updates
`CLAUDE_CODE_PERFORCE_MODE`	Defina como `1` para habilitar proteção de escrita ciente de Perforce. Quando definido, Edit, Write e NotebookEdit falham com uma dica `p4 edit <file>` se o arquivo de destino não tiver o bit de escrita do proprietário, que Perforce limpa em arquivos sincronizados até que `p4 edit` os abra. Isso evita que Claude Code contorne o rastreamento de mudanças do Perforce
`CLAUDE_CODE_PLUGIN_CACHE_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 este caminho. Padrão é `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Tempo limite em milissegundos para operações git ao instalar ou atualizar plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Veja Operações Git expiram
`CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE`	Defina como `1` para manter o cache de marketplace existente quando um `git pull` falha em vez de limpar e re-clonar. Útil em ambientes offline ou airgapped onde re-clonar falharia da mesma forma. Veja Atualizações de marketplace falham em ambientes offline
`CLAUDE_CODE_PLUGIN_PREFER_HTTPS`	Defina como `1` para clonar fontes de plugin GitHub `owner/repo` via HTTPS em vez de SSH. Aplica-se a instalação de plugin e atualização, e a `/plugin marketplace add` e `update`. Útil em executores CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para `github.com`
`CLAUDE_CODE_PLUGIN_SEED_DIR`	Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por `:` em Unix ou `;` no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de contêiner. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja Pré-popular plugins para contêineres
`CLAUDE_CODE_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 linha de status, e respeitar a política de execução efetiva da máquina em vez disso. Por padrão, Claude Code contorna a política de execução no escopo do processo para que scripts `.ps1` e importações de módulo funcionem em instalações Windows padrão com Restricted. O bypass no escopo do processo nunca substitui a Política de Grupo `MachinePolicy` ou `UserPolicy` independentemente dessa configuração
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Tempo máximo em milissegundos que modo não interativo com a flag `-p` aguarda após a volta final para subagentes em segundo plano e workflows cujo resultado faz parte da saída. Padrão: `600000`, ou 10 minutos. Quando o limite é excedido, tarefas em segundo plano restantes são encerradas e o processo sai. Defina como `0` para aguardar indefinidamente. Este limite é separado do período de carência de cinco segundos que se aplica a shells em segundo plano simples
`CLAUDE_CODE_PROCESS_WRAPPER`	Inicie os processos que Claude Code começa a partir de seu próprio binário através de um executável wrapper, dado como um prefixo argv como `/opt/corp/launcher`. Cobre o serviço em segundo plano que hospeda sessões visualização de agentes, cada sessão que ele gera e o relançamento que Claude Code realiza de si mesmo para terminar de instalar uma atualização. O primeiro token deve ser o caminho absoluto de um executável que termina executando `exec "$@"`, e a maioria dos lançadores é apenas esse caminho único. O valor é uma lista de argumentos, não um comando de shell: espaço em branco separa tokens, aspas duplas agrupam um caminho que contém espaços, e um valor que começa com `[` é lido como uma matriz de string JSON. Defina em bloco `env` de configurações de usuário ou gerenciadas, não como exportação de shell, para que o serviço em segundo plano desanexado o herde; configurações de projeto e local não podem defini-lo. A extensão VS Code configura seu próprio lançador separadamente através de sua configuração `claudeProcessWrapper`. Ignorado no Windows. `CLAUDE_CODE_SHELL_PREFIX` é um controle separado: envolve os comandos de shell que Claude Code executa como uma string única entre aspas, enquanto essa variável envolve os próprios processos do Claude Code como um prefixo argv. Veja Executar Claude Code atrás de um lançador corporativo
`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 é habilitada apenas quando conectado diretamente à API Anthropic. Adicionado em v2.1.152. Veja Rastreamentos (beta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Definido por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, seleção de provedor, endpoint e variáveis de autenticação como `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` em arquivos de configuração são ignorados para que configurações de usuário não possam substituir o roteamento do host. O opt-out automático de telemetria para Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry também é ignorado, então a telemetria segue o opt-out padrão `DISABLE_TELEMETRY`. Veja Comportamentos padrão por provedor de API
`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`	Defina como `1` para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host
`CLAUDE_CODE_REMOTE`	Definido automaticamente como `true` quando Claude Code está em execução como uma sessão em nuvem. Leia isso de um hook ou script de configuração para detectar se você está em um ambiente em nuvem
`CLAUDE_CODE_REMOTE_SESSION_ID`	Definido 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_RESUME_INTERRUPTED_TURN`	Defina como `1` para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt
`CLAUDE_CODE_RESUME_PROMPT`	Substitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é `Continue from where you left off.`. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de inicialização mais diretiva. Uma string vazia usa o padrão
`CLAUDE_CODE_RETRY_WATCHDOG`	Defina como `1` para sessões não supervisionadas, como harnesses de avaliação, trabalhos CI ou workers remotos. Tenta novamente erros de capacidade `429` e `529` indefinidamente em vez de falhar após `CLAUDE_CODE_MAX_RETRIES` tentativas. O watchdog recua até 5 minutos entre tentativas, ou até o limite ser redefinido quando a resposta carrega um tempo de redefinição de limite de taxa, então uma sessão que atinge um limite de uso aguarda a janela restante. A partir de v2.1.199, também aumenta a contagem de retry padrão para outros erros transitórios, como erros de servidor, timeouts e conexões descartadas, para 300, aproximadamente três horas de backoff, e remove o limite de 15 em `CLAUDE_CODE_MAX_RETRIES` se você definir essa variável explicitamente. Requer 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 linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam, para solucionar problemas de uma configuração quebrada. A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Equivalente a passar `--safe-mode`. Processos filhos gerados diretamente 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; os valores são limites de chamadas inteiras. Por exemplo, `{"deploy.sh": 2}` permite que `deploy.sh` seja chamado no máximo duas vezes. A correspondência é baseada em substring, então truques de expansão de shell como `./scripts/deploy.sh $(evil)` ainda contam contra o limite. Fan-out em tempo de execução via `xargs` ou `find -exec` não é detectado; este é um controle de defesa em profundidade
`CLAUDE_CODE_SCROLL_SPEED`	Defina o multiplicador de rolagem da roda do mouse em renderização em tela cheia. Aceita valores de 1 a 20 e valores fracionários abaixo de 1, como `0.5` para desacelerar a rolagem acelerada de trackpad e roda em terminais que já amplificam eventos de roda. Defina como `3` para corresponder a `vim` se seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio tratamento de rolagem
`CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`	Substitua o orçamento de tempo em milissegundos para hooks SessionEnd. Aplica-se à saída de sessão, `/clear` e alternância de sessões via `/resume` interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o `timeout` por hook mais alto configurado em arquivos de configuração, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento
`CLAUDE_CODE_SESSION_ID`	Definido automaticamente em subprocessos de ferramenta Bash e PowerShell, subprocessos de comando hook e subprocessos servidor MCP stdio para o ID da sessão atual. 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>` ele recebe o ID retomado, correspondendo a hooks e Bash. Em `--continue` ou `--resume` sem um ID explícito, ele pode receber o ID de inicialização inicial em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou
`CLAUDE_CODE_SHELL`	Defina o shell que Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário `bash` ou `zsh`, por exemplo `/opt/homebrew/bin/bash`. Outros shells como `fish` não são suportados. Se o valor não for um caminho `bash` ou `zsh` funcionando, Claude Code o ignora e volta para auto-detecção. A auto-detecção usa seu `$SHELL` quando aponta para `bash` ou `zsh`, caso contrário, escolhe o primeiro `zsh` funcionando e depois `bash` encontrado no seu `PATH` e locais de instalação padrão
`CLAUDE_CODE_SHELL_PREFIX`	Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos hook, linha de status comandos, e comandos de inicialização de servidor MCP stdio. Hooks de forma exec e hooks PowerShell são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples como `/path/to/logger.sh` executa cada comando como `/path/to/logger.sh '<command>'`. O wrapper recebe a linha de comando como um único argumento shell-quoted em `$1`, então o wrapper deve 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 as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de `--mcp-config` ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Tokens OAuth e credenciais de keychain não são lidos, então a autenticação Anthropic deve 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 optar por não participar mesmo em modelos onde o experimento ou configuração do servidor habilitaria de outra forma. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados
`CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH`	Pule autenticação do lado do cliente para Claude Platform on AWS, para gateways que assinam solicitações por conta própria
`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 tempo limite 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_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 do 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 de 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 a escrita de histórico de prompt e transcrições de sessão em disco. Sessões iniciadas com essa variável definida não aparecem em `--resume`, `--continue` ou histórico de seta para cima. Útil para sessões com script efêmeras
`CLAUDE_CODE_SKIP_VERTEX_AUTH`	Pule autenticação Google para Google Cloud’s Agent Platform (por exemplo, ao usar um gateway LLM)
`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`	Número máximo de vezes consecutivas que um hook Stop ou SubagentStop pode bloquear o término da volta antes que Claude Code o substitua e termine a volta de qualquer forma (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`	Veja Configuração de modelo. A partir de v2.1.196, defini-lo como `inherit` é o mesmo que deixá-lo não definido; versões anteriores tratavam `inherit` como um override que forçava cada subagente para o modelo da conversa principal
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Defina como `1` para remover credenciais do Anthropic e do provedor de nuvem de ambientes de subprocesso (ferramenta Bash, hooks, servidores MCP stdio). O processo Claude pai mantém essas credenciais para chamadas de API, mas processos filhos não podem lê-las, reduzindo a exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão de shell. No Linux, isso também executa subprocessos Bash em um namespace PID isolado para que não possam ler ambientes de processo do host via `/proc`; como efeito colateral, `ps`, `pgrep` e `kill` não podem ver ou sinalizar processos do host. `claude-code-action` define isso automaticamente quando `allowed_non_write_users` está configurado
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Defina como `1` em modo não interativo (a flag `-p`) para aguardar a conclusão da instalação de plugin antes da primeira consulta. Sem isso, plugins instalam em segundo plano e podem não estar disponíveis na primeira volta. Combine com `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` para limitar a espera
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`	Tempo limite em milissegundos para instalação síncrona de plugin. Quando excedido, Claude Code prossegue sem plugins e registra um erro. Sem padrão: sem essa variável, instalação síncrona aguarda até a conclusão
`CLAUDE_CODE_SYNC_SKILLS`	Defina como `1` para baixar suas skills habilitadas do claude.ai em `~/.claude/skills/` antes da primeira consulta e ressincronizar a cada 10 minutos. Aplica-se apenas em modo não interativo com a flag `-p`. Requer autenticação claude.ai. Claude Code on the web sessões recebem suas skills habilitadas do claude.ai automaticamente; você não precisa definir isso lá
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Tempo limite em milissegundos para uma ressincronização de skills no meio da sessão quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 30000). Limita o download acionado quando o host solicita um recarregamento de skill durante a sessão. Quando excedido, a ressincronização para e os downloads de skill restantes continuam em segundo plano
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Tempo limite em milissegundos para a primeira consulta aguardar na sincronização inicial de skills quando `CLAUDE_CODE_SYNC_SKILLS` está definido (padrão: 5000). Quando excedido, a consulta prossegue e os downloads de skill restantes continuam em segundo plano
`CLAUDE_CODE_SYNTAX_HIGHLIGHT`	Defina como `false` para desabilitar destaque de sintaxe na saída de diff. Útil quando cores interferem com sua configuração de terminal. Para também desabilitar destaque em blocos de código e visualizações de arquivo, use a configuração `syntaxHighlightingDisabled`
`CLAUDE_CODE_TASK_LIST_ID`	Compartilhe uma lista de tarefas entre sessões. Defina o mesmo ID em múltiplas instâncias do Claude Code para coordenar em uma lista de tarefas compartilhada. Veja Lista de tarefas
`CLAUDE_CODE_TEAM_NAME`	Nome da equipe de agentes à qual este companheiro pertence. Definido automaticamente em membros de equipe de agentes
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Substitua, em milissegundos, quanto tempo uma sessão não interativa aguarda na saída para que sua equipe de agentes termine 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 este caminho. Padrão: `/tmp` em macOS, `os.tmpdir()` em Linux e Windows. A partir de v2.1.161, 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 inalterado. Os próprios arquivos temporários do Claude Code sempre usam sua substituição
`CLAUDE_CODE_TMUX_TRUECOLOR`	Defina como `1` para permitir saída truecolor de 24 bits dentro de tmux. Por padrão, Claude Code limita a 256 cores quando `$TMUX` está definido porque tmux não passa sequências de escape truecolor a menos que esteja configurado para isso. Defina isso após adicionar `set -ga terminal-overrides ',*:Tc'` ao seu `~/.tmux.conf`. Veja Configuração de terminal para outras configurações de tmux
`CLAUDE_CODE_USE_ANTHROPIC_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 do Amazon Bedrock
`CLAUDE_CODE_USE_NATIVE_FILE_SEARCH`	Defina como `1` para descobrir comandos personalizados, subagentes e estilos de saída usando APIs de arquivo Node.js em vez de ripgrep. Defina isso se o binário ripgrep agrupado estiver indisponível ou bloqueado em seu ambiente. Não afeta as ferramentas Grep ou busca de arquivo
`CLAUDE_CODE_USE_POWERSHELL_TOOL`	Controla a ferramenta PowerShell. No Windows sem Git Bash, a ferramenta é habilitada automaticamente; defina como `0` para desabilitá-la. No Windows com Git Bash instalado, a ferramenta está sendo lançada progressivamente: defina como `1` para optar por participar ou `0` para optar por não participar. No Linux, macOS e WSL, defina como `1` para habilitá-la, o que requer `pwsh` no seu `PATH`. Quando habilitada no Windows, Claude pode executar comandos PowerShell nativamente em vez de rotear através do Git Bash. Veja Ferramenta PowerShell
`CLAUDE_CODE_USE_VERTEX`	Use Google Cloud’s Agent Platform
`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 este caminho, assim como credenciais no Linux e Windows; em macOS, credenciais estão no Keychain do sistema. Útil para executar múltiplas contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`
`CLAUDE_DISABLE_ADOPT`	Defina como `1` para parar o trabalho em segundo plano em andamento em vez de carregá-lo quando você coloca uma sessão em segundo plano pressionando `←` ou com `/background`. Claude Code pede que você confirme antes de colocar em segundo plano, então para as tarefas que de outra forma seriam carregadas. Requer Claude Code v2.1.195 ou posterior
`CLAUDE_EFFORT`	Definido automaticamente em subprocessos de ferramenta Bash e comandos hook para o nível de esforço ativo para a volta: `low`, `medium`, `high`, `xhigh` ou `max`. Ultracode não é um nível distinto e relata como `xhigh`. Corresponde ao campo `effort.level` passado para hooks. Apenas definido quando o modelo atual suporta o parâmetro de esforço
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Defina como `1` para forçar a habilitação do watchdog ocioso de nível de byte, ou defina como `0` para forçar a desabilitação. Quando não definido, o watchdog é habilitado por padrão para conexões diretas da API Anthropic e Claude Platform on AWS. O watchdog de byte aborta uma conexão quando nenhum byte chega no fio por 180 segundos por padrão em conexões diretas da API Anthropic, 300 segundos em Claude Platform on AWS e quando habilitado em Amazon Bedrock, ou para o valor de `CLAUDE_STREAM_IDLE_TIMEOUT_MS` quando isso está definido, que é fixado a um mínimo de 5 minutos, independente do watchdog de nível de evento
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Defina como `1` para habilitar o watchdog ocioso de streaming de nível de byte em respostas `vnd.amazon.eventstream` do Amazon Bedrock. Desativado por padrão. Configure o tempo limite com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`CLAUDE_ENABLE_STREAM_WATCHDOG`	Defina como `0` para forçar a desabilitação do watchdog ocioso de streaming de nível de evento, ou defina como `1` para forçar a habilitação. Quando não definido, o watchdog está ativado por padrão para todos os provedores. Antes de v2.1.196, o padrão não definido era controlado pelo servidor na API Anthropic direta e desativado em outros provedores. A partir de v2.1.169, provedores diferentes da API Anthropic direta e Claude Platform on AWS também têm um tempo limite de inatividade de corpo padrão de 5 minutos independente desta variável; veja `API_FORCE_IDLE_TIMEOUT`. Em Amazon Bedrock, você também pode habilitar o watchdog de nível de byte independente com `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; os dois funcionam juntos quando ambos estão definidos. Configure o tempo limite com `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`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 as exportações no arquivo sejam visíveis para o comando. Use para persistir ativação de virtualenv ou conda entre comandos. Também preenchido dinamicamente por hooks SessionStart, Setup, CwdChanged e FileChanged
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Prefixo para nomes de sessão Remote Control gerados automaticamente quando nenhum nome explícito é fornecido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. A flag CLI `--remote-control-session-name-prefix` define o mesmo valor para uma única invocação
`CLAUDE_STREAM_IDLE_TIMEOUT_MS`	Tempo limite em milissegundos antes que o watchdog ocioso de streaming feche uma conexão travada. Quando você define esta variável explicitamente, o mínimo é `300000` (5 minutos); valores mais baixos são silenciosamente fixados para absorver pausas de pensamento estendido e buffering de proxy. Quando não definido, o watchdog de nível de evento padrão é 300 segundos e o watchdog de nível de byte padrão é 180 segundos em conexões diretas da API Anthropic (300 segundos em Claude Platform on AWS e outros provedores). O padrão de 180 segundos do watchdog de byte não definido é um valor separado e não está sujeito ao clamp de 5 minutos. O tempo limite de inatividade de corpo descrito em `API_FORCE_IDLE_TIMEOUT` se aplica independentemente. Em Amazon Bedrock, também se aplica quando `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`
`DEBUG`	Defina como `1` para habilitar modo de depuração, equivalente a iniciar com `--debug`. Logs de depuração são escritos em `~/.claude/debug/<session-id>.txt`, ou no caminho definido por `CLAUDE_CODE_DEBUG_LOGS_DIR`. Apenas os valores verdadeiros `1`, `true`, `yes` e `on` habilitam modo de depuração, então padrões de namespace como `DEBUG=express:*` definidos para outras ferramentas não o acionam
`DISABLE_AUTOUPDATER`	Defina como `1` para desabilitar atualizações automáticas em segundo plano. Manual `claude update` 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ê deseja controle explícito sobre quando a compactação ocorre
`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 de verificação de configuração `/doctor` 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 de v2.1.205, essa variável ocultava a tela de diagnósticos `/doctor`
`DISABLE_ERROR_REPORTING`	Defina como `1` para optar por não participar do relatório de erros
`DISABLE_EXTRA_USAGE_COMMAND`	Defina como `1` para ocultar o comando `/usage-credits` que permite aos usuários comprar uso adicional além dos limites de taxa
`DISABLE_FEEDBACK_COMMAND`	Defina como `1` para desabilitar o comando `/feedback`. O nome mais antigo `DISABLE_BUG_COMMAND` também é aceito
`DISABLE_GROWTHBOOK`	Defina como `1` para desabilitar busca de flag de recurso GrowthBook e usar padrões de código para cada flag. Logging de eventos de telemetria permanece ativado a menos que `DISABLE_TELEMETRY` também esteja definido
`DISABLE_INSTALLATION_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 a 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 prompt caching para todos os modelos (tem precedência sobre configurações por modelo)
`DISABLE_PROMPT_CACHING_FABLE`	Defina como `1` para desabilitar prompt caching para modelos Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Defina como `1` para desabilitar prompt caching para modelos Haiku
`DISABLE_PROMPT_CACHING_OPUS`	Defina como `1` para desabilitar prompt caching para modelos Opus
`DISABLE_PROMPT_CACHING_SONNET`	Defina como `1` para desabilitar prompt caching para modelos Sonnet
`DISABLE_TELEMETRY`	Defina como `1` para optar por não participar da telemetria. Eventos de telemetria não incluem dados do usuário como código, caminhos de arquivo ou comandos bash. Também desabilita busca de flags de recurso com o mesmo efeito que `DISABLE_GROWTHBOOK`, então alguns recursos sinalizados podem não estar disponíveis
`DISABLE_UPDATES`	Defina como `1` para bloquear todas as atualizações, incluindo manual `claude update` e `claude install`. Mais rigoroso que `DISABLE_AUTOUPDATER`. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar
`DISABLE_UPGRADE_COMMAND`	Defina como `1` para ocultar o comando `/upgrade`
`DO_NOT_TRACK`	Defina como `1` para optar por não participar da telemetria. Equivalente a definir `DISABLE_TELEMETRY`. Claude Code honra isso como a convenção padrão entre ferramentas reconhecida por muitos CLIs de desenvolvedor
`ENABLE_CLAUDEAI_MCP_SERVERS`	Defina como `false` para desabilitar servidores MCP claude.ai no Claude Code. Habilitado por padrão para usuários conectados. Para desabilitar por projeto ou por organização, defina `disableClaudeAiConnectors` em configurações em vez disso
`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 para usuários de chave de API, Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry e Claude Platform on AWS. Usuários de assinatura recebem TTL de 1 hora automaticamente. Escritas de cache de 1 hora são cobradas a uma taxa mais alta
`ENABLE_PROMPT_CACHING_1H_BEDROCK`	Descontinuado. Use `ENABLE_PROMPT_CACHING_1H` em vez disso
`ENABLE_TOOL_SEARCH`	Controla busca de ferramentas MCP. Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em Google Cloud’s Agent Platform ou quando `ANTHROPIC_BASE_URL` aponta para um host que não é de primeira parte. Valores: `true` (sempre adia e envia o cabeçalho beta, solicitações falham em modelos Google Cloud’s Agent Platform anteriores a Sonnet 4.5 ou Opus 4.5, ou em proxies que não suportam `tool_reference`), `auto` (modo de limite: carrega antecipadamente se as ferramentas se encaixarem em 10% do contexto), `auto:N` (limite personalizado, por exemplo, `auto:5` para 5%), `false` (carrega tudo antecipadamente). Ignorado quando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está definido, que força todas as ferramentas a carregar antecipadamente
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Defina como qualquer valor não vazio para fazer todos os modelos, não apenas Opus, parar de tentar novamente com um erro de sobrecarga repetido quando nenhum modelo fallback está configurado. A partir de v2.1.160, uma cadeia de modelo fallback configurada aciona em erros de sobrecarga repetidos para qualquer modelo primário, então esta variável não afeta a alternância para um modelo fallback
`FORCE_AUTOUPDATE_PLUGINS`	Defina como `1` para forçar auto-atualizações de plugins mesmo quando o auto-atualizador principal está desabilitado via `DISABLE_AUTOUPDATER`
`FORCE_HYPERLINK`	Defina como `1` para habilitar hyperlinks OSC 8 clicáveis quando seu terminal suporta mas não é detectado automaticamente, ou `0` para desabilitá-los
`FORCE_PROMPT_CACHING_5M`	Defina como `1` para forçar o TTL de cache de prompt de 5 minutos mesmo quando o TTL de 1 hora se aplicaria de outra forma. Substitui `ENABLE_PROMPT_CACHING_1H`
`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 `1` para habilitar modo demo: oculta seu email e nome da organização do cabeçalho e saída `/status`, e pula onboarding. Útil ao fazer streaming ou gravar uma sessão
`MAX_MCP_OUTPUT_TOKENS`	Número máximo de tokens permitidos em respostas de ferramentas MCP. Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram `anthropic/maxResultSizeChars` usam esse limite de caracteres para conteúdo de texto em vez disso, mas conteúdo de imagem dessas ferramentas ainda está sujeito a essa variável (padrão: 25000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Número de vezes para tentar novamente quando a resposta do modelo falha na validação contra o `--json-schema` em modo não interativo (a flag `-p`). Padrão é 5
`MAX_THINKING_TOKENS`	Substitua o orçamento de token de pensamento estendido. O teto é o max output tokens do modelo menos um. Defina como `0` para desabilitar pensamento na API Anthropic exceto em Fable 5, que não pode ter pensamento desligado. Em provedores de terceiros, `0` igualmente omite o parâmetro, e modelos com raciocínio adaptativo ainda podem pensar. Para valores diferentes de zero em modelos de raciocínio adaptativo, o orçamento é ignorado a menos que raciocínio adaptativo seja desabilitado via `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`
`MCP_CLIENT_SECRET`	Segredo do 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. A partir do Claude Code v2.1.142, a inicialização MCP é não-bloqueante por padrão: servidores se conectam em segundo plano e suas ferramentas ficam disponíveis conforme terminam. Defina como `0` para restaurar a espera de conexão bloqueante de 5 segundos. Servidores configurados com `alwaysLoad: true` ainda bloqueiam a inicialização independentemente, já que suas ferramentas devem estar presentes quando o primeiro prompt é construído
`MCP_CONNECT_TIMEOUT_MS`	Quanto tempo a inicialização bloqueante MCP 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 segundo plano mas não aparecerão até a próxima consulta. Distinto de `MCP_TIMEOUT`, que limita a tentativa de conexão de um servidor individual
`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_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_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`	Tempo limite em milissegundos para inicialização do servidor MCP (padrão: 30000, ou 30 segundos)
`MCP_TOOL_TIMEOUT`	Tempo limite em milissegundos para execução de ferramentas 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 tempo limite geral de execução de ferramenta mas deixa o limite por solicitação em 60 segundos. Servidores Stdio e WebSocket não têm temporizador 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 as chamadas de ferramenta desse servidor, então `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` nunca as aborta mais cedo; este piso requer Claude Code v2.1.203 ou posterior. Para a variável env, valores abaixo de 1000 são fixados em 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_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, o valor de `OTEL_LOG_USER_PROMPTS` é usado em vez disso. Defina como `0` para manter respostas redatadas mesmo quando `OTEL_LOG_USER_PROMPTS` está definido. Requer Claude Code v2.1.193 ou posterior. Veja Monitoramento
`OTEL_LOG_RAW_API_BODIES`	Emita solicitação e resposta JSON da API Anthropic Messages como eventos de log `api_request_body` / `api_response_body`. Defina como `1` para corpos inline truncados em 60 KB, ou `file:<dir>` para escrever corpos não truncados em disco e emitir um caminho `body_ref` em vez disso. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Veja Monitoramento
`OTEL_LOG_TOOL_CONTENT`	Defina como `1` para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja Monitoramento
`OTEL_LOG_TOOL_DETAILS`	Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, nomes de workflow definidos pelo usuário, strings de erro bruto em falhas de ferramenta, a categoria de recusa em eventos `api_refusal` e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. 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). Veja Monitoramento
`OTEL_METRICS_INCLUDE_ACCOUNT_UUID`	Defina como `false` para excluir UUID da conta dos 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 em v2.1.152. Veja Monitoramento
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	A partir de 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 dos atributos de métricas (padrão: incluído). Veja Monitoramento
`OTEL_METRICS_INCLUDE_VERSION`	Defina como `true` para incluir versão do 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`	Número máximo de caracteres na saída de subagente antes de truncamento (padrão: 32000, máximo: 160000). Quando truncado, a saída completa é salva em disco e o caminho é incluído na resposta truncada
`USE_BUILTIN_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. Adicionado em v2.1.111
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Substitua região para Claude Opus 4.8 ao usar Google Cloud’s Agent Platform. Adicionado em v2.1.154
`VERTEX_REGION_CLAUDE_5_SONNET`	Substitua região para Claude Sonnet 5 ao usar Google Cloud’s Agent Platform. Adicionado em v2.1.197
`VERTEX_REGION_CLAUDE_FABLE_5`	Substitua região para Claude Fable 5 ao usar Google Cloud’s Agent Platform. Adicionado em v2.1.170
`VERTEX_REGION_CLAUDE_HAIKU_4_5`	Substitua região para Claude Haiku 4.5 ao usar Google Cloud’s Agent Platform

Variáveis padrão do exportador OpenTelemetry (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES e variantes específicas de sinal) também são suportadas. Veja Monitoramento para detalhes de configuração.

Veja também

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

​Veja também