95當設定開啟時，若要啟動常規工作階段，請傳遞提示：`claude "fix the login test"`。若要關閉設定，在常規工作階段中或從 agent view 附加的工作階段中執行 `/config defaultToAgentsView=false`。95當設定開啟時，若要啟動常規工作階段，請傳遞提示：`claude "fix the login test"`。若要關閉設定，在常規工作階段中或從 agent view 附加的工作階段中執行 `/config defaultToAgentsView=false`。
96 96
97<h2 id="monitor-sessions-with-agent-view">97<h2 id="monitor-sessions-with-agent-view">
98 使用代理檢視監控工作階段98 使用 agent 檢視監控工作階段
99</h2>99</h2>
100 100
101執行 `claude agents` 以開啟代理檢視。它會接管整個終端機，並按狀態列出每個工作階段，已釘選的工作階段和需要您的工作階段位於頂部。每一列顯示工作階段的名稱、目前活動和年齡，年齡從工作階段建立時開始計算；已完成的工作階段的年齡會凍結在執行所花費的時間。101執行 `claude agents` 以開啟 agent 檢視。它會接管整個終端機，並按狀態分組列出每個工作階段，已釘選的工作階段和需要您處理的工作階段位於頂部。每一列顯示工作階段的名稱、目前活動和經過時間，經過時間從工作階段建立時開始計算；已完成工作階段的經過時間會固定為該次執行所花費的時間。
102 102
103名稱會以該工作階段中由 [`/color`](/docs/zh-TW/commands) 設定的顏色著色，包括當您使用 `←` 或 `/background` [背景執行工作階段](#from-inside-a-session) 時。103名稱會以該工作階段中由 [`/color`](/docs/zh-TW/commands) 設定的顏色著色，包括當您使用 `←` 或 `/background` [將工作階段移至背景](#from-inside-a-session) 時。
104 104
105根據預設，清單會顯示您已啟動的每個背景工作階段，跨越所有專案。在一個儲存庫中工作的工作階段和在不同 worktree 中工作的另一個工作階段都會出現在這裡，無論您從哪個目錄開啟代理檢視。若要將清單縮小到一個專案，請傳遞 `--cwd`：105根據預設，清單會顯示您已啟動的每個背景工作階段，涵蓋所有專案。在一個儲存庫中工作的工作階段和在另一個 worktree 中工作的工作階段都會出現在這裡，無論您從哪個目錄開啟 agent 檢視。若要將清單縮小到單一專案，請傳遞 `--cwd`：
106 106
107```bash theme={null}107```bash theme={null}
108claude agents --cwd ~/projects/my-app108claude agents --cwd ~/projects/my-app
109```109```
110 110
111這只會顯示在該目錄下啟動的工作階段。它仍然會列出已 [移入 worktree](#how-file-edits-are-isolated) 在 `~/projects/my-app/.claude/worktrees/` 下的工作階段。111這只會顯示在該目錄下啟動的工作階段。它仍然會列出已 [移入 `~/projects/my-app/.claude/worktrees/` 下的 worktree](#how-file-edits-are-isolated) 的工作階段。
112 112
113您在其他終端機中開啟的互動式工作階段不會出現，直到您 [背景執行它們](#from-inside-a-session)。[子代理](/docs/zh-TW/sub-agents) 和 [隊友](/docs/zh-TW/agent-teams) 工作階段產生的不會列為單獨的列。113您在其他終端機中開啟的互動式工作階段不會出現，直到您 [將它們移至背景](#from-inside-a-session)。工作階段產生的 [subagent](/docs/zh-TW/sub-agents) 和 [隊員](/docs/zh-TW/agent-teams) 不會列為單獨的列。
114 114
115```text theme={null}115```text theme={null}
116Pinned116Pinned
124 124
125Working125Working
126 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m126 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m
127 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m127 ✢ playtest level 3 all checkpoints cleared ×12 in 4m
128 128
129Completed129Completed
130 ✻ title screen result: menu, options, and credits done 9m130 ✻ title screen menu, options, and credits done 9m
131 ∙ sound effects result: 14 SFX exported to assets/audio 4h131 ∙ sound effects 14 SFX exported to assets/audio 4h
132 … 6 more132 … 6 more
133```133```
134 134
141| 狀態 | 圖示顯示為 | 意義 |141| 狀態 | 圖示顯示為 | 意義 |
142| :- | :- | :- |142| :- | :- | :- |
143| Working | 動畫 | Claude 正在主動執行工具或產生回應 |143| Working | 動畫 | Claude 正在主動執行工具或產生回應 |
144| Needs input | 黃色 | Claude 正在等待只有您才能提供的內容：問題的答案、權限決定，或只有您才能回答的其他提示，例如 [沙箱](/docs/zh-TW/sandboxing) 提示以允許網路主機或 MCP 伺服器的 [輸入請求](/docs/zh-TW/mcp#respond-to-mcp-elicitation-requests)。需要附加終端機的命令，例如 `/install-github-app` 或 `/mcp` 設定清單，[也會在此處保留無人值守的工作階段](#attach-to-a-session) |144| Needs input | 黃色 | Claude 正在等待只有您才能提供的內容：問題的答案、權限決定，或只有您才能回答的其他提示，例如 允許網路主機的 [沙箱](/docs/zh-TW/sandboxing) 提示，或 MCP 伺服器的 [輸入請求](/docs/zh-TW/mcp#respond-to-mcp-elicitation-requests)。需要附加終端機的命令，例如 `/install-github-app` 或 `/mcp` 設定清單，[也會讓無人值守的工作階段停留在此處](#attach-to-a-session) |
145| Idle | 變暗 | 工作階段沒有任何工作要做，已準備好接收您的下一個提示 |145| Idle | 變暗 | 工作階段沒有任何工作要做，已準備好接收您的下一個提示詞 |
146| Completed | 綠色 | 任務成功完成 |146| Completed | 綠色 | 任務成功完成 |
147| Failed | 紅色 | 任務以錯誤結束 |147| Failed | 紅色 | 任務以錯誤結束 |
148| Stopped | 灰色 | 您使用 `Ctrl+X` 或 `claude stop` 停止了工作階段，[其程序從 Claude Code 外部結束](#the-supervisor-process)，或 [在背景服務關閉時結束](#sessions-show-as-failed-after-shutdown) |148| Stopped | 灰色 | 您使用 `Ctrl+X` 或 `claude stop` 停止了工作階段、[其程序從 Claude Code 外部被結束](#the-supervisor-process)，或 [它在背景服務關閉時結束](#sessions-show-as-failed-after-shutdown) |
149 149
150另外，圖示的形狀顯示基礎程序是否正在執行：150另外，圖示的形狀有其自身的意義：
151 151
152| 形狀 | 意義 |152| 形狀 | 意義 |
153| :- | :- |153| :- | :- |
154| `✻` 或動畫 `✽` | 工作階段程序處於活動狀態並立即回應 |154| `✻` 或動畫 `✽` | 工作階段程序正在執行，或工作階段需要您的輸入 |
155| `∙` | 程序已結束。您仍然可以查看該列，當您回應或附加時，Claude 會從中斷的地方重新啟動 |155| `∙` | 程序已結束。您仍然可以查看該列，當您回覆或附加時，Claude 會從中斷的地方重新啟動 |
156| `✢` | [`/loop`](/docs/zh-TW/scheduled-tasks) 工作階段在迭代之間休眠。該列顯示其執行計數和倒數計時 |156| `✢` | 在迭代之間休眠的 [`/loop`](/docs/zh-TW/scheduled-tasks) 工作階段。該列顯示其執行次數和倒數計時 |
157 157
158可能出現在列右邊緣的 `#N` 或 `!N` 標籤是指向工作階段的 [拉取請求或合併請求](#pull-request-status) 的連結，不是狀態圖示的一部分。158可能出現在列右邊緣的 `#N` 或 `!N` 標籤是指向工作階段的 [pull request 或 merge request](#pull-request-status) 的連結，不是狀態圖示的一部分。
159 159
160終端機標籤標題在代理檢視開啟時顯示等待輸入計數：當工作階段需要輸入時為 `2 awaiting input · claude agents`，或當沒有時為 `claude agents`。160agent 檢視開啟時，終端機分頁標題會顯示等待輸入的數量：當有工作階段需要輸入時為 `2 awaiting input · claude agents`，沒有時則為 `claude agents`。
161 161
162若要從指令碼或其他程式讀取工作階段狀態，請使用 [`claude agents --json`](#read-session-state-from-a-script)，而不是 `~/.claude/jobs/` 下的檔案。162若要從指令碼或其他程式讀取工作階段狀態，請使用 [`claude agents --json`](#read-session-state-from-a-script)，而不是 `~/.claude/jobs/` 下的檔案。
163 163
164當代理檢視開啟時，Claude Code 也會透過您設定的 [終端機通知頻道](/docs/zh-TW/terminal-config#get-a-terminal-bell-or-notification) 發送通知，當本機背景工作階段開始需要您的輸入、完成或失敗時。在排程上執行的工作階段，例如 [`/loop`](/docs/zh-TW/scheduled-tasks) 工作階段，只在需要您的輸入時通知。通知使用與 Claude Code 其餘部分相同的 [`preferredNotifChannel` 設定](/docs/zh-TW/settings-reference#preferrednotifchannel)，並使用 `agent_needs_input` 或 `agent_completed` 類型觸發 [`Notification` hook](/docs/zh-TW/hooks#notification)。164當 agent 檢視開啟時，若本機背景工作階段開始需要您的輸入、完成或失敗，Claude Code 也會透過您設定的 [終端機通知頻道](/docs/zh-TW/terminal-config#get-a-terminal-bell-or-notification) 發送通知。依排程執行的工作階段，例如 [`/loop`](/docs/zh-TW/scheduled-tasks) 工作階段，只在需要您的輸入時通知。通知使用與 Claude Code 其餘部分相同的 [`preferredNotifChannel` 設定](/docs/zh-TW/settings-reference#preferrednotifchannel)，並以 `agent_needs_input` 或 `agent_completed` 類型觸發 [`Notification` hook](/docs/zh-TW/hooks#notification)。
165 165
166背景工作階段不需要任何開啟的終端機即可繼續工作。單獨的 [監督程序](#the-supervisor-process) 執行它們，因此您可以關閉代理檢視、關閉您的 shell，或啟動新的互動式工作階段，您分派的工作會繼續進行。166背景工作階段不需要開啟任何終端機即可繼續工作。一個獨立的 [監督程序](#the-supervisor-process) 會執行它們，因此您可以關閉 agent 檢視、關閉您的 shell，或啟動新的互動式工作階段，您分派的工作會繼續進行。
167 167
168工作階段狀態透過自動更新和監督程序重新啟動在磁碟上持續存在。當您的機器休眠時，工作階段也會被保留。它們的程序在喚醒時繼續執行，監督程序會重新連接到它們，而不是將時間間隙視為閒置。關閉仍會停止執行中的工作階段；請參閱 [工作階段在關閉後顯示為失敗或停止](#sessions-show-as-failed-after-shutdown) 以了解如何復原它們。168工作階段狀態會保存在磁碟上，不受自動更新和監督程序重新啟動影響。當您的機器休眠時，工作階段也會被保留。它們的程序在喚醒時繼續執行，監督程序會重新連接到它們，而不會將時間間隔視為閒置。關機仍會停止執行中的工作階段；請參閱 [工作階段在關機後顯示為失敗或停止](#sessions-show-as-failed-after-shutdown) 以了解如何復原它們。
169 169
170在機器休眠時正在中途回應的工作階段可能會回來無回應。當您開啟已停止回應的工作階段時，監督程序會重新啟動其程序，工作階段會從中斷的地方繼續中斷的回應。170在機器休眠時正處於回應中途的工作階段，恢復後可能沒有回應。當您開啟已停止回應的工作階段時，監督程序會重新啟動其程序，工作階段會從中斷的地方繼續被中斷的回應。
171 171
172<h3 id="row-summaries">172<h3 id="row-summaries">
173 列摘要173 列摘要
174</h3>174</h3>
175 175
176每列中的單行摘要由 [Haiku 級模型](/docs/zh-TW/model-config) 產生，因此該列可以告訴您工作階段在做什麼、需要什麼或產生了什麼，而無需開啟文字記錄。當工作階段主動工作時，列文字最多每 15 秒從工作階段自己的最近輸出更新一次，無需發送模型請求，模型在每個回合結束時寫入新摘要。176每列中的單行摘要由 [Haiku 級模型](/docs/zh-TW/model-config) 產生，讓該列無需開啟逐字稿即可告訴您工作階段在做什麼、需要什麼或產生了什麼。當工作階段正在主動工作時，列文字最多每 15 秒根據工作階段自身的最近輸出更新一次，不會發送模型請求，並且模型會在每個回合結束時撰寫新的摘要。
177 177
178工作中的列顯示工作階段說它在做什麼，被阻止的列顯示它在問什麼問題。在長回合期間，模型也會每隔幾分鐘重寫摘要，以便繁忙的列不會繼續顯示過時的摘要。摘要文字填滿列的剩餘寬度；開啟 [查看面板](#peek-and-reply) 以讀取終端機邊緣裁剪的句子。178工作中的列會顯示工作階段自述正在做的事，被阻擋的列則顯示它正在提出的問題。在較長的回合期間，模型也會每隔幾分鐘重寫摘要，讓忙碌的列不會持續顯示過時的摘要。摘要文字會填滿列的剩餘寬度；開啟 [查看面板](#peek-and-reply) 即可閱讀被終端機邊緣截斷的句子。
179 179
180當清單 [按目錄分組](#organize-the-list) 時，摘要以工作階段的狀態開頭，作為彩色單詞，例如 `Needs input · double jump or wall climb?`。在預設狀態分組中，群組標題已命名狀態，因此列只顯示摘要。180當清單 [按目錄分組](#organize-the-list) 時，摘要會以彩色文字顯示的工作階段狀態開頭，例如 `Needs input · double jump or wall climb?`。在預設的狀態分組中，群組標題已標示狀態，因此列只會顯示摘要。
181 181
182回合結束摘要和每個中途重寫都是透過您的正常提供者進行的一個簡短 Haiku 級請求，按照與工作階段本身相同的 [資料使用條款](/docs/zh-TW/data-usage) 計費和處理。模型重寫之間的 15 秒更新重複使用工作階段自己的輸出，不發送請求。在沒有設定 Haiku 級模型的第三方提供者或閘道上，請求使用工作階段的主要模型；設定 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/zh-TW/model-config#environment-variables) 以選擇一個。182回合結束摘要和每次回合中途的重寫，都是透過您的一般提供者發送的一個簡短 Haiku 級請求，並依照與工作階段本身相同的 [資料使用條款](/docs/zh-TW/data-usage) 計費和處理。模型重寫之間的 15 秒更新會重複使用工作階段自身的輸出，不會發送請求。在未設定 Haiku 級模型的第三方提供者或閘道上，請求會改用工作階段的主要模型；設定 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/zh-TW/model-config#environment-variables) 即可選擇一個模型。
183 183
184<h3 id="pull-request-status">184<h3 id="pull-request-status">
185 拉取請求狀態185 Pull request 狀態
186</h3>186</h3>
187 187
188當工作階段 [開啟拉取請求](#how-file-edits-are-isolated) 時，Claude Code 在列的右邊緣新增標籤，連結到拉取請求：188當工作階段 [開啟 pull request](#how-file-edits-are-isolated) 時，Claude Code 會在列的右邊緣新增連結到該 pull request 的標籤：
189 189
190* Claude Code 將標籤寫為拉取請求的 `#1234` 和 GitLab 合併請求的 `!1234`。190* Claude Code 將 pull request 的標籤寫為 `#1234`，將 GitLab merge request 的標籤寫為 `!1234`。
191* Claude Code 發出連結，即使它無法偵測超連結支援，例如透過 SSH 或 tmux。設定 [`FORCE_HYPERLINK=0`](/docs/zh-TW/env-vars) 以將標籤呈現為純文字。191* 即使 Claude Code 無法偵測到超連結支援（例如透過 SSH 或 tmux），它仍會輸出連結。設定 [`FORCE_HYPERLINK=0`](/docs/zh-TW/env-vars) 即可將標籤呈現為純文字。
192* 在您向工作階段發送後續內容後，Claude Code 會在列返回即時進度時保留標籤。192* 在您向工作階段發送後續訊息後，列會回到顯示即時進度，而 Claude Code 會保留該標籤。
193 193
194在現有拉取請求上工作的工作階段以相同方式連結到它。Claude Code 根據 Claude 執行的命令以不同方式尋找拉取請求：194處理現有 pull request 的工作階段也會以相同方式連結到它。Claude Code 依 Claude 執行的命令以不同方式尋找 pull request：
195 195
196* 當 Claude 使用 `gh` 編輯、評論、關閉或標記拉取請求為就緒時，Claude Code 連結命令自己的輸出命名的拉取請求。其捕獲的輸出未命名拉取請求的 `gh` 命令不會建立連結；`gh pr merge` 是常見情況，因為它只將其結果列印到互動式終端機。196* 當 Claude 使用 `gh` 編輯、留言、關閉或將 pull request 標記為就緒時，Claude Code 會連結該命令自身輸出中指明的 pull request。若 `gh` 命令擷取到的輸出未指明任何 pull request，則不會建立連結；`gh pr merge` 是常見情況，因為它只會將結果列印到互動式終端機。
197* 當 Claude 使用 `gh pr checkout` 簽出拉取請求或推送到分支時，Claude Code 使用 `gh pr view` 查詢分支並連結其開啟的拉取請求。197* 當 Claude 使用 `gh pr checkout` 簽出 pull request 或推送到分支時，Claude Code 會使用 `gh pr view` 查詢該分支，並連結其開啟中的 pull request。
198* 當 Claude 推送時拉取請求不需要存在：Claude Code 在同一目錄中執行最多五個稍後的 `git`、`gh`、`glab` 或 `curl` 命令後重試分支查詢，因此在推送後建立的拉取請求，包括 Claude 透過 GitHub REST API 建立的拉取請求，在重試找到時連結。198* Claude 推送時，pull request 不需要已經存在：Claude Code 會在同一目錄中之後執行的最多五個 `git`、`gh`、`glab` 或 `curl` 命令後重試分支查詢，因此在推送後建立的 pull request，包括 Claude 透過 GitHub REST API 建立的 pull request，會在重試找到它時建立連結。
199 199
200當工作階段連結到多個拉取請求時，標籤顯示計數，例如 `3 PRs`，按最需要關注的開啟拉取請求著色。開啟 [查看面板](#peek-and-reply) 以查看它們全部。200當工作階段連結到多個 pull request 時，標籤會改為顯示數量，例如 `3 PRs`，並依最需要關注的開啟中 pull request 著色。開啟 [查看面板](#peek-and-reply) 即可查看全部。
201 201
202拉取請求編號按其狀態著色：202Pull request 編號會依其狀態著色：
203 203
204| 顏色 | 拉取請求狀態 |204| 顏色 | Pull request 狀態 |
205| :- | :- |205| :- | :- |
206| 黃色 | 等待檢查或審查，或檢查失敗 |206| 黃色 | 等待檢查或審查，或檢查失敗 |
207| 綠色 | 檢查通過且沒有審查阻止 |207| 綠色 | 檢查通過且沒有審查阻擋 |
208| 紫色 | 已合併 |208| 紫色 | 已合併 |
209| 灰色 | 草稿或已關閉 |209| 灰色 | 草稿或已關閉 |
210 210
211對於以拉取請求結束的任務，檢查此標籤以獲得結果：當其編號變為綠色時審查並合併拉取請求。211對於以 pull request 作為結果的任務，請查看此標籤取得結果：當編號變成綠色時，審查並合併該 pull request。
212 212
213<h3 id="peek-and-reply">213<h3 id="peek-and-reply">
214 查看和回應214 查看和回覆
215</h3>215</h3>
216 216
217在選定的列上按 `Space` 以開啟查看面板。它開啟時顯示列在終端機邊緣截斷的句子，該句子是哪一個取決於工作階段的狀態：217在選定的列上按 `Space` 以開啟查看面板。面板開啟時會顯示該列在終端機邊緣被截斷的句子，而顯示哪個句子取決於工作階段的狀態：
218 218
219* 等待您的工作階段：它要求的確切問題，在回應輸入上方219* 等待您的工作階段：它提出的確切問題，位於回覆輸入上方
220* 已完成的工作階段：其結果220* 已完成的工作階段：其結果
221* 工作中的工作階段：其完整狀態句子221* 工作中的工作階段：其完整狀態句子
222 222
223任何連結到工作階段的拉取請求都會列在下方。對於等待您的工作階段，下方的一行（例如 `waiting 3m`）顯示它已等待多長時間，這是面板中唯一顯示的時間。列右邊緣的年齡是不同的數字：它從工作階段啟動時開始計算。223接著會列出連結到該工作階段的所有 pull request。對於等待您的工作階段，其下方會有一行（例如 `waiting 3m`）顯示它已等待多久，這也是面板中唯一顯示的時間。列右邊緣的經過時間是另一個數字：它從工作階段啟動時開始計算。
224 224
225大多數時候查看面板就足夠了，您不需要開啟完整文字記錄。225大多數時候查看面板就足夠了，您不需要開啟完整逐字稿。
226 226
227在查看面板中輸入回覆，然後按 `Enter` 將其發送到該工作階段。在回覆前加上 `!` 則改為發送 Bash 命令。回覆的處理方式取決於工作階段以及您發送的內容：227在查看面板中輸入回覆，然後按 `Enter` 將其發送到該工作階段。在回覆前加上 `!` 則改為發送 Bash 命令。回覆的處理方式取決於工作階段以及您發送的內容：
228 228
236* 沒有預定義選項的問題：輸入您的答案。當空白輸入顯示建議的回覆時，按 `Tab` 將其填入，並在發送前編輯236* 沒有預定義選項的問題：輸入您的答案。當空白輸入顯示建議的回覆時，按 `Tab` 將其填入，並在發送前編輯
237* 權限提示或其他對話框，例如 [沙箱](/docs/zh-TW/sandboxing) 提示或 MCP 伺服器的 [輸入請求](/docs/zh-TW/mcp#respond-to-mcp-elicitation-requests)：回覆無法回答它。您的回覆會在佇列中等待。若要回答對話框，請使用 `→` 附加237* 權限提示或其他對話框，例如 [沙箱](/docs/zh-TW/sandboxing) 提示或 MCP 伺服器的 [輸入請求](/docs/zh-TW/mcp#respond-to-mcp-elicitation-requests)：回覆無法回答它。您的回覆會在佇列中等待。若要回答對話框，請使用 `→` 附加
238 238
239當 [`PermissionRequest`](/docs/zh-TW/hooks#permissionrequest) 或 [`PreToolUse`](/docs/zh-TW/hooks#pretooluse) hook 返回 Claude Code 無法驗證工作階段要求的呼叫的輸出時，列顯示 hook 事件和 `hook output invalid:` 以及驗證錯誤，然後是待處理請求的文字。對於以其他方式失敗的 hook，列說 hook 失敗。工作階段仍然等待相同的請求。239當 [`PermissionRequest`](/docs/zh-TW/hooks#permissionrequest) 或 [`PreToolUse`](/docs/zh-TW/hooks#pretooluse) hook 針對工作階段所詢問的呼叫傳回 Claude Code 無法驗證的輸出時，列會在待處理請求的文字之前顯示 hook 事件，以及 `hook output invalid:` 和驗證錯誤。對於以其他方式失敗的 hook，列會顯示該 hook 失敗。工作階段仍會等待同一個請求。
240 240
241無法傳遞的回應，因為背景服務無法到達或發送失敗，會被保存並在其程序再次啟動時作為下一個提示發送到工作階段，錯誤訊息說回應已保存。以 `!` 為前綴的回應不會被保存，因為保存的文字會作為純提示而不是 Bash 命令到達工作階段。241因背景服務無法連線或發送失敗而無法傳遞的回覆會被儲存，並在工作階段的程序再次啟動時作為其下一個提示詞發送，錯誤訊息也會說明回覆已儲存。以 `!` 為前綴的回覆不會被儲存，因為儲存的文字會以純提示詞的形式送達工作階段，而不會作為 Bash 命令執行。
242 242
243啟用 [語音聽寫](/docs/zh-TW/voice-dictation) 後，在回應輸入聚焦時按住或點擊您的推送通話鍵以聽寫回應而不是輸入。相同的方式適用於代理檢視底部的分派輸入。243在 [按住模式](/docs/zh-TW/voice-dictation#hold-to-record) 下啟用 [語音聽寫](/docs/zh-TW/voice-dictation) 後，在回覆輸入聚焦時按住您的按鍵通話鍵，即可以聽寫代替輸入回覆。相同的方式也適用於 agent 檢視底部的分派輸入。
244 244
245使用 `↑` 和 `↓` 查看相鄰工作階段而無需關閉面板，或使用 `→` 附加。245使用 `↑` 和 `↓` 查看相鄰的工作階段而無需關閉面板，或使用 `→` 附加。
246 246
247<h3 id="attach-to-a-session">247<h3 id="attach-to-a-session">
248 附加到工作階段248 附加到工作階段
249</h3>249</h3>
250 250
251在選定的列上按 `Enter` 或 `→` 以附加。代理檢視被完整互動式工作階段取代。當您附加時，Claude 發佈您離開時發生的簡短回顧。251在選定的列上按 `Enter` 或 `→` 以附加。agent 檢視會被完整的互動式工作階段取代。當您附加時，Claude 會發布一則簡短回顧，說明您離開期間發生的事。
252 252
253附加時，工作階段的行為就像任何其他 Claude Code 工作階段：[命令](/docs/zh-TW/commands)、鍵盤快捷鍵和功能都可以工作，除了下面的例外。253附加時，工作階段的行為與任何其他 Claude Code 工作階段相同：[命令](/docs/zh-TW/commands)、鍵盤快捷鍵和功能都可正常運作，但以下情況除外。
254 254
255附加時，`/install-github-app` 和 [`/mcp`](/docs/zh-TW/mcp) 設定清單正常工作，因為終端機上有人可以完成它們的對話。當沒有人附加時，這些命令無法開啟它們的對話，因此工作階段在代理檢視中的 `Needs input` 下出現，列如 `open this session to manage MCP servers`，文字記錄回應說相同的內容。附加並再次執行命令以繼續；當您附加時，需要輸入的列會清除。`/mcp reconnect <server>`、`/mcp enable` 和 `/mcp disable` 無論如何都可以在不附加的情況下工作。255附加時，`/install-github-app` 和 [`/mcp`](/docs/zh-TW/mcp) 設定清單可正常運作，因為終端機前有人可以完成它們的對話框。當沒有人附加時，這些命令無法開啟對話框，因此工作階段會出現在 agent 檢視的 `Needs input` 下，列上顯示如 `open this session to manage MCP servers` 的內容，逐字稿中的回應也會說明相同的事。附加並再次執行該命令即可繼續；當您附加時，需要輸入的列會被清除。`/mcp reconnect <server>`、`/mcp enable` 和 `/mcp disable` 無論如何都可以在不附加的情況下運作。
256 256
257附加的工作階段始終以 [全螢幕模式](/docs/zh-TW/fullscreen) 呈現，無論您的 `tui` 設定如何，因為背景工作階段沒有終端機捲軸可附加到。使用 `PgUp`、`PgDn` 或滑鼠滾輪捲動，按 `Ctrl+O` 進入文字記錄模式。您終端機的原生捲動和 tmux 複製模式只顯示目前檢視區，與執行任何全螢幕應用程式時相同。257無論您的 `tui` 設定為何，附加的工作階段一律以 [全螢幕模式](/docs/zh-TW/fullscreen) 呈現，因為背景工作階段沒有可附加內容的終端機捲動緩衝區。使用 `PgUp`、`PgDn` 或滑鼠滾輪捲動，並按 `Ctrl+O` 進入逐字稿模式。您終端機的原生捲動和 tmux 複製模式只會顯示目前的檢視區，與執行任何全螢幕應用程式時相同。
258 258
259在空提示上按 `←`，或執行 `/exit`，以分離並返回代理檢視，無論您是從代理檢視開啟工作階段還是從 shell 使用 `claude attach <id>`。259在空白提示詞輸入上按 `←`，或執行 `/exit`，即可分離並返回 agent 檢視，無論您是從 agent 檢視開啟工作階段，還是從 shell 使用 `claude attach <id>` 開啟。
260 260
261當 [`/btw` 覆蓋層](/docs/zh-TW/interactive-mode#side-questions-with-%2Fbtw) 開啟時，`←` 也會分離。需要 Claude Code v2.1.257 或更新版本。仍在回答的側問題在您離開時繼續執行。下次您附加時，覆蓋層會重新開啟它，或使用其答案。261當 [`/btw` 覆蓋層](/docs/zh-TW/interactive-mode#side-questions-with-%2Fbtw) 開啟時，`←` 也會分離。需要 Claude Code v2.1.257 或更新版本。仍在回答中的旁支問題會在您離開期間繼續執行。下次您附加時，覆蓋層會重新開啟並顯示該問題或其答案。
262 262
263在 Windows 上，如果您在附加後約半秒內按 `←`，Claude Code 會顯示 `Ambiguous ←, press again to detach`，因為在該視窗中終端機可以重新傳遞您附加前的按下。再次按 `←` 以分離。263在 Windows 上，如果您在附加後約半秒內按 `←`，Claude Code 會顯示 `Ambiguous ←, press again to detach`，因為在這段時間內，終端機可能會重新傳遞您附加前的按鍵。再按一次 `←` 即可分離。
264 264
265`Ctrl+Z` 也會分離但會回到您開始的地方：如果您從那裡附加則為代理檢視，或如果您執行 `claude attach` 則為您的 shell。當對話有焦點且不回應 `←` 時使用 `Ctrl+Z`。265`Ctrl+Z` 也會分離，但會回到您開始的地方：若您是從 agent 檢視附加，則回到 agent 檢視；若您執行的是 `claude attach`，則回到您的 shell。當對話框取得焦點且不回應 `←` 時，請使用 `Ctrl+Z`。
266 266
267`Ctrl+C` 在附加時保持其標準中斷行為：它取消執行中的回應或 `!` shell 命令，而不是分離。在空提示上按 `Ctrl+C` 兩次會分離，與任何工作階段中相同。267附加時，`Ctrl+C` 保留其標準的中斷行為：它會取消執行中的回應或 `!` shell 命令，而不是分離。在空白提示詞輸入上按兩次 `Ctrl+C` 會分離，與任何工作階段中相同。
268 268
269分離永遠不會停止背景工作階段：`←`、`Ctrl+Z`、`/exit` 和雙 `Ctrl+C` 或雙 `Ctrl+D` 都會讓它執行。若要從內部結束工作階段，請執行 `/stop`。269分離永遠不會停止背景工作階段：`←`、`Ctrl+Z`、`/exit`，以及按兩次 `Ctrl+C` 或兩次 `Ctrl+D`，都會讓它繼續執行。若要從工作階段內部結束它，請執行 `/stop`。
270 270
271<h4 id="switch-sessions-without-leaving-the-terminal">271<h4 id="switch-sessions-without-leaving-the-terminal">
272 在不離開終端機的情況下切換工作階段272 在不離開終端機的情況下切換工作階段
273</h4>273</h4>
274 274
275在前景執行的工作階段中，您在終端機中啟動的工作階段而不是從代理檢視附加的工作階段，在空提示上按 `←` 會背景執行它並開啟代理檢視，該列已選定，因此您可以在不離開終端機的情況下切換工作階段。相同的單次按下會分離附加的工作階段。275在前景執行的工作階段（即您在終端機中啟動、而非從 agent 檢視附加的工作階段）中，在空白提示詞輸入上按 `←` 會將其移至背景，並開啟已選定該列的 agent 檢視，讓您無需離開終端機即可切換工作階段。同樣按一次也會分離已附加的工作階段。
276 276
277如果您在刪除提示的最後文字或移動提示歷史記錄後立即按 `←`，Claude Code 會要求您確認：第一次按下顯示 `Press ← again to open agents`，或在附加的工作階段中顯示 `Press ← again to go back to agents`，第二次按下切換。277如果您在刪除提示詞輸入的最後一段文字或瀏覽提示詞歷史記錄後立即按 `←`，Claude Code 會要求您確認：第一次按下會顯示 `Press ← again to open agents`，在已附加的工作階段中則顯示 `Press ← again to go back to agents`，第二次按下才會切換。
278 278
279當 `←` 背景執行前景工作階段時，代理檢視在清單上方顯示 `Your conversation moved to the background`，該工作階段的列已選定。從那裡：279當 `←` 將前景工作階段移至背景時，agent 檢視會在清單上方顯示 `Your conversation moved to the background`，並已選定該工作階段的列。接著：
280 280
281* 按 `Enter` 重新開啟對話。281* 按 `Enter` 重新開啟對話。
282* 按 `Esc` 撤銷切換並返回對話。如果 `Esc` 顯示 `Still starting — try again in a moment`，背景工作階段還沒準備好，所以稍後再按一次 `Esc`。282* 按 `Esc` 復原切換並返回對話。如果 `Esc` 顯示 `Still starting — try again in a moment`，表示背景工作階段尚未就緒，請稍後再按一次 `Esc`。
283* 按 `Ctrl+C` 兩次以退出到您的 shell。283* 按兩次 `Ctrl+C` 以退出到您的 shell。
284 284
285當 Claude Code 無法重新開啟對話時，它會退出並列印一個 `claude --resume` 命令來繼續它。285當 Claude Code 無法重新開啟對話時，它會結束並列印一個可恢復該對話的 `claude --resume` 命令。
286 286
287[Claude 的任務清單](/docs/zh-TW/interactive-mode#task-list) 隨著對話移動到背景工作階段，因此當您返回該列時檢查清單是完整的。287[Claude 的任務清單](/docs/zh-TW/interactive-mode#task-list) 會隨對話移至背景工作階段，因此當您返回該列時，檢查清單會保持完整。
288 288
289您按 `←` 的列在使用箭頭鍵或滑鼠移動選擇後也保持粗體、未變暗的名稱，因此您可以判斷您來自哪個工作階段。289您按下 `←` 的來源列，在您使用方向鍵或滑鼠移動選擇後，名稱仍會保持粗體且不變暗，讓您能分辨自己來自哪個工作階段。
290 290
291如果在您按 `←` 時工具正在執行，Claude Code 會等待最多約十秒鐘讓它完成，然後背景執行，Claude 在背景工作階段中繼續回應。再次按 `←` 以立即背景執行而不是等待。當進行中的工作無法轉移到背景工作階段時，Claude Code 首先顯示 `Background this session?` 對話，與 [`/background`](#from-inside-a-session) 相同。291如果您按 `←` 時有工具正在執行，Claude Code 會最多等待約十秒鐘讓它完成再移至背景，而 Claude 會在背景工作階段中繼續回應。再按一次 `←` 即可立即移至背景而不等待。當進行中的工作無法轉移到背景工作階段時，Claude Code 會先顯示 `Background this session?` 對話框，與 [`/background`](#from-inside-a-session) 相同。
292 292
293十秒限制在 [前景子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) Claude 在對話中啟動的仍在執行時不適用。Claude Code 繼續等待以便它們的工作轉移，並在等待時顯示 `Still backgrounding after the current tool` 通知。再次按 `←` 以在不等待的情況下背景執行，這會從頭開始重新啟動這些子代理。Claude Code 不會等待 [動態工作流程](/docs/zh-TW/workflows) 正在執行的子代理。當工作流程有子代理執行時，Claude Code 改為顯示 `Background this session?` 對話。293當 Claude 在對話中啟動的 [前景 subagent](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) 仍在執行時，十秒限制不適用。Claude Code 會持續等待，讓它們的工作得以轉移，並在等待期間顯示 `Still backgrounding after the current tool` 通知。再按一次 `←` 即可不等待直接移至背景，這會讓這些 subagent 從頭重新開始。Claude Code 不會等待 [動態工作流程](/docs/zh-TW/workflows) 正在執行的 subagent。當工作流程有 subagent 正在執行時，Claude Code 會改為顯示 `Background this session?` 對話框。
294 294
295Claude Code 在您的提示輸入中有未發送的文字時不會背景執行工作階段，因為文字會保留在您終端機的輸入框中，不會移動到背景工作階段。如果在 Claude Code 等待背景執行工作階段時輸入到輸入中，它會以 `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` 取消切換。295當您的提示詞輸入中有未發送的文字時，Claude Code 不會將工作階段移至背景，因為該文字會留在您終端機的輸入框中，不會移至背景工作階段。如果您在 Claude Code 等待將工作階段移至背景時於輸入框中輸入文字，它會以 `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` 取消切換。
296 296
297按 `←` 會建立工作階段的列，即使對話還沒有訊息，所以 `→` 仍然會返回到它。297即使對話尚無任何訊息，按 `←` 也會建立該工作階段的列，因此 `→` 仍可返回該工作階段。
298 298
299您可以使用 `/config` 中的 [`leftArrowOpensAgents`](/docs/zh-TW/settings-reference#leftarrowopensagents) 設定關閉此快捷鍵。299您可以使用 `/config` 中的 [`leftArrowOpensAgents`](/docs/zh-TW/settings-reference#leftarrowopensagents) 設定，為前景工作階段關閉此快捷鍵。
300 300
301<h3 id="organize-the-list">301<h3 id="organize-the-list">
302 組織清單302 組織清單
303</h3>303</h3>
304 304
305代理檢視分組工作階段，使需要輸入的工作階段位於頂部，`Ready for review` 和 `Needs input` 在 `Working` 和 `Completed` 上方。這些群組名稱不與上面的 [狀態](#read-session-state) 一一對應：當工作階段有開啟的拉取請求時，它會移動到 `Ready for review`，`Completed` 收集已完成、失敗和停止的工作階段。305agent 檢視會將工作階段分組，讓需要輸入的工作階段位於頂部，`Ready for review` 和 `Needs input` 位於 `Working` 和 `Completed` 上方。這些群組名稱並非與上述 [狀態](#read-session-state) 一一對應：當工作階段有需要審查或檢查失敗的開啟中 pull request 時，它會移至 `Ready for review`，而 `Completed` 會將已完成、失敗和已停止的工作階段集中在一起。
306 306
307按 `Ctrl+S` 改為按目錄分組。您的選擇在執行中持續存在。307按 `Ctrl+S` 改為按目錄分組。您的選擇會在多次執行間保留。
308 308
309在群組內：309在群組內：
310 310
311* 按 `Ctrl+T` 將工作階段釘選到頂部並 [在閒置時保持其程序執行](#the-supervisor-process)311* 按 `Ctrl+T` 將工作階段釘選到頂部，並 [在閒置時保持其程序執行](#the-supervisor-process)
312* 按 `Shift+↑` 或 `Shift+↓` 重新排序工作階段312* 按 `Shift+↑` 或 `Shift+↓` 重新排序工作階段
313* 按 `Ctrl+R` 重新命名工作階段313* 按 `Ctrl+R` 重新命名工作階段
314* 在群組標題上按 `Enter` 以摺疊群組，但 [篩選](#filter-sessions) 啟用時除外，此時所有群組都會保持展開314* 在群組標題上按 `Enter` 以摺疊群組，但 [篩選](#filter-sessions) 啟用時除外，此時所有群組都會保持展開
315 315
316若要從清單中移除工作階段，按 `Ctrl+X` 停止它，然後在兩秒內再次按 `Ctrl+X` 以刪除它。在群組標題上按 `Ctrl+X` 會在確認後刪除該群組中的每個工作階段。316若要從清單中移除工作階段，按 `Ctrl+X` 停止它，然後在兩秒內再次按 `Ctrl+X` 以刪除它。在群組標題上按 `Ctrl+X` 會在確認後刪除該群組中的每個工作階段。
317 317
318第二次按下會刪除工作階段，即使停止嘗試失敗，例如因為 [背景服務沒有回應](#agent-view-says-the-background-service-did-not-respond)：確認會再保持活動兩秒，刪除會結束工作階段的程序本身。按 `Esc` 以在不刪除的情況下關閉確認。318即使停止嘗試失敗（例如因為 [背景服務沒有回應](#agent-view-says-the-background-service-did-not-respond)），第二次按下仍會刪除工作階段：確認狀態會再維持兩秒，而刪除動作會自行結束工作階段的程序。按 `Esc` 即可關閉確認而不刪除。
319 319
320除了 [刪除工作階段會移除什麼](#what-deleting-a-session-removes) 中涵蓋的保留情況外，刪除會從清單中移除工作階段，Claude 為其建立的 worktree 會被移除、保留或保留在原位，取決於您如何刪除以及 worktree 保留的內容。對話文字記錄始終保留在您的本機上，可透過 `claude --resume` 取得。320除了 [刪除工作階段會移除什麼](#what-deleting-a-session-removes) 中說明的保留情況外，刪除會將工作階段從清單中移除，而 Claude 為其建立的 worktree 會被移除、保留或留在原位，取決於您的刪除方式以及 worktree 中的內容。對話逐字稿一律保留在您的本機上，可透過 `claude --resume` 取得。
321 321
322若要在 Claude Code v2.1.212 或更新版本上復原工作階段，請在分派輸入中輸入 `/resume`。選擇器開啟，顯示您開啟代理檢視的儲存庫的過去工作階段，最新的優先，包括您從清單中刪除的工作階段；已有列的工作階段不會列出。`↑`/`↓` 移動選擇，`Enter` 將選定的工作階段復原為背景工作階段，使其作為列重新加入清單，`Esc` 關閉選擇器。322若要在 Claude Code v2.1.212 或更新版本上找回工作階段，請在分派輸入中輸入 `/resume`。選擇器會開啟，依最新優先的順序列出您開啟 agent 檢視時所在儲存庫的過去工作階段，包括您已從清單中刪除的工作階段；已有列的工作階段不會列出。`↑`/`↓` 移動選擇，`Enter` 會將選定的工作階段恢復為背景工作階段，使其以列的形式重新加入清單，`Esc` 則關閉選擇器。
323 323
324選擇器只在裸 `/resume` 時開啟。有目標、範圍或受限的復原無法由選擇器提供，因此當以下情況時代理檢視顯示 `attach to a session to run it` 提示：324選擇器只會在單純輸入 `/resume` 時開啟。指定目標、限定範圍或受限制的恢復無法由選擇器處理，因此在以下情況下，agent 檢視會改為顯示 `attach to a session to run it` 提示：
325 325
326* `/resume` 命名 id 或搜尋詞326* `/resume` 指定了 id 或搜尋詞
327* 檢視以 `--cwd` 為範圍327* 檢視以 `--cwd` 限定範圍
328* 檢視以 [`--safe-mode`](/docs/zh-TW/cli-reference#cli-flags) 啟動328* 檢視以 [`--safe-mode`](/docs/zh-TW/cli-reference#cli-flags) 啟動
329* 檢視以 `--permission-mode` 或 `--settings` 等旗標開啟329* 檢視以 `--permission-mode` 或 `--settings` 等旗標開啟
330 330
331不適合螢幕的已完成工作階段會摺疊成 `… N more` 列。失敗和有開啟拉取請求的工作階段始終保持可見。`Completed` 群組填滿即時群組後剩下的垂直空間，在短終端機上標題會壓縮為單一摘要行，以便工作中或需要輸入的工作階段保持可見。331螢幕上放不下的已完成工作階段會摺疊成 `… N more` 列。`Completed` 群組會填滿即時群組之後剩餘的垂直空間，而在較矮的終端機上，標題會壓縮成單一摘要行，讓工作中或需要輸入的工作階段保持可見。
332 332
333<h3 id="filter-sessions">333<h3 id="filter-sessions">
334 篩選工作階段334 篩選工作階段
338 338
339| 篩選 | 顯示 |339| 篩選 | 顯示 |
340| :- | :- |340| :- | :- |
341| `a:<name>` | 執行命名代理的工作階段 |341| `a:<name>` | 執行指定 agent 的工作階段 |
342| `s:<state>` | 處於指定狀態的工作階段，例如 `s:working`，或位於指定群組標題下的工作階段，例如代表 `Ready for review` 的 `s:ready`。`s:blocked` 會列出所有正在等待您的項目 |342| `s:<state>` | 處於指定狀態的工作階段，例如 `s:working`，或位於指定群組標題下的工作階段，例如代表 `Ready for review` 的 `s:ready`。`s:blocked` 會列出所有正在等待您的項目 |
343| `n:<text>` | 名稱或第一個提示詞包含該文字的工作階段，例如 `n:login`。需要 Claude Code v2.1.287 或更新版本 |343| `n:<text>` | 名稱或第一個提示詞包含該文字的工作階段，例如 `n:login`。需要 Claude Code v2.1.287 或更新版本 |
344| `o:<text>` | 結果包含該文字的工作階段，例如 `o:merged`。單獨的 `o:` 會列出所有已回報結果的工作階段 |344| `o:<text>` | 結果包含該文字的工作階段，例如 `o:merged`。單獨的 `o:` 會列出所有已回報結果的工作階段 |
345| Pull request 或 merge request 編號（例如 `#1234`）或其 URL | 正在處理該 pull request 或 merge request 的工作階段 |345| Pull request 或 merge request 編號（例如 `#1234`）或其 URL | 正在處理該 pull request 或 merge request 的工作階段 |
346| 任何其他 URL | 其第一個提示包含該 URL 的工作階段 |346| 任何其他 URL | 其第一個提示詞包含該 URL 的工作階段 |
347 347
348若要組合篩選條件，請以 `a:`、`s:`、`n:` 或 `o:` 開頭，再加上更多條件，以空格分隔。清單會顯示符合所有條件的工作階段。例如，`s:blocked a:reviewer` 會列出正在等待您的 `reviewer` 工作階段。348若要組合篩選條件，請以 `a:`、`s:`、`n:` 或 `o:` 開頭，再加上更多條件，以空格分隔。清單會顯示符合所有條件的工作階段。例如，`s:blocked a:reviewer` 會列出正在等待您的 `reviewer` 工作階段。
349 349
353 鍵盤快捷鍵353 鍵盤快捷鍵
354</h3>354</h3>
355 355
356在代理檢視中按 `?` 以查看上下文中的每個快捷鍵。下表總結了它們。356在 agent 檢視中按 `?` 即可查看當下情境中的快捷鍵。下表為其摘要。
357 357
358| 快捷鍵 | 動作 |358| 快捷鍵 | 動作 |
359| :- | :- |359| :- | :- |
362| `Home` / `End` | 跳至第一列或最後一列 |362| `Home` / `End` | 跳至第一列或最後一列 |
363| `Enter` | 附加到選定的工作階段，或在輸入的文字不是 [篩選條件](#filter-sessions) 時提交該文字 |363| `Enter` | 附加到選定的工作階段，或在輸入的文字不是 [篩選條件](#filter-sessions) 時提交該文字 |
364| `Space` | 開啟或關閉選定工作階段的查看面板 |364| `Space` | 開啟或關閉選定工作階段的查看面板 |
365| `Shift+Enter` | 在分派輸入中插入新行，[如主提示中所示](/docs/zh-TW/terminal-config#enter-multiline-prompts) |365| `Shift+Enter` | 在分派輸入中插入新行，[與主提示詞輸入相同](/docs/zh-TW/terminal-config#enter-multiline-prompts) |
366| `Ctrl+Enter` | 分派並立即附加，在終端機中 `?` 覆蓋層列出 `ctrl+enter to start and open` |366| `Ctrl+Enter` | 分派並立即附加，適用於 `?` 覆蓋層列出 `ctrl+enter to start and open` 的終端機 |
367| `→` | 附加到選定的工作階段 |367| `→` | 附加到選定的工作階段 |
368| `Alt+1`..`Alt+9` | 附加到聚焦工作階段目錄中的工作階段 1–9 |368| `Alt+1`..`Alt+9` | 附加到聚焦工作階段所在目錄中的工作階段 1–9 |
369| `Tab` | 在空輸入上，瀏覽所有子代理。否則應用突出顯示的建議 |369| `Tab` | 在空白輸入上瀏覽所有 subagent。否則套用反白顯示的建議 |
370| `Ctrl+S` | 在狀態和目錄之間切換分組 |370| `Ctrl+S` | 在狀態和目錄之間切換分組方式 |
371| `Ctrl+T` | 釘選或取消釘選選定的工作階段 |371| `Ctrl+T` | 釘選或取消釘選選定的工作階段 |
372| `Ctrl+F` | 使用 [`n:` 篩選條件](#filter-sessions) 依名稱尋找工作階段 |372| `Ctrl+F` | 使用 [`n:` 篩選條件](#filter-sessions) 依名稱尋找工作階段 |
373| `Alt+↑` / `Alt+↓` | 跳至上一個或下一個群組標題 |373| `Alt+↑` / `Alt+↓` | 跳至上一個或下一個群組標題 |
374| `Ctrl+R` | 重新命名選定的工作階段 |374| `Ctrl+R` | 重新命名選定的工作階段 |
375| `Ctrl+G` | 在您的 `$VISUAL` 或 `$EDITOR` 中開啟分派提示 |375| `Ctrl+G` | 在您的 `$VISUAL` 或 `$EDITOR` 中開啟分派提示詞 |
376| `Ctrl+J` | 在分派輸入中插入新行 |376| `Ctrl+J` | 在分派輸入中插入新行 |
377| `Ctrl+X` | 停止工作階段；在兩秒內再次按下以刪除它 |377| `Ctrl+X` | 停止工作階段；在兩秒內再次按下以刪除它 |
378| `Shift+↑` / `Shift+↓` | 重新排序選定的工作階段 |378| `Shift+↑` / `Shift+↓` | 重新排序選定的工作階段 |
379| `Esc` | 關閉查看面板、清除輸入或退出。當您透過使用 `←` 背景執行工作階段開啟代理檢視時，最終 `Esc` 會返回到該對話而不是退出。啟用 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode) 後，在輸入中按 `Esc` 會從 INSERT 切換到 NORMAL 模式並保留您的文字，如主提示中所示 |379| `Esc` | 關閉查看面板、清除輸入或退出。當您是透過 `←` 將工作階段移至背景而開啟 agent 檢視時，最後一次 `Esc` 會返回該對話而不是退出。啟用 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode) 時，在輸入中按 `Esc` 會從 INSERT 切換到 NORMAL 模式並保留您的文字，與主提示詞輸入相同 |
380| `Ctrl+C` | 清除輸入；按兩次以退出 |380| `Ctrl+C` | 清除輸入；按兩次以退出 |
381| `?` | 顯示所有快捷鍵 |381| `?` | 顯示快捷鍵 |
382 382
383在 [`Agents` 情境](/docs/zh-TW/keybindings#agents-actions) 中具有動作的快捷鍵會遵循您的 [`keybindings.json`](/docs/zh-TW/keybindings)。`Ctrl+G` 也是如此，透過 `Chat` 情境的 `chat:externalEditor` 繫結。383在 [`Agents` 情境](/docs/zh-TW/keybindings#agents-actions) 中具有動作的快捷鍵會遵循您的 [`keybindings.json`](/docs/zh-TW/keybindings)。`Ctrl+G` 也是如此，透過 `Chat` 情境的 `chat:externalEditor` 繫結。
384 384
602 602
603當 hook 在非 git 儲存庫的目錄中失敗時，Claude 會略過該目錄的隔離，並就地編輯工作目錄。在 git 儲存庫內，Claude 會在編輯前移入 worktree 的工作階段，在該移動發生之前無法編輯共用簽出中的檔案。603當 hook 在非 git 儲存庫的目錄中失敗時，Claude 會略過該目錄的隔離，並就地編輯工作目錄。在 git 儲存庫內，Claude 會在編輯前移入 worktree 的工作階段，在該移動發生之前無法編輯共用簽出中的檔案。
604 604
605若要找到工作階段的 worktree 路徑，請預覽該工作階段，或附加並檢查其工作目錄。605若要找到工作階段的 worktree 路徑，請附加並檢查其工作目錄。
606 606
607背景工作階段產生的 [subagent](/docs/zh-TW/sub-agents) 會繼承工作階段的工作目錄。一旦工作階段位於 worktree 中，subagent 的檔案編輯就會寫入該 worktree，而不是您的工作副本。若要改為給 subagent 其自己獨立的 worktree，請在其 frontmatter 中設定 [`isolation: worktree`](/docs/zh-TW/sub-agents#supported-frontmatter-fields)，或在產生它時傳遞 `isolation: "worktree"`。607背景工作階段產生的 [subagent](/docs/zh-TW/sub-agents) 會繼承工作階段的工作目錄。一旦工作階段位於 worktree 中，subagent 的檔案編輯就會寫入該 worktree，而不是您的工作副本。若要改為給 subagent 其自己獨立的 worktree，請在其 frontmatter 中設定 [`isolation: worktree`](/docs/zh-TW/sub-agents#supported-frontmatter-fields)，或在產生它時傳遞 `isolation: "worktree"`。
608 608
810| `claude agents` | 開啟 agent view |810| `claude agents` | 開啟 agent view |
811| `claude agents --cwd <path>` | 開啟 agent view，範圍限定於在 `<path>` 下啟動的工作階段 |811| `claude agents --cwd <path>` | 開啟 agent view，範圍限定於在 `<path>` 下啟動的工作階段 |
812| `claude agents --json` | 將工作階段列印為 JSON 陣列並結束。請參閱 [將工作階段列為 JSON](#list-sessions-as-json) |812| `claude agents --json` | 將工作階段列印為 JSON 陣列並結束。請參閱 [將工作階段列為 JSON](#list-sessions-as-json) |
813| `claude attach <id>` | 在此終端中附加到工作階段 |813| `claude attach <id\|name>` | 在此終端機中附加到工作階段 |
814| `claude logs <id>` | 列印工作階段的最近輸出 |814| `claude logs <id\|name>` | 列印工作階段的最近輸出 |
815| `claude stop <id>` | 停止工作階段。也接受 `claude kill` |815| `claude stop <id>` | 停止工作階段。也接受 `claude kill` |
816| `claude respawn <id>` | 重新啟動工作階段（執行中或已停止），例如用於採用更新的 Claude Code 二進位檔案。重新啟動的工作階段會繼續其已儲存的對話；當磁碟上沒有對話時，它會再次執行其原始提示作為新對話 |816| `claude respawn <id>` | 重新啟動工作階段（執行中或已停止），例如用於採用更新的 Claude Code 二進位檔案。重新啟動的工作階段會繼續其已儲存的對話；當磁碟上沒有對話時，它會再次執行其原始提示詞作為新對話 |
817| `claude respawn --all` | 重新啟動每個執行中的工作階段，例如一次將所有工作階段移至更新的 Claude Code 二進位檔案 |817| `claude respawn --all` | 重新啟動每個執行中的工作階段，例如一次將所有工作階段移至更新的 Claude Code 二進位檔案 |
818| `claude rm <id>` | 從清單中移除工作階段，以及 Claude 為其建立的 worktree（當安全刪除時）；請參閱 [刪除工作階段會移除什麼](#what-deleting-a-session-removes)。對話記錄會保留在您的本機上，並可透過 `claude --resume` 繼續使用 |818| `claude rm <id>` | 從清單中移除工作階段，以及 Claude 為其建立的 worktree（當安全刪除時）；請參閱 [刪除工作階段會移除什麼](#what-deleting-a-session-removes)。對話逐字稿會保留在您的本機上，並可透過 `claude --resume` 繼續使用 |
819| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | 刪除因未推送提交而拒絕刪除的工作階段，捨棄 worktree 及其分支和提交。傳遞拒絕列印的確切值；請參閱 [刪除工作階段會移除什麼](#what-deleting-a-session-removes)。需要 v2.1.260 或更新版本 |819| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | 刪除因未推送提交而拒絕刪除的工作階段，捨棄 worktree 及其分支和提交。傳遞拒絕列印的確切值；請參閱 [刪除工作階段會移除什麼](#what-deleting-a-session-removes)。需要 v2.1.260 或更新版本 |
820| `claude rm <id> --force-remove-worktree <worktree-id>` | 刪除因 git 或 `WorktreeRemove` hook 無法移除其 worktree 而拒絕刪除的工作階段，無論如何刪除 worktree 目錄並在儲存庫中保留其分支。傳遞拒絕列印的確切值；請參閱 [刪除工作階段會移除什麼](#what-deleting-a-session-removes)。需要 v2.1.268 或更新版本 |820| `claude rm <id> --force-remove-worktree <worktree-id>` | 刪除因 git 或 `WorktreeRemove` hook 無法移除其 worktree 而拒絕刪除的工作階段，無論如何刪除 worktree 目錄並在儲存庫中保留其分支。傳遞拒絕列印的確切值；請參閱 [刪除工作階段會移除什麼](#what-deleting-a-session-removes)。需要 v2.1.268 或更新版本 |
821| `claude daemon status` | 列印 [supervisor](#the-supervisor-process) 的狀態、版本、socket 目錄和 worker 計數 |821| `claude daemon status` | 列印 [supervisor](#the-supervisor-process) 的狀態、版本、socket 目錄和 worker 計數 |
822| `claude daemon stop --any` | 停止 supervisor 程序及其託管的背景工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行中，以便下一個 supervisor 可以重新連接到它們。下一個 `claude agents` 或 `claude --bg` 會啟動全新的 supervisor |822| `claude daemon stop --any` | 停止 supervisor 程序及其託管的背景工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行中，以便下一個 supervisor 可以重新連接到它們。下一個 `claude agents` 或 `claude --bg` 會啟動全新的 supervisor |
823 823
824`claude attach` 和 `claude logs` 可以使用執行中工作階段名稱的一部分來取代 ID，例如 `claude logs "auth refactor"`。傳遞名稱需要 Claude Code v2.1.290 或更新版本。
825
824<h3 id="list-sessions-as-json">826<h3 id="list-sessions-as-json">
825 將工作階段列為 JSON827 將工作階段列為 JSON
826</h3>828</h3>
835| `id` | 背景工作階段 | 短 ID，可與 `claude attach`、`claude logs` 和 `claude stop` 搭配使用 |837| `id` | 背景工作階段 | 短 ID，可與 `claude attach`、`claude logs` 和 `claude stop` 搭配使用 |
836| `state` | 背景工作階段 | `working`、`blocked`、`done`、`failed` 或 `stopped` 之一。請參閱 [從指令碼讀取工作階段狀態](#read-session-state-from-a-script)，了解每個值的含義 |838| `state` | 背景工作階段 | `working`、`blocked`、`done`、`failed` 或 `stopped` 之一。請參閱 [從指令碼讀取工作階段狀態](#read-session-state-from-a-script)，了解每個值的含義 |
837| `pid`、`status` | 程序執行時 | 程序 ID 和 `busy`、`waiting` 或 `idle` 之一 |839| `pid`、`status` | 程序執行時 | 程序 ID 和 `busy`、`waiting` 或 `idle` 之一 |
838| `waitingFor` | 當 `status` 為 `waiting` 時 | 工作階段被阻止的原因：`permission prompt` 表示需要核准、`input needed` 表示 Claude 或 MCP 伺服器的輸入請求、`sandbox request`、`worker request` 或 `dialog open` |840| `waitingFor` | 當 `status` 為 `waiting` 時 | 工作階段被阻止的原因：`permission prompt` 表示需要核准、`input needed` 表示 Claude 的問題或 MCP 伺服器的輸入請求、`sandbox request`、`worker request` 或 `dialog open` |
839| `sessionId`、`name` | 設定時 | `sessionId` 是完整的工作階段 UUID，可與 [`claude --resume`](/docs/zh-TW/sessions) 搭配使用。互動工作階段的 `name` 是其 [預設顯示名稱](/docs/zh-TW/sessions#name-your-sessions)，直到您命名工作階段或在其中接受計畫 |841| `sessionId`、`name` | 設定時 | `sessionId` 是完整的工作階段 UUID，可與 [`claude --resume`](/docs/zh-TW/sessions) 搭配使用。互動工作階段的 `name` 是其 [預設顯示名稱](/docs/zh-TW/sessions#name-your-sessions)，直到您命名工作階段或在其中接受計畫 |
840 842
841<h3 id="read-session-state-from-a-script">843<h3 id="read-session-state-from-a-script">
847| `state` | 含義 |849| `state` | 含義 |
848| :- | :- |850| :- | :- |
849| `working` | 正在執行一個回合，或工作階段在其自行驅動的工作步驟之間，例如 [`/loop`](/docs/zh-TW/scheduled-tasks) 反覆運算或等待 CI。`status` 會告訴您其程序現在是否為 `busy` |851| `working` | 正在執行一個回合，或工作階段在其自行驅動的工作步驟之間，例如 [`/loop`](/docs/zh-TW/scheduled-tasks) 反覆運算或等待 CI。`status` 會告訴您其程序現在是否為 `busy` |
850| `blocked` | 工作階段正在等待您：它提出的問題、權限或沙箱決定、只有您才能清除的錯誤（例如過期的登入），或如果您在沒有提示的情況下啟動它，則為其第一個提示。當等待是即時程序中的開啟提示時，`waitingFor` 會命名它 |852| `blocked` | 工作階段正在等待您：它提出的問題、權限或沙箱決定、只有您才能清除的錯誤（例如過期的登入），或如果您在沒有提示詞的情況下啟動它，則為其第一個提示詞。當等待是即時程序中開啟的提示時，`waitingFor` 會命名它 |
851| `done` | 最後一個回合完成了您要求的內容，工作階段已準備好接收您的下一個提示，無論其程序是否仍在執行 |853| `done` | 最後一個回合完成了您要求的內容，工作階段已準備好接收您的下一個提示詞，無論其程序是否仍在執行 |
852| `failed`、`stopped` | 工作已因錯誤而結束，或工作階段已停止 |854| `failed`、`stopped` | 工作已因錯誤而結束，或工作階段已停止 |
853 855
854完成其回合並等待您下一個指令的工作階段讀取 `done`，而不是 `blocked`。`blocked` 一律表示工作階段在繼續之前需要您提供的內容。856完成其回合並等待您下一個指令的工作階段讀取 `done`，而不是 `blocked`。`blocked` 一律表示工作階段在繼續之前需要您提供的內容。
861 背景工作階段如何被託管863 背景工作階段如何被託管
862</h2>864</h2>
863 865
864Claude Code 將 agent view 中列出的每個工作階段視為背景工作階段，無論您目前是否連接到它。相比之下，直接執行 `claude` 啟動的工作階段與該終端相關聯，並在終端關閉時結束，除非您[將其發送到背景](#from-inside-a-session)。866Claude Code 將 agent view 中列出的每個工作階段視為背景工作階段，無論您目前是否連接到它。相比之下，直接執行 `claude` 啟動的工作階段與該終端機相關聯，並在終端機關閉時結束，除非您[將其發送到背景](#from-inside-a-session)。
865 867
866要檢查您在哪種工作階段中，請執行 [`/status`](/docs/zh-TW/commands)。`Session kind` 列在背景工作階段中顯示 `background job · attached` 或 `background job · unattended`（取決於是否連接了終端），在任何其他工作階段中顯示 `interactive`。868要檢查您在哪種工作階段中，請執行 [`/status`](/docs/zh-TW/commands)。`Session kind` 列在背景工作階段中顯示 `background job · attached` 或 `background job · unattended`（取決於是否連接了終端機），在任何其他工作階段中顯示 `interactive`。
867 869
868<h3 id="the-supervisor-process">870<h3 id="the-supervisor-process">
869 監督程序871 監督程序
870</h3>872</h3>
871 873
872監督程序是一個背景服務，執行您的背景工作階段，使其在您關閉 agent view 或終端後繼續工作。Claude Code 在您第一次背景化工作階段或開啟 agent view 時啟動它，您不需要自己管理它。874監督程序是一個背景服務，執行您的背景工作階段，使其在您關閉 agent view 或終端機後繼續工作。Claude Code 在您第一次背景化工作階段或開啟 agent view 時啟動它，您不需要自己管理它。
873 875
874每個工作階段都是監督程序下的自己的 Claude Code 程序，該程序發生的情況取決於工作階段的狀態：876每個工作階段都是監督程序下的自己的 Claude Code 程序，該程序發生的情況取決於工作階段的狀態：
875 877
876* **工作中、暫停在權限提示或其他對話框上，或已連接**：程序保持執行。執行中的子代理、工作流程或監視器計為工作中。878* **工作中、暫停在權限提示或其他對話框上，或已連接**：程序保持執行。執行中的 subagent、工作流程或監視器計為工作中。
877* **已完成或等待您的下一條訊息，且未連接約一小時**：監督程序停止程序以釋放資源。通過提出問題結束其輪次的工作階段計為等待您的下一條訊息。對話保存在磁碟上，下次您連接或回覆時，工作階段從中斷的地方恢復。使用 `Ctrl+T` 釘選工作階段以保持其程序執行。879* **已完成或等待您的下一條訊息，且未連接約一小時**：監督程序停止程序以釋放資源。透過提出問題結束其回合的工作階段計為等待您的下一條訊息。對話保存在磁碟上，下次您連接或回覆時，工作階段從中斷的地方恢復。使用 `Ctrl+T` 釘選工作階段以保持其程序執行。
878* **在監督程序執行時意外退出**：監督程序重新啟動程序。使用 `←` 或 `/background` 結束您背景化的工作階段（例如使用 `kill`）會將其標記為已停止而不是重新啟動。對於以關閉結束的工作階段，請參閱[工作階段在關閉後顯示為失敗或已停止](#sessions-show-as-failed-after-shutdown)。880* **在監督程序執行時意外退出**：監督程序重新啟動程序。結束您自己使用 `←` 或 `/background` 背景化的工作階段（例如使用 `kill`）會將其標記為已停止而不是重新啟動。對於以關閉結束的工作階段，請參閱[工作階段在關閉後顯示為失敗或已停止](#sessions-show-as-failed-after-shutdown)。
879* **自動更新後**：監督程序重新啟動自身到新版本，並在背景中移動閒置工作階段。正在工作、等待您或已連接的工作階段不會被中斷。881* **自動更新後**：監督程序重新啟動自身到新版本，並在背景中移動閒置工作階段。正在工作、等待您或已連接的工作階段不會被中斷。
880 882
881當工作階段的程序停止或重新啟動時，Claude 在其中啟動的背景 shell 命令、動態工作流程和背景子代理會轉移到其下一個程序；執行中的監視器和子代理啟動的 shell 命令會隨程序停止。刪除工作階段會停止它轉移的所有內容。要讓所有內容隨程序停止而不是轉移，請將 [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/zh-TW/env-vars#variables) 設定為 `1`。883當工作階段的程序停止或重新啟動時，Claude 在其中啟動的背景 shell 命令、動態工作流程和背景 subagent 會轉移到其下一個程序；執行中的監視器和 subagent 啟動的 shell 命令會隨程序停止。刪除工作階段會停止它轉移的所有內容。要讓所有內容隨程序停止而不是轉移，請將 [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/zh-TW/env-vars#variables) 設定為 `1`。
882 884
883監督程序及其工作階段使用與您的互動工作階段相同的儲存認證進行身份驗證。對於哪些設定和 shell 變數到達工作階段（包括 `PATH`），請參閱[設定和提供者](#settings-and-provider)。對於閘道端點，請參閱 [LLM 閘道](#llm-gateway)。885監督程序及其工作階段使用與您的互動工作階段相同的儲存憑證進行身分驗證。對於哪些設定和 shell 變數到達工作階段（包括 `PATH`），請參閱[設定和提供者](#settings-and-provider)。對於閘道端點，請參閱 [LLM 閘道](#llm-gateway)。
884 886
885<h3 id="where-state-is-stored">887<h3 id="where-state-is-stored">
886 狀態存儲位置888 狀態存儲位置
892| :- | :- |894| :- | :- |
893| `~/.claude/daemon.log` | 監督程序日誌 |895| `~/.claude/daemon.log` | 監督程序日誌 |
894| `~/.claude/daemon/roster.json` | 執行中的背景工作階段列表，用於在重新啟動後重新連接 |896| `~/.claude/daemon/roster.json` | 執行中的背景工作階段列表，用於在重新啟動後重新連接 |
895| `~/.claude/jobs/<id>/state.json` | 在 agent view 中顯示的每個工作階段狀態。通過 [`claude agents --json`](#read-session-state-from-a-script) 讀取它，而不是解析檔案 |897| `~/.claude/jobs/<id>/state.json` | 在 agent view 中顯示的每個工作階段狀態。透過 [`claude agents --json`](#read-session-state-from-a-script) 讀取它，而不是解析檔案 |
896| `~/.claude/jobs/<id>/tmp/` | 每個工作階段的暫存目錄。Claude 的 `Write` 和 `Edit` 呼叫在此處不會提示權限。工作階段刪除時移除 |898| `~/.claude/jobs/<id>/tmp/` | 每個工作階段的暫存目錄。Claude 的 `Write` 和 `Edit` 呼叫在此處不會提示權限。工作階段刪除時移除 |
897 899
898每個背景工作階段都設定了 `CLAUDE_JOB_DIR` 環境變數，指向其 `~/.claude/jobs/<id>` 目錄，因此工作階段執行的 shell 命令可以將臨時檔案寫入 `$CLAUDE_JOB_DIR/tmp`，而不會與平行工作階段衝突。900每個背景工作階段都設定了 `CLAUDE_JOB_DIR` 環境變數，指向其 `~/.claude/jobs/<id>` 目錄，因此工作階段執行的 shell 命令可以將臨時檔案寫入 `$CLAUDE_JOB_DIR/tmp`，而不會與平行工作階段衝突。
907 關閉 agent view909 關閉 agent view
908</h3>910</h3>
909 911
910要完全關閉背景代理和 agent view，將 `disableAgentView` [設定](/docs/zh-TW/settings)設為 `true` 或設定 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境變數。管理員可以通過[受管設定](/docs/zh-TW/managed-settings)強制執行此操作。912要完全關閉背景 agent 和 agent view，將 `disableAgentView` [設定](/docs/zh-TW/settings)設為 `true` 或設定 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境變數。管理員可以透過[受管設定](/docs/zh-TW/managed-settings)強制執行此操作。
911 913
912<h2 id="troubleshooting">914<h2 id="troubleshooting">
913 故障排除915 疑難排解
914</h2>916</h2>
915 917
916<h3 id="claude-agents-lists-subagents-instead-of-opening-agent-view">918<h3 id="claude-agents-lists-subagents-instead-of-opening-agent-view">
917 `claude agents` 列出子代理而不是開啟代理檢視919 `claude agents` 列出 subagent 而不是開啟 agent view
918</h3>920</h3>
919 921
920如果 `claude agents` 列印計數後跟著您設定的子代理，然後退出，代理檢視在您的環境中不可用。執行 `claude update` 以安裝最新版本。922如果 `claude agents` 列印計數後跟著您設定的 subagent，然後退出，表示 agent view 在您的環境中不可用。執行 `claude update` 以安裝最新版本。
921 923
922如果更新後代理檢視仍未開啟，請檢查它是否已被設定或環境變數[關閉](#turn-off-agent-view)。924如果更新後 agent view 仍未開啟，請檢查它是否已被設定或環境變數[關閉](#turn-off-agent-view)。
923 925
924<h3 id="agent-view-opens-with-no-sessions">926<h3 id="agent-view-opens-with-no-sessions">
925 Agent view 開啟時沒有工作階段927 Agent view 開啟時沒有工作階段
926</h3>928</h3>
927 929
928在您分派第一個工作階段之前，agent view 會顯示空的區段標題，每個標題下方有描述，以及輸入上方有一行說明，代替工作階段清單。在底部的輸入框中輸入提示並按 `Enter` 以分派您的第一個工作階段。930在您分派第一個工作階段之前，agent view 會顯示空的區段標題，每個標題下方有描述，以及輸入框上方有一行說明，代替工作階段清單。在底部的輸入框中輸入提示詞並按 `Enter` 以分派您的第一個工作階段。
929 931
930<h3 id="backgrounding-shows-a-background-this-session-dialog">932<h3 id="backgrounding-shows-a-background-this-session-dialog">
931 背景化顯示 `Background this session?` 對話933 背景化顯示 `Background this session?` 對話框
932</h3>934</h3>
933 935
934如果按 `←` 將當前工作階段放在背景中，Claude Code 顯示 `Background this session?` 對話，工作階段有進行中的工作無法轉移到背景工作階段、可能會停止、重新啟動或無人看管地執行，Claude Code 在執行任何操作之前會詢問：936如果您按 `←` 將目前的工作階段放到背景，而 Claude Code 顯示 `Background this session?` 對話框，表示該工作階段有進行中的工作，背景化會使其停止、重新啟動或在無人看管的情況下繼續執行，因此 Claude Code 在執行上述任何操作之前會先詢問：
935 937
936* **無法移動的工作**：工作階段有無法移動到背景工作階段的工作，例如執行中的 [monitor](/docs/zh-TW/tools-reference#monitor-tool)。對話命名 Claude Code 會停止的工作，並分別計算轉移的任務。938* **無法移動的工作**：工作階段有無法移動到背景工作階段的工作，例如執行中的 [monitor](/docs/zh-TW/tools-reference#monitor-tool)。對話框會列出 Claude Code 將停止的工作，並另外計算會轉移的任務數量。
937* **具有執行中子代理的工作流程**：[動態工作流程](/docs/zh-TW/workflows)仍有子代理執行。工作流程本身會轉移，但其執行中的子代理會從頭開始重新啟動，對話會說明有多少個。939* **具有執行中 subagent 的工作流程**：[動態工作流程](/docs/zh-TW/workflows)仍有 subagent 在執行。工作流程本身會轉移，但其執行中的 subagent 會從頭開始重新啟動，對話框會說明有多少個。
938* **自動成品回覆**：Claude 正在[自行回覆成品上的評論](/docs/zh-TW/artifacts#let-claude-reply-to-comments-on-its-own)。這些回覆會在背景工作階段中繼續，對話會說明。940* **自動 artifact 回覆**：Claude 正在[自行回覆 artifact 上的評論](/docs/zh-TW/artifacts#let-claude-reply-to-comments-on-its-own)。這些回覆會在背景工作階段中繼續，對話框也會說明這一點。
939 941
940執行 `/tasks` 以查看正在執行的所有內容，然後確認以無論如何背景化或選擇 `Stay` 讓工作先完成。請參閱[背景化時轉移的內容](#what-carries-over-when-you-background)以了解哪些工作類型轉移，哪些 Claude Code 停止。942執行 `/tasks` 以查看正在執行的所有內容，然後確認仍要背景化，或選擇 `Stay` 讓工作先完成。請參閱[背景化時轉移的內容](#what-carries-over-when-you-background)以了解哪些類型的工作會轉移，哪些會被 Claude Code 停止。
941 943
942<h3 id="prompt-rejected-as-too-short">944<h3 id="prompt-rejected-as-too-short">
943 提示被拒絕為過短945 提示詞因過短而被拒絕
944</h3>946</h3>
945 947
946分派輸入期望任務描述，而不是對話開場白。短於四個字元的提示會被拒絕並顯示 `Too short` 提示，以便隨意按鍵不會啟動工作階段。描述您希望工作階段執行的操作，例如 `investigate the flaky checkout test`。948分派輸入框期望的是任務描述，而不是對話開場白。短於四個字元的提示詞會被拒絕並顯示 `Too short` 提示，以避免誤觸按鍵啟動工作階段。請描述您希望工作階段執行的操作，例如 `investigate the flaky checkout test`。
947 949
948<h3 id="sessions-show-as-failed-after-shutdown">950<h3 id="sessions-show-as-failed-after-shutdown">
949 工作階段在關閉後顯示為失敗或停止951 工作階段在關機後顯示為失敗或停止
950</h3>952</h3>
951 953
952關閉或重新啟動您的機器會停止執行中的背景工作階段。等待您輸入的工作階段在您回來時會保留在 `Needs input` 下。對於任何其他執行中的工作階段，agent view 顯示的內容取決於它上次取得進度的時間有多久：954關閉或重新啟動您的機器會停止執行中的背景工作階段。等待您輸入的工作階段在您回來時會保留在 `Needs input` 下。對於任何其他執行中的工作階段，agent view 顯示的內容取決於它上次取得進度的時間有多久：
953 955
954* 在 48 小時內，工作階段顯示為失敗。附加或回覆它，它會從中斷的地方重新啟動。956* 在 48 小時內，工作階段顯示為失敗。附加或回覆它，它會從中斷的地方重新啟動。
955* 超過 48 小時，例如機器關閉數天後，工作階段顯示為停止，並顯示 `ended while the background service was off`。在該列上按 `Enter`，頁腳會顯示 `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` 在同一列上再次按 `Enter` 以恢復其已儲存的對話。回覆或 `claude attach <id>` 會在沒有該頁腳提示的情況下恢復它。957* 超過 48 小時，例如機器關閉數天後，工作階段顯示為停止，並顯示 `ended while the background service was off`。在該列上按 `Enter`，頁尾會顯示 `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` 在同一列上再次按 `Enter` 以恢復其已儲存的對話。回覆或 `claude attach <id>` 會在沒有該頁尾提示的情況下恢復它。
956 958
957當[文字記錄清理](/docs/zh-TW/settings-reference#cleanupperioddays)已移除停止工作階段的已儲存對話時，Claude Code 拒絕開啟該列：訊息說沒有要恢復的內容。`claude rm <id>` 刪除該列，除了[保留的情況](#what-deleting-a-session-removes)中描述的情況外，`claude respawn <id>` 會再次執行其原始提示。請參閱[此工作階段的已儲存對話不再在磁碟上](/docs/zh-TW/errors#this-sessions-saved-conversation-is-no-longer-on-disk)。959當[逐字稿清理](/docs/zh-TW/settings-reference#cleanupperioddays)已移除停止工作階段的已儲存對話時，Claude Code 會拒絕開啟該列：訊息會說明沒有可恢復的內容。`claude rm <id>` 會刪除該列（上述[保留的情況](#what-deleting-a-session-removes)除外），而 `claude respawn <id>` 會再次執行其原始提示詞。請參閱[此工作階段的已儲存對話已不在磁碟上](/docs/zh-TW/errors#this-sessions-saved-conversation-is-no-longer-on-disk)。
958 960
959睡眠單獨不會停止工作階段。工作階段在睡眠期間會被保留，監督程序在喚醒時會重新連接到它們。961單純的睡眠不會停止工作階段。工作階段在睡眠期間會被保留，監督程序在喚醒時會重新連接到它們。
960 962
961<h3 id="opening-a-session-says-the-conversation-is-already-open">963<h3 id="opening-a-session-says-the-conversation-is-already-open">
962 開啟工作階段時顯示對話已開啟964 開啟工作階段時顯示對話已開啟
963</h3>965</h3>
964 966
965兩個程序無法寫入同一個文字記錄。當停止工作階段的已儲存對話已在另一個執行中的 Claude Code 程序中開啟時，Claude Code 拒絕啟動工作階段的自己的程序。您看到的內容取決於什麼持有對話：967兩個程序無法寫入同一個逐字稿。當停止工作階段的已儲存對話已在另一個執行中的 Claude Code 程序中開啟時，Claude Code 會拒絕啟動該工作階段自己的程序。您看到的內容取決於持有該對話的是什麼：
966 968
967* 您恢復對話的終端，例如使用 `claude --resume` 或 `/resume`：該列顯示 `Open in a terminal`，並提示在那裡繼續，開啟該列會顯示 `Can't open — this session is running in another terminal`。在該終端中繼續，或退出它並再次開啟該列。969* 您恢復對話的終端機，例如使用 `claude --resume` 或 `/resume`：該列顯示 `Open in a terminal`，並提示在那裡繼續，開啟該列會顯示 `Can't open — this session is running in another terminal`。在該終端機中繼續，或退出它並再次開啟該列。
968* 另一個非互動式 Claude Code 程序，例如同一對話的背景工作階段程序尚未退出：開啟該列會顯示 `This conversation is already open in another running Claude session`。使用該程序，或等待它退出並再次開啟該列。970* 另一個非互動式 Claude Code 程序，例如同一對話的背景工作階段程序尚未退出：開啟該列會顯示 `This conversation is already open in another running Claude session`。使用該程序，或等待它退出後再次開啟該列。
969 971
970Claude Code 會儲存您在拒絕嘗試時輸入的回覆，並在工作階段下次啟動時發送它。972Claude Code 會儲存您在被拒絕的嘗試中輸入的回覆，並在工作階段下次啟動時傳送它。
971 973
972<h3 id="opening-a-session-says-it-has-no-saved-transcript">974<h3 id="opening-a-session-says-it-has-no-saved-transcript">
973 開啟工作階段時顯示它沒有已儲存的文字記錄975 開啟工作階段時顯示它沒有已儲存的逐字稿
974</h3>976</h3>
975 977
976停止工作階段[從另一個對話背景化](#from-inside-a-session)並在其第一個回覆完成之前停止，沒有要恢復的內容：在該第一個回覆完成之前，對話仍然只存在於它背景化的工作階段中。`claude attach` 拒絕開啟它，顯示 `This session has no saved transcript`。978從[另一個對話背景化](#from-inside-a-session)且在第一個回應完成之前就停止的工作階段，沒有可恢復的內容：在第一個回應完成之前，對話仍然只存在於它被背景化的來源工作階段中。`claude attach` 會拒絕開啟它，並顯示 `This session has no saved transcript`。
977 979
978在 agent view 中，開啟該列會在清單下方顯示 `Press enter again to restart this session fresh`。在同一列上再次按 `Enter` 以使用空對話重新啟動工作階段，或從 shell 執行 `claude respawn <id>`。980在 agent view 中，開啟該列會在清單下方顯示 `Press enter again to restart this session fresh`。在同一列上再次按 `Enter` 以使用空對話重新啟動工作階段，或從 shell 執行 `claude respawn <id>`。
979 981
980原始對話完整無缺；使用 `claude --resume` 恢復它或繼續在其中工作。請參閱[錯誤參考](/docs/zh-TW/errors#this-session-has-no-saved-transcript)以取得詳細資訊。982原始對話完整無缺；使用 `claude --resume` 恢復它或繼續在其中工作。請參閱[錯誤參考](/docs/zh-TW/errors#this-session-has-no-saved-transcript)以取得詳細資訊。
981 983
982<h3 id="the-terminal-host-died-or-the-session-stopped-responding">984<h3 id="the-terminal-host-died-or-the-session-stopped-responding">
983 終端主機已死亡或工作階段停止回應985 終端機主機已終止或工作階段停止回應
984</h3>986</h3>
985 987
986[監督程序](#the-supervisor-process)在其自己的主機程序中執行每個背景工作階段的終端。當該程序死亡或停止回應時，Claude Code 會顯示原因並提供重新啟動；在兩種情況下，對話都會被儲存，重新啟動會恢復它。[錯誤參考](/docs/zh-TW/errors#terminal-host-process-died)引用完整訊息。988[監督程序](#the-supervisor-process)在各自的主機程序中執行每個背景工作階段的終端機。當該程序終止或停止回應時，Claude Code 會顯示原因並提供重新啟動；在兩種情況下，對話都會被儲存，重新啟動會恢復它。[錯誤參考](/docs/zh-TW/errors#terminal-host-process-died)中列出了完整訊息。
987 989
988Claude Code 永遠不會重新啟動執行[shell 命令](#run-a-shell-command)的列，來自 `Enter` 或來自 `claude attach`，因為那樣會再次執行命令；該列的訊息和 `claude attach` 都說命令不會再次執行。990無論是透過 `Enter` 或 `claude attach`，Claude Code 都永遠不會重新啟動執行 [shell 命令](#run-a-shell-command)的列，因為那樣會再次執行該命令；該列的訊息和 `claude attach` 都會說明命令不會再次執行。
989 991
990<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">992<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">
991 工作階段在啟動前失敗，並出現 `possibly low memory` 註記993 工作階段在啟動前失敗，並出現 `possibly low memory` 註記
992</h3>994</h3>
993 995
994當背景工作階段的程序在完成啟動前退出，且主機記憶體不足時，該列的狀態會命名退出並新增 `possibly low memory — free some up and retry`。996當背景工作階段的程序在完成啟動前退出，且主機記憶體不足時，該列的狀態會說明退出情況並附加 `possibly low memory — free some up and retry`。
995 997
996該註記是一個假設，而不是確認的原因。Claude Code 只在程序無聲退出時新增它，沒有寫入錯誤，也沒有被信號停止，且主機在該時刻報告記憶體不足。當程序在退出前確實寫入了錯誤時，該列會改為顯示該錯誤。998該註記是一個假設，而不是已確認的原因。Claude Code 只在程序無聲退出（未寫入錯誤，也未被信號停止）且主機在該時刻回報記憶體不足時才會附加它。當程序在退出前確實寫入了錯誤時，該列會改為顯示該錯誤。
997 999
998釋放機器上的記憶體，然後附加或回覆該列，監督程序會為工作階段啟動新的程序。當記憶體保持不足時，監督程序也會[停止閒置工作階段](#the-supervisor-process)以自行釋放資源，如果停止其他工作階段沒有釋放任何內容，也會停止閒置釘選工作階段。1000釋放機器上的記憶體，然後附加或回覆該列，監督程序會為工作階段啟動新的程序。當記憶體持續不足時，監督程序也會自行[停止閒置工作階段](#the-supervisor-process)以釋放資源，如果停止其他工作階段沒有釋放任何資源，也會停止閒置的釘選工作階段。
999 1001
1000<h3 id="agent-view-says-the-background-service-did-not-respond">1002<h3 id="agent-view-says-the-background-service-did-not-respond">
1001 Agent view 表示背景服務未回應1003 Agent view 表示背景服務未回應
1002</h3>1004</h3>
1003 1005
1004如果附加、查看或 `claude logs` 報告背景服務未回應，監督程序可能已停止回應。停止它並讓下一個 `claude agents` 啟動新的程序。若要在重新啟動期間保持背景工作階段執行，請傳遞 `--keep-workers`：1006如果附加、查看或 `claude logs` 回報背景服務未回應，監督程序可能已停滯。停止它並讓下一個 `claude agents` 啟動新的監督程序。若要在重新啟動期間保持背景工作階段執行，請傳遞 `--keep-workers`：
1005 1007
1006```bash theme={null}1008```bash theme={null}
1007claude daemon stop --any --keep-workers1009claude daemon stop --any --keep-workers
1008```1010```
1009 1011
1010新的監督程序會重新連接到執行中的工作階段。如果沒有 `--keep-workers`，該命令也會結束背景工作階段。`--any` 旗標確認您想要停止按需啟動的監督程序，而不是作為已安裝的服務啟動的程序，這是預設值。1012新的監督程序會重新連接到執行中的工作階段。如果沒有 `--keep-workers`，該命令也會結束背景工作階段。`--any` 旗標確認您想要停止按需啟動的監督程序，而不是作為已安裝服務啟動的監督程序，前者為預設情況。
1011 1013
1012啟動但無法接受連接的監督程序會自行退出並釋放其鎖定，因此下一個 `claude agents` 會啟動新的程序，無需此手動停止。上述步驟適用於執行中的監督程序停止回應的情況。1014啟動但無法接受連接的監督程序會自行退出並釋放其鎖定，因此下一個 `claude agents` 會啟動新的監督程序，無需此手動停止。上述步驟適用於執行中的監督程序停滯的情況。
1013 1015
1014如果命令改為退出，說記錄的程序無法驗證為監督程序，請檢查報告的程序 ID：如果它是您擁有的監督程序，自行停止它，然後刪除 `~/.claude/daemon.lock`，以便下一個 `claude agents` 啟動新的程序。1016如果命令改為退出，並表示記錄的程序無法驗證為監督程序，請檢查回報的程序 ID：如果它是您擁有的監督程序，請自行停止它，然後刪除 `~/.claude/daemon.lock`，以便下一個 `claude agents` 重新啟動。
1015 1017
1016在 Windows 上，如果監督程序未回應停止請求，該命令會列印其程序 ID。使用 `taskkill /PID <pid>` 結束該程序以完成復原。當您傳遞 `--keep-workers` 時，背景工作階段仍會被保留。1018在 Windows 上，如果監督程序未回應停止請求，該命令會列印其程序 ID。使用 `taskkill /PID <pid>` 結束該程序以完成復原。若您傳遞了 `--keep-workers`，背景工作階段仍會被保留。
1017 1019
1018<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">1020<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">
1019 背景分派失敗，出現 `Could not resolve authentication method`1021 分派失敗，出現 `Could not resolve authentication method`
1020</h3>1022</h3>
1021 1023
1022如果背景分派失敗，出現 `Could not resolve authentication method`，而互動式工作階段正常驗證，接收分派的背景工作程序未取得認證。背景工作階段從[監督程序](#the-supervisor-process)取得其認證，因此此錯誤表示監督程序本身沒有可用的已儲存認證。確認您已執行 `/login` 或設定 API 金鑰，然後停止監督程序：1024如果背景分派失敗並出現 `Could not resolve authentication method`，而互動式工作階段的身分驗證正常，表示接收分派的背景工作程序未取得憑證。背景工作階段從[監督程序](#the-supervisor-process)取得憑證，因此此錯誤表示監督程序本身沒有可用的已儲存憑證。確認您已執行 `/login` 或設定 API 金鑰，然後停止監督程序：
1023 1025
1024```bash theme={null}1026```bash theme={null}
1025claude daemon stop --any --keep-workers1027claude daemon stop --any --keep-workers
1026```1028```
1027 1029
1028下一個 `claude agents` 或 `claude --bg` 啟動新的監督程序，該程序會讀取您的已儲存認證。如果您使用環境變數（例如 `ANTHROPIC_API_KEY`）而不是 `/login` 進行驗證，請從設定該變數的 shell 執行下一個命令。1030下一個 `claude agents` 或 `claude --bg` 會啟動新的監督程序，該程序會讀取您的已儲存憑證。如果您使用環境變數（例如 `ANTHROPIC_API_KEY`）而不是 `/login` 進行身分驗證，請從已設定該變數的 shell 執行下一個命令。
1029 1031
1030請參閱[錯誤參考](/docs/zh-TW/errors#could-not-resolve-authentication-method)以取得完整的原因和修復清單。1032請參閱[錯誤參考](/docs/zh-TW/errors#could-not-resolve-authentication-method)以取得完整的原因和修復清單。
1031 1033
1033 背景工作階段無法在 macOS 上讀取 Desktop、Documents 或 Downloads1035 背景工作階段無法在 macOS 上讀取 Desktop、Documents 或 Downloads
1034</h3>1036</h3>
1035 1037
1036在 macOS 上，背景工作階段主機作為其自己的程序執行，並與您的終端分開請求對受保護資料夾的存取。如果背景工作階段在讀取 `~/Desktop`、`~/Documents`、`~/Downloads` 或其他受保護位置時報告 `Operation not permitted`，請在系統設定中的隱私與安全性 > 檔案和資料夾下授予存取權限，或為該項目啟用完整磁碟存取。1038在 macOS 上，背景工作階段主機作為獨立的程序執行，並與您的終端機分開請求對受保護資料夾的存取權。如果背景工作階段在讀取 `~/Desktop`、`~/Documents`、`~/Downloads` 或其他受保護位置時回報 `Operation not permitted`，請在系統設定中的隱私權與安全性 > 檔案與檔案夾下授予存取權，或為該項目啟用完整磁碟取用權限。
1037 1039
1038使用原生安裝程式，該項目會顯示為 Claude Code，授予的權限在更新後會保留。使用其他安裝方法（例如 Homebrew 或 npm），該項目會顯示二進位檔路徑，更新後可能需要再次授予。1040使用原生安裝程式時，該項目會顯示為 Claude Code，授予的權限在更新後會保留。使用其他安裝方法（例如 Homebrew 或 npm）時，該項目會顯示二進位檔路徑，更新後可能需要再次授予。
1039 1041
1040<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">1042<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">
1041 背景工作階段無法在 macOS 上連接到本機網路主機1043 背景工作階段無法在 macOS 上連接到本機網路主機
1042</h3>1044</h3>
1043 1045
1044在 macOS 15 及更新版本上，系統會阻止程序連接到您本機網路上的裝置，直到您授予本機網路權限，因此針對 LAN 位址的命令可能會在背景工作階段中失敗，出現 `connect: no route to host`，即使相同的命令在前景終端中有效。背景工作階段中連接到本機網路位址的第一個命令會觸發 Claude Code 的 macOS 本機網路權限提示。授予一次，這些命令就能像在前景終端中一樣連接到 LAN 主機。1046在 macOS 15 及更新版本上，系統會阻止程序連接到您本機網路上的裝置，直到您授予本機網路權限，因此針對 LAN 位址的命令可能會在背景工作階段中失敗並出現 `connect: no route to host`，即使相同的命令在前景終端機中可以正常運作。背景工作階段中第一個連接到本機網路位址的命令會觸發 Claude Code 的 macOS 本機網路權限提示。授予一次後，這些命令就能像在前景終端機中一樣連接到 LAN 主機。
1045 1047
1046<h3 id="a-session-is-slow-to-respond-after-attaching">1048<h3 id="a-session-is-slow-to-respond-after-attaching">
1047 工作階段在附加後響應緩慢1049 工作階段在附加後回應緩慢
1048</h3>1050</h3>
1049 1051
1050當完成或等待您下一個訊息的工作階段在未附加的情況下閒置約一小時時，監督程序會停止其程序以釋放資源。附加會啟動從中斷的地方開始的新程序，並在程序重新啟動時立即切換到工作階段。正在工作、暫停在權限提示或其他對話上，或[釘選](#organize-the-list)的工作階段不會以這種方式停止，因此使用 `Ctrl+T` 釘選工作階段以保持其回應性。1052當已完成或正在等待您下一則訊息的工作階段在未附加的狀態下維持約一小時時，監督程序會停止其程序以釋放資源。附加會從中斷的地方啟動新的程序，並在程序重新啟動期間立即切換到該工作階段。正在工作、暫停在權限提示或其他對話框上，或已[釘選](#organize-the-list)的工作階段不會以這種方式停止，因此請使用 `Ctrl+T` 釘選工作階段以保持其回應速度。
1051 1053
1052當程序啟動時，Claude Code 會顯示工作階段文字記錄的尾部，格式化為即時工作階段呈現的方式，包含 markdown、突出顯示的程式碼區塊和工具呼叫作為暗淡列，上方有暗淡提示區域和 `Session is starting` 註記。即時工作階段在準備好時立即取代它。1054程序啟動期間，Claude Code 會以即時工作階段的呈現方式顯示工作階段逐字稿的結尾部分，包含 markdown、醒目顯示的程式碼區塊，以及以暗淡列呈現的工具呼叫，下方為暗淡的提示區域並附有 `Session is starting` 註記。即時工作階段準備好後會立即取代它。
1053 1055
1054<h3 id="claude/worktrees/-is-filling-up">1056<h3 id="claude/worktrees/-is-filling-up">
1055 `.claude/worktrees/` 正在填滿1057 `.claude/worktrees/` 正在填滿
1057 1059
1058在 agent view 中刪除工作階段會移除 Claude 為其建立的 worktree，但[某些刪除會保留 worktree 或在磁碟上留下其目錄](#what-deleting-a-session-removes)，因此剩餘目錄可能會累積。Git 不再識別的目錄不會出現在 `git worktree list` 中，因此請手動移除這些目錄。1060在 agent view 中刪除工作階段會移除 Claude 為其建立的 worktree，但[某些刪除會保留 worktree 或在磁碟上留下其目錄](#what-deleting-a-session-removes)，因此剩餘目錄可能會累積。Git 不再識別的目錄不會出現在 `git worktree list` 中，因此請手動移除這些目錄。
1059 1061
1060在專案目錄中使用 `git worktree list` 列出剩餘條目，並使用 `git worktree remove <path>` 移除每個。請參閱[清理 worktrees](/docs/zh-TW/worktrees#clean-up-worktrees)。1062在專案目錄中使用 `git worktree list` 列出剩餘項目，並使用 `git worktree remove <path>` 逐一移除。請參閱[清理 worktree](/docs/zh-TW/worktrees#clean-up-worktrees)。
1061 1063
1062<h2 id="limitations">1064<h2 id="limitations">
1063 限制1065 限制
1089 1091
1090| 版本 | 變更 |1092| 版本 | 變更 |
1091| - | - |1093| - | - |
1094| v2.1.290 | [`claude attach` 和 `claude logs`](#manage-sessions-from-the-shell) 可以接受執行中工作階段名稱的一部分來取代 ID。 |
1092| v2.1.288 | `Ctrl+F` 會依名稱尋找工作階段，`Alt+↑` / `Alt+↓` 會在群組標題之間跳轉。這兩者以及 `Ctrl+R` 都可以[重新繫結](/docs/zh-TW/keybindings#agents-actions)。 |1095| v2.1.288 | `Ctrl+F` 會依名稱尋找工作階段，`Alt+↑` / `Alt+↓` 會在群組標題之間跳轉。這兩者以及 `Ctrl+R` 都可以[重新繫結](/docs/zh-TW/keybindings#agents-actions)。 |
1093| v2.1.287 | [`n:<text>` 篩選器](#filter-sessions)會依名稱或第一個提示詞尋找工作階段。當任何篩選器作用中時，您摺疊的群組會展開以顯示其符合項目，並選取第一個符合項目，因此 `Enter` 會開啟它。 |1096| v2.1.287 | [`n:<text>` 篩選器](#filter-sessions)會依名稱或第一個提示詞尋找工作階段。當任何篩選器作用中時，您摺疊的群組會展開以顯示其符合項目，並選取第一個符合項目，因此 `Enter` 會開啟它。 |
1094| v2.1.287 | 作為[查看回覆](#peek-and-reply)傳送的命令會在工作階段目前的回合結束時執行，包括在工作階段自己的輸入中一輸入就會立即執行的命令。內容恰好為 `/stop` 的回覆會立即停止工作階段。 |1097| v2.1.287 | 作為[查看回覆](#peek-and-reply)傳送的命令會在工作階段目前的回合結束時執行，包括在工作階段自己的輸入中一輸入就會立即執行的命令。內容恰好為 `/stop` 的回覆會立即停止工作階段。 |
1095| v2.1.281 | [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 限制[轉移](#what-carries-over-when-you-background)到您使用 `←` 或 `/bg` 背景化的工作階段，以及您從 agent view 分派的工作階段。在此版本之前，生成的工作階段載入每個設定來源。 |1098| v2.1.281 | [`--setting-sources`](/docs/zh-TW/cli-reference#cli-flags) 限制會[轉移](#what-carries-over-when-you-background)到您使用 `←` 或 `/bg` 背景化的工作階段，以及您從 agent view 分派的工作階段。在此版本之前，生成的工作階段會載入每個設定來源。 |
1096| v2.1.281 | `claude --bg` 和重新啟動工作階段的命令會先檢查工作階段目錄的工作區信任。從該目錄中的終端，如果您尚未接受，[信任對話會出現](#from-your-shell)；在無法出現對話的地方（例如在指令碼中），命令會以 [`Workspace not trusted`](/docs/zh-TW/errors#workspace-not-trusted-when-dispatching-a-background-session) 錯誤退出。 |1099| v2.1.281 | `claude --bg` 和重新啟動工作階段的命令會先檢查工作階段目錄的工作區信任。從該目錄中的終端機，如果您尚未接受，[信任對話框會出現](#from-your-shell)；在無法出現對話框的地方（例如在指令碼中），命令會以 [`Workspace not trusted`](/docs/zh-TW/errors#workspace-not-trusted-when-dispatching-a-background-session) 錯誤退出。 |
1097| v2.1.274 | 自動更新後，您已遠離約一小時的 agent view 可以將自己重新啟動到新的組建。當它這樣做時，它會保留您開啟它時的[分派預設值](#dispatch-defaults)：`--model`、`--effort`、`--permission-mode`、`--allow-dangerously-skip-permissions` 和 `--agent`。在此版本之前，重新啟動的 view 只保留 `--cwd` 和配置旗標，例如 `--settings` 和 `--mcp-config`，所以您之後分派的工作階段啟動時沒有這些預設值。 |1100| v2.1.274 | 自動更新後，您已離開約一小時的 agent view 可以將自己重新啟動到新的建置。當它這樣做時，它會保留您開啟它時的[分派預設值](#dispatch-defaults)：`--model`、`--effort`、`--permission-mode`、`--allow-dangerously-skip-permissions` 和 `--agent`。在此版本之前，重新啟動的 view 只保留 `--cwd` 和設定旗標，例如 `--settings` 和 `--mcp-config`，所以您之後分派的工作階段啟動時沒有這些預設值。 |
1098| v2.1.274 | 當[刪除因 git 或您的 `WorktreeRemove` hook 無法移除 worktree 而被拒絕](#what-deleting-a-session-removes)時，已簽出的子模組，Claude Code 驗證沒有對追蹤檔案的未提交變更，不會阻止再次刪除的提供，並移除目錄。已簽出子模組內的未提交工作計為未提交變更，訊息會命名子模組。在此版本之前，worktree 中的任何子模組簽出都會阻止提供，訊息說 worktree 包含巢狀儲存庫。 |1101| v2.1.274 | 當[刪除因 git 或您的 `WorktreeRemove` hook 無法移除 worktree 而被拒絕](#what-deleting-a-session-removes)時，經 Claude Code 驗證對追蹤檔案沒有未提交變更的已簽出子模組，不會阻止再次刪除並仍移除目錄的選項。已簽出子模組內的未提交工作會計為未提交變更，訊息會指出該子模組的名稱。在此版本之前，worktree 中的任何子模組簽出都會阻止該選項，訊息說 worktree 包含巢狀儲存庫。 |
1099| v2.1.268 | 當[刪除因 git 或您的 `WorktreeRemove` hook 無法移除 worktree 而被拒絕](#what-deleting-a-session-removes)時，訊息會命名原因，包括 hook 如何結束及其 stderr 的開始。對於位於儲存庫的 `.claude/worktrees/` 下的連結 worktree，沒有對追蹤檔案的未提交變更、其內沒有巢狀儲存庫，且沒有其他工作階段的記錄命名它，再次刪除工作階段會從 agent view 或使用 `claude rm <id> --force-remove-worktree <worktree-id>` 移除目錄。在此版本之前，列只顯示 `worktree could not be removed (WorktreeRemove hook failed)` 或 git 的錯誤，hook 的 stderr 只進入偵錯日誌，再次刪除被以相同方式拒絕。 |1102| v2.1.268 | 當[刪除因 git 或您的 `WorktreeRemove` hook 無法移除 worktree 而被拒絕](#what-deleting-a-session-removes)時，訊息會指出原因，包括 hook 如何結束及其 stderr 的開頭。對於位於儲存庫的 `.claude/worktrees/` 下的連結 worktree，若對追蹤檔案沒有未提交變更、其內沒有巢狀儲存庫，且沒有其他工作階段的記錄指向它，再次刪除工作階段會從 agent view 或使用 `claude rm <id> --force-remove-worktree <worktree-id>` 仍然移除目錄。在此版本之前，列只顯示 `worktree could not be removed (WorktreeRemove hook failed)` 或 git 的錯誤，hook 的 stderr 只進入偵錯日誌，再次刪除會以相同方式被拒絕。 |
1100| v2.1.268 | 在第一個 `←` 顯示 `Press ← again to open agents` 或在附加的工作階段中 `Press ← again to go back to agents` 後，[至少一秒後到達的第一次按下會切換](#switch-sessions-without-leaving-the-terminal)，即使中間更快的按下被忽略。在此版本之前，每次被忽略的按下都會重新啟動等待，所以以穩定的速度再次按 `←` 直到您暫停超過一秒才會切換。 |1103| v2.1.268 | 在第一個 `←` 顯示 `Press ← again to open agents`，或在附加的工作階段中顯示 `Press ← again to go back to agents` 後，[至少一秒後到達的第一次按下會切換](#switch-sessions-without-leaving-the-terminal)，即使中間較快的按下被忽略。在此版本之前，每次被忽略的按下都會重新開始等待，所以以穩定的速度再次按 `←` 直到您暫停超過一秒才會切換。 |
1101| v2.1.260 | 當您[背景化工作階段](#from-inside-a-session)時，您的其他工作階段的[代理清單](/docs/zh-TW/cross-session-messaging#see-which-sessions-claude-can-reach)會顯示對話一次，作為其背景工作階段，它們對它的訊息不再到達您移動它的終端。在此版本之前，該終端可能會在對話名稱下列為第二個互動工作階段，在移動前已訊息對話的工作階段會繼續傳遞到該終端。 |1104| v2.1.260 | 當您[背景化工作階段](#from-inside-a-session)時，您其他工作階段的 [agent 清單](/docs/zh-TW/cross-session-messaging#see-which-sessions-claude-can-reach)會只顯示該對話一次，作為其背景工作階段，它們傳給它的訊息不再到達您移出它的終端機。在此版本之前，該終端機可能會在對話名稱下被列為第二個互動工作階段，而在移動前已傳訊息給該對話的工作階段會繼續傳遞到該終端機。 |
1102| v2.1.260 | 當[刪除因未推送的提交而被拒絕](#what-deleting-a-session-removes)時，訊息會命名 worktree 的分支及有多少提交未推送，再次刪除工作階段會丟棄 worktree 及其提交。在此版本之前，拒絕只說 `worktree has commits that are not pushed anywhere`，再次刪除被以相同方式拒絕，刪除工作階段需要推送提交或手動移除 worktree。 |1105| v2.1.260 | 當[刪除因未推送的提交而被拒絕](#what-deleting-a-session-removes)時，訊息會指出 worktree 的分支及有多少提交未推送，再次刪除工作階段會丟棄 worktree 及其提交。在此版本之前，拒絕只說 `worktree has commits that are not pushed anywhere`，再次刪除會以相同方式被拒絕，刪除工作階段需要推送提交或手動移除 worktree。 |
1103| v2.1.257 | `←` [在 `/btw` 覆蓋層開啟時從附加的工作階段分離](#attach-to-a-session)，即使在中途回答，覆蓋層會在您下次附加時重新開啟。在此版本之前，覆蓋層開啟時 `←` 不會分離。 |1106| v2.1.257 | `←` [在 `/btw` 覆蓋層開啟時從附加的工作階段分離](#attach-to-a-session)，即使正在回答中途，覆蓋層會在您下次附加時重新開啟。在此版本之前，覆蓋層開啟時 `←` 不會分離。 |
1104| v2.1.257 | 當您執行 [`claude --resume <session-id> --bg`](#from-your-shell) 時，Claude Code 會在其自己的 ID 下繼續該工作階段，或在新 ID 下啟動副本並列印 `note:` 行說明原因。`--continue`、裸露的 `--resume` 和帶有名稱或路徑的 `--resume` 會啟動具有相同備註的副本。在此版本之前，`--resume` 與 `--bg` 總是在新 ID 下啟動副本且不說任何內容。 |1107| v2.1.257 | 當您執行 [`claude --resume <session-id> --bg`](#from-your-shell) 時，Claude Code 會在其自己的 ID 下繼續該工作階段，或在新 ID 下啟動副本並列印 `note:` 行說明原因。`--continue`、不帶參數的 `--resume` 和帶有名稱或路徑的 `--resume` 會啟動副本並顯示相同的備註。在此版本之前，`--resume` 與 `--bg` 總是在新 ID 下啟動副本且不說明任何內容。 |
1105| v2.1.257 | 當您從使用 `←` 開啟的 agent view 分派工作階段時，Claude Code 會在[目標目錄透過 `permissions.defaultMode` 配置的權限模式](#permission-mode)中啟動它。當目錄未設定一個時，您來自的工作階段的權限模式適用。在此版本之前，分派的工作階段總是在您來自的工作階段的權限模式中啟動，覆蓋它。 |1108| v2.1.257 | 當您從使用 `←` 開啟的 agent view 分派工作階段時，Claude Code 會以[目標目錄透過 `permissions.defaultMode` 設定的權限模式](#permission-mode)啟動它。當目錄未設定時，會套用您來源工作階段的權限模式。在此版本之前，分派的工作階段總是以您來源工作階段的權限模式啟動，覆寫了目錄的設定。 |
1106| v2.1.257 | Agent view 中的 `Ctrl+S`、`Ctrl+T` 和 `Ctrl+G` [遵循您的 `keybindings.json`](#keyboard-shortcuts)：`Ctrl+S` 和 `Ctrl+T` 透過 `Agents` 內容的 `agents:switchView` 和 `agents:togglePin` 動作，以及 `Ctrl+G` 透過 `Chat` 內容的 `chat:externalEditor` 繫結。在此版本之前，agent view 忽略 `keybindings.json`，這些鍵是固定的。 |1109| v2.1.257 | Agent view 中的 `Ctrl+S`、`Ctrl+T` 和 `Ctrl+G` [遵循您的 `keybindings.json`](#keyboard-shortcuts)：`Ctrl+S` 和 `Ctrl+T` 透過 `Agents` 內容的 `agents:switchView` 和 `agents:togglePin` 動作，`Ctrl+G` 則透過 `Chat` 內容的 `chat:externalEditor` 繫結。在此版本之前，agent view 忽略 `keybindings.json`，這些鍵是固定的。 |
1107| v2.1.257 | 啟動[背景服務](#the-supervisor-process)會從兩個失敗原因恢復。在 macOS npm 安裝上，自我更新期間的啟動[等待安裝](/docs/zh-TW/errors#eacces-when-starting-a-background-session)，而不是執行 npm 在取代二進位檔時放下的預留位置。在 Windows 上，在機器上次啟動前寫入的過時 `daemon.lock`，或其記錄的程序 ID 現在屬於不同程序的，會被取代。在此版本之前，macOS 啟動在安裝視窗期間失敗，出現 `Error: claude native binary not installed.`，Windows 鎖定使每次啟動都失敗，出現 [`exited before it became reachable`](/docs/zh-TW/errors#background-service-exited-before-it-became-reachable)，直到您刪除 `~/.claude/daemon.lock`。 |1110| v2.1.257 | 啟動[背景服務](#the-supervisor-process)可從兩種失敗原因中復原。在 macOS npm 安裝上，自我更新期間的啟動會[等待安裝完成](/docs/zh-TW/errors#eacces-when-starting-a-background-session)，而不是執行 npm 在取代二進位檔時放置的預留位置。在 Windows 上，在機器上次開機前寫入的過時 `daemon.lock`，或其記錄的程序 ID 現在屬於不同程序的，會被取代。在此版本之前，macOS 啟動在安裝期間會失敗並出現 `Error: claude native binary not installed.`，而 Windows 鎖定會使每次啟動都失敗並出現 [`exited before it became reachable`](/docs/zh-TW/errors#background-service-exited-before-it-became-reachable)，直到您刪除 `~/.claude/daemon.lock`。 |
1108| v2.1.257 | 當您在另一個 Claude Code 程序下載 npm 更新時開啟或分派背景工作階段時，Claude Code [保持等待最多兩分鐘](/docs/zh-TW/errors#eacces-when-starting-a-background-session)，同時安裝執行，然後失敗，說 `Claude Code is being updated by npm on this machine`。在此版本之前，等待在十秒時停止，所以開啟在下載仍在執行時失敗，出現 `Couldn't start the background service`。 |1111| v2.1.257 | 當您在另一個 Claude Code 程序下載 npm 更新時開啟或分派背景工作階段，Claude Code 會在安裝執行期間[持續等待最多兩分鐘](/docs/zh-TW/errors#eacces-when-starting-a-background-session)，然後失敗並顯示 `Claude Code is being updated by npm on this machine`。在此版本之前，等待在十秒時停止，所以開啟會在下載仍在執行時失敗，出現 `Couldn't start the background service`。 |
1109| v2.1.257 | 持有[跨工作階段訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)等待您批准的背景工作階段在其 `Needs input` 列上顯示 `approve message from`，帶有寄件者的地址和寄件者聲稱的名稱。在此版本之前，列移到 `Needs input` 但保留其先前的文字，所以 `claude agents` 中沒有任何內容命名等待的訊息或其寄件者。 |1112| v2.1.257 | 持有[跨工作階段訊息](/docs/zh-TW/cross-session-messaging#control-inbound-messages)等待您核准的背景工作階段，會在其 `Needs input` 列上顯示 `approve message from`，並附上寄件者的地址和寄件者聲稱的名稱。在此版本之前，列會移到 `Needs input` 但保留其先前的文字，所以 `claude agents` 中沒有任何內容指出等待中的訊息或其寄件者。 |
1110| v2.1.257 | 在開啟的背景工作階段內使用 `Ctrl+S` 隱藏的提示[與工作階段一起保留](#what-persists-across-restarts)，所以 `Ctrl+S` 在工作階段的程序停止並再次啟動後恢復它。在此版本之前，隱藏只存在於執行中的程序中，當工作階段閒置足夠長的時間以至於其程序停止時，或當它停止然後重新開啟時會遺失。 |1113| v2.1.257 | 在開啟的背景工作階段內使用 `Ctrl+S` 暫存的提示詞[會與工作階段一起保留](#what-persists-across-restarts)，所以 `Ctrl+S` 在工作階段的程序停止並再次啟動後仍能還原它。在此版本之前，暫存只存在於執行中的程序中，當工作階段閒置夠久以至於其程序停止時，或當它被停止後再重新開啟時，就會遺失。 |
1111| v2.1.251 | 在尚未[移入 worktree](#how-file-edits-are-isolated) 的背景工作階段中，Claude 和它生成的子代理可以編輯連結 git worktree 內的檔案。 |1114| v2.1.251 | 在尚未[移入 worktree](#how-file-edits-are-isolated) 的背景工作階段中，Claude 和它生成的 subagent 可以編輯連結 git worktree 內的檔案。 |
1112| v2.1.251 | Claude Code 轉發在您分派的 shell 中匯出的雲端提供者閘道，例如 `ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 及其驗證繞過旗標，到[工作階段的工作程序](#llm-gateway)，條件與 `ANTHROPIC_BASE_URL` 相同。在此版本之前，如果您只透過這樣的閘道背景化或分派，工作階段進行的每個請求都失敗，因為端點和旗標從其環境中被丟棄。 |1115| v2.1.251 | Claude Code 會將您分派時所在 shell 中匯出的雲端提供者閘道，例如 `ANTHROPIC_VERTEX_BASE_URL` 或 `ANTHROPIC_BEDROCK_BASE_URL` 及其身分驗證繞過旗標，以與 `ANTHROPIC_BASE_URL` 相同的條件轉發到[工作階段的工作程序](#llm-gateway)。在此版本之前，如果您從只透過這種閘道進行身分驗證的 shell 背景化或分派，工作階段發出的每個請求都會失敗，因為端點和旗標已從其環境中被丟棄。 |
1113| v2.1.251 | 當背景工作階段在另一個 Claude Code 程序重新整理[外掛程式市場](/docs/zh-TW/plugins/overview)時啟動，例如執行[市場自動更新](/docs/zh-TW/plugins/install#keep-plugins-updated)的同級工作階段，Claude Code 保持該市場的外掛程式可用。在此版本之前，這樣的工作階段可能在沒有該市場的任何技能、代理、hooks 和 MCP 伺服器的情況下啟動，並在其整個執行期間保持這樣。 |1116| v2.1.251 | 當背景工作階段在另一個 Claude Code 程序重新整理[外掛市集](/docs/zh-TW/plugins/overview)時啟動，例如同級工作階段正在執行[市集自動更新](/docs/zh-TW/plugins/install#keep-plugins-updated)，Claude Code 會讓該市集的外掛保持可用。在此版本之前，這樣的工作階段可能在沒有該市集任何 skill、agent、hook 和 MCP 伺服器的情況下啟動，並在其整個執行期間保持如此。 |
1114| v2.1.248 | [分派輸入](#keyboard-shortcuts)中的 `Shift+Enter` 插入換行符，符合主提示，`Ctrl+Enter` 在 `?` 覆蓋層列出 `ctrl+enter to start and open` 的終端中立即分派並附加。在此版本之前，`Shift+Enter` 分派並附加。 |1117| v2.1.248 | [分派輸入](#keyboard-shortcuts)中的 `Shift+Enter` 會插入換行，與主要提示詞輸入一致，而在 `?` 覆蓋層列出 `ctrl+enter to start and open` 的終端機中，`Ctrl+Enter` 會立即分派並附加。在此版本之前，`Shift+Enter` 會分派並附加。 |
1115| v2.1.248 | [刪除工作階段](#what-deleting-a-session-removes)在 worktree 的提交已在您的 `origin` 遠端預設分支的本機副本上且您的主簽出已簽出該分支時成功；在此版本之前，刪除被拒絕，出現 `has commits that are not pushed anywhere`。 |1118| v2.1.248 | 當 worktree 的提交已在您 `origin` 遠端預設分支的本機副本上，且您的主要簽出已簽出該分支時，[刪除工作階段](#what-deleting-a-session-removes)會成功；在此版本之前，刪除會被拒絕並出現 `has commits that are not pushed anywhere`。 |
1116| v2.1.248 | 使用 `←` 或 `/background` 背景化的工作階段在執行時持有其 worktree 上的 [`git worktree lock`](/docs/zh-TW/worktrees#clean-up-subagent-and-background-session-worktrees)；在此版本之前，背景化釋放鎖定，清理或 `git worktree remove` 可以在執行中的工作階段下移除 worktree。 |1119| v2.1.248 | 使用 `←` 或 `/background` 背景化的工作階段在執行期間會持有其 worktree 上的 [`git worktree lock`](/docs/zh-TW/worktrees#clean-up-subagent-and-background-session-worktrees)；在此版本之前，背景化會釋放鎖定，清理或 `git worktree remove` 可能在執行中的工作階段底下移除 worktree。 |
1117| v2.1.248 | 未等待您輸入且在其最後活動超過 48 小時後被發現已死亡的背景工作階段，例如在機器關閉數天後，[顯示為已停止](#sessions-show-as-failed-after-shutdown)，出現 `ended while the background service was off`，`Enter` 在它上面會在恢復其已保存的對話前詢問。在此版本之前，這樣的工作階段重新出現為新鮮失敗，排序到列表的頂部，單一 `Enter` 將數週前的對話拉入前景。 |1120| v2.1.248 | 未在等待您輸入、且在其最後活動超過 48 小時後被發現已終止的背景工作階段，例如在機器關閉數天後，會[顯示為已停止](#sessions-show-as-failed-after-shutdown)並附上 `ended while the background service was off`，在其上按 `Enter` 會在恢復其已儲存的對話前先詢問。在此版本之前，這樣的工作階段會重新出現為新的失敗並排序到清單頂端，單次 `Enter` 就會將數週前的對話拉到前景。 |
1118| v2.1.248 | 開啟已停止列，其對話[您在另一個終端恢復](#opening-a-session-says-the-conversation-is-already-open)被拒絕，出現 `Can't open — this session is running in another terminal`，列顯示 `Open in a terminal` 而不是在 `Working` 下顯示。在此版本之前，開啟列啟動第二個程序寫入相同的對話。 |1121| v2.1.248 | 開啟一個其對話[已在另一個終端機中恢復](#opening-a-session-says-the-conversation-is-already-open)的已停止列，會被拒絕並出現 `Can't open — this session is running in another terminal`，且該列會顯示 `Open in a terminal`，而不是顯示在 `Working` 下。在此版本之前，開啟該列會啟動第二個寫入相同對話的程序。 |
1119| v2.1.248 | 等待權限決定的背景工作階段，同時 `PermissionRequest` 或 `PreToolUse` hook 列印了無效答案[在其列上命名 hook 事件和架構錯誤](#peek-and-reply)。在此版本之前，列只顯示待決請求。 |1122| v2.1.248 | 在 `PermissionRequest` 或 `PreToolUse` hook 輸出無效答案時等待權限決定的背景工作階段，會[在其列上指出 hook 事件和 schema 錯誤](#peek-and-reply)。在此版本之前，列只顯示待決的請求。 |
1120| v2.1.248 | 在 Windows 上，`claude agents` 在早期程序留下 win32-input-mode 的終端標籤中啟動時回應鍵盤。在此版本之前，Claude Code 沒有解碼這樣的標籤傳送的關鍵記錄。 |1123| v2.1.248 | 在 Windows 上，`claude agents` 在先前程式留下 win32-input-mode 的終端機分頁中啟動時，會回應鍵盤輸入。在此版本之前，Claude Code 無法解碼這類分頁傳送的按鍵記錄。 |
1121| v2.1.247 | 在 Linux 和 WSL 上，[其終端主機程序已死亡](#the-terminal-host-died-or-the-session-stopped-responding)的工作階段在數秒內失敗，出現原因。沒有輸出的開啟在約十秒後結束，出現重新啟動提供，`Enter` 在列上使用其對話重新啟動工作階段；`claude attach <id>` 報告原因並退出。在此版本之前，開啟這樣的工作階段無限期地顯示 `opening… · esc to cancel`，`claude attach <id>` 等待而不報告錯誤。 |1124| v2.1.247 | 在 Linux 和 WSL 上，[其終端機主機程序已終止](#the-terminal-host-died-or-the-session-stopped-responding)的工作階段會在數秒內失敗並顯示原因。沒有產生輸出的開啟會在約十秒後結束並提供重新啟動選項，在該列上按 `Enter` 會以其對話重新啟動工作階段；`claude attach <id>` 會回報原因並退出。在此版本之前，開啟這樣的工作階段會無限期顯示 `opening… · esc to cancel`，而 `claude attach <id>` 會持續等待而不回報錯誤。 |
1122| v2.1.246 | 在 npm 安裝上，當[背景服務](#the-supervisor-process)在 `npm install -g @anthropic-ai/claude-code` 取代二進位檔時無法啟動時，Claude Code 等待最多十秒以完成安裝並重試，然後報告 [`EACCES: permission denied`](/docs/zh-TW/errors#eacces-when-starting-a-background-session)。 |1125| v2.1.246 | 在 npm 安裝上，當[背景服務](#the-supervisor-process)在 `npm install -g @anthropic-ai/claude-code` 取代二進位檔期間無法啟動時，Claude Code 會等待最多十秒讓安裝完成並重試，然後才回報 [`EACCES: permission denied`](/docs/zh-TW/errors#eacces-when-starting-a-background-session)。 |
1123| v2.1.246 | 當[背景服務](#the-supervisor-process)程序在列印錯誤後死亡時，Claude Code 報告失敗並[引用服務的第一個錯誤行](/docs/zh-TW/errors#background-service-exited-before-it-became-reachable)。 |1126| v2.1.246 | 當[背景服務](#the-supervisor-process)程序在輸出錯誤後終止時，Claude Code 會回報失敗並[引用服務的第一行錯誤](/docs/zh-TW/errors#background-service-exited-before-it-became-reachable)。 |
1124| v2.1.246 | 如果您的機器在[背景服務](#the-supervisor-process)啟動時進入睡眠，Claude Code 會重試啟動一次，而不是失敗。 |1127| v2.1.246 | 如果您的機器在[背景服務](#the-supervisor-process)啟動期間進入睡眠，Claude Code 會重試啟動一次，而不是失敗。 |
1125| v2.1.246 | Claude Code 等待約兩分鐘，而不是 45 秒，以便新啟動的[背景服務](#the-supervisor-process)活著但接受連接速度緩慢。 |1128| v2.1.246 | 對於新啟動、仍在運作但接受連線緩慢的[背景服務](#the-supervisor-process)，Claude Code 會等待約兩分鐘，而不是 45 秒。 |
1126| v2.1.246 | [背景服務](#the-supervisor-process)從您的主目錄啟動，所以在 macOS 和 Linux 上已刪除或移動的啟動目錄不再阻止啟動。 |1129| v2.1.246 | [背景服務](#the-supervisor-process)從您的家目錄啟動，所以在 macOS 和 Linux 上，已刪除或移動的啟動目錄不再阻止啟動。 |
1127| v2.1.246 | `/fork` [複製完整對話](#copy-the-session-with-%2Ffork)，來自本身作為副本啟動且未記錄新提示的工作階段：您附加到的 `/fork` 副本、在 `←` 或 `/background` 將其移到背景後重新附加的工作階段，或使用 `claude --resume <id> --fork-session` 啟動的工作階段。在此版本之前，如果您在這樣的工作階段中在傳送新提示前執行 `/fork`，Claude Code 列印正常確認但使用空對話啟動副本。使用 `←` 或 `/background` 將這樣的工作階段移到背景以相同方式遺失對話。 |1130| v2.1.246 | `/fork` 會從本身作為副本啟動、且之後尚未記錄新提示詞的工作階段[複製完整對話](#copy-the-session-with-%2Ffork)：您附加的 `/fork` 副本、在 `←` 或 `/background` 將其移到背景後重新附加的工作階段，或使用 `claude --resume <id> --fork-session` 啟動的工作階段。在此版本之前，如果您在傳送新提示詞前就在這樣的工作階段中執行 `/fork`，Claude Code 會列印正常的確認訊息，但以空對話啟動副本。使用 `←` 或 `/background` 將這樣的工作階段移到背景也會以相同方式遺失對話。 |
1128| v2.1.246 | 當您開啟您剛分派的工作階段，同時其工作程序仍在啟動時，例如按 `Enter` 在其列上，Claude Code 等待程序然後附加。在此版本之前，如果您在程序仍在啟動時按 `Enter`，Claude Code 可能會停止工作階段，出現 [`Session <id> was stopped while the respawn was in flight`](/docs/zh-TW/errors#session-was-stopped-while-the-respawn-was-in-flight)。 |1131| v2.1.246 | 當您在剛分派的工作階段的工作程序仍在啟動時開啟它，例如在其列上按 `Enter`，Claude Code 會等待程序然後附加。在此版本之前，如果您在程序仍在啟動時按 `Enter`，Claude Code 可能會停止工作階段，出現 [`Session <id> was stopped while the respawn was in flight`](/docs/zh-TW/errors#session-was-stopped-while-the-respawn-was-in-flight)。 |
1129| v2.1.246 | 當您[背景化](#from-inside-a-session)命名的工作階段時，Claude Code 列出它一次，當您再次背景化相同的對話時，它對新列的名稱進行編號，例如 `my-session (2)`，現有列保留其名稱。在此版本之前，您按 `←` 的終端可能在 `claude agents --json` 中作為同一名稱下的第二個工作階段出現，如果您再次背景化相同的對話，Claude Code 在相同名稱下新增另一列。 |1132| v2.1.246 | 當您[背景化](#from-inside-a-session)已命名的工作階段時，Claude Code 只會列出它一次，而當您再次背景化相同的對話時，它會為新列的名稱編號，例如 `my-session (2)`，現有列則保留其名稱。在此版本之前，您按下 `←` 的終端機可能會在 `claude agents --json` 中以相同名稱作為第二個工作階段出現，如果您再次背景化相同的對話，Claude Code 會以完全相同的名稱新增另一列。 |
1130| v2.1.239 | 使用 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode)開啟，在 agent view 的輸入中按 `Esc` 從 INSERT 切換到 NORMAL 模式並保留您的文字，符合主提示；在 NORMAL 模式下，輸入中仍有文字，按 `Esc` 清除它，在空輸入上按 `Esc` 退出，如 [`Esc` 快捷鍵](#keyboard-shortcuts)描述。在此版本之前，`Esc` 清除輸入。 |1133| v2.1.239 | 開啟 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode)時，在 agent view 的輸入中按 `Esc` 會從 INSERT 切換到 NORMAL 模式並保留您的文字，與主要提示詞輸入一致；在 NORMAL 模式下輸入中仍有文字時，按 `Esc` 會清除它，在空輸入上按 `Esc` 則會退出，如 [`Esc` 快捷鍵](#keyboard-shortcuts)所述。在此版本之前，`Esc` 會清除輸入。 |
1131| v2.1.233 | 對於連結到 GitLab 合併請求的工作階段，Claude Code 以 GitLab 的 `!1234` 參考語法寫入列的標籤。您也可以將合併請求的 URL 貼到[分派輸入](#filter-sessions)中以選擇該工作階段。在此版本之前，標籤呈現為 `#1234`，貼上的合併請求 URL 只在其第一個提示包含 URL 時符合工作階段。 |1134| v2.1.233 | 對於連結到 GitLab merge request 的工作階段，Claude Code 會以 GitLab 的 `!1234` 參考語法寫入該列的標籤。您也可以將 merge request 的 URL 貼到[分派輸入](#filter-sessions)中以選取該工作階段。在此版本之前，標籤呈現為 `#1234`，而貼上的 merge request URL 只有在工作階段的第一個提示詞包含該 URL 時才會符合。 |
1132| v2.1.227 | [刪除工作階段](#what-deleting-a-session-removes)在另一個活躍 Claude Code 工作階段在該 worktree 目錄內執行時保留工作階段及其 worktree。Agent view 在列上顯示 `not deleted` 及頁尾中的原因，`claude rm` 列印 `kept <id>` 及原因，命名其他工作階段的程序 ID。在此版本之前，刪除工作階段在其他工作階段仍在其中工作時移除 worktree。 |1135| v2.1.227 | 當另一個執行中的 Claude Code 工作階段正在該 worktree 目錄內執行時，[刪除工作階段](#what-deleting-a-session-removes)會保留工作階段及其 worktree。Agent view 會在列上顯示 `not deleted` 並在頁尾顯示原因，`claude rm` 會列印 `kept <id>` 及原因，其中會指出另一個工作階段的程序 ID。在此版本之前，刪除工作階段會在另一個工作階段仍在其中工作時移除 worktree。 |
1133| v2.1.225 | 您未信任的目錄中的 `claude agents` 顯示與 `claude` 在啟動時顯示的相同[工作區信任對話](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)，在 agent view 開啟前。接受會為該工作區保存信任；拒絕會在不開啟 agent view 的情況下退出。在此版本之前，`claude agents` 開啟而不詢問，所以您從它分派的工作階段在您從未被要求信任的目錄中執行。<br /><br />列按目錄分組，將滑鼠懸停在列上會突出顯示它，而不改變[分派目標](#dispatch-to-a-specific-directory)；使用箭頭鍵或點擊選擇列仍會改變目標。在此版本之前，將滑鼠移到另一個專案中的工作階段會無聲地改變下一個分派的工作階段啟動的目錄。 |1136| v2.1.225 | 在您尚未信任的目錄中執行 `claude agents`，會在 agent view 開啟前顯示與 `claude` 啟動時相同的[工作區信任對話框](/docs/zh-TW/permissions#project-allow-rules-and-workspace-trust)。接受會儲存該工作區的信任；拒絕則會在不開啟 agent view 的情況下退出。在此版本之前，`claude agents` 會在不詢問的情況下開啟，所以您從它分派的工作階段會在您從未被要求信任的目錄中執行。<br /><br />當清單依目錄分組時，將滑鼠懸停在列上會醒目提示它，但不會改變[分派目標](#dispatch-to-a-specific-directory)；使用方向鍵或點擊選取列仍會改變目標。在此版本之前，將滑鼠移到另一個專案中的工作階段上，會在無提示的情況下改變下一個分派工作階段的啟動目錄。 |
1134| v2.1.221 | `/status` 顯示 `Session kind` 列：背景工作階段中的 `background job · attached` 或 `background job · unattended`，取決於是否附加了終端，以及任何其他工作階段中的 `interactive`。在此版本之前，`/status` 沒有報告工作階段種類。<br /><br />`/fork`：Claude Code 指示[副本](#from-inside-a-session)隔離其工作與原始工作階段的：副本在進行程式碼變更前建立自己的 worktree，遠離原始工作階段的 worktree，當其任務建立在該工作上時基於原始分支的新分支。請參閱連結的部分以了解確切條件。在此版本之前，副本沒有收到隔離指令，可能最終編輯原始工作階段仍在工作的 worktree 或簽出。<br /><br />使用 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode)開啟，在使用 `u` 撤銷提示回到空後立即按 `←` 會詢問與刪除文字或移動提示歷史相同的確認，並僅在第二次按下時切換；在此版本之前按下立即切換。 |1137| v2.1.221 | `/status` 會顯示 `Session kind` 列：在背景工作階段中視是否附加了終端機而顯示 `background job · attached` 或 `background job · unattended`，在任何其他工作階段中則顯示 `interactive`。在此版本之前，`/status` 不會回報工作階段種類。<br /><br />`/fork`：Claude Code 會指示[副本](#from-inside-a-session)將其工作與原始工作階段的工作隔離：副本在進行程式碼變更前會建立自己的 worktree，避開原始工作階段的 worktree，且當其任務建立在該工作之上時，會以原始工作階段的分支為基礎建立新分支。請參閱連結的章節以了解確切條件。在此版本之前，副本不會收到隔離指令，可能最終編輯原始工作階段仍在使用的 worktree 或簽出。<br /><br />開啟 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode)時，使用 `u` 將提示詞復原為空白後立即按 `←`，會要求與刪除文字或瀏覽提示詞歷史相同的確認，並僅在第二次按下時切換；在此版本之前，按下會立即切換。 |
1135| v2.1.219 | 使用 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode)開啟，在空提示上按 `←` 從 NORMAL 模式以及 INSERT 開啟 agent view，頁尾的 `←` 提示在 NORMAL 模式中顯示；在此版本之前手勢和提示是 INSERT 專用的，在 NORMAL 模式中空提示上的 `←` 不執行任何操作。在 Claude Code 等待背景化工作階段時輸入輸入會取消切換，出現 `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` 所以輸入的草稿不會遺失。 |1138| v2.1.219 | 開啟 [vim 編輯器模式](/docs/zh-TW/interactive-mode#vim-editor-mode)時，在空提示詞上按 `←` 在 NORMAL 模式和 INSERT 模式下都會開啟 agent view，且頁尾的 `←` 提示會在 NORMAL 模式中顯示；在此版本之前，此手勢和提示僅限 INSERT 模式，在 NORMAL 模式中空提示詞上的 `←` 不會有任何作用。在 Claude Code 等待背景化工作階段時於輸入中打字，會以 `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` 取消切換，讓輸入的草稿不會遺失。 |
1136| v2.1.218 | 在清空提示的刪除後兩秒內或移動提示歷史後按 `←` 顯示 `Press ← again to open agents`，或在附加的工作階段中 `Press ← again to go back to agents`，並僅在至少一秒後的第二次按下時切換；在此版本之前按下立即切換。到達貼上或指令碼輸入內的 `←` 不再觸發切換。使用 `←` 背景化前景工作階段在列上方顯示 `Your conversation moved to the background`，`Esc` 在 agent view 的根部返回該對話，而不是退出到 shell，雙 `Ctrl+C` 保持退出；如果對話無法重新開啟，Claude Code 退出並列印 `claude --resume` 命令。在 Windows 上，在附加後約半秒內按下的 `←` 顯示 `Ambiguous ←, press again to detach` 並在第二次按下時分離。 |1139| v2.1.218 | 在清空提示詞的刪除後兩秒內，或在瀏覽提示詞歷史後兩秒內按 `←`，會顯示 `Press ← again to open agents`，或在附加的工作階段中顯示 `Press ← again to go back to agents`，並僅在至少一秒後的第二次按下時切換；在此版本之前，按下會立即切換。出現在貼上或指令碼輸入內的 `←` 不再觸發切換。使用 `←` 背景化前景工作階段會在清單上方顯示 `Your conversation moved to the background`，在 agent view 根層級按 `Esc` 會返回該對話，而不是退出到 shell，雙按 `Ctrl+C` 仍為退出方式；如果對話無法重新開啟，Claude Code 會退出並為其列印 `claude --resume` 命令。在 Windows 上，在附加後約半秒內按下的 `←` 會顯示 `Ambiguous ←, press again to detach`，並在第二次按下時分離。 |
1137| v2.1.217 | 工作階段列上的拉取請求徽章呈現為超連結，即使 Claude Code 無法偵測終端超連結支援，例如透過 SSH 或 tmux；設定 [`FORCE_HYPERLINK=0`](/docs/zh-TW/env-vars) 以將其呈現為純文字。在此版本之前，未偵測到支援時徽章呈現為純文字。 |1140| v2.1.217 | 工作階段列上的 pull request 徽章即使在 Claude Code 無法偵測終端機超連結支援時（例如透過 SSH 或 tmux）也會呈現為超連結；設定 [`FORCE_HYPERLINK=0`](/docs/zh-TW/env-vars) 可將其呈現為純文字。在此版本之前，未偵測到支援時徽章會呈現為純文字。 |
1138| v2.1.216 | `/fork`：[確認](#from-inside-a-session)是一行，顯示副本的狀態、其 agent view 列的名稱及其工作階段 ID 以供 `claude attach`，僅當副本在主工作樹中執行或編輯您開啟的簽出時以 `runs in the origin tree` 或 `edits this checkout` 結尾。點擊名稱會背景化此工作階段並在副本的工作階段中開啟 agent view。確認不再重述副本的繼承權限模式；較早版本列印多行確認，沒有可點擊的名稱。<br /><br />需要輸入：`/install-github-app` 和 `/mcp` 設定清單，在沒有人附加時執行，在 `Needs input` 下顯示工作階段，帶有命名命令的列，附加並重新執行命令會繼續；從 v2.1.208 到 v2.1.215 它們在該狀態下被直接拒絕。<br /><br />`--agent` 恢復：恢復或重新啟動[背景化 `--agent` 工作階段](#from-your-shell)會恢復代理的系統提示和工具限制，在工作階段自己的目錄中搜尋代理，當其工作區被信任時；代理不再存在的工作階段會繼續使用預設工具和系統提示，並以可見警告開啟，而不是無聲地還原為預設代理。<br /><br />`Ctrl+X`：按兩次會刪除工作階段，即使停止嘗試失敗，而不是失敗的停止取消待決刪除，已刪除的工作階段，其工作程序已死亡，不再在下一次重新整理時重新出現。<br /><br />Worktree 刪除：其 worktree 目錄不屬於任何 git 儲存庫的工作階段可以被刪除；在此版本之前，每次刪除這樣的工作階段的嘗試都被拒絕。已消失的目錄立即清除。Agent view 雙按移除仍有檔案的目錄，為 hook 建立的目錄執行您的 `WorktreeRemove` hook，除非另一個工作階段的記錄也命名它。`claude rm` 只要檔案仍然存在就保留這樣的目錄。 |1141| v2.1.216 | `/fork`：[確認訊息](#from-inside-a-session)為一行，顯示副本的狀態、其 agent view 列的名稱及供 `claude attach` 使用的工作階段 ID，僅當副本在主要工作樹中執行或編輯您開啟的簽出時，才會以 `runs in the origin tree` 或 `edits this checkout` 結尾。點擊名稱會背景化此工作階段，並在副本的工作階段中開啟 agent view。確認訊息不再重述副本繼承的權限模式；較早版本會列印多行確認訊息，且沒有可點擊的名稱。<br /><br />需要輸入：在沒有人附加時執行的 `/install-github-app` 和 `/mcp` 設定清單，會將工作階段顯示在 `Needs input` 下，並以一列指出該命令，附加並重新執行命令即可繼續；從 v2.1.208 到 v2.1.215，它們在該狀態下會被直接拒絕。<br /><br />`--agent` 還原：當工作區受信任時，恢復或重新啟動[背景化的 `--agent` 工作階段](#from-your-shell)會還原 agent 的系統提示詞和工具限制，並優先在工作階段自己的目錄中搜尋該 agent；其 agent 已不存在的工作階段會以預設工具和系統提示詞繼續，並在開啟時顯示可見的警告，而不是在無提示的情況下還原為預設 agent。<br /><br />`Ctrl+X`：按兩次會刪除工作階段，即使停止嘗試失敗，而不是讓失敗的停止取消待決的刪除，且工作程序已終止的已刪除工作階段不再於下一次重新整理時重新出現。<br /><br />Worktree 刪除：worktree 目錄不屬於任何 git 儲存庫的工作階段可以被刪除；在此版本之前，每次刪除這類工作階段的嘗試都會被拒絕。已不存在的目錄會立即清除。Agent view 的雙按會移除仍有檔案的目錄，對於由 hook 建立的目錄會執行您的 `WorktreeRemove` hook，除非另一個工作階段的記錄也指向它。`claude rm` 只要檔案仍存在就會保留這類目錄。 |
1139| v2.1.214 | 使用 `←` 或 `/background` 背景化且閒置時沒有執行任何操作的工作階段會停止其程序，如同任何其他閒置工作階段，而不是保持其程序和背景服務無限期執行。已完成的工作階段可以在背景服務閒置後使用 `claude rm` 或從 agent view 移除，進入 worktree 的工作階段在從不是 git 儲存庫的目錄分派後，例如多儲存庫工作區資料夾，當 worktree 本身屬於 git 儲存庫時可以從 agent view 刪除，因為清理是從 worktree 而不是分派工作階段的目錄解決的；兩次移除在之前的每次嘗試都被拒絕。重新開啟已停止的工作階段會恢復其已保存的對話，即使記錄存儲中的資料夾無法讀取。 |1142| v2.1.214 | 使用 `←` 或 `/background` 背景化、且閒置時沒有任何執行中項目的工作階段，會像任何其他閒置工作階段一樣停止其程序，而不是讓其程序和背景服務無限期執行。已完成的工作階段可在背景服務閒置後使用 `claude rm` 或從 agent view 移除，而從非 git 儲存庫目錄（例如多儲存庫工作區資料夾）分派後進入 worktree 的工作階段，當 worktree 本身屬於 git 儲存庫時，可以從 agent view 刪除，因為清理是從 worktree 而不是從分派工作階段的目錄解析的；這兩種移除在之前的每次嘗試都會被拒絕。重新開啟已停止的工作階段會還原其已儲存的對話，即使逐字稿儲存區中的某個資料夾無法讀取。 |
1140| v2.1.213 | `/install-github-app`、[`/mcp`](/docs/zh-TW/mcp) 設定清單和 MCP 驗證動作在附加終端時在背景工作階段中工作，僅當沒有人附加時被拒絕，帶有告訴您附加並再次執行命令的訊息；從 v2.1.208 到 v2.1.212 即使附加了終端也被拒絕。 |1143| v2.1.213 | `/install-github-app`、[`/mcp`](/docs/zh-TW/mcp) 設定清單和 MCP 身分驗證動作在附加終端機時可在背景工作階段中運作，僅在沒有人附加時被拒絕，並顯示訊息告訴您附加後再次執行命令；從 v2.1.208 到 v2.1.212，即使附加了終端機也會被拒絕。 |
1141| v2.1.212 | [互動工作階段中的 `/fork`](#from-inside-a-session) 將對話複製到顯示為其自己列的新背景工作階段，以它來自的工作階段命名，或對於未命名工作階段的提示分支，以分支提示命名，而原始工作階段保持執行；`/fork` 的較早分支子代理行為移到 `/subtask`。使用[關閉 agent view](#turn-off-agent-view)，`/fork` 保持分支子代理行為。等待其第一個提示的焦點列顯示 `space to send it a prompt`。`Ctrl+J` 在具有擴展鍵報告的終端上在分派輸入中插入換行符，其中按鍵先前被忽略，`?` 覆蓋層列出快捷鍵。當背景工作階段完成且沒有任何需要您輸入時，互動工作階段中的 `←` 頁尾提示簡要顯示 `N done`。在 agent view 中輸入裸露的 `/resume` 會開啟您開啟 agent view 的儲存庫的過去工作階段的選擇器，包括從列表中刪除的工作階段，選擇一個會將其恢復為背景工作階段；在此版本之前 `/resume` 在 agent view 中不可用，已刪除的工作階段只能透過 `claude --resume` 或互動工作階段中的 `/resume` 到達。目標、範圍和受限形式保留較早版本為每個形式顯示的 `attach to a session to run it` 提示。等待沙箱網路主機提示、MCP 輸入請求或受管設定提示的工作階段在 agent view 和 `claude agents --json` 中顯示為 `Needs input` 而不是 `Working`，Claude 的問題報告 `waitingFor: input needed` 而不是 `permission prompt`。附加到其程序已停止的工作階段會顯示其記錄，格式化為活躍工作階段呈現的方式，而不是原始文字。已停止的工作階段，其記錄在意外位置，透過您已保存記錄的最後手段掃描恢復，開啟沒有已保存記錄的列顯示 `Press enter again to restart this session fresh`，在第二次按下時新鮮重新啟動；v2.1.211 顯示拒絕，沒有辦法從 agent view 重新啟動。 |1144| v2.1.212 | [互動工作階段中的 `/fork`](#from-inside-a-session) 會將對話複製到一個顯示為獨立列的新背景工作階段，以其來源工作階段命名，或對於未命名工作階段的帶提示詞分支，以分支提示詞命名，而原始工作階段會持續執行；`/fork` 較早的分支 subagent 行為已移到 `/subtask`。在[關閉 agent view](#turn-off-agent-view) 時，`/fork` 保持分支 subagent 行為。等待其第一個提示詞的焦點列會顯示 `space to send it a prompt`。在支援延伸按鍵回報的終端機上，`Ctrl+J` 會在分派輸入中插入換行（先前該按鍵會被忽略），`?` 覆蓋層會列出此快捷鍵。當背景工作階段完成且沒有任何工作階段需要您輸入時，互動工作階段中的 `←` 頁尾提示會短暫顯示 `N done`。在 agent view 中輸入不帶參數的 `/resume` 會開啟您開啟 agent view 所在儲存庫的過去工作階段選擇器，包括已從清單刪除的工作階段，選擇其中一個會將其恢復為背景工作階段；在此版本之前，`/resume` 在 agent view 中不可用，已刪除的工作階段只能透過 `claude --resume` 或互動工作階段中的 `/resume` 存取。指定目標、限定範圍和受限的形式會保留較早版本對所有形式都顯示的 `attach to a session to run it` 提示。等待沙箱網路主機提示、MCP 輸入請求或受管設定提示的工作階段，在 agent view 和 `claude agents --json` 中會顯示為 `Needs input` 而不是 `Working`，Claude 提出的問題會回報 `waitingFor: input needed` 而不是 `permission prompt`。附加到程序已停止的工作階段會以執行中工作階段的呈現方式顯示其逐字稿，而不是原始文字。逐字稿位於非預期位置的已停止工作階段，會透過對您已儲存逐字稿的最後手段掃描從中恢復，而開啟沒有已儲存逐字稿的列會顯示 `Press enter again to restart this session fresh`，並在第二次按下時重新全新啟動；v2.1.211 會顯示拒絕訊息，且無法從 agent view 重新啟動。 |
1142| v2.1.211 | 喚醒已停止的工作階段，透過附加或從其執行的目錄回覆，再次轉發您的 shell 的閘道 `ANTHROPIC_BASE_URL`，條件與新鮮分派相同，所以透過閘道 `ANTHROPIC_AUTH_TOKEN` 驗證的工作階段在閘道上恢復，而不是報告 `Not logged in`。附加到在另一個對話之前背景化的已停止工作階段，在其第一個回應完成前被拒絕，出現 `This session has no saved transcript` 而不是無聲地在相同工作階段 ID 下啟動空白對話；從 agent view 開啟相同列顯示頁尾中的拒絕。從 Claude Code 外部結束 `←` 或 `/background` 工作階段的程序會將其標記為已停止，而不是監督程序重新啟動它，已記錄在磁碟上的停止會被尊重，除非您傳送的回覆仍在等待傳遞，崩潰後重新啟動的工作階段被告知它已重新啟動，重新啟動的 `←` 或 `/background` 工作階段不會恢復超過約一小時的中斷回應。回答或拒絕提示而不是標籤的工作階段命名回覆，例如對於主要是連結的提示，會被丟棄，列保留從提示文字取得的名稱。其 worktree git 不再識別的工作階段刪除成功，在磁碟上留下 worktree 目錄並命名其路徑，而不是每次嘗試都被拒絕。拒絕的刪除在工作階段列上顯示原因，包括 worktree 無法移除時的基礎 git 錯誤，而不是列無聲地重新出現。 |1145| v2.1.211 | 透過附加或從其執行目錄回覆來喚醒已停止的工作階段時，會再次以與全新分派相同的條件轉發您 shell 的閘道 `ANTHROPIC_BASE_URL`，所以透過閘道 `ANTHROPIC_AUTH_TOKEN` 進行身分驗證的工作階段會在閘道上恢復，而不是回報 `Not logged in`。附加到在第一個回應完成前就從另一個對話背景化的已停止工作階段，會被拒絕並出現 `This session has no saved transcript`，而不是在無提示的情況下以相同工作階段 ID 啟動空白對話；從 agent view 開啟相同的列會在頁尾顯示拒絕訊息。從 Claude Code 外部結束 `←` 或 `/background` 工作階段的程序會將其標記為已停止，而不是讓監督程序重新啟動它；已記錄在磁碟上的停止會被遵守，除非您傳送的回覆仍在等待傳遞；當機後重新啟動的工作階段會被告知它已重新啟動；重新啟動的 `←` 或 `/background` 工作階段不會恢復超過約一小時前中斷的回應。回答或拒絕提示詞而不是為其加上標籤的工作階段命名回覆，例如對於主要是連結的提示詞，會被丟棄，該列會保留從提示詞文字取得的名稱。刪除其 worktree 已不被 git 識別的工作階段會成功，在磁碟上保留 worktree 目錄並指出其路徑，而不是每次嘗試都被拒絕。被拒絕的刪除會在工作階段列上顯示原因，包括 worktree 無法移除時的底層 git 錯誤，而不是讓該列在無提示的情況下重新出現。 |
1143| v2.1.210 | `claude attach` 在背景服務啟動或重新連接時等待，而不是失敗，出現 `job not found` 或 `still starting` 錯誤，報告在附加期間完成的工作階段為已退出，並應用在慢速附加期間進行的終端調整大小，當附加完成時。提示頁尾的 `←` 需要輸入計數出現在每個提供者上，包括先前顯示純 `← for agents` 形式的第三方提供者。使用 `←` 背景化工作階段會將 Claude 的任務清單帶到背景工作階段，而不是丟棄它。您按 `←` 的列在選擇移動後保留粗體、未變暗的名稱。`claude agents --effort` 接受 `ultracode` 而不是無聲地丟棄它。 |1146| v2.1.210 | `claude attach` 會在背景服務啟動或重新連線時等待，而不是以 `job not found` 或 `still starting` 錯誤失敗，會將在附加期間完成的工作階段回報為已退出，並在附加完成時套用緩慢附加期間進行的終端機大小調整。提示詞頁尾的 `←` 需要輸入計數會出現在每個提供者上，包括先前顯示純 `← for agents` 形式的第三方提供者。使用 `←` 背景化工作階段會將 Claude 的任務清單帶到背景工作階段，而不是丟棄它。您按下 `←` 時所在的列在選取移動後會保留粗體、未變暗的名稱。`claude agents --effort` 會接受 `ultracode`，而不是在無提示的情況下丟棄它。 |
1144| v2.1.208 | 附加到其程序已停止的工作階段會顯示其記錄的最後一屏，同時程序啟動，而不是只顯示 `Session is starting` 備註。無法傳遞的回覆（因為背景服務無法連線或傳送失敗）會被保存，並在其程序再次啟動時作為工作階段的下一個提示傳送；在此版本之前，背景服務無法連線時遺失的回覆會被丟棄。其自身二進位檔被更新取代的程序仍然可以啟動監督程序，從已安裝的 `claude` 啟動器或磁碟上的最新版本，而不是失敗直到 Claude Code 重新啟動。執行較舊版本的監督程序永遠不會將由較新版本啟動的閒置工作階段重新啟動到其自身較舊的二進位檔。刪除工作階段會移除其 worktree，即使工作階段將 worktree 移到不同的分支，並在 worktree 有未推送到任何地方的提交或另一個工作階段聲稱它時將 worktree 與工作階段列保持在一起，而不是銷毀提交或孤立 worktree。`/install-github-app` 和 `/mcp` 設定清單及其驗證動作在背景工作階段中被拒絕，並顯示命名替代方案的訊息；在 v2.1.208 中，`/model` 選擇器以相同方式被拒絕，輸入的 `/model <name>` 只切換該工作階段，而不是也保存您的預設模型。 |1147| v2.1.208 | 附加到程序已停止的工作階段時，會在程序啟動期間顯示其逐字稿的最後一個畫面，而不是只顯示 `Session is starting` 備註。因背景服務無法連線或傳送失敗而無法傳遞的回覆會被儲存，並在其程序再次啟動時作為工作階段的下一個提示詞傳送；在此版本之前，背景服務無法連線時遺失的回覆會被丟棄。自身二進位檔已被更新取代的程序，仍可從已安裝的 `claude` 啟動器或磁碟上的最新版本啟動監督程序，而不是在 Claude Code 重新啟動前持續失敗。執行較舊版本的監督程序永遠不會將由較新版本啟動的閒置工作階段重新啟動到其自身較舊的二進位檔上。刪除工作階段會移除其 worktree，即使工作階段已將 worktree 切換到不同的分支；而當 worktree 有未推送到任何地方的提交或另一個工作階段宣告擁有它時，會將 worktree 與工作階段列一起保留，而不是銷毀提交或讓 worktree 成為孤立狀態。`/install-github-app` 和 `/mcp` 設定清單及其身分驗證動作在背景工作階段中會被拒絕，並顯示指出替代方案的訊息；僅在 v2.1.208 中，`/model` 選擇器也以相同方式被拒絕，且輸入的 `/model <name>` 只會切換該工作階段，而不會同時儲存您的預設模型。 |
1145| v2.1.207 | 查看面板以列截斷的句子開啟，例如等待您的工作階段的確切問題，並顯示被阻止的工作階段已等待多長時間，作為單一 `waiting 3m` 行，而不是將相同的時間戳記前綴到狀態句子和問題。在分派輸入中再次貼上相同的文字會展開摺疊的 `[Pasted text #N]` 預留位置，而不是新增第二個。按名稱接受計畫的背景工作階段會在其列上顯示該名稱。移入 worktree 的背景工作階段在其程序從 agent view 重新啟動時會保留其對話。 |1148| v2.1.207 | 查看面板會以該列截斷的句子開啟，例如等待您的工作階段的確切問題，並以單行 `waiting 3m` 顯示被阻擋的工作階段已等待多久，而不是在狀態句子和問題前都加上相同的時間戳記。在分派輸入中再次貼上相同的文字會展開已摺疊的 `[Pasted text #N]` 預留位置，而不是新增第二個。透過接受計畫而命名的背景工作階段會在其列上顯示該名稱。已移入 worktree 的背景工作階段在其程序從 agent view 重新啟動時會保留其對話。 |
1146| v2.1.206 | 列摘要填充列的剩餘寬度，並僅在終端的右邊緣截斷，而不是在 64 欄處。監督程序重新啟動到新的 Claude Code 版本後，它會在背景中將剩餘的閒置背景工作階段重新啟動到該版本，而不是每分鐘幾個。使用 `Ctrl+X` 或 `claude rm` 刪除工作階段也會從監督程序的工作階段清單中清除它，因此列在監督程序重新啟動後不再重新出現。在分派 shell 中匯出的 `CLAUDE_CODE_EXTRA_BODY` 請求本體覆蓋到達背景工作階段，而不是被忽略。 |1149| v2.1.206 | 列摘要會填滿該列的剩餘寬度，並僅在終端機的右邊緣截斷，而不是在 64 欄處。監督程序重新啟動到新的 Claude Code 版本後，會在背景中將剩餘的閒置背景工作階段重新啟動到該版本，而不是每分鐘只處理幾個。使用 `Ctrl+X` 或 `claude rm` 刪除工作階段也會將其從監督程序的工作階段清單中清除，因此該列在監督程序重新啟動後不再重新出現。在分派 shell 中匯出的 `CLAUDE_CODE_EXTRA_BODY` 請求本體覆寫會傳遞到背景工作階段，而不是被忽略。 |
1147| v2.1.205 | 提示頁尾的 `←` 提示在常規 `claude` 工作階段中計算等待您的背景代理，例如 `← 2 agents`。列摘要顯示工作階段自己的單行報告，在 64 欄處截斷，而不是原始工具叫用或 `done/total` 計數；目錄分組列以彩色狀態字開啟。查看面板以完整狀態句子開啟，對於等待您的工作階段，其確切問題顯示在回覆輸入上方。編輯、評論、關閉或使用 `gh` 標記拉取請求為就緒的工作階段會連結到它，不僅是建立或簽出拉取請求的工作階段，推送會連結拉取請求，即使本機分支名稱不符，建立命令的輸出超過內聯限制的拉取請求也會連結。沒有可讀文字的轉向會保留工作階段的先前狀態，而不是將其翻轉回 `Working`。`claude attach` 會等待最多約 60 秒以重新啟動的工作階段，並顯示狀態行說明原因，而不是失敗。 |1150| v2.1.205 | 在一般 `claude` 工作階段中，提示詞頁尾的 `←` 提示會計算等待您的背景 agent 數量，例如 `← 2 agents`。列摘要會顯示工作階段自己的單行報告，在 64 欄處截斷，而不是原始工具呼叫或 `done/total` 計數；依目錄分組的列會以彩色狀態詞開頭。查看面板會以完整的狀態句子開啟，對於等待您的工作階段，其確切問題會顯示在回覆輸入上方。使用 `gh` 編輯、評論、關閉或將 pull request 標記為就緒的工作階段都會連結到該 pull request，而不只是建立或簽出 pull request 的工作階段；即使本機分支名稱不符，推送也會連結 pull request；建立命令的輸出超過內嵌限制的 pull request 也會被連結。沒有可讀文字的回合會保留工作階段的先前狀態，而不是將其切回 `Working`。`claude attach` 會為正在重新啟動的工作階段等待最多約 60 秒，並以狀態列說明原因，而不是失敗。 |
1148| v2.1.203 | 在分派 shell 中匯出的閘道 `ANTHROPIC_BASE_URL` 會到達從它分派的工作階段進入同一目錄，當監督程序共享該閘道環境時，而不是在保留隨之匯出的 API 金鑰時被丟棄。分派 shell 的 `PATH` 會套用到每個工作階段的工作程序。在子代理執行時按 `←` 會等待它們，而不是在十秒後重新啟動它們。空清單始終顯示區段標題，每個標題下方有描述。在分派輸入中輸入 `@` 也會列出啟動儲存庫的已註冊 git worktrees，這些 worktrees 位於其目錄樹內。從 `effortLevel` 設定繼承的努力會在稍後編輯該設定時跟隨，而不是在分派時固定。開啟其對話已在另一個執行中工作階段中開啟的已停止工作階段會被拒絕並顯示訊息，而不是使列失敗。在 agent view 中不可用的命令會在輸入中保留輸入的文字。在 git 儲存庫外失敗的 `WorktreeCreate` hook 不再阻止工作階段編輯檔案。 |1151| v2.1.203 | 當監督程序共用該閘道環境時，在分派 shell 中匯出的閘道 `ANTHROPIC_BASE_URL` 會傳遞到從該 shell 分派至同一目錄的工作階段，而不是在保留一同匯出的 API 金鑰時被丟棄。分派 shell 的 `PATH` 會套用到每個工作階段的工作程序。在 subagent 執行時按 `←` 會等待它們，而不是在十秒後重新啟動它們。空清單一律會顯示各區段標題，每個標題下方附有說明。在分派輸入中輸入 `@` 也會列出啟動儲存庫中位於其目錄樹內的已註冊 git worktree。從 `effortLevel` 設定繼承的 effort 會跟隨之後對該設定的編輯，而不是在分派時固定。開啟其對話已在另一個執行中工作階段開啟的已停止工作階段，會被拒絕並顯示訊息，而不是讓該列失敗。在 agent view 中不可用的命令會將已輸入的文字保留在輸入中。在 git 儲存庫外失敗的 `WorktreeCreate` hook 不再阻止工作階段編輯檔案。 |
1149| v2.1.202 | 使用 `/rename` 或 `Ctrl+R` 在背景工作階段上設定的名稱在監督程序停止並重新啟動其程序時會保留，而不是還原為工作階段分派時的名稱。 |1152| v2.1.202 | 在背景工作階段上使用 `/rename` 或 `Ctrl+R` 設定的名稱，在監督程序停止並重新啟動其程序時會保留，而不是還原為工作階段分派時的名稱。 |
1150| v2.1.200 | 較舊的 Claude Code 版本在 `roster.json` 中重寫工作階段清單時會保留較新版本寫入的欄位，符合現有的 `state.json` 保證，因此由較新版本啟動的工作階段在監督程序重新啟動後繼續接受輸入。當您開啟已停止回應的工作階段時，監督程序會重新啟動其程序，工作階段會從中斷的地方繼續中斷的回應。Agent view 應用放在 `agents` 後面的 `--plugin-dir` 旗標到其自己的子代理和技能自動完成，在分派輸入中以及分派的工作階段。 |1153| v2.1.200 | 較舊的 Claude Code 版本在重寫 `roster.json` 中的工作階段清單時，會保留較新版本寫入的欄位，與現有的 `state.json` 保證一致，因此由較新版本啟動的工作階段在監督程序重新啟動後會繼續接受輸入。當您開啟已停止回應的工作階段時，監督程序會重新啟動其程序，工作階段會從中斷處繼續被中斷的回應。Agent view 會將放在 `agents` 之後的 `--plugin-dir` 旗標套用到其分派輸入中自己的 subagent 和 skill 自動完成，以及分派的工作階段。 |
1151| v2.1.199 | 背景工作階段，其程序在低記憶體主機上完成啟動前退出，其列狀態會顯示 `possibly low memory — free some up and retry`，而不是只顯示裸露的退出原因。使用 `←` 或 `/background` 背景化工作階段會將其 `/color` 帶到新列。 |1154| v2.1.199 | 在低記憶體主機上，其程序在完成啟動前就退出的背景工作階段，會在其列狀態中顯示 `possibly low memory — free some up and retry`，而不是只顯示單純的退出原因。使用 `←` 或 `/background` 背景化工作階段會將其 `/color` 帶到新列。 |
1152| v2.1.198 | Agent view 在背景工作階段需要輸入、完成或失敗時透過 `preferredNotifChannel` 傳送通知，並使用 `agent_needs_input` 或 `agent_completed` 類型觸發 `Notification` hook。`←` 和 `/exit` 在 `claude attach <id>` 內返回 agent view 而不是退出到 shell；`Ctrl+Z` 返回到 shell。隔離其工作在 worktree 中的背景工作階段會提交、推送其自己的隔離分支（絕不是 `main` 或 `master`），並在完成時開啟草稿拉取請求，而不是先詢問。`/login` 在 agent view 中執行並開啟登入對話框。`Background work is running` 退出對話框提供 `Move to background and exit`。退出交付也涵蓋背景子代理，它們在下次喚醒時從其記錄恢復，而不是被報告為失敗。`claude --bg` 與 `-p` 或 `--print` 結合會被拒絕並出現錯誤。背景工作階段主機在首次 LAN 存取時要求 macOS 本機網路權限，而不是失敗，出現 `connect: no route to host`。 |1155| v2.1.198 | 當背景工作階段需要輸入、完成或失敗時，Agent view 會透過 `preferredNotifChannel` 傳送通知，並以 `agent_needs_input` 或 `agent_completed` 類型觸發 `Notification` hook。在 `claude attach <id>` 內的 `←` 和 `/exit` 會返回 agent view，而不是退出到 shell；`Ctrl+Z` 會返回 shell。在 worktree 中隔離其工作的背景工作階段完成時，會提交、推送其自己的隔離分支（絕不是 `main` 或 `master`），並開啟草稿 pull request，而不是先詢問。`/login` 可在 agent view 中執行並開啟登入對話框。`Background work is running` 退出對話框提供 `Move to background and exit`。退出交接也涵蓋背景 subagent，它們會在下次喚醒時從其逐字稿恢復，而不是被回報為失敗。`claude --bg` 與 `-p` 或 `--print` 合併使用會被拒絕並出現錯誤。背景工作階段主機會在首次存取 LAN 時請求 macOS 本機網路權限，而不是以 `connect: no route to host` 失敗。 |
1153| v2.1.196 | 單一 `←` 按下會背景化前景工作階段；較早的版本需要兩次按下，帶有頁尾提示和確認。傳遞給 `claude agents` 的 `--dangerously-skip-permissions` 會顯示繞過免責聲明，而不是被無聲地丟棄。您從未命名的互動工作階段在工作階段清單和 `claude agents --json` 中帶有預設名稱，例如 `my-app-3f`。背景 shell 命令和動態工作流程在工作階段的程序被停止、重新啟動或更新時存活，包括在 Windows 上；設定 `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` 以關閉交付。在重新啟動時誤讀為空的記錄會被重命名為 `.orphaned-` 後綴，而不是被刪除。 |1156| v2.1.196 | 按一次 `←` 即可背景化前景工作階段；較早的版本需要按兩次，並附有頁尾提示和確認。傳遞給 `claude agents` 的 `--dangerously-skip-permissions` 會顯示繞過免責聲明，而不是在無提示的情況下被丟棄。您從未命名的互動工作階段在工作階段清單和 `claude agents --json` 中會帶有預設名稱，例如 `my-app-3f`。背景 shell 命令和動態工作流程在工作階段的程序被停止、重新啟動或更新時仍會存續，包括在 Windows 上；設定 `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` 可關閉此交接。在重新啟動時被誤判為空的逐字稿會加上 `.orphaned-` 後綴重新命名，而不是被刪除。 |
1154| v2.1.195 | 進行中的工作在您背景化 Windows 上的工作階段時也會轉移；設定 `CLAUDE_DISABLE_ADOPT=1` 以改為停止它。`Completed` 組填充剩餘的垂直空間，標題在短終端上壓縮。較舊的 Claude Code 版本不再丟棄較新工作階段的 `state.json` 欄位或隱藏這些工作階段。附加到已停止的工作階段會立即切換，而不是顯示空白螢幕最多五秒。無法接受連接的監督程序會自行退出並釋放其鎖定。 |1157| v2.1.195 | 在 Windows 上背景化工作階段時，進行中的工作也會轉移；設定 `CLAUDE_DISABLE_ADOPT=1` 可改為停止它。`Completed` 群組會填滿剩餘的垂直空間，標題在較矮的終端機上會壓縮。較舊的 Claude Code 版本不再丟棄較新工作階段的 `state.json` 欄位，也不再從 `claude agents` 中隱藏這些工作階段。附加到已停止的工作階段會立即切換，而不是顯示空白畫面長達五秒。無法接受連線的監督程序會自行退出並釋放其鎖定。 |
1155| v2.1.191 | `claude --bg` 與不符合您任何子代理的 `--agent` 名稱失敗啟動：工作階段立即退出，出現 `--agent '<name>' not found` 錯誤，而不是使用預設代理執行。 |1158| v2.1.191 | `claude --bg` 搭配不符合您任何 subagent 的 `--agent` 名稱時會啟動失敗：工作階段會立即退出並出現 `--agent '<name>' not found` 錯誤，而不是以預設 agent 執行。 |
1156| v2.1.174 | 背景工作階段不再繼承閘道端點變數，例如來自監督程序啟動 shell 的 `ANTHROPIC_BASE_URL`；監督程序向預先準備的工作程序提供新的認證快照，修復虛假的 `Could not resolve authentication method` 錯誤。 |1159| v2.1.174 | 背景工作階段不再從監督程序的啟動 shell 繼承閘道端點變數，例如 `ANTHROPIC_BASE_URL`；監督程序會向預熱的工作程序提供新的憑證快照，修正了虛假的 `Could not resolve authentication method` 錯誤。 |
1157| v2.1.172 | 分派輸入中的 `/model` 設定工作階段範圍的分派模型覆蓋。 |1160| v2.1.172 | 分派輸入中的 `/model` 會設定工作階段範圍的分派模型覆寫。 |
1158| v2.1.161 | 列摘要顯示平行工作項目的 `done/total` 計數；查看面板命名最長執行的平行工作項目。 |1161| v2.1.161 | 列摘要會顯示平行工作項目的 `done/total` 計數；查看面板會指出執行最久的平行工作項目。 |
1159| v2.1.157 | `claude agents` 接受 `--agent`；分派的工作階段尊重 `agent` 設定。 |1162| v2.1.157 | `claude agents` 接受 `--agent`；分派的工作階段會遵循 `agent` 設定。 |
1160| v2.1.145 | 查看面板回覆輸入和分派輸入中支援語音聽寫。 |1163| v2.1.145 | 查看面板回覆輸入和分派輸入中支援語音聽寫。 |
1161| v2.1.143 | `worktree.bgIsolation` 設定新增；`claude agents` 接受 `--allow-dangerously-skip-permissions`。 |1164| v2.1.143 | 新增 `worktree.bgIsolation` 設定；`claude agents` 接受 `--allow-dangerously-skip-permissions`。 |
1162| v2.1.142 | `claude agents` 接受 `--permission-mode`、`--model`、`--effort`、`--dangerously-skip-permissions`、`--settings`、`--add-dir`、`--plugin-dir`、`--mcp-config` 和 `--strict-mcp-config`。 |1165| v2.1.142 | `claude agents` 接受 `--permission-mode`、`--model`、`--effort`、`--dangerously-skip-permissions`、`--settings`、`--add-dir`、`--plugin-dir`、`--mcp-config` 和 `--strict-mcp-config`。 |
1163| v2.1.141 | `claude agents` 接受 `--cwd` 以將清單範圍限定為一個專案。 |1166| v2.1.141 | `claude agents` 接受 `--cwd` 以將清單範圍限定為單一專案。 |
1164| v2.1.139 | Agent view 作為研究預覽版本引入。 |1167| v2.1.139 | Agent view 以研究預覽形式推出。 |
