O Claude Code rastreia automaticamente as edições de arquivos do Claude enquanto você trabalha, permitindo que você desfaça mudanças rapidamente e reverta para estados anteriores se algo sair dos trilhos.

​
Como os checkpoints funcionam

Enquanto você trabalha com o Claude, o checkpointing captura automaticamente o estado do seu código antes de cada edição. Esta rede de segurança permite que você persiga tarefas ambiciosas e de grande escala sabendo que sempre pode retornar a um estado anterior do código.

​
Rastreamento automático

O Claude Code rastreia todas as mudanças feitas por suas ferramentas de edição de arquivos:
  • Cada prompt do usuário cria um novo checkpoint
  • Os checkpoints persistem entre sessões, então você pode acessá-los em conversas retomadas
  • Automaticamente limpos junto com as sessões após 30 dias (configurável)

​
Revertendo mudanças

Pressione Esc duas vezes (Esc + Esc) ou use o comando /rewind para abrir o menu de reversão. Você pode escolher restaurar:
  • Apenas conversa: Reverta para uma mensagem do usuário mantendo as mudanças do código
  • Apenas código: Reverta mudanças de arquivos mantendo a conversa
  • Código e conversa: Restaure ambos para um ponto anterior na sessão

​
Casos de uso comuns

Os checkpoints são particularmente úteis quando:
  • Explorando alternativas: Experimente diferentes abordagens de implementação sem perder seu ponto de partida
  • Recuperando de erros: Desfaça rapidamente mudanças que introduziram bugs ou quebraram funcionalidades
  • Iterando em recursos: Experimente com variações sabendo que pode reverter para estados funcionais

​
Limitações

​
Mudanças de comandos bash não são rastreadas

O checkpointing não rastreia arquivos modificados por comandos bash. Por exemplo, se o Claude Code executar: 
rm file.txt
mv old.txt new.txt
cp source.txt dest.txt
Essas modificações de arquivos não podem ser desfeitas através da reversão. Apenas edições diretas de arquivos feitas através das ferramentas de edição de arquivos do Claude são rastreadas.

​
Mudanças externas não são rastreadas

O checkpointing apenas rastreia arquivos que foram editados dentro da sessão atual. Mudanças manuais que você faz em arquivos fora do Claude Code e edições de outras sessões concorrentes normalmente não são capturadas, a menos que modifiquem os mesmos arquivos da sessão atual.

​
Não é um substituto para controle de versão

Os checkpoints são projetados para recuperação rápida no nível da sessão. Para histórico de versão permanente e colaboração:
  • Continue usando controle de versão (ex. Git) para commits, branches e histórico de longo prazo
  • Os checkpoints complementam mas não substituem o controle de versão adequado
  • Pense nos checkpoints como “desfazer local” e Git como “histórico permanente”

​
Veja também