SpyBara
Go Premium

checkpointing.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 20 additions and 48 deletions.

2026
Tue 6 23:59 Sat 10 23:01 Thu 15 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sun 25 23:58 Wed 28 23:57

チェックポイント

Claude のエディット内容と会話を追跡、巻き戻し、要約してセッション状態を管理します。

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

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

Claude で作業する際、チェックポイント機能は送信する各プロンプトがターンを開始する前のコード状態を自動的にキャプチャします。

自動追跡

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

  • 送信する各プロンプトがターンを開始するたびに新しいチェックポイントが作成されます
  • Claude Code はセッション内の最新 100 個のチェックポイントのファイルスナップショットを保持します。古いチェックポイントを破棄すると、残りのチェックポイントが参照しないスナップショットファイルが削除されます。ただし、各ファイルの最初のスナップショットは除外されます。これは VS Code 拡張機能がセッション diff のベースラインとして使用します。
  • チェックポイントはセッションと共に保存されるため、再開したセッションでも /rewind で戻ることができます
  • Claude Code は保持期間スイープでセッションのファイルスナップショットを削除します。デフォルトではセッションが最後に保存されてから約 30 日後です。スナップショットが削除されたチェックポイントに巻き戻すと、No files were restored エラーで失敗する可能性があります。スナップショットをより長く保持するには、cleanupPeriodDays を設定してください。

巻き戻しと要約

/rewind を実行するか、プロンプト入力が空の状態で Esc キーを 2 回押して、巻き戻しメニューを開きます。

[!NOTE]

プロンプト入力にテキストが含まれている場合、ダブル Esc はメニューを開く代わりにテキストをクリアします。クリアされたテキストは入力履歴に保存されるため、巻き戻しメニューを終了した後に Up キーを押して呼び出すことができます。

巻き戻しメニューには、セッション中に送信したプロンプトが一覧表示されます。操作したいポイントを選択してから、アクションを選択します。

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

2 つのコード復元オプションは、選択したチェックポイントが戻すべき追跡されたファイル変更を持つ場合にのみ表示されます。そのポイント以降にファイル編集がキャプチャされていない場合、メニューは 会話を復元、要約オプション、および キャンセル のみを提供します。

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

「ここまで要約」を選択すると、会話の最後に留まり、入力フィールドは空になります。どちらの要約オプションでも、圧縮されたメッセージがあった会話内に 要約された会話 マーカーが表示されます。

クリアされた会話を超えて巻き戻す

同じ Claude Code プロセスの前の段階で /clear を実行した場合、巻き戻しメニューはリストの最上部に /resume <session-id>（前のセッション） というラベルの追加エントリを表示します。これを選択して、/clear が実行される前にアクティブだった会話を再開します。このエントリは Claude Code を終了するか別のセッションを再開するまで利用可能です。

要約をガイドする

要約はディスク上のファイルを変更せず、元のメッセージはセッショントランスクリプトに保持されるため、Claude は詳細を参照できます。要約が焦点を当てるべき内容をガイドするには、矢印キーで 要約 オプションをハイライトし、行が コンテキストを追加（オプション） と表示されている場所に指示を入力してから、Enter キーを押します。数字キーでオプションを選択すると、指示なしで即座に要約されます。

[!NOTE]

要約はセッションを同じ状態に保ち、コンテキストを圧縮します。これは対象を絞った /compact のようなものです。元のセッションを保持したまま異なるアプローチを試したい場合は、代わりに /branch または claude --continue --fork-session を使用してください。

一般的なユースケース

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

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

制限事項

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

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

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

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

サブエージェントの編集は復元されません

サブエージェントは Claude のファイル編集ツールで編集を行いますが、Claude Code は通常、セッションのチェックポイントでこれらの編集をキャプチャしません。巻き戻しがそれらを復元するかどうかは、サブエージェントの実行方法によって異なります：

  • フォアグラウンドフォークスキル：context: fork を持つスキルがフォアグラウンドで実行され、自分のターン中にワーキングツリーを編集するため、巻き戻しは通常どおりその編集を復元します。background: false を設定してフォークをフォアグラウンドで実行します。いくつかの状況（スキルページに記載）では、この設定に関係なくそこで実行されます。
  • その他のサブエージェント：巻き戻しで復元されるのは、会話の中で Claude がすでに編集していたファイルのみです。サブエージェントによるその他のファイルへの編集は残るため、git を使用して元に戻してください。これには、バックグラウンドで実行されるフォークスキル（デフォルト）と、バックグラウンド /code-review --fix 実行が含まれます。

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

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

ターン中に送信されたメッセージはチェックポイントされません

巻き戻しメニューでは、Claude がまだ作業中に入力したメッセージに No code restore（コードの復元なし）と表示されることがあります。Claude はそのメッセージをターンの終了前に読み取っています。チェックポイントはターンを開始するプロンプトに対して作成されるため、このメッセージ自体にはチェックポイントがありません。Claude がそのメッセージを読んだ後に行った編集は、ターンを開始したプロンプトに含まれます。

メッセージ自体について何かをする必要はありません。セッションのその部分でのファイル変更を取り消すには、ターンを開始したプロンプトを選択し、Restore code（コードを復元）または Restore code and conversation（コードと会話を復元）を選択します。これにより、メッセージが到達する前の編集を含め、ターン全体での Claude のファイル編集が元に戻されます。マークされたメッセージを選択した場合も Restore conversation（会話を復元）は利用でき、会話をそのメッセージまで巻き戻し、ファイルはそのまま残します。

シンボリックリンクおよびハードリンクパスは復元されません

チェックポイント機能は、シンボリックリンクまたはハードリンクされたファイルを巻き戻しません。/rewind メニューから Restore code（コードを復元）または Restore code and conversation（コードと会話を復元）を選択すると、Claude Code は追跡されたパスのうち、シンボリックリンクまたはハードリンクであるパスをスキップし、Restored the code, but skipped N files（コードを復元しましたが、N 個のファイルをスキップしました）という警告を表示します。スキップされたファイルは現在の内容を保持します。セッションの変更の 1 つを取り消すには、Claude に編集を逆にするよう依頼するか、ファイルを自分で編集してください。ドットファイルマネージャーがプロジェクトにシンボリックリンクする設定ファイルと、pnpm がその場所にハードリンクするファイルの両方がこのカテゴリに該当します。

復元がスキップするパスを確認するには、復元する前に /debug でデバッグログを有効にします：~/.claude/debug/<session-id>.txt のデバッグログには、スキップされた各パスが記載されます。スキップの理由と復旧手順については、エラーリファレンスのスキップされたファイルエントリを参照してください。

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

チェックポイントは、クイックなセッションレベルの復旧用に設計されています。永続的なバージョン履歴とコラボレーションの場合は、Git などのバージョン管理を引き続き使用して、コミット、ブランチ、長期履歴を管理してください。

関連項目

  • Interactive mode - キーボードショートカットとセッションコントロール
  • Commands - /rewind を使用したチェックポイントへのアクセス
  • CLI reference - コマンドラインオプション