結論から書きます。Claude Code のチェックポイントは、AIがファイル編集ツールで加えた変更を、会話の途中の時点まで手早く戻すための仕組みです。版管理(変更の履歴を残す仕組み。Git など)の代わりにはなりません。公式ドキュメントにも「セッション単位で手早く戻すための仕組み」と書かれており、恒久的な履歴や共同作業には引き続き Git などの版管理を使うよう案内されています。
医療・ヘルスケアの業務システムの開発では、変更の経緯を後から説明できるようにしておきたい場面が多くあります。そのため、この機能で「戻せる範囲」と「戻らない範囲」を先に押さえておくことが大切です。
チェックポイントの仕組み
公式ドキュメントによると、チェックポイントの仕組みは次のとおりです。
- ターンを始めるプロンプト(AIへの指示文)を送るたびに、その直前のコードの状態が自動で記録されます。
- 追跡の対象は、Claude がファイル編集ツールで加えた変更です。
- ファイルの写し(スナップショット)は、1つのセッションにつき直近100個のチェックポイントの分が保持されます。
- チェックポイントは会話と一緒に保存されるため、セッションを再開した後でも
/rewindを使えます。 - スナップショットは定期的な削除処理の対象で、既定ではそのセッションが最後にスナップショットを保存してから約30日で消えます。消えた後に巻き戻そうとすると
No files were restoredとなって失敗することがあります。もっと長く残したい場合はcleanupPeriodDaysという設定で調整できます。
巻き戻しメニューでできること
/rewind を実行すると巻き戻しメニューが開きます。セッション中に送ったプロンプトが一覧で表示され、戻したい時点を選んでから、次の操作のどれかを選びます。
- Restore code and conversation:コードと会話の両方をその時点に戻す
- Restore conversation:コードは今のままで、会話だけを戻す
- Restore code:会話は残したまま、ファイルの変更だけを戻す
- Summarize from here:その時点から後の会話を要約にまとめ、文脈の領域を空ける
- Summarize up to here:その時点より前の会話を要約にまとめ、後の会話はそのまま残す
- Never mind:何もせずに一覧へ戻る
コードを戻す2つの選択肢が表示されるのは、選んだ時点の後に追跡済みのファイル変更がある場合だけです。また、要約の操作はディスク上のファイルを変更しません。会話を整理したいだけなのか、ファイルを戻したいのかを分けて選べるようになっています。
戻らない変更を知っておく
公式ドキュメントの「制限」の節には、巻き戻しでは戻らない変更が挙げられています。実務で特に気をつけたいものを整理します。
シェルコマンドだけで変更したファイル:Claude が会話の中でファイル編集ツールを使って一度編集したファイルなら、その後にシェル(Bash)のコマンドで加えられた変更も /rewind で戻せます。一方で、シェルコマンドだけで変更されたファイルは追跡されず、そのまま残ります。これを戻すには Git などの版管理を使うよう案内されています。
サブエージェントによる編集:サブエージェント(作業を分担する補助のAI)の編集は、通常はセッションのチェックポイントに取り込まれません。例外は、フォアグラウンドで動く context: fork のスキルです。それ以外の場合に戻せるのは、会話の中で Claude がすでに編集していたファイルだけです。
Claude Code の外での変更:利用者が手作業で加えた変更や、同時に動いている別のセッションによる編集は、通常は記録されません。ただし、現在のセッションと同じファイルを変更した場合は別です。
作業中に送ったメッセージ:Claude の作業中に入力したメッセージには No code restore と表示されることがあり、そのメッセージ自体にはチェックポイントがありません。その場合は、ターンを始めたプロンプトを選んでコードを戻します。
シンボリックリンクとハードリンク:リンクになっているファイルは巻き戻しの対象外で、Restored the code, but skipped N files という警告が出ます。
医療・ヘルスケアの開発でどう使うか
公式ドキュメントは、チェックポイントが特に役立つ場面として、別の実装方法を試すときや、不具合を生んだ変更を手早く取り消すときを挙げています。これらを踏まえて、業務システムの開発での使い分けを考えます。
試行錯誤はチェックポイント、確定はコミット:集計ロジックや画面の別案を試すときは、チェックポイントで気軽に戻せます。一方で、採用を決めた変更は Git にコミットし、誰がいつ何を変えたかを残しておきます。チェックポイントのスナップショットは約30日で消えることがあるため、変更の記録として頼る使い方には向きません。
スクリプトで作ったファイルは戻らない前提で:データ変換のスクリプトをシェルで実行して生成したファイルや、ビルドで書き出されたファイルは、シェルコマンドだけで変更されたものであれば巻き戻しの対象外です。また、公式ドキュメントで扱われているのはファイルの変更であり、外部のデータベースなどの状態を戻す仕組みとしては書かれていません。データを書き換える処理を試す前には、別途バックアップを取っておくのが無難です。
試すときは架空のデータで:患者情報を含むデータを外部のAIサービスで扱えるかどうかは、契約や利用規約、組織の規程、関係する法令やガイドラインを踏まえて組織として判断する事項で、この記事で扱える範囲を超えます。この記事では、患者情報を入力せず、合成データ(架空のデータ)で試すことを前提にしています。編集したファイルの写しが手元に一定期間残る仕組みであることも、扱うデータを慎重に選ぶ理由の一つです。
まとめ
チェックポイントは「AIが編集ツールで書き換えたファイルを、会話の途中まで手早く戻す」ための仕組みです。シェルコマンドだけで変更したファイル、多くのサブエージェントによる編集、外部での変更、リンクになっているファイルは戻りません。試行錯誤の安全網として使い、確定した変更は版管理に残す。この役割分担を決めておくと、AIを使った開発を落ち着いて進めやすくなります。
医療・ヘルスケア領域でAIを使った開発の進め方や、開発環境の決めごとを整えたい方は、お気軽にご相談ください。
この記事は note でも発信しています。