チェックポイント機能とは？Claude Codeの変更を安全に巻き戻す仕組み

Claude Codeのチェックポイントは、セッション中の編集と会話の状態を追跡し、以前の状態へ戻すための仕組みです。現行の操作と制約はCheckpointingを正本にします。Gitコミットや外部バックアップと同じではありません。

使う場面

巻き戻す前に、残したい現在の変更を退避します。

• 追跡された会話・ファイル編集チェックポイントの対象と失う変更を確認。
• Gitの履歴・作業ツリー対象の変更に合ったGitの復元手順を選ぶ。
• DB・外部送信・公開先そのサービスのバックアップや復旧手順を使う。

チェックポイントで外部への送信は取り消せません。戻した後も、対象ファイルと動作を確かめます。

複数案を試す、変更後に方針を戻す、直前の編集を取り消すときに役立ちます。戻す前に現在の差分を保存し、どのチェックポイントへ戻るかを確認します。チェックポイントが作られる条件、保持範囲、サブエージェントや外部操作への影響は公式ページの現行仕様を読みます。

現在の変更を要約し、戻す場合に失われるファイルと会話状態を説明してください。まだ巻き戻さないでください。

作業の途中に送った追加指示が、実行中のターンへ合流した場合、そのメッセージ専用のチェックポイントは作られません。戻すには、そのターンを開始した依頼まで戻るため、追加指示が届く前の作業も一緒に対象になります。追加指示が別のターンとして処理された場合は通常どおり作られます。会話に表示されていることと、個別に巻き戻せることを分けて確認します。

Gitと併用する

重要な段階で小さくコミットし、git statusとgit diffを保存します。チェックポイントは、リモートへpushしたコミット、データベースの変更、外部サービスへの送信を取り消せません。削除や生成物の復旧を目的にするなら、専用バックアップと復元手順を用意します。差分確認とGit操作を先に押さえると安全です。

戻した後は作業ツリー、テスト、生成物、セッションの表示を確認します。実機で特定バージョンの巻き戻しを試していない場合は、UIやショートカットを確認済みと断定しません。

実際に巻き戻す操作

直前の編集を取り消すだけなら、Claude Codeの入力待ちでEscを2回押してチェックポイントを選びます。コマンドで選ぶ場合は/rewind（別名/checkpoint、/undo）を入力し、戻す対象を確認してから実行します。会話だけ、コードだけ、または両方を戻す選択肢が表示される場合がありますが、表示内容は利用中のバージョンで確認してください。まず「変更を要約し、まだ巻き戻さないでください」と依頼してから操作すると、失う差分を把握できます。

チェックポイントはClaude Codeが追跡したファイル変更と会話状態を戻す機能です。すでにpushしたコミット、データベース、外部サービスへの送信、生成したメールなどは取り消せません。重要な状態は先にコミットまたは別バックアップへ保存し、復元後にgit status、git diff、テスト、生成物を確認します。

戻す前のチェックリスト

現在の差分をパッチや別ブランチへ保存し、残す変更と捨てる変更を分けます。チェックポイントの復元はファイルのスナップショットを対象にするため、push済みのコミット、外部サービス、データベース、生成したメールなどは元に戻りません。復元後にgit statusとテストを実行し、必要なら新しいチェックポイントやコミットを作ります。重大な変更は、公式の制約と自分のバージョンを確認してから実行します。