Plan mode do Claude Code: como quebrar um plano grande em etapas que dá para revisar

Fala aí, beleza? Tu pede um plano, espera algo enxuto, e o Claude Code devolve uma lista com um monte de frentes ao mesmo tempo

Refactor, migração, teste novo, renomear pasta, mexer em config, tudo empilhado no mesmo plano

Aí bate aquela sensação ruim: você olha, não consegue revisar nada linha a linha, e acaba aprovando no chute (ou trava e não aprova nada)

Se liga nisso: o problema não é o plan mode

Ele tá fazendo exatamente o que promete, ou seja, pesquisar e propor mudança sem aplicar

O problema é o ESCOPO do que foi pedido, e escopo é decisão sua, não do modelo

Esse post cobre o caminho inteiro: como entrar em plan mode, como perceber que o plano inchou, o critério pra decidir o que sai primeiro, como pedir a versão menor sem perder o resto, o que fazer quando o plano volta grande do mesmo jeito e onde guardar o que ficou pra depois…

O que você precisa antes de cortar o plano

Primeiro o óbvio: tem que estar em plan mode mesmo, senão o Claude já sai editando

Três formas de entrar:

• Apertar Shift+Tab até a barra de status mostrar ⏸ plan mode on (a doc fala em "até aparecer", não em um número fixo de pressionadas)
• Rodar /plan, que entra em plan mode antes de uma mudança grande, e que também funciona como prefixo do próximo prompt
• Já abrir a sessão planejando, direto na linha de comando:

claude --permission-mode plan

E o que muda estando lá dentro?

Segundo a documentação de permission modes, em plan mode o Claude lê arquivos, roda comandos de shell pra explorar e escreve um plano, mas não edita seu código fonte

As edições ficam bloqueadas até você aprovar o plano (exceto em sessões com bypass permissions disponível)

Detalhe que confunde bastante gente: nos planos Pro, Max e Team o auto mode é o modo de permissão inicial embutido

Ou seja, é dali que o ciclo do Shift+Tab começa, e por isso aquela receita de "aperta X vezes" nem sempre bate com o que aparece na sua tela

Outra coisa importante: o sandbox do Bash e o auto mode funcionam de forma independente e se combinam, menos em plan mode, onde o auto-allow não amplia aprovações

Traduzindo: estar planejando não é uma brecha pra liberar mais coisa, é o contrário 🙂

Como saber que o plano ficou grande demais

Não existe número oficial que defina isso, então pode esquecer a regrinha de "passou de X passos, divide"

O que existe são sinais práticos:

• Várias frentes independentes na mesma lista: dá pra entregar o passo 2 sem o passo 7? Se dá, são dois planos, não um
• Passos que dependem de decisão que você ainda não tomou: tipo "criar a tabela nova" quando nem ficou decidido se vai ter tabela nova
• Trechos que você não consegue revisar linha a linha: se você leu e pensou "ah, deve tá certo", isso não foi revisado, foi aceito
• O plano cita arquivo que você não faz ideia de onde saiu

A orientação oficial de boas práticas vai bem nessa linha: separar pesquisa e planejamento da implementação evita resolver o problema errado

E a recomendação da Anthropic é trabalhar passo a passo em vez de pedir solução de uma tacada só

É o mesmo problema da skill que virou um manual: quanto mais coisa você enfia num artefato único, menos alguém consegue auditar aquilo

Plano revisável é plano pequeno, não tem jeito

Passo a passo: reduzir o escopo do plano antes de aprovar

Bora ver na prática?

1. Leia o plano inteiro antes de responder qualquer coisa. Aqui o Ctrl+T ajuda: ele alterna a visualização da lista de tarefas no modo interativo, então dá pra ver o conjunto sem ficar rolando o chat pra cima e pra baixo. O erro comum deste passo: responder no reflexo, porque a pergunta de como proceder aparece logo depois do plano e a mão vai sozinha no enter

2. Aplique o critério de corte. A pergunta é uma só: qual é a MENOR fatia que fecha sozinha e que eu consigo revisar linha a linha? Essa sai primeiro, o resto vira "próxima sessão". Frente de limpeza costuma ser a mais perigosa de misturar, porque apagar código com segurança já é um trabalho inteiro por si só. O erro comum deste passo: cortar por tamanho ("deixa os 5 primeiros passos") em vez de cortar por entrega, e sobrar uma metade que não funciona sozinha

3. Responda No, keep planning. Quando o plano fica pronto, o Claude pergunta como proceder e oferece três opções:

O erro comum deste passo: achar que "keep planning" é recomeçar do zero. Não é, a sessão segue em plan mode e você só fala o que mudar

4. Peça a versão menor com uma frase de escopo explícita. Frase vaga tipo "deixa mais simples" devolve o mesmo plano com adjetivos diferentes. Seja chato no limite:

Corta esse plano. Quero só a primeira fatia: <o que precisa sair primeiro>
Não toque em <frente que fica pra depois>
No fim do plano, liste em uma linha cada o que ficou de fora, sem detalhar

Reescreva o plano com um único objetivo: <objetivo>
Se um passo não for necessário pra esse objetivo, remova o passo
Não crie arquivo novo fora de <arquivo ou pasta>

O erro comum deste passo: dizer só o que tirar e não dizer o que é o objetivo. Sem objetivo, o Claude reencaixa as frentes cortadas achando que tá ajudando

5. Edite o plano direto, se for mais rápido que explicar. Ctrl+G abre o plano proposto no seu editor de texto padrão, e na extensão do VS Code dá pra revisar e editar os planos antes de aceitar. Às vezes apagar quatro linhas na mão resolve o que três prompts não resolveriam. O erro comum deste passo: assumir que o atalho se comporta igual em qualquer terminal ou integração (no agent view o Ctrl+G segue por padrão o binding chat:externalEditor do contexto de Chat)

6. Aprove só a fatia. Aprovar um plano sai do plan mode e troca a sessão para o modo de permissão descrito na opção escolhida, e o Claude começa a editar. Então a aprovação é o ponto de não retorno da revisão, não um "ok, continua pensando". O erro comum deste passo: aprovar com auto-accept quando você ainda queria olhar cada edição

Quando o plano volta grande de novo: o que fazer

Acontece. Você corta, pede de novo, e volta um plano do mesmo tamanho com outros nomes

Sintoma: o Claude reincorpora as frentes que você cortou

Causa provável: as versões antigas do plano ainda estão na conversa inteirinhas, então o "contexto" dele inclui tudo o que você mandou tirar

Solução: rode /compact, que resume as mensagens antigas preservando o contexto importante (ele precisa de conversa prévia suficiente pra resumir)

Depois repita a frase de escopo, curta e direta

Sintoma: o contexto já está carregado demais pra planejar com foco

Causa provável: memória, arquivos CLAUDE.md e ferramentas MCP ocupando espaço antes mesmo de você falar qualquer coisa

Solução: /context mostra um detalhamento ao vivo do uso do contexto por categoria, com sugestões de otimização e quais arquivos CLAUDE.md e de memória foram carregados

E /context all mostra quantos tokens cada ferramenta MCP carregada está usando

Se tiver muito entulho, /clear reseta a conversa pra contexto vazio. A conversa anterior continua em disco e pode ser retomada passando o session ID pra opção de resume, então não é perda, é gaveta

Sintoma: você aprovou sem querer

Causa provável: enter no automático na pergunta de como proceder (clássico!)

Solução: Esc duas vezes ou /rewind abre o menu de rewind, que volta código e conversa pra um checkpoint, ou resume a partir de uma mensagem selecionada

Como prevenir

• Corrija assim que perceber que saiu do trilho, porque loops de feedback curtos entregam resultado melhor e mais rápido
• Pra voltar a planejar, cicle com Shift+Tab ou prefixe o próximo prompt com /plan
• Não conte com janela grande pra salvar escopo grande: a janela de 1 milhão de tokens existe, mas é suportada só por parte dos modelos, e mesmo nela o plano que você não consegue ler continua o plano que você não consegue revisar

Cabe mais coisa no contexto, não na sua cabeça 😀

O que fazer com o que ficou de fora

Cortar não é jogar fora, é empilhar pra depois

Algumas formas de guardar o que sobrou:

• Registre o escopo restante no próprio plano antes de aprovar: peça pro Claude listar no fim do plano as frentes que ficaram de fora. É o jeito mais barato de não esquecer, já que você vai ler esse texto de novo
• Use o session ID depois de um /clear: a conversa anterior fica em disco e pode ser retomada passando o session ID pra opção de resume, então a sessão "encerrada" segue lá com o plano completo
• Quebre workflow complexo em subagents especializados em vez de tentar resolver tudo num prompt só. A orientação da Anthropic é justamente essa, e o efeito colateral é bom: fica mais fácil debugar e a qualidade da saída melhora

E um aviso pra quem leu post antigo por aí: o /ultraplan não existe mais

A research preview e a keyword ultraplan foram removidas, e a orientação oficial hoje é usar plan mode pra planejamento local, ou o Claude Code na web pra sessões na nuvem

Se você viu isso num tutorial, o tutorial tá velho, beleza?

Conclusão

Recapitulando: plano revisável é plano pequeno, e o corte é decisão sua

O plan mode te dá o espaço certo pra isso, já que o Claude pesquisa e propõe sem editar, e as edições ficam bloqueadas até a aprovação (exceto em sessões com bypass permissions disponível)

O critério é sempre o mesmo: a menor fatia que fecha sozinha e que você consegue revisar linha a linha sai primeiro, o resto fica anotado pra próxima

Próximo passo bem concreto: no próximo plano gigante que aparecer, antes de qualquer aprovação, responda No, keep planning e peça só a primeira fatia com a frase de escopo explícita

E se Ctrl+G e Ctrl+T viraram parte da sua rotina, dá pra customizar os atalhos: rodar /keybindings cria ou abre o arquivo em ~/.claude/keybindings.json

até o próximo post! 🙂