Claude Code は、作業中に Claude が行ったファイルエディットを自動的に追跡し、変更をすばやく取り消したり、問題が発生した場合に以前の状態に巻き戻したりできます。Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
チェックポイントの仕組み
Claude で作業する際、チェックポイント機能は各エディット前のコード状態を自動的にキャプチャします。このセーフティネットにより、野心的で大規模なタスクを実行する際に、いつでも以前のコード状態に戻ることができるという安心感を持って作業できます。自動追跡
Claude Code は、ファイル編集ツールで行われたすべての変更を追跡します。- ユーザープロンプトごとに新しいチェックポイントが作成されます
- チェックポイントはセッション間で保持されるため、再開した会話でアクセスできます
- セッション終了後 30 日後に自動的にクリーンアップされます(設定可能)
巻き戻しと要約
Esc キーを 2 回(Esc + Esc)押すか、/rewind コマンドを使用して巻き戻しメニューを開きます。スクロール可能なリストにセッションからの各プロンプトが表示されます。操作したいポイントを選択してから、アクションを選択します。
- コードと会話を復元: コードと会話の両方をそのポイントに戻します
- 会話を復元: 現在のコードを保持しながら、そのメッセージに巻き戻します
- コードを復元: 会話を保持しながら、ファイルの変更を戻します
- ここから要約: このポイント以降の会話を圧縮して要約し、コンテキストウィンドウスペースを解放します
- ここまで要約: このポイント前の会話を要約に圧縮し、後のメッセージはそのまま保持します
- キャンセル: 変更を加えずにメッセージリストに戻ります
復元と要約の違い
復元オプションは状態を戻します。コード変更、会話履歴、またはその両方を取り消します。要約オプションは、ディスク上のファイルを変更せずに、会話の一部を AI 生成の要約に圧縮します。- ここから要約: 選択したメッセージより前のメッセージはそのまま保持されます。選択したメッセージとそれ以降のすべてのメッセージは、要約に置き換えられます。サイドディスカッションを破棄しながら、初期コンテキストを完全な詳細で保持する場合に使用します。
- ここまで要約: 選択したメッセージより前のメッセージは、要約に置き換えられます。選択したメッセージとそれ以降のすべてのメッセージはそのまま保持され、会話の最後に留まります。初期セットアップディスカッションを圧縮しながら、最近の作業を完全な詳細で保持する場合に使用します。
/compact に似ていますが、対象を絞ったものです。会話全体を要約する代わりに、選択したメッセージのどちらの側を圧縮するかを選択します。
要約はセッションを同じ状態に保ち、コンテキストを圧縮します。元のセッションを保持したまま異なるアプローチを試したい場合は、代わりに fork(
claude --continue --fork-session)を使用してください。一般的なユースケース
チェックポイントは以下の場合に特に便利です。- 代替案の検討: 開始点を失わずに異なる実装アプローチを試します
- ミスからの回復: バグを導入したり機能を破損させた変更をすばやく取り消します
- 機能の反復: 動作状態に戻すことができるという確信を持って変更を試験します
- コンテキストスペースの解放: 冗長なデバッグセッションを中間地点から要約し、初期指示を保持します
制限事項
Bash コマンドの変更は追跡されません
チェックポイント機能は、bash コマンドで変更されたファイルを追跡しません。たとえば、Claude Code が以下を実行する場合。外部の変更は追跡されません
チェックポイント機能は、現在のセッション内で編集されたファイルのみを追跡します。Claude Code の外部で手動で行ったファイルの変更や、他の同時セッションからのエディットは、通常キャプチャされません。ただし、現在のセッションと同じファイルを変更する場合は除きます。バージョン管理の代替ではありません
チェックポイントは、クイックなセッションレベルの復旧用に設計されています。永続的なバージョン履歴とコラボレーションの場合。- バージョン管理(例:Git)を引き続き使用してコミット、ブランチ、長期履歴を管理します
- チェックポイントは適切なバージョン管理を補完しますが、置き換えるものではありません
- チェックポイントを「ローカル取り消し」、Git を「永続履歴」と考えてください
関連項目
- Interactive mode - キーボードショートカットとセッションコントロール
- Commands -
/rewindを使用したチェックポイントへのアクセス - CLI reference - コマンドラインオプション