Claude Code チェックポイント
チェックポイントは Claude Code のコードを安全にロールバックするためのツールですClaude によるファイルの編集操作を自動的に追跡し、不要な変更をすばやく取り消して、コードを壊してしまっても復元しやすくします。
チェックポイントの動作原理
チェックポイントは、Claude Code を使用しているときに自動的にバックグラウンドで実行され、手動での設定は一切不要です:
- 自動作成:ユーザープロンプトを送信するたびにチェックポイントが自動的に作成され、現在のコード状態が記録されます
- 永続保存:チェックポイントはセッション間で保持され、セッションを閉じても、次回復元した後に過去のチェックポイントにアクセスできます
- 自動クリーンアップ:30日を超えたチェックポイントは自動的に削除されます(クリーンアップ時間は設定可能)
注意:追跡されるのは Claude がファイル編集ツールを通じて行った直接的な変更のみです。その他の方法による変更は記録されません。
チェックポイントを使って変更をロールバックする方法
1. ロールバックメニューを開く
トリガー方法は2つあり、どちらか一方を選択します:
- ショートカットキー:2回押す
Esc(Esc+Esc) - スラッシュコマンド:入力
/rewind
2. ロールバックの種類を選択
メニューを開くと、ニーズに応じて3つのロールバックモードを選択できます:
| ロールバックの種類 | 効果 | 適用シーン |
|---|---|---|
| ダイアログのみ | 過去のダイアログ内容にロールバックし、現在のコード変更は保持します | 会話の方向性がずれてきたと感じ、質問し直したいが、コードの変更には問題がない場合 |
| コードのみ | ファイルを過去の状態に復元し、現在の会話は保持します | コードを壊してしまったが、現在の会話に基づいて調整を続けたい場合 |
| コードとダイアログ | コードとダイアログの両方を以前の状態にロールバックします | 完全にやり直して、満足のいく時点に戻りたい場合 |
一般的な使用例
チェックポイントは特に以下の開発シーンに適しています:
- 複数のアプローチを探索する:さまざまなコード実装のアイデアを試し、気に入らなければワンクリックで開始点にロールバックして、別の案に切り替える
- ミスを迅速に修正する:Claude の変更によってバグが発生したり機能が壊れたりした場合に、変更前の正常な状態へすばやくロールバックする
- 機能開発の反復:機能に対して複数のバリエーションで実験し、いつでも安定した中間バージョンに復元する
重要な制限
チェックポイントは一時的なセーフティネットであり、万能ではありません。その境界線に注意する必要があります:
Bash コマンドによる変更は追跡されない
像 rm mv cpBash ツールを通じて実行されるこの種のファイル操作は、チェックポイントに記録されず、ロールバックできません。
外部での変更は追跡されない
追跡されるのは、現在のセッション内で Claude が編集したファイルのみです。VS Code やターミナルなどの外部ツールで手動で変更したファイルや、他のセッションでの変更は、キャプチャされません。
バージョン管理ツールの代替にはならない
チェックポイントはセッションレベルの一時的なロールバックにのみ使用され、長期的なプロジェクト管理やチームコラボレーションには適していません。
- 長期的な履歴記録、ブランチ管理 → Git などのバージョン管理ツールを使用
- チェックポイント = ローカルの一時的な取り消し、Git = 永続的なプロジェクト履歴