Modo plan do Claude Code: pesquisar primeiro, aprovar e só então codar
O modo plan é a diferença entre guiar o Claude Code e corrigi-lo no meio do caminho. Este walkthrough cobre o atalho Shift+Tab, o que o Claude pode e não pode fazer enquanto planeja, as opções de aprovação e a tabela de modos que diz qual usar quando.
Resumo
- Pressione Shift+Tab para ciclar os modos de permissão até a linha de status ler "plan mode on" — nesse modo o Claude pesquisa e propõe, mas não edita seus arquivos.
- Você também pode digitar /plan antes de um prompt, ou iniciar com claude --permission-mode plan.
- Ctrl+G abre o plano proposto no seu próprio editor para você reescrever antes de o Claude tocar em qualquer código.
- Aprovar um plano sai do modo plan e troca a sessão para o modo escolhido: modo auto ou aprovações manuais de edição. Mais um Shift+Tab sai do modo plan sem aprovar.
The Explore → Plan → Code → Commit workflow (official)
Canal: Claude — official YouTube channel3:12
Permission modes — official docs (plan mode)
Docs: code.claude.com/docs
As capturas vêm do walkthrough oficial Explore → Plan → Code → Commit da Anthropic; só foram usados trechos limpos de tela — trechos com apresentador ficaram de fora. Cada fato foi conferido com a documentação oficial de permission-modes.
Os carimbos de tempo dos quadros apontam de volta para o vídeo de origem. Claude Code é uma marca da Anthropic; este guia é independente e sem vínculo.
Rodar um ciclo completo de planejamento
Entrar no modo plan
- 1
Entender para que serve o modo plan
O fluxo de trabalho oficial do Claude Code é explore, plan, code, commit — e o modo plan é onde os dois primeiros passos acontecem mais rápido. O Claude lê arquivos, explora em somente leitura e escreve um plano de ação antes de uma única linha do seu código mudar.
O enquadramento do próprio walkthrough oficial: explorar e planejar primeiro, para a fase de código ter menos surpresas.Assistir em 0:20 - 2
Entrar com Shift+Tab
Pressione Shift+Tab para ciclar os modos de permissão e fique de olho na linha de status: default (rotulado manual), accept edits, modo plan e depois os opcionais bypass e auto. Pare quando ler "plan mode on". No Windows sem entrada VT, Alt+M faz o mesmo. Prefere um prefixo? Digite /plan antes do seu prompt.
A linha de status vira "plan mode on (shift+tab to cycle)" — a prova visível de que você está planejando, não editando.Assistir em 0:59 - 3
Saber onde o modo plan fica no ciclo
O ciclo do Shift+Tab roda default → accept edits → plan, com bypass permissions (se ativado) e o modo auto entrando depois do plan; do auto, a primeira pressão volta para o default. Cada modo responde a uma pergunta: quanto o Claude pode fazer sem te perguntar? A tabela de modos abaixo detalha cada opção.
Deixar o Claude pesquisar e propor
- 4
Dar ao Claude um prompt de pesquisa
Descreva o resultado, não a implementação: "Preciso adicionar conversão para webp ao nosso pipeline de upload de imagens. Descubra em que ponto do pipeline isso deveria acontecer, se precisamos de dependências novas e como abordar a coisa." Perguntas como onde, se e como empurram o Claude a investigar antes de propor.
Um prompt de planejamento real do walkthrough oficial, digitado enquanto a linha de status mostrava que o modo plan estava ligado.Assistir em 0:40 - 5
Deixar explorar — nada é editado
No modo plan o Claude lê arquivos e pode rodar comandos de shell para explorar; edições ficam bloqueadas até você aprovar um plano. Ele pode até levantar subagentes Explore para mapear a codebase — com o modo auto disponível, um classificador examina qualquer comando que não seja somente leitura em vez de te perguntar toda hora.
VS Code rodando o Claude Code no modo plan com dois subagentes Explore mapeando estrutura e estilos enquanto as edições ficam bloqueadas.Assistir em 2:50 - 6
Revisar o plano proposto
O plano volta como mudanças concretas, arquivo por arquivo — adicionar uma dependência aqui, trocar o handler de upload ali. É o momento mais barato de corrigir a rota: nada foi escrito ainda, e a discussão guarda o contexto que moldou o plano para a fase de código.
Um plano proposto listando mudanças por arquivo: adicionar sharp, mudar a rota de upload para memory storage, converter no handler.Assistir em 0:50 - 7
Editar o arquivo do plano com Ctrl+G
Não gostou da redação? Pressione Ctrl+G e o plano proposto abre no seu próprio editor (ele vive em ~/.claude/plans/) para você reescrever direto antes de o Claude seguir. O Claude também escreve o plano refinado nesse arquivo, que você pode pré-visualizar na sessão.
O plano atualizado na sessão com o modo plan ainda ligado — o Claude escreve e mantém o arquivo do plano conforme a discussão evolui.Assistir em 0:34
Revisar, editar, aprovar — ou dar o fora
- 8
Escolher a opção de aprovação certa
Aprovar oferece três caminhos: sim com modo auto (o Claude segue movendo com checagens de segurança em segundo plano), sim com edições aprovadas à mão (você confirma cada edição) ou não — continuar planejando, o que devolve o Claude com seu feedback. Uma quarta saída de emergência está sempre disponível: digite o que mudar em vez de aprovar.
O prompt de aprovação do plano: auto-accept edits, aprovar edições manualmente, continuar planejando — mais ctrl+g para editar antes o arquivo do plano.Assistir em 1:20 - 9
Saber o que acontece depois da aprovação
Aprovar sai do modo plan e troca a sessão para o modo que a sua escolha descreve. A sessão também ganha um título gerado a partir do plano aprovado, então fica fácil reconhecê-la depois no agent view ou no seu histórico de sessões.
- 10
Ou sair sem aprovar
Mais um Shift+Tab sai do modo plan sem aprovar nada — a pesquisa fica no contexto, mas nenhum plano é aceito e nenhuma edição é liberada. A alternativa na hora de iniciar: claude --permission-mode plan abre uma sessão já planejando.
Hábitos que deixam os planos melhores
- 11
Dar entradas melhores ao plano
Planos só são tão bons quanto a verdade que você aponta para eles: mantenha uma suíte de testes que o Claude consiga rodar, dê ferramentas para ele verificar o próprio trabalho (a extensão Claude in Chrome para trabalho de UI, por exemplo) e escreva critérios de sucesso explícitos no CLAUDE.md para todo plano herdar.
- 12
Construir o hábito do modo plan
Recorra ao modo plan sempre que uma tarefa tocar mais de uns poucos arquivos, quando a abordagem estiver nebulosa ou quando o custo de um erro de rota for alto. Para consertos de uma linha, o modo accept edits é mais rápido. Corrigir no plano sempre custa menos do que no meio do código.
Modo plan vs accept edits vs auto vs manual
Cada posição do Shift+Tab e o que o Claude pode fazer sem perguntar em cada uma:
- 1default (rotulado manual) — leitura é livre; todo o resto te pergunta. O padrão seguro.
- 2acceptEdits — edições de arquivos e comandos comuns de sistema de arquivos (mkdir, touch, mv, cp…) rodam sem perguntar; você revisa depois via git diff.
- 3plan — leitura mais exploração somente leitura; edições ficam bloqueadas até você aprovar um plano, e aí a sessão muda para o modo que você escolheu.
- 4auto — tudo roda, com um modelo classificador à parte bloqueando ações que escalam além do seu pedido. Reduz perguntas; não garante segurança.
- 5bypassPermissions — tudo roda imediatamente sem checagens de segurança; só aparece se você ativou, e admins podem desativar por completo. dontAsk é um modo só de configuração que nega tudo o que perguntaria.
Regra de bolso: plan para pensar, acceptEdits para iterar com confiança, auto para corridas longas e confiáveis, manual para qualquer coisa sensível — e deixe a linha de status do Shift+Tab decidir, não o piloto automático.