Guia de campo do Claude Code em português

Plan mode no Claude Code: planejar antes de mexer no código

O plan mode (modo de planejamento) faz o Claude ler, explorar e escrever um plano sem editar nada até você aprovar. Abaixo, os três jeitos de entrar, o que cada botão de aprovação faz, a diferença para o accept edits, o opusplan e o cuidado com o bypass. É a seção 2.3 do guia (p. 20), conferida na doc oficial em português, lida em 18/10/2026.

O que o plan mode faz

A doc define em uma linha: "O modo plan diz a Claude para pesquisar e propor mudanças sem realizá-las." E detalha: "Claude lê arquivos, executa comandos shell para explorar e escreve um plano, mas não edita sua fonte." Ele separa duas coisas que costumam vir juntas: entender o problema e mexer no código. Deixar o Claude ir direto ao código pode produzir código que resolve o problema errado (p. 20).

Três jeitos de entrar

Shift+Tab durante a sessão. Partindo do modo auto, a ordem da volta é manual, accept edits e plan: o terceiro toque chega ao plan (p. 20). A barra de status mostra ⏸ plan mode on. Shift+Tab de novo sai sem aprovar nada.
/plan no começo de um pedido: entra no modo e já planeja aquele pedido, como em /plan corrija a falha de login.
Já na abertura, pelo terminal, no PowerShell como em qualquer outro:

claude --permission-mode plan

Aprovar o plano: o que cada botão faz

Quando o plano fica pronto, o Claude o apresenta e pergunta como seguir. Na tela os botões aparecem em inglês; a doc em português os traduz assim:

Na tela	Na doc	O que acontece
Yes, and use auto mode	"Sim, e usar modo automático"	Aprova e segue no modo auto, sem pedir licença a cada passo. Sem auto disponível, o botão vira Yes, auto-accept edits.
Yes, manually approve edits	"Sim, aprovar edições manualmente"	Aprova e pergunta antes de cada edição.
No, keep planning	"Não, continuar planejando"	Fica no plano; diga o que mudar.

Antes de aprovar, dá para corrigir o plano à mão: "Pressione Ctrl+G para abrir o plano proposto em seu editor de texto padrão e editá-lo diretamente antes de Claude prosseguir." Aprovar tira a sessão do plan mode; para planejar de novo, Shift+Tab ou /plan no próximo pedido.

Plan mode ou accept edits?

Os dois aparecem na mesma volta do Shift+Tab, e a dúvida é comum. A tabela de modos da doc separa assim o que roda sem perguntar:

Modo	Roda sem perguntar	Melhor para
`acceptEdits`	Leituras, edições de arquivo e comandos comuns do sistema de arquivos	Iterar sobre código que você está revisando
`plan`	Leituras, mais comandos aprovados pelo classificador quando o modo automático está disponível	Explorar uma base de código antes de alterá-la

Em resumo: no accept edits ele já edita; no plan ele só propõe. Os seis modos, e por que a sessão começa no auto, estão em modos de permissão.

Opus para planejar, Sonnet para executar: o opusplan

Quem busca "plan mode opus sonnet" procura o alias opusplan. A doc o descreve como "Modo especial que usa opus durante o modo de planejamento, depois muda para sonnet para execução". Ele se escolhe em /model, como qualquer modelo. O argumento da doc: "Isso combina o raciocínio do Opus para planejamento com a eficiência do Sonnet para execução."

Plan mode como padrão do projeto

Para todo projeto abrir planejando, a doc manda "defina defaultMode como plan em .claude/settings.json":

{
  "permissions": {
    "defaultMode": "plan"
  }
}

No VS Code isso não vale para o painel: "defina claudeCode.initialPermissionMode como plan em suas configurações de usuário do VS Code em vez disso". Como o Claude Code roda no editor está em Claude Code no VS Code e no Cursor.

O cuidado que pega: bypass

O bloqueio de edição tem uma exceção. A doc: "Exceto em sessões interativas de terminal com permissões de bypass disponíveis, edições permanecem bloqueadas até que você aprove o plano." Se você abriu a sessão com --dangerously-skip-permissions ou --allow-dangerously-skip-permissions, o Claude é instruído a só planejar, mas uma edição ou comando que ele tente roda sem perguntar (p. 20). Fora do terminal interativo, como no claude -p, o bloqueio vale sempre.

Quando pular o plano

O plano tem custo (p. 20). Se você consegue descrever a mudança numa frase (um erro de digitação, uma linha de log, um nome de variável), peça direto (p. 20). O plan mode paga quando a mudança é grande ou o código é desconhecido. Os outros atalhos da sessão estão em comandos do Claude Code.

Fora do livro: code.claude.com/docs/pt/permission-modes, common-workflows e model-config, lidas em 18/10/2026.