Checkpointing

Rastreie, reverta e resuma as edições e conversas do Claude para gerenciar o estado da sessão.

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
• Resumir até aqui: compacta a conversa antes deste ponto em um resumo, mantendo as mensagens posteriores intactas
• Nunca importa: retorna à lista de mensagens sem fazer alterações

Após restaurar a conversa ou escolher Resumir a partir daqui, o prompt original da mensagem selecionada é restaurado no campo de entrada para que você possa reenviá-lo ou editá-lo.

Escolher Resumir até aqui o deixa no final da conversa com a entrada vazia.

Restaurar vs. resumir

As opções de restauração revertam o estado: elas desfazem alterações de código, histórico de conversa ou ambos. As opções de resumo compactam parte da conversa em um resumo gerado por IA sem alterar arquivos no disco:

• Resumir a partir daqui: as mensagens antes da mensagem selecionada permanecem intactas. A mensagem selecionada e tudo depois dela são substituídos por um resumo. Use isso para descartar uma discussão lateral mantendo o contexto inicial em detalhes completos.
• Resumir até aqui: as mensagens antes da mensagem selecionada são substituídas por um resumo. A mensagem selecionada e tudo depois dela permanecem intactas, e você permanece no final da conversa. Use isso para compactar a discussão de configuração inicial mantendo o trabalho recente em detalhes completos.

Em ambos os casos, as mensagens originais são preservadas na transcrição da sessão, para que Claude possa fazer referência aos detalhes se necessário. Você pode digitar instruções opcionais para orientar o que o resumo se concentra. Isso é semelhante ao /compact, mas direcionado: em vez de resumir toda a conversa, você escolhe qual lado da mensagem selecionada compactar.

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

• Modo interativo - Atalhos de teclado e controles de sessão
• Comandos - Acessando checkpoints usando /rewind
• Referência CLI - Opções de linha de comando