Lendo, editando e aprovando um plano

Ler o plano com olhar crítico

O plan mode só entrega valor se você lê o plano de verdade, e não o aprova no automático. Quando o Claude Code termina de pensar, ele apresenta o plano e pergunta como você quer seguir. Esse é o momento de vestir o chapéu de revisor. Leia os passos propostos e faça a si mesmo três perguntas: isso resolve o problema que eu pedi? Falta algum passo importante, como rodar os testes ou tratar um caso de borda? Há algum passo arriscado que eu prefiro fazer de outro jeito? Um plano bem lido pega problemas que, deixados passar, custariam caro na execução.

Uma vantagem de revisar o plano, em vez de revisar só o resultado final, é o timing. No plano, um passo errado é uma linha de texto que você corrige com uma frase. No resultado, o mesmo erro já virou código, talvez espalhado por vários arquivos, mais trabalhoso de desfazer. Por isso a leitura do plano é um dos investimentos de atenção mais rentáveis do Claude Code: poucos minutos lendo evitam longos minutos consertando. E, com a prática, você aprende a farejar rápido os sinais de um plano que precisa de ajuste, como passos vagos, ausência de verificação ou uma abordagem mais complicada do que o problema pede.

Editar o plano antes de aprovar

Nem sempre o plano vem perfeito, e você não precisa aceitá-lo como está nem rejeitá-lo por inteiro. O Claude Code deixa você editar o plano proposto antes de aprová-lo, abrindo-o no seu editor de texto para você mudar o que quiser. Assim, se o plano tem cinco passos e só o terceiro está errado, você corrige aquele passo e mantém o resto. É a diferença entre um plano ditado pelo agente e um plano construído a quatro mãos: ele propõe, você refina, e a versão que roda é a que os dois concordam. Esse controle fino sobre o plano é o que faz do plan mode uma ferramenta de colaboração, não só de aprovação.

Editar o plano é especialmente útil quando você tem um conhecimento que o agente não tem: uma restrição do projeto, uma decisão de negócio, um detalhe histórico. Em vez de deixá-lo executar um plano que ignora isso e corrigir depois, você injeta o seu conhecimento direto no plano. Por exemplo, se um passo propõe mudar uma parte que você sabe ser intocável, você reescreve o passo ali mesmo. O resultado é um plano melhor do que o agente sozinho ou você sozinho conseguiriam, porque combina o que ele descobriu explorando o código com o que só você sabe sobre o contexto.

Se o plano ainda não convence mesmo depois de uma edição, existe a opção de continuar planejando: em vez de aprovar, você dá um retorno ao agente e ele refina o plano com base no que você disse. Isso é útil quando o plano está no caminho, mas você quer explorar uma alternativa ou aprofundar um trecho antes de comprometer-se. Planejar em rodadas, com idas e voltas, é perfeitamente normal em tarefas complexas. O importante é que nada disso toca no seu código: toda essa conversa acontece no papel, e a obra só começa quando o projeto está do jeito que você quer.

Escolher o modo de execução ao aprovar

Aprovar um plano não é um botão único; é uma escolha de como o agente vai executá-lo, que conecta direto com o módulo de permissões. Ao aprovar, você decide em qual modo a execução acontece. Pode pedir para revisar cada edição, o que mantém o controle máximo e é indicado quando o plano toca partes sensíveis. Pode aprovar aceitando as edições, deixando o agente aplicar as mudanças e você revisar pelo resultado, bom quando você confia no plano. E pode aprovar de forma mais automática, para o agente seguir com menos interrupções. A escolha segue a mesma lógica de sempre: mais controle no sensível, mais autonomia no que você confia.

Repare como o plan mode e os modos de permissão se encaixam num fluxo único. O plan mode cuida da fase de projeto, garantindo que a obra só comece com um plano aprovado. A escolha do modo na aprovação cuida da fase de obra, decidindo quanto o agente age sozinho ao executar. Juntos, eles dão um controle fino sobre todo o ciclo: você planeja com calma, revisa o projeto, e então libera a execução no nível de autonomia que a tarefa merece. Essa combinação, planejar antes e escolher a autonomia depois, é o coração de um uso maduro e seguro do Claude Code em tarefas grandes.