Documentation — Spybara

admin-setup.md +3 −2

Details

174| 主題 | 需要了解的內容 | 從哪裡開始 |174| 主題 | 需要了解的內容 | 從哪裡開始 |

175| :- | :- | :- |175| :- | :- | :- |

178| HIPAA configuration | 適用於已啟用 HIPAA 的 Claude for Enterprise 組織。部分 Claude Code（本機模式）功能會被關閉，其他功能則預設為關閉 | [Set up Claude Code (local mode) for a HIPAA-ready organization](/docs/zh-TW/hipaa-setup) |

179 180

180如果您需要請求級別的稽核日誌記錄或按資料敏感性路由流量，請在開發人員和您的提供者之間放置自託管的 [Claude apps gateway](/docs/zh-TW/claude-apps-gateway)，它會記錄具有 IdP 身分的每個請求稽核日誌，或使用另一個 [LLM gateway](/docs/zh-TW/llm-gateway)。有關法規要求和認證，請參閱 [Legal and compliance](/docs/zh-TW/legal-and-compliance)。181如果您需要請求層級的稽核日誌記錄或依資料敏感性路由流量，我們建議您在開發人員和您的提供者之間放置閘道：自行託管的 [Claude apps gateway](/docs/zh-TW/claude-apps-gateway) 會記錄包含 IdP 身分的每個請求稽核日誌，或者您也可以使用另一個 [LLM gateway](/docs/zh-TW/llm-gateway)。透過閘道進行的工作階段不適用於 HIPAA 設定。[檢查開發人員如何登入和連線](/docs/zh-TW/hipaa-setup#check-how-developers-sign-in-and-connect)列出了適用的連線方式。有關法規要求和認證，請參閱 [Legal and compliance](/docs/zh-TW/legal-and-compliance)。

181 182

182<h2 id="verify-and-onboard">183<h2 id="verify-and-onboard">

183 驗證和上線184 驗證和上線

agent-sdk/claude-code-features.md +5 −5

Details

107 專案指令（CLAUDE.md 和規則）107 專案指令（CLAUDE.md 和規則）

108</h2>108</h2>

109 109

110`CLAUDE.md` 檔案和 `.claude/rules/*.md` 檔案為您的代理提供有關您的專案的持久上下文：編碼慣例、建置命令、架構決策和指令。當 `settingSources` 包含 `"project"`（如 [`settingSources` 範例](#control-filesystem-settings-with-settingsources)所示）時，SDK 在工作階段開始時將這些檔案載入到上下文中。代理隨後會遵循您的專案慣例，而無需在每個提示中重複它們。110`CLAUDE.md` 檔案和 `.claude/rules/*.md` 檔案為您的 agent 提供有關您的專案的持久上下文：編碼慣例、建置命令、架構決策和指令。當 `settingSources` 包含 `"project"`（如 [`settingSources` 範例](#control-filesystem-settings-with-settingsources)所示）時，SDK 在工作階段開始時將這些檔案載入到上下文中。agent 隨後會遵循您的專案慣例，而無需您在每個提示詞中重複它們。

111 111

112<h3 id="claude-md-load-locations">112<h3 id="claude-md-load-locations">

113 CLAUDE.md 載入位置113 CLAUDE.md 載入位置

119| 專案規則 | `<cwd>/.claude/rules/*.md` 和 `.claude/rules/*.md` 在每個父目錄中 | `settingSources` 包含 `"project"` |119| 專案規則 | `<cwd>/.claude/rules/*.md` 和 `.claude/rules/*.md` 在每個父目錄中 | `settingSources` 包含 `"project"` |

122| 本機 | `<cwd>/CLAUDE.local.md` 和 `CLAUDE.local.md` 在每個父目錄中 | `settingSources` 包含 `"local"` |122| 本機 | `<cwd>/CLAUDE.local.md` 和 `CLAUDE.local.md` 在每個父目錄中 | `settingSources` 包含 `"local"` |

123| 使用者 | `~/.claude/CLAUDE.md` | `settingSources` 包含 `"user"` |123| 使用者 | `~/.claude/CLAUDE.md` | `settingSources` 包含 `"user"` |

124| 使用者規則 | `~/.claude/rules/*.md` | `settingSources` 包含 `"user"` |124| 使用者規則 | `~/.claude/rules/*.md` | `settingSources` 包含 `"user"` |

125 125

126所有層級都是累加的：如果專案和使用者 CLAUDE.md 檔案都存在，代理會看到兩者。層級之間沒有硬性優先順序規則；如果指令衝突，結果取決於 Claude 如何解釋它們。編寫不衝突的規則，或在更具體的檔案中明確說明優先順序（「這些專案指令會覆蓋任何衝突的使用者層級預設值」）。126所有層級都是累加的：如果專案和使用者 CLAUDE.md 檔案都存在，agent 會看到兩者。層級之間沒有硬性優先順序規則；如果指令衝突，結果取決於 Claude 如何解釋它們。編寫不衝突的規則，或在更具體的檔案中明確說明優先順序（「這些專案指令會覆寫任何衝突的使用者層級預設值」）。

127 127

128<Tip>128<Tip>

129 您也可以透過 `systemPrompt` 直接注入上下文，而無需使用 CLAUDE.md 檔案。請參閱 [修改系統提示](/docs/zh-TW/agent-sdk/modifying-system-prompts)。當您想要在互動式 Claude Code 工作階段和 SDK 代理之間共享相同上下文時，請使用 CLAUDE.md。129 您也可以透過 `systemPrompt` 直接注入上下文，而無需使用 CLAUDE.md 檔案。請參閱 [修改系統提示詞](/docs/zh-TW/agent-sdk/modifying-system-prompts)。當您想要在互動式 Claude Code 工作階段和 SDK agent 之間共享相同上下文時，請使用 CLAUDE.md。

130</Tip>130</Tip>

131 131

132如需如何結構化和組織 CLAUDE.md 內容的資訊，請參閱 [管理 Claude 的記憶體](/docs/zh-TW/memory)。132如需如何結構化和組織 CLAUDE.md 內容的資訊，請參閱 [管理 Claude 的記憶](/docs/zh-TW/memory)。

133 133

134<h2 id="skills">134<h2 id="skills">

135 Skills135 Skills

agent-sdk/cost-tracking.md +4 −0

Details

10 10

11如需完整的 API 文件，請參閱 [TypeScript SDK 參考](/docs/zh-TW/agent-sdk/typescript)和 [Python SDK 參考](/docs/zh-TW/agent-sdk/python)。11如需完整的 API 文件，請參閱 [TypeScript SDK 參考](/docs/zh-TW/agent-sdk/typescript)和 [Python SDK 參考](/docs/zh-TW/agent-sdk/python)。

12 12

13<span id="estimates-not-billing" />

13<Warning>15<Warning>

14 `total_cost_usd` 和 `costUSD` 欄位是用戶端估計值，不是權威的計費資料。SDK 從在建置時捆綁的價格表在本機計算它們，除非有 [`modelPricing`](/docs/zh-TW/settings-reference#modelpricing) 表生效。當發生以下情況時，它們可能會與您實際被計費的金額不同：16 `total_cost_usd` 和 `costUSD` 欄位是用戶端估計值，不是權威的計費資料。SDK 從在建置時捆綁的價格表在本機計算它們，除非有 [`modelPricing`](/docs/zh-TW/settings-reference#modelpricing) 表生效。當發生以下情況時，它們可能會與您實際被計費的金額不同：

15 17

242* **獨立呼叫，沒有 `resume` 或 `continue` 選項**：每個結果只涵蓋其自己的呼叫，因此請自行加總，如下面的範例所示。244* **獨立呼叫，沒有 `resume` 或 `continue` 選項**：每個結果只涵蓋其自己的呼叫，因此請自行加總，如下面的範例所示。

243* **恢復相同工作階段的呼叫**：Claude Code 會在程序正常退出時將工作階段的總計儲存到其[文字記錄](/docs/zh-TW/sessions#where-transcripts-are-stored)，並在稍後的呼叫恢復或分叉工作階段時復原它們。每個結果已經包含工作階段的早期支出。讀取工作階段的最新結果以取得工作階段總計；加總結果會重複計算已復原的支出。在 v2.1.277 之前，您透過 SDK 或 `claude -p` 恢復的工作階段會將其總計從零開始，因此每個呼叫的結果只涵蓋該呼叫。245* **恢復相同工作階段的呼叫**：Claude Code 會在程序正常退出時將工作階段的總計儲存到其[文字記錄](/docs/zh-TW/sessions#where-transcripts-are-stored)，並在稍後的呼叫恢復或分叉工作階段時復原它們。每個結果已經包含工作階段的早期支出。讀取工作階段的最新結果以取得工作階段總計；加總結果會重複計算已復原的支出。在 v2.1.277 之前，您透過 SDK 或 `claude -p` 恢復的工作階段會將其總計從零開始，因此每個呼叫的結果只涵蓋該呼叫。

244 246

247無論哪種方式，合併後的數字仍然是[用戶端估算值](#estimates-not-billing)。

248

245在串流輸入模式中，如 [在串流輸入模式中追蹤成本](#track-costs-in-streaming-input-mode) 中所述讀取每個呼叫的總計。對於以當機結束的呼叫，請參閱 [在工作階段當機後復原總計](#recover-totals-after-a-session-crash)。249在串流輸入模式中，如 [在串流輸入模式中追蹤成本](#track-costs-in-streaming-input-mode) 中所述讀取每個呼叫的總計。對於以當機結束的呼叫，請參閱 [在工作階段當機後復原總計](#recover-totals-after-a-session-crash)。

246 250

247以下範例依序執行兩個 `query()` 呼叫，將每個呼叫的 `total_cost_usd` 加入執行中的總計，並列印每次呼叫和合併的成本：251以下範例依序執行兩個 `query()` 呼叫，將每個呼叫的 `total_cost_usd` 加入執行中的總計，並列印每次呼叫和合併的成本：

agent-sdk/custom-tools.md +78 −12

Details

15| 如果您想要... | 執行此操作 |15| 如果您想要... | 執行此操作 |

16| :- | :- |16| :- | :- |

17| 定義工具 | 使用 [`@tool`](/docs/zh-TW/agent-sdk/python#tool)（Python）或 [`tool()`](/docs/zh-TW/agent-sdk/typescript#tool)（TypeScript），搭配名稱、描述、結構描述和處理程式。請參閱[建立自訂工具](#create-a-custom-tool)。 |17| 定義工具 | 使用 [`@tool`](/docs/zh-TW/agent-sdk/python#tool)（Python）或 [`tool()`](/docs/zh-TW/agent-sdk/typescript#tool)（TypeScript），搭配名稱、描述、結構描述和處理程式。請參閱[建立自訂工具](#create-a-custom-tool)。 |

18| 將參數設為選用 | 在 schema 中將其宣告為選用，並在處理程式中套用預設值。請參閱[將參數設為選用](#make-a-parameter-optional)。 |

18| 向 Claude 註冊工具 | 在 `create_sdk_mcp_server` / `createSdkMcpServer` 中包裝，並傳遞至 `query()` 中的 `mcpServers`。請參閱[呼叫自訂工具](#call-a-custom-tool)。 |19| 向 Claude 註冊工具 | 在 `create_sdk_mcp_server` / `createSdkMcpServer` 中包裝，並傳遞至 `query()` 中的 `mcpServers`。請參閱[呼叫自訂工具](#call-a-custom-tool)。 |

19| 預先核准工具 | 新增至您允許的工具。請參閱[設定允許的工具](#configure-allowed-tools)。 |20| 預先核准工具 | 新增至您允許的工具。請參閱[設定允許的工具](#configure-allowed-tools)。 |

20| 從 Claude 的內容中移除內建工具 | 傳遞 `tools` 陣列，僅列出您想要的內建工具。請參閱[設定允許的工具](#configure-allowed-tools)。 |21| 從 Claude 的內容中移除內建工具 | 傳遞 `tools` 陣列，僅列出您想要的內建工具。請參閱[設定允許的工具](#configure-allowed-tools)。 |

32 33

33* **名稱：** Claude 用來呼叫工具的唯一識別碼。34* **名稱：** Claude 用來呼叫工具的唯一識別碼。

34* **描述：** 工具的功能。Claude 讀取此項以決定何時呼叫它。35* **描述：** 工具的功能。Claude 讀取此項以決定何時呼叫它。

35* **輸入綱要：** Claude 必須提供的引數。在 TypeScript 中，這始終是 [Zod 綱要](https://zod.dev/)，處理程式的 `args` 會自動從中輸入。在 Python 中，這是將名稱對應到類型的字典，例如 `{"latitude": float}`，SDK 會為您將其轉換為 JSON 綱要。Python 裝飾器也接受完整的 [JSON 綱要](https://json-schema.org/understanding-json-schema/about)字典，當您需要列舉、範圍、選用欄位或巢狀物件時。36* **輸入 schema：** 工具接受的引數，依語言宣告：

37 * **TypeScript**：[Zod schema](https://zod.dev/)。處理程式的 `args` 會從中取得其類型。在欄位上呼叫 `.describe()`，即可為其提供 Claude 看得到的描述。

38 * **Python**：將名稱對應到類型的字典，例如 `{"latitude": float}`，SDK 會為您將其轉換為 JSON Schema。將類型包裝在 `Annotated` 中，例如 `{"latitude": Annotated[float, "Latitude coordinate"]}`，即可為欄位提供 Claude 看得到的描述。當您需要列舉、範圍、選用欄位或巢狀物件時，裝飾器也可直接接受完整的 [JSON Schema](https://json-schema.org/understanding-json-schema/about) 字典。

36* **處理程式：** Claude 呼叫工具時執行的非同步函式。它接收已驗證的引數，並且必須傳回包含以下內容的物件：39* **處理程式：** Claude 呼叫工具時執行的非同步函式。它接收已驗證的引數，並且必須傳回包含以下內容的物件：

37 * `content`（必需）：結果區塊的陣列，每個區塊的 `type` 為 `"text"`、`"image"`、`"audio"`、`"resource"` 或 `"resource_link"`。請參閱[傳回影像和資源](#return-images-and-resources)以了解非文字區塊。40 * `content`（必需）：結果區塊的陣列，每個區塊的 `type` 為 `"text"`、`"image"`、`"audio"`、`"resource"` 或 `"resource_link"`。請參閱[傳回影像和資源](#return-images-and-resources)以了解非文字區塊。

38 * `structuredContent`（選用）：保存結果作為機器可讀資料的 JSON 物件，與 `content` 一起傳回。請參閱[傳回結構化資料](#return-structured-data)。41 * `structuredContent`（選用）：保存結果作為機器可讀資料的 JSON 物件，與 `content` 一起傳回。請參閱[傳回結構化資料](#return-structured-data)。

40 43

41定義工具後，使用 [`createSdkMcpServer`](/docs/zh-TW/agent-sdk/typescript#createsdkmcpserver)（TypeScript）或 [`create_sdk_mcp_server`](/docs/zh-TW/agent-sdk/python#create_sdk_mcp_server)（Python）將其包裝在伺服器中。伺服器在應用程式內部以同步程序執行，而不是作為單獨的程序。44定義工具後，使用 [`createSdkMcpServer`](/docs/zh-TW/agent-sdk/typescript#createsdkmcpserver)（TypeScript）或 [`create_sdk_mcp_server`](/docs/zh-TW/agent-sdk/python#create_sdk_mcp_server)（Python）將其包裝在伺服器中。伺服器在應用程式內部以同步程序執行，而不是作為單獨的程序。

42 45

46本頁中發出 HTTP 請求的 Python 範例使用 [httpx](https://www.python-httpx.org/)。請使用專案所用的套件管理工具新增它：

48<Tabs>

49 <Tab title="Python (uv)">

50 ```bash theme={null}

51 uv add httpx

52 ```

53 </Tab>

55 <Tab title="Python (pip)">

56 ```bash theme={null}

57 pip install httpx

58 ```

59 </Tab>

60</Tabs>

43<h3 id="weather-tool-example">62<h3 id="weather-tool-example">

44 天氣工具範例63 天氣工具範例

45</h3>64</h3>

46 65

47此範例定義 `get_temperature` 工具並將其包裝在 MCP 伺服器中。它只設定工具；若要將其傳遞給 `query` 並執行它，請參閱下面的[呼叫自訂工具](#call-a-custom-tool)。66此範例定義 `get_temperature` 工具並將其包裝在 MCP 伺服器中，但不將伺服器傳遞給 `query`。若要執行工具，請參閱下面的[呼叫自訂工具](#call-a-custom-tool)。

48 67

49<CodeGroup>68<CodeGroup>

50 ```python Python theme={null}69 ```python Python theme={null}

~~51 from typing import Any~~70 from typing import Annotated, Any

52 import httpx71 import httpx

53 from claude_agent_sdk import tool, create_sdk_mcp_server72 from claude_agent_sdk import tool, create_sdk_mcp_server

54 73

57 @tool(76 @tool(

58 "get_temperature",77 "get_temperature",

59 "Get the current temperature at a location",78 "Get the current temperature at a location",

~~60 {"latitude": float, "longitude": float},~~79 {

80 "latitude": Annotated[float, "Latitude coordinate"],

81 "longitude": Annotated[float, "Longitude coordinate"],

82 },

61 )83 )

62 async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:84 async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:

63 async with httpx.AsyncClient() as client:85 async with httpx.AsyncClient() as client:

128 150

129請參閱 [`tool()`](/docs/zh-TW/agent-sdk/typescript#tool) TypeScript 參考或 [`@tool`](/docs/zh-TW/agent-sdk/python#tool) Python 參考以取得完整的參數詳細資訊，包括 JSON 綱要輸入格式和傳回值結構。151請參閱 [`tool()`](/docs/zh-TW/agent-sdk/typescript#tool) TypeScript 參考或 [`@tool`](/docs/zh-TW/agent-sdk/python#tool) Python 參考以取得完整的參數詳細資訊，包括 JSON 綱要輸入格式和傳回值結構。

130 152

131<Tip>153<h3 id="make-a-parameter-optional">

132 若要使參數成為選用：在 TypeScript 中，將 `.optional()` 新增至 Zod 欄位，並在處理程式中套用預設值。在 Python 中，字典綱要將每個鍵視為必需，因此請將參數留出綱要，在描述字串中提及它，並在處理程式中使用 `args.get()` 讀取它。下面的 [`get_precipitation_chance` 工具](#add-more-tools)顯示兩種模式。154 將參數設為選用

133</Tip>155</h3>

156

157若要將參數設為選用，請在 schema 中將其宣告為選用，並在處理程式中套用預設值：

158

159* **TypeScript**：將 `.optional()` 新增至 Zod 欄位。

160* **Python**：字典 schema 要求每個鍵都必須提供。請使用 JSON Schema 形式，將該參數排除在 `required` 之外，並使用 `args.get()` 讀取它。若要使用具有選用鍵的型別化 schema，請參閱 [TypedDict 類別](/docs/zh-TW/agent-sdk/python#input-schema-options)。

161

162[下面的 `get_precipitation_chance` 工具](#add-more-tools)顯示兩種模式。

134 163

135<h3 id="call-a-custom-tool">164<h3 id="call-a-custom-tool">

136 呼叫自訂工具165 呼叫自訂工具

182 ```211 ```

183</CodeGroup>212</CodeGroup>

184 213

185將此程式碼片段與[天氣工具範例](#weather-tool-example)中的工具和伺服器定義結合在一個檔案中，然後使用 `python weather.py`（Python）或 `npx tsx weather.ts`（TypeScript）執行它。Claude 呼叫 `get_temperature`，指令碼會列印一行答案，顯示舊金山目前的溫度。214將此程式碼片段與[天氣工具範例](#weather-tool-example)中的工具和伺服器定義結合在一個檔案 `weather.py` 或 `weather.ts` 中，然後從終端機執行它：

215

216<Tabs>

217 <Tab title="TypeScript">

218 ```bash theme={null}

219 npx tsx weather.ts

220 ```

221 </Tab>

222

223 <Tab title="Python (uv)">

224 ```bash theme={null}

225 uv run weather.py

226 ```

227 </Tab>

228

229 <Tab title="Python (pip)">

230 啟用您安裝 SDK 的虛擬環境，然後執行：

231

232 ```bash theme={null}

233 python weather.py

234 ```

235 </Tab>

236</Tabs>

237

238Claude 呼叫 `get_temperature`，指令碼會列印一行答案，顯示舊金山目前的溫度。

186 239

187<h3 id="add-more-tools">240<h3 id="add-more-tools">

188 新增更多工具241 新增更多工具

197 # Define a second tool for the same server250 # Define a second tool for the same server

198 @tool(251 @tool(

199 "get_precipitation_chance",252 "get_precipitation_chance",

200 "Get the hourly precipitation probability for a location. "253 "Get the hourly precipitation probability for a location",

201 "Optionally pass 'hours' (1-24) to control how many hours to return.",254 {

202 {"latitude": float, "longitude": float},255 "type": "object",

256 "properties": {

257 "latitude": {"type": "number"},

258 "longitude": {"type": "number"},

259 "hours": {

260 "type": "integer",

261 "minimum": 1,

262 "maximum": 24,

263 "description": "How many hours of forecast to return",

264 },

265 },

266 # 'hours' is left out of required, so Claude can omit it

267 "required": ["latitude", "longitude"],

268 },

203 )269 )

204 async def get_precipitation_chance(args: dict[str, Any]) -> dict[str, Any]:270 async def get_precipitation_chance(args: dict[str, Any]) -> dict[str, Any]:

205 # 'hours' isn't in the schema - read it with .get() to make it optional271 # 'hours' isn't in required - read it with .get() to fall back to a default

206 hours = args.get("hours", 12)272 hours = args.get("hours", 12)

207 async with httpx.AsyncClient() as client:273 async with httpx.AsyncClient() as client:

208 response = await client.get(274 response = await client.get(

agent-sdk/migration-guide.md +1 −1

Details

10 概述10 概述

11</h2>11</h2>

12 12

~~13Claude Code SDK 已重新命名為 **Claude Agent SDK**，其文件已重新組織。此變更反映了該 SDK 在建構 AI 代理程式方面的更廣泛功能，不僅限於編碼任務。~~13Claude Code SDK 已重新命名為 **Claude Agent SDK**，其文件已重新組織。此變更反映了該 SDK 在建構 AI agent 方面的更廣泛功能，不僅限於編碼任務。

14 14

15從 OpenAI Agents SDK 遷移？[OpenAI Agents SDK 遷移配方](https://platform.claude.com/cookbook/claude-agent-sdk-04-migrating-from-openai-agents-sdk)透過單一實作範例將每個原始元素對應到 Claude Agent SDK。15從 OpenAI Agents SDK 遷移？[OpenAI Agents SDK 遷移配方](https://platform.claude.com/cookbook/claude-agent-sdk-04-migrating-from-openai-agents-sdk)透過單一實作範例將每個原始元素對應到 Claude Agent SDK。

16 16

agent-sdk/python.md +26 −1

Details

147 }147 }

148 ```148 ```

149 149

1503. **TypedDict 類別**：一種具類型的 schema，其中 `NotRequired` 鍵不會列入 `required`。

151

152 * **Python 3.11 及更新版本**：從 `typing` 匯入 `TypedDict` 和 `NotRequired`。

153 * **Python 3.10**：`typing` 沒有 `NotRequired`。請從 `typing_extensions` 匯入 `TypedDict` 和 `NotRequired`，SDK 會在 Python 3.10 上安裝此套件。

154

155 ```python theme={null}

156 from typing import Annotated, Any, NotRequired, TypedDict

157 from claude_agent_sdk import tool

158

159

160 class ForecastArgs(TypedDict):

161 latitude: Annotated[float, "Latitude coordinate"]

162 hours: NotRequired[Annotated[int, "How many hours of forecast to return"]]

163

164

165 @tool("get_forecast", "Get the hourly forecast for a location", ForecastArgs)

166 async def get_forecast(args: dict[str, Any]) -> dict[str, Any]:

167 hours = args.get("hours", 12)

168 return {"content": [{"type": "text", "text": f"{hours}-hour forecast for {args['latitude']}"}]}

169 ```

170

171在簡單對應和 TypedDict 形式中，將類型包裝在 `Annotated[type, "description"]` 中即可設定該欄位的描述。

172

150<h4 id="returns-2">173<h4 id="returns-2">

151 返回174 返回

152</h4>175</h4>

1781 data: dict[str, Any]1804 data: dict[str, Any]

1782```1805```

1783 1806

1807沒有專屬 dataclass 的 subtype 會以 `SystemMessage` 的形式送達。若要在回合之間追蹤工作階段，請設定 [`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`](/docs/zh-TW/env-vars#variables)，並在每則 `subtype` 為 `session_state_changed` 的消息上讀取 `message.data["state"]`。[`SDKSessionStateChangedMessage`](/docs/zh-TW/agent-sdk/typescript#sdksessionstatechangedmessage) 列出它可能攜帶的狀態。請使用 `receive_messages()` 進行迭代以讀取這些消息：`receive_response()` 會在 `ResultMessage` 處停止，而 `session_state_changed` 消息可能出現在該結果之後。

1808

1784<h3 id="resultmessage">1809<h3 id="resultmessage">

1785 `ResultMessage`1810 `ResultMessage`

1786</h3>1811</h3>

2267 2292

2268參數：2293參數：

2269 2294

2270* `input`：強類型 hook 輸入，具有基於 `hook_event_name` 的判別聯合（見 [`HookInput`](#hookinput)）2295* `input`：強類型 hook 輸入，具有基於 `hook_event_name` 的判別聯合（請參閱 [`HookInput`](#hookinput)）

2271* `tool_use_id`：可選 tool 使用識別碼（用於 tool 相關 hooks）2296* `tool_use_id`：可選 tool 使用識別碼（用於 tool 相關 hooks）

2272* `context`：具有其他資訊的 hook 上下文2297* `context`：具有其他資訊的 hook 上下文

2273 2298

agent-sdk/quickstart.md +1 −1

Details

130 如需詳細資訊，請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[AWS 上的 Claude Platform](/docs/zh-TW/claude-platform-on-aws)、[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 的設定指南。130 如需詳細資訊，請參閱 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[AWS 上的 Claude Platform](/docs/zh-TW/claude-platform-on-aws)、[Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 的設定指南。

131 131

132 <Note>132 <Note>

133 除非事先獲得批准，否則 Anthropic 不允許第三方開發人員為其產品（包括基於 Claude Agent SDK 建立的代理程式）提供 claude.ai 登入或速率限制。請改用本文件中描述的 API 金鑰驗證方法。133 除非事先獲得批准，否則 Anthropic 不允許第三方開發人員為其產品（包括基於 Claude Agent SDK 建立的 agent）提供 claude.ai 登入或速率限制。請改用本文件中描述的 API 金鑰驗證方法。

134 </Note>134 </Note>

135 </Step>135 </Step>

136</Steps>136</Steps>

agent-sdk/secure-deployment.md +1 −1

Details

317 317

318此方法處理任何基於 HTTP 的服務，而無需編寫自訂工具，但增加了圍繞憑證管理的複雜性。318此方法處理任何基於 HTTP 的服務，而無需編寫自訂工具，但增加了圍繞憑證管理的複雜性。

319 319

320請注意，並非所有程式都尊重 `HTTP_PROXY`/`HTTPS_PROXY`。大多數工具（curl、pip、npm、git）都這樣做，但有些可能會繞過這些變數並直接連接。例如，Node.js `fetch()` 預設忽略這些變數；在 Node 24+ 中，您可以設定 `NODE_USE_ENV_PROXY=1` 以啟用支援。為了全面涵蓋，您可以使用 [proxychains](https://github.com/haad/proxychains) 來攔截網路呼叫，或配置 iptables 將出站流量重定向到透明代理。320請注意，並非所有程式都會遵循 `HTTP_PROXY`/`HTTPS_PROXY`。大多數工具（curl、pip、npm、git）都會遵循，但有些可能會略過這些變數而直接連線。例如，Node.js `fetch()` 預設會忽略這些變數；在 Node 24+ 中，您可以設定 `NODE_USE_ENV_PROXY=1` 以啟用支援。若要涵蓋會忽略這些變數的工具，您可以使用 [proxychains](https://github.com/haad/proxychains) 來攔截網路呼叫，或設定 iptables 將傳出流量重新導向到透明代理伺服器。

321 321

322<Info>322<Info>

323 **透明代理**在網路級別攔截流量，因此用戶端不需要配置為使用它。常規代理要求用戶端明確連接並說 HTTP CONNECT 或 SOCKS。透明代理（如 Squid 或 mitmproxy 透明模式）可以處理原始重定向的 TCP 連接。323 **透明代理**在網路級別攔截流量，因此用戶端不需要配置為使用它。常規代理要求用戶端明確連接並說 HTTP CONNECT 或 SOCKS。透明代理（如 Squid 或 mitmproxy 透明模式）可以處理原始重定向的 TCP 連接。

agent-sdk/skills.md +1 −1

Details

8 8

9Agent Skills 使用專門功能擴展 Claude，Claude 會在相關時自動調用這些功能。Skills 被打包為 `SKILL.md` 文件，包含說明、描述和可選的支持資源。本頁面也涵蓋了 [Agent SDK 會話中的命令](#commands-in-agent-sdk-sessions)。9Agent Skills 使用專門功能擴展 Claude，Claude 會在相關時自動調用這些功能。Skills 被打包為 `SKILL.md` 文件，包含說明、描述和可選的支持資源。本頁面也涵蓋了 [Agent SDK 會話中的命令](#commands-in-agent-sdk-sessions)。

10 10

~~11有關 Skills 的全面資訊，包括優勢、架構和編寫指南，請參閱 [Agent Skills 概述](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)。~~11有關 Skills 的更多資訊，包括優勢、架構和編寫指南，請參閱 [Agent Skills 概述](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)。

12 12

13<h2 id="how-skills-work-with-the-agent-sdk">13<h2 id="how-skills-work-with-the-agent-sdk">

14 Skills 如何與 Agent SDK 搭配運作14 Skills 如何與 Agent SDK 搭配運作

agent-sdk/structured-outputs.md +1 −1

Details

8 8

9結構化輸出讓您定義想要從代理返回的資料的確切形狀。代理可以使用任何需要的工具來完成任務，而您仍然會在最後獲得與您的架構相匹配的驗證 JSON。定義一個 [JSON Schema](https://json-schema.org/understanding-json-schema/about) 來描述您需要的結構，SDK 會根據它驗證輸出，在不匹配時重新提示。如果驗證在重試限制內未成功，結果將是錯誤而不是結構化資料；請參閱 [錯誤處理](#error-handling)。9結構化輸出讓您定義想要從代理返回的資料的確切形狀。代理可以使用任何需要的工具來完成任務，而您仍然會在最後獲得與您的架構相匹配的驗證 JSON。定義一個 [JSON Schema](https://json-schema.org/understanding-json-schema/about) 來描述您需要的結構，SDK 會根據它驗證輸出，在不匹配時重新提示。如果驗證在重試限制內未成功，結果將是錯誤而不是結構化資料；請參閱 [錯誤處理](#error-handling)。

10 10

11為了獲得完整的類型安全，使用 [Zod](#type-safe-schemas-with-zod-and-pydantic)（TypeScript）或 [Pydantic](#type-safe-schemas-with-zod-and-pydantic)（Python）來定義您的架構並獲得強類型物件。11為了獲得完整的類型安全，使用 [Zod](#type-safe-schemas-with-zod-and-pydantic)（TypeScript）或 [Pydantic](#type-safe-schemas-with-zod-and-pydantic)（Python）來定義您的 schema 並獲得強類型物件。

12 12

13<h2 id="why-structured-outputs">13<h2 id="why-structured-outputs">

14 為什麼要使用結構化輸出？14 為什麼要使用結構化輸出？

agent-sdk/subagents.md +1 −1

Details

768 相關文件768 相關文件

769</h2>769</h2>

770 770

771* [Claude Code 子代理](/docs/zh-TW/sub-agents)：包括基於檔案系統定義的完整子代理文件771* [Claude Code subagent](/docs/zh-TW/sub-agents)：subagent 文件，包括基於檔案系統的定義

772* [動態工作流程](/docs/zh-TW/workflows)：從指令碼協調許多子代理，用於超出單一對話範圍的大型工作772* [動態工作流程](/docs/zh-TW/workflows)：從指令碼協調許多子代理，用於超出單一對話範圍的大型工作

773* [SDK 概述](/docs/zh-TW/agent-sdk/overview)：開始使用 Claude Agent SDK773* [SDK 概述](/docs/zh-TW/agent-sdk/overview)：開始使用 Claude Agent SDK

agent-sdk/typescript.md +26 −2

Details

2299 Hook 類型2299 Hook 類型

2300</h2>2300</h2>

2301 2301

2302有關使用 hooks 的綜合指南，包括示例和常見模式，見 [Hooks 指南](/docs/zh-TW/agent-sdk/hooks)。2302有關使用 hook 的綜合指南，包括示例和常見模式，見 [Hooks 指南](/docs/zh-TW/agent-sdk/hooks)。

2303 2303

2304<h3 id="hookevent">2304<h3 id="hookevent">

2305 `HookEvent`2305 `HookEvent`

3364};3364};

3365```3365```

3366 3366

3367基於 ripgrep 的強大搜尋工具，支援正規表達式。3367以 ripgrep 為基礎的搜尋工具，支援正規表達式。

3368 3368

3369<h3 id="taskstop">3369<h3 id="taskstop">

3370 TaskStop3370 TaskStop

5882};5882};

5883```5883```

5884 5884

5885<h3 id="sdksessionstatechangedmessage">

5886 `SDKSessionStateChangedMessage`

5887</h3>

5888

5889當 Claude Code 報告工作階段的狀態時發出。若要接收這些訊息，請設定 [`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`](/docs/zh-TW/env-vars#variables)。Claude Code 可能多次報告相同的狀態，因此請將訊息視為工作階段的目前狀態，而非狀態轉換。

5890

5891`state` 欄位攜帶下列值之一：

5892

5893* `running`：工作階段正在運作。

5894* `idle`：Claude Code 正在等待您的下一個提示詞。

5895* `requires_action`：工作階段因等待其傳送給您主機的請求之回答而受阻，例如權限提示。

5896

5897回合的 `idle` 訊息與其 `result` 訊息可能以任一順序到達。若要變更 `idle` 是否等待背景工作（例如背景 subagent 或 [工作流程](/docs/zh-TW/workflows) 執行），請參閱 [`CLAUDE_CODE_BG_TASKS_REPORT_RUNNING`](/docs/zh-TW/env-vars#variables)。

5898

5899```typescript theme={null}

5900type SDKSessionStateChangedMessage = {

5901 type: "system";

5902 subtype: "session_state_changed";

5903 state: "idle" | "running" | "requires_action";

5904 uuid: UUID;

5905 session_id: string;

5906};

5907```

5908

5885<h3 id="sdkfilespersistedevent">5909<h3 id="sdkfilespersistedevent">

5886 `SDKFilesPersistedEvent`5910 `SDKFilesPersistedEvent`

5887</h3>5911</h3>

agent-view.md +226 −223

Details

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| :- | :- |

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| :- | :- |

367| `→` | 附加到選定的工作階段 |367| `→` | 附加到選定的工作階段 |

369| `Tab` | 在空輸入上，瀏覽所有子代理。否則應用突出顯示的建議 |369| `Tab` | 在空白輸入上瀏覽所有 subagent。否則套用反白顯示的建議 |

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 模式並保留您的文字，與主提示詞輸入相同 |

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

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 或更新版本 |

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` 搭配使用 |

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` |

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| :- | :- |

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) 讀取它，而不是解析檔案 |

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 以研究預覽形式推出。 |

channels.md +4 −4

Details

47 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。47 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

48 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。48 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。

49 49

50 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to activate.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。50 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。

51 </Step>51 </Step>

52 52

53 <Step title="設定您的權杖">53 <Step title="設定您的權杖">

125 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。125 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

126 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。126 * 外掛程式[在市集中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。

127 127

128 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to activate.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。128 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。檢查安裝摘要：如果報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以使外掛程式的設定命令可用。

129 </Step>129 </Step>

130 130

131 <Step title="設定您的權杖">131 <Step title="設定您的權杖">

192 192

193 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。193 當安裝要求安裝範圍時，選擇使用者範圍選項，以便外掛程式在所有專案中可用。

194 194

195 如果安裝摘要報告 `Run /reload-plugins to activate.`，您不需要在此處理，因為下一步中的重新啟動會載入外掛程式。195 如果安裝摘要報告 `Run /reload-plugins to apply.`，您不需要在此處理，因為下一步中的重新啟動會載入外掛程式。

196 </Step>196 </Step>

197 197

198 <Step title="在啟用頻道的情況下重新啟動">198 <Step title="在啟用頻道的情況下重新啟動">

251 251

252 當安裝要求選擇安裝範圍時，選擇使用者範圍選項，以便外掛程式在您的所有專案中可用。252 當安裝要求選擇安裝範圍時，選擇使用者範圍選項，以便外掛程式在您的所有專案中可用。

253 253

254 如果安裝摘要報告 `Run /reload-plugins to activate.`，您無需在此處理，因為下一步中的重新啟動會載入外掛程式。254 如果安裝摘要報告 `Run /reload-plugins to apply.`，您無需在此處理，因為下一步中的重新啟動會載入外掛程式。

255 </Step>255 </Step>

256 256

257 <Step title="在啟用頻道的情況下重新啟動">257 <Step title="在啟用頻道的情況下重新啟動">

channels-reference.md +2 −0

Details

193claude --dangerously-load-development-channels server:webhook193claude --dangerously-load-development-channels server:webhook

194```194```

195 195

196請在互動式工作階段中使用開發旗標，Claude Code 才能在其中顯示確認提示。如果您在非互動模式下透過 `-p` 或 Agent SDK 傳遞此旗標，Claude Code 會忽略該旗標，且 channel 不會註冊。

197

196繞過是按項目進行的。將此旗標與 `--channels` 結合不會將繞過擴展到 `--channels` 項目。在研究預覽期間，您的 channel 不在核准允許清單上，因此在您建立和測試時保持在開發旗標上。198繞過是按項目進行的。將此旗標與 `--channels` 結合不會將繞過擴展到 `--channels` 項目。在研究預覽期間，您的 channel 不在核准允許清單上，因此在您建立和測試時保持在開發旗標上。

197 199

198<Note>200<Note>

checkpointing.md +3 −3

Details

35 如果提示輸入包含文字，雙 `Esc` 會清除它而不是開啟選單。清除的文字會儲存到您的輸入歷史記錄中，因此在您完成回溯選單後，按 `Up` 可以召回它。35 如果提示輸入包含文字，雙 `Esc` 會清除它而不是開啟選單。清除的文字會儲存到您的輸入歷史記錄中，因此在您完成回溯選單後，按 `Up` 可以召回它。

36</Note>36</Note>

37 37

38回溯選單列出您在會話期間傳送的每個提示，除了[在回合中途傳送的訊息](#messages-sent-mid-turn-not-checkpointed)。選擇您想要操作的點，然後選擇一個動作：38回溯選單列出您在工作階段期間傳送的提示詞。選擇您想要操作的點，然後選擇一個動作：

39 39

40* **恢復程式碼和對話**：將程式碼和對話都回復到該點40* **恢復程式碼和對話**：將程式碼和對話都回復到該點

41* **恢復對話**：回溯到該訊息，同時保持目前程式碼41* **恢復對話**：回溯到該訊息，同時保持目前程式碼

114 訊息在回合中途傳送未進行檢查點114 訊息在回合中途傳送未進行檢查點

115</h3>115</h3>

116 116

117當您[在 Claude 工作時排隊的訊息](/docs/zh-TW/interactive-mode#queue-messages-while-claude-works)在執行中的回合內到達 Claude 時，它會加入該回合而不是開始新的回合。訊息會出現在對話中，但 Claude Code 不會為其建立檢查點，回溯功能表也不會列出它。Claude Code 作為其自己的回合傳送的排隊訊息會照常獲得檢查點，包括當多個排隊訊息[共享該回合](/docs/zh-TW/interactive-mode#when-claude-code-sends-what-you-queued)時。117當您[在 Claude 工作時排隊的訊息](/docs/zh-TW/interactive-mode#queue-messages-while-claude-works)在執行中的回合內到達 Claude 時，它會加入該回合而不是開始新的回合。訊息會出現在對話中，但 Claude Code 不會為其建立檢查點。Claude Code 作為新回合的一部分傳送的排隊訊息會照常獲得檢查點，包括當多個排隊訊息[共享該回合](/docs/zh-TW/interactive-mode#when-claude-code-sends-what-you-queued)時。

118 118

119若要移除此類訊息，或撤銷 Claude 在其後所做的編輯，請回溯到開始該回合的提示。這會回溯整個回合，包括 Claude 在您的訊息到達之前所做的工作。119若要撤銷 Claude 在此類訊息之後所做的編輯，請回溯到開始該回合的提示詞。這會回溯整個回合，包括 Claude 在您的訊息到達之前所做的工作。

120 120

121<h3 id="symlinked-and-hard-linked-paths-not-restored">121<h3 id="symlinked-and-hard-linked-paths-not-restored">

122 符號連結和硬連結路徑未復原122 符號連結和硬連結路徑未復原

chrome.md +2 −0

Details

45* [Claude Code](/docs/zh-TW/quickstart#step-1-install-claude-code)45* [Claude Code](/docs/zh-TW/quickstart#step-1-install-claude-code)

46* 直接 Anthropic 計畫（Pro、Max、Team 或 Enterprise）46* 直接 Anthropic 計畫（Pro、Max、Team 或 Enterprise）

47 47

48在已啟用 HIPAA 的 Enterprise 組織中，Claude in Chrome 預設為關閉，[Owner](/docs/zh-TW/server-managed-settings#access-control) 可以在 [**Organization settings > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension) 中將其開啟。您與 Anthropic 簽訂的商業夥伴協議（BAA）不涵蓋透過 Claude in Chrome 傳送至第三方網站的資料。如需 Eligible Services 清單，請參閱 [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide)。

48Chrome 整合還需要使用 `/login` 登入。如果您使用 API 金鑰或來自 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 的長期 token 進行身分驗證，即使您傳入 `--chrome`，Claude Code 也會保持 Chrome 整合關閉，因為瀏覽器擴充功能無法使用這些憑證進行身分驗證。在 v2.1.216 之前，這些工作階段可以啟用 Chrome 整合，但每次嘗試連線至瀏覽器擴充功能時都會因 403 錯誤而失敗。50Chrome 整合還需要使用 `/login` 登入。如果您使用 API 金鑰或來自 [`claude setup-token`](/docs/zh-TW/authentication#generate-a-long-lived-token) 的長期 token 進行身分驗證，即使您傳入 `--chrome`，Claude Code 也會保持 Chrome 整合關閉，因為瀏覽器擴充功能無法使用這些憑證進行身分驗證。在 v2.1.216 之前，這些工作階段可以啟用 Chrome 整合，但每次嘗試連線至瀏覽器擴充功能時都會因 403 錯誤而失敗。

49 51

50<Note>52<Note>

claude-code-on-the-web.md +1 −1

Details

64有關 `/web-setup` 的逐步說明，請參閱[從您的終端機連接](/docs/zh-TW/web-quickstart#connect-from-your-terminal)，包括 `/web-setup` 儲存的內容以及如何移除它。64有關 `/web-setup` 的逐步說明，請參閱[從您的終端機連接](/docs/zh-TW/web-quickstart#connect-from-your-terminal)，包括 `/web-setup` 儲存的內容以及如何移除它。

65 65

66<Note>66<Note>

~~67 啟用[零資料保留](/docs/zh-TW/zero-data-retention)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。~~67 啟用[零資料保留](/docs/zh-TW/zero-data-retention)或已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。

68</Note>68</Note>

69 69

70<h3 id="quick-setup-for-team-and-enterprise">70<h3 id="quick-setup-for-team-and-enterprise">

claude-directory.md +2 −2

Details

1582 在下列任一情況下，Claude Code 會改為在 `cleanupPeriodDays` 後刪除這些逐字稿：1582 在下列任一情況下，Claude Code 會改為在 `cleanupPeriodDays` 後刪除這些逐字稿：

1583 1583

1584 * [受管設定](/docs/zh-TW/managed-settings)設定了 `cleanupPeriodDays`1584 * [受管設定](/docs/zh-TW/managed-settings)設定了 `cleanupPeriodDays`

1585 * 您的組織套用了 HIPAA 設定，且 Claude Code 直接連線至 Claude API1585 * [HIPAA 設定套用於您的工作階段](/docs/zh-TW/hipaa-setup#check-how-developers-sign-in-and-connect)

1586 1586

1587Claude Code 在這些情況下跳過基於年齡的掃描：1587Claude Code 在這些情況下跳過基於年齡的掃描：

1588 1588

1619 1619

1620| `~/.claude/` 下的路徑 | 內容 |1620| `~/.claude/` 下的路徑 | 內容 |

1621| - | - |1621| - | - |

1622| `history.jsonl` | 您輸入的每個提示詞，附有時間戳記和專案路徑。用於向上箭頭叫回、`Ctrl+R` 歷史搜尋和 `!` shell 命令補全。在套用了 HIPAA 設定的組織中，當 Claude Code 直接連線至 Claude API 時，每次掃描都會移除超過 `cleanupPeriodDays` 的項目。 |1622| `history.jsonl` | 您輸入的每個提示詞，附有時間戳記和專案路徑。用於向上箭頭叫回、`Ctrl+R` 歷史搜尋和 `!` shell 命令補全。當 [HIPAA 設定套用於您的工作階段](/docs/zh-TW/hipaa-setup#check-how-developers-sign-in-and-connect)時，每次掃描都會移除超過 `cleanupPeriodDays` 的項目。 |

1624| `remote-settings.json` | [伺服器受管設定](/docs/zh-TW/server-managed-settings) 的快取副本，用於你的組織，或當你的組織未配置任何設定時為 `{}`。只有在工作階段 [擷取它們](/docs/zh-TW/server-managed-settings#platform-availability) 時才存在。Claude Code 在啟動時和工作階段期間每小時檢查更新。Claude Code 在你登出時刪除它。 |1624| `remote-settings.json` | [伺服器受管設定](/docs/zh-TW/server-managed-settings) 的快取副本，用於你的組織，或當你的組織未配置任何設定時為 `{}`。只有在工作階段 [擷取它們](/docs/zh-TW/server-managed-settings#platform-availability) 時才存在。Claude Code 在啟動時和工作階段期間每小時檢查更新。Claude Code 在你登出時刪除它。 |

claude-security.md +1 −1

Details

53* 如果它報告 `Marketplace "claude-plugins-official" not found`，使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。53* 如果它報告 `Marketplace "claude-plugins-official" not found`，使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市集，然後重試安裝。

54* 如果它報告[在市集中找不到外掛程式](/docs/zh-TW/plugins/install#install-a-plugin)，檢查外掛程式名稱是否有拼寫錯誤。54* 如果它報告[在市集中找不到外掛程式](/docs/zh-TW/plugins/install#install-a-plugin)，檢查外掛程式名稱是否有拼寫錯誤。

55 55

56檢查安裝摘要。如果它報告 `Run /reload-plugins to activate.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以在您目前的工作階段中啟用外掛程式。56檢查安裝摘要。如果它報告 `Run /reload-plugins to apply.`，請參閱[在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins)以在您目前的工作階段中啟用外掛程式。

57 57

58外掛程式啟用後，您已準備好[掃描和修復您的程式碼庫](#scan-and-fix-your-codebase)。58外掛程式啟用後，您已準備好[掃描和修復您的程式碼庫](#scan-and-fix-your-codebase)。

59 59

cli-reference.md +4 −4

Details

29| `claude auth status` | 以 JSON 格式顯示身分驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出，如果未登入則以代碼 1 退出。JSON 包含一個 `configDirectory` 欄位，命名 CLI 使用的 [設定目錄](/docs/zh-TW/claude-directory)。該欄位需要 Claude Code v2.1.268 或更新版本。JSON 的 `authMethod` 欄位為 `none`、`claude.ai`、`oauth_token`、`api_key`、`api_key_helper` 或 `third_party` 其中之一 | `claude auth status` |29| `claude auth status` | 以 JSON 格式顯示身分驗證狀態。使用 `--text` 以人類可讀的格式輸出。如果已登入則以代碼 0 退出，如果未登入則以代碼 1 退出。JSON 包含一個 `configDirectory` 欄位，命名 CLI 使用的 [設定目錄](/docs/zh-TW/claude-directory)。該欄位需要 Claude Code v2.1.268 或更新版本。JSON 的 `authMethod` 欄位為 `none`、`claude.ai`、`oauth_token`、`api_key`、`api_key_helper` 或 `third_party` 其中之一 | `claude auth status` |

30| `claude agents` | 開啟 [agent 檢視](/docs/zh-TW/agent-view) 以監控和分派平行背景工作階段。使用 `--cwd <path>` 僅顯示在該目錄下啟動的工作階段，或使用 `--json` 將作用中工作階段列印為 JSON 陣列以供指令碼使用（`--json --all` 也包括已完成的背景工作階段）。傳遞 `--permission-mode`、`--model`、`--effort` 或 `--agent` 以設定 [分派工作階段的預設值](/docs/zh-TW/agent-view#permission-mode-model-and-effort)。接受 `--settings`、`--add-dir`、`--plugin-dir` 和 `--mcp-config`，如同頂層 `claude` 命令。開啟 agent 檢視需要互動式終端機 | `claude agents --json` |30| `claude agents` | 開啟 [agent 檢視](/docs/zh-TW/agent-view) 以監控和分派平行背景工作階段。使用 `--cwd <path>` 僅顯示在該目錄下啟動的工作階段，或使用 `--json` 將作用中工作階段列印為 JSON 陣列以供指令碼使用（`--json --all` 也包括已完成的背景工作階段）。傳遞 `--permission-mode`、`--model`、`--effort` 或 `--agent` 以設定 [分派工作階段的預設值](/docs/zh-TW/agent-view#permission-mode-model-and-effort)。接受 `--settings`、`--add-dir`、`--plugin-dir` 和 `--mcp-config`，如同頂層 `claude` 命令。開啟 agent 檢視需要互動式終端機 | `claude agents --json` |

32| `claude auto-mode defaults` | 以 JSON 格式列印內建 [自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看應用了設定的有效設定。使用 `--label <prefix>` 僅列印標籤以該前綴開頭的規則，不區分大小寫。需要 Claude Code v2.1.208 或更新版本 | `claude auto-mode defaults --label 'Git Destructive'` |32| `claude auto-mode defaults` | 以 JSON 格式列印內建 [自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 分類器規則。使用 `claude auto-mode config` 查看應用了設定的有效設定。使用 `--label <prefix>` 僅列印標籤以該前綴開頭的規則，不區分大小寫。需要 Claude Code v2.1.208 或更新版本 | `claude auto-mode defaults --label 'Git Destructive'` |

33| `claude auto-mode reset` | 透過從使用者設定檔案中移除 `autoMode` 部分來還原預設 [自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 設定。在寫入前提示確認；傳遞 `-y`/`--yes` 以跳過提示。來自 [受管設定](/docs/zh-TW/server-managed-settings) 或 `--settings` 旗標的規則仍然適用。需要 Claude Code v2.1.212 或更新版本。請參閱 [檢查預設值和您的有效設定](/docs/zh-TW/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |33| `claude auto-mode reset` | 透過從使用者設定檔案中移除 `autoMode` 部分來還原預設 [自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 設定。在寫入前提示確認；傳遞 `-y`/`--yes` 以跳過提示。來自 [受管設定](/docs/zh-TW/server-managed-settings) 或 `--settings` 旗標的規則仍然適用。需要 Claude Code v2.1.212 或更新版本。請參閱 [檢查預設值和您的有效設定](/docs/zh-TW/auto-mode-config#inspect-the-defaults-and-your-effective-config) | `claude auto-mode reset --yes` |

35| `claude daemon stop --any` | 停止背景工作階段 [監督程序](/docs/zh-TW/agent-view#the-supervisor-process) 及其託管的工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行，以便下一個監督程序重新連接到它們。`--any` 確認停止隨需監督程序，這是預設值。使用此命令從 [無回應的監督程序](/docs/zh-TW/agent-view#agent-view-says-the-background-service-did-not-respond) 復原 | `claude daemon stop --any --keep-workers` |35| `claude daemon stop --any` | 停止背景工作階段 [監督程序](/docs/zh-TW/agent-view#the-supervisor-process) 及其託管的工作階段。傳遞 `--keep-workers` 以保持背景工作階段執行，以便下一個監督程序重新連接到它們。`--any` 確認停止隨需監督程序，這是預設值。使用此命令從 [無回應的監督程序](/docs/zh-TW/agent-view#agent-view-says-the-background-service-did-not-respond) 復原 | `claude daemon stop --any --keep-workers` |

37| `claude import [source]` | 啟動互動式工作階段，執行 [`/import`](/docs/zh-TW/commands#all-commands) 以將其他編碼 agent 的設定帶入 Claude Code。接受與命令相同的 `--dry-run` 和 `--yes` 選項。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 AWS 上的 Claude Platform 上不可用。當您關閉 [功能旗標擷取](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching) 時也不可用。需要 Claude Code v2.1.213 或更新版本 | `claude import codex --dry-run` |37| `claude import [source]` | 啟動互動式工作階段，執行 [`/import`](/docs/zh-TW/commands#all-commands) 以將其他編碼 agent 的設定帶入 Claude Code。接受與命令相同的 `--dry-run` 和 `--yes` 選項。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 AWS 上的 Claude Platform 上不可用。當您關閉 [功能旗標擷取](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching) 時也不可用。需要 Claude Code v2.1.213 或更新版本 | `claude import codex --dry-run` |

40| `claude mcp login <name>` | 執行已設定 MCP 伺服器的 OAuth 流程，無需開啟互動式 `/mcp` 面板。適用於 HTTP、SSE 和 claude.ai 連接器伺服器。在 SSH 上新增 `--no-browser` 以列印授權 URL 而非開啟瀏覽器，然後將重新導向 URL 貼回提示處。請參閱 [從命令列進行身分驗證](/docs/zh-TW/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |40| `claude mcp login <name>` | 執行已設定 MCP 伺服器的 OAuth 流程，無需開啟互動式 `/mcp` 面板。適用於 HTTP、SSE 和 claude.ai 連接器伺服器。在 SSH 上新增 `--no-browser` 以列印授權 URL 而非開啟瀏覽器，然後將重新導向 URL 貼回提示處。請參閱 [從命令列進行身分驗證](/docs/zh-TW/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

81| `--cloud` | 使用任務說明，建立新的[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)。使用工作階段 ID（`session_...` 或 `cse_...`）或 claude.ai/code URL，改為使用 `-p` 將訊息排入該現有工作階段。請參閱[傳送後續訊息](/docs/zh-TW/claude-code-on-the-web#send-follow-ups-from-the-cli)。 | `claude --cloud "Fix the login bug"` |81| `--cloud` | 使用任務說明，建立新的[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)。使用工作階段 ID（`session_...` 或 `cse_...`）或 claude.ai/code URL，改為使用 `-p` 將訊息排入該現有工作階段。請參閱[傳送後續訊息](/docs/zh-TW/claude-code-on-the-web#send-follow-ups-from-the-cli)。 | `claude --cloud "Fix the login bug"` |

82| `--continue`, `-c` | 載入目前目錄中最近的對話，包括[已完成的背景工作階段](/docs/zh-TW/sessions#resume-a-session)；開啟已完成的背景工作階段需要 Claude Code v2.1.257 或更新版本。跳過使用 `claude -p` 或 Agent SDK 建立的工作階段，以及第一個提示為 `/loop` 的工作階段。`claude -p --continue` 包括 `-p`、SDK 和 `/loop` 工作階段。包括使用 `/add-dir` 新增此目錄的工作階段 | `claude --continue` |82| `--continue`, `-c` | 載入目前目錄中最近的對話，包括[已完成的背景工作階段](/docs/zh-TW/sessions#resume-a-session)；開啟已完成的背景工作階段需要 Claude Code v2.1.257 或更新版本。跳過使用 `claude -p` 或 Agent SDK 建立的工作階段，以及第一個提示為 `/loop` 的工作階段。`claude -p --continue` 包括 `-p`、SDK 和 `/loop` 工作階段。包括使用 `/add-dir` 新增此目錄的工作階段 | `claude --continue` |

83| `--dangerously-load-development-channels` | 啟用不在核准允許清單上的[頻道](/docs/zh-TW/channels-reference#test-during-the-research-preview)，用於本機開發。接受 `plugin:<name>@<marketplace>` 和 `server:<name>` 項目。提示確認 | `claude --dangerously-load-development-channels server:webhook` |83| `--dangerously-load-development-channels` | 啟用不在核准允許清單上的[頻道](/docs/zh-TW/channels-reference#test-during-the-research-preview)，用於本機開發。接受 `plugin:<name>@<marketplace>` 和 `server:<name>` 項目。會提示確認，因此它在互動工作階段中生效。使用 `-p` 時，Claude Code 會忽略此旗標 | `claude --dangerously-load-development-channels server:webhook` |

84| `--dangerously-skip-permissions` | 跳過權限提示。等同於 `--permission-mode bypassPermissions`。請參閱[權限模式](/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode)以了解此操作跳過和不跳過的內容。對於使用 `--bg` 啟動的工作階段，當主管重新啟動工作階段時，模式[會保留](/docs/zh-TW/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | 跳過權限提示。等同於 `--permission-mode bypassPermissions`。請參閱[權限模式](/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode)以了解此操作跳過和不跳過的內容。對於使用 `--bg` 啟動的工作階段，當主管重新啟動工作階段時，模式[會保留](/docs/zh-TW/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

105| `--json-schema` | 在代理程式完成其工作流程後取得符合 JSON Schema 的驗證 JSON 輸出（僅列印模式）。請參閱[結構化輸出](/docs/zh-TW/agent-sdk/structured-outputs)。Claude Code 在無效的 schema 上結束並接受 `format` 關鍵字作為註釋而不進行用戶端驗證 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |105| `--json-schema` | 在代理程式完成其工作流程後取得符合 JSON Schema 的驗證 JSON 輸出（僅列印模式）。請參閱[結構化輸出](/docs/zh-TW/agent-sdk/structured-outputs)。Claude Code 在無效的 schema 上結束並接受 `format` 關鍵字作為註釋而不進行用戶端驗證 | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

107| `--max-budget-usd` | 在停止前在 API 呼叫上花費的最大美元金額（僅列印模式）。來自[子代理程式](/docs/zh-TW/sub-agents)的支出計入上限。當您使用 `--continue` 或 `--resume` 返回對話時，[從較早的執行恢復](/docs/zh-TW/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)的總計不計入它。一旦支出達到上限，產生另一個子代理程式會失敗，出現 `Budget limit reached`，Claude Code 會停止仍在執行的背景子代理程式；上限強制行為需要 Claude Code v2.1.217 或更新版本 | `claude -p --max-budget-usd 5.00 "query"` |107| `--max-budget-usd` | 在停止前在 API 呼叫上花費的最大美元金額（僅列印模式）。Claude Code 會依據其[用戶端成本估算](/docs/zh-TW/agent-sdk/cost-tracking#estimates-not-billing)檢查上限，這可能與您的帳單不同。來自 [subagent](/docs/zh-TW/sub-agents) 的支出計入上限。當您使用 `--continue` 或 `--resume` 返回對話時，[從較早的執行還原](/docs/zh-TW/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)的總計不計入上限。一旦支出達到上限，產生另一個 subagent 會失敗並出現 `Budget limit reached`，且 Claude Code 會停止仍在執行的背景 subagent；上限強制行為需要 Claude Code v2.1.217 或更新版本 | `claude -p --max-budget-usd 5.00 "query"` |

109| `--mcp-config` | 從 JSON 檔案或字串載入 MCP 伺服器（以空格分隔）。當您使用 `-p` 傳遞此旗標時，Claude Code 會等待仍在擱置的伺服器連線，直到 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 啟動逾時（預設 30 秒）；具有[快取工具清單](/docs/zh-TW/mcp#managing-your-servers)的伺服器會跳過等待並在首次使用時連線。等待需要 Claude Code v2.1.221 或更新版本 | `claude --mcp-config ./mcp.json` |109| `--mcp-config` | 從 JSON 檔案或字串載入 MCP 伺服器（以空格分隔）。當您使用 `-p` 傳遞此旗標時，Claude Code 會等待仍在擱置的伺服器連線，直到 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 啟動逾時（預設 30 秒）；具有[快取工具清單](/docs/zh-TW/mcp#managing-your-servers)的伺服器會跳過等待並在首次使用時連線。等待需要 Claude Code v2.1.221 或更新版本 | `claude --mcp-config ./mcp.json` |

110| `--model` | 使用[模型別名](/docs/zh-TW/model-config#model-aliases)（例如 `sonnet`、`opus`、`haiku` 或 `fable`）或模型的完整名稱為目前工作階段設定模型。覆蓋 [`model`](/docs/zh-TW/settings-reference#model) 設定和 [`ANTHROPIC_MODEL`](/docs/zh-TW/model-config#environment-variables) | `claude --model claude-sonnet-5` |110| `--model` | 使用[模型別名](/docs/zh-TW/model-config#model-aliases)（例如 `sonnet`、`opus`、`haiku` 或 `fable`）或模型的完整名稱為目前工作階段設定模型。覆蓋 [`model`](/docs/zh-TW/settings-reference#model) 設定和 [`ANTHROPIC_MODEL`](/docs/zh-TW/model-config#environment-variables) | `claude --model claude-sonnet-5` |

code-review.md +3 −3

Details

7> 設定自動化 PR 審查，使用多代理分析您的完整程式碼庫來捕捉邏輯錯誤、安全漏洞和迴歸7> 設定自動化 PR 審查，使用多代理分析您的完整程式碼庫來捕捉邏輯錯誤、安全漏洞和迴歸

8 8

9<Note>9<Note>

10 Code Review 處於研究預覽階段，適用於 [Team 和 Enterprise](https://claude.ai/admin-settings/claude-code) 訂閱。對於啟用了 [Zero Data Retention](/docs/zh-TW/zero-data-retention) 的組織，此功能不可用。在其他方案上，您仍然可以使用 `/code-review` 命令[在本地審查差異](#review-a-diff-locally)。10 Code Review 處於研究預覽階段，適用於 [Team 和 Enterprise](https://claude.ai/admin-settings/claude-code) 訂閱。對於啟用了 [Zero Data Retention](/docs/zh-TW/zero-data-retention) 或套用了 [HIPAA 設定](/docs/zh-TW/hipaa-setup) 的組織，此功能不可用，且不在 Anthropic 的 BAA 涵蓋範圍內。在其他方案上，您仍然可以使用 `/code-review` 命令[在本地審查差異](#review-a-diff-locally)。

11</Note>11</Note>

12 12

13Code Review 分析您的 GitHub pull request，並在發現問題的程式碼行上發佈內聯評論。一群專門的代理在您完整程式碼庫的背景下檢查程式碼變更，尋找邏輯錯誤、安全漏洞、破損的邊界情況和細微的迴歸。13Code Review 分析您的 GitHub pull request，並在發現問題的程式碼行上發佈內聯評論。一群專門的代理在您完整程式碼庫的背景下檢查程式碼變更，尋找邏輯錯誤、安全漏洞、破損的邊界情況和細微的迴歸。

372* 在終端工作階段中，其中 `/code-review` 作為[分叉子代理](/docs/zh-TW/skills#run-skills-in-a-subagent)執行審查372* 在終端工作階段中，其中 `/code-review` 作為[分叉子代理](/docs/zh-TW/skills#run-skills-in-a-subagent)執行審查

373* 在具有文字或 JSON 輸出的 `-p` 執行中373* 在具有文字或 JSON 輸出的 `-p` 執行中

374 374

375在要求發現結果清單的主應用程式中，例如[桌面應用程式](/docs/zh-TW/desktop)，Claude 透過 [`ReportFindings` 工具](/docs/zh-TW/tools-reference)報告審查的發現結果。Claude Code 將報告呈現為發現結果清單，每個項目顯示檔案位置、單句摘要和類別標籤，例如當發現結果包含時的 `correctness`。主應用程式要求適用於每個努力級別，需要 Claude Code v2.1.218 或更新版本。375在請求發現結果清單的主應用程式中，例如[桌面應用程式](/docs/zh-TW/desktop#review-your-code)，Claude 改為透過 [`ReportFindings` 工具](/docs/zh-TW/tools-reference)報告審查的發現結果。Claude Code 將報告呈現為發現結果清單，每個項目顯示檔案位置、單句摘要，以及當發現結果帶有類別標籤時的標籤，例如 `correctness`。主應用程式請求適用於每個 effort 等級，需要 Claude Code v2.1.218 或更新版本。

376 376

377當 Claude 稍後在工作階段中修復報告的發現結果時，它會再次報告它們，Claude Code 會將更新的發現結果清單中的每個發現結果標記為已修復、已跳過或無需變更。377當 Claude 稍後在工作階段中修復報告的發現結果時，它會再次報告它們，Claude Code 會將更新的發現結果清單中的每個發現結果標記為已修復、已跳過或無需變更。

378 378

436當目標是 `github.com` pull request 時，您可以讓 Claude[將完成的發現結果發佈到 PR](/docs/zh-TW/ultrareview#post-findings-to-the-pull-request)作為來自您 GitHub 帳戶的評論。需要 Claude Code v2.1.227 或更新版本。436當目標是 `github.com` pull request 時，您可以讓 Claude[將完成的發現結果發佈到 PR](/docs/zh-TW/ultrareview#post-findings-to-the-pull-request)作為來自您 GitHub 帳戶的評論。需要 Claude Code v2.1.227 或更新版本。

437 437

438<Note>438<Note>

439 Ultrareview 需要使用 claude.ai 帳戶進行身份驗證，在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用，或對於啟用了零資料保留的組織不可用。當 ultrareview 不可用時，`/code-review ultra` 會在您的工作階段中執行本地審查。439 Ultrareview 需要使用 claude.ai 帳戶進行身分驗證，在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用，對於啟用了零資料保留或已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織也不可用。當 ultrareview 不可用時，`/code-review ultra` 會改為在您的工作階段中執行本地審查。

440</Note>440</Note>

441 441

442若要從指令碼或 CI 作業執行雲端審查，請使用 [`claude ultrareview` 子命令](/docs/zh-TW/ultrareview#run-ultrareview-non-interactively)，它會等待發現結果並將其列印到 stdout。442若要從指令碼或 CI 作業執行雲端審查，請使用 [`claude ultrareview` 子命令](/docs/zh-TW/ultrareview#run-ultrareview-non-interactively)，它會等待發現結果並將其列印到 stdout。

commands.md +2 −2

Details

10 10

11輸入 `/` 以查看可用的命令，或輸入 `/` 後跟字母以篩選。[命令菜單如何匹配您輸入的內容](#how-the-command-menu-matches-what-you-type)涵蓋了突出顯示、拼寫錯誤以及 Claude Code 隱藏的少數命令，直到您輸入其完整名稱。11輸入 `/` 以查看可用的命令，或輸入 `/` 後跟字母以篩選。[命令菜單如何匹配您輸入的內容](#how-the-command-menu-matches-what-you-type)涵蓋了突出顯示、拼寫錯誤以及 Claude Code 隱藏的少數命令，直到您輸入其完整名稱。

12 12

13命令只在您的訊息開始時被識別。命令名稱後面的文字成為其引數。從 v2.1.199 開始，[skills](/docs/zh-TW/skills#pass-arguments-to-skills)是例外：一個 skill 調用後跟更多 skills，例如 `/skill-a /skill-b do XYZ`，會載入開始時命名的每個 skill，並將尾部文字作為引數傳遞給每個。最多可以鏈接六個 skills。13命令只在您的訊息開始時被識別。命令名稱後面的文字成為其引數。[Skills](/docs/zh-TW/skills#pass-arguments-to-skills) 是例外：一個 skill 呼叫後跟更多 skills，例如 `/skill-a /skill-b do XYZ`，會載入開始時命名的 skills，並將尾部文字作為引數傳遞給每個 skill。最多可以串連六個 skills。

14 14

15如果您在 Claude 回應時發送命令，Claude Code 會將其排隊，並在目前回合完成後執行。Claude Code 會立即執行某些命令而不中斷回應，例如 `/status`、`/tasks` 和 `/usage`。在[全螢幕渲染](/docs/zh-TW/fullscreen)中，Claude Code 也會立即開啟對話命令，例如 `/theme` 和 `/help`。在 v2.1.234 之前，Claude Code 會將這些對話排隊直到回合完成。15如果您在 Claude 回應時發送命令，Claude Code 會將其排隊，並在目前回合完成後執行。Claude Code 會立即執行某些命令而不中斷回應，例如 `/status`、`/tasks` 和 `/usage`。在[全螢幕渲染](/docs/zh-TW/fullscreen)中，Claude Code 也會立即開啟對話命令，例如 `/theme` 和 `/help`。在 v2.1.234 之前，Claude Code 會將這些對話排隊直到回合完成。

16 16

140| `/run-skill-generator` | **[Skill](/docs/zh-TW/skills#bundled-skills)。** 通過編寫每個專案的 [skill](/docs/zh-TW/skills#run-and-verify-your-app)，教 `/run` 和 `/verify` 如何從乾淨環境建置、啟動和驅動您的專案應用程式 |140| `/run-skill-generator` | **[Skill](/docs/zh-TW/skills#bundled-skills)。** 通過編寫每個專案的 [skill](/docs/zh-TW/skills#run-and-verify-your-app)，教 `/run` 和 `/verify` 如何從乾淨環境建置、啟動和驅動您的專案應用程式 |

142| `/schedule [description]` | 建立、更新、列出或運行在雲端執行的 [routine](/docs/zh-TW/routines)。Claude 以對話方式逐步解說設定。您也可以詢問 [routine 的最近運行](/docs/zh-TW/routines#manage-routines-from-the-cli)。別名：`/routines` |142| `/schedule [description]` | 建立、更新、列出或運行在雲端執行的 [routine](/docs/zh-TW/routines)。Claude 以對話方式逐步解說設定。您也可以詢問 [routine 的最近運行](/docs/zh-TW/routines#manage-routines-from-the-cli)。別名：`/routines` |

143| `/scroll-speed` | 以互動方式調整滑鼠滾輪[捲動速度](/docs/zh-TW/fullscreen#mouse-wheel-scrolling)，使用尺標，您可以在對話框打開時捲動以預覽變更。僅在[全螢幕渲染](/docs/zh-TW/fullscreen)中可用，在 JetBrains IDE 終端機中不可用 |143| `/scroll-speed` | 以互動方式調整滑鼠滾輪[捲動速度](/docs/zh-TW/fullscreen#mouse-wheel-scrolling)。僅在[全螢幕渲染](/docs/zh-TW/fullscreen)中可用，在 JetBrains IDE 終端機中不可用 |

144| `/security-review` | 分析目前分支上的變更以查找安全漏洞。檢查您的分支與 origin 預設分支之間的差異，識別注入、身分驗證問題和資料洩露等風險。需要 `origin` 遠端；如果檢查失敗並出現 `ambiguous argument` 錯誤，請參閱[錯誤參考](/docs/zh-TW/errors#security-review-fails-without-origin-head) |144| `/security-review` | 分析目前分支上的變更以查找安全漏洞。檢查您的分支與 origin 預設分支之間的差異，識別注入、身分驗證問題和資料洩露等風險。需要 `origin` 遠端；如果檢查失敗並出現 `ambiguous argument` 錯誤，請參閱[錯誤參考](/docs/zh-TW/errors#security-review-fails-without-origin-head) |

145| `/setup-bedrock` | 通過互動式精靈設定 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 身分驗證、區域和模型釘選。[從命令選單隱藏](#how-the-command-menu-matches-what-you-type)直到設定 `CLAUDE_CODE_USE_BEDROCK=1`；完整輸入它。首次 Amazon Bedrock 使用者也可以從登入螢幕存取此精靈 |145| `/setup-bedrock` | 通過互動式精靈設定 [Amazon Bedrock](/docs/zh-TW/amazon-bedrock) 身分驗證、區域和模型釘選。[從命令選單隱藏](#how-the-command-menu-matches-what-you-type)直到設定 `CLAUDE_CODE_USE_BEDROCK=1`；完整輸入它。首次 Amazon Bedrock 使用者也可以從登入螢幕存取此精靈 |

146| `/setup-vertex` | 通過互動式精靈設定 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 身分驗證、專案、區域和模型釘選。[從命令選單隱藏](#how-the-command-menu-matches-what-you-type)直到設定 `CLAUDE_CODE_USE_VERTEX=1`；完整輸入它。首次 Google Cloud 的 Agent Platform 使用者也可以從登入螢幕存取此精靈 |146| `/setup-vertex` | 通過互動式精靈設定 [Google Cloud 的 Agent Platform](/docs/zh-TW/google-vertex-ai) 身分驗證、專案、區域和模型釘選。[從命令選單隱藏](#how-the-command-menu-matches-what-you-type)直到設定 `CLAUDE_CODE_USE_VERTEX=1`；完整輸入它。首次 Google Cloud 的 Agent Platform 使用者也可以從登入螢幕存取此精靈 |

common-workflows.md +1 −1

Details

229 229

230Claude 可以產生遵循您專案現有模式和慣例的測試。要求測試時，請明確說明您想驗證的行為。Claude 會檢查您現有的測試檔案，以符合已在使用的風格、框架和斷言模式。230Claude 可以產生遵循您專案現有模式和慣例的測試。要求測試時，請明確說明您想驗證的行為。Claude 會檢查您現有的測試檔案，以符合已在使用的風格、框架和斷言模式。

231 231

232為了獲得全面的涵蓋範圍，要求 Claude 識別您可能遺漏的邊界情況。Claude 可以分析您的程式碼路徑，並建議測試錯誤條件、邊界值和容易忽視的意外輸入。232若要提高涵蓋範圍，請要求 Claude 識別您可能遺漏的邊界情況。Claude 可以分析您的程式碼路徑，並建議測試錯誤條件、邊界值和容易忽視的意外輸入。

233 233

234***234***

235 235

context-window.md +2 −2

Details

1604| 自動記憶 | 從磁碟重新注入 |1604| 自動記憶 | 從磁碟重新注入 |

1605| [Git 狀態快照](/docs/zh-TW/settings-reference#includegitinstructions) | Claude Code 從您的儲存庫讀取新的快照 |1605| [Git 狀態快照](/docs/zh-TW/settings-reference#includegitinstructions) | Claude Code 從您的儲存庫讀取新的快照 |

1606| Claude 在[計畫模式](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)中編寫的計畫 | 從磁碟重新注入 |1606| Claude 在[計畫模式](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)中編寫的計畫 | 從磁碟重新注入 |

1608| 子目錄中的巢狀 CLAUDE.md | Claude Code 在 Claude 讀取該子目錄中的檔案時重新載入它們 |1608| 子目錄中的巢狀 CLAUDE.md | Claude Code [視需要](/docs/zh-TW/memory#how-claude-md-files-load)重新載入它們 |

1609| Claude 讀取或編輯的檔案 | Claude Code 重新讀取最多五個，最近修改的優先 |1609| Claude 讀取或編輯的檔案 | Claude Code 重新讀取最多五個，最近修改的優先 |

1610| 已叫用的技能主體 | 重新注入，每個技能上限為 5,000 個權杖，總計 25,000 個權杖；最舊的優先刪除 |1610| 已叫用的技能主體 | 重新注入，每個技能上限為 5,000 個權杖，總計 25,000 個權杖；最舊的優先刪除 |

1611| [背景命令](/docs/zh-TW/interactive-mode#background-bash-commands)和背景[子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) | 保持執行。Claude Code 提醒 Claude 哪些仍在執行，以便它不會啟動重複的 |1611| [背景命令](/docs/zh-TW/interactive-mode#background-bash-commands)和背景[子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) | 保持執行。Claude Code 提醒 Claude 哪些仍在執行，以便它不會啟動重複的 |

costs.md +24 −22

Details

37 37

38當 `/clear` 啟動新工作階段時，這些總計會重設，因此下一個工作階段的總成本從 \$0 開始。在 v2.1.211 之前，它們在 `/clear` 期間持續累積，直到 Claude Code 程序的生命週期結束。38當 `/clear` 啟動新工作階段時，這些總計會重設，因此下一個工作階段的總成本從 \$0 開始。在 v2.1.211 之前，它們在 `/clear` 期間持續累積，直到 Claude Code 程序的生命週期結束。

39 39

40對於以 1.1× [資料駐留費率](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing)計費的 Claude API 回應，Claude Code 會將該回應的 token 列表價格乘以 1.1，以計入工作階段成本數字。Claude Code 在[狀態行的成本欄位](/docs/zh-TW/statusline#cost-and-duration-tracking)中報告相同的總計，並將其與 [`--max-budget-usd`](/docs/zh-TW/cli-reference#cli-flags) 進行比較。在 v2.1.239 之前，Claude Code 沒有對這些回應應用 1.1×，因此工作階段成本數字低於帳單。40對於以 1.1× [資料駐留費率](https://platform.claude.com/docs/en/about-claude/pricing#data-residency-pricing)計費的 Claude API 回應，Claude Code 會將該回應的 token 列表價格乘以 1.1，以計入工作階段成本數字。相同的總計會出現在[狀態列的成本欄位](/docs/zh-TW/statusline#cost-and-duration-tracking)中，且乘算後的數字也會計入 [`--max-budget-usd`](/docs/zh-TW/cli-reference#cli-flags)。

41 41

42<h4 id="prompt-cache-statistics">42<h4 id="prompt-cache-statistics">

43 Prompt cache 統計資訊43 Prompt cache 統計資訊

252 減少 token 使用252 減少 token 使用

253</h2>253</h2>

254 254

255Token 成本隨上下文大小而擴展：Claude 處理的上下文越多，您使用的 token 就越多。Claude Code 透過 [prompt caching](/docs/zh-TW/prompt-caching)（減少重複內容（如系統提示）的成本）和 auto-compact（在接近上下文限制時總結對話歷史記錄）自動優化成本。255Token 成本隨上下文大小而擴展：Claude 處理的上下文越多，您使用的 token 就越多。Claude Code 透過[提示快取](/docs/zh-TW/prompt-caching)（減少系統提示詞等重複內容的成本）和自動壓縮（在接近上下文限制時總結對話歷史記錄）自動優化成本。

256 256

257以下策略可幫助您保持上下文較小並降低每條訊息的成本。257以下策略可幫助您保持上下文較小並降低每條訊息的成本。

258 258

260 主動管理上下文260 主動管理上下文

261</h3>261</h3>

262 262

263使用 `/usage` 檢查您目前的 token 使用情況，或[設定您的狀態行](/docs/zh-TW/statusline#context-window-usage)以持續顯示它。263使用 `/usage` 檢查您目前的 token 使用情況，或[設定您的狀態列](/docs/zh-TW/statusline#context-window-usage)以持續顯示它。

264 264

265* **在任務之間清除**：切換到不相關的工作時，使用 `/clear` 重新開始。過時的上下文會在後續的每條訊息上浪費 token。在清除之前使用 `/rename` 以便稍後輕鬆找到工作階段，然後使用 `/resume` 返回到它。265* **在任務之間清除**：切換到不相關的工作時，使用 `/clear` 重新開始。過時的上下文會在後續的每條訊息上浪費 token。在清除之前使用 `/rename` 以便稍後找到工作階段，然後使用 `/resume` 返回到它。

266* **新增自訂壓縮指示**：`/compact Focus on code samples and API usage` 告訴 Claude 在總結期間要保留什麼。266* **新增自訂壓縮指示**：`/compact Focus on code samples and API usage` 告訴 Claude 在總結期間要保留什麼。

267 267

268您也可以在專案根目錄的 CLAUDE.md 檔案中自訂壓縮行為：268您也可以在專案根目錄的 CLAUDE.md 檔案中自訂壓縮行為：

277 選擇正確的模型277 選擇正確的模型

278</h3>278</h3>

279 279

280Sonnet 能很好地處理大多數編碼任務，成本低於 Opus。為複雜的架構決策或多步驟推理保留 Opus。使用 `/model` 在工作階段中途切換模型，或在 `/config` 中設定預設值。對 Opus 的切換也適用於[繼承您工作階段模型的 subagents](/docs/zh-TW/model-config#setting-your-model)。對於簡單的 subagent 任務，在您的 [subagent 設定](/docs/zh-TW/sub-agents#choose-a-model)中指定 `model: haiku`。280Sonnet 能很好地處理大多數編碼任務，成本低於 Opus。為複雜的架構決策或多步驟推理保留 Opus。使用 `/model` 在工作階段中途切換模型，或在 `/config` 中設定預設值。對 Opus 的切換也適用於[繼承您工作階段模型的 subagent](/docs/zh-TW/model-config#setting-your-model)。對於簡單的 subagent 任務，在您的 [subagent 設定](/docs/zh-TW/sub-agents#choose-a-model)中指定 `model: haiku`。

281 281

282<h3 id="reduce-mcp-server-overhead">282<h3 id="reduce-mcp-server-overhead">

283 減少 MCP 伺服器開銷283 減少 MCP 伺服器開銷

285 285

286MCP 工具定義[預設為延遲](/docs/zh-TW/mcp#scale-with-mcp-tool-search)，因此只有工具名稱和伺服器指示進入上下文，直到 Claude 使用特定工具。執行 `/context` 以查看消耗空間的內容。286MCP 工具定義[預設為延遲](/docs/zh-TW/mcp#scale-with-mcp-tool-search)，因此只有工具名稱和伺服器指示進入上下文，直到 Claude 使用特定工具。執行 `/context` 以查看消耗空間的內容。

287 287

288* **在可用時偏好 CLI 工具**：`gh`、`aws`、`gcloud` 和 `sentry-cli` 等工具比 MCP 伺服器更具上下文效率，因為它們不會新增任何每個工具的列表。Claude 可以直接執行 CLI 命令。288* **在可用時偏好 CLI 工具**：`gh`、`aws`、`gcloud` 和 `sentry-cli` 等工具仍比 MCP 伺服器更具上下文效率，因為它們不會新增任何每個工具的列表。Claude 可以直接執行 CLI 命令。

289* **停用未使用的伺服器**：執行 `/mcp` 以查看已設定的伺服器，並停用任何您未主動使用的伺服器。289* **停用未使用的伺服器**：執行 `/mcp` 以查看已設定的伺服器，並停用任何您未主動使用的伺服器。

290 290

291<h3 id="install-code-intelligence-plugins-for-typed-languages">291<h3 id="install-code-intelligence-plugins-for-typed-languages">

295[程式碼智慧外掛](/docs/zh-TW/plugins/code-intelligence)為 Claude 提供精確的符號導航，而不是基於文字的搜尋，在探索不熟悉的程式碼時減少不必要的檔案讀取。單一「前往定義」呼叫取代了可能需要的 grep 後跟讀取多個候選檔案。已安裝的語言伺服器也會在編輯後自動報告型別錯誤，因此 Claude 無需執行編譯器即可捕捉錯誤。295[程式碼智慧外掛](/docs/zh-TW/plugins/code-intelligence)為 Claude 提供精確的符號導航，而不是基於文字的搜尋，在探索不熟悉的程式碼時減少不必要的檔案讀取。單一「前往定義」呼叫取代了可能需要的 grep 後跟讀取多個候選檔案。已安裝的語言伺服器也會在編輯後自動報告型別錯誤，因此 Claude 無需執行編譯器即可捕捉錯誤。

296 296

297<h3 id="offload-processing-to-hooks-and-skills">297<h3 id="offload-processing-to-hooks-and-skills">

298 將處理卸載到 hooks 和 skills298 將處理卸載到 hook 和 skill

299</h3>299</h3>

300 300

301自訂 [hooks](/docs/zh-TW/hooks)可以在 Claude 看到資料之前對其進行預處理。Claude 不是讀取 10,000 行日誌檔案來尋找錯誤，hook 可以 grep `ERROR` 並僅返回匹配的行，將上下文從數萬個 token 減少到數百個。301自訂 [hook](/docs/zh-TW/hooks) 可以在 Claude 看到資料之前對其進行預處理。Claude 不是讀取 10,000 行日誌檔案來尋找錯誤，hook 可以 grep `ERROR` 並僅返回匹配的行，將上下文從數萬個 token 減少到數百個。

302 302

303[skill](/docs/zh-TW/skills)可以為 Claude 提供領域知識，因此它不必進行探索。例如，「codebase-overview」skill 可以描述您的專案架構、關鍵目錄和命名慣例。當 Claude 呼叫該 skill 時，它會立即獲得此上下文，而不是花費 token 讀取多個檔案來理解結構。303[skill](/docs/zh-TW/skills) 可以為 Claude 提供領域知識，因此它不必進行探索。例如，「codebase-overview」skill 可以描述您的專案架構、關鍵目錄和命名慣例。當 Claude 呼叫該 skill 時，它會立即獲得此上下文，而不是花費 token 讀取多個檔案來理解結構。

304 304

305例如，此 PreToolUse hook 篩選測試輸出以僅顯示失敗：305例如，此 PreToolUse hook 篩選測試輸出以僅顯示失敗：

306 306

328 </Tab>328 </Tab>

329 329

330 <Tab title="filter-test-output.sh">330 <Tab title="filter-test-output.sh">

331 hook 呼叫此指令碼。建立資料夾，使用 `mkdir -p ~/.claude/hooks`，將下面的指令碼儲存為 `~/.claude/hooks/filter-test-output.sh`，並使用 `chmod +x ~/.claude/hooks/filter-test-output.sh` 使其可執行。它檢查命令是否為測試執行器並修改它以僅顯示失敗：331 hook 呼叫此指令碼。使用 `mkdir -p ~/.claude/hooks` 建立資料夾，將下面的指令碼儲存為 `~/.claude/hooks/filter-test-output.sh`，並使用 `chmod +x ~/.claude/hooks/filter-test-output.sh` 使其可執行。它檢查命令是否為測試執行器並修改它以僅顯示失敗：

332 332

333 ```bash theme={null}333 ```bash theme={null}

334 #!/bin/bash334 #!/bin/bash

350若要驗證設定，執行 `/hooks` 並檢查 hook 是否出現在 PreToolUse 下。您也可以使用 `claude --debug-file ./claude-debug.txt` 啟動 Claude Code，並要求 Claude 執行 `npm test`。當 hook 重寫命令時，該日誌檔案包含列出 `command` 和其他 Bash 輸入欄位的 `modified tool input keys` 行。350若要驗證設定，執行 `/hooks` 並檢查 hook 是否出現在 PreToolUse 下。您也可以使用 `claude --debug-file ./claude-debug.txt` 啟動 Claude Code，並要求 Claude 執行 `npm test`。當 hook 重寫命令時，該日誌檔案包含列出 `command` 和其他 Bash 輸入欄位的 `modified tool input keys` 行。

351 351

352<h3 id="move-instructions-from-claude-md-to-skills">352<h3 id="move-instructions-from-claude-md-to-skills">

353 將指示從 CLAUDE.md 移至 skills353 將指示從 CLAUDE.md 移至 skill

354</h3>354</h3>

355 355

356您的 [CLAUDE.md](/docs/zh-TW/memory) 檔案在工作階段開始時載入到上下文中。如果它包含特定工作流程的詳細指示（例如 PR 審查或資料庫遷移），即使您在進行不相關的工作時，這些 token 也會存在。[Skills](/docs/zh-TW/skills)僅在呼叫時按需載入，因此將專門指示移至 skills 可以保持您的基本上下文較小。目標是透過僅包含必要內容來將 CLAUDE.md 保持在 200 行以下。356您的 [CLAUDE.md](/docs/zh-TW/memory) 檔案在工作階段開始時載入到上下文中。如果它包含特定工作流程的詳細指示（例如 PR 審查或資料庫遷移），即使您在進行不相關的工作時，這些 token 也會存在。[Skills](/docs/zh-TW/skills) 僅在呼叫時按需載入，因此將專門指示移至 skill 可以保持您的基本上下文較小。目標是透過僅包含必要內容來將 CLAUDE.md 保持在 200 行以下。

357 357

358<h3 id="adjust-extended-thinking">358<h3 id="adjust-extended-thinking">

359 調整延伸思考359 調整延伸思考

361 361

362延伸思考預設為啟用，因為它可以顯著改善複雜規劃和推理任務的效能。思考 token 會作為輸出 token 計費，預設預算可能是每個請求數萬個 token，取決於模型。362延伸思考預設為啟用，因為它可以顯著改善複雜規劃和推理任務的效能。思考 token 會作為輸出 token 計費，預設預算可能是每個請求數萬個 token，取決於模型。

363 363

364對於不需要深度推理的較簡單任務，您可以透過在 `/effort` 中降低[努力等級](/docs/zh-TW/model-config#adjust-effort-level)或在 `/model` 中降低、在 `/config` 中停用思考，或在具有[固定思考預算](/docs/zh-TW/model-config#adaptive-reasoning-and-fixed-thinking-budgets)的模型上，透過設定 `MAX_THINKING_TOKENS` [環境變數](/docs/zh-TW/env-vars)（例如 `MAX_THINKING_TOKENS=8000`）來降低預算，以降低成本。自適應推理模型會忽略非零預算，因此請改用努力等級。您無法在 Opus 5.5、Sonnet 5.5 或 Fable 模型上關閉思考，它們始終使用延伸思考。364對於不需要深度推理的較簡單任務，您可以透過 `/effort` 或在 `/model` 中降低 [effort 等級](/docs/zh-TW/model-config#adjust-effort-level)，或在 `/config` 中停用思考，以降低成本。您無法在 Opus 5.5、Sonnet 5.5 或 Fable 模型上關閉思考，它們始終使用延伸思考。

365

366在具有[固定思考預算](/docs/zh-TW/model-config#adaptive-reasoning-and-fixed-thinking-budgets)的模型上，您也可以透過設定 `MAX_THINKING_TOKENS` [環境變數](/docs/zh-TW/env-vars)來降低預算，例如 `MAX_THINKING_TOKENS=8000`。自適應推理模型會忽略非零預算，因此在這些模型上請改用 effort 等級。

365 367

366<h3 id="delegate-verbose-operations-to-subagents">368<h3 id="delegate-verbose-operations-to-subagents">

367 將詳細操作委派給 subagents369 將詳細操作委派給 subagent

368</h3>370</h3>

369 371

370執行測試、擷取文件或處理日誌檔案可能會消耗大量上下文。將這些委派給 [subagents](/docs/zh-TW/sub-agents#isolate-high-volume-operations)，以便詳細輸出保留在 subagent 的上下文中，而只有摘要返回到您的主要對話。372執行測試、擷取文件或處理日誌檔案可能會消耗大量上下文。將這些委派給 [subagent](/docs/zh-TW/sub-agents#isolate-high-volume-operations)，以便詳細輸出保留在 subagent 的上下文中，而只有摘要返回到您的主要對話。

371 373

372subagent 自己的請求仍然會消耗您的使用量。為了在這些請求上花費更少，[為 subagent 選擇較小的模型](/docs/zh-TW/sub-agents#choose-a-model)或[在一個模型上執行每個 subagent](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model)。374subagent 自己的請求仍然會消耗您的使用量。為了在這些請求上花費更少，[為 subagent 選擇較小的模型](/docs/zh-TW/sub-agents#choose-a-model)或[在一個模型上執行每個 subagent](/docs/zh-TW/sub-agents#run-every-subagent-on-one-model)。

373 375

374<h3 id="manage-agent-team-costs">376<h3 id="manage-agent-team-costs">

375 管理 agent 團隊成本377 管理 agent team 成本

376</h3>378</h3>

377 379

378Agent 團隊使用的 token 大約是標準工作階段的 7 倍，當隊友在 plan mode 中執行時，因為每位隊友維護自己的上下文視窗並作為單獨的 Claude 執行個體執行。保持團隊任務小且自成一體，以限制每位隊友的 token 使用。有關詳細資訊，請參閱 [agent 團隊](/docs/zh-TW/agent-teams)。380當隊員在 plan mode 中執行時，agent team 使用的 token 大約是標準工作階段的 7 倍，因為每位隊員維護自己的上下文視窗並作為單獨的 Claude 執行個體執行。保持團隊任務小且自成一體，以限制每位隊員的 token 使用。有關詳細資訊，請參閱 [agent team](/docs/zh-TW/agent-teams)。

379 381

380<h3 id="write-specific-prompts">382<h3 id="write-specific-prompts">

381 撰寫具體提示383 撰寫具體提示詞

382</h3>384</h3>

383 385

384模糊的請求（例如「改進此程式碼庫」）會觸發廣泛掃描。具體的請求（例如「在 auth.ts 中的登入函式中新增輸入驗證」）讓 Claude 能夠以最少的檔案讀取高效地工作。386模糊的請求（例如「改進此程式碼庫」）會觸發廣泛掃描。具體的請求（例如「在 auth.ts 中的登入函式中新增輸入驗證」）讓 Claude 能夠以最少的檔案讀取高效地工作。

389 391

390對於較長或更複雜的工作，這些習慣有助於避免因走錯方向而浪費的 token：392對於較長或更複雜的工作，這些習慣有助於避免因走錯方向而浪費的 token：

391 393

392* **對複雜任務使用 plan mode**：按 Shift+Tab 進入 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)，然後再進行實施。Claude 探索程式碼庫並提出一個方法供您批准，防止當初始方向錯誤時進行昂貴的返工。394* **對複雜任務使用 plan mode**：在實作之前，按 Shift+Tab 循環切換至 [plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)。Claude 探索程式碼庫並提出一個方法供您核准，防止當初始方向錯誤時進行昂貴的返工。

393* **及早糾正方向**：如果 Claude 開始朝著錯誤的方向前進，按 Escape 立即停止。使用 `/rewind` 或雙擊 Escape 將對話和程式碼恢復到先前的 checkpoint。395* **及早修正方向**：如果 Claude 開始朝著錯誤的方向前進，按 Escape 立即停止。使用 `/rewind` 或雙擊 Escape 將對話和程式碼還原到先前的檢查點。

394* **提供驗證目標**：在您的提示中包含測試案例、貼上螢幕截圖或定義預期輸出。當 Claude 可以驗證自己的工作時，它會在您需要請求修復之前捕捉問題。396* **提供驗證目標**：在您的提示詞中包含測試案例、貼上螢幕截圖或定義預期輸出。當 Claude 可以驗證自己的工作時，它會在您需要請求修復之前捕捉問題。

395* **增量測試**：寫一個檔案、測試它，然後繼續。這會在問題便宜時及早捕捉問題。397* **增量測試**：寫一個檔案、測試它，然後繼續。這能在問題修復成本仍低時及早捕捉問題。

396 398

397<h2 id="background-token-usage">399<h2 id="background-token-usage">

398 背景 token 使用400 背景 token 使用

debug-your-config.md +2 −2

Details

29| `/debug [issue]` | 為工作階段啟用偵錯日誌，並提示 Claude 利用日誌輸出與設定路徑進行診斷 |29| `/debug [issue]` | 為工作階段啟用偵錯日誌，並提示 Claude 利用日誌輸出與設定路徑進行診斷 |

30| `/status` | 作用中的設定來源，包括受管設定是否生效 |30| `/status` | 作用中的設定來源，包括受管設定是否生效 |

31 31

32如果某個記憶檔案未出現在 `/context` 的細分結果中，請對照 [CLAUDE.md 檔案的載入方式](/docs/zh-TW/memory#how-claude-md-files-load) 檢查其位置。子目錄中的 `CLAUDE.md` 檔案是在 Claude 對該目錄中的檔案使用 Read、Write 或 Edit 工具後才按需載入，而非在工作階段開始時載入。32如果某個記憶檔案未出現在 `/context` 的細分結果中，請對照 [CLAUDE.md 檔案的載入方式](/docs/zh-TW/memory#how-claude-md-files-load) 檢查其位置。子目錄中的 `CLAUDE.md` 檔案是按需載入，而非在工作階段開始時載入，因此不會出現在該細分結果中。

33 33

34如果 `/context` 確認檔案已載入，但 Claude 仍未遵循某項特定指令，問題很可能出在指令的撰寫方式，而非是否已載入。CLAUDE.md 很適合用於您會提供給新進團隊成員的各類指引，例如專案慣例、建置命令，以及檔案應放置的位置。34如果 `/context` 確認檔案已載入，但 Claude 仍未遵循某項特定指令，問題很可能出在指令的撰寫方式，而非是否已載入。CLAUDE.md 很適合用於您會提供給新進團隊成員的各類指引，例如專案慣例、建置命令，以及檔案應放置的位置。

35 35

116| `settings.json` 值似乎被忽略 | 相同的鍵在 `settings.local.json` 中設定 | `settings.local.json` 會覆寫 `settings.json`，兩者都會覆寫 `~/.claude/settings.json`。請參閱 [settings 優先順序](/docs/zh-TW/settings#settings-precedence)。 |116| `settings.json` 值似乎被忽略 | 相同的鍵在 `settings.local.json` 中設定 | `settings.local.json` 會覆寫 `settings.json`，兩者都會覆寫 `~/.claude/settings.json`。請參閱 [settings 優先順序](/docs/zh-TW/settings#settings-precedence)。 |

118| Skill 出現在 `/skills` 中，但 Claude 從未叫用它 | Skill 在其 frontmatter 中有 `disable-model-invocation: true`，或其描述與您提出請求的方式不符 | 檢查 `/skills` 中的徽章：「user-only」標籤表示 Claude 不會自動觸發它。請參閱 [skill 叫用](/docs/zh-TW/skills)。 |118| Skill 出現在 `/skills` 中，但 Claude 從未叫用它 | Skill 在其 frontmatter 中有 `disable-model-invocation: true`，或其描述與您提出請求的方式不符 | 檢查 `/skills` 中的徽章：「user-only」標籤表示 Claude 不會自動觸發它。請參閱 [skill 叫用](/docs/zh-TW/skills)。 |

119| 子目錄 `CLAUDE.md` 指示似乎被忽略 | 子目錄檔案按需載入，而不是在工作階段開始時載入 | 當 Claude 對該目錄中的檔案使用 Read、Write 或 Edit 工具後才會載入，而不是在啟動時載入。在 v2.1.288 之前，只有 Read 工具會載入它們。請參閱 [CLAUDE.md 檔案如何載入](/docs/zh-TW/memory#how-claude-md-files-load)。 |119| 子目錄 `CLAUDE.md` 指示似乎被忽略 | 子目錄檔案按需載入，而不是在工作階段開始時載入 | 請參閱 [子目錄檔案何時載入](/docs/zh-TW/memory#how-claude-md-files-load)。在 v2.1.288 之前，只有 Read 工具會載入它們。 |

120| 子代理忽略 `CLAUDE.md` 指示 | 內建的 Explore 和 Plan 代理會跳過 `CLAUDE.md`。自訂子代理的載入方式與主對話相同，除非其定義設定 [`omitClaudeMd`](/docs/zh-TW/sub-agents#supported-frontmatter-fields) | 對於 Explore 或 Plan，在您的委派提示中重新陳述指示。對於設定 `omitClaudeMd` 的子代理，移除該欄位。對於任何其他自訂子代理，將關鍵指示放在代理檔案本文中，該本文會成為代理的系統提示。請參閱 [啟動時載入的內容](/docs/zh-TW/sub-agents#what-loads-at-startup)。 |120| 子代理忽略 `CLAUDE.md` 指示 | 內建的 Explore 和 Plan 代理會跳過 `CLAUDE.md`。自訂子代理的載入方式與主對話相同，除非其定義設定 [`omitClaudeMd`](/docs/zh-TW/sub-agents#supported-frontmatter-fields) | 對於 Explore 或 Plan，在您的委派提示中重新陳述指示。對於設定 `omitClaudeMd` 的子代理，移除該欄位。對於任何其他自訂子代理，將關鍵指示放在代理檔案本文中，該本文會成為代理的系統提示。請參閱 [啟動時載入的內容](/docs/zh-TW/sub-agents#what-loads-at-startup)。 |

122| `.mcp.json` 中的 MCP 伺服器永遠不會載入 | 檔案位於 `.claude/` 下，或其伺服器位於頂層 `servers` 鍵下（如 VS Code 的 `mcp.json`），而不是 `mcpServers` | 專案 MCP 設定位於存放庫根目錄的 `.mcp.json`，而不是在 `.claude/` 內，伺服器位於 `mcpServers` 鍵下。請參閱 [MCP 設定](/docs/zh-TW/mcp)。 |122| `.mcp.json` 中的 MCP 伺服器永遠不會載入 | 檔案位於 `.claude/` 下，或其伺服器位於頂層 `servers` 鍵下（如 VS Code 的 `mcp.json`），而不是 `mcpServers` | 專案 MCP 設定位於存放庫根目錄的 `.mcp.json`，而不是在 `.claude/` 內，伺服器位於 `mcpServers` 鍵下。請參閱 [MCP 設定](/docs/zh-TW/mcp)。 |

deep-links.md +1 −1

Details

204 連結呈現為純文字而不是可點擊的204 連結呈現為純文字而不是可點擊的

205</h3>205</h3>

206 206

207某些 Markdown 呈現器只允許 `http` 和 `https` 連結，並移除其他 URL 配置。GitHub 在 README、問題、拉取請求和 wiki 中執行此操作：`[label](claude-cli://...)` 呈現為只是 `label`，沒有連結，URL 被移除。在這些平台上，將深層連結放在程式碼區塊中，以便讀者可以看到 URL 並將其貼到瀏覽器的位址列中。207某些 Markdown 呈現器只允許 `http` 和 `https` 連結，並移除其他 URL 配置。GitHub 在 README、問題、pull request 和 wiki 中執行此操作：`[label](claude-cli://...)` 呈現為 `label`，沒有連結，URL 被移除。在這些平台上，將深層連結放在程式碼區塊中，以便讀者可以看到 URL 並將其貼到瀏覽器的位址列中。

208 208

209<h3 id="the-session-opens-in-my-home-directory-instead-of-the-repo">209<h3 id="the-session-opens-in-my-home-directory-instead-of-the-repo">

210 工作階段在我的主目錄中開啟而不是儲存庫210 工作階段在我的主目錄中開啟而不是儲存庫

desktop.md +68 −61

Details

124 124

125* 直接在「瀏覽器」窗格中與執行中的應用程式互動125* 直接在「瀏覽器」窗格中與執行中的應用程式互動

126* 觀看 Claude 自動驗證其自身的變更：它會擷取螢幕截圖、檢查 DOM、點擊元素、填寫表單，並修復它發現的問題126* 觀看 Claude 自動驗證其自身的變更：它會擷取螢幕截圖、檢查 DOM、點擊元素、填寫表單，並修復它發現的問題

127* 從工作階段工具列中的伺服器下拉式選單啟動或停止伺服器127* 從「瀏覽器」窗格標題列中的**開發伺服器**選單啟動或停止伺服器，或一次停止所有伺服器

128* 通過在下拉式選單中選擇**保留工作階段**，在伺服器重新啟動時保留 Cookie 和本機儲存，因此您在開發期間不必重新登入128* 透過「瀏覽器」窗格 **⋮** 選單中的**保留 Cookie**，選擇「瀏覽器」是否在您結束應用程式後保留 Cookie，因此您在開發期間不必重新登入

129* 編輯伺服器設定或一次停止所有伺服器

130 129

131Claude 根據您的專案建立初始伺服器設定。如果您的應用程式使用自訂開發命令，請編輯 `.claude/launch.json` 以符合您的設定。請參閱[設定預覽伺服器](#configure-preview-servers)以了解完整參考。130Claude 根據您的專案建立初始伺服器設定。如果您的應用程式使用自訂開發命令，請編輯 `.claude/launch.json` 以符合您的設定。請參閱[設定預覽伺服器](#configure-preview-servers)以了解完整參考。

132 131

133若要清除已儲存的工作階段資料，或完全關閉「瀏覽器」，請使用「設定」→「Claude Code」中的切換。132若要清除「瀏覽器」已儲存的資料，請在「瀏覽器」窗格的 **⋮** 選單中選擇**清除瀏覽資料**。若要完全關閉「瀏覽器」，請在**設定 > Claude Code** 中關閉**瀏覽器工具**。

134 133

135<h3 id="browse-external-sites">134<h3 id="browse-external-sites">

136 瀏覽外部網站135 瀏覽外部網站

137</h3>136</h3>

138 137

139「瀏覽器」窗格是一個標籤式瀏覽器，因此您可以在執行中的應用程式旁邊開啟文件、問題追蹤器或任何其他網站。若要開啟「瀏覽器」，請在 macOS 上按 **Cmd+Shift+B**，或在 Windows 上按 **Ctrl+Shift+B**，或從**檢視**選單中選擇它。當您點擊聊天中的外部連結時，選擇器會提供**在應用程式中開啟**以使用「瀏覽器」窗格或**預設瀏覽器**以使用您自己的；在 macOS 上按 **Cmd** 點擊或在 Windows 上按 **Ctrl** 點擊直接在您的系統瀏覽器中開啟連結。您可以登入窗格中的網站，包括彈出式登入流程，例如 Google OAuth。138「瀏覽器」窗格是一個標籤式瀏覽器，因此您可以在執行中的應用程式旁邊開啟文件、問題追蹤器或任何其他網站。若要開啟「瀏覽器」，請在 macOS 上按 **Cmd+Shift+B**，或在 Windows 上按 **Ctrl+Shift+B**，或點擊工作階段標題列中的**瀏覽器**。您可以登入窗格中的網站，包括彈出式登入流程，例如 Google OAuth。

139

140您第一次點擊聊天中的外部連結時，會出現一個對話方塊，詢問連結要在「瀏覽器」窗格中開啟，還是在您的預設瀏覽器中開啟。若要稍後變更您的選擇，請使用「瀏覽器」窗格 **⋮** 選單中的**在內建瀏覽器中開啟連結**。在 macOS 上按 **Cmd** 點擊或在 Windows 上按 **Ctrl** 點擊，會直接在您的預設瀏覽器中開啟連結。

140 141

141Claude 可以使用與[驗證您的應用程式](#preview-your-app)相同的工具讀取和互動外部頁面，並進行兩項額外的安全檢查：142Claude 可以使用與[驗證您的應用程式](#preview-your-app)相同的工具讀取和互動外部頁面，並進行兩項額外的安全檢查：

142 143

184 檢查您的程式碼185 檢查您的程式碼

185</h3>186</h3>

186 187

187在差異檢視中，點擊右上角工具列中的**檢查程式碼**以要求 Claude 在您提交之前評估變更。Claude 會檢查目前的差異並直接在差異檢視中留下評論。您可以回應任何評論或要求 Claude 進行修訂。188若要讓 Claude 在您提交之前審查您的變更，請在[提示詞輸入框](#use-the-prompt-box)中輸入 `/code-review`。審查完成後，結果會出現在對話中。

189

190在本機、[SSH](#ssh-sessions) 和 [WSL](/docs/zh-TW/desktop-wsl) 工作階段中，結果會以**程式碼審查**卡片呈現，並依檔案分組。使用該卡片來處理這些結果：

188 191

189檢查著重於高信號問題：編譯錯誤、明確的邏輯錯誤、安全漏洞和明顯的錯誤。它不會標記樣式、格式、預先存在的問題或 linter 會捕捉的任何內容。192* 點擊**在差異中逐一檢視**以開啟差異檢視，並逐一檢視各項結果。位於目前差異中的結果會顯示在其對應的行，您可以在那裡點擊**修正此項**或將其關閉。

193* 點擊**套用修正**以要求 Claude 修正仍未處理的結果。

194

195在任何工作階段中，您也可以在提示詞輸入框中要求 Claude 修正審查發現的問題。若要了解 `/code-review` 檢查的內容及其接受的引數，請參閱[在本機審查差異](/docs/zh-TW/code-review#review-a-diff-locally)。

190 196

191<h3 id="monitor-pull-request-status">197<h3 id="monitor-pull-request-status">

192 監控提取請求狀態198 監控提取請求狀態

194 200

195開啟提取請求後，CI 狀態列會出現在工作階段中。Claude Code 使用 GitHub CLI 輪詢檢查結果並顯示失敗。201開啟提取請求後，CI 狀態列會出現在工作階段中。Claude Code 使用 GitHub CLI 輪詢檢查結果並顯示失敗。

196 202

197* **自動修復**：啟用後，Claude 會自動嘗試通過讀取失敗輸出並進行迭代來修復失敗的 CI 檢查。203* **自動修復 CI 並處理評論**：啟用後，Claude 會自動嘗試透過讀取失敗輸出並進行迭代來修復失敗的 CI 檢查。在本機工作階段中，當作者是儲存庫擁有者、組織成員、協作者或 GitHub App 時，Claude 也會處理由您以外的人留下的新審查評論。

198* **自動合併**：啟用後，Claude 會在所有檢查通過後合併 PR。合併方法是壓縮。首先在您的 [GitHub 儲存庫設定](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)中啟用自動合併；沒有它，Claude 無法合併 PR。204* **就緒時自動合併**：啟用後，Claude 會在所有檢查通過後合併 PR。合併方法是壓縮。首先在您的 [GitHub 儲存庫設定](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)中啟用自動合併；沒有它，Claude 無法合併 PR。

199 205

200使用 CI 狀態列中的**自動修復**和**自動合併**切換以啟用任一選項。Claude Code 也會在 CI 完成時傳送桌面通知。若要在 PR 合併或關閉後自動封存工作階段，請在「設定」→「Claude Code」中開啟[自動封存](#work-in-parallel-with-sessions)。206若要開啟這些選項，請點擊狀態列中的 **CI**。若要在 PR 合併或關閉後自動封存工作階段，請在**設定 > Claude Code** 中開啟[自動封存](#work-in-parallel-with-sessions)。

201 207

202<Note>208<Note>

203 PR 監控需要在您的機器上安裝並驗證 [GitHub CLI (`gh`)](https://cli.github.com/)。如果未安裝 `gh`，Desktop 會在您首次嘗試建立 PR 時提示您安裝它。209 PR 監控需要在您的機器上安裝並驗證 [GitHub CLI (`gh`)](https://cli.github.com/)。如果未安裝 `gh`，Desktop 會在您首次嘗試建立 PR 時提示您安裝它。

207 安排您的工作區213 安排您的工作區

208</h2>214</h2>

209 215

210Code 標籤是圍繞您可以以任何佈局排列的窗格構建的：聊天、差異、瀏覽器、終端機、檔案、plan、tasks 和 subagent，以及 macOS 上的 [iOS Simulator](/docs/zh-TW/desktop-ios-simulator)。透過其標題拖動窗格以重新定位它，或拖動窗格邊緣以調整其大小。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格。從會話工具列中的 **Views** 選單開啟其他窗格。216Code 標籤是圍繞您可以以任何佈局排列的窗格構建的：聊天、差異、瀏覽器、終端機、檔案、plan、tasks 和 subagent，以及 macOS 上的 [iOS Simulator](/docs/zh-TW/desktop-ios-simulator)。透過其標題拖動窗格以重新定位它，或拖動窗格邊緣以調整其大小。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格。點擊工作階段標題列中的 **Terminal**、**Changes** 或 **Browser** 以開啟終端機、差異或瀏覽器窗格。它們旁邊的 **⋮** 選單可開啟更多窗格（例如 **Files**），並在視窗太窄而無法顯示這些按鈕時收納這些按鈕。

211 217

212若要跨螢幕工作，將窗格（例如差異或終端機）彈出到其自己的視窗中，完成後將其停靠回來。Claude 會在主視窗中繼續工作。218若要跨螢幕工作，將窗格（例如差異或終端機）彈出到其自己的視窗中，完成後將其停靠回來。Claude 會在主視窗中繼續工作。

213 219

219 在終端機中執行命令225 在終端機中執行命令

220</h3>226</h3>

221 227

222整合終端機讓您在會話旁執行命令，而無需切換到另一個應用程式。從 **Views** 選單開啟它，或在 macOS 或 Windows 上按 **Ctrl+\`**。終端機在您會話的工作目錄中開啟，並與 Claude 共用相同的環境，因此 `npm test` 或 `git status` 等命令會看到 Claude 正在編輯的相同檔案。若要開啟第二個終端機標籤，請點擊終端機窗格標題中的 **+** 或右鍵點擊聊天中的資料夾以選擇 **Open in terminal**。終端機僅在本機會話中可用。228整合終端機讓您在工作階段旁執行命令，而無需切換到另一個應用程式。點擊工作階段標題列中的 **Terminal**，或在 macOS 或 Windows 上按 **Ctrl+\`**。終端機在您工作階段的工作目錄中開啟，並與 Claude 共用相同的環境，因此 `npm test` 或 `git status` 等命令會看到 Claude 正在編輯的相同檔案。若要開啟第二個終端機標籤，請點擊終端機窗格標題中的 **+** 或右鍵點擊聊天中的資料夾以選擇 **Open in terminal**。終端機僅在本機工作階段中可用。

223 229

224<h3 id="open-and-edit-files">230<h3 id="open-and-edit-files">

225 開啟和編輯檔案231 開啟和編輯檔案

410 觀看背景任務416 觀看背景任務

411</h3>417</h3>

412 418

413任務窗格顯示在目前工作階段內執行的背景工作：subagents、背景 shell 命令和[動態工作流程](/docs/zh-TW/workflows)。從 **Views** 選單開啟它或將其拖入您的佈局。419任務窗格顯示在目前工作階段內執行的背景工作：subagents、背景 shell 命令和[動態工作流程](/docs/zh-TW/workflows)。當工作階段有背景工作時，請從標題列的 **⋮** 選單中選擇 **Background tasks** 以開啟此窗格。

414 420

415點擊任何項目以在 subagent 窗格中查看其輸出或停止它。若要查看其他工作階段正在執行的操作，請使用[側邊欄](#work-in-parallel-with-sessions)，或詢問 Claude [為您檢查它們](#work-across-sessions)。421點擊任何項目以在 subagent 窗格中查看其輸出或停止它。若要查看其他工作階段正在執行的操作，請使用[側邊欄](#work-in-parallel-with-sessions)，或詢問 Claude [為您檢查它們](#work-across-sessions)。

416 422

518 524

519Claude 會自動偵測您的開發伺服器設定，並將配置儲存在您開始會話時選擇的資料夾根目錄中的 `.claude/launch.json`。Preview 使用此資料夾作為其工作目錄，因此如果您選擇了父資料夾，具有自己開發伺服器的子資料夾將不會自動偵測。若要使用子資料夾的伺服器，請直接在該資料夾中開始會話，或手動新增配置。525Claude 會自動偵測您的開發伺服器設定，並將配置儲存在您開始會話時選擇的資料夾根目錄中的 `.claude/launch.json`。Preview 使用此資料夾作為其工作目錄，因此如果您選擇了父資料夾，具有自己開發伺服器的子資料夾將不會自動偵測。若要使用子資料夾的伺服器，請直接在該資料夾中開始會話，或手動新增配置。

520 526

521若要自訂伺服器的啟動方式，例如使用 `yarn dev` 而不是 `npm run dev` 或變更連接埠，請手動編輯檔案或點擊伺服器下拉式選單中的 **Edit configuration** 以在您的程式碼編輯器中開啟它。該檔案支援帶註解的 JSON。527若要自訂伺服器的啟動方式，例如使用 `yarn dev` 而不是 `npm run dev` 或變更連接埠，請編輯 `.claude/launch.json`。該檔案支援帶註解的 JSON。

522 528

523```json theme={null}529```json theme={null}

524{530{

542 548

543啟用 `autoVerify` 時，Claude 會在編輯檔案後自動驗證程式碼變更。它會擷取螢幕截圖、檢查錯誤，並在完成回應之前確認變更有效。549啟用 `autoVerify` 時，Claude 會在編輯檔案後自動驗證程式碼變更。它會擷取螢幕截圖、檢查錯誤，並在完成回應之前確認變更有效。

544 550

545自動驗證預設為開啟。透過將 `"autoVerify": false` 新增到 `.claude/launch.json`，或從伺服器下拉式選單切換它，按專案停用它。551自動驗證預設為開啟。若要按專案停用，請將 `"autoVerify": false` 新增到 `.claude/launch.json`，或在 Browser 窗格的 **⋮** 選單中關閉 **Auto-verify changes**。

546 552

547```json theme={null}553```json theme={null}

548{554{

766 772

767SSH 會話可讓您在遠端機器上執行 Claude Code，同時使用桌面應用程式作為您的介面。這對於使用存在於雲端虛擬機器、開發容器或具有特定硬體或相依性的伺服器上的程式碼庫很有用。773SSH 會話可讓您在遠端機器上執行 Claude Code，同時使用桌面應用程式作為您的介面。這對於使用存在於雲端虛擬機器、開發容器或具有特定硬體或相依性的伺服器上的程式碼庫很有用。

768 774

769若要新增 SSH 連線，請在開始會話前點擊環境下拉式選單，然後選擇 **+ Add SSH connection**。對話框要求：775若要新增 SSH 連線，請在開始工作階段前於提示詞輸入框中開啟環境下拉式選單，然後選擇 **SSH > Add SSH connection…** 並填寫連線詳細資訊：

770 776

771* **Name**：此連線的友善標籤777* **Name**：此連線的友善標籤

772* **SSH Host**：`user@hostname` 或在 `~/.ssh/config` 中定義的主機778* **SSH host**：`user@hostname` 或在 `~/.ssh/config` 中定義的主機

773* **SSH Port**：如果留空則預設為 22，或使用您的 SSH 配置中的連接埠779* **SSH port**：如果留空則預設為 22，或使用您的 SSH 設定中的連接埠

774* **Identity File**：您的私鑰的路徑，例如 `~/.ssh/id_rsa`。留空以使用預設金鑰或您的 SSH 配置。780* **SSH key (optional)**：您的私鑰的路徑，例如 `~/.ssh/id_ed25519`。留空以使用您的 SSH 設定或 SSH agent。

775 781

776新增後，連線會出現在環境下拉式選單中。選擇它以在該機器上啟動會話。Claude 在遠端機器上執行，可存取其檔案和工具。782新增後，連線會出現在環境下拉式選單的 **SSH** 下方。選擇它以在該機器上啟動工作階段。Claude 在遠端機器上執行，可存取其檔案和工具。

777 783

778遠端機器必須執行 Linux 或 macOS。桌面應用程式會在您第一次連接時自動在遠端機器上安裝 Claude Code。連接後，SSH 會話支援權限模式、連接器、plugins 和 MCP servers。784遠端機器必須執行 Linux 或 macOS。桌面應用程式會在您第一次連接時自動在遠端機器上安裝 Claude Code。連接後，SSH 會話支援權限模式、連接器、plugins 和 MCP servers。

779 785

820`sshHostAllowlist` 僅從受管設定讀取；使用者或專案設定中的值會被忽略。只有 Claude Desktop 應用程式遵守此設定；Claude Code CLI 和 IDE 擴充功能不讀取它，它也不限制透過 Bash 工具執行的 `ssh` 命令。它控制 Desktop 應用程式連接的主機，而不是網路出口，因此如果您需要硬邊界，請將其與您組織的網路或零信任控制配對。826`sshHostAllowlist` 僅從受管設定讀取；使用者或專案設定中的值會被忽略。只有 Claude Desktop 應用程式遵守此設定；Claude Code CLI 和 IDE 擴充功能不讀取它，它也不限制透過 Bash 工具執行的 `ssh` 命令。它控制 Desktop 應用程式連接的主機，而不是網路出口，因此如果您需要硬邊界，請將其與您組織的網路或零信任控制配對。

821 827

822<h2 id="enterprise-configuration">828<h2 id="enterprise-configuration">

823 企業配置829 企業設定

824</h2>830</h2>

825 831

826Teams 或 Enterprise 計畫上的組織可以透過管理員主控台控制、受管設定檔案和裝置管理原則來管理桌面應用程式行為。832Team 或 Enterprise 計畫上的組織可以透過管理員主控台控制、受管設定檔案和裝置管理原則來管理桌面應用程式行為。

827 833

828<h3 id="admin-console-controls">834<h3 id="admin-console-controls">

829 管理員主控台控制835 管理員主控台控制

830</h3>836</h3>

831 837

832這些設定透過[管理員設定主控台](https://claude.ai/admin-settings/claude-code)配置：838這些設定透過[管理員設定主控台](https://claude.ai/admin-settings/claude-code)進行設定：

839

840* **Desktop**：控制您組織中的使用者是否可以在桌面應用程式中存取 Claude Code

841* **雲端工作階段**：為您的組織啟用或停用[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)

842* **Remote Control**：為您的組織啟用或停用 [Remote Control](/docs/zh-TW/remote-control)

833 843

834* **Desktop 中的 Code**：控制您組織中的使用者是否可以在桌面應用程式中存取 Claude Code844在已啟用 HIPAA 的 Enterprise 組織中，**Desktop** 切換開關預設為關閉，[Owner](/docs/zh-TW/server-managed-settings#access-control) 可以將其開啟。套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)會將其關閉，即使先前已開啟也一樣，因此 Owner 之後必須再將其開啟。**雲端工作階段**和 **Remote Control** 預設也為關閉，且一旦組織套用了 HIPAA 設定，Owner 便無法將其開啟。

835* **網路上的 Code**：為您的組織啟用或停用[網路會話](/docs/zh-TW/claude-code-on-the-web)

836* **遠端控制**：為您的組織啟用或停用[遠端控制](/docs/zh-TW/remote-control)

837* **停用略過權限模式**：防止您組織中的使用者啟用略過權限模式

838 845

839<Note>846<Note>

840 OpenTelemetry 表單用於管理員主控台**監控**下的 Cowork，位於[資料和隱私設定](https://claude.ai/admin-settings/data-privacy-controls)，僅適用於 Cowork 會話。在此機器上的 Cowork 會話中，桌面應用程式將該收集器作為 `OTEL_*` 環境變數傳遞給 Claude Code，因此表單會生效，儘管該會話中的 Claude Code [永遠不會擷取管理員主控台設定](#managed-settings)。847 管理員主控台[資料和隱私設定](https://claude.ai/admin-settings/data-privacy-controls)中**監控**下的 Cowork OpenTelemetry 表單僅適用於 Cowork 工作階段。在此機器上的 Cowork 工作階段中，桌面應用程式會將該收集器作為 `OTEL_*` 環境變數傳遞給 Claude Code，因此即使該工作階段中的 Claude Code [永遠不會擷取管理員主控台設定](#managed-settings)，表單仍會生效。

841 848

842 若要從 Code 標籤會話匯出遙測，請在 Claude Code 受管設定的 `env` 區塊中設定 `CLAUDE_CODE_ENABLE_TELEMETRY` 和 `OTEL_*` 變數，如[監控的管理員配置](/docs/zh-TW/monitoring-usage#administrator-configuration)所示。本機、雲端和 SSH 會話各自從不同來源讀取[受管設定](#managed-settings)。有關雲端會話可以到達的主機，請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)。有關 Code 標籤會話報告的 `service.name`，請參閱[服務資訊](/docs/zh-TW/monitoring-usage#service-information)。849 若要從 Code 分頁工作階段匯出遙測，請在 Claude Code 受管設定的 `env` 區塊中設定 `CLAUDE_CODE_ENABLE_TELEMETRY` 和 `OTEL_*` 變數，如[監控的管理員設定](/docs/zh-TW/monitoring-usage#administrator-configuration)所示。本機、雲端和 SSH 工作階段各自[從不同來源讀取受管設定](#managed-settings)。有關雲端工作階段可以連線的主機，請參閱[網路存取](/docs/zh-TW/cloud-environments#network-access)。有關 Code 分頁工作階段回報的 `service.name`，請參閱[服務資訊](/docs/zh-TW/monitoring-usage#service-information)。

843</Note>850</Note>

844 851

845<h3 id="managed-settings">852<h3 id="managed-settings">

846 受管設定853 受管設定

847</h3>854</h3>

848 855

849受管設定會覆蓋專案和使用者設定，並在 Desktop 中的 Claude Code 會話時套用。您可以在您組織的[受管設定](/docs/zh-TW/managed-settings)檔案中設定這些金鑰，或透過管理員主控台遠端推送它們。856受管設定會覆寫專案和使用者設定，並套用於 Desktop 中的 Claude Code 工作階段。您可以在您組織的[受管設定](/docs/zh-TW/managed-settings)檔案中設定這些鍵，或透過管理員主控台遠端推送它們。

850 857

851| 金鑰 | 描述 |858| 鍵 | 描述 |

852| - | - |859| - | - |

854| `disableAutoMode` | 設定為 `"disable"` 以從模式選擇器中移除 [Auto](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 模式。也在 `permissions` 下接受。 |861| `disableAutoMode` | 設定為 `"disable"` 以從模式選擇器中移除 [Auto](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 模式。也可放在 `permissions` 下。 |

856| `browserExternalPageTools` | 設定為 `"disabled"` 以防止 Claude 使用工具來讀取或作用於[瀏覽器窗格](#browse-external-sites)中的外部頁面。使用者仍然可以自行瀏覽外部網站，本機開發伺服器預覽不受影響。 |863| `browserExternalPageTools` | 設定為 `"disabled"` 以防止 Claude 使用工具來讀取或操作[瀏覽器窗格](#browse-external-sites)中的外部頁面。使用者仍然可以自行瀏覽外部網站，本機開發伺服器預覽不受影響。 |

857| `disableMobileSimulatorTools` | 設定為 `true` 以阻止 Claude 在 [iOS Simulator 窗格](/docs/zh-TW/desktop-ios-simulator#turn-off-simulator-access)中控制和擷取裝置的工具。該窗格仍可供使用者自己的點擊使用；只有 Claude 的存取被移除。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |864| `disableMobileSimulatorTools` | 設定為 `true` 以封鎖 Claude 在 [iOS Simulator 窗格](/docs/zh-TW/desktop-ios-simulator#turn-off-simulator-access)中控制和擷取裝置的工具。該窗格仍可供使用者自行點擊使用；只有 Claude 的存取被移除。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |

858| `disableBrowserExternalNavigation` | 設定為 `true` 以完全關閉[瀏覽器窗格](#browse-external-sites)中的外部瀏覽。使用者和 Claude 都無法瀏覽外部網站，localhost 開發伺服器預覽不受影響。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |865| `disableBrowserExternalNavigation` | 設定為 `true` 以完全關閉[瀏覽器窗格](#browse-external-sites)中的外部瀏覽。使用者和 Claude 都無法瀏覽外部網站，localhost 開發伺服器預覽不受影響。該值必須是 JSON 布林值 `true`；字串 `"true"` 會被忽略。 |

860| `sshHostAllowlist` | 限制 [SSH 會話](#restrict-which-ssh-hosts-users-can-connect-to)連線到已解析主機名稱符合這些模式之一的主機。空陣列會停用 SSH 會話。僅從受管設定讀取。 |867| `sshHostAllowlist` | 將 [SSH 工作階段](#restrict-which-ssh-hosts-users-can-connect-to)限制在已解析主機名稱符合這些模式之一的主機。空陣列會停用 SSH 工作階段。僅從受管設定讀取。 |

861| `disableDesktopLocalSessions` | 設定為 `true` 以關閉[在裝置上執行的 Code 會話](#local-sessions-on-managed-devices)，只保留 SSH 會話到其他主機和雲端會話。該值必須是 JSON 布林值 `true`。僅從受管設定讀取。需要 Claude Desktop v1.37937.0 或更新版本。 |868| `disableDesktopLocalSessions` | 設定為 `true` 以關閉[在裝置上執行的 Code 工作階段](#local-sessions-on-managed-devices)，僅保留連線到其他主機的 SSH 工作階段和雲端工作階段。該值必須是 JSON 布林值 `true`。僅從受管設定讀取。需要 Claude Desktop v1.37937.0 或更新版本。 |

862| `managedMcpServers` | 將 MCP 伺服器配置推送到所有使用者。僅在第三方 (3P) Desktop 部署中可用。在每個項目中，設定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸、連線詳細資訊，以及可選的 `toolPolicy` 對應，限制該伺服器中使用者可以叫用的工具。透過受管設定檔案、MDM 或 Claude apps gateway 原則的 [`desktop` 區塊](/docs/zh-TW/claude-apps-gateway-config#claude-desktop-overlay)傳遞，因為第三方部署不會收到管理員主控台設定。若要透過閘道傳遞，您需要閘道伺服器上的 Claude Code v2.1.232 或更新版本。這是桌面應用程式自己的金鑰；Claude Code 讀取自己的[同名受管設定](/docs/zh-TW/managed-mcp#provide-servers-through-managed-settings)，具有不同的項目形狀。 |869| `managedMcpServers` | 將 MCP 伺服器設定推送給所有使用者。僅在第三方 (3P) Desktop 部署中可用。在每個項目中，設定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸方式、連線詳細資訊，以及可選的 `toolPolicy` 對應，以限制使用者可以叫用該伺服器的哪些工具。請透過受管設定檔案、MDM 或 Claude apps gateway 原則的 [`desktop` 區塊](/docs/zh-TW/claude-apps-gateway-config#claude-desktop-overlay)傳遞，因為第三方部署不會收到管理員主控台設定。若要透過閘道傳遞，您需要在閘道伺服器上使用 Claude Code v2.1.232 或更新版本。這是桌面應用程式自己的鍵；Claude Code 會讀取自己的[同名受管設定](/docs/zh-TW/managed-mcp#provide-servers-through-managed-settings)，其項目結構不同。 |

863 870

864哪些受管設定到達 Desktop 會話取決於該會話執行的位置。模型限制（例如 [`availableModels`](/docs/zh-TW/model-config#restrict-model-selection)）在 Desktop 的 Claude Code 會話中的強制方式與終端 CLI 相同；請參閱[表面涵蓋範圍](/docs/zh-TW/model-config#surface-coverage)。871哪些受管設定會套用到 Desktop 工作階段，取決於該工作階段執行的位置。模型限制（例如 [`availableModels`](/docs/zh-TW/model-config#restrict-model-selection)）在 Desktop 的 Claude Code 工作階段中的強制方式與終端機 CLI 相同；請參閱[使用介面涵蓋範圍](/docs/zh-TW/model-config#surface-coverage)。

865 872

866* **此機器上的本機會話**：部署到磁碟的受管設定檔案適用。透過管理員主控台推送的遠端受管設定在會話使用[符合條件的登入或金鑰](/docs/zh-TW/server-managed-settings#platform-availability)向 Anthropic 的 API 進行驗證時也會到達這些會話，遵循與終端 CLI 相同的[設定優先順序](/docs/zh-TW/settings#settings-precedence)。873* **此機器上的本機工作階段**：部署到磁碟的受管設定檔案會套用。當工作階段使用[符合條件的登入或金鑰](/docs/zh-TW/server-managed-settings#platform-availability)向 Anthropic 的 API 進行身分驗證時，透過管理員主控台遠端推送的受管設定也會套用到這些工作階段，並遵循與終端機 CLI 相同的[設定優先順序](/docs/zh-TW/settings#settings-precedence)。

867* **[雲端會話](#cloud-sessions)**：接收[伺服器管理的設定](/docs/zh-TW/server-managed-settings)；裝置部署的檔案無法到達它們，因為它們在 Anthropic 管理的 VM 上執行。路由到[自託管環境](/docs/zh-TW/self-hosted-environments)的會話也讀取執行器映像中的受管設定檔案。[Claude Code 如何結合受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明該檔案何時適用。874* **[雲端工作階段](#cloud-sessions)**：接收[伺服器管理的設定](/docs/zh-TW/server-managed-settings)；裝置部署的檔案不會套用到它們，因為它們在 Anthropic 管理的 VM 上執行。路由到[自託管環境](/docs/zh-TW/self-hosted-environments)的工作階段也會讀取執行器映像中的受管設定檔案。[Claude Code 如何結合受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明該檔案何時適用。

868* **[SSH 會話](#ssh-sessions)**：會話從遠端主機讀取受管設定檔案。Desktop 本身從本機機器的受管設定讀取 `sshConfigs`、`sshHostAllowlist` 和 `disableDesktopLocalSessions`。875* **[SSH 工作階段](#ssh-sessions)**：工作階段從遠端主機讀取受管設定檔案。Desktop 本身會從本機的受管設定讀取 `sshConfigs`、`sshHostAllowlist` 和 `disableDesktopLocalSessions`。

869* **[Cowork](https://claude.com/docs/cowork/overview) 會話**：在此機器上的 Cowork 會話中，Claude Code 永遠不會擷取管理員主控台設定，即使使用者使用 Team 或 Enterprise 帳戶登入，並讀取部署到機器的原則，除非您的 Claude Desktop 配置設定 `requireCoworkFullVmSandbox`。遠端 Cowork 會話都不會接收。請參閱[原則適用的位置和時間](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)以了解哪些裝置檔案到達 Cowork，以及[MCP 權限規則](/docs/zh-TW/permissions#mcp)以了解 `Bash` 和 `WebFetch` 規則如何適用於 Cowork 的工具。876* **[Cowork](https://claude.com/docs/cowork/overview) 工作階段**：在此機器上的 Cowork 工作階段中，即使使用者以 Team 或 Enterprise 帳戶登入，Claude Code 也永遠不會擷取管理員主控台設定，並且會讀取部署到機器的原則，除非您的 Claude Desktop 設定設有 `requireCoworkFullVmSandbox`。遠端 Cowork 工作階段兩者皆不會接收。請參閱[原則適用的位置和時間](/docs/zh-TW/managed-settings#where-and-when-a-policy-applies)以了解哪些裝置檔案會套用到 Cowork，以及 [MCP 權限規則](/docs/zh-TW/permissions#mcp)以了解 `Bash` 和 `WebFetch` 規則如何套用於 Cowork 的工具。

870 877

871在本機和 SSH 會話中，桌面應用程式直接將每個使用者連線的 claude.ai 連接器傳遞給 Claude Code。無論您使用哪個設定來源或檔案位置，都沒有 MCP 設定或 `managed-mcp.json` 到達這些連接器。若要在這些會話中阻止連接器的工具，請使用您組織的[連接器工具控制](/docs/zh-TW/mcp#organization-controls-on-connector-tools)。[連接器如何到達 Claude Code](/docs/zh-TW/mcp#how-connectors-reach-claude-code)顯示哪些設定在每種會話中管理連接器。878在本機和 SSH 工作階段中，桌面應用程式會直接將每個使用者已連線的 claude.ai 連接器傳遞給 Claude Code。無論您使用哪個設定來源或檔案位置，任何 MCP 設定或 `managed-mcp.json` 都不會影響這些連接器。若要在這些工作階段中封鎖連接器的工具，請使用您組織的[連接器工具控制](/docs/zh-TW/mcp#organization-controls-on-connector-tools)。[連接器如何到達 Claude Code](/docs/zh-TW/mcp#how-connectors-reach-claude-code) 說明在每種工作階段中由哪些設定管理連接器。

872 879

873`permissions.disableBypassPermissionsMode` 和 `disableAutoMode` 也在使用者和專案設定中運作，但將它們放在受管設定中可防止使用者覆蓋它們。880`permissions.disableBypassPermissionsMode` 和 `disableAutoMode` 也可在使用者和專案設定中運作，但將它們放在受管設定中可防止使用者覆寫它們。

874 881

875有關只有受管來源可以設定的權限、外掛程式和傳遞金鑰，請參閱[只有受管設定可以設定的金鑰](/docs/zh-TW/managed-settings#managed-only-settings)。882有關只有受管來源可以設定的權限、外掛和傳遞鍵，請參閱[只有受管設定可以設定的鍵](/docs/zh-TW/managed-settings#managed-only-settings)。

876 883

877<h3 id="device-management-policies">884<h3 id="device-management-policies">

878 裝置管理原則885 裝置管理原則

880 887

881IT 團隊可以透過 macOS 上的 MDM 或 Windows 上的群組原則來管理桌面應用程式。可用的原則包括啟用或停用 Claude Code 功能、控制自動更新和設定自訂部署 URL。888IT 團隊可以透過 macOS 上的 MDM 或 Windows 上的群組原則來管理桌面應用程式。可用的原則包括啟用或停用 Claude Code 功能、控制自動更新和設定自訂部署 URL。

882 889

883* **macOS**：使用 Jamf 或 Kandji 等工具透過 `com.anthropic.claudefordesktop` 偏好設定網域配置890* **macOS**：使用 Jamf 或 Kandji 等工具透過 `com.anthropic.claudefordesktop` 偏好設定網域進行設定

884* **Windows**：透過 `SOFTWARE\Policies\Claude` 的登錄配置891* **Windows**：透過位於 `SOFTWARE\Policies\Claude` 的登錄進行設定

885 892

886<h3 id="network-access-requirements">893<h3 id="network-access-requirements">

887 網路存取需求894 網路存取需求

902*.claudemcpcontent.com909*.claudemcpcontent.com

903```910```

904 911

905流量在連接埠 443 上使用 HTTPS，除非您為 [OTLP](/docs/zh-TW/monitoring-usage)、LLM 閘道或 MCP 伺服器配置自訂連接埠。912除非您為 [OTLP](/docs/zh-TW/monitoring-usage)、LLM 閘道或 MCP 伺服器設定自訂連接埠，否則流量皆為連接埠 443 上的 HTTPS。

906 913

907對於代理伺服器、自訂憑證授權單位、mTLS 和獨立 CLI 需要的網域，請參閱[網路配置](/docs/zh-TW/network-config)。914有關代理伺服器、自訂憑證授權單位、mTLS 和獨立 CLI 所需的網域，請參閱[網路設定](/docs/zh-TW/network-config)。

908 915

909若要減少防火牆萬用字元的數量，請改為允許這些 Anthropic 主機。某些子網域是動態產生的，必須保持為萬用字元。916若要減少防火牆萬用字元的數量，請改為允許這些 Anthropic 主機。某些子網域是動態產生的，必須保持為萬用字元。

910 917

928*.claudemcpcontent.com935*.claudemcpcontent.com

929```936```

930 937

931如果您的組織已[啟用 IP 允許清單](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)用於 Claude，請透過與 `claude.ai` 和 `api.anthropic.com` 相同的代理出口路由 `bridge.claudeusercontent.com`。如果您無法以這種方式路由它，請將您的代理用於該主機的出口位址新增到您組織的 IP 允許清單，但僅當該位址專用於您的組織時：共用代理出口範圍也允許代理廠商的其他客戶。938如果您的組織已為 Claude 啟用 [IP 允許清單](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)，請將 `bridge.claudeusercontent.com` 透過與 `claude.ai` 和 `api.anthropic.com` 相同的代理伺服器出口路由。如果您無法以這種方式路由，請將您的代理伺服器用於該主機的出口位址新增到您組織的 IP 允許清單，但僅限該位址專屬於您的組織時：共用的代理伺服器出口範圍也會放行該代理伺服器廠商的其他客戶。

932 939

933Anthropic 使用它們到達的位址檢查與該主機的連線是否符合您組織的 IP 允許清單。如果您的代理透過不在該允許清單上的位址為其傳送流量，Chrome 中的 Claude 和透過橋接連線的其他功能會停止運作，而應用程式的其餘部分會繼續運作。940Anthropic 會依據連線來源的位址，檢查與該主機的連線是否符合您組織的 IP 允許清單。如果您的代理伺服器透過不在該允許清單上的位址傳送該主機的流量，Claude in Chrome 和其他透過橋接連線的功能會停止運作，而應用程式的其餘部分則會繼續運作。

934 941

935從 [Google Fonts](/docs/zh-TW/artifacts#improve-the-visual-design) 載入字體的[成品](/docs/zh-TW/artifacts)也會要求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。兩個主機都是選用的。如果您阻止它們，成品會以備用字體呈現。使用快速拒絕而不是無聲丟棄來阻止，以便字體要求立即失敗，而不是延遲頁面的首次呈現。942從 [Google Fonts](/docs/zh-TW/artifacts#improve-the-visual-design) 載入字體的 [artifact](/docs/zh-TW/artifacts) 也會請求 `fonts.googleapis.com` 和 `fonts.gstatic.com`。這兩個主機都是選用的。如果您封鎖它們，artifact 會以備援字體呈現。請以快速拒絕而非無聲丟棄的方式封鎖，讓字體請求立即失敗，而不會延遲頁面的首次呈現。

936 943

937成品也可以從 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com`、`code.jquery.com` 和 `unpkg.com` 載入 JavaScript 程式庫（例如 React 或圖表套件），而不是從任何其他外部主機。如果您阻止這些主機，成品中依賴程式庫的部分無法運作，與阻止的字體不同，阻止的程式庫沒有備用方案。也在這裡使用快速拒絕，以便阻止的程式庫要求立即失敗，而不是掛起直到逾時。944Artifact 也可以從 `cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`cdn.tailwindcss.com`、`code.jquery.com` 和 `unpkg.com` 載入 JavaScript 程式庫（例如 React 或圖表套件），且不會從其他任何外部主機載入。如果您封鎖這些主機，artifact 中依賴程式庫的部分將無法運作，而且與被封鎖的字體不同，被封鎖的程式庫沒有備援。此處同樣請以快速拒絕的方式封鎖，讓被封鎖的程式庫請求立即失敗，而不是懸置直到逾時。

938 945

939<h3 id="authentication-and-sso">946<h3 id="authentication-and-sso">

940 驗證和 SSO947 身分驗證和 SSO

941</h3>948</h3>

942 949

943Team 和 Enterprise 組織可以要求所有使用者進行 SSO。有關計畫級別的詳細資訊，請參閱[驗證](/docs/zh-TW/authentication)，以及有關 SAML 配置，請參閱[設定 SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)；OIDC 設定涵蓋在 [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) 中。950Team 和 Enterprise 組織可以要求所有使用者使用 SSO。有關計畫層級的詳細資訊，請參閱[身分驗證](/docs/zh-TW/authentication)；有關 SAML 設定，請參閱[設定 SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)；OIDC 設定則涵蓋在 [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide) 中。

944 951

945<h3 id="data-handling">952<h3 id="data-handling">

946 資料處理953 資料處理

947</h3>954</h3>

948 955

949Claude Code 在本機會話中本機處理您的程式碼，或在雲端會話中在 Anthropic 管理的基礎設施上處理，除非您的組織將它們路由到[自託管環境](/docs/zh-TW/self-hosted-environments)。雲端會話（包括在自託管環境中）將對話和程式碼上下文傳送到 Anthropic 的 API 進行處理；本機和 SSH 會話將它們傳送到您的部署配置的任何[模型提供者](#feature-comparison)，預設為 Anthropic 的 API。有關資料保留、隱私和合規性的詳細資訊，請參閱[資料處理](/docs/zh-TW/data-usage)。956Claude Code 在本機工作階段中於本機處理您的程式碼，或在雲端工作階段中於 Anthropic 管理的基礎設施上處理，除非您的組織將它們路由到[自託管環境](/docs/zh-TW/self-hosted-environments)。雲端工作階段（包括在自託管環境中）會將對話和程式碼上下文傳送到 Anthropic 的 API 進行處理；本機和 SSH 工作階段則會將它們傳送到您的部署所設定的[模型提供者](#feature-comparison)，預設為 Anthropic 的 API。有關資料保留、隱私和合規性的詳細資訊，請參閱[資料處理](/docs/zh-TW/data-usage)。

950 957

951<h3 id="deployment">958<h3 id="deployment">

952 部署959 部署

957* **macOS**：透過 MDM（例如 Jamf 或 Kandji）使用 `.dmg` 安裝程式分發964* **macOS**：透過 MDM（例如 Jamf 或 Kandji）使用 `.dmg` 安裝程式分發

958* **Windows**：透過 MSIX 套件部署。有關企業部署選項（包括無聲安裝），請參閱[為 Windows 部署 Claude Desktop](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows)965* **Windows**：透過 MSIX 套件部署。有關企業部署選項（包括無聲安裝），請參閱[為 Windows 部署 Claude Desktop](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows)

959 966

960有關防火牆中要允許清單的網域，請參閱上面的[網路存取需求](#network-access-requirements)。有關代理設定、自訂憑證授權單位和 LLM 閘道，請參閱[網路配置](/docs/zh-TW/network-config)。967有關需在防火牆中加入允許清單的網域，請參閱上方的[網路存取需求](#network-access-requirements)。有關代理伺服器設定、自訂憑證授權單位和 LLM 閘道，請參閱[網路設定](/docs/zh-TW/network-config)。

961 968

962有關完整的企業配置參考，請參閱[企業配置指南](https://support.claude.com/en/articles/12622667-enterprise-configuration)。969有關完整的企業設定參考，請參閱[企業設定指南](https://support.claude.com/en/articles/12622667-enterprise-configuration)。

963 970

964<h2 id="coming-from-the-cli">971<h2 id="coming-from-the-cli">

965 來自 CLI？972 來自 CLI？

1155 在 CLI 中開啟時「分支尚不存在」1162 在 CLI 中開啟時「分支尚不存在」

1156</h3>1163</h3>

1157 1164

1158遠端會話可以建立在您的本機機器上不存在的分支。點擊會話工具列中的分支名稱以複製它，然後在本機提取它：1165雲端工作階段可以建立在您的本機機器上不存在的分支。點擊工作階段中的分支名稱並選擇 **Copy branch name**，然後在本機提取它：

1159 1166

1160```bash theme={null}1167```bash theme={null}

1161git fetch origin <branch-name>1168git fetch origin <branch-name>

desktop-ios-simulator.md +1 −1

Details

77 77

78Claude 啟動的裝置也會出現在 Apple 的 Simulator 應用程式中，或在 Xcode 27 的 Device Hub 中。Claude 可以在您已經啟動的裝置上安裝應用程式。78Claude 啟動的裝置也會出現在 Apple 的 Simulator 應用程式中，或在 Xcode 27 的 Device Hub 中。Claude 可以在您已經啟動的裝置上安裝應用程式。

79 79

80您也可以自己開啟模擬器窗格。一旦工作階段有附加的模擬器或已編輯 Swift 檔案，工作階段工具列中的 **Views** 功能表會顯示 **iOS Simulator** 項目。如果窗格尚未顯示裝置，請按一下 **Attach simulator**，或從旁邊的裝置功能表中選擇特定裝置；選擇已關閉的裝置會啟動它。如果 Xcode 或其模擬器遺失，窗格會改為顯示設定步驟，並在您完成每個步驟時檢查它們。80您也可以自己開啟模擬器窗格。一旦工作階段已附加模擬器，或 Claude Code 偵測到 iOS 應用程式相關工作，工作階段的標題列中就會出現 **iOS Simulator** 按鈕。如果窗格尚未顯示裝置，請按一下 **Attach simulator**，或從旁邊的裝置功能表中選擇特定裝置；選擇已關閉的裝置會啟動它。如果 Xcode 或其模擬器遺失，窗格會改為顯示設定步驟，並在您完成每個步驟時將其勾選。

81 81

82<h2 id="control-the-simulator-yourself">82<h2 id="control-the-simulator-yourself">

83 自己控制模擬器83 自己控制模擬器

desktop-quickstart.md +1 −1

Details

116 116

117**使用 skills 執行可重複的工作。** 輸入 `/` 或點擊 **+** → **Slash commands** 以瀏覽[內建命令](/docs/zh-TW/commands)、[自訂 skills](/docs/zh-TW/skills) 和外掛 skills。Skills 是可重複使用的提示，您可以在需要時隨時叫用，例如程式碼審查檢查清單或部署步驟。117**使用 skills 執行可重複的工作。** 輸入 `/` 或點擊 **+** → **Slash commands** 以瀏覽[內建命令](/docs/zh-TW/commands)、[自訂 skills](/docs/zh-TW/skills) 和外掛 skills。Skills 是可重複使用的提示，您可以在需要時隨時叫用，例如程式碼審查檢查清單或部署步驟。

118 118

119**在提交前檢查變更。** Claude 編輯檔案後，會出現 `+12 -1` 指示器。點擊它以開啟[差異檢視](/docs/zh-TW/desktop#review-changes-with-diff-view)，逐個檔案檢查修改，並在特定行上留下評論。Claude 會讀取您的評論並進行修訂。點擊**檢查程式碼**讓 Claude 自行評估差異並留下內嵌建議。119**在提交前檢查變更。** Claude 編輯檔案後，會出現 `+12 -1` 指示器。點擊它以開啟[差異檢視](/docs/zh-TW/desktop#review-changes-with-diff-view)，逐個檔案檢查修改，並在特定行上留下評論。Claude 會讀取您的評論並進行修訂。若要讓 Claude 自行審查變更，請在提示詞輸入框中輸入 [`/code-review`](/docs/zh-TW/desktop#review-your-code)。

120 120

121**調整您擁有的控制程度。** 您的[權限模式](/docs/zh-TW/desktop#choose-a-permission-mode)設定了 Claude 在不請求批准的情況下可以執行的操作：121**調整您擁有的控制程度。** 您的[權限模式](/docs/zh-TW/desktop#choose-a-permission-mode)設定了 Claude 在不請求批准的情況下可以執行的操作：

122 122

desktop-scheduled-tasks.md +1 −1

Details

83 83

84當應用程式啟動或您的電腦喚醒時，Desktop 會檢查每個任務是否在過去七天內錯過了任何執行。如果有，Desktop 會為最近錯過的時間啟動恰好一次的追趕執行，並丟棄任何較舊的執行。錯過六天的每日任務在喚醒時執行一次。Desktop 會在追趕執行啟動時顯示通知。84當應用程式啟動或您的電腦喚醒時，Desktop 會檢查每個任務是否在過去七天內錯過了任何執行。如果有，Desktop 會為最近錯過的時間啟動恰好一次的追趕執行，並丟棄任何較舊的執行。錯過六天的每日任務在喚醒時執行一次。Desktop 會在追趕執行啟動時顯示通知。

85 85

86在撰寫提示時請記住這一點。排程在上午 9 點的任務可能在晚上 11 點執行，如果您的電腦整天都在睡眠狀態。如果時間很重要，請在提示本身中新增護欄，例如：「只審查今天的提交。如果已經過下午 5 點，請跳過審查，只發佈錯過內容的摘要。」86在撰寫提示詞時請記住這一點。排程在上午 9 點的任務可能在晚上 11 點執行，如果您的電腦整天都在睡眠狀態。如果時間很重要，請在提示詞本身中新增護欄，例如：「只審查今天的提交。如果已經過下午 5 點，請跳過審查，只發佈錯過內容的摘要。」

87 87

88<h2 id="permissions-for-scheduled-tasks">88<h2 id="permissions-for-scheduled-tasks">

89 排程任務的權限89 排程任務的權限

env-vars.md +4 −2

Details

195| `BASH_DEFAULT_TIMEOUT_MS` | 前景 Bash 或 PowerShell 工具命令的預設逾時，以毫秒為單位（預設：120000，即 2 分鐘）。超過 30 分鐘的預設值，也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的預設值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |195| `BASH_DEFAULT_TIMEOUT_MS` | 前景 Bash 或 PowerShell 工具命令的預設逾時，以毫秒為單位（預設：120000，即 2 分鐘）。超過 30 分鐘的預設值，也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的預設值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code 讀回命令結果中的 bash 輸出字元數上限（預設：30000；最大值：150000）。如果您設定了 [`bashOutputMaxChars`](/docs/zh-TW/settings-reference#bashoutputmaxchars) 設定，Claude Code 會忽略此變數。請參閱[輸出限制](/docs/zh-TW/tools-reference#output-limits) |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code 讀回命令結果中的 bash 輸出字元數上限（預設：30000；最大值：150000）。如果您設定了 [`bashOutputMaxChars`](/docs/zh-TW/settings-reference#bashoutputmaxchars) 設定，Claude Code 會忽略此變數。請參閱[輸出限制](/docs/zh-TW/tools-reference#output-limits) |

197| `BASH_MAX_TIMEOUT_MS` | 模型可為前景 Bash 或 PowerShell 工具命令設定的逾時上限，以毫秒為單位（預設：600000，即 10 分鐘）。實際上限為此值與 `BASH_DEFAULT_TIMEOUT_MS` 中的較大者。超過 2 小時的實際上限，也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的最大值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |197| `BASH_MAX_TIMEOUT_MS` | 模型可為前景 Bash 或 PowerShell 工具命令設定的逾時上限，以毫秒為單位（預設：600000，即 10 分鐘）。實際上限為此值與 `BASH_DEFAULT_TIMEOUT_MS` 中的較大者。超過 2 小時的實際上限，也會成為無人值守工作階段中[背景命令時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)的最大值。背景時間限制需要 Claude Code v2.1.285 或更新版本 |

198| `BETA_TRACING_ENDPOINT` | [詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)的 OTLP 端點：搭配 `ENABLE_BETA_TRACING_DETAILED=1` 時，日誌和追蹤會傳送至此處，而非已設定的匯出器。請在您的 shell、使用者設定或受管設定中設定。在[專案和本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |198| `BETA_TRACING_ENDPOINT` | [詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)的 OTLP/HTTP 端點：搭配 `ENABLE_BETA_TRACING_DETAILED=1` 時，日誌與追蹤會傳送至此處，而非已設定的匯出器。請在您的 shell、使用者設定或受管設定中設定此變數。在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中會被忽略 |

199| `CCR_FORCE_BUNDLE` | 設為 `1` 可強制 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github) 打包並上傳您的本機儲存庫，而非從其遠端複製 |199| `CCR_FORCE_BUNDLE` | 設為 `1` 可強制 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#send-local-repositories-without-github) 打包並上傳您的本機儲存庫，而非從其遠端複製 |

200| `CLAUDECODE` | 在 Claude Code 產生的子程序中設為 `1`（Bash 和 PowerShell 工具、tmux 工作階段、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令、stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序）。IDE 擴充功能也會在其整合式終端機中設定此變數。用於偵測指令碼是否在 Claude Code 產生的子程序中執行。若要檢查目前程序是否由工具呼叫或 hook 直接產生，而非在 Claude Code 啟動的 stdio MCP 伺服器內，請改用 `CLAUDE_CODE_CHILD_SESSION` |200| `CLAUDECODE` | 在 Claude Code 產生的子程序中設為 `1`（Bash 和 PowerShell 工具、tmux 工作階段、[hook](/docs/zh-TW/hooks) 命令、[狀態列](/docs/zh-TW/statusline)命令、stdio [MCP 伺服器](/docs/zh-TW/mcp)子程序）。IDE 擴充功能也會在其整合式終端機中設定此變數。用於偵測指令碼是否在 Claude Code 產生的子程序中執行。若要檢查目前程序是否由工具呼叫或 hook 直接產生，而非在 Claude Code 啟動的 stdio MCP 伺服器內，請改用 `CLAUDE_CODE_CHILD_SESSION` |

201| `CLAUDE_AFK_COUNTDOWN_MS` | 未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話方塊在自動繼續之前多少毫秒，畫面上會出現倒數計時。預設 `20000`（20 秒），上限為自動繼續逾時。除非已開啟自動繼續，否則沒有作用；請參閱 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定和 `CLAUDE_AFK_TIMEOUT_MS`。需要 Claude Code v2.1.198 或更新版本 |201| `CLAUDE_AFK_COUNTDOWN_MS` | 未回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話方塊在自動繼續之前多少毫秒，畫面上會出現倒數計時。預設 `20000`（20 秒），上限為自動繼續逾時。除非已開啟自動繼續，否則沒有作用；請參閱 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定和 `CLAUDE_AFK_TIMEOUT_MS`。需要 Claude Code v2.1.198 或更新版本 |

287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設為 `1` 可在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令，而非透過 `cmd.exe` 啟動器。根據預設，啟動器可讓[在背景執行](/docs/zh-TW/tools-reference#background-commands)的 PowerShell 命令[延續至工作階段的下一個程序](/docs/zh-TW/agent-view#the-supervisor-process)，例如當您[將工作階段移至背景](/docs/zh-TW/agent-view#from-inside-a-session)時。如果您設定此變數，移至背景的 PowerShell 命令會在工作階段程序結束時停止。Bash 命令不受影響。需要 Claude Code v2.1.269 或更新版本 |287| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | 設為 `1` 可在 Windows 上直接啟動 [PowerShell 工具](/docs/zh-TW/tools-reference#powershell-tool)命令，而非透過 `cmd.exe` 啟動器。根據預設，啟動器可讓[在背景執行](/docs/zh-TW/tools-reference#background-commands)的 PowerShell 命令[延續至工作階段的下一個程序](/docs/zh-TW/agent-view#the-supervisor-process)，例如當您[將工作階段移至背景](/docs/zh-TW/agent-view#from-inside-a-session)時。如果您設定此變數，移至背景的 PowerShell 命令會在工作階段程序結束時停止。Bash 命令不受影響。需要 Claude Code v2.1.269 或更新版本 |

288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設為 `1` 可停用[工作流程](/docs/zh-TW/workflows#turn-workflows-off)。等同於 [`disableWorkflows`](/docs/zh-TW/settings-reference#disableworkflows) 設定 |288| `CLAUDE_CODE_DISABLE_WORKFLOWS` | 設為 `1` 可停用[工作流程](/docs/zh-TW/workflows#turn-workflows-off)。等同於 [`disableWorkflows`](/docs/zh-TW/settings-reference#disableworkflows) 設定 |

289| `CLAUDE_CODE_EFFORT_LEVEL` | 設定支援之模型的 effort 等級。值：`low`、`medium`、`high`、`xhigh`、`max`，或 `auto` 以使用模型預設值。可用的等級取決於模型。優先於 `--effort`、`/effort`，以及 `modelSettings` 和 `effortLevel` 設定。[`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) 上限仍然適用。請參閱[調整 effort 等級](/docs/zh-TW/model-config#adjust-effort-level) |289| `CLAUDE_CODE_EFFORT_LEVEL` | 設定支援之模型的 effort 等級。值：`low`、`medium`、`high`、`xhigh`、`max`，或 `auto` 以使用模型預設值。可用的等級取決於模型。優先於 `--effort`、`/effort`，以及 `modelSettings` 和 `effortLevel` 設定。[`maxEffortLevel`](/docs/zh-TW/settings-reference#maxeffortlevel) 上限仍然適用。請參閱[調整 effort 等級](/docs/zh-TW/model-config#adjust-effort-level) |

290| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | 設為 `1` 可將帶有工作階段狀態的 [`session_state_changed`](/docs/zh-TW/agent-sdk/typescript#sdksessionstatechangedmessage) 訊息加入訊息串流。需要 [Agent SDK](/docs/zh-TW/agent-sdk/overview)，或同時使用 `--print`、`--output-format stream-json` 與 `--verbose` |

290| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 為了與舊版相容而接受，但不會產生任何效果。自動模式在每個供應商上預設皆可使用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry，以及已登入的 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)工作階段。在 v2.1.158 至 v2.1.206 中，必須將此變數設為 `1`，才能在這些供應商上使用[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) |291| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 為了與舊版相容而接受，但不會產生任何效果。自動模式在每個供應商上預設皆可使用，包括 Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry，以及已登入的 [Claude apps 閘道](/docs/zh-TW/claude-apps-gateway)工作階段。在 v2.1.158 至 v2.1.206 中，必須將此變數設為 `1`，才能在這些供應商上使用[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) |

291| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆寫[工作階段回顧](/docs/zh-TW/interactive-mode#session-recap)的可用性。設為 `0` 可強制關閉回顧，無論 `/config` 切換開關為何。設為 `1` 可在 [`awaySummaryEnabled`](/docs/zh-TW/settings-reference#awaysummaryenabled) 為 `false` 時強制開啟回顧。優先於該設定與 `/config` 切換開關 |292| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | 覆寫[工作階段回顧](/docs/zh-TW/interactive-mode#session-recap)的可用性。設為 `0` 可強制關閉回顧，無論 `/config` 切換開關為何。設為 `1` 可在 [`awaySummaryEnabled`](/docs/zh-TW/settings-reference#awaysummaryenabled) 為 `false` 時強制開啟回顧。優先於該設定與 `/config` 切換開關 |

292| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設為 `1` 可在[非互動模式](/docs/zh-TW/headless)中，於背景安裝完成後在回合邊界重新整理外掛狀態。預設為關閉，因為重新整理會在工作階段中途變更系統提示詞，使該回合的[提示快取](/docs/zh-TW/prompt-caching)失效 |293| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | 設為 `1` 可在[非互動模式](/docs/zh-TW/headless)中，於背景安裝完成後在回合邊界重新整理外掛狀態。預設為關閉，因為重新整理會在工作階段中途變更系統提示詞，使該回合的[提示快取](/docs/zh-TW/prompt-caching)失效 |

314| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設為 `false` 可讓 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)遵守 `.gitignore` 模式。根據預設，Glob 會傳回所有符合的檔案，包括被 gitignore 的檔案。不影響 `@` 檔案自動完成，後者有自己的 [`respectGitignore` 設定](/docs/zh-TW/settings-reference#respectgitignore) |315| `CLAUDE_CODE_GLOB_NO_IGNORE` | 設為 `false` 可讓 [Glob 工具](/docs/zh-TW/tools-reference#glob-tool-behavior)遵守 `.gitignore` 模式。根據預設，Glob 會傳回所有符合的檔案，包括被 gitignore 的檔案。不影響 `@` 檔案自動完成，後者有自己的 [`respectGitignore` 設定](/docs/zh-TW/settings-reference#respectgitignore) |

316| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | 背景工作可讓進行中的目標等待多少分鐘，之後 Claude Code 會[請 Claude 檢查它](/docs/zh-TW/goal#background-work-defers-evaluation)。預設為 `30`。設為 `0` 可關閉檢查。請以純數字提供整數分鐘數，最多 `10080`，即一週。Claude Code 會將其他任何值視為未設定並使用預設值。需要 Claude Code v2.1.234 或更新版本 |317| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | 背景工作可讓進行中的目標等待多少分鐘，之後 Claude Code 會[請 Claude 檢查它](/docs/zh-TW/goal#background-work-defers-evaluation)。預設為 `30`。設為 `0` 可關閉檢查。請以純數字提供整數分鐘數，最多 `10080`，即一週。Claude Code 會將其他任何值視為未設定並使用預設值。需要 Claude Code v2.1.234 或更新版本 |

318| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | 設為 `0` 可關閉傳送至 `api.anthropic.com` 的 Claude API、遙測與 [artifact](/docs/zh-TW/artifacts) 發布請求本文的 gzip 壓縮。預設情況下，Claude Code 會在直接連線時壓縮大型請求本文，而在您透過代理伺服器傳送請求、設定用戶端憑證或設定 `NODE_EXTRA_CA_CERTS` 時略過壓縮。如果 Claude Code 無法偵測到的 [TLS 檢查代理伺服器](/docs/zh-TW/network-config#ca-certificate-store)錯誤處理壓縮的請求，請使用 `0` |

319| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設為 `1` 可略過 IDE 擴充功能的自動安裝。等同於將 [`autoInstallIdeExtension`](/docs/zh-TW/settings-reference#autoinstallideextension) 設為 `false` |321| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | 設為 `1` 可略過 IDE 擴充功能的自動安裝。等同於將 [`autoInstallIdeExtension`](/docs/zh-TW/settings-reference#autoinstallideextension) 設為 `false` |

460| `DISABLE_UPDATES` | 設定為 `1` 可封鎖所有更新，包括手動執行的 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。適用於透過您自己的管道發佈 Claude Code 且使用者不應自行更新的情況 |462| `DISABLE_UPDATES` | 設定為 `1` 可封鎖所有更新，包括手動執行的 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更嚴格。適用於透過您自己的管道發佈 Claude Code 且使用者不應自行更新的情況 |

462| `DO_NOT_TRACK` | 設定為 `1` 可選擇不參與遙測，效果與 `DISABLE_TELEMETRY` 相同，包括對[功能旗標擷取](#features-that-need-feature-flag-fetching)的影響。Claude Code 會將此變數視為標準布林值讀取，因此 `0` 會保持遙測開啟，並遵循許多開發者 CLI 所認可的跨工具慣例 |464| `DO_NOT_TRACK` | 設定為 `1` 可選擇不參與遙測，效果與 `DISABLE_TELEMETRY` 相同，包括對[功能旗標擷取](#features-that-need-feature-flag-fetching)的影響。Claude Code 會將此變數視為標準布林值讀取，因此 `0` 會保持遙測開啟，並遵循許多開發者 CLI 所認可的跨工具慣例 |

463| `ENABLE_BETA_TRACING_DETAILED` | 與 `BETA_TRACING_ENDPOINT` 一起設定為 `1`，可開啟[詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)，這會新增包含內容的 span 屬性和 `claude_code.hook` span。互動式 CLI 工作階段還需要您的組織已列入 beta 允許清單。這兩個變數在[專案和本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中都會被忽略 |465| `ENABLE_BETA_TRACING_DETAILED` | 設定為 `1`，並將 `BETA_TRACING_ENDPOINT` 設定為您的 OTLP/HTTP 收集器端點，即可開啟[詳細 beta 追蹤](/docs/zh-TW/monitoring-usage#traces-beta)，這會新增帶有內容的 span 屬性和 `claude_code.hook` span。互動式 CLI 工作階段還需要您的組織已列入此 beta 的允許清單。這兩個變數在[專案與本機設定](/docs/zh-TW/settings-reference#variables-claude-code-ignores-in-env)中都會被忽略 |

464| `ENABLE_CLAUDEAI_MCP_SERVERS` | 設定為 `false` 可讓 Claude Code 停止擷取 [claude.ai MCP 伺服器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)。對已登入的使用者預設啟用。若要按專案或按組織停用，請改為在設定中設定 [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) |466| `ENABLE_CLAUDEAI_MCP_SERVERS` | 設定為 `false` 可讓 Claude Code 停止擷取 [claude.ai MCP 伺服器](/docs/zh-TW/mcp#use-mcp-servers-from-claude-ai)。對已登入的使用者預設啟用。若要按專案或按組織停用，請改為在設定中設定 [`disableClaudeAiConnectors`](/docs/zh-TW/settings-reference#disableclaudeaiconnectors) |

465| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 可請求 1 小時的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)，而非預設的 5 分鐘。適用於 API 金鑰、[Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai)、[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 使用者。在內含用量範圍內的訂閱使用者會在[主要對話](/docs/zh-TW/prompt-caching#which-ttl-each-request-gets)上自動獲得 1 小時 TTL。使用[用量點數](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)的訂閱使用者可設定此變數以保留 1 小時 TTL。1 小時快取寫入會以較高費率計費。若要改為依請求類別選擇 TTL，請使用 `CLAUDE_CODE_PROMPT_CACHE_TTL` 和 `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`，兩者都優先於此變數 |467| `ENABLE_PROMPT_CACHING_1H` | 設定為 `1` 可請求 1 小時的[提示快取 TTL](/docs/zh-TW/prompt-caching#cache-lifetime)，而非預設的 5 分鐘。適用於 API 金鑰、[Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai)、[Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 和 [Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws) 使用者。在內含用量範圍內的訂閱使用者會在[主要對話](/docs/zh-TW/prompt-caching#which-ttl-each-request-gets)上自動獲得 1 小時 TTL。使用[用量點數](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)的訂閱使用者可設定此變數以保留 1 小時 TTL。1 小時快取寫入會以較高費率計費。若要改為依請求類別選擇 TTL，請使用 `CLAUDE_CODE_PROMPT_CACHE_TTL` 和 `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`，兩者都優先於此變數 |

feature-availability.md +4 −1

Details

51 51

52這些需要使用 claude.ai 帳戶登入，無法透過 Anthropic Console API 金鑰或第三方提供者存取：52這些需要使用 claude.ai 帳戶登入，無法透過 Anthropic Console API 金鑰或第三方提供者存取：

53 53

~~54* [網頁上的 Claude Code](/docs/zh-TW/claude-code-on-the-web)、行動裝置上的 Claude Code 和 [Slack 中的 Claude Code](/docs/zh-TW/slack)~~54* [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)和行動裝置上的 Claude Code

55* [Slack 中的 Claude Code](/docs/zh-TW/slack)：Pro 和 Max 計畫

55* [Claude Code Desktop](/docs/zh-TW/desktop)56* [Claude Code Desktop](/docs/zh-TW/desktop)

56* [Routines](/docs/zh-TW/routines)（`/schedule`）57* [Routines](/docs/zh-TW/routines)（`/schedule`）

57* [Ultrareview](/docs/zh-TW/ultrareview)58* [Ultrareview](/docs/zh-TW/ultrareview)

303 304

304如果您透過 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Anthropic Console API 金鑰進行驗證，本節不適用於您。當您使用 claude.ai 帳戶登入時，您的計畫決定了下列功能中哪些可用。305如果您透過 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Anthropic Console API 金鑰進行驗證，本節不適用於您。當您使用 claude.ai 帳戶登入時，您的計畫決定了下列功能中哪些可用。

305 306

307在已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的 Enterprise 組織中，此表格中的部分功能會被關閉。

308

306| 功能 | Pro | Max | Team | Enterprise |309| 功能 | Pro | Max | Team | Enterprise |

307| :- | :- | :- | :- | :- |310| :- | :- | :- | :- | :- |

308| [Cloud sessions](/docs/zh-TW/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |311| [Cloud sessions](/docs/zh-TW/claude-code-on-the-web) | ✓ | ✓ | ✓ | ✓ <sup><a href="#fn6">6</a></sup> |

fullscreen.md +6 −5

Details

100 100

101* **在提示輸入欄中點擊**，以在您輸入的文字中的任何位置放置游標。101* **在提示輸入欄中點擊**，以在您輸入的文字中的任何位置放置游標。

102* **點擊 `/` 命令或 `@` 檔案清單中的建議**，以接受它。懸停會突顯游標下的列。102* **點擊 `/` 命令或 `@` 檔案清單中的建議**，以接受它。懸停會突顯游標下的列。

103* **點擊選擇功能表中的選項**，以選擇它。這涵蓋權限提示、`/model`、`/config` 和其他顯示選項清單的對話框。懸停會在游標下的列上顯示指標。103* **點擊選擇功能表中的選項**，以選擇它。這涵蓋權限提示、`/model`、`/config` 和其他顯示選項清單的對話框。

104* **點擊多選功能表中的選項**，以切換它，然後點擊提交按鈕以確認您的選擇。點擊自由文字列（例如多選題中的 `Other` 列）會聚焦其輸入欄位，以便您可以輸入答案。需要 Claude Code v2.1.208 或更新版本。104* **點擊多選功能表中的選項**，以切換它，然後點擊提交按鈕以確認您的選擇。點擊自由文字列（例如多選題中的 `Other` 列）會聚焦其輸入欄位，以便您可以輸入答案。需要 Claude Code v2.1.208 或更新版本。

105* **點擊 `/config` 面板中的設定值**，以變更它，並使用滑鼠滾輪捲動設定清單。需要 Claude Code v2.1.271 或更新版本。105* **點擊 `/config` 面板中的設定值**，以變更它，並使用滑鼠滾輪捲動設定清單。需要 Claude Code v2.1.271 或更新版本。

106* **使用滑鼠滾輪捲動選擇或多選功能表**，當它有超過一次顯示的選項時，例如短終端機視窗中的 `/model` 清單。當指標在其選項上方時，滾輪會捲動清單。需要 Claude Code v2.1.280 或更新版本。106* **使用滑鼠滾輪捲動選擇或多選功能表**，當它有超過一次顯示的選項時，例如短終端機視窗中的 `/model` 清單。當指標在其選項上方時，滾輪會捲動清單。需要 Claude Code v2.1.280 或更新版本。

110* **點擊已摺疊的工具結果**，以展開它並查看完整輸出。再次點擊以摺疊。工具呼叫及其結果會一起展開。只有有更多內容要顯示的訊息才可點擊。110* **點擊已摺疊的工具結果**，以展開它並查看完整輸出。再次點擊以摺疊。工具呼叫及其結果會一起展開。只有有更多內容要顯示的訊息才可點擊。

111 * 點擊也會展開 `!` shell 命令的輸出，無論是較舊的截斷結果或命令執行時的即時進度列。需要 Claude Code v2.1.257 或更新版本。111 * 點擊也會展開 `!` shell 命令的輸出，無論是較舊的截斷結果或命令執行時的即時進度列。需要 Claude Code v2.1.257 或更新版本。

112 * 點擊也會展開當寄件者是[隊友](/docs/zh-TW/agent-teams)或在您的工作階段中執行的另一個 agent 時的暗淡 `Message from @<sender>` 列。112 * 點擊也會展開當寄件者是[隊友](/docs/zh-TW/agent-teams)或在您的工作階段中執行的另一個 agent 時的暗淡 `Message from @<sender>` 列。

113* **在 macOS 上按住 `Cmd`，或在 Linux 和 Windows 上按住 `Ctrl`，然後點擊 URL 或檔案路徑**，以開啟它。純 `http://` 和 `https://` URL 會在您的瀏覽器中開啟，而工具輸出中的檔案路徑（例如在 Edit 或 Write 後列印的路徑）會在您的預設應用程式中開啟。不使用修飾鍵的純點擊不會開啟連結，符合原生終端機行為。113* **在 macOS 上按住 `Cmd`，或在 Linux 和 Windows 上按住 `Ctrl`，然後點擊 URL 或檔案路徑**，以開啟它。純 `http://` 和 `https://` URL 會在您的瀏覽器中開啟。當 Claude Code 處理點擊時，工具輸出中的檔案路徑（例如在 Edit 或 Write 後列印的路徑）會在您的檔案管理員中開啟，並選取該檔案。不使用修飾鍵的純點擊不會開啟連結，符合原生終端機行為。

114 * Claude Code 會將網路 (UNC) 路徑（例如 `\\server\share\file.ts`）呈現為純文字，沒有連結，因為開啟網路路徑可能會將您的 Windows 認證傳送到它命名的主機。114 * 在 Linux 和 WSL 上，點擊檔案路徑需要提供 `org.freedesktop.FileManager1` D-Bus 介面的檔案管理員。若沒有，則不會開啟任何項目。

115 * Claude Code 會將網路 (UNC) 路徑（例如 `\\server\share\file.ts`）呈現為純文字，沒有連結，因為開啟網路路徑可能會將您的 Windows 憑證傳送到它命名的主機。

115 * 某些 macOS 終端機會將 `Cmd`+點擊轉發給執行中的應用程式，而不是自己開啟連結，而終端機滑鼠協定無法編碼 `Cmd` 鍵，因此 Claude Code 會收到純點擊。在 Ghostty 以及 macOS 上的 Warp 中，Claude Code 會偵測到這一點，並讓純點擊連結開啟它，而按住 `Cmd` 仍然有效。116 * 某些 macOS 終端機會將 `Cmd`+點擊轉發給執行中的應用程式，而不是自己開啟連結，而終端機滑鼠協定無法編碼 `Cmd` 鍵，因此 Claude Code 會收到純點擊。在 Ghostty 以及 macOS 上的 Warp 中，Claude Code 會偵測到這一點，並讓純點擊連結開啟它，而按住 `Cmd` 仍然有效。

116 * 在 VS Code 整合終端機和類似的 xterm.js 型終端機中，Claude Code 會遵循終端機自己的連結處理程式，該處理程式使用相同的手勢。117 * 在 VS Code 整合終端機和類似的 xterm.js 型終端機中，Claude Code 會遵循終端機自己的連結處理程式，該處理程式使用相同的手勢。

117* **點擊並拖曳**，以在對話中的任何位置選擇文字。雙擊會選擇一個單字，符合 iTerm2 的單字邊界，因此檔案路徑會選擇為一個單位。雙擊 URL 會選擇整個 URL，包括配置。三擊會選擇該列。118* **點擊並拖曳**，以在對話中的任何位置選擇文字。雙擊會選擇一個單字，符合 iTerm2 的單字邊界，因此檔案路徑會選擇為一個單位。雙擊 URL 會選擇整個 URL，包括配置。三擊會選擇該列。

130* **任何其他鍵，包括純箭頭鍵、`Enter` 和輸入的字元**：Claude Code 會清除選擇。131* **任何其他鍵，包括純箭頭鍵、`Enter` 和輸入的字元**：Claude Code 會清除選擇。

131* **繫結至 [`selection:clear`](/docs/zh-TW/keybindings#scroll-actions) 的鍵**：Claude Code 會清除選擇，即使該鍵是 `Esc` 或其他通常保持選擇的鍵。該動作沒有預設繫結。132* **繫結至 [`selection:clear`](/docs/zh-TW/keybindings#scroll-actions) 的鍵**：Claude Code 會清除選擇，即使該鍵是 `Esc` 或其他通常保持選擇的鍵。該動作沒有預設繫結。

132 133

133在[文字記錄模式](#search-and-review-the-conversation)中，列在該處的導覽和搜尋鍵也會保持選擇。134在[逐字稿模式](#search-and-review-the-conversation)中，列在該處的導覽鍵也會保持選擇。

134 135

135<h2 id="scroll-the-conversation">136<h2 id="scroll-the-conversation">

136 捲動對話137 捲動對話

187 188

188值 `3` 符合 `vim` 和類似應用程式中的預設值。此設定接受任何正值，最高為 20，包括低於 1 的小數值，例如 `0.25`，以減緩已經放大滾輪事件的終端機中的加速觸控板和滾輪捲動。189值 `3` 符合 `vim` 和類似應用程式中的預設值。此設定接受任何正值，最高為 20，包括低於 1 的小數值，例如 `0.25`，以減緩已經放大滾輪事件的終端機中的加速觸控板和滾輪捲動。

189 190

190若要以互動方式調整捲動速度，請執行 `/scroll-speed`。對話框會顯示一個尺標，您可以在對話框開啟時捲動，以便立即感受變化。按 `←` 和 `→` 調整速度，按 `r` 重設為自動偵測的預設值，按 `Enter` 儲存。對話框以整數步進到 10，在支援更精細控制的終端機上，它也提供四分之一步進到 0.25。191若要以互動方式調整捲動速度，請執行 `/scroll-speed`。在對話框開啟時捲動，即可立即感受變化。按 `←` 和 `→` 調整速度，按 `r` 重設為自動偵測的預設值，按 `Enter` 儲存。對話框以整數步進到 10，在支援更精細控制的終端機上，它也提供四分之一步進到 0.25。

191 192

192該命令寫入與 `CLAUDE_CODE_SCROLL_SPEED` 環境變數設定相同的值，持久化到 `~/.claude/settings.json`。對話框的最大值為 10：如果您透過環境變數設定更高的值，對話框會顯示 10，從對話框儲存會持久化 10。此命令在 JetBrains IDE 終端機中不可用。193該命令寫入與 `CLAUDE_CODE_SCROLL_SPEED` 環境變數設定相同的值，持久化到 `~/.claude/settings.json`。對話框的最大值為 10：如果您透過環境變數設定更高的值，對話框會顯示 10，從對話框儲存會持久化 10。此命令在 JetBrains IDE 終端機中不可用。

193 194

github-actions.md +1 −1

Details

326 326

327僅授予工作流程它需要的權限，並在合併前審查 Claude 的變更。327僅授予工作流程它需要的權限，並在合併前審查 Claude 的變更。

328 328

329如需包括權限和身份驗證的全面安全指導，請參閱 [Claude Code Action 安全性文件](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md)。329如需包括權限和身分驗證的安全指導，請參閱 [Claude Code Action 安全性文件](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md)。

330 330

331<h3 id="manage-costs">331<h3 id="manage-costs">

332 管理成本332 管理成本

glossary.md +1 −1

Details

499 Verification loop499 Verification loop

500</h3>500</h3>

501 501

502一個會話知道工作實際完成而不僅僅是看起來合理的方式。您給 Claude 一個它可以執行的檢查，例如測試套件、構建或螢幕截圖比較，Claude 迭代直到檢查通過，而不是在一次嘗試後停止。驗證迴圈是 [`/goal`](/docs/zh-TW/goal)、無人值守執行和 [dynamic workflows](/docs/zh-TW/workflows) 的先決條件：沒有它，唯一決定代理完成的事情就是代理本身。502一個工作階段知道工作實際完成而不僅僅是看起來合理的方式。您給 Claude 一個它可以執行的檢查，例如測試套件、建置或螢幕截圖比較，Claude 迭代直到檢查通過，而不是在一次嘗試後停止。驗證迴圈是 [`/goal`](/docs/zh-TW/goal)、無人值守執行和[動態工作流程](/docs/zh-TW/workflows)的先決條件：沒有它，唯一決定 agent 是否完成的就是 agent 本身。

503 503

504了解更多：[Give Claude a way to verify its work](/docs/zh-TW/best-practices#give-claude-a-way-to-verify-its-work)504了解更多：[Give Claude a way to verify its work](/docs/zh-TW/best-practices#give-claude-a-way-to-verify-its-work)

505 505

headless.md +90 −90

Details

109 範例109 範例

110</h2>110</h2>

111 111

112這些範例突出了常見的 CLI 模式。如果命令指定了檔案（例如 `auth.py` 或 `build-error.txt`），請替換為您自己專案中的檔案。在 CI 或其他指令碼環境中，添加 [`--bare`](#start-faster-with-bare-mode)，以便 Claude Code 啟動時不載入主機的 hooks、plugins、自動記憶或 `CLAUDE.md`。112這些範例展示常見的 CLI 使用模式。當命令中提及 `auth.py` 或 `build-error.txt` 等檔案時，請替換為您自己專案中的檔案。在 CI 或其他腳本化環境中，請加上 [`--bare`](#start-faster-with-bare-mode)，讓 Claude Code 啟動時不載入主機的 hook、外掛、自動記憶或 `CLAUDE.md`。

113 113

114<h3 id="pipe-data-through-claude">114<h3 id="pipe-data-through-claude">

115 透過 Claude 管道傳輸資料115 透過 Claude 傳遞資料

116</h3>116</h3>

117 117

118非互動模式讀取 stdin，因此您可以像任何其他命令列工具一樣管道傳輸資料並重新導向回應。118非互動模式會讀取 stdin，因此您可以像使用任何其他命令列工具一樣，將資料透過管道傳入，並將回應重新導向輸出。

119 119

120此範例將建置日誌管道傳輸到 Claude，並將說明寫入檔案：120此範例將建置日誌透過管道傳入 Claude，並將說明寫入檔案：

121 121

122```bash theme={null}122```bash theme={null}

123cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt123cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

124```124```

125 125

126使用 `--output-format json` 時，回應承載包括 `total_cost_usd` 和按模型的成本明細，因此指令碼呼叫者可以追蹤支出，而無需查詢[使用儀表板](/docs/zh-TW/costs)。當您使用 `--continue` 或 `--resume` 繼續較早的對話時，執行會報告對話的整體總計，[包括較早執行的支出](/docs/zh-TW/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)。兩個數字都是[用戶端估計](/docs/zh-TW/agent-sdk/cost-tracking)，可能與您的實際帳單不同。126使用 `--output-format json` 時，回應 payload 會包含 `total_cost_usd` 以及依模型細分的費用，因此腳本化的呼叫端無需查閱[使用量儀表板](/docs/zh-TW/costs)即可追蹤支出。當您使用 `--continue` 或 `--resume` 接續先前的對話時，該次執行會回報整個對話的總額，[包含先前執行的支出](/docs/zh-TW/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)。這兩個數字都是[用戶端估算值](/docs/zh-TW/agent-sdk/cost-tracking)，可能與您的實際帳單不同。

127 127

128<Note>128<Note>

129 管道傳輸的 stdin 上限為 10MB。如果超過上限，Claude Code 會以清晰的錯誤訊息退出，並返回非零狀態。若要處理較大的輸入，請將內容寫入檔案，並在提示中參考檔案路徑，而不是管道傳輸。129 透過管道傳入的 stdin 上限為 10MB。若超過上限，Claude Code 會以明確的錯誤訊息及非零狀態結束。若要處理更大的輸入，請將內容寫入檔案，並在提示詞中引用該檔案路徑，而非透過管道傳入。

130</Note>130</Note>

131 131

132如果 Claude Code 無法讀取 stdin（例如因為啟動它的程序斷開了其端點），Claude Code 會向 stderr 列印警告並繼續執行命令列中的提示。在 v2.1.211 之前，Windows 上無法讀取的 stdin 會導致工作階段崩潰或以無輸出的方式無聲退出。132如果 Claude Code 無法讀取 stdin，例如啟動它的程序中斷了其一端的連線，Claude Code 會將警告輸出至 stderr，並繼續使用命令列中的提示詞。在 v2.1.211 之前，Windows 上無法讀取的 stdin 會導致工作階段當機，或使其在沒有任何輸出的情況下靜默結束。

133 133

134<h3 id="add-claude-to-a-build-script">134<h3 id="add-claude-to-a-build-script">

135 將 Claude 新增到建置指令碼135 將 Claude 加入建置腳本

136</h3>136</h3>

137 137

138您可以在指令碼中包裝非互動呼叫，以將 Claude 用作專案特定的 linter 或審查者。138您可以將非互動呼叫包裝在腳本中，把 Claude 當作專案專屬的 linter 或審查工具使用。

139 139

140此 `package.json` 指令碼將針對 `main` 的差異管道傳輸到 Claude，並要求它報告拼寫錯誤。管道傳輸差異意味著 Claude 不需要 Bash 權限來讀取它，而逸出的雙引號使指令碼可移植到 Windows：140此 `package.json` 腳本會將相對於 `main` 的差異透過管道傳入 Claude，並要求它回報錯字。透過管道傳入差異意味著 Claude 不需要 Bash 權限即可讀取它，而跳脫的雙引號可讓腳本在 Windows 上保持可攜性：

141 141

142```json theme={null}142```json theme={null}

143{143{

147}147}

148```148```

149 149

150使用 `npm run lint:claude` 執行它。150使用 `npm run lint:claude` 執行。

151 151

152<h3 id="get-structured-output">152<h3 id="get-structured-output">

153 取得結構化輸出153 取得結構化輸出

156使用 `--output-format` 控制回應的傳回方式：156使用 `--output-format` 控制回應的傳回方式：

157 157

158* `text`（預設）：純文字輸出158* `text`（預設）：純文字輸出

159* `json`：包含結果、工作階段 ID 和中繼資料的結構化 JSON159* `json`：包含結果、工作階段 ID 及中繼資料的結構化 JSON

160* `stream-json`：換行分隔的 JSON，用於即時串流160* `stream-json`：以換行分隔的 JSON，用於即時串流

161 161

162此範例以 JSON 形式傳回專案摘要及工作階段中繼資料，文字結果在 `result` 欄位中：162此範例以 JSON 格式傳回專案摘要及工作階段中繼資料，文字結果位於 `result` 欄位：

163 163

164```bash theme={null}164```bash theme={null}

165claude -p "Summarize this project" --output-format json165claude -p "Summarize this project" --output-format json

166```166```

167 167

168若要取得符合特定結構描述的輸出，請使用 `--output-format json` 搭配 `--json-schema` 和 [JSON Schema](https://json-schema.org/) 定義。回應包括關於請求的中繼資料（工作階段 ID、使用情況等），結構化輸出在 `structured_output` 欄位中。168若要取得符合特定 schema 的輸出，請將 `--output-format json` 與 `--json-schema` 及 [JSON Schema](https://json-schema.org/) 定義搭配使用。回應會包含請求的中繼資料（工作階段 ID、使用量等），結構化輸出則位於 `structured_output` 欄位。

169 169

170此範例從 auth.py 提取函式名稱並將其傳回為字串陣列：170此範例會擷取函式名稱，並以字串陣列的形式傳回：

171 171

172```bash theme={null}172```bash theme={null}

173claude -p "Extract the main function names from auth.py" \173claude -p "Extract the main function names from auth.py" \

175 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'175 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

176```176```

177 177

178如果值不是有效的 JSON Schema，`claude` 會以 `Error: --json-schema is not a valid JSON Schema` 退出，後面跟著驗證器的診斷。Claude Code 接受使用 `format` 關鍵字的結構描述，例如 `"format": "email"`，但將 `format` 視為註解，不強制執行。在 v2.1.205 之前，Claude Code 無聲地忽略無效的結構描述並傳回非結構化文字，並將任何包含 `format` 的結構描述視為無效。178如果該值不是有效的 JSON Schema，`claude` 會以 `Error: --json-schema is not a valid JSON Schema` 結束，並附上驗證器的診斷訊息。Claude Code 接受使用 `format` 關鍵字的 schema，例如 `"format": "email"`，但會將 `format` 視為註解而不強制執行。在 v2.1.205 之前，Claude Code 會靜默忽略無效的 schema 並傳回非結構化文字，且會將任何包含 `format` 的 schema 視為無效。

179 179

180<Tip>180<Tip>

181 使用 [jq](https://jqlang.org/) 之類的工具來解析回應並提取特定欄位：181 使用 [jq](https://jqlang.org/) 等工具剖析回應並擷取特定欄位：

182 182

183 ```bash theme={null}183 ```bash theme={null}

184 # Extract the text result184 # Extract the text result

196 串流回應196 串流回應

197</h3>197</h3>

198 198

199使用 `--output-format stream-json` 搭配 `--verbose` 和 `--include-partial-messages` 以在產生令牌時接收它們。每一行都是代表事件的 JSON 物件：199將 `--output-format stream-json` 與 `--verbose` 及 `--include-partial-messages` 搭配使用，即可在 token 產生時即時接收。每一行都是代表一個事件的 JSON 物件：

200 200

201```bash theme={null}201```bash theme={null}

202claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages202claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

203```203```

204 204

205串流的最後一行是 `result` 訊息，包含最終回應文字、成本和工作階段中繼資料。205串流的最後一行是 `result` 訊息，其中包含最終回應文字、費用及工作階段中繼資料。

206 206

207如果您的消費者緩慢讀取串流，Claude Code 會等待佇列中的輸出排出後再退出，根據仍在佇列中的數量調整等待時間，上限為 30 秒。在 v2.1.214 之前，退出等待上限約為 2 秒，這可能會截斷大型回應的末尾。207如果您的消費端讀取串流的速度較慢，Claude Code 會等待佇列中的輸出消化完畢後再結束，等待時間會依仍在佇列中的量調整，上限為 30 秒。在 v2.1.214 之前，結束前的等待上限約為兩秒，可能會截斷大型回應的結尾。

208 208

209以下範例使用 [jq](https://jqlang.org/) 篩選文字增量並僅顯示串流文字。`-r` 旗標輸出原始字串（無引號），`-j` 在沒有換行符的情況下聯接，以便令牌連續串流：209以下範例使用 [jq](https://jqlang.org/) 篩選文字差量，僅顯示串流文字。`-r` 旗標會輸出原始字串（不含引號），`-j` 則會在不加換行的情況下串接，讓 token 持續串流：

210 210

211```bash theme={null}211```bash theme={null}

212claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \212claude -p "Write a poem" --output-format stream-json --verbose --include-partial-messages | \

213 jq -rj 'select(.type == "stream_event" and .event.delta.type? == "text_delta") | .event.delta.text'213 jq -rj 'select(.type == "stream_event" and .event.delta.type? == "text_delta") | .event.delta.text'

214```214```

215 215

216如需具有回呼和訊息物件的程式設計串流，請參閱 Agent SDK 文件中的[即時串流回應](/docs/zh-TW/agent-sdk/streaming-output)。216如需使用回呼及訊息物件進行程式化串流，請參閱 Agent SDK 文件中的[即時串流回應](/docs/zh-TW/agent-sdk/streaming-output)。

217 217

218<h4 id="follow-subagent-messages">218<h4 id="follow-subagent-messages">

219 追蹤子代理訊息219 追蹤 subagent 訊息

220</h4>220</h4>

221 221

222來自[子代理](/docs/zh-TW/sub-agents)的訊息在串流中顯示為 `assistant` 和 `user` 訊息，其 `parent_tool_use_id` 欄位是產生子代理的工具呼叫的 ID。來自主對話的訊息在該欄位中帶有 `null`。222來自 [subagent](/docs/zh-TW/sub-agents) 的訊息會以 `assistant` 及 `user` 訊息的形式出現在串流中，其 `parent_tool_use_id` 欄位為產生該 subagent 的工具呼叫 ID。來自主對話的訊息在該欄位中則為 `null`。

223 223

224來自在[前景](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)中執行的子代理的第一條訊息是 `user` 訊息，帶有驅動它的提示。在該第一條訊息之後，Claude Code 發出：224在[前景](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)執行的 subagent 的第一則訊息是一則 `user` 訊息，內含驅動它的提示詞。在第一則訊息之後，Claude Code 會發出：

225 225

226* **預設情況下**：子代理的 `tool_use` 和 `tool_result` 區塊。226* **預設情況下**：subagent 的 `tool_use` 及 `tool_result` 區塊。

227* **使用 [`--forward-subagent-text`](/docs/zh-TW/cli-reference#cli-flags) 或 [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/zh-TW/env-vars)**：子代理的文字和思考區塊，以便您可以重建每個子代理的文字記錄。這需要 Claude Code v2.1.211 或更新版本。227* **使用 [`--forward-subagent-text`](/docs/zh-TW/cli-reference#cli-flags) 或 [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/zh-TW/env-vars) 時**：還會包含 subagent 的文字及思考區塊，因此您可以重建每個 subagent 的逐字稿。這需要 Claude Code v2.1.211 或更新版本。

228 228

229當您啟用任一選項時，Claude Code 會轉發來自[每個巢狀深度的子代理](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents)的訊息，無論每個子代理是使用 Agent 工具產生的還是作為[分叉 skill](/docs/zh-TW/skills#run-skills-in-a-subagent) 啟動的。分叉 skill 產生的子代理的訊息，以及在子代理或另一個分叉 skill 內啟動的分叉 skill，需要 Claude Code v2.1.275 或更新版本。在 `parent_tool_use_id` 中，巢狀子代理的訊息帶有啟動它的 Agent 或 Skill 工具呼叫的 ID，因此您可以透過追蹤這些 ID 來重建完整的巢狀樹。在 v2.1.219 之前，巢狀子代理的訊息不會出現在串流中。229啟用任一選項時，Claude Code 會轉發來自[每個巢狀層級的 subagent](/docs/zh-TW/sub-agents#let-subagents-spawn-their-own-subagents) 的訊息，無論每個 subagent 是透過 Agent 工具產生，還是以[分叉 skill](/docs/zh-TW/skills#run-skills-in-a-subagent) 的形式啟動。由分叉 skill 產生的 subagent 的訊息，以及在 subagent 或另一個分叉 skill 內啟動的分叉 skill 的訊息，需要 Claude Code v2.1.275 或更新版本。在 `parent_tool_use_id` 中，巢狀 subagent 的訊息會帶有啟動它的 Agent 或 Skill 工具呼叫 ID，因此您可以依循這些 ID 重建完整的巢狀樹狀結構。在 v2.1.219 之前，來自巢狀 subagent 的訊息不會出現在串流中。

230 230

231在子代理中[執行的 Skills](/docs/zh-TW/skills#run-skills-in-a-subagent) 在串流中以相同方式出現：分叉 skill 的第一條訊息是 `user` 訊息，帶有驅動執行的 skill 內容。如果您啟用任一選項，串流也會帶有分叉 skill 的文字和思考區塊。在 v2.1.265 之前，只有分叉 skill 的 `tool_use` 和 `tool_result` 區塊出現在串流中。231[在 subagent 中執行](/docs/zh-TW/skills#run-skills-in-a-subagent)的 skill 會以相同方式出現在串流中：分叉 skill 的第一則訊息是一則 `user` 訊息，內含驅動該次執行的 skill 內容。如果您啟用任一選項，串流也會包含分叉 skill 的文字及思考區塊。在 v2.1.265 之前，串流中只會出現分叉 skill 的 `tool_use` 及 `tool_result` 區塊。

232 232

233<h4 id="handle-api-retries">233<h4 id="handle-api-retries">

234 處理 API 重試234 處理 API 重試

235</h4>235</h4>

236 236

237當 API 請求因可重試的錯誤而失敗時，Claude Code 在重試前發出 `system/api_retry` 事件。在 v2.1.246 或更新版本上，當 `401` 或 `403` 拒絕 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 認證時，Claude Code 會以無事件的方式進行前兩次重試，然後從第三次連續重試開始照常發出事件。無聲重試仍計入 `attempt`。您可以使用事件在自己的介面中顯示重試進度。237當 API 請求因可重試的錯誤而失敗時，Claude Code 會在重試前發出 `system/api_retry` 事件。在 v2.1.246 或更新版本中，當 `401` 或 `403` 拒絕 [`apiKeyHelper`](/docs/zh-TW/settings-reference#apikeyhelper) 憑證時，Claude Code 會靜默進行前兩次重試而不發出事件，從第三次連續重試起才照常發出事件。靜默重試仍會計入 `attempt`。您可以使用此事件在自己的介面中顯示重試進度。

238 238

239| 欄位 | 類型 | 說明 |239| 欄位 | 類型 | 說明 |

240| - | - | - |240| - | - | - |

247| `no_response` | 物件，選用 | 僅當失敗的嘗試[未及時獲得回應標頭](/docs/zh-TW/errors#no-response-from-api)時出現。`waited_ms` 是該嘗試等待的時間，`retry_wait_ms` 是重試將等待的時間。在這些事件中，`max_retries` 反映此原因通常獲得的一次重試，而不是工作階段範圍的預算。需要 Claude Code v2.1.261 或更新版本 |247| `no_response` | object，選用 | 僅在失敗的嘗試[未及時收到回應標頭](/docs/zh-TW/errors#no-response-from-api)時出現。`waited_ms` 是該次嘗試等待的時間，`retry_wait_ms` 是重試將等待的時間。在這些事件中，`max_retries` 反映此原因通常獲得的一次重試，而非整個工作階段的預算。需要 Claude Code v2.1.261 或更新版本 |

248| `error` | 字串 | 錯誤類別：`authentication_failed`、`oauth_org_not_allowed`、`account_on_hold`、`billing_error`、`rate_limit`、`overloaded`、`invalid_request`、`model_not_found`、`server_error`、`max_output_tokens`、`cloud_credential_error` 或 `unknown` |248| `error` | string | 錯誤類別：`authentication_failed`、`oauth_org_not_allowed`、`account_on_hold`、`billing_error`、`rate_limit`、`overloaded`、`invalid_request`、`model_not_found`、`server_error`、`max_output_tokens`、`cloud_credential_error` 或 `unknown` |

251 251

252<h4 id="read-session-metadata">252<h4 id="read-session-metadata">

253 讀取工作階段中繼資料253 讀取工作階段中繼資料

254</h4>254</h4>

255 255

256`system/init` 事件報告工作階段中繼資料，包括模型、工具、MCP 伺服器和載入的 plugins。除非啟動事件在其前面，否則它是串流中的第一個事件：256`system/init` 事件會回報工作階段中繼資料，包括模型、工具、MCP 伺服器及已載入的外掛。除非有啟動事件排在它之前，否則它是串流中的第一個事件：

257 257

258* `plugin_install` 事件，當設定 [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/zh-TW/env-vars) 時。258* `plugin_install` 事件，於設定 [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/zh-TW/env-vars) 時出現。

259* [`hook_started`、`hook_progress` 和 `hook_response` 事件](/docs/zh-TW/agent-sdk/typescript#sdkhookstartedmessage)，當配置的 [`SessionStart`](/docs/zh-TW/hooks#sessionstart) 或 [`Setup`](/docs/zh-TW/hooks#setup) hook 執行時。這些會在 hook 產生時串流。Claude Code v2.1.169 至 v2.1.203 在 hook 完成後以一個批次傳遞它們，仍在 `system/init` 之前；v2.1.204 恢復了即時傳遞。259* [`hook_started`、`hook_progress` 及 `hook_response` 事件](/docs/zh-TW/agent-sdk/typescript#sdkhookstartedmessage)，於已設定的 [`SessionStart`](/docs/zh-TW/hooks#sessionstart) 或 [`Setup`](/docs/zh-TW/hooks#setup) hook 執行期間出現。這些事件會在 hook 產生時即時串流。Claude Code v2.1.169 至 v2.1.203 會在 hook 完成後一次批次傳送，但仍在 `system/init` 之前；v2.1.204 恢復了即時傳送。

260 260

261該事件還帶有一個選用的 `capabilities` 字串陣列，命名此 Claude Code 版本實現的協議行為，例如 `interrupt_receipt_v1` 或 `interrupt_cancel_queued_v1`。檢查它以進行功能偵測，而不是比較版本字串，並忽略您不認識的值。該欄位需要 Claude Code v2.1.205 或更新版本，在較早版本中不存在。請參閱 [`SDKSystemMessage`](/docs/zh-TW/agent-sdk/typescript#sdksystemmessage) 以取得功能清單。261此事件還帶有一個選用的 `capabilities` 字串陣列，列出此 Claude Code 版本所實作的協定行為，例如 `interrupt_receipt_v1` 或 `interrupt_cancel_queued_v1`。請檢查此陣列來偵測功能，而非比對版本字串，並忽略您無法辨識的值。此欄位需要 Claude Code v2.1.205 或更新版本，較早的版本中不會出現。如需功能清單，請參閱 [`SDKSystemMessage`](/docs/zh-TW/agent-sdk/typescript#sdksystemmessage)。

262 262

263<h4 id="fail-ci-when-a-plugin-or-mcp-server-doesn’t-load">263<h4 id="fail-ci-when-a-plugin-or-mcp-server-doesn’t-load">

264 當 plugin 或 MCP 伺服器未載入時使 CI 失敗264 在外掛或 MCP 伺服器未載入時讓 CI 失敗

265</h4>265</h4>

266 266

267使用 `system/init` 事件中的 plugin 欄位來捕捉未載入的 plugin：267使用 `system/init` 事件中的外掛欄位來偵測未載入的外掛：

268 268

269| 欄位 | 類型 | 說明 |269| 欄位 | 類型 | 說明 |

270| - | - | - |270| - | - | - |

273 273

274當 `--plugin-dir` 目錄或存檔本身無法載入時，其 `plugin_errors` 項目包括已解析的絕對路徑作為 `path`。使用它來判斷多個 `--plugin-dir` 值中哪個失敗。`path` 欄位需要 Claude Code v2.1.283 或更新版本。274當 `--plugin-dir` 目錄或封存檔本身載入失敗時，其 `plugin_errors` 項目會以 `path` 包含解析後的絕對路徑。可用它來判斷多個 `--plugin-dir` 值中是哪一個失敗。`path` 欄位需要 Claude Code v2.1.283 或更新版本。

275 275

276以相同方式使用 MCP 伺服器欄位。當您使用 `-p` 傳遞 [`--mcp-config`](/docs/zh-TW/cli-reference#cli-flags) 時，Claude Code 會等待仍在等待的伺服器，直到 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 啟動逾時（預設 30 秒）。具有[快取工具清單](/docs/zh-TW/agent-sdk/mcp#connection-timing)的遠端伺服器會跳過等待，在 `system/init` 中顯示 `pending`，並在其第一次工具呼叫時連接。等待需要 Claude Code v2.1.221 或更新版本。276以相同方式使用 MCP 伺服器欄位。當您搭配 `-p` 傳入 [`--mcp-config`](/docs/zh-TW/cli-reference#cli-flags) 時，Claude Code 會在執行第一個回合前等待仍在擱置中的伺服器，最長等待 [`MCP_TIMEOUT`](/docs/zh-TW/env-vars) 啟動逾時時間，預設為 30 秒。具有[快取工具清單](/docs/zh-TW/agent-sdk/mcp#connection-timing)的遠端伺服器會略過等待，在 `system/init` 中顯示 `pending`，並在第一次工具呼叫時連線。此等待需要 Claude Code v2.1.221 或更新版本。

277 277

278Claude Code 在啟動時驗證每個 `--mcp-config` 項目，並跳過驗證失敗的項目，例如沒有 `type` 的 `url` 項目。執行會繼續並乾淨地退出，因此檢查這些欄位以捕捉未載入的伺服器：278Claude Code 會在啟動時驗證每個 `--mcp-config` 項目，並略過驗證失敗的項目，例如沒有 `type` 的 `url` 項目。執行會繼續並正常結束，因此請檢查這些欄位，以偵測從未載入的伺服器：

279 279

280| 欄位 | 類型 | 說明 |280| 欄位 | 類型 | 說明 |

281| - | - | - |281| - | - | - |

283| `mcp_server_errors` | 陣列 | 由配置驗證跳過的 `--mcp-config` 項目，每個都有 `name`、`type` 和 `message`。`type` 是跳過類別，例如 `unknown_type`、`url_missing_type`、`invalid_config` 或 `reserved_name`；將您不認識的值視為通用跳過。受影響的伺服器不在 `mcp_servers` 中。當沒有錯誤時，會省略該鍵，因此 CI 閘道可以在非空陣列上失敗。需要 Claude Code v2.1.219 或更新版本 |283| `mcp_server_errors` | array | 因設定驗證而被略過的 `--mcp-config` 項目，每個都包含 `name`、`type` 及 `message`。`type` 是略過類別，例如 `unknown_type`、`url_missing_type`、`invalid_config` 或 `reserved_name`；請將無法辨識的值視為一般略過。受影響的伺服器不會出現在 `mcp_servers` 中。沒有錯誤時會省略此鍵，因此 CI 關卡可以在陣列非空時判定失敗。需要 Claude Code v2.1.219 或更新版本 |

284 284

285當您在終端機中手動執行命令時，Claude Code 也會向 stderr 列印啟動警告，例如 `Warning: 1 MCP server skipped due to invalid config:`，後面跟著每個跳過項目的原因。當您重新導向 stderr 或當 CI 執行器或 SDK 主機等程式捕捉它時，Claude Code 不會列印警告，只在 `mcp_server_errors` 欄位中報告跳過的項目。警告需要 Claude Code v2.1.219 或更新版本。285當您在終端機中手動執行命令時，Claude Code 也會將啟動警告輸出至 stderr，例如 `Warning: 1 MCP server skipped due to invalid config:`，接著列出每個被略過項目的原因。當您重新導向 stderr，或由 CI 執行器或 SDK 主機等程式擷取 stderr 時，Claude Code 不會輸出警告，僅在 `mcp_server_errors` 欄位中回報被略過的項目。此警告需要 Claude Code v2.1.219 或更新版本。

286 286

287<h4 id="track-plugin-installs">287<h4 id="track-plugin-installs">

288 追蹤 plugin 安裝288 追蹤外掛安裝

289</h4>289</h4>

290 290

291當設定 [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/zh-TW/env-vars) 時，Claude Code 在第一次轉向前安裝市場 plugins 時發出 `system/plugin_install` 事件。使用這些在您自己的 UI 中顯示安裝進度。291設定 [`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/docs/zh-TW/env-vars) 時，Claude Code 會在第一個回合之前安裝市集外掛的期間發出 `system/plugin_install` 事件。可使用這些事件在您自己的 UI 中呈現安裝進度。

292 292

293| 欄位 | 類型 | 說明 |293| 欄位 | 類型 | 說明 |

294| - | - | - |294| - | - | - |

302 302

303<h3 id="auto-approve-tools">303<h3 id="auto-approve-tools">

304 自動核准工具304 自動核准工具

305</h3>305</h3>

306 306

307使用 `--allowedTools` 讓 Claude 使用某些工具而無需提示。列出 `Read` 和 `Edit` 讓 Claude 讀取和編輯檔案而無需詢問權限。列出 `Bash` 對 shell 命令執行相同操作，除非在[自動模式](/docs/zh-TW/permission-modes#how-auto-mode-evaluates-actions)中啟動的執行中，Claude Code 會將裸 `Bash` 項目作為廣泛允許規則刪除，自動模式會改為評估每個命令。此範例執行測試套件並使用列出的這三個工具修復失敗：307使用 `--allowedTools` 讓 Claude 無需提示即可使用特定工具。列出 `Read` 及 `Edit` 可讓 Claude 在不請求權限的情況下讀取及編輯檔案。列出 `Bash` 對 shell 命令也有相同效果，但以[自動模式](/docs/zh-TW/permission-modes#how-auto-mode-evaluates-actions)啟動的執行除外；在此情況下，Claude Code 會將單獨的 `Bash` 項目視為過於寬泛的允許規則而捨棄，改由自動模式評估每個命令。此範例列出這三個工具，執行測試套件並修正失敗：

308 308

309```bash theme={null}309```bash theme={null}

310claude -p "Run the test suite and fix any failures" \310claude -p "Run the test suite and fix any failures" \

311 --allowedTools "Bash,Read,Edit"311 --allowedTools "Bash,Read,Edit"

312```312```

313 313

314若要為整個工作階段設定基準而不是列出個別工具，請傳遞[權限模式](/docs/zh-TW/permission-modes)。未設定權限模式的執行採用[內建啟動權限模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)，可能是 `auto`，因此傳遞您想要的：314若要為整個工作階段設定基準，而非列出個別工具，請傳入[權限模式](/docs/zh-TW/permission-modes)。沒有任何設定指定權限模式的執行會採用[內建的起始權限模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)，而它可能是 `auto`，因此請傳入您想要的模式：

315 315

316* **`auto`**：傳遞 `--permission-mode auto` 以讓分類器審查大多數操作，而不是您316* **`auto`**：傳入 `--permission-mode auto`，由分類器代替您審查大多數動作

317* **`dontAsk`**：Claude Code 拒絕每個會以其他方式提示的呼叫，這對鎖定的 CI 執行很有用。在 Manual 模式中不需要核准的操作仍會執行，例如在您的工作目錄中讀取檔案和[唯讀命令集](/docs/zh-TW/permissions#read-only-commands)，您的 `--allowedTools` 項目或 `permissions.allow` 規則涵蓋的操作也會執行。`AskUserQuestion`、連接器工具[您的組織設定為 `ask`](/docs/zh-TW/mcp#organization-controls-on-connector-tools) 和標記為 [`requiresUserInteraction`](/docs/zh-TW/mcp#require-approval-for-a-specific-tool) 的 MCP 工具即使在允許規則符合時也會被拒絕317* **`dontAsk`**：Claude Code 會拒絕所有原本會提示的呼叫，這對於受嚴格限制的 CI 執行很有用。在手動模式下無需核准的動作仍會執行，例如讀取工作目錄中的檔案及[唯讀命令集](/docs/zh-TW/permissions#read-only-commands)，您的 `--allowedTools` 項目或 `permissions.allow` 規則涵蓋的動作也同樣會執行。`AskUserQuestion`、[您的組織設為 `ask`](/docs/zh-TW/mcp#organization-controls-on-connector-tools) 的連接器工具，以及標記為 [`requiresUserInteraction`](/docs/zh-TW/mcp#require-approval-for-a-specific-tool) 的 MCP 工具，即使有允許規則相符仍會被拒絕

318* **`acceptEdits`**：Claude 寫入檔案而無需提示，Claude Code 自動核准常見的檔案系統命令，例如 `mkdir`、`touch`、`mv` 和 `cp`。[沒有模式自動核准的操作](/docs/zh-TW/permission-modes#actions-no-mode-auto-approves)仍然適用。除了唯讀命令集，其他 shell 命令和網路請求仍需要 `--allowedTools` 項目或 `permissions.allow` 規則。請參閱[`acceptEdits` 自動核准的內容](/docs/zh-TW/permission-modes#auto-approve-file-edits-with-acceptedits-mode)以取得完整清單318* **`acceptEdits`**：Claude 無需提示即可寫入檔案，且 Claude Code 會自動核准常見的檔案系統命令，例如 `mkdir`、`touch`、`mv` 及 `cp`。[任何模式都不會自動核准的動作](/docs/zh-TW/permission-modes#actions-no-mode-auto-approves)仍然適用。除唯讀命令集外，其他 shell 命令及網路請求仍需要 `--allowedTools` 項目或 `permissions.allow` 規則。如需完整清單，請參閱 [`acceptEdits` 自動核准的項目](/docs/zh-TW/permission-modes#auto-approve-file-edits-with-acceptedits-mode)

319 319

320此範例以 `acceptEdits` 作為基準應用 lint 修復：320此範例以 `acceptEdits` 作為基準套用 lint 修正：

321 321

322```bash theme={null}322```bash theme={null}

323claude -p "Apply the lint fixes" --permission-mode acceptEdits323claude -p "Apply the lint fixes" --permission-mode acceptEdits

327 在無人值守的執行中關閉權限提示327 在無人值守的執行中關閉權限提示

328</h3>328</h3>

329 329

330當沒有人可用於回答權限提示時，傳遞 `--permission-prompts none`，例如在排程的工作中。當您的執行有權限主機時，該旗標最重要：具有 [`canUseTool` 回呼](/docs/zh-TW/agent-sdk/user-input)的 Agent SDK 應用程式，或您使用 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 傳遞的 MCP 工具。沒有該旗標，您的執行會等待該主機回答每個權限請求。330當沒有人能回應權限提示時，例如在排程工作中，請傳入 `--permission-prompts none`。當您的執行具有權限主機時，此旗標最為重要：具有 [`canUseTool` 回呼](/docs/zh-TW/agent-sdk/user-input)的 Agent SDK 應用程式，或您透過 [`--permission-prompt-tool`](/docs/zh-TW/cli-reference#cli-flags) 傳入的 MCP 工具。若未使用此旗標，您的執行會等待該主機回應每個權限請求。

331 331

332使用該旗標，您的執行不會查詢主機或等待它。任何會提示的內容都會被拒絕，除非 `PermissionRequest` hook 允許它，Claude 被告知沒有人可以核准請求且不應重試它，執行會繼續。在沒有主機的 `-p` 執行中，這些請求無論如何都會被拒絕，該旗標也會告訴 Claude 不要重試它們。權限規則、[`PermissionRequest` hooks](/docs/zh-TW/hooks#permissionrequest) 和您設定的權限模式仍會首先決定每個呼叫；Claude Code 只拒絕其他任何內容都無法解決的請求。332使用此旗標時，您的執行不會諮詢主機，也不會等待它。任何會觸發提示的動作都會被拒絕，除非有 `PermissionRequest` hook 允許；Claude 會被告知沒有人能核准該請求且不應重試，而執行會繼續進行。在沒有主機的 `-p` 執行中，這些請求無論如何都會被拒絕，而此旗標還會告知 Claude 不要重試。權限規則、[`PermissionRequest` hook](/docs/zh-TW/hooks#permissionrequest) 以及您設定的權限模式仍會優先決定每個呼叫；Claude Code 只會拒絕其他機制都無法處理的請求。

333 333

334此範例在[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)中執行無人值守的任務。分類器照常審查每個操作，Claude Code 拒絕任何會回退到提示的內容：334此範例以[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)執行無人值守的任務。分類器會照常審查每個動作，而 Claude Code 會拒絕任何原本會退回提示的動作：

335 335

336```bash theme={null}336```bash theme={null}

337claude -p "Update the dependency pins and run the tests" --permission-mode auto --permission-prompts none337claude -p "Update the dependency pins and run the tests" --permission-mode auto --permission-prompts none

338```338```

339 339

340使用 `--permission-prompts none`，Claude Code 會移除需要來自人員的答案的工具，例如 [`AskUserQuestion`](/docs/zh-TW/tools-reference#askuserquestion-tool-behavior)，因此 Claude 無法呼叫它們。任何沒有 [`Elicitation` hook](/docs/zh-TW/hooks#elicitation) 回答的 [MCP 引出請求](/docs/zh-TW/mcp#respond-to-mcp-elicitation-requests)都會被取消。340使用 `--permission-prompts none` 時，Claude Code 會移除需要由人回應的工具，例如 [`AskUserQuestion`](/docs/zh-TW/tools-reference#askuserquestion-tool-behavior)，因此 Claude 無法呼叫它們。任何沒有 [`Elicitation` hook](/docs/zh-TW/hooks#elicitation) 回應的 [MCP elicitation 請求](/docs/zh-TW/mcp#respond-to-mcp-elicitation-requests)都會被取消。

341 341

342使用 `--output-format stream-json` 時，拒絕會顯示為 `permission_denied` 系統訊息，最終結果訊息在 `permission_denials` 中列出它們。342使用 `--output-format stream-json` 時，拒絕會以 `permission_denied` 系統訊息的形式出現，而最終結果訊息會在 `permission_denials` 中列出這些拒絕。

343 343

344<Note>344<Note>

345 `--permission-prompts` 旗標需要 Claude Code v2.1.259 或更新版本。較早版本會以未知選項錯誤拒絕它。345 `--permission-prompts` 旗標需要 Claude Code v2.1.259 或更新版本。較早的版本會以未知選項錯誤拒絕它。

346</Note>346</Note>

347 347

348<h3 id="create-a-commit">348<h3 id="create-a-commit">

349 建立提交349 建立提交

350</h3>350</h3>

351 351

352此範例審查暫存的變更並建立具有適當訊息的提交：352此範例會審查已暫存的變更，並以適當的訊息建立提交：

353 353

354```bash theme={null}354```bash theme={null}

355claude -p "Look at my staged changes and create an appropriate commit" \355claude -p "Look at my staged changes and create an appropriate commit" \

356 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"356 --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

357```357```

358 358

359`--allowedTools` 旗標使用[權限規則語法](/docs/zh-TW/settings-reference#permission-rule-syntax)。尾部的 ` *` 啟用前綴匹配，因此 `Bash(git diff *)` 允許任何以 `git diff` 開頭的命令。空格在 `*` 之前很重要：沒有它，`Bash(git diff*)` 也會符合 `git diff-index`。359`--allowedTools` 旗標使用[權限規則語法](/docs/zh-TW/settings-reference#permission-rule-syntax)。結尾的 ` *` 會啟用前綴比對，因此 `Bash(git diff *)` 允許任何以 `git diff` 開頭的命令。`*` 前的空格很重要：若沒有空格，`Bash(git diff*)` 也會比對到 `git diff-index`。

360 360

361<Note>361<Note>

362 命令支援在 `-p` 模式中有所不同：362 `-p` 模式下的命令支援有所不同：

363 363

364 * 使用者叫用的 [skills](/docs/zh-TW/skills) 和自訂命令有效。在提示字串中包含 `/skill-name`，Claude Code 會在執行前展開它。364 * 使用者呼叫的 [skill](/docs/zh-TW/skills) 及自訂命令可以運作。在提示詞字串中加入 `/skill-name`，Claude Code 會在執行前將其展開。

365 * 只在終端機介面中執行的內建命令（例如 `/login`）不可用。365 * 僅在終端機介面中執行的內建命令（例如 `/login`）無法使用。

366 * `/model`、`/effort`、`/fast`、`/color` 和 `/rename` 接受值作為引數，例如 `/model sonnet`，`/mcp` 不帶引數會列印伺服器狀態的文字摘要。這些形式需要 Claude Code v2.1.205 或更新版本，並遵循每個命令的[可用性注意事項](/docs/zh-TW/commands#all-commands)。366 * `/model`、`/effort`、`/fast`、`/color` 及 `/rename` 接受以引數形式傳入值，例如 `/model sonnet`；不帶引數的 `/mcp` 會輸出伺服器狀態的文字摘要。這些形式需要 Claude Code v2.1.205 或更新版本，並遵循各命令的[可用性說明](/docs/zh-TW/commands#all-commands)。

367 * 若要變更設定，請將 `key=value` 傳遞給 `/config`，例如 `/config thinking=false`。367 * 若要變更設定，請將 `key=value` 傳給 `/config`，例如 `/config thinking=false`。

368 * `/output-style <style>` 切換[輸出樣式](/docs/zh-TW/output-styles)，`/output-style` 單獨列出它們。需要 Claude Code v2.1.269 或更新版本。368 * `/output-style <style>` 會切換[輸出風格](/docs/zh-TW/output-styles)，單獨使用 `/output-style` 則會列出所有風格。需要 Claude Code v2.1.269 或更新版本。

369</Note>369</Note>

370 370

371<h3 id="customize-the-system-prompt">371<h3 id="customize-the-system-prompt">

372 自訂系統提示372 自訂系統提示詞

373</h3>373</h3>

374 374

375使用 `--append-system-prompt` 在保持 Claude Code 預設行為的同時新增指示。此範例將 PR 差異管道傳輸到 Claude，並指示它審查安全漏洞。將其儲存為 shell 指令碼，例如 `review.sh`：375使用 `--append-system-prompt` 新增指令，同時保留 Claude Code 的預設行為。此範例將 PR 差異透過管道傳入 Claude，並指示它審查安全性弱點。將其儲存為 shell 腳本，例如 `review.sh`：

376 376

377```bash theme={null}377```bash theme={null}

378gh pr diff "$1" | claude -p \378gh pr diff "$1" | claude -p \

380 --output-format json380 --output-format json

381```381```

382 382

383在指令碼中，`"$1"` 代表您在命令列上傳遞的第一個引數。執行 `bash review.sh 123`，shell 會將 `"$1"` 替換為 `123`，因此指令碼會擷取 PR 123 的差異。Claude Code 以 JSON 形式列印審查，文字在 `result` 欄位中。383在此腳本中，`"$1"` 代表您在命令列上傳入的第一個引數。執行 `bash review.sh 123`，shell 會將 `"$1"` 替換為 `123`，因此腳本會擷取 PR 123 的差異。Claude Code 會以 JSON 格式輸出審查結果，文字位於 `result` 欄位。

384 384

385請參閱[系統提示旗標](/docs/zh-TW/cli-reference#system-prompt-flags)以取得更多選項，包括 `--system-prompt` 以完全取代預設提示。385如需更多選項，包括以 `--system-prompt` 完全取代預設提示詞，請參閱[系統提示詞旗標](/docs/zh-TW/cli-reference#system-prompt-flags)。

386 386

387<h3 id="continue-conversations">387<h3 id="continue-conversations">

388 繼續對話388 繼續對話

389</h3>389</h3>

390 390

391使用 `--continue` 繼續最近的對話，或使用 `--resume` 搭配工作階段 ID 繼續特定對話。在 Claude Code v2.1.257 或更新版本上，當您傳遞 `--continue` 時，Claude Code 會開啟已完成但仍在執行的[背景工作階段](/docs/zh-TW/sessions#resume-a-session)。此範例執行審查，然後傳送後續提示：391使用 `--continue` 繼續最近的對話，或使用 `--resume` 搭配工作階段 ID 繼續特定對話。在 Claude Code v2.1.257 或更新版本中，當您傳入 `--continue` 時，Claude Code 會開啟已經完成的[背景工作階段](/docs/zh-TW/sessions#resume-a-session)，但不會開啟仍在執行中的背景工作階段。此範例會執行一次審查，然後傳送後續提示詞：

392 392

393```bash theme={null}393```bash theme={null}

394# First request394# First request

399claude -p "Generate a summary of all issues found" --continue399claude -p "Generate a summary of all issues found" --continue

400```400```

401 401

402如果您執行多個對話，請擷取工作階段 ID 以繼續特定對話：402如果您同時進行多個對話，請擷取工作階段 ID 以繼續特定的對話：

403 403

404```bash theme={null}404```bash theme={null}

405session_id=$(claude -p "Start a review" --output-format json | jq -r '.session_id')405session_id=$(claude -p "Start a review" --output-format json | jq -r '.session_id')

406claude -p "Continue that review" --resume "$session_id"406claude -p "Continue that review" --resume "$session_id"

407```407```

408 408

409您可以從不同的目錄執行這兩個命令：Claude Code [按其 ID 在此機器上的任何專案中找到工作階段](/docs/zh-TW/sessions#resume-a-session)。在 v2.1.223 之前，Claude Code 只在目前專案目錄及其 git worktrees 中尋找 ID，因此您必須從同一目錄執行兩個命令。409您可以從不同的目錄執行這兩個命令：Claude Code 會在此機器上的任何專案中[依 ID 尋找工作階段](/docs/zh-TW/sessions#resume-a-session)。在 v2.1.223 之前，Claude Code 只會在目前的專案目錄及其 git worktree 中尋找該 ID，因此您必須從同一個目錄執行這兩個命令。

410 410

411您可以將工作階段的絕對路徑傳遞給 `--resume`，而不是工作階段 ID，該路徑指向工作階段的 `.jsonl` [文字記錄檔](/docs/zh-TW/sessions#where-transcripts-are-stored)，Claude Code 會繼續儲存在該檔案中的對話。411您也可以不傳入工作階段 ID，改為將工作階段 `.jsonl` [逐字稿檔案](/docs/zh-TW/sessions#where-transcripts-are-stored)的絕對路徑傳給 `--resume`，Claude Code 會繼續該檔案中儲存的對話。

412 412

413<h2 id="next-steps">413<h2 id="next-steps">

414 後續步驟414 後續步驟

hipaa-setup.md +12 −5

Details

15 * Claude Desktop 的 Code 分頁中的 Claude Code15 * Claude Desktop 的 Code 分頁中的 Claude Code

16 * Claude Desktop 中的 Cowork16 * Claude Desktop 中的 Cowork

17 17

18 VS Code 和 JetBrains 的 Claude Code 擴充功能不屬於（本機模式）。套用 HIPAA 設定後，這些擴充功能仍可繼續運作，但您的 BAA 不涵蓋它們。如需完整的合格服務清單，請參閱[實作指南](https://trust.anthropic.com/resources?s=rgirr4qe8u7ek8c2igx3\&name=claude-for-enterprise-hipaa-ready-offering-implementation-guide)。18 VS Code 和 JetBrains 的 Claude Code 擴充功能不屬於（本機模式）。套用 HIPAA 設定後，這些擴充功能仍可繼續運作，但您的 BAA 不涵蓋它們。如需完整的合格服務清單，請參閱[實作指南](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide)。

19</Note>19</Note>

20 20

21本頁面適用於負責準備開發人員電腦的 IT 或安全管理員。設定本身由您 Claude 組織的主要擁有者（Primary Owner）套用。[在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）](https://support.claude.com/en/articles/17318731)說明了您的 BAA 包含哪些內容、設定如何套用，以及如何排定套用日期。21本頁面適用於負責準備開發人員電腦的 IT 或安全管理員。設定本身由您 Claude 組織的主要擁有者（Primary Owner）套用。[在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）](https://support.claude.com/en/articles/17318731)說明了您的 BAA 包含哪些內容、設定如何套用，以及如何排定套用日期。

174 174

175* **Claude Console 登入和聯合憑證**：`forceLoginOrgUUID` 僅檢查 claude.ai 登入。[將登入限制為您的組織](/docs/zh-TW/authentication#restrict-login-to-your-organization)列出了 Claude Code 針對各登入途徑和憑證所檢查的內容。175* **Claude Console 登入和聯合憑證**：`forceLoginOrgUUID` 僅檢查 claude.ai 登入。[將登入限制為您的組織](/docs/zh-TW/authentication#restrict-login-to-your-organization)列出了 Claude Code 針對各登入途徑和憑證所檢查的內容。

176* **伺服器受管設定**：如果您的組織也使用[伺服器受管設定](/docs/zh-TW/server-managed-settings)，請讓擁有者在其中加入相同的設定鍵。[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明了套用哪個來源。176* **伺服器受管設定**：如果您的組織也使用[伺服器受管設定](/docs/zh-TW/server-managed-settings)，請讓擁有者在其中加入相同的設定鍵。[Claude Code 如何合併受管來源](/docs/zh-TW/managed-settings#how-claude-code-combines-managed-sources)說明了套用哪個來源。

177* **早於 v2.1.285 的版本**：這些版本會忽略 `allowedProviders`，因此仍可在雲端供應商或閘道上啟動。若要讓 v2.1.163 至 v2.1.284 拒絕啟動，您可以在與[範例設定鍵](#deploy-managed-settings)相同的受管設定中，加入設為 `"2.1.285"` 的 [`requiredMinimumVersion`](/docs/zh-TW/settings-reference#requiredminimumversion)。早於 v2.1.163 的版本除了 `allowedProviders` 之外也會忽略 `requiredMinimumVersion`，因此請[更新這些電腦](#update-claude-code-and-claude-desktop)。

177 178

178若要了解您的 BAA 是否涵蓋在沒有 HIPAA 設定的情況下執行的工作階段，請參閱[在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）](https://support.claude.com/en/articles/17318731)。179若要了解您的 BAA 是否涵蓋在沒有 HIPAA 設定的情況下執行的工作階段，請參閱[在 HIPAA-ready Enterprise 方案上使用 Claude Code（本機模式）和 Cowork（本機模式）](https://support.claude.com/en/articles/17318731)。

179 180

234 235

235套用 HIPAA 設定後，Claude Code 會從其啟動的 shell 命令、hook 和 MCP 伺服器的環境中，移除其用來連線 Anthropic 的憑證，例如 `ANTHROPIC_API_KEY` 和 `ANTHROPIC_AUTH_TOKEN`。236套用 HIPAA 設定後，Claude Code 會從其啟動的 shell 命令、hook 和 MCP 伺服器的環境中，移除其用來連線 Anthropic 的憑證，例如 `ANTHROPIC_API_KEY` 和 `ANTHROPIC_AUTH_TOKEN`。

236 237

237HIPAA 設定不會移除雲端供應商或 GitHub 憑證，因此推送至 GitHub 或呼叫其他服務的命令仍會以該開發人員的存取權限運作。您與 Anthropic 簽訂的 BAA 不涵蓋其傳送至這些服務的資料。如需完整的合格服務清單，請參閱[實作指南](https://trust.anthropic.com/resources?s=rgirr4qe8u7ek8c2igx3\&name=claude-for-enterprise-hipaa-ready-offering-implementation-guide)。238HIPAA 設定不會移除雲端供應商或 GitHub 憑證，因此推送至 GitHub 或呼叫其他服務的命令仍會以該開發人員的存取權限運作。您與 Anthropic 簽訂的 BAA 不涵蓋其傳送至這些服務的資料。如需完整的合格服務清單，請參閱[實作指南](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide)。

238 239

239若要限制 Claude 可使用的命令和主機，請參閱[權限規則](/docs/zh-TW/permissions)和[沙箱](/docs/zh-TW/sandboxing)。240若要限制 Claude 可使用的命令和主機，請參閱[權限規則](/docs/zh-TW/permissions)和[沙箱](/docs/zh-TW/sandboxing)。

240 241

275 立即刪除工作階段資料276 立即刪除工作階段資料

276</h3>277</h3>

277 278

278如果您的組織需要在保留清除作業刪除之前移除某位開發人員的工作階段資料，您可以用一個命令移除其中大部分資料。以該開發人員的身分登入電腦，並在任何 shell 中執行此命令：279如果您的組織需要在保留清除作業刪除之前移除某位開發人員的工作階段資料，您可以用一個命令移除其中大部分資料。以該開發人員的身分登入電腦，開啟任何 shell，並執行與已安裝的 Claude Code 版本對應的命令。

280

281在 Claude Code v2.1.288 或更新版本上，執行 `claude purge`：

279 282

280```bash theme={null}283```bash theme={null}

281claude purge --all --yes284claude purge --all --yes

282```285```

283 286

284在 v2.1.288 之前，此命令為 `claude project purge`。287在 v2.1.126 至 v2.1.287 上，執行 `claude project purge`，它接受相同的旗標：

288

289```bash theme={null}

290claude project purge --all --yes

291```

285 292

286此命令會刪除每個專案的逐字稿和自動記憶、`tasks/`、`debug/` 和 `file-history/` 中的項目、`history.jsonl`，以及 `~/.claude.json` 中的專案項目。若未加上 `--yes`，它會先輸出計畫並詢問確認。293這兩個命令都會刪除每個專案的逐字稿和自動記憶、`tasks/`、`debug/` 和 `file-history/` 中的項目、`history.jsonl`，以及 `~/.claude.json` 中的專案項目。若未加上 `--yes`，它會先輸出計畫並詢問確認。

287 294

288清除作業會留下其他可能包含工作階段內容的路徑，例如 `paste-cache/` 中貼上的文字。[清除本機資料](/docs/zh-TW/claude-directory#clear-local-data)列出了您可以手動刪除的路徑。若要完全清除一台電腦，例如在重新指派之前，請[抹除該電腦](#offboard-a-developer)。295清除作業會留下其他可能包含工作階段內容的路徑，例如 `paste-cache/` 中貼上的文字。[清除本機資料](/docs/zh-TW/claude-directory#clear-local-data)列出了您可以手動刪除的路徑。若要完全清除一台電腦，例如在重新指派之前，請[抹除該電腦](#offboard-a-developer)。

289 296

hooks.md +4 −4

Details

772| 欄位 | 描述 |772| 欄位 | 描述 |

773| :- | :- |773| :- | :- |

775| `prompt_id` | UUID 識別目前正在處理的使用者提示。與 [OpenTelemetry 事件上的 `prompt.id` 屬性](/docs/zh-TW/monitoring-usage#event-correlation-attributes) 相符，因此您可以將 hook 輸出與單一提示的遙測相關聯。在第一個使用者輸入之前不存在。需要 Claude Code v2.1.196 或更新版本 |775| `prompt_id` | 識別目前正在處理的使用者提示詞的 UUID。與 [OpenTelemetry 事件上的 `prompt.id` 屬性](/docs/zh-TW/monitoring-usage#event-correlation-attributes) 相符，因此您可以將 hook 輸出與單一提示詞的遙測相關聯。在第一個使用者輸入之前不存在 |

776| `transcript_path` | 對話 JSON 的路徑。成績單檔案以非同步方式寫入，可能滯後於記憶體中的對話，因此當 hook 觸發時，它可能尚未包含目前回合的最新訊息。需要目前回合最後助手文字的 Hooks 應在 [Stop](#stop) 和 [SubagentStop](#subagentstop) 上使用 `last_assistant_message`，而不是讀取成績單 |776| `transcript_path` | 對話 JSON 的路徑。成績單檔案以非同步方式寫入，可能滯後於記憶體中的對話，因此當 hook 觸發時，它可能尚未包含目前回合的最新訊息。需要目前回合最後助手文字的 Hooks 應在 [Stop](#stop) 和 [SubagentStop](#subagentstop) 上使用 `last_assistant_message`，而不是讀取成績單 |

777| `cwd` | 叫用 hook 時的目前工作目錄 |777| `cwd` | 叫用 hook 時的目前工作目錄 |

778| `scratchpad_dir` | 工作階段的 [暫存目錄](/docs/zh-TW/claude-directory#session-scratchpad-directory) 的路徑，Claude 在其中保存臨時工作檔案。當工作階段沒有暫存或臨時目錄不可用時不存在。需要 Claude Code v2.1.257 或更新版本 |778| `scratchpad_dir` | 工作階段的 [暫存目錄](/docs/zh-TW/claude-directory#session-scratchpad-directory) 的路徑，Claude 在其中保存臨時工作檔案。當工作階段沒有暫存或臨時目錄不可用時不存在。需要 Claude Code v2.1.257 或更新版本 |

1359 1359

1360Setup hook 無法阻擋；無論退出碼為何，執行都會繼續。無論退出碼為何，Claude Code 都會捨棄 Setup hook 的 [JSON 輸出欄位](#json-output)，例如 `systemMessage`、`continue` 與 `hookSpecificOutput.additionalContext`。使用 `-p` 時，Setup hook 的 stdout、stderr 與退出碼只有在您以 `--output-format stream-json --verbose` 啟動時，才會以 [`hook_response` 事件](/docs/zh-TW/headless#read-session-metadata)的形式出現在執行輸出中。1360Setup hook 無法阻擋；無論退出碼為何，執行都會繼續。無論退出碼為何，Claude Code 都會捨棄 Setup hook 的 [JSON 輸出欄位](#json-output)，例如 `systemMessage`、`continue` 與 `hookSpecificOutput.additionalContext`。使用 `-p` 時，Setup hook 的 stdout、stderr 與退出碼只有在您以 `--output-format stream-json --verbose` 啟動時，才會以 [`hook_response` 事件](/docs/zh-TW/headless#read-session-metadata)的形式出現在執行輸出中。

1361 1361

1362Setup hook 可以存取 `CLAUDE_ENV_FILE`。寫入該檔案的變數會保存到該工作階段的後續 Bash 命令中，與 [SessionStart hook](#persist-environment-variables) 相同。只有 `type: "command"` hook 會在 `Setup` 上執行。`Setup` 上的 `type: "mcp_tool"` hook 一律會被略過，如 [MCP tool hook 欄位](#mcp-tool-hook-fields)中所述。1362Setup hook 可以存取 `CLAUDE_ENV_FILE`。寫入該檔案的變數會保存到該工作階段後續的 Bash 命令中，與 [SessionStart hook](#persist-environment-variables) 相同。`Setup` 上只會執行 `type: "command"` hook。`Setup` 上的 `type: "mcp_tool"` hook 一律會被略過，如 [MCP 工具 hook 欄位](#mcp-tool-hook-fields)中所述。

1363 1363

1364<h3 id="instructionsloaded">1364<h3 id="instructionsloaded">

1365 InstructionsLoaded1365 InstructionsLoaded

1366</h3>1366</h3>

1367 1367

1368在 `CLAUDE.md` 或 `.claude/rules/*.md` 檔案載入上下文時觸發。此事件會在工作階段開始時針對預先載入的檔案觸發，之後在延遲載入檔案時再次觸發，例如當 Claude 存取包含巢狀 `CLAUDE.md` 的子目錄，或帶有 `paths:` frontmatter 的條件式規則相符時。此 hook 不支援阻擋或決策控制。它會為了可觀察性而以非同步方式執行。1368當 `CLAUDE.md` 或 `.claude/rules/*.md` 檔案載入上下文時觸發。此事件會在工作階段開始時針對立即載入的檔案觸發，之後在檔案延遲載入時再次觸發，例如當 Claude 存取包含巢狀 `CLAUDE.md` 的子目錄時，或具有 `paths:` frontmatter 的條件式規則符合時。此 hook 不支援阻擋或決策控制。它以非同步方式執行，用於可觀察性目的。

1369 1369

1370當 Claude 透過 **Project instructions** 設定[直接讀取 `AGENTS.md`](/docs/zh-TW/memory#agents-md) 時，此事件不會觸發。當 `CLAUDE.md` 匯入您的 `AGENTS.md` 時，此事件會觸發，且 `load_reason` 與其他任何匯入的檔案一樣設為 `include`；當 `CLAUDE.md` 是指向它的符號連結時，也會以一般的 `CLAUDE.md` 載入觸發。1370當 Claude 透過 **Project instructions** 設定[直接讀取 `AGENTS.md`](/docs/zh-TW/memory#agents-md) 時，此事件不會觸發。當 `CLAUDE.md` 匯入您的 `AGENTS.md` 時，此事件會觸發，且 `load_reason` 與其他任何匯入的檔案一樣設為 `include`；當 `CLAUDE.md` 是指向它的符號連結時，也會以一般的 `CLAUDE.md` 載入觸發。

1371 1371

2140| `addRules` | `rules`、`behavior`、`destination` | 新增權限規則。`rules` 是 `{toolName, ruleContent?}` 物件的陣列。省略 `ruleContent` 即可比對整個工具。`behavior` 為 `"allow"`、`"deny"` 或 `"ask"` |2140| `addRules` | `rules`、`behavior`、`destination` | 新增權限規則。`rules` 是 `{toolName, ruleContent?}` 物件的陣列。省略 `ruleContent` 即可比對整個工具。`behavior` 為 `"allow"`、`"deny"` 或 `"ask"` |

2143| `setMode` | `mode`、`destination` | 變更權限模式。有效的模式為 `default`、`auto`、`acceptEdits`、`dontAsk`、`bypassPermissions`、`plan`，以及作為 `default` 別名的 `manual`。`manual` 別名需要 Claude Code v2.1.200 或更新版本 |2143| `setMode` | `mode`、`destination` | 變更權限模式。有效模式為 `default`、`auto`、`acceptEdits`、`dontAsk`、`bypassPermissions`、`plan`，以及作為 `default` 別名的 `manual` |

2146 2146

interactive-mode.md +5 −5

Details

215| `$` | 行尾 |215| `$` | 行尾 |

216| `^` | 第一個非空白字元 |216| `^` | 第一個非空白字元 |

217| `gg` | 輸入開始 |217| `gg` | 輸入開始 |

218| `G` | 輸入結尾 |218| `G` | 最後一行的開頭 |

219| `f{char}` | 跳到下一個字元出現位置 |219| `f{char}` | 跳到下一個字元出現位置 |

220| `F{char}` | 跳到上一個字元出現位置 |220| `F{char}` | 跳到上一個字元出現位置 |

221| `t{char}` | 跳到下一個字元出現位置之前 |221| `t{char}` | 跳到下一個字元出現位置之前 |

355* 當 Claude Code 結束時，背景工作會自動清理。在 macOS 和 Linux 上，當您從 [`/tasks`](/docs/zh-TW/commands) 停止背景工作或 Claude Code 在結束時停止它時，從工作的 shell 分離的程序（例如在 `setsid` 或 `timeout` 下啟動的程序）也會停止355* 當 Claude Code 結束時，背景工作會自動清理。在 macOS 和 Linux 上，當您從 [`/tasks`](/docs/zh-TW/commands) 停止背景工作或 Claude Code 在結束時停止它時，從工作的 shell 分離的程序（例如在 `setsid` 或 `timeout` 下啟動的程序）也會停止

356* 如果您將工作階段放在背景而不是結束它，您的背景工作會繼續在背景工作階段中執行。請參閱[將執行中的工作階段放在背景](/docs/zh-TW/agent-view#from-inside-a-session)356* 如果您將工作階段放在背景而不是結束它，您的背景工作會繼續在背景工作階段中執行。請參閱[將執行中的工作階段放在背景](/docs/zh-TW/agent-view#from-inside-a-session)

357* 背景工作如果輸出超過 5GB，會自動終止，stderr 中會有說明原因的備註357* 背景工作如果輸出超過 5GB，會自動終止，stderr 中會有說明原因的備註

358* 在 macOS 和 Linux 上，當作業系統發出記憶體壓力信號時，Claude Code 會終止執行中的背景工作，前提是工作階段已閒置至少 30 分鐘且沒有執行任何轉向或子代理。需要 Claude Code v2.1.193 或更新版本358* 在 macOS 和 Linux 上，當作業系統回報嚴重記憶體壓力時，Claude Code 會停止您執行中的背景任務，前提是工作階段已閒置至少 30 分鐘，且沒有任何回合或 subagent 正在執行

359 * [偵錯日誌](/docs/zh-TW/debug-your-config)會說明為什麼工作被停止，或為什麼壓力事件讓它們繼續執行359 * [偵錯日誌](/docs/zh-TW/debug-your-config)會說明為什麼任務被停止，或為什麼壓力事件讓它們繼續執行

360 * 將 [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/zh-TW/env-vars) 設定為 `1` 以關閉記憶體壓力停止360 * 將 [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/zh-TW/env-vars) 設定為 `1` 以關閉記憶體壓力停止

361* 在您從終端機、桌面應用程式或 VS Code 擴充功能操作的本機工作階段中，背景命令沒有時間限制。在無人看管執行的工作階段中（例如 `-p` 執行或雲端工作階段），Claude Code 會在背景命令達到其[時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)時停止它361* 在您從終端機、桌面應用程式或 VS Code 擴充功能操作的本機工作階段中，背景命令沒有時間限制。在無人看管執行的工作階段中（例如 `-p` 執行或雲端工作階段），Claude Code 會在背景命令達到其[時間限制](/docs/zh-TW/tools-reference#time-limit-for-background-commands)時停止它

362* 由前景[子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)啟動的背景命令在該子代理的執行結束時結束，無論是完成、失敗或被中斷；請參閱工具參考中的[背景命令停止時](/docs/zh-TW/tools-reference#when-a-background-command-stops)362* 由前景[子代理](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background)啟動的背景命令在該子代理的執行結束時結束，無論是完成、失敗或被中斷；請參閱工具參考中的[背景命令停止時](/docs/zh-TW/tools-reference#when-a-background-command-stops)

390* 支援相同的 `Ctrl+B` 背景執行，用於長時間執行的命令390* 支援相同的 `Ctrl+B` 背景執行，用於長時間執行的命令

391* 不需要 Claude 解釋或核准命令391* 不需要 Claude 解釋或核准命令

392* 支援歷史記錄型自動完成：輸入部分命令並按 `Tab` 以從目前專案中的先前 `!` 命令完成392* 支援歷史記錄型自動完成：輸入部分命令並按 `Tab` 以從目前專案中的先前 `!` 命令完成

393* 自 v2.1.193 起在所有平台上支援即時檔案路徑自動完成：輸入包含正斜線的權杖（例如 `./src/` 或 `~/`）以查看相符檔案和目錄的下拉式清單，然後按 `Tab` 以接受。在 Windows 上也使用正斜線；下拉式清單由 `/` 觸發，而不是 `\`393* 支援即時檔案路徑自動完成：輸入包含正斜線的 token（例如 `./src/` 或 `~/`）以查看相符檔案和目錄的下拉式清單，然後按 `Tab` 以接受。在 Windows 上也使用正斜線；下拉式清單由 `/` 觸發，而不是 `\`

394* 在空提示上按 `Escape`、`Backspace` 或 `Ctrl+U` 結束394* 在空提示上按 `Escape`、`Backspace` 或 `Ctrl+U` 結束

395* 將以 `!` 開頭的文字貼到空提示中會自動進入 shell 模式，符合輸入的 `!` 行為395* 將以 `!` 開頭的文字貼到空提示中會自動進入 shell 模式，符合輸入的 `!` 行為

396 396

397除非您的工作階段是[嚴格沙箱模式](/docs/zh-TW/sandboxing#turn-off-the-retry-with-strict-sandbox-mode)下列出的其中一個，否則您在 shell 模式中輸入的命令會在[沙箱](/docs/zh-TW/sandboxing)外執行，即使您已啟用沙箱機制，因為沙箱適用於 Claude 執行的命令。397除非您的工作階段是[嚴格沙箱模式](/docs/zh-TW/sandboxing#turn-off-the-retry-with-strict-sandbox-mode)下列出的其中一個，否則您在 shell 模式中輸入的命令會在[沙箱](/docs/zh-TW/sandboxing)外執行，即使您已啟用沙箱機制，因為沙箱適用於 Claude 執行的命令。

398 398

399一旦命令輸出進入文字記錄，Claude 會自動回應，因此您可以執行 `! npm test` 並取得失敗的說明，無需第二個提示。回應成本與傳送一般提示相同。若要還原先前的行為（其中輸出會新增至內容而不回應），請在 `settings.json` 中將 [`respondToBashCommands`](/docs/zh-TW/settings-reference#respondtobashcommands) 設定為 `false`。在 v2.1.186 之前，shell 模式始終將輸出新增至內容而不回應。399一旦命令輸出進入逐字稿，Claude 會自動回應，因此您可以執行 `! npm test` 並取得失敗的說明，無需第二個提示詞。回應成本與傳送一般提示詞相同。若要改為將輸出新增至內容而不回應，請在 `settings.json` 中將 [`respondToBashCommands`](/docs/zh-TW/settings-reference#respondtobashcommands) 設定為 `false`。

400 400

401<h2 id="queue-messages-while-claude-works">401<h2 id="queue-messages-while-claude-works">

402 在 Claude 工作時排隊傳送訊息402 在 Claude 工作時排隊傳送訊息

keybindings.md +5 −5

Details

160| `confirm:previous` | Up | 上一個選項 |160| `confirm:previous` | Up | 上一個選項 |

162| `confirm:nextField` | Tab | 下一個欄位 |162| `confirm:nextField` | Tab | 在 `/fast` 對話框中，開啟或關閉快速模式 |

163| `confirm:previousField` | (未綁定) | 上一個欄位 |163| `confirm:previousField` | (未綁定) | Claude Code 不會回應此動作，且命名它的 `keybindings.json` 仍然有效 |

165| `confirm:cycleMode` | Shift+Tab\* | 循環權限模式。在檔案權限提示上，關閉開啟的 [評論欄位](/docs/zh-TW/permissions#add-a-comment-when-you-answer-a-permission-prompt)；沒有開啟的欄位時，選擇允許該動作用於工作階段其餘部分的選項，當提示提供該選項時 |165| `confirm:cycleMode` | Shift+Tab\* | 在檔案權限提示上，關閉開啟的 [評論欄位](/docs/zh-TW/permissions#add-a-comment-when-you-answer-a-permission-prompt)；沒有開啟的欄位時，選擇允許該動作用於工作階段其餘部分的選項，當提示提供該選項時 |

166 166

167\*在沒有 VT 模式的 Windows 上 (Node \<24.2.0/\<22.17.0, Bun \<1.2.23)，預設為 Meta+M。167\*在沒有 VT 模式的 Windows 上 (Node \<24.2.0/\<22.17.0, Bun \<1.2.23)，預設為 Meta+M。

168 168

200 200

201| 動作 | 預設 | 說明 |201| 動作 | 預設 | 說明 |

202| :- | :- | :- |202| :- | :- | :- |

203| `permission:toggleDebug` | (未綁定) | 切換權限偵錯資訊。Ctrl+D 的先前預設值在 v2.1.146 中被移除，因為它遮蔽了 `app:exit` |203| `permission:toggleDebug` | (未綁定) | Claude Code 不會回應此動作，且命名它的 `keybindings.json` 仍然有效 |

204 204

205<h3 id="transcript-actions">205<h3 id="transcript-actions">

206 文字記錄動作206 文字記錄動作

239 239

240| 動作 | 預設 | 說明 |240| 動作 | 預設 | 說明 |

241| :- | :- | :- |241| :- | :- | :- |

243 243

244<h3 id="theme-actions">244<h3 id="theme-actions">

245 主題動作245 主題動作

large-codebases.md +4 −4

Details

68 68

70| :- | :- | :- | :- |70| :- | :- | :- | :- |

72| 子目錄 | 僅該子樹，直到您授予更多權限 | 該目錄的加上每個祖先的 | 工作範圍限於一個套件或子系統 |72| 子目錄 | 僅該子樹，直到您授予更多權限 | 該目錄的加上每個祖先的 | 工作範圍限於一個套件或子系統 |

73 73

74`.claude/settings.json` 中的專案設定不像 CLAUDE.md 檔案那樣從父目錄繼承。如需瞭解工作階段讀取哪個目錄的 `.claude/settings.json`，請參閱 [Claude Code 在何處查找各個檔案](/docs/zh-TW/settings#where-claude-code-looks-for-each-file)。74`.claude/settings.json` 中的專案設定不像 CLAUDE.md 檔案那樣從父目錄繼承。如需瞭解工作階段讀取哪個目錄的 `.claude/settings.json`，請參閱 [Claude Code 在何處查找各個檔案](/docs/zh-TW/settings#where-claude-code-looks-for-each-file)。

81 81

82在大型程式碼庫中，儲存庫根目錄的單個 CLAUDE.md 往往要麼增長到涵蓋每個子系統的約定，在與當前任務無關的指令上浪費上下文，要麼保持太通用而無用。將指令分散到按目錄的檔案中意味著 Claude 載入儲存庫範圍的規則加上僅適用於您正在處理的程式碼的約定。82在大型程式碼庫中，儲存庫根目錄的單個 CLAUDE.md 往往要麼增長到涵蓋每個子系統的約定，在與當前任務無關的指令上浪費上下文，要麼保持太通用而無用。將指令分散到按目錄的檔案中意味著 Claude 載入儲存庫範圍的規則加上僅適用於您正在處理的程式碼的約定。

83 83

84Claude Code 在啟動時從您的工作目錄和每個父目錄載入每個 [CLAUDE.md](/docs/zh-TW/memory) 檔案，然後當它在該處讀取檔案時按需載入每個子目錄的檔案。根檔案設定儲存庫範圍的規則，每個子目錄添加其自己的規則。84Claude Code 在啟動時從您的工作目錄和每個父目錄載入每個 [CLAUDE.md](/docs/zh-TW/memory) 檔案，然後[按需](/docs/zh-TW/memory#how-claude-md-files-load)載入每個子目錄的檔案。根檔案設定儲存庫範圍的規則，每個子目錄添加其自己的規則。

85 85

86常見的分割是兩個級別：86常見的分割是兩個級別：

87 87

124 124

125| 方法 | 檔案位置 | 載入時機 | 使用時機 |125| 方法 | 檔案位置 | 載入時機 | 使用時機 |

126| :- | :- | :- | :- |126| :- | :- | :- | :- |

129 129

130有關也涵蓋技能的比較，請參閱[比較相似功能](/docs/zh-TW/features-overview#compare-similar-features)。130有關也涵蓋技能的比較，請參閱[比較相似功能](/docs/zh-TW/features-overview#compare-similar-features)。

133 排除無關的 CLAUDE.md 檔案133 排除無關的 CLAUDE.md 檔案

134</h3>134</h3>

135 135

136當您從儲存庫根目錄啟動 Claude 時，每個子目錄的 CLAUDE.md 在 Claude 讀取該目錄中的檔案時立即載入。`claudeMdExcludes` 設定按路徑或 glob 模式跳過特定檔案，以便它們永遠不會載入。136當您從儲存庫根目錄啟動 Claude 時，每個子目錄的 CLAUDE.md 可以在工作階段期間[按需載入](/docs/zh-TW/memory#how-claude-md-files-load)。`claudeMdExcludes` 設定按路徑或 glob 模式跳過特定檔案，以便它們永遠不會載入。

137 137

138將此用於您從不使用的目錄，例如其他團隊的套件、舊程式碼或供應商子樹。排除清單是靜態的，不是按任務的開關。若要今天專注於一個套件，明天專注於另一個套件，請[從該套件的目錄啟動 Claude](#choose-where-to-start-claude)，而不是編輯排除項。138將此用於您從不使用的目錄，例如其他團隊的套件、舊程式碼或供應商子樹。排除清單是靜態的，不是按任務的開關。若要今天專注於一個套件，明天專注於另一個套件，請[從該套件的目錄啟動 Claude](#choose-where-to-start-claude)，而不是編輯排除項。

139 139

legal-and-compliance.md +6 −1

Details

46 醫療保健合規（BAA）46 醫療保健合規（BAA）

47</h3>47</h3>

48 48

49如果客戶已與 Anthropic 簽訂業務關聯協議（BAA），並已為相關組織啟用[零資料保留（ZDR）](/docs/zh-TW/zero-data-retention)，該 BAA 將擴展至客戶通過 Claude Code 的 API 流量。49如果客戶已與 Anthropic 簽訂業務關聯協議（BAA），該 BAA 將依據貴組織可使用的選項，擴展至以下兩種設定下的 Claude Code：

51* **HIPAA 設定**：搭配 Claude for Enterprise 帳戶使用的 Claude Code CLI 或 Claude Desktop 中的 Code 分頁。該組織必須已啟用 HIPAA，並已將 HIPAA 設定套用至 Claude Code（本機模式）與 Cowork（本機模式）。請參閱[為符合 HIPAA 要求的組織設定 Claude Code（本機模式）](/docs/zh-TW/hipaa-setup)。

52* **零資料保留**：已為相關組織啟用[零資料保留（ZDR）](/docs/zh-TW/zero-data-retention)的 Claude Code。ZDR 並非適用於所有組織。

54在 HIPAA 設定下，雲端工作階段、Remote Control、Claude 行動應用程式中的 Claude Code，以及透過第三方雲端供應商或閘道路由的 Claude Code 均不在涵蓋範圍內。請查閱[實施指南](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide)以取得完整的合格服務清單。

50 55

51<h2 id="usage-policy">56<h2 id="usage-policy">

52 使用政策57 使用政策

mcp.md +1 −1

Details

52 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增 marketplace，然後重試安裝。52 * `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增 marketplace，然後重試安裝。

53 * [plugin 在 marketplace 中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查 plugin 名稱。53 * [plugin 在 marketplace 中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查 plugin 名稱。

54 54

55 如果安裝摘要報告 `Run /reload-plugins to activate.`，Claude Code 會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`。55 如果安裝摘要報告 `Run /reload-plugins to apply.`，Claude Code 會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`。

56 </Step>56 </Step>

57 57

58 <Step title="執行建立 skill">58 <Step title="執行建立 skill">

memory.md +20 −17

Details

71 71

72工作目錄上方目錄階層中的 CLAUDE.md 和 CLAUDE.local.md 檔案在啟動時載入。子目錄中的檔案在 Claude 讀取這些目錄中的檔案時按需載入。請參閱 [CLAUDE.md 檔案如何載入](#how-claude-md-files-load) 以了解完整的解析順序。72工作目錄上方目錄階層中的 CLAUDE.md 和 CLAUDE.local.md 檔案在啟動時載入。子目錄中的檔案按需載入。請參閱 [CLAUDE.md 檔案如何載入](#how-claude-md-files-load) 以了解它們何時載入以及完整的解析順序。

73 73

74對於大型專案，您可以使用 [project rules](#organize-rules-with-claude/rules/) 將指令分解為主題特定的檔案。規則可讓您將指令範圍限制為特定檔案類型或子目錄。74對於大型專案，您可以使用 [project rules](#organize-rules-with-claude/rules/) 將指令分解為主題特定的檔案。規則可讓您將指令範圍限制為特定檔案類型或子目錄。

75 75

161 161

162所有發現的檔案都會串聯到背景中，而不是相互覆寫。在目錄樹中，內容從檔案系統根目錄向下排序到您的工作目錄。對於 `foo/bar/` 範例，`foo/CLAUDE.md` 在背景中出現在 `foo/bar/CLAUDE.md` 之前，因此更接近您啟動 Claude 的位置的指令最後讀取。在每個目錄中，`CLAUDE.local.md` 附加在 `CLAUDE.md` 之後，因此您的個人筆記是 Claude 在該級別讀取的最後一件事。162所有發現的檔案都會串聯到背景中，而不是相互覆寫。在目錄樹中，內容從檔案系統根目錄向下排序到您的工作目錄。對於 `foo/bar/` 範例，`foo/CLAUDE.md` 在背景中出現在 `foo/bar/CLAUDE.md` 之前，因此更接近您啟動 Claude 的位置的指令最後讀取。在每個目錄中，`CLAUDE.local.md` 附加在 `CLAUDE.md` 之後，因此您的個人筆記是 Claude 在該級別讀取的最後一件事。

163 163

164Claude 也會發現您目前工作目錄下子目錄中的 `CLAUDE.md` 和 `CLAUDE.local.md` 檔案。它們不是在啟動時載入，而是在 Claude 讀取這些子目錄中的檔案時包含。關於 `.claude/worktrees/` 下 worktree 中的檔案，請參閱 [使用 worktree 隔離 subagent](/docs/zh-TW/worktrees#isolate-subagents-with-worktrees)。164Claude 也會發現您目前工作目錄下子目錄中的 `CLAUDE.md` 和 `CLAUDE.local.md` 檔案。它們不是在啟動時載入，而是在 Claude 對這些子目錄中的檔案使用 [Read](/docs/zh-TW/tools-reference#read-tool-behavior)、[Write](/docs/zh-TW/tools-reference#write-tool-behavior) 或 [Edit](/docs/zh-TW/tools-reference#edit-tool-behavior) 工具時，由 Claude Code 將其納入。如果 Claude 已對子目錄的 `CLAUDE.md` 本身使用過其中一個工具，該檔案就不會以這種方式載入，因為 Claude Code 將其視為已在對話中。關於 `.claude/worktrees/` 下 worktree 中的檔案，請參閱 [使用 worktree 隔離 subagent](/docs/zh-TW/worktrees#isolate-subagents-with-worktrees)。

165 165

166如果您在大型 monorepo 中工作，其中其他團隊的 CLAUDE.md 檔案被拾取，請使用 [`claudeMdExcludes`](#exclude-specific-claude-md-files) 跳過它們。有關根目錄和每個目錄 CLAUDE.md 檔案和規則的完整配置，請參閱 [Monorepos 和大型儲存庫](/docs/zh-TW/large-codebases)。166如果您在大型 monorepo 中工作，其中其他團隊的 CLAUDE.md 檔案被拾取，請使用 [`claudeMdExcludes`](#exclude-specific-claude-md-files) 跳過它們。有關根目錄和每個目錄 CLAUDE.md 檔案和規則的完整配置，請參閱 [Monorepos 和大型儲存庫](/docs/zh-TW/large-codebases)。

167 167

316組織可以部署適用於機器上所有使用者的集中管理 CLAUDE.md。此檔案無法由個別設定排除。316組織可以部署適用於機器上所有使用者的集中管理 CLAUDE.md。此檔案無法由個別設定排除。

317 317

318<Steps>318<Steps>

319 <Step title="Create the file at the managed policy location">319 <Step title="在受管理的原則位置建立檔案">

320 * macOS：`/Library/Application Support/ClaudeCode/CLAUDE.md`320 * macOS：`/Library/Application Support/ClaudeCode/CLAUDE.md`

321 * Linux 和 WSL：`/etc/claude-code/CLAUDE.md`321 * Linux 和 WSL：`/etc/claude-code/CLAUDE.md`

322 * Windows：`C:\Program Files\ClaudeCode\CLAUDE.md`322 * Windows：`C:\Program Files\ClaudeCode\CLAUDE.md`

323 </Step>323 </Step>

324 324

325 <Step title="Deploy with your configuration management system">325 <Step title="使用您的設定管理系統進行部署">

326 使用 MDM、Group Policy、Ansible 或類似工具在開發人員機器上分發檔案。請參閱 [managed settings](/docs/zh-TW/managed-settings) 以了解其他組織範圍設定選項。326 使用 MDM、Group Policy、Ansible 或類似工具在開發人員機器上分發檔案。請參閱 [managed settings](/docs/zh-TW/managed-settings) 以了解其他組織範圍設定選項。

327 </Step>327 </Step>

328</Steps>328</Steps>

333 333

334**優先順序**：與受管理的 CLAUDE.md 檔案相同。在使用者和專案 CLAUDE.md 之前載入。334**優先順序**：與受管理的 CLAUDE.md 檔案相同。在使用者和專案 CLAUDE.md 之前載入。

335 335

336**其中受尊重**：僅受管理和原則設定。在使用者、專案或本機設定中設定 `claudeMd` 無效。336**適用位置**：僅受管理和原則設定。在使用者、專案或本機設定中設定 `claudeMd` 無效。

337 337

338下面的範例直接在受管理的設定檔案中新增行為指令：338下面的範例直接在受管理的設定檔案中新增行為指令：

339 339

430| `claude-md-and-agents-md` | 您的 `CLAUDE.md` 和 `AGENTS.md` 檔案一起，每個目錄的 `CLAUDE.md` 檔案優先，其 `AGENTS.md` 在之後。Claude Code 會跳過已經載入的 `AGENTS.md`，因此您的 `CLAUDE.md` 匯入或符號連結到的 `AGENTS.md` 不會讀取兩次 |430| `claude-md-and-agents-md` | 您的 `CLAUDE.md` 和 `AGENTS.md` 檔案一起，每個目錄的 `CLAUDE.md` 檔案優先，其 `AGENTS.md` 在之後。Claude Code 會跳過已經載入的 `AGENTS.md`，因此您的 `CLAUDE.md` 匯入或符號連結到的 `AGENTS.md` 不會讀取兩次 |

432| `managed-only` | 僅您組織的受管 `CLAUDE.md` 和啟動時的[自動記憶](#auto-memory)。您的專案、本機和使用者 `CLAUDE.md` 檔案、您的 `.claude/rules/` 檔案和每個 `AGENTS.md` 都被排除在外。當 Claude 讀取該處的檔案時，子目錄的 `CLAUDE.md` 和 `.claude/rules/` 檔案仍會載入，[路徑範圍規則](#path-specific-rules)仍會套用 |432| `managed-only` | 僅您組織的受管 `CLAUDE.md` 和啟動時的[自動記憶](#auto-memory)。您的專案、本機和使用者 `CLAUDE.md` 檔案、您的 `.claude/rules/` 檔案和每個 `AGENTS.md` 都被排除在外。子目錄的 `CLAUDE.md` 和 `.claude/rules/` 檔案，以及[路徑範圍規則](#path-specific-rules)，仍會按需載入 |

433 433

434您也可以在設定檔中設定值，而不是 `/config`。在 [`pluginConfigs`](/docs/zh-TW/settings-reference#pluginconfigs) 中的內建 `agents-md` 外掛程式的 ID 下新增它，在 `~/.claude/settings.json`、`--settings` 檔案或[受管設定](/docs/zh-TW/managed-settings)中。Claude Code 在專案和本機設定檔中忽略它。此範例讓 Claude 讀取兩個檔案：434您也可以在設定檔中設定值，而不是使用 `/config`。將它新增到 [`pluginConfigs`](/docs/zh-TW/settings-reference#pluginconfigs) 中的 `cc-plugin-agents-md@builtin` 下，這是讀取 `AGENTS.md` 的內建外掛的 ID。Claude Code 會從 `~/.claude/settings.json`、`--settings` 檔案或[受管設定](/docs/zh-TW/managed-settings)中讀取該項目，並在專案和本機設定檔中忽略它。此範例讓 Claude 讀取兩個檔案：

435 435

436```json settings.json theme={null}436```json settings.json theme={null}

437{437{

438 "pluginConfigs": {438 "pluginConfigs": {

439 "agents-md@builtin": {439 "cc-plugin-agents-md@builtin": {

440 "options": { "instructionFiles": "claude-md-and-agents-md" }440 "options": { "instructionFiles": "claude-md-and-agents-md" }

441 }441 }

442 }442 }

443}443}

444```444```

445 445

446在 v2.1.285 之前，該外掛的 ID 是 `agents-md@builtin`，且 Claude Code 會忽略 `cc-plugin-agents-md@builtin` 下的項目。如果較早的版本也會讀取您的設定檔，請在其中使用 `agents-md@builtin`。Claude Code v2.1.285 及更新版本會讀取任一 ID 下的項目。

447

446您的變更從您傳送的下一則訊息和每個新工作階段開始套用。448您的變更從您傳送的下一則訊息和每個新工作階段開始套用。

447 449

448<h3 id="when-agents-md-support-is-unavailable">450<h3 id="when-agents-md-support-is-unavailable">

452在這些工作階段中，Claude 僅讀取 `CLAUDE.md` 檔案，**專案指示**不會出現在 `/config` 設定面板中：454在這些工作階段中，Claude 僅讀取 `CLAUDE.md` 檔案，**專案指示**不會出現在 `/config` 設定面板中：

453 455

454* 您使用的是 v2.1.277 之前的 Claude Code 版本456* 您使用的是 v2.1.277 之前的 Claude Code 版本

455* 您停用了內建 `agents-md` 外掛程式在 `/plugin` 中457* 您使用 `/plugin` 停用了讀取 `AGENTS.md` 的內建外掛

456* 在某些情況下，這是您[從 v2.1.276 或更早版本升級](/docs/zh-TW/env-vars#first-session-after-an-install-or-upgrade)後的第一個工作階段。Claude 會從您的下一個工作階段開始讀取 `AGENTS.md`458* 在某些情況下，這是您[從 v2.1.276 或更早版本升級](/docs/zh-TW/env-vars#first-session-after-an-install-or-upgrade)後的第一個工作階段。Claude 會從您的下一個工作階段開始讀取 `AGENTS.md`

457 459

458在 v2.1.281 之前，某些工作階段（例如在 Amazon Bedrock 上或停用遙測的工作階段）僅讀取 `CLAUDE.md` 檔案。在這些版本上，請更新 Claude Code。若要在這些工作階段中將您的 `AGENTS.md` 提供給 Claude，請[從 `CLAUDE.md` 匯入](#share-one-file-with-other-coding-tools)。460在 v2.1.281 之前，某些工作階段（例如在 Amazon Bedrock 上或停用遙測的工作階段）僅讀取 `CLAUDE.md` 檔案。在這些版本上，請更新 Claude Code。若要在這些工作階段中將您的 `AGENTS.md` 提供給 Claude，請[從 `CLAUDE.md` 匯入](#share-one-file-with-other-coding-tools)。

623 使用 `/memory` 檢視和編輯625 使用 `/memory` 檢視和編輯

624</h2>626</h2>

625 627

626`/memory` 命令列出您的 CLAUDE.md、CLAUDE.local.md 和其他記憶檔案在使用者和專案範圍內的位置，包括尚不存在的檔案的使用者和專案 CLAUDE.md 項目。它也讓您切換自動記憶開啟或關閉，並提供開啟自動記憶資料夾的選項。選擇任何檔案以在您的編輯器中開啟它；選擇尚不存在的檔案會先建立它。若要檢查哪些 `CLAUDE.md` 和規則檔案實際載入到目前工作階段中，請執行 `/context`。628`/memory` 命令列出您的 CLAUDE.md、CLAUDE.local.md 和其他記憶檔案在使用者和專案範圍內的位置，包括尚不存在的檔案的使用者和專案 CLAUDE.md 項目。它也讓您切換自動記憶開啟或關閉，並提供開啟自動記憶資料夾的選項。選擇任何檔案以在您的編輯器中開啟它；選擇尚不存在的檔案會先建立它。若要檢查啟動時載入了哪些 `CLAUDE.md` 和規則檔案，請執行 `/context`。

627 629

628VS Code 等 GUI 編輯器會在單獨的視窗中開啟檔案，您可以在檔案開啟時繼續使用工作階段。在 v2.1.216 之前，`/memory` 會等待您關閉檔案後才回應。Vim 等終端編輯器會接管終端，直到您退出。630VS Code 等 GUI 編輯器會在單獨的視窗中開啟檔案，您可以在檔案開啟時繼續使用工作階段。在 v2.1.216 之前，`/memory` 會等待您關閉檔案後才回應。Vim 等終端編輯器會接管終端，直到您退出。

629 631

639 Claude 不遵循我的 CLAUDE.md641 Claude 不遵循我的 CLAUDE.md

640</h3>642</h3>

641 643

642CLAUDE.md 內容作為系統提示後的使用者訊息傳遞，而不是系統提示本身的一部分。Claude 讀取它並嘗試遵循它，但沒有嚴格遵守的保證，特別是對於模糊或衝突的指令。644CLAUDE.md 內容作為系統提示詞後的使用者訊息傳遞，而不是系統提示詞本身的一部分。Claude 讀取它並嘗試遵循它，但沒有嚴格遵守的保證，特別是對於模糊或衝突的指令。

643 645

644要除錯：646要除錯：

645 647

646* 執行 `/context` 並檢查 **Memory files** 下的清單，以驗證您的 CLAUDE.md 和 CLAUDE.local.md 檔案是否已載入。如果 `CLAUDE.md` 檔案未列出，Claude 看不到它。使用 `/memory` 開啟和編輯檔案。648* 執行 `/context` 並檢查 **Memory files** 下的清單，以驗證應在啟動時載入的 CLAUDE.md 和 CLAUDE.local.md 檔案。如果其中某個檔案未列在那裡，Claude 就看不到它。使用 `/memory` 開啟和編輯檔案。

649* 工作目錄之子目錄中的 `CLAUDE.md` 不會出現在 **Memory files** 下，因為它是按需載入，而不是在啟動時載入。當它載入時，終端機中會出現一行包含其路徑的 `Loaded`。若要測試新的檔案，請從 shell 建立它，而不是要求 Claude 撰寫，然後要求 Claude 讀取該子目錄中的檔案。

647* 檢查相關的 CLAUDE.md 是否位於為您的工作階段載入的位置（請參閱 [選擇 CLAUDE.md 檔案的位置](#choose-where-to-put-claude-md-files)）。650* 檢查相關的 CLAUDE.md 是否位於為您的工作階段載入的位置（請參閱 [選擇 CLAUDE.md 檔案的位置](#choose-where-to-put-claude-md-files)）。

648* 使指令更具體。「使用 2 空格縮排」比「正確格式化程式碼」效果更好。651* 使指令更具體。「使用 2 空格縮排」比「正確格式化程式碼」效果更好。

649* 查找跨 CLAUDE.md 檔案的衝突指令。如果兩個檔案為相同行為提供不同的指導，Claude 可能會任意選擇一個。652* 查找跨 CLAUDE.md 檔案的衝突指令。如果兩個檔案為相同行為提供不同的指導，Claude 可能會任意選擇一個。

650* 檢查您的指令是否與 Claude Code 自行新增的指導相競爭。如果您的 CLAUDE.md 設定提交或提取請求規則，請使用 [`includeGitInstructions`](/docs/zh-TW/settings-reference#includegitinstructions) 關閉內建規則，並使用 [`attribution`](/docs/zh-TW/settings-reference#attribution) 設定歸屬文字。653* 檢查您的指令是否與 Claude Code 自行新增的指導相競爭。如果您的 CLAUDE.md 設定提交或 pull request 規則，請使用 [`includeGitInstructions`](/docs/zh-TW/settings-reference#includegitinstructions) 關閉內建規則，並使用 [`attribution`](/docs/zh-TW/settings-reference#attribution) 設定歸屬文字。

651 654

652如果指令是必須在特定時間點執行的內容，例如在每次提交前或每次檔案編輯後，請改為將其寫成 [hook](/docs/zh-TW/hooks-guide)。Hooks 在固定的生命週期事件中作為 shell 命令執行，並且無論 Claude 決定做什麼都適用。655如果指令是必須在特定時間點執行的內容，例如在每次提交前或每次檔案編輯後，請改為將其寫成 [hook](/docs/zh-TW/hooks-guide)。Hook 在固定的生命週期事件中作為 shell 命令執行，並且無論 Claude 決定做什麼都適用。

653 656

654對於您想要在系統提示級別的指令，請使用 [`--append-system-prompt`](/docs/zh-TW/cli-reference#system-prompt-flags)。您在啟動時傳遞它，因此它更適合指令碼和自動化，而不是互動式使用。如需了解它在恢復對話時的行為方式，請參閱 [已恢復對話中的系統提示旗標](/docs/zh-TW/cli-reference#system-prompt-flags-in-resumed-conversations)。657對於您想要在系統提示詞級別的指令，請使用 [`--append-system-prompt`](/docs/zh-TW/cli-reference#system-prompt-flags)。您在啟動時傳遞它，因此它更適合指令碼和自動化，而不是互動式使用。如需了解它在恢復對話時的行為方式，請參閱 [已恢復對話中的系統提示詞旗標](/docs/zh-TW/cli-reference#system-prompt-flags-in-resumed-conversations)。

655 658

656<Tip>659<Tip>

657 使用 [`InstructionsLoaded` hook](/docs/zh-TW/hooks#instructionsloaded) 記錄確切載入的指令檔案、何時載入以及為什麼。這對於除錯路徑特定規則或子目錄中的延遲載入檔案很有用。660 使用 [`InstructionsLoaded` hook](/docs/zh-TW/hooks#instructionsloaded) 記錄載入了哪些 `CLAUDE.md` 和規則檔案、何時載入以及為什麼。這對於除錯路徑特定規則或子目錄中的延遲載入檔案很有用。

658</Tip>661</Tip>

659 662

660<h3 id="my-agents-md-isn’t-loading">663<h3 id="my-agents-md-isn’t-loading">

693 指令在 `/compact` 後似乎丟失了696 指令在 `/compact` 後似乎丟失了

694</h3>697</h3>

695 698

696專案根目錄 CLAUDE.md 在壓縮中倖存：在 `/compact` 之後，Claude 從磁碟重新讀取它並將其重新注入到工作階段中。子目錄中的巢狀 CLAUDE.md 檔案和具有 [`paths:` frontmatter](#path-specific-rules) 的規則會在 Claude 讀取它們適用的檔案時重新載入。699專案根目錄 CLAUDE.md 在壓縮中倖存：在 `/compact` 之後，Claude 從磁碟重新讀取它並將其重新注入到工作階段中。子目錄中的巢狀 CLAUDE.md 檔案和具有 [`paths:` frontmatter](#path-specific-rules) 的規則會按需重新載入。

697 700

698如果指令在壓縮後消失，它要麼只在對話中給出，要麼位於尚未重新載入的巢狀 CLAUDE.md 中，或者是尚未符合檔案的路徑範圍規則。將對話專用指令新增到 CLAUDE.md 以使其持久化。有關完整的細目，請參閱 [壓縮後倖存的內容](/docs/zh-TW/context-window#what-survives-compaction)。701如果指令在壓縮後消失，它要麼只在對話中給出，要麼位於尚未重新載入的巢狀 CLAUDE.md 中，或者是尚未符合檔案的路徑範圍規則。將對話專用指令新增到 CLAUDE.md 以使其持久化。有關完整的細目，請參閱 [壓縮後倖存的內容](/docs/zh-TW/context-window#what-survives-compaction)。

699 702

monitoring-usage.md +5 −5

Details

128| `OTEL_METRIC_EXPORT_INTERVAL` | 匯出間隔（毫秒）（預設值：60000） | `5000`、`60000` |128| `OTEL_METRIC_EXPORT_INTERVAL` | 匯出間隔（毫秒）（預設值：60000） | `5000`、`60000` |

129| `OTEL_LOGS_EXPORT_INTERVAL` | 日誌匯出間隔（毫秒）（預設值：5000） | `1000`、`10000` |129| `OTEL_LOGS_EXPORT_INTERVAL` | 日誌匯出間隔（毫秒）（預設值：5000） | `1000`、`10000` |

130| `OTEL_LOG_USER_PROMPTS` | 啟用使用者提示內容的日誌記錄（預設值：停用） | `1` 啟用 |130| `OTEL_LOG_USER_PROMPTS` | 啟用使用者提示內容的日誌記錄（預設值：停用） | `1` 啟用 |

132| `OTEL_LOG_TOOL_DETAILS` | 在工具事件和追蹤跨度屬性中啟用工具參數和輸入引數的日誌記錄：Bash 命令、MCP 伺服器和工具名稱、技能名稱、使用者撰寫的工作流程名稱和工具輸入。也在 `user_prompt` 事件上啟用自訂、外掛程式和 MCP 命令名稱，以及在[成本和令牌計數器](#cost-counter)上啟用真實代理、技能、外掛程式和 MCP 伺服器和工具名稱（預設值：停用）。對於 Claude Desktop 的內建伺服器，在 Claude Desktop 擁有的工作階段中，即使關閉旗標，`mcp_server_name`/`mcp_tool_name` 也會在 `tool_decision`/`tool_result` 上發出。例外需要 Claude Code v2.1.214 或更新版本 | `1` 啟用 |132| `OTEL_LOG_TOOL_DETAILS` | 在工具事件和追蹤跨度屬性中啟用工具參數和輸入引數的日誌記錄：Bash 命令、MCP 伺服器和工具名稱、技能名稱、使用者撰寫的工作流程名稱和工具輸入。也在 `user_prompt` 事件上啟用自訂、外掛程式和 MCP 命令名稱，以及在[成本和令牌計數器](#cost-counter)上啟用真實代理、技能、外掛程式和 MCP 伺服器和工具名稱（預設值：停用）。對於 Claude Desktop 的內建伺服器，在 Claude Desktop 擁有的工作階段中，即使關閉旗標，`mcp_server_name`/`mcp_tool_name` 也會在 `tool_decision`/`tool_result` 上發出。例外需要 Claude Code v2.1.214 或更新版本 | `1` 啟用 |

133| `OTEL_LOG_TOOL_CONTENT` | 在 [`tool.output` 跨度事件](#tool-output-span-event)中啟用工具內容的日誌記錄（預設值：停用）。跨度屬性在[其自己的閘門](#new-context-gates)下攜帶工具內容。需要[追蹤](#traces-beta)。內容在內容限制處截斷（預設值 60 KB） | `1` 啟用 |133| `OTEL_LOG_TOOL_CONTENT` | 在 [`tool.output` 跨度事件](#tool-output-span-event)中啟用工具內容的日誌記錄（預設值：停用）。跨度屬性在[其自己的閘門](#new-context-gates)下攜帶工具內容。需要[追蹤](#traces-beta)。內容在內容限制處截斷（預設值 60 KB） | `1` 啟用 |

134| `OTEL_LOG_MANAGED_SETTINGS` | 將編輯的受管設定和設定編輯前的 SHA-256 摘要新增至[受管設定已解決](#managed-settings-resolved-event)事件（預設值：停用）。專案或本機設定中的值不會將其開啟。需要 Claude Code v2.1.274 或更新版本 | `1` 啟用 |134| `OTEL_LOG_MANAGED_SETTINGS` | 將編輯的受管設定和設定編輯前的 SHA-256 摘要新增至[受管設定已解決](#managed-settings-resolved-event)事件（預設值：停用）。專案或本機設定中的值不會將其開啟。需要 Claude Code v2.1.274 或更新版本 | `1` 啟用 |

819 助手回應事件819 助手回應事件

820</h4>820</h4>

821 821

822在返回模型文字內容的每個 API 請求後記錄。只包括回應的文字區塊；思考區塊和工具使用區塊被排除。需要 Claude Code v2.1.193 或更新版本。822在每次從模型傳回文字內容的 API 請求之後記錄。只包含回應中的文字區塊；思考區塊與工具使用區塊不包含在內。

823 823

824**事件名稱**：`claude_code.assistant_response`824**事件名稱**：`claude_code.assistant_response`

825 825

1157* `plugin_id_hash`：外掛程式名稱和市場的確定性雜湊，僅發送到您配置的匯出器。讓您計算整個車隊中載入的不同第三方外掛程式，而無需記錄其名稱。對於[從 claude.ai 同步的外掛程式](/docs/zh-TW/plugins/loading#synced-plugins)，Claude Code 使用外掛程式名稱與 claude.ai 為外掛程式報告的市場名稱進行雜湊，或使用 `synced`。在 v2.1.246 之前，Claude Code 在雜湊中未使用 claude.ai 報告的市場名稱1157* `plugin_id_hash`：外掛程式名稱和市場的確定性雜湊，僅發送到您配置的匯出器。讓您計算整個車隊中載入的不同第三方外掛程式，而無需記錄其名稱。對於[從 claude.ai 同步的外掛程式](/docs/zh-TW/plugins/loading#synced-plugins)，Claude Code 使用外掛程式名稱與 claude.ai 為外掛程式報告的市場名稱進行雜湊，或使用 `synced`。在 v2.1.246 之前，Claude Code 在雜湊中未使用 claude.ai 報告的市場名稱

1158* `has_hooks`：外掛程式是否貢獻鉤子1158* `has_hooks`：外掛程式是否貢獻鉤子

1159* `has_mcp`：外掛程式是否貢獻 MCP 伺服器1159* `has_mcp`：外掛程式是否貢獻 MCP 伺服器

1160* `host_owned_mcp`：當 SDK 主機管理此外掛程式的 MCP 連線且 Claude Code 跳過讀取外掛程式的 MCP 伺服器配置時為 `true`，否則為 `false`。需要 Claude Code v2.1.172 或更新版本1160* `host_owned_mcp`：當 SDK 主機管理此外掛的 MCP 連線，且 Claude Code 略過讀取外掛的 MCP 伺服器設定時為 `true`，否則為 `false`

1161* `skill_path_count`：外掛程式宣告的技能目錄數1161* `skill_path_count`：外掛程式宣告的技能目錄數

1162* `command_path_count`：外掛程式宣告的命令目錄數1162* `command_path_count`：外掛程式宣告的命令目錄數

1163* `agent_path_count`：外掛程式宣告的代理程式目錄數1163* `agent_path_count`：外掛程式宣告的代理程式目錄數

1336* `pre_tokens`：壓縮前的近似權杖計數1336* `pre_tokens`：壓縮前的近似權杖計數

1337* `post_tokens`：壓縮後的近似權杖計數1337* `post_tokens`：壓縮後的近似權杖計數

1338* `error`：壓縮失敗時的錯誤消息1338* `error`：壓縮失敗時的錯誤消息

1339* `precompute_reuse`：僅當 `trigger` 為 `"manual"` 時設定。自動壓縮可以在上下文視窗填滿之前在背景中準備摘要，此屬性記錄 `/compact` 是否重用該準備的摘要。`"hit"` 表示它被重用；`"miss_custom_instructions"`、`"miss_hook"` 和 `"miss_not_ready"` 給出改為計算新摘要的原因。需要 Claude Code v2.1.153 或更新版本1339* `precompute_reuse`：僅在 `trigger` 為 `"manual"` 時設定。自動壓縮可在上下文視窗填滿之前於背景預先準備摘要，而此屬性記錄 `/compact` 是否重複使用了該預先準備的摘要。`"hit"` 表示已重複使用；`"miss_custom_instructions"`、`"miss_hook"` 與 `"miss_not_ready"` 則說明改為重新計算摘要的原因

1340 1340

1341<h4 id="subagent-completed-event">1341<h4 id="subagent-completed-event">

1342 子代理程式已完成事件1342 子代理程式已完成事件

1518* 異常的權杖消耗1518* 異常的權杖消耗

1519* 來自特定使用者的高工作階段量1519* 來自特定使用者的高工作階段量

1520 1520

1521所有指標都可以按[標準屬性](#standard-attributes)進行分段。`model` 屬性可在 `claude_code.token.usage`、`claude_code.cost.usage` 上使用，以及從 v2.1.172 開始，`claude_code.lines_of_code.count` 上也可使用。1521所有指標都可以按[標準屬性](#standard-attributes)進行分段。`model` 屬性可在 `claude_code.token.usage`、`claude_code.cost.usage` 和 `claude_code.lines_of_code.count` 上使用。

1522 1522

1523提交的按模型細分只能透過在 `session.id` 上與權杖或成本指標進行聯接來近似，因為一個工作階段可以跨越多個模型。篩選權杖或成本端的列，使 `query_source` 為 `"main"`，以便輔助和子代理請求不會將工作階段的提交歸因於未進行提交的模型。1523提交的按模型細分只能透過在 `session.id` 上與權杖或成本指標進行聯接來近似，因為一個工作階段可以跨越多個模型。篩選權杖或成本端的列，使 `query_source` 為 `"main"`，以便輔助和子代理請求不會將工作階段的提交歸因於未進行提交的模型。

1524 1524

network-config.md +1 −1

Details

69 CA 憑證存放區69 CA 憑證存放區

70</h2>70</h2>

71 71

72根據預設，Claude Code 信任其捆綁的 Mozilla CA 憑證和您作業系統的憑證存放區。讀取作業系統存放區需要具有 `tls.getCACertificates` 的執行時環境：原生安裝程式始終具有它，npm 安裝需要 Node 22.15 或更新版本。在較舊的 Node 版本上，只有捆綁的集合和 `NODE_EXTRA_CA_CERTS` 適用。企業 TLS 檢查代理在其根憑證安裝在作業系統信任存放區中且執行時可以讀取它時，無需額外設定即可運作。72根據預設，Claude Code 信任其捆綁的 Mozilla CA 憑證和您作業系統的憑證存放區。讀取作業系統存放區需要具有 `tls.getCACertificates` 的執行時環境：原生安裝程式始終具有它，npm 安裝需要 Node 22.15 或更新版本。在較舊的 Node 版本上，只有捆綁的集合和 `NODE_EXTRA_CA_CERTS` 適用。企業 TLS 檢查代理伺服器在其根憑證安裝在作業系統信任存放區中且執行時可以讀取它時，無需額外設定即可運作。如果此類代理伺服器無法正確處理 gzip 壓縮的請求主體，請設定 [`CLAUDE_CODE_GZIP_REQUEST_BODIES=0`](/docs/zh-TW/env-vars) 以關閉 Claude API、遙測和 artifact 發布請求的壓縮。

73 73

74`CLAUDE_CODE_CERT_STORE` 接受以逗號分隔的來源清單。認可的值為 `bundled`（Claude Code 隨附的 Mozilla CA 集合）和 `system`（作業系統信任存放區）。預設值為 `bundled,system`。74`CLAUDE_CODE_CERT_STORE` 接受以逗號分隔的來源清單。認可的值為 `bundled`（Claude Code 隨附的 Mozilla CA 集合）和 `system`（作業系統信任存放區）。預設值為 `bundled,system`。

75 75

permission-modes.md +11 −9

Details

27 27

28審查每個操作的模式在 CLI 中、`claude --help` 中、VS Code 和 JetBrains 擴充功能中以及桌面應用程式中名為 **Manual**。其設定值為 `default`，這是 hooks 和 SDK 整合使用的值。CLI 接受 `manual` 作為別名，無論您在何處輸入該值，例如 `claude --permission-mode manual` 或 `"defaultMode": "manual"`。Manual 標籤和 `manual` 別名需要 Claude Code v2.1.200 或更新版本。桌面應用程式的標籤不取決於您的 CLI 版本。28審查每個操作的模式在 CLI 中、`claude --help` 中、VS Code 和 JetBrains 擴充功能中以及桌面應用程式中名為 **Manual**。其設定值為 `default`，這是 hook 和 SDK 整合使用的值。CLI 接受 `manual` 作為別名，無論您在何處輸入該值，例如 `claude --permission-mode manual` 或 `"defaultMode": "manual"`。

29 29

30寫入[受保護的路徑](#protected-paths)永遠不會自動批准，唯一的例外是 `bypassPermissions` 模式，以及可使用略過權限的 Plan Mode 工作階段，也就是以[將 `bypassPermissions` 放入模式循環](#switch-permission-modes)的方式啟動的工作階段。30寫入[受保護的路徑](#protected-paths)永遠不會自動批准，唯一的例外是 `bypassPermissions` 模式，以及可使用略過權限的 Plan Mode 工作階段，也就是以[將 `bypassPermissions` 放入模式循環](#switch-permission-modes)的方式啟動的工作階段。

31 31

359 分類器預設阻止的內容359 分類器預設阻止的內容

360</h3>360</h3>

361 361

362分類器信任您的工作目錄，以及工作階段啟動時為其設定的遠端。在工作階段期間使用 `git remote add` 或 `git remote set-url` 新增或重新指向的遠端不受信任，其他所有內容都被視為外部，直到您[設定受信任的基礎設施](/docs/zh-TW/auto-mode-config)。在 v2.1.200 之前，工作階段中途新增的遠端也受信任。362分類器信任您的工作目錄，以及工作階段啟動時為其設定的遠端。在工作階段期間使用 `git remote add` 或 `git remote set-url` 新增或重新指向的遠端不受信任，其他所有內容都被視為外部，直到您[設定受信任的基礎設施](/docs/zh-TW/auto-mode-config)。

363 363

364**預設阻止**：364**預設阻止**：

365 365

392* 啟動在沒有人工核准或沙箱的情況下執行的自主 agent 迴圈，例如使用 `--dangerously-skip-permissions` 或 `--no-sandbox` 啟動的迴圈。這包括在停用隔離和逐項操作核准的情況下執行第三方 agent 或評估工具，例如使用 `--yes-always` 啟動的執行器392* 啟動在沒有人工核准或沙箱的情況下執行的自主 agent 迴圈，例如使用 `--dangerously-skip-permissions` 或 `--no-sandbox` 啟動的迴圈。這包括在停用隔離和逐項操作核准的情況下執行第三方 agent 或評估工具，例如使用 `--yes-always` 啟動的執行器

393* 可能將頁面內容、Cookie 或憑證傳送到其他來源的 [Claude in Chrome](/docs/zh-TW/chrome) 瀏覽器操作393* 可能將頁面內容、Cookie 或憑證傳送到其他來源的 [Claude in Chrome](/docs/zh-TW/chrome) 瀏覽器操作

394* 透過萬用字元、glob 或存留時間篩選，而非特定指名的路徑，刪除 `/tmp`、`$TMPDIR` 或其他共享暫存或快取目錄中的檔案394* 透過萬用字元、glob 或存留時間篩選，而非特定指名的路徑，刪除 `/tmp`、`$TMPDIR` 或其他共享暫存或快取目錄中的檔案

395* 在傳送、上傳、發佈或寫給其他人或共享系統的內容中包含敏感細節，而您自己的訊息並未授權將這些細節提供給該收件者。當儲存庫位於信任邊界之外或為公開時（包括您組織自己的公開儲存庫），PR 和 issue 內文、提交訊息和留言都視為此類對外內容；內部檔案路徑、代號、即時 API 回應資料（例如電子郵件或帳戶識別碼）以及基礎設施識別碼都視為敏感細節。PR、issue 和提交訊息的範圍界定需要 Claude Code v2.1.200 或更新版本。PR 或 issue 內文中來自 API 回應的即時個人資料，例如電子郵件地址、帳戶或組織識別碼或使用量指標，無論儲存庫的可見性或信任邊界為何，都需要您指明這些細節和收件者。該檢查需要 Claude Code v2.1.203 或更新版本395* 在傳送、上傳、發佈或寫給其他人或共享系統的內容中包含敏感細節，而您自己的訊息並未授權將這些細節提供給該收件者。當儲存庫位於信任邊界之外或為公開時（包括您組織自己的公開儲存庫），PR 和 issue 內文、提交訊息和留言都視為此類對外內容；內部檔案路徑、代號、即時 API 回應資料（例如電子郵件或帳戶識別碼）以及基礎設施識別碼都視為敏感細節。PR 或 issue 內文中來自 API 回應的即時個人資料，例如電子郵件地址、帳戶或組織識別碼或使用量指標，無論儲存庫的可見性或信任邊界為何，都需要您指明這些細節和收件者。該檢查需要 Claude Code v2.1.203 或更新版本

396* 向 Claude Code 自己的 tmux 窗格傳送按鍵以操控其自身介面，分類器將此視為 Claude 變更自己的權限或監督396* 向 Claude Code 自己的 tmux 窗格傳送按鍵以操控其自身介面，分類器將此視為 Claude 變更自己的權限或監督

~~397~~

398其中幾個類別取決於[環境](/docs/zh-TW/auto-mode-config#define-trusted-infrastructure)項目，例如敏感遠端目標和受保護的 IaC 範圍，您可以將其縮小到具體名稱。

~~399~~

400Claude Code v2.1.200 及更新版本也預設阻止這些：

~~401~~

402* 註解掉、刪除或強制通過保護安全行為的測試或斷言，例如驗證、存取控制、輸入驗證或沙箱機制397* 註解掉、刪除或強制通過保護安全行為的測試或斷言，例如驗證、存取控制、輸入驗證或沙箱機制

403* 刪除或拆除 Claude 未在工作階段中建立的有狀態資源，當沒有更具體的刪除規則適用且您未指明該資源時398* 刪除或拆除 Claude 未在工作階段中建立的有狀態資源，當沒有更具體的刪除規則適用且您未指明該資源時

404* 將 API 基礎 URL、代理伺服器端點、webhook 接收器或 registry 鏡像重新指向不符合任務的第三方主機，包括在 `.env.example` 等範例檔案中399* 將 API 基礎 URL、代理伺服器端點、webhook 接收器或 registry 鏡像重新指向不符合任務的第三方主機，包括在 `.env.example` 等範例檔案中

406* 將秘密或個人或受託資料推送到已知為公開的儲存庫，或將不屬於該儲存庫本身工作的機密資料推送到那裡。對個人或受託資料而言，dotfiles 儲存庫本身的主題內容是唯一的例外，而來自私人儲存庫的內容流向任何公開使用介面也會以相同方式被阻止；這兩項改進都需要 Claude Code v2.1.203 或更新版本。在 v2.1.203 之前，個人資料與機密資料歸為同一類，僅當其不屬於該儲存庫本身的工作時才會被阻止。當儲存庫的可見性未確定時，分類器不會僅憑此點而阻止；它會改為依據其他規則判斷內容401* 將秘密或個人或受託資料推送到已知為公開的儲存庫，或將不屬於該儲存庫本身工作的機密資料推送到那裡。對個人或受託資料而言，dotfiles 儲存庫本身的主題內容是唯一的例外，而來自私人儲存庫的內容流向任何公開使用介面也會以相同方式被阻止；這兩項改進都需要 Claude Code v2.1.203 或更新版本。在 v2.1.203 之前，個人資料與機密資料歸為同一類，僅當其不屬於該儲存庫本身的工作時才會被阻止。當儲存庫的可見性未確定時，分類器不會僅憑此點而阻止；它會改為依據其他規則判斷內容

407* 對不同的儲存庫或組織開啟 pull request、使用 `gh repo fork` 進行分叉，或推送到第三方儲存庫，除非您指明了該外部目標402* 對不同的儲存庫或組織開啟 pull request、使用 `gh repo fork` 進行分叉，或推送到第三方儲存庫，除非您指明了該外部目標

408 403

404其中幾個類別取決於[環境](/docs/zh-TW/auto-mode-config#define-trusted-infrastructure)項目，例如敏感遠端目標和受保護的 IaC 範圍，您可以將其縮小到具體名稱。

405

409Claude Code v2.1.203 及更新版本也預設阻止這些：406Claude Code v2.1.203 及更新版本也預設阻止這些：

410 407

411* 來自敏感本機儲存區，或來自名稱、路徑或類型標示其為敏感之檔案的內容，進入提交、推送、PR 或 issue 文字、gist 或貼文，或套件發佈，除非您同時指明了來源和目的地。工作階段逐字稿和對話日誌、憑證和設定點資料夾（例如 SSH 金鑰、雲端憑證、瀏覽器設定檔和 shell 歷史記錄）以及使用者資料匯出都包含在內，且儲存庫為私人並不會解除此限制408* 來自敏感本機儲存區，或來自名稱、路徑或類型標示其為敏感之檔案的內容，進入提交、推送、PR 或 issue 文字、gist 或貼文，或套件發佈，除非您同時指明了來源和目的地。工作階段逐字稿和對話日誌、憑證和設定點資料夾（例如 SSH 金鑰、雲端憑證、瀏覽器設定檔和 shell 歷史記錄）以及使用者資料匯出都包含在內，且儲存庫為私人並不會解除此限制

676* `.devcontainer`673* `.devcontainer`

677* `.yarn`674* `.yarn`

678* `.mvn`675* `.mvn`

679* `.claude`，除了 `.claude/worktrees`（Claude 在其中儲存其自身的 git worktrees），以及在未使用 `--restricted` 啟動的工作階段中，Claude 自身[自動記憶](/docs/zh-TW/memory#storage-location)目錄中的 markdown 檔案676* `.claude`，但有少數例外，例如：

677 * Claude 自身位於 `.claude/worktrees/` 下的 git worktrees

678 * 目前工作階段自身位於 `~/.claude/plans/` 或您所設定的 [`plansDirectory`](/docs/zh-TW/settings-reference#plansdirectory) 中的計畫檔案

679 * [背景工作階段](/docs/zh-TW/agent-view#where-state-is-stored)自身位於 `~/.claude/jobs/<id>/tmp/` 的暫存目錄

680 * 在未使用 `--restricted` 啟動的工作階段中，專案[自動記憶](/docs/zh-TW/memory#storage-location)目錄（例如 `~/.claude/projects/<project>/memory/`）中的 markdown 檔案

681 * 在未使用 `--restricted` 啟動的工作階段中，[subagent 記憶](/docs/zh-TW/sub-agents#enable-persistent-memory)目錄（例如 `.claude/agent-memory/`）中的 markdown 檔案

680* 您使用 [`--plugin-dir`](/docs/zh-TW/plugins/mods/create#change-a-mod-with-claude) 載入的目錄，因為當檔案變更時 Claude Code 會從中重新載入並執行 mod 的程式碼682* 您使用 [`--plugin-dir`](/docs/zh-TW/plugins/mods/create#change-a-mod-with-claude) 載入的目錄，因為當檔案變更時 Claude Code 會從中重新載入並執行 mod 的程式碼

681 683

682受保護的檔案：684受保護的檔案：

permissions.md +2 −2

Details

87 87

88| 模式 | 描述 |88| 模式 | 描述 |

89| :- | :- |89| :- | :- |

90| `default` | 在首次使用每個工具時提示權限。在 CLI、VS Code 和 JetBrains 擴充功能以及桌面應用程式中標示為 Manual，Claude Code 接受 `manual` 作為別名。標籤和別名需要 Claude Code v2.1.200 或更新版本。桌面應用程式的標籤不取決於您的 CLI 版本 |90| `default` | 在首次使用每個工具時提示權限。在 CLI、VS Code 和 JetBrains 擴充功能以及桌面應用程式中標示為 Manual，Claude Code 接受 `manual` 作為別名 |

91| `acceptEdits` | 自動接受工作目錄或 `additionalDirectories` 中路徑的檔案編輯和常見檔案系統命令，例如 `mkdir`、`touch`、`mv` 和 `cp` |91| `acceptEdits` | 自動接受工作目錄或 `additionalDirectories` 中路徑的檔案編輯和常見檔案系統命令，例如 `mkdir`、`touch`、`mv` 和 `cp` |

92| `plan` | Claude 讀取檔案並執行唯讀 shell 命令以探索，但不編輯您的原始檔案；在 [auto mode](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 可用的情況下，分類器批准的命令也會執行。在 CLI 和 VS Code 擴充功能中標示為 Plan |92| `plan` | Claude 讀取檔案並執行唯讀 shell 命令以探索，但不編輯您的原始檔案；在 [auto mode](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 可用的情況下，分類器批准的命令也會執行。在 CLI 和 VS Code 擴充功能中標示為 Plan |

93| `auto` | 在沒有例行提示的情況下執行；在 shell 命令和網路要求等操作執行之前，背景 [classifier](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 會檢查它們是否符合您的要求 |93| `auto` | 在沒有例行提示的情況下執行；在 shell 命令和網路要求等操作執行之前，背景 [classifier](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 會檢查它們是否符合您的要求 |

773 設定主目錄例外只會跳過信任步驟。`~/.claude/settings.local.json` 仍然是[本機範圍](/docs/zh-TW/settings#compare-the-scope-of-each-settings-file)，因此 Claude Code 只在您在主目錄本身啟動的工作階段中讀取它，而不是在每個專案中。若要在所有專案中套用權限規則，請改為將它們新增到您的使用者設定：`~/.claude/settings.json` 或設定 `CLAUDE_CONFIG_DIR` 時的 `$CLAUDE_CONFIG_DIR/settings.json`。773 設定主目錄例外只會跳過信任步驟。`~/.claude/settings.local.json` 仍然是[本機範圍](/docs/zh-TW/settings#compare-the-scope-of-each-settings-file)，因此 Claude Code 只在您在主目錄本身啟動的工作階段中讀取它，而不是在每個專案中。若要在所有專案中套用權限規則，請改為將它們新增到您的使用者設定：`~/.claude/settings.json` 或設定 `CLAUDE_CONFIG_DIR` 時的 `$CLAUDE_CONFIG_DIR/settings.json`。

774</Note>774</Note>

775 775

776在版本 2.1.196 至 2.1.199 中，Claude Code 在您的設定主目錄和 git 儲存庫外也會暫不套用該檔案的規則，並在那裡列印[`this workspace has not been trusted`](/docs/zh-TW/errors#workspace-has-not-been-trusted)警告。在 v2.1.207 之前，Claude Code 在您接受對話框之前套用未追蹤檔案的規則。776在 v2.1.207 之前，Claude Code 在您接受對話框之前套用未追蹤檔案的規則。

777 777

778<h3 id="what-runs-before-you-trust-a-folder">778<h3 id="what-runs-before-you-trust-a-folder">

779 您信任資料夾前執行的內容779 您信任資料夾前執行的內容

platforms.md +3 −3

Details

44 44

45對於此處未列出的整合，[MCP servers](/docs/zh-TW/mcp) 和[連接器](/docs/zh-TW/desktop#connect-external-tools)讓您連接幾乎任何東西：Linear、Notion、Google Drive 或您自己的內部 API。45對於此處未列出的整合，[MCP servers](/docs/zh-TW/mcp) 和[連接器](/docs/zh-TW/desktop#connect-external-tools)讓您連接幾乎任何東西：Linear、Notion、Google Drive 或您自己的內部 API。

56| [Remote Control](/docs/zh-TW/remote-control) | 從 [claude.ai/code](https://claude.ai/code) 或 Claude 行動應用程式驅動執行中的工作階段 | 您的機器 (CLI、Desktop 或 VS Code) | 執行 [`claude remote-control` 或 `/remote-control`](/docs/zh-TW/remote-control#start-a-remote-control-session) | 從另一個裝置控制進行中的工作 |56| [Remote Control](/docs/zh-TW/remote-control) | 從 [claude.ai/code](https://claude.ai/code) 或 Claude 行動應用程式驅動執行中的工作階段 | 您的機器 (CLI、Desktop 或 VS Code) | 執行 [`claude remote-control` 或 `/remote-control`](/docs/zh-TW/remote-control#start-a-remote-control-session) | 從另一個裝置控制進行中的工作 |

61 61

86* [GitHub Actions](/docs/zh-TW/github-actions)：在您的 CI 管道中執行 Claude86* [GitHub Actions](/docs/zh-TW/github-actions)：在您的 CI 管道中執行 Claude

87* [GitLab CI/CD](/docs/zh-TW/gitlab-ci-cd)：GitLab 的相同功能87* [GitLab CI/CD](/docs/zh-TW/gitlab-ci-cd)：GitLab 的相同功能

88* [Code Review](/docs/zh-TW/code-review)：每個拉取請求上的自動審查88* [Code Review](/docs/zh-TW/code-review)：每個拉取請求上的自動審查

~~89* [Slack](/docs/zh-TW/slack)：從團隊聊天發送任務，取回 PR~~89* [Slack](/docs/zh-TW/slack)：從團隊聊天發送任務，取回 PR，適用於 Pro 和 Max 方案

90* [Claude Tag](https://claude.com/docs/claude-tag)：在 Team 和 Enterprise 方案上執行 `@Claude` 作為您組織的共享身分90* [Claude Tag](https://claude.com/docs/claude-tag)：在 Team 和 Enterprise 方案上執行 `@Claude` 作為您組織的共享身分

91 91

92<h3 id="remote-access">92<h3 id="remote-access">

plugins/install.md +2 −2

Details

73 73

74 * **Active now**：`Plugin is now active.` 不需要重新載入。74 * **Active now**：`Plugin is now active.` 不需要重新載入。

75 * **Active, but a server needs setup**：`Plugin is now active.` 後面跟著 `Its bundled MCP server needs configuration before it can start`。外掛程式的 [bundled MCP server](/docs/zh-TW/plugins/components#include-a-packaged-mcpb-server) 在您設定其選項之前無法啟動。在 `/plugin` 的 **Installed** 標籤上選擇外掛程式，然後選擇 **Configure** 以設定伺服器的選項。75 * **Active, but a server needs setup**：`Plugin is now active.` 後面跟著 `Its bundled MCP server needs configuration before it can start`。外掛程式的 [bundled MCP server](/docs/zh-TW/plugins/components#include-a-packaged-mcpb-server) 在您設定其選項之前無法啟動。在 `/plugin` 的 **Installed** 標籤上選擇外掛程式，然後選擇 **Configure** 以設定伺服器的選項。

76 * **Reload needed**：`Run /reload-plugins to activate.` 面板關閉，Claude Code 為您執行該重新載入。如果重新載入會 [使提示快取失效](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)，它會警告並改為保留外掛程式待處理。執行 `/reload-plugins --force` 以無論如何啟動它，這會花費一個未快取的請求。76 * **Reload needed**：`Run /reload-plugins to apply.` 面板關閉，Claude Code 為您執行該重新載入。如果重新載入會 [使提示快取失效](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)，它會警告並改為保留外掛程式待處理。執行 `/reload-plugins --force` 以無論如何啟動它，這會花費一個未快取的請求。

77 * **Load failed**：`The plugin couldn't be loaded`。在 `/plugin` 中開啟 **Errors** 標籤以了解原因，然後請參閱 [安裝後：外掛程式無法運作](/docs/zh-TW/plugins/troubleshooting#plugin-installed-but-not-working)。77 * **Load failed**：`The plugin couldn't be loaded`。在 `/plugin` 中開啟 **Errors** 標籤以了解原因，然後請參閱 [安裝後：外掛程式無法運作](/docs/zh-TW/plugins/troubleshooting#plugin-installed-but-not-working)。

78 </Step>78 </Step>

79 79

80 <Step title="確認外掛程式有效">80 <Step title="確認外掛程式有效">

81 輸入 `/` 並在其名稱下尋找外掛程式的技能，形式為 `/<plugin>:<skill>`。對於 `commit-commands`，`/commit-commands:commit` 出現。另外兩個地方也列出外掛程式：81 輸入 `/` 並在其名稱下尋找外掛程式的 skill，形式為 `/<plugin>:<skill>`。對於 `commit-commands`，`/commit-commands:commit` 出現。另外兩個地方也列出外掛程式：

82 82

83 * 在 `/plugin` 中開啟 **Installed** 標籤，該標籤列出具有其範圍的外掛程式。83 * 在 `/plugin` 中開啟 **Installed** 標籤，該標籤列出具有其範圍的外掛程式。

84 * 在您的 shell 中，執行 `claude plugin list`，它列印相同的清單，包含 `Version`、`Scope` 和 `Status` 行。84 * 在您的 shell 中，執行 `claude plugin list`，它列印相同的清單，包含 `Version`、`Scope` 和 `Status` 行。

plugins/mods/admin.md +1 −1

Details

8 8

9[mod](/docs/zh-TW/plugins/mods/overview) 是在 Claude Code 內執行程式碼的外掛程式，具有安裝它的使用者的權限。Mods 不是沙箱化的。透過[受管設定](/docs/zh-TW/managed-settings)，您可以決定 mods 是否在使用者的機器上執行、執行哪些 mods，以及執行順序。您也可以安裝自己的 mod，用來監視或拒絕其他 mods 的操作。9[mod](/docs/zh-TW/plugins/mods/overview) 是在 Claude Code 內執行程式碼的外掛程式，具有安裝它的使用者的權限。Mods 不是沙箱化的。透過[受管設定](/docs/zh-TW/managed-settings)，您可以決定 mods 是否在使用者的機器上執行、執行哪些 mods，以及執行順序。您也可以安裝自己的 mod，用來監視或拒絕其他 mods 的操作。

10 10

11此頁面適用於為 Claude Code 部署受管設定的人員，無論是作為檔案、透過 MDM 或從 claude.ai 管理員主控台部署。在 Claude Code v2.1.287 及更新版本中，mods 預設為開啟。從與您要執行的操作相符的部分開始：11此頁面適用於為 Claude Code 部署受管設定的人員，無論是作為檔案、透過 MDM 或從 claude.ai 管理員主控台部署。在 Claude Code v2.1.286 及更新版本中，mod 預設為開啟。從與您要執行的操作相符的部分開始：

12 12

13* **排除使用者自己的 mods，無論是否有您自己的 mods**：[停止使用者安裝的 mods 載入](#stop-user-installed-mods-from-loading)13* **排除使用者自己的 mods，無論是否有您自己的 mods**：[停止使用者安裝的 mods 載入](#stop-user-installed-mods-from-loading)

14* **查看當您不做任何更改時使用者會獲得什麼**：[了解預設情況下會發生什麼](#know-what-happens-by-default)14* **查看當您不做任何更改時使用者會獲得什麼**：[了解預設情況下會發生什麼](#know-what-happens-by-default)

plugins/mods/create.md +1 −1

Details

14如果你還沒決定 mod 是否是正確的工具，請先閱讀[概述上的比較](/docs/zh-TW/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers)。14如果你還沒決定 mod 是否是正確的工具，請先閱讀[概述上的比較](/docs/zh-TW/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers)。

15 15

16<Note>16<Note>

17 Mod 需要 Claude Code v2.1.287 或更新版本。在你的 shell 中，執行 `claude --version` 來檢查。若要查看 mod 是否可以為你載入，請參閱[檢查 mod 是否可以載入](/docs/zh-TW/plugins/mods/troubleshoot#check-whether-mods-can-load)。17 請使用 Claude Code v2.1.287 或更新版本。在您的 shell 中，執行 `claude --version` 來檢查。若要查看 mod 是否可以為您載入，請參閱[檢查 mod 是否可以載入](/docs/zh-TW/plugins/mods/troubleshoot#check-whether-mods-can-load)。

18</Note>18</Note>

19 19

20<h2 id="ask-claude-for-a-mod">20<h2 id="ask-claude-for-a-mod">

plugins/mods/overview.md +4 −1

Details

110 開啟或關閉 mods110 開啟或關閉 mods

111</h2>111</h2>

112 112

113Mods 需要 Claude Code v2.1.287 或更新版本，預設情況下它們是開啟的。在您的 shell 中，執行 `claude --version` 以檢查，如果您的版本較舊，請更新 Claude Code。113mod 預設為開啟。在終端機中，請使用 Claude Code v2.1.287 或更新版本。Desktop 應用程式內含自己的 Claude Code 副本，mod 從 v2.1.286 起即可在其中運作。請在您使用 mod 的地方檢查版本：

114

115* **終端機**：在您的 shell 中執行 `claude --version`。如果您的版本較舊，請[更新 Claude Code](/docs/zh-TW/setup#update-claude-code)。

116* **Desktop 應用程式**：在 Code 標籤的本機工作階段中，輸入 `/status` 並查看 **Claude Code** 列，其中會顯示版本，例如 `2.1.286`。如果您的版本較舊，請更新 Desktop 應用程式。

114 117

115若要關閉 mods，請選擇要停止多少個，以及停止多長時間。若要將它們重新開啟，請撤銷相同的變更：118若要關閉 mods，請選擇要停止多少個，以及停止多長時間。若要將它們重新開啟，請撤銷相同的變更：

116 119

plugins/mods/troubleshoot.md +3 −5

Details

40 40

41mod 新增的任何內容都不會出現：沒有命令、沒有繪圖，也沒有行為變化。41mod 新增的任何內容都不會出現：沒有命令、沒有繪圖，也沒有行為變化。

42 42

~~43<h3 id="your-version-is-older-than-2-1-287">~~43<h3 id="your-version-is-too-old">

~~44 您的版本早於 2.1.287~~44 您的版本太舊

45</h3>45</h3>

46 46

~~47`claude --version` 列印的版本早於 2.1.287。您的版本早於預設開啟 mod 的時間。~~47請參閱[應使用哪個版本以及如何檢查您的版本](/docs/zh-TW/plugins/mods/overview#turn-mods-on-or-off)。

~~49[更新 Claude Code](/docs/zh-TW/setup#update-claude-code)。~~

50 48

51<h3 id="the-mods-active-line-doesn’t-name-the-mod">49<h3 id="the-mods-active-line-doesn’t-name-the-mod">

52 `mods active` 行不命名 mod50 `mods active` 行不命名 mod

plugins/troubleshooting.md +2 −2

Details

695* **某人發佈的外掛程式**：在 `/plugin` 中開啟 **Installed**，並開啟外掛程式的詳細資訊窗格，其中列出外掛程式包含的內容。在那裡列出無技能的外掛程式在您輸入 `/` 時沒有任何內容可提供695* **某人發佈的外掛程式**：在 `/plugin` 中開啟 **Installed**，並開啟外掛程式的詳細資訊窗格，其中列出外掛程式包含的內容。在那裡列出無技能的外掛程式在您輸入 `/` 時沒有任何內容可提供

696 696

697<h3 id="run-reload-plugins-to-activate">697<h3 id="run-reload-plugins-to-activate">

698 `Run /reload-plugins to activate.`698 `Run /reload-plugins to apply.`

699</h3>699</h3>

700 700

701`/plugin` 中的安裝摘要以 `Run /reload-plugins to activate.` 結尾，而不是 `Plugin is now active.`701`/plugin` 中的安裝摘要以 `Run /reload-plugins to apply.` 結尾，而不是 `Plugin is now active.`。同時，提示詞上方可能會出現 `Plugins changed. Run /reload-plugins to activate.` 通知。

702 702

703Claude Code 在安裝期間沒有啟用外掛程式，要麼是因為啟用它會 [使提示快取失效](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)，要麼是因為啟用嘗試失敗。703Claude Code 在安裝期間沒有啟用外掛程式，要麼是因為啟用它會 [使提示快取失效](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)，要麼是因為啟用嘗試失敗。

704 704

prompt-caching.md +13 −13

Details

240* [編輯您的儲存庫中的檔案](#editing-files-in-your-repository)240* [編輯您的儲存庫中的檔案](#editing-files-in-your-repository)

241* [在工作階段中編輯 CLAUDE.md](#editing-claude-md-mid-session)241* [在工作階段中編輯 CLAUDE.md](#editing-claude-md-mid-session)

242* [變更權限模式](#changing-permission-mode)242* [變更權限模式](#changing-permission-mode)

243* [變更輸出樣式](#changing-output-style)243* [變更輸出風格](#changing-output-style)

244* [叫用技能和命令](#invoking-skills-and-commands)244* [叫用 skill 和命令](#invoking-skills-and-commands)

245* [執行 `/recap`](#running-%2Frecap)245* [執行 `/recap`](#running-%2Frecap)

246* [倒帶對話](#rewinding-the-conversation)246* [倒帶對話](#rewinding-the-conversation)

247* [生成子代理](#subagents-and-the-cache)247* [生成 subagent](#subagents-and-the-cache)

248 248

249<h3 id="editing-files-in-your-repository">249<h3 id="editing-files-in-your-repository">

250 編輯您的儲存庫中的檔案250 編輯您的儲存庫中的檔案

256 在工作階段中編輯 CLAUDE.md256 在工作階段中編輯 CLAUDE.md

257</h3>257</h3>

258 258

259您的專案根目錄和使用者層級 CLAUDE.md 檔案在工作階段開始時讀取一次並保存在記憶體中。在工作階段中編輯它們不會使快取失效，但編輯也不會應用。Claude 繼續使用在工作階段開始時載入的版本。新內容在下一次 `/clear`、`/compact` 或重新啟動時載入。259您的專案根目錄和使用者層級 CLAUDE.md 檔案在工作階段開始時讀取一次並保存在記憶體中。在工作階段中編輯它們不會使快取失效，但編輯也不會套用。Claude 繼續使用在工作階段開始時載入的版本。新內容在下一次 `/clear`、`/compact` 或重新啟動時載入。

260 260

261[子目錄中的巢狀 CLAUDE.md 檔案](/docs/zh-TW/memory)和[具有 `paths:` frontmatter 的規則](/docs/zh-TW/memory#path-specific-rules)稍後載入，當 Claude 首次讀取匹配的檔案時。在它載入之前編輯它確實會生效。載入後，內容是對話歷史記錄的一部分，因此在工作階段中編輯不會追溯性地改變它。261[子目錄中的巢狀 CLAUDE.md 檔案](/docs/zh-TW/memory)和[具有 `paths:` frontmatter 的規則](/docs/zh-TW/memory#path-specific-rules)會在稍後視需要載入。在它載入之前自行編輯它確實會生效。載入後，內容是對話歷史記錄的一部分，因此在工作階段中編輯不會追溯性地改變它。

262 262

263<h3 id="changing-permission-mode">263<h3 id="changing-permission-mode">

264 變更權限模式264 變更權限模式

265</h3>265</h3>

266 266

267在[權限模式](/docs/zh-TW/permission-modes)之間切換，例如從手動切換到接受編輯，不會改變系統提示或工具定義，因此模式變更是快取安全的。例外是使用 [`opusplan`](/docs/zh-TW/model-config#opusplan-model-setting) 模型設定的計畫模式，它在您進入或離開計畫模式時在 Opus 和 Sonnet 之間切換模型。這使得模式切換成為[模型切換](#switching-models)。267在[權限模式](/docs/zh-TW/permission-modes)之間切換，例如從手動切換到接受編輯，不會改變系統提示詞或工具定義，因此模式變更是快取安全的。例外是使用 [`opusplan`](/docs/zh-TW/model-config#opusplan-model-setting) 模型設定的 plan mode，它在您進入或離開 plan mode 時在 Opus 和 Sonnet 之間切換模型。這使得模式切換成為[模型切換](#switching-models)。

268 268

269<h3 id="changing-output-style">269<h3 id="changing-output-style">

270 變更輸出樣式270 變更輸出風格

271</h3>271</h3>

272 272

273當您在工作階段中使用 [`/output-style`](/docs/zh-TW/output-styles#change-your-output-style)、`/config` 或 `outputStyle` 設定切換[輸出樣式](/docs/zh-TW/output-styles)時，Claude 從您的下一條訊息開始使用新樣式。Claude Code 將新樣式的指示作為對話中的訊息傳遞，因此該請求仍然從快取中讀取系統提示和較早的對話。273當您在工作階段中使用 [`/output-style`](/docs/zh-TW/output-styles#change-your-output-style)、`/config` 或 `outputStyle` 設定切換[輸出風格](/docs/zh-TW/output-styles)時，Claude 從您的下一條訊息開始使用新風格。Claude Code 將新風格的指示作為對話中的訊息傳遞，因此該請求仍然從快取中讀取系統提示詞和較早的對話。

274 274

275在 v2.1.251 之前，在工作階段中切換樣式會保留快取，但在您執行 `/clear` 或開始新工作階段之前不會應用。275在 v2.1.251 之前，在工作階段中切換風格會保留快取，但在您執行 `/clear` 或開始新工作階段之前不會套用。

276 276

277<h3 id="invoking-skills-and-commands">277<h3 id="invoking-skills-and-commands">

278 叫用技能和命令278 叫用 skill 和命令

279</h3>279</h3>

280 280

281[技能](/docs/zh-TW/skills)和[命令](/docs/zh-TW/commands)在叫用點將其指示作為使用者訊息注入。對話中較早的任何內容都不會改變。frontmatter 命名 `model` 的技能或命令可以是該輪的[模型切換](#switching-models)。281[Skill](/docs/zh-TW/skills) 和[命令](/docs/zh-TW/commands)在叫用點將其指示作為使用者訊息注入。對話中較早的任何內容都不會改變。frontmatter 命名 `model` 的 skill 或命令可以是該回合的[模型切換](#switching-models)。

282 282

283<h3 id="running-/recap">283<h3 id="running-/recap">

284 執行 `/recap`284 執行 `/recap`

285</h3>285</h3>

286 286

287[`/recap`](/docs/zh-TW/interactive-mode#session-recap) 生成一個摘要以在您的終端中顯示。與 `/compact` 不同，它將摘要附加為命令輸出，而不是替換您的訊息歷史記錄，因此快取的前綴保持完整。287[`/recap`](/docs/zh-TW/interactive-mode#session-recap) 生成一個摘要以在您的終端機中顯示。與 `/compact` 不同，它將摘要附加為命令輸出，而不是替換您的訊息歷史記錄，因此快取的前綴保持完整。

288 288

289<h3 id="rewinding-the-conversation">289<h3 id="rewinding-the-conversation">

290 倒帶對話290 倒帶對話

291</h3>291</h3>

292 292

293[`/rewind`](/docs/zh-TW/checkpointing) 將您的對話截斷回較早的輪次。剩餘的歷史記錄是快取在該點建立時的相同內容，系統提示和專案上下文層保持不變，因此下一個請求會命中較早的快取項目。自那時以來的每一輪都已讀過該前綴，即使原始輪次比 TTL 更久遠，也保持了該項目的活躍狀態。293[`/rewind`](/docs/zh-TW/checkpointing) 將您的對話截斷回較早的回合。剩餘的歷史記錄是快取在該點建立時的相同內容，系統提示詞和專案上下文層保持不變，因此下一個請求會命中較早的快取項目。自那時以來的每一回合都已讀過該前綴，即使原始回合比 TTL 更久遠，也保持了該項目的活躍狀態。

294 294

295將檔案檢查點與對話一起還原對快取沒有單獨的影響。檔案內容只有在 Claude 讀取時才會進入上下文，與[編輯您的儲存庫中的檔案](#editing-files-in-your-repository)相同。295將檔案檢查點與對話一起還原對快取沒有單獨的影響。檔案內容只有在 Claude 讀取時才會進入上下文，與[編輯您的儲存庫中的檔案](#editing-files-in-your-repository)相同。

296 296

prompt-library.md +11 −11

Details

1181 title: "將會議轉換為工單",1181 title: "將會議轉換為工單",

1182 teaches: "跳過整理逐字稿的步驟。Claude 從非結構化輸入中提取行動項目，並透過 [MCP](/docs/zh-TW/mcp) 直接將其寫入您的追蹤器，以便您審查工單而不是逐字稿。",1182 teaches: "跳過整理逐字稿的步驟。Claude 從非結構化輸入中提取行動項目，並透過 [MCP](/docs/zh-TW/mcp) 直接將其寫入您的追蹤器，以便您審查工單而不是逐字稿。",

1183 next: "將此儲存為 `/tickets` skill",1183 next: "將此儲存為 `/tickets` skill",

1184 prompt: "閱讀 {input} 並寫出行動項目，然後為每一項建立附有驗收標準的 {tracker} 工單",1184 prompt: "閱讀 {input} 並寫出行動項目，然後在{tracker}中為每一項建立附有驗收標準的工單",

1185 slots: {1185 slots: {

1186 input: "@meeting-notes.md",1186 input: "@meeting-notes.md",

1187 tracker: "Linear"1187 tracker: "我們的問題追蹤器"

1188 }1188 }

1189 },1189 },

1190 "map-edge-cases-before": {1190 "map-edge-cases-before": {

1212 next: "要求 Claude 將其遵循的模式寫入 `CLAUDE.md`，以便未來工作階段無需參考即可符合它",1212 next: "要求 Claude 將其遵循的模式寫入 `CLAUDE.md`，以便未來工作階段無需參考即可符合它",

1213 prompt: "查看 {example} 的實作方式以了解其模式，然後以相同方式打造 {new}",1213 prompt: "查看 {example} 的實作方式以了解其模式，然後以相同方式打造 {new}",

1214 slots: {1214 slots: {

1215 example: "GitHub webhook 處理常式",1215 example: "現有的 webhook 處理常式",

1216 new: "Stripe webhook 處理常式"1216 new: "付款 webhook 處理常式"

1217 }1217 }

1218 },1218 },

1219 "add-a-small-well": {1219 "add-a-small-well": {

1419 "open-a-pull-request": {1419 "open-a-pull-request": {

1420 title: "從工單開啟 pull request",1420 title: "從工單開啟 pull request",

1421 teaches: "跳過追蹤器、編輯器和 GitHub 之間的情境切換。一個提示詞讀取規格、進行變更並打開 PR。",1421 teaches: "跳過追蹤器、編輯器和 GitHub 之間的情境切換。一個提示詞讀取規格、進行變更並打開 PR。",

1422 prompt: "找到關於{topic}的 {tracker} 工單，並開啟一個實作它的 PR",1422 prompt: "在{tracker}中找到關於{topic}的工單，並開啟一個實作它的 PR",

1423 slots: {1423 slots: {

1424 tracker: "Linear",1424 tracker: "我們的問題追蹤器",

1425 topic: "登入逾時"1425 topic: "登入逾時"

1426 }1426 }

1427 },1427 },

1470 "investigate-a-production-incident": {1470 "investigate-a-production-incident": {

1471 title: "調查生產事件",1471 title: "調查生產事件",

1472 teaches: "列出要關聯的證據來源，而不是要採取的步驟。Claude 一起讀取日誌、git 歷史和設定以縮小原因。",1472 teaches: "列出要關聯的證據來源，而不是要採取的步驟。Claude 一起讀取日誌、git 歷史和設定以縮小原因。",

1473 next: "透過 MCP 連接 Sentry 或您的日誌儲存區",1473 next: "透過 MCP 連接您的錯誤追蹤器或日誌儲存區",

1474 prompt: "{symptom}。檢查日誌、最近的部署和設定變更，然後告訴我最可能的原因",1474 prompt: "{symptom}。檢查日誌、最近的部署和設定變更，然後告訴我最可能的原因",

1475 slots: {1475 slots: {

1476 symptom: "結帳端點從一小時前開始回傳 500 錯誤"1476 symptom: "結帳端點從一小時前開始回傳 500 錯誤"

1491 teaches: "雲端控制台向您顯示問題，但不顯示修復它的命令。Claude 讀取螢幕截圖並將儀表板轉換為要執行的 kubectl、gcloud 或 aws 命令。",1491 teaches: "雲端控制台向您顯示問題，但不顯示修復它的命令。Claude 讀取螢幕截圖並將儀表板轉換為要執行的 kubectl、gcloud 或 aws 命令。",

1492 prompt: "這是{console}的螢幕截圖。帶我了解{resource}為什麼失敗，並給我修復它的確切命令",1492 prompt: "這是{console}的螢幕截圖。帶我了解{resource}為什麼失敗，並給我修復它的確切命令",

1493 slots: {1493 slots: {

1494 console: "GCP Kubernetes 儀表板",1494 console: "我們的 Kubernetes 儀表板",

1495 resource: "這個 pod"1495 resource: "這個 pod"

1496 }1496 }

1497 },1497 },

1538 "connect-a-tool-with": {1538 "connect-a-tool-with": {

1539 title: "使用 MCP 連接工具",1539 title: "使用 MCP 連接工具",

1540 teaches: "連接來源一次，而不是每個工作階段貼上資料。在 [MCP](/docs/zh-TW/mcp) 設定後，當您詢問它時，Claude 直接從工具讀取。",1540 teaches: "連接來源一次，而不是每個工作階段貼上資料。在 [MCP](/docs/zh-TW/mcp) 設定後，當您詢問它時，Claude 直接從工具讀取。",

1541 prompt: "設定 {server} MCP 伺服器，讓您可以直接讀取我的{data}",1541 prompt: "透過 MCP 連接{server}，讓您可以直接讀取它的{data}",

1542 slots: {1542 slots: {

1543 server: "Sentry",1543 server: "我們的錯誤追蹤器",

1544 data: "錯誤報告"1544 data: "堆疊追蹤"

1545 }1545 }

1546 },1546 },

1547 "capture-what-to-remember": {1547 "capture-what-to-remember": {

quickstart.md +7 −7

Details

33 <Tab title="原生安裝（建議）">33 <Tab title="原生安裝（建議）">

34 **macOS、Linux、WSL：**34 **macOS、Linux、WSL：**

35 35

~~36 ```bash theme={null}~~36 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

37 curl -fsSL https://claude.ai/install.sh | bash37 curl -fsSL https://claude.ai/install.sh | bash

38 ```38 ```

39 39

40 **Windows PowerShell：**40 **Windows PowerShell：**

41 41

~~42 ```powershell theme={null}~~42 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43 irm https://claude.ai/install.ps1 | iex43 irm https://claude.ai/install.ps1 | iex

44 ```44 ```

45 45

46 **Windows CMD：**46 **Windows CMD：**

47 47

~~48 ```batch theme={null}~~48 ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

50 ```50 ```

51 51

63 </Tab>63 </Tab>

64 64

65 <Tab title="Homebrew">65 <Tab title="Homebrew">

~~66 ```bash theme={null}~~66 ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

67 brew install --cask claude-code67 brew install --cask claude-code

68 ```68 ```

69 69

75 </Tab>75 </Tab>

76 76

77 <Tab title="WinGet">77 <Tab title="WinGet">

~~78 ```powershell theme={null}~~78 ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

79 winget install Anthropic.ClaudeCode79 winget install Anthropic.ClaudeCode

80 ```80 ```

81 81

181 步驟 5：進行您的第一次程式碼變更181 步驟 5：進行您的第一次程式碼變更

182</h2>182</h2>

183 183

184現在讓我們讓 Claude Code 進行一些實際的編碼。嘗試一個簡單的任務：184現在讓 Claude Code 進行一些實際的編碼。嘗試一個簡單的任務：

185 185

186```text wrap theme={null}186```text wrap theme={null}

187add a hello world function to the main file187add a hello world function to the main file

382* **在 Claude Code 中**：輸入 `/help` 或詢問「how do I」問題382* **在 Claude Code 中**：輸入 `/help` 或詢問「how do I」問題

383* **文件**：您在這裡！瀏覽其他指南383* **文件**：您在這裡！瀏覽其他指南

384* **課程**：參加 [Claude Code 101](https://academy.claude.com/courses/claude-code-101) 和其他免費自學課程，位於 [Claude Academy](https://academy.claude.com/)384* **課程**：參加 [Claude Code 101](https://academy.claude.com/courses/claude-code-101) 和其他免費自學課程，位於 [Claude Academy](https://academy.claude.com/)

385* **社群**：加入我們的 [Discord](https://www.anthropic.com/discord) 以獲取提示和支援385* **社群**：加入 [Discord 伺服器](https://www.anthropic.com/discord) 以獲取提示和支援

remote-control.md +3 −3

Details

236 236

237Remote Control 連接時，會話記錄（包括您的訊息、Claude 的回應和工具活動）會儲存在 Anthropic 伺服器上。儲存的記錄可讓對話在您的裝置間保持同步，並讓會話在網路中斷後重新連接。執行和檔案系統存取保留在您的機器上，儲存的記錄會根據[資料使用](/docs/zh-TW/data-usage)政策保留。237Remote Control 連接時，會話記錄（包括您的訊息、Claude 的回應和工具活動）會儲存在 Anthropic 伺服器上。儲存的記錄可讓對話在您的裝置間保持同步，並讓會話在網路中斷後重新連接。執行和檔案系統存取保留在您的機器上，儲存的記錄會根據[資料使用](/docs/zh-TW/data-usage)政策保留。

238 238

239若要完全關閉 Remote Control，請使用 [`disableRemoteControl`](/docs/zh-TW/settings-reference#disableremotecontrol) 設定。具有零資料保留等合規要求的組織無法啟用 Remote Control。239若要完全關閉 Remote Control，請使用 [`disableRemoteControl`](/docs/zh-TW/settings-reference#disableremotecontrol) 設定。已啟用[零資料保留](/docs/zh-TW/zero-data-retention)或已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織無法啟用 Remote Control。

240 240

241<h2 id="trusted-devices">241<h2 id="trusted-devices">

242 受信任的裝置242 受信任的裝置

317| [Remote Control](/docs/zh-TW/remote-control) | 從 [claude.ai/code](https://claude.ai/code) 或 Claude 行動應用程式驅動執行中的工作階段 | 您的機器 (CLI、Desktop 或 VS Code) | 執行 [`claude remote-control` 或 `/remote-control`](/docs/zh-TW/remote-control#start-a-remote-control-session) | 從另一個裝置控制進行中的工作 |317| [Remote Control](/docs/zh-TW/remote-control) | 從 [claude.ai/code](https://claude.ai/code) 或 Claude 行動應用程式驅動執行中的工作階段 | 您的機器 (CLI、Desktop 或 VS Code) | 執行 [`claude remote-control` 或 `/remote-control`](/docs/zh-TW/remote-control#start-a-remote-control-session) | 從另一個裝置控制進行中的工作 |

322 322

451 451

452* **錯誤提及 `disableRemoteControl`**：您的 IT 管理員已透過[受管設定](/docs/zh-TW/managed-settings)在此裝置上停用 Remote Control，獨立於組織範圍的切換和您的登入方式。452* **錯誤提及 `disableRemoteControl`**：您的 IT 管理員已透過[受管設定](/docs/zh-TW/managed-settings)在此裝置上停用 Remote Control，獨立於組織範圍的切換和您的登入方式。

453* **您的 claude.ai 計畫是 Pro 或 Max**：Claude Code 仍在來自較早登入的 Team 或 Enterprise 組織下登入，因此它會檢查該組織的 Remote Control 原則。執行 `/status` 以查看您的登入使用哪個計畫和組織。執行 `claude auth logout` 然後 `claude auth login` 以在您目前的計畫下重新登入。453* **您的 claude.ai 計畫是 Pro 或 Max**：Claude Code 仍在來自較早登入的 Team 或 Enterprise 組織下登入，因此它會檢查該組織的 Remote Control 原則。執行 `/status` 以查看您的登入使用哪個計畫和組織。執行 `claude auth logout` 然後 `claude auth login` 以在您目前的計畫下重新登入。

454* **訊息未說要聯絡您的組織管理員**：您的組織有與 Remote Control 不相容的 HIPAA 設定，且 `/status` 在其 `Organization configuration` 列中列出 `HIPAA`。在此狀態下，管理員面板的 Remote Control 切換呈灰色，因此擁有者無法在那裡變更它。聯絡 Anthropic 支援以討論選項。在 v2.1.267 之前，此情況顯示「Remote Control isn't available for your organization due to its compliance policy」。454* **訊息未說要聯絡您的組織管理員**：您的組織已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)，這會關閉 Remote Control。若要確認，請執行 `/status` 並在 `Organization configuration` 列中尋找 `HIPAA`。擁有者會在[管理設定](https://claude.ai/admin-settings/claude-code)中看到 **Remote Control** 切換呈灰色，且無法將其開啟。如果您對此設定有疑問，請詢問擁有者，擁有者可以聯絡您組織的 Anthropic 客戶團隊。在 v2.1.267 之前，此情況顯示「Remote Control isn't available for your organization due to its compliance policy」。

455* **否則，擁有者尚未為您的組織啟用它**：Remote Control 在 Team 和 Enterprise 計畫上預設為關閉。擁有者可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 啟用它，方法是開啟 **Remote Control** 切換。此切換是伺服器端組織設定。455* **否則，擁有者尚未為您的組織啟用它**：Remote Control 在 Team 和 Enterprise 計畫上預設為關閉。擁有者可以在 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 啟用它，方法是開啟 **Remote Control** 切換。此切換是伺服器端組織設定。

456 456

457在 v2.1.281 之前，當 Claude Code 未在此機器上載入您的組織原則時，此訊息也會出現，例如在離線啟動後。更新版本會改為將該狀態報告為 [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control)。457在 v2.1.281 之前，當 Claude Code 未在此機器上載入您的組織原則時，此訊息也會出現，例如在離線啟動後。更新版本會改為將該狀態報告為 [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control)。

sandboxing.md +1 −1

Details

1109</h2>1109</h2>

1110 1110

1111* [Sandbox environments](/docs/zh-TW/sandbox-environments)：比較內建沙箱與開發容器、容器和虛擬機1111* [Sandbox environments](/docs/zh-TW/sandbox-environments)：比較內建沙箱與開發容器、容器和虛擬機

1112* [Security](/docs/zh-TW/security)：全面的安全功能和最佳實踐1112* [Security](/docs/zh-TW/security)：安全功能和最佳實踐

1113* [Permissions](/docs/zh-TW/permissions)：權限配置和存取控制1113* [Permissions](/docs/zh-TW/permissions)：權限配置和存取控制

1114* [All settings](/docs/zh-TW/settings-reference)：每個設定鍵1114* [All settings](/docs/zh-TW/settings-reference)：每個設定鍵

1115* [CLI reference](/docs/zh-TW/cli-reference)：命令列選項1115* [CLI reference](/docs/zh-TW/cli-reference)：命令列選項

security-guidance.md +1 −1

Details

44* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。44* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。

45* 外掛程式 [在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。45* 外掛程式 [在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛程式名稱。

46 46

47檢查安裝摘要。如果它報告 `Run /reload-plugins to activate.`，請參閱 [在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins) 以在您目前的工作階段中啟用外掛程式。47檢查安裝摘要。如果它報告 `Run /reload-plugins to apply.`，請參閱 [在不重新啟動的情況下套用外掛程式變更](/docs/zh-TW/plugins/cli-reference#reload-plugins) 以在您目前的工作階段中啟用外掛程式。

48 48

49<h3 id="enable-for-your-team-in-local-sessions">49<h3 id="enable-for-your-team-in-local-sessions">

50 在本地工作階段中為您的團隊啟用50 在本地工作階段中為您的團隊啟用

self-hosted-environments.md +1 −1

Details

45在規劃推出之前，請檢查這些內容：45在規劃推出之前，請檢查這些內容：

46 46

47* **方案**：Team 和 Enterprise 組織的公開測試版。自託管環境預設為關閉；[擁有者](/docs/zh-TW/cloud-environments#organization-shared-environments)在[**雲端環境**管理頁面](https://claude.ai/admin-settings/cloud-environments)上開啟**允許自託管環境**，這需要為組織啟用[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)。47* **方案**：Team 和 Enterprise 組織的公開測試版。自託管環境預設為關閉；[擁有者](/docs/zh-TW/cloud-environments#organization-shared-environments)在[**雲端環境**管理頁面](https://claude.ai/admin-settings/cloud-environments)上開啟**允許自託管環境**，這需要為組織啟用[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)。

~~48* **零資料保留**：對於啟用了[零資料保留](/docs/zh-TW/zero-data-retention)的組織不可用。~~48* **零資料保留和 HIPAA**：對於啟用了[零資料保留](/docs/zh-TW/zero-data-retention)或套用了 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織不可用。

49* **模型推理**：除非您將執行器設定為[將模型請求傳送至 Amazon Bedrock 或 Google Cloud 的 Agent Platform](/docs/zh-TW/self-hosted-environments-configuration#send-model-requests-to-bedrock-or-agent-platform)，否則工作階段會使用 Anthropic API。在這兩種情況下，工作階段內容都會傳送至 Anthropic。在以此方式設定的執行器上，[伺服器管理的設定](/docs/zh-TW/server-managed-settings)和來自 claude.ai 的組織政策不會套用到工作階段。49* **模型推理**：除非您將執行器設定為[將模型請求傳送至 Amazon Bedrock 或 Google Cloud 的 Agent Platform](/docs/zh-TW/self-hosted-environments-configuration#send-model-requests-to-bedrock-or-agent-platform)，否則工作階段會使用 Anthropic API。在這兩種情況下，工作階段內容都會傳送至 Anthropic。在以此方式設定的執行器上，[伺服器管理的設定](/docs/zh-TW/server-managed-settings)和來自 claude.ai 的組織政策不會套用到工作階段。

50* **表面**：從 [claude.ai/code](https://claude.ai/code)、行動和桌面應用程式、[排程例行工作](/docs/zh-TW/routines) 和終端機啟動的工作階段，使用 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud) 或 [`--environment` 分派](/docs/zh-TW/self-hosted-environments-testing#run-the-test-loop)，可以在自託管環境中執行。[Claude Tag](https://claude.com/docs/claude-tag/overview) 工作階段也可以在其中執行，但 Claude 在這些工作階段中還無法使用[存取套件](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle)。[Claude Security](/docs/zh-TW/claude-security) 和 [Code Review](/docs/zh-TW/code-review) 工作階段還沒有路由到它們。對這兩個表面的支援將單獨跟進。50* **表面**：從 [claude.ai/code](https://claude.ai/code)、行動和桌面應用程式、[排程例行工作](/docs/zh-TW/routines) 和終端機啟動的工作階段，使用 [`claude --cloud`](/docs/zh-TW/claude-code-on-the-web#from-terminal-to-cloud) 或 [`--environment` 分派](/docs/zh-TW/self-hosted-environments-testing#run-the-test-loop)，可以在自託管環境中執行。[Claude Tag](https://claude.com/docs/claude-tag/overview) 工作階段也可以在其中執行，但 Claude 在這些工作階段中還無法使用[存取套件](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle)。[Claude Security](/docs/zh-TW/claude-security) 和 [Code Review](/docs/zh-TW/code-review) 工作階段還沒有路由到它們。對這兩個表面的支援將單獨跟進。

51* **儲存庫**：工作階段從 GitHub 簽出儲存庫；請參閱 [GitHub 身份驗證選項](/docs/zh-TW/claude-code-on-the-web#github-authentication-options)。對於 GitHub Enterprise Server 主機，請參閱其[網路需求](/docs/zh-TW/github-enterprise-server#network-requirements)。51* **儲存庫**：工作階段從 GitHub 簽出儲存庫；請參閱 [GitHub 身份驗證選項](/docs/zh-TW/claude-code-on-the-web#github-authentication-options)。對於 GitHub Enterprise Server 主機，請參閱其[網路需求](/docs/zh-TW/github-enterprise-server#network-requirements)。

self-hosted-environments-deploy.md +3 −3

Details

156 156

157沒有身份，`git commit` 失敗並顯示 `Please tell me who you are`，工作階段無法取得進展。您可以改用自己的機器人身份；執行器不會覆蓋這些值。157沒有身份，`git commit` 失敗並顯示 `Please tell me who you are`，工作階段無法取得進展。您可以改用自己的機器人身份；執行器不會覆蓋這些值。

158 158

159不要將長期或廣泛範圍的推送認證烘焙到共享執行器映像中：映像中的認證可用於映像執行的每個工作階段，無論誰啟動它。相反，使用工作階段 JWT 從您的[包裝器指令碼](/docs/zh-TW/self-hosted-environments-configuration#wrapper-scripts)按工作階段薄荷短期、最小範圍的令牌，使用從工作階段 JWT 解碼的工作階段建立者的身份。將其與臨時的每個工作階段容器配對，這需要 `--capacity 1`，因此沒有認證超過薄荷它的工作階段；請參閱[強化部分](#harden-your-deployment)。159請勿將長期或範圍廣泛的推送憑證內建到共用的執行器映像中：映像中的憑證可供該映像執行的每個工作階段使用，無論是誰啟動的。請改為從您的[包裝指令碼](/docs/zh-TW/self-hosted-environments-configuration#wrapper-scripts)為每個工作階段產生短期、最小範圍的 token，並使用從工作階段 JWT 解碼出的工作階段建立者身分。搭配每個工作階段專用的臨時容器（這需要 `--capacity 1`），使任何憑證都不會比產生它的工作階段存活更久；請參閱[強化部分](#harden-your-deployment)。

160 160

161如果您必須在映像級別配置推送認證，例如對於唯讀部署金鑰，請盡可能緊密地限制它們：161如果您必須在映像級別配置推送認證，例如對於唯讀部署金鑰，請盡可能緊密地限制它們：

162 162

163* SSH 部署金鑰限制為一個儲存庫，帶有 `url.<base>.insteadOf` 重寫163* SSH 部署金鑰限制為一個儲存庫，帶有 `url.<base>.insteadOf` 重寫

164* 返回最小範圍令牌的 `credential.helper`164* 傳回最小範圍 token 的 `credential.helper`

165* `GIT_SSH_COMMAND` 指向狹隘範圍的金鑰165* 指向範圍狹小之金鑰的 `GIT_SSH_COMMAND`

166 166

167您配置的任何機制都必須無需提示即可工作，因為執行器的內置複製和提取禁用 Git、SSH 和 Git Credential Manager 否則會顯示的提示：167您配置的任何機制都必須無需提示即可工作，因為執行器的內置複製和提取禁用 Git、SSH 和 Git Credential Manager 否則會顯示的提示：

168 168

settings-reference.md +5 −5

Details

1765 * `"auto"`：Claude Code 在沒有例行提示的情況下執行；在 shell 命令和網路請求等操作執行之前，背景分類器會檢查它們是否符合您的請求1765 * `"auto"`：Claude Code 在沒有例行提示的情況下執行；在 shell 命令和網路請求等操作執行之前，背景分類器會檢查它們是否符合您的請求

1766 * `"dontAsk"`：Claude Code 自動拒絕每個原本會提示的呼叫；讀取、不需要核准的其他操作以及預先核准的工具仍然執行1766 * `"dontAsk"`：Claude Code 自動拒絕每個原本會提示的呼叫；讀取、不需要核准的其他操作以及預先核准的工具仍然執行

1767 * `"bypassPermissions"`：Claude Code 在不詢問的情況下執行所有操作1767 * `"bypassPermissions"`：Claude Code 在不詢問的情況下執行所有操作

1768 * `"manual"`：`"default"` 的別名，在 Claude Code v2.1.200 或更新版本中1768 * `"manual"`：`"default"` 的別名

1769* **預設值**：未設定1769* **預設值**：未設定

1770* **每個工作階段的覆寫**：`--permission-mode` 及其 `bypassPermissions` 的等效項 `--dangerously-skip-permissions` 對一個工作階段優先於此設定鍵1770* **每個工作階段的覆寫**：`--permission-mode` 及其 `bypassPermissions` 的等效項 `--dangerously-skip-permissions` 對一個工作階段優先於此設定鍵

1771 1771

1777}1777}

1778```1778```

1779 1779

1780權限規則分層在每個模式之上：`deny` 規則在每個模式中封鎖，包括 `bypassPermissions`。請參閱[權限模式](/docs/zh-TW/permission-modes)。`manual` 命名 CLI 和 VS Code 擴充功能中標記為「Manual」的權限模式；別名需要 Claude Code v2.1.200 或更新版本。在雲端工作階段中，Claude Code 只從此設定鍵中接受 `acceptEdits`、`plan`、`default` 和 `auto`。對於 VS Code 擴充功能啟動的對話，請參閱[擴充功能為啟動權限模式讀取的設定](/docs/zh-TW/permission-modes#switch-permission-modes)。1780權限規則分層在每個模式之上：`deny` 規則在每個模式中封鎖，包括 `bypassPermissions`。請參閱[權限模式](/docs/zh-TW/permission-modes)。在雲端工作階段中，Claude Code 只從此設定鍵中接受 `acceptEdits`、`plan`、`default` 和 `auto`。對於 VS Code 擴充功能啟動的對話，請參閱[擴充功能為啟動權限模式讀取的設定](/docs/zh-TW/permission-modes#switch-permission-modes)。

1781 1781

1782<h3 id="permissions-disablebypasspermissionsmode">1782<h3 id="permissions-disablebypasspermissionsmode">

1783 `permissions.disableBypassPermissionsMode`1783 `permissions.disableBypassPermissionsMode`

3232 `askUserQuestionTimeout`3232 `askUserQuestionTimeout`

3233</h3>3233</h3>

3234 3234

3235讓未獲回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話框在閒置一段時間後自動繼續，並提交您已選取的選項。當您暫時離開並希望 Claude 在沒有您的情況下繼續時，請設定此項目。使用預設值時，問題會一直等待直到您回答。關於計時器何時暫停或永不啟動，請參閱[問題自動繼續逾時](/docs/zh-TW/tools-reference#question-auto-continue-timeout)。需要 Claude Code v2.1.200 或更新版本。3235讓未獲回答的 [`AskUserQuestion`](/docs/zh-TW/tools-reference) 對話框在閒置一段時間後自動繼續，並提交您已選取的選項。當您暫時離開並希望 Claude 在沒有您的情況下繼續時，請設定此項目。使用預設值時，問題會一直等待直到您回答。關於計時器何時暫停或永不啟動，請參閱[問題自動繼續逾時](/docs/zh-TW/tools-reference#question-auto-continue-timeout)。

3236 3236

3237* **範圍**：[`User or managed`](#scopes)3237* **範圍**：[`User or managed`](#scopes)

3238* **類型**：字串，為 `"60s"`、`"5m"`、`"10m"` 或 `"never"` 之一3238* **類型**：字串，為 `"60s"`、`"5m"`、`"10m"` 或 `"never"` 之一

3245}3245}

3246```3246```

3247 3247

3248在 `/config` 中顯示為 **Question auto-continue timeout**，會將此設定鍵寫入使用者設定；當受管設定或 `--settings` 旗標設定了此設定鍵時，Claude Code 會隱藏該列。需要 Claude Code v2.1.200 或更新版本。3248在 `/config` 中顯示為 **Question auto-continue timeout**，會將此設定鍵寫入使用者設定；當受管設定或 `--settings` 旗標設定了此設定鍵時，Claude Code 會隱藏該列。

3249 3249

3250<h3 id="autocontinueatusagelimit">3250<h3 id="autocontinueatusagelimit">

3251 `autoContinueAtUsageLimit`3251 `autoContinueAtUsageLimit`

5165}5165}

5166```5166```

5167 5167

5168內建 plugins 在相同鍵下儲存其選項，帶有 `@builtin` 後綴。例如，控制 Claude Code 是否讀取 `AGENTS.md` 檔案的[**專案指示**](/docs/zh-TW/memory#choose-which-instruction-files-load)設定是 `pluginConfigs["agents-md@builtin"].options.instructionFiles`。5168內建 plugins 在相同鍵下儲存其選項，帶有 `@builtin` 後綴。例如，控制 Claude Code 是否讀取 `AGENTS.md` 檔案的[**專案指示**](/docs/zh-TW/memory#choose-which-instruction-files-load)設定是 `pluginConfigs["cc-plugin-agents-md@builtin"].options.instructionFiles`。在 v2.1.285 之前，該 plugin 的 ID 是 `agents-md@builtin`。較新版本會讀取任一 ID 下的項目。

5169 5169

5170Claude Code 忽略專案和本機項目，因為它將這些值替換到 plugin hook、MCP 和 LSP 配置中，複製的儲存庫不得能夠提供它們。在 v2.1.207 之前，專案和本機設定也被讀取。5170Claude Code 忽略專案和本機項目，因為它將這些值替換到 plugin hook、MCP 和 LSP 配置中，複製的儲存庫不得能夠提供它們。在 v2.1.207 之前，專案和本機設定也被讀取。

5171 5171

skills.md +3 −3

Details

40 執行並驗證您的應用程式40 執行並驗證您的應用程式

41</h3>41</h3>

42 42

~~43三個捆綁技能協同工作以啟動您的應用程式，並根據執行中的應用程式而非僅測試來確認變更：~~43三個隨附 skill 協同工作以啟動您的應用程式，並根據執行中的應用程式而非僅測試來確認變更：

44 44

45| 技能 | 用途 |45| 技能 | 用途 |

46| :- | :- |46| :- | :- |

52 52

53`/run-skill-generator` 會改為記錄配方。它從乾淨環境中讓您的應用程式執行，捕捉有效的內容（安裝命令、環境變數、啟動指令碼），並將其提交為位於 `.claude/skills/run-<name>/` 的每個專案技能。之後，`/run`、`/verify` 和儲存庫中的任何其他代理都會遵循記錄的配方，而不是重新發現它。每個專案執行一次 `/run-skill-generator`，如果建置或啟動程序變更，則再執行一次。53`/run-skill-generator` 會改為記錄配方。它從乾淨環境中讓您的應用程式執行，捕捉有效的內容（安裝命令、環境變數、啟動指令碼），並將其提交為位於 `.claude/skills/run-<name>/` 的每個專案技能。之後，`/run`、`/verify` 和儲存庫中的任何其他代理都會遵循記錄的配方，而不是重新發現它。每個專案執行一次 `/run-skill-generator`，如果建置或啟動程序變更，則再執行一次。

54 54

55`/verify` 也可以記錄自己的配方。當它必須在沒有記錄配方的情況下建置和驅動您的應用程式時，它會將有效的內容寫入儲存庫根目錄的 `.claude/skills/verify/SKILL.md`，或在 monorepo 中的觸及套件目錄中，以便稍後的執行和其他代理遵循相同的步驟。在儲存庫根目錄，記錄的技能會取代捆綁的 `/verify`。這需要 Claude Code v2.1.200 或更新版本。55`/verify` 也可以記錄自己的配方。當它必須在沒有記錄配方的情況下建置和驅動您的應用程式時，它會將有效的內容寫入儲存庫根目錄的 `.claude/skills/verify/SKILL.md`，或在 monorepo 中的觸及套件目錄中，以便稍後的執行和其他 agent 遵循相同的步驟。在儲存庫根目錄，記錄的 skill 會取代隨附的 `/verify`。

56 56

57Claude 只有在引導執行出錯時（例如失敗的命令或缺少的步驟）才會編輯記錄的檔案，因此您可以提交檔案而無需每個工作階段的差異。在 v2.1.205 之前，捆綁技能告訴 Claude 要折疊執行學到的任何內容，這導致頻繁的合併衝突。57Claude 只有在引導執行出錯時（例如失敗的命令或缺少的步驟）才會編輯記錄的檔案，因此您可以提交檔案而無需每個工作階段的差異。在 v2.1.205 之前，捆綁技能告訴 Claude 要折疊執行學到的任何內容，這導致頻繁的合併衝突。

58 58

996* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。996* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。

997* 外掛[在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛名稱。997* 外掛[在市場中找不到](/docs/zh-TW/plugins/install#install-a-plugin)：檢查外掛名稱。

998 998

999如果安裝摘要報告 `Run /reload-plugins to activate.`，Claude Code 會為你運行該重新載入。如果重新載入警告你的下一則訊息會重新讀取對話，請運行 `/reload-plugins --force` 以在目前會話中啟用外掛的技能。然後要求 Claude 評估現有技能，例如 `evaluate my summarize-changes skill with skill-creator`。外掛會引導你完成編寫測試案例並運行迴圈：999如果安裝摘要顯示 `Run /reload-plugins to apply.`，Claude Code 接著會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force`，讓外掛的 skill 在目前工作階段中可用。然後要求 Claude 評估現有的 skill，例如 `evaluate my summarize-changes skill with skill-creator`。外掛會引導您撰寫測試案例並執行迴圈：

1000 1000

1001* **測試案例**：在技能目錄內的 `evals/evals.json` 中儲存提示、輸入檔案和預期行為1001* **測試案例**：在技能目錄內的 `evals/evals.json` 中儲存提示、輸入檔案和預期行為

1002* **隔離運行**：為每個測試案例生成一個[子代理](/docs/zh-TW/sub-agents)，以便每次運行都以乾淨的上下文開始，並記錄權杖計數和持續時間1002* **隔離運行**：為每個測試案例生成一個[子代理](/docs/zh-TW/sub-agents)，以便每次運行都以乾淨的上下文開始，並記錄權杖計數和持續時間

slack.md +27 −7

Details

4 4

5# Slack 中的 Claude Code5# Slack 中的 Claude Code

6 6

7> 直接從您的 Slack 工作區委派編碼任務。Anthropic 正在為 Team 和 Enterprise 工作區停用此較早版本，改用 Claude Tag；它仍然是 Pro 和 Max 方案上的設定路徑。7> 從 Slack 委派編碼任務。此較早版本僅在未連接 Claude Tag 的工作區中，回應來自 Pro 和 Max 帳戶的頻道提及。

8 8

9<Warning>9<Warning>

~~10 此頁面記錄了較早的 Slack 中的 Claude Code，它在每個工作階段下以個別使用者的帳戶運行。~~10 此頁面記錄了較早的 Slack 中的 Claude Code，它在每個工作階段下以個別使用者的帳戶運行。它僅回應來自 Pro 和 Max 帳戶的頻道 @提及，且僅限於沒有任何組織將其連接到 [Claude Tag](https://claude.com/product/tag) 的 Slack 工作區。Claude Tag 以 @Claude 身份作為您組織的共享身份運行，具有管理員設定的存取權限。

11 11

12 * **Team 和 Enterprise 方案：** Anthropic 正在停用此版本，改用 [Claude Tag](https://claude.com/product/tag)，它以 @Claude 身份作為您組織的共享身份運行，具有管理員配置的存取權限。您現有的 Slack 應用程式和 @Claude 控制代碼保持不變，您的 Anthropic 帳戶團隊可以告訴您轉換日期。[設定 Claude Tag](https://claude.com/docs/claude-tag/overview) 以建立新工作區；若要移動已使用此版本的工作區，請參閱[從較早的 Slack 中的 Claude 遷移](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)。12 * **Pro 和 Max 方案：** Claude Tag 在個人方案上不可用，因此在未連接 Claude Tag 的工作區中，此頁面仍然是設定路徑。

~~13 * **Pro 和 Max 方案：** Claude Tag 在個人方案上不可用，因此此頁面仍然是設定路徑。~~13 * **Team 和 Enterprise 方案：** 您現有的 Slack 應用程式和 @Claude 控制代碼保持不變。[設定 Claude Tag](https://claude.com/docs/claude-tag/overview) 以建立新工作區；若要移動已使用此版本的工作區，請參閱[從較早的 Slack 中的 Claude 遷移](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)。

14 * **收到通知而非回答：** 請查閱 @Claude 回覆的[設定通知](#this-workspace-isnt-set-up-for-claude-tag-yet)或[停用通知](#the-legacy-claude-in-slack-bot-is-retired)。

14</Warning>15</Warning>

15 16

16Slack 中的 Claude Code 將 Claude Code 的強大功能直接帶入您的 Slack 工作區。當您提及 `@Claude` 並附帶編碼任務時，Claude 會自動檢測意圖並在雲端建立 Claude Code 工作階段，讓您無需離開團隊對話即可委派開發工作。17Slack 中的 Claude Code 將 Claude Code 的強大功能直接帶入您的 Slack 工作區。當您提及 `@Claude` 並附帶編碼任務時，Claude 會自動檢測意圖並在雲端建立 Claude Code 工作階段，讓您無需離開團隊對話即可委派開發工作。

34 35

35| 要求 | 詳情 |36| 要求 | 詳情 |

36| :- | :- |37| :- | :- |

~~37| Claude 計畫 | Pro、Max、Team 或 Enterprise，具有 Claude Code 存取權限（高級席位或 Chat + Claude Code 席位） |~~38| Claude 計畫 | Pro 或 Max |

39| Slack 工作區 | 未被任何組織連接到 [Claude Tag](https://claude.com/docs/claude-tag/overview)。如果 @Claude 回覆[停用通知](#the-legacy-claude-in-slack-bot-is-retired)，表示該工作區已連接 |

38| 雲端工作階段 | [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)已為您的帳戶啟用 |40| 雲端工作階段 | [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)已為您的帳戶啟用 |

39| GitHub 帳戶 | 在 [claude.ai/code](https://claude.ai/code) 連接，至少有一個存儲庫已驗證 |41| GitHub 帳戶 | 在 [claude.ai/code](https://claude.ai/code) 連接，至少有一個存儲庫已驗證 |

40| Slack 驗證 | 您的 Slack 帳戶通過 Claude 應用程式連接到您的 Claude 帳戶 |42| Slack 驗證 | 您的 Slack 帳戶通過 Claude 應用程式連接到您的 Claude 帳戶 |

211 故障排除213 故障排除

212</h2>214</h2>

213 215

216<h3 id="this-workspace-isnt-set-up-for-claude-tag-yet">

217 "This workspace isn't set up for Claude Tag yet"

218</h3>

219

220當以下兩項條件皆成立時，@Claude 會在討論串中回覆此通知，而非提供答案：

221

222* 沒有任何組織已將您的 Slack 工作區連接到 [Claude Tag](https://claude.com/docs/claude-tag/overview)。

223* 您在 Slack 中連結的 Claude 帳戶不是 Pro 或 Max 方案。

224

225Claude Tag 適用於 Team 和 Enterprise 方案。若要連接工作區，請從通知中提到的 `@Claude connect` 命令開始，然後依照[設定 Claude Tag](https://claude.com/docs/claude-tag/overview) 進行。

226

227<h3 id="the-legacy-claude-in-slack-bot-is-retired">

228 "The legacy Claude in Slack bot is retired"

229</h3>

230

231此通知的開頭為 `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.`。您的 Slack 工作區已連接到某個 Claude 組織，但在該組織的 Claude Tag 設定中，頻道、工作區或組織預設值仍選擇了舊版本。此通知與您自己的方案無關，因此 Pro 和 Max 帳戶也會收到。

232

233如果您是該組織的擁有者，請開啟 [Claude 管理設定](https://claude.ai/admin-settings/claude-tag)，並為該頻道開啟 Claude Tag。若要修正所有繼承此設定的頻道，請改為在工作區或組織預設值上變更設定。如需完整的遷移說明，請參閱[從舊版 Claude in Slack 遷移](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)。如果您不是擁有者，請將此項目傳送給擁有者。

234

214<h3 id="claude-code-is-not-enabled-for-your-account">235<h3 id="claude-code-is-not-enabled-for-your-account">

215 "Claude Code 未為您的帳戶啟用"236 "Claude Code 未為您的帳戶啟用"

216</h3>237</h3>

261 282

2621. 在應用程式首頁中斷開並重新連接您的 Claude 帳戶2831. 在應用程式首頁中斷開並重新連接您的 Claude 帳戶

2632. 確保您在瀏覽器中登入正確的 Claude 帳戶2842. 確保您在瀏覽器中登入正確的 Claude 帳戶

2643. 檢查您的 Claude 計畫是否包括 Claude Code 存取

265 285

266<h2 id="current-limitations">286<h2 id="current-limitations">

267 目前限制287 目前限制

269 289

270* **僅 GitHub**：存儲庫必須在 GitHub 上。290* **僅 GitHub**：存儲庫必須在 GitHub 上。

271* **一次一個拉取請求**：每個工作階段可以建立一個拉取請求。291* **一次一個拉取請求**：每個工作階段可以建立一個拉取請求。

272* **需要雲端工作階段存取**：使用者需要存取[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)；沒有存取權限的使用者會收到標準聊天回應。292* **需要雲端工作階段存取**：使用者需要存取[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)。

273 293

274<h2 id="related-resources">294<h2 id="related-resources">

275 相關資源295 相關資源

statusline.md +1 −1

Details

211| `prompt_cache` | 工作階段的 [prompt cache](/docs/zh-TW/prompt-caching) 統計資料（針對主對話）：命中率、未命中次數，以及快取是否溫暖。請參閱 [prompt cache 欄位](#prompt-cache-fields)以了解每個欄位。在主對話的第一次 API 回應之前不存在。需要 Claude Code v2.1.251 或更新版本 |211| `prompt_cache` | 工作階段的 [prompt cache](/docs/zh-TW/prompt-caching) 統計資料（針對主對話）：命中率、未命中次數，以及快取是否溫暖。請參閱 [prompt cache 欄位](#prompt-cache-fields)以了解每個欄位。在主對話的第一次 API 回應之前不存在。需要 Claude Code v2.1.251 或更新版本 |

213| `session_name` | 工作階段名稱。使用使用 `--name` 旗標或 `/rename` 設定的自訂名稱（如果存在），否則使用 AI 產生的工作階段標題。[預設顯示名稱](/docs/zh-TW/sessions#name-your-sessions)（例如 `my-app-3f`）不會填入此欄位。當工作階段既沒有自訂名稱也沒有 AI 產生的標題時不存在 |213| `session_name` | 工作階段名稱。使用使用 `--name` 旗標或 `/rename` 設定的自訂名稱（如果存在），否則使用 AI 產生的工作階段標題。[預設顯示名稱](/docs/zh-TW/sessions#name-your-sessions)（例如 `my-app-3f`）不會填入此欄位。當工作階段既沒有自訂名稱也沒有 AI 產生的標題時不存在 |

214| `prompt_id` | 識別目前正在處理的使用者提示的 UUID。符合 [OpenTelemetry 事件上的 `prompt.id` 屬性](/docs/zh-TW/monitoring-usage#event-correlation-attributes)。在第一次使用者輸入之前不存在。需要 Claude Code v2.1.196 或更新版本 |214| `prompt_id` | 識別目前正在處理的使用者提示詞的 UUID。符合 [OpenTelemetry 事件上的 `prompt.id` 屬性](/docs/zh-TW/monitoring-usage#event-correlation-attributes)。在第一次使用者輸入之前不存在 |

sub-agents.md +2 −2

Details

315| `tools` | 否 | 子代理可以使用的[工具](#available-tools)，作為逗號分隔的字串，例如 `Read, Grep, Bash` 或 YAML 列表。如果省略，繼承子代理可用的每個工具。如果列表中沒有條目解析為工具，子代理通常[無法啟動](/docs/zh-TW/errors#agent-would-be-spawned-with-zero-tools)並出現錯誤，命名未解析的條目。若要將 Skills 預載入上下文，請使用 `skills` 欄位而不是在此列出 `Skill` |315| `tools` | 否 | 子代理可以使用的[工具](#available-tools)，作為逗號分隔的字串，例如 `Read, Grep, Bash` 或 YAML 列表。如果省略，繼承子代理可用的每個工具。如果列表中沒有條目解析為工具，子代理通常[無法啟動](/docs/zh-TW/errors#agent-would-be-spawned-with-zero-tools)並出現錯誤，命名未解析的條目。若要將 Skills 預載入上下文，請使用 `skills` 欄位而不是在此列出 `Skill` |

316| `disallowedTools` | 否 | 要拒絕的工具，從繼承或指定的列表中移除。與 `tools` 相同的格式。具有指定符的條目（例如 `Bash(git push *)`）仍然[移除整個工具](#available-tools) |316| `disallowedTools` | 否 | 要拒絕的工具，從繼承或指定的列表中移除。與 `tools` 相同的格式。具有指定符的條目（例如 `Bash(git push *)`）仍然[移除整個工具](#available-tools) |

317| `model` | 否 | 要使用的[模型](#choose-a-model)：`sonnet`、`opus`、`haiku`、`fable`、完整模型 ID（例如 `claude-opus-5-5`）或 `inherit`。當您省略它時，Claude Code 會在[子代理模型順序](#choose-a-model)中選擇模型 |317| `model` | 否 | 要使用的[模型](#choose-a-model)：`sonnet`、`opus`、`haiku`、`fable`、完整模型 ID（例如 `claude-opus-5-5`）或 `inherit`。當您省略它時，Claude Code 會在[子代理模型順序](#choose-a-model)中選擇模型 |

318| `permissionMode` | 否 | [權限模式](#permission-modes)：`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、`plan` 或 `manual` 作為 `default` 的別名。`manual` 別名需要 Claude Code v2.1.200 或更新版本。對於 [plugin 子代理](#choose-the-subagent-scope)被忽略 |318| `permissionMode` | 否 | [權限模式](#permission-modes)：`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、`plan`，或作為 `default` 別名的 `manual`。對[外掛 subagent](#choose-the-subagent-scope) 會被忽略 |

319| `maxTurns` | 否 | 子代理停止前的最大代理轉數。當子代理達到限制時，Claude Code 返回其輸出標記為部分，Claude 可以[恢復它](#resume-subagents)以繼續。部分標記需要 Claude Code v2.1.246 或更新版本 |319| `maxTurns` | 否 | 子代理停止前的最大代理轉數。當子代理達到限制時，Claude Code 返回其輸出標記為部分，Claude 可以[恢復它](#resume-subagents)以繼續。部分標記需要 Claude Code v2.1.246 或更新版本 |

320| `skills` | 否 | 在啟動時預載入子代理上下文的[技能](/docs/zh-TW/skills)。注入完整技能內容，而不僅僅是描述。子代理仍然可以透過 Skill 工具叫用未列出的專案、使用者和 plugin 技能 |320| `skills` | 否 | 在啟動時預載入子代理上下文的[技能](/docs/zh-TW/skills)。注入完整技能內容，而不僅僅是描述。子代理仍然可以透過 Skill 工具叫用未列出的專案、使用者和 plugin 技能 |

321| `mcpServers` | 否 | 此子代理可用的 [MCP 伺服器](/docs/zh-TW/mcp)。每個條目要麼是參考已設定伺服器的伺服器名稱（例如 `"slack"`），要麼是內聯定義，伺服器名稱作為鍵，完整 [MCP 伺服器設定](/docs/zh-TW/mcp#installing-mcp-servers)作為值。對於 [plugin 子代理](#choose-the-subagent-scope)被忽略 |321| `mcpServers` | 否 | 此子代理可用的 [MCP 伺服器](/docs/zh-TW/mcp)。每個條目要麼是參考已設定伺服器的伺服器名稱（例如 `"slack"`），要麼是內聯定義，伺服器名稱作為鍵，完整 [MCP 伺服器設定](/docs/zh-TW/mcp#installing-mcp-servers)作為值。對於 [plugin 子代理](#choose-the-subagent-scope)被忽略 |

988 988

989subagent 的執行因 API 錯誤（例如用量上限或重複的伺服器錯誤）而結束時，會將該失敗報告回 Claude。Claude 接收的內容取決於 subagent 執行的位置：989subagent 的執行因 API 錯誤（例如用量上限或重複的伺服器錯誤）而結束時，會將該失敗報告回 Claude。Claude 接收的內容取決於 subagent 執行的位置：

990 990

991* **前景**：如果速率限制、過載或伺服器錯誤切斷已經產生文字輸出的 subagent，Agent 工具會返回該部分輸出，並附註 subagent 被切斷且未完成其任務。未產生任何內容或其唯一輸出為工具呼叫的 subagent 會失敗，並顯示 [`Agent terminated early due to an API error`](/docs/zh-TW/errors#agent-terminated-early-due-to-an-api-error)，後跟錯誤詳細資訊。在 v2.1.199 中，切斷僅含工具呼叫情況的速率限制、過載或伺服器錯誤，返回的是只包含切斷附註的空部分結果。991* **前景**：如果速率限制、過載或伺服器錯誤切斷已經產生文字輸出的 subagent，Agent 工具會返回該部分輸出，並附註 subagent 被切斷且未完成其任務。未產生任何內容或其唯一輸出為工具呼叫的 subagent 會失敗，並顯示 [`Agent terminated early due to an API error`](/docs/zh-TW/errors#agent-terminated-early-due-to-an-api-error)，後跟錯誤詳細資訊。

992* **背景**：subagent 被標記為失敗，Claude 在其結束時接收的訊息會指出 API 錯誤並包括 subagent 的最後輸出，所以部分工作不會遺失。992* **背景**：subagent 被標記為失敗，Claude 在其結束時接收的訊息會指出 API 錯誤並包括 subagent 的最後輸出，所以部分工作不會遺失。

993 993

994當您設定 [備援模型鏈](/docs/zh-TW/model-config#fallback-model-chains) 且 subagent 遇到鏈涵蓋的失敗（例如其模型不可用）時，Claude Code 會將 subagent 切換到鏈中接受請求的第一個模型。Subagent 會繼續工作而不是因錯誤而結束。994當您設定 [備援模型鏈](/docs/zh-TW/model-config#fallback-model-chains) 且 subagent 遇到鏈涵蓋的失敗（例如其模型不可用）時，Claude Code 會將 subagent 切換到鏈中接受請求的第一個模型。Subagent 會繼續工作而不是因錯誤而結束。

third-party-integrations.md +3 −3

Details

227 投資於文件和記憶227 投資於文件和記憶

228</h3>228</h3>

229 229

230我們強烈建議投資於文件，以便 Claude Code 能夠理解您的程式碼庫。組織可以在多個層級部署 CLAUDE.md 檔案。請參閱[CLAUDE.md 檔案可以存放的位置](/docs/zh-TW/memory#choose-where-to-put-claude-md-files)和[如何部署組織範圍的 CLAUDE.md](/docs/zh-TW/memory#deploy-organization-wide-claude-md)。230投資於文件，以便 Claude Code 能夠理解您的程式碼庫。組織可以在多個層級部署 CLAUDE.md 檔案。請參閱[CLAUDE.md 檔案可以存放的位置](/docs/zh-TW/memory#choose-where-to-put-claude-md-files)和[如何部署組織範圍的 CLAUDE.md](/docs/zh-TW/memory#deploy-organization-wide-claude-md)。

231 231

232<h3 id="simplify-deployment">232<h3 id="simplify-deployment">

233 簡化部署233 簡化部署

234</h3>234</h3>

235 235

236如果您有自訂開發環境，我們發現建立「一鍵」安裝 Claude Code 的方式是在組織中推動採用的關鍵。236如果您有自訂開發環境，建立「一鍵」安裝 Claude Code 的方式是在組織中推動採用的關鍵。

237 237

238<h3 id="start-with-guided-usage">238<h3 id="start-with-guided-usage">

239 從引導式使用開始239 從引導式使用開始

259 使用 MCP 進行整合259 使用 MCP 進行整合

260</h3>260</h3>

261 261

262MCP 是為 Claude Code 提供更多資訊的絕佳方式，例如連接到票證管理系統或錯誤日誌。我們建議由一個中央團隊設定 MCP 伺服器，並將 `.mcp.json` 設定檔簽入程式碼庫，以便所有使用者受益。[瞭解更多](/docs/zh-TW/mcp)。262MCP 是為 Claude Code 提供更多資訊的絕佳方式，例如連接到票證管理系統或錯誤日誌。由一個中央團隊設定 MCP 伺服器，並將 `.mcp.json` 設定檔簽入程式碼庫，以便所有使用者受益。[瞭解更多](/docs/zh-TW/mcp)。

263 263

264<h2 id="next-steps">264<h2 id="next-steps">

265 後續步驟265 後續步驟

tools-reference.md +9 −9

Details

43| `Read` | 讀取檔案的內容。請參閱 [Read 工具行為](#read-tool-behavior) | 否 |43| `Read` | 讀取檔案的內容。請參閱 [Read 工具行為](#read-tool-behavior) | 否 |

44| `ReadMcpResourceTool` | 按 URI 讀取特定 MCP 資源 | 否 |44| `ReadMcpResourceTool` | 按 URI 讀取特定 MCP 資源 | 否 |

45| `RemoteTrigger` | 在 claude.ai 上建立、更新、執行和列出[例行程序](/docs/zh-TW/routines)。支援 `/schedule` 命令。[`RemoteTrigger` 輸入參考](/docs/zh-TW/agent-sdk/typescript#remotetrigger)記錄每個動作和移除工具的組織政策。例行程序位於 claude.ai 上並需要 Pro、Max、Team 或 Enterprise 方案，因此此工具無法從 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 存取 | 否 |45| `RemoteTrigger` | 在 claude.ai 上建立、更新、執行和列出[例行程序](/docs/zh-TW/routines)。支援 `/schedule` 命令。[`RemoteTrigger` 輸入參考](/docs/zh-TW/agent-sdk/typescript#remotetrigger)記錄每個動作和移除工具的組織政策。例行程序位於 claude.ai 上並需要 Pro、Max、Team 或 Enterprise 方案，因此此工具無法從 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 存取 | 否 |

46| `ReportFindings` | 將程式碼審查發現報告為結構化清單，每個發現都有檔案、摘要和失敗情景，以便 Claude Code 可以呈現它們而不是將其列印為文字。當活躍的程式碼審查指示告訴它時，Claude 會呼叫它。需要 Claude Code v2.1.196 或更新版本。從 v2.1.199 開始，發現也可以帶有可選的 `category` slug，例如 `correctness` 或 `test-coverage`，顯示在呈現清單中的檔案位置旁邊 | 否 |46| `ReportFindings` | 將程式碼審查發現報告為結構化清單，每個發現都有檔案、摘要和失敗情景，以便 Claude Code 可以呈現它們而不是將其列印為文字。當有效的程式碼審查指示要求時，Claude 會呼叫它。發現也可以帶有選用的 `category` slug，例如 `correctness` 或 `test-coverage`，顯示在呈現清單中的檔案位置旁邊 | 否 |

47| `ScheduleWakeup` | 重新排程[自我調整 `/loop`](/docs/zh-TW/scheduled-tasks#let-claude-choose-the-interval)的下一次迭代。Claude 在每次迭代結束時呼叫此項以選擇下一次執行的時間，介於一分鐘到一小時之間；您不直接呼叫它。若要改為結束迴圈，Claude 使用 `stop: true` 呼叫它，這會取消待處理的喚醒。`stop` 欄位需要 Claude Code v2.1.202 或更新版本。待處理的喚醒出現在[停止 hook 輸入](/docs/zh-TW/hooks#stop-input)中的 `session_crons` 中 | 否 |47| `ScheduleWakeup` | 重新排程[自我調整 `/loop`](/docs/zh-TW/scheduled-tasks#let-claude-choose-the-interval)的下一次迭代。Claude 在每次迭代結束時呼叫此項以選擇下一次執行的時間，介於一分鐘到一小時之間；您不直接呼叫它。若要改為結束迴圈，Claude 使用 `stop: true` 呼叫它，這會取消待處理的喚醒。`stop` 欄位需要 Claude Code v2.1.202 或更新版本。待處理的喚醒出現在[停止 hook 輸入](/docs/zh-TW/hooks#stop-input)中的 `session_crons` 中 | 否 |

48| `SendFeedback` | 起草關於 Claude Code 的回饋報告，涵蓋產品問題或 Claude 在工作階段中的自身行為，並在您的機器上排隊供您審查。Claude Code 在您選擇傳送草稿之前不會傳送任何內容。請參閱 [SendFeedback 工具行為](#sendfeedback-tool-behavior)。需要 Claude Code v2.1.238 或更新版本 | 否 |48| `SendFeedback` | 起草關於 Claude Code 的回饋報告，涵蓋產品問題或 Claude 在工作階段中的自身行為，並在您的機器上排隊供您審查。Claude Code 在您選擇傳送草稿之前不會傳送任何內容。請參閱 [SendFeedback 工具行為](#sendfeedback-tool-behavior)。需要 Claude Code v2.1.238 或更新版本 | 否 |

49| `SendMessage` | 傳送訊息給另一個代理：[代理團隊](/docs/zh-TW/agent-teams)隊友、[它按代理 ID 或名稱復原的子代理](/docs/zh-TW/sub-agents#resume-subagents)，或您的其他 Claude Code 工作階段之一，在此機器上或超越它。傳訊其他工作階段需要 Claude Code v2.1.224 或更新版本。[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)涵蓋 Claude 可以到達的工作階段、[訊息到達時的樣子](/docs/zh-TW/cross-session-messaging#what-a-message-looks-like)以及 [Claude 如何在另一個工作階段閒置時收到通知](/docs/zh-TW/cross-session-messaging#get-a-notice-when-another-session-goes-idle)。Claude 可以包含可選的 `summary` 輸入，通常 5-10 個字，Claude Code 顯示為單行預覽。當 Claude 在[純文字訊息](/docs/zh-TW/cross-session-messaging#limitations)上省略它時，Claude Code 使用訊息的第一行作為摘要。Claude Code 使用省略號截斷超過 200 個字元的摘要 | 否 |49| `SendMessage` | 傳送訊息給另一個代理：[代理團隊](/docs/zh-TW/agent-teams)隊友、[它按代理 ID 或名稱復原的子代理](/docs/zh-TW/sub-agents#resume-subagents)，或您的其他 Claude Code 工作階段之一，在此機器上或超越它。傳訊其他工作階段需要 Claude Code v2.1.224 或更新版本。[跨工作階段傳訊](/docs/zh-TW/cross-session-messaging)涵蓋 Claude 可以到達的工作階段、[訊息到達時的樣子](/docs/zh-TW/cross-session-messaging#what-a-message-looks-like)以及 [Claude 如何在另一個工作階段閒置時收到通知](/docs/zh-TW/cross-session-messaging#get-a-notice-when-another-session-goes-idle)。Claude 可以包含可選的 `summary` 輸入，通常 5-10 個字，Claude Code 顯示為單行預覽。當 Claude 在[純文字訊息](/docs/zh-TW/cross-session-messaging#limitations)上省略它時，Claude Code 使用訊息的第一行作為摘要。Claude Code 使用省略號截斷超過 200 個字元的摘要 | 否 |

50| `SendUserFile` | 從工作階段傳送檔案給您，帶有可選的標題，以便生成的報告、圖表、螢幕擷取畫面或內建成品到達您的裝置，而不是僅在文字記錄中提及。從 v2.1.196 開始，可選的 `display` 輸入控制呈現：`render` 在用戶端中內聯開啟檔案，`attach` 僅顯示下載卡，未設定時用戶端根據檔案型別決定。當[遠端控制](/docs/zh-TW/remote-control)用戶端連接或在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中時可用。傳遞透過 Anthropic 託管的基礎設施執行，因此該工具在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用 | 否 |50| `SendUserFile` | 從工作階段傳送檔案給您，帶有選用的說明文字，以便生成的報告、圖表、螢幕擷取畫面或建置產物到達您的裝置，而不是僅在逐字稿中提及。選用的 `display` 輸入控制呈現方式：`render` 在用戶端中內嵌開啟檔案，`attach` 僅顯示下載卡，未設定時由用戶端根據檔案型別決定。當 [Remote Control](/docs/zh-TW/remote-control) 用戶端連接或在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中時可用。傳遞透過 Anthropic 託管的基礎設施執行，因此該工具在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用 | 否 |

51| `ShareOnboardingGuide` | 上傳 `ONBOARDING.md` 並返回隊友可以在 Claude Code 中開啟的分享連結。在指南寫入後從 `/team-onboarding` 呼叫。適用於 Pro、Max、Team 和 Enterprise 方案上的 claude.ai 訂閱者 | 是 |51| `ShareOnboardingGuide` | 上傳 `ONBOARDING.md` 並返回隊友可以在 Claude Code 中開啟的分享連結。在指南寫入後從 `/team-onboarding` 呼叫。適用於 Pro、Max、Team 和 Enterprise 方案上的 claude.ai 訂閱者 | 是 |

52| `Skill` | 在主對話中執行[技能](/docs/zh-TW/skills#control-who-invokes-a-skill) | 是 |52| `Skill` | 在主對話中執行[技能](/docs/zh-TW/skills#control-who-invokes-a-skill) | 是 |

53| `SubagentHandback` | 將子代理的最終報告傳遞給接收該子代理結果的任何對話。僅在[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)中提供，給 Agent 工具在本機執行的子代理，除了[分支](/docs/zh-TW/sub-agents#fork-the-current-conversation)，並在終端 CLI、IDE 擴充功能、雲端工作階段和 Agent SDK 中可用；分類器在傳遞報告前審查它。需要 Claude Code v2.1.271 或更新版本 | 否 |53| `SubagentHandback` | 將子代理的最終報告傳遞給接收該子代理結果的任何對話。僅在[自動模式](/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode)中提供，給 Agent 工具在本機執行的子代理，除了[分支](/docs/zh-TW/sub-agents#fork-the-current-conversation)，並在終端 CLI、IDE 擴充功能、雲端工作階段和 Agent SDK 中可用；分類器在傳遞報告前審查它。需要 Claude Code v2.1.271 或更新版本 | 否 |

55| `TaskGet` | 檢索特定任務的完整詳細資訊。預設情況下僅在[任務工具可用性](#task-tool-availability)下列出的模型上提供，在其他模型上當您選擇加入時提供 | 否 |55| `TaskGet` | 檢索特定任務的完整詳細資訊。預設情況下僅在[任務工具可用性](#task-tool-availability)下列出的模型上提供，在其他模型上當您選擇加入時提供 | 否 |

56| `TaskList` | 列出所有任務及其目前狀態。預設情況下僅在[任務工具可用性](#task-tool-availability)下列出的模型上提供，在其他模型上當您選擇加入時提供 | 否 |56| `TaskList` | 列出所有任務及其目前狀態。預設情況下僅在[任務工具可用性](#task-tool-availability)下列出的模型上提供，在其他模型上當您選擇加入時提供 | 否 |

57| `TaskOutput` | 檢索來自背景任務的輸出。已棄用，改為在任務的輸出檔案路徑上使用 `Read`。當沒有任務符合 ID 時，錯誤會列出執行中的背景代理（按 ID 和說明）。在 v2.1.203 之前，錯誤僅命名遺失的 ID | 否 |57| `TaskOutput` | 檢索來自背景任務的輸出。已棄用，改為在任務的輸出檔案路徑上使用 `Read`。當沒有任務符合 ID 時，錯誤會列出執行中的背景代理（按 ID 和說明）。在 v2.1.203 之前，錯誤僅命名遺失的 ID | 否 |

58| `TaskStop` | 按 ID 停止執行中的背景任務。它也接受[代理團隊隊友](/docs/zh-TW/agent-teams)或按代理 ID 或名稱命名的背景代理。在 v2.1.198 之前，它僅接受背景任務 ID。當沒有任務符合 ID 時，錯誤會列出執行中的背景代理（按 ID 和說明），包括另一個代理生成的代理。在 v2.1.203 之前，錯誤列出執行中的隊友和命名代理，但不列出另一個代理生成的背景代理，因此無法從主對話中識別或停止它們 | 否 |58| `TaskStop` | 按 ID 停止執行中的背景任務。它也接受 [agent team 隊友](/docs/zh-TW/agent-teams)或按 agent ID 或名稱指定的具名背景 agent。當沒有任務符合 ID 時，錯誤會列出執行中的背景 agent（按 ID 和說明），包括另一個 agent 生成的 agent。在 v2.1.203 之前，錯誤列出執行中的隊友和具名 agent，但不列出另一個 agent 生成的背景 agent，因此無法從主對話中識別或停止它們 | 否 |

59| `TaskUpdate` | 更新任務狀態、依賴項、詳細資訊或刪除任務。預設情況下僅在[任務工具可用性](#task-tool-availability)下列出的模型上提供，在其他模型上當您選擇加入時提供 | 否 |59| `TaskUpdate` | 更新任務狀態、依賴項、詳細資訊或刪除任務。預設情況下僅在[任務工具可用性](#task-tool-availability)下列出的模型上提供，在其他模型上當您選擇加入時提供 | 否 |

60| `TodoWrite` | 管理工作階段任務檢查清單。預設情況下禁用，改為使用 `TaskCreate`、`TaskGet`、`TaskList` 和 `TaskUpdate`。設定 `CLAUDE_CODE_ENABLE_TASKS=0` 以在[具有任務追蹤工具的工作階段](#task-tool-availability)中重新啟用它 | 否 |60| `TodoWrite` | 管理工作階段任務檢查清單。預設情況下禁用，改為使用 `TaskCreate`、`TaskGet`、`TaskList` 和 `TaskUpdate`。設定 `CLAUDE_CODE_ENABLE_TASKS=0` 以在[具有任務追蹤工具的工作階段](#task-tool-availability)中重新啟用它 | 否 |

61| `ToolSearch` | 當[工具搜尋](/docs/zh-TW/mcp#scale-with-mcp-tool-search)啟用時，搜尋並載入延遲工具 | 否 |61| `ToolSearch` | 當[工具搜尋](/docs/zh-TW/mcp#scale-with-mcp-tool-search)啟用時，搜尋並載入延遲工具 | 否 |

122您看到子代理權限提示的位置取決於它是在前景還是背景中執行。Claude Code 預設在背景中執行子代理，除了 [cases that run in the foreground](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) 外。122您看到子代理權限提示的位置取決於它是在前景還是背景中執行。Claude Code 預設在背景中執行子代理，除了 [cases that run in the foreground](/docs/zh-TW/sub-agents#run-subagents-in-foreground-or-background) 外。

123 123

124* **前景子代理**顯示您在主對話中會看到的相同權限提示，在每個工具呼叫發生時。124* **前景子代理**顯示您在主對話中會看到的相同權限提示，在每個工具呼叫發生時。

125* **背景子代理** 自 v2.1.186 起在您的主工作階段中顯示權限提示。提示會命名哪個子代理在詢問，按 Esc 會拒絕該工具呼叫而不停止子代理。在 v2.1.186 之前，背景子代理會自動拒絕任何否則會提示的工具呼叫，並在沒有該工具的情況下繼續。125* **背景 subagent** 會在您的主工作階段中顯示權限提示。提示會指出是哪個 subagent 在詢問，按 Esc 會拒絕該次工具呼叫，而不會停止 subagent。

126 126

127若要 [limit what a subagent can reach](/docs/zh-TW/sub-agents#control-subagent-capabilities)，請首先縮小其 `tools` 欄位，例如透過將 Bash 留在列表之外，或在您的設定中設定拒絕規則。127若要 [limit what a subagent can reach](/docs/zh-TW/sub-agents#control-subagent-capabilities)，請首先縮小其 `tools` 欄位，例如透過將 Bash 留在列表之外，或在您的設定中設定拒絕規則。

128 128

138 問題自動繼續逾時138 問題自動繼續逾時

139</h3>139</h3>

140 140

141問題會保持開啟，直到您回答為止。如果您想讓未回答的問題最終關閉並讓 Claude 在沒有您的情況下繼續，請在您的使用者 `settings.json` 中或從 `/config` 中的 **Question auto-continue timeout** 列設定 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定為 `60s`、`5m` 或 `10m`。141問題會保持開啟，直到您回答為止。如果您想讓未回答的問題最終關閉並讓 Claude 在沒有您的情況下繼續，請在您的使用者 `settings.json` 中或從 `/config` 中的 **Question auto-continue timeout** 列將 [`askUserQuestionTimeout`](/docs/zh-TW/settings-reference#askuserquestiontimeout) 設定為 `60s`、`5m` 或 `10m`。

142 142

143問題閒置該時間長度而沒有輸入後，對話框會自動關閉：它會提交您已選擇的任何選項，並告訴 Claude 您可能離開了鍵盤，因此 Claude 會根據自己的判斷進行，稍後可以重新提問。您會看到最後 20 秒的倒數計時。按任何鍵即可重新啟動計時器。當您的終端機回報其視窗處於焦點狀態時，計時器不會倒數。143問題閒置該時間長度而沒有輸入後，對話框會自動關閉：它會提交您已選擇的任何選項，並告訴 Claude 您可能離開了鍵盤，因此 Claude 會根據自己的判斷進行，稍後可以重新提問。您會看到最後 20 秒的倒數計時。按任何鍵即可重新啟動計時器。當您的終端機回報其視窗處於焦點狀態時，計時器不會倒數。

144 144

512 512

513Bash 工具部分所述的相同主工作階段工作目錄重設行為適用於 PowerShell 命令，包括 `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` 環境變數。513Bash 工具部分所述的相同主工作階段工作目錄重設行為適用於 PowerShell 命令，包括 `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` 環境變數。

514 514

515自 v2.1.196 起，來自 `grep`、`rg`、`egrep`、`fgrep`、`findstr` 和 `git grep` 的結束代碼 1 表示無符合項目。來自 `git diff` 的結束代碼 1 表示存在差異。這兩個結果都不會向 Claude 報告為命令失敗。對於 `robocopy`，結束代碼 0 到 7 是資訊性結果，例如複製的檔案或偵測到的額外檔案。結束代碼 8 或更高視為失敗。515來自 `grep`、`rg`、`egrep`、`fgrep`、`findstr` 和 `git grep` 的結束代碼 1 表示無符合項目。來自 `git diff` 的結束代碼 1 表示存在差異。這兩個結果都不會向 Claude 報告為命令失敗。對於 `robocopy`，結束代碼 0 到 7 是資訊性結果，例如複製的檔案或偵測到的額外檔案。結束代碼 8 或更高視為失敗。

516 516

517<h3 id="windows-encoding-and-exit-codes">517<h3 id="windows-encoding-and-exit-codes">

518 Windows 編碼和結束代碼518 Windows 編碼和結束代碼

551 551

552Read 處理純文字以外的多種檔案類型：552Read 處理純文字以外的多種檔案類型：

553 553

554* **影像**：PNG、JPG 和其他影像格式會以 Claude 可以看到的視覺內容形式傳回，而不是原始位元組。Claude Code 會在傳送前調整大小並重新壓縮大型影像以符合模型的影像大小限制，因此 Claude 可能會看到大型螢幕擷取畫面的縮小版本。自 v2.1.196 起，在調整大小後仍大於 500KB 的影像會以降低品質的 JPEG 格式重新編碼，其像素尺寸保持不變。如果 Claude 在大型影像中遺漏了細微的像素級細節，請要求它先裁剪感興趣的區域，例如透過 Bash 使用 ImageMagick。554* **影像**：PNG、JPG 和其他影像格式會以 Claude 可以看到的視覺內容形式傳回，而不是原始位元組。Claude Code 會在傳送前調整大小並重新壓縮大型影像以符合模型的影像大小限制，因此 Claude 可能會看到大型螢幕擷取畫面的縮小版本。在調整大小後仍大於 500KB 的影像會以降低品質的 JPEG 格式重新編碼，其像素尺寸保持不變。如果 Claude 在大型影像中遺漏了細微的像素級細節，請要求它先裁剪感興趣的區域，例如透過 Bash 使用 ImageMagick。

555* **PDF**：Claude 會完整讀取短 `.pdf` 檔案。對於超過 10 頁的 PDF，它會使用 `pages` 參數（例如 `"1-5"`）按範圍讀取，一次最多 20 頁。頁面範圍讀取會使用 poppler-utils 中的 `pdftoppm` 呈現頁面，因此在 macOS 上使用 `brew install poppler` 安裝，或在 Debian 和 Ubuntu 上使用 `apt-get install poppler-utils` 安裝。在 Windows 和其他平台上，安裝將 `pdftoppm` 放在您的 `PATH` 上的 poppler 組建。沒有它，頁面範圍讀取會失敗並顯示 `pdftoppm is not installed`。555* **PDF**：Claude 會完整讀取短 `.pdf` 檔案。對於超過 10 頁的 PDF，它會使用 `pages` 參數（例如 `"1-5"`）按範圍讀取，一次最多 20 頁。頁面範圍讀取會使用 poppler-utils 中的 `pdftoppm` 呈現頁面，因此在 macOS 上使用 `brew install poppler` 安裝，或在 Debian 和 Ubuntu 上使用 `apt-get install poppler-utils` 安裝。在 Windows 和其他平台上，安裝將 `pdftoppm` 放在您的 `PATH` 上的 poppler 組建。沒有它，頁面範圍讀取會失敗並顯示 `pdftoppm is not installed`。

556* **Jupyter 筆記本**：`.ipynb` 檔案會傳回所有儲存格及其輸出，包括程式碼、markdown 和視覺化。Claude Code 拒絕讀取超過 100 MB 的筆記本檔案；錯誤會告訴 Claude 如何改為讀取筆記本的一部分，例如使用 shell 命令讀取儲存格的切片。556* **Jupyter 筆記本**：`.ipynb` 檔案會傳回所有儲存格及其輸出，包括程式碼、markdown 和視覺化。Claude Code 拒絕讀取超過 100 MB 的筆記本檔案；錯誤會告訴 Claude 如何改為讀取筆記本的一部分，例如使用 shell 命令讀取儲存格的切片。

557 557

603 603

604Claude Code 會將您的工作目錄保留在本機草稿中，以便它可以找到文字記錄，並且不會發送該目錄。604Claude Code 會將您的工作目錄保留在本機草稿中，以便它可以找到文字記錄，並且不會發送該目錄。

605 605

606在[零資料保留的組織](/docs/zh-TW/zero-data-retention#features-disabled-under-zdr)中，Claude Code 會將該工具排除在外，就像它對 `/feedback` 所做的那樣。如果此類組織中的工作階段仍然提供該工具，草稿會保留在您的機器上，發送會失敗並顯示 `Feedback collection is not available for organizations with custom data retention policies.`606在[零資料保留的組織](/docs/zh-TW/zero-data-retention#features-disabled-under-zdr)中，以及已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織中，Claude Code 會將該工具排除在外，就像它對 `/feedback` 所做的那樣。如果零資料保留組織中的工作階段仍然提供該工具，草稿會保留在您的機器上，發送會失敗並顯示 `Feedback collection is not available for organizations with custom data retention policies.`

607 607

608<h3 id="discard-or-keep-a-draft">608<h3 id="discard-or-keep-a-draft">

609 捨棄或保留草稿609 捨棄或保留草稿

627* [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，無法寫入您機器上的佇列627* [雲端工作階段](/docs/zh-TW/claude-code-on-the-web)，無法寫入您機器上的佇列

628* [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws)、[Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 上的工作階段628* [Amazon Bedrock](/docs/zh-TW/amazon-bedrock)、[Claude Platform on AWS](/docs/zh-TW/claude-platform-on-aws)、[Google Cloud's Agent Platform](/docs/zh-TW/google-vertex-ai) 或 [Microsoft Foundry](/docs/zh-TW/microsoft-foundry) 上的工作階段

629* 您設定 [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/zh-TW/env-vars) 或 [`DISABLE_FEEDBACK_COMMAND=1`](/docs/zh-TW/env-vars) 的工作階段，將 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 設定為任何非空值，或關閉[功能旗標擷取](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching)629* 您設定 [`CLAUDE_CODE_SEND_FEEDBACK=0`](/docs/zh-TW/env-vars) 或 [`DISABLE_FEEDBACK_COMMAND=1`](/docs/zh-TW/env-vars) 的工作階段，將 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 設定為任何非空值，或關閉[功能旗標擷取](/docs/zh-TW/env-vars#features-that-need-feature-flag-fetching)

630* 已關閉產品回饋的組織，以及[零資料保留的組織](/docs/zh-TW/zero-data-retention#features-disabled-under-zdr)630* 已關閉產品回饋的組織、[零資料保留的組織](/docs/zh-TW/zero-data-retention#features-disabled-under-zdr)，以及已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織

631 631

632<h2 id="task-tool-availability">632<h2 id="task-tool-availability">

633 Task 工具可用性633 Task 工具可用性

ultrareview.md +1 −1

Details

18* **更廣泛的覆蓋範圍**：許多審查代理程式並行探索變更，這會發現本地審查可能遺漏的問題18* **更廣泛的覆蓋範圍**：許多審查代理程式並行探索變更，這會發現本地審查可能遺漏的問題

19* **無本地資源使用**：審查完全在雲端沙箱中執行，因此您的終端在執行期間保持空閒，可用於其他工作19* **無本地資源使用**：審查完全在雲端沙箱中執行，因此您的終端在執行期間保持空閒，可用於其他工作

20 20

21Ultrareview 需要使用 claude.ai 帳戶進行身份驗證，因為它在 Anthropic 的基礎設施上作為雲端工作階段執行。如果您僅使用 API 金鑰登入，請先執行 `/login` 並使用 claude.ai 進行身份驗證。使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 的 Claude Code 時，Ultrareview 不可用，對於已啟用零資料保留的組織也不可用。當 ultrareview 不可用時，`/code-review ultra` 會改為在您的工作階段中執行本地審查。21Ultrareview 需要使用 claude.ai 帳戶進行身分驗證，因為它在 Anthropic 的基礎設施上作為雲端工作階段執行。如果您僅使用 API 金鑰登入，請先執行 `/login` 並使用 claude.ai 進行身分驗證。使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 的 Claude Code 時，Ultrareview 不可用，對於已啟用零資料保留或已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織也不可用。當 ultrareview 不可用時，`/code-review ultra` 會改為在您的工作階段中執行本地審查。

22 22

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 從 CLI 執行 ultrareview24 從 CLI 執行 ultrareview

voice-dictation.md +1 −1

Details

8 8

9在 Claude Code CLI 中說出您的提示，而不是輸入它們。您的語音會即時轉錄到提示輸入中，因此您可以在同一條訊息中混合語音和輸入。使用 `/voice` 啟用聽寫，然後在說話時按住一個鍵或點擊一次開始，再點擊一次發送。9在 Claude Code CLI 中說出您的提示，而不是輸入它們。您的語音會即時轉錄到提示輸入中，因此您可以在同一條訊息中混合語音和輸入。使用 `/voice` 啟用聽寫，然後在說話時按住一個鍵或點擊一次開始，再點擊一次發送。

10 10

~~11聽寫也適用於[代理檢視](/docs/zh-TW/agent-view#peek-and-reply)。在調度輸入或窺視面板回覆聚焦時，按住或點擊您的推送通話鍵以聽寫到背景工作階段。~~11在[按住模式](#hold-to-record)下，聽寫也適用於 [agent 檢視](/docs/zh-TW/agent-view#peek-and-reply)。在 dispatch 輸入或窺視面板回覆聚焦時，按住您的按鍵通話鍵，即可聽寫到背景工作階段。

12 12

13<h2 id="requirements">13<h2 id="requirements">

14 要求14 要求

web-quickstart.md +2 −2

Details

103如果您已經在瀏覽器中連接了 GitHub，`/web-setup` 會警告您繼續將會取代您的雲端工作階段的該連接。103如果您已經在瀏覽器中連接了 GitHub，`/web-setup` 會警告您繼續將會取代您的雲端工作階段的該連接。

104 104

105<Note>105<Note>

106 啟用[零資料保留](/docs/zh-TW/zero-data-retention)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。如果未安裝 GitHub CLI 或未進行驗證，Claude Code 會改為開啟瀏覽器上線流程。106 啟用[零資料保留](/docs/zh-TW/zero-data-retention)或套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)的組織無法使用 `/web-setup` 或其他雲端工作階段功能。如果未安裝 GitHub CLI 或未進行驗證，Claude Code 會改為開啟瀏覽器上線流程。

107</Note>107</Note>

108 108

109<Steps>109<Steps>

264該命令在另外兩種情況下也被隱藏：264該命令在另外兩種情況下也被隱藏：

265 265

266* 管理員已為您的組織停用雲端會話。在這種情況下，提交 `/web-setup` 會返回 [`Cloud sessions are disabled by your organization's policy`](/docs/zh-TW/errors#cloud-sessions-are-disabled-by-your-organizations-policy)。在 v2.1.268 之前，這種情況也會返回 `Unknown command: /web-setup`。266* 管理員已為您的組織停用雲端會話。在這種情況下，提交 `/web-setup` 會返回 [`Cloud sessions are disabled by your organization's policy`](/docs/zh-TW/errors#cloud-sessions-are-disabled-by-your-organizations-policy)。在 v2.1.268 之前，這種情況也會返回 `Unknown command: /web-setup`。

267* 您的 Enterprise 組織已啟用[零資料保留](/docs/zh-TW/zero-data-retention)，這使雲端會話不可用。267* 您的 Enterprise 組織已啟用[零資料保留](/docs/zh-TW/zero-data-retention)，或已套用 [HIPAA 設定](/docs/zh-TW/hipaa-setup)。任一項都會使雲端工作階段無法使用。

268 268

269<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">269<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">

270 使用 `--cloud` 時出現 "Could not create a cloud environment" 或 "No cloud environment available"270 使用 `--cloud` 時出現 "Could not create a cloud environment" 或 "No cloud environment available"

workflows.md +6 −6

Details

49 </Step>49 </Step>

50 50

51 <Step title="允許工作流程">51 <Step title="允許工作流程">

52 Claude Code 詢問是否允許工作流程。選擇**是**以繼續。確切的提示取決於您的權限模式。有關每種模式選項，請參閱[在執行前批准計畫](#approve-the-plan-before-it-runs)。52 Claude Code 詢問是否允許工作流程。選擇 **Yes** 以繼續。確切的提示取決於您的權限模式。有關每種模式選項，請參閱[在執行前批准計畫](#approve-the-plan-before-it-runs)。

53 </Step>53 </Step>

54 54

55 <Step title="監視進度">55 <Step title="監視進度">

~~56 執行在背景中啟動。執行 `/workflows`，使用箭頭鍵選擇執行，然後按 Enter 開啟其進度檢視：~~56 執行在背景中啟動。執行 `/workflows` 以開啟其進度檢視：

57 57

58 ```text wrap theme={null}58 ```text wrap theme={null}

59 /workflows59 /workflows

60 ```60 ```

61 61

62 檢視顯示每個階段及其代理計數、令牌總計和經過時間。深入任何階段以查看其代理及每個代理發現的內容。有關完整的控制集，請參閱[監視執行](#watch-the-run)。62 如果 `/workflows` 改為顯示執行清單，請選擇您剛啟動的執行並按 Enter。檢視顯示每個階段及其 agent 數量。深入任何階段以查看其 agent 及每個 agent 發現的內容。有關完整的控制集，請參閱[監視執行](#watch-the-run)。

63 63

64 您也可以從輸入框下方的任務面板監視：執行進行時會出現一行進度摘要。按向下箭頭聚焦它，然後按 Enter 展開。64 您也可以從輸入框下方的任務面板監視：執行進行時會出現一行進度摘要。按向下箭頭聚焦它，然後按 Enter 展開。

65 </Step>65 </Step>

91 監視執行91 監視執行

92</h3>92</h3>

93 93

94工作流程在背景中執行，因此工作階段在代理工作時保持回應。隨時執行 `/workflows` 以列出執行中和已完成的工作流程，然後選擇一個以開啟其進度檢視。若要停止執行中的工作流程而不開啟它，請在清單中選擇它並按 `x`。94工作流程在背景中執行，因此工作階段在 agent 工作時保持回應。隨時執行 `/workflows` 以列出執行中和已完成的工作流程，然後選擇一個以開啟其進度檢視。當工作階段只有一個執行時，`/workflows` 會略過清單並直接開啟該執行。若要停止執行中的工作流程而不開啟它，請在清單中選擇它並按 `x`。

95 95

~~96進度檢視顯示每個階段及其代理計數、令牌總計和經過時間。頁腳列出每個動作的鍵：~~96進度檢視顯示每個階段及其 agent 數量。頁腳列出每個動作的鍵：

97 97

98| 鍵 | 動作 |98| 鍵 | 動作 |

99| :- | :- |99| :- | :- |

192* **View raw script**：在決定前讀取指令碼192* **View raw script**：在決定前讀取指令碼

193* **No**：取消193* **No**：取消

194 194

195`Ctrl+G` 在您的編輯器中開啟指令碼。`Tab` 讓您在執行開始前調整提示。195`Ctrl+G` 在您的編輯器中開啟指令碼。選取 **Yes, run it** 或 **No** 時，按 `Tab` 可為您的回答[新增註解](/docs/zh-TW/permissions#add-a-comment-when-you-answer-a-permission-prompt)。

196 196

197您是否看到此提示取決於您的[權限模式](/docs/zh-TW/permission-modes)：197您是否看到此提示取決於您的[權限模式](/docs/zh-TW/permission-modes)：

198 198

zero-data-retention.md +4 −2

Details

4 4

5# 零資料保留5# 零資料保留

6 6

~~7> 了解 Claude for Enterprise 合格帳戶可用的 Claude Code 零資料保留 (ZDR)，包括範圍、停用的功能，以及如何要求啟用。~~7> 了解 Claude for Enterprise 合格帳戶可用的 Claude Code 零資料保留 (ZDR)，包括範圍、停用的功能，以及如何請求啟用。

8 8

9Claude Code 的零資料保留 (ZDR) 適用於 Claude for Enterprise 上的合格帳戶。啟用 ZDR 後，Claude Code 工作階段期間產生的提示和模型回應會即時處理，在回應返回後不會由 Anthropic 儲存，除非需要遵守法律或防止濫用。9Claude Code 的零資料保留 (ZDR) 適用於 Claude for Enterprise 上的合格帳戶。啟用 ZDR 後，Claude Code 工作階段期間產生的提示詞和模型回應會即時處理，在回應返回後不會由 Anthropic 儲存，除非需要遵守法律或防止濫用。

10 10

11<Note>11<Note>

12 ZDR 不包含在標準 Claude for Enterprise 方案中，也無法從您的管理員設定中啟用。它適用於合格帳戶，需要由 Anthropic 進行單獨啟用。如果您的組織需要 ZDR，請[聯絡銷售](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request)或您的 Anthropic 帳戶團隊以確認資格。12 ZDR 不包含在標準 Claude for Enterprise 方案中，也無法從您的管理員設定中啟用。它適用於合格帳戶，需要由 Anthropic 進行單獨啟用。如果您的組織需要 ZDR，請[聯絡銷售](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request)或您的 Anthropic 帳戶團隊以確認資格。

13</Note>13</Note>

14 14

15已啟用 HIPAA 的 Claude for Enterprise 組織，在將 HIPAA 設定套用至 Claude Code（本機模式）和 Cowork（本機模式）後，即可在不使用 ZDR 的情況下，將 Claude Code CLI 和 Claude Desktop 中的 Code 分頁納入其商業夥伴協議 (BAA) 的涵蓋範圍。請參閱[為符合 HIPAA 要求的組織設定 Claude Code（本機模式）](/docs/zh-TW/hipaa-setup)。未採用 HIPAA 設定的組織仍需要 ZDR，才能讓 Claude Code 獲得 BAA 涵蓋。如需合格服務清單，請參閱[實施指南](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide)。

15Claude for Enterprise 上的 ZDR 為企業客戶提供了使用 Claude Code 並實現零資料保留的能力，以及存取管理功能：17Claude for Enterprise 上的 ZDR 為企業客戶提供了使用 Claude Code 並實現零資料保留的能力，以及存取管理功能：

16 18

17* 每位使用者的成本控制19* 每位使用者的成本控制

Documentation 2026-10-05 23:58 UTC to 2026-10-06 06:00 UTC