SpyBara
Go Premium

env-vars.md 2026-05-08 22:00 UTC to 2026-05-09 04:57 UTC

3 added, 1 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

Variáveis de ambiente

Referência completa para variáveis de ambiente que controlam o comportamento do Claude Code.

Claude Code suporta as seguintes variáveis de ambiente para controlar seu comportamento. Configure-as no seu shell antes de iniciar claude, ou configure-as em settings.json sob a chave env para aplicá-las a cada sessão ou distribuí-las em sua equipe.

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_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
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_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
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
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 de serem truncadas no meio
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 ambientes de shell que Claude Code gera (ferramenta Bash, sessões tmux). Não definido em hooks ou comandos de linha de status. Use para detectar quando um script está sendo executado dentro de um shell gerado por Claude Code
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 da capacidade de contexto (1-100) na qual a auto-compactação é acionada. Por padrão, a auto-compactação é acionada em aproximadamente 95% de capacidade. Use valores mais baixos como 50 para compactar mais cedo. Valores acima do limite padrão não têm efeito. Aplica-se a conversas principais e subagentes. Esta porcentagem se alinha com o campo context_window.used_percentage disponível na linha de status
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_BASH_MAINTAIN_PROJECT_WORKING_DIR Retorne ao diretório de trabalho original após cada comando Bash ou PowerShell na sessão principal
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_API_KEY_HELPER_TTL_MS Intervalo em milissegundos no qual as credenciais devem ser atualizadas (ao usar apiKeyHelper)
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. 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. Padrão é bundled,system
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_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 ou /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. Ú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. {/* min-version: 2.1.111 */}Não tem efeito em Opus 4.7, que sempre usa raciocínio adaptativo
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
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 durante o lançamento gradual. 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_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 ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definido. 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_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_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
CLAUDE_CODE_DISABLE_THINKING Defina como 1 para forçar a desabilitação de pensamento estendido independentemente do suporte do modelo ou outras configurações. Mais direto que MAX_THINKING_TOKENS=0
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_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_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_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
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 Defina como 1 para habilitar o sistema de rastreamento de tarefas em modo não interativo (a flag -p). As tarefas estão ativadas por padrão em modo interativo. Veja Lista de tarefas
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_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 habilitar subagentes bifurcados. Um subagente bifurcado herda o contexto de conversa completo da sessão principal em vez de começar do zero. Quando habilitado, /fork gera um subagente bifurcado em vez de agir como um alias para /branch, e todos os spawns de subagente são executados em segundo plano. 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. 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)
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_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_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_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_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_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 artefatos 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_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. 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 para o ID da sessão atual. Corresponde ao campo session_id passado para hooks. Atualizado em /clear. Use para correlacionar scripts e ferramentas externas com a sessão Claude Code que as iniciou
CLAUDE_CODE_SHELL Substitua a detecção automática de shell. Útil quando seu shell de login difere do seu shell de trabalho preferido (por exemplo, bash vs zsh)
CLAUDE_CODE_SHELL_PREFIX Prefixo de comando que envolve comandos shell que Claude Code gera: chamadas de ferramenta Bash, comandos hook e comandos de inicialização de servidor MCP stdio. Útil para logging ou auditoria. Exemplo: definir /path/to/logger.sh executa cada comando como /path/to/logger.sh <command>
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. A flag CLI --bare define isso
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT Defina como 1 para usar um prompt do sistema mais curto e descrições de ferramenta abreviadas em Opus 4.7. Não tem efeito em outros modelos. O conjunto de ferramentas completo, hooks, servidores MCP e descoberta de CLAUDE.md permanecem habilitados
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 (por exemplo, ao usar um gateway LLM)
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 usando um gateway LLM)
CLAUDE_CODE_SUBAGENT_MODEL Veja Configuração de modelo
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_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}/ (Unix) ou /claude/ (Windows) a este caminho. Padrão: /tmp em macOS, os.tmpdir() em Linux/Windows
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_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_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. 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 da API Anthropic. O watchdog de byte aborta uma conexão quando nenhum byte chega no fio pela duração definida por CLAUDE_STREAM_IDLE_TIMEOUT_MS, com um mínimo de 5 minutos, independente do watchdog de nível de evento
CLAUDE_ENABLE_STREAM_WATCHDOG Defina como 1 para habilitar o watchdog ocioso de streaming de nível de evento. Desativado por padrão. Para Bedrock, Vertex e Foundry, este é o único watchdog ocioso disponível. 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. Padrão e mínimo 300000 (5 minutos) para ambos os watchdogs de nível de byte e de nível de evento; valores mais baixos são silenciosamente fixados para absorver pausas de pensamento estendido e buffering de proxy. Para provedores de terceiros, requer CLAUDE_ENABLE_STREAM_WATCHDOG=1
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 /extra-usage 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 cache de prompt para todos os modelos (tem precedência sobre configurações por modelo)
DISABLE_PROMPT_CACHING_HAIKU Defina como 1 para desabilitar cache de prompt para modelos Haiku
DISABLE_PROMPT_CACHING_OPUS Defina como 1 para desabilitar cache de prompt para modelos Opus
DISABLE_PROMPT_CACHING_SONNET Defina como 1 para desabilitar cache de prompt para modelos Sonnet
DISABLE_TELEMETRY Defina como 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
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. Honrado como a convenção padrão entre ferramentas
ENABLE_CLAUDEAI_MCP_SERVERS Defina como false para desabilitar servidores MCP claude.ai no Claude Code. Habilitado por padrão para usuários conectados
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 e Foundry. 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 incluindo proxies e Vertex AI), 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 acionador fallback para --fallback-model após erros de sobrecarga repetidos em qualquer modelo primário. Por padrão, apenas modelos Opus acionam o 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 inteiramente. Em modelos com 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 Defina como true em modo não interativo (-p) para pular a espera de conexão MCP inteiramente. Útil para pipelines com script onde ferramentas MCP não são necessárias. Sem essa variável, a primeira consulta aguarda até 5 segundos para conexões de servidor --mcp-config. Servidores configurados com alwaysLoad: true sempre bloqueiam a inicialização independentemente dessa variável, já que suas ferramentas devem estar presentes quando o primeiro prompt é construído
MCP_CONNECT_TIMEOUT_MS Quanto tempo a primeira consulta aguarda, em milissegundos, para o lote de conexão MCP antes de tirar um snapshot da lista de ferramentas (padrão: 5000). 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. Mais relevante para sessões não interativas que emitem uma única consulta e precisam que servidores de conexão lenta sejam visíveis
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)
NO_PROXY Lista de domínios e IPs para os quais as solicitações serão emitidas diretamente, contornando proxy
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 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_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 {/* min-version: 2.1.111 */}Substitua região para Claude Opus 4.7 ao usar Vertex AI
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 para detalhes de configuração.

Veja também