> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Variáveis de ambiente
> Referência para variáveis de ambiente que controlam o comportamento do Claude Code.
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](/pt/settings), uma [flag CLI](/pt/cli-reference) ou um comando em sessão como `/model`.
Esta página aborda como:
* [Definir variáveis de ambiente](#set-environment-variables) no seu shell ou em um arquivo de configurações
* [Verificar qual valor se aplica](#precedence) quando um comportamento pode ser definido de mais de uma forma
* [Procurar as variáveis que Claude Code lê](#variables)
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`:
```bash theme={null}
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.
```powershell theme={null}
$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.
```batch theme={null}
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.
```json ~/.claude/settings.json theme={null}
{
"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](/pt/settings#settings-files) para onde cada arquivo reside e [Precedência de configurações](/pt/settings#settings-precedence) 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.
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](#variables) 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](/pt/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](/pt/claude-platform-on-aws). Use para regiões personalizadas ou ao rotear através de um [gateway LLM](/pt/llm-gateway). Padrão é `https://aws-external-anthropic.{AWS_REGION}.api.aws` |
| `ANTHROPIC_AWS_WORKSPACE_ID` | Obrigatório para [Claude Platform on AWS](/pt/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](/pt/mcp#scale-with-mcp-tool-search) é desabilitada por padrão. Defina `ENABLE_TOOL_SEARCH=true` se seu proxy encaminha blocos `tool_reference`. {/* min-version: 2.1.196 */}A partir de v2.1.196, [Remote Control](/pt/remote-control#requirements) é desabilitado quando isso aponta para um host diferente de `api.anthropic.com`, correspondendo ao seu comportamento em Bedrock, Vertex AI e Foundry |
| `ANTHROPIC_BEDROCK_BASE_URL` | Substitua a URL do endpoint Bedrock. Use para endpoints Bedrock personalizados ou ao rotear através de um [gateway LLM](/pt/llm-gateway). Veja [Amazon Bedrock](/pt/amazon-bedrock) |
| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Substitua a URL do endpoint Bedrock Mantle. Veja [endpoint Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) |
| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Bedrock [service tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` ou `priority`). Enviado como cabeçalho `X-Amzn-Bedrock-Service-Tier`. Veja [Amazon Bedrock](/pt/amazon-bedrock#service-tiers) |
| `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](https://platform.claude.com/docs/en/api/beta-headers) antes que Claude Code adicione suporte nativo. Diferentemente da flag [`--betas`](/pt/cli-reference#cli-flags), 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](/pt/model-config#add-a-custom-model-option) |
| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrição de exibição para a entrada de modelo personalizado no seletor `/model`. Padrão é `Custom model ()` 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](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Veja [Configuração de modelo](/pt/model-config#environment-variables) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Veja [Configuração de modelo](/pt/model-config#customize-pinned-model-display-and-capabilities) |
| `ANTHROPIC_FOUNDRY_API_KEY` | Chave de API para autenticação do Microsoft Foundry (veja [Microsoft Foundry](/pt/microsoft-foundry)) |
| `ANTHROPIC_FOUNDRY_BASE_URL` | URL base completa para o recurso Foundry (por exemplo, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa para `ANTHROPIC_FOUNDRY_RESOURCE` (veja [Microsoft Foundry](/pt/microsoft-foundry)) |
| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome do recurso Foundry (por exemplo, `my-resource`). Obrigatório se `ANTHROPIC_FOUNDRY_BASE_URL` não estiver definido (veja [Microsoft Foundry](/pt/microsoft-foundry)) |
| `ANTHROPIC_MODEL` | Nome da configuração de modelo a usar (veja [Configuração de modelo](/pt/model-config#environment-variables)) |
| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] Nome do [modelo da classe Haiku para tarefas em segundo plano](/pt/costs) |
| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Substitua a região AWS para o modelo da classe Haiku ao usar Bedrock ou Bedrock Mantle. Em Bedrock, isso só tem efeito quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou o descontinuado `ANTHROPIC_SMALL_FAST_MODEL` também está definido, já que Bedrock de outra forma usa o modelo primário para tarefas em segundo plano |
| `ANTHROPIC_VERTEX_BASE_URL` | Substitua a URL do endpoint Vertex AI. Use para endpoints Vertex personalizados ou ao rotear através de um [gateway LLM](/pt/llm-gateway). Veja [Google Vertex AI](/pt/google-vertex-ai) |
| `ANTHROPIC_VERTEX_PROJECT_ID` | ID do projeto GCP para solicitações Vertex AI. Substituído por `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` ou o projeto no seu arquivo de credenciais `GOOGLE_APPLICATION_CREDENTIALS`. Veja [Google Vertex AI](/pt/google-vertex-ai) |
| `ANTHROPIC_WORKSPACE_ID` | ID do workspace para [federação de identidade de carga de trabalho](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). 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` | {/* min-version: 2.1.169 */}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](/pt/llm-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](/pt/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 [Vertex AI](/pt/google-vertex-ai), [Foundry](/pt/microsoft-foundry), [Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint), [Bedrock](/pt/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 Bedrock para autenticação (veja [Chaves de API do Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |
| `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](/pt/tools-reference#bash-tool-behavior) |
| `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 --remote`](/pt/claude-code-on-the-web#send-local-repositories-without-github) 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](/pt/hooks) comandos, [linha de status](/pt/statusline) comandos, subprocessos [servidor MCP](/pt/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_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Defina como `1` para desabilitar todos os tipos de [subagente](/pt/sub-agents) 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____` 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](/pt/claude-code-on-the-web) e em Sonnet 4.6 e Opus 4.6 sem [contexto estendido](/pt/model-config#extended-context), que compactam no limite de 200K por padrão. Em Sonnet 5, compactação proativa se aplica no [limite padrão](/pt/model-config#sonnet-5-context-window) 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` | {/* min-version: 2.1.181 */}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`](/pt/settings#available-settings) é `true`. A flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) 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` | {/* min-version: 2.1.181 */}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](/pt/remote-control#mobile-push-notifications), 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](/pt/fullscreen) 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](/pt/agent-view) no Windows |
| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Defina como `1` para enviar o parâmetro [esforço](/pt/model-config#adjust-effort-level) 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](/pt/llm-gateway) 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`](/pt/settings#available-settings)) |
| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Defina como `0` para parar Claude Code de abrir o navegador automaticamente quando um novo [artefato](/pt/artifacts) é 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](/pt/llm-gateway). 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](/pt/model-config#extended-context), exceto em Sonnet 5, que tem seu próprio [limite padrão](/pt/model-config#sonnet-5-context-window). 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](/pt/vs-code) 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`](/pt/settings#global-config-settings) |
| `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](/pt/network-config#ca-certificate-store). Padrão é `bundled,system` |
| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Defina como `1` em subprocessos que Claude Code gera via ferramentas Bash, PowerShell e Monitor, [hook](/pt/hooks) comandos e [linha de status](/pt/statusline) comandos. Não definido para subprocessos [servidor MCP](/pt/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` | {/* max-version: 2.1.185 */}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`](/pt/cli-reference#cli-flags) faz ambos de uma vez. Padrão é `~/.claude/debug/.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](/pt/model-config#extended-context). Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo, e sessões [Sonnet 5](/pt/model-config#sonnet-5-context-window) 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](/pt/model-config#adjust-effort-level) em Opus 4.6 e Sonnet 4.6 e voltar ao orçamento de pensamento fixo controlado por `MAX_THINKING_TOKENS`. {/* min-version: 2.1.111 */}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` | {/* min-version: 2.1.98 */}Defina como `1` para desabilitar a [ferramenta advisor](/pt/advisor). O comando `/advisor` e a flag `--advisor` ficam indisponíveis e qualquer `advisorModel` configurado é ignorado. Requer Claude Code v2.1.98 ou posterior |
| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Defina como `1` para desativar [agentes em segundo plano e visualização de agentes](/pt/agent-view): `claude agents`, `--bg`, `/background` e o supervisor sob demanda. Equivalente à configuração [`disableAgentView`](/pt/settings#available-settings) |
| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Defina como `1` para desabilitar [renderização em tela cheia](/pt/fullscreen) 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`](/pt/settings#available-settings). Você também pode alternar com `/tui default`. Não se aplica a sessões em segundo plano abertas de [visualização de agentes](/pt/agent-view), que sempre usam renderização em tela cheia |
| `CLAUDE_CODE_DISABLE_ARTIFACT` | Defina como `1` para desabilitar a ferramenta [Artifact](/pt/artifacts), que publica saída de sessão como uma página web privada em claude.ai. Equivalente à configuração [`disableArtifact`](/pt/settings#available-settings) |
| `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](/pt/memory#auto-memory). Defina como `0` para forçar a memória automática mesmo quando `--bare` mode ou [`autoMemoryEnabled: false`](/pt/settings#available-settings) 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_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}Defina como `1` para parar os comandos de shell em segundo plano em execução de uma [sessão em segundo plano](/pt/agent-view) e fluxos de trabalho dinâmicos quando o [supervisor](/pt/agent-view#the-supervisor-process) 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`](/pt/agent-view#from-inside-a-session) 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` | {/* min-version: 2.1.193 */}Defina como `1` para parar Claude Code de encerrar [comandos de shell em segundo plano](/pt/interactive-mode#background-bash-commands) 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](/pt/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. Skills de plugins, `.claude/skills/` e `.claude/commands/` não são afetadas. Equivalente à configuração [`disableBundledSkills`](/pt/settings#available-settings); `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](/pt/scheduled-tasks). 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 |
| `CLAUDE_CODE_DISABLE_FAST_MODE` | Defina como `1` para desabilitar [modo rápido](/pt/fast-mode) |
| `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`](/pt/settings#available-settings). Veja [Pesquisas de qualidade de sessão](/pt/data-usage#session-quality-surveys) |
| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Defina como `1` para desabilitar [checkpointing](/pt/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`](/pt/settings#available-settings) 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 Bedrock, Vertex ou Foundry |
| `CLAUDE_CODE_DISABLE_MOUSE` | Defina como `1` para desabilitar rastreamento de mouse em [renderização em tela cheia](/pt/fullscreen). 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` | {/* min-version: 2.1.195 */}Defina como `1` para desabilitar clique, arrasto e manipulação de hover em [renderização em tela cheia](/pt/fullscreen) 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` | {/* min-version: 2.1.193 */}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](/pt/remote-control#mobile-push-notifications) 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](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 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](/pt/third-party-integrations), `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](/pt/fullscreen) 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](/pt/workflows#turn-workflows-off). Equivalente à configuração [`disableWorkflows`](/pt/settings#available-settings) |
| `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](/pt/model-config#adjust-effort-level) |
| `CLAUDE_CODE_ENABLE_AUTO_MODE` | {/* min-version: 2.1.158 */}Defina como `1` para disponibilizar [modo automático](/pt/permission-modes#eliminate-prompts-with-auto-mode) em Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry e sessões [gateway de aplicativos Claude](/pt/claude-apps-gateway) conectadas. Requer Claude Code v2.1.158 ou posterior. Não tem efeito na API Anthropic, onde o modo automático está disponível por padrão. Veja [Habilitar modo automático em Bedrock, Vertex AI ou Foundry](/pt/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) |
| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Substitua a disponibilidade de [recapitulação de sessão](/pt/interactive-mode#session-recap). Defina como `0` para forçar recapitulações desativadas independentemente do toggle `/config`. Defina como `1` para forçar recapitulações ativadas quando [`awaySummaryEnabled`](/pt/settings#available-settings) é `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](/pt/headless) 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](/pt/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](/pt/monitoring-usage) 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 Bedrock e Vertex, 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 Foundry e conexões [gateway](/pt/llm-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`](/pt/settings#available-settings) que a sessão recebe; entregue a lista através de [MDM ou um arquivo de configurações gerenciado](/pt/settings#settings-files), já que [entrega gerenciada pelo servidor não está disponível em configurações de gateway](/pt/server-managed-settings#platform-availability) |
| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Removido em v2.1.142, quando o padrão de [modo rápido](/pt/fast-mode) 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](/pt/interactive-mode#prompt-suggestions) |
| `CLAUDE_CODE_ENABLE_TASKS` | Controla se as sessões usam as ferramentas Task estruturadas (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou a ferramenta legada `TodoWrite`. {/* min-version: 2.1.142 */}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](/pt/interactive-mode#task-list) e [Migrar para ferramentas Task](/pt/agent-sdk/todo-tracking#migrate-to-task-tools) |
| `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](/pt/monitoring-usage) |
| `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](/pt/agent-teams). 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 |
| `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` | {/* min-version: 2.1.172 */}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. {/* min-version: 2.1.178 */}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` | {/* min-version: 2.1.186 */}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](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) 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 |
| `CLAUDE_CODE_FORK_SUBAGENT` | Defina como `1` para permitir [subagentes bifurcados](/pt/sub-agents#fork-the-current-conversation), 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`](/pt/commands) 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](/pt/setup#set-up-on-windows) |
| `CLAUDE_CODE_GLOB_HIDDEN` | Defina como `false` para excluir dotfiles dos resultados quando Claude invoca a [ferramenta Glob](/pt/tools-reference#glob-tool-behavior). 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](/pt/tools-reference#glob-tool-behavior) 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`](/pt/settings#available-settings) |
| `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` | Pule a auto-instalação de extensões IDE. Equivalente a definir [`autoInstallIdeExtension`](/pt/settings#global-config-settings) 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. {/* min-version: 2.1.193 */}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](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Aumentar este valor reduz a janela de contexto efetiva disponível antes que [auto-compactação](/pt/costs#reduce-token-usage) seja acionada |
| `CLAUDE_CODE_MAX_RETRIES` | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10). {/* min-version: 2.1.186 */}Limitado a 15 a partir de v2.1.186. 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`](/pt/cli-reference#cli-flags), 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` | {/* min-version: 2.1.187 */}Tempo limite de inatividade em milissegundos para chamadas de ferramentas MCP remotas (padrão: 300000, ou 5 minutos). Quando um servidor MCP HTTP, SSE, WebSocket ou [conector claude.ai](/pt/mcp#use-mcp-servers-from-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` de tempo de parede. 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. Não se aplica a servidores stdio ou IDE. Requer Claude Code v2.1.187 ou posterior |
| `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](/pt/fullscreen), uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Equivalente à configuração [`tui`](/pt/settings#available-settings); 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`](/pt/authentication#generate-a-long-lived-token) |
| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Removido em v2.1.160 e agora é um no-op. Anteriormente fixava [modo rápido](/pt/fast-mode) 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` | {/* min-version: 2.1.179 */}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](/pt/monitoring-usage) |
| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Tempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja [Monitoramento](/pt/monitoring-usage) |
| `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](/pt/monitoring-usage#dynamic-headers) |
| `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](/pt/monitoring-usage) |
| `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](/pt/setup#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 ` 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](/pt/plugin-marketplaces#git-operations-time-out) |
| `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](/pt/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |
| `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](/pt/plugin-marketplaces#pre-populate-plugins-for-containers) |
| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Defina como `1` para parar Claude Code de passar `-ExecutionPolicy Bypass` ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de 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` | {/* min-version: 2.1.182 */}Tempo máximo em milissegundos que [modo não interativo](/pt/headless#background-tasks-at-exit) 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_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}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)](/pt/monitoring-usage#traces-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 Bedrock, Vertex e Foundry também é ignorado, então a telemetria segue o opt-out padrão `DISABLE_TELEMETRY`. Veja [Comportamentos padrão por provedor de API](/pt/data-usage#default-behaviors-by-api-provider) |
| `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](/pt/claude-code-on-the-web). 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](/pt/claude-code-on-the-web) 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](/pt/claude-code-on-the-web#link-output-back-to-the-session) |
| `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` | {/* min-version: 2.1.186 */}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. 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`](/pt/cli-reference#cli-flags). 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](/pt/fullscreen#mouse-wheel-scrolling). 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](/pt/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](/pt/hooks) e subprocessos [servidor MCP](/pt/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 ` 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](/pt/hooks), [linha de status](/pt/statusline) comandos e comandos de inicialização de [servidor MCP](/pt/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 ''`. 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 `. 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`](/pt/headless#start-faster-with-bare-mode) |
| `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](/pt/claude-platform-on-aws), para gateways que assinam solicitações por conta própria |
| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Pule autenticação AWS para Bedrock (por exemplo, ao usar um gateway LLM) |
| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Pule autenticação Azure para Microsoft Foundry. Para um gateway, defina a credencial em `ANTHROPIC_FOUNDRY_API_KEY` em vez disso; sem uma chave de API, essa variável deixa o cliente Foundry incapaz de enviar solicitações |
| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Pule autenticação AWS para 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 Vertex (por exemplo, ao usar um gateway LLM) |
| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Número máximo de vezes consecutivas que um hook [Stop](/pt/hooks#stop) ou [SubagentStop](/pt/hooks#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](/pt/model-config). {/* min-version: 2.1.196 */}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](/pt/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`](/pt/settings) |
| `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](/pt/interactive-mode#task-list) |
| `CLAUDE_CODE_TEAM_NAME` | Nome da equipe de agentes à qual este companheiro pertence. Definido automaticamente em membros de [equipe de agentes](/pt/agent-teams) |
| `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. {/* min-version: 2.1.161 */}A partir de v2.1.161, em macOS e Linux, subprocessos Bash [sandboxed](/pt/sandboxing) 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](/pt/terminal-config) para outras configurações de tmux |
| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Use [Claude Platform on AWS](/pt/claude-platform-on-aws) |
| `CLAUDE_CODE_USE_BEDROCK` | Use [Bedrock](/pt/amazon-bedrock) |
| `CLAUDE_CODE_USE_FOUNDRY` | Use [Microsoft Foundry](/pt/microsoft-foundry) |
| `CLAUDE_CODE_USE_MANTLE` | Use o endpoint [Mantle](/pt/amazon-bedrock#use-the-mantle-endpoint) do 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](/pt/tools-reference#powershell-tool) |
| `CLAUDE_CODE_USE_VERTEX` | Use [Vertex](/pt/google-vertex-ai) |
| `CLAUDE_CONFIG_DIR` | Substitua o diretório de configuração (padrão: `~/.claude`). Todas as configurações, credenciais, histórico de sessão e plugins são armazenados sob este caminho. Útil para executar múltiplas contas lado a lado: por exemplo, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |
| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}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`](/pt/agent-view#from-inside-a-session). 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](/pt/model-config#adjust-effort-level) 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](/pt/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](/pt/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 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. {/* min-version: 2.1.196 */}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. {/* min-version: 2.1.169 */}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 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](/pt/hooks#persist-environment-variables), [Setup](/pt/hooks#setup), [CwdChanged](/pt/hooks#cwdchanged) e [FileChanged](/pt/hooks#filechanged) |
| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefixo para nomes de sessão [Remote Control](/pt/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 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`](/pt/cli-reference#cli-flags). Logs de depuração são escritos em `~/.claude/debug/.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 o comando `/doctor`. Útil para implantações gerenciadas onde usuários não devem executar diagnósticos de instalação |
| `DISABLE_ERROR_REPORTING` | Defina como `1` para optar por não participar do relatório de erros do Sentry |
| `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 (Bedrock, Vertex ou 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](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |
| `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](/pt/prompt-caching#disable-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](/pt/mcp#use-mcp-servers-from-claude-ai) no Claude Code. Habilitado por padrão para usuários conectados. Para desabilitar por projeto ou por organização, defina [`disableClaudeAiConnectors`](/pt/settings#available-settings) 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, [Bedrock](/pt/amazon-bedrock), [Vertex](/pt/google-vertex-ai), [Foundry](/pt/microsoft-foundry) e [Claude Platform on AWS](/pt/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](/pt/mcp#scale-with-mcp-tool-search). Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em Vertex AI 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 Vertex AI 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) |
| `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. {/* min-version: 2.1.160 */}A partir de v2.1.160, uma [cadeia de modelo fallback](/pt/model-config#fallback-model-chains) 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_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`](/pt/mcp#raise-the-limit-for-a-specific-tool) 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`](/pt/cli-reference#cli-flags) em modo não interativo (a flag `-p`). Padrão é 5 |
| `MAX_THINKING_TOKENS` | Substitua o orçamento de token de [pensamento estendido](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). O teto é o [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 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](/pt/third-party-integrations), `0` igualmente omite o parâmetro, e modelos com [raciocínio adaptativo](/pt/model-config#adjust-effort-level) 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](/pt/mcp#use-pre-configured-oauth-credentials). 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. {/* min-version: 2.1.142 */}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`](/pt/mcp#exempt-a-server-from-deferral) 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`](/pt/mcp#exempt-a-server-from-deferral). 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](/pt/mcp#use-pre-configured-oauth-credentials) |
| `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). Um campo `timeout` por servidor em `.mcp.json` substitui isso para esse servidor. 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` | {/* min-version: 2.1.193 */}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](/pt/monitoring-usage#assistant-response-event) |
| `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:` 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](/pt/monitoring-usage#api-request-body-event) |
| `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](/pt/monitoring-usage) |
| `OTEL_LOG_TOOL_DETAILS` | Defina como `1` para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, 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](/pt/monitoring-usage) |
| `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](/pt/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Defina como `false` para excluir UUID da conta dos atributos de métricas (padrão: incluído). Veja [Monitoramento](/pt/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}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](/pt/monitoring-usage) |
| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}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](/pt/monitoring-usage#multi-team-organization-support) |
| `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](/pt/monitoring-usage) |
| `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](/pt/monitoring-usage) |
| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Substitua o orçamento de caracteres para metadados de skill mostrados à [ferramenta Skill](/pt/skills#control-who-invokes-a-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](/pt/sub-agents) 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 Vertex AI |
| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Substitua região para Claude 3.5 Sonnet ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Substitua região para Claude 3.7 Sonnet ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Substitua região para Claude 4.0 Opus ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Substitua região para Claude 4.0 Sonnet ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Substitua região para Claude 4.1 Opus ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Substitua região para Claude Opus 4.5 ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Substitua região para Claude Sonnet 4.5 ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Substitua região para Claude Opus 4.6 ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Substitua região para Claude Sonnet 4.6 ao usar Vertex AI |
| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Substitua região para Claude Opus 4.7 ao usar Vertex AI. Adicionado em v2.1.111 |
| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Substitua região para Claude Opus 4.8 ao usar Vertex AI. Adicionado em v2.1.154 |
| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Substitua região para Claude Fable 5 ao usar Vertex AI. Adicionado em v2.1.170 |
| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Substitua região para Claude Haiku 4.5 ao usar Vertex AI |
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](/pt/monitoring-usage) para detalhes de configuração.
Veja também
* [Configurações](/pt/settings): todas as configurações `settings.json`, incluindo a chave `env`
* [Referência CLI](/pt/cli-reference): flags de tempo de inicialização
* [Configuração de rede](/pt/network-config): configuração de proxy e TLS
* [Monitoramento](/pt/monitoring-usage): configuração OpenTelemetry