記事一覧

Claude Codeの「元に戻す」で戻せるもの・戻せないもの|チェックポイントの基本

Claude Code には、AIが変更したファイルを前の状態に戻せる「チェックポイント」があります。ただし、コマンド経由の変更や外部サービスへの影響は戻りません。公式ドキュメントをもとに、戻せる範囲とバックアップ・Gitとの使い分けを初心者向けに整理します。

中央に寄せた二枚の紙と糸巻きを糸で結び、糸の届かない封筒を外側に配した復元範囲のイラスト

この記事で分かること

AIにファイルを変更してもらったあと、「失敗したら、どこまで元に戻せるの?」が分からない初心者に向けた記事です。

結論から書くと、Claude Code のチェックポイントは「Claude Code が直接編集したファイル」を戻す仕組みで、何でも戻せるわけではありません。大事なものは、Git やバックアップと分けて守るのが安全です。

この記事は、Claude Code の公式ドキュメント(Checkpointing、2026年10月20日確認)に基づく一般的な解説です。このブログの環境で巻き戻しを試した記録ではありません。画面や操作は今後変わることがあるので、使う前に公式ドキュメントも確認してください。

チェックポイントとは

Claude Code は、作業の途中の状態を自動で記録しています。これがチェックポイントです。公式ドキュメントによると、依頼を送るたびに記録され、あとから前の時点まで巻き戻す(rewind)ことができます。

巻き戻すときは、主に次を選べると説明されています。

  • ファイル(コード)だけ戻す
  • 会話だけ戻す
  • 両方戻す

「会話は残したまま、ファイルの変更だけ取り消したい」といった使い分けができるわけです。

戻せないもの

ここが大事なところです。公式ドキュメントには、チェックポイントで追跡しないものが書かれています。

  • コマンド(シェル)経由の変更:Claude Code がコマンドを実行してファイルを消したり移動したりした場合、その変更はチェックポイントで戻りません
  • Claude Code の外での変更:自分で別のソフトから編集したもの、ほかの作業で変わったもの
  • 外部への影響:データベースの書き換え、サイトへの公開、メールや SNS への送信など。手元のファイルを戻しても、外で起きたことは取り消されません

たとえば「ブログ記事を公開した」あとで巻き戻しても、公開された記事は消えません。手元の状態が戻るだけです。

海外の利用者の投稿でも、「巻き戻したのに一部の変更しか戻らなかった」という疑問が出ていました(約3か月前の投稿)。原因は環境ごとに違う可能性がありますが、「戻るのは直接編集した分だけ」と知っておくと、こうした驚きは減らせます。

Git・バックアップとの役割分担

図解:何で守るかを使い分ける

公式ドキュメントでも、チェックポイントはGit などのバージョン管理の代わりではないとされています。おすすめの分け方は次のとおりです。

  • 直前のAIの編集を、すぐ取り消したい → チェックポイント
  • 区切りのよい状態を、長く残したい → Git(コミット)
  • 消えたら本当に困るデータを守りたい → 別の場所へのバックアップ
  • 外部サービスへの影響を防ぎたい → 実行前に人が確認する

このブログの運営では、ファイルを直接消さず「削除」フォルダーへ移すルールにしています(作業メモの記事で紹介)。消す代わりに移しておけば、チェックポイントで戻らない場合でも取り戻せます。

試すなら、練習用のファイルで

チェックポイントを試してみたい場合は、新しく作った練習用のフォルダーとファイルで行ってください。

  1. 空のフォルダーに、短いテキストファイルを1つ作る
  2. Claude Code に、その文章を書き換えてもらう
  3. 巻き戻して、元の文章に戻るかを見る

本番のデータや公開中のサイト、設定ファイルで試すのはやめましょう。

まとめ

  • チェックポイントは、Claude Code が直接編集したファイルを前の時点に戻す仕組み
  • コマンド経由の変更、外での変更、外部サービスへの影響は戻らない
  • 長く残すなら Git、大事なデータは別にバックアップ、外部への操作は事前確認
  • 試すときは練習用のファイルで

次に読む:AIに作業を任せたら「それは止めます」と言われた3つの場面/Claude Codeに毎回同じ説明をしない作業メモ

コメント

まだコメントはありません