Cheat sheet do Claude Code: comandos, configurações e atalhos
# Cheat sheet do Claude Code para a v2.1.317: flags da CLI, comandos de barra, atalhos de teclado, modos de permissão, modelos (Opus 5.5 como padrão em todos os planos), hooks, plugins, Workflow e variáveis de ambiente.
Cada flag do CLI, comando de barra, atalho de teclado, chave de configuração, evento de hook e variável de ambiente em um só lugar. Para explicações detalhadas, veja o guia completo do Claude Code. Para configuração inicial, veja o quickstart.
1. Instalação
Três métodos de instalação, em ordem de preferência.
# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash
# Homebrew (macOS)
brew install --cask claude-code
# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code
Instale uma versão específica:
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Verifique a instalação:
claude doctor
claude --version
Nas versões 2.1.288 a 2.1.290, atualize para a 2.1.291 ou posterior: ela corrige uma regressão da 2.1.288 que podia perder as últimas mensagens de uma sessão ao sair e uma regressão da 2.1.290 em que sessões na nuvem podiam descartar respostas a prompts de permissão.
Autentique-se:
claude auth login # Log in or switch accounts
claude auth status # Check current auth state
claude auth logout # Clear stored credentials
2. Flags da CLI
| Flag | Descrição | Exemplo |
|---|---|---|
-p |
Modo de impressão — uma única consulta e depois sai | claude -p "list TODOs" |
-c |
Continua a sessão mais recente | claude -c |
-r, --resume |
Retoma uma sessão nomeada ou numerada | claude -r "auth-refactor" |
-n, --name |
Define o nome de exibição da sessão na inicialização | claude -n "feature-x" |
--model |
Substitui o modelo para esta sessão | claude --model opus |
--advisor <model> |
Ativa a ferramenta advisor do lado do servidor para uma sessão (fable, opus, sonnet ou um ID completo); não aparece em --help; prevalece sobre a configuração advisorModel |
claude --advisor opus |
--max-turns |
Limita os turnos autônomos | claude -p "fix lint" --max-turns 10 |
--output-format |
Saída como text, json ou stream-json |
claude -p "count files" --output-format json |
--allowedTools |
Restringe as ferramentas disponíveis | claude -p "fix" --allowedTools "Edit,Bash(npm:*)" |
--permission-mode |
Define o modo de permissão | claude --permission-mode auto |
--permission-mode auto |
Inicia com o Modo Auto ativado (substituiu --enable-auto-mode, removido na v2.1.111); a partir da v2.1.302, uma sessão claude -p ou do Agent SDK inicia em Manual, a menos que você passe essa flag |
claude --permission-mode auto |
--dangerously-skip-permissions |
Modo YOLO — pula todos os prompts | claude --dangerously-skip-permissions |
--from-pr |
Inicia uma sessão vinculada a um PR (v2.1.27+); aceita URLs de PR do GitHub, GHE, MR do GitLab e PR do Bitbucket (v2.1.119+) | claude --from-pr 123 |
--fork-session |
Cria um fork a partir de uma sessão retomada | claude -r base --fork-session |
-w |
Inicia em um worktree git isolado | claude -w |
--bare |
Modo para scripts — pula hooks, LSP e plugins; a partir da v2.1.286, conecta apenas os servidores MCP nomeados na linha de comando, não envia lembretes do sistema e não inicia tarefas em segundo plano | claude -p "count files" --bare |
--plugin-url <url> |
Baixa um arquivo .zip de plugin para a sessão atual (v2.1.129+) |
claude --plugin-url https://example.com/plugin.zip |
--plugin-dir <path> |
Carrega um diretório de plugin, um arquivo .zip ou uma pasta de plugins – cada subpasta com um manifesto é carregada, e as alterações são detectadas ao vivo (.zip v2.1.128+, modo pasta v2.1.265+) |
claude --plugin-dir ./my-plugin.zip |
--channels |
Encaminha prompts de aprovação para o Telegram/Discord | claude --channels |
--forward-subagent-text |
Inclui o texto e o thinking dos subagents na saída stream-json (v2.1.211+); env: CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 |
claude -p "audit" --output-format stream-json --forward-subagent-text |
--ax-screen-reader |
Ativa o modo leitor de tela (v2.1.208+); também CLAUDE_AX_SCREEN_READER=1 ou "axScreenReader": true |
claude --ax-screen-reader |
--desktop |
Abre o app desktop do Claude no diretório atual, ou em uma sessão com --continue / --resume <id> (v2.1.285+) |
claude --desktop --continue |
--cloud |
Inicia uma sessão na nuvem para o repositório atual a partir do terminal (--remote é o alias descontinuado); com -p e um ID de sessão ou URL claude.ai/code, enfileira uma mensagem em uma sessão na nuvem em execução e sai |
claude --cloud "Fix the flaky login test" |
--debug |
Ativa o log de depuração | claude --debug |
--init |
Inicializa o projeto com CLAUDE.md | claude --init |
Subcomando adicionado na v2.1.212: claude auto-mode reset redefine o estado do modo auto a partir do terminal; passe --yes para pular o prompt de confirmação.7
Subcomandos de sessão e dados: claude attach <name> e claude logs <name> aceitam parte do nome de uma sessão em segundo plano no lugar do id (v2.1.290+). claude purge [path] exclui o estado local do Claude Code de um projeto (--dry-run mostra uma prévia); antes da v2.1.288 era claude project purge, e o nome antigo ainda funciona com um aviso. A partir da v2.1.300, claude remote-control não aceita mais --sandbox nem --no-sandbox (eles não tinham efeito; defina sandbox.enabled nas configurações). A partir da v2.1.309, claude ultrareview exige confiança no workspace: em um terminal, ele pergunta; caso contrário, recusa; scripts passam --trust-workspace (sem valor; coloque um número de PR ou branch base antes dele) ou definem CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1.14 claude self-hosted-runner --hold-idle-file <path> --max-hold-min <n> mantém uma sessão ociosa enquanto seu host continuar alterando o arquivo, liberando-a de qualquer forma após n minutos (padrão 1440; v2.1.311+).
3. Comandos de barra
| Comando | O que faz |
|---|---|
/init |
Inicializa o projeto com CLAUDE.md |
/compact |
Condensa o histórico da conversa. Adicione um foco: /compact focus on tests |
/autocompact |
Define o quanto a janela de contexto pode encher antes da compactação automática: /autocompact 500k, ou auto para o padrão ajustado. Salvo por modelo a partir da v2.1.288, então cada modelo mantém sua própria janela |
/context |
Mostra o uso da janela de contexto com sugestões práticas |
/diff |
Painel de diff em tela cheia ao lado da conversa, mostrando suas alterações não commitadas ao vivo enquanto o Claude edita; alterne com /diff (v2.1.260) |
/usage |
Uso de tokens, custo e uso do plano; diálogo unificado (v2.1.118+: /cost e /stats são atalhos de digitação que abrem abas do /usage); a v2.1.149+ adiciona o uso dos limites por categoria para skills, subagents e plugins, além do custo por servidor MCP; a v2.1.299 adiciona avisos para esforço máximo, workflows, contexto sempre ativo e resultados grandes de ferramentas; a v2.1.305 transforma cada aviso em uma correção de uma linha que indica sua origem, e f aplica as correções (também no VS Code e no /doctor) |
/cost |
Atalho de digitação → abre a aba de custo do /usage (v2.1.118+) |
/model |
Troca o modelo. /model opus, /model sonnet; os nomes dispensam o sufixo [1m] onde ele não tem efeito, e o sufixo continua sendo aceito (v2.1.311+) |
/advisor |
Define, mostra ou desativa o modelo advisor que o Claude consulta em pontos de decisão (ferramenta experimental do servidor). /advisor opus, /advisor off; forma textual em sessões headless e desktop desde a v2.1.260; na Claude Platform na AWS desde a v2.1.300 |
/fast |
Alterna o modo de saída rápida – Opus 5.5 (o padrão desde a v2.1.280, US$ 8/US$ 40 por MTok), Opus 5 ou Opus 4.8 (US$ 10/US$ 50; modo rápido do Opus 4.8 descontinuado em 30 de outubro de 2026, removido em 30 de novembro); a v2.1.219 removeu o Opus 4.7; ~2,5× a velocidade de saída; funciona em sessões remotas (runners na nuvem e auto-hospedados) a partir da v2.1.271; enviado a partir da visualização de agentes, define com o que as novas sessões começam, e um /fast sozinho ali abre um seletor (v2.1.299+) |
/effort |
Define o nível de esforço: low, medium, high, xhigh, max (padrão medium no Opus 5.5 e no Sonnet 5.5, high na maioria dos outros modelos). O Ultracode tem seu próprio interruptor a partir da v2.1.284: Tab no controle deslizante, ou /effort ultracode on / /effort ultracode off; ele não força mais xhigh e permanece ativo em qualquer nível; na visualização de agentes, um /effort sozinho abre um seletor e o nível se aplica às novas sessões (v2.1.299+). Digitar ultrathink em um prompt do terminal executa aquele turno em xhigh no Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1 (v2.1.311+; CLAUDE_CODE_DISABLE_ULTRATHINK=1 desativa isso) |
/status |
Mostra o estado da sessão, o modelo e as configurações |
/permissions |
Gerencia as configurações de permissão de forma interativa |
/auto-mode-setup |
Configuração guiada que rascunha entradas de autoMode.environment (campos de confiança e sensibilidade) a partir do seu projeto e das sessões recentes; também no Bedrock, Vertex, Foundry, gateways e com a telemetria desativada (v2.1.304+) |
/config |
Abre a interface completa de configurações; uma linha Idle compaction desativa ou reativa a compactação em inatividade (v2.1.302+) |
/mcp |
Configura servidores MCP. /mcp enable, /mcp disable; /mcp reconnect all tenta novamente todos os servidores que falharam ao conectar ou que precisam de autenticação (v2.1.284+) |
/hooks |
Mostra a configuração de hooks; abre em uma única lista dos seus hooks configurados, agrupados por evento (v2.1.286+) |
/memory |
Mostra e gerencia os arquivos de memória automática |
/copy |
Copia blocos de código. /copy N para a N-ésima resposta mais recente; texto citado é copiado sem os marcadores > (v2.1.295+) |
/resume |
Retoma uma sessão nomeada. /resume 1 ou /resume name; no Pro e no Max, um aviso aparece quando retomar uma conversa inativa consumiria uma parcela perceptível do limite de 5 horas (v2.1.304+) |
/rename |
Nomeia a sessão atual. /rename feature-auth |
/branch |
Ramifica a conversa para exploração paralela |
/fork |
Copia a conversa para uma nova sessão em segundo plano — com linha própria em claude agents (reaproveitado na v2.1.212); a cópia ganha seu próprio worktree a partir da v2.1.221 |
/subtask |
Fork dentro da sessão — o antigo comportamento do /fork com seu novo nome (v2.1.212) |
/list-agents |
Lista todos os agentes aos quais o Claude pode enviar mensagens: subagents, suas outras sessões locais e (com o Remote Control) sessões em outras máquinas (v2.1.224) |
/peers |
Alias de /list-agents (v2.1.224) |
/clear |
Limpa o histórico da conversa |
/plan |
Entra no modo de planejamento. /plan refactor the auth module |
/powerup |
Lições interativas sobre recursos com demonstrações animadas (v2.1.90+) |
/voice |
Alterna o modo de voz push-to-talk |
/loop |
Tarefas recorrentes. /loop 5m /foo executa a cada 5 min |
/schedule |
Cria uma tarefa agendada na nuvem (antes chamada de rotina): de forma conversacional, ou /schedule daily PR review at 9am; alias /routines; exige login no claude.ai com sessões na nuvem habilitadas |
/slides |
Cria uma apresentação do Claude Slides como artefato a partir de um briefing; o beta de templates vem ativado por padrão no Pro, no Max e no Team |
/rewind |
Volta a um checkpoint (ou pressione Esc duas vezes) |
/export |
Exporta a transcrição da conversa |
/add-dir |
Adiciona diretórios de trabalho para ampliar o acesso a arquivos |
/agents |
Removido na v2.1.198 – peça ao Claude para criar ou gerenciar subagents, ou edite .claude/agents/ diretamente; digitar /agents explica para onde o assistente de configuração foi |
/goal |
Define uma condição de conclusão; o Claude continua até a meta ser atingida (v2.1.139+) |
/skills |
Lista as skills instaladas; caixa de busca que filtra conforme você digita (v2.1.121+) |
/skill-doctor |
Mostra quais skills carregadas ficam sem uso e quanto elas custam em contexto (v2.1.261+) |
/bashes |
Lista as tarefas bash em segundo plano |
/tasks |
Lista os agentes em segundo plano |
/theme |
Gerencia temas nomeados (v2.1.118+); plugins incluem um diretório themes/ |
/output-style [name] |
Lista e alterna estilos de saída; descontinuado da v2.1.73 à v2.1.268 em favor do /config, revivido na v2.1.269 – funciona via Remote Control e em sessões na nuvem/headless |
/color |
Define a cor da barra do prompt. /color default para redefinir |
/code-review [effort] |
Encontra bugs de corretude em um nível de esforço opcional; --comment publica comentários inline no PR do GitHub (renomeado de /simplify na v2.1.147). Executa como subagent em segundo plano a partir da v2.1.218. A partir da v2.1.223, /review é um alias deste comando, um /code-review sozinho reutiliza o último nível de esforço que você digitou, e /code-review ultra é a revisão profunda na nuvem. --max-findings <n> ou --max-findings all reporta mais ou menos achados do que o limite habitual e é reutilizado até --max-findings default (v2.1.288+) |
/batch |
Operações em lote |
/security-review |
Revisa o código em busca de vulnerabilidades |
/claude-api |
Cria apps com a Claude API/Anthropic SDK. /claude-api managed-agents-onboard <url> transforma o padrão de Managed Agents de uma página em arquivos ant apply; em vez disso, passe o nome de um quickstart do Console, como deep-researcher, para montar esse template com a CLI ant (v2.1.290+); /claude-api api-version migra o código da API para a versão 2026-10-21 da API (v2.1.307+); managed-agents-secure [<agent-id>] verifica as configurações de um Managed Agent em relação ao guia de implantação segura (v2.1.304+) |
/doctor |
Checkup completo da configuração — diagnostica e corrige problemas (v2.1.205; /checkup é um alias). /doctor prompt-audit (v2.1.283+) audita seus arquivos CLAUDE.md, skills, agentes e comandos em busca de padrões de prompt escritos para modelos mais antigos |
/bug |
Reporta um bug à Anthropic |
/release-notes |
Seletor interativo de versões com changelogs (v2.1.92+) |
/buddy |
Mascote de companhia no terminal — 18 espécies, 5 níveis de raridade, determinístico a partir do ID da conta |
/login / /logout |
Faz login ou sai da conta dentro da sessão |
Comandos personalizados: crie .claude/commands/my-command.md (projeto) ou ~/.claude/commands/my-command.md (pessoal) e invoque com /my-command. Os comandos aceitam frontmatter YAML para descrição, ferramentas permitidas, substituição de modelo e interpolação de argumentos via $ARGUMENTS ou posicionais $1, $2.
---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---
Fix GitHub issue #$ARGUMENTS following our coding standards.
Uso: /fix-issue 123
4. Atalhos de teclado
Controles gerais
| Atalho | Ação |
|---|---|
Ctrl+C |
Cancela a operação atual ou limpa o prompt; Up no prompt vazio traz o rascunho de volta, incluindo colagens e imagens (v2.1.288+), mesmo depois de um comando de barra ou de uma mensagem enviada (v2.1.292+) |
Ctrl+D |
Encerra a sessão (EOF) |
Ctrl+L |
Limpa a tela (mantém o histórico) |
Ctrl+O |
Alterna a saída detalhada |
Ctrl+R |
Pesquisa no histórico de comandos |
Ctrl+V |
Cola uma imagem da área de transferência |
Ctrl+B |
Envia a operação atual para segundo plano |
Ctrl+Enter (ou Ctrl+X Ctrl+S) |
Enviar agora: envia todas as mensagens na fila de uma vez; o texto na fila aparece em cinza até ser recebido (v2.1.275+). Desde a v2.1.281, as ferramentas em execução passam para segundo plano em vez de o turno ser cancelado |
Ctrl+X Ctrl+K |
Interrompe todos os agentes (mudou de Ctrl+F na v2.1.83; a segunda tecla tem uma janela de 3 segundos com aviso de tempo esgotado, v2.1.265+) |
Ctrl+S |
Guarda o rascunho do prompt (stash) |
Ctrl+G |
Abre o editor externo; editores que aceitam número de linha abrem na linha do seu cursor (v2.1.286+) |
Esc Esc |
Reverte a última alteração |
Tab |
Aceita a sugestão do prompt |
! Tab |
Autocompletar do histórico do bash |
Shift+Tab |
Alterna entre os modos de permissão |
Alt+P / Option+P |
Troca de modelo enquanto você digita |
Alt+T |
Alterna o modo de raciocínio (thinking) |
Ctrl+T |
Alterna o realce de sintaxe |
Shift+Down |
Alterna entre os membros da equipe de agentes |
Up/Down |
Navega pelo histórico de comandos |
v |
Modo visual do Vim — seleção por caractere (v2.1.118+; somente no modo vim) |
V |
Modo visual por linha do Vim (v2.1.118+; somente no modo vim) |
% |
Vim: pula para o colchete (), [] ou {} correspondente; d%, c% e y% operam através dele (v2.1.301+; somente no modo vim) |
? |
Mostra os atalhos |
Prefixos rápidos
| Prefixo | Ação | Exemplo |
|---|---|---|
# |
Adiciona à memória persistente | # Always use TypeScript |
/ |
Comando de barra | /review |
! |
Executa bash diretamente | ! git status |
@ |
Referencia um arquivo | @src/index.ts |
& |
Envia a tarefa para a nuvem | & Build the API |
Entrada multilinha
| Método | Teclas |
|---|---|
| Escapar a quebra de linha | \ e depois Enter |
| macOS | Option+Enter |
| iTerm2/WezTerm/Ghostty/Kitty | Shift+Enter |
| Outros terminais | Shift+Enter (execute /terminal-setup primeiro) |
| Caractere de controle | Ctrl+J |
Os atalhos de teclado podem ser personalizados via /keybindings (armazenados em ~/.claude/keybindings.json). A partir da v2.1.284, as ações effortSlider:decreaseEffort, increaseEffort e toggleUltracode reatribuem as teclas de seta e Tab do controle deslizante do /effort.
5. Arquivos de configuração
Hierarquia de precedência (da maior para a menor)
| Nível | Local | Escopo |
|---|---|---|
| Enterprise (bloqueado) | /Library/Application Support/ClaudeCode/managed-settings.json (macOS) |
Todos os usuários, não pode ser sobrescrito |
| Flags da CLI | Argumentos de linha de comando | Sessão atual |
| Projeto local | .claude/settings.local.json |
Pessoal, projeto atual (ignorado pelo git) |
| Projeto compartilhado | .claude/settings.json |
Equipe, versionado no git |
| Global do usuário | ~/.claude/settings.json |
Todos os seus projetos |
| Estado de runtime | ~/.claude.json |
Tokens OAuth, configuração MCP |
A primeira correspondência vence. As configurações enterprise não podem ser contornadas.
6. Referência do Settings.json
Principais configurações com tipos e exemplos. Coloque em qualquer arquivo de configurações da hierarquia acima.
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"model": "claude-sonnet-4-6",
"permissions": {
"allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
"deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
"ask": ["WebFetch", "Bash(docker:*)"],
"defaultMode": "acceptEdits",
"additionalDirectories": ["../shared-lib"]
},
"env": {
"NODE_ENV": "development"
},
"hooks": {},
"sandbox": {
"enabled": false,
"autoAllowBashIfSandboxed": true
},
"cleanupPeriodDays": 30,
"respectGitignore": true,
"showTurnDuration": true,
"language": "en",
"autoMemoryDirectory": ".claude/memory",
"plansDirectory": ".claude/plans"
}
Sintaxe das regras de permissão: Tool(pattern:*) faz correspondência por prefixo. Bash(npm run test:*) permite npm run test, npm run test:unit etc. Padrões de arquivo usam a sintaxe glob: Edit(src/**). A partir da v2.1.214, uma regra allow de segmento único dir/** corresponde apenas a <cwd>/dir — não mais a qualquer dir/ em qualquer lugar da árvore; escreva Edit(**/src/**) para correspondência em qualquer profundidade. As regras deny/ask mantêm a correspondência em qualquer profundidade, e as condições if: de hooks recebem o mesmo escopo de cwd. A partir da v2.1.299, uma regra allow de MCP alcança apenas o servidor que ela nomeia: mcp__a não cobre mais um servidor chamado a__b ou a_; escreva mcp__<server>__* com o nome normalizado completo.
Novas chaves (v2.1.118+):
| Chave | Comportamento |
|---|---|
autoMode.allow $defaults |
Sentinela que adiciona regras personalizadas junto com a lista integrada (também para soft_deny e environment) — v2.1.118+ |
prUrlTemplate |
Template de URL do selo de PR no rodapé — v2.1.119+ |
wslInheritsWindowsSettings |
O WSL herda as configurações gerenciadas do lado do Windows — v2.1.118+ |
skillOverrides |
Oculta ou recolhe skills: off, user-invocable-only ou name-only — v2.1.129+ |
allowAllClaudeAiMcps |
Configuração gerenciada enterprise para carregar os conectores MCP em nuvem do claude.ai junto com o managed-mcp.json — v2.1.149+ |
allowClaudeInChromeWithManagedMcp |
Configuração gerenciada que permite que claude --chrome rode junto com um managed-mcp.json exclusivo – v2.1.282+ |
sandbox.filesystem.disabled |
Pula o isolamento do sistema de arquivos mantendo o controle de saída de rede — v2.1.216+ |
emojiCompletionEnabled |
Autocompletar de códigos de emoji na entrada do prompt (:heart: → ❤️); defina false para desativar — v2.1.217+ |
sandbox.network.strictAllowlist |
Nega hosts fora da lista de permissões para comandos em sandbox sem perguntar — v2.1.219+ |
sandbox.allowNestedUserNamespaces |
Permite que comandos em sandbox no Linux e no WSL2 criem namespaces de usuário (Chromium, podman rootless); isso também permite que eles contornem as proteções de arquivos do sandbox – configurações de usuário ou gerenciadas, v2.1.305+ |
workflowSizeGuideline |
Define a diretriz consultiva de tamanho de workflow dinâmico a partir de qualquer arquivo de configurações; o padrão é medium (“busque menos de 15 agentes”), e a linha do /config fica oculta enquanto uma estiver definida — v2.1.219+ |
enableWorkflows / disableWorkflows |
enableWorkflows liga ou desliga os workflows dinâmicos para você (o botão Dynamic workflows do /config grava essa chave; o padrão é ligado, exceto no Pro); disableWorkflows: true os desliga para todos que suas configurações alcançam, como nas configurações gerenciadas |
syncClaudeAiSkills / syncClaudeAiPlugins |
As skills e os plugins da conta claude.ai sincronizam com as sessões de terminal autenticadas nessa conta; defina false para desativar – v2.1.275+ |
attribution |
Atribuição em commits e PRs; substitui o obsoleto includeCoAuthoredBy. "attribution": false oculta tudo (v2.1.281+), mas versões mais antigas da CLI ignoram um arquivo de configurações que a contenha, então mantenha a forma de objeto (commit, pr, sessionUrl) em arquivos compartilhados entre versões |
maxProseWidth |
Limita a largura da prosa do Claude em terminais largos (número inteiro de colunas, mínimo 40); tabelas e blocos de código mantêm a largura total – v2.1.282+ |
deniedModels |
Gerenciada: bloqueia modelos específicos mesmo quando availableModels os permite; um alias de família como "opus" bloqueia a família inteira – v2.1.283+ |
availableModelsMatch |
Gerenciada: "exact" faz cada entrada de availableModels permitir apenas a versão que ela nomeia, de modo que novos lançamentos continuam bloqueados até serem listados (padrão "prefix") – v2.1.283+ |
allowedProviders |
Gerenciada: limita quais provedores de API uma máquina pode usar (Anthropic API, um endpoint personalizado, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform na AWS ou um gateway Cloud) – v2.1.285+ |
idleCompaction |
false interrompe a compactação ociosa, que compacta uma conversa com mais de 200K tokens deixada ociosa, cerca de 54 minutos antes de o cache de prompt de uma hora expirar (CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ajusta o limite); desde a v2.1.314 ela também roda no VS Code e na aba Code do app desktop, com a telemetria desligada, e no Bedrock, Vertex, Foundry e gateways quando o cache de prompt de uma hora está ativo – lançada na v2.1.299; a documentação data a chave como v2.1.290+ |
advisorModel |
Modelo advisor salvo (fable, opus, sonnet ou um ID completo); /advisor grava nas configurações de usuário, --advisor sobrescreve por sessão, CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 desliga a ferramenta |
permissions.blockWritesOutsideWorkingDirectories |
Write, Edit e NotebookEdit recusam caminhos fora dos diretórios de trabalho em todos os modos de permissão, inclusive bypassPermissions; comandos de shell, ferramentas MCP e hooks não são limitados, e as ferramentas EnterWorktree e ExitWorktree desaparecem enquanto ela está ativa. Qualquer arquivo de configurações pode ativá-la; nenhum pode desativá-la – v2.1.314+ |
disableRemoteControl |
Recusa claude remote-control, --remote-control, o início automático e o botão dentro da sessão; qualquer arquivo de configurações, configurações gerenciadas para imposição via MDM. /remote-control nomeia a configuração quando ela está definida (v2.1.317+) |
Para o esquema completo de configurações, consulte o Mergulho profundo na configuração no guia completo.
7. Referência rápida do CLAUDE.md
CLAUDE.md é o arquivo de instruções do seu projeto. O Claude o lê no início de cada sessão.
Onde ele fica:
| Local | Escopo |
|---|---|
CLAUDE.md (raiz do projeto) |
Todos os usuários, todas as sessões neste projeto |
.claude/CLAUDE.md |
O mesmo, em local alternativo |
~/.claude/CLAUDE.md |
Pessoal, todos os projetos |
AGENTS.md (v2.1.277+): em um projeto sem CLAUDE.md, o Claude Code lê AGENTS.md no lugar dele – altere o comportamento em “Project instructions” no /config (ainda não disponível no Bedrock/Vertex/Foundry).
O que incluir:
# Project Name
## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5
## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`
## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands
## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models
Mantenha-o fácil de escanear. Prosa densa desperdiça tokens de contexto a cada sessão. Use listas com marcadores, tabelas e blocos de código curtos. Evite parágrafos longos — o Claude lê o CLAUDE.md no início de cada sessão, então cada palavra custa contexto.
Dicas avançadas:
- Use o prefixo # no REPL para adicionar coisas à memória automática sem editar o CLAUDE.md: # Always use TypeScript strict mode
- O CLAUDE.md em subdiretórios é carregado quando o Claude lê arquivos nesse diretório
- Regras compartilhadas pela equipe vão em .claude/rules/*.md para uma organização modular
8. Modos de permissão
| Modo | Comportamento | Caso de uso |
|---|---|---|
default / manual — rotulado “Manual” (v2.1.200+) |
Pergunta no primeiro uso de cada ferramenta | Desenvolvimento normal |
acceptEdits |
Aprova edições de arquivos automaticamente, pergunta para bash | Projetos confiáveis |
auto |
Um classificador (Sonnet 5 desde a v2.1.210, originalmente Sonnet 4.6) revisa a segurança de cada ação | Autônomo com salvaguardas |
plan |
Somente leitura — nenhuma edição ou execução permitida | Apenas análise e planejamento |
bypassPermissions |
Pula todos os prompts | Automação de CI/CD |
Auto Mode (v2.1.85+) é o modo inicial integrado para sessões interativas no terminal e no VS Code em todos os planos e provedores: a v2.1.283 o estendeu a provedores de terceiros e a sessões com telemetria desativada, e a v2.1.284 a todos os planos e provedores; antes disso, ele era o padrão apenas no Pro, Max e Team (desde 14 de agosto de 2026). Da v2.1.285 à v2.1.301, sessões claude -p e do Python Agent SDK em provedores de terceiros ou com telemetria desativada também iniciavam em auto mode quando nenhum modo de permissão estava configurado; a v2.1.302 reverte isso: uma sessão claude -p ou do Agent SDK sem modo de permissão inicia em Manual em provedores de terceiros, com telemetria desativada e em uma instalação nova, como sempre fez onde os feature flags são obtidos, e --permission-mode auto mantém o auto.13 permissions.defaultMode sobrescreve o padrão integrado ("default" fixa o Manual), e disableAutoMode o desativa em toda a organização. Ele é o substituto recomendado para --dangerously-skip-permissions. Operações somente leitura e edições de arquivos são aprovadas automaticamente; desde a v2.1.281, onde a revisão do classificador roda no servidor, comandos de shell somente leitura e em sandbox também aguardam por ela e são bloqueados quando ela os sinaliza. Regras personalizadas de allow/deny são resolvidas primeiro. Todo o resto vai para o classificador de segurança. Bloqueados automaticamente por padrão: curl | bash, force-push para main, deploys em produção, exclusões em massa na nuvem, alterações de IAM, envio de dados sensíveis para fora.1
Disjuntor: 3 bloqueios consecutivos ou 20 no total em uma sessão pausam e voltam ao prompt manual.
O prompt do auto mode antes de uma leitura fora dos diretórios de trabalho oferece Yes, but ask again next time (v2.1.284+): permite aquela leitura específica e continua perguntando sobre as próximas.
rm perigoso em modos não assistidos (v2.1.281): no auto mode e com --dangerously-skip-permissions, o prompt de rm perigoso aguarda 2 minutos e então nega o comando com uma dica de reescrita para que a sessão continue. Um rm recursivo cujo alvo é apenas a saída de uma substituição de comando, como rm -rf "$(pwd)", agora pergunta mesmo com uma regra de permissão para o Bash.
# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto
# Cycle during session
Shift+Tab # Manual (aka default) -> acceptEdits -> auto -> plan
Mudanças de permissão (v2.1.288-290): pyright não é mais tratado como somente leitura e pergunta antes, assim como mais formas de ps (v2.1.290). Os arquivos de configurações de um projeto não podem mais ativar o Claude no Chrome; use --chrome, /chrome ou suas configurações de usuário (v2.1.290). O classificador do auto mode no lado do cliente ignora um pin de ANTHROPIC_DEFAULT_SONNET_MODEL que nomeie o Sonnet 5.5 ou o Opus 5.5 e usa o Claude Sonnet 5 (v2.1.288).
Aprovação automática do PowerShell (v2.1.119+): os comandos da ferramenta PowerShell são aprovados automaticamente no modo de permissão da mesma forma que os comandos do Bash. Regras de permissão como PowerShell(Get-*:*) dispensam os prompts para operações somente leitura. Use a v2.1.149+ em fluxos de trabalho pesados em PowerShell; ela corrige bypasses de permissão do cd integrado, a correspondência de regras de permissão por prefixo/curinga e o rastreamento desatualizado de variáveis de diretório.
9. Eventos de hooks
| Evento | Quando dispara | Pode bloquear? |
|---|---|---|
PreToolUse |
Antes de a ferramenta executar | Sim |
PostToolUse |
Depois que a ferramenta conclui | Não |
PostToolUseFailure |
Depois que a ferramenta falha | Não |
UserPromptSubmit |
O usuário envia um prompt | Sim |
Stop |
O Claude termina a resposta | Sim |
SubagentStart |
Um subagent é criado | Não |
SubagentStop |
Um subagent conclui | Sim |
SessionStart |
A sessão começa | Não |
SessionEnd |
A sessão é encerrada | Não |
Notification |
Um alerta é disparado | Não |
| InstructionsLoaded | CLAUDE.md carregado | Não |
| ConfigChange | O arquivo de configuração muda no meio da sessão | Sim |
| DirectoryAdded | /add-dir ou o register_repo_root do SDK adiciona um diretório de trabalho no meio da sessão (v2.1.219+) | Não |
| WorktreeCreate | Worktree sendo criado | Sim |
| WorktreeRemove | Worktree sendo removido | Não |
| PreCompact | Antes da compactação do contexto | Não |
| PostCompact | Depois da compactação do contexto | Não |
| Elicitation | O MCP solicita entrada estruturada | Sim |
| ElicitationResult | O usuário responde ao diálogo do MCP | Sim |
| StopFailure | O turno termina por erro de API | Não |
| PermissionRequest | Diálogo de permissão exibido | Sim |
| PermissionDenied | O auto mode nega uma ação (v2.1.88+) | Não |
| CwdChanged | O diretório de trabalho muda (v2.1.83+) | Não |
| FileChanged | Arquivo monitorado modificado externamente (v2.1.83+) | Não |
| TaskCreated | Nova tarefa criada (v2.1.84+) | Não |
| TeammateIdle | Um membro da equipe de agentes fica ocioso | Sim |
| TaskCompleted | Tarefa marcada como concluída | Sim |
Para o protocolo completo de hooks (JSON de entrada/saída, matchers, códigos de saída), veja Hooks em profundidade no guia completo.
10. Configuração de hooks
Os hooks ficam em settings.json ou em um hooks.json dedicado. Exemplo mínimo:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "npx prettier --write \"$FILE_PATH\""
}
]
}
],
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": ".claude/hooks/validate-bash.sh"
}
]
}
]
}
}
Sintaxe de matchers:
| Padrão | Corresponde a |
|---|---|
* |
Todas as ferramentas |
Bash |
Apenas Bash |
Edit\|Write |
Edit ou Write |
mcp__github |
Ferramentas de servidores MCP |
"" (vazio) |
Eventos sem ferramentas (por exemplo, UserPromptSubmit) |
Códigos de saída:
| Código | Significado |
|---|---|
0 |
Sucesso — a operação prossegue |
2 |
Bloqueio — a operação para, e o stderr é enviado ao Claude |
1, 3+ |
Aviso não bloqueante; um hook com "onFailure": "block" (v2.1.295+) bloqueia em vez disso, como o exit 2 faz |
Hooks assíncronos rodam em segundo plano sem bloquear: adicione "async": true ao objeto do hook.2 Hooks de prompt e de agente rodam no máximo 12 de um mesmo evento por vez desde a v2.1.302; os demais aguardam sua vez.13
Campos de saída/entrada de hooks:
duration_msna entrada dos hooksPostToolUse/PostToolUseFailure(v2.1.119+) — tempo de execução da ferramenta, excluindo prompts de permissão e hooks PreToolUse.hookSpecificOutput.updatedToolOutput(v2.1.121+) — substitui a saída de qualquer ferramenta (a v2.1.118 introduziu isso apenas para MCP; a v2.1.121 estende a todas as ferramentas).hookSpecificOutput.sessionTitle(v2.1.96+) — define o título da sessão a partir de um hookUserPromptSubmit.args: string[]em hooks de comando (v2.1.139+) — passa um argv estruturado sem escape de shell.- Limites de hooks de skills (v2.1.304+): as skills de uma mesma origem (um repositório, sua própria pasta ou um plugin) podem registrar no máximo 1.024 hooks e 16.384 caracteres de matcher por sessão; o hook
oncede uma skill não remove mais o hook idêntico de outra skill. continueOnBlockem hooksPostToolUse(v2.1.139+) — devolve o motivo do bloqueio ao Claude e continua o turno.subagent_typena entrada de hooks de agente (v2.1.140+) — identifica qual tipo de agente está em execução.terminalSequencena saída JSON do hook (v2.1.141+) — emite sequências de controle do terminal para notificações, títulos de janela e sinais sonoros.onFailure: "block"em hooks de comando e HTTP (v2.1.295+) – um hook que não consegue iniciar, excede o tempo limite, sai com um código diferente de 0 ou 2, recebe um erro HTTP ou imprime JSON inválido bloqueia a ação (o que o exit 2 faz naquele evento; uma negação noPermissionRequest). O padrão é"continue"; ignorado emStop,SubagentStop,TaskCompleted,TeammateIdlee hooks assíncronos.
11. Configuração rápida do MCP
Adicione um servidor MCP com um único comando:
# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
--header "Authorization: Bearer $TOKEN"
# Local stdio server
claude mcp add --transport stdio postgres \
--env "DATABASE_URL=postgresql://user:pass@localhost/db" \
-- npx -y @anthropic-ai/mcp-server-postgres
Controle de escopo:
claude mcp add --scope project ... # Team-shared (.mcp.json)
claude mcp add --scope user ... # Personal (~/.claude.json)
Exemplo de .mcp.json do projeto:
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"database": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost/db"
}
}
}
}
O MCP agora tem 100 milhões de downloads mensais e mais de 3.000 servidores indexados.3 Para saber mais sobre tipos de transporte, elicitação e configuração da busca de ferramentas, consulte a seção sobre MCP no guia completo.
alwaysLoad (v2.1.121+): Desative o carregamento adiado pelo Tool Search para um servidor confiável. Todas as ferramentas dele são carregadas no início da sessão, sem uma chamada adicional ao ToolSearch:
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
"alwaysLoad": true
}
}
}
alwaysLoad: false (v2.1.287+) faz o contrário: todas as ferramentas desse servidor aguardam a busca de ferramentas para serem carregadas.
Novas tentativas automáticas (v2.1.121+): A conexão com servidores MCP que apresentam erros durante a inicialização é tentada novamente até 3 vezes antes de eles serem marcados como desconectados.
Solicitações de URL (v2.1.287+): Servidores MCP que usam o protocolo 2025-11-25 podem abrir solicitações de URL, por exemplo, para fazer login. Se um servidor parar de se conectar após a atualização, adicione "bareElicitationCapability": true à entrada dele na configuração do MCP.
SDK mcp_authenticate redirectUri (v2.1.121+): Obrigatório para concluir o OAuth com esquemas de URI personalizados — aplicativos de desktop e fluxos de conectores do claude.ai.
11.5. Comandos de plugins na CLI
| Comando | Comportamento |
|---|---|
claude --plugin-url <url> |
Baixa um arquivo .zip de plugin para a sessão atual (v2.1.129+) |
claude --plugin-dir <path> |
Carrega um diretório de plugin, arquivo .zip ou pasta de plugins – cada subpasta com um manifesto é carregada (.zip v2.1.128+, modo de pasta v2.1.265+) |
claude plugin prune |
Remove plugins instalados automaticamente cujo plugin pai não está mais presente (v2.1.121+) |
claude plugin uninstall <name> --prune |
Desinstala e remove em cascata as dependências órfãs instaladas automaticamente (v2.1.121+) |
claude plugin tag |
Cria tags git de lançamento com validação de versão (v2.1.118+) |
claude plugin eval |
Executa a suíte de avaliações de um plugin: resultados com pontuação e reproduzíveis, relatório em JSON + HTML (v2.1.269+) |
claude plugin eval --disallow-tools <names> |
Exclui das execuções de avaliação as ferramentas integradas especificadas, como Agent (também aceita disallowed_tools em um caso); uma execução que termina com um erro de API recebe pontuação 0 e reprova a suíte (v2.1.299+) |
claude plugin configure <plugin> |
Mostra as opções de um plugin e quais não estão definidas; --values-stdin salva novos valores lidos de stdin (v2.1.285+) |
claude plugin install <plugin> --config <server>.<key>=<value> |
Define as configurações próprias de um servidor MCP incluído no pacote .mcpb durante a instalação, para que ele inicie sem precisar acessar /plugin → Configurar (v2.1.285+) |
claude plugin install <plugin> --marketplace <source> |
Adiciona o marketplace, se necessário, com as mesmas verificações de política de claude plugin marketplace add, e depois instala o plugin a partir dele (v2.1.292+) |
claude plugin validate |
Valida um plugin antes da publicação; a v2.1.281 adiciona verificações de MCP (entradas de .mcp.json que seriam descartadas silenciosamente no carregamento, referências ${user_config.*} não declaradas, URLs inseguras) e um aviso sobre ${CLAUDE_PLUGIN_ROOT} sem aspas em um hook no formato shell |
/plugin install <plugin> --marketplace <source> |
Instala durante a sessão a partir de um marketplace que você ainda não adicionou – oferece adicioná-lo primeiro (v2.1.275+) |
/plugin enable cc-plugin-you-should-know@builtin |
Ativa You should know, um mod integrado cujo agente auxiliar aponta coisas que você ou o Claude podem deixar passar (v2.1.287+; sessões próprias do provedor com telemetria ativada) |
Mods (v2.1.287+): um mod é um plugin cujos manipuladores de JavaScript ou TypeScript são executados dentro do Claude Code: ele pode desenhar painéis, adicionar comandos e observar ou alterar chamadas de ferramentas. Os mods ficam ativados por padrão; --safe-mode os desativa por uma sessão e "disableAllHooks": true em todas as sessões, mas nenhuma dessas opções desativa os mods integrados.8
Servidores LSP (v2.1.288+): uma entrada de servidor LSP aceita requestTimeout em milissegundos (padrão 60000), de modo que um servidor que nunca responde faz a solicitação falhar após 60 segundos, em vez de ficar travada.
12. Tipos de subagents
| Tipo | Modelo padrão | Modo | Uso |
|---|---|---|---|
| Explore | Herda o modelo da sessão, limitado ao Opus (v2.1.198+; antes era Haiku) | Somente leitura | Pesquisar na base de código, encontrar arquivos e entender a estrutura |
| General-purpose | Herda o modelo principal | Leitura e escrita completas | Tarefas complexas de pesquisa + modificação |
| Plan | Herda o modelo principal | Somente leitura | Planejar implementações antes da execução |
| Personalizado | Configurável | Configurável | Trabalho específico de um domínio (revisão de segurança, testes etc.) |
O Claude delega automaticamente para subagents. Você também pode solicitá-los explicitamente:
> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema
Subagents personalizados são definidos em .claude/agents/ (projeto) ou ~/.claude/agents/ (pessoal) como arquivos markdown com frontmatter em YAML. Por padrão, até 20 subagents são executados simultaneamente; CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS altera esse limite.4 A partir da v2.1.292, a ferramenta Agent aceita um parâmetro effort, então você pode pedir ao Claude para executar um subagent com um nível de esforço específico, e os nomes de agentes são limitados a 256 caracteres (um name mais longo em um arquivo de skill ou plugin é ignorado). A partir da v2.1.302, os subagents do tipo fork (subagent_type: "fork") ficam ativados por padrão em claude -p, no Agent SDK, no aplicativo de desktop e no VS Code, além do terminal (CLAUDE_CODE_FORK_SUBAGENT=0 os desativa; claude mcp serve nunca os disponibiliza), e o aplicativo de desktop e o VS Code sempre executam os subagents da conversa principal em segundo plano.13
claude agents abre o Agent View nas versões atuais: uma tela de operações em prévia de pesquisa para sessões do Claude Code em execução, bloqueadas e concluídas. claude agents --cwd <path> limita a visualização a um diretório (v2.1.141+), a v2.1.142 adiciona flags de despacho para sessões em segundo plano e a v2.1.143 aplica essas flags de forma consistente ao painel e às sessões em segundo plano: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort e --dangerously-skip-permissions. A v2.1.144 adiciona suporte a /resume para sessões em segundo plano e as identifica com bg; a v2.1.145 adiciona claude agents --json, contagens nas abas de sessões aguardando entrada e correções no painel de respostas do Agent View; a v2.1.147 adiciona sessões fixadas em segundo plano que permanecem ativas quando ociosas e reiniciam no mesmo lugar para receber atualizações; a v2.1.287 adiciona um filtro n:<text> que busca correspondências em nomes de sessões e tarefas; a v2.1.288 adiciona Ctrl+F para encontrar uma sessão pelo nome e Alt+Up / Alt+Down para alternar entre grupos, ambos reconfiguráveis em keybindings.json (agents:find para Ctrl+F). Use o Agent View para monitoramento, não como prova de que o trabalho passou pelas verificações de qualidade.6
Campos de frontmatter de agentes personalizados:
| Campo | Finalidade |
|---|---|
name |
Identificador único (letras minúsculas, hífens) |
description |
Quando invocar (inclua “PROACTIVELY” para delegação automática) |
tools |
Lista de ferramentas separadas por vírgulas. Aceita Agent(Explore) para restringir os tipos que podem ser criados |
disallowedTools |
Ferramentas a bloquear no conjunto herdado |
model |
opus, sonnet, haiku ou inherit (padrão) |
permissionMode |
default/manual, acceptEdits, plan, bypassPermissions etc. |
maxTurns |
Número máximo de turnos do agente |
background |
true para sempre executar como tarefa em segundo plano |
isolation |
worktree para uma cópia isolada em um worktree git |
skills |
Skills pré-carregadas no contexto na inicialização; os primeiros 32 nomes distintos (v2.1.295+) |
autoCompactWindow |
Compacta automaticamente este subagent antes do limite da janela da conversa principal, em tokens (v2.1.296+) |
Exemplo de agente personalizado (.claude/agents/security-reviewer.md):
---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---
You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.
13. Variáveis de ambiente
Autenticação e API
| Variável | Finalidade |
|---|---|
ANTHROPIC_API_KEY |
Autenticação direta pela API |
ANTHROPIC_AUTH_TOKEN |
Cabeçalho de autorização personalizado |
ANTHROPIC_CUSTOM_HEADERS |
Cabeçalhos de requisição adicionais |
| ### Configuração de modelo | |
| Variável | Finalidade |
| ---------- | --------- |
ANTHROPIC_MODEL |
Substitui o modelo padrão |
CLAUDE_CODE_SUBAGENT_MODEL |
Modelo dos subagents; a v2.1.147 corrige a propagação para os processos dos integrantes de equipes de agentes |
CLAUDE_CODE_SUBAGENT_EFFORT |
Nível de esforço em que os subagents rodam quando nada mais define um, em vez de herdar o da sessão (v2.1.316+); um subagent em outro modelo usa o esforço salvo desse modelo ou o padrão dele (v2.1.317+) |
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 |
Desativa a ferramenta advisor: /advisor fica indisponível, advisorModel é ignorado e --advisor é aceito, mas não faz nada |
CLAUDE_CODE_DISABLE_ULTRATHINK=1 |
Desativa a palavra-chave ultrathink; desde a v2.1.311 ela executa o turno do terminal em xhigh (v2.1.316+) |
CLAUDE_CODE_DISABLE_WORKFLOWS=1 |
Desativa os workflows dinâmicos por uma sessão; equivale a "disableWorkflows": true, e, seja qual for o lado que os desativou, o outro não consegue reativá-los. Os workflows vêm ativados por padrão, exceto no Pro, onde "enableWorkflows": true (a opção Dynamic workflows do /config) os ativa; o opt-in CLAUDE_CODE_WORKFLOWS=1 da v2.1.147 não aparece mais na referência de variáveis de ambiente |
MAX_THINKING_TOKENS |
Ativa o extended thinking |
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
Limita o tamanho da saída |
| ### Provedores de nuvem | |
| Variável | Finalidade |
| ---------- | --------- |
CLAUDE_CODE_USE_BEDROCK=1 |
Usa o AWS Bedrock |
CLAUDE_CODE_USE_VERTEX=1 |
Usa o Google Vertex AI |
CLAUDE_CODE_USE_FOUNDRY=1 |
Usa o Microsoft Foundry |
VERTEX_REGION_CLAUDE_HAIKU_5_5 |
Região do Vertex para o Claude Haiku 5.5 (v2.1.293+) |
ANTHROPIC_BEDROCK_SERVICE_TIER=priority |
Nível de serviço do Bedrock — default/flex/priority (v2.1.122+); enviado como X-Amzn-Bedrock-Service-Tier |
ENABLE_TOOL_SEARCH=true |
Ativa o Tool Search no Vertex AI (v2.1.119+; ali ele vem desativado por padrão). Atrás de um ANTHROPIC_BASE_URL personalizado, o tool search vem ativado por padrão desde a v2.1.304, e um 400 ou 422 do gateway é repetido sem ele (a v2.1.305 corrigiu a regressão que fazia toda requisição falhar em provedores que o rejeitam); um gateway que recusa blocos tool_reference recebe a requisição de novo sem tool search, e a sessão se lembra disso (v2.1.314+) |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 |
Ativa a descoberta de modelos via /v1/models do gateway para o seletor /model (v2.1.129+) |
CLAUDE_CODE_AUTO_MODE_SERVER=0 |
Desativa o classificador de auto mode do lado do servidor (o classificador local então passa a contar no uso); =1 ativa. O lado do servidor é o padrão no Bedrock/Vertex/Foundry e em gateways desde a v2.1.278, sem cobrança pela sobrecarga do classificador, e em uma conexão direta com a API da Anthropic com a telemetria desligada desde a v2.1.282; desde a v2.1.281 a variável também vale em uma conexão direta com a API da Anthropic (=1 era o opt-in das v2.1.273-277, quando o local era o padrão) |
CLAUDE_CODE_AUTO_MODE_MODEL |
Modelo que o classificador de auto mode do lado do cliente usa; sem efeito no auto mode do lado do servidor (v2.1.302+) |
CLAUDE_CODE_MODEL_CATALOG=off |
Impede que sessões no Bedrock, Mantle, Vertex AI e Foundry carreguem configurações de modelo do arquivo assinado em downloads.claude.ai (v2.1.311+) |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 |
Mantém o system prompt completo (=1 usa o mais curto em qualquer modelo); desde a v2.1.312, Bedrock, Mantle, Vertex AI e Foundry usam o prompt mais curto para nomes de modelo que o Claude Code não reconhece, mesmo quando por trás deles está um Sonnet ou um Haiku |
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 |
Desativa a troca automática de modelo depois que um classificador de segurança sinaliza uma requisição (a configuração switchModelsOnFlag); desde a v2.1.312 ela também cobre nomes de modelo que o Claude Code não reconhece |
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1 |
Para de enviar structured outputs, para o Mantle ou um gateway que os rejeite (títulos de sessão, recuperação de memória e prompt hooks falhavam ali antes, v2.1.288+) |
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 |
Envia os cabeçalhos de dica x-claude-code-* a um gateway de LLM ou a um provedor de terceiros (v2.1.273+; a v2.1.283 adiciona x-claude-code-prompt-id, que agrupa as requisições que atendem a um mesmo prompt). Uma conexão direta com a API da Anthropic os envia por padrão; =0 os desativa em todo lugar |
| ### Controle de comportamento | |
| Variável | Finalidade |
| ---------- | --------- |
DISABLE_AUTOUPDATER=1 |
Impede atualizações automáticas |
DISABLE_UPDATES=1 |
Bloqueia todos os caminhos de atualização, inclusive o claude update manual (v2.1.118+, mais restrito que DISABLE_AUTOUPDATER) |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 |
Instalações via Homebrew/WinGet executam as atualizações do gerenciador de pacotes em segundo plano e pedem para reiniciar (v2.1.129+) |
CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 |
Clona fontes de plugins do GitHub via HTTPS em vez de SSH quando não há chaves SSH disponíveis (v2.1.141+) |
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE |
Removida — sem efeito desde a v2.1.160. O fast mode agora é /model <model> seguido de /fast on |
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP |
Substitui o limite da v2.1.143+ que encerra um turno com um aviso após repetidos stop hooks bloqueantes |
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1 |
Desativa o comportamento -ExecutionPolicy Bypass do PowerShell introduzido na v2.1.143+ |
CLAUDE_CODE_USE_POWERSHELL_TOOL=0 |
Desativa a ferramenta PowerShell onde a v2.1.143 a ativa por padrão para usuários do Bedrock, Vertex e Foundry |
DISABLE_TELEMETRY=1 |
Desativa a telemetria de uso |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 |
Desativa o tráfego não essencial: atualizações automáticas, telemetria, relatório de erros, /feedback, notas de versão, busca de feature flags (o que também desativa o Remote Control); desde a v2.1.290 pula também o aquecimento da conexão na inicialização. 0 ou false continuam desativando; remova a variável para permitir |
CLAUDE_CODE_ATTRIBUTION_HEADER=0 |
Omite o bloco de atribuição do system prompt; atrás de um gateway de apps do Claude, defina-a no env da política code ou cli (v2.1.299+) |
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH |
Limite de truncamento dos atributos de conteúdo do OTel (padrão 60 KB, v2.1.214+) |
CLAUDE_CODE_ENABLE_TELEMETRY, variáveis de exportador OTEL_* e de conteúdo OTEL_LOG_* |
Ignoradas nas configurações de projeto e locais desde a v2.1.282, exceto valores que desligam a telemetria; defina-as no seu shell, nas configurações de usuário ou nas configurações gerenciadas. /status e claude doctor listam os nomes ignorados |
DISABLE_COST_WARNINGS=1 |
Oculta os avisos de custo |
DISABLE_PROMPT_CACHING=1 |
Desativa o prompt caching globalmente |
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 |
Mantém todo modelo nativamente de 1M em 200K via compactação automática (a v2.1.223 ampliou isso para além de uma lista fixa). Desde a v2.1.285, sessões atrás de um ANTHROPIC_BASE_URL personalizado usam a janela de 1M dos modelos que a têm (Opus 4.7+, Sonnet 5+, Fable); execute /autocompact 200k se o seu gateway para em 200K. Desde a v2.1.287, Opus 4.7+ e Fable também rodam com 1M por padrão no Bedrock, Vertex, Foundry e no gateway de apps do Claude, sem o sufixo [1m]; esta variável os mantém em 200K |
CLAUDE_CODE_AUTO_COMPACT_WINDOW |
Janela de compactação automática em tokens, de 100000 a 1000000; os sufixos k e M funcionam desde a v2.1.304 (200k definia silenciosamente uma janela de 100K); valores fora do intervalo geram um aviso |
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1 |
Permite que claude ultrareview rode em uma pasta não confiável onde ele não pode perguntar, como em CI; defina-a no ambiente que faz o lançamento, não em um bloco env das configurações (v2.1.309+) |
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS |
Tamanho de contexto a partir do qual a compactação ociosa se aplica, padrão 200000; valores abaixo de 100000 são elevados a 100000; "idleCompaction": false desativa o recurso (v2.1.299; a documentação diz v2.1.290+) |
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 |
Permite que IDs de modelo não reconhecidos excedam a janela de contexto presumida (v2.1.223) |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1 |
Remove as instruções embutidas de commit/PR |
CLAUDE_CODE_DISABLE_WEB_FETCH=1 |
Desativa a ferramenta WebFetch (v2.1.285+) |
CLAUDE_CODE_DISABLE_ARTIFACT=1 |
Desativa a ferramenta Artifact por uma sessão; nenhum arquivo de configurações a reativa enquanto a variável estiver definida ("enableArtifact": false faz o mesmo a partir das configurações ou da linha Artifacts em /config) |
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 |
Não abre o navegador quando um novo artifact é publicado |
CLAUDE_CODE_MAX_TURNS |
Limita os turnos agênticos quando nenhum --max-turns é passado; a flag prevalece quando ambos estão definidos |
CLAUDE_CODE_SKIP_PROMPT_HISTORY=1 |
Não grava histórico de prompts nem transcrição; a sessão nunca aparece em --resume, --continue nem no histórico da seta para cima (execuções efêmeras por script) |
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC=1 |
Em uma sessão longa com -p ou com o Agent SDK, descarta o histórico pré-compactação de uma transcrição acima de 5 MB após cada compactação; o resume ainda restaura a conversa; somente via ambiente (v2.1.287+) |
CLAUDE_CODE_SYNC_SKILLS=1 |
Faz uma execução -p baixar as skills habilitadas para a sua conta claude.ai e aguardar a lista antes da primeira consulta; com a busca de feature flags desligada, reutiliza uma lista de até 10 minutos atrás obtida por outra sessão (v2.1.311+) |
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 |
Em um runner auto-hospedado, permite que um claude -p executado dentro de uma sessão compartilhe o ID e a transcrição dessa sessão, como antes da v2.1.317 (v2.1.317+) |
CLAUDE_CODE_DISABLE_CFC_PROMPT=1 |
Mantém as ferramentas do Claude in Chrome, mas deixa a seção do Chrome fora do prompt do sistema; no VS Code (v2.1.314+), também fora das mensagens da sessão (v2.1.257+) |
FORCE_HYPERLINK |
1 força a ativação de links de terminal OSC 8 onde a detecção falha; 0, false, no ou off os renderiza como texto simples (antes da v2.1.314, as três palavras ativavam os links) |
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES |
Limita os reenvios de uma requisição de fallback sem streaming que expirou por timeout (v2.1.285+) |
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS |
Atraso inicial do backoff para requisições sobrecarregadas (erro 529), padrão 500 ms, aceita 500-32000; sem efeito sob o watchdog de novas tentativas ou no modo rápido (v2.1.292+) |
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS |
Teto desse backoff em milissegundos, padrão 32000 (v2.1.296+) |
CLAUDE_CODE_RETRY_WATCHDOG=1 |
Sessões sem supervisão: repete indefinidamente as tentativas após erros de capacidade 429 e 529, com backoff de até 5 minutos ou até o limite ser redefinido (v2.1.186+) |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS |
Limite por requisição de quanto tempo o watchdog aguarda durante erros 429 e 529; não definida significa sem limite (v2.1.295+) |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS |
Sob o watchdog, encerra uma requisição que atingiu um limite de uso cuja redefinição está mais distante do que este valor, em vez de aguardar (v2.1.301+) |
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS |
Intervalo mínimo entre verificações de que um limite de uso foi liberado antes da sua redefinição enquanto o watchdog aguarda por ele (v2.1.305+) |
CLAUDE_CODE_DISABLE_ATTACHMENTS=1 |
Envia menções de arquivo com @ como texto simples em vez de expandi-las. A partir da v2.1.290, o .claude/settings.json ou .claude/settings.local.json de um repositório não pode mais defini-la; o shell e as configurações de usuário e gerenciadas ainda podem |
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1 |
Entrega ao Claude o caminho de uma menção @ para ler com suas ferramentas de arquivo, em vez do conteúdo do arquivo, para que hooks PreToolUse vejam a leitura; apenas shell e configurações de usuário e gerenciadas (v2.1.299+) |
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS |
Milissegundos até que um diálogo encaminhado a um cliente remoto (Remote Control, um host do SDK) seja cancelado; sobrepõe dialogExpiry, 0 desativa. Um valor com sufixo de unidade, como 5m, recai em dialogExpiry a partir da v2.1.290 (antes era lido como 5 ms) |
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 |
Mantém o prompt de rm perigoso aguardando no modo automático e em --dangerously-skip-permissions, em vez de negar após 2 minutos (v2.1.281+) |
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1 |
Pula o prompt de um rm recursivo cujo alvo é apenas a saída de uma substituição de comando, como rm -rf "$(pwd)" (v2.1.281+) |
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 |
Continua exibindo o prompt para um rm montado em tempo de execução dentro de um script shell -c que o Claude Code não consegue ler; por padrão, esses scripts não exibem mais o prompt (v2.1.299+) |
CLAUDE_CODE_HIDE_CWD=1 |
Oculta o diretório de trabalho no logotipo de inicialização (v2.1.119+) |
CLAUDE_CODE_FORK_SUBAGENT=0 |
Desativa os subagents fork; ativados por padrão no terminal e, desde a v2.1.302, em claude -p, no Agent SDK, no aplicativo desktop e no VS Code (=1 era o opt-in para builds externos a partir da v2.1.117; claude mcp serve nunca os oferece) |
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 |
Força a saída sincronizada do terminal quando a detecção automática falha (v2.1.129+) |
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 |
Inclui texto + raciocínio dos subagents na saída stream-json; combina com --forward-subagent-text (v2.1.211+) |
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION |
Limite de WebSearch por sessão (padrão 200, v2.1.212+). A partir da v2.1.290, as sessões interativas reabastecem seu orçamento de WebSearch com o tempo, em vez de parar após 200 chamadas |
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR |
Taxa de reabastecimento do orçamento de WebSearch da sessão interativa (padrão 100 chamadas por hora; 0 desativa o reabastecimento, v2.1.290+) |
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION |
Limite de criação de subagents por sessão (padrão 200; /clear redefine o orçamento, v2.1.212+) |
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS |
Limite de subagents em execução simultânea (padrão 20; distinto do total por sessão acima, v2.1.217+) |
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS |
Escalonamento do fan-out de Workflow para reutilização do cache de prompt; 0 desativa (v2.1.229+) |
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL |
Executa todos os agentes de workflow em um único modelo enquanto os demais subagents mantêm o seu (v2.1.296+) |
CLAUDE_CODE_TOOL_MEMORY_LIMIT |
Cgroup de memória do Linux (MB) opcional para comandos da ferramenta Bash (v2.1.233+) |
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS |
TTL do cache de sessão por URL do WebFetch, padrão 15 min (v2.1.233+) |
CLAUDE_CODE_ENABLE_TODO_TOOLS |
Restaura as ferramentas de todo/tarefas no Opus 4.8+/Sonnet 5+/Fable 5+, desativadas por padrão desde a v2.1.233 |
CLAUDE_CODE_PROJECT_DIR_NAME |
Nome curto do diretório de transcrições por projeto para hosts com diretórios de configuração por sessão (v2.1.234+) |
CLAUDE_CODE_GOAL_CHECKIN_MINUTES |
Verifica tarefas em segundo plano que travam um /goal por este tempo; 0 desativa (v2.1.234+, padrão 30) |
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH |
Profundidade de criação de subagents aninhados — padrão 3 a partir da v2.1.219; defina 1 para desativar o aninhamento. Histórico do padrão: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219), então defina-a explicitamente |
CLAUDE_AX_SCREEN_READER=1 |
Ativa o modo de leitor de tela; igual a --ax-screen-reader (v2.1.208+) |
CLAUDE_AX_PREPARK_MS |
Milissegundos que o modo de leitor de tela aguarda antes de escrever uma linha nova ou alterada; padrão 0 a partir da v2.1.287 (era 50), então defina 50 para restaurar a pausa |
| ### Configuração de ferramentas | |
| Variável | Finalidade |
| ---------- | --------- |
BASH_DEFAULT_TIMEOUT_MS |
Timeout de comandos Bash (padrão 30000) |
BASH_MAX_TIMEOUT_MS |
Timeout máximo do bash (padrão 600000) |
MCP_TIMEOUT |
Timeout de inicialização do servidor MCP (padrão 5000) |
MCP_TOOL_TIMEOUT |
Timeout de execução de ferramentas MCP (padrão 30000); a v2.1.142 corrige chamadas HTTP/SSE remotas que ignoravam valores maiores |
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH |
Substitui o limite das descrições de ferramentas MCP e das instruções de servidor, 4.096 caracteres desde a v2.1.296 (2.048 na v2.1.280-295) – aplica-se a todos os servidores MCP da sessão (v2.1.280+); os servidores próprios da Anthropic em api.anthropic.com não são cortados desde a v2.1.299 |
MCP_PROTOCOL_NEGOTIATION |
legacy deixa de sondar os servidores em busca do protocolo MCP 2026-07-28; auto sonda servidores HTTP, de conector e stdio. Servidores locais (stdio) negociam 2026-07-28 por padrão em todas as instalações, incluindo Bedrock, Vertex e Foundry, a partir da v2.1.292; conectores de sessão na nuvem e do Remote Control o negociam por padrão a partir da v2.1.299 |
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS |
Limiar a partir do qual uma chamada longa de ferramenta MCP passa automaticamente para o segundo plano (padrão 2 min, v2.1.212+) |
Comandos em segundo plano (v2.1.285+): comandos Bash e PowerShell em segundo plano são interrompidos após um limite de tempo – o timeout deles com run_in_background, padrão 30 minutos, máximo 2 horas – e o Claude é notificado quando um deles é interrompido. A partir da v2.1.288, o limite se aplica apenas a sessões sem supervisão (-p, Agent SDK, CI, nuvem); sessões no terminal, no aplicativo desktop e no VS Code não têm limite. |
Rede e proxy
| Variável | Finalidade |
|---|---|
HTTP_PROXY / HTTPS_PROXY |
Configuração de proxy |
NO_PROXY |
Ignora o proxy para domínios específicos |
CLAUDE_CODE_CLIENT_CERT |
Caminho do certificado mTLS |
ANTHROPIC_WORKSPACE_ID |
Delimita o escopo de tokens federados por identidade de workload quando uma regra abrange vários workspaces (v2.1.141+) |
CLAUDE_CODE_GZIP_REQUEST_BODIES=0 |
Desativa a compressão gzip de corpos de requisição grandes para api.anthropic.com, ativada mesmo com a telemetria desligada (v2.1.300+) |
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP=1 |
Mantém certificados cruzados do sistema que se certificam mutuamente em um ciclo, para uma CA privada que precise de um (v2.1.316+) |
OTEL_EXPORTER_OTLP_TIMEOUT |
Timeout padrão de exportação do OTel (milissegundos); uma exportação OTLP atrás de um proxy que nunca responde desiste após 10 segundos, ou após este valor até 30 segundos (v2.1.317+) |
| Para a lista completa, consulte Variáveis de ambiente no guia completo. |
14. Referência de custos
Preços por 1 milhão de tokens (em outubro de 2026).510
| Modelo | Entrada | Saída | Observações |
|---|---|---|---|
| Sonnet 5.5 | US$ 2,00 | US$ 10,00 | O modelo Sonnet padrão na Anthropic API a partir da v2.1.284 (28 de setembro de 2026) – ID do modelo claude-sonnet-5-5, contexto de 1M / saída de 128K, leituras de cache a US$ 0,10/MTok (0,05x da entrada; a v2.1.296 corrige os valores de custo do Claude Code, que usavam US$ 0,20), corte de conhecimento em junho de 2026. Codificação diária com foco em custo; effort tem medium como padrão no Claude Code. /model sonnet na Anthropic API (a Claude Platform na AWS resolve sonnet para o Sonnet 4.6; Bedrock, Agent Platform e Foundry para o Sonnet 4.5). |
| Sonnet 5 (anterior) | US$ 2,00 | US$ 10,00 | O que sonnet selecionava na Anthropic API da v2.1.197 à v2.1.283, e o padrão dos planos Pro/Team Standard até a v2.1.280 mover esses planos para o Opus. Contexto nativo de 1M; US$ 2/US$ 10 é o preço de tabela padrão (o aumento programado para 1º de setembro, para US$ 3/US$ 15, foi cancelado; a v2.1.243 atualizou o seletor /model para refletir isso). Fixe com ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5. |
| Opus 5.5 | US$ 4,00 | US$ 20,00 | O modelo Opus padrão a partir da v2.1.280 (22 de setembro de 2026) – ID do modelo claude-opus-5-5, contexto de 1M, leituras de cache a US$ 0,20/MTok (0,05x da entrada, contra o padrão de 0,1x). Mais barato que o Opus 5 em todas as posições, e o modelo padrão em todos os planos agora que a v2.1.280 move Pro e Team Standard do Sonnet para o Opus. /model opus. |
| Opus 5 (anterior) | US$ 5,00 | US$ 25,00 | O nível Opus da v2.1.219 (24 de julho de 2026) à v2.1.278 — ID do modelo claude-opus-5, contexto de 1M / saída de 128K, thinking ativado por padrão, effort tem high como padrão, corte de conhecimento em maio de 2026. Era o padrão dos planos premium – Max, Team Premium, Enterprise (assentos a partir da v2.1.251) – e da Anthropic API, até a v2.1.280 tornar o Opus 5.5 o modelo Opus padrão. Fixe com ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5. |
| Opus 4.8 (legado) | US$ 5,00 | US$ 25,00 | Mesmo preço, agora na tabela de modelos legados da documentação; o padrão do nível premium da v2.1.154 à v2.1.219. O fast mode nele foi descontinuado em 30 de outubro de 2026 e será removido em 30 de novembro de 2026. Fixe com ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8. |
| Fable 5.1 | US$ 10,00 | US$ 50,00 | Nível acima do Opus; /model fable o seleciona a partir da v2.1.257, a primeira versão instalável que o inclui (o Fable 5, v2.1.170+, passou para a tabela de legados da documentação). ID do modelo claude-fable-5-1, contexto de 1M / saída de 128K, thinking adaptativo sempre ativo, corte de conhecimento em junho de 2026 (o mesmo do Opus 5.5 e do Sonnet 5.5), leituras de cache a US$ 0,25/MTok (0,025x da entrada, contra o padrão de 0,1x). |
| Haiku 5.5 | US$ 0,10 | US$ 0,50 | O que haiku seleciona na Anthropic API a partir da v2.1.293 (7 de outubro de 2026) – ID do modelo claude-haiku-5-5, contexto de 1M / saída de 128K, thinking adaptativo que não pode ser desativado, corte de conhecimento em junho de 2026. Um prompt acima de 100K tokens paga US$ 0,50 / US$ 2,50, incluindo todos os tokens dessa solicitação; leituras de cache a US$ 0,01 (padrão de 0,1x). Exploração rápida, tarefas simples, subagents. Ainda é o Haiku 4.5 no Bedrock, Vertex, Foundry e na Claude Platform na AWS. /model haiku. |
| Haiku 4.5 (anterior) | US$ 1,00 | US$ 5,00 | O que haiku selecionava antes da v2.1.293, e ainda seleciona no Bedrock, Vertex, Foundry e na Claude Platform na AWS. Fixe com ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001. |
Uma sessão típica consome de 50K a 200K tokens de entrada e de 10K a 50K tokens de saída. Sessão com Haiku 5.5: cerca de US$ 0,01 a US$ 0,05 nas tarifas para prompts de até 100K tokens. Sessão com Opus 5.5: US$ 0,40 a US$ 1,80.
Modelo padrão no Claude Code (por plano): Opus em todos os planos a partir da v2.1.280 (22 de setembro de 2026) – Pro e Team Standard passaram do Sonnet para o Opus, igualando Max, Team Premium e Enterprise – e o modelo Opus padrão é o Opus 5.5 (claude-opus-5-5), onde o alias opus agora aterrissa. A divisão da v2.1.251 (Opus 5 nos planos premium, Sonnet 5 no Pro/Team Standard) e o padrão Sonnet-5-em-tudo da v2.1.197 ficaram para trás. Administradores podem definir um padrão para toda a organização, exibido como “Org default” no /model (v2.1.196+). A Claude Platform na AWS, o Amazon Bedrock e a Agent Platform do Google Cloud também usam o Opus 5.5 como padrão; o Microsoft Foundry é a única exceção (padrão Sonnet 4.5, e o único lugar onde opus resolve para o Opus 4.6) – fixe um modelo específico via ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.
Opus 5.5, Sonnet 5.5, Haiku 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5 e Fable 5.1 usam apenas raciocínio adaptativo (sem orçamentos fixos de thinking), com /effort xhigh para o trabalho de codificação/agêntico mais difícil. effort tem high como padrão em todos eles, exceto no Opus 5.5 e no Sonnet 5.5, cujo padrão é medium, como acontece com o Haiku 5.5 na Claude API – e, a partir da v2.1.280, um nível de effort salvo antes de o /effort se tornar por modelo não é mais transferido para modelos recém-lançados como o Opus 5.5, então ele começa no próprio padrão até você escolher um. O thinking não pode ser desativado no Opus 5.5, no Sonnet 5.5 nem nos modelos Fable (MAX_THINKING_TOKENS=0 não tem efeito neles). Mudanças incompatíveis do Opus 5 em relação ao Opus 4.8: o thinking fica ativado por padrão em solicitações que omitem o campo thinking, e thinking: {type: "disabled"} com effort xhigh ou max retorna um 400.
Fast mode (/fast) se aplica ao Opus 5.5 e ao Opus 5, e ao Opus 4.8 até 30 de novembro de 2026 (descontinuado em 30 de outubro; após a remoção, uma solicitação em fast mode no Opus 4.8 gera erro em vez de rodar na velocidade padrão), com o Opus 5.5 como padrão desde a v2.1.280 – US$ 8 / US$ 40 por MTok no Opus 5.5, US$ 10 / US$ 50 no Opus 5 e no 4.8 (2× o preço base em cada caso) para até 2,5× mais tokens de saída por segundo. O Opus 4.7 foi removido: claude-opus-4-7 + speed: "fast" agora gera erro em vez de recuar para a velocidade padrão. Prévia de pesquisa, apenas na Claude API e nas assinaturas (não no Bedrock/Vertex/Foundry nem na Claude Platform na AWS); trocar de velocidade invalida o cache de prompt. A partir da v2.1.271, o fast mode também funciona em sessões do Claude Code Remote (runners na nuvem e autogerenciados): a configuração de fast mode do host ou o /fast digitado na sessão vale onde sua organização permitir.
Alternar modelos durante uma sessão:
/model opus # Switch to Opus 5.5 (v2.1.280+)
/model sonnet # Switch to Sonnet 5.5 on the Anthropic API (v2.1.284+)
/model haiku # Switch to Haiku 5.5 on the Anthropic API (v2.1.293+)
/model fable # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/effort xhigh # Recommended for the hardest coding/agentic work
Regra de decisão: Exploração simples vai para o Haiku. Codificação diária com foco em custo vai para o Sonnet. Raciocínio difícil, arquitetura, loops agênticos e análise de segurança vão para o Opus. Use opusplan para refatorações complexas (o Opus planeja, o Sonnet executa).
15. Localização dos arquivos principais
| Caminho | Finalidade |
|---|---|
~/.claude/settings.json |
Configurações globais do usuário |
~/.claude/keybindings.json |
Atalhos de teclado personalizados |
~/.claude/CLAUDE.md |
Instruções pessoais (todos os projetos) |
~/.claude/commands/ |
Slash commands pessoais |
~/.claude/skills/ |
Skills pessoais |
~/.claude/agents/ |
Definições pessoais de subagents |
~/.claude.json |
Estado de runtime, tokens OAuth, configuração MCP |
.claude/settings.json |
Configurações do projeto (compartilhadas via git) |
.claude/settings.local.json |
Configurações do projeto (pessoais, no gitignore) |
.claude/CLAUDE.md |
Instruções do projeto |
.claude/commands/ |
Slash commands do projeto |
.claude/agents/ |
Definições de subagents do projeto |
.claude/skills/ |
Skills do projeto |
.claude/plans/ |
Arquivos de saída do modo de planejamento |
.claude/memory/ |
Arquivos de memória automática |
.mcp.json |
Configuração do servidor MCP do projeto |
CLAUDE.md |
Instruções do projeto (alternativa na raiz) |
AGENTS.md |
Lido como instruções do projeto quando o projeto não tem CLAUDE.md (v2.1.277+) |
16. Changelog
| Data | Alteração |
|---|---|
| 2026-11-02 | Sincronização direcionada das v2.1.311-317 (26 de outubro a 2 de novembro; npm latest e next em 2.1.317, stable passa para 2.1.311; a 2.1.313 nunca foi publicada, a 2.1.315 está no npm sem entrada no changelog). O modo rápido (fast mode) no Opus 4.8 foi descontinuado em 30 de outubro e será removido em 30 de novembro. ultrathink executa um turno no terminal em xhigh. Linhas adicionadas: permissions.blockWritesOutsideWorkingDirectories, disableRemoteControl, CLAUDE_CODE_SUBAGENT_EFFORT, CLAUDE_CODE_DISABLE_ULTRATHINK, CLAUDE_CODE_MODEL_CATALOG, CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK, CLAUDE_CODE_SKIP_PROMPT_HISTORY, CLAUDE_CODE_TRANSCRIPT_LOCAL_GC, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_DISABLE_NESTED_SESSION_ID, CLAUDE_CODE_DISABLE_CFC_PROMPT, FORCE_HYPERLINK, CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP, OTEL_EXPORTER_OTLP_TIMEOUT. Linhas atualizadas: /fast, /model ([1m] removido onde não tem efeito), /effort, idleCompaction (VS Code, desktop e provedores de terceiros desde a v2.1.314), ENABLE_TOOL_SEARCH, a tabela de custos e os subcomandos do runner.16 |
| 2026-10-26 | Sincronização de documentação, sem nova versão do CLI (npm latest 2.1.310, stable 2.1.308). Linhas adicionadas: --cloud (--remote é o alias descontinuado; -p "msg" --cloud <session-id> enfileira uma mensagem em uma sessão na nuvem em execução), /schedule (tarefas agendadas na nuvem, antes chamadas de routines; alias /routines), /slides (beta dos templates de artefato), CLAUDE_CODE_DISABLE_ARTIFACT, CLAUDE_CODE_ARTIFACT_AUTO_OPEN, CLAUDE_CODE_MAX_TURNS, enableWorkflows / disableWorkflows. Linha substituída: CLAUDE_CODE_WORKFLOWS=1 (o opt-in da v2.1.147, que saiu da referência de variáveis de ambiente) por CLAUDE_CODE_DISABLE_WORKFLOWS=1; os workflows ficam ativados por padrão, exceto no plano Pro. O guia completo ganha a seção Projects (beta público desde 17 de setembro de 2026).15 |
| 2026-10-23 | Sincronização direcionada das v2.1.303-310 (18 a 23 de outubro; npm latest e next em 2.1.310, stable passa para 2.1.308; a 303 e a 308 são versões de confiabilidade com uma única linha de notas). Linhas adicionadas: /auto-mode-setup, sandbox.allowNestedUserNamespaces, CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS, CLAUDE_CODE_AUTO_COMPACT_WINDOW (sufixos k/M), CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK. Linhas atualizadas: /usage em uma linha, fixado com f (v2.1.305), o aviso de retomada de 5 horas do Pro/Max em /resume (v2.1.304), /claude-api api-version e managed-agents-secure, busca de ferramentas ativada por padrão atrás de uma URL base personalizada (v2.1.304) com a correção da regressão da v2.1.305, confiança no workspace do claude ultrareview (v2.1.309), limites de hooks de skills (v2.1.304).14 |
| 2026-10-17 | Sincronização direcionada das v2.1.301-302 (15 e 16 de outubro; npm latest e next em 2.1.302, stable segue em 2.1.292; nada foi pulado). claude -p e o SDK voltam a iniciar em Manual em provedores de terceiros, com a telemetria desligada e em instalações novas (a v2.1.302 reverte a v2.1.285; --permission-mode auto mantém o auto). Subagentes fork ativados por padrão em -p, no SDK, no desktop e no VS Code (CLAUDE_CODE_FORK_SUBAGENT=0 os desativa); o desktop e o VS Code sempre executam em segundo plano os subagentes da conversa principal; hooks de prompt e de agente têm limite de 12 por evento. Linhas: CLAUDE_CODE_AUTO_MODE_MODEL, CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS, % do vim, a linha Idle compaction do /config.13 |
| 2026-10-14 | Sincronização direcionada da v2.1.300 (14 de outubro; npm latest e next em 2.1.300, stable passa para 2.1.292). Linhas da ferramenta Advisor adicionadas (/advisor, --advisor, advisorModel, CLAUDE_CODE_DISABLE_ADVISOR_TOOL): um segundo modelo, do lado do servidor, que o Claude consulta em pontos de decisão, disponível na Claude Platform na AWS a partir desta versão. Linha CLAUDE_CODE_GZIP_REQUEST_BODIES; claude remote-control perde --sandbox/--no-sandbox; o updatedInput de hooks agora é validado como a própria entrada do Claude.12 |
| 2026-10-14 | Sincronização direcionada da v2.1.299 (14 de outubro; npm latest 2.1.299, next 2.1.300 ainda sem notas, stable segue em 2.1.287; a 2.1.297 e a 2.1.298 nunca foram publicadas). Compactação por inatividade: uma conversa com mais de 200K tokens, ociosa por cerca de 54 minutos, é compactada antes de o cache de prompt de uma hora expirar; nova linha de configuração idleCompaction e nova linha de ambiente CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS. Novas linhas de ambiente CLAUDE_CODE_DISABLE_FILE_MENTIONS, CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT e CLAUDE_CODE_ATTRIBUTION_HEADER; CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS agora documentada (teto, padrão 32000). As regras de MCP correspondem ao nome completo do servidor (mcp__a não cobre mais a__b; escreva mcp__<server>__*), anotado na sintaxe de regras de permissão; servidores próprios em api.anthropic.com ficam isentos do limite de descrição; conectores da nuvem e do Remote Control no protocolo 2026-07-28. Avisos do /usage, /effort e /fast na visualização de agentes, claude plugin eval --disallow-tools. Duas regressões da 2.1.296 corrigidas (Edit e Retry em sessões na nuvem; uma chamada de ferramenta aprovada executada duas vezes após um reinício).11 |
| 2026-10-11 | Sincronização direcionada das v2.1.293-296 (7 a 9 de outubro; npm latest e next em 2.1.296, stable passa para 2.1.287). Claude Haiku 5.5 (claude-haiku-5-5, US$ 0,10 / US$ 0,50 por MTok para prompts de até 100K tokens, US$ 0,50 / US$ 2,50 acima disso) é o que haiku seleciona na Anthropic API (v2.1.293): nova linha na Referência de custos, Haiku 4.5 reclassificado como anterior, nota do /model haiku atualizada; leituras de cache do Sonnet 5.5 corrigidas para US$ 0,10. Hooks: onFailure: "block" (v2.1.295). Limite de descrição de MCP em 4.096 (v2.1.296). Novas linhas: skills (32 pré-carregadas), autoCompactWindow, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, CLAUDE_CODE_RETRY_WATCHDOG, CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL, VERTEX_REGION_CLAUDE_HAIKU_5_5; nota do /copy.10 |
| 2026-10-06 | Sincronização direcionada das v2.1.288-292 (2 a 6 de outubro; npm latest e next em 2.1.292, stable segue em 2.1.285). A 2.1.291 corrige regressões da 2.1.288 e da 2.1.290, então atualize para além delas. O orçamento do WebSearch é reabastecido a cada hora em sessões interativas (v2.1.290); os limites de comandos em segundo plano valem apenas para sessões sem supervisão (v2.1.288); claude project purge agora é claude purge. Novas linhas: /autocompact, plugin install --marketplace, CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR, MCP_PROTOCOL_NEGOTIATION e mais quatro variáveis de ambiente; notas de permissões, Agent View, /code-review e /claude-api atualizadas.9 |
| 2026-10-01 | Sincronização direcionada das v2.1.286-287 (30 de setembro a 1º de outubro; npm latest e next em 2.1.287, stable passa para 2.1.285; nada foi pulado desde a 2.1.285). Contexto de 1M por padrão para Opus 4.7+ e Fable no Bedrock, Vertex, Foundry e no gateway de apps do Claude (v2.1.287): linha CLAUDE_CODE_DISABLE_1M_CONTEXT atualizada. Chegam os Mods, com o mod integrado You should know (v2.1.287). --bare conecta apenas servidores MCP de linha de comando e não inicia tarefas em segundo plano (v2.1.286). Novas linhas: CLAUDE_AX_PREPARK_MS (padrão agora 0), /plugin enable cc-plugin-you-should-know@builtin; notas sobre alwaysLoad: false, prompts de URL e bareElicitationCapability, o filtro de agentes n:<text>, /hooks e Ctrl+G adicionadas. A nota do modo auto agora corresponde à documentação de modos de permissão. |
| 2026-09-29 | Sincronização direcionada das v2.1.284-285 (28 e 29 de setembro; npm latest e next em 2.1.285, stable passa para 2.1.280; nada foi pulado desde a 2.1.283). Claude Sonnet 5.5 (claude-sonnet-5-5, US$ 2/US$ 10 por MTok) é o modelo Sonnet padrão na Anthropic API (v2.1.284): nova linha na Referência de custos, linha do Sonnet 5 reclassificada como anterior, notas de esforço e de raciocínio atualizadas. O modo auto agora inicia as sessões interativas em todos os planos e provedores (v2.1.284) e as sessões de claude -p / Python Agent SDK em provedores de terceiros ou com a telemetria desligada (v2.1.285). Ultracode é um toggle próprio do /effort (v2.1.284). Comandos de shell em segundo plano param ao atingir o timeout, padrão de 30 minutos (v2.1.285). Novas linhas: --desktop, allowedProviders, claude plugin configure, plugin install --config, CLAUDE_CODE_DISABLE_WEB_FETCH, CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES; /mcp reconnect all, atalhos do slider e a janela de 1M com URL base personalizada adicionados a linhas existentes. |
| 2026-09-26 | Sincronização direcionada das v2.1.282-283 (24 e 25 de setembro; npm latest e next em 2.1.283, stable passa para 2.1.274; nada foi pulado desde a 2.1.281). O modo auto agora é o modo inicial integrado para sessões interativas no terminal e no VS Code em todos os planos e provedores (v2.1.283), e usa o classificador do lado do servidor por padrão em uma conexão direta com a API com a telemetria desligada (v2.1.282). Variáveis OTel em configurações de projeto e locais são ignoradas (v2.1.282). Novas linhas: maxProseWidth, deniedModels, availableModelsMatch, allowClaudeInChromeWithManagedMcp, /doctor prompt-audit e as variáveis OTel ignoradas; a linha dos hint headers ganha x-claude-code-prompt-id e o padrão de API direta. |
| 2026-09-24 | Sincronização direcionada da v2.1.281 (23 de setembro; npm latest e next em 2.1.281, stable passa para 2.1.273; nenhuma versão pulada desde a 2.1.280). Enviar agora (Ctrl+Enter) move as ferramentas em execução para segundo plano em vez de cancelar o turno. CLAUDE_CODE_AUTO_MODE_SERVER agora também se aplica a uma conexão direta com a Anthropic API. Modo automático: comandos de shell somente leitura e em sandbox revisados pelo servidor aguardam essa revisão; o prompt do rm perigoso nega após 2 minutos em modos sem supervisão. Novas linhas: attribution (false oculta toda a atribuição), verificações MCP do claude plugin validate e duas variáveis de ambiente do rm. Correção: a linha de /agents agora diz que o assistente (wizard) foi removido na v2.1.198. |
| 2026-09-23 | Correções, sem nova versão de CLI (npm latest continua em 2.1.280). O modo rápido agora lista Opus 5.5 a US$ 8/US$ 40 por MTok, o padrão do modo rápido desde a v2.1.280 (Opus 5 e 4.8 continuam a US$ 10/US$ 50), na linha de /fast e na nota de Referência de custos. Custo de sessão do Opus recalculado com os US$ 4/US$ 20 do Opus 5.5: US$ 0,40 a US$ 1,80. A linha de /effort lista a escala completa e o padrão medium do Opus 5.5; o thinking não pode ser desativado no Opus 5.5. |
| 2026-09-22 | Sincronização direcionada da v2.1.280 (22 de setembro; npm latest em 2.1.280, stable mantém 2.1.267; a 2.1.279 nunca foi publicada – sem release no npm, sem seção no changelog). Claude Opus 5.5 (claude-opus-5-5) é o novo modelo Opus padrão – contexto de 1M, US$ 4/US$ 20 por MTok, leituras de cache a US$ 0,20/MTok – e o modelo padrão nos planos Pro e Team Standard passa de Sonnet para Opus, igualando Max, Team Premium e Enterprise: nova linha do Opus 5.5 na Referência de custos, linhas do Opus 5 e do Sonnet 5 reclassificadas como histórico, nota de modelo padrão e comentário de /model atualizados. CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH – nova linha de variável de ambiente: substitui o limite de 2.048 caracteres nas descrições de ferramentas MCP e nas instruções de servidor. Também na v2.1.280, sem impacto em nenhuma superfície do cheatsheet: um nível de esforço salvo antes de /effort passar a ser por modelo não se aplica mais a modelos recém-lançados como o Opus 5.5 (eles começam no padrão deles); gravações por caminhos com symlink agora são julgadas pelo destino final da gravação, então acceptEdits/regras de permissão/modo automático não aprovam mais um destino fora da árvore; o modo automático nega uma vez quando uma verificação de segurança se recusa a revisar, e recua e depois encerra o turno após dez verificações sem resposta. |
| 2026-09-21 | Sincronização direcionada das v2.1.277-278 (18 e 19 de setembro; npm latest em 2.1.278, stable mantém 2.1.267). Suporte a AGENTS.md (v2.1.277) – nova nota na seção CLAUDE.md e uma linha em Locais de arquivos importantes: em um projeto sem CLAUDE.md, o Claude Code lê AGENTS.md no lugar, configurável em “Project instructions” no /config, ainda não disponível em Bedrock/Vertex/Foundry. Semântica de CLAUDE_CODE_AUTO_MODE_SERVER invertida (v2.1.278) – linha atualizada: o classificador do lado do servidor agora é o PADRÃO para usuários da Claude API e Enterprise e em Bedrock/Vertex/Foundry e gateways, sem cobrança pelo overhead do classificador, e =0 é a forma de desativar nesses casos (a linha da v2.1.273 documentava =1 como opt-in enquanto o local era o padrão); /status ganha uma linha “Auto mode server”. Nenhuma outra superfície do cheatsheet afetada (a correção de glob em comandos compostos no sandbox da v2.1.277, o comportamento de código de saída em modo headless e a variável de ambiente de egress de gateway ficam no guia completo). |
| 2026-09-17 | Sincronização direcionada das v2.1.274-276 (17 de setembro; npm latest em 2.1.276, stable mantém 2.1.267; a 2.1.276 corrige uma regressão da 2.1.275 – toda requisição retorna 400 quando ANTHROPIC_BASE_URL aponta para um proxy ou gateway, então nunca fixe a 2.1.275 atrás de um). Tecla de enviar agora (v2.1.275) – nova linha: ctrl+enter (ou ctrl+x ctrl+s) interrompe o turno e envia todas as mensagens na fila. syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275) – nova linha de configurações: skills e plugins da conta claude.ai sincronizam com as sessões de terminal autenticadas, false desativa. /plugin install <plugin> --marketplace <source> (v2.1.275) – nova linha de plugin: oferece adicionar o marketplace primeiro. Nenhuma outra superfície do cheatsheet afetada (a mudança de nome para “cloud session” da v2.1.274 não toca nenhuma linha do cheatsheet, e as novas variáveis de ambiente MCP ficam na tabela de env do guia completo). |
| 2026-09-16 | Sincronização direcionada da v2.1.273 (15 de setembro; npm latest, encerrando a vigilância da tag next abaixo; a dist-tag stable passou para 2.1.267). Duas linhas de variáveis de ambiente adicionadas: CLAUDE_CODE_AUTO_MODE_SERVER (o modo automático via gateway agora usa por padrão o classificador LOCAL em Bedrock/Vertex/Foundry) e CLAUDE_CODE_GATEWAY_HINT_HEADERS. Nota para quem usa regras de permissão: a v2.1.273 reverte pontualmente a verificação de negação de linhas não analisáveis da v2.1.268 (linhas com eval e env -C voltam a pedir confirmação em vez de negar); as correções de estado e de symlink da v2.1.260 permanecem. Nenhuma outra superfície do cheatsheet afetada. |
| 2026-09-15 | Sincronização direcionada das v2.1.266-272 (8 a 14 de setembro; npm latest em 2.1.272, 2.1.273 apenas na tag next e ainda sem notas de versão; 266/270 são correções de regressão de uma linha e a 272 não tem conteúdo). /output-style de volta (v2.1.269) – nova linha: lista e alterna estilos de saída, descontinuado da v2.1.73 à v2.1.268 em favor de /config, agora funciona via Remote Control e em sessões na nuvem/headless. O modo rápido chega às sessões Remote (v2.1.271) – linha de /fast e nota do modo rápido atualizadas: runners na nuvem e auto-hospedados, configuração no host ou /fast na sessão, onde a organização permitir. claude plugin eval (v2.1.269) – nova linha de Plugin CLI: suítes de avaliação pontuadas e reproduzíveis com relatórios em JSON + HTML. Nenhuma outra superfície do cheatsheet afetada (verificado: as linhas de /diff, /skill-doctor, --plugin-dir e de atalhos encadeados não foram tocadas por essas versões). |
| 2026-09-08 | Sincronização direcionada da v2.1.265 (8 de setembro; 2.1.262/2.1.264 nunca publicadas, 2.1.263 sem conteúdo). Linhas de --plugin-dir: modo pasta de plugins – cada subpasta com um manifesto é carregada, e subpastas adicionadas ou removidas durante a execução são detectadas (v2.1.265+). Linha de Ctrl+X Ctrl+K: os atalhos encadeados de duas teclas agora esperam 3 segundos pela segunda tecla e mostram um aviso ao expirar (antes era 1 segundo com cancelamento silencioso, o que engolia atalhos digitados no tmux). Nenhuma outra superfície do cheatsheet afetada. |
| 2026-09-05 | Sincronização direcionada da v2.1.261 (4 de setembro). Adicionada a linha de /skill-doctor: mostra quais skills carregadas ficam sem uso e quanto cada uma custa em contexto, para que você possa removê-las. Também da v2.1.261, sem impacto em nenhuma superfície do cheatsheet: a configuração keybindingFlavor foi aposentada (a edição de palavras do readline agora é o único dialeto do prompt) – o cheatsheet nunca a documentou. |
| 2026-09-03 | Sincronização direcionada da v2.1.260 (chegou horas depois da sincronização das v2.1.257-259 do mesmo dia, abaixo). Adicionada a linha de /diff: painel de diff em tela cheia ao lado da conversa, mostrando as alterações não commitadas ao vivo enquanto o Claude edita. Nota para quem usa regras de permissão: a v2.1.260 reverte a extensão da v2.1.259 das regras de negação Read() para valores de opções e operandos do Bash (ela negava npm run build sob uma regra de negação de diretório de build em todos os modos); a cobertura de redirecionamento de entrada e de comandos de leitura da v2.1.257 permanece. |
| 2026-09-03 | Sincronização direcionada das v2.1.257-259 + o lançamento do Claude Fable 5.1 (1º de setembro de 2026). O alias fable agora seleciona o Fable 5.1 (claude-fable-5-1) – mesmos US$ 10/US$ 50 por MTok, corte de conhecimento em junho de 2026 (o mais recente entre os modelos atuais), leituras de cache a US$ 0,25/MTok (0,025x, contra o padrão de 0,1x); o Fable 5 passa para a tabela de modelos legados da documentação. A v2.1.257 é a primeira versão instalável com o Fable 5.1 (2.1.253-256 nunca foram publicadas no npm). Linha da Referência de custos, nota de raciocínio adaptativo e comentário de /model atualizados. |
| 2026-08-30 | Correção do modelo padrão a partir da documentação de configuração de modelos + CLI v2.1.251: o Opus 5 é o padrão nos planos premium (Max, Team Premium, Enterprise com pagamento conforme o uso, a Anthropic API, Bedrock / Agent Platform do Google Cloud / Claude Platform na AWS; o Enterprise por assento entra na v2.1.251) e o Sonnet 5 no Pro/Team Standard (Foundry: Sonnet 4.5). Linhas do Sonnet 5, Opus 5 e Opus 4.8, nota de modelo padrão e comentário de /model atualizados; o enquadramento “Sonnet 5 em todo lugar” da v2.1.197 foi aposentado. |
| 2026-08-26 | Correção de preços: os US$ 2/US$ 10 por MTok do Sonnet 5 agora são o preço de tabela padrão – a página de preços da Anthropic cancela o aumento para US$ 3/US$ 15 agendado para 1º de setembro, e a v2.1.243 atualizou o seletor /model e a skill claude-api para refletir isso. Linha da Referência de custos e nota de modelo padrão atualizadas; nenhum outro conteúdo alterado.5 |
| 2026-08-17 | Sincronização direcionada da v2.1.234. As sessões continuam automaticamente quando um limite de uso do claude.ai é redefinido (/config: “Continue automatically at usage limit”). Variáveis de ambiente: CLAUDE_CODE_PROJECT_DIR_NAME, CLAUDE_CODE_GOAL_CHECKIN_MINUTES. /permissions e /add-dir agora abrem no meio do turno. Selo de MR do GitLab (!N) no rodapé via glab autenticado. |
| 2026-08-15 | Sincronização direcionada da v2.1.233. Variáveis de ambiente: CLAUDE_CODE_TOOL_MEMORY_LIMIT (cgroup do Bash no Linux), CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS, CLAUDE_CODE_ENABLE_TODO_TOOLS (as ferramentas de todo/task agora ficam DESLIGADAS por padrão no Opus 4.8/Sonnet 5/Fable 5+). MRs do GitLab funcionam com --worktree (!N em claude agents). As mudanças de permissão de symlink no Cygwin e de < file da v2.1.232 foram revertidas; sua regressão de aprovação no modo automático no Windows foi corrigida. |
| 2026-08-14 | Sincronização direcionada da v2.1.231–232 + a mudança de padrão de 14 de agosto. O modo Auto agora é o padrão para novas sessões nos planos Pro/Max/Team (observado no bloco Modo Auto). v2.1.232: menção com @ a sessões ativas (roteia via SendMessage; a correspondência exata do nome simples entrega), fork de subagents ativado por padrão, linhas do /config para expiração de diálogos + entrada entre sessões, marketplaces do GitLab + redação de tokens, aliases de configurações additionalMarketplaces/allowedMarketplaces. v2.1.231: correção do redirect-URI do MCP OAuth. |
| 2026-08-12 | Sincronização direcionada da v2.1.228–229. Variáveis de ambiente: adicionada CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS (escalonamento do fan-out de workflows; 0 desativa). Também: claude remote-control --continue retoma a sessão mais recente do Remote Control; /commit-push-pr não aprova mais automaticamente flags perigosas do git; a ferramenta Write segue as mesmas regras de sobrescrita da Edit nos modelos mais novos. |
| 2026-08-10 | Reparo de defeito herdado, vindo da auditoria holística do guia principal: a linha do classificador do modo auto ainda dizia Sonnet 4.6 — corrigida para Sonnet 5 a partir da v2.1.210 (originalmente Sonnet 4.6). |
| 2026-08-06 | Sincronização direcionada dos itens de superfície de comandos da v2.1.221–v2.1.223. /review volta a ser um alias de /code-review (v2.1.223), lembrando o último nível de esforço digitado; as cópias feitas por /fork ganham o próprio worktree (v2.1.221); o VSCode adiciona a visualização Focus (Ctrl+Alt+F, v2.1.221); CLAUDE_CODE_DISABLE_1M_CONTEXT agora limita todo modelo nativo de 1M a 200K via compactação automática, com CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT como válvula de escape para modelos desconhecidos (v2.1.223); strictKnownMarketplaces/blockedMarketplaces aceitam curingas de organização "owner/*" (v2.1.223). |
| 2026-07-25 | Sincronização direcionada dos itens da v2.1.219–v2.1.220. Modelos: Claude Opus 5 (claude-opus-5) substitui o Opus 4.8 como o nível Opus e como o que /model opus seleciona — mesmos US$ 5/US$ 25 por MTok, contexto de 1M / saída de 128K, thinking ativado por padrão, effort com padrão high, corte de conhecimento em maio de 2026, modelo padrão no Claude Max; o Opus 4.8 fica como linha legada. Mudanças incompatíveis em relação ao 4.8: requisições sem o campo thinking agora pensam, e thinking: {type: "disabled"} + effort xhigh/max retorna um 400. Modo rápido corrigido: /fast cobre apenas Opus 5 e Opus 4.8 a US$ 10/US$ 50 por MTok (2× o preço base, ~2,5× a velocidade de saída) — o Opus 4.7 foi removido e agora retorna erro com speed: "fast" em vez de recorrer ao fallback. Variáveis de ambiente: CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH corrigida — a criação aninhada de subagents está ativada por padrão na profundidade 3 a partir da v2.1.219 (estava desativada na v2.1.217); defina 1 para desativar. Chaves de configuração: adicionadas sandbox.network.strictAllowlist (nega hosts fora da lista de permissões sem perguntar) e workflowSizeGuideline (tamanho dinâmico de workflow em caráter consultivo, padrão medium / menos de 15 agentes). Eventos de hook: adicionado DirectoryAdded (dispara depois que /add-dir ou o register_repo_root do SDK registra um diretório de trabalho no meio da sessão). A v2.1.220 traz apenas correções de bugs e melhorias de confiabilidade. |
| 2026-07-24 | Sincronização direcionada dos itens da v2.1.218. Superfície de comandos: /code-review agora roda como subagent em segundo plano, então o trabalho de revisão não ocupa mais a sua conversa. Também na v2.1.218: skills com context: fork rodam em segundo plano por padrão (desativação por skill via a nova chave de frontmatter background: false), /deep-research só inicia quando invocado manualmente, o classificador do modo auto decide as verificações de rm perigoso/& em segundo plano/caminho suspeito do Windows em vez de abrir diálogos de permissão, e hooks no frontmatter de agentes exigem que a pasta do arquivo do agente tenha aceitado a confiança do workspace. |
| 2026-07-22 | Sincronização direcionada dos itens da v2.1.217. Variáveis de ambiente: adicionadas CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (limite de subagents em execução simultânea, padrão 20) e CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH (a criação aninhada de subagents está desativada por padrão a partir da v2.1.217 — defina esta variável para reativar; a v2.1.172–v2.1.216 permitia 5 níveis). Chaves de configuração: adicionada emojiCompletionEnabled (autocompletar de códigos de emoji na entrada do prompt, :heart: → ❤️; false desativa). Também na v2.1.217: --max-budget-usd agora interrompe os subagents em segundo plano assim que o limite é atingido. |
| 2026-07-21 | Sincronização direcionada dos itens da v2.1.214–v2.1.216 (a v2.1.213 nunca foi lançada). Sintaxe das regras de permissão: regras allow de segmento único dir/** agora correspondem apenas a <cwd>/dir (v2.1.214) — use **/dir/** para qualquer profundidade; regras deny/ask mantêm a correspondência em qualquer profundidade; condições if: de hooks recebem o mesmo escopo de cwd. Chaves de configuração: adicionada sandbox.filesystem.disabled (pula o isolamento do sistema de arquivos, mantém o controle de saída de rede, v2.1.216+). Variáveis de ambiente: adicionada CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH (limite de truncamento de conteúdo do OTel, padrão 60 KB, v2.1.214+). |
| 2026-07-17 | Sincronizado até o Claude Code v2.1.212. Superfície de comandos: /fork foi reaproveitado — copia a conversa para uma nova sessão em segundo plano com a própria linha em claude agents; o fork dentro da sessão agora é /subtask; novo subcomando claude auto-mode reset (--yes pula a confirmação); novas flags --forward-subagent-text (v2.1.211) e --ax-screen-reader (v2.1.208). Variáveis de ambiente adicionadas: CLAUDE_CODE_FORWARD_SUBAGENT_TEXT, CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION / CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (padrões de 200 por sessão, v2.1.212), CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS (chamadas MCP com mais de 2 min vão automaticamente para segundo plano), CLAUDE_AX_SCREEN_READER.7 |
| 2026-07-07 | Sincronizado até o Claude Code v2.1.202. Modo de permissão default → “Manual” (v2.1.200; manual aceito como alias). Tabela de modelos reconstruída com a lineup atual — Sonnet 5 (padrão do Claude Code desde a v2.1.197), Opus 4.8, Fable 5, Haiku 4.5 — substituindo as linhas desatualizadas do Opus 4.7 como flagship / Sonnet 4.6; notas de roteamento padrão e de /effort atualizadas. O subagent Explore agora herda o modelo da sessão (limitado ao Opus, v2.1.198); antes era Haiku. Entradas desatualizadas removidas: --enable-auto-mode (removida na v2.1.111 → use --permission-mode auto) e CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE (sem efeito desde a v2.1.160). |
| 2026-05-24 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.150. Adicionados o uso de limites por categoria em /usage, a nota de rolagem pelo teclado em /diff via changelog, a nota de renderização de checkboxes de listas de tarefas GFM via changelog, o allowAllClaudeAiMcps do Enterprise, a orientação de correção de permissões no PowerShell e notas de confiabilidade de Bash/git-worktree/configurações gerenciadas/OTEL/Remote Control. A v2.1.150 em si não tem mudanças anunciadas voltadas ao usuário. Verificação local: o claude --version local retornou 2.1.144 (Claude Code) enquanto a versão mais recente no npm era 2.1.150.6 |
| 2026-05-21 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.147. Adicionados a ferramenta Workflow desativada por padrão (CLAUDE_CODE_WORKFLOWS=1), sessões em segundo plano fixadas no Agent View, /code-review [effort] --comment substituindo /simplify, sandboxes de REPL/Workflow reforçados, melhorias no atualizador automático e em diffs grandes, supressão de duplicatas no histórico de prompts, e correções de login enterprise, PowerShell, paginação de MCP, Agent View, plugins, condições de hooks e texto colado. Verificação local: o claude --version local retornou 2.1.144 (Claude Code) enquanto a versão mais recente no npm era 2.1.147.6 |
| 2026-05-19 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.145. Adicionados claude agents --json, contagens de abas aguardando entrada no Agent View, campos JSON de repositório/PR do GitHub na linha de status, descoberta de plugins mais rica antes da instalação, entrada de hook background_tasks e session_crons em Stop/SubagentStop, agent_id/parent_agent_id no OTEL, e correções de permissões, MCP, spinner, Windows, Agent View, lista de tarefas, validação de plugins, recursão de skills e ferramenta Read. Verificação local: o claude --version local retornou 2.1.144 (Claude Code) enquanto a versão mais recente no npm era 2.1.145.6 |
| 2026-05-19 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.144. Adicionados o suporte de /resume a sessões em segundo plano, o comportamento de sessão atual/padrão do /model, /usage-credits, a exibição da última atualização de plugins, notificações de duração de subagents em segundo plano e correções de confiabilidade do terminal/sessões em segundo plano. Verificação local: claude --version retornou 2.1.144 (Claude Code) e a versão mais recente no npm era 2.1.144.6 |
| 2026-05-18 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.143. Adicionados a consistência de despacho do Agent View, o limite de bloqueios do hook Stop e variáveis de ambiente de política do PowerShell, além de notas sobre a aplicação de dependências de plugins, o custo de contexto projetado de plugins, worktree.bgIsolation: "none", a preservação de modelo/esforço em sessões em segundo plano e correções de timing do avaliador do /goal. Verificação local: claude --version retornou 2.1.142 (Claude Code) enquanto a versão mais recente no npm era 2.1.143.6 |
| 2026-05-15 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.142. Adicionados terminalSequence, claude agents --cwd, as flags de despacho de sessões em segundo plano da v2.1.142, a substituição do padrão do Opus 4.7 no modo rápido, a variável de ambiente de clone de plugins do HTTPS, a variável de ambiente de workspace para workload identity e a nota de correção de HTTP/SSE remoto do MCP_TOOL_TIMEOUT. Verificação local: claude --version retornou 2.1.141 (Claude Code) enquanto a versão mais recente no npm era 2.1.142.6 |
| 2026-05-13 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.140. Adicionados /goal, a nota sobre o Agent View, args em hooks de comando, continueOnBlock em PostToolUse e subagent_type na entrada do hook de agente. Registrado que a v2.1.140 corrige o comportamento de ConfigChange, disableAllHooks e allowManagedHooksOnly. Verificação local: claude --version retornou 2.1.140 (Claude Code).6 |
| 2026-05-06 | Evidências da linha mais recente sincronizadas até o Claude Code v2.1.131. Nenhuma alteração foi necessária nas tabelas de comandos, configuração, atalhos, hooks, plugins ou variáveis de ambiente, porque a v2.1.131 é uma versão de correção para a ativação do VS Code no Windows e a autenticação do endpoint Mantle.6 |
| 2026-05-05 | Sincronizado com o guia do CC v2.36 (CLI v2.1.126–v2.1.129). Adicionados: --plugin-url para carregar plugins a partir de arquivos zip, suporte a .zip em --plugin-dir, skillOverrides, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE, CLAUDE_CODE_FORCE_SYNC_OUTPUT e as orientações da v2.1.129 sobre o manifesto de plugins para themes/monitors experimentais. Cobertura até a v2.1.129.6 |
| 2026-04-29 | Sincronizado com o guia do CC v2.35 (CLI v2.1.117–v2.1.123). Adicionados: opção alwaysLoad de MCP + nova tentativa automática na inicialização; claude plugin prune e a cascata de --prune; claude plugin tag; filtragem ao digitar em /skills; temas nomeados em /theme; diálogo unificado de /usage; modos visuais do vim (v/V); aprovação automática do PowerShell; duration_ms na entrada dos hooks + updatedToolOutput para todas as ferramentas; prUrlTemplate, wslInheritsWindowsSettings, autoMode.allow $defaults; variáveis de ambiente ANTHROPIC_BEDROCK_SERVICE_TIER, ENABLE_TOOL_SEARCH, CLAUDE_CODE_HIDE_CWD, DISABLE_UPDATES, CLAUDE_CODE_FORK_SUBAGENT; --from-pr aceita URLs de PR do GitLab/Bitbucket/GHE. Cobertura até a v2.1.123. |
| 2026-04-19 | Atualização: o contexto de 1M do Sonnet 4.6 agora aparece com o preço padrão de US$ 3/US$ 15 (sem sobretaxa de contexto longo); nota de rodapé de preços alterada para platform.claude.com/docs/en/about-claude/pricing. Cobertura até a v2.1.116. |
| 2026-04-04 | Rederivado a partir do guia do CC v2.26. Adicionado /powerup, atualizado /release-notes, removido /vim. Atalho Ctrl+X Ctrl+K atualizado. Adicionados 4 eventos de hook (CwdChanged, FileChanged, TaskCreated, PermissionDenied). /cost atualizado com detalhamento por modelo. Cobertura até a v2.1.92. |
| 2026-03-28 | Lançamento inicial da cheat sheet, cobrindo o Claude Code CLI até a v2.1.85 |
17. Referências
Este cheat sheet é o companheiro de consulta rápida do guia completo da CLI do Claude Code. Para tutoriais de configuração, veja o guia rápido do Claude Code. Para projetos iOS e macOS especificamente, veja o guia de desenvolvimento de agentes para iOS, os padrões de integração com o XcodeBuildMCP e a série Ecossistema Apple. Última atualização em 6 de outubro de 2026.
-
Documentação do Auto Mode do Anthropic Claude Code (v2.1.85) ↩
-
Documentação de subagents do Claude Code, “Limite de subagents simultâneos”: 20 subagents em execução por padrão, alterado com
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. Lido em 6 de outubro de 2026. ↩ -
Notas de lançamento do Claude Code v2.1.129, notas de lançamento do Claude Code v2.1.131, notas de lançamento do Claude Code v2.1.139, notas de lançamento do Claude Code v2.1.140, notas de lançamento do Claude Code v2.1.141, notas de lançamento do Claude Code v2.1.142, notas de lançamento do Claude Code v2.1.143, notas de lançamento do Claude Code v2.1.144, notas de lançamento do Claude Code v2.1.145, notas de lançamento do Claude Code v2.1.147, notas de lançamento do Claude Code v2.1.148, notas de lançamento do Claude Code v2.1.149, notas de lançamento do Claude Code v2.1.150, documentação do Agent View do Claude Code, documentação do Goal do Claude Code e o CHANGELOG do Claude Code ↩↩↩↩↩↩↩↩↩↩
-
Notas de lançamento do Claude Code v2.1.206, v2.1.207, v2.1.208, v2.1.210, v2.1.211, v2.1.212 e a documentação de acessibilidade do Claude Code. Julho de 2026. ↩↩
-
Notas de lançamento do Claude Code v2.1.287 e a visão geral dos Mods, outubro de 2026. ↩
-
CHANGELOG do Claude Code, v2.1.288 a v2.1.292, a referência da CLI e a referência de variáveis de ambiente, outubro de 2026. ↩
-
CHANGELOG do Claude Code, v2.1.293 a v2.1.296, a visão geral do modelo Claude Haiku 5.5, a página de preços, a referência de hooks, a referência de sub-agents e a referência de variáveis de ambiente, outubro de 2026. ↩↩
-
CHANGELOG do Claude Code, v2.1.299, a Referência de configurações (
idleCompaction, “Requer Claude Code v2.1.290 ou posterior”) e a página Variáveis de ambiente (CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS,CLAUDE_CODE_DISABLE_FILE_MENTIONS,CLAUDE_CODE_ATTRIBUTION_HEADER,CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS), consultadas em 14 de outubro de 2026; dist-tags do npm lidas no mesmo dia: latest 2.1.299 (publicada em 14 de outubro, 00:23 UTC), next 2.1.300 (14:27 UTC), stable 2.1.287.CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT,--disallow-toolse a mudança da regra de nome completo do MCP constam apenas nas notas de lançamento até essa data. ↩ -
CHANGELOG do Claude Code, v2.1.300, a página da ferramenta advisor, a referência da CLI (
--advisor <model>), a Referência de configurações (advisorModel) e a página Variáveis de ambiente (CLAUDE_CODE_DISABLE_ADVISOR_TOOL,CLAUDE_CODE_GZIP_REQUEST_BODIES), consultadas em 14 de outubro de 2026; dist-tags do npm lidas na mesma noite: latest e next 2.1.300 (publicada às 14:27 UTC), stable 2.1.292. ↩ -
CHANGELOG do Claude Code, v2.1.301 e v2.1.302 e a página Modo interativo (o movimento
%, “Requer Claude Code v2.1.301 ou posterior”), consultados em 17 de outubro de 2026; dist-tags do npm lidas no mesmo dia: latest e next 2.1.302 (publicada em 16 de outubro, 16:48 UTC; 2.1.301 em 15 de outubro, 14:34 UTC), stable 2.1.292. As páginas de modos de permissão, variáveis de ambiente e sub-agents ainda descrevem as regras de-pe do modo fork anteriores à 2.1.302, eCLAUDE_CODE_AUTO_MODE_MODEL,CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MSe a linha de/configconstam apenas nas notas de lançamento até essa data. ↩↩↩↩ -
CHANGELOG do Claude Code, v2.1.303 a v2.1.310, a página Variáveis de ambiente (
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS,CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK,CLAUDE_CODE_AUTO_COMPACT_WINDOW“Valores com sufixo, como200k, exigem a v2.1.304 ou posterior”), a Referência de configurações (sandbox.allowNestedUserNamespaces, nível de usuário ou gerenciado), a página de configuração do auto mode (/auto-mode-setup), a página de custos (“O atalhofrequer Claude Code v2.1.305 ou posterior”) e a página do ultrareview (--trust-workspace), consultadas em 23 de outubro de 2026; dist-tags do npm lidas no mesmo dia: latest e next 2.1.310 (publicada em 23 de outubro, 21:20 UTC), stable 2.1.308. O comportamento padrão do tool search com uma URL base personalizada e o aviso de retomada nos planos Pro/Max constam apenas nas notas de lançamento até essa data. ↩↩ -
Use o Claude Code na nuvem (“A grafia antiga
--remoteainda funciona como alias obsoleto de--cloud”), Automatize o trabalho com tarefas agendadas (“Crie tarefas agendadas, antes chamadas de routines”; “o alias/routinespara/schedule”), Compartilhe a saída da sessão como artifacts (“Os templates estão em beta. Eles vêm ativados por padrão nos planos Pro, Max e Team”; a tabela Desativar artifacts), a página Variáveis de ambiente (CLAUDE_CODE_ARTIFACT_AUTO_OPEN,CLAUDE_CODE_DISABLE_WORKFLOWS,CLAUDE_CODE_MAX_TURNS;CLAUDE_CODE_WORKFLOWSnão aparece mais na lista), a Referência de configurações (enableWorkflows: “os workflows ficam ativados, a menos que você esteja no plano Pro, em que ficam desativados”) e Deixe o Claude coordenar o trabalho contínuo com Projects, toda a documentação do Claude Code consultada em 26 de outubro de 2026;claude --helpna 2.1.310 lista--cloud [description|session_id|url]. ↩ -
CHANGELOG do Claude Code, v2.1.311 a v2.1.317 e as releases do GitHub v2.1.311 (26 de outubro de 2026) a v2.1.317 (2 de novembro de 2026; npm às 23:57 UTC); Acelere as respostas com o fast mode (“O fast mode para o Opus 4.8 foi descontinuado em 30 de outubro de 2026 e será removido em 30 de novembro de 2026”); Configuração de modelos (“Digitada no prompt do terminal, a palavra também pode elevar aquele turno ao esforço
xhigh”; “Requer Claude Code v2.1.311 ou posterior”); Todas as configurações (permissions.blockWritesOutsideWorkingDirectories,idleCompaction,disableRemoteControl); Variáveis de ambiente (CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT,CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK,CLAUDE_CODE_SYNC_SKILLS,CLAUDE_CODE_TRANSCRIPT_LOCAL_GC,CLAUDE_CODE_SKIP_PROMPT_HISTORY,CLAUDE_CODE_DISABLE_CFC_PROMPT,FORCE_HYPERLINK); Referência de ambientes auto-hospedados (--hold-idle-file,--max-hold-min). Tudo consultado em 2 de novembro de 2026. ↩