Guia de campo do Claude Code em português

Checkpoint e /rewind no Claude Code: como desfazer uma alteração

O Claude Code guarda o estado dos arquivos antes de cada pedido seu. Isso é o checkpoint, e o /rewind (ou Esc duas vezes) volta a ele. Abaixo, como abrir o menu, o que cada ação faz, os quatro casos em que o rewind não desfaz nada e por que ele não substitui o git. É a seção 6.2 do guia (p. 53), conferida na doc oficial em inglês, baixada em 15/10/2026.

O que é um checkpoint

A doc (em inglês) é direta: todo pedido seu que começa um turno cria um checkpoint novo ("Every prompt you send that starts a turn creates a new checkpoint"). O checkpoint é a foto dos arquivos antes daquele turno. Não é preciso ligar nada: o Claude Code registra sozinho as edições que as ferramentas de edição dele fazem (p. 53).

Três detalhes da doc que mudam o uso:

Os 100 mais recentes. O Claude Code guarda as fotos dos arquivos dos 100 checkpoints mais recentes de cada sessão.
Sobrevive ao fechar. Os checkpoints são salvos com a conversa, então o /rewind funciona depois de retomar a sessão com /resume.
Não é para sempre. As fotos são apagadas na limpeza automática, por padrão cerca de 30 dias depois da última vez que a sessão gravou uma. Voltar a um checkpoint sem foto pode falhar com No files were restored.

Como abrir o menu de volta

Dois caminhos levam ao mesmo menu:

Digite /rewind no prompt.
Aperte Esc duas vezes com a caixa de texto vazia.

O detalhe que confunde: se a caixa tem texto, o Esc duplo apaga o rascunho em vez de abrir o menu. O texto não se perde: vai para o histórico, e a seta para cima o traz de volta. O menu lista os pedidos que você fez na sessão; escolha o ponto e a ação.

As ações do menu

Na tela os nomes aparecem em inglês:

Na tela	O que acontece
Restore code and conversation	Arquivos e conversa voltam àquele ponto
Restore conversation	A conversa volta; os arquivos ficam como estão
Restore code	Os arquivos voltam; a conversa fica
Summarize from here	Resume a conversa daquele ponto em diante e libera janela de contexto
Summarize up to here	Resume o que veio antes e mantém as mensagens seguintes
Never mind	Volta à lista sem mudar nada

As duas opções de código só aparecem quando há edição registrada depois do ponto escolhido. Ao restaurar a conversa, o pedido original volta para a caixa de texto, pronto para reenviar ou corrigir. O resumo é um /compact dirigido: não mexe em arquivo nenhum. Os outros comandos de contexto (/compact, /clear, /resume) estão em comandos do Claude Code.

Restore code ou Restore conversation?

A escolha depende do que deu errado. Se o código ficou ruim e a conversa estava boa (ele entendeu o pedido, mas errou a mão), Restore code desfaz os arquivos e você pede de novo com mais contexto. Se a conversa tomou um rumo ruim e você quer recomeçar o raciocínio sem perder o que já está nos arquivos, Restore conversation. Quando os dois desandaram, Restore code and conversation. Para testar outro caminho sem perder o original, a doc indica outra coisa: abrir um ramo da sessão com /branch ou claude --continue --fork-session.

O que o rewind não desfaz

É aqui que a ferramenta engana quem confia demais nela (p. 22). A doc lista os limites:

Comando do terminal. O checkpoint não registra arquivo mudado por comando Bash ou PowerShell: um rm, mv ou cp que o Claude rodou não volta pelo menu. Só voltam as edições feitas pelas ferramentas de edição dele.
Subagente. Em regra, o rewind só restaura arquivos que o Claude já tinha editado na sua conversa; o que o subagente mexeu em outros arquivos fica, e a doc manda usar o git. A exceção é a skill com context: fork rodando em primeiro plano (p. 65).
Mudança de fora. O que você editou à mão fora do Claude Code, ou outra sessão aberta ao mesmo tempo, normalmente não entra.
Link simbólico e hard link. São pulados na restauração, com o aviso Restored the code, but skipped N files.

Checkpoint não é git

A doc fecha o assunto: checkpoints são feitos para recuperação rápida, dentro da sessão ("Checkpoints are designed for quick, session-level recovery"). Histórico permanente, ramo e trabalho em equipe continuam no git. O hábito que o guia recomenda é simples: commit antes de tarefa arriscada, e o rewind para o resto (p. 22). Se a tarefa mexe em muita coisa, planeje antes com o plan mode, que não edita nada até você aprovar, e escolha o modo de permissão certo em modos de permissão.

Fora do livro: code.claude.com/docs/en/checkpointing, baixada em 15/10/2026.