cmux 中的工作階段還原

當應用程式可以重建你的工作形狀時，終端機工作流程就更能承受中斷。cmux 現在把工作區版面視為持久狀態，而不是綁定到某個應用程式程序的暫時狀態。

重要的界線是即時程序狀態。cmux 會還原自己擁有的內容，以及支援工具透過自身還原 API 暴露的內容。它不會為任意終端機程序建立檢查點。

如果你想知道終端機當機後如何復原 Claude Code、OpenCode、opencode、Codex、Gemini CLI、Antigravity CLI、Grok Build CLI、Amp、Cursor CLI、Rovo Dev、Copilot、CodeBuddy、Factory、Qoder 或 Hermes Agent 工作階段，請安裝 cmux hooks，並保持 agent 復原功能開啟。

一定會回來的內容

正常重新啟動後，cmux 會還原應用程式層級的工作階段快照：

• 視窗、工作區與窗格版面
• 工作目錄
• 終端機捲動記錄，盡力還原
• 瀏覽器 URL 與導覽歷史

代理工作階段需要 hooks

當 cmux 擁有原生工作階段 ID 時，Claude Code、Codex、Grok Build CLI、OpenCode、Pi、Amp、Cursor CLI、Gemini CLI、Antigravity CLI、Rovo Dev、Hermes Agent、Copilot、CodeBuddy、Factory 和 Qoder 都可以繼續工作階段。對大多數 agent，請用 cmux hooks setup 安裝整合。

cmux hooks setup

setup 指令會安裝 PATH 中找得到的支援代理，並略過其他代理。啟用 Settings 中的 Claude 整合後，Claude Code 由 cmux Claude 包裝器處理。

運作方式

cmux 會在 Application Support 下寫入 JSON 工作階段快照，其中包含視窗樹、工作區中繼資料、窗格版面、終端機 cwd、捲動記錄重播資料與瀏覽器導覽狀態。

代理 hooks 會把工作階段對應寫入 ~/.cmuxterm。還原時，cmux 會先重建 UI。若已啟用自動代理還原，它會使用儲存的工作階段 ID 啟動每個支援代理的原生還原指令。

不在範圍內的內容

tmux、vim、shell 與未支援工具會以一般終端機重新開啟，除非它們有 cmux 整合可記錄安全的原生還原指令。這讓還原保持可預期，並避免重播過期提示或密鑰。

閱讀工作階段還原文件，了解設定指令、支援代理與疑難排解。