【AI】Claude Codeのチェックポイントで変更を巻き戻す方法

当ページのリンクには広告が含まれています。
いずみ

こんな悩みを解決できる記事を書きました!

僕は現役フリーランスエンジニア(歴年)で、資格は個保有しています。

Claude Codeでコードが壊れたときに、編集を安全に元へ戻したい」とお悩みではありませんか?

Claude Codeに大きめの修正を任せた結果、意図しない箇所まで書き換わってしまった経験は誰にでもあります。

チェックポイントと/rewindを使えば、プロンプト単位でコードと会話を巻き戻せるので、失敗しても数秒でやり直せます。

いずみ

Gitのコミットより手軽に使える安全網です。

ということで、本記事ではClaude Codeのチェックポイントと/rewindで変更を巻き戻す方法を解説します。

いずみ

すぐ読み終わるので、ぜひ最後まで読んでくださいませ。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
執筆者/監修者
  • フリーランスエンジニア(保有資格個、企業と直接契約
  • ブログ・アフィリエイト歴7年(2018年〜)
  • ブランドせどりで月利50万円⇨脱サラ
  • 投資(仮想通貨・FX)歴7年(2018年〜)
  • X(旧Twitter)フォロワー約1,900人
  • 運営者情報はこちら
いずみです
目次

Claude Codeのチェックポイントで変更を巻き戻す方法

早速ですが、Claude Codeのチェックポイントと/rewindの使い方を順番に見ていきます。

チェックポイントとは何か

チェックポイントは、Claude Codeがファイル編集ツールで加えた変更を自動で記録する仕組みです。

ユーザーがプロンプトを送るたびに、プロンプト送信直前のコード状態がスナップショットとして保存されます。

Claude Codeはセッション内の直近100件のチェックポイントについてスナップショットを保持します。

チェックポイントは会話と一緒に保存されるため、セッションを再開したあとでも/rewindを実行できます。

いずみ

操作は不要で、Claude Codeを使っているだけで裏側で勝手に積み上がっていきます。

/rewindメニューを開く

巻き戻しは/rewindメニューから操作します。

STEP
rewindメニューを開く

プロンプト入力欄で/rewindと入力するか、入力欄が空の状態でEscを2回押します。

/rewind

入力欄にテキストが残っていると、Escの2回押しはメニューではなく入力のクリアとして扱われます。

クリアされたテキストは入力履歴に残るため、メニューを閉じたあとにUpキーで呼び戻せます。

STEP
戻したいプロンプトを選ぶ

メニューにはセッション中に送った各プロンプトが一覧で並びます。

矢印キーで戻したい時点のプロンプトを選び、Enterで確定します。

復元する内容を選ぶ

プロンプトを選ぶと、復元アクションを選択できます。

  • Restore code and conversation:コードと会話の両方を選んだ時点へ戻す
  • Restore conversation:現在のコードは残したまま、会話だけを選んだ時点へ戻す
  • Restore code:会話は残したまま、ファイル変更だけを選んだ時点へ戻す

コードを戻す2つの選択肢は、選んだチェックポイント以降に記録済みのファイル変更がある場合だけ表示されます。

ファイル編集が記録されていない場合は、会話を戻す選択肢と要約の選択肢だけが並びます。

会話を戻すと、選んだメッセージの元プロンプトが入力欄に復元されるため、そのまま送り直すか手直しして再実行できます。

いずみ

「実装は気に入らないけど指示文はそのまま使いたい」というときに、会話だけ戻すと便利です。

要約で文脈を圧縮する

/rewindメニューには要約用の選択肢もあります。

  • Summarize from here:選んだ時点から先の会話を要約へ圧縮し、コンテキストウィンドウを空ける
  • Summarize up to here:選んだ時点より前の会話を圧縮し、以降のメッセージは残す

要約はディスク上のファイルを変更せず、元のメッセージもセッションの記録には残ります。

長いデバッグ作業の途中から先だけを圧縮して、最初の指示を保ったままコンテキストを軽くする、といった使い方ができます。

巻き戻せないものに注意する

チェックポイントが記録するのは、Claudeのファイル編集ツールによる直接の変更だけです。

bashコマンドによるファイル操作は追跡されず、/rewindで元へ戻せません。

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

サブエージェントがファイル編集ツールで加えた変更も、通常はセッションのチェックポイントに取り込まれず、巻き戻しの対象外です。

Claude Codeの外で手動で行った編集や、別セッションからの編集も、同じファイルに触れていない限り記録されません。

シンボリックリンクやハードリンクのパスは復元されず、コード復元時にスキップされた旨の警告が出ます。

いずみ

「git pushやパッケージのインストールは巻き戻らない」と覚えておくと安全です。

スナップショットの保持期間を延ばす

セッションのスナップショットは、最後に保存されてから約30日で自動的に削除されます。

スナップショットが消えたチェックポイントへ巻き戻そうとすると、ファイルが復元できず失敗することがあります。

保持期間を延ばしたい場合は、settings.jsoncleanupPeriodDaysを大きめに設定します。

{
  "cleanupPeriodDays": 90
}

長期の履歴やチーム共有には向かないため、恒久的なバージョン管理はGitのコミットとブランチで行うのが前提です。

いずみ

チェックポイントはあくまでセッション単位の応急処置、と割り切るのがちょうどいいです。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式

【厳選】フリーランスエンジニアにおすすめなエージェント3選

フリーランスエンジニアになるにはエージェントから案件をもらう必要があります。

僕が実際に利用しているおすすめエージェントを紹介しますね。

いずみ

エージェントは必ず複数登録してください。

担当者によっては「全然案件紹介してくれない…」みたいなこともあるので…

僕は実際に5つのエージェントを使い回していますよ。

フリーランスを始めるなら「

案件数マージン率単価
約88,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 業界最大級の案件数。
  • 業界トップクラスの高単価報酬、低マージン(平均年収862万円)。
  • 案件参画中のフォローの充実。

※詳細は「【業界最大手】レバテックフリーランスとは?メリットや利用手順を解説!」を参照。

は業界最大手のフリーランスエージェントです。

とにかく案件数が多いので、とりあえず登録しておけば間違いないエージェントです!

いずみ

僕もはじめてフリーランスの案件を貰ったのはです。

保有している案件数が多いので、業務経験がなくても何かしらの案件は紹介してもらえますよ(僕はJavaの経験3年でも案件を貰えました)。

手厚い保障を重視したいなら「

案件数マージン率単価
約10,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 手厚い保障で正社員並みの安心感。
  • 還元率60%超え&単価公開でクリアな契約。
  • 給与保障制度(審査あり)。

は手厚い保障が特徴のフリーランスエージェントです。

フリーランスを目指しているけど不安な方や保障を重視したい方におすすめです。

いずみ

僕も何度か案件を紹介してもらいました。

自分のスキルに合った案件を紹介してもらえましたし、電話のやり取りも非常に丁寧でした。

週2〜3日の案件探しなら「

案件数マージン率単価
約5,000件非公開
初心者福利厚生申し込み
経験者向け無料
Good Point
  • IT案件に特化したフリーランスエージェント。
  • 週2〜3日の案件が豊富。
  • リモート案件が多く、直エンドなので単価も高い。

※詳細は「【週2・3案件】ITプロパートナーズとは?メリットや利用手順を解説!」を参照。

はIT案件に特化したフリーランスエージェントです。

週2〜3日から参画できる案件が豊富なので、起業したい人にもおすすめです。

いずみ

週2〜3日の案件はある程度スキルがないと紹介してもらえない印象です。

とはいえ、週5の案件ももちろんありますし、僕が利用した時は迅速・丁寧に対応していただきました!

よくある質問

巻き戻したあとに「やり直し」はできますか?

redoに相当する機能はありません。

戻しすぎると、選んだ時点より先の会話とファイル変更は失われます。

大きな変更の前にGitでコミットしておくと、二重の安全網になります。

チェックポイントはどのくらい残りますか?

セッション内では直近100件のチェックポイントのスナップショットが保持されます。

スナップショット自体は、最後の保存から約30日で自動削除されます。

より長く残したい場合はcleanupPeriodDaysを設定してください。

git pushやnpm installは巻き戻せますか?

巻き戻せません。

チェックポイントが追跡するのはファイル編集ツールによる変更だけで、bashコマンドの副作用や外部への操作は対象外です。

プッシュ済みのコミットはgit revertなどで別途対応する必要があります。

まとめ

今回は、Claude Codeのチェックポイントと/rewindで変更を巻き戻す方法について解説しました。

以下が本記事のまとめになります。

まとめ
  • チェックポイントはユーザープロンプトごとに自動でコード状態を保存する。
  • /rewind、または入力欄が空のときのEsc2回でメニューを開く。
  • コードと会話・会話のみ・コードのみの3通りで復元できる。
  • bashコマンドの変更・サブエージェントの編集・外部への操作は巻き戻らない。
  • 恒久的な履歴はGitで管理し、チェックポイントは応急処置として使う。
まとめ
いずみ

最後までお読みいただき、ありがとうございました!

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
  • クソおすすめ本
¥4,480 (2024/06/01 23:28時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場
いずみ

海外のエンジニアがどういった思考で働いているかが理解できます。

海外に行く気はないけど海外エンジニアの動向が気になる雑魚エンジニアにおすすめです(本当におすすめな本しか紹介しないのでご安心を)。

この記事が気に入ったら
フォローしてね!

シェアしてね!
  • URLをコピーしました!
目次