Pular para o conteúdo principal
Claude Code rastreia automaticamente as edições de arquivo do Claude conforme você trabalha, permitindo que você desfaça rapidamente as alterações e reverta para estados anteriores se algo sair do caminho.

​
Como o checkpointing funciona

Conforme você trabalha com 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 em larga escala sabendo que sempre pode retornar a um estado de código anterior.

​
Rastreamento automático

Claude Code rastreia todas as alterações feitas por suas ferramentas de edição de arquivo:
  • Cada prompt do usuário cria um novo checkpoint
  • Os checkpoints persistem entre sessões, para que você possa acessá-los em conversas retomadas
  • Limpeza automática junto com as sessões após 30 dias (configurável)

​
Rewind e resumo

Pressione Esc duas vezes (Esc + Esc) ou use o comando /rewind para abrir o menu de rewind. Uma lista rolável mostra cada um dos seus prompts da sessão. Selecione o ponto em que deseja agir e escolha uma ação:
  • Restaurar código e conversa: reverte tanto o código quanto a conversa para esse ponto
  • Restaurar conversa: reverte para essa mensagem mantendo o código atual
  • Restaurar código: reverte as alterações de arquivo mantendo a conversa
  • Resumir a partir daqui: compacta a conversa a partir deste ponto em diante em um resumo, liberando espaço da context window
  • Cancelar: retorna à lista de mensagens sem fazer alterações
Após restaurar a conversa ou resumir, o prompt original da mensagem selecionada é restaurado no campo de entrada para que você possa reenviá-lo ou editá-lo.

​
Restaurar vs. resumir

As três opções de restauração revertam o estado: elas desfazem alterações de código, histórico de conversa ou ambos. “Resumir a partir daqui” funciona de forma diferente:
  • As mensagens antes da mensagem selecionada permanecem intactas
  • A mensagem selecionada e todas as mensagens subsequentes são substituídas por um resumo compacto gerado por IA
  • Nenhum arquivo no disco é alterado
  • As mensagens originais são preservadas na transcrição da sessão, para que Claude possa fazer referência aos detalhes se necessário
Isso é semelhante ao /compact, mas direcionado: em vez de resumir toda a conversa, você mantém o contexto inicial em detalhes completos e apenas compacta as partes que estão usando espaço. Você pode digitar instruções opcionais para orientar o que o resumo se concentra.
Resumir mantém você na mesma sessão e compacta o contexto. Se você quiser ramificar e tentar uma abordagem diferente enquanto preserva a sessão original intacta, use fork em vez disso (claude --continue --fork-session).

​
Casos de uso comuns

Os checkpoints são particularmente úteis quando:
  • Explorando alternativas: tente diferentes abordagens de implementação sem perder seu ponto de partida
  • Recuperando de erros: desfaça rapidamente as alterações que introduziram bugs ou quebraram a funcionalidade
  • Iterando em recursos: experimente variações sabendo que você pode reverter para estados funcionais
  • Liberando espaço de contexto: resuma uma sessão de depuração verbosa a partir do ponto médio em diante, mantendo suas instruções iniciais intactas

​
Limitações

​
Alterações de comando Bash não rastreadas

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

​
Alterações externas não rastreadas

O checkpointing rastreia apenas arquivos que foram editados na sessão atual. Alterações manuais que você faz em arquivos fora do Claude Code e edições de outras sessões simultâneas normalmente não são capturadas, a menos que aconteçam de modificar 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 em checkpoints como “desfazer local” e Git como “histórico permanente”

​
Veja também