生活分享
Claude Code|Checkpoint 與 /rewind
區分回復對話、回復檔案與 Git 還原。Checkpoint 與 /rewind 可以在 Claude Code 工作階段內回到先前的對話或受追蹤檔案狀態。本篇會用一個主標題修改練習三種還原選擇,並說明哪些變更不在範圍內。你會知道它適合快速回復局部嘗試,但不能代替 Git、資料備份或外部操作的補救流程。
閱讀時間約 5 分鐘

Checkpoint 與 /rewind 可以在 Claude Code 工作階段內回到先前的對話或受追蹤檔案狀態。本篇會用一個主標題修改練習三種還原選擇,並說明哪些變更不在範圍內。你會知道它適合快速回復局部嘗試,但不能代替 Git、資料備份或外部操作的補救流程。
請在練習專案Claude Code|準備第一個練習專案取得待辦清單材料,認識檔案及啟動方法。本系列共用一個小型待辦清單網站,讓你在不同功能教學裡看到熟悉的檔案與行為。它使用 HTML、CSS、JavaScript,不需要資料庫、API 金鑰或另外安裝 npm 套件。起始版已能新增、勾選與刪除待辦;後面的練習會加入篩選、儲存和測試,讓你逐步理解 Claude Code 如何協助改動專案。閱讀全文的獨立副本操作,先保存原始材料或建立 Git 基準。不要一開始就用多 session、子代理子代理(Subagent)是什麼:把有邊界的工作交出去子代理是由主代理委派特定工作的代理,通常有自己的任務上下文,再把結果交回主代理整合;它不一定使用不同模型,也不必永久保存記憶。本文以社區刊物的資料查核為例,說明交辦範圍、證據格式、同步與背景執行的差別,以及為什麼子代理說完成仍需要驗收。附交接圖與實用檢查表,幫你判斷何時分派能減少負擔。閱讀全文或命令搬檔做還原實驗,因為不同操作的追蹤條件不同。本篇先讓 Claude 透過一般檔案編輯工具修改 index.html。
Checkpoint 保存什麼
閱讀完整文字說明
Checkpoint 與 /rewind,以流程和文件圖形呈現教學重點。
Claude Code 會為開始新回合的提示建立檢查點,追蹤其檔案編輯工具造成的變更。檢查點與對話一起保存,有保留數量與清理期限,並不是無限期版本倉庫。對長期歷史與多人協作,仍應使用GitClaude Code|Git、差異審查與 PR檢查差異、整理提交與準備 PR。Claude Code 完成功能後,還需要檢查差異、整理提交並決定如何交給他人審查。本篇用待辦專案示範 Git 工作目錄、暫存區與提交的關係,最後準備一份 Pull Request 說明。你會知道測試通過、本機提交、遠端 PR、合併與部署是不同狀態。閱讀全文。
| 還原選項 | 對話變化 | 檔案變化 |
|---|---|---|
| Restore code and conversation | 回到選定位置 | 回復受追蹤變更 |
| Restore conversation | 回到選定位置 | 保留目前檔案 |
| Restore code | 保留目前對話 | 回復受追蹤變更 |
| Summarize 選項 | 壓縮指定對話範圍 | 不修改檔案 |
有些選项只在選定檢查點存在可還原檔案時出現。若目前只是只讀聊天,沒有看到 Restore code 不一定是故障。先確認這個回合是否真的透過檔案編輯工具產生變更,再看選單內容。
建立一個容易辨認的修改
先打開 index.html 記下目前 h1 文字,啟動 Claude 並要求只改主標題。明確保留其他檔案與功能,方便之後判斷還原範圍。完成後看差異,確認實際使用的是檔案編輯,而不是 shell 腳本直接改寫。
請透過檔案編輯工具,把 index.html 的可見主標題改為「Checkpoint 練習」。
只改這段文字,不使用 shell 腳本修改檔案,不建立 Git 提交。
完成後指出實際差異,方便我練習 rewind。
檢查檔案已出現新標題,再輸入 /rewind 開啟選單。也可以依介面支援使用空白輸入時連按兩次 Esc;若輸入框已有文字,快捷鍵可能先清除輸入,所以初學直接用指令比較清楚。
/rewind
先練習只還原程式
選擇啟動主標題修改的提示,閱讀可用動作,使用 Restore code。完成後對話仍保留你要求修改與回報的歷史,但 index.html 應回到原標題。這是刻意讓對話與檔案分開,用來理解兩種狀態的差別。
請重新讀取 index.html,回報目前 h1 文字。
對照剛才修改前後的內容,確認是否已回復。
先不要再次套用修改,也不要依對話中的舊回報猜測。
同時用編輯器或 Git diff 核對。若畫面還顯示舊內容,先確認瀏覽器是否重新整理與伺服器是否對應同一資料夾。還原成功與預覽更新是兩個檢查步驟,不應只看聊天回覆判斷。
比較對話還原與全部還原
再次做一次小標題修改,這次選 Restore conversation。你會回到先前對話位置,但檔案仍保持修改後內容;因此接下來的提示應先重新讀檔,不能假設磁碟也已回復。若想同時回復兩者,才選 Restore code and conversation,並再檢查檔案差異。
每次實驗只改同一段文字,保留清楚的原值與新值。這樣你能分辨選項效果,而不是在複雜功能修改中猜哪些行應該存在。選錯時先停止新的修改,查看目前檔案與對話,再決定下一個動作。
哪些操作不能依賴 rewind
shell 命令造成的檔案刪除、搬移或改寫不屬於一般檔案編輯追蹤;外部服務、資料庫操作、Git 推送與部署也不能靠對話還原撤銷。其他 session 與多數子代理的變更通常不在主 session 的還原範圍,符號連結或硬連結檔案也有跳過限制。
例如測試命令產生了一份輸出檔,rewind 回到命令前並不保證它消失;如果已把訊息送到外部服務,對話回退也不會收回訊息。這些情況要使用各自的版本、備份或補償操作,並驗證外部狀態。
若檢查點已超過保留範圍或快照被清理,還原可能失敗。看到「沒有檔案被還原」或「部分檔案跳過」時,讀取具體紀錄,不要把部分成功寫成全部完成。先查看受影響檔案,再決定使用 Git 或手動反向修改。
若你在 Claude 修改後又手動調整同一檔案,先保存手動差異再做還原。檢查點回復可能影響重疊區域,不能假設它會理解哪些行屬於你想保留的工作。這也是先用單一標題練習、再處理複雜修改的原因。
摘要功能與完成判準
rewind 的摘要選項可以只整理對話的一段,適合保留後半段工作或壓縮冗長調查。它們不會更動磁碟檔案,也不是還原的別名。需要整體上下文整理時,請參考/compact 與 /clearClaude Code|上下文整理:context、compact 與 clear選擇保留、壓縮或清空上下文的時機。對話變長時,Claude Code 需要在有限的上下文中保留需求、檔案與工具結果。本篇會用 /context 查看內容占用,用 /compact 整理仍要繼續的工作,再用 /clear 切換到無關的新任務。你會知道這三個指令分別是在觀察、摘要或開始新對話,不會把它們誤當成刪檔與還原功能。閱讀全文。
小練習是以主標題依序比較只還原程式、只還原對話與兩者一起還原,記錄每次的對話位置和 h1 文字。完成判準是能預測三個選項的差別,知道沒有追蹤的操作需另行處理,並保留一份 Git 或原始材料作為長期基準。熟悉後再將它用於較大的功能嘗試。
回 Claude Code 教學總目錄Claude Code 完整教學目錄:從入門到自動化依平台、程度與功能找到需要的教學,從 96 篇文章與共用練習專案逐步完成操作。這個教學中心把 Claude Code 分成 96 個可以獨立閱讀的小題目,從桌面、CLI、網頁與手機開始,再學 MD 規則、常用指令、Skills、MCP 與自動化。你可以依推薦路線循序學習,也可以直接搜尋正在遇到的功能、命令或檔名。目錄依目前公開狀態顯示可閱讀文章。閱讀全文
覺得這篇整理實用嗎?分享給需要的朋友
同主題延伸閱讀
生活分享
Claude Code|建立第一個 mod:在 Claude Code 行程內數工具呼叫
寫一個三檔案的 mod,用驗證器與測試確認它掛上的事件。文件把 mod 定義成多了入口檔的 plugin:入口檔叫 hooks module,Claude Code 在事件發生時呼叫裡面的函式,函式可以觀察、改寫或接手事件。
生活分享
Claude Code|Git Worktree 平行工作
隔離多個任務的檔案與分支。Git Worktree 讓同一儲存庫擁有多個工作目錄,各自使用分支與檔案。本篇會把待辦篩選與文件整理分開,確認兩個 session 不會直接改到彼此的檔案,再把其中一個成果整合回主分支。你也會知道何時可以安全清理工作目錄。
生活分享
Claude Code|雙 Worktree 實作與衝突整合
隔離兩項功能,最後完成整合與回歸。兩個 Claude 工作階段同時編輯專案,最容易出現的問題是互相改到同一份檔案,或各自測試通過、整合後卻失敗。本篇用兩個 Worktree 分別處理篩選預設值與介面文字,故意製造一次小衝突,再完成整合、驗證與清理。你不需要先啟用 Agent Teams。
生活分享
Claude Code|比較流程品質、用量與執行時間
以同一資料集比較兩種工作方法。比較兩種 Claude 工作方法時,不能只挑成功那一次,也不能只看第一個答案有多快。本篇用固定案例、原始紀錄和一致判準,比較品質、重試、等待與人工整合時間,最後寫出有樣本數與限制的報告,而不是保證某個方法一定省錢。
引用本文的文章
資料來源
- Checkpointing查證日期:
- Manage sessions查證日期:
本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。