Mestre do Claude
Voltar pro blog
5 min de leitura

Claude Code /rewind: desfaça mudanças com checkpoints

Tutorial em pt-BR do /rewind do Claude Code: checkpoints automáticos para desfazer edições, voltar a conversa, restaurar código e liberar contexto — com o que ele NÃO desfaz.

Claude Code /rewind: desfaça mudanças com checkpoints

Acontece com todo mundo: você pede uma mudança "simples", o Claude sai editando seis arquivos, e de repente algo que funcionava parou de funcionar. O reflexo é entrar em pânico e tentar lembrar o que era cada coisa antes.

Não precisa. O Claude Code guarda um checkpoint a cada passo — e dá pra voltar no tempo com dois toques no Esc. É a rede de segurança que deixa você pedir tarefas ambiciosas sem medo de quebrar tudo.

Se você ainda não tem o Claude Code rodando, comece pela instalação e depois volte aqui.

O que é o checkpoint (sem complicar)

Pensa no checkpoint como um ponto de salvamento de videogame. Antes de cada edição que o Claude faz, o Claude Code tira uma "foto" do estado do seu código. Se a próxima jogada der errado, você carrega o save anterior e tenta de novo.

Dois fatos importantes sobre como isso funciona:

  • Cada prompt seu cria um novo checkpoint. A cada mensagem que você envia, nasce um ponto de retorno.
  • Eles sobrevivem ao fechar a sessão. Você acessa os checkpoints mesmo numa conversa retomada dias depois. Por padrão, são limpos junto com a sessão após 30 dias (prazo configurável).

Ou seja: é segurança da sessão, automática, sem você precisar configurar nada.

Como voltar no tempo: o /rewind

Tem dois jeitos de abrir o menu de retorno:

/rewind

Ou, mais rápido ainda, aperte Esc duas vezes com a caixa de mensagem vazia.

Atenção a um detalhe: se você tiver texto digitado na caixa, o Esc duplo primeiro limpa o texto em vez de abrir o menu. Não se preocupe — o texto vai pro histórico, e você recupera com a seta . Aperte Esc Esc de novo (agora com a caixa vazia) pra abrir o menu.

O menu mostra a lista de cada prompt que você enviou na sessão. Você escolhe pra qual ponto quer voltar — e, principalmente, o que quer trazer de volta.

As três formas de restaurar (essa é a sacada)

Aqui mora o poder do recurso. Voltar no tempo não é tudo-ou-nada. Ao escolher um ponto, você decide:

  • Restore code and conversation — volta os dois: o código e o histórico do chat ao estado daquele momento. É o "desfazer completo".
  • Restore code — desfaz só as edições de arquivo e mantém a conversa. Perfeito pra quando a ideia era boa mas a execução saiu torta: você guarda o contexto da discussão e só limpa os arquivos pra tentar de novo.
  • Restore conversation — rebobina só a conversa e mantém o código atual. Útil quando você gostou do resultado nos arquivos, mas quer reescrever o pedido a partir de um ponto anterior.

Depois de restaurar a conversa, tem um carinho do Claude Code: o prompt original daquela mensagem volta pra caixa de texto. Você reenvia como estava, ou edita antes de mandar — ótimo pra testar uma abordagem diferente a partir do mesmo ponto de partida.

E se você abriu o menu só pra olhar? Escolha Never mind e volta tudo como estava, sem mudar nada.

Bônus: liberar contexto sem perder o trabalho

O mesmo menu tem duas opções que não desfazem nada — elas comprimem parte da conversa num resumo, liberando espaço na janela de contexto:

  • Summarize from here — troca a mensagem escolhida (e tudo depois dela) por um resumo, mantendo o começo intacto. Bom pra descartar uma discussão paralela que não foi pra frente.
  • Summarize up to here — troca tudo antes da mensagem por um resumo, mantendo o trecho recente em detalhe. Bom pra enxugar a conversa de setup e seguir com a janela mais leve.

É como o /compact, mas cirúrgico: em vez de resumir a conversa inteira, você escolhe qual lado comprimir. As mensagens originais continuam no transcript da sessão, então o Claude ainda pode consultar os detalhes se precisar. Se economizar contexto é uma dor sua, vale combinar isso com as dicas de gastar menos tokens no Claude.

O que o rewind NÃO desfaz (leia isto)

Essa é a parte que evita um falso senso de segurança. O checkpoint rastreia apenas as edições feitas pelas ferramentas de arquivo do Claude: Write, Edit e NotebookEdit. Fora disso, ele é cego:

  • Comandos de terminal não são rastreados. Se o Claude rodar algo como rm arquivo.txt, mv antigo.txt novo.txt ou sed -i, essas mudanças não podem ser desfeitas pelo rewind. Pra esse tipo de operação, sua rede é o Git.
  • Mudanças externas não são capturadas. Edições que você faz na mão fora do Claude Code, ou de outra sessão rodando em paralelo, normalmente não entram — a não ser que toquem nos mesmos arquivos da sessão atual.

Por isso a recomendação oficial da Anthropic é direta: o checkpoint é um "desfazer local"; o Git é o "histórico permanente". Um não substitui o outro. Continue commitando seu trabalho — o rewind é pra recuperação rápida dentro da sessão, não pra versionamento de longo prazo.

Quando o rewind salva o seu dia

Na prática, é o recurso que você mais agradece nestes momentos:

  • Testar caminhos diferentes — experimente uma implementação, e se não gostar, volte ao ponto de partida e tente outra sem perder nada.
  • Sair de um buraco — o Claude introduziu um bug e a coisa virou bola de neve? Rebobine pro último estado que funcionava.
  • Iterar com coragem — saber que dá pra voltar te deixa pedir mudanças mais ousadas, porque o custo do erro caiu.

Esse é o espírito: com uma rede embaixo, você arrisca mais — e produz mais.

Por onde continuar

A ideia central: você não precisa ter medo de deixar o Claude trabalhar. Antes de cada edição, ele já salvou o jogo. Errou? Esc Esc, escolhe o ponto, e segue em frente — só não esqueça que comando de terminal é assunto do Git.


Fonte: documentação oficial da Anthropic, Checkpointing. Os fatos (checkpoints automáticos a cada prompt, as opções de restaurar/resumir, o prazo de 30 dias e o que o rewind não rastreia) vêm de lá; a redação, os exemplos e a estrutura são deste blog.

Perguntas frequentes

Como abro o menu de rewind no Claude Code?

Tem dois jeitos: digite /rewind na caixa de mensagem, ou aperte Esc duas vezes com a caixa de texto vazia. Atenção: se houver texto digitado, o Esc duplo primeiro limpa o texto (ele vai pro histórico, dá pra recuperar com a seta pra cima) — aperte de novo pra abrir o menu.

O rewind desfaz tudo que o Claude fez?

Não. Os checkpoints rastreiam só as edições feitas pelas ferramentas de arquivo do Claude (Write, Edit e NotebookEdit). Mudanças feitas por comandos de terminal — como rm, mv, cp ou sed -i — NÃO são capturadas e não podem ser desfeitas pelo rewind. Pra essas, conte com o Git.

Qual a diferença entre restaurar código, conversa, ou os dois?

No menu você escolhe: 'Restore code and conversation' volta os dois ao ponto escolhido; 'Restore conversation' rebobina só a conversa e mantém o código atual; 'Restore code' desfaz só as edições de arquivo e mantém a conversa. Útil quando você quer manter o histórico mas voltar os arquivos, ou o contrário.

Por quanto tempo os checkpoints ficam guardados?

Eles persistem entre sessões — você acessa mesmo numa conversa retomada depois — e são limpos junto com a sessão após 30 dias por padrão (esse prazo é configurável). Ou seja, é uma rede de segurança da sessão, não um histórico permanente.

Checkpoint substitui o Git?

Não. A própria Anthropic descreve o checkpoint como 'desfazer local' e o Git como 'histórico permanente'. Use o rewind pra recuperação rápida durante a sessão e continue commitando no Git pra versões, branches e histórico de longo prazo. Os dois se completam.


Curtiu? Receba os próximos por email.

Sem spam, sem newsletter chata. Só o que vale.

Cadastrar email