メインコンテンツへスキップ
レッスン 8 / 12|7分で読めます

Checkpoints(チェックポイント) 巻き戻す

プロンプトを送るたびに自動で取られるスナップショット。ただし追跡されないものがあり、そこを知らないと事故る。

一行でいうと

あなたがプロンプトを送るたびに、自動で取られる編集のスナップショットです。失敗したら /rewind(またはEscを2回)で、その時点まで戻せます。

Checkpointsで戻せる履歴と境界外の変更

履歴の線路は巻き戻せます。ただし、点線の外で起きた変更までは戻りません。


何が戻せるのか

/rewind を打つと、戻し方を選べます。

保持は直近100件・30日間。会話を再開したセッションでも使えます。

これが可能なのは、会話そのものの保存の仕方にあります。プロンプトを送るたびに、やり取りは ~/.claude/projects 配下にJSONL形式で、そのまま平文で保存されています。rewindも、セッションを再開する仕組みも、この同じ保存の上に成り立っています。

セッションを「再開する」ことと「複製する」ことは、別の操作です。claude --continueclaude --resume で再開すると、同じセッションIDに新しいメッセージが追記されていきます。一方、--fork-session/branch で複製すると、その時点までの履歴を新しいセッションIDにコピーし、元のセッションはそのまま無傷で残ります。大きく作り変えてみたいときは、先に複製しておくと、元の会話に戻れる逃げ道を残せます。

最後の「要約」は地味に便利です。/compact が会話全体を圧縮するのに対して、こちらは範囲を狙って圧縮できます。


最重要の落とし穴

ここだけは必ず覚えてください。

bash経由で消したり動かしたりしたファイルは、追跡されません。

つまり、rmmvcp で起きた変更は、/rewind では戻ってきません。戻せるのは、Claudeが編集ツール(EditやWrite)で書き換えたものだけです。

注意

checkpointsはバージョン管理の代わりではない

公式ドキュメントも明言しています。checkpointsは「ローカルの取り消し」、gitは「恒久的な履歴」。役割が違います。

実際、この落とし穴は現場で刺さります。自動化スクリプトや別のセッションが git reset を走らせると、未保存の新規ファイルは消え、rewindでも戻せません。

だからこの原則は変わりません。作業はこまめにcommitする。checkpointsがあっても、です。


よくある誤解と罠

罠1: 「保険があるから大胆にやれる」と思う

半分は正しく、半分は危険です。Claudeの編集は戻せますが、コマンド実行の副作用は戻せません。外部に送信したもの、消したファイル、デプロイしたもの。ここは戻りません。

罠2: セッション外の変更も戻ると思う

原則追跡外なのは、エディタで手で直した内容や、並行して動いている別のセッションの変更です。

罠3: 長期保存だと思う

30日で自動的に消えます。残したい状態は、gitのコミットにするか、ファイルとして書き出しておく。


実務での使い方

いちばん効くのは、失敗した試行をなかったことにする使い方です。

生成がうまくいかなかったとき、口頭で「違う、そうじゃない」と訂正を重ねると、会話に失敗の履歴が溜まります。その状態からの再生成は、たいてい精度が落ちる。

そうではなく、失敗ごと巻き戻して、学びを反映した新しい依頼を1回投げる。これが一番速い直し方です。前のレッスンで出てきた「訂正が積み重なった長い会話より、きれいな会話に良い依頼」と同じ話です。


使いどころ

効くのは、大胆に試したいときです。

  • 原稿の書き換えを試して、気に入らなければ丸ごと戻す
  • スライドの構成を2案試して、良かったほうを残す
  • 「この方向で書き直して」を大胆に試せる安心材料として

ただし、大事な原稿ほど、節目でcommitしておく。checkpointsは今日の作業の保険であって、資産の保管庫ではありません。


今日のまとめ

  • Checkpointsは自動スナップショット。直近100件・30日、/rewind で戻せる
  • bash経由の削除・移動は追跡されない。バージョン管理の代わりにはならない
  • 失敗は口で訂正するより巻き戻す。ただし作業はこまめにcommitする
SourceDOCUMENTATION
Checkpointing 公式ドキュメント

保持期間、rewindの全選択肢、追跡されない変更の一覧。

Webcode.claude.com
code.claude.com/docs/en/checkpointing

次は、実装の前に立ち止まる仕組み、Plan modeです。