Programação e agentes de IA

[Claude Code #5] /rewind: restaurando o código quebrado para um checkpoint

O /rewind do Claude Code restaura o código e as conversas para checkpoints salvos automaticamente a cada prompt. Este artigo explica o menu aberto ao pressionar Esc duas vezes, as opções de restauração e resumo e o que não pode ser revertido, como efeitos colaterais do shell.

4 min de leitura
Imagem de capa de [Claude Code #5] /rewind: restaurando o código quebrado para um checkpoint

Todo mundo já pediu uma alteração à IA e se arrependeu 30 minutos depois. Se nem commit você fez, dá aquele suor frio nas costas.

O Claude Code tem um botão de voltar para situações assim: /rewind.

A cada prompt enviado, o estado do código é salvo como um checkpoint, permitindo restaurar o código e a conversa para aquele momento a qualquer hora.

Se o /branch de Claude Code, parte 4 é sobre criar ramificações, esta parte é sobre voltar atrás.

Os checkpoints se acumulam automaticamente

Com base em Documentação oficial de checkpoints, o funcionamento é o seguinte.

Um checkpoint é criado sempre que você envia um prompt de usuário. Não é preciso ativar nada nem pressionar um botão de salvar.

Os snapshots de arquivos mantêm os 100 checkpoints mais recentes por sessão. Como os checkpoints são salvos junto com a conversa, /rewind continua disponível depois que a sessão é retomada.

Abrindo o menu de voltar

Digite /rewind ou pressione Esc duas vezes com o campo de entrada vazio para abrir o menu.

O menu mostra em ordem cronológica os prompts enviados na sessão atual. Escolha o ponto para o qual quer voltar e as opções serão exibidas.

  • Restaurar código e conversa: voltar tudo para aquele ponto
  • Restaurar apenas a conversa: manter o código atual e voltar somente a conversa
  • Restaurar apenas o código: manter a conversa e desfazer somente as alterações nos arquivos

As duas opções de restauração do código só aparecem quando existem alterações rastreadas nos arquivos depois daquele ponto.

Ao restaurar a conversa, o prompt original daquele ponto é preenchido novamente no campo de entrada. Basta corrigir a instrução e enviá-la outra vez.

Diagrama da criação de checkpoints do Claude Code e das opções de restauração do /rewind
Os checkpoints se acumulam a cada prompt, e você escolhe o escopo da restauração ao voltar

Também dá para resumir em vez de voltar

O mesmo menu oferece duas opções de resumo.

Resumir a partir daqui comprime em um resumo a conversa depois do ponto escolhido. É útil para recolher uma depuração longa e recuperar espaço de contexto.

Resumir até aqui faz o contrário: comprime a parte inicial e mantém a conversa recente intacta.

O resumo não altera os arquivos, e as mensagens originais continuam no histórico da sessão. Pense nele como um /compact para marcar um ponto específico.

O que não pode ser revertido

/rewind não é uma solução universal. Ele acompanha um escopo específico.

Primeiro, ele não rastreia efeitos colaterais de comandos do shell. Arquivos alterados pelo Claude com rm ou mv não podem ser restaurados ao voltar. Só são rastreadas alterações feitas por ferramentas de edição de arquivos.

Arquivos alterados por subagentes também ficam, em geral, fora do escopo de restauração. A exceção são as fork skills executadas em primeiro plano; as edições dos subagentes em segundo plano, que são o padrão, precisam ser revertidas com git.

O mesmo vale para alterações feitas manualmente fora da sessão e para arquivos ligados por links simbólicos ou hard links. Durante a restauração, esses caminhos são ignorados e um aviso informa quantos foram pulados.

Os checkpoints também podem ser excluídos junto com a sessão depois de 30 dias. É por isso que a documentação oficial enfatiza: eles servem para recuperação rápida no nível da sessão, não substituem um sistema de controle de versão como o git.

Ilustração de uma rede de segurança segurando um notebook, com a frase SAFETY NET NOT A VAULT e um cofre do git
Checkpoints são a rede; git é o cofre

Voltando a uma conversa apagada com /clear

Logo depois de limpar a conversa com /clear, você também pode pensar: “ops”.

Dentro do mesmo processo do Claude Code, a parte superior do menu de voltar mostra uma opção para retornar à sessão anterior (v2.1.191 ou posterior). Ao selecioná-la, a conversa de antes de /clear volta intacta.

Resumo

/rewind é uma rede de segurança que restaura o código e a conversa por meio de checkpoints em cada prompt. Pressione Esc duas vezes para abri-lo.

Lembre apenas que efeitos colaterais de comandos do shell não podem ser revertidos. Deixe os experimentos dentro da sessão para /rewind e o histórico permanente para o git.

Na próxima parte, veremos /goal, que define critérios de conclusão para o Claude. Ao configurar uma meta, outro modelo verifica ao fim de cada turno se as condições foram atendidas; caso contrário, o trabalho continua.

Fontes e critérios de verificação

Continue lendo

Série Claude Code

Tópicos relacionados