チェックポイント

Claude Code は、作業中に Claude が行ったファイルエディットを自動的に追跡し、変更をすばやく取り消したり、問題が発生した場合に以前の状態に巻き戻したりできます。

チェックポイントの仕組み

Claude で作業する際、チェックポイント機能は各エディット前のコード状態を自動的にキャプチャします。このセーフティネットにより、野心的で大規模なタスクを実行する際に、いつでも以前のコード状態に戻ることができるという安心感を持って作業できます。

自動追跡

Claude Code は、ファイル編集ツールで行われたすべての変更を追跡します。

ユーザープロンプトごとに新しいチェックポイントが作成されます
チェックポイントはセッション間で保持されるため、再開した会話でアクセスできます
セッション終了後 30 日後に自動的にクリーンアップされます（設定可能）

巻き戻しと要約

Esc キーを 2 回（Esc + Esc）押すか、/rewind コマンドを使用して巻き戻しメニューを開きます。スクロール可能なリストにセッションからの各プロンプトが表示されます。操作したいポイントを選択してから、アクションを選択します。

コードと会話を復元: コードと会話の両方をそのポイントに戻します
会話を復元: 現在のコードを保持しながら、そのメッセージに巻き戻します
コードを復元: 会話を保持しながら、ファイルの変更を戻します
ここから要約: このポイント以降の会話を圧縮して要約し、コンテキストウィンドウスペースを解放します
キャンセル: 変更を加えずにメッセージリストに戻ります

会話を復元または要約した後、選択したメッセージからの元のプロンプトが入力フィールドに復元されるため、再送信または編集できます。

復元と要約の違い

3 つの復元オプションは状態を戻します。コード変更、会話履歴、またはその両方を取り消します。「ここから要約」は異なる動作をします。

選択したメッセージより前のメッセージはそのまま保持されます
選択したメッセージとそれ以降のすべてのメッセージは、コンパクトな AI 生成の要約に置き換えられます
ディスク上のファイルは変更されません
元のメッセージはセッショントランスクリプトに保持されるため、Claude は必要に応じて詳細を参照できます

これは /compact に似ていますが、対象を絞ったものです。会話全体を要約する代わりに、初期コンテキストを完全な詳細で保持し、スペースを使用している部分のみを圧縮します。要約が焦点を当てるべき内容をガイドするためのオプション指示を入力できます。

要約はセッションを同じ状態に保ち、コンテキストを圧縮します。元のセッションを保持したまま異なるアプローチを試したい場合は、代わりに fork（claude --continue --fork-session）を使用してください。

一般的なユースケース

チェックポイントは以下の場合に特に便利です。

代替案の検討: 開始点を失わずに異なる実装アプローチを試します
ミスからの回復: バグを導入したり機能を破損させた変更をすばやく取り消します
機能の反復: 動作状態に戻すことができるという確信を持って変更を試験します
コンテキストスペースの解放: 冗長なデバッグセッションを中間地点から要約し、初期指示を保持します

制限事項

Bash コマンドの変更は追跡されません

チェックポイント機能は、bash コマンドで変更されたファイルを追跡しません。たとえば、Claude Code が以下を実行する場合。

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

これらのファイル変更は巻き戻しで取り消すことはできません。Claude のファイル編集ツールで行われた直接的なファイルエディットのみが追跡されます。

外部の変更は追跡されません

チェックポイント機能は、現在のセッション内で編集されたファイルのみを追跡します。Claude Code の外部で手動で行ったファイルの変更や、他の同時セッションからのエディットは、通常キャプチャされません。ただし、現在のセッションと同じファイルを変更する場合は除きます。

バージョン管理の代替ではありません

チェックポイントは、クイックなセッションレベルの復旧用に設計されています。永続的なバージョン履歴とコラボレーションの場合。

バージョン管理（例：Git）を引き続き使用してコミット、ブランチ、長期履歴を管理します
チェックポイントは適切なバージョン管理を補完しますが、置き換えるものではありません
チェックポイントを「ローカル取り消し」、Git を「永続履歴」と考えてください

リファレンス