Claude Media
Claude Code rewindコマンドで編集を取り消し、/clear前に戻る

Claude Code rewindコマンドで編集を取り消し、/clear前に戻る

/rewindでコードと会話をどこまで巻き戻せるか、/clear前の会話に戻る手順、bash変更やサブエージェント編集が復元されない限界を実例で扱います。

Claude Code rewindは何を元に戻せるコマンドか

Claudeの編集を取り消したいときは、入力欄が空の状態でEscを2回押すか/rewindを実行し、戻したい時点を選びます。/undoと/checkpointも同じメニューを開きます。

やりたいこと操作
編集だけ取り消す操作Restore codeを選ぶ
会話だけ前の時点に戻す操作Restore conversationを選ぶ
コードも会話も戻す操作Restore code and conversationを選ぶ
/clear前の会話に戻る操作先頭の(previous session)項目を選ぶ

Claude Codeはユーザーのプロンプトごとにチェックポイントを自動で作り、ファイル編集前の状態を記録しています。/rewindはそのチェックポイントを使って、コードと会話の両方、あるいは片方だけを、過去の任意の時点まで巻き戻すコマンドです。実装を試して失敗した、デバッグが長引いてコンテキストを圧迫している、別のアプローチを試したい。こうした場面で、手動のgit操作なしに戻せます。

チェックポイントは会話とともに保存されるため、セッションを終了して--resumeで再開した後でも/rewindは使えます。ファイルのスナップショットは直近100件のチェックポイント分がセッションごとに保持されます。古いものはどのチェックポイントからも参照されなくなった時点で破棄されますが、各ファイルの最初のスナップショットだけは、VS Code拡張機能がセッション差分の基準に使うため残ります。

スナップショットはセッションの最終保存から約30日で削除され、期間はcleanupPeriodDays設定で変えられます。この削除が、後述のNo files were restoredエラーの原因の1つです。

コマンド一覧では、/rewindは「何かがおかしいときに使うコマンド」に分類されています。

Claude Code rewindはどう使うか

/rewindを実行するか、プロンプト入力欄が空の状態でEscを2回押すと、rewindメニューが開きます。入力欄に文字が残っていると、Esc2回はメニューではなく入力のクリアになります。クリアした文字は入力履歴に残るので、Upキーで呼び戻せます。

メニューにはセッション中に送った各プロンプトが並びます。戻したい時点を選んでから、アクションを選びます。

アクション何が起きるか
Restore code and conversation何が起きるかコードと会話の両方をその時点まで戻す
Restore conversation何が起きるかコードはそのまま、会話だけを戻す
Restore code何が起きるか会話はそのまま、ファイルの変更だけを戻す
Summarize from here何が起きるか選んだ時点以降の会話を要約に圧縮する
Summarize up to here何が起きるか選んだ時点より前の会話を要約に圧縮し、以降はそのまま残す
Never mind何が起きるか何もせずメッセージ一覧に戻る

実装を試して失敗したときはRestore code and conversationで両方を戻し、別のアプローチを最初からやり直すのが早道です。ファイルは今のまま会話の脱線だけ整理したいならRestore conversation、コードだけ戻して会話の流れを残したいならRestore codeを選びます。コンテキストが膨らんだだけなら、コードに触れない要約2種で会話量だけを削れます。

コードを戻す2つの選択肢は、選んだチェックポイントに追跡済みのファイル変更があるときだけ出ます。ファイル編集が記録されていない時点では、Restore conversationと要約系、Never mindだけが並びます。

会話を復元するか、Summarize from hereを選ぶと、その時点の元のプロンプトが入力欄に戻ります。そのまま再送も編集もできます。Summarize up to hereは会話の末尾にとどまり、入力欄は空のままです。圧縮された箇所には「Summarized conversation」のマーカーが出ます。

要約は、矢印キーでハイライトして「add context (optional)」の行に指示を打ち、Enterを押すと焦点を絞れます。数字キーで選ぶと、指示なしですぐ実行されます。要約はディスク上のファイルを変えず、元のメッセージもトランスクリプトに残ります。

/clear前の会話にrewindで戻る手順

/clearしても、同じプロセス内ならrewindメニューから戻れます。

手順

/clearしてしまったときの戻り方

  1. 1

    Claude Codeを終了していないか確かめる

    この項目が出るのは、/clearを実行したのと同じプロセスの間だけです。終了するか別のセッションを再開すると消えます。

  2. 2

    /rewindでメニューを開く

    入力欄が空の状態でEscを2回押しても開きます。

  3. 3

    先頭の previous session を選ぶ

    /resume <session-id> (previous session)が/clear前の会話です。

  4. 4

    項目が無ければ/resumeに切り替える

    プロセスを閉じた後は/resumeの一覧から選びます。v2.1.191より古い環境では、そもそもこの項目がありません。

そもそも/clearはコンテキストを空にするだけのコマンドで、Claude Codeは直前の会話を保存し続けています。--nameや/renameで付けた名前は新しい会話に引き継がれますが、AIが自動生成したセッションタイトルは引き継がれません。/clear release-prepのように名前を渡すと、離れる側の会話にその名前を付けられます。この形で名前を渡すと、新しい会話は無名で始まります。

同じセッションを2つの端末で同時に--resumeすると、双方のメッセージが1つのトランスクリプトに混ざります。巻き戻しの位置が分かりにくくなるので、並行して試すなら--fork-sessionを付けます。

Claude Code rewindが元に戻せないものは何か

チェックポイントが記録するのは、Claudeのファイル編集ツールによる変更だけです。次の4つは/rewindの対象外になります。

対象外

rewindで戻らない4つの変更

  • bashコマンドの変更

    rm・mv・cpなどシェルコマンドでの変更は追跡されません。破壊的なbashの前にはgitのコミットを挟みます。Auto Modeがbashのsedやheredocで編集することもあり、CLAUDE_CODE_THRIFTY_SONICでの止め方に例があります。

  • サブエージェントの編集

    サブエージェントの通常の編集は含まれません。例外はcontext: forkのスキルをフォアグラウンド(background: false)で走らせた場合で、自分のターン中に作業ツリーを直接編集するため復元されます。バックグラウンドのフォークスキルや、バックグラウンドの/code-review --fixはgitで手動revertします。

  • セッション外の変更

    Claude Code外での手動編集や、別の同時実行セッションの変更は、現在のセッションが同じファイルを編集していない限り記録されません。

  • シンボリックリンクとハードリンク

    ドットファイル管理ツールが置くシンボリックリンクや、pnpmのハードリンクは復元されず、警告が出ます(読み方は後述)。

これらの限界から、/rewindはバージョン管理の代替ではなく、セッション内の即応的な巻き戻し手段です。恒久的な履歴や共同作業はgitが前提です。対象外ケースごとの挙動と対処はClaude Code checkpointの制限で詳しく扱っています。

ターンの途中で送ったメッセージは一覧に出ない

Claudeの作業中に自分がキューへ積んだメッセージは、ツール呼び出しが終わった時点で同じターンに合流します。この場合は新しいターンにならないので、チェックポイントも作られず、rewindメニューにも並びません。

そのメッセージを消したい、あるいはその後のClaudeの編集を取り消したいときは、そのターンを始めたプロンプトまで戻します。ターンの前半にClaudeが済ませた作業もまとめて巻き戻る点に注意が要ります。ターンの終わりまで残っていたキューは新しいターンとして送られ、通常どおりチェックポイントが付きます。

復元に失敗したときのメッセージの読み方

コードの復元では、2種類のメッセージが出ます。警告か失敗かで、次の一手が変わります。

メッセージ種別起きていること
Restored the code, but skipped N files種別警告起きていること一部のパスだけ飛ばして残りは復元した
No files were restored種別エラー起きていることチェックポイント内のファイルを1つも復元できなかった

Restored the code, but skipped N files

飛ばされるのは、リンクなど通常のファイルでなくなったパス、チェックポイント以降にディレクトリが変わったパス、バックアップを安全に読めないパスです。飛ばされたファイルは現在の内容のまま残ります。v2.1.216より前の/rewindは、リンクの先まで書き込み・削除しており、部分的な復元も報告しませんでした。

メッセージが示すのは件数だけです。どのパスかは、復元前に/debugでデバッグログを有効にしておくと~/.claude/debug/<session-id>.txtに残ります。macOSやLinuxなら、find . -type lでシンボリックリンク、find . -type f -links +1でハードリンクを直接探せます。

心当たりのないリンクが見つかったら、中身を信用する前にパスを確かめます。意図して置いたリンクなら、Claudeに編集の取り消しを頼むか、自分で直します。

No files were restored

バックアップが無いか、書き込みや削除ができなかったときのエラーです。

Failed to restore the code:
No files were restored: 1 file failed (backup missing, or the file could not be updated)

メッセージにN paths were skipped for link safetyが併記されているときは、リンクを飛ばした分です。前節の警告と同じ手順で、該当パスを確かめます。

約30日たったセッションを--resumeで開くと起きることがあります。チェックポイントの一覧は残っていても、バックアップは保持期間の掃除で消えています。フォークしたセッションでは、元のバックアップをコピーできなかった分(ディスクが満杯など)が欠けて、同じエラーになります。

バックアップが消えていると、/rewindを何度やり直しても同じ結果です。Claudeに自分の編集を逆向きに直させるか、gitから戻します。書き込みを妨げている原因(ファイルの権限など)があるなら、それを直せば再実行できます。今後のセッションで保持を延ばすにはcleanupPeriodDaysを増やします。

v2.1.260より前は、バックアップが欠けたファイルを黙って飛ばし、巻き戻しが成功したように見えました。--rewind-filesも同じ修正の対象です。古い環境の「戻ったはずなのに戻っていない」は、この挙動が原因かもしれません。

バージョン別の/rewindの違い

自分の環境で何が起きるかは、バージョンで切り分けられます。

バージョン変わったことこれより前の環境で起きること
v2.1.191変わったこと/clear前の会話に戻る項目が追加これより前の環境で起きることrewindメニューにその項目が出ない
v2.1.216変わったことリンク越しの復元・削除をやめ、飛ばした件数を報告これより前の環境で起きることリンクの先まで書き込み・削除し、部分復元も報告しない
v2.1.260変わったことバックアップ欠落を失敗として報告(--rewind-filesも対象)これより前の環境で起きること欠けたファイルを黙って飛ばし、成功に見える
v2.1.275変わったことフォークやバックグラウンドのコピー失敗に対応これより前の環境で起きること空や欠けたファイルが復元されることがある

Claude Code rewindと/clear・/compact・/branchはどう使い分けるか

会話やコンテキストを整理する手段は複数あり、目的で選ぶコマンドが変わります。

操作何をするか使いどころ
/rewind何をするか指定した過去の時点までコード/会話を巻き戻す、または要約する使いどころ実装に失敗した・別アプローチを試したい・コンテキストが膨らんだ
/clear何をするか会話履歴を空にする(ファイルは変更しない)使いどころ新しいタスクに切り替え、過去の文脈を持ち込みたくないとき
/compact何をするか現在の会話をその場で圧縮する使いどころセッションを続けたまま文脈量だけ減らしたいとき
/branch何をするか元のセッションを保ったまま別セッションに分岐する使いどころ元の状態を壊さず別のアプローチを並行で試したいとき

/rewindの要約オプションは/compactに近い働きですが、起点が違います。今の会話を丸ごと圧縮するのではなく、過去の特定の時点を境に圧縮します。コンテキストの節約を全体設計で考えるならClaude Codeのコンテキスト管理が参考になります。

元のセッションを保ったまま別の方針を試したいなら、/rewindではなく/branchかclaude --continue --fork-sessionで分岐します。--fork-sessionはclaude --helpで次のように説明されています(v2.1.287で確認)。

claude --help | grep -A2 -- '--fork-session'
  --fork-session   When resuming, create a new session ID
                   instead of reusing the original (use
                   with --resume or --continue)

フォーク時のコピー失敗は、v2.1.275より前だとエラーになりませんでした。バックアップを完全にコピーできなかったフォークやバックグラウンドのセッションでは、中身が空や欠けたファイルが復元されることがありました。

まとめ

巻き戻しの前に、変更をClaudeの編集ツールが行ったのか、bashやサブエージェントが行ったのかを見分けるのが分かれ目です。戻ったはずのファイルが戻っていないと感じたら、まず使っているClaude Codeのバージョンを確かめます。v2.1.260より前の環境なら、成功表示が実際の復元を保証していません。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/ja/checkpointing
  2. code.claude.com/docs/ja/commands
  3. code.claude.com/docs/ja/sessions
  4. code.claude.com/docs/en/errors
  5. code.claude.com/docs/en/interactive-mode
この記事を共有:XはてブLinkedIn