Plan Mode no Claude Code: faça ele planejar antes de editar

Acontece direto: você pede uma mudança e, antes de entender o que está rolando, o Claude já editou seis arquivos. Às vezes dá certo. Às vezes ele entendeu errado o pedido — e agora você precisa caçar tudo que mudou.

Tem um botão que resolve isso: Shift+Tab. Ele coloca o Claude Code no Plan Mode (modo plano), onde o Claude pesquisa o projeto e te entrega um plano — sem tocar no código até você aprovar. É a diferença entre "atira primeiro, pergunta depois" e "combina antes, executa com precisão".

Se você ainda não tem o Claude Code rodando, comece pela instalação e depois volte aqui.

Os três modos do Shift+Tab

Antes do Plan Mode, entenda o atalho que governa tudo: o Shift+Tab cicla entre três modos de permissão. A barra de status (lá embaixo do terminal) mostra em qual você está:

• Padrão — o Claude lê arquivos sozinho, mas pede sua permissão antes de editar um arquivo ou rodar um comando. É o modo de quem quer revisar cada passo.
• Aceitar edições (⏵⏵ accept edits on) — o Claude cria e edita arquivos na pasta de trabalho sem perguntar. Ótimo pra iterar rápido quando você confia na direção e vai revisar depois com git diff.
• Plano (⏸ plan mode on) — o Claude pesquisa e propõe, mas não edita seu código-fonte até você dar o aval.

Aperte Shift+Tab uma vez para ir ao "aceitar edições", de novo para o "plano", e mais uma para voltar ao padrão. Simples assim.

Atenção a um mito comum: Plan Mode não é "modo congelado". O Claude ainda lê arquivos e roda comandos de exploração pra entender o projeto e montar o plano. Ele só não mexe no seu código. É "pesquisar e propor", não "ficar parado".

Como entrar no Plan Mode

Tem três caminhos, escolha o que cair melhor:

# 1. Dentro da sessão: aperte Shift+Tab até ver "⏸ plan mode on"
 
# 2. Só para o próximo pedido: comece a mensagem com /plan
/plan adicione paginação na listagem de produtos
 
# 3. Já abrindo o Claude direto em modo plano:
claude --permission-mode plan

Quis sair do modo plano sem aprovar nada? Shift+Tab de novo e pronto.

O fluxo na prática

A mágica aparece quando você usa o Plan Mode como primeira etapa de qualquer tarefa que não seja trivial. O roteiro:

1. Entre em modo plano (Shift+Tab).
2. Descreva a tarefa com contexto. Quanto mais claro, melhor o plano: "adicione login com Google, sem quebrar o fluxo de e-mail/senha atual".
3. O Claude lê os arquivos relevantes e te entrega um plano — o que vai mexer, em que ordem, o que pode dar errado.
4. Você revisa. Gostou? Aprova. Não gostou? Dá feedback e ele refina.

A própria Anthropic resume o jeito de trabalhar em quatro fases: Explorar → Planejar → Implementar → Commitar. O Plan Mode é a ferramenta oficial das duas primeiras. Um bom plano faz o resto quase rodar sozinho.

A hora de aprovar (essa é a sacada)

Quando o plano fica pronto, o Claude pergunta como você quer seguir. As opções:

• Aprovar e revisar cada edição — ele executa, mas para e pede sua permissão a cada mudança. Máximo controle.
• Aprovar e aceitar edições — ele implementa direto, sem pedir a cada passo. Você revisa no fim.
• Aprovar e começar em modo auto — para deixar ele tocar a tarefa de ponta a ponta (quando disponível na sua conta).
• Continuar planejando — você responde com ajustes e ele reescreve o plano.

Repare: aprovar um plano já te coloca no modo de execução escolhido. Não precisa trocar de modo na mão depois.

E tem dois detalhes que poucos conhecem:

• Ctrl+G abre o plano no seu editor de texto. Quer cortar uma etapa, reordenar ou acrescentar uma regra? Edita o plano à mão antes de aprovar. O Claude segue exatamente o que ficou escrito.
• Aprovar dá nome à sessão automaticamente, tirado do conteúdo do plano. Facilita demais reencontrar a conversa depois com /resume.

Deixe o Plan Mode como padrão

Trabalha num projeto onde você sempre quer revisar antes de qualquer edição? Não precisa apertar Shift+Tab toda vez. Coloque no .claude/settings.json do projeto:

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

Agora toda sessão aberta naquela pasta já nasce em modo plano. Como o arquivo fica no repositório, dá pra versionar no Git e o time inteiro herda o mesmo cuidado.

Quando o Plan Mode vale (e quando não)

Ele não é pra tudo. A régua é simples:

• Use quando você está inseguro sobre a abordagem, quando a mudança toca vários arquivos, ou quando você não conhece bem o código que vai mexer. É aí que um plano ruim custa caro — melhor pegar o erro no papel.
• Pule quando você conseguiria descrever o diff numa frase só ("renomeia essa variável", "troca o texto do botão"). Planejar o óbvio só atrasa.

Combina bem com…

O Plan Mode fica ainda mais forte ao lado de outros recursos:

• Subagentes pra explorar. Se o projeto é grande, peça pra um subagente investigar uma parte do código — só o resumo volta, sem entupir seu contexto durante o planejamento.
• Rewind como rede de segurança. Aprovou um plano e mesmo assim deu ruim? O /rewind desfaz as mudanças com checkpoints. Planejar reduz o erro; o rewind te tira do buraco quando ele escapa.
• Contexto leve. Planejamento gasta tokens lendo arquivos. Combine com as dicas de gastar menos tokens no Claude pra manter a janela enxuta.

E se você ainda tropeça no básico do dia a dia, vale revisar os erros comuns no Claude Code — "deixar o Claude editar sem plano" está entre os clássicos.

O resumo

Shift+Tab é provavelmente o atalho mais subestimado do Claude Code. Com um toque, você troca "executa e torce" por "combina e executa". Para tarefas ambiciosas, comece sempre pelo plano: leia o que o Claude pretende fazer, ajuste com Ctrl+G se precisar, e só então solte ele pra implementar. O resultado costuma sair certo de primeira — porque vocês concordaram antes de uma única linha mudar.

Fonte: documentação oficial da Anthropic, Choose a permission mode e Common workflows. Os fatos (os modos do Shift+Tab, os indicadores na barra de status, o fluxo de aprovação, o Ctrl+G e o defaultMode) vêm de lá; a redação, os exemplos e a estrutura são deste blog.