Coolkid mascot CoolkidLab Build in Public. Level up together.
首頁新手教學免費工具AI 新聞GitHub 精選陪跑服務關於

新手教學 · 疑難排解

Claude Code 不能 rewind?8 個原因與 4 道防線

閱讀
摘要

短答給趕時間的人:rewind 是「本機的小倒帶」,不是保險箱。官方文件寫明,rewind 只追蹤 AI 用編輯工具改的檔案,指令改的、分身改的都不在快照裡,而且快照預設 30 天清掉、每個對話只留最近 100 個斷點。所以不能倒帶通常不是壞掉,是本來就超出快照的範圍。用下面 8 個原因的對照表找你中的那一項,再用 4 道防線讓「救不回」變成虛驚。

最近我的一直失靈。

按 ESC 兩下、選要回去的那則訊息,跳出「Can't rewind to this message」(無法倒帶到這則訊息),換一則還是同樣的錯誤,再換一則,還是一樣。

不挑訊息,每一則都倒不回去。

我用的是桌面 App。查了才發現,這是 上掛著的已知問題:今年 5 月更新後開始,官方把回報單關掉、標成「不打算修」。

回報的人說,同一台電腦開終端機版就正常。

他在 Mac 上遇到,我在 Windows 上遇到,這件事不挑系統。

這件事逼我去找官方文件。讀完的心得是:就算沒有這個問題,rewind 能救的範圍也比我以為的窄很多。

這篇前半是「不能 rewind 的 8 個原因」對照表,後半是 4 道防線,包含一個整個資料夾被刪光的真實案例。

rewind 到底存了什麼?

rewind 的原理是快照:每次你送出一句話之前,Claude Code 先把檔案狀態拍下來,之後可以退回去。官方文件白紙黑字寫了三個關鍵限制。

  1. 只追蹤 AI 用編輯工具改的檔案。AI 跑指令做的改動(例如刪檔、搬檔)、分身()做的修改,官方明列不在快照裡。
  2. 快照有期限。存在你電腦的 .claude 資料夾裡,預設 30 天清掉,每個對話只留最近 100 個斷點。
  3. 官方自己的定位 是「本機的復原鍵(local undo)」,git 才是「永久的歷史(permanent history)」。這是原文直譯,不是我的解讀。

白話翻譯:rewind 管的只有 AI 自己動手改的檔案,而且只有最近的。

指令改的、分身改的、放太久的,都不在快照裡,要靠 git 才救得回。

不能 rewind 的 8 個原因對照表

我把官方限制加上自己遇到的狀況整理成一張表。從左邊找你的症狀。

你遇到的狀況原因怎麼辦
選單裡只剩「還原對話」,沒有「還原程式碼」那個斷點之後沒有 AI 編輯工具改過的檔案,官方寫明這時選項不會出現不是壞掉,想回檔案就選更早的斷點
倒帶了,檔案沒變回來那些改動是 AI 跑指令做的,不在快照裡用 git 還原,不會下指令就叫 AI 代勞
分身做的修改回不去subagent 的編輯不進本對話的快照,官方明列用 git 還原
舊對話倒不回去快照預設 30 天清掉,每個對話只留最近 100 個斷點超過期限只能靠 git
按 ESC 兩下沒反應輸入框裡有字時,ESC 兩下是清空輸入,不是開選單先清空輸入框再按,或直接打 /rewind
整個功能像不存在設定裡的 Rewind code 開關被關掉打開開關,之後的改動才有快照
換了電腦或清過資料夾快照存在本機 .claude 資料夾,清掉就沒了沒救,靠 git 跟備份
桌面 App 每一則都跳 Can't rewind to this messageGitHub 已知問題,官方標「不打算修」,回報者說同機終端機版正常重要的倒帶去終端機做,桌面 App 的 rewind 先別當保險

前 7 項全部有官方文件背書。第 8 項我在官方文件裡找不到任何說明,只有 GitHub 回報單,我自己在 Windows 撞到同一款。

看出共通點了嗎?8 項裡有 6 項的解法指向同一個地方:git。

最壞的情況:連 git 都一起消失

那靠 git 就萬無一失了嗎?大部分時候夠用,但有一種情況連 git 都陪葬。一份公開的事故檢討記錄了全程。

一個自動化程式在清理暫存檔的時候,把「目前所在的資料夾」誤當成要清的暫存資料夾,一口氣刪光整個專案,連 .git,也就是 git 的整本歷史,都一起蒸發。

更值得記住的是原因:舊版程式本來有一道防這件事的檢查,是後來 AI 改寫的時候被拿掉的。

最後靠兩條命活回來:電腦的系統快照,加上早就推上 GitHub 的雲端備份。本機的一切都沒了,救援全部來自電腦之外。

寫在程式裡的防線,會在下一次改寫時被拆掉。AI 的自我約束是軟的,環境的圍欄才是硬的。

對照官方文件再看一次就懂:被指令刪掉的檔案,rewind 明列救不回。

而 git 的歷史就住在專案資料夾裡,資料夾整個消失,歷史跟著消失,這種等級的事故,前面 8 個原因的解法全部失效。

我的 4 道防線

那防線要怎麼設?我的配置是 4 道,一道比一道外圈:兩道設定一次就自動跑,另外兩道練成固定習慣。

  1. 權限防線。刪除類的指令要 AI 先問過我,全自動同意的模式不開。設定方法見權限設定那篇
  2. git 加遠端。做完一段就存斷點,推上 GitHub 等於多一份異地備份。上面案例的主角,一半是靠這條活的。不會指令就跟 AI 說「幫我把目前進度存成斷點並推上去」。
  3. 系統快照。Mac 開 Time Machine,Windows 開檔案歷程記錄。案例主角的另一半命是這條救的。
  4. 隔離。專案放獨立資料夾,不讓 AI 直接在桌面或整個家目錄工作。要同時跑好幾個實驗,就請 AI 幫每個實驗各開一個獨立的工作資料夾,互不干擾(分身派工那篇有講)。

回到 rewind 本身:這功能還是好用的,反悔上一步靠倒帶最快。

只是官方那句話值得抄在心裡:checkpoint 是本機的復原鍵,git 才是永久的歷史。倒帶拿來反悔,防線拿來保整個專案,兩個都要有。

rewind 是本機的小倒帶,不是保險箱。官方文件寫明三個限制:只追蹤 AI 用編輯工具改的檔案(跑指令做的改動、分身 subagent 做的修改都明列救不回)、快照存在本機 .claude 資料夾預設 30 天清掉、每個對話只留最近 100 個斷點,官方自己的定位是 checkpoint 等於本機復原鍵、git 才是永久歷史。不能 rewind 的 8 個常見原因:斷點之後沒有被追蹤的編輯(還原程式碼選項不出現)、改動來自指令、改動來自分身、超過保存期限、輸入框有字時 ESC 兩下變成清空、功能開關被關、快照資料夾被清、桌面 App 的已知問題(GitHub 編號 57206,今年 5 月更新後全部訊息跳 Can't rewind to this message,官方標不打算修,回報者說同機終端機版正常,我在 Windows 撞到同款)。8 項裡 6 項的解法指向 git,但一份公開的事故檢討顯示連 git 都可能陪葬:自動化程式誤把目前資料夾當暫存清掉,連 .git 一起刪光,靠系統快照加 GitHub 遠端才救回,而且原本防這件事的檢查是 AI 改寫時拆掉的。我的 4 道防線:權限防線(刪除類指令要問)、git 加遠端、系統快照(Time Machine 或檔案歷程記錄)、專案資料夾隔離。

名詞解釋

Rewind(倒帶)
Claude Code 內建的復原功能:每次你送出指令前先拍一張檔案快照,按 ESC 兩下或打 /rewind 可以退回之前的狀態。只追蹤 AI 用編輯工具改的檔案,跑指令做的改動不算。
Checkpoint(斷點快照)
Rewind 功能背後的存檔點:每則指令送出前自動存一張檔案快照,預設保留 30 天、每個對話最多 100 個。官方定位是「本機的復原鍵」,永久的歷史還是要靠 git。
Git
程式碼的版本紀錄系統:每次改動存成一個「存檔點」(commit),隨時可以回溯、比對、還原,不怕改壞。
GitHub
放 Git 程式碼的雲端平台,也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
subagent(子代理)
AI 派出去的分身:主對話把一件事外包給另一個獨立的 AI 執行,做完只回報結果,不佔用主對話的記憶空間。

全站名詞表 · 161 條 →

不想錯過 Lab 的新文章?
訂閱後有新文章上線,就寄信通知你,
點有興趣的進來看就好。

填 email 就完成訂閱(信由 Substack 代寄)、隨時取消、不轉賣 email。

如果內容對你有用就太好了
隨喜斗內

Buy Me a Coffee at ko-fi.com
NEXT CHAPTER ▸ Claude Code 改壞怎麼辦?Esc 兩下倒帶還原

▸ 常見問題

Claude Code 按 ESC 兩下沒反應,怎麼開倒帶選單?

先看輸入框有沒有字。輸入框有字的時候,ESC 兩下是清空輸入,不是開選單,清空之後再按一次就出來了,或者直接打 /rewind。如果是桌面 App 每一則訊息都跳錯誤,那是另一件事,見下一題。

桌面 App 一直跳 Can't rewind to this message 怎麼辦?

我自己就遇到這個。查證結果是 GitHub 上的已知問題(編號 57206),今年 5 月更新後出現,官方已把回報單標成不打算修,而且我在官方文件裡沒找到桌面 App 的 rewind 說明。回報的人說同一台電腦開終端機版就正常。我的做法:重要的倒帶去終端機做,平常靠 git 斷點,不把桌面 App 的 rewind 當保險。

為什麼倒帶了檔案沒變回來?

最常見的兩個原因:那些改動是 AI 跑指令做的,或者是分身(subagent)做的。官方文件明列這兩種都不在快照裡,rewind 只追蹤 AI 用編輯工具直接改的檔案。這兩種情況都要改用 git 還原,不會下指令就叫 AI 代勞。

rewind 的快照存在哪?存多久?

存在你電腦的 .claude 資料夾裡,是看得到的明文檔案。預設 30 天跟著對話一起清掉,而且每個對話只保留最近 100 個斷點。清掉資料夾或換電腦,倒帶能力就跟著消失,長期的保障要靠 git 跟雲端備份。

選單裡沒有「還原程式碼」選項,是壞掉了嗎?

不是。官方寫明:選的那個斷點之後如果沒有被追蹤的檔案編輯,還原程式碼的選項就不會出現,只剩還原對話跟摘要。想退檔案就往前選更早的斷點。

不會 git,只靠 rewind 可以嗎?

官方自己的定位是:checkpoint 是本機的復原鍵,git 才是永久的歷史,兩個是搭配不是取代。不會指令沒關係,跟 AI 說「幫我把目前進度存成一個斷點」就等於在用 git。再加開系統備份(Time Machine 或檔案歷程記錄),就算遇到整個資料夾消失的最壞情況,也活得回來。

看完這篇之前先確認:

適合你
  • 按了 rewind 卻跳錯誤、或倒帶了檔案沒變回來的人
  • 想知道 rewind 到底能救什麼、救不了什麼
  • 把 rewind 當成唯一保險,想確認這樣夠不夠
不適合
  • 還不知道 rewind 是什麼(先看 Rewind 倒帶教學那篇)
  • 在找 git 指令教學的人(這篇只教你叫 AI 代勞)
  • 網站改壞但能正常倒帶的人(那篇教學就夠用)

← 回新手教學 · 看「出錯看這裡」這個主題

⚠ 本站所有內容僅供教育與研究用途,不構成投資建議,不保證任何獲利。投資有風險,使用者須自行判斷並承擔結果。
TAO 道 · Hikari Zen YouTube ↗
音樂透過 YouTube 播放
♪ TAO 道 · Hikari Zen — Japanese Zen Music(YouTube)