Checkpoints do Claude Code: como voltar código e conversa atrás
Todo prompt do Claude Code é um checkpoint que você pode restaurar. Aprenda /rewind e o Esc duplo, as três opções de restauração, o que os checkpoints capturam (e o que não capturam), os limites de retenção e como eles complementam o git — verificado contra a documentação oficial.
A versão curta
- Checkpoints são automáticos: todo prompt que inicia um turno primeiro tira um snapshot do seu código. Não há nada para configurar — você só precisa saber como voltar atrás.
- Rode /rewind (ou pressione Esc duas vezes com o prompt vazio) para ter um menu de pontos de restauração, cada um oferecendo: restaurar código e conversa, só a conversa ou só o código.
- O rewind é recuperação em nível de sessão, não controle de versão: efeitos colaterais via Bash (rm, mv, cp), a maioria das edições de subagentes e suas próprias edições manuais não são capturadas. Continue commitando no git.
- O Claude Code mantém os 100 checkpoints mais recentes de uma sessão por cerca de 30 dias (ajuste com cleanupPeriodDays), e os checkpoints sobrevivem ao /resume — dá para rebobinar a sessão de ontem hoje.
12 Claude Code Features Every Engineer Should Know: Subagents, CLAUDE.md, Checkpoints, MCP, and more
Canal: ByteByteAI7:30
Claude Code Checkpoints Are Here (First Look)
Canal: Build at Scale8:16
Checkpointing — official documentation
Documentação oficial: code.claude.com/docs
Cada opção de restauração, limite e número de retenção desta página foi verificado contra a documentação oficial de checkpointing; os vídeos acima são as fontes visuais e factuais.
As capturas de tela pertencem aos seus criadores, com links diretos para os timestamps exatos. Nenhum quadro com rosto é usado.
Voltar atrás com checkpoints do Claude Code, passo a passo
Parte 1 — O que é capturado
- 1
Entenda o que é um checkpoint
Um checkpoint é um snapshot automático do estado do seu código, tirado antes de cada prompt que inicia um novo turno. Ele existe para que um refactor ruim, uma edição apressada ou uma direção errada estejam a um comando de serem desfeitos — sem stash, sem commit, sem cerimônia.
A proposta dos checkpoints: snapshot antes de cada edição, volta o código e a conversa sempre que um experimento capotar.Ver em 2:15 - 2
Todo prompt que inicia um turno cria um
Você não cria checkpoints à mão — cada prompt que põe o Claude a trabalhar tira snapshot dos arquivos que ele está prestes a tocar. Uma sessão longa constrói uma cadeia de pontos de restauração, um por prompt, como save states automáticos para o seu repositório.
O ciclo de edição: o Claude edita, um snapshot entra na cadeia de checkpoints e o próximo prompt começa um novo giro.Ver em 2:33 - 3
Abra o menu de rewind com /rewind
Digite /rewind no prompt para listar os checkpoints da sessão atual. O caminho de teclado é ainda mais rápido: pressione Esc duas vezes com a caixa de entrada vazia. (Se houver texto na entrada, o Esc duplo só limpa — aperte ↑ para recuperar o que você digitou.)
Digitando /rewind no prompt do Claude Code — a lista de checkpoints abre ali mesmo, dentro da sessão.Ver em 2:40 - 4
Escolha seu ponto de restauração
O menu lista cada checkpoint com o prompt que o criou — "restaurar o código e/ou a conversa para o ponto antes de…". Navegue até o momento em que as coisas deram errado, pressione Enter e escolha o que restaurar.
O menu de restauração: escolha o prompt anterior ao erro — as entradas destacadas em vermelho são perguntas anteriores desta sessão.Ver em 2:45
Parte 2 — O menu de rewind
- 5
Restaure código e conversa juntos
O rewind completo: os arquivos voltam ao estado do snapshot e a conversa bifurca de volta para aquele ponto. Use quando a direção inteira estava errada — o código e a memória que o Claude tem da tarefa são reiniciados juntos.
- 6
Restaure só o código — mantendo a conversa
Restaurar só o código reverte os arquivos enquanto a conversa fica onde está. Perfeito para "a abordagem está certa, o resultado está errado": o Claude lembra de tudo que vocês discutiram, mas as edições quebradas somem.
- 7
Restaure só a conversa — bifurque o chat
A terceira opção rebobina a conversa para um ponto anterior e deixa seus arquivos intactos — o mesmo comportamento de bifurcação que o Esc duplo tinha antes dos checkpoints. Use quando o código está bom mas a discussão desceu uma toca de coelho.
- 8
Resuma daqui em vez de voltar
O menu também oferece "Summarize from here" e "Summarize up to here" — um /compact direcionado que condensa um trecho da conversa num resumo, mantendo suas instruções iniciais. Para bifurcações de verdade, use /branch ou claude --continue --fork-session.
Parte 3 — Limites e o hábito do git
- 9
Saiba o que o rewind não desfaz
Checkpoints rastreiam as edições de arquivo que o Claude faz, não tudo: mudanças feitas via Bash (rm, mv, cp), a maioria das edições de subagentes, suas edições manuais e as mudanças de outras sessões não são capturadas. Symlinks são pulados — a restauração avisa "Restored the code, but skipped N files".
- 10
Checkpoints vs git: divida o trabalho
Checkpoints são para recuperação rápida, em nível de sessão: desfazer este prompt, tentar aquela ideia de novo. Git é para histórico permanente: comitar estados que funcionam, criar branches, push. O ritmo recomendado é rebobinar à vontade enquanto explora e comitar com intenção quando a mudança vale a pena.
- 11
Fique de olho na janela de retenção
O Claude Code mantém os 100 checkpoints mais recentes por sessão e varre snapshots antigos depois de cerca de 30 dias — o mesmo cleanupPeriodDays que governa o histórico de transcrições. Estenda no settings.json se quiser que /rewind e /resume alcancem mais para trás.
Checkpoints vs git vs /branch vs Esc duplo vs /compact
O Claude Code te dá cinco maneiras de voltar — elas resolvem problemas diferentes:
- 1Checkpoints (/rewind) — instantâneo, automático, em nível de sessão: desfaz código, conversa ou ambos até qualquer fronteira de prompt. Sem setup, não é permanente, não é compartilhado.
- 2Git — a história de verdade: commits explícitos que você faz quando o trabalho vale a pena. Checkpoints nunca o substituem; eles ficam antes dele na corrente de segurança.
- 3/branch e --fork-session — comece uma linha do tempo paralela a partir da conversa atual sem tocar em arquivos. Use quando quiser explorar uma alternativa e manter as duas linhas.
- 4Esc duplo — o caminho de teclado para o mesmo menu de rewind quando o prompt está vazio; com texto na caixa, ele só limpa a entrada (o histórico guarda, aperte ↑ para recuperar).
- 5/compact e "Summarize from here" — encolhem a conversa em vez de se mover por ela: recuperam contexto mantendo decisões, ao custo de detalhe.
Um modelo mental simples: rewind para erros, git para progresso, fork para alternativas, summarize para espaço.
O rewind não fez o que você esperava?
Quatro surpresas comuns de checkpoint e o que fazer com cada uma:
- 1"No files were restored". Os snapshots foram varridos — passaram do teto de 100 checkpoints ou da retenção de ~30 dias. Estenda o cleanupPeriodDays no settings.json para manter uma cauda mais longa.
- 2"Restored the code, but skipped N files". Symlinks e hard links são pulados por design. Rode /debug e confira ~/.claude/debug/<session-id>.txt para os caminhos exatos pulados, e reverta esses à mão.
- 3Arquivos alterados via Bash continuam iguais. rm, mv e cp rodam no shell, fora do sistema de snapshots — desfaça com git checkout ou restaure de backups.
- 4O prompt que você quer não está na lista. Mensagens na fila no meio do turno não criam checkpoints — rebobine até o prompt de início de turno mais próximo, e edições de subagentes podem precisar de um git revert.
- 5Não existe comando /rewind nenhum. Checkpoints chegaram no Claude Code 2.0 — rode claude update (ou claude doctor) para conferir sua versão, e note que sessões bem antigas, anteriores à funcionalidade, não têm snapshots para voltar.
Regra de ouro: se a mudança importa, commite. Checkpoints são o airbag, git é o cinto de segurança — use os dois.