O Claude Code fez um plano.Leia-o, comente-o e depois aprove.

O que faz o plan mode do Claude Code

No plan mode, o Claude Code lê e explora o seu projeto e depois escreve um plano. Não edita os seus ficheiros de código até aprovar o plano. Isso faz do plano o sítio mais barato para apanhar uma ideia errada: um erro no passo 3 custa um comentário, não uma funcionalidade reescrita.

Há três formas de entrar:

• Prima Shift+Tab no prompt para mudar de modo.
• Comece um prompt com /plan.
• Inicie uma sessão com claude --permission-mode plan.

Para iniciar todas as sessões em plan mode, defina defaultMode como "plan" nas definições.

Onde o Claude Code guarda os ficheiros dos planos

Por predefinição, os planos são ficheiros Markdown em ~/.claude/plans, fora do seu projeto. É fácil perdê-los de vista, e um plano aí não está no git. A definição plansDirectory move-os. Coloque-a em .claude/settings.json:

{
  "plansDirectory": "./plans"
}

O caminho é relativo à raiz do projeto. Um caminho fora do projeto, como ../plans, é ignorado e os planos voltam a ~/.claude/plans. Dentro do projeto pode fazer commit deles, revê-los num pull request e deixar a sessão seguinte relê-los.

Ler os planos no DotMD

Um plano é Markdown com títulos, listas, tabelas e muitas vezes um diagrama. O DotMD mostra-o da forma como se destina a ser lido, não como texto em bruto num terminal.

1. Adicione a pasta

   Prima ⌘O e escolha a pasta do projeto, ou a pasta de planos dentro dela. Para a localização predefinida, escolha diretamente ~/.claude/plans: na janela Abrir, ⇧⌘. mostra as pastas ocultas.

2. Veja-o aparecer

   Os novos planos surgem na barra lateral enquanto o Claude os escreve, e o ficheiro aberto recarrega quando muda. Tabelas, código e diagramas Mermaid são desenhados.

3. Leia-o do princípio ao fim

   Leia o plano todo antes de comentar. Ordem errada dos passos, uma migração em falta, um ficheiro em que o Claude não deve tocar: verá mais à segunda leitura.

Comente, não reescreva

Escrever “não, muda o passo 3 para usar o helper existente” no chat obriga o Claude a adivinhar a que passo se refere. No DotMD seleciona o passo e prime ⌥⌘M, e escreve o que deve mudar. Os comentários ficam ligados às suas linhas e nunca tocam no ficheiro.

Quando tiver percorrido o plano, diga ao Claude Code: “Go through my comments in DotMD.” Ele lê-os por MCP, corrige o plano e devolve cada comentário com uma nota. Vê cada correção no ficheiro, o texto antigo a vermelho e o novo a verde, e aceita ou reabre cada uma. Depois aprova, e o Claude começa a construir. Ligá-lo leva uma linha: veja o guia do Claude Code.

Faça o Claude enviar-lhe todos os planos

Pode pedi-lo de cada vez, ou dizê-lo uma só vez. Acrescente uma linha como esta ao seu CLAUDE.md:

After writing a plan, send it to me with request_review in DotMD
and wait for my approval before changing any code.

O Claude entrega então o plano ao DotMD e espera numa só chamada, sem gastar tokens, até clicar em Send com os seus comentários ou em Approve. O DotMD também pode acrescentar as suas regras de revisão ao seu ficheiro de instruções com um clique: veja CLAUDE.md e AGENTS.md no Mac.

Ctrl+G ou DotMD?

O Claude Code pode abrir o plano no seu editor de texto com Ctrl+G, para o alterar você mesmo. É a forma rápida de corrigir uma palavra. O DotMD serve para o outro trabalho: marcar o que o Claude deve mudar num plano longo e verificar depois o que mudou, incluindo edições que ninguém pediu. Funcionam em conjunto; use o que se adequar à correção.

Perguntas sobre os planos do Claude Code

Mais perguntas