Prompt falhou no Claude Code: reescrever do zero ou corrigir por cima?

Fala aí, beleza? Você manda o primeiro prompt, o Claude Code sai rodando, e o que volta não é nem de longe o que você pediu

Aí vem a bifurcação: você escreve "não, não era isso, faz assim" e segue na mesma conversa, ou apaga tudo e escreve um enunciado novo do zero?

Parece detalhe, mas escolher errado aqui custa caro

Insistir numa conversa contaminada faz o modelo continuar puxando pro caminho errado, e recomeçar sem necessidade joga fora contexto bom que já estava construído

Neste post eu separo os sinais objetivos de cada lado, com as ferramentas que o Claude Code já traz pra sustentar as duas decisões 🙂

Corrigir por cima x reescrever do zero: comparação lado a lado

Antes dos sinais, a foto geral

Os dois caminhos mexem em coisas diferentes: um preserva o histórico, o outro preserva o código, e nem sempre você quer preservar os dois

Formação Recomendada

Formação Claude Code

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

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Repare numa coisa: nem tudo cabe nessas duas colunas

/compact fica no meio do caminho

Ele pede ao modelo um resumo da conversa e substitui o histórico por esse resumo, e aceita instruções no formato /compact [instruções]

Ou seja, você mantém o fio da meada sem carregar cada tentativa falha linha por linha

O rewind (Esc + Esc ou /rewind) é o outro híbrido, e é o mais mal entendido dos dois

Ele não é o botão de recomeço total: o menu deixa restaurar código e conversa, restaurar só a conversa mantendo o código atual, ou restaurar só o código mantendo a conversa

Quer dizer, dá pra voltar os arquivos pro ponto anterior sem jogar fora o enunciado que você já tinha construído, e aí aquele esforço "Alto" da tabela cai pra perto de zero

Por isso o rewind não mora na coluna do /clear, ele atravessa as duas

Sinais de que é hora de recomeçar (e sinais de que ajustar resolve)

Um filtro rápido antes: se o Claude Code nem sobe direito na sua máquina, o problema não é o enunciado, é ambiente, e isso se resolve nos erros comuns na instalação

Agora, assumindo que a ferramenta está rodando redondo

Recomece do zero quando:

• O assunto mudou

A documentação de boas práticas do Claude Code recomenda resetar o contexto entre tarefas não relacionadas, porque sessão longa carregada de contexto irrelevante derruba o desempenho

Nova tarefa, nova sessão, simples assim

• A conversa já tem uma trajetória de erro pendurada

Esse ponto tem respaldo além do achismo

O Recovery-Bench é um benchmark de código aberto criado e mantido pela Letta, que inicializa agentes com ambientes e históricos de ações vindos de trajetórias que falharam

O que ele mostra é forte: o desempenho de recuperação difere de forma marcante do desempenho a partir de contexto limpo

Os modelos são distraídos ou induzidos ao erro pelas tentativas falhas presentes no contexto, a tal poluição de contexto

Traduzindo pro seu dia: recuperar é uma capacidade DIFERENTE de resolver do zero

Se o histórico está cheio de caminho errado, você está pedindo pro modelo jogar no modo difícil sem precisar

• Você já não consegue explicar o desvio numa frase

Se a correção precisa de três parágrafos pra desfazer suposições anteriores, o enunciado novo sai mais barato que a emenda

Ajuste na mesma conversa quando:

• O desvio é pontual e o resto do caminho está certo

Arquivo errado, biblioteca errada, um detalhe do formato de saída, esse tipo de coisa

A documentação de boas práticas é direta: os melhores resultados vêm de ciclos curtos de feedback, e corrigir rápido costuma produzir soluções melhores mais depressa

• Você percebeu o erro enquanto ele ainda estava rodando

Um toque em Esc interrompe o Claude no meio da ação preservando o contexto, e você redireciona ali mesmo

É o cenário mais barato de todos, aproveite

• O contexto acumulado é caro de reconstruir

Se o Claude já mapeou a estrutura do projeto e você jogaria fora tudo isso, ajustar tende a compensar

E se essa parte de "explicar o projeto de novo" é o que te cansa, vale organizar o primeiro prompt do dia pra não recomeçar do absoluto zero toda vez

Como recomeçar sem perder o que já funcionava

Recomeçar não é fechar o terminal e chorar, beleza? 😀

O Claude Code cria um checkpoint a cada prompt enviado, e tira um snapshot dos arquivos antes de cada alteração

Isso é justamente o que torna o recomeço barato

1. Interrompa na hora com um toque em Esc

Isso para o Claude no meio da ação com o contexto preservado, e te devolve o controle pra redirecionar

O erro comum deste passo: deixar a execução terminar mesmo já tendo visto o desvio, e depois ter que desfazer o dobro de coisa

2. Abra o menu de rewind com Esc + Esc ou com /rewind

/rewind

O erro comum deste passo: esperar as opções de restaurar código sempre aparecerem

Elas só aparecem quando o checkpoint selecionado tem alterações de arquivo rastreadas pra reverter

Sem edições capturadas depois daquele ponto, o menu mostra apenas restaurar conversa, as opções de resumo e cancelar

3. Escolha o tipo de restauração

São três: restaurar código e conversa, restaurar a conversa mantendo o código atual, ou restaurar o código mantendo a conversa

Essa separação é o pulo do gato do "recomeçar sem perder o que funcionava": dá pra manter o código bom e limpar só o papo, ou o contrário

4. Antes de zerar, peça o resumo

O rewind permite pedir ao Claude que resuma o que aprendeu e gere uma mensagem de handoff, a opção de resumir a partir de um ponto da conversa (summarize from here), pelo menu ou por /rewind

O erro comum deste passo: pular ele e apagar junto o aprendizado que custou meia hora

5. Zere a conversa com /clear

/clear

Ele inicia uma conversa nova e vazia mantendo a memória de projeto

Se a sua intenção não é apagar e sim enxugar, use /compact, que resume a conversa e troca o histórico pelo resumo, aceitando instruções no formato /compact [instruções]

6. Saiba que dá pra voltar depois

As sessões são salvas continuamente em arquivos de transcrição locais e podem ser retomadas depois de sair ou de rodar /clear, via /resume ou pela entrada de sessão anterior no menu de rewind

Saber disso tira o medo de apertar o /clear

7. Não trate o rewind como controle de versão

Esse é O erro comum da lista toda, e o mais caro

O checkpointing não rastreia arquivos modificados por comandos bash, então o que os rm, mv e cp da vida fizeram não volta pelo rewind, só as edições feitas pelas ferramentas de edição de arquivo do Claude são rastreadas

Ele também só rastreia arquivos editados dentro da sessão atual: alteração manual feita fora do Claude Code e edição de outra sessão simultânea normalmente não são capturadas, a menos que toquem os mesmos arquivos da sessão atual

E symlinks e hard links ficam de fora

A própria documentação recomenda usar os checkpoints em COMBINAÇÃO com controle de versão, como complemento e não substituto

Tome cuidado aqui, é o tipo de coisa que só ensina doendo

8. Previna o próximo prompt falho com o modo de planejamento

Entra com Shift+Tab até aparecer Plan Mode abaixo do campo de texto, ou prefixando o prompt com /plan

Nesse modo o Claude pesquisa e propõe as mudanças sem executá-las, usando ferramentas somente de leitura

E tem o detalhe massa: Ctrl+G abre o plano proposto no seu editor de texto padrão, então você edita o plano antes do Claude seguir

Aprovar o plano sai do modo de planejamento

Corrigir o plano é sempre mais barato que corrigir o código que o plano gerou, porque no plano você mexe em texto e no código você mexe em arquivo, teste e tudo que veio pendurado 🙂

Veredito: qual caminho custa menos retrabalho

Sem enrolação e sem meio-termo forçado

Corrigir por cima vence enquanto o desvio for pontual e a tarefa for a mesma

É o cenário do ciclo curto de feedback que a documentação de boas práticas recomenda, e o Esc existe exatamente pra isso: parar, redirecionar, seguir com o contexto de pé

Reescrever do zero vence quando o assunto mudou ou quando o histórico está contaminado

Troca de tarefa pede reset de contexto por recomendação oficial, e trajetória de erro no contexto é justamente o que o Recovery-Bench mostra atrapalhando a recuperação dos modelos

A boa notícia é que recomeçar dentro da sessão é barato: cada prompt enviado cria um checkpoint, e o Claude tira um snapshot dos arquivos antes de cada alteração

Você volta pro ponto certo, escolhe se leva o código, a conversa ou os dois, e toca o barco

A condição pra isso funcionar continua a mesma: o controle de versão fazendo a parte dele, porque o rewind cobre as edições do Claude e não as suas nem as dos comandos bash

Veja o Claude Code em ação

Se você ainda não viu o fluxo do Claude Code rodando de ponta a ponta, esse vídeo do canal serve de porta de entrada

Ele mostra a construção de um app completo do zero até o deploy, com o Claude Code no volante

Depois de ver o fluxo inteiro, os comandos deste post param de ser sopa de letrinhas e viram reflexo

Conclusão

O critério de decisão cabe em uma linha: desvio pontual na mesma tarefa se corrige, assunto novo ou histórico contaminado se reescreve

O resto é ferramenta: Esc pra redirecionar, Esc + Esc ou /rewind pra voltar no checkpoint escolhendo o que preservar, /compact pra enxugar o histórico, /clear pra zerar mantendo a memória de projeto e /resume pra voltar depois

E o próximo passo acionável, o que realmente diminui a frequência dessa dúvida: antes do próximo prompt grande, entre no modo de planejamento com Shift+Tab, leia o plano, ajuste com Ctrl+G e SÓ então aprove

Quanto melhor o plano, menos vezes você vai precisar escolher entre reescrever e corrigir 😀

até o próximo post!