~/教學/REWIND.md

文章 / Claude Code

Claude Code 改壞了?按兩下 Esc 還原:檢查點、/rewind 和一條 deny 規則

Claude Code 每送出一句話就自動存一個檢查點。按兩下 Esc 就能還原程式碼或對話,再加一條 deny 規則,不讓它自己 git push。附官方說明和限制。

我以前遇到 Claude Code 把專案改壞,第一個反應都是叫它「再修一次」,結果越修越亂。其實 Claude Code 內建檢查點:你每送出一句話,它就先存一份。這篇是 Reels 裡 REWIND 那支影片的完整版,每一步我都在 2026 年 10 月 30 日對過 Claude Code 官方文件。

01先看結果:按兩下 Esc,回到改壞之前

Reels 畫面:綠色背景前,一座彩色程式積木塔重新疊好,前面兩顆大大的 Esc 鍵,Claw'd 站在旁邊,上方綠色印章寫還原
示意:Reels 裡積木塔倒了,按兩下 Esc 又疊回去。實際操作是在終端機裡選一個還原點。

Claude Code 改壞東西的時候,你不用叫它重寫,也不用自己一行一行改回去。它在你每次送出指令之前,就把檔案存了一份檢查點。按兩下 Esc,選回出事前那一句,就能把程式碼、對話,或兩個一起還原。

看完這篇你會拿到:

  1. 檢查點什麼時候存、存了什麼。
  2. 按兩下 Esc(或 /rewind)之後,每個還原選項的差別。
  3. 兩種它救不回來的東西,以及該怎麼補。
  4. 一條可以直接貼的 deny 規則,不讓 Claude 自己 git push。

02① 先知道:每句話都是一個存檔點

Reels 畫面:筆電螢幕上是 Claude Code 官方 checkpointing 文件,Every prompt you send that starts a turn creates a new checkpoint 那句被框起來
Claude Code 官方文件:每送出一個開始新回合的提示,就建立一個新的檢查點(2026-10-30 截圖)。

檢查點是自動的,不用設定。官方文件寫得很清楚:

  1. 你每送出一個開始新回合的提示,就建立一個新的檢查點。
  2. 它追蹤的是 Claude 用「檔案編輯工具」改的檔案。
  3. 每個工作階段保留最近 100 個檢查點的檔案快照。
  4. 檢查點跟著對話一起存,之後用 /resume 回到這個對話,一樣可以 /rewind。
  5. 預設大約 30 天後會清掉快照,想留久一點可以調 cleanupPeriodDays。

03② 按兩下 Esc,選回那一句

Reels 畫面:官方文件 Run /rewind, or press Esc twice when the prompt input is empty 那段,/rewind 和 twice when the 被框起來
開啟還原選單:輸入框空白時按兩下 Esc,或直接打 /rewind。
  1. 先確定輸入框是空的。
  2. 按兩下 Esc,或輸入 /rewind,開啟還原選單。
  3. 選單會列出你這次送過的每一句,選出事前的那一句。
  4. 再選一個動作(下面說明)。
Reels 畫面:官方文件的動作清單,Restore code and conversation、Restore conversation、Restore code 三行依序被框起來
三種還原:程式碼和對話一起、只還原對話、只還原程式碼。
  1. 還原程式碼和對話(Restore code and conversation):兩個都回到那一句。
  2. 還原對話(Restore conversation):對話回到那一句,程式碼保留現在的樣子。
  3. 還原程式碼(Restore code):檔案改回去,對話保留。
  4. 從這裡摘要/摘要到這裡:不動檔案,把一段對話壓縮成摘要,騰出上下文空間。
  5. 算了(Never mind):回到清單,什麼都不改。

04③ 認清它救不回來的兩種東西

Reels 畫面:官方文件 Limitations 段落,A file that only Bash commands changed isn't tracked and stays as it is 被框起來,下面紅色印章寫救不回來
官方文件的限制:只被 Bash 指令改過的檔案不會被追蹤。
  1. 只被指令改過的檔案:官方原文是「只被 Bash 指令改過的檔案不會被追蹤,會維持原樣」,要用 Git 這類版本控制還原。
  2. 已經推上 GitHub 的東西:/rewind 只還原你電腦上被追蹤的檔案,推送改的是遠端,所以拉不回來(這是我從文件推論的,官方的說法是檢查點不能取代版本控制)。
  3. 另外兩種也要知道:子代理(subagent)的編輯通常不會被還原;你在 Claude Code 外面手動改的檔案也不會被追蹤。

05④ 加一條 deny:不准 Claude 自己 git push

Reels 畫面:官方權限文件的 settings.json 範例,"deny" 和 "Bash(git push *)" 被框起來,左下綠色紙條寫推送你自己按
官方文件的設定範例:deny 裡放 Bash(git push *),Claude 就不會自己推送。

推送是 /rewind 救不回來的,那就乾脆不讓 Claude 自己推。把下面這段放進專案的 .claude/settings.json(只想管所有專案就放 ~/.claude/settings.json),Claude Code 就會拒絕任何以 git push 開頭的指令,推送由你自己按。

.claude/settings.json
{
  "permissions": {
    "deny": [
      "Bash(git push *)"
    ]
  }
}
也可以直接叫 Claude 幫你加([]換成你的)
幫我在[這個專案]的 .claude/settings.json 加一條 permissions.deny 規則:"Bash(git push *)"。檔案裡其他設定不要動,改完給我看 diff。

06要注意

  1. 影片裡的「三秒」是說它很快,不是實際計時。
  2. deny 規則不是保險箱:寫法不同的 push(例如 git -C . push)不會被這條規則擋到。真的要嚴格把關,請看官方文件的 hooks 和 sandbox。
  3. 檢查點的快照預設大約 30 天後清除,太舊的檢查點可能出現 No files were restored。
  4. 檢查點不能取代 Git:重要的版本請 commit。
  5. 以上都是 2026 年 10 月 30 日對照官方文件寫的,Claude Code 更新很快,選單名稱可能會變。

資料來源

延伸閱讀