Documentation 2026-11-09 23:02 UTC to 2026-11-10 21:57 UTC

160* **API 計費**：您需要按顧問模型的輸入和輸出費率支付顧問代幣160* **API 計費**：您需要按顧問模型的輸入和輸出費率支付顧問代幣

161* **訂閱計畫**：顧問使用計入您計畫的使用限制，除非 Fable 顧問在 Fable 使用計費的計畫上計入[使用額度](https://code.claude.com/docs/zh-TW/model-config.md#fable-and-usage-credits)161* **訂閱計畫**：顧問使用計入您計畫的使用限制，除非 Fable 顧問在 Fable 使用計費的計畫上計入[使用額度](https://code.claude.com/docs/zh-TW/model-config.md#fable-and-usage-credits)

162 162 

163如果您的帳戶需要使用額度同意，Fable 顧問在您同意前不會計費，因為 Claude Code [在那之前不會套用選擇](#fable-advisor-and-usage-credits)。163如需了解 Fable 顧問如何搭配用量點數運作，請參閱 [Fable 顧問與用量點數](#fable-advisor-and-usage-credits)。

164 164 

165Claude 在決策點而非每個輪次都呼叫顧問，因此將更快的主要模型與更強大的顧問配對通常比全程執行更強大的模型成本更低。顧問使用計入 [`/usage`](https://code.claude.com/docs/zh-TW/costs#track-your-costs) 顯示的會話總計。165Claude 在決策點而非每個輪次都呼叫顧問，因此將更快的主要模型與更強大的顧問配對通常比全程執行更強大的模型成本更低。顧問使用計入 [`/usage`](https://code.claude.com/docs/zh-TW/costs#track-your-costs) 顯示的會話總計。

166 166 

79 )79 )

80 80 

81 async with ClaudeSDKClient(options=options) as client:81 async with ClaudeSDKClient(options=options) as client:

82 await client.query("建立一個 .env 檔案，包含標準本地開發資料庫設定")82 await client.query("Create a .env file with the standard local development database configuration")

83 async for message in client.receive_response():83 async for message in client.receive_response():

84 # 篩選助手和結果訊息84 # 篩選助手和結果訊息

85 if isinstance(message, (AssistantMessage, ResultMessage)):85 if isinstance(message, (AssistantMessage, ResultMessage)):

118};118};

119 119 

120for await (const message of query({120for await (const message of query({

121 prompt: "建立一個 .env 檔案，包含標準本地開發資料庫設定",121 prompt: "Create a .env file with the standard local development database configuration",

122 options: {122 options: {

123 hooks: {123 hooks: {

124 // 為 PreToolUse 事件註冊 hook124 // 為 PreToolUse 事件註冊 hook

247* **頂級欄位**在每個事件上被接受：`systemMessage` 向使用者顯示訊息，`continue`（Python 中的 `continue_`）決定此 hook 後 agent 是否繼續執行。某些事件會捨棄它們或將它們傳遞到其他地方。每個[事件的部分](https://code.claude.com/docs/zh-TW/hooks.md#hook-events)在 hook 頁面上說明它們的位置。247* **頂級欄位**在每個事件上被接受：`systemMessage` 向使用者顯示訊息，`continue`（Python 中的 `continue_`）決定此 hook 後 agent 是否繼續執行。某些事件會捨棄它們或將它們傳遞到其他地方。每個[事件的部分](https://code.claude.com/docs/zh-TW/hooks.md#hook-events)在 hook 頁面上說明它們的位置。

248* **`hookSpecificOutput`** 控制目前操作。內部的欄位取決於 hook 事件類型：248* **`hookSpecificOutput`** 控制目前操作。內部的欄位取決於 hook 事件類型：

249 * 對於 `PreToolUse` hook，這是您設定 `permissionDecision`（`"allow"`、`"deny"`、`"ask"` 或 `"defer"`）、`permissionDecisionReason` 和 `updatedInput` 的地方。如果您返回 `"defer"`，該回合會以一則 `stop_reason` 為 `"tool_deferred"` 的結果訊息結束，以便您可以[稍後繼續該呼叫](https://code.claude.com/docs/zh-TW/hooks.md#defer-a-tool-call-for-later)。249 * 對於 `PreToolUse` hook，這是您設定 `permissionDecision`（`"allow"`、`"deny"`、`"ask"` 或 `"defer"`）、`permissionDecisionReason` 和 `updatedInput` 的地方。如果您返回 `"defer"`，該回合會以一則 `stop_reason` 為 `"tool_deferred"` 的結果訊息結束，以便您可以[稍後繼續該呼叫](https://code.claude.com/docs/zh-TW/hooks.md#defer-a-tool-call-for-later)。

250 * 對於 `PostToolUse` hook，您可以設定 `additionalContext` 以將資訊附加到工具結果。要在 Claude 看到之前替換工具的輸出，請設定 `updatedToolOutput`，這適用於兩個 SDK 中的任何工具。較舊的 `updatedMCPToolOutput` 欄位僅替換 MCP 工具輸出。250 * 對於 `PostToolUse` hook，您可以設定 `additionalContext` 以將資訊附加到工具結果。要在 Claude 看到之前替換工具的輸出，請設定 `updatedToolOutput`，這適用於兩個 SDK 中的內建工具和 MCP 工具。較舊的 `updatedMCPToolOutput` 欄位僅替換 MCP 工具輸出。

251 * 在 TypeScript SDK 中，`PostToolUse` 回調也可以返回 `classifierContext`，這是關於工具呼叫結果的簡短說明，用於[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)權限分類器。因為您的回調在您應用程式自己的程序中執行，分類器可能會將您在說明中轉達的使用者陳述視為使用者意圖。該欄位需要 TypeScript Agent SDK v0.3.236 或更新版本。[為自動模式分類器註解結果](https://code.claude.com/docs/zh-TW/hooks.md#annotate-a-result-for-the-auto-mode-classifier)涵蓋長度上限、僅同步規則，以及不要在說明中放入的內容。251 * 在 TypeScript SDK 中，`PostToolUse` 回調也可以返回 `classifierContext`，這是關於工具呼叫結果的簡短說明，用於[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)權限分類器。因為您的回調在您應用程式自己的程序中執行，分類器可能會將您在說明中轉達的使用者陳述視為使用者意圖。該欄位需要 TypeScript Agent SDK v0.3.236 或更新版本。[為自動模式分類器註解結果](https://code.claude.com/docs/zh-TW/hooks.md#annotate-a-result-for-the-auto-mode-classifier)涵蓋長度上限、僅同步規則，以及不要在說明中放入的內容。

252 252 

253返回 `{}` 以允許操作而不進行變更。SDK 回調 hook 使用與 [Claude Code shell 命令 hook](https://code.claude.com/docs/zh-TW/hooks.md#json-output) 相同的 JSON 輸出格式，其記錄每個欄位和事件特定選項。對於 SDK 類型定義，請參閱 [TypeScript](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#synchookjsonoutput) 和 [Python](https://code.claude.com/docs/zh-TW/agent-sdk/python.md#synchookjsonoutput) SDK 參考。253返回 `{}` 以允許操作而不進行變更。SDK 回調 hook 使用與 [Claude Code shell 命令 hook](https://code.claude.com/docs/zh-TW/hooks.md#json-output) 相同的 JSON 輸出格式，其記錄每個欄位和事件特定選項。對於 SDK 類型定義，請參閱 [TypeScript](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#synchookjsonoutput) 和 [Python](https://code.claude.com/docs/zh-TW/agent-sdk/python.md#synchookjsonoutput) SDK 參考。

605 605 

606 606 

607def _send_webhook(tool_name):607def _send_webhook(tool_name):

608 """同步幫助程式，將工具使用資料 POST 到外部 webhook。"""608 """Synchronous helper that POSTs tool usage data to an external webhook."""

609 data = json.dumps(609 data = json.dumps(

610 {610 {

611 "tool": tool_name,611 "tool": tool_name,

703 703 

704 704 

705def _send_slack_notification(message):705def _send_slack_notification(message):

706 """同步幫助程式，透過傳入 webhook 將訊息傳送到 Slack。"""706 """Synchronous helper that sends a message to Slack via incoming webhook."""

707 data = json.dumps({"text": f"Agent status: {message}"}).encode()707 data = json.dumps({"text": f"Agent status: {message}"}).encode()

708 req = urllib.request.Request(708 req = urllib.request.Request(

709 "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",709 "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",

1858 1858 

1859### `TaskStartedMessage`1859### `TaskStartedMessage`

1860 1860 

1861在背景任務啟動時發出。背景任務是在主轉之外追蹤的任何內容：背景 Bash 命令、[Monitor](#monitor) 監視、透過 Agent tool 生成的子代理或遠端代理。`task_type` 欄位告訴您是哪一個。此命名與 `Task` 到 `Agent` tool 重新命名無關。1861在背景任務啟動時發出。背景任務是在主回合之外追蹤的任何內容，例如背景 Bash 命令、[Monitor](#monitor) 監視、透過 Agent 工具生成的 subagent，或遠端 agent。此命名與 `Task` 到 `Agent` 工具重新命名無關。

1862 1862 

1863```python theme={null}1863```python theme={null}

1864@dataclass1864@dataclass

1878| `uuid` | `str` | 唯一消息識別碼 |1878| `uuid` | `str` | 唯一消息識別碼 |

1879| `session_id` | `str` | session 識別碼 |1879| `session_id` | `str` | session 識別碼 |

1880| `tool_use_id` | `str \| None` | 相關聯的 tool 使用 ID |1880| `tool_use_id` | `str \| None` | 相關聯的 tool 使用 ID |

1881| `task_type` | `str \| None` | 背景任務的類型：`"local_bash"` 用於背景 Bash 和 Monitor 監視，`"local_agent"` 或 `"remote_agent"` |1881| `task_type` | `str \| None` | 背景任務的類型，例如 `"local_bash"` 用於背景 Bash 和 Monitor 監視、`"local_agent"` 用於 subagent、`"mcp_task"` 用於[背景 MCP 工具呼叫](https://code.claude.com/docs/zh-TW/mcp.md#automatic-backgrounding-of-long-tool-calls)，或 `"remote_agent"` |

1882 1882 

1883### `TaskUsage`1883### `TaskUsage`

1884 1884 

81 }81 }

82 })) {82 })) {

83 // 結果訊息包含具有驗證資料的 structured_output83 // 結果訊息包含具有驗證資料的 structured_output

84 if (message.type === "result" && message.subtype === "success" && message.structured_output) {84 if (message.type === "result" && message.subtype === "success" && !message.is_error && message.structured_output) {

85 console.log(message.structured_output);85 console.log(message.structured_output);

86 // { company_name: "Anthropic", founded_year: 2021, headquarters: "San Francisco, CA" }86 // { company_name: "Anthropic", founded_year: 2021, headquarters: "San Francisco, CA" }

87 }87 }

118 ),118 ),

119 ):119 ):

120 # 結果訊息包含具有驗證資料的 structured_output120 # 結果訊息包含具有驗證資料的 structured_output

121 if isinstance(message, ResultMessage) and message.structured_output:121 if (

122 isinstance(message, ResultMessage)

123 and not message.is_error

124 and message.structured_output

125 ):

122 print(message.structured_output)126 print(message.structured_output)

123 # {'company_name': 'Anthropic', 'founded_year': 2021, 'headquarters': 'San Francisco, CA'}127 # {'company_name': 'Anthropic', 'founded_year': 2021, 'headquarters': 'San Francisco, CA'}

124 except Exception as error:128 except Exception as error:

142import { z } from "zod";146import { z } from "zod";

143import { query } from "@anthropic-ai/claude-agent-sdk";147import { query } from "@anthropic-ai/claude-agent-sdk";

144 148 

145// 使用 Zod 定義架構149// 使用 Zod 定義 schema

146const FeaturePlan = z.object({150const FeaturePlan = z.object({

147 feature_name: z.string(),151 feature_name: z.string(),

148 summary: z.string(),152 summary: z.string(),

173 }177 }

174 }178 }

175 })) {179 })) {

176 if (message.type === "result" && message.subtype === "success" && message.structured_output) {180 if (message.type === "result" && message.subtype === "success" && !message.is_error && message.structured_output) {

177 // 驗證並獲得完全類型化的結果181 // 驗證並獲得完全類型化的結果

178 const parsed = FeaturePlan.safeParse(message.structured_output);182 const parsed = FeaturePlan.safeParse(message.structured_output);

179 if (parsed.success) {183 if (parsed.success) {

223 }227 }

224 ),228 ),

225 ):229 ):

226 if isinstance(message, ResultMessage) and message.structured_output:230 if (

231 isinstance(message, ResultMessage)

232 and not message.is_error

233 and message.structured_output

234 ):

227 # 驗證並獲得完全類型化的結果235 # 驗證並獲得完全類型化的結果

228 plan = FeaturePlan.model_validate(message.structured_output)236 plan = FeaturePlan.model_validate(message.structured_output)

229 print(f"Feature: {plan.feature_name}")237 print(f"Feature: {plan.feature_name}")

286 required: ["todos", "total_count"]294 required: ["todos", "total_count"]

287};295};

288 296 

289// 代理使用 Grep 查找 TODO，使用 Bash 獲取 git blame 資訊297// Agent 使用 Grep 查找 TODO，使用 Bash 獲取 git blame 資訊

290try {298try {

291 for await (const message of query({299 for await (const message of query({

292 prompt: "Find all TODO comments in this codebase and identify who added them",300 prompt: "Find all TODO comments in this codebase and identify who added them",

297 }305 }

298 }306 }

299 })) {307 })) {

300 if (message.type === "result" && message.subtype === "success" && message.structured_output) {308 if (message.type === "result" && message.subtype === "success" && !message.is_error && message.structured_output) {

301 const data = message.structured_output as { total_count: number; todos: Array<{ file: string; line: number; text: string; author?: string; date?: string }> };309 const data = message.structured_output as { total_count: number; todos: Array<{ file: string; line: number; text: string; author?: string; date?: string }> };

302 console.log(`Found ${data.total_count} TODOs`);310 console.log(`Found ${data.total_count} TODOs`);

303 data.todos.forEach((todo) => {311 data.todos.forEach((todo) => {

344 352 

345 353 

346async def main():354async def main():

347 # 代理使用 Grep 查找 TODO，使用 Bash 獲取 git blame 資訊355 # Agent 使用 Grep 查找 TODO，使用 Bash 獲取 git blame 資訊

348 try:356 try:

349 async for message in query(357 async for message in query(

350 prompt="Find all TODO comments in this codebase and identify who added them",358 prompt="Find all TODO comments in this codebase and identify who added them",

352 output_format={"type": "json_schema", "schema": todo_schema}360 output_format={"type": "json_schema", "schema": todo_schema}

353 ),361 ),

354 ):362 ):

355 if isinstance(message, ResultMessage) and message.structured_output:363 if (

364 isinstance(message, ResultMessage)

365 and not message.is_error

366 and message.structured_output

367 ):

356 data = message.structured_output368 data = message.structured_output

357 print(f"Found {data['total_count']} TODOs")369 print(f"Found {data['total_count']} TODOs")

358 for todo in data["todos"]:370 for todo in data["todos"]:

383 395 

384當 agent 無法生成與您的 schema 相符的有效 JSON 時，結構化輸出生成可能會失敗。這通常發生在 schema 對於任務過於複雜、任務本身不明確，或 agent 在嘗試修復驗證錯誤時達到重試限制時。它也可能在沒有任何驗證失敗的情況下發生：[模型備援](https://code.claude.com/docs/zh-TW/model-config.md#automatic-model-fallback)可以在串流中途收回已完成的輸出，如果沒有重試替換它，執行將以相同的錯誤結束。在對您的 schema 進行除錯之前，請檢查錯誤結果訊息上的 `errors` 清單以區分這兩個原因。396當 agent 無法生成與您的 schema 相符的有效 JSON 時，結構化輸出生成可能會失敗。這通常發生在 schema 對於任務過於複雜、任務本身不明確，或 agent 在嘗試修復驗證錯誤時達到重試限制時。它也可能在沒有任何驗證失敗的情況下發生：[模型備援](https://code.claude.com/docs/zh-TW/model-config.md#automatic-model-fallback)可以在串流中途收回已完成的輸出，如果沒有重試替換它，執行將以相同的錯誤結束。在對您的 schema 進行除錯之前，請檢查錯誤結果訊息上的 `errors` 清單以區分這兩個原因。

385 397 

386發生錯誤時，結果訊息有一個 `subtype` 指示出了什麼問題：398請檢查結果訊息的 `subtype`：

387 399 

388| Subtype | 含義 |400| Subtype | 含義 |

389| - | - |401| - | - |

390| `success` | 輸出已成功生成並驗證 |402| `success` | 執行結束時沒有錯誤 subtype |

391| `error_max_structured_output_retries` | 多次嘗試後沒有有效輸出存活（驗證失敗，或模型回退收回且沒有成功重試） |403| `error_max_structured_output_retries` | 多次嘗試後沒有有效輸出存活（驗證失敗，或模型回退收回且沒有成功重試） |

392 404 

393結果也可以以 `success` 的 subtype 結束，但沒有 `structured_output` 值，例如當運行完成而代理沒有生成結構化輸出時。將該情況也視為失敗。疑難排解項目[structured\_output 為 None 但結果顯示成功](https://code.claude.com/docs/zh-TW/agent-sdk/troubleshooting.md#structured_output-is-none-but-the-result-says-success)涵蓋此情況。下面的範例僅在 `subtype` 為 `success` 且 `structured_output` 存在時才將結果視為成功，並將所有其他結果作為失敗處理：405`success` subtype 本身並不代表執行已產生答案。當結果的 `is_error` 為 `true` 或缺少 `structured_output` 時，請將該結果視為失敗：

406 

407* **結果上的 `is_error` 為 `true`**：例如，最後一次模型請求以 API 錯誤或拒絕結束。請勿使用此類結果上的 `structured_output` 值。

408* **缺少 `structured_output`**：若要找出原因，請參閱[structured\_output 為 None 但結果顯示成功](https://code.claude.com/docs/zh-TW/agent-sdk/troubleshooting.md#structured_output-is-none-but-the-result-says-success)

409 

410下面的範例套用了這些檢查：

394 411 

395```typescript TypeScript theme={null}412```typescript TypeScript theme={null}

396import { query } from "@anthropic-ai/claude-agent-sdk";413import { query } from "@anthropic-ai/claude-agent-sdk";

415 }432 }

416 })) {433 })) {

417 if (msg.type === "result") {434 if (msg.type === "result") {

418 if (msg.subtype === "success" && msg.structured_output) {435 if (msg.subtype === "success" && !msg.is_error && msg.structured_output) {

419 // 使用驗證的輸出436 // 使用驗證的輸出

420 console.log(msg.structured_output);437 console.log(msg.structured_output);

421 } else if (msg.subtype === "error_max_structured_output_retries") {438 } else if (msg.subtype === "error_max_structured_output_retries") {

422 console.error("Could not produce valid output");439 console.error("Could not produce valid output");

423 } else {440 } else {

424 console.error("Run ended without a structured output");441 console.error("Run ended with an error or without a structured output");

425 }442 }

426 }443 }

427 }444 }

456 ),473 ),

457 ):474 ):

458 if isinstance(message, ResultMessage):475 if isinstance(message, ResultMessage):

459 if message.subtype == "success" and message.structured_output:476 if (

477 message.subtype == "success"

478 and not message.is_error

479 and message.structured_output

480 ):

460 # 使用驗證的輸出481 # 使用驗證的輸出

461 print(message.structured_output)482 print(message.structured_output)

462 elif message.subtype == "error_max_structured_output_retries":483 elif message.subtype == "error_max_structured_output_retries":

463 print("Could not produce valid output")484 print("Could not produce valid output")

464 else:485 else:

465 print("Run ended without a structured output")486 print("Run ended with an error or without a structured output")

466 except Exception as error:487 except Exception as error:

467 # A single-shot query() raises after yielding an error result. If the488 # A single-shot query() raises after yielding an error result. If the

468 # failure was an error result, the error subtype branches above have489 # failure was an error result, the error subtype branches above have

142 142 

143結果訊息可以以 `subtype: "success"` 結尾，而在 Python 中 `structured_output` 是 `None` 或在 TypeScript 中是 `undefined`。執行完成，但不存在驗證的輸出。143結果訊息可以以 `subtype: "success"` 結尾，而在 Python 中 `structured_output` 是 `None` 或在 TypeScript 中是 `undefined`。執行完成，但不存在驗證的輸出。

144 144 

145在應用程式程式碼中將此結果視為失敗。在使用 `structured_output` 之前，檢查 `subtype` 是 `success` 且 `structured_output` 存在。[錯誤處理](https://code.claude.com/docs/zh-TW/agent-sdk/structured-outputs.md#error-handling)部分顯示了兩個 SDK 的此模式。接著檢查以下原因：145在應用程式程式碼中將此結果視為失敗。[錯誤處理](https://code.claude.com/docs/zh-TW/agent-sdk/structured-outputs.md#error-handling)部分顯示了兩個 SDK 的此模式。接著檢查以下原因：

146 146 

147* **Claude 拒絕的請求**：若要在程式碼中偵測此情況，請檢查結果訊息的 `stop_reason` 是否為 `"refusal"`。關於接下來可嘗試的做法，請參閱 [Usage Policy 拒絕](https://code.claude.com/docs/zh-TW/errors.md#usage-policy-refusal)。147* **Claude 拒絕的請求**：若要在程式碼中偵測此情況，請檢查結果訊息的 `stop_reason` 是否為 `"refusal"`。關於接下來可嘗試的做法，請參閱 [Usage Policy 拒絕](https://code.claude.com/docs/zh-TW/errors.md#usage-policy-refusal)。

148* **沒有任何輸出能滿足的 schema**：例如，`minLength` 大於其 `maxLength` 的字串。如果在您認為正確的 schema 下 `structured_output` 反覆缺失，請尋找彼此矛盾的約束。如果找不到，請簡化 schema 直到輸出通過驗證，然後一次重新引入一個約束。148* **沒有任何輸出能滿足的 schema**：例如，`minLength` 大於其 `maxLength` 的字串。如果在您認為正確的 schema 下 `structured_output` 反覆缺失，請尋找彼此矛盾的約束。如果找不到，請簡化 schema 直到輸出通過驗證，然後一次重新引入一個約束。

1923| `extra_usage_disabled` | 帳戶的用量點數已關閉 |1923| `extra_usage_disabled` | 帳戶的用量點數已關閉 |

1924| `network_error` | [可用性檢查](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)無法連線到 `api.anthropic.com` |1924| `network_error` | [可用性檢查](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways)無法連線到 `api.anthropic.com` |

1925| `unknown` | Claude Code 無法判斷可用性 |1925| `unknown` | Claude Code 無法判斷可用性 |

1926| `not_first_party` | 工作階段使用 Anthropic API 以外的提供者 |1926| `not_first_party` | 工作階段使用的供應商不提供快速模式 |

1927| `disabled_by_env` | 已設定 [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/zh-TW/env-vars) |1927| `disabled_by_env` | 已設定 [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/zh-TW/env-vars)，或模型在 [Google Cloud's Agent Platform](https://code.claude.com/docs/zh-TW/fast-mode.md#use-fast-mode-on-agent-platform) 上的區域不提供快速模式 |

1928| `model_not_allowed` | 快速模式的 Opus 模型不在組織的 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection) 允許清單中 |1928| `model_not_allowed` | 快速模式模型不在組織的 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection) 允許清單中，或供應商拒絕為工作階段的模型提供快速模式 |

1929| `sdk_opt_in_required` | 工作階段尚未選擇加入快速模式：請在 [`settings`](#options) 選項中或透過 [`applyFlagSettings()`](#applyflagsettings) 傳遞 `fastMode: true` |1929| `sdk_opt_in_required` | 工作階段尚未選擇加入快速模式：請在 [`settings`](#options) 選項中或透過 [`applyFlagSettings()`](#applyflagsettings) 傳遞 `fastMode: true` |

1930| `pending` | 可用性檢查尚未完成 |1930| `pending` | 可用性檢查尚未完成 |

1931 1931 

2007 2007 

2008#### `startup_failure_reason`2008#### `startup_failure_reason`

2009 2009 

2010Claude Code 拒絕啟動的原因，讓您的應用程式可以提供修正方式而非重試。Claude Code 會在因已知啟動失敗而結束前寫入的 `error_during_execution` 結果上設定它。該結果攜帶歸零的總計，其 `errors` 陣列攜帶與 stderr 相同的文字。在所有其他結果上，此欄位不存在。需要 Agent SDK v0.3.274 或更新版本。2010Claude Code 拒絕啟動的原因，讓您的應用程式能提供修正方法而非重試。Claude Code 會在因已知啟動失敗而結束前所寫入的 `error_during_execution` 結果上設定它。該結果帶有歸零的總計，其 `errors` 陣列帶有失敗訊息。此欄位在其他所有結果上皆不存在。需要 Agent SDK v0.3.274 或更新版本。

2011 2011 

2012在 [`env`](#options) 中將 `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` 設定為 `1`，即可針對每個 `SDKStartupFailureReason` 值接收此結果。若未設定該變數，Claude Code 僅會針對下列失敗寫入結果，其餘失敗則以 stderr 輸出、非零結束代碼且無結果訊息的方式結束：2012在 [`env`](#options) 中將 `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` 設定為 `1`，即可針對每個 `SDKStartupFailureReason` 值接收此結果。若未設定該變數，Claude Code 僅會針對下列失敗寫入結果，其餘失敗則以 stderr 輸出、非零結束代碼且無結果訊息的方式結束：

2013 2013 

5710 5710 

5711### `SDKTaskStartedMessage`5711### `SDKTaskStartedMessage`

5712 5712 

5713在工作開始時發出。`task_type` 欄位對 Bash 命令和 [Monitor](#monitor) 監視為 `"local_bash"`，對 subagent 為 `"local_agent"`，或 `"remote_agent"`。5713在工作開始時發出。`task_type` 命名工作的種類，例如 Bash 命令和 [Monitor](#monitor) 監視為 `"local_bash"`，subagent 為 `"local_agent"`，[背景 MCP 工具呼叫](https://code.claude.com/docs/zh-TW/mcp.md#automatic-backgrounding-of-long-tool-calls)為 `"mcp_task"`，或 `"remote_agent"`。

5714 5714 

5715```typescript theme={null}5715```typescript theme={null}

5716type SDKTaskStartedMessage = {5716type SDKTaskStartedMessage = {

5919 errorCode?: "credits_required";5919 errorCode?: "credits_required";

5920 canUserPurchaseCredits?: boolean;5920 canUserPurchaseCredits?: boolean;

5921 hasChargeableSavedPaymentMethod?: boolean;5921 hasChargeableSavedPaymentMethod?: boolean;

5922 overageEnabled?: boolean;

5922 };5923 };

5923 uuid: UUID;5924 uuid: UUID;

5924 session_id: string;5925 session_id: string;

5927 5928 

5928當 `errorCode` 為 `"credits_required"` 時，拒絕來自其內含用量已耗盡的 claude.ai 訂閱，工作階段在使用者購買用量點數之前無法繼續。`canUserPurchaseCredits` 指示已驗證的使用者是否可以為帳戶購買點數，`hasChargeableSavedPaymentMethod` 指示是否已儲存付款方式。在不是需要點數之拒絕的速率限制事件上，這三個欄位都不存在。需要 Claude Code v2.1.181 或更新版本。5929當 `errorCode` 為 `"credits_required"` 時，拒絕來自其內含用量已耗盡的 claude.ai 訂閱，工作階段在使用者購買用量點數之前無法繼續。`canUserPurchaseCredits` 指示已驗證的使用者是否可以為帳戶購買點數，`hasChargeableSavedPaymentMethod` 指示是否已儲存付款方式。在不是需要點數之拒絕的速率限制事件上，這三個欄位都不存在。需要 Claude Code v2.1.181 或更新版本。

5929 5930 

5931在關於方案用量上限的警告上（即 `status` 為 `"allowed_warning"` 時），`overageEnabled` 會報告帳戶是否已開啟[用量點數](https://code.claude.com/docs/zh-TW/costs.md#add-usage-credits-to-your-subscription)。需要 Claude Code v2.1.295 或更新版本。

5932 

5930### `SDKLocalCommandOutputMessage`5933### `SDKLocalCommandOutputMessage`

5931 5934 

5932Claude Code 不發出此訊息類型。當您傳送命令（例如 `/context` 或 `/usage`）作為提示詞時，其輸出作為 [`SDKAssistantMessage`](#sdkassistantmessage) 到達。5935Claude Code 不發出此訊息類型。當您傳送命令（例如 `/context` 或 `/usage`）作為提示詞時，其輸出作為 [`SDKAssistantMessage`](#sdkassistantmessage) 到達。

647 647 

648 648 

649def parse_response(response: str, options: list) -> str:649def parse_response(response: str, options: list) -> str:

650 """將使用者輸入解析為選項編號或自由文字。"""650 """Parse user input as option number(s) or free text."""

651 try:651 try:

652 indices = [int(s.strip()) - 1 for s in response.split(",")]652 indices = [int(s.strip()) - 1 for s in response.split(",")]

653 labels = [options[i]["label"] for i in indices if 0 <= i < len(options)]653 labels = [options[i]["label"] for i in indices if 0 <= i < len(options)]

657 657 

658 658 

659async def handle_ask_user_question(input_data: dict) -> PermissionResultAllow:659async def handle_ask_user_question(input_data: dict) -> PermissionResultAllow:

660 """顯示 Claude 的問題並收集使用者答案。"""660 """Display Claude's questions and collect user answers."""

661 answers = {}661 answers = {}

662 662 

663 for q in input_data.get("questions", []):663 for q in input_data.get("questions", []):

8 8 

9> [!WARNING]9> [!WARNING]

10>10>

11> Agent teams 是實驗性功能，預設為停用。透過在 [settings.json](https://code.claude.com/docs/zh-TW/settings.md) 或環境中設定 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 來啟用。若沒有該變數，工作階段啟動時不會設定任何團隊、不會寫入團隊目錄，Claude 也不會生成或提議隊友。Agent teams 在工作階段恢復、任務協調和關閉行為方面有[已知限制](#limitations)。11> Agent teams 是實驗性功能，預設為停用。透過在 [settings.json](https://code.claude.com/docs/zh-TW/settings.md) 或環境中設定 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 來啟用。Agent teams 在工作階段恢復、任務協調和關閉行為方面有[已知限制](#limitations)。

12 12 

13Agent teams 讓您協調多個 Claude Code 實例一起工作。一個工作階段充當團隊主管，協調工作、分配任務並綜合結果。隊友獨立工作，各自在自己的 context window 中，並直接相互溝通。您也可以直接與任何隊友互動，無需透過主管。13Agent teams 讓您協調多個 Claude Code 實例一起工作。一個工作階段充當團隊主管，協調工作、分配任務並綜合結果。隊友獨立工作，各自在自己的 context window 中，並直接相互溝通。您也可以直接與任何隊友互動，無需透過主管。

14 14 

892 892 

893該命令也會在執行中的監督程序版本與您叫用的 `claude` 版本不同時發出警告，這會在監督程序尚未重新啟動到新版本的更新後發生。警告會顯示兩個版本，並告訴您執行 `claude daemon stop --any` 以採用新版本。893該命令也會在執行中的監督程序版本與您叫用的 `claude` 版本不同時發出警告，這會在監督程序尚未重新啟動到新版本的更新後發生。警告會顯示兩個版本，並告訴您執行 `claude daemon stop --any` 以採用新版本。

894 894 

895工作階段在該版本不匹配時保持完整：較舊的 Claude Code 版本更新工作階段的 `state.json` 時會保留它不識別的欄位，並保持工作階段列出。`roster.json` 中的工作階段列表遵循相同規則，因此由較新版本啟動的工作階段保持可達，並在監督程序重新啟動後繼續接受輸入。

896 

897### 關閉 agent view895### 關閉 agent view

898 896 

899要完全關閉背景 agent 和 agent view，將 `disableAgentView` [設定](https://code.claude.com/docs/zh-TW/settings.md)設為 `true` 或設定 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境變數。管理員可以透過[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)強制執行此操作。897要完全關閉背景 agent 和 agent view，將 `disableAgentView` [設定](https://code.claude.com/docs/zh-TW/settings.md)設為 `true` 或設定 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 環境變數。管理員可以透過[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)強制執行此操作。

367| `ap-*` | `apac.` |367| `ap-*` | `apac.` |

368| 所有其他區域 | `global.` |368| 所有其他區域 | `global.` |

369 369 

370設定 `ANTHROPIC_BEDROCK_REGION_PREFIX` 以選擇 Claude Code 優先嘗試的前綴；當 Claude Code 可以檢查設定檔可用性並找不到模型的相符設定檔時，它會按照下方解析順序進行回退。有效值為 `us`、`eu`、`apac`、`jp`、`au` 和 `global`。例如，當您的帳戶已啟用 `global.` 設定檔但 Claude Code 會根據您的 AWS 區域衍生出地理位置特定的設定檔時，請將其設定為 `global`。需要 Claude Code v2.1.224 或更新版本。370設定 `ANTHROPIC_BEDROCK_REGION_PREFIX` 以選擇 Claude Code 優先嘗試的前綴。有效值為 `us`、`eu`、`apac`、`jp`、`au` 和 `global`。例如，當您的帳戶已啟用 `global.` 設定檔但 Claude Code 會根據您的 AWS 區域衍生出地理位置特定的設定檔時，請將其設定為 `global`。

371 371 

372此範例透過 `global.` 設定檔路由預設模型：372此範例透過 `global.` 設定檔路由預設模型：

373 373 

64| :- | :- |64| :- | :- |

65| 工作階段處於 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) | 在每個 artifact 首次發佈前詢問 |65| 工作階段處於 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) | 在每個 artifact 首次發佈前詢問 |

66| 該發佈為頁面宣告了執行階段功能，例如[連接器呼叫](#pull-live-data-with-mcp-connectors)或[檔案下載](#offer-a-file-download) | 在該次發佈前詢問 |66| 該發佈為頁面宣告了執行階段功能，例如[連接器呼叫](#pull-live-data-with-mcp-connectors)或[檔案下載](#offer-a-file-download) | 在該次發佈前詢問 |

67| 您已公開分享該 artifact | 在每次對話中變更前詢問一次 |67| 您已公開分享該 artifact | 在每次對話中變更前詢問一次，並在每次回覆其上的留言前詢問 |

68| Claude 在由[工作階段範圍的排程任務](https://code.claude.com/docs/zh-TW/scheduled-tasks.md)於您的工作階段中觸發所啟動的回合中發佈，而非由您輸入的提示詞啟動 | 在每個 artifact 首次發佈前詢問 |68| Claude 在由[工作階段範圍的排程任務](https://code.claude.com/docs/zh-TW/scheduled-tasks.md)於您的工作階段中觸發所啟動的回合中發佈，而非由您輸入的提示詞啟動 | 在每個 artifact 首次發佈前詢問 |

69| Claude 在未經您核准的情況下無法讀取該檔案 | 在發佈前詢問。`Artifact` 工具的允許規則不會略過此提示 |69| Claude 在未經您核准的情況下無法讀取該檔案 | 在發佈前詢問。`Artifact` 工具的允許規則不會略過此提示 |

70| 在 [Manual](https://code.claude.com/docs/zh-TW/permission-modes.md) 或 `acceptEdits` 模式中，Claude 對某個 artifact 的檔案進行小幅變更，而該檔案未經您核准便無法編輯，例如 Manual 模式中的專案檔案 | 在發佈該變更前詢問。即使允許規則涵蓋 `Artifact` 工具，仍會詢問您，因為對該檔案的編輯需要您的核准 |70| 在 [Manual](https://code.claude.com/docs/zh-TW/permission-modes.md) 或 `acceptEdits` 模式中，Claude 對某個 artifact 的檔案進行小幅變更，而該檔案未經您核准便無法編輯，例如 Manual 模式中的專案檔案 | 在發佈該變更前詢問。即使允許規則涵蓋 `Artifact` 工具，仍會詢問您，因為對該檔案的編輯需要您的核准 |

89使用今天的數字更新 https://claude.ai/code/artifact/5fbea6f3-...。89使用今天的數字更新 https://claude.ai/code/artifact/5fbea6f3-...。

90```90```

91 91 

92### 關閉一步式 artifact 更新

93 

94一步式更新是 Claude 在發佈過程中對 artifact 檔案所做的小幅變更，而非透過 `Edit` 或 `Write` 呼叫進行。

95 

96若要關閉一步式更新，請將 [`CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS`](https://code.claude.com/docs/zh-TW/env-vars) 設定為 `0`。此範例將該變數新增至 `~/.claude/settings.json` 中的 `env` 區塊：

97 

98```json theme={null}

99{

100 "env": {

101 "CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS": "0"

102 }

103}

104```

105 

106接著結束並重新啟動 Claude Code，因為執行中的工作階段不會重新讀取該變數。

107 

92## 再次尋找成品108## 再次尋找成品

93 109 

94在 Claude Code 中執行 `/artifacts`，以列出您擁有的 artifact 以及與您共享的 artifact。目前工作階段的 artifact 會排在最前面，位於 **This session** 之下。110在 Claude Code 中執行 `/artifacts`，以列出您擁有的 artifact 以及與您共享的 artifact。目前工作階段的 artifact 會排在最前面，位於 **This session** 之下。

111你可以分享給誰取決於你的方案：127你可以分享給誰取決於你的方案：

112 128 

113* **在組織內**：在 Team 和 Enterprise 方案上，授予組織中特定人員或所有人的存取權。檢視者以組織成員身分登入 claude.ai 以查看該頁面。129* **在組織內**：在 Team 和 Enterprise 方案上，授予組織中特定人員或所有人的存取權。檢視者以組織成員身分登入 claude.ai 以查看該頁面。

130* **可存取共用資料夾的人員**：在 Team 和 Enterprise 方案上，將 artifact 移至您擁有或擔任編輯者的資料夾。請從 [Artifacts 頁面](https://claude.ai/artifacts)移動，若您可以使用 claude.ai 聊天功能，即可使用此頁面。之後所有可存取該資料夾的人都能開啟它，而資料夾的擁有者和編輯者可以變更它。

114* **公開**：分享一個連結，網際網路上的任何人都可以開啟，無需 claude.ai 登入。在 Team 和 Enterprise 方案上，公開分享處於關閉狀態，直到擁有者[為組織啟用它](#control-public-sharing)。131* **公開**：分享一個連結，網際網路上的任何人都可以開啟，無需 claude.ai 登入。在 Team 和 Enterprise 方案上，公開分享處於關閉狀態，直到擁有者[為組織啟用它](#control-public-sharing)。

115 132 

116### 連結到特定檢視133### 連結到特定檢視

178您的[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)決定了當發送的評論到達時 Claude 的行為：195您的[權限模式](https://code.claude.com/docs/zh-TW/permission-modes.md)決定了當發送的評論到達時 Claude 的行為：

179 196 

180* **Claude 自動回覆**：如果您處於允許 Claude 在不詢問您的情況下發佈回覆的權限模式，Claude 會讀取執行緒並回覆。您會看到 `Auto-replied to comment thread on Artifact: <name>`。197* **Claude 自動回覆**：如果您處於允許 Claude 在不詢問您的情況下發佈回覆的權限模式，Claude 會讀取執行緒並回覆。您會看到 `Auto-replied to comment thread on Artifact: <name>`。

181* **Claude 等待您**：在計畫模式外，當發佈回覆需要您的批准時，您會看到 `Comments are waiting on Artifact: <name>`。Claude 隨後會要求您批准讀取執行緒，然後再次批准發佈回覆。198* **Claude 等待您**：在 plan mode 之外，當發佈回覆[需要您的核准](#when-claude-code-asks-before-publishing)時，您會看到 `Comments are waiting on Artifact: <name>`。Claude 隨後會要求您核准讀取執行緒，然後再次要求核准發佈回覆。

182* **Claude 在計畫模式中暫停**：您會看到 `Comments are waiting on Artifact: <name>`，Claude 不會回覆，直到您離開計畫模式並要求它讀取並回覆。199* **Claude 在計畫模式中暫停**：您會看到 `Comments are waiting on Artifact: <name>`，Claude 不會回覆，直到您離開計畫模式並要求它讀取並回覆。

183 200 

184Claude 在處理該成品上的 60 個已發送評論或執行緒啟動後，也會停止自動回覆該成品。您會看到 `Comments are waiting on Artifact: <name>` 一次，當該小時的評論過期時，Claude 會重新開始。201Claude 在處理該成品上的 60 個已發送評論或執行緒啟動後，也會停止自動回覆該成品。您會看到 `Comments are waiting on Artifact: <name>` 一次，當該小時的評論過期時，Claude 會重新開始。

34* **請求**：為了讓檢查通過，閘道需原樣轉發 `anthropic-beta` 標頭和 `safeguards` 本文欄位，因為[兩者會成對傳送](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#beta-header-and-body-field-pairs)。在 [Amazon Bedrock InvokeModel 格式](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#api-formats)上，閘道需轉發 `anthropic_beta` 本文欄位以取代該標頭。34* **請求**：為了讓檢查通過，閘道需原樣轉發 `anthropic-beta` 標頭和 `safeguards` 本文欄位，因為[兩者會成對傳送](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#beta-header-and-body-field-pairs)。在 [Amazon Bedrock InvokeModel 格式](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#api-formats)上，閘道需轉發 `anthropic_beta` 本文欄位以取代該標頭。

35* **回應**：閘道在返回回應和串流事件時，不得刪除欄位或重寫工具使用 ID。為了讓檢查的結果通過，閘道需保留 `safeguard_results` 欄位。35* **回應**：閘道在返回回應和串流事件時，不得刪除欄位或重寫工具使用 ID。為了讓檢查的結果通過，閘道需保留 `safeguard_results` 欄位。

36 36 

37以這種方式通過流量的閘道可繼續與此功能和未來功能搭配運作。新工作階段隨後會再次使用伺服器的檢查。37一旦您的閘道做到這一點，新工作階段就會再次使用伺服器的檢查。

38 38 

39如果您已經知道您的閘道無法提供伺服器的檢查，請在啟動工作階段之前，在您的 shell 或 [`env` 設定金鑰](https://code.claude.com/docs/zh-TW/settings-reference#env)中將 `CLAUDE_CODE_AUTO_MODE_SERVER` 設定為 `0`，以告訴 Claude Code 不要在該處要求檢查：39如果您已經知道您的閘道無法提供伺服器的檢查，請在啟動工作階段之前，在您的 shell 或 [`env` 設定金鑰](https://code.claude.com/docs/zh-TW/settings-reference#env)中將 `CLAUDE_CODE_AUTO_MODE_SERVER` 設定為 `0`，以告訴 Claude Code 不要在該處要求檢查：

40 40 

180 180 

181Claude Code 會在背景中掃描，然後向您顯示草稿。您只能整體接受或捨棄草稿，因此之後請編輯 `~/.claude/settings.json` 來調整個別項目。當您接受時，Claude Code 會寫入草稿，並將其與您現有的設定進行協調：181Claude Code 會在背景中掃描，然後向您顯示草稿。您只能整體接受或捨棄草稿，因此之後請編輯 `~/.claude/settings.json` 來調整個別項目。當您接受時，Claude Code 會寫入草稿，並將其與您現有的設定進行協調：

182 182 

183* Claude Code 寫入的 `environment` 清單不含 `"$defaults"`，因為草稿已明確列出其未變更的內建項目183* 如果您選擇新增到 `~/.claude/settings.json` 中的 `environment` 清單，您會保留其中的任何 `"$defaults"` 項目。如果您選擇取代該清單，您會失去該項目，因此若您需要預設項目，請重新加入 `"$defaults"`

184* Claude Code 會在草稿新增項目的每個 `allow`、`soft_deny` 和 `hard_deny` 清單中包含 `"$defaults"`，除非您已經撰寫了不含它的 `allow` 清單，如此一來，您尚未取代的[內建規則](#override-the-block-and-allow-rules)仍會保持生效184* Claude Code 會在草稿新增項目的每個 `allow`、`soft_deny` 和 `hard_deny` 清單中包含 `"$defaults"`，除非您已經撰寫了不含它的 `allow` 清單，如此一來，您尚未取代的[內建規則](#override-the-block-and-allow-rules)仍會保持生效

185* 儲存後，Claude Code 會提議移除 `~/.claude/settings.json` 中自動模式會忽略的 `permissions.allow` 規則（例如 `Bash(*)`），或會自動核准破壞性命令的規則185* 儲存後，Claude Code 會提議移除 `~/.claude/settings.json` 中自動模式會忽略的 `permissions.allow` 規則（例如 `Bash(*)`），或會自動核准破壞性命令的規則

186 186 

216 216 

217三個額外的欄位讓您取代分類器的內建規則清單：217三個額外的欄位讓您取代分類器的內建規則清單：

218 218 

219* `autoMode.hard_deny`：無條件安全邊界219* `autoMode.hard_deny`：即使使用者要求也要阻止的操作

220* `autoMode.soft_deny`：使用者意圖可以清除的破壞性操作220* `autoMode.soft_deny`：使用者意圖可以清除的破壞性操作

221* `autoMode.allow`：軟阻止規則的例外221* `autoMode.allow`：軟阻止規則的例外

222 222 

231 231 

232一般請求不算作明確意圖。要求 Claude「清理儲存庫」不授權強制推送，但要求 Claude「強制推送此分支」則授權。232一般請求不算作明確意圖。要求 Claude「清理儲存庫」不授權強制推送，但要求 Claude「強制推送此分支」則授權。

233 233 

234要放寬，當分類器重複標記預設例外不涵蓋的常規模式時，新增到 `allow`。要加強，對於預設值遺漏的特定於您環境的破壞性風險，新增到 `soft_deny`，或對於必須永遠不能跨越的安全邊界，新增到 `hard_deny`。234要放寬，當分類器反覆標示預設例外不涵蓋的例行模式時，新增到 `allow`。要加強，對於預設值遺漏的特定於您環境的破壞性風險，新增到 `soft_deny`，或對於即使使用者要求也要阻止的操作，新增到 `hard_deny`。

235 235 

236要保留內建規則同時新增您自己的規則，請在陣列中包含字面字串 `"$defaults"`。預設規則會在該位置拼接，因此您的自訂規則可以在它們之前或之後，並且當內建清單在版本發佈中變更時，您繼續繼承更新。236要保留內建規則同時新增您自己的規則，請在陣列中包含字面字串 `"$defaults"`。預設規則會在該位置拼接，因此您的自訂規則可以在它們之前或之後，並且當內建清單在版本發佈中變更時，您繼續繼承更新。

237 237 

252 "soft_deny": [252 "soft_deny": [

253 "$defaults",253 "$defaults",

254 "Never run database migrations outside the migrations CLI, even against dev databases",254 "Never run database migrations outside the migrations CLI, even against dev databases",

255 "Never modify files under infra/terraform/prod/: production infrastructure changes go through the review workflow"255 "Running terraform apply in infra/terraform/prod/ needs an explicit request: production infrastructure changes go through the review workflow"

256 ],256 ],

257 "hard_deny": [257 "hard_deny": [

258 "$defaults",258 "$defaults",

763. 您對應到該上游 ID 的 [`models[].id`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#models) 的清單價格，適用於不包含模型名稱的上游字串，例如 Amazon Bedrock 應用程式推論設定檔 ARN 或 Microsoft Foundry 部署名稱。需要 v2.1.218 或更新版本。763. 您對應到該上游 ID 的 [`models[].id`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#models) 的清單價格，適用於不包含模型名稱的上游字串，例如 Amazon Bedrock 應用程式推論設定檔 ARN 或 Microsoft Foundry 部署名稱。需要 v2.1.218 或更新版本。

774. 未知模型層級，每百萬輸入/輸出令牌 \$5/\$25，因此計量器無法識別的 ID 永遠不會免費。閘道在啟動時和執行時每個 ID 一次警告當它使用此層級時。774. 未知模型層級，每百萬輸入/輸出令牌 \$5/\$25，因此計量器無法識別的 ID 永遠不會免費。閘道在啟動時和執行時每個 ID 一次警告當它使用此層級時。

78 78 

79無論適用哪個費率，計量器隨後將金額乘以 [`pricing.multiplier`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#pricing)，預設值為 `1`。79無論適用哪個費率，計量器隨後將金額乘以 [`pricing.multiplier`](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config#pricing)，預設值為 `1`。需要執行 Claude Code v2.1.227 或更新版本的閘道伺服器。

80 80 

81用戶端中止也會被計費。當串流在沒有上游最終使用量框架的情況下結束時，計量器會計費約每輸出令牌四個字元的下限估計，用於已傳送給用戶端的文字，因此提前中止請求不會規避上限。81用戶端中止也會被計費。當串流在沒有上游最終使用量框架的情況下結束時，計量器會計費約每輸出令牌四個字元的下限估計，用於已傳送給用戶端的文字，因此提前中止請求不會規避上限。

82 82 

205* **使用 `/teleport`**：在現有 CLI 工作階段內執行 `/teleport` 或 `/tp` 以開啟相同的工作階段選擇器，無需重新啟動 Claude Code。205* **使用 `/teleport`**：在現有 CLI 工作階段內執行 `/teleport` 或 `/tp` 以開啟相同的工作階段選擇器，無需重新啟動 Claude Code。

206* **從 `/tasks`**：執行 `/tasks` 以查看您的背景工作階段，然後按 `t` 以 teleport 進入其中一個。206* **從 `/tasks`**：執行 `/tasks` 以查看您的背景工作階段，然後按 `t` 以 teleport 進入其中一個。

207* **從 claude.ai/code**：從工作階段功能表選擇 **Open in > Terminal** 以複製可以貼到您的終端機的命令。207* **從 claude.ai/code**：從工作階段功能表選擇 **Open in > Terminal** 以複製可以貼到您的終端機的命令。

208* **從雲端工作階段內**：輸入 `/teleport`，Claude Code 會回覆確切的 `claude --teleport <session-id>` 命令，準備從儲存庫的簽出執行。需要工作階段環境中的 Claude Code v2.1.223 或更新版本。208* **從雲端工作階段內**：輸入 `/teleport`，Claude Code 會回覆該工作階段確切的 `claude --teleport <session-id>` 命令，可直接從儲存庫的簽出執行。

209 209 

210當您 teleport 工作階段時，Claude 會驗證您在正確的儲存庫中，擷取並簽出雲端工作階段的分支，並將對話載入您的終端機。210當您 teleport 工作階段時，Claude 會驗證您在正確的儲存庫中，擷取並簽出雲端工作階段的分支，並將對話載入您的終端機。

211 211 

499* **儲存庫驗證**：您只能在驗證到相同帳戶時將雲端工作階段拉入您的終端機499* **儲存庫驗證**：您只能在驗證到相同帳戶時將雲端工作階段拉入您的終端機

500* **平台限制**：在 Anthropic 託管環境中複製儲存庫以及建立 pull request 需要 GitHub。自託管 [GitHub Enterprise Server](https://code.claude.com/docs/zh-TW/github-enterprise-server.md) 執行個體支援 Team 和 Enterprise 計畫。您可以透過設定 `CCR_FORCE_BUNDLE=1`，將 GitLab、Bitbucket 或其他非 GitHub 儲存庫作為[本機捆綁](#send-local-repositories-without-github)發送到雲端工作階段，但工作階段無法將結果推送回該遠端500* **平台限制**：在 Anthropic 託管環境中複製儲存庫以及建立 pull request 需要 GitHub。自託管 [GitHub Enterprise Server](https://code.claude.com/docs/zh-TW/github-enterprise-server.md) 執行個體支援 Team 和 Enterprise 計畫。您可以透過設定 `CCR_FORCE_BUNDLE=1`，將 GitLab、Bitbucket 或其他非 GitHub 儲存庫作為[本機捆綁](#send-local-repositories-without-github)發送到雲端工作階段，但工作階段無法將結果推送回該遠端

501 * **自託管環境**：若儲存庫位於其他 git 主機上，請參閱[使用 `--environment` 啟動工作階段的需求](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy#start-a-session-on-a-repository-outside-github)。501 * **自託管環境**：若儲存庫位於其他 git 主機上，請參閱[使用 `--environment` 啟動工作階段的需求](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy#start-a-session-on-a-repository-outside-github)。

502* **組織 IP 允許清單**：雲端工作階段從 Anthropic 管理的基礎設施而不是您的網路呼叫 Anthropic API，而[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments)中的工作階段從您自己的網路呼叫它。如果您的組織啟用了 [IP 允許清單](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)，每個 Anthropic 託管的雲端工作階段都會失敗，出現身分驗證錯誤。

503 * **Code Review 和排程任務**：這同樣適用於 [Code Review](https://code.claude.com/docs/zh-TW/code-review.md)，以及在 Anthropic 託管環境中執行的[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)。路由到自託管環境的排程任務會從您自己的網路呼叫 API。

504 * **取得豁免**：聯絡 [Anthropic 支援](https://support.claude.com/)，以從您組織的 IP 允許清單中豁免 Anthropic 託管的服務。

505 502 

506## 相關資源503## 相關資源

507 504 

142`sessions/` 中的工作階段檔案、自動記憶和 Claude Desktop 及 Cowork 文字記錄各自遵循自己的保留規則：142`sessions/` 中的工作階段檔案、自動記憶和 Claude Desktop 及 Cowork 文字記錄各自遵循自己的保留規則：

143 143 

144* **`sessions/`**：為每個執行中的工作階段保存一個小檔案，用於偵測並行工作階段和崩潰。它不是基於年齡的掃描的一部分：Claude Code 在其工作階段退出時移除每個檔案，並在下次啟動時清除崩潰遺留物。144* **`sessions/`**：為每個執行中的工作階段保存一個小檔案，用於偵測並行工作階段和崩潰。它不是基於年齡的掃描的一部分：Claude Code 在其工作階段退出時移除每個檔案，並在下次啟動時清除崩潰遺留物。

145* **`seed-admin/`**：Claude Code 在為 [ultrareview](https://code.claude.com/docs/zh-TW/ultrareview.md) 或[雲端工作階段上傳](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#send-local-repositories-without-github)打包您的儲存庫時建立的暫用 git 目錄。當上傳結束時，或若上傳被中斷則在之後的工作階段中，Claude Code 會移除該次上傳的目錄，並保留 `seed-admin/` 本身。

145* **自動記憶**：掃描不會刪除專案 [自動記憶](https://code.claude.com/docs/zh-TW/memory.md#auto-memory) 目錄 `projects/<project>/memory/` 中的記憶檔案。Claude Code 只有在整個保留期間該目錄一直為空時才會移除它。在 v2.1.228 之前，掃描將記憶目錄內的資料夾視為工作階段資料，可能會刪除其下的舊檔案。146* **自動記憶**：掃描不會刪除專案 [自動記憶](https://code.claude.com/docs/zh-TW/memory.md#auto-memory) 目錄 `projects/<project>/memory/` 中的記憶檔案。Claude Code 只有在整個保留期間該目錄一直為空時才會移除它。在 v2.1.228 之前，掃描將記憶目錄內的資料夾視為工作階段資料，可能會刪除其下的舊檔案。

146* **Claude Desktop 和 Cowork 逐字稿**：對於您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段，Claude Code 會保留其逐字稿，無論年齡如何。若要為這些逐字稿設定年齡限制，請設定 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/zh-TW/settings-reference#desktopsessioncleanupperioddays)。需要 Claude Code v2.1.248 或更新版本；較早版本會在 `cleanupPeriodDays` 後刪除它們。147* **Claude Desktop 和 Cowork 逐字稿**：對於您在 Claude Desktop 或 Cowork 中啟動或最近繼續的工作階段，Claude Code 會保留其逐字稿，無論年齡如何。若要為這些逐字稿設定年齡限制，請設定 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/zh-TW/settings-reference#desktopsessioncleanupperioddays)。需要 Claude Code v2.1.248 或更新版本；較早版本會在 `cleanupPeriodDays` 後刪除它們。

147 148 

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

154 155 

155* **裸機模式**：當你使用 [`--bare`](https://code.claude.com/docs/zh-TW/headless#start-faster-with-bare-mode) 執行 `claude -p` 時，Claude Code 不會在該工作階段中執行掃描。156* **裸機模式**：當你使用 [`--bare`](https://code.claude.com/docs/zh-TW/headless#start-faster-with-bare-mode) 執行 `claude -p` 時，Claude Code 不會在該工作階段中執行掃描。

156* **暫停掃描**：如果 Claude Code 無法安全地確定保留期間，它會暫停保留清理掃描；[`retention_sweep` 事件](https://code.claude.com/docs/zh-TW/monitoring-usage#retention-sweep-event) 列出每個暫停它的設定。當原因是無法讀取或解析的設定檔案，或 `cleanupPeriodDays` 或 `desktopSessionCleanupPeriodDays` 明確設定的設定錯誤時，Claude Code 也會在 `/status` 中顯示警告，直到你修復設定錯誤。當 [受管設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md) 提供 `cleanupPeriodDays` 時，Claude Code 在任一情況下都會以受管值執行掃描。157* **暫停掃描**：如果 Claude Code 無法安全地確定保留期間，它會暫停掃描；[`retention_sweep` 事件](https://code.claude.com/docs/zh-TW/monitoring-usage#retention-sweep-event)列出每個會使其暫停的設定。當原因是無法讀取或解析的設定檔，或在設定了 `cleanupPeriodDays` 或 `desktopSessionCleanupPeriodDays` 的情況下出現設定錯誤時，`/status` 會顯示警告，直到您修正該原因。

158 

159當[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)提供 `cleanupPeriodDays` 時，即使較低優先順序的設定檔有錯誤，Claude Code 也會以受管值執行掃描。

157 160 

158若要確認您組織中的機器是以您設定的保留期間執行掃描，請參閱[檢查保留掃描](https://code.claude.com/docs/zh-TW/monitoring-usage.md#check-the-retention-sweep)。161若要確認您組織中的機器是以您設定的保留期間執行掃描，請參閱[檢查保留掃描](https://code.claude.com/docs/zh-TW/monitoring-usage.md#check-the-retention-sweep)。

159 162 

20 20 

21* **將工作發送到一個地方**：每當出現時，將錯誤報告、堆疊追蹤或任務清單貼到對話中。Claude 為每個工作片段啟動一個執行緒，或將其傳遞給已在該區域工作的執行緒，並就地回答快速問題。21* **將工作發送到一個地方**：每當出現時，將錯誤報告、堆疊追蹤或任務清單貼到對話中。Claude 為每個工作片段啟動一個執行緒，或將其傳遞給已在該區域工作的執行緒，並就地回答快速問題。

22* **設定一次背景資訊**：每個新執行緒都以專案的指示開始，因此您陳述一次的規則（例如要針對的分支）會到達所有執行緒。22* **設定一次背景資訊**：每個新執行緒都以專案的指示開始，因此您陳述一次的規則（例如要針對的分支）會到達所有執行緒。

23* **離開並返回已完成的工作**：當您一小時後或第二天早上回來時，**Overview** 窗格會顯示哪些執行緒已完成、哪些提取請求已準備好供審查，以及哪個執行緒正在等待您的答案。23* **離開並返回已完成的工作**：Overview 窗格會顯示哪些執行緒已完成、哪些 pull request 已準備好供審查，以及哪個執行緒正在等待您的答案。

24 24 

25如果您已經知道希望專案執行的工作，請直接前往 [建立專案](#create-a-project)。25如果您已經知道希望專案執行的工作，請直接前往 [建立專案](#create-a-project)。

26 26 

28 28 

29當工作有一個超越單個工作階段的目標並持續產生任務時，創建 project 是值得的。這些類型的工作非常適合 project：29當工作有一個超越單個工作階段的目標並持續產生任務時，創建 project 是值得的。這些類型的工作非常適合 project：

30 30 

31* **跨多個儲存庫的一個目標**："將每個服務升級到新的 lint 配置。" Claude 可以為每個儲存庫執行一個執行緒，每個都有自己的提取請求，[**Overview** 窗格](#see-what-needs-you-in-overview) 會顯示哪些已準備好供審查。31* **跨多個儲存庫的一個目標**：「將每個服務升級到新的 lint 設定。」Claude 可以為每個儲存庫執行一個執行緒，每個都有自己的 pull request，[Overview 窗格](#see-what-needs-you-in-overview) 會顯示哪些已準備好供審查。

32* **您持續提供的區域**：一個服務的錯誤、堆疊追蹤和審查請求，在到達您時貼到對話中。您告訴 Claude 在一個修復後要記住的陷阱在 [project 記憶](#give-a-project-standing-context) 中供下一個使用。32* **您持續提供的區域**：一個服務的錯誤、堆疊追蹤和審查請求，在到達您時貼到對話中。您告訴 Claude 在一個修復後要記住的陷阱在 [project 記憶](#give-a-project-standing-context) 中供下一個使用。

33* **比工作階段更大的構建或遷移**："構建 `docs/spec.md` 描述的內容"或"將應用程式從已棄用的 ORM 移出。" 工作分成執行緒，每個執行緒處理一部分，您要求 Claude 早期記住的決定會到達後來的執行緒，您在構建期間發現的規格變更和錯誤進入相同的對話。33* **比工作階段更大的構建或遷移**："構建 `docs/spec.md` 描述的內容"或"將應用程式從已棄用的 ORM 移出。" 工作分成執行緒，每個執行緒處理一部分，您要求 Claude 早期記住的決定會到達後來的執行緒，您在構建期間發現的規格變更和錯誤進入相同的對話。

34* **不是程式碼的工作**：一個合約資料夾或支援票證匯出，您不斷回來提出新問題，例如"在這些票證中找到十個最常見的整合錯誤。" 上傳文件而不是添加儲存庫，執行緒會在 project 的 [**Library** 標籤](#see-what-needs-you-in-overview) 上將每個寫作作為檔案提供。34* **不是程式碼的工作**：一個合約資料夾或支援票證匯出，您不斷回來提出新問題，例如「在這些票證中找到十個最常見的整合錯誤。」上傳文件而不是新增儲存庫，執行緒會將每份報告作為檔案交付到 project 的 [**Library**](#see-what-needs-you-in-overview) 中。

35 35 

36在任何一種情況下，您都可以發送一批任務，告訴 Claude 在不要求您確認的情況下開始，然後離開。當您回來時，可以在 [**Waiting on you**](#see-what-needs-you-in-overview) 下找到需要您的執行緒。您也可以要求 Claude 將部分工作放在時間表上，作為 [雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)。如果這是您的情況，[建立 project](#create-a-project)。36在任何一種情況下，您都可以發送一批任務，告訴 Claude 在不要求您確認的情況下開始，然後離開。當您回來時，可以在 [**Waiting on you**](#see-what-needs-you-in-overview) 下找到需要您的執行緒。您也可以要求 Claude 將部分工作放在時間表上，作為 [雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)。如果這是您的情況，[建立 project](#create-a-project)。

37 37 

57 * [project 每個儲存庫](#what-threads-pick-up-from-your-repositories) 中的 `CLAUDE.md`，但不包括這些儲存庫的 skill、`.claude/settings.json` 或 `.mcp.json`57 * [project 每個儲存庫](#what-threads-pick-up-from-your-repositories) 中的 `CLAUDE.md`，但不包括這些儲存庫的 skill、`.claude/settings.json` 或 `.mcp.json`

58 * 您 claude.ai 帳戶上的 [連接器](#get-skills-plugins-connectors-and-tools-into-threads)58 * 您 claude.ai 帳戶上的 [連接器](#get-skills-plugins-connectors-and-tools-into-threads)

59 * 一個 [雲端環境](#choose-an-environment-for-threads)，設定其網路存取、環境變數、網路密鑰和已安裝的工具59 * 一個 [雲端環境](#choose-an-environment-for-threads)，設定其網路存取、環境變數、網路密鑰和已安裝的工具

60* **Overview 窗格**：您在其中 [一次看到所有執行緒](#see-what-needs-you-in-overview) 以及其中哪些需要您。其他標籤是 **Library** 用於您添加的檔案和執行緒產生的檔案，**Pull requests** 用於執行緒開啟的 pull request，**Scheduled tasks** 用於 project 中的排程工作。60* **Overview 窗格**：您在其中 [一次看到所有執行緒](#see-what-needs-you-in-overview) 以及其中哪些需要您。

61 61 

62雲端執行緒不會從您自己機器上的 Claude Code 設定中選擇任何內容。[將 skills、plugins、connectors 和工具放入執行緒](#get-skills-plugins-connectors-and-tools-into-threads) 涵蓋了如何給予它們否則會缺少的內容。62雲端執行緒不會從您自己機器上的 Claude Code 設定中選擇任何內容。[將 skills、plugins、connectors 和工具放入執行緒](#get-skills-plugins-connectors-and-tools-into-threads) 涵蓋了如何給予它們否則會缺少的內容。

63 63 

64以下是這些部分如何連接的方式，從您通過對話到執行工作的執行緒，**Overview** 跟蹤其狀態：64以下是這些部分如何連接的方式，從您通過對話到執行工作的執行緒，Overview 跟蹤其狀態：

65 65 

66![Project 的圖表。您在 project 對話中寫入，Claude 回答或啟動執行緒。每個雲端執行緒在自己的分支和提取請求上工作。Overview 窗格按狀態列出執行緒，例如準備好供審查、等待您和工作中。](https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview.svg?fit=max\&auto=format\&n=e8CLbxM17eD7cAiv\&q=85\&s=dbf446f69f0bbdb9961d21af207cb93b)66![Project 的圖表。您在 project 對話中寫入，Claude 回答或啟動執行緒。每個雲端執行緒在自己的分支和提取請求上工作。Overview 窗格按狀態列出執行緒，例如準備好供審查、等待您和工作中。](https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview.svg?fit=max\&auto=format\&n=e8CLbxM17eD7cAiv\&q=85\&s=dbf446f69f0bbdb9961d21af207cb93b)

67 67 

96 96 

97* **Name**：專案在 **Projects** 清單中顯示的名稱。97* **Name**：專案在 **Projects** 清單中顯示的名稱。

98* **What do you want to work on?**（選填）：一行文字，會成為專案的目標，例如「將 p95 API 延遲維持在 200 ms 以下」。對話中的 Claude 會朝此目標努力。如果沒有目標，Claude 會依據您傳送的任務工作，您之後也可以在 **Project settings > General** 中新增目標。98* **What do you want to work on?**（選填）：一行文字，會成為專案的目標，例如「將 p95 API 延遲維持在 200 ms 以下」。對話中的 Claude 會朝此目標努力。如果沒有目標，Claude 會依據您傳送的任務工作，您之後也可以在 **Project settings > General** 中新增目標。

99* **Context**（選填）：此專案處理的 GitHub 儲存庫，以及執行緒應讀取的任何檔案、資料夾或 Google Drive 資料夾。每一項都請點選 **Add** 來新增。請新增大多數任務需要的儲存庫，而不是工作可能涉及的每一個儲存庫；[決定要新增哪些儲存庫](#decide-which-repositories-to-add)說明了如何選擇，您之後也可以在 **Project settings > Environment** 中新增更多儲存庫。99* **Context**（選填）：此專案處理的 GitHub 儲存庫，以及執行緒應讀取的任何檔案、資料夾或 Google Drive 資料夾。每一項都請點選 **+** 來新增。請新增大多數任務需要的儲存庫，而不是工作可能涉及的每一個儲存庫；[決定要新增哪些儲存庫](#decide-which-repositories-to-add)說明了如何選擇，您之後也可以在 **Project settings > Environment** 中新增更多儲存庫。

100 100 

101關於執行緒應如何工作的長期規則，請放在[專案指示](#give-a-project-standing-context)中，您可以在專案建立後設定。101關於執行緒應如何工作的長期規則，請放在[專案指示](#give-a-project-standing-context)中，您可以在專案建立後設定。

102 102 

109* 如果專案有可讀取的儲存庫，啟動一個執行緒來探索該儲存庫（不做任何變更），並提出後續步驟建議。109* 如果專案有可讀取的儲存庫，啟動一個執行緒來探索該儲存庫（不做任何變更），並提出後續步驟建議。

110* 根據您最近的雲端工作階段發布 **Setup recommendations**：要新增的儲存庫、要建立的排程任務，以及它可以啟動的執行緒。每個建議的儲存庫和排程任務一開始都是開啟狀態。請關閉您不想要的項目，然後點選 **Update setup** 新增其餘項目，或忽略這些建議並自行描述工作。110* 根據您最近的雲端工作階段發布 **Setup recommendations**：要新增的儲存庫、要建立的排程任務，以及它可以啟動的執行緒。每個建議的儲存庫和排程任務一開始都是開啟狀態。請關閉您不想要的項目，然後點選 **Update setup** 新增其餘項目，或忽略這些建議並自行描述工作。

111 111 

112專案現在會列在側邊欄的 **Projects** 之下，且其對話已開啟。[您的第一批工作](#your-first-batch)說明了在傳送工作之前需要設定的項目。112專案現在會顯示在側邊欄中，且其對話已開啟。[您的第一批工作](#your-first-batch)說明了在傳送工作之前需要設定的項目。

113 113 

114### 從現有的工作階段開始114### 從現有的工作階段開始

115 115 

168 168 

169如果 Claude 路由的內容與您想要的不同，請說出來。[調整 Claude 執行 project 的方式](#tune-how-claude-runs-a-project) 列出了您可以告訴它的內容，例如為後續工作重用現有執行緒或就地回答而不是啟動執行緒。169如果 Claude 路由的內容與您想要的不同，請說出來。[調整 Claude 執行 project 的方式](#tune-how-claude-runs-a-project) 列出了您可以告訴它的內容，例如為後續工作重用現有執行緒或就地回答而不是啟動執行緒。

170 170 

171執行緒的完整結果保留在執行緒中，您打開對話中的卡片來讀取它們。執行緒產生的檔案也在 **Overview** 中的 **Library** 標籤上。171執行緒的完整結果保留在執行緒中，您可以開啟對話中的卡片來讀取。執行緒產生的檔案也會出現在 project 的 [**Library**](#see-what-needs-you-in-overview) 中。

172 172 

173有時 Claude 在 **Suggested threads** 清單中提議執行緒而不是啟動它們。點擊建議上的箭頭啟動該執行緒。當列出多個時，清單下的按鈕啟動所有這些。173有時 Claude 在 **Suggested threads** 清單中提議執行緒而不是啟動它們。點擊建議上的箭頭啟動該執行緒。當列出多個時，清單下的按鈕啟動所有這些。

174 174 

190 190 

191### 在 Overview 中查看需要您的內容191### 在 Overview 中查看需要您的內容

192 192 

193**Overview** 窗格在對話旁邊跟蹤 project 的執行緒。它在您第一次打開新 project 時已經打開。project 標題中的 **Overview** 按鈕關閉並重新打開它，並在執行緒等待您時顯示一個點。193對話旁的 Overview 窗格會追蹤 project 的執行緒。第一次開啟新 project 時，它就已經是開啟狀態。關閉後若要重新開啟，請點擊 project 標題中的 **Threads** 按鈕。當有執行緒在等待您時，該按鈕會顯示一個點。

194 194 

195在桌面應用程式中，當 Claude 在對話中發佈、執行緒遇到錯誤或執行緒需要您的輸入時，您還會收到桌面通知，因此您不必保持 project 打開來找出。要在每次執行緒完成一個回合時也收到一個，或為 project 關閉它們，請在 project 的側邊欄功能表中選擇 **Notifications**。這些通知僅限桌面：在瀏覽器中，檢查 **Overview** 按鈕上的點。195在桌面應用程式中，預設會在 Claude 於對話中發佈訊息、執行緒發生錯誤或執行緒需要您的輸入時顯示通知。當您正在檢視該 project 時則不會顯示。若要在每次執行緒完成一個回合時也收到通知，或要為某個 project 關閉通知，請在 project 的側邊欄選單中選擇 **Notifications**。在瀏覽器中，請查看 **Threads** 按鈕上的點。

196 196 

197窗格的 **Threads** 標籤按狀態對執行緒進行分組：197窗格的 **Threads** 檢視會依狀態將執行緒分組：

198 198 

199| 群組 | 其中的內容 |199| 群組 | 其中的內容 |

200| :- | :- |200| :- | :- |

205| **Idle** | 已完成且不等待任何內容的執行緒 |205| **Idle** | 已完成且不等待任何內容的執行緒 |

206| **Resolved** | 標記為完成的執行緒：由您從執行緒的功能表中，由 Claude 在您採取最後一步後（例如合併其提取請求），或在一週無活動後自動。您可以從相同功能表重新打開一個 |206| **Resolved** | 標記為完成的執行緒：由您從執行緒的功能表中，由 Claude 在您採取最後一步後（例如合併其提取請求），或在一週無活動後自動。您可以從相同功能表重新打開一個 |

207 207 

208窗格的其他標籤是：208從 project 標題可在窗格中開啟 project 的檔案和排程任務：

209 209 

210* **Library**：您新增的檔案和資料夾，以及執行緒產生的檔案210* **Library**：您新增的檔案和資料夾，以及執行緒產生的檔案。點擊 **Threads** 旁邊的 **Library** 按鈕。

211* **Pull requests**：在執行緒打開任何 pull request 後顯示211* **Scheduled tasks**：Claude 從此 project 設定的[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)。在標題的 **⋯** 選單中選擇它。

212* **Scheduled tasks**：Claude 從此 project 設定的[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)

213 212 

214### 當您需要控制時打開執行緒213### 當您需要控制時打開執行緒

215 214 

216點擊對話中執行緒的卡片或 **Overview** 中的其行，在 Overview 窗格中打開其記錄。從那裡您可以：215點擊對話中執行緒的卡片或 Overview 中該執行緒的列，即可在 Overview 窗格中開啟其逐字稿。您可以在那裡：

217 216 

218* 逐步讀取 Claude 所做的內容。217* 逐步讀取 Claude 所做的內容。

219* 通過在執行緒自己的訊息框中寫入來引導任務。那裡的訊息直接進入該執行緒，而 project 對話中的後續工作只有在 Claude 將後續工作與該執行緒匹配時才會到達它。218* 通過在執行緒自己的訊息框中寫入來引導任務。那裡的訊息直接進入該執行緒，而 project 對話中的後續工作只有在 Claude 將後續工作與該執行緒匹配時才會到達它。

290| :- | :- | :- |289| :- | :- | :- |

291| 專案記憶 | Claude 保留的關於專案的筆記，例如需求、決策和陷阱，儲存為檔案。每個雲端執行緒在啟動時讀取索引檔案 `MEMORY.md`，並在需要時開啟其他檔案 | 在專案對話或任何雲端執行緒中要求 Claude 記住一項需求、決策或陷阱，或忘記一項。在**專案設定 > 記憶**中讀取、編輯和刪除檔案 |290| 專案記憶 | Claude 保留的關於專案的筆記，例如需求、決策和陷阱，儲存為檔案。每個雲端執行緒在啟動時讀取索引檔案 `MEMORY.md`，並在需要時開啟其他檔案 | 在專案對話或任何雲端執行緒中要求 Claude 記住一項需求、決策或陷阱，或忘記一項。在**專案設定 > 記憶**中讀取、編輯和刪除檔案 |

292| 專案指示 | 傳送到每個新執行緒和專案對話中的 Claude 的文字，最多 16,000 個字元。[寫入專案指示](#write-project-instructions)涵蓋要在其中放入的內容 | **專案設定 > 記憶 > 專案指示**，或要求 Claude 變更指示 |291| 專案指示 | 傳送到每個新執行緒和專案對話中的 Claude 的文字，最多 16,000 個字元。[寫入專案指示](#write-project-instructions)涵蓋要在其中放入的內容 | **專案設定 > 記憶 > 專案指示**，或要求 Claude 變更指示 |

293| 儲存庫、檔案和環境 | 每個雲端執行緒複製的儲存庫、每個執行緒可以在 `/mnt/project-files` 下讀取的資料夾和檔案，以及執行緒執行所在的雲端環境 | 儲存庫和環境在**專案設定 > 環境**中，或在對話中要求 Claude 將儲存庫新增到專案。[檔案和資料夾](#add-files-and-folders)來自**概覽**中**程式庫**標籤上的**新增** |292| 儲存庫、檔案和環境 | 每個雲端執行緒複製的儲存庫、它可以在 `/mnt/project-files` 下讀取的資料夾和檔案，以及它執行所在的雲端環境 | 儲存庫和環境在**專案設定 > 環境**中，或在對話中要求 Claude 將儲存庫新增到專案。[檔案和資料夾](#add-files-and-folders)透過專案[**程式庫**](#see-what-needs-you-in-overview)中的**新增** |

294 293 

295**專案設定 > 記憶**在**自動記憶**下列出這些檔案，因為 Claude 在專案中工作時自己寫入它們。它們與 Claude Code 在您的機器上保留的[自動記憶](https://code.claude.com/docs/zh-TW/memory.md)分開，儘管兩者都使用 `MEMORY.md` 索引。專案記憶也與專案儲存庫中的 `CLAUDE.md` 檔案分開。每個雲端執行緒在啟動時仍然從其複製讀取這些 `CLAUDE.md` 檔案，因此將關於儲存庫的指示放在其 `CLAUDE.md` 中，將關於專案的筆記放在專案記憶中。294**專案設定 > 記憶**在**自動記憶**下列出這些檔案，因為 Claude 在專案中工作時自己寫入它們。它們與 Claude Code 在您的機器上保留的[自動記憶](https://code.claude.com/docs/zh-TW/memory.md)分開，儘管兩者都使用 `MEMORY.md` 索引。專案記憶也與專案儲存庫中的 `CLAUDE.md` 檔案分開。每個雲端執行緒在啟動時仍然從其複製讀取這些 `CLAUDE.md` 檔案，因此將關於儲存庫的指示放在其 `CLAUDE.md` 中，將關於專案的筆記放在專案記憶中。

296 295 

297### 寫入專案指示296### 寫入專案指示

298 297 

299專案指示是每個新執行緒開始的簡報。按一下專案標題中的齒輪圖示以開啟**專案設定**，然後前往**記憶 > 專案指示**。有用的簡報涵蓋：298專案指示是每個新執行緒開始的簡報。在專案標題的 **⋯** 功能表中選擇**設定**以開啟**專案設定**，然後前往**記憶 > 專案指示**。有用的簡報涵蓋：

300 299 

301* 專案的用途300* 專案的用途

302* 工作發生的位置：哪些儲存庫、從哪個分支開始、如何命名提取請求301* 工作發生的位置：哪些儲存庫、從哪個分支開始、如何命名提取請求

307例如：306例如：

308 307 

309```text theme={null}308```text theme={null}

310此專案將付款 API 的 p95 延遲保持在 200 毫秒以下：分析、查詢和快取修復，以及隨之而來的相依套件升級，在 payments-api 儲存庫中。309This project holds p95 latency for the payments API under 200 ms: profiling, query and caching fixes, and the dependency upgrades that come with them, in the payments-api repository.

311 310 

312- 從 main 分支建立分支，每個執行緒開啟一個草稿 pull request。311- Branch from main and open one draft pull request per thread.

313- 在您完成工作前，執行 `make test` 和 `make lint`，並在最終訊息中貼上摘要行。312- Before you call work done, run `make test` and `make lint` and paste the summary lines in your final message.

314- 如果您無法到達所需的東西，例如儲存庫、祕密、API 或連接器，請在第一條訊息中確切說明遺失的內容並停止。不要替代、模擬或猜測。313- If you can't reach something you need, such as a repository, a secret, an API, or a connector, say exactly what's missing in your first message and stop. Don't substitute, mock, or guess.

315- 不要在沒有在執行緒中詢問我的情況下合併、強制推送或變更 CI 設定。314- Don't merge, force-push, or change CI configuration without asking me in the thread.

316```315```

317 316 

318關於一個儲存庫的規則，例如其建置命令，屬於該儲存庫的 `CLAUDE.md`，每個雲端執行緒在儲存庫是專案的一部分時讀取。一旦工作開始，當您更正執行緒時，也要告訴 Claude 記住更正：它進入[專案記憶](#give-a-project-standing-context)，稍後的雲端執行緒開始時會有它。317關於一個儲存庫的規則，例如其建置命令，屬於該儲存庫的 `CLAUDE.md`，每個雲端執行緒在儲存庫是專案的一部分時讀取。一旦工作開始，當您更正執行緒時，也要告訴 Claude 記住更正：它進入[專案記憶](#give-a-project-standing-context)，稍後的雲端執行緒開始時會有它。

324* **將其新增到專案**，在**新專案**對話方塊中、在**專案設定 > 環境**中，或透過在對話中要求 Claude 將其新增到專案。從那時起，每個雲端執行緒都會複製它，並在啟動時載入其 `CLAUDE.md`，無論任務是否涉及它。323* **將其新增到專案**，在**新專案**對話方塊中、在**專案設定 > 環境**中，或透過在對話中要求 Claude 將其新增到專案。從那時起，每個雲端執行緒都會複製它，並在啟動時載入其 `CLAUDE.md`，無論任務是否涉及它。

325* **不要新增它，讓執行緒在需要時自行新增。** 其任務需要專案沒有的儲存庫的雲端執行緒可以將其新增到自己，執行緒中的筆記表示它僅被新增到此執行緒。複製發生在任務進行中途，因此該儲存庫的 `CLAUDE.md` 在執行緒啟動時不存在。下一個執行緒啟動時沒有它。以這種方式新增的儲存庫需要與專案儲存庫相同的[先決條件](#check-the-prerequisites)：在其上安裝的 Claude GitHub App 和來自您的 GitHub 帳戶的推送存取。324* **不要新增它，讓執行緒在需要時自行新增。** 其任務需要專案沒有的儲存庫的雲端執行緒可以將其新增到自己，執行緒中的筆記表示它僅被新增到此執行緒。複製發生在任務進行中途，因此該儲存庫的 `CLAUDE.md` 在執行緒啟動時不存在。下一個執行緒啟動時沒有它。以這種方式新增的儲存庫需要與專案儲存庫相同的[先決條件](#check-the-prerequisites)：在其上安裝的 Claude GitHub App 和來自您的 GitHub 帳戶的推送存取。

326 325 

327專案根本不需要儲存庫。其雲端執行緒仍然可以進行研究、寫入文件，以及在自己的沙箱中寫入和執行程式碼，並將檔案傳遞到**程式庫**標籤。那裡的任何雲端執行緒也可以在任務需要時將儲存庫新增到自己。326專案根本不需要儲存庫。其雲端執行緒仍然可以進行研究、寫入文件，以及在自己的沙箱中寫入和執行程式碼。它們會將檔案傳遞到專案的**程式庫**。其任何雲端執行緒仍然可以在任務需要時將儲存庫新增到自己。

328 327 

329一旦專案有了儲存庫，Claude 只能從專案已經使用的 GitHub 擁有者新增儲存庫，無論它是將其新增到專案還是執行緒將其新增到自己。要引入來自不同擁有者的儲存庫，請在**專案設定 > 環境**中自己新增它。328一旦專案有了儲存庫，Claude 只能從專案已經使用的 GitHub 擁有者新增儲存庫，無論它是將其新增到專案還是執行緒將其新增到自己。要引入來自不同擁有者的儲存庫，請在**專案設定 > 環境**中自己新增它。

330 329 

332 331 

333### 新增檔案和資料夾332### 新增檔案和資料夾

334 333 

335在**新專案**對話的**背景**欄位中新增您想要執行緒讀取的檔案和資料夾，或之後使用**概覽**中**程式庫**標籤上的**新增**。這些限制適用於您新增的內容：334在**新專案**對話方塊的**背景**欄位中新增您想要執行緒讀取的檔案和資料夾，或之後使用專案[**程式庫**](#see-what-needs-you-in-overview)中的**新增**。這些限制適用於您新增的內容：

336 335 

337* **程式庫標籤**：一次最多 100 個檔案和 2 GB，單個檔案最多 480 MB。336* **您在 claude.ai/code 或桌面應用程式中上傳的檔案**：一次最多 1,000 個檔案和 2 GB，單個檔案最多 480 MB。

338* **新專案對話**：超過 30 MB 的檔案會被跳過，因此在建立專案後從**程式庫**標籤新增較大的檔案。337* **您上傳的資料夾**：隱藏檔案和 `node_modules` 不會被新增。專案最多可以保存 10 個資料夾和 Google Drive 資料夾的組合，單個檔案不計入該限制。

339* **資料夾**：當您從任一位置新增資料夾時，專案會收到其前 100 個檔案的副本，最多 200 MB，不包括任何超過 30 MB 的檔案、隱藏檔案或 `node_modules`。專案最多可以保存 10 個資料夾和 Google Drive 資料夾的組合，單個檔案不計入該限制。

340* **上傳後的變更**：上傳是副本，因此您之後在電腦上進行的變更不會到達專案，直到您再次上傳檔案並在詢問現有名稱時選擇**取代**。338* **上傳後的變更**：上傳是副本，因此您之後在電腦上進行的變更不會到達專案，直到您再次上傳檔案並在詢問現有名稱時選擇**取代**。

341 339 

342### 執行緒從您的儲存庫中取得什麼340### 執行緒從您的儲存庫中取得什麼

373 371 

374## Project 設定參考372## Project 設定參考

375 373 

376您在 claude.ai/code 或桌面應用程式中更改 project 設定，而不是在 `settings.json` 中。從 project 側邊欄功能表中的 **Settings** 或 project 標題中的齒輪圖示打開 **Project settings**。374您在 claude.ai/code 或桌面應用程式中更改 project 設定，而不是在 `settings.json` 中。從 project 側邊欄功能表中的 **Settings** 或 project 標題中的 **⋯** 功能表打開 **Project settings**。

377 375 

378設定在您更改時保存；您正在編輯的文本欄位，例如目標或指示，顯示 **Save changes** 和 **Discard**，直到您離開它。對指示、儲存庫、plugins 和 **Project settings** 中環境的更改到達新執行緒，而不是已在執行的執行緒。376設定在您更改時保存；您正在編輯的文本欄位，例如目標或指示，顯示 **Save changes** 和 **Discard**，直到您離開它。對指示、儲存庫、plugins 和 **Project settings** 中環境的更改到達新執行緒，而不是已在執行的執行緒。

379 377 

434 432 

435 Projects 適用於 Pro、Max 和 Ultra。project 只屬於您：您是唯一能傳送工作給它或查看其執行緒的人，它使用您自己的 GitHub 存取權限和連接器。[Claude Tag 與 Cowork 和 Claude Code 的不同之處](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) 有並排比較。433 Projects 適用於 Pro、Max 和 Ultra。project 只屬於您：您是唯一能傳送工作給它或查看其執行緒的人，它使用您自己的 GitHub 存取權限和連接器。[Claude Tag 與 Cowork 和 Claude Code 的不同之處](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) 有並排比較。

436* **雲端工作階段**：每個執行緒是一個 [雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)，除非您要求 Claude 在您的機器上執行它。無論哪種方式，Claude 啟動並追蹤它而不是您。您也可以將自己啟動的雲端工作階段的工作帶入 project：在該工作階段的側邊欄選單中選擇 [**Continue in project**](#start-from-an-existing-cloud-session)。434* **雲端工作階段**：每個執行緒是一個 [雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)，除非您要求 Claude 在您的機器上執行它。無論哪種方式，Claude 啟動並追蹤它而不是您。您也可以將自己啟動的雲端工作階段的工作帶入 project：在該工作階段的側邊欄選單中選擇 [**Continue in project**](#start-from-an-existing-cloud-session)。

437* **排程任務**：當您在 project 中要求排程工作時，Claude 會建立一個[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)，在該 project 中作為執行緒執行，並出現在其 **Scheduled tasks** 標籤上。您在 project 外建立的排程任務會繼續獨立運作。435* **排程任務**：當您在 project 中要求排程工作時，Claude 會建立一個[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)，在該 project 中作為執行緒執行，並出現在其 **Scheduled tasks** 檢視中。您在 project 外建立的排程任務會繼續獨立運作。

438* **Remote Control**：[Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 連接 claude.ai 到在您機器上執行的 Claude Code 工作階段。當您在 project 中要求 Claude 在您的電腦上執行執行緒時，project [使用 Remote Control 來執行它](#run-a-thread-on-your-own-computer)。436* **Remote Control**：[Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 連接 claude.ai 到在您機器上執行的 Claude Code 工作階段。當您在 project 中要求 Claude 在您的電腦上執行執行緒時，project [使用 Remote Control 來執行它](#run-a-thread-on-your-own-computer)。

439* **本機工作階段和 agent 檢視**：您在終端機、IDE 或桌面應用程式的本機環境中自行啟動的工作階段不會屬於您的 projects，不過您可以[將其工作帶入某個 project](#start-from-an-existing-cloud-session)。[Agent 檢視](https://code.claude.com/docs/zh-TW/agent-view.md) 是用於並排追蹤多個本機工作階段的畫面，您仍然自己啟動每個工作階段並給它其任務。437* **本機工作階段和 agent 檢視**：您在終端機、IDE 或桌面應用程式的本機環境中自行啟動的工作階段不會屬於您的 projects，不過您可以[將其工作帶入某個 project](#start-from-an-existing-cloud-session)。[Agent 檢視](https://code.claude.com/docs/zh-TW/agent-view.md) 是用於並排追蹤多個本機工作階段的畫面，您仍然自己啟動每個工作階段並給它其任務。

440* **Worktrees**：[worktree](https://code.claude.com/docs/zh-TW/worktrees.md) 給每個本機工作階段其自己的儲存庫工作副本。雲端執行緒不需要它們：每個執行緒將其儲存庫克隆到其自己的雲端沙箱中，並在自己的分支上工作。438* **Worktrees**：[worktree](https://code.claude.com/docs/zh-TW/worktrees.md) 給每個本機工作階段其自己的儲存庫工作副本。雲端執行緒不需要它們：每個執行緒將其儲存庫克隆到其自己的雲端沙箱中，並在自己的分支上工作。

466當多個執行緒回來假設了錯誤的內容、解決了缺失的存取或停止了「被阻止」，原因通常是 project 設定中的相同間隙，而不是每個任務的問題。在修復任何內容之前排序哪些執行緒是健全的：464當多個執行緒回來假設了錯誤的內容、解決了缺失的存取或停止了「被阻止」，原因通常是 project 設定中的相同間隙，而不是每個任務的問題。在修復任何內容之前排序哪些執行緒是健全的：

467 465 

4681. 在對話中要求 Claude：「對於每個打開的執行緒，列出您要求它做什麼、它假設或無法到達的內容，以及它正在等待什麼。」Claude 讀取每個執行緒並在對話中回答。4661. 在對話中要求 Claude：「對於每個打開的執行緒，列出您要求它做什麼、它假設或無法到達的內容，以及它正在等待什麼。」Claude 讀取每個執行緒並在對話中回答。

4692. 對於從錯誤假設開始的執行緒，從 **Overview** 打開執行緒並從其功能表標記為已解決，或在其訊息框中告訴它改為做什麼。其分支和任何提取請求保留在 GitHub 上，直到您刪除它們。4672. 對於從錯誤假設開始的執行緒，從 Overview 打開執行緒並從其功能表標記為已解決，或告訴它改為做什麼。其分支和任何 pull request 保留在 GitHub 上，直到您刪除它們。

4703. 在 [project 指示](#give-a-project-standing-context) 或 [環境](#choose-an-environment-for-threads) 中修復間隙一次，然後在再次發送其餘工作作為新執行緒之前發送一個執行緒。4683. 在 [project 指示](#give-a-project-standing-context) 或 [環境](#choose-an-environment-for-threads) 中修復間隙一次，然後在再次發送其餘工作作為新執行緒之前發送一個執行緒。

471 469 

472### Claude 還沒有回應470### Claude 還沒有回應

71 71 

72**2. 選擇要掃描的內容**72**2. 選擇要掃描的內容**

73 73 

74外掛程式首先讀取您的儲存庫，然後提供整個儲存庫或聚焦區域，每個選項都說明檔案計數和相對成本。選擇整個儲存庫，或回答「我不知道」，外掛程式會為您的儲存庫大小選擇合理的預設值。74外掛程式首先讀取您的儲存庫，然後提供整個儲存庫或聚焦區域。選擇整個儲存庫，或回答「我不知道」，外掛程式會為您的儲存庫大小選擇合理的預設值。

75 75 

76**3. 確認執行**76**3. 確認執行**

77 77 

78掃描可能需要一段時間，可能使用大量令牌，並需要 Claude Code 在完成時保持開啟。在您確認之前，不會執行任何操作。78掃描可能需要一段時間，可能使用大量 token，並需要 Claude Code 在完成時保持開啟。在您確認之前，不會執行任何操作。

79 79 

80**4. 讀取報告**80**4. 讀取報告**

81 81 

82掃描執行時，它會在每個階段開始時報告，詳細資訊可在 [`/workflows`](https://code.claude.com/docs/zh-TW/workflows) 下取得。結果進入您儲存庫中的時間戳記目錄，如[讀取掃描結果](#read-the-scan-results)中所述。82掃描執行時，它會在每個階段開始時報告，詳細資訊可在 [`/workflows`](https://code.claude.com/docs/zh-TW/workflows) 下取得。結果會寫入您儲存庫中的時間戳記目錄，如[讀取掃描結果](#read-the-scan-results)中所述。

83 83 

84**5. 將發現轉換為修補程式**84**5. 將發現轉換為修補程式**

85 85 

86再次執行 `/claude-security` 並選擇 **Suggest patches**，然後選擇要解決的發現。已檢查的修補程式進入報告的 `patches/` 資料夾；[修復發現](#fix-findings)涵蓋每個修補程式的建立和檢查方式。86再次執行 `/claude-security` 並選擇 **Suggest patches**，然後選擇要解決的發現。已檢查的修補程式會寫入報告的 `patches/` 資料夾；[修復發現](#fix-findings)涵蓋每個修補程式的建立和檢查方式。

87 87 

88**6. 應用您接受的修補程式**88**6. 應用您接受的修補程式**

89 89 

95 95 

96當您的分支有其基礎沒有的提交時，`/claude-security` 功能表會提供僅掃描該差異的選項，以便您可以在合併前檢查分支。您也可以掃描您的一個開啟 pull request，或通過要求它來掃描單一提交，例如「scan commit abc1234」。僅掃描已提交的變更：首先提交或 stash 進行中的編輯，或執行完整掃描，它會讀取工作樹。96當您的分支有其基礎沒有的提交時，`/claude-security` 功能表會提供僅掃描該差異的選項，以便您可以在合併前檢查分支。您也可以掃描您的一個開啟 pull request，或通過要求它來掃描單一提交，例如「scan commit abc1234」。僅掃描已提交的變更：首先提交或 stash 進行中的編輯，或執行完整掃描，它會讀取工作樹。

97 97 

98變更掃描需要 git 儲存庫；未版本控制目錄的完整掃描仍然有效。尋找您的開啟 pull request 是唯一到達網路的步驟，僅當您的工作階段已有權限執行 GitHub CLI 且 `gh` 已登入時才提供。98變更掃描需要 git 儲存庫；未版本控制目錄的完整掃描仍然有效。僅當您的工作階段已有權限執行 GitHub CLI 且 `gh` 已登入時，才會提供尋找您開啟的 pull request 的選項。

99 99 

100### 限制大型儲存庫的範圍100### 限制大型儲存庫的範圍

101 101 

120* **`CLAUDE-SECURITY-RESULTS.md`**：報告，包含每項發現的 ID，例如 `F1`，加上其影響、利用情景、嚴重性、信心和建議120* **`CLAUDE-SECURITY-RESULTS.md`**：報告，包含每項發現的 ID，例如 `F1`，加上其影響、利用情景、嚴重性、信心和建議

121* **`CLAUDE-SECURITY-RESULTS.jsonl`**：相同的發現以機器可讀形式，每行一個 JSON 物件121* **`CLAUDE-SECURITY-RESULTS.jsonl`**：相同的發現以機器可讀形式，每行一個 JSON 物件

122* **`CLAUDE-SECURITY-RESULTS.sarif`**：相同的發現作為 [SARIF 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) 日誌，用於 GitHub 程式碼掃描和任何其他讀取標準的工具。掃描將發現分類在其 [CWE](https://cwe.mitre.org/) 弱點類別下122* **`CLAUDE-SECURITY-RESULTS.sarif`**：相同的發現作為 [SARIF 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) 日誌，用於 GitHub 程式碼掃描和任何其他讀取標準的工具。掃描將發現分類在其 [CWE](https://cwe.mitre.org/) 弱點類別下

123* **`CLAUDE-SECURITY-REVISION-<commit>.json`**：修訂戳記，記錄掃描了哪個提交、使用何種[掃描強度](#choose-a-scan-effort)、未提交的變更是否是掃描樹的一部分，以及執行的驗證程度如何，因此報告始終與其描述的程式碼相關聯。版本控制外的掃描在提交位置戳記 `UNVERSIONED`123* **`CLAUDE-SECURITY-REVISION-<commit>.json`**：修訂戳記，記錄掃描了哪個提交、使用何種[掃描強度](#choose-a-scan-effort)、未提交的變更是否是掃描樹的一部分，以及執行的驗證程度如何。版本控制外的掃描在提交位置戳記 `UNVERSIONED`

124 124 

125該目錄是掃描對您簽出的唯一變更，它帶有自己的 `.gitignore`，因此隨意的 `git add` 永遠不會將報告掃入提交。若要在歷史記錄中保留報告以進行稽核追蹤，刪除該一個 `.gitignore` 檔案並像任何其他檔案一樣提交目錄。125該目錄是掃描對您簽出的唯一變更，它帶有自己的 `.gitignore`，因此隨意的 `git add` 永遠不會將報告掃入提交。若要在歷史記錄中保留報告以進行稽核追蹤，刪除該一個 `.gitignore` 檔案並像任何其他檔案一樣提交目錄。

126 126 

127發現僅在獨立驗證代理分析它們後才出現在報告中，這使報告簡短且值得閱讀。掃描是非確定性的：同一程式碼的兩次掃描可能會發現不同的發現。定期執行掃描，並使用修訂戳記將每份報告歸因於它涵蓋的確切程式碼和設定。127發現僅在獨立驗證 agent 分析它們後才出現在報告中，這使報告簡短且值得閱讀。掃描是非確定性的：同一程式碼的兩次掃描可能會發現不同的發現。定期執行掃描。

128 128 

129## 修復發現129## 修復發現

130 130 

102* **角色**：在所有方案上，無論您的角色為何，都可以在自己的環境上新增和刪除機密。在 Team 和 Enterprise 上，擁有者在您的 claude.ai 組織中持有組織管理員角色，管理員則沒有，這會改變您在以下情況中看到的內容：102* **角色**：在所有方案上，無論您的角色為何，都可以在自己的環境上新增和刪除機密。在 Team 和 Enterprise 上，擁有者在您的 claude.ai 組織中持有組織管理員角色，管理員則沒有，這會改變您在以下情況中看到的內容：

103 * **您自己的環境**：若沒有組織管理員角色，**新增機密**會開啟[較簡短的表單](#add-a-secret-without-the-role)103 * **您自己的環境**：若沒有組織管理員角色，**新增機密**會開啟[較簡短的表單](#add-a-secret-without-the-role)

104 * **共用環境**：擁有者從管理設定[新增和刪除其機密](#add-a-credential)。若沒有組織管理員角色，請擁有者新增機密，因為該環境的對話框沒有**網路機密**區段104 * **共用環境**：擁有者從管理設定[新增和刪除其機密](#add-a-credential)。若沒有組織管理員角色，請擁有者新增機密，因為該環境的對話框沒有**網路機密**區段

105* **環境類型**：已存在的 Anthropic 託管雲端環境。[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments)沒有網路機密105* **環境類型**：Anthropic 託管的雲端環境。[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments)沒有網路機密

106* **API 可達性**：API 接受來自網際網路的連線，因為請求來自 Anthropic 的網路106* **API 可達性**：API 接受來自網際網路的連線，因為請求來自 Anthropic 的網路

107* **加密金鑰**：如果您的組織使用客戶管理的加密金鑰，您無法儲存網路機密107* **加密金鑰**：如果您的組織使用客戶管理的加密金鑰，您無法儲存網路機密

108 108 

14>14>

15> 若要在 GitHub 上自動審查儲存庫中的每個 pull request，請參閱 [Code Review](https://code.claude.com/docs/zh-TW/code-review.md)，這是由 Owner 為您的組織啟用的託管服務。15> 若要在 GitHub 上自動審查儲存庫中的每個 pull request，請參閱 [Code Review](https://code.claude.com/docs/zh-TW/code-review.md)，這是由 Owner 為您的組織啟用的託管服務。

16 16 

17`/review` 是 `/code-review` 的別名。在 v2.1.223 之前，`/review` 是一個獨立的命令，會對 GitHub pull request 執行單次、唯讀的審查。17`/review` 是 `/code-review` 的別名。

18 18 

19**1. 執行 /code-review**19**1. 執行 /code-review**

20 20 

91* **`ultra`**：審查既不使用也不更新記住的等級91* **`ultra`**：審查既不使用也不更新記住的等級

92* **從未輸入過等級**：審查會使用工作階段目前的 effort92* **從未輸入過等級**：審查會使用工作階段目前的 effort

93 93 

94在 v2.1.223 之前，未指定等級的 `/code-review` 一律使用工作階段目前的 effort。

95 

96### 將發現的問題張貼到 GitLab merge request94### 將發現的問題張貼到 GitLab merge request

97 95 

98當您為 GitLab merge request 傳入 `--comment` 時，Claude Code 會透過 GitLab 的 `glab` CLI 張貼發現的問題。需要 Claude Code v2.1.257 或更新版本。若未安裝 `glab`，Claude 會改為在終端機中印出發現的問題。96當您為 GitLab merge request 傳入 `--comment` 時，Claude Code 會透過 GitLab 的 `glab` CLI 張貼發現的問題。需要 Claude Code v2.1.257 或更新版本。若未安裝 `glab`，Claude 會改為在終端機中印出發現的問題。

104| `/install-github-app` | 為儲存庫安裝 Claude GitHub App，可選步驟設定 [GitHub Actions](https://code.claude.com/docs/zh-TW/github-actions.md) 工作流程和機密。逐步解說您選擇儲存庫和設定整合。僅適用於 github.com 儲存庫。當您的儲存庫的 git 遠端在 gitlab.com 或 bitbucket.org 上時，命令會列印通知並退出而不是啟動設定。要從 GitLab 管道運行 Claude Code，請參閱 [GitLab CI/CD](https://code.claude.com/docs/zh-TW/gitlab-ci-cd.md) |104| `/install-github-app` | 為儲存庫安裝 Claude GitHub App，可選步驟設定 [GitHub Actions](https://code.claude.com/docs/zh-TW/github-actions.md) 工作流程和機密。逐步解說您選擇儲存庫和設定整合。僅適用於 github.com 儲存庫。當您的儲存庫的 git 遠端在 gitlab.com 或 bitbucket.org 上時，命令會列印通知並退出而不是啟動設定。要從 GitLab 管道運行 Claude Code，請參閱 [GitLab CI/CD](https://code.claude.com/docs/zh-TW/gitlab-ci-cd.md) |

105| `/install-slack-app` | 安裝 Claude Slack 應用程式。打開瀏覽器以完成 OAuth 流程 |105| `/install-slack-app` | 安裝 Claude Slack 應用程式。打開瀏覽器以完成 OAuth 流程 |

106| `/keybindings` | 打開您的[鍵盤快捷鍵](https://code.claude.com/docs/zh-TW/keybindings.md)檔案 |106| `/keybindings` | 打開您的[鍵盤快捷鍵](https://code.claude.com/docs/zh-TW/keybindings.md)檔案 |

107| `/list-agents` | 列出 Claude 可以傳送訊息的 subagent、[agent team](https://code.claude.com/docs/zh-TW/agent-teams.md) 隊員和其他 Claude Code 工作階段，以及每個要使用的名稱。請參閱[跨工作階段訊息](https://code.claude.com/docs/zh-TW/cross-session-messaging.md)。也可用作 `/peers`。需要 Claude Code v2.1.224 或更新版本；較早版本報告 `Unknown command: /list-agents`。隊員行和顯示此工作階段自己名稱的第一行需要 v2.1.239 或更新版本。僅在[啟用跨工作階段訊息](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#availability)的工作階段中可用 |107| `/list-agents` | 列出 Claude 可以傳送訊息的 subagent、[agent team](https://code.claude.com/docs/zh-TW/agent-teams.md) 隊員和其他 Claude Code 工作階段，以及每個要使用的名稱。請參閱[跨工作階段訊息](https://code.claude.com/docs/zh-TW/cross-session-messaging.md)。也可用作 `/peers`。隊員行和顯示此工作階段自己名稱的第一行需要 v2.1.239 或更新版本。僅在[啟用跨工作階段訊息](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#availability)的工作階段中可用 |

108| `/login` | 登入您的 Anthropic 帳戶 |108| `/login` | 登入您的 Anthropic 帳戶 |

109| `/logout` | 登出您的 Anthropic 帳戶 |109| `/logout` | 登出您的 Anthropic 帳戶 |

110| `/loop [interval] [prompt]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 在工作階段保持打開時重複運行提示詞。省略間隔，Claude [自行調整迭代之間的步調](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#let-claude-choose-the-interval)。省略提示詞，Claude 運行[內建維護提示詞](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#run-the-built-in-maintenance-prompt)或您的 [`loop.md`](https://code.claude.com/docs/zh-TW/scheduled-tasks#customize-the-default-prompt-with-loop-md)。範例：`/loop 5m check if the deploy finished`。請參閱[按排程運行提示詞](https://code.claude.com/docs/zh-TW/scheduled-tasks.md)。別名：`/proactive` |110| `/loop [interval] [prompt]` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 在工作階段保持打開時重複運行提示詞。省略間隔，Claude [自行調整迭代之間的步調](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#let-claude-choose-the-interval)。省略提示詞，Claude 運行[內建維護提示詞](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#run-the-built-in-maintenance-prompt)或您的 [`loop.md`](https://code.claude.com/docs/zh-TW/scheduled-tasks#customize-the-default-prompt-with-loop-md)。範例：`/loop 5m check if the deploy finished`。請參閱[按排程運行提示詞](https://code.claude.com/docs/zh-TW/scheduled-tasks.md)。別名：`/proactive` |

132| `/rename [name]` | 重新命名目前工作階段並在提示詞欄上顯示名稱。沒有名稱時，從對話歷史記錄自動生成一個。也可在非互動模式 (`-p`) 中使用。從每個重新命名的使用介面，包括 claude.ai 和桌面應用程式，Claude Code 會用空格替換新名稱中的控制和不可見字元，並將名稱上限設為 200 個字元。如果移除不可見字元後名稱為空，Claude Code 會拒絕它並顯示 `That name is empty once invisible characters are removed. Usage: /rename <name>`。字元替換和長度上限需要 Claude Code v2.1.221 或更新版本 |132| `/rename [name]` | 重新命名目前工作階段並在提示詞欄上顯示名稱。沒有名稱時，從對話歷史記錄自動生成一個。也可在非互動模式 (`-p`) 中使用。從每個重新命名的使用介面，包括 claude.ai 和桌面應用程式，Claude Code 會用空格替換新名稱中的控制和不可見字元，並將名稱上限設為 200 個字元。如果移除不可見字元後名稱為空，Claude Code 會拒絕它並顯示 `That name is empty once invisible characters are removed. Usage: /rename <name>`。字元替換和長度上限需要 Claude Code v2.1.221 或更新版本 |

133| `/restart` | 重新啟動 Claude Code 並恢復此工作階段，以應用已安裝的更新。當更新安裝後頁尾提供此選項時運行它。需要 Pro、Max 或 Ultra 方案，以及在 macOS 或 Linux（非 WSL）上的原生安裝。需要 Claude Code v2.1.288 或更新版本。別名：`/update` |133| `/restart` | 重新啟動 Claude Code 並恢復此工作階段，以應用已安裝的更新。當更新安裝後頁尾提供此選項時運行它。需要 Pro、Max 或 Ultra 方案，以及在 macOS 或 Linux（非 WSL）上的原生安裝。需要 Claude Code v2.1.288 或更新版本。別名：`/update` |

134| `/resume [session]` | 按 ID 或名稱恢復對話，或打開工作階段選擇器。[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)在選擇器中以 `bg` 標記出現。恢復仍在運行的工作階段時，無論是從選擇器或按 ID 或名稱，都會[打開該工作階段](https://code.claude.com/docs/zh-TW/sessions.md#resume-a-running-background-session)：您目前的對話會移到背景，此終端機會附加到運行中的工作階段。在空提示詞上按 `←` 可返回 agent view，其中也會列出您離開的對話。在 v2.1.285 之前，Claude Code 會拒絕，並告訴您使用 `claude attach` 打開該工作階段或先停止它。別名：`/continue` |134| `/resume [session]` | 按 ID 或名稱恢復對話，或打開工作階段選擇器。[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)在選擇器中以 `bg` 標記出現。恢復仍在運行的工作階段時，無論是從選擇器或按 ID 或名稱，都會[打開該工作階段](https://code.claude.com/docs/zh-TW/sessions.md#resume-a-running-background-session)：您目前的對話會移到背景，此終端機會附加到運行中的工作階段。在空提示詞上按 `←` 可返回 agent view，其中也會列出您離開的對話。在 v2.1.285 之前，Claude Code 會拒絕，並告訴您使用 `claude attach` 打開該工作階段或先停止它。別名：`/continue` |

135| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | [`/code-review`](https://code.claude.com/docs/zh-TW/code-review-local) 的別名：檢查目前差異或您傳遞的 PR 編號、分支或路徑，例如 `/review 1234`，並採用相同的 effort 等級和旗標。沒有給定等級時，檢查重複使用您最後輸入的 `low` 到 `max` 等級；有關確切規則，請參閱[使用 `/code-review` 在本地檢查](https://code.claude.com/docs/zh-TW/code-review-local)。對於深度雲端檢查，使用 [`/code-review ultra`](https://code.claude.com/docs/zh-TW/ultrareview)。在 v2.1.223 之前，`/review` 是一個單獨的命令，按編號對 GitHub pull request 進行單次通過、唯讀檢查，在運行時不帶引數時列出打開的 PR 以選擇；從 v2.1.186 到 v2.1.201，它運行與 `/code-review medium` 相同的多 agent 引擎 |135| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | [`/code-review`](https://code.claude.com/docs/zh-TW/code-review-local) 的別名：檢查目前差異或您傳遞的 PR 編號、分支或路徑，例如 `/review 1234`，並採用相同的 effort 等級和旗標。沒有給定等級時，檢查重複使用您最後輸入的 `low` 到 `max` 等級；有關確切規則，請參閱[使用 `/code-review` 在本地檢查](https://code.claude.com/docs/zh-TW/code-review-local)。對於深度雲端檢查，使用 [`/code-review ultra`](https://code.claude.com/docs/zh-TW/ultrareview) |

136| `/rewind` | 倒帶對話和/或程式碼到上一個點，或從選定的訊息進行摘要。請參閱[檢查點功能](https://code.claude.com/docs/zh-TW/checkpointing.md)。別名：`/checkpoint`、`/undo` |136| `/rewind` | 倒帶對話和/或程式碼到上一個點，或從選定的訊息進行摘要。請參閱[檢查點功能](https://code.claude.com/docs/zh-TW/checkpointing.md)。別名：`/checkpoint`、`/undo` |

137| `/run` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 啟動並驅動您的專案應用程式以查看變更實際運作，而不僅僅是通過測試。請參閱[運行和驗證您的應用程式](https://code.claude.com/docs/zh-TW/skills.md#run-and-verify-your-app) |137| `/run` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 啟動並驅動您的專案應用程式以查看變更實際運作，而不僅僅是通過測試。請參閱[運行和驗證您的應用程式](https://code.claude.com/docs/zh-TW/skills.md#run-and-verify-your-app) |

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

236 * 執行 `/usage-credits` 以請求超過額度的使用量，如果您已啟用[使用額度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)。236 * 執行 `/usage-credits` 以請求超過額度的使用量，如果您已啟用[使用額度](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)。

237 * 在 Claude Code v2.1.234 或更新版本上，[在重設後自動等待並繼續中斷的任務](https://code.claude.com/docs/zh-TW/interactive-mode.md#wait-for-a-usage-limit-to-reset)；該部分列出 Claude Code 何時自行開始等待以及開發人員何時從 `/rate-limit-options` 選擇它。若要控制您的機隊 Claude Code 是否自行開始該等待，請在[受管設定](https://code.claude.com/docs/zh-TW/settings.md#settings-precedence)中設定 [`autoContinueAtUsageLimit`](https://code.claude.com/docs/zh-TW/settings-reference#autocontinueatusagelimit)。237 * 在 Claude Code v2.1.234 或更新版本上，[在重設後自動等待並繼續中斷的任務](https://code.claude.com/docs/zh-TW/interactive-mode.md#wait-for-a-usage-limit-to-reset)；該部分列出 Claude Code 何時自行開始等待以及開發人員何時從 `/rate-limit-options` 選擇它。若要控制您的機隊 Claude Code 是否自行開始該等待，請在[受管設定](https://code.claude.com/docs/zh-TW/settings.md#settings-precedence)中設定 [`autoContinueAtUsageLimit`](https://code.claude.com/docs/zh-TW/settings-reference#autocontinueatusagelimit)。

238* **「You've hit your individual spend limit」、「org's monthly spend limit」或「team's shared budget」**：開發人員的請求將被計費至用量點數，而這些點數已達到您設定的支出限制。若要讓開發人員繼續，請前往[**組織設定 > 用量**](https://claude.ai/admin-settings/usage)並提高訊息中指明的限制。當訊息也指明方案重設時間時，開發人員可以改為等待直到那時。請參閱[錯誤參考](https://code.claude.com/docs/zh-TW/errors.md#youve-hit-your-monthly-spend-limit)以了解每個變體。238* **「You've hit your individual spend limit」、「org's monthly spend limit」或「team's shared budget」**：開發人員的請求將被計費至用量點數，而這些點數已達到您設定的支出限制。若要讓開發人員繼續，請前往[**組織設定 > 用量**](https://claude.ai/admin-settings/usage)並提高訊息中指明的限制。當訊息也指明方案重設時間時，開發人員可以改為等待直到那時。請參閱[錯誤參考](https://code.claude.com/docs/zh-TW/errors.md#youve-hit-your-monthly-spend-limit)以了解每個變體。

239* **來自 [Claude apps gateway](https://code.claude.com/docs/zh-TW/claude-apps-gateway) 的支出限制訊息**：開發人員超過了您在自託管閘道上設定的支出上限，閘道會阻止他們的請求，直到期間重設或您提高上限。請參閱[閘道支出限制](https://code.claude.com/docs/zh-TW/claude-apps-gateway-spend-limits.md)以了解上限、重設時間表和開發人員看到的訊息。239* **來自 [Claude apps gateway](https://code.claude.com/docs/zh-TW/claude-apps-gateway) 的支出限制訊息**：開發人員超過了您在自託管閘道上設定的支出上限。閘道會阻止他們的請求，直到您提高上限，或在上限高於 \$0 時直到上限重設。請參閱[閘道支出限制](https://code.claude.com/docs/zh-TW/claude-apps-gateway-spend-limits.md)以了解上限、重設時間表和開發人員看到的訊息。

240* **上下文或自動壓縮警告**：不是使用限制。對話已接近工作階段的[自動壓縮視窗](https://code.claude.com/docs/zh-TW/model-config.md#set-the-auto-compact-window)，Claude Code 會總結較舊的歷史記錄以釋放空間的閾值。將開發人員指向[減少 token 使用量](#reduce-token-usage)。240* **上下文或自動壓縮警告**：不是使用限制。對話已接近工作階段的[自動壓縮視窗](https://code.claude.com/docs/zh-TW/model-config.md#set-the-auto-compact-window)，Claude Code 會總結較舊的歷史記錄以釋放空間的閾值。將開發人員指向[減少 token 使用量](#reduce-token-usage)。

241* **API 或雲端提供者方案上的意外高支出**：通常可追溯到從未清除的長工作階段或留作預設模型的 Opus。分享的最高影響習慣是在不相關的任務之間清除和將模型與工作相匹配，兩者都涵蓋在[減少 token 使用量](#reduce-token-usage)中。241* **API 或雲端提供者方案上的意外高支出**：通常可追溯到從未清除的長工作階段或留作預設模型的 Opus。分享的最高影響習慣是在不相關的任務之間清除和將模型與工作相匹配，兩者都涵蓋在[減少 token 使用量](#reduce-token-usage)中。

242 242 

292 292 

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

294 294 

295[skill](https://code.claude.com/docs/zh-TW/skills.md) 可以為 Claude 提供領域知識，因此它不必進行探索。例如，「codebase-overview」skill 可以描述您的專案架構、關鍵目錄和命名慣例。當 Claude 呼叫該 skill 時，它會立即獲得此上下文，而不是花費 token 讀取多個檔案來理解結構。295此 PreToolUse hook 將測試輸出裁剪為最後 100 行：

296 

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

298 296 

299> [tab] settings.json297> [tab] settings.json

300>298>

320 318 

321> [tab] filter-test-output.sh319> [tab] filter-test-output.sh

322>320>

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

324>322>

325> ```bash theme={null}323> ```bash theme={null}

326> #!/bin/bash324> #!/bin/bash

327> input=$(cat)325> input=$(cat)

328> cmd=$(echo "$input" | jq -r '.tool_input.command')326> cmd=$(echo "$input" | jq -r '.tool_input.command')

329>327>

330> # If running tests, filter to show only failures328> # If running tests, keep only the last 100 lines

331> pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'329> pattern='^(npm test|pytest|go test)( [^;&|<>`$#\\[:cntrl:]]*)?$'

332> if [[ "$cmd" =~ $pattern ]]; then330> if [[ "$cmd" =~ $pattern ]]; then

333> filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"331> filtered_cmd="$cmd 2>&1 | tail -n 100"

334> echo "$input" | jq --arg filtered "$filtered_cmd" \332> echo "$input" | jq --arg filtered "$filtered_cmd" \

335> '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'333> '{hookSpecificOutput: {hookEventName: "PreToolUse", updatedInput: (.tool_input + {command: $filtered})}}'

336> else334> else

340 338 

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

342 340 

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

342 

343### 將指示從 CLAUDE.md 移至 skill343### 將指示從 CLAUDE.md 移至 skill

344 344 

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

56 56 

57### 訊息傳遞57### 訊息傳遞

58 58 

59接收 Claude 在活躍回合期間的工具呼叫之間讀取訊息，因此執行中的工具永遠不會被中斷。當接收工作階段閒置時，Claude Code 使用訊息啟動新回合。59接收 Claude 在活躍回合期間的工具呼叫之間讀取訊息。當接收工作階段閒置時，Claude Code 使用訊息啟動新回合。

60 60 

61來自另一個工作階段的訊息作為純文字到達。如果它使用 `@` 提及檔案或 [MCP 資源](https://code.claude.com/docs/zh-TW/mcp.md#use-mcp-resources)，Claude 會看到如寫入的提及，Claude Code 不會附加任何內容，無論訊息是啟動新回合還是在一個回合期間到達。Claude 仍然可以使用自己的工具在接收機器上開啟提及的路徑，受該工作階段的權限限制。61來自另一個工作階段的訊息作為純文字到達。如果它使用 `@` 提及檔案或 [MCP 資源](https://code.claude.com/docs/zh-TW/mcp.md#use-mcp-resources)，Claude 會看到如寫入的提及，Claude Code 不會附加任何內容，無論訊息是啟動新回合還是在一個回合期間到達。Claude 仍然可以使用自己的工具在接收機器上開啟提及的路徑，受該工作階段的權限限制。

62 62 

141 141 

142在 [SSH](#ssh-sessions) 或 [WSL](https://code.claude.com/docs/zh-TW/desktop-wsl.md) 工作階段中，點擊聊天中 HTML 檔案的路徑，即可在「瀏覽器」窗格中預覽該檔案。如果預覽中的圖表或表格一直是空的，預覽上方的通知會告訴您原因：142在 [SSH](#ssh-sessions) 或 [WSL](https://code.claude.com/docs/zh-TW/desktop-wsl.md) 工作階段中，點擊聊天中 HTML 檔案的路徑，即可在「瀏覽器」窗格中預覽該檔案。如果預覽中的圖表或表格一直是空的，預覽上方的通知會告訴您原因：

143 143 

144* **`This preview doesn't load anything from the web`**：檔案中撰寫的指令碼會執行，但從網路載入其程式庫的圖表會保持空白。如果通知中有**匯出**按鈕，請選擇它，並在您的瀏覽器中開啟儲存的檔案，在那裡來自網路的內容會載入。144* **`This preview doesn't load anything from the web`**：檔案中撰寫的指令碼會執行，但從網路載入其程式庫的圖表會保持空白。如果通知中有 **Export** 按鈕，請選擇它，並在您的瀏覽器中開啟儲存的檔案，在那裡來自網路的內容會載入。

145* **`This preview doesn't run scripts or load anything from the web`**：在 Claude Desktop v4.23118.0 之前，這些預覽不會執行指令碼，因此請更新 Desktop 並再次開啟該檔案。如果 Desktop 已是最新版本而通知仍然存在，請重新啟動 Desktop。如果通知依然存在，指令碼可能已[為您的組織關閉](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)，請詢問您的管理員。145* **`This preview doesn't run scripts or load anything from the web`**：在 Claude Desktop v4.23118.0 之前，這些預覽不會執行指令碼，因此請更新 Desktop 並再次開啟該檔案。如果 Desktop 已是最新版本而通知仍然存在，請重新啟動 Desktop。如果通知依然存在，指令碼可能已[為您的組織關閉](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)，請詢問您的管理員。

146 146 

147如果您關閉了通知，請再次開啟該檔案以重新顯示它。147如果您關閉了通知，請再次開啟該檔案以重新顯示它。

256 256 

257### 最小化窗格257### 最小化窗格

258 258 

259若要以小尺寸持續顯示 Terminal、Browser 或 [iOS Simulator](https://code.claude.com/docs/zh-TW/desktop-ios-simulator.md)，請點擊窗格標題中的 **Minimize**。此按鈕需要 Claude Desktop v4.0.0 或更新版本，以及 Claude 帳戶而非[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)。Browser 窗格僅在本機工作階段中提供此按鈕。259若要以小尺寸持續顯示 Terminal、Browser、[iOS Simulator](https://code.claude.com/docs/zh-TW/desktop-ios-simulator.md) 或[側邊聊天](#ask-a-side-question-without-derailing-the-session)，請點擊窗格標題中的 **Minimize**。此按鈕需要 Claude Desktop v4.0.0 或更新版本，以及 Claude 帳戶而非[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)。Browser 窗格僅在本機工作階段中提供此按鈕。

260 260 

261當[工作階段詳細資訊面板](#see-session-details)顯示在畫面上時，最小化的窗格會位於該面板中，否則會浮動在聊天的某個角落：261當[工作階段詳細資訊面板](#see-session-details)顯示在畫面上時，最小化的窗格會位於該面板中，否則會浮動在聊天的某個角落：

262 262 

1380* **工作流程**：Desktop 會在每個新的[工作流程](https://code.claude.com/docs/zh-TW/workflows.md)啟動前進行檢查，因此在 Desktop 中斷連線時，新的工作流程會等待最多 10 分鐘後失敗1380* **工作流程**：Desktop 會在每個新的[工作流程](https://code.claude.com/docs/zh-TW/workflows.md)啟動前進行檢查，因此在 Desktop 中斷連線時，新的工作流程會等待最多 10 分鐘後失敗

1381* **MCP 伺服器**：Claude Code 在遠端機器上啟動的 MCP 伺服器不會透過 Desktop 執行，因此 Claude 仍可呼叫它們的工具。只有在 Desktop 未使用其[內建 SSH 用戶端](#worktree-edits-while-disconnected)時，來自 `claude_desktop_config.json` 的伺服器才屬於此類。否則，以及在[某些 Windows 遠端機器](#windows-remote-machines)上，Claude 在 Desktop 中斷連線時無法呼叫它們的工具。1381* **MCP 伺服器**：Claude Code 在遠端機器上啟動的 MCP 伺服器不會透過 Desktop 執行，因此 Claude 仍可呼叫它們的工具。只有在 Desktop 未使用其[內建 SSH 用戶端](#worktree-edits-while-disconnected)時，來自 `claude_desktop_config.json` 的伺服器才屬於此類。否則，以及在[某些 Windows 遠端機器](#windows-remote-machines)上，Claude 在 Desktop 中斷連線時無法呼叫它們的工具。

1382 1382 

1383> [accordion] worktree 中的編輯何時會繼續運作1383> [accordion] worktree 中的編輯何時可以繼續運作

1384>1384>

1385> 在 Linux 或 macOS 遠端機器上，該檢查不會經過 Desktop，因此在 Desktop 中斷連線時，worktree 內的編輯會繼續運作。在 Claude Desktop v2.37337.0 之前，這僅適用於 Linux 遠端機器。1385> 在 Linux 或 macOS 遠端機器上，Desktop 中斷連線時，worktree 內的編輯可以繼續運作，因為每個編輯的檢查可以在沒有 Desktop 的情況下執行。在 [Claude Desktop v2.37337.0](#check-your-version) 之前，這只適用於 Linux 遠端機器。

1386>1386>

1387> 在某些情況下編輯仍會失敗，包括下列情況：1387> 在某些情況下編輯仍會失敗，包括下列情況：

1388>1388>

2050 2050 

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

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

2053* **[SSH 工作階段](#ssh-sessions)**：工作階段從遠端主機讀取受管設定檔案。Desktop 本身會在本機上讀取 `sshConfigs`、`sshHostAllowlist`、`disableSshSavedPasswords` 和 `disableDesktopLocalSessions`。如果您傳遞多個受管來源，它[預設只從其中一個讀取](https://code.claude.com/docs/zh-TW/managed-settings.md#how-claude-code-combines-managed-sources)。2053* **[SSH 工作階段](#ssh-sessions)**：工作階段從遠端主機讀取受管設定檔案。Desktop 本身會在本機上讀取 `sshConfigs`、`sshHostAllowlist`、`disableSshSavedPasswords` 和 `disableDesktopLocalSessions`。如果您傳遞多個受管來源，它[預設只從其中一個讀取](https://code.claude.com/docs/zh-TW/managed-settings.md#how-claude-code-combines-managed-sources)。如果您在本機上生效的受管設定中設定 `permissions.disableBypassPermissionsMode` 或 `disableAutoMode`，無論遠端主機如何設定，SSH 工作階段的模式選擇器都不會提供該模式。

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

2055 2055 

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

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> iOS Simulator 窗格在 macOS 上的 Claude Code Desktop 中處於公開測試版。它在 Pro、Max、Ultra、Team 和 Enterprise 方案上可用，但在啟用 HIPAA 設定的 Enterprise 組織中除外。11> iOS Simulator 窗格在 macOS 上的 Claude Code Desktop 中處於公開測試版。它在 Pro、Max、Ultra、Team 和 Enterprise 方案上可用，但在啟用 HIPAA 設定的 Enterprise 組織中除外。如果您使用[第三方供應商](https://code.claude.com/docs/zh-TW/third-party-integrations.md)，則無法使用此功能。

12 12 

13iOS Simulator 窗格在 Claude Code Desktop 中的對話旁邊顯示您的應用程式在 Apple 的 iOS Simulator 中執行。當 Claude 在模擬器中建置、安裝、啟動或檢查您的應用程式時，窗格會自動開啟並即時串流裝置螢幕。使用它來觀看 Claude 執行和測試您的應用程式，或在 Claude 繼續工作時自己點選應用程式。13iOS Simulator 窗格在 Claude Code Desktop 中的對話旁邊顯示您的應用程式在 Apple 的 iOS Simulator 中執行。當 Claude 在模擬器中建置、安裝、啟動或檢查您的應用程式時，窗格會自動開啟並即時串流裝置螢幕。使用它來觀看 Claude 執行和測試您的應用程式，或在 Claude 繼續工作時自己點選應用程式。

14 14 

147* 明確說明目標，例如「在 iOS Simulator 中執行應用程式並點選註冊流程」。147* 明確說明目標，例如「在 iOS Simulator 中執行應用程式並點選註冊流程」。

148* 確認 Xcode 和 iOS 模擬器已安裝，且您的 Xcode 版本符合[需求](#requirements)。148* 確認 Xcode 和 iOS 模擬器已安裝，且您的 Xcode 版本符合[需求](#requirements)。

149* 如果您的組織管理 Claude Code，[模擬器工具可能被原則停用](#turn-off-simulator-access)。149* 如果您的組織管理 Claude Code，[模擬器工具可能被原則停用](#turn-off-simulator-access)。

150* 如果您在啟用 HIPAA 設定的 Enterprise 組織中，模擬器窗格對您不可用。150* 如果您在啟用 HIPAA 設定的 Enterprise 組織中，或您使用[第三方提供者](https://code.claude.com/docs/zh-TW/third-party-integrations.md)，模擬器窗格對您不可用。

151* 模擬器窗格需要 Claude Desktop v1.24012.0 或更新版本。開啟 **Claude > Check for Updates…**，然後重新啟動應用程式。151* 模擬器窗格需要 Claude Desktop v1.24012.0 或更新版本。開啟 **Claude > Check for Updates…**，然後重新啟動應用程式。

152 152 

153### 模擬器窗格顯示找不到模擬器153### 模擬器窗格顯示找不到模擬器

204| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設定為 `0` 可阻止 Claude Code 在發布新的 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md#create-an-artifact) 時自動開啟瀏覽器 |204| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 設定為 `0` 可阻止 Claude Code 在發布新的 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md#create-an-artifact) 時自動開啟瀏覽器 |

205| `CLAUDE_CODE_ARTIFACT_COMMENTS` | 設定為 `0` 可阻止 Claude 讀取及回覆 [artifact 上的留言](https://code.claude.com/docs/zh-TW/artifacts.md#collect-comments-on-an-artifact)。當 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 已[關閉 artifact](https://code.claude.com/docs/zh-TW/artifacts.md#availability) 時沒有作用。需要 Claude Code v2.1.221 或更新版本 |205| `CLAUDE_CODE_ARTIFACT_COMMENTS` | 設定為 `0` 可阻止 Claude 讀取及回覆 [artifact 上的留言](https://code.claude.com/docs/zh-TW/artifacts.md#collect-comments-on-an-artifact)。當 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 已[關閉 artifact](https://code.claude.com/docs/zh-TW/artifacts.md#availability) 時沒有作用。需要 Claude Code v2.1.221 或更新版本 |

206| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | 設定為 `0` 可阻止 Claude [自行回覆傳送給它的留言](https://code.claude.com/docs/zh-TW/artifacts.md#let-claude-reply-to-comments-on-its-own)。需要 Claude Code v2.1.228 或更新版本 |206| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | 設定為 `0` 可阻止 Claude [自行回覆傳送給它的留言](https://code.claude.com/docs/zh-TW/artifacts.md#let-claude-reply-to-comments-on-its-own)。需要 Claude Code v2.1.228 或更新版本 |

207| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | 設為 `0` 可阻止 Claude 在發布 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md#update-an-artifact) 時一併對其檔案套用小幅變更。Claude 會改用其檔案編輯工具編輯該檔案，並以獨立步驟發布。需要 Claude Code v2.1.300 或更新版本 |207| `CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS` | 設為 `0` 可讓 Claude 不要在發布 artifact 時[套用小幅變更](https://code.claude.com/docs/zh-TW/artifacts.md#turn-off-one-step-artifact-updates)至其檔案。Claude 接著會以其檔案編輯工具編輯該檔案，並以獨立步驟發布。需要 Claude Code v2.1.300 或更新版本 |

208| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 可從系統提示詞開頭省略[歸屬區塊](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#system-prompt-attribution-block)，該區塊包含用戶端版本與提示詞指紋。無論如何，直接連線至 Anthropic API 時的快取都不受影響。在某些直接連線設定中，即使您設定了 `0`，Claude Code 仍會在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)分類器請求中保留此區塊。請在[系統提示詞歸屬區塊](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#system-prompt-attribution-block)中查看此情況涵蓋哪些連線與憑證。在 v2.1.181 之前，此區塊在自訂基礎 URL 與 Microsoft Foundry 連線上包含每個請求專屬的 token，因此在這些版本上，當您的 LLM 閘道依請求本文進行快取或將請求轉送至第三方提供者時，或當您直接連線至 Microsoft Foundry 時，請將其設定為 `0` |208| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 設定為 `0` 可從系統提示詞開頭省略[歸屬區塊](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#system-prompt-attribution-block)，該區塊包含用戶端版本與提示詞指紋。無論如何，直接連線至 Anthropic API 時的快取都不受影響。在某些直接連線設定中，即使您設定了 `0`，Claude Code 仍會在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)分類器請求中保留此區塊。請在[系統提示詞歸屬區塊](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#system-prompt-attribution-block)中查看此情況涵蓋哪些連線與憑證。在 v2.1.181 之前，此區塊在自訂基礎 URL 與 Microsoft Foundry 連線上包含每個請求專屬的 token，因此在這些版本上，當您的 LLM 閘道依請求本文進行快取或將請求轉送至第三方提供者時，或當您直接連線至 Microsoft Foundry 時，請將其設定為 `0` |

209| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | 已於 v2.1.283 移除。請改用 `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |209| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | 已於 v2.1.283 移除。請改用 `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

210| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定自動壓縮視窗，即上下文在壓縮前可填滿的程度，範圍為 `100000` 至 `1000000` 個 token。`200k` 等帶後綴的值需要 v2.1.304 或更新版本。關於它相對於其他設定視窗方式的優先順序，以及對狀態列 `used_percentage` 的影響，請參閱[設定自動壓縮視窗](https://code.claude.com/docs/zh-TW/model-config.md#set-the-auto-compact-window) |210| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 設定自動壓縮視窗，即上下文在壓縮前可填滿的程度，範圍為 `100000` 至 `1000000` 個 token。`200k` 等帶後綴的值需要 v2.1.304 或更新版本。關於它相對於其他設定視窗方式的優先順序，以及對狀態列 `used_percentage` 的影響，請參閱[設定自動壓縮視窗](https://code.claude.com/docs/zh-TW/model-config.md#set-the-auto-compact-window) |

502| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 可在 `tool.output` OpenTelemetry span 事件中包含工具內容。Span 屬性會依[各自的開關](https://code.claude.com/docs/zh-TW/monitoring-usage.md#new-context-gates)攜帶工具內容。需要[追蹤](https://code.claude.com/docs/zh-TW/monitoring-usage.md#traces-beta)。預設為停用以保護敏感資料。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md#tool-output-span-event) |502| `OTEL_LOG_TOOL_CONTENT` | 設定為 `1` 可在 `tool.output` OpenTelemetry span 事件中包含工具內容。Span 屬性會依[各自的開關](https://code.claude.com/docs/zh-TW/monitoring-usage.md#new-context-gates)攜帶工具內容。需要[追蹤](https://code.claude.com/docs/zh-TW/monitoring-usage.md#traces-beta)。預設為停用以保護敏感資料。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md#tool-output-span-event) |

503| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 可在 OpenTelemetry 指標、追蹤與日誌中包含工具輸入引數；MCP 伺服器名稱；使用者撰寫的工作流程名稱；工具失敗時的原始錯誤字串；`api_refusal` 事件上的拒絕 `category`；[成本與 token 指標](https://code.claude.com/docs/zh-TW/monitoring-usage.md#cost-counter)上真實的 agent、skill、外掛與 MCP 伺服器名稱；以及其他工具詳細資訊。預設為停用以保護 PII。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |503| `OTEL_LOG_TOOL_DETAILS` | 設定為 `1` 可在 OpenTelemetry 指標、追蹤與日誌中包含工具輸入引數；MCP 伺服器名稱；使用者撰寫的工作流程名稱；工具失敗時的原始錯誤字串；`api_refusal` 事件上的拒絕 `category`；[成本與 token 指標](https://code.claude.com/docs/zh-TW/monitoring-usage.md#cost-counter)上真實的 agent、skill、外掛與 MCP 伺服器名稱；以及其他工具詳細資訊。預設為停用以保護 PII。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

504| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 可在 OpenTelemetry 追蹤與日誌中包含使用者提示詞文字。預設為停用（提示詞會被遮蔽）。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |504| `OTEL_LOG_USER_PROMPTS` | 設定為 `1` 可在 OpenTelemetry 追蹤與日誌中包含使用者提示詞文字。預設為停用（提示詞會被遮蔽）。請在您的 shell、使用者設定或受管設定中設定。在[專案與本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略，但該節所述的關閉值除外。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

505| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 設定為 `false` 可從指標屬性中排除帳戶 UUID（預設：包含）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |505| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 設為 `false` 可從指標和事件屬性中排除帳戶 UUID（預設值：包含）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

506| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 設定為 `true` 可在指標屬性中包含工作階段進入點（預設：排除）。於 v2.1.152 新增。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |506| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 設為 `true` 可在指標和事件屬性中包含工作階段進入點（預設值：排除）。於 v2.1.152 新增。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

507| `OTEL_METRICS_INCLUDE_REPOSITORY` | 設定為 `true` 可為 OpenTelemetry 指標與事件加上識別工作階段儲存庫的 `vcs.*` 屬性（預設：排除）。需要 Claude Code v2.1.269 或更新版本。請參閱[儲存庫屬性](https://code.claude.com/docs/zh-TW/monitoring-usage.md#repository-attributes) |507| `OTEL_METRICS_INCLUDE_REPOSITORY` | 設定為 `true` 可為 OpenTelemetry 指標與事件加上識別工作階段儲存庫的 `vcs.*` 屬性（預設：排除）。需要 Claude Code v2.1.269 或更新版本。請參閱[儲存庫屬性](https://code.claude.com/docs/zh-TW/monitoring-usage.md#repository-attributes) |

508| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | 自 v2.1.161 起，Claude Code 會將 `OTEL_RESOURCE_ATTRIBUTES` 的鍵附加至指標資料點標籤。設定為 `false` 可將其排除（預設：包含）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md#multi-team-organization-support) |508| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | 自 v2.1.161 起，Claude Code 會將 `OTEL_RESOURCE_ATTRIBUTES` 的鍵附加至指標資料點標籤。設定為 `false` 可將其排除（預設：包含）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md#multi-team-organization-support) |

509| `OTEL_METRICS_INCLUDE_SESSION_ID` | 設定為 `false` 可從指標屬性中排除工作階段 ID（預設：包含）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |509| `OTEL_METRICS_INCLUDE_SESSION_ID` | 設為 `false` 可從指標和事件屬性中排除工作階段 ID（預設值：包含）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

510| `OTEL_METRICS_INCLUDE_VERSION` | 設定為 `true` 可在指標屬性中包含 Claude Code 版本（預設：排除）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |510| `OTEL_METRICS_INCLUDE_VERSION` | 設為 `true` 可在指標和事件屬性中包含 Claude Code 版本（預設值：排除）。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

511| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆寫顯示給 [Skill 工具](https://code.claude.com/docs/zh-TW/skills.md#control-who-invokes-a-skill)之 skill 中繼資料的字元預算。此預算會動態調整為上下文視窗的 1%，備援值為 8,000 個字元。保留舊名稱以維持向下相容 |511| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | 覆寫顯示給 [Skill 工具](https://code.claude.com/docs/zh-TW/skills.md#control-who-invokes-a-skill)之 skill 中繼資料的字元預算。此預算會動態調整為上下文視窗的 1%，備援值為 8,000 個字元。保留舊名稱以維持向下相容 |

512| `TASK_MAX_OUTPUT_LENGTH` | 已在 v2.1.277 中與其所設定大小的 `TaskOutput` 工具一併移除，現在不再有任何作用。先前用於設定 `TaskOutput` 工具保留的[背景任務](https://code.claude.com/docs/zh-TW/tools-reference.md#background-commands)輸出最大字元數。Claude 現在改以 `Read` 讀取背景任務的輸出檔案 |512| `TASK_MAX_OUTPUT_LENGTH` | 已在 v2.1.277 中與其所設定大小的 `TaskOutput` 工具一併移除，現在不再有任何作用。先前用於設定 `TaskOutput` 工具保留的[背景任務](https://code.claude.com/docs/zh-TW/tools-reference.md#background-commands)輸出最大字元數。Claude 現在改以 `Read` 讀取背景任務的輸出檔案 |

513| `USE_BUILTIN_RIPGREP` | 設定為 `0` 可使用系統安裝的 `rg`，而非 Claude Code 內含的 `rg` |513| `USE_BUILTIN_RIPGREP` | 設定為 `0` 可使用系統安裝的 `rg`，而非 Claude Code 內含的 `rg` |

104| `Failed to authenticate: OAuth session expired and could not be refreshed` | [身分驗證](#login-expired) |104| `Failed to authenticate: OAuth session expired and could not be refreshed` | [身分驗證](#login-expired) |

105| `Could not refresh your login because another Claude Code process is refreshing it` | [身分驗證](#could-not-refresh-your-login) |105| `Could not refresh your login because another Claude Code process is refreshing it` | [身分驗證](#could-not-refresh-your-login) |

106| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [身分驗證](#could-not-refresh-your-login) |106| `Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh` | [身分驗證](#could-not-refresh-your-login) |

107| `Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [身分驗證](#could-not-refresh-your-login-disk-full) |

108| `Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full` | [身分驗證](#could-not-refresh-your-login-disk-full) |

107| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [身分驗證](#your-account-is-on-hold) |109| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [身分驗證](#your-account-is-on-hold) |

108| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [身分驗證](#your-account-is-on-hold) |110| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [身分驗證](#your-account-is-on-hold) |

109| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [身分驗證](#anthropic-profile-login-expired) |111| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [身分驗證](#anthropic-profile-login-expired) |

242| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [命令列錯誤](#the-current-directory-no-longer-exists) |244| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [命令列錯誤](#the-current-directory-no-longer-exists) |

243| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [命令列錯誤](#temp-directory-refused-or-cannot-be-created) |245| `Temp directory <dir> ... Refusing to use it` / `Claude Code's temporary directory <dir> could not be created` | [命令列錯誤](#temp-directory-refused-or-cannot-be-created) |

244| `ENOSPC: no space left on device, mkdir '<dir>'` | [命令列錯誤](#temp-directory-refused-or-cannot-be-created) |246| `ENOSPC: no space left on device, mkdir '<dir>'` | [命令列錯誤](#temp-directory-refused-or-cannot-be-created) |

247| `Error: Claude Code could not save ... because the disk is full (ENOSPC)` / `because your disk quota is used up (EDQUOT)` | [命令列錯誤](#could-not-save-because-the-disk-is-full) |

245| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [命令列錯誤](#directory-couldnt-be-resolved-to-a-real-location) |248| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [命令列錯誤](#directory-couldnt-be-resolved-to-a-real-location) |

246| 啟動 Remote Control 時出現的 `Error: Workspace not trusted` | [命令列錯誤](#workspace-not-trusted-when-starting-remote-control) |249| 啟動 Remote Control 時出現的 `Error: Workspace not trusted` | [命令列錯誤](#workspace-not-trusted-when-starting-remote-control) |

247| 執行 `claude ultrareview` 時出現的 `Error: Workspace not trusted` | [命令列錯誤](#workspace-not-trusted-when-running-claude-ultrareview) |250| 執行 `claude ultrareview` 時出現的 `Error: Workspace not trusted` | [命令列錯誤](#workspace-not-trusted-when-running-claude-ultrareview) |

248| `Ultrareview did not start` | [命令列錯誤](#ultrareview-did-not-start) |251| `Ultrareview did not start` | [命令列錯誤](#ultrareview-did-not-start) |

252| `Remote Control did not start: "<question>" got no answer` | [命令列錯誤](#remote-control-did-not-start-got-no-answer) |

249| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [命令列錯誤](#not-carried-over-to-the-sessions-remote-control-starts) |253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [命令列錯誤](#not-carried-over-to-the-sessions-remote-control-starts) |

250| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [命令列錯誤](#sandbox-is-not-supported-by-claude-remote-control) |254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [命令列錯誤](#sandbox-is-not-supported-by-claude-remote-control) |

251| `` `claude import` is not yet available in this build `` | [命令列錯誤](#claude-import-is-not-yet-available-in-this-build) |255| `` `claude import` is not yet available in this build `` | [命令列錯誤](#claude-import-is-not-yet-available-in-this-build) |

320| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [外掛疑難排解](https://code.claude.com/docs/zh-TW/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |324| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [外掛疑難排解](https://code.claude.com/docs/zh-TW/plugins/troubleshooting.md#the-packages-it-lists-are-not-installed) |

321| `does not load (...), so Claude Code ignores the whole file` | [外掛疑難排解](https://code.claude.com/docs/zh-TW/plugins/troubleshooting.md#does-not-load-so-claude-code-ignores-the-whole-file) |325| `does not load (...), so Claude Code ignores the whole file` | [外掛疑難排解](https://code.claude.com/docs/zh-TW/plugins/troubleshooting.md#does-not-load-so-claude-code-ignores-the-whole-file) |

322| `path escapes plugin directory` | [外掛錯誤](#path-escapes-plugin-directory) |326| `path escapes plugin directory` | [外掛錯誤](#path-escapes-plugin-directory) |

327| `path not read: <path> is absolute or has a ".." part` | [外掛錯誤](#server-file-path-not-read) |

323| `Plugin not loaded: its manifest <path> was not read` | [外掛錯誤](#plugin-not-loaded-its-manifest-was-not-read) |328| `Plugin not loaded: its manifest <path> was not read` | [外掛錯誤](#plugin-not-loaded-its-manifest-was-not-read) |

324| `path could not be checked` | [外掛錯誤](#path-could-not-be-checked) |329| `path could not be checked` | [外掛錯誤](#path-could-not-be-checked) |

325| `its marketplace entry path does not stay inside the marketplace directory` | [外掛錯誤](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |330| `its marketplace entry path does not stay inside the marketplace directory` | [外掛錯誤](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |

368| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [工具錯誤](#refusing-after-a-symlink-changed) |373| `Refusing to write <path>: where it leads on disk could not be determined` / `Refusing to read <path>: where it leads on disk could not be determined` | [工具錯誤](#refusing-after-a-symlink-changed) |

369| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [工具錯誤](#refusing-after-a-symlink-changed) |374| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [工具錯誤](#refusing-after-a-symlink-changed) |

370| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [工具錯誤](#refusing-after-a-symlink-changed) |375| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [工具錯誤](#refusing-after-a-symlink-changed) |

376| `The search failed, so this is not a "no matches" result: matches may exist` | [工具錯誤](#the-search-failed) |

371| `task output swap refused (tasks dir moved or linked)` | [工具錯誤](#task-output-swap-refused) |377| `task output swap refused (tasks dir moved or linked)` | [工具錯誤](#task-output-swap-refused) |

372| `Command killed: its output file was replaced or could no longer be verified` | [工具錯誤](#task-output-swap-refused) |378| `Command killed: its output file was replaced or could no longer be verified` | [工具錯誤](#task-output-swap-refused) |

373| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [工具錯誤](#disk-quota-or-temp-filesystem-is-full) |379| `Disk full: this computer's volume holding <dir> (Claude Code's temporary directory) has <n> MB free` / `Nearly out of inodes: this computer's volume holding <dir>` | [工具錯誤](#disk-quota-or-temp-filesystem-is-full) |

377| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [工具錯誤](#disk-quota-or-temp-filesystem-is-full) |383| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [工具錯誤](#disk-quota-or-temp-filesystem-is-full) |

378| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [工具錯誤](#file-is-not-valid-utf-8) |384| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [工具錯誤](#file-is-not-valid-utf-8) |

379| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [工具錯誤](#git-is-not-installed-on-this-mac) |385| `git is not installed on this Mac. To install it, run xcode-select --install, then try again.` | [工具錯誤](#git-is-not-installed-on-this-mac) |

386| `Refusing to apply edits to <path>: a hook is configured for file edits in this session` | [工具錯誤](#a-hook-is-configured-for-file-edits) |

380| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [工具錯誤](#the-source-file-is-not-valid-utf-8-text) |387| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [工具錯誤](#the-source-file-is-not-valid-utf-8-text) |

381| `the source file has the replacement character U+FFFD` | [工具錯誤](#the-source-file-is-not-valid-utf-8-text) |388| `the source file has the replacement character U+FFFD` | [工具錯誤](#the-source-file-is-not-valid-utf-8-text) |

382| `Not published: that file is on a network share` | [工具錯誤](#not-published-that-file-is-on-a-network-share) |389| `Not published: that file is on a network share` | [工具錯誤](#not-published-that-file-is-on-a-network-share) |

387| `The safety check for domain ... is rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |394| `The safety check for domain ... is rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |

388| `The safety check for domain ... is temporarily rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |395| `The safety check for domain ... is temporarily rate-limited` | [工具錯誤](#webfetch-domain-safety-check-failed) |

389| `Unable to verify if domain ... is safe to fetch` | [工具錯誤](#webfetch-domain-safety-check-failed) |396| `Unable to verify if domain ... is safe to fetch` | [工具錯誤](#webfetch-domain-safety-check-failed) |

397| `MCP tool "<tool>" on server "<server>" gave no answer that could be read` / `answered without its text` | [如何讀取 MCP 工具 hook 的結果](https://code.claude.com/docs/zh-TW/hooks.md#how-the-tools-result-is-read) |

390| `Can't open MCP settings while no terminal is attached to this background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |398| `Can't open MCP settings while no terminal is attached to this background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |

391| `Can't open MCP settings in a background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |399| `Can't open MCP settings in a background session` | [背景工作階段錯誤](#commands-refused-in-a-background-session) |

392| `blocked because the path is spelled in a form that cannot be safely resolved` | [背景工作階段錯誤](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |400| `blocked because the path is spelled in a form that cannot be safely resolved` | [背景工作階段錯誤](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |

397| `Can't open — this session is running in another terminal` | [背景工作階段錯誤](#this-session-is-running-in-another-terminal) |405| `Can't open — this session is running in another terminal` | [背景工作階段錯誤](#this-session-is-running-in-another-terminal) |

398| `This conversation is already open in another running Claude session` | [背景工作階段錯誤](#this-session-is-running-in-another-terminal) |406| `This conversation is already open in another running Claude session` | [背景工作階段錯誤](#this-session-is-running-in-another-terminal) |

399| `This session's saved conversation is no longer on disk` | [背景工作階段錯誤](#this-sessions-saved-conversation-is-no-longer-on-disk) |407| `This session's saved conversation is no longer on disk` | [背景工作階段錯誤](#this-sessions-saved-conversation-is-no-longer-on-disk) |

408| `This forked session could not be started. Fork the conversation again to retry.` | [背景工作階段錯誤](#this-forked-session-could-not-be-started) |

400| `Bypass permissions was requested at launch and ignored` | [在背景工作階段中 Bypass permissions 遭到忽略](https://code.claude.com/docs/zh-TW/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |409| `Bypass permissions was requested at launch and ignored` | [在背景工作階段中 Bypass permissions 遭到忽略](https://code.claude.com/docs/zh-TW/permission-modes.md#bypass-permissions-ignored-in-a-background-session) |

401| `kept <id> — its worktree is still at <path>` | 若訊息的下一行提及未推送的提交，請參閱[背景工作階段錯誤](#worktree-has-commits-that-are-not-pushed-anywhere)，否則請參閱[刪除工作階段會移除哪些內容](https://code.claude.com/docs/zh-TW/agent-view.md#what-deleting-a-session-removes) |410| `kept <id> — its worktree is still at <path>` | 若訊息的下一行提及未推送的提交，請參閱[背景工作階段錯誤](#worktree-has-commits-that-are-not-pushed-anywhere)，否則請參閱[刪除工作階段會移除哪些內容](https://code.claude.com/docs/zh-TW/agent-view.md#what-deleting-a-session-removes) |

402| `kept <id> — <n> unpushed commits on <branch>` | [背景工作階段錯誤](#worktree-has-commits-that-are-not-pushed-anywhere) |411| `kept <id> — <n> unpushed commits on <branch>` | [背景工作階段錯誤](#worktree-has-commits-that-are-not-pushed-anywhere) |

548| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/zh-TW/env-vars) | 10 | 重試嘗試次數。從 v2.1.186 開始上限為 15；從 v2.1.199 開始 `CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。降低它以在指令碼中更快地顯示故障。 |557| [`CLAUDE_CODE_MAX_RETRIES`](https://code.claude.com/docs/zh-TW/env-vars) | 10 | 重試嘗試次數。從 v2.1.186 開始上限為 15；從 v2.1.199 開始 `CLAUDE_CODE_RETRY_WATCHDOG` 會提高預設值並移除上限。降低它以在指令碼中更快地顯示故障。 |

549| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 在無人值守的工作階段（例如 CI 工作）中設定為 `1`，以無限期重試 `429` 和 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。當標準速度的請求收到報告支出限制或用量點數耗盡的 `429` 時，Claude Code 會立即失敗，即使該 `429` 來自按排程重設的 [gateway spend cap](#spend-limit-reached)。在 v2.1.239 之前，看門狗會無限期重試這些錯誤。如需快速模式請求，請參閱 [Handle rate limits](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)。在 v2.1.199 或更新版本上，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時和連線中斷）的預設重試次數提高至 300，大約三小時的退避，並在您明確設定 `CLAUDE_CODE_MAX_RETRIES` 時移除其上限 15。 |558| [`CLAUDE_CODE_RETRY_WATCHDOG`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 在無人值守的工作階段（例如 CI 工作）中設定為 `1`，以無限期重試 `429` 和 `529` 容量錯誤，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次嘗試後失敗。當標準速度的請求收到報告支出限制或用量點數耗盡的 `429` 時，Claude Code 會立即失敗，即使該 `429` 來自按排程重設的 [gateway spend cap](#spend-limit-reached)。在 v2.1.239 之前，看門狗會無限期重試這些錯誤。如需快速模式請求，請參閱 [Handle rate limits](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)。在 v2.1.199 或更新版本上，它也會將其他暫時性錯誤（例如伺服器錯誤、逾時和連線中斷）的預設重試次數提高至 300，大約三小時的退避，並在您明確設定 `CLAUDE_CODE_MAX_RETRIES` 時移除其上限 15。 |

550| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，每個 API 請求等待 `429` 和 `529` 錯誤所花費的最長時間（毫秒）。未設定時，等待時間沒有限制。需要 Claude Code v2.1.295 或更新版本。 |559| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，每個 API 請求等待 `429` 和 `529` 錯誤所花費的最長時間（毫秒）。未設定時，等待時間沒有限制。需要 Claude Code v2.1.295 或更新版本。 |

560| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS` | 無上限 | 設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，單一請求等待您方案的[用量上限](#youve-hit-your-session-limit)（例如工作階段或每週上限）重設的最長時間（毫秒）。當重設時間比此等待上限更遠時，請求會立即失敗，除非用量點數仍有餘額或 API 無法檢查用量點數。在這些情況下，請求會被重試，如果在成功之前超過此等待上限則會失敗。需要 Claude Code v2.1.301 或更新版本。 |

551| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，在請求等待[用量上限](#youve-hit-your-session-limit)重設期間，檢查該上限是否已解除的最短間隔（毫秒）。當檢查發現上限已解除時，請求會立即送出。請提供 `60000` 到 `10800000` 之間的純數字。未設定或超出該範圍時，不會進行任何檢查。關於 Claude Code 何時略過這些檢查，請參閱[環境變數參考](https://code.claude.com/docs/zh-TW/env-vars.md)。需要 Claude Code v2.1.305 或更新版本。 |561| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 未設定 | 設定 `CLAUDE_CODE_RETRY_WATCHDOG` 時，在請求等待[用量上限](#youve-hit-your-session-limit)重設期間，檢查該上限是否已解除的最短間隔（毫秒）。當檢查發現上限已解除時，請求會立即送出。請提供 `60000` 到 `10800000` 之間的純數字。未設定或超出該範圍時，不會進行任何檢查。關於 Claude Code 何時略過這些檢查，請參閱[環境變數參考](https://code.claude.com/docs/zh-TW/env-vars.md)。需要 Claude Code v2.1.305 或更新版本。 |

552| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 500 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的起始延遲（毫秒）。當 API 容量已滿時，可提高此值（最高 32000），以將重試分散在較長的時間範圍內。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.292 或更新版本。 |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 500 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的起始延遲（毫秒）。當 API 容量已滿時，可提高此值（最高 32000），以將重試分散在較長的時間範圍內。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.292 或更新版本。 |

553| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 32000 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的上限（毫秒）。當 API 容量已滿時，可提高此值（最高 64000），讓後續的重試間隔持續拉長。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.296 或更新版本。 |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/zh-TW/env-vars) | 32000 | API 以 `529` 過載錯誤拒絕的請求，其重試之間退避的上限（毫秒）。當 API 容量已滿時，可提高此值（最高 64000），讓後續的重試間隔持續拉長。當 `CLAUDE_CODE_RETRY_WATCHDOG` 設定為 `1`，或被拒絕的請求是以[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md#handle-rate-limits)發送時，此設定無效。需要 Claude Code v2.1.296 或更新版本。 |

1436 1446 

1437這與 [OAuth token 已撤銷或已過期](#oauth-token-revoked-or-expired)並非相同狀態。那些訊息回報的是 API 傳回的拒絕。`Login expired` 是 Claude Code 本身針對已無法更新的登入所產生的訊息，因此不會傳送任何請求。當更新失敗是因為帳戶本身遭到停權而非登入過時，Claude Code 會改為顯示[您的帳戶已遭暫停](#your-account-is-on-hold)。1447這與 [OAuth token 已撤銷或已過期](#oauth-token-revoked-or-expired)並非相同狀態。那些訊息回報的是 API 傳回的拒絕。`Login expired` 是 Claude Code 本身針對已無法更新的登入所產生的訊息，因此不會傳送任何請求。當更新失敗是因為帳戶本身遭到停權而非登入過時，Claude Code 會改為顯示[您的帳戶已遭暫停](#your-account-is-on-hold)。

1438 1448 

1439以 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/zh-TW/env-vars) 或第三方供應商進行身分驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。

1440 

1441您可以在請求失敗之前檢查此狀態：[`/status`](https://code.claude.com/docs/zh-TW/commands) 會顯示一列內容為 `Expired — log in again` 的 `Login`，以及它為過期登入所儲存的組織與電子郵件。只有當已儲存的登入是您使用中的憑證且已無法重新整理時，才會出現該列。以其他方式進行身分驗證的工作階段不會顯示該列，即使仍有已過期的登入被儲存。在 v2.1.210 之前，`/status` 在此狀態下不會顯示任何曾經存在登入的跡象，因為被清除的憑證讓它沒有可回報的內容。1449您可以在請求失敗之前檢查此狀態：[`/status`](https://code.claude.com/docs/zh-TW/commands) 會顯示一列內容為 `Expired — log in again` 的 `Login`，以及它為過期登入所儲存的組織與電子郵件。只有當已儲存的登入是您使用中的憑證且已無法重新整理時，才會出現該列。以其他方式進行身分驗證的工作階段不會顯示該列，即使仍有已過期的登入被儲存。在 v2.1.210 之前，`/status` 在此狀態下不會顯示任何曾經存在登入的跡象，因為被清除的憑證讓它沒有可回報的內容。

1442 1450 

1443**處理方式：**1451**處理方式：**

1461Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1469Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

1462```1470```

1463 1471 

1464以 API 金鑰、[`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/zh-TW/env-vars) 或第三方供應商進行身分驗證的工作階段不使用已儲存的登入，永遠不會看到此訊息。

1465 

1466**處理方式：**1472**處理方式：**

1467 1473 

1468* 一分鐘後再試一次。如果另一個程序先完成了重新整理，此工作階段就會使用更新後的登入。1474* 一分鐘後再試一次。如果另一個程序先完成了重新整理，此工作階段就會使用更新後的登入。

1469* 如果訊息持續出現，請關閉其他 Claude Code 視窗與程序，然後重試。1475* 如果訊息持續出現，請關閉其他 Claude Code 視窗與程序，然後重試。

1470* 如果在沒有其他 Claude Code 程序執行的情況下仍出現此訊息，請執行 `/login`。重新登入不需要等待重新整理鎖。1476* 如果在沒有其他 Claude Code 程序執行的情況下仍出現此訊息，請執行 `/login`。重新登入不需要等待重新整理鎖。

1471 1477 

1478### Could not refresh your login: the disk that holds the Claude Code config directory is full

1479 

1480請釋放存放 Claude Code 設定目錄之磁碟上的空間，然後再次傳送您的訊息。在磁碟已滿的情況下重新登入並沒有幫助，因為新的登入無法被儲存。除非您設定了 [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/zh-TW/env-vars)，否則設定目錄為您家目錄中的 `~/.claude`。

1481 

1482```text wrap theme={null}

1483Could not refresh your login: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full · Delete files you no longer need on that disk, then try again · Signing in again won't help

1484```

1485 

1486在[非互動模式](https://code.claude.com/docs/zh-TW/headless.md)（`-p`）和 [Agent SDK](https://code.claude.com/docs/zh-TW/agent-sdk/overview.md) 中，訊息如下：

1487 

1488```text wrap theme={null}

1489Failed to refresh OAuth token: the disk that holds the Claude Code config directory (~/.claude by default), or your disk quota on it, is full. Delete files you no longer need on that disk and retry; signing in again won't help

1490```

1491 

1492**處理方式：**

1493 

1494* 若是指令碼，請重新執行其 `claude -p` 命令

1495* 如果磁碟已顯示有可用空間，那麼磁碟配額或 inode 用盡也會產生相同的訊息。請刪除您自己在該磁碟上的檔案。如果訊息再次出現，請刪除許多小檔案而非少數大檔案，因為每個檔案無論大小都會佔用一個 inode。

1496 

1472### 無法儲存您的登入1497### 無法儲存您的登入

1473 1498 

1474您已使用 claude.ai 登入，但 Claude Code 無法將登入儲存至其憑證儲存區，因此登入未完成。在 macOS 上，如果 Claude Code 在同一個工作階段中已經讀取或儲存過登入鑰匙圈中的憑證，之後鑰匙圈被鎖定（例如在睡眠或閒置時），就可能發生這種情況。1499您已使用 claude.ai 登入，但 Claude Code 無法將登入儲存至其憑證儲存區，因此登入未完成。在 macOS 上，如果 Claude Code 在同一個工作階段中已經讀取或儲存過登入鑰匙圈中的憑證，之後鑰匙圈被鎖定（例如在睡眠或閒置時），就可能發生這種情況。

2442 2467 

2443### 上下文超過 token 限制2468### 上下文超過 token 限制

2444 2469 

2445`/context` 顯示此警告在其輸出頂部，當對話超過模型的上下文視窗時。在您釋放空間之前，請求會因 [`Prompt is too long`](#prompt-is-too-long) 而失敗。互動式工作階段將該錯誤顯示為 `Context limit reached` 行。2470當對話已超出模型的上下文視窗時，`/context` 會在輸出頂端顯示此警告：

2446 2471 

2447```text theme={null}2472```text theme={null}

2448Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.2473Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

2449```2474```

2450 2475 

2476出現 `Context exceeds` 警告後，只要[自動壓縮](https://code.claude.com/docs/zh-TW/settings-reference.md#autocompactenabled)處於開啟狀態（預設值），您就不需要執行任何一個命令：

2477 

2478* **自動壓縮開啟**：送出您的下一則訊息。若仍以 [`Prompt is too long`](#prompt-is-too-long) 失敗，請參閱該項目。

2479* **自動壓縮關閉**：在工作階段中，若警告提到 `/compact` 則執行它，或執行 `/clear` 重新開始。在您執行其中之一之前，訊息會以 `Context limit reached` 失敗，在 `-p` 輸出中則為 `Prompt is too long`。

2480 

2451當您超過的限制是壓縮視窗（例如 1M 上下文模型上的 200K 邊界）時，警告的讀取方式不同。壓縮視窗可以位於模型的上下文視窗下方，因此超過它的請求仍然可以成功。2481當您超過的限制是壓縮視窗（例如 1M 上下文模型上的 200K 邊界）時，警告的讀取方式不同。壓縮視窗可以位於模型的上下文視窗下方，因此超過它的請求仍然可以成功。

2452 2482 

2453```text theme={null}2483```text theme={null}

2458 2488 

2459**該怎麼辦：**2489**該怎麼辦：**

2460 2490 

2461* 在多回合對話中，執行 `/compact` 以總結較早的回合並釋放空間。若要改為重新開始，請執行 `/clear`2491* **出現壓縮視窗警告後**：在多回合對話中，執行 `/compact` 摘要較早的回合以釋放空間。若要改為重新開始，請執行 `/clear`。

2462* 有關減少使用的更多方式，請參閱 [Prompt is too long](#prompt-is-too-long)2492* 有關減少使用的更多方式，請參閱 [Prompt is too long](#prompt-is-too-long)

2463 2493 

2464在 v2.1.216 之前，`/context` 顯示超過 100% 的使用情況，沒有警告行解釋這意味著什麼或如何恢復。2494在 v2.1.216 之前，`/context` 顯示超過 100% 的使用情況，沒有警告行解釋這意味著什麼或如何恢復。

3302 3332 

3303### Configuration error in \~/.claude.json3333### Configuration error in \~/.claude.json

3304 3334 

3305Claude Code 無法解析 `~/.claude.json`，這是存放您帳戶詳細資料、MCP 伺服器與各專案狀態的檔案。您的檔案並未變更。`claude -p` 等[非互動](https://code.claude.com/docs/zh-TW/headless.md)啟動每次都會以退出碼 1 結束，直到您修復該檔案為止。3335Claude Code 無法解析 `~/.claude.json`，也就是保存您的帳戶資訊、MCP 伺服器與各專案狀態的檔案。[非互動式](https://code.claude.com/docs/zh-TW/headless.md)啟動（例如 `claude -p`）會以退出碼 1 結束。

3306 3336 

3307當 Claude Code 找到[備份](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)時，輸出會指名該備份，並輸出一行將其複製回來的 `cp` 命令：3337當 Claude Code 找到[備份](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)時，輸出會指名該備份，並輸出一行將其複製回來的 `cp` 命令：

3308 3338 

3317 3347 

3318**處理方式：**3348**處理方式：**

3319 3349 

3320* **輸出中有 `cp` 行**：在終端機中執行該行。在 Windows 上，請在 PowerShell 中執行。它會以備份（`~/.claude.json` 的較早版本）取代損壞的檔案。3350* **輸出中有 `cp` 行**：在終端機中執行該行。在 Windows 上，請在 PowerShell 中執行。

3321* **輸出中沒有 `cp` 行，或執行後錯誤再次出現**：修正 `~/.claude.json` 中的 JSON；如果 [`~/.claude/backups/`](https://code.claude.com/docs/zh-TW/claude-directory#cleaned-up-automatically) 中有其他 `.claude.json.backup.<timestamp>` 檔案，可將其複製覆蓋該檔案；或將該檔案重新命名。當 `~/.claude.json` 不存在時，Claude Code 會以預設設定啟動，且不含該檔案原本保存的任何內容。3351* **輸出中沒有 `cp` 行，或執行後錯誤再次出現**：若 `~/.claude.json` 仍保有您的設定，請修正其 JSON。若無法修正，若 [`~/.claude/backups/`](https://code.claude.com/docs/zh-TW/claude-directory#cleaned-up-automatically) 中有其他 `.claude.json.backup.<timestamp>` 檔案，請將其複製過去覆寫該檔案，或將該檔案重新命名。若 `~/.claude.json` 不存在，Claude Code 會以預設設定啟動，且不會保有該檔案原本的任何內容。

3322 3352* **`~/.claude.json` 已不再保有您的設定**：在 [`~/.claude/backups/`](https://code.claude.com/docs/zh-TW/claude-directory#cleaned-up-automatically) 或您的家目錄中找出仍保有設定的 `.claude.json.corrupted.<timestamp>` 檔案。修正其 JSON，然後將其複製過去覆寫 `~/.claude.json`。若找不到或無法修正，請以保有您設定的 `.claude.json.backup.<timestamp>` 檔案嘗試相同步驟。若都沒有，請將 `~/.claude.json` 重新命名，並以 [`claude mcp add`](https://code.claude.com/docs/zh-TW/mcp#installing-mcp-servers) 重新加入您的 MCP 伺服器。

3323在 v2.1.318 之前，非互動啟動輸出此錯誤後，`~/.claude.json` 中只會留下預設值，因此下次啟動時不會套用您的設定。

3324 3353 

3325### Claude configuration file was empty and no backup holds anything3354### Claude configuration file was empty and no backup holds anything

3326 3355 

3381 3410 

3382在 v2.1.309 之前，當磁碟區已滿或您的配額已用完時，Claude Code 只會印出作業系統的錯誤文字。例如 `ENOSPC: no space left on device, mkdir '/tmp/claude-501'`，處理步驟相同。3411在 v2.1.309 之前，當磁碟區已滿或您的配額已用完時，Claude Code 只會印出作業系統的錯誤文字。例如 `ENOSPC: no space left on device, mkdir '/tmp/claude-501'`，處理步驟相同。

3383 3412 

3413### Claude Code 因磁碟已滿而無法儲存

3414 

3415在 [`claude -p`](https://code.claude.com/docs/zh-TW/headless) 執行後，stderr 上出現這一行表示磁碟已滿或您的磁碟配額已用盡，因此 Claude Code 無法儲存該次執行的所有內容：

3416 

3417```text wrap theme={null}

3418Error: Claude Code could not save all of this session's transcript under /Users/you/.claude because the disk is full (ENOSPC). If you resume this session, part of the conversation may be missing. Free up space on that disk before the next run.

3419```

3420 

3421使用文字或 `json` 輸出時，該次執行會以退出碼 1 結束，而答案已經印出。使用 `stream-json` 輸出時，該次執行會維持其一般的退出碼，答案仍會送達。

3422 

3423**處理方式：**

3424 

3425* **`the disk is full (ENOSPC)`**：在下次執行前，釋放包含訊息中路徑之磁碟上的空間

3426* **`your disk quota is used up (EDQUOT)`**：在下次執行前，釋放空間或要求更大的配額

3427 

3384### 目錄無法解析為實際位置3428### 目錄無法解析為實際位置

3385 3429 

3386您對工作目錄的子目錄執行了 `/add-dir`，而 Claude Code 無法將該目錄解析為其實際位置。3430您對工作目錄的子目錄執行了 `/add-dir`，而 Claude Code 無法將該目錄解析為其實際位置。

3448* **`Error: Workspace not trusted. <folder> is your home directory`**：由於對家目錄的信任永遠不會被儲存，先在那裡執行 `claude` 並沒有幫助。請改從專案目錄執行 `claude ultrareview`（事先在那裡執行一次 `claude` 以接受信任對話框），或附加 `--trust-workspace`。3492* **`Error: Workspace not trusted. <folder> is your home directory`**：由於對家目錄的信任永遠不會被儲存，先在那裡執行 `claude` 並沒有幫助。請改從專案目錄執行 `claude ultrareview`（事先在那裡執行一次 `claude` 以接受信任對話框），或附加 `--trust-workspace`。

3449* **`No answer in time.` 後接 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 問題在 5 分鐘內未獲回答。請再次執行 `claude ultrareview` 並回答它。3493* **`No answer in time.` 後接 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 問題在 5 分鐘內未獲回答。請再次執行 `claude ultrareview` 並回答它。

3450* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 問題中拒絕了，例如回答 `n` 或按下 Enter。若要啟動審查，請再次執行 `claude ultrareview` 並回答 `y`。3494* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 問題中拒絕了，例如回答 `n` 或按下 Enter。若要啟動審查，請再次執行 `claude ultrareview` 並回答 `y`。

3451* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 之後跟著非旗標的內容，例如 PR 編號或 `false`。如果您不信任該資料夾，請省略此旗標。若要在此次執行中信任它，請將 PR 編號或基礎分支放在旗標之前：`claude ultrareview 1234 --trust-workspace`。3495* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 後面接了旗標以外的內容，例如 PR 編號或 `false`。若您不信任該資料夾，請省略此旗標。若要在此次執行中信任它，請將 PR 編號或基礎分支放在旗標之前：`claude ultrareview 1234 --trust-workspace`。

3452 3496 

3453在 v2.1.309 之前，`claude ultrareview` 不接受 `--trust-workspace`。3497在 v2.1.309 之前，`claude ultrareview` 不接受 `--trust-workspace`。

3454 3498 

3499### Remote Control 因問題未獲回答而未啟動

3500 

3501此訊息表示 [`claude remote-control`](https://code.claude.com/docs/zh-TW/remote-control) 詢問了訊息中引述的首次執行問題，但沒有得到回答：

3502 

3503```text theme={null}

3504Remote Control did not start: "Enable Remote Control?" got no answer. Run `claude remote-control` at a terminal and answer y once; it won't ask again.

3505Remote Control did not start: "Choose [1/2] (default: 1):" got no answer. You can run `claude remote-control` and choose, or pass --spawn=same-dir or --spawn=worktree.

3506```

3507 

3508**處理方式：**

3509 

3510* **`Enable Remote Control?`**：在腳本或服務中，標準輸入會在任何人能回答之前結束。請以您的腳本或服務執行時所用的使用者身分，在終端機中執行一次 `claude remote-control` 並回答 `y`。

3511* **`Choose [1/2] (default: 1):`**：再次執行 `claude remote-control` 並[選擇產生模式](https://code.claude.com/docs/zh-TW/remote-control.md#set-the-default-spawn-mode-for-a-project)，或傳入 [`--spawn=same-dir` 或 `--spawn=worktree`](https://code.claude.com/docs/zh-TW/remote-control#start-a-remote-control-session) 以跳過此問題

3512 

3455### 不會傳遞到 Remote Control 所啟動的工作階段3513### 不會傳遞到 Remote Control 所啟動的工作階段

3456 3514 

3457您在 `remote-control` 動詞之前加上了全域 `claude` 旗標來啟動 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md)，而該旗標會限制或設定 Remote Control 所啟動的工作階段，例如 `--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools` 或 `--mcp-config`。放在動詞之前的旗標永遠不會傳到這些工作階段。Claude Code 會改為拒絕啟動，並指出該旗標：3515您在 `remote-control` 動詞之前加上了全域 `claude` 旗標來啟動 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md)，而該旗標會限制或設定 Remote Control 所啟動的工作階段，例如 `--settings`、`--setting-sources`、`--permission-mode`、`--disallowed-tools` 或 `--mcp-config`。放在動詞之前的旗標永遠不會傳到這些工作階段。Claude Code 會改為拒絕啟動，並指出該旗標：

3741 3799 

3742以下同類字串會在命令執行之前就觸發：3800以下同類字串會在命令執行之前就觸發：

3743 3801 

3744* `Shell command permission check failed for pattern "..."`：命令的權限檢查不允許該命令。[注入命令的權限檢查](https://code.claude.com/docs/zh-TW/skills.md#permission-checks-on-injected-commands)說明了各權限模式下哪些結果會中止，以及如何使用 `allowed-tools` 預先核准命令3802* `Shell command permission check failed for pattern "..."`：該命令的權限檢查不允許它。[注入命令的權限檢查](https://code.claude.com/docs/zh-TW/skills.md#permission-checks-on-injected-commands)說明了在各權限模式下哪些結果會中止，以及如何以 `allowed-tools` 預先核准命令

3745* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：skill 的 frontmatter 要求使用 bash，但電腦上沒有 bash。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](https://code.claude.com/docs/zh-TW/skills.md#how-injected-commands-run)3803* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：該 skill 的 frontmatter 要求在沒有 bash 的電腦上使用 bash。請安裝 Git for Windows，或將 frontmatter 改為 `shell: powershell`。請參閱[注入命令的執行方式](https://code.claude.com/docs/zh-TW/skills.md#how-injected-commands-run)

3746 3804 

3747**處理方式：**3805**處理方式：**

3748 3806 

3895 3953 

3896* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支進行比較，並建議您明確傳入基底分支，如上例所示3954* **您沒有傳入基底分支**：Claude Code 與儲存庫的預設分支進行比較，並建議您明確傳入基底分支，如上例所示

3897* **您傳入的基底分支已存在於您的複製中**：提示內容為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3955* **您傳入的基底分支已存在於您的複製中**：提示內容為 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3898* **您傳入的基礎分支不在您的 clone 中**：Claude Code 在比較前先從 origin 擷取了該分支。提示內容為 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；當 Claude Code 無法判斷您的 clone 是否為淺層 clone 時，它會改為建議 `git fetch --unshallow origin`。在 v2.1.221 之前，提示會對每個擷取的基礎分支都建議 `git fetch --unshallow origin`，而在完整的 clone 上，該命令會以 `fatal: --unshallow on a complete repository does not make sense` 失敗。3956* **您傳入的基礎分支不在您的複製中**：Claude Code 在比較前會先從 origin 擷取該分支。提示內容為 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；當 Claude Code 無法判斷您的複製是否為淺層複製時，會改為建議 `git fetch --unshallow origin`。在 v2.1.221 之前，提示會針對每個擷取的基礎分支建議 `git fetch --unshallow origin`，而在完整的複製上，該命令會以 `fatal: --unshallow on a complete repository does not make sense` 失敗。

3899 3957 

3900**處理方式：**3958**處理方式：**

3901 3959 

4457* 如果訊息以 `EACCES` 結尾，請恢復您在通往該路徑所指檔案或資料夾的每個目錄上的執行權限。檢查該路徑上方的目錄，然後追蹤您遇到的每個符號連結，並檢查通往其指向位置的目錄。對於任何其他錯誤代碼，請在 [無法檢查之路徑的原因與步驟](#path-could-not-be-checked) 中查詢。4515* 如果訊息以 `EACCES` 結尾，請恢復您在通往該路徑所指檔案或資料夾的每個目錄上的執行權限。檢查該路徑上方的目錄，然後追蹤您遇到的每個符號連結，並檢查通往其指向位置的目錄。對於任何其他錯誤代碼，請在 [無法檢查之路徑的原因與步驟](#path-could-not-be-checked) 中查詢。

4458* 若要與同一 marketplace 中的其他 plugin 共享檔案，請使用 plugin 目錄內的符號連結連結它們，遵循 [符號連結規則](https://code.claude.com/docs/zh-TW/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)4516* 若要與同一 marketplace 中的其他 plugin 共享檔案，請使用 plugin 目錄內的符號連結連結它們，遵循 [符號連結規則](https://code.claude.com/docs/zh-TW/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

4459 4517 

4518### 未讀取伺服器檔案路徑

4519 

4520`path not read` 訊息表示 Claude Code 因為檔案的路徑，而未讀取 plugin 所指定的 MCP 或 LSP 伺服器檔案。plugin 的其餘部分會載入，但不包含該檔案所定義的伺服器。

4521 

4522即使路徑保持在 plugin 內，`..` 部分仍會被計入，如以下範例：

4523 

4524```text theme={null}

4525mcp-servers path not read: ./sub/../x.json is absolute or has a ".." part

4526```

4527 

4528**該怎麼做：**

4529 

4530* 如果您安裝了該 plugin 但並未維護它，請將訊息回報給其作者

4531* 如果您維護該 plugin，請將伺服器檔案保留在 plugin 目錄內。在 manifest 或 marketplace 項目中，以 `./` 開頭且不含 `..` 的路徑指定它，例如 `./servers/x.json`

4532* 若要在同一 marketplace 中的 plugin 之間共享一個伺服器檔案，請使用符號連結將該檔案連結到每個 plugin 中，遵循 [符號連結規則](https://code.claude.com/docs/zh-TW/plugins/host-marketplace.md#share-files-within-a-marketplace-with-symlinks)

4533 

4460### Plugin 未載入：未讀取其 manifest4534### Plugin 未載入：未讀取其 manifest

4461 4535 

4462Claude Code 無法確認 marketplace plugin 位於 `.claude-plugin/plugin.json` 的 [manifest](https://code.claude.com/docs/zh-TW/plugins/manifest-reference.md) 在 plugin 內，因此不會從該 plugin 載入任何內容。對於 [本機 marketplace](https://code.claude.com/docs/zh-TW/plugins/loading.md#in-place-and-copied-plugins) 中的 plugin，Claude Code 也無法確認該 manifest 位於該 marketplace 內。此訊息會出現在 `/plugin` **Errors** 標籤中，而訊息結尾的原因說明了 Claude Code 發現的情況。4536Claude Code 無法確認 marketplace plugin 位於 `.claude-plugin/plugin.json` 的 [manifest](https://code.claude.com/docs/zh-TW/plugins/manifest-reference.md) 在 plugin 內，因此不會從該 plugin 載入任何內容。對於 [本機 marketplace](https://code.claude.com/docs/zh-TW/plugins/loading.md#in-place-and-copied-plugins) 中的 plugin，Claude Code 也無法確認該 manifest 位於該 marketplace 內。此訊息會出現在 `/plugin` **Errors** 標籤中，而訊息結尾的原因說明了 Claude Code 發現的情況。

5065 5139 

5066在 v2.1.280 之前，`where it leads on disk could not be determined` 拒絕不會出現。5140在 v2.1.280 之前，`where it leads on disk could not be determined` 拒絕不會出現。

5067 5141 

5142### The search failed, so this is not a "no matches" result

5143 

5144Claude 執行的 [Grep](https://code.claude.com/docs/zh-TW/tools-reference.md#grep-tool-behavior) 或 [Glob](https://code.claude.com/docs/zh-TW/tools-reference.md#glob-tool-behavior) 搜尋在傳回任何結果之前就失敗了，因此無法得知是否存在相符項目。Claude 收到用以取代結果的訊息開頭如下：

5145 

5146```text wrap theme={null}

5147The search failed, so this is not a "no matches" result: matches may exist. What happened to the search program (ripgrep) is not known, and no results were read. Run the search once more. If it fails again, tell the user that searches are failing.

5148```

5149 

5150**處理方式：**

5151 

5152* **第一次出現時**：無需任何動作。訊息會要求 Claude 先再次搜尋。

5153* **如果 Claude 表示搜尋持續失敗**：擷取 ripgrep 的錯誤以用於錯誤回報：

5154 1. 從您的 shell 啟動一個工作階段，使用與搜尋失敗之工作階段相同的旗標，並加上 [`--debug-file claude-debug.log`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags)

5155 2. 向 Claude 傳送導致搜尋失敗的請求

5156 3. 如果搜尋再次失敗，請在 `claude-debug.log` 中找出包含 `rg error (signal=` 的那一行

5157 4. 在您 [回報問題](#report-an-error) 時附上該行

5158 

5068### Task output swap refused5159### Task output swap refused

5069 5160 

5070Claude Code 會將每個 Bash 命令的輸出儲存到其暫存目錄下的檔案中。每次開啟這些檔案時，它都會檢查路徑是否仍通往它所建立的檔案，且沒有符號連結、額外的硬連結或被移動的目錄將其重新導向。此訊息表示該檢查失敗，因此 Claude Code 拒絕了該操作，而不是透過該路徑寫入或讀取輸出。訊息會出現在 Bash 工具結果中：5161Claude Code 會將每個 Bash 命令的輸出儲存到其暫存目錄下的檔案中。每次開啟這些檔案時，它都會檢查路徑是否仍通往它所建立的檔案，且沒有符號連結、額外的硬連結或被移動的目錄將其重新導向。此訊息表示該檢查失敗，因此 Claude Code 拒絕了該操作，而不是透過該路徑寫入或讀取輸出。訊息會出現在 Bash 工具結果中：

5153 5244 

5154在 v2.1.296 之前，Edit 和 NotebookEdit 會套用這類編輯，並將無法解碼的每個位元組儲存為 `U+FFFD`。若您使用的是這些版本，請更新 Claude Code。5245在 v2.1.296 之前，Edit 和 NotebookEdit 會套用這類編輯，並將無法解碼的每個位元組儲存為 `U+FFFD`。若您使用的是這些版本，請更新 Claude Code。

5155 5246 

5247### Refusing to apply edits: a hook is configured for file edits in this session

5248 

5249Claude 嘗試以 [一步更新](https://code.claude.com/docs/zh-TW/artifacts.md#turn-off-one-step-artifact-updates) 發佈 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md)，也就是在發佈時一併包含對該 artifact 檔案的小幅變更，而 Claude Code 拒絕了。沒有發佈任何內容，檔案也未變更。訊息會出現在 Artifact 工具結果中：

5250 

5251```text wrap theme={null}

5252Refusing to apply edits to <path>: a hook is configured for file edits in this session, so a publish can't apply edits here. Edit the file, then publish it without edits. Nothing was published.

5253```

5254 

5255當您的工作階段有針對 `Edit` 或 `Write` 的 [`PreToolUse` hook](https://code.claude.com/docs/zh-TW/hooks#pretooluse) 或 [mod](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md) 時，Claude Code 不允許一步更新。

5256 

5257**處理方式：**

5258 

5259* 如果 Claude 接著編輯了檔案並將其發佈，則無需任何動作

5260* 如果 Claude 在此訊息處停止，請要求 Claude 編輯檔案並發佈

5261* 如果訊息持續出現，請結束並重新啟動 Claude Code

5262* 如果重新啟動後訊息仍再次出現，請 [關閉一步更新](https://code.claude.com/docs/zh-TW/artifacts.md#turn-off-one-step-artifact-updates)

5263 

5156### The source file is not valid UTF-8 text5264### The source file is not valid UTF-8 text

5157 5265 

5158Claude 嘗試從一個位元組無法解碼為文字、或其文字已包含替代字元 `U+FFFD` 的檔案發佈 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md)，因此 Claude Code 在上傳任何內容之前就拒絕了發佈。訊息會出現在 Artifact 工具結果中，並指出第一個需要修正的位置：5266Claude 嘗試從一個位元組無法解碼為文字、或其文字已包含替代字元 `U+FFFD` 的檔案發佈 [artifact](https://code.claude.com/docs/zh-TW/artifacts.md)，因此 Claude Code 在上傳任何內容之前就拒絕了發佈。訊息會出現在 Artifact 工具結果中，並指出第一個需要修正的位置：

5623 5731 

5624* 重新建立訊息指出的目錄，或從存在的目錄分派，然後再試一次5732* 重新建立訊息指出的目錄，或從存在的目錄分派，然後再試一次

5625 5733 

5734### This forked session could not be started

5735 

5736您從 claude.ai [分叉了 Remote Control 工作階段](https://code.claude.com/docs/zh-TW/remote-control.md#fork-a-session-from-your-browser)，而 Claude Code 無法完成啟動在您機器上執行該分叉的[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)。此通知會出現在分叉工作階段的逐字稿中：

5737 

5738```text theme={null}

5739This forked session could not be started. Fork the conversation again to retry.

5740```

5741 

5742您分叉的工作階段會繼續執行。

5743 

5744**該怎麼做：**

5745 

5746* 回到您分叉的工作階段，並在該工作階段閒置後再次分叉它

5747 

5626### 分派背景工作階段時工作區未信任5748### 分派背景工作階段時工作區未信任

5627 5749 

5628您在尚未[信任](https://code.claude.com/docs/zh-TW/permissions.md#project-allow-rules-and-workspace-trust)的目錄中啟動或重新啟動[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)，而工作區信任對話框無法出現來詢問您。Claude Code 不會啟動工作階段：5750您在尚未[信任](https://code.claude.com/docs/zh-TW/permissions.md#project-allow-rules-and-workspace-trust)的目錄中啟動或重新啟動[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)，而工作區信任對話框無法出現來詢問您。Claude Code 不會啟動工作階段：

12 12 

13快速模式是支援模型的高速設定，使模型速度提升最高 2.5 倍，但每個 token 的成本更高。當您需要速度進行互動式工作（如快速迭代或即時除錯）時，使用 `/fast` 切換開啟；當成本比延遲更重要時，則切換關閉。13快速模式是支援模型的高速設定，使模型速度提升最高 2.5 倍，但每個 token 的成本更高。當您需要速度進行互動式工作（如快速迭代或即時除錯）時，使用 `/fast` 切換開啟；當成本比延遲更重要時，則切換關閉。

14 14 

15快速模式使用相同的模型，搭配以速度優先於成本效率的不同 API 設定，因此品質和功能維持不變。快速模式在 Fable 5.2、Opus 5.5、Opus 5 和 Opus 4.8 上受支援。它在 Sonnet、Haiku 或其他模型上不可用。15快速模式使用相同的模型，搭配以速度優先於成本效率的不同 API 設定，因此品質和功能維持不變。在 Anthropic API 上，快速模式在 Fable 5.2、Opus 5.5、Opus 5 和 Opus 4.8 上受支援，但在 Sonnet、Haiku 或其他模型上不受支援。關於 Google Cloud 的 Agent Platform 上的模型，請參閱[在 Agent Platform 上使用快速模式](#use-fast-mode-on-agent-platform)。

16 16 

17> [!WARNING]17> [!WARNING]

18>18>

25 25 

26需要了解的事項：26需要了解的事項：

27 27 

28* 使用 `/fast` 在 Claude Code CLI 中切換快速模式。[VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md)在選定的模型支援快速模式時提供**切換快速模式**命令。Claude Code 將該切換儲存到您的 [`fastMode` 設定](#toggle-fast-mode)。28* 使用 `/fast` 在 Claude Code CLI 中切換快速模式。[VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md)在選定的模型支援快速模式時提供**切換快速模式**命令。在 Anthropic API 上，Claude Code 會將該切換儲存到您的 [`fastMode` 設定](#toggle-fast-mode)。

29* 快速模式每 MTok 輸入/輸出的定價在 Fable 5.2 上為 \$16/\$80，在 Opus 5.5 上為 \$8/\$40，在 Opus 5 和 Opus 4.8 上為 \$10/\$50。29* Anthropic 的快速模式每 MTok 輸入/輸出的定價在 Fable 5.2 上為 \$16/\$80，在 Opus 5.5 上為 \$8/\$40，在 Opus 5 和 Opus 4.8 上為 \$10/\$50。

30* 適用於訂閱方案（Pro/Max/Ultra/Team/Enterprise）上的 Claude Code 使用者和 Claude Console。Team 和 Enterprise 組織需要擁有者先啟用它，Console 組織則需要先佈建存取權限，才能搭配 Opus 5 或 Opus 4.8 使用。[需求](#requirements)說明了這兩者。30* 適用於訂閱方案（Pro/Max/Ultra/Team/Enterprise）上的 Claude Code 使用者、Claude Console，以及[在特定條件下](#use-fast-mode-on-agent-platform)適用於 Google Cloud 的 Agent Platform。Team 和 Enterprise 組織需要擁有者先啟用它，Console 組織則需要先佈建存取權限，才能搭配 Opus 5 或 Opus 4.8 使用。[需求](#requirements)說明了這兩者。

31* 對於訂閱方案（Pro/Max/Ultra/Team/Enterprise）上的 Claude Code 使用者，快速模式僅透過用量點數提供，不包含在訂閱速率限制中。31* 對於訂閱方案（Pro/Max/Ultra/Team/Enterprise）上的 Claude Code 使用者，快速模式僅透過用量點數提供，不包含在訂閱速率限制中。

32 32 

33## 切換快速模式33## 切換快速模式

34 34 

35在 Agent Platform 上，`/fast` 與 `fastMode` 設定的運作方式不同，因此請改為依照[在 Agent Platform 上使用快速模式](#use-fast-mode-on-agent-platform)的說明操作。

36 

35在 CLI 中，可透過以下任一方式切換快速模式：37在 CLI 中，可透過以下任一方式切換快速模式：

36 38 

37* 執行 `/fast`，按 Space 切換開啟或關閉，然後按 Enter 確認39* 執行 `/fast`，按 Space 切換開啟或關閉，然後按 Enter 確認

38* 在支援快速模式的模型上，於您的[使用者設定檔](https://code.claude.com/docs/zh-TW/settings.md)中設定 `"fastMode": true`。如果您在其他任何模型上設定此項，您會繼續使用該模型，且快速模式保持關閉。在 Fable 5.2 上，僅有此設定並不會產生作用，直到您在使用 Fable 5.2 時執行 `/fast`。40* 在支援快速模式的模型上，於您的[使用者設定檔](https://code.claude.com/docs/zh-TW/settings.md)中設定 `"fastMode": true`。如果您在其他任何模型上設定此項，您會繼續使用該模型，且快速模式保持關閉。在 Fable 5.2 上，僅有此設定並不會產生作用，直到您在使用 Fable 5.2 時執行 `/fast`。

39 41 

40預設情況下，在互動式工作階段中開啟的快速模式會在支援的模型上跨工作階段保留。在 Fable 5.2 上，只有在您[於使用 Fable 5.2 時開啟](#switch-models-while-fast-mode-is-on)的情況下才會保留。您可以將快速模式設定為在每個工作階段重設。詳情請參閱[要求每個工作階段選擇加入](#require-per-session-opt-in)。42在 Anthropic API 上，預設情況下，在互動式工作階段中開啟的快速模式會在支援的模型上跨工作階段保留。在 Fable 5.2 上，只有在您[於使用 Fable 5.2 時開啟](#switch-models-while-fast-mode-is-on)的情況下才會保留。您可以將快速模式設定為在每個工作階段重設。詳情請參閱[要求每個工作階段選擇加入](#require-per-session-opt-in)。

41 43 

42在[雲端工作階段](#use-fast-mode-in-cloud-sessions)之外，於使用 `-p` 旗標的[非互動模式](https://code.claude.com/docs/zh-TW/headless.md)中，`/fast` 僅在其 [`--settings`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 值中啟用快速模式所啟動的工作階段中有效，例如 `claude -p --settings '{"fastMode": true}'`；此時切換僅套用於該工作階段，不會儲存為您的預設值。`-p` 形式需要 Claude Code v2.1.205 或更新版本。在其他非互動模式情況下，該命令會回報快速模式無法使用。44在[雲端工作階段](#use-fast-mode-in-cloud-sessions)之外，於使用 `-p` 旗標的[非互動模式](https://code.claude.com/docs/zh-TW/headless.md)中，`/fast` 僅在其 [`--settings`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 值中啟用快速模式所啟動的工作階段中有效，例如 `claude -p --settings '{"fastMode": true}'`；此時切換僅套用於該工作階段，不會儲存為您的預設值。`-p` 形式需要 Claude Code v2.1.205 或更新版本。在其他非互動模式情況下，該命令會回報快速模式無法使用。

43 45 

47 49 

48當您使用 `/fast` 啟用快速模式時：50當您使用 `/fast` 啟用快速模式時：

49 51 

50* 如果您目前的模型不支援快速模式，Claude Code 會切換至 Opus52* 在 Anthropic API 上，如果您目前的模型不支援快速模式，Claude Code 會切換至 Opus

51* 在 Fable 5.2 上使用快速模式需要 Claude Code v2.1.321 或更新版本53* 在 Fable 5.2 上使用快速模式需要 Claude Code v2.1.321 或更新版本

52* 您會看到確認訊息："Fast mode ON"54* 您會看到確認訊息："Fast mode ON"

53* 快速模式啟用期間，提示詞旁會出現一個小型 `↯` 圖示55* 快速模式啟用期間，提示詞旁會出現一個小型 `↯` 圖示

54* 隨時再次執行 `/fast` 即可檢查快速模式是開啟還是關閉56* 隨時再次執行 `/fast` 即可檢查快速模式是開啟還是關閉

55 57 

56在 Claude Code v2.1.280 及更新版本中，Opus 5.5 是快速模式的預設模型。在 v2.1.280 之前，從 v2.1.219 起快速模式預設使用 Opus 5。58在 Anthropic API 上，於 Claude Code v2.1.280 及更新版本中，Opus 5.5 是快速模式的預設模型。在 v2.1.280 之前，從 v2.1.219 起快速模式預設使用 Opus 5。

57 59 

58當您再次使用 `/fast` 停用快速模式時，您會繼續使用目前的模型。若要切換至其他模型，請使用 `/model`。60當您再次使用 `/fast` 停用快速模式時，您會繼續使用目前的模型。若要切換至其他模型，請使用 `/model`。

59 61 

63 65 

64* **切換離開**：當您切換至不支援快速模式的模型時，Claude Code 會關閉快速模式。這包括 Opus 4.7；在 v2.1.221 之前，切換至 Opus 4.7 後快速模式仍保持開啟，且 API 會拒絕這些請求。66* **切換離開**：當您切換至不支援快速模式的模型時，Claude Code 會關閉快速模式。這包括 Opus 4.7；在 v2.1.221 之前，切換至 Opus 4.7 後快速模式仍保持開啟，且 API 會拒絕這些請求。

65* **切換回來**：當您儲存的偏好設定為開啟時，快速模式會在受支援的 Opus 模型上重新開啟。若已設定[每個工作階段選擇加入](#require-per-session-opt-in)，請改為執行 `/fast`。67* **切換回來**：當您儲存的偏好設定為開啟時，快速模式會在受支援的 Opus 模型上重新開啟。若已設定[每個工作階段選擇加入](#require-per-session-opt-in)，請改為執行 `/fast`。

66* **切換至 Fable 5.2**：除非您在使用 Fable 5.2 時開啟了快速模式，否則快速模式會關閉。若要開啟，請在 Fable 5.2 上執行 `/fast`。除非您已設定[每個工作階段選擇加入](#require-per-session-opt-in)，否則此設定會跨工作階段保留，直到您將其關閉，或在其他模型上將其開啟為止。68* **切換至 Fable 5.2**：除非您在使用 Fable 5.2 時開啟了快速模式，否則快速模式會關閉。若要開啟，請在 Fable 5.2 上執行 `/fast`。除非您已設定[每個工作階段選擇加入](#require-per-session-opt-in)，否則在 Anthropic API 上此選擇會跨工作階段保留，直到您關閉快速模式，或在其他模型上將其開啟為止。

67 69 

68每當模型切換開啟或關閉快速模式時，Claude Code 都會顯示 `Fast mode ON` 或 `Fast mode OFF` 確認訊息，且快速模式開啟期間會出現 `↯` 圖示。無論您是使用 `/model`、使用 [`/config model=<model>`](https://code.claude.com/docs/zh-TW/settings)，還是從透過 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 連線的裝置進行切換，皆是如此。70每當模型切換開啟或關閉快速模式時，Claude Code 都會顯示 `Fast mode ON` 或 `Fast mode OFF` 確認訊息，且快速模式開啟期間會出現 `↯` 圖示。無論您是使用 `/model`、使用 [`/config model=<model>`](https://code.claude.com/docs/zh-TW/settings)，還是從透過 [Remote Control](https://code.claude.com/docs/zh-TW/remote-control.md) 連線的裝置進行切換，皆是如此。

69 71 

70在模型切換、重新連線或[可用性檢查](#use-fast-mode-behind-proxies-and-llm-gateways)失敗後，Claude Code 會將工作階段的快速模式狀態重新傳送至透過 Remote Control 連線的裝置。

71 

72### 在雲端工作階段中使用快速模式72### 在雲端工作階段中使用快速模式

73 73 

74當您的帳戶可使用快速模式時，快速模式可在[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)中運作，無論該工作階段是在 Anthropic 管理的基礎架構上執行，還是在[自行託管的執行器](https://code.claude.com/docs/zh-TW/self-hosted-environments)上執行。工作階段的環境需要 Claude Code v2.1.271 或更新版本。74當您的帳戶可使用快速模式時，快速模式可在[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)中運作，無論該工作階段是在 Anthropic 管理的基礎架構上執行，還是在 Anthropic API 上的[自行託管的執行器](https://code.claude.com/docs/zh-TW/self-hosted-environments)上執行。工作階段的環境需要 Claude Code v2.1.271 或更新版本。

75 75 

76在工作階段中輸入 `/fast on` 即可開啟快速模式。它僅在該工作階段中保持開啟，不會儲存為您的預設值。[需求](#requirements)同樣適用於雲端工作階段。76在工作階段中輸入 `/fast on` 即可開啟快速模式。它僅在該工作階段中保持開啟，不會儲存為您的預設值。[需求](#requirements)同樣適用於雲端工作階段。

77 77 

79 79 

80## 了解成本權衡80## 了解成本權衡

81 81 

82快速模式的每個 token 定價高於標準速度：82快速模式的每個 token 定價高於標準速度。以下是 Anthropic 的費率：

83 83 

84| 模型 | 輸入 (MTok) | 輸出 (MTok) |84| 模型 | 輸入 (MTok) | 輸出 (MTok) |

85| - | - | - |85| - | - | - |

129 129 

130快速模式需要以下所有條件：130快速模式需要以下所有條件：

131 131 

132* **僅限 Anthropic API 或訂閱**：快速模式可透過 Anthropic Console API 和使用用量點數的 Claude 訂閱方案取得。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 AWS 上的 Claude Platform 上無法使用。Console 組織還必須[佈建快速模式存取](#enable-fast-mode-for-your-organization)，才能在 Opus 5 或 Opus 4.8 上使用它。132* **支援的提供者**：快速模式可透過 Anthropic Console API、使用用量點數的 Claude 訂閱方案，以及[在特定條件下](#use-fast-mode-on-agent-platform)透過 Google Cloud 的 Agent Platform 取得。在 Amazon Bedrock、Microsoft Foundry 或 AWS 上的 Claude Platform 上無法使用，在這些平台上 `/fast` 會報告「此提供者無法使用快速模式」。Console 組織還必須[佈建快速模式存取](#enable-fast-mode-for-your-organization)，才能在 Opus 5 或 Opus 4.8 上使用它。

133* **為訂閱方案開啟用量點數**：在 Pro、Max、Ultra、Team 或 Enterprise 方案上，您的帳戶必須開啟[用量點數](https://code.claude.com/docs/zh-TW/costs.md#add-usage-credits-to-your-subscription)，這允許超出您方案包含使用量的計費。在開啟之前，`/fast` 會報告「快速模式需要用量點數」。若要開啟它們，請依照您方案對應的步驟操作：133* **為訂閱方案開啟用量點數**：在 Pro、Max、Ultra、Team 或 Enterprise 方案上，您的帳戶必須開啟[用量點數](https://code.claude.com/docs/zh-TW/costs.md#add-usage-credits-to-your-subscription)，這允許超出您方案包含使用量的計費。在開啟之前，`/fast` 會報告「快速模式需要用量點數」。若要開啟它們，請依照您方案對應的步驟操作：

134 * 在 Pro、Max 和 Ultra 上，在 claude.ai 上的 [**設定 > 使用量**](https://claude.ai/settings/usage) 的 **用量點數** 部分開啟它們，或執行 `/usage-credits` 以開啟該頁面。134 * 在 Pro、Max 和 Ultra 上，在 claude.ai 上的 [**設定 > 使用量**](https://claude.ai/settings/usage) 的 **用量點數** 部分開啟它們，或執行 `/usage-credits` 以開啟該頁面。

135 * 在 Team 和 Enterprise 上，具有計費存取權限的成員在 [**組織設定 > 使用量**](https://claude.ai/admin-settings/usage) 為組織開啟它們，沒有存取權限的成員執行 `/usage-credits` 以向組織的管理員發送請求。135 * 在 Team 和 Enterprise 上，具有計費存取權限的成員在 [**組織設定 > 使用量**](https://claude.ai/admin-settings/usage) 為組織開啟它們，沒有存取權限的成員執行 `/usage-credits` 以向組織的管理員發送請求。

150> * **快速模式未啟用**：如果尚未為您的組織啟用快速模式，使用 `/fast` 開啟快速模式會顯示「快速模式已被您的組織停用。」150> * **快速模式未啟用**：如果尚未為您的組織啟用快速模式，使用 `/fast` 開啟快速模式會顯示「快速模式已被您的組織停用。」

151> * **快速模式被受管設定關閉**：如果您的組織部署[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)，設定 [`fastMode: false`](https://code.claude.com/docs/zh-TW/settings-reference#fastmode)，使用 `/fast` 開啟快速模式會顯示相同的「快速模式已被您的組織停用」訊息。151> * **快速模式被受管設定關閉**：如果您的組織部署[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)，設定 [`fastMode: false`](https://code.claude.com/docs/zh-TW/settings-reference#fastmode)，使用 `/fast` 開啟快速模式會顯示相同的「快速模式已被您的組織停用」訊息。

152> * **需要每個工作階段的選擇加入**：設定 [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) 的受管設定會在除了互動式終端工作階段以外的所有地方拒絕 `/fast on`，顯示相同的訊息。152> * **需要每個工作階段的選擇加入**：設定 [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) 的受管設定會在除了互動式終端工作階段以外的所有地方拒絕 `/fast on`，顯示相同的訊息。

153> * **快速模式模型不允許**：如果您組織的 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection) 允許清單排除快速模式 Opus 模型，開啟它會被拒絕，顯示「不在您組織的允許模型中」。在已在支援快速模式的允許模型上執行的工作階段中，`/fast` 改為在您目前的模型上啟用快速模式，而不是切換模型。153> * **快速模式模型不允許**：如果您組織的 [`availableModels`](https://code.claude.com/docs/zh-TW/model-config#restrict-model-selection) 允許清單排除了 `/fast` 要切換到的模型，開啟它會被拒絕，顯示「不在您組織的允許模型中」。在已在支援快速模式的允許模型上執行的工作階段中，`/fast` 改為在您目前的模型上啟用快速模式，而不是切換模型。

154 154 

155### 為您的組織啟用快速模式155### 為您的組織啟用快速模式

156 156 

163 163 

164另一個完全停用快速模式的選項是設定 `CLAUDE_CODE_DISABLE_FAST_MODE=1`。請參閱[環境變數](https://code.claude.com/docs/zh-TW/env-vars.md)。164另一個完全停用快速模式的選項是設定 `CLAUDE_CODE_DISABLE_FAST_MODE=1`。請參閱[環境變數](https://code.claude.com/docs/zh-TW/env-vars.md)。

165 165 

166### 在 Agent Platform 上使用快速模式

167 

168在 [Google Cloud 的 Agent Platform](https://code.claude.com/docs/zh-TW/google-vertex-ai.md) 上，您可以為 Fable 5.2 開啟快速模式，方法是在互動式工作階段中使用 `/fast`，或在[非互動模式](https://code.claude.com/docs/zh-TW/headless.md)中使用啟動旗標。需要 Claude Code v2.1.322 或更新版本。

169 

170快速模式需要 Fable 5.2 的[區域](https://code.claude.com/docs/zh-TW/google-vertex-ai.md#region-configuration)為 `global`、`us` 或 `eu`。在其他區域中，`/fast` 會報告 `Fast mode needs Vertex region global, us or eu`，而 `claude -p` 會以標準速度執行。請在啟動 Claude Code 之前於您的 shell 中設定區域，例如設定為 `global`：

171 

172```bash theme={null}

173export VERTEX_REGION_CLAUDE_FABLE_5_2=global

174```

175 

176接著開啟快速模式：

177 

178* **在互動式工作階段中**：執行 `/fast`。它會將您從 Opus 模型或 Agent Platform 上其他不支援快速模式的模型切換到 Fable 5.2。快速模式不會儲存為您的預設值。

179* **在非互動模式中**：以 [`--model`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 傳入 Fable 5.2，並在 [`--settings`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 中傳入快速模式，例如 `claude -p "Summarize this project" --model claude-fable-5-2 --settings '{"fastMode": true}'`

180 

181在 Agent Platform 上，您的使用者、專案、本機或受管設定中的 `"fastMode": true` 不會產生任何作用。

182 

183如果 Agent Platform 拒絕快速模式，Claude Code 會回退到標準速度。互動式工作階段接著會顯示下列其中一則終端機訊息：

184 

185* `Using standard speed on Fable 5.2 · fast mode wasn't available`：執行 `/fast on` 以再次嘗試快速模式

186* `Fast mode was refused for this project · trying again in 30m`：Agent Platform 以 403 或 404 錯誤回應了快速模式請求。若要更早嘗試，請執行 `/fast on`。

187 

166### 在代理和 LLM 閘道後面使用快速模式188### 在代理和 LLM 閘道後面使用快速模式

167 189 

168在提供快速模式之前，Claude Code 會透過直接向 `api.anthropic.com` 的請求檢查您組織的快速模式可用性。該檢查不遵循 [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-TW/llm-gateway-connect#set-the-base-url-and-credential)，因此在將 Claude 流量路由透過 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)並阻止直接出口到 `api.anthropic.com` 的網路上，即使推理請求有效，檢查也會失敗。該檢查確實使用已設定的 [HTTP 代理](https://code.claude.com/docs/zh-TW/network-config.md#proxy-configuration)，因此網路阻止只在 `api.anthropic.com` 即使透過代理也無法到達的地方才會使檢查失敗。190在 Anthropic API 上提供快速模式之前，Claude Code 會透過直接向 `api.anthropic.com` 的請求檢查您組織的快速模式可用性。該檢查不遵循 [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-TW/llm-gateway-connect#set-the-base-url-and-credential)，因此在將 Claude 流量路由透過 [LLM 閘道](https://code.claude.com/docs/zh-TW/llm-gateway)並阻止直接出口到 `api.anthropic.com` 的網路上，即使推理請求有效，檢查也會失敗。