Planejar antes ou codar direto no Claude Code: quando cada um compensa?

Todo mundo faz uma escolha antes de apertar Enter, e quase ninguém percebe que está escolhendo

Ou você pede um plano e revisa antes de qualquer arquivo ser tocado, ou você manda o pedido e deixa o Claude Code sair editando

Os dois caminhos são legítimos, e nenhum dos dois é "o certo" sempre

A resposta muda conforme o tipo de tarefa, e é exatamente isso que eu vou separar aqui: onde planejar antes paga, onde ele só te custa contexto, e o que mudou no caminho de codar direto 🙂

O que o plan mode faz (e o que ele bloqueia):

O plan mode é o modo de permissão em que o Claude Code lê, busca e roda comandos de exploração, mas não edita arquivos de origem antes da sua aprovação

Essa é a linha inteira: leitura e pesquisa liberadas, escrita travada

Se você conhece aquele fluxo de abrir um PR e revisar o diff antes do merge, é a mesma ideia, só que antes do código existir

Como entrar e como sair:

São quatro formas de ligar, e todas valem:

1. Pressione Shift+Tab até a barra de status mostrar ⏸ plan mode on

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 110 aulas
• 4 projetos
• 9h 2min

Conhecer formação

O erro comum deste passo: dar um toque só e achar que ligou. O Shift+Tab cicla entre os modos, então confirme olhando a barra de status, não a memória muscular

2. Prefixe um prompt único com /plan quando você quer planejar só aquele pedido, sem mudar o modo da sessão

3. Inicie a sessão já em plan mode pela linha de comando:

claude --permission-mode plan

4. Para deixar o plan mode como padrão das sessões de terminal de um projeto, defina o defaultMode no .claude/settings.json:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

O erro comum deste passo: escrever defaultMode solto na raiz do arquivo. Ele mora dentro de permissions

Repara no escopo, porque isso confunde muita gente: o .claude/settings.json é o arquivo de configuração DO PROJETO, vale só ali dentro. Existe também o arquivo de settings do usuário, o ~/.claude/settings.json, que é a sua config pessoal. Mesma chave, arquivos diferentes, escopos diferentes

E pra sair sem aprovar nada, é o mesmo atalho da entrada: Shift+Tab de novo e você sai do plan mode sem aprovar o plano

E na hora que o plano aparece?

Aqui está a parte que muita gente ignora: a aprovação não é só um "ok"

Ao apresentar o plano, o Claude Code te dá opções que definem em qual modo de permissão a sessão continua: aprovar e usar auto mode, aprovar e aceitar edições, aprovar e revisar cada edição manualmente, ou No, keep planning pra seguir planejando com o seu feedback

Ou seja, a aprovação é também o momento em que você escolhe quanta rédea vai dar dali pra frente

E dá pra mexer no plano antes de aprovar

Ctrl+G abre o plano proposto no seu editor de texto padrão

Na extensão do VS Code o plano abre automaticamente como documento Markdown completo, com comentários inline, então tu marca "esse arquivo não, esse trecho sim" direto no texto

Tem ainda o showClearContextOnPlanAccept, uma configuração que adiciona uma primeira opção de aprovação: aprova o plano E limpa o contexto de planejamento. Guarda esse nome, ele volta lá na frente

Se você quiser a visão passo a passo de planejar antes de executar mudanças, tem post separado aqui no blog só sobre isso

Tudo isso encaixa no fluxo de quatro fases que a própria documentação de boas práticas recomenda: explorar (em plan mode), planejar, codar e commitar

A justificativa oficial é seca: deixar o Claude ir direto pro código pode produzir código que resolve o problema errado

Codar direto mudou: o auto mode agora é o padrão

Se faz um tempo que você não olha os modos de permissão, o caminho "mandar codar direto" não é mais o que era

Os modos disponíveis hoje são: default (exibido como Manual na CLI), acceptEdits, plan, auto, dontAsk e bypassPermissions

O destaque é o auto

No auto mode um segundo modelo, um classificador, revisa as ações em vez de você, com checagens de segurança rodando em segundo plano e menos pedidos de permissão na sua cara

É como ter um revisor sentado ao lado que só te chama quando a coisa cheira mal

E ele virou o padrão: a partir de 14 de agosto de 2026, o auto mode é o modo de permissão padrão para novas sessões nos planos Pro, Max e Team

Calma se você configurou outra coisa

Quem já tinha um defaultMode diferente no arquivo de settings do usuário, aquele ~/.claude/settings.json que eu separei lá em cima do arquivo do projeto, mantém as sessões nesse modo, e o Claude Code pergunta uma única vez se você quer mudar pro auto mode

E a rede de segurança?

Vale nos dois caminhos, e é bom saber disso antes de escolher: regras de negação (deny) bloqueiam em TODOS os modos, inclusive no bypassPermissions

Então o deny é o seu chão, não o modo de permissão

Ah, e um aviso pra quem chegou aqui procurando: o research preview Ultraplan foi removido, comando e keyword

O substituto indicado é o plan mode local mesmo, ou o Claude Code na web

Plan mode x codar direto: comparação lado a lado

Em que tarefa cada caminho ganha

Agora o coração da coisa

Esquece "sempre planeje", isso é conselho de quem nunca perdeu meia hora planejando um if

Mudança pontual em arquivo que você conhece: direto ganha

Você sabe o arquivo, sabe a linha, sabe o que quer

Pedir plano aqui é pedir pro Claude te devolver em três parágrafos aquilo que você já tinha na cabeça

Manda direto

Correção de bug já diagnosticado: direto ganha

Diagnóstico feito é meio caminho: a causa você já sabe, falta aplicar

O plano viraria uma repetição do que você acabou de descobrir

Direto, e revisa o diff

Refatoração ampla que atravessa vários arquivos: plano ganha

Aqui a conta vira

Refatoração que atravessa a base é onde o Claude precisa entender antes de mexer, e mexer errado em cinco arquivos é bem mais caro que ler um plano

E tem um detalhe bom: quando está em plan mode e precisa entender a base de código, o Claude Code delega a pesquisa ao subagente Plan, mantendo a saída da exploração em uma janela de contexto separada

Ou seja, a bagunça da leitura não desce pra sua conversa principal 😀

Feature nova em base que você não conhece: plano ganha

Base estranha é o cenário clássico de "achei que era assim"

Aqui entra um outro subagente, e vale marcar que são dois nomes diferentes na documentação, não é o mesmo do tópico anterior: o Plan é o que o Claude Code aciona durante o plan mode, e o Explore é acionado quando o Claude precisa buscar ou entender uma base de código sem fazer alterações, com o nível de profundidade escolhido na chamada: quick, medium ou very thorough

Pra feature nova em terreno desconhecido, é aí que a exploração paga

Se a dúvida é mais básica, tipo saber se a tarefa vale delegar, o filtro é outro e vem antes desse

Requisito ainda vago: plano ganha, e ganha fácil

Quando nem você sabe direito o que quer, o plano é o lugar mais barato de errar

Corrigir uma frase no plano custa uma frase

Corrigir depois custa diff, revisão e retrabalho

Abre com Ctrl+G, reescreve o que está torto, ou deixa comentário inline se você usa a extensão do VS Code

O custo de planejar demais (e como perceber)

Essa parte quase ninguém escreve, e é a que mais dói

Sintoma: a sessão está longa, o plano virou um documento genérico cheio de "considerar" e "avaliar", e as respostas foram piorando ao longo da conversa

Causa: a documentação de boas práticas parte justamente dessa restrição, a janela de contexto enche rápido e o desempenho piora conforme ela enche

Planejar em looping é uma das formas mais eficientes de encher contexto sem produzir nada 😛

Solução, em ordem de esforço:

1. Delegue a exploração aos subagentes. Cada subagente roda na própria janela de contexto e só a mensagem final volta pra conversa principal, então chamada e resultado intermediário não entopem o seu fio

2. Aprove em vez de refinar pra sempre. O No, keep planning é ótimo pra UMA correção de rumo, não pra cinco rodadas seguidas

O erro comum deste passo: usar o No, keep planning como se fosse conversa. Se você já sabe o que quer mudar, edita o plano no Ctrl+G e aprova

3. Use a opção que limpa o contexto de planejamento na aprovação, habilitando o showClearContextOnPlanAccept. Você aprova e entra na implementação sem carregar toda a exploração nas costas

4. Saia do plan mode com Shift+Tab no instante em que a tarefa ficou clara. Não precisa terminar o plano só porque começou

Como prevenir: escolha o modo pelo TIPO da tarefa antes de começar, não no meio dela

Trocar de modo no meio é sintoma de que o pedido não estava definido

Veredito: qual usar como padrão

Sem cima do muro, a régua que eu usaria:

Se você não consegue descrever a mudança em uma frase e apontar os arquivos, planeje

Se consegue, vai direto

Só isso, e funciona pra quase tudo

Fixar "defaultMode": "plan" no .claude/settings.json do projeto faz sentido em base grande, legada ou compartilhada por time, onde uma edição errada respinga em gente que não está na sua sessão

Já pra projeto pessoal, script, protótipo e mexida do dia a dia, o auto mode padrão dos planos Pro, Max e Team já resolve, com o classificador revisando as ações e as suas regras de deny segurando o que não pode ser tocado

Uma honestidade necessária: essa comparação é feita com base no comportamento documentado de cada modo

Não tem alegação de teste próprio aqui, nem número de economia de tempo ou de token, porque medição oficial disso eu não achei e chutar métrica é o tipo de coisa que eu acho zoado fazer

Conclusão

O dilema não é "plan mode ou codar direto", é "eu sei o suficiente pra pular a exploração?"

Próximo passo prático: pega a tarefa mais confusa da sua lista, entra no plan mode com Shift+Tab e roda ela planejada

Depois pega uma tarefa pequena e manda direto

Compara não a velocidade, compara o RETRABALHO que cada caminho gerou

Esse número é seu, e é o único que importa na sua base

Me conta nos comentários qual modo virou padrão na sua máquina, e por quê

até o próximo post! =)