Claude Code 如何恢復工作階段與查找歷程
使用名稱、ID 或選取器恢復 Claude Code 工作階段,並找出代理程式實際執行所在機器上的純文字對話記錄。
如何繼續 Claude Code 工作階段
若要繼續 Claude Code 工作階段,請執行 claude --continue,開啟目前目錄中最近的對話;或執行 claude --resume,從清單中選取較早的對話。在已執行中的工作階段內,/resume 命令可切換至其他對話,無須結束目前工作階段。簡寫形式為 -c 和 -r。
claude --continue
claude --resume
claude --resume auth-refactor如果已知工作階段名稱或 ID,可將其作為引數傳入,Claude Code 會直接開啟該工作階段,不顯示選取器。
以下內容均符合截至 November 2026 的官方工作階段文件。Claude Code 經常發布新版本,旗標名稱與鍵盤快速鍵也會隨版本變更;如果本文內容與終端機顯示不一致,請以 claude --help 和該頁面為準。
實際上的工作階段
工作階段是繫結至專案目錄的一段已儲存對話。它會保存完整的訊息記錄,包括 Claude 執行的工具呼叫,以及這些呼叫傳回的結果。Claude Code 會在你工作期間持續將內容寫入磁碟,而不是等到最後才寫入,因此即使關閉終端機或 SSH 連線中斷,對話仍會保留。
恢復工作階段時,還原的不只是文字。完整的對話記錄會一併恢復,也包括該工作階段使用的模型,以及啟動工作階段時使用的子代理程式(如果你使用了 --agent)。使用 --continue 或工作階段 ID 從 shell 恢復時,權限模式也會恢復,但有一項基於安全性的例外:永遠不會恢復略過權限檢查模式,因此以該模式結束的工作階段恢復時,會改用新工作階段的預設啟動模式。計畫模式也會恢復,包括從選擇器選取工作階段,或使用 /resume 切換至該工作階段時;這兩種方式在其他情況下不會帶回已儲存的模式。自 v2.1.290 起,從終端機恢復時會還原計畫模式;選擇器與 /resume 則自 v2.1.292 起支援。更早的版本在恢復時也會捨棄計畫模式。從 shell 執行時,--permission-mode 會覆寫恢復的模式。
部分內容不會恢復,因為它們是啟動時旗標,而不是已儲存狀態。使用 --add-dir 新增的目錄,以及 --mcp-config、--settings 和 --plugin-dir 等選項,都必須在恢復時再次傳入。settings.json 等設定檔會在啟動時重新讀取,因此其中的設定不必再次指定。憑證也屬於同一類:Claude Code 會在啟動時根據你的登入資訊與環境判斷驗證方式,而不是隨對話一併恢復。因此,如果你在 VPS 上恢復工作階段時,shell 中意外出現了 ANTHROPIC_API_KEY,即使上次執行正常,也會遇到無效 API key 錯誤。
為什麼工作階段歷史記錄在 VPS 上更重要
有一點常讓人感到意外:逐字記錄會寫入執行 agent 的那台機器。它不會儲存在你的帳戶中,也不會同步至雲端,而是該主機磁碟上的檔案。
因此,你留在 VPS 上 tmux 視窗內的工作階段,不會出現在筆電的選取器中;筆電上的工作階段也不會出現在 VPS 上。兩者之間不會傳輸任何資料。如果你的工作方式和多數人一樣,在 VPS 上於 tmux 中執行 Claude Code,伺服器就會累積你真正的對話歷史記錄,而你在本機看到的選取器則會顯示另一組、規模小得多的記錄。
不同介面之間也存在相同的區隔。桌面應用程式與 VS Code 擴充功能各自保留工作階段歷史記錄,兩者都不是 CLI 的歷史記錄;不過,桌面應用程式也能繼續 CLI 工作階段。Claude Code on the web 也有自己的歷史記錄。Cowork 的隔離程度更高:依預設,其工作階段會在 Anthropic 的雲端中執行,並儲存至你的 Claude 帳戶,而不是儲存在你擁有的硬體上;只有現有的桌面部署會保留本機執行。因此,如果你正在評估 Cowork 與 Claude Code,逐字記錄的儲存位置也是決策的一部分。
在同一台機器上,搜尋範圍比你預期的更廣。claude --resume <session-id> 會先搜尋目前的專案目錄及其 git worktree,接著搜尋該機器上的所有其他專案。請記住「在該機器上」這個條件。來自其他主機的工作階段 ID 找不到對應結果,Claude Code 會以 No conversation found with session ID: <session-id> 告知你這一點。
Claude Code 將工作階段歷程記錄儲存在哪裡
預設情況下,逐字稿會儲存在 Claude Code 設定目錄下,路徑格式為 ~/.claude/projects/<project>/<session-id>.jsonl。
<project> 是工作目錄路徑,其中所有非英數字元都會替換為連字號。因此,在 /home/deploy/apps/api 中啟動的工作階段,會儲存在名稱為 -home-deploy-apps-api 的目錄下。如果轉換後的名稱會超過 200 個字元,Claude Code 會截斷名稱,並附加完整路徑的雜湊值,讓目錄名稱維持在檔案系統限制內。
檔案格式為 JSONL:每行包含一個 JSON 物件。每行可能是訊息、工具使用記錄或其結果、Claude Code 傳送給模型的請求記錄,或中繼資料項目。這是可讀取的文字檔案,讀取它沒有問題。
但不應針對此檔案撰寫解析器。項目格式屬於 Claude Code 的內部格式,可能在不同版本間變更。因此,直接讀取這些檔案的指令碼可能在任何更新後失效。Anthropic 的官方文件建議改用 /export 或文件所述的指令碼介面,正是基於這個原因。
有兩項設定會改變儲存位置與保留期限。CLAUDE_CONFIG_DIR 會將整個設定目錄移至其他位置,可藉此將逐字稿存放在獨立磁碟區或加密磁碟區。cleanupPeriodDays 位於 settings.json 中,用於控制逐字稿的保留時間;預設為 30 天,最短為 1 天。
這些轉錄檔實際包含什麼
每個工具結果都會被記錄,因此轉錄檔會包含 Claude 讀取的檔案內容,以及 Claude 執行命令的輸出。Anthropic 的資料使用頁面明確說明:Claude Code 會在本機以純文字格式,將工作階段轉錄檔儲存於 ~/.claude/projects/。由於轉錄檔也會記錄 Claude Code 傳送給模型的內容,因此可能包含系統提示、工具定義、請求參數,以及載入的 CLAUDE.md 檔案。
請思考這對伺服器代表什麼。如果 Claude 讀取 .env 檔案以判斷服務無法啟動的原因,該檔案內容現在就會位於主目錄中的 JSONL 檔案內。如果某個命令輸出了連線字串,該字串也會被記錄其中。這不代表發生了資料外洩。轉錄檔記錄的是實際發生的內容,這正是它的用途,也因此應將其納入威脅模型。
- 備份:直接備份
/home或/root時,轉錄檔也會被複製到備份目的地。請加入排除規則,否則就必須接受提示內容與檔案內容的副本會存在於備份儲存區。 - 快照與映像:無論基於何種原因建立 VPS 快照,都會包含整個目錄。用來建立第二台伺服器的複製映像也一樣。
- 伺服器上的其他帳號:請使用
ls -ld ~/.claude ~/.claude/projects自行檢查權限模式,不要假設權限已設為嚴格限制。 - 主動上傳:
/feedback命令會刻意將對話記錄傳送給 Anthropic,/bug與/share也會透過相同路徑回報。回饋對話框也可能包含同一專案在最近 24 小時或 7 天內的其他工作階段,而不只目前的工作階段。這些都是由你主動選擇的操作,因此在確認前,請先了解你同意的內容。
如果你不希望建立轉錄檔,CLAUDE_CODE_SKIP_PROMPT_HISTORY 會停用轉錄檔寫入;--no-session-persistence 則會在單次非互動式 claude -p 執行中停用寫入。設定任一選項前,請先確認其中的取捨。resume 會讀取轉錄檔,因此沒有轉錄檔就無法 resume。
如何尋找舊對話
使用 claude --resume 開啟選擇器,或在執行中的工作階段內使用 /resume。每一列會顯示工作階段名稱(如果有設定),或系統產生的標題(如果沒有設定),以及距離上次活動的時間、git 分支和檔案大小。
選擇器支援搜尋。按下 /,或直接開始輸入,即可篩選清單。值得熟悉的快捷鍵是用來擴大搜尋範圍的快捷鍵:Ctrl+A 顯示此電腦上所有專案的工作階段,Ctrl+W 顯示目前儲存庫的所有 worktree,而 Ctrl+B 則限縮至目前的 git 分支。按下 Space 可在選定工作階段前預覽其內容,按下 Ctrl+R 可重新命名反白的工作階段。
為工作階段命名會讓上述操作容易許多。使用 claude -n auth-refactor 啟動工作階段,或在進行到一半、察覺對話已經變成實際工作時執行 /rename auth-refactor。之後即可直接從 shell 以名稱恢復具名工作階段。
未命名的工作階段仍會取得系統產生的標題。這個標題由背景請求交給小型快速模型產生,用來摘要你的第一個提示。該標題能協助你在選擇器中辨識工作階段,也可作為恢復工作階段的識別名稱:claude --resume 會以與你自行設定的名稱相同的方式解析它。但無法使用的是預設顯示名稱,例如 my-app-3f。未命名的互動式工作階段會在執行中工作階段清單中使用這類名稱。將它傳給 claude --resume 時,Claude Code 找不到該工作階段。
搜尋轉錄內容以找出正確工作階段
有時你只記得一句話,其他資訊都想不起來。轉錄內容是文字,因此可以搜尋。
grep -rl "nftables" ~/.claude/projects/這會列出符合條件之轉錄檔的路徑。移除 .jsonl 副檔名後的檔名就是工作階段 ID,而 claude --resume <session-id> 可接受此 ID。claude --resume 也可直接接受轉錄檔的絕對路徑。先使用 grep 判斷要使用哪個工作階段,再恢復該工作階段或將其匯出,以便實際閱讀內容。
有兩點需要注意。內容採用 JSON 跳脫格式,因此包含引號的片語,或跨越換行的片語,可能無法以字面字串比對成功。此外,如果比對結果出現在工具結果中,代表 Claude 看到了該文字,不代表有人輸入過該文字。
讀取與匯出對話
/export 會將目前的對話轉換為純文字,並以易讀格式輸出訊息與工具輸出,而不是 JSON。未提供引數時,會開啟選單,讓您選擇剪貼簿或檔案。指定檔名時,/export handover.txt 會直接寫入該路徑。若要將對話從伺服器移至筆記型電腦,或將對話附加至工單,應使用這個方式。
若要進行自動化,請使用設計為保持穩定的介面。Hooks 和 status line commands 會接收 transcript_path 欄位作為輸入,因此 SessionEnd hook 可以在工作階段結束時封存文字記錄。您也可以不開啟已儲存的工作階段,直接向它提問:
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'這會將後續提示傳送至舊對話,並傳回結構化 JSON。這比剖析可能在下一個版本變更的 JSONL 格式可靠得多。
重新開始勝過繼續工作時
繼續對話會恢復完整歷史,而之後的每個請求都會攜帶這些歷史。昨天執行了 4 小時的對話,今天繼續使用時成本很高;長時間工作階段中的 token 用量如何累積說明了這些成本的實際來源。
Claude Code 有時會替你採取折衷方案。如果你在互動式終端機工作階段中讓長時間對話閒置,而該對話使用一小時 prompt cache,Claude 訂閱方案會依方案內容,預設為主要對話提供這項快取;當快取即將在約 54 分鐘後到期時,閒置壓縮會先壓縮對話。這項功能會在對話內容達到 token 閾值後套用,預設值為 200,000;使用者也必須啟用自動壓縮,且此時電腦保持喚醒狀態。在 v2.1.314 之前,Claude Code 還需要向 Anthropic 取得功能旗標,因此關閉遙測的訂閱者無法使用;自 v2.1.314 起,這些使用者也能使用,VS Code 擴充功能的聊天面板和桌面應用程式的 Code 分頁也同樣支援。系統不會先顯示對話框詢問。你返回時,對話會顯示一行以 Compacted while idle, before the prompt cache expired 開頭的文字,而你的下一則訊息會傳送摘要,不會傳送完整歷史。
- 保持啟用後,之後的請求成本較低,但摘要捨棄的內容將無法再取得。你可以使用
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS降低閾值,但低於 100,000 的值會調高為 100,000。 - 在
settings.json中將idleCompaction設為false,或在 v2.1.302 及更新版本的/config中,從 Idle compaction 列將其關閉。如此可保留完整對話,但每次請求的成本會隨對話大小增加。如果你傳送下一則訊息時快取已到期,該請求會重新處理完整歷史一次。
在 Pro 和 Max 方案中,v2.1.304 新增了另一項檢查;目前文件也列出 Ultra 方案。當你在長時間中斷後繼續長對話,或改用不同模型時,如果此操作會占用 5 小時用量上限中相當大的比例,系統會顯示 Resume this conversation? 對話框,提供預估比例,並讓你選擇繼續或開始新對話。當開始新對話的選項如此說明時,如果你提到先前的對話,Claude 可以查閱該對話。
判斷方式比看起來簡單。下一步要輸入的內容取決於先前已說過的內容時,就繼續對話;不取決於先前內容時,就重新開始。只要留意,就很容易發現內容偏移:例如 Claude 提到你一小時前已刪除的檔案,或重新爭論你在工作階段開頭已經決定的事項。這就是過時的內容脈絡;繼續攜帶這些內容會同時增加 token 用量,並降低準確性。
如果舊對話中有一項決策或事實之後還會用到,不要依賴繼續對話來保留它。請將其記錄在每個工作階段都能看見的位置,這正是 Claude Code 的記憶檔案的用途。
/branch 在這裡也值得了解。它會複製目前位置以前的對話,並將你切換到副本,同時保留原始對話,讓它繼續顯示在選擇器中。你可以用它嘗試第二種方法,而不會遺失第一種方法。
resume 與 compaction 及 memory 的差異
這些功能經常被混淆,但解決的是不同問題。
resume 用於在離開、重新開機或轉而處理其他工作後,重新開啟原本的對話。compaction 則處理仍在進行中的對話所使用的 context window:/compact 會以摘要取代 Claude 目前保留的內容,讓後續請求傳送較少的 tokens。如果問題是 context window 已滿,應使用 compaction;管理 Claude Code context window 會完整說明相關作法。
memory 又是另一回事。CLAUDE.md 檔案和 auto memory 會在每個 session 開始時載入 instructions 和 facts,因此它們不是供你返回的對話,而是你記錄下來、之後就不必再返回對話的內容。
如果你想同時執行兩個對話並讓它們互相協調,那是另一種機制。Claude Code sessions 可以互相傳送訊息,前提是兩個 session 都仍在執行中;這和從磁碟重新載入昨天的 session,是不同的問題。
FAQ
Claude Code 將工作階段歷程儲存在哪裡?
預設會儲存在設定目錄下的 ~/.claude/projects/<project>/<session-id>.jsonl,其中 <project> 是將工作目錄路徑中的非英數字元替換為連字號後的結果。每個檔案都是 JSONL:每行包含一個 JSON 物件,代表訊息、工具使用或其結果、傳送至模型的請求,或中繼資料項目。CLAUDE_CONFIG_DIR 會將設定目錄移至其他位置,而 settings.json 中的 cleanupPeriodDays 會設定逐字稿的保留時間;預設為 30 天,最低為 1 天。
為什麼我在筆記型電腦的選取器中看不到 VPS 工作階段?
因為逐字稿會寫入執行代理程式之電腦的磁碟,且不會在電腦之間同步。您在 VPS 的 tmux 中進行的對話只存在於 VPS。請透過 SSH 在該 VPS 上恢復工作階段;如果需要保留本機記錄,也可以在其中執行 /export,再將文字檔複製到本機。
我可以恢復在其他目錄中開始的工作階段嗎?
可以,但您需要該工作階段的 ID。claude --resume <session-id> 會先在目前專案目錄及其 git worktree 中搜尋,再搜尋同一台電腦上的其他專案。在選取器中,Ctrl+A 會將清單擴大至電腦上的所有專案,而 Ctrl+W 會將清單擴大至目前儲存庫的所有 worktree。如果沒有相符項目,Claude Code 會顯示 No conversation found with session ID: <session-id>。
我應該恢復舊工作階段,還是開始新的工作階段?
如果下一則訊息取決於對話中先前已說明的內容,請恢復工作階段。如果不相依,請開始新的工作階段,因為恢復工作階段會重新載入完整歷程,之後的每個請求都會攜帶這些內容。請注意內容是否逐漸偏離:如果工作階段持續提及您已刪除的檔案,表示其中仍帶有過時的上下文;這些上下文會在每一輪消耗 token,並降低準確度。
我可以阻止 Claude Code 將逐字稿寫入磁碟嗎?
可以。CLAUDE_CODE_SKIP_PROMPT_HISTORY 會禁止寫入逐字稿,而 --no-session-persistence 會在單次非互動式 claude -p 執行中禁止寫入。請先了解取捨,因為 resume 會讀取逐字稿;關閉寫入後,--continue 與 --resume 將沒有可載入的內容。如果您在意的是檔案的存放位置,而不是完全不建立檔案,可以將 CLAUDE_CONFIG_DIR 指向加密磁碟區,並改為降低 cleanupPeriodDays。