Claude Code entendeu errado o seu pedido? Os sinais que aparecem nas primeiras linhas da resposta

Nada dói mais que descobrir a interpretação errada depois que dezenas de arquivos já foram tocados

O prejuízo vem dobrado: você perde o tempo da execução e ainda ganha uma revisão de diff gigante pra separar o que presta do que não presta 😅

E o detalhe chato é que o aviso quase sempre estava ali, nas primeiras linhas

Quando o Claude Code começa a responder, ele normalmente devolve o pedido com as palavras dele e já engata os primeiros itens do que pretende fazer

É nesse pedacinho que o desvio aparece: o objeto trocado, o escopo inflado, a premissa que ninguém confirmou

Ler esse trecho com atenção custa alguns segundos, revisar o diff depois custa a sua tarde

Neste post eu separo os sinais que dão o desvio de graça, o que fazer no segundo em que eles aparecem, e como voltar atrás se já passou batido

Bora?

Sinal 1: a reformulação do pedido não é o seu pedido

O sintoma: as primeiras linhas repetem o seu pedido, só que com outro objeto, outro verbo ou de um jeito vago demais

Você pediu pra ajustar a validação de um formulário e a resposta abre falando em "melhorar o fluxo de cadastro"

Formação Recomendada

Formação Claude Code

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

• 116 aulas
• 4 projetos
• 9h 23min

Conhecer formação

Parece a mesma coisa, mas não é: um é uma função, o outro é meio sistema

A causa: pedido ambíguo, quase sempre

Pronome solto do tipo "arruma isso aí" ou "esse arquivo" sem alvo explícito, mais o contexto das mensagens anteriores da sessão puxando a interpretação pra outro lado

O modelo não adivinha o que ficou na sua cabeça, ele completa a lacuna com o que parece razoável

Como resolver agora: Esc interrompe o turno em andamento e você reenvia o pedido nomeando arquivo, função e resultado esperado

Sem pronome, sem "aquilo"

Como prevenir: abrir tarefa ambígua já em plan mode

No plan mode o Claude Code pesquisa e propõe mudanças sem editar os arquivos de código: ele lê, busca e roda comandos de exploração, e só então apresenta um plano pra aprovação

Ou seja, você lê a reformulação antes de qualquer edição existir

Pra entrar, Shift+Tab cicla os modos de permissão, ou você prefixa um único prompt com /plan

/plan
Corrigir a validação de e-mail em src/forms/signup.ts, na função validateEmail.
Não alterar nenhum outro arquivo.

Se a reformulação ainda voltar torta, o problema não é o modelo, é o pedido

Sinal 2: o escopo do plano é maior que o pedido

O sintoma: os primeiros itens do plano já listam pastas, refatorações e arquivos que você nunca mencionou

Você pediu uma função, o plano abre com "reorganizar a estrutura de testes"

Se liga nisso: escopo inflado é o desvio mais caro, porque ele parece produtivo

A causa: pedido genérico convida solução ampla

Quando falta alvo, o modelo preenche a lacuna com o que parece útil, e útil pra ele nem sempre é o que você queria hoje

Esse mesmo mecanismo aparece quando o Claude Code responde genérico demais: a resposta cresce pra cobrir o que não foi dito

Como resolver agora: com o plano na tela, o Claude Code pergunta como proceder e oferece três opções: Yes, and use auto mode, Yes, manually approve edits e No, keep planning

A terceira é a sua amiga aqui: continua planejando, nada é editado

Dá também pra abrir o plano proposto no seu editor de texto padrão com Ctrl+G e cortar na unha os itens fora de escopo antes do Claude prosseguir

Como prevenir: delimite o alvo no próprio prompt e leia o plano inteiro antes de aprovar

Tome cuidado: aprovar o plano sai do plan mode e troca a sessão pro modo de permissão correspondente, e o Claude começa a editar

Aquele "deixa eu aprovar só pra ver no que dá" é exatamente o momento em que você perde a janela de revisão

Sinal 3: o plano parte de uma premissa que você nunca confirmou

O sintoma: as primeiras linhas afirmam como o seu projeto funciona, ou propõem criar um arquivo ou uma estrutura nova, sem que isso tenha sido combinado com ninguém

Algo do tipo "como o projeto usa tal padrão, vou criar tal pasta"

Você lê e pensa: usa? 🤔

A causa: falta de contexto do projeto na sessão

O Claude viu alguns arquivos, inferiu um padrão e seguiu em frente com a inferência virando verdade

Como resolver agora: interrompe e responde a premissa com o fato correto, na lata

"O projeto não usa isso, a configuração vive em tal arquivo"

Ou mantém ele planejando até a premissa sumir do plano

Se a dúvida for sobre o que ele quis dizer e não sobre o que ele vai fazer, vale perguntar antes de aceitar a resposta em vez de sair corrigindo

Como prevenir: registrar as convenções no CLAUDE.md da raiz do projeto, um arquivo markdown que o Claude Code lê no início de cada sessão

Preferência que é sua e vale pra tudo que você faz vai no CLAUDE.md do diretório ~/.claude, que o Claude Code também lê

Como interromper e recalibrar na hora

O sinal apareceu, agora é velocidade

1. Aperte Esc. No modo interativo, o Esc interrompe o turno em andamento, e o que estava na fila de mensagens é enviado em seguida. Erro comum deste passo: ficar lendo mais dez linhas "pra confirmar" a suspeita. Se bateu a dúvida no começo, já era, interrompe
2. Reenvie o pedido apontando o desvio. Não repita o prompt original igualzinho, diga o que estava errado no entendimento e o que é o certo. Erro comum: mandar só "não é isso", sem dizer o que é
3. Se estiver em plan mode, responda ao plano com No, keep planning. É a opção que continua planejando sem editar. Erro comum: escolher Yes, and use auto mode ou Yes, manually approve edits só pra "ver no que dá", porque aprovar sai do plan mode e o Claude começa a editar
4. Use Ctrl+G pra editar o plano no editor padrão. Quando o plano está quase certo, é mais rápido cortar os itens fora de escopo na mão que descrever tudo de novo no chat. Erro comum: reescrever o pedido inteiro quando faltava só apagar dois itens
5. Shift+Tab de novo pra sair do plan mode sem aprovar o plano. Serve pra quando você decidiu que a tarefa muda de rumo e o plano não interessa mais. Erro comum: apertar Esc duas vezes com texto no campo de prompt esperando o menu de rewind, porque com texto lá o duplo Esc limpa o texto em vez de abrir o menu

Passou batido e o Claude já editou arquivos: como voltar atrás

O sintoma: você só percebeu o desvio depois das edições

Acontece, principalmente em modo automático, e não é o fim do mundo

Como resolver: abra o menu de rewind com /rewind, que tem os aliases /checkpoint e /undo, ou apertando Esc duas vezes com o campo de prompt vazio

O menu lista cada prompt enviado durante a sessão, então você escolhe o ponto de retorno e restaura o código, a conversa ou os dois

Restaurar só a conversa é ótimo quando o código está ok mas o entendimento azedou lá atrás

Os limites, pra você não se frustrar na hora errada:

• os checkpoints cobrem apenas as edições feitas pelo Claude através das ferramentas de edição de arquivo, ou seja, edição sua na mão e comando bash não entram
• o Claude Code guarda snapshots de arquivos dos 100 checkpoints mais recentes de uma sessão
• os checkpoints são apagados junto com as sessões depois de 30 dias

Como prevenir o susto: usar checkpoint junto com controle de versão, que é exatamente o que a própria documentação recomenda

Commit pequeno antes de soltar uma tarefa grande continua sendo a rede mais barata que existe

Modos de permissão: quanto acontece antes de você conseguir ler o plano

A janela pra pegar a interpretação errada muda conforme o modo em que a sessão está

A lista oficial de modos de permissão do Claude Code traz ainda o Auto mode (auto) e o Bypass permissions (bypassPermissions), que ficam de fora da tabela porque o comportamento deles não é assunto deste post

A leitura da tabela é simples: quanto mais automático o modo, MENOS janela você tem pra pegar o desvio nas primeiras linhas

No plan mode a janela é máxima, porque nada foi editado ainda

No acceptEdits ela é bem menor, já que as operações de arquivo passam sozinhas

Uma observação que economiza xingamento: Shift+Tab é atalho do modo interativo de terminal e não vale no aplicativo Desktop do Claude Code

Como reduzir o retrabalho nas próximas sessões

A rotina preventiva é curta e cabe em quatro hábitos

1. Abra tarefa ambígua em plan mode. Shift+Tab ou prefixo /plan, e use as primeiras linhas do plano como checagem de entendimento antes de qualquer coisa. Erro comum: usar plan mode e aprovar sem ler, o que dá exatamente no mesmo que não usar
2. Escreva as convenções no CLAUDE.md da raiz do projeto. O que não deve ser tocado, o formato esperado, o que o projeto usa de verdade. Ele é lido no início de cada sessão, e como é arquivo do projeto dá pra commitar no git e valer pro time inteiro. Erro comum: deixar preferência pessoal ali dentro e empurrar o seu gosto pros outros no commit

## Convenções do projeto
- Não alterar arquivos dentro de `src/legacy/`
- Toda alteração de rota precisa de teste correspondente
- Não criar pasta nova sem pedido explícito

3. Deixe as preferências pessoais no CLAUDE.md de ~/.claude. Esse é configuração sua e vale pra todos os projetos. Erro comum: esquecer que a variável de ambiente CLAUDE_CONFIG_DIR, se estiver definida, faz todos os caminhos ~/.claude passarem a ficar dentro desse diretório, e aí você fica editando o arquivo errado sem entender por que nada muda
4. Mantenha o controle de versão ativo como rede. Checkpoint cobre edição feita pelo Claude via ferramenta de arquivo, o resto é com você e com o git. Erro comum: confiar no /rewind pra desfazer o que um comando bash fez, porque isso ele não pega

Conclusão

Os segundos que você gasta lendo a reformulação do pedido e os primeiros itens do plano são o investimento mais barato da sessão inteira

Revisar dezenas de arquivos depois, não

Então o combinado é o seguinte: no próximo pedido ambíguo, entra em plan mode, lê as primeiras linhas com calma e só aprova quando o que está escrito ali for o que você pediu de verdade

E testa o /rewind uma vez agora, num momento tranquilo, só pra ver como ele se comporta antes de você precisar dele no desespero 🙂

Até o próximo post!