ANTHROPIC_API_KEY | Chave de API enviada como cabeçalho X-Api-Key. Quando definida, essa chave é usada em vez de sua assinatura Claude Pro, Max, Team ou Enterprise, mesmo que você esteja conectado. Em modo não interativo (-p), a chave é sempre usada quando presente. Em modo interativo, você é solicitado a aprovar a chave uma vez antes de ela substituir sua assinatura. Para usar sua assinatura em vez disso, execute unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN | Valor personalizado para o cabeçalho Authorization (o valor que você definir aqui será prefixado com Bearer ) |
ANTHROPIC_AWS_API_KEY | Chave de API do workspace para Claude Platform on AWS, gerada no AWS Console. Enviada como x-api-key e tem precedência sobre AWS SigV4 |
ANTHROPIC_AWS_BASE_URL | Substitua a URL do endpoint Claude Platform on AWS. Use para regiões personalizadas ou ao rotear através de um gateway LLM. Padrão é https://aws-external-anthropic.{AWS_REGION}.api.aws |
ANTHROPIC_AWS_WORKSPACE_ID | Obrigatório para Claude Platform on AWS. Enviado em cada solicitação como cabeçalho anthropic-workspace-id |
ANTHROPIC_BASE_URL | Substitua o endpoint da API para rotear solicitações através de um proxy ou gateway. Quando definido para um host que não é de primeira parte, busca de ferramentas MCP é desabilitada por padrão. Defina ENABLE_TOOL_SEARCH=true se seu proxy encaminha blocos tool_reference. A partir de v2.1.196, Remote Control é desabilitado quando isso aponta para um host diferente de api.anthropic.com, correspondendo ao seu comportamento em 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. Veja Amazon Bedrock |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL | Substitua a URL do endpoint Bedrock Mantle. Veja endpoint Mantle |
ANTHROPIC_BEDROCK_SERVICE_TIER | Bedrock service tier (default, flex ou priority). Enviado como cabeçalho X-Amzn-Bedrock-Service-Tier. Veja Amazon Bedrock |
ANTHROPIC_BETAS | Lista separada por vírgula de valores de cabeçalho anthropic-beta adicionais para incluir em solicitações de API. Claude Code já envia os cabeçalhos beta que precisa; use isso para optar por um beta da API Anthropic antes que Claude Code adicione suporte nativo. Diferentemente da flag --betas, que requer autenticação de chave de API, essa variável funciona com todos os métodos de autenticação, incluindo assinatura Claude.ai |
ANTHROPIC_CUSTOM_HEADERS | Cabeçalhos personalizados para adicionar às solicitações (formato Name: Value, separados por quebra de linha para múltiplos cabeçalhos) |
ANTHROPIC_CUSTOM_MODEL_OPTION | ID do modelo para adicionar como entrada personalizada no seletor /model. Use isso para tornar um modelo não padrão ou específico de gateway selecionável sem substituir aliases integrados. Veja Configuração de modelo |
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION | Descrição de exibição para a entrada de modelo personalizado no seletor /model. Padrão é Custom model (<model-id>) quando não definido |
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME | Nome de exibição para a entrada de modelo personalizado no seletor /model. Padrão é o ID do modelo quando não definido |
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_FABLE_MODEL | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_OPUS_MODEL | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_SONNET_MODEL | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME | Veja Configuração de modelo |
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES | Veja Configuração de modelo |
ANTHROPIC_FOUNDRY_API_KEY | Chave de API para autenticação do Microsoft Foundry (veja Microsoft Foundry) |
ANTHROPIC_FOUNDRY_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) |
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) |
ANTHROPIC_MODEL | Nome da configuração de modelo a usar (veja Configuração de modelo) |
ANTHROPIC_SMALL_FAST_MODEL | [DEPRECATED] Nome do modelo da classe Haiku para tarefas em segundo plano |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION | Substitua a região AWS para o modelo da classe Haiku ao usar 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. Veja 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 |
ANTHROPIC_WORKSPACE_ID | ID do workspace para federação de identidade de carga de trabalho. Defina isso quando sua regra de federação está no escopo de mais de um workspace para que a troca de token saiba qual workspace direcionar |
API_FORCE_IDLE_TIMEOUT | Substitua o tempo limite de inatividade de 5 minutos que aborta uma resposta de modelo de streaming quando nenhum byte chega. Defina como 0 para desabilitar o tempo limite, por exemplo, quando um gateway lento ou modelo local pausa por mais de 5 minutos entre chunks. Defina como 1 para manter o tempo limite em cada provedor. Quando não definido, o tempo limite está inativo em conexões diretas da API Anthropic e Claude Platform on AWS, onde o próprio watchdog de stream de nível de byte do Claude Code é executado, e ativo em cada outro provedor, incluindo Vertex AI, Foundry, Mantle, 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) |
BASH_DEFAULT_TIMEOUT_MS | Tempo limite padrão para comandos bash de longa duração (padrão: 120000, ou 2 minutos) |
BASH_MAX_OUTPUT_LENGTH | Número máximo de caracteres nas saídas bash antes da saída completa ser salva em um arquivo e Claude receber o caminho mais uma visualização curta. Veja Comportamento da ferramenta Bash |
BASH_MAX_TIMEOUT_MS | Tempo limite máximo que o modelo pode definir para comandos bash de longa duração (padrão: 600000, ou 10 minutos) |
CCR_FORCE_BUNDLE | Defina como 1 para forçar claude --remote a agrupar e fazer upload do seu repositório local mesmo quando o acesso ao GitHub está disponível |
CLAUDECODE | Defina como 1 em subprocessos que Claude Code gera (ferramentas Bash e PowerShell, sessões tmux, hook comandos, linha de status comandos, subprocessos servidor MCP stdio). Extensões IDE também definem isso em seus terminais integrados. Use para detectar quando um script está sendo executado dentro de um subprocesso gerado por Claude Code. Para verificar se o processo atual foi gerado diretamente por uma chamada de ferramenta ou hook, em vez de dentro de um servidor MCP stdio que Claude Code iniciou, use CLAUDE_CODE_CHILD_SESSION em vez disso |
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS | Defina como 1 para desabilitar todos os tipos de subagente integrados, como Explore e Plan. Aplica-se apenas em modo não interativo (a flag -p). Útil para usuários do SDK que desejam uma tela em branco |
CLAUDE_AGENT_SDK_MCP_NO_PREFIX | Defina como 1 para pular o prefixo mcp__<server>__ em nomes de ferramentas de servidores MCP criados pelo SDK. As ferramentas usam seus nomes originais. Apenas uso do SDK |
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS | Tempo limite de travamento em milissegundos para subagentes em segundo plano. Padrão 600000 (10 minutos). O temporizador é reiniciado em cada evento de progresso de streaming; se nenhum progresso chegar dentro da janela, o subagente é abortado e a tarefa é marcada como falha, exibindo qualquer resultado parcial para o pai |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | Defina a porcentagem (1-100) da janela de auto-compactação na qual a auto-compactação é acionada. Use valores mais baixos como 50 para compactar mais cedo. Esta variável só causa compactação mais cedo quando Claude Code compacta proativamente: quando CLAUDE_CODE_AUTO_COMPACT_WINDOW está definido, em sessões em nuvem e em Sonnet 4.6 e Opus 4.6 sem contexto estendido, que compactam no limite de 200K por padrão. Em Sonnet 5, compactação proativa se aplica no limite padrão do modelo. Em outros casos, como uma sessão local em Opus 4.8, auto-compactação é acionada quando a conversa atinge o limite de contexto do modelo. O override só pode baixar o limite, então valores acima do padrão não têm efeito. Aplica-se a conversas principais e subagentes |
CLAUDE_AUTO_BACKGROUND_TASKS | Defina como 1 para forçar a habilitação do envio automático para segundo plano de tarefas de agente de longa duração. Quando habilitado, subagentes são movidos para o segundo plano após executarem por aproximadamente dois minutos |
CLAUDE_AX_SCREEN_READER | Defina como 1 para renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Defina como 0 para forçar o modo leitor de tela desativado mesmo quando axScreenReader é true. A flag --ax-screen-reader tem precedência. Requer Claude Code v2.1.181 ou posterior |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | Retorne ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal |
CLAUDE_CLIENT_PRESENCE_FILE | Caminho para um arquivo que uma ferramenta externa, como um ouvinte de bloqueio de tela, cria quando você desbloqueia sua tela e exclui quando você a bloqueia. Enquanto o arquivo existe, Claude Code pula notificações push móveis de Remote Control, para que você pare de receber pushes enquanto está usando ativamente o computador. Quando o arquivo está ausente ou ilegível, as notificações são enviadas normalmente. Claude Code verifica o arquivo uma vez por evento de disparo de push em vez de fazer polling. Requer Claude Code v2.1.181 ou posterior |
CLAUDE_CODE_ACCESSIBILITY | Defina como 1 para manter o cursor do terminal nativo visível e desabilitar o indicador de cursor de texto invertido. Permite que ampliadores de tela como macOS Zoom rastreiem a posição do cursor |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD | Defina como 1 para carregar arquivos de memória de diretórios especificados com --add-dir. Carrega CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md e CLAUDE.local.md. Por padrão, diretórios adicionais não carregam arquivos de memória |
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT | Defina como 1 para repintar a tela inteira em cada quadro em renderização em tela cheia em vez de enviar atualizações incrementais. Use isso se o modo tela cheia mostrar fragmentos de texto obsoletos ou deslocados. Claude Code habilita isso automaticamente para sessões em segundo plano e visualização de agentes no Windows |
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT | Defina como 1 para enviar o parâmetro esforço com cada solicitação, mesmo quando Claude Code não reconhece o ID do modelo como capaz de esforço. Use isso ao rotear através de um gateway LLM ou provedor de terceiros que serve modelos sob identificadores personalizados. Modelos que rejeitam o parâmetro de esforço na API, incluindo modelos Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, ainda são excluídos para que as solicitações não falhem |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar apiKeyHelper) |
CLAUDE_CODE_ARTIFACT_AUTO_OPEN | Defina como 0 para parar Claude Code de abrir o navegador automaticamente quando um novo artefato é publicado. Republicar um artefato existente não abre o navegador independentemente dessa configuração |
CLAUDE_CODE_ATTRIBUTION_HEADER | Defina como 0 para omitir o bloco de atribuição (versão do cliente e impressão digital do prompt) do início do prompt do sistema. Desabilitá-lo melhora as taxas de acerto do cache de prompt ao rotear através de um gateway LLM. O cache da API Anthropic não é afetado |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | Defina a capacidade de contexto em tokens usada para cálculos de auto-compactação. Padrão é a janela de contexto do modelo: 200K para modelos padrão ou 1M para modelos de contexto estendido, exceto em Sonnet 5, que tem seu próprio limite padrão. Use um valor mais baixo como 500000 em um modelo de 1M para tratar a janela como 500K para fins de compactação. O valor é limitado à janela de contexto real do modelo. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE é aplicado como uma porcentagem deste valor. Definir esta variável desacopla o limite de compactação do used_percentage da linha de status, que sempre usa a janela de contexto completa do modelo |
CLAUDE_CODE_AUTO_CONNECT_IDE | Substitua a conexão IDE automática. Por padrão, Claude Code se conecta automaticamente quando iniciado dentro do terminal integrado de uma IDE suportada. Defina como false para evitar isso. Defina como true para forçar uma tentativa de conexão quando a detecção automática falha, como quando tmux obscurece o terminal pai. Tem precedência sobre a configuração global autoConnectIde |
CLAUDE_CODE_CERT_STORE | Lista separada por vírgula de fontes de certificado CA para conexões TLS. bundled é o conjunto de CA Mozilla fornecido com Claude Code. system é o armazenamento de confiança do sistema operacional, somente leitura em tempos de execução com tls.getCACertificates: o binário nativo, ou Node 22.15 ou posterior para instalações npm. Veja Armazenamento de certificado CA. Padrão é bundled,system |
CLAUDE_CODE_CHILD_SESSION | Defina como 1 em subprocessos que Claude Code gera via ferramentas Bash, PowerShell e Monitor, hook comandos e linha de status comandos. Não definido para subprocessos servidor MCP stdio, que são de longa duração e sobrevivem à sessão que os gerou. Diferentemente de CLAUDECODE, isso é definido apenas pelo Claude Code quando ele inicia um subprocesso e não por extensões IDE, então distingue de forma confiável uma sessão aninhada de um claude de nível superior iniciado em um terminal integrado IDE. Uma claude TUI interativa aninhada iniciada desta forma é automaticamente excluída de --resume, --continue, histórico de seta para cima e a lista claude agents. Sessões claude -p não interativas ainda persistem. Defina CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 para substituir esta exclusão. Requer Claude Code v2.1.172 ou posterior |
CLAUDE_CODE_CLIENT_CERT | Caminho para arquivo de certificado do cliente para autenticação mTLS |
CLAUDE_CODE_CLIENT_KEY | Caminho para arquivo de chave privada do cliente para autenticação mTLS |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE | Frase-passe para CLAUDE_CODE_CLIENT_KEY criptografada (opcional) |
CLAUDE_CODE_CONNECT_TIMEOUT_MS | Removido em v2.1.186 e agora é um no-op. Anteriormente definia um tempo limite separado para a fase de conexão, TLS e cabeçalho de resposta de uma solicitação de API de streaming. Use API_TIMEOUT_MS para o tempo limite por solicitação |
CLAUDE_CODE_DEBUG_LOGS_DIR | Substitua o caminho do arquivo de log de depuração. Apesar do nome, este é um caminho de arquivo, não um diretório. Requer que o modo de depuração seja habilitado separadamente via --debug, /debug ou a variável de ambiente DEBUG: definir apenas essa variável não habilita o logging. A flag --debug-file faz ambos de uma vez. Padrão é ~/.claude/debug/<session-id>.txt |
CLAUDE_CODE_DEBUG_LOG_LEVEL | Nível de log mínimo escrito no arquivo de log de depuração. Valores: verbose, debug (padrão), info, warn, error. Defina como verbose para incluir diagnósticos de alto volume como saída completa de comando de linha de status, ou aumente para error para reduzir ruído |
CLAUDE_CODE_DISABLE_1M_CONTEXT | Defina como 1 para desabilitar suporte a janela de contexto de 1M. Quando definido, variantes de modelo de 1M não estão disponíveis no seletor de modelo, e sessões Sonnet 5 são tratadas como tendo uma janela de 200K. Útil para ambientes corporativos com requisitos de conformidade |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING | Defina como 1 para desabilitar raciocínio adaptativo em Opus 4.6 e Sonnet 4.6 e voltar ao orçamento de pensamento fixo controlado por MAX_THINKING_TOKENS. A partir de v2.1.111, não tem efeito em Fable 5, Sonnet 5 ou Opus 4.7 e posterior, que sempre usam raciocínio adaptativo |
CLAUDE_CODE_DISABLE_ADVISOR_TOOL | Defina como 1 para desabilitar a ferramenta advisor. O comando /advisor 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: claude agents, --bg, /background e o supervisor sob demanda. Equivalente à configuração disableAgentView |
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN | Defina como 1 para desabilitar renderização em tela cheia e usar o renderizador de tela principal clássico. A conversa permanece no scrollback nativo do seu terminal para que Cmd+f e modo de cópia tmux funcionem como de costume. Tem precedência sobre CLAUDE_CODE_NO_FLICKER e a configuração tui. Você também pode alternar com /tui default. Não se aplica a sessões em segundo plano abertas de visualização de agentes, que sempre usam renderização em tela cheia |
CLAUDE_CODE_DISABLE_ARTIFACT | Defina como 1 para desabilitar a ferramenta Artifact, que publica saída de sessão como uma página web privada em claude.ai. Equivalente à configuração disableArtifact |
CLAUDE_CODE_DISABLE_ATTACHMENTS | Defina como 1 para desabilitar o processamento de anexos. Menções de arquivo com sintaxe @ são enviadas como texto simples em vez de serem expandidas para conteúdo de arquivo |
CLAUDE_CODE_DISABLE_AUTO_MEMORY | Defina como 1 para desabilitar memória automática. Defina como 0 para forçar a memória automática mesmo quando --bare mode ou autoMemoryEnabled: false desabilitaria de outra forma. Quando desabilitada, Claude não cria ou carrega arquivos de memória automática |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS | Defina como 1 para desabilitar toda a funcionalidade de tarefas em segundo plano, incluindo o parâmetro run_in_background em ferramentas Bash e subagent, auto-backgrounding e o atalho Ctrl+B |
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF | Defina como 1 para parar os comandos de shell em segundo plano em execução de uma sessão em segundo plano e fluxos de trabalho dinâmicos quando o supervisor para, reinicia ou atualiza o processo dessa sessão, em vez de entregá-los ao próximo processo da sessão. Afeta apenas esse handoff: colocar uma sessão em segundo plano com ← ou /background ainda carrega o trabalho em andamento, e CLAUDE_DISABLE_ADOPT desativa ambos. Requer Claude Code v2.1.196 ou posterior |
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP | Defina como 1 para parar Claude Code de encerrar comandos de shell em segundo plano quando o sistema operacional relata pressão de memória. Por padrão, em macOS e Linux, Claude Code encerra um shell em segundo plano iniciado na sessão principal em um sinal de pressão de memória uma vez que a sessão ficou ociosa por 30 minutos e nenhuma volta ou subagente está em execução. Windows não tem sinal de pressão de memória, então essa variável não tem efeito lá. Requer Claude Code v2.1.193 ou posterior |
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS | Defina como 1 para desabilitar as skills e workflows que vêm com Claude Code: skills agrupadas e workflows integrados são removidos inteiramente, enquanto comandos slash integrados como /init permanecem digitáveis mas são ocultados do modelo. Skills de plugins, .claude/skills/ e .claude/commands/ não são afetadas. Equivalente à configuração disableBundledSkills; 0 não a substitui |
CLAUDE_CODE_DISABLE_CLAUDE_MDS | Defina como 1 para evitar carregar qualquer arquivo de memória CLAUDE.md no contexto, incluindo arquivos de usuário, projeto e memória automática |
CLAUDE_CODE_DISABLE_CRON | Defina como 1 para desabilitar tarefas agendadas. A skill /loop e ferramentas cron ficam indisponíveis e qualquer tarefa já agendada para de disparar, incluindo tarefas que já estão em execução no meio da sessão |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS | Defina como 1 para remover cabeçalhos de solicitação anthropic-beta específicos do Anthropic e campos de esquema de ferramenta beta (como defer_loading e eager_input_streaming) de solicitações de API. Use isso quando um gateway proxy rejeita solicitações com erros como “Unexpected value(s) for the anthropic-beta header” ou “Extra inputs are not permitted”. Campos padrão (name, description, input_schema, cache_control) são preservados |
CLAUDE_CODE_DISABLE_FAST_MODE | Defina como 1 para desabilitar modo rápido |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY | Defina como 1 para desabilitar as pesquisas de qualidade de sessão “Como Claude está se saindo?”. Pesquisas também são desabilitadas quando DISABLE_TELEMETRY, DO_NOT_TRACK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definido, a menos que CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL opte por participar novamente. Para definir uma taxa de amostra em vez de desabilitar completamente, use a configuração feedbackSurveyRate. Veja Pesquisas de qualidade de sessão |
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING | Defina como 1 para desabilitar checkpointing de arquivo. O comando /rewind não será capaz de restaurar alterações de código |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS | Defina como 1 para remover instruções de fluxo de trabalho de commit e PR integradas e o snapshot de status git do prompt do sistema do Claude. Útil ao usar suas próprias skills de fluxo de trabalho git. Tem precedência sobre a configuração includeGitInstructions quando definido |
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP | Defina como 1 para evitar remapeamento automático de Opus 4.0 e 4.1 para a versão Opus atual na API Anthropic. Use quando você deseja intencionalmente fixar um modelo mais antigo. O remapeamento não é executado em Bedrock, Vertex ou Foundry |
CLAUDE_CODE_DISABLE_MOUSE | Defina como 1 para desabilitar rastreamento de mouse em renderização em tela cheia. A rolagem por teclado com PgUp e PgDn ainda funciona. Use isso para manter o comportamento nativo de cópia ao selecionar do seu terminal |
CLAUDE_CODE_DISABLE_MOUSE_CLICKS | Defina como 1 para desabilitar clique, arrasto e manipulação de hover em renderização em tela cheia enquanto mantém a rolagem da roda do mouse. Use isso quando você quer que a rolagem da roda funcione dentro do Claude Code mas não quer que cliques posicionem o cursor, expandam saída de ferramenta ou abram links. CLAUDE_CODE_DISABLE_MOUSE tem precedência quando ambos estão definidos. Requer Claude Code v2.1.195 ou posterior |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Equivalente a definir DISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING e DISABLE_TELEMETRY |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK | Defina como 1 para desabilitar o fallback não-streaming quando uma solicitação de streaming falha no meio do stream. Erros de streaming se propagam para a camada de retry em vez disso. Útil quando um proxy ou gateway causa o fallback para produzir execução de ferramenta duplicada |
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK | Defina como 1 para enviar a notificação de desktop da ferramenta PushNotification mesmo enquanto você está digitando ou focado no terminal. Por padrão, a ferramenta pula tanto a notificação de desktop quanto o push móvel quando detecta atividade de teclado recente ou foco no terminal. Esta variável desabilita apenas essa verificação local, então o servidor ainda pode suprimir o push móvel quando detecta que você está ativo. Requer Claude Code v2.1.193 ou posterior |
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL | Defina como 1 para pular a adição automática do marketplace de plugin oficial na primeira execução |
CLAUDE_CODE_DISABLE_POLICY_SKILLS | Defina como 1 para pular o carregamento de skills do diretório de skills gerenciado em todo o sistema. Útil para sessões de contêiner ou CI que não devem carregar skills provisionadas pelo operador |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE | Defina como 1 para desabilitar atualizações automáticas de título do terminal com base no contexto da conversa. Em sessões Agent SDK e claude -p, isso também pula a solicitação de Haiku em segundo plano que gera o título da sessão |
CLAUDE_CODE_DISABLE_THINKING | Defina como 1 para omitir o parâmetro thinking de solicitações de API inteiramente. Esta é uma opção de compatibilidade para proxies e gateways que rejeitam o parâmetro. O comportamento da variável é inalterado em relação a versões anteriores; em modelos que pensam por padrão, omitir o parâmetro significa que o modelo ainda pode pensar. Para desabilitar explicitamente pensamento estendido na API Anthropic, use MAX_THINKING_TOKENS=0 em vez disso, que também é ineficaz em Fable 5 já que não pode ter pensamento desligado. Em provedores de terceiros, 0 igualmente omite o parâmetro, então as duas variáveis se comportam da mesma forma lá |
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL | Defina como 1 para desabilitar rolagem virtual em renderização em tela cheia e renderizar cada mensagem na transcrição. Use isso se a rolagem em modo tela cheia mostrar regiões em branco onde as mensagens deveriam aparecer |
CLAUDE_CODE_DISABLE_WORKFLOWS | Defina como 1 para desabilitar workflows. Equivalente à configuração disableWorkflows |
CLAUDE_CODE_EFFORT_LEVEL | Defina o nível de esforço para modelos suportados. Valores: low, medium, high, xhigh, max ou auto para usar o padrão do modelo. Os níveis disponíveis dependem do modelo. Tem precedência sobre /effort e a configuração effortLevel. Veja Ajustar nível de esforço |
CLAUDE_CODE_ENABLE_AUTO_MODE | Defina como 1 para disponibilizar modo automático em Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry e sessões gateway de aplicativos Claude 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 |
CLAUDE_CODE_ENABLE_AWAY_SUMMARY | Substitua a disponibilidade de recapitulação de sessão. Defina como 0 para forçar recapitulações desativadas independentemente do toggle /config. Defina como 1 para forçar recapitulações ativadas quando awaySummaryEnabled é false. Tem precedência sobre a configuração e toggle /config |
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH | Defina como 1 para atualizar o estado do plugin em limites de turno em modo não interativo após a conclusão de uma instalação em segundo plano. Desativado por padrão porque a atualização altera o prompt do sistema no meio da sessão, o que invalida prompt caching para esse turno |
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL | Defina como 1 para rotear a pesquisa de qualidade de sessão “Como Claude está se saindo?” para seu próprio coletor OpenTelemetry quando o tráfego não essencial vinculado ao Anthropic está bloqueado. As classificações de pesquisa são emitidas apenas como eventos OTEL para seu coletor configurado. Nenhum dado de pesquisa é enviado ao Anthropic neste modo. Aplica-se quando CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY ou DO_NOT_TRACK está definido, e não tem efeito caso contrário. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY e a política de feedback do produto da organização têm precedência |
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING | Controla se as entradas de chamada de ferramenta são transmitidas da API conforme Claude as gera. Com isso desativado, uma entrada de ferramenta grande, como uma escrita de arquivo longa, chega apenas após Claude terminar de gerá-la, o que pode parecer que está travando. Habilitado por padrão na API Anthropic. Em 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 |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY | Defina como 1 para popular o seletor /model a partir do endpoint /v1/models do seu gateway quando ANTHROPIC_BASE_URL aponta para um gateway compatível com Anthropic, como LiteLLM, Kong ou um proxy interno. Desativado por padrão porque gateways apoiados por uma chave de API compartilhada mostrariam de outra forma cada usuário cada modelo que a chave pode acessar. Modelos descobertos ainda são filtrados pela lista de permissões availableModels que a sessão recebe; entregue a lista através de MDM ou um arquivo de configurações gerenciado, já que entrega gerenciada pelo servidor não está disponível em configurações de gateway |
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE | Removido em v2.1.142, quando o padrão de modo rápido mudou de Opus 4.6 para Opus 4.7 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION | Defina como false para desabilitar sugestões de prompt (o toggle “Prompt suggestions” em /config). Estas são as previsões acinzentadas que aparecem na sua entrada de prompt após Claude responder. Veja Sugestões de prompt |
CLAUDE_CODE_ENABLE_TASKS | Controla se as sessões usam as ferramentas Task estruturadas (TaskCreate, TaskUpdate, TaskGet, TaskList) ou a ferramenta legada TodoWrite. A partir do Claude Code v2.1.142, as ferramentas Task são o padrão em todos os modos. Defina como 0 para reverter para TodoWrite. Veja Lista de tarefas e Migrar para ferramentas Task |
CLAUDE_CODE_ENABLE_TELEMETRY | Defina como 1 para habilitar coleta de dados OpenTelemetry para métricas e logging. Obrigatório antes de configurar exportadores OTel. Veja Monitoramento |
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY | Tempo em milissegundos para aguardar após o loop de consulta ficar ocioso antes de sair automaticamente. Útil para fluxos de trabalho automatizados e scripts usando modo SDK |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | Defina como 1 para habilitar equipes de agentes. As equipes de agentes são experimentais e desabilitadas por padrão |
CLAUDE_CODE_EXTRA_BODY | Objeto JSON para mesclar no nível superior de cada corpo de solicitação de API. Útil para passar parâmetros específicos do provedor que Claude Code não expõe diretamente |
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS | Substitua o limite de token padrão para leituras de arquivo. Útil quando você precisa ler arquivos maiores na íntegra |
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE | Defina como 1 para forçar persistência de transcrição, histórico de prompt e registro claude agents mesmo quando este claude foi iniciado de dentro de outra sessão Claude Code. Use quando um valor CLAUDE_CODE_CHILD_SESSION herdado, por exemplo de uma sessão screen ou um lançador em segundo plano iniciado pela primeira vez pela ferramenta Bash do Claude Code, causa uma sessão genuína de nível superior a ser classificada incorretamente como aninhada. A partir de v2.1.178, Claude Code detecta o caso tmux automaticamente e ignora o marcador herdado, então tmux não precisa mais dessa variável. Também honrado em v2.1.169 e anterior; não tem efeito em v2.1.170 e v2.1.171, onde a detecção de sessão aninhada que ele substitui foi removida |
CLAUDE_CODE_FORCE_STRIKETHROUGH | Defina como 1 para forçar renderização de tachado para ~~text~~ nas respostas do Claude quando seu terminal suporta mas não é detectado automaticamente, como sobre SSH sem TERM_PROGRAM encaminhado. Sem isso, terminais não detectados mostram os marcadores ~~ literais em vez de renderizar o texto como tachado. Requer Claude Code v2.1.186 ou posterior |
CLAUDE_CODE_FORCE_SYNC_OUTPUT | Defina como 1 para forçar a habilitação do modo privado DEC 2026 saída sincronizada quando seu terminal suporta mas não é detectado automaticamente. Útil para emuladores como eat do Emacs que implementam BSU/ESU mas não respondem à sonda de capacidade. Não tem efeito sob tmux |
CLAUDE_CODE_FORK_SUBAGENT | Defina como 1 para permitir subagentes bifurcados, ou 0 para desabilitá-los, substituindo qualquer rollout do lado do servidor. Quando habilitado, Claude pode solicitar o tipo de subagente fork para gerar uma bifurcação, um subagente que herda o contexto de conversa completo em vez de começar do zero. Spawns sem um tipo de subagente ainda usam o subagente de propósito geral, e todos os spawns de subagente são executados em segundo plano. O comando /fork explícito funciona sem essa variável. Funciona em modo interativo e via SDK ou claude -p |
CLAUDE_CODE_GIT_BASH_PATH | Apenas Windows: caminho para o executável Git Bash (bash.exe). Use quando Git Bash está instalado mas não está no seu PATH. Veja Configuração do Windows |
CLAUDE_CODE_GLOB_HIDDEN | Defina como false para excluir dotfiles dos resultados quando Claude invoca a ferramenta Glob. Incluído por padrão. Não afeta autocomplete de arquivo @, ls, Grep ou Read |
CLAUDE_CODE_GLOB_NO_IGNORE | Defina como false para fazer a ferramenta Glob respeitar padrões .gitignore. Por padrão, Glob retorna todos os arquivos correspondentes, incluindo os ignorados pelo git. Não afeta autocomplete de arquivo @, que tem sua própria configuração respectGitignore |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS | Tempo limite em segundos para descoberta de arquivo da ferramenta Glob. Padrão é 20 segundos na maioria das plataformas e 60 segundos no WSL |
CLAUDE_CODE_HIDE_CWD | Defina como 1 para ocultar o diretório de trabalho no logo de inicialização. Útil para compartilhamentos de tela ou gravações onde o caminho expõe seu nome de usuário do SO |
CLAUDE_CODE_IDE_HOST_OVERRIDE | Substitua o endereço de host usado para conectar à extensão IDE. Por padrão, Claude Code detecta automaticamente o endereço correto, incluindo roteamento WSL-para-Windows |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | Pule a auto-instalação de extensões IDE. Equivalente a definir autoInstallIdeExtension como false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK | Defina como 1 para pular validação de entradas de arquivo de bloqueio IDE durante a conexão. Use quando a auto-conexão falha em encontrar sua IDE apesar dela estar em execução |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | Substitua o tamanho da janela de contexto que Claude Code assume para o modelo ativo. A partir de v2.1.193, aplicado diretamente para nomes de modelo que Claude Code não reconhece como um modelo Claude; para modelos Claude reconhecidos, só tem efeito quando DISABLE_COMPACT também está definido. Use isso ao rotear para um modelo através de ANTHROPIC_BASE_URL cuja janela de contexto não corresponde ao tamanho integrado para seu nome |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Defina o número máximo de tokens de saída para a maioria das solicitações. Padrões e limites variam por modelo; veja max output tokens. Aumentar este valor reduz a janela de contexto efetiva disponível antes que auto-compactação seja acionada |
CLAUDE_CODE_MAX_RETRIES | Substitua o número de vezes para tentar novamente solicitações de API falhadas (padrão: 10). Limitado a 15 a partir de v2.1.186. Para sessões não supervisionadas que precisam aguardar através de interrupções mais longas, defina CLAUDE_CODE_RETRY_WATCHDOG em vez disso |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY | Número máximo de ferramentas somente leitura e subagentes que podem executar em paralelo (padrão: 10). Valores mais altos aumentam o paralelismo mas consomem mais recursos |
CLAUDE_CODE_MAX_TURNS | Limite o número de voltas agentes quando nenhum limite explícito é passado. Equivalente a passar --max-turns, que tem precedência quando ambos estão definidos. Um valor que não é um inteiro positivo é rejeitado na inicialização com um erro em vez de ser tratado como sem limite |
CLAUDE_CODE_MCP_ALLOWLIST_ENV | Defina como 1 para gerar servidores MCP stdio com apenas um ambiente de linha de base segura mais o env configurado do servidor, em vez de herdar seu ambiente de shell |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT | Tempo limite de inatividade em milissegundos para chamadas de ferramentas MCP remotas (padrão: 300000, ou 5 minutos). Quando um servidor MCP HTTP, SSE, WebSocket ou conector claude.ai não envia resposta e nenhuma notificação de progresso por este tempo, a chamada de ferramenta aborta com um erro em vez de aguardar o MCP_TOOL_TIMEOUT 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, uma visualização de pesquisa que reduz cintilação e mantém memória plana em conversas longas. Equivalente à configuração tui; você também pode alternar com /tui fullscreen |
CLAUDE_CODE_OAUTH_REFRESH_TOKEN | Token de atualização OAuth para autenticação Claude.ai. Quando definido, claude auth login troca esse token diretamente em vez de abrir um navegador. Requer CLAUDE_CODE_OAUTH_SCOPES. Útil para provisionar autenticação em ambientes automatizados |
CLAUDE_CODE_OAUTH_SCOPES | Escopos OAuth separados por espaço com os quais o token de atualização foi emitido, como "user:profile user:inference user:sessions:claude_code". Obrigatório quando CLAUDE_CODE_OAUTH_REFRESH_TOKEN está definido |
CLAUDE_CODE_OAUTH_TOKEN | Token de acesso OAuth para autenticação Claude.ai. Alternativa a /login para SDK e ambientes automatizados. Tem precedência sobre credenciais armazenadas em keychain. Gere um com claude setup-token |
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE | Removido em v2.1.160 e agora é um no-op. Anteriormente fixava modo rápido em Claude Opus 4.6 em vez do padrão atual. Opus 4.6 não suporta mais modo rápido |
CLAUDE_CODE_OTEL_DIAG_STDERR | Defina como 1 para escrever erros de diagnóstico do exportador OpenTelemetry para stderr. Por padrão, esses erros aparecem apenas com --debug, então um exportador mal configurado, como uma colisão de porta Prometheus, falha silenciosamente de outra forma. Requer Claude Code v2.1.179 ou posterior. Veja Monitoramento |
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS | Tempo limite em milissegundos para liberar spans OpenTelemetry pendentes (padrão: 5000). Veja Monitoramento |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS | Intervalo para atualizar cabeçalhos OpenTelemetry dinâmicos em milissegundos (padrão: 1740000 / 29 minutos). Veja Cabeçalhos dinâmicos |
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS | Tempo limite em milissegundos para o exportador OpenTelemetry terminar no desligamento (padrão: 2000). Aumente se métricas forem descartadas na saída. Veja Monitoramento |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE | Defina como 1 para permitir que Claude Code execute o comando de atualização do seu gerenciador de pacotes em segundo plano quando uma nova versão estiver disponível. Aplica-se a instalações Homebrew e WinGet. Outros gerenciadores de pacotes continuam a mostrar o comando de atualização sem executá-lo. Veja Auto updates |
CLAUDE_CODE_PERFORCE_MODE | Defina como 1 para habilitar proteção de escrita ciente de Perforce. Quando definido, Edit, Write e NotebookEdit falham com uma dica p4 edit <file> se o arquivo de destino não tiver o bit de escrita do proprietário, que Perforce limpa em arquivos sincronizados até que p4 edit os abra. Isso evita que Claude Code contorne o rastreamento de mudanças do Perforce |
CLAUDE_CODE_PLUGIN_CACHE_DIR | Substitua o diretório raiz de plugins. Apesar do nome, isso define o diretório pai, não o cache em si: marketplaces e o cache de plugin vivem em subdiretórios sob este caminho. Padrão é ~/.claude/plugins |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS | Tempo limite em milissegundos para operações git ao instalar ou atualizar plugins (padrão: 120000). Aumente este valor para repositórios grandes ou conexões de rede lentas. Veja Operações Git expiram |
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE | Defina como 1 para manter o cache de marketplace existente quando um git pull falha em vez de limpar e re-clonar. Útil em ambientes offline ou airgapped onde re-clonar falharia da mesma forma. Veja Atualizações de marketplace falham em ambientes offline |
CLAUDE_CODE_PLUGIN_PREFER_HTTPS | Defina como 1 para clonar fontes de plugin GitHub owner/repo via HTTPS em vez de SSH. Aplica-se a instalação de plugin e atualização, e a /plugin marketplace add e update. Útil em executores CI, contêineres ou qualquer ambiente sem uma chave SSH configurada para github.com |
CLAUDE_CODE_PLUGIN_SEED_DIR | Caminho para um ou mais diretórios de seed de plugin somente leitura, separados por : em Unix ou ; no Windows. Use isso para agrupar um diretório de plugins pré-populado em uma imagem de contêiner. Claude Code registra marketplaces desses diretórios na inicialização e usa plugins pré-armazenados em cache sem re-clonar. Veja Pré-popular plugins para contêineres |
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY | Defina como 1 para parar Claude Code de passar -ExecutionPolicy Bypass ao gerar PowerShell para chamadas de ferramenta, hooks e comandos de linha de status, e respeitar a política de execução efetiva da máquina em vez disso. Por padrão, Claude Code contorna a política de execução no escopo do processo para que scripts .ps1 e importações de módulo funcionem em instalações Windows padrão com Restricted. O bypass no escopo do processo nunca substitui a Política de Grupo MachinePolicy ou UserPolicy independentemente dessa configuração |
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS | Tempo máximo em milissegundos que modo não interativo com a flag -p aguarda após a volta final para subagentes em segundo plano e workflows cujo resultado faz parte da saída. Padrão: 600000, ou 10 minutos. Quando o limite é excedido, tarefas em segundo plano restantes são encerradas e o processo sai. Defina como 0 para aguardar indefinidamente. Este limite é separado do período de carência de cinco segundos que se aplica a shells em segundo plano simples |
CLAUDE_CODE_PROPAGATE_TRACEPARENT | Defina como 1 para propagar contexto de rastreamento W3C quando ANTHROPIC_BASE_URL aponta para um proxy personalizado. A propagação cobre o cabeçalho traceparent em solicitações de modelo e MCP HTTP e a variável de ambiente TRACEPARENT para subprocessos Bash, PowerShell e hook. Por padrão, a propagação é habilitada apenas quando conectado diretamente à API Anthropic. Adicionado em v2.1.152. Veja Rastreamentos (beta) |
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST | Definido por plataformas host que incorporam Claude Code e gerenciam roteamento de provedor de modelo em seu nome. Quando definido, seleção de provedor, endpoint e variáveis de autenticação como CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY em arquivos de configuração são ignorados para que configurações de usuário não possam substituir o roteamento do host. O opt-out automático de telemetria para 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 |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS | Defina como 1 para permitir que o proxy execute resolução DNS em vez do chamador. Opt-in para ambientes onde o proxy deve lidar com resolução de nome de host |
CLAUDE_CODE_REMOTE | Definido automaticamente como true quando Claude Code está em execução como uma sessão em nuvem. Leia isso de um hook ou script de configuração para detectar se você está em um ambiente em nuvem |
CLAUDE_CODE_REMOTE_SESSION_ID | Definido automaticamente em sessões em nuvem para o ID da sessão atual. Leia isso para construir um link de volta para a transcrição da sessão. Veja Vincular saída de volta à sessão |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN | Defina como 1 para retomar automaticamente se a sessão anterior terminou no meio de uma volta. Usado em modo SDK para que o modelo continue sem exigir que o SDK reenvie o prompt |
CLAUDE_CODE_RESUME_PROMPT | Substitua a mensagem de continuação injetada ao retomar uma sessão que terminou no meio de uma volta. Padrão é Continue from where you left off.. Scripts de spawn para agentes de longa duração podem definir isso para uma mensagem de inicialização mais diretiva. Uma string vazia usa o padrão |
CLAUDE_CODE_RETRY_WATCHDOG | Defina como 1 para sessões não supervisionadas, como harnesses de avaliação, trabalhos CI ou workers remotos. Tenta novamente erros de capacidade 429 e 529 indefinidamente em vez de falhar após CLAUDE_CODE_MAX_RETRIES tentativas. O watchdog recua até 5 minutos entre tentativas, ou até o limite ser redefinido quando a resposta carrega um tempo de redefinição de limite de taxa, então uma sessão que atinge um limite de uso aguarda a janela restante. Requer Claude Code v2.1.186 ou posterior |
CLAUDE_CODE_SAFE_MODE | Defina como 1 para iniciar em modo seguro: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos personalizados e agentes, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam, para solucionar problemas de uma configuração quebrada. A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Equivalente a passar --safe-mode. Processos filhos gerados diretamente herdam a variável |
CLAUDE_CODE_SCRIPT_CAPS | Objeto JSON limitando quantas vezes scripts específicos podem ser invocados por sessão quando CLAUDE_CODE_SUBPROCESS_ENV_SCRUB está definido. As chaves são substrings correspondidas contra o texto do comando; os valores são limites de chamadas inteiras. Por exemplo, {"deploy.sh": 2} permite que deploy.sh seja chamado no máximo duas vezes. A correspondência é baseada em substring, então truques de expansão de shell como ./scripts/deploy.sh $(evil) ainda contam contra o limite. Fan-out em tempo de execução via xargs ou find -exec não é detectado; este é um controle de defesa em profundidade |
CLAUDE_CODE_SCROLL_SPEED | Defina o multiplicador de rolagem da roda do mouse em renderização em tela cheia. Aceita valores de 1 a 20 e valores fracionários abaixo de 1, como 0.5 para desacelerar a rolagem acelerada de trackpad e roda em terminais que já amplificam eventos de roda. Defina como 3 para corresponder a vim se seu terminal enviar um evento de roda por entalhe sem amplificação. Ignorado no terminal IDE JetBrains, onde Claude Code usa seu próprio tratamento de rolagem |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS | Substitua o orçamento de tempo em milissegundos para hooks SessionEnd. Aplica-se à saída de sessão, /clear e alternância de sessões via /resume interativo. Por padrão, o orçamento é 1,5 segundos, automaticamente aumentado para o timeout por hook mais alto configurado em arquivos de configuração, até 60 segundos. Timeouts em hooks fornecidos por plugin não aumentam o orçamento |
CLAUDE_CODE_SESSION_ID | Definido automaticamente em subprocessos de ferramenta Bash e PowerShell, subprocessos de comando hook e subprocessos servidor MCP stdio para o ID da sessão atual. Para Bash, PowerShell e hooks, isso corresponde ao campo session_id na entrada JSON do hook e é atualizado em /clear. Um subprocesso de servidor MCP retém o ID com o qual foi gerado. Em --resume <session-id> ele recebe o ID retomado, correspondendo a hooks e Bash. Em --continue ou --resume sem um ID explícito, ele pode receber o ID de inicialização inicial em vez disso. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou |
CLAUDE_CODE_SHELL | Defina o shell que Claude Code usa para executar comandos da ferramenta Bash. Aceita um caminho para um binário bash ou zsh, por exemplo /opt/homebrew/bin/bash. Outros shells como fish não são suportados. Se o valor não for um caminho bash ou zsh funcionando, Claude Code o ignora e volta para auto-detecção. A auto-detecção usa seu $SHELL quando aponta para bash ou zsh, caso contrário, escolhe o primeiro zsh funcionando e depois bash encontrado no seu PATH e locais de instalação padrão |
CLAUDE_CODE_SHELL_PREFIX | Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos hook, linha de status comandos e comandos de inicialização de servidor MCP stdio. Hooks de forma exec e hooks PowerShell são executados sem o prefixo. Útil para logging ou auditoria. Definir um caminho de executável simples como /path/to/logger.sh executa cada comando como /path/to/logger.sh '<command>'. O wrapper recebe a linha de comando como um único argumento shell-quoted em $1, então o wrapper deve re-avaliar $1 com um shell, por exemplo exec bash -c "$1". Tratar $1 como um caminho de executável simples quebra servidores MCP stdio que passam argumentos como npx -y <package>. Para chamadas de ferramenta Bash, $1 contém a invocação de shell completa que Claude Code monta, incluindo configuração de ambiente, não apenas o comando que Claude executou |
CLAUDE_CODE_SIMPLE | Defina como 1 para executar com um prompt do sistema mínimo e apenas as ferramentas Bash, leitura de arquivo e edição de arquivo. Ferramentas MCP de --mcp-config ainda estão disponíveis. Desabilita auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md. Tokens OAuth e credenciais de keychain não são lidos, então a autenticação Anthropic deve vir de ANTHROPIC_API_KEY ou um apiKeyHelper em --settings. Equivalente a passar --bare |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT | Defina como 1 para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em qualquer modelo. Defina como 0, false, no ou off para optar por não participar mesmo em modelos onde o experimento ou configuração do servidor habilitaria de outra forma. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados |
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH | Pule autenticação do lado do cliente para Claude Platform on AWS, para gateways que assinam solicitações por conta própria |
CLAUDE_CODE_SKIP_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 ou SubagentStop pode bloquear o término da volta antes que Claude Code o substitua e termine a volta de qualquer forma (padrão: 8). Defina como 0 para desabilitar o limite. Aumente isso se seu hook legitimamente precisa de mais iterações para resolver |
CLAUDE_CODE_SUBAGENT_MODEL | Veja Configuração de modelo. A partir de v2.1.196, defini-lo como inherit é o mesmo que deixá-lo não definido; versões anteriores tratavam inherit como um override que forçava cada subagente para o modelo da conversa principal |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB | Defina como 1 para remover credenciais do Anthropic e do provedor de nuvem de ambientes de subprocesso (ferramenta Bash, hooks, servidores MCP stdio). O processo Claude pai mantém essas credenciais para chamadas de API, mas processos filhos não podem lê-las, reduzindo a exposição a ataques de injeção de prompt que tentam exfiltrar segredos via expansão de shell. No Linux, isso também executa subprocessos Bash em um namespace PID isolado para que não possam ler ambientes de processo do host via /proc; como efeito colateral, ps, pgrep e kill não podem ver ou sinalizar processos do host. claude-code-action define isso automaticamente quando allowed_non_write_users está configurado |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL | Defina como 1 em modo não interativo (a flag -p) para aguardar a conclusão da instalação de plugin antes da primeira consulta. Sem isso, plugins instalam em segundo plano e podem não estar disponíveis na primeira volta. Combine com CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS para limitar a espera |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS | Tempo limite em milissegundos para instalação síncrona de plugin. Quando excedido, Claude Code prossegue sem plugins e registra um erro. Sem padrão: sem essa variável, instalação síncrona aguarda até a conclusão |
CLAUDE_CODE_SYNC_SKILLS | Defina como 1 para baixar suas skills habilitadas do claude.ai em ~/.claude/skills/ antes da primeira consulta e ressincronizar a cada 10 minutos. Aplica-se apenas em modo não interativo com a flag -p. Requer autenticação claude.ai. Claude Code on the web sessões recebem suas skills habilitadas do claude.ai automaticamente; você não precisa definir isso lá |
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS | Tempo limite em milissegundos para uma ressincronização de skills no meio da sessão quando CLAUDE_CODE_SYNC_SKILLS está definido (padrão: 30000). Limita o download acionado quando o host solicita um recarregamento de skill durante a sessão. Quando excedido, a ressincronização para e os downloads de skill restantes continuam em segundo plano |
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS | Tempo limite em milissegundos para a primeira consulta aguardar na sincronização inicial de skills quando CLAUDE_CODE_SYNC_SKILLS está definido (padrão: 5000). Quando excedido, a consulta prossegue e os downloads de skill restantes continuam em segundo plano |
CLAUDE_CODE_SYNTAX_HIGHLIGHT | Defina como false para desabilitar destaque de sintaxe na saída de diff. Útil quando cores interferem com sua configuração de terminal. Para também desabilitar destaque em blocos de código e visualizações de arquivo, use a configuração syntaxHighlightingDisabled |
CLAUDE_CODE_TASK_LIST_ID | Compartilhe uma lista de tarefas entre sessões. Defina o mesmo ID em múltiplas instâncias do Claude Code para coordenar em uma lista de tarefas compartilhada. Veja Lista de tarefas |
CLAUDE_CODE_TEAM_NAME | Nome da equipe de agentes à qual este companheiro pertence. Definido automaticamente em membros de equipe de agentes |
CLAUDE_CODE_TMPDIR | Substitua o diretório temporário usado para arquivos temporários internos. Claude Code acrescenta /claude-{uid}/ em Unix ou /claude/ no Windows a este caminho. Padrão: /tmp em macOS, os.tmpdir() em Linux e Windows. A partir de v2.1.161, em macOS e Linux, subprocessos Bash sandboxed recebem um fallback $TMPDIR curto sob o padrão do sistema quando sua substituição é um caminho longo, já que algumas ferramentas falham quando caminhos temporários ficam muito longos. Comandos Bash não sandboxed herdam seu $TMPDIR de shell inalterado. Os próprios arquivos temporários do Claude Code sempre usam sua substituição |
CLAUDE_CODE_TMUX_TRUECOLOR | Defina como 1 para permitir saída truecolor de 24 bits dentro de tmux. Por padrão, Claude Code limita a 256 cores quando $TMUX está definido porque tmux não passa sequências de escape truecolor a menos que esteja configurado para isso. Defina isso após adicionar set -ga terminal-overrides ',*:Tc' ao seu ~/.tmux.conf. Veja Configuração de terminal para outras configurações de tmux |
CLAUDE_CODE_USE_ANTHROPIC_AWS | Use Claude Platform on AWS |
CLAUDE_CODE_USE_BEDROCK | Use Bedrock |
CLAUDE_CODE_USE_FOUNDRY | Use Microsoft Foundry |
CLAUDE_CODE_USE_MANTLE | Use o endpoint Mantle 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 |
CLAUDE_CODE_USE_VERTEX | Use Vertex |
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 | Defina como 1 para parar o trabalho em segundo plano em andamento em vez de carregá-lo quando você coloca uma sessão em segundo plano pressionando ← ou com /background. Claude Code pede que você confirme antes de colocar em segundo plano, então para as tarefas que de outra forma seriam carregadas. Requer Claude Code v2.1.195 ou posterior |
CLAUDE_EFFORT | Definido automaticamente em subprocessos de ferramenta Bash e comandos hook para o nível de esforço ativo para a volta: low, medium, high, xhigh ou max. Ultracode não é um nível distinto e relata como xhigh. Corresponde ao campo effort.level passado para hooks. Apenas definido quando o modelo atual suporta o parâmetro de esforço |
CLAUDE_ENABLE_BYTE_WATCHDOG | Defina como 1 para forçar a habilitação do watchdog ocioso de nível de byte, ou defina como 0 para forçar a desabilitação. Quando não definido, o watchdog é habilitado por padrão para conexões diretas da API Anthropic e Claude Platform on AWS. O watchdog de byte aborta uma conexão quando nenhum byte chega no fio por 180 segundos por padrão em conexões diretas da API Anthropic, 300 segundos em Claude Platform on AWS e quando habilitado em Bedrock, ou para o valor de CLAUDE_STREAM_IDLE_TIMEOUT_MS quando isso está definido, que é fixado a um mínimo de 5 minutos, independente do watchdog de nível de evento |
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK | Defina como 1 para habilitar o watchdog ocioso de streaming de nível de byte em respostas vnd.amazon.eventstream do Amazon Bedrock. Desativado por padrão. Configure o tempo limite com CLAUDE_STREAM_IDLE_TIMEOUT_MS |
CLAUDE_ENABLE_STREAM_WATCHDOG | Defina como 0 para forçar a desabilitação do watchdog ocioso de streaming de nível de evento, ou defina como 1 para forçar a habilitação. Quando não definido, o watchdog está ativado por padrão para todos os provedores. Antes de v2.1.196, o padrão não definido era controlado pelo servidor na API Anthropic direta e desativado em outros provedores. A partir de v2.1.169, provedores diferentes da API Anthropic direta e Claude Platform on AWS também têm um tempo limite de inatividade de corpo padrão de 5 minutos independente desta variável; veja API_FORCE_IDLE_TIMEOUT. Em Bedrock, você também pode habilitar o watchdog de nível de byte independente com CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK; os dois funcionam juntos quando ambos estão definidos. Configure o tempo limite com CLAUDE_STREAM_IDLE_TIMEOUT_MS |
CLAUDE_ENV_FILE | Caminho para um script de shell cujo conteúdo Claude Code executa antes de cada comando Bash no mesmo processo de shell, para que as exportações no arquivo sejam visíveis para o comando. Use para persistir ativação de virtualenv ou conda entre comandos. Também preenchido dinamicamente por hooks SessionStart, Setup, CwdChanged e FileChanged |
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX | Prefixo para nomes de sessão Remote Control gerados automaticamente quando nenhum nome explícito é fornecido. Padrão é o nome do host da sua máquina, produzindo nomes como myhost-graceful-unicorn. A flag CLI --remote-control-session-name-prefix define o mesmo valor para uma única invocação |
CLAUDE_STREAM_IDLE_TIMEOUT_MS | Tempo limite em milissegundos antes que o watchdog ocioso de streaming feche uma conexão travada. Quando você define esta variável explicitamente, o mínimo é 300000 (5 minutos); valores mais baixos são silenciosamente fixados para absorver pausas de pensamento estendido e buffering de proxy. Quando não definido, o watchdog de nível de evento padrão é 300 segundos e o watchdog de nível de byte padrão é 180 segundos em conexões diretas da API Anthropic (300 segundos em Claude Platform on AWS e outros provedores). O padrão de 180 segundos do watchdog de byte não definido é um valor separado e não está sujeito ao clamp de 5 minutos. O tempo limite de inatividade de corpo descrito em API_FORCE_IDLE_TIMEOUT se aplica independentemente. Em Bedrock, também se aplica quando CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 |
DEBUG | Defina como 1 para habilitar modo de depuração, equivalente a iniciar com --debug. Logs de depuração são escritos em ~/.claude/debug/<session-id>.txt, ou no caminho definido por CLAUDE_CODE_DEBUG_LOGS_DIR. Apenas os valores verdadeiros 1, true, yes e on habilitam modo de depuração, então padrões de namespace como DEBUG=express:* definidos para outras ferramentas não o acionam |
DISABLE_AUTOUPDATER | Defina como 1 para desabilitar atualizações automáticas em segundo plano. Manual claude update ainda funciona. Use DISABLE_UPDATES para bloquear ambos |
DISABLE_AUTO_COMPACT | Defina como 1 para desabilitar compactação automática ao se aproximar do limite de contexto. O comando manual /compact permanece disponível. Use quando você deseja controle explícito sobre quando a compactação ocorre |
DISABLE_COMPACT | Defina como 1 para desabilitar toda compactação: tanto compactação automática quanto o comando manual /compact |
DISABLE_COST_WARNINGS | Defina como 1 para desabilitar mensagens de aviso de custo |
DISABLE_DOCTOR_COMMAND | Defina como 1 para ocultar 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 |
DISABLE_LOGIN_COMMAND | Defina como 1 para ocultar o comando /login. Útil quando a autenticação é tratada externamente via chaves de API ou apiKeyHelper |
DISABLE_LOGOUT_COMMAND | Defina como 1 para ocultar o comando /logout |
DISABLE_PROMPT_CACHING | Defina como 1 para desabilitar prompt caching para todos os modelos (tem precedência sobre configurações por modelo) |
DISABLE_PROMPT_CACHING_FABLE | Defina como 1 para desabilitar prompt caching para modelos Fable |
DISABLE_PROMPT_CACHING_HAIKU | Defina como 1 para desabilitar prompt caching para modelos Haiku |
DISABLE_PROMPT_CACHING_OPUS | Defina como 1 para desabilitar prompt caching para modelos Opus |
DISABLE_PROMPT_CACHING_SONNET | Defina como 1 para desabilitar prompt caching para modelos Sonnet |
DISABLE_TELEMETRY | Defina como 1 para optar por não participar da telemetria. Eventos de telemetria não incluem dados do usuário como código, caminhos de arquivo ou comandos bash. Também desabilita busca de flags de recurso com o mesmo efeito que DISABLE_GROWTHBOOK, então alguns recursos sinalizados podem não estar disponíveis |
DISABLE_UPDATES | Defina como 1 para bloquear todas as atualizações, incluindo manual claude update e claude install. Mais rigoroso que DISABLE_AUTOUPDATER. Use ao distribuir Claude Code através de seus próprios canais e usuários não devem auto-atualizar |
DISABLE_UPGRADE_COMMAND | Defina como 1 para ocultar o comando /upgrade |
DO_NOT_TRACK | Defina como 1 para optar por não participar da telemetria. Equivalente a definir DISABLE_TELEMETRY. Claude Code honra isso como a convenção padrão entre ferramentas reconhecida por muitos CLIs de desenvolvedor |
ENABLE_CLAUDEAI_MCP_SERVERS | Defina como false para desabilitar servidores MCP claude.ai no Claude Code. Habilitado por padrão para usuários conectados. Para desabilitar por projeto ou por organização, defina disableClaudeAiConnectors em configurações em vez disso |
ENABLE_PROMPT_CACHING_1H | Defina como 1 para solicitar um TTL de cache de prompt de 1 hora em vez do padrão de 5 minutos. Destinado para usuários de chave de API, Bedrock, Vertex, Foundry e Claude Platform on AWS. Usuários de assinatura recebem TTL de 1 hora automaticamente. Escritas de cache de 1 hora são cobradas a uma taxa mais alta |
ENABLE_PROMPT_CACHING_1H_BEDROCK | Descontinuado. Use ENABLE_PROMPT_CACHING_1H em vez disso |
ENABLE_TOOL_SEARCH | Controla busca de ferramentas MCP. Não definido: todas as ferramentas MCP adiadas por padrão, mas carregadas antecipadamente em 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. A partir de v2.1.160, uma cadeia de modelo fallback configurada aciona em erros de sobrecarga repetidos para qualquer modelo primário, então esta variável não afeta a alternância para um modelo fallback |
FORCE_AUTOUPDATE_PLUGINS | Defina como 1 para forçar auto-atualizações de plugins mesmo quando o auto-atualizador principal está desabilitado via DISABLE_AUTOUPDATER |
FORCE_PROMPT_CACHING_5M | Defina como 1 para forçar o TTL de cache de prompt de 5 minutos mesmo quando o TTL de 1 hora se aplicaria de outra forma. Substitui ENABLE_PROMPT_CACHING_1H |
HTTP_PROXY | Especifique servidor proxy HTTP para conexões de rede |
HTTPS_PROXY | Especifique servidor proxy HTTPS para conexões de rede |
IS_DEMO | Defina como 1 para habilitar modo demo: oculta seu email e nome da organização do cabeçalho e saída /status, e pula onboarding. Útil ao fazer streaming ou gravar uma sessão |
MAX_MCP_OUTPUT_TOKENS | Número máximo de tokens permitidos em respostas de ferramentas MCP. Claude Code exibe um aviso quando a saída excede 10.000 tokens. Ferramentas que declaram anthropic/maxResultSizeChars usam esse limite de caracteres para conteúdo de texto em vez disso, mas conteúdo de imagem dessas ferramentas ainda está sujeito a essa variável (padrão: 25000) |
MAX_STRUCTURED_OUTPUT_RETRIES | Número de vezes para tentar novamente quando a resposta do modelo falha na validação contra o --json-schema em modo não interativo (a flag -p). Padrão é 5 |
MAX_THINKING_TOKENS | Substitua o orçamento de token de pensamento estendido. O teto é o max output tokens do modelo menos um. Defina como 0 para desabilitar pensamento na API Anthropic exceto em Fable 5, que não pode ter pensamento desligado. Em provedores de terceiros, 0 igualmente omite o parâmetro, e modelos com raciocínio adaptativo ainda podem pensar. Para valores diferentes de zero em modelos de raciocínio adaptativo, o orçamento é ignorado a menos que raciocínio adaptativo seja desabilitado via CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING |
MCP_CLIENT_SECRET | Segredo do cliente OAuth para servidores MCP que requerem credenciais pré-configuradas. Evita o prompt interativo ao adicionar um servidor com --client-secret |
MCP_CONNECTION_NONBLOCKING | Controla se a inicialização aguarda servidores MCP se conectarem antes da primeira consulta. A partir do Claude Code v2.1.142, a inicialização MCP é não-bloqueante por padrão: servidores se conectam em segundo plano e suas ferramentas ficam disponíveis conforme terminam. Defina como 0 para restaurar a espera de conexão bloqueante de 5 segundos. Servidores configurados com alwaysLoad: true ainda bloqueiam a inicialização independentemente, já que suas ferramentas devem estar presentes quando o primeiro prompt é construído |
MCP_CONNECT_TIMEOUT_MS | Quanto tempo a inicialização bloqueante MCP aguarda, em milissegundos, para o lote de conexão antes de tirar um snapshot da lista de ferramentas (padrão: 5000). Aplica-se quando MCP_CONNECTION_NONBLOCKING=0 ou para servidores marcados alwaysLoad: true. Servidores ainda pendentes no prazo continuam se conectando em segundo plano mas não aparecerão até a próxima consulta. Distinto de MCP_TIMEOUT, que limita a tentativa de conexão de um servidor individual |
MCP_OAUTH_CALLBACK_PORT | Porta fixa para o callback de redirecionamento OAuth, como alternativa a --callback-port ao adicionar um servidor MCP com credenciais pré-configuradas |
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE | Número máximo de servidores MCP remotos (HTTP/SSE) para conectar em paralelo durante a inicialização (padrão: 20) |
MCP_SERVER_CONNECTION_BATCH_SIZE | Número máximo de servidores MCP locais (stdio) para conectar em paralelo durante a inicialização (padrão: 3) |
MCP_TIMEOUT | Tempo limite em milissegundos para inicialização do servidor MCP (padrão: 30000, ou 30 segundos) |
MCP_TOOL_TIMEOUT | Tempo limite em milissegundos para execução de ferramentas MCP (padrão: 100000000, aproximadamente 28 horas). 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 | Defina como 1 para incluir o texto de resposta do modelo em eventos de log OpenTelemetry assistant_response. Quando não definido, o valor de OTEL_LOG_USER_PROMPTS é usado em vez disso. Defina como 0 para manter respostas redatadas mesmo quando OTEL_LOG_USER_PROMPTS está definido. Requer Claude Code v2.1.193 ou posterior. Veja Monitoramento |
OTEL_LOG_RAW_API_BODIES | Emita solicitação e resposta JSON da API Anthropic Messages como eventos de log api_request_body / api_response_body. Defina como 1 para corpos inline truncados em 60 KB, ou file:<dir> para escrever corpos não truncados em disco e emitir um caminho body_ref em vez disso. Desabilitado por padrão; corpos incluem todo o histórico de conversa. Veja Monitoramento |
OTEL_LOG_TOOL_CONTENT | Defina como 1 para incluir conteúdo de entrada e saída de ferramenta em eventos de span OpenTelemetry. Desabilitado por padrão para proteger dados sensíveis. Veja Monitoramento |
OTEL_LOG_TOOL_DETAILS | Defina como 1 para incluir argumentos de entrada de ferramenta, nomes de servidor MCP, strings de erro bruto em falhas de ferramenta, a categoria de recusa em eventos api_refusal e outros detalhes de ferramenta em rastreamentos e logs OpenTelemetry. Desabilitado por padrão para proteger PII. Veja Monitoramento |
OTEL_LOG_USER_PROMPTS | Defina como 1 para incluir texto de prompt do usuário em rastreamentos e logs OpenTelemetry. Desabilitado por padrão (prompts são redatados). Veja Monitoramento |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID | Defina como false para excluir UUID da conta dos atributos de métricas (padrão: incluído). Veja Monitoramento |
OTEL_METRICS_INCLUDE_ENTRYPOINT | Defina como true para incluir o ponto de entrada da sessão em atributos de métricas (padrão: excluído). Adicionado em v2.1.152. Veja Monitoramento |
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES | A partir de v2.1.161, Claude Code anexa chaves OTEL_RESOURCE_ATTRIBUTES aos rótulos de ponto de dados de métrica. Defina como false para excluí-las (padrão: incluído). Veja Monitoramento |
OTEL_METRICS_INCLUDE_SESSION_ID | Defina como false para excluir ID de sessão dos atributos de métricas (padrão: incluído). Veja Monitoramento |
OTEL_METRICS_INCLUDE_VERSION | Defina como true para incluir versão do Claude Code em atributos de métricas (padrão: excluído). Veja Monitoramento |
SLASH_COMMAND_TOOL_CHAR_BUDGET | Substitua o orçamento de caracteres para metadados de skill mostrados à ferramenta Skill. O orçamento escala dinamicamente em 1% da janela de contexto, com um fallback de 8.000 caracteres. Nome legado mantido para compatibilidade com versões anteriores |
TASK_MAX_OUTPUT_LENGTH | Número máximo de caracteres na saída de subagente antes de truncamento (padrão: 32000, máximo: 160000). Quando truncado, a saída completa é salva em disco e o caminho é incluído na resposta truncada |
USE_BUILTIN_RIPGREP | Defina como 0 para usar rg instalado no sistema em vez de rg incluído com Claude Code |
VERTEX_REGION_CLAUDE_3_5_HAIKU | Substitua região para Claude 3.5 Haiku ao usar 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 | Substitua região para Claude Opus 4.7 ao usar Vertex AI. Adicionado em v2.1.111 |
VERTEX_REGION_CLAUDE_4_8_OPUS | Substitua região para Claude Opus 4.8 ao usar Vertex AI. Adicionado em v2.1.154 |
VERTEX_REGION_CLAUDE_FABLE_5 | 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 |
