Modo plano e revisão: deixe ele pensar antes de fazer
Tarefas pequenas — criar um arquivo, mudar uma linha — o Claude Code resolve direto, e tudo bem. Mas e quando o pedido é grande? "Monte a estrutura inteira do meu site." Aí, se ele sair fazendo tudo de uma vez, você pode acabar com um monte de coisas mexidas sem entender direito o que aconteceu.
Existe um jeito muito melhor de lidar com tarefas grandes: pedir um plano antes da ação. Esse é, talvez, o hábito que mais separa quem se atrapalha de quem trabalha com tranquilidade.
A ideia: pensar antes de fazer
Imagine uma reforma na sua casa. Você não quer que o pedreiro comece a quebrar paredes no susto. Você quer que ele primeiro explique: "Vou fazer assim, depois assado, e no fim fica desse jeito." Você ouve, ajusta o que não gostou, e só então libera o trabalho.
Com o Claude Code é igual. Antes de tarefas maiores, você pede o projeto da reforma — o plano — em vez da reforma em si. Você lê, opina, corrige. Quando o plano está bom, aí sim manda executar.
Como pedir um plano
É simples assim. Antes de soltar a tarefa grande, escreva algo como:
Antes de mexer em qualquer arquivo, me explique o que você vai fazer, passo a passo. Não faça nada ainda — só me mostre o plano.
A parte mais importante é o "não faça nada ainda". Isso deixa claro que você quer só o raciocínio, não a execução. O Claude Code vai responder com uma lista de etapas: "1. Criar a pasta tal. 2. Criar o arquivo principal. 3. Adicionar o conteúdo X..." e assim por diante.
Muitas versões do Claude Code têm até um modo plano próprio, que você ativa para garantir que ele só pensa e propõe, sem tocar em nada até você dar o aval. Mas, mesmo sem botão nenhum, pedir em palavras já funciona perfeitamente.
Pare e revise o plano
Com o plano na tela, é a sua vez. Leia com calma e pergunte a si mesmo:
- Entendi o que cada passo faz? Se algum passo está confuso, peça pra ele explicar melhor.
- É isso mesmo que eu quero? Talvez ele tenha entendido diferente do que você imaginou.
- Tem algum passo que te deixa desconfortável — apagar algo, mexer onde não devia? Aponte.
Aí você responde em português: "O plano está bom, pode fazer." Ou: "Quase. No passo 3, em vez de apagar, só acrescente. E pula o passo 5 por enquanto." Ele reajusta o plano. Vocês acertam juntos antes de uma única mudança real acontecer.
Trabalhe em passos pequenos e verificáveis
Mesmo com um bom plano, evite mandar ele executar tudo de uma vez num pedido só. O melhor é avançar um passo de cada vez e conferir antes de seguir:
- Aprove o primeiro passo.
- Ele faz só aquele passo.
- Você confere o resultado — abre o arquivo, olha o que mudou.
- Está bom? Vá pro próximo. Não está? Ajuste agora, enquanto é uma coisinha só.
A vantagem é enorme. Se algo sai diferente do esperado, você descobre cedo, quando ainda é fácil corrigir. É a diferença entre notar um errinho na primeira parede e descobrir a casa inteira torta no fim.
Esse é o conceito de revisar a cada etapa em vez de soltar tudo e torcer. Passos pequenos e verificáveis te mantêm no controle do começo ao fim — e, de quebra, você vai entendendo o projeto enquanto ele cresce.
Quando o plano é dispensável
Nem tudo precisa de plano. Para tarefas minúsculas e sem risco — "corrija esse erro de português", "crie um arquivo de notas" —, pedir um plano só atrasa. Use o bom senso: quanto maior e mais arriscada a tarefa, mais vale parar pra planejar. Tarefa grande, planeje. Tarefa pequena, vá direto.
Se algo der errado
- Ele começou a fazer mesmo eu querendo só o plano. Você esqueceu de avisar "não faça nada ainda". Recuse a ação na tela de permissão e reforce: "Pare. Só quero o plano por escrito, sem mexer em nada."
- O plano veio gigante e assustador. Peça pra simplificar: "Me explique em menos passos e em linguagem mais simples." Ou quebre o projeto em pedaços: "Vamos fazer só a primeira parte hoje."
- Você aprovou o plano mas o resultado não bateu com ele. Acontece. É só apontar a diferença: "Você disse que ia fazer X no passo 2, mas ficou diferente. Pode ajustar?" Conferir a cada etapa existe justamente pra pegar isso cedo.
Com isso você fecha o conjunto de habilidades essenciais pra trabalhar com o Claude Code no terminal: você sabe como ele enxerga suas pastas, como pedir tarefas reais, como as permissões te protegem, como ensinar o projeto pelo CLAUDE.md e como planejar antes de agir. No próximo post, a gente começa a juntar tudo isso para tirar do papel o seu primeiro projeto de verdade, do início ao fim.