Documentation 2026-11-02 23:57 UTC to 2026-11-03 23:58 UTC

79* 透過 HKLM 登錄或 `C:\Program Files\ClaudeCode` 檔案部署 `wslInheritsWindowsSettings: true`，以便 WSL 工作階段繼承與主機工作階段相同的政策。79* 透過 HKLM 登錄或 `C:\Program Files\ClaudeCode` 檔案部署 `wslInheritsWindowsSettings: true`，以便 WSL 工作階段繼承與主機工作階段相同的政策。

80* 透過在 WSL 工作階段內執行 `/status` 進行驗證，並讀取 `Setting sources` 行。若要解釋它列出的內容，請參閱[在 /status 中讀取來源](https://code.claude.com/docs/zh-TW/managed-settings.md#read-the-source-in-/status)。80* 透過在 WSL 工作階段內執行 `/status` 進行驗證，並讀取 `Setting sources` 行。若要解釋它列出的內容，請參閱[在 /status 中讀取來源](https://code.claude.com/docs/zh-TW/managed-settings.md#read-the-source-in-/status)。

81 81 

82如果 WSL 工作階段在設有 Claude Desktop [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/configuration#allowedworkspacefolders) 清單的裝置上啟動，`~` 項目代表發行版內的家目錄。

83 

82WSL 2 公用程式 VM 內的程序對 Windows 端端點偵測感應器不可見。若要觀察發行版內的程序和檔案活動，請檢查您的端點偵測廠商的 WSL 指南，以取得您可以在發行版內執行的 Linux 感應器及其需要的排除項目。Claude Code 的 [OpenTelemetry 工具執行遙測](https://code.claude.com/docs/zh-TW/monitoring-usage.md)對 WSL 和原生工作階段的發出方式相同。84WSL 2 公用程式 VM 內的程序對 Windows 端端點偵測感應器不可見。若要觀察發行版內的程序和檔案活動，請檢查您的端點偵測廠商的 WSL 指南，以取得您可以在發行版內執行的 Linux 感應器及其需要的排除項目。Claude Code 的 [OpenTelemetry 工具執行遙測](https://code.claude.com/docs/zh-TW/monitoring-usage.md)對 WSL 和原生工作階段的發出方式相同。

83 85 

84## 決定要執行什麼86## 決定要執行什麼

127 129 

128### 已連結的 GitHub 帳戶130### 已連結的 GitHub 帳戶

129 131 

130在 Team 和 Enterprise 方案中，[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) 的 GitHub 區段會列出透過 [Claude GitHub App](https://github.com/apps/claude) 連結至您 Claude 組織的 GitHub 組織和個人帳戶。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) 和 Claude Security 共用此清單。開啟此頁面需要您在 Claude 組織中具備管理員角色。132在 Team 和 Enterprise 方案中，[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) 的 GitHub 區段會列出透過 [Claude GitHub App](https://github.com/apps/claude) 連結至您 Claude 組織的 GitHub 組織和個人帳戶。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) 和 Claude Security 共用此清單。開啟此頁面需要您在 Claude 組織中具備[擁有者角色](https://code.claude.com/docs/zh-TW/server-managed-settings.md#access-control)。管理員角色無法開啟此頁面。

131 133 

132管理員或成員都可以連結帳戶：134任何人都可以從 Git providers 頁面或透過將 GitHub 連接至 Claude 來連結帳戶：

133 135 

134* **管理員連線**：管理員在該區段中點擊 **Connect**，或在已連結帳戶後點擊 **Add organization**，並在 GitHub 組織上安裝 Claude GitHub App。以此方式連結組織，需要一位同時是該 GitHub 組織擁有者及您 Claude 組織管理員的人員。136* **擁有者連線**：擁有者在該區段中點擊 **Connect**，或在已連結帳戶後點擊 **Add organization**，並在 GitHub 組織上安裝 Claude GitHub App。以此方式連結組織，需要一位同時是您 Claude 組織擁有者及該 GitHub 組織擁有者的人員。

135* **成員連線**：當成員將其 GitHub 帳戶連接至 Claude 時（例如在[設定雲端工作階段](https://code.claude.com/docs/zh-TW/web-quickstart.md#connect-github)期間），Claude 會連結該成員所擁有、且已安裝 Claude GitHub App 的 GitHub 帳戶。這可能包括其個人帳戶以及其擁有的 GitHub 組織。137* **成員連線**：當成員將其 GitHub 帳戶連接至 Claude 時（例如在[設定雲端工作階段](https://code.claude.com/docs/zh-TW/web-quickstart.md#connect-github)期間），Claude 會連結該成員所擁有、且已安裝 Claude GitHub App 的 GitHub 帳戶。這可能包括其個人帳戶以及其擁有的 GitHub 組織。

136 138 

137標示為 **Not linked** 的列來自您自己的 GitHub 登入。這是您在 GitHub 上可以看到、且已安裝 Claude GitHub App 的帳戶。139標示為 **Not linked** 的列來自您自己的 GitHub 登入。這是您在 GitHub 上可以看到、且已安裝 Claude GitHub App 的帳戶。

222>222>

223> `effort` 在每個回應內交換延遲和代幣成本以獲得推理深度。[擴展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 是一個單獨的功能，在輸出中產生 `thinking` 區塊，而 [Python](https://code.claude.com/docs/zh-TW/agent-sdk/python.md#thinkingconfig) 或 [TypeScript](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#thinkingconfig) 上 `ThinkingConfig` 的 `display` 欄位控制您是否接收其文字。它們是獨立的：您可以設定 `effort: "low"` 並啟用擴展思考，或 `effort: "max"` 而不啟用它。223> `effort` 在每個回應內交換延遲和代幣成本以獲得推理深度。[擴展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 是一個單獨的功能，在輸出中產生 `thinking` 區塊，而 [Python](https://code.claude.com/docs/zh-TW/agent-sdk/python.md#thinkingconfig) 或 [TypeScript](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#thinkingconfig) 上 `ThinkingConfig` 的 `display` 欄位控制您是否接收其文字。它們是獨立的：您可以設定 `effort: "low"` 並啟用擴展思考，或 `effort: "max"` 而不啟用它。

224 224 

225對於執行簡單、範圍明確的任務（如列出檔案或執行單個 grep）的代理程式，使用較低的努力來降低成本和延遲。在頂級 `query()` 選項中設定 `effort` 以用於整個工作階段，或在 [`AgentDefinition`](https://code.claude.com/docs/zh-TW/agent-sdk/subagents#agentdefinition-configuration) 上使用 `effort` 欄位以每個子代理程式為基礎覆蓋工作階段等級。225對於執行簡單、範圍明確的任務（如列出檔案或執行單個 grep）的 agent，使用較低的 effort 來降低成本和延遲。在頂層 `query()` 選項中設定 `effort` 以用於[工作階段](https://code.claude.com/docs/zh-TW/sub-agents.md#choose-an-effort-level)，或在 [`AgentDefinition`](https://code.claude.com/docs/zh-TW/agent-sdk/subagents#agentdefinition-configuration) 上使用 `effort` 欄位以每個 subagent 為基礎覆寫工作階段等級。

226 226 

227### 權限模式227### 權限模式

228 228 

224| `matcher` | `string` | `undefined` | 針對事件的篩選欄位比對的模式，遵循[設定檔中 matcher 的規則](https://code.claude.com/docs/zh-TW/hooks.md#matcher-patterns)。對於工具 hook，該欄位是工具名稱。內建工具包括 `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` 等。請參閱[工具輸入類型](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#tool-input-types)以取得完整列表。MCP 工具使用模式 `mcp__<server>__<action>`，其中 `<server>` 是您在 `mcpServers` 設定中使用的鍵，其拼寫方式依照[工具命名慣例](https://code.claude.com/docs/zh-TW/agent-sdk/mcp.md#tool-naming-convention)所述。 |224| `matcher` | `string` | `undefined` | 針對事件的篩選欄位比對的模式，遵循[設定檔中 matcher 的規則](https://code.claude.com/docs/zh-TW/hooks.md#matcher-patterns)。對於工具 hook，該欄位是工具名稱。內建工具包括 `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` 等。請參閱[工具輸入類型](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#tool-input-types)以取得完整列表。MCP 工具使用模式 `mcp__<server>__<action>`，其中 `<server>` 是您在 `mcpServers` 設定中使用的鍵，其拼寫方式依照[工具命名慣例](https://code.claude.com/docs/zh-TW/agent-sdk/mcp.md#tool-naming-convention)所述。 |

225| `hooks` | `HookCallback[]` | - | 必需。當模式比對成功時執行的回調函數陣列 |225| `hooks` | `HookCallback[]` | - | 必需。當模式比對成功時執行的回調函數陣列 |

226| `timeout` | `number` | `undefined` | 逾時時間（秒）。省略時，Claude Code 會套用[事件的預設逾時](#hook-timeout)。您的 SDK 回調遵循 `command` hook 預設值 |226| `timeout` | `number` | `undefined` | 逾時時間（秒）。省略時，Claude Code 會套用[事件的預設逾時](#hook-timeout)。您的 SDK 回調遵循 `command` hook 預設值 |

227| `onFailure` | `"continue" \| "block"` | `undefined` | 回調失敗時的處理方式。設定 `"block"` 以[在回調失敗時阻止該動作](#block-the-action-when-a-callback-fails)。在 Python 中，請使用 `on_failure` |

227 228 

228盡可能使用 `matcher` 模式來針對特定工具。帶有 `'Bash'` 的 matcher 只針對 Bash 命令執行，而省略模式會針對事件的每次出現執行您的回調。229盡可能使用 `matcher` 模式來針對特定工具。帶有 `'Bash'` 的 matcher 只針對 Bash 命令執行，而省略模式會針對事件的每次出現執行您的回調。

229 230 

283>284>

284> 非同步輸出無法阻止、修改或將上下文注入操作，因為 agent 已經繼續。僅將它們用於副作用，例如日誌記錄、指標或通知。285> 非同步輸出無法阻止、修改或將上下文注入操作，因為 agent 已經繼續。僅將它們用於副作用，例如日誌記錄、指標或通知。

285 286 

287### 在回調失敗時阻止該動作

288 

289在大多數事件中，如果回調拋出錯誤或返回未通過驗證的輸出，該動作會繼續進行，而您的應用程式會收到一則 `tag` 為 `hook_callback_failed` 的 [`SDKInformationalMessage`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#sdkinformationalmessage) 警告。如此一來，當機的 `PreToolUse` 防護會讓工具呼叫進入一般的權限流程。沒有返回任何內容的回調（例如沒有 `return` 的路徑）也視為失敗。在 Python 中，請從 `SystemMessage.data` 讀取 `tag`。

290 

291若要改為阻止該動作，請在 matcher 上設定 `onFailure: "block"`（TypeScript）或 `on_failure="block"`（Python）。需要 TypeScript Agent SDK v0.3.317 或更新版本，或 Python Agent SDK v0.2.177 或更新版本。此範例會在 Python 中的 `check_policy` 或 TypeScript 中的 `checkPolicy` 失敗時阻止 Bash 呼叫：

292 

293```python Python theme={null}

294options = ClaudeAgentOptions(

295 hooks={

296 "PreToolUse": [

297 HookMatcher(matcher="Bash", hooks=[check_policy], on_failure="block")

298 ]

299 }

300)

301```

302 

303```typescript TypeScript theme={null}

304import type { Options } from "@anthropic-ai/claude-agent-sdk";

305 

306const options: Options = {

307 hooks: {

308 PreToolUse: [{ matcher: "Bash", hooks: [checkPolicy], onFailure: "block" }]

309 }

310};

311```

312 

313若要測試，請讓回調引發錯誤，並要求 Claude 執行 Bash 命令。工具結果會包含 `failed; blocking because onFailure is "block"`，而 Claude 不會看到您的錯誤文字。

314 

315當回調沒有意見時，請返回 `{}`。設定 `"block"` 後，沒有 `return` 的路徑會阻止該動作。捕捉自身錯誤並返回 `{}` 的回調不算失敗，因此請讓錯誤從防護中向外傳遞。

316 

317#### 行為不同的事件

318 

319設定 `"block"` 時，這些事件不一定會阻止：

320 

321* **`Stop`、`SubagentStop`、`TaskCompleted` 和 `TeammateIdle`**：這些事件會忽略此選項，因此動作會繼續進行。

322* **`PermissionRequest`**：只有在您的 `canUseTool` 回調回應之前到達時，阻止才會生效。

323* **`PostToolUse`**：工具已經執行，因此 Claude 會將失敗作為回饋接收。

324 

325超過逾時時間的回調依照 [Hook 逾時](#hook-timeout)處理。設定 `"block"` 時，逾時也會阻止 `PreCompact`、`Elicitation` 和 `WorktreeCreate`。

326 

327#### `onFailure` 的啟動錯誤

328 

329設定 `"block"` 時，若無法遵循此選項，查詢會在啟動時失敗，且不會傳送任何提示詞：

330 

331* **Claude Code 不支援此選項**：錯誤包含 `does not honor`。請更新 Claude Code，或移除此選項。

332* **工作階段已在執行中且未註冊您的 hook**：錯誤包含 `did not register your hooks`。請啟動新的工作階段。

333 

286## 範例334## 範例

287 335 

288本節中的幾個範例僅顯示回調函數。若要執行其中一個，請在您的選項的 `hooks` 欄位中的匹配事件下註冊回調，如 [設定 hooks](#configure-hooks) 中所示。336本節中的幾個範例僅顯示回調函數。若要執行其中一個，請在您的選項的 `hooks` 欄位中的匹配事件下註冊回調，如 [設定 hooks](#configure-hooks) 中所示。

779* `Stop` 和 `SubagentStop`：逾時的回調計為不返回任何決定。Agent 或 subagent 停止，如同該回調已允許它，而您其他 hook 在該事件上的決定仍然適用。在 Claude Code v2.1.273 之前，逾時的 `Stop` 或 `SubagentStop` 回調計為失敗的 hook 執行，Claude Code 捨棄您其他 hook 在該事件上的決定。827* `Stop` 和 `SubagentStop`：逾時的回調計為不返回任何決定。Agent 或 subagent 停止，如同該回調已允許它，而您其他 hook 在該事件上的決定仍然適用。在 Claude Code v2.1.273 之前，逾時的 `Stop` 或 `SubagentStop` 回調計為失敗的 hook 執行，Claude Code 捨棄您其他 hook 在該事件上的決定。

780* `SessionStart`：逾時的回調計為不返回任何輸出，工作階段繼續，使用您其他 `SessionStart` hook 的輸出。828* `SessionStart`：逾時的回調計為不返回任何輸出，工作階段繼續，使用您其他 `SessionStart` hook 的輸出。

781* `PreModelSwitch`：Claude Code 阻止模型切換。未回答的 hook 尚未核准切換。829* `PreModelSwitch`：Claude Code 阻止模型切換。未回答的 hook 尚未核准切換。

782* 其他事件，如 `Notification`、`PreCompact` 和 `PostModelSwitch`：Claude Code 記錄失敗並繼續。830* 其他事件，如 `Notification`、`PreCompact` 和 `PostModelSwitch`：Claude Code 記錄失敗並繼續。若使用 [`onFailure: "block"`](#block-the-action-when-a-callback-fails)，`PreCompact`、`Elicitation` 或 `WorktreeCreate` 上的逾時會阻止該動作。

783 831 

784主工作階段中 `Stop` 或 `SessionStart` 回調首次逾時時，Claude Code 也會新增 [`SDKInformationalMessage`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#sdkinformationalmessage) 到訊息流，說明驅動工作階段的應用程式未回應。稍後的逾時在您的應用程式保持無回應時不會重複該訊息。832主工作階段中 `Stop` 或 `SessionStart` 回調首次逾時時，Claude Code 也會新增 [`SDKInformationalMessage`](https://code.claude.com/docs/zh-TW/agent-sdk/typescript#sdkinformationalmessage) 到訊息流，說明驅動工作階段的應用程式未回應。稍後的逾時在您的應用程式保持無回應時不會重複該訊息。

785 833 

2161 None # Timeout in seconds. When omitted, the per-event default applies:2161 None # Timeout in seconds. When omitted, the per-event default applies:

2162 # 600 for most events, 30 for UserPromptSubmit2162 # 600 for most events, 30 for UserPromptSubmit

2163 )2163 )

2164 on_failure: Literal["continue", "block"] | None = (

2165 None # "block" blocks the action when a callback fails

2166 )

2164```2167```

2165 2168 

2169如需判斷 `on_failure` 涵蓋的範圍，請參閱[在回呼失敗時阻止動作](https://code.claude.com/docs/zh-TW/agent-sdk/hooks.md#block-the-action-when-a-callback-fails)。

2170 

2166### `HookInput`2171### `HookInput`

2167 2172 

2168所有 hook 輸入類型的聯合類型。實際類型取決於 `hook_event_name` 欄位。2173所有 hook 輸入類型的聯合類型。實際類型取決於 `hook_event_name` 欄位。

2437 2442 

2438#### `HookSpecificOutput`2443#### `HookSpecificOutput`

2439 2444 

2440事件特定輸出類型的判別聯合。`hookEventName` 欄位決定哪些欄位有效。如需每個 hook 事件的可用欄位的完整詳情，見 [使用 hooks 控制執行](https://code.claude.com/docs/zh-TW/agent-sdk/hooks.md#outputs)。2445事件特定 `TypedDict` 輸出類型的判別聯合。`hookEventName` 欄位決定哪些欄位有效。如需每個 hook 事件的可用欄位的完整詳情，見 [使用 hook 控制執行](https://code.claude.com/docs/zh-TW/agent-sdk/hooks.md#outputs)。

2441 2446 

2442```python theme={null}2447```python theme={null}

2443class PreToolUseHookSpecificOutput(TypedDict):2448class PreToolUseHookSpecificOutput(TypedDict):

2183 level: "info" | "notice" | "suggestion" | "warning";2183 level: "info" | "notice" | "suggestion" | "warning";

2184 tool_use_id?: string;2184 tool_use_id?: string;

2185 prevent_continuation?: boolean;2185 prevent_continuation?: boolean;

2186 tag?: string;

2186 uuid: UUID;2187 uuid: UUID;

2187 session_id: string;2188 session_id: string;

2188};2189};

2557interface HookCallbackMatcher {2558interface HookCallbackMatcher {

2558 matcher?: string;2559 matcher?: string;

2559 hooks: HookCallback[];2560 hooks: HookCallback[];

2560 timeout?: number; // 此匹配器中所有 hooks 的超時時間（秒）2561 timeout?: number; // 此 matcher 中所有 hook 的逾時時間（秒）

2562 onFailure?: "continue" | "block"; // 當回呼失敗時，"block" 會阻止該動作

2561}2563}

2562```2564```

2563 2565 

2566若要判斷 `onFailure` 涵蓋哪些情況，請參閱[在回呼失敗時阻止動作](https://code.claude.com/docs/zh-TW/agent-sdk/hooks.md#block-the-action-when-a-callback-fails)。

2567 

2564### `HookInput`2568### `HookInput`

2565 2569 

2566所有 hook 輸入類型的聯合類型。2570所有 hook 輸入類型的聯合類型。

158* **家族別名，例如 `opus`**：在 Anthropic API 和 AWS 上的 Claude Platform 上，Claude Code 在允許清單允許的該家族的最新版本上運行隊友。在具有提供者特定模型 ID 的提供者上，其中[替換不運行](https://code.claude.com/docs/zh-TW/model-config.md#restrict-model-selection)，被阻止的別名會根據下一個項目符號像任何其他被阻止的值一樣回退158* **家族別名，例如 `opus`**：在 Anthropic API 和 AWS 上的 Claude Platform 上，Claude Code 在允許清單允許的該家族的最新版本上運行隊友。在具有提供者特定模型 ID 的提供者上，其中[替換不運行](https://code.claude.com/docs/zh-TW/model-config.md#restrict-model-selection)，被阻止的別名會根據下一個項目符號像任何其他被阻止的值一樣回退

159* **任何其他被阻止的值，包括提供者特定模型 ID 提供者上的家族別名，或其家族沒有允許版本的別名**：Claude Code 在主管的模型上運行隊友。如果您設定 `CLAUDE_CODE_SUBAGENT_MODEL`，Claude Code 會先嘗試該模型，遵循相同的規則159* **任何其他被阻止的值，包括提供者特定模型 ID 提供者上的家族別名，或其家族沒有允許版本的別名**：Claude Code 在主管的模型上運行隊友。如果您設定 `CLAUDE_CODE_SUBAGENT_MODEL`，Claude Code 會先嘗試該模型，遵循相同的規則

160 160 

161預設情況下，隊友會繼承主管的 [effort 等級](https://code.claude.com/docs/zh-TW/model-config.md#adjust-effort-level)。在分割窗格模式中，這從 v2.1.186 開始適用；較早的版本未將主管的工作階段 effort 傳遞給分割窗格隊友。161預設情況下，使用主管模型的隊友會繼承主管的 [effort 等級](https://code.claude.com/docs/zh-TW/model-config.md#adjust-effort-level)。在分割窗格模式中，這從 v2.1.186 開始適用；較早的版本未將主管的工作階段 effort 傳遞給分割窗格隊友。對於使用其他模型的隊友，請參閱 [subagent 和隊友的 effort 等級](https://code.claude.com/docs/zh-TW/model-config.md#effort-level-of-subagents-and-teammates)。

162 162 

163### 讓隊友在實施前進行計畫163### 讓隊友在實施前進行計畫

164 164 

165對於複雜或有風險的任務，您可以讓隊友在實施前進行計畫。當主管在 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 中時，Claude 生成的隊友在唯讀計畫模式下工作，直到其計畫準備好。首先將主管切換到計畫模式，然後要求隊友：165對於複雜或有風險的任務，您可以讓隊友在實施前進行計畫。當主管處於 [plan mode](https://code.claude.com/docs/zh-TW/permission-modes.md#analyze-before-you-edit-with-plan-mode) 時，Claude 生成的隊友也會在 plan mode 中工作，直到其計畫準備好。首先將主管切換到 plan mode，然後要求生成隊友：

166 166 

167```text wrap theme={null}167```text wrap theme={null}

168Spawn an architect teammate to refactor the authentication module.168Spawn an architect teammate to refactor the authentication module.

169```169```

170 170 

171當該隊友完成計畫時，它向主管發送計畫核准請求。如果您自該隊友生成以來未變更其權限模式，Claude Code 會在請求到達時立即核准計畫，無需主管審查。隊友的編輯和命令仍然會通過[權限](#permissions)中描述的權限提示。一旦核准，隊友退出 plan mode 並開始實施。171當該隊友完成計畫時，它向主管發送計畫核准請求。如果您自該隊友生成以來未變更其權限模式，Claude Code 會在請求到達時立即核准計畫，無需主管審查。一旦核准，隊友退出 plan mode 並開始實施。Claude Code 會將主管目前的[權限模式](#permissions)傳遞給它；如果主管目前是 plan mode，則傳遞 Manual。

172 172 

173如果您在查看正在運行的 in-process 隊友的工作階段時，按下 [`Shift+Tab`](https://code.claude.com/docs/zh-TW/permission-modes#switch-permission-modes) 將其置於 plan mode，則該次運行的計畫會由主管審查，而非由 Claude Code 核准。系統不會要求您核准；主管會核准它，或將其退回修訂。173如果您在查看正在運行的 in-process 隊友的工作階段時，按下 [`Shift+Tab`](https://code.claude.com/docs/zh-TW/permission-modes#switch-permission-modes) 將其置於 plan mode，則該次運行的計畫會由主管審查，而非由 Claude Code 核准。系統不會要求您核准；主管會核准它，或將其退回修訂。

174 174 

219* [`TaskCreated`](https://code.claude.com/docs/zh-TW/hooks#taskcreated)：當任務正在建立時運行。以代碼 2 退出以防止建立並發送反饋。219* [`TaskCreated`](https://code.claude.com/docs/zh-TW/hooks#taskcreated)：當任務正在建立時運行。以代碼 2 退出以防止建立並發送反饋。

220* [`TaskCompleted`](https://code.claude.com/docs/zh-TW/hooks#taskcompleted)：當任務被標記為完成時運行。以代碼 2 退出以防止完成並發送反饋。220* [`TaskCompleted`](https://code.claude.com/docs/zh-TW/hooks#taskcompleted)：當任務被標記為完成時運行。以代碼 2 退出以防止完成並發送反饋。

221 221 

222## Agent teams 如何工作222## Agent teams 的運作方式

223 223 

224本節涵蓋 agent teams 背後的架構和機制。如果您想開始使用它們，請參閱上面的[控制您的 agent team](#control-your-agent-team)。224本節說明 agent teams 背後的架構與運作機制。如果您想開始使用，請參閱上方的[控制您的 agent team](#control-your-agent-team)。

225 225 

226### Claude 如何啟動 agent teams226### Claude 如何啟動 agent teams

227 227 

228若要啟動一個團隊，請向 Claude 要求隊友。當 Claude 在啟用 agent teams 時呼叫 [Agent tool](https://code.claude.com/docs/zh-TW/tools-reference.md) 並帶有 [`name`](https://code.claude.com/docs/zh-TW/sub-agents#subagent-names) 時，Claude 會啟動一個隊友，除非該呼叫是[分支](https://code.claude.com/docs/zh-TW/sub-agents.md#fork-the-current-conversation)或在呼叫本身上傳遞 `isolation`。Claude Code 不會要求您確認啟動。228若要啟動團隊，請要求 Claude 建立隊員。在啟用 agent teams 的情況下，當 Claude 以 [`name`](https://code.claude.com/docs/zh-TW/sub-agents#subagent-names) 呼叫 [Agent 工具](https://code.claude.com/docs/zh-TW/tools-reference.md)時，就會啟動一名隊員，除非該呼叫是 [fork](https://code.claude.com/docs/zh-TW/sub-agents.md#fork-the-current-conversation)，或在呼叫本身傳入了 `isolation`。Claude Code 不會要求您確認啟動。

229 229 

230Claude 也會自行命名普通 subagents，以便稍後可以向它們傳送訊息。這些呼叫遵循相同的規則，因此即使您沒有要求，團隊也可能形成。如果您想要 subagents，請[關閉 agent teams](#claude-spawns-teammates-instead-of-subagents)。230Claude 也會自行為一般 subagent 命名，以便之後傳訊息給它們。這些呼叫遵循相同的規則，因此即使您沒有要求，也可能形成團隊。如果您想改用 subagent，請[關閉 agent teams](#claude-spawns-teammates-instead-of-subagents)。

231 231 

232### 架構232### 架構

233 233 

234Agent team 由以下部分組成：234一個 agent team 由以下部分組成：

235 235 

236| 元件 | 角色 |236| 元件 | 角色 |

237| :- | :- |237| :- | :- |

238| **Team lead** | 生成隊友並協調工作的主要 Claude Code 工作階段 |238| **組長** | 產生隊員並協調工作的主要 Claude Code 工作階段 |

239| **Teammates** | 各自處理分配任務的獨立 Claude Code 實例 |239| **隊員** | 各自處理所指派任務的獨立 Claude Code 執行個體 |

240| **Task list** | 隊友認領和完成的共享工作項目列表 |240| **任務清單** | 隊員認領並完成的共用工作項目清單 |

241| **Mailbox** | 代理之間通訊的訊息系統 |241| **信箱** | 供 agent 之間溝通的訊息系統 |

242 242 

243每個 agent 的 mailbox 是位於 `~/.claude/teams/{team-name}/inboxes/{agent-name}.json` 的 JSON 檔案。Claude Code 在讀取 mailbox 檔案時驗證每個條目。不符合訊息格式的條目會被報告為錯誤並從檔案中移除；有效的訊息仍會被傳遞。243每個 agent 的信箱是位於 `~/.claude/teams/{team-name}/inboxes/{agent-name}.json` 的 JSON 檔案。Claude Code 讀取信箱檔案時會驗證每一筆項目。不符合訊息格式的項目會被回報為錯誤並從檔案中移除；有效的訊息仍會照常傳遞。

244 244 

245Claude Code 只在寫入收件人 mailbox 檔案成功時才報告訊息已發送，無論訊息是純文字還是結構化協議訊息（例如計畫批准或關閉請求）。當寫入失敗時（例如因為磁碟已滿或 mailbox 目錄不可寫），發送代理會收到錯誤，且不會發送任何內容。請參閱[無法寫入隊友的收件匣](https://code.claude.com/docs/zh-TW/errors.md#failed-to-write-to-a-teammate-inbox)以了解錯誤訊息和復原步驟。245只有在寫入收件者信箱檔案成功時，Claude Code 才會將訊息回報為已傳送，無論該訊息是純文字，還是計畫核准或關閉請求等結構化協定訊息。寫入失敗時，例如因為磁碟已滿或信箱目錄無法寫入，傳送端 agent 會收到錯誤，且不會傳送任何內容。錯誤訊息與復原步驟請參閱 [Failed to write to a teammate's inbox](https://code.claude.com/docs/zh-TW/errors.md#failed-to-write-to-a-teammate-inbox)。

246 246 

247Claude Code 自動管理任務依賴關係：當隊友完成其他任務依賴的任務時，被阻止的任務會自動解除阻止，無需您採取任何行動。247Claude Code 會自動管理任務相依性：當隊員完成其他任務所相依的任務時，它會解除相依任務的封鎖，您無需採取任何動作。

248 248 

249團隊和任務存儲在本地，名稱來自工作階段衍生的名稱。名稱是 `session-` 後跟工作階段 ID 的前八個字元：249團隊與任務會以衍生自工作階段的名稱儲存在本機。該名稱為 `session-` 後接工作階段 ID 的前八個字元：

250 250 

251* **Team config**：`~/.claude/teams/{team-name}/config.json`。Claude Code 會在工作階段結束時移除團隊設定目錄。251* **團隊設定**：`~/.claude/teams/{team-name}/config.json`。工作階段結束時，Claude Code 會移除團隊設定目錄。

252* **Task list**：`~/.claude/tasks/{team-name}/`。此目錄在工作階段結束後會保留在磁碟上。若要變更 [Claude Code 保留它的時間長度](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)，請設定 [`cleanupPeriodDays`](https://code.claude.com/docs/zh-TW/settings-reference#cleanupperioddays)。252* **任務清單**：`~/.claude/tasks/{team-name}/`。此目錄在工作階段結束後仍會保留在磁碟上。若要變更 [Claude Code 保留它的時間長度](https://code.claude.com/docs/zh-TW/claude-directory.md#cleaned-up-automatically)，請設定 [`cleanupPeriodDays`](https://code.claude.com/docs/zh-TW/settings-reference#cleanupperioddays)。

253 253 

254Claude Code 在工作階段啟動時自動生成這兩者，並在隊友加入、閒置或離開時更新它們。254Claude Code 會在工作階段啟動時自動產生這兩者，並在隊員加入、閒置或離開時更新它們。

255 255 

256團隊配置保存運行時狀態，例如工作階段 ID 和 tmux 窗格 ID，因此不要手動編輯或預先編寫它：您的變更會在下次狀態更新時被覆蓋。256團隊設定保存了工作階段 ID 與 tmux 窗格 ID 等執行階段狀態，因此請勿手動編輯或預先撰寫它：您的變更會在下一次狀態更新時被覆寫。

257 257 

258若要定義可重複使用的隊友角色，請改用 [subagent 定義](#use-subagent-definitions-for-teammates)。258若要定義可重複使用的隊員角色，請改用 [subagent 定義](#use-subagent-definitions-for-teammates)。

259 259 

260團隊配置包含一個 `members` 陣列，其中包含每個成員的名稱和代理 ID。主管的條目始終帶有代理類型 `team-lead`。隊友的條目帶有主管在生成它時命名的任何代理類型，無論是[內建類型](https://code.claude.com/docs/zh-TW/sub-agents.md#built-in-subagents)還是 [subagent 定義](#use-subagent-definitions-for-teammates)，當主管未命名任何類型時則省略該欄位。隊友可以讀取此檔案以發現其他團隊成員。260團隊設定包含一個 `members` 陣列，其中列出每位成員的名稱與 agent ID。組長的項目一律帶有 agent 類型 `team-lead`。隊員的項目則帶有組長產生它時所指定的 agent 類型，無論是[內建類型](https://code.claude.com/docs/zh-TW/sub-agents.md#built-in-subagents)還是 [subagent 定義](#use-subagent-definitions-for-teammates)；若組長未指定任何類型，則省略該欄位。隊員可以讀取此檔案來得知其他團隊成員。

261 261 

262沒有專案級別的團隊配置等效項。您專案目錄中的 `.claude/teams/teams.json` 之類的檔案不被識別為配置；Claude 將其視為普通檔案。262團隊設定沒有專案層級的對應檔案。專案目錄中類似 `.claude/teams/teams.json` 的檔案不會被視為設定；Claude 會將其當作一般檔案處理。

263 263 

264### 為隊友使用 subagent 定義264### 為隊員使用 subagent 定義

265 265 

266在任一顯示模式中生成隊友時，您可以參考來自專案、使用者、受管或外掛 [subagent 範圍](https://code.claude.com/docs/zh-TW/sub-agents.md#choose-the-subagent-scope)的 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 類型。這讓您定義一個角色一次，例如安全審查者或測試執行者，並將其同時重複使用為委派的 subagent 和 agent team 隊友。266在任一顯示模式下產生隊員時，您都可以參照來自專案、使用者、受管理或外掛 [subagent 範圍](https://code.claude.com/docs/zh-TW/sub-agents.md#choose-the-subagent-scope)的 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 類型。這讓您可以只定義一次角色，例如 security-reviewer 或 test-runner，並同時將其重複用作委派的 subagent 與 agent team 隊員。

267 267 

268若要使用 subagent 定義，在要求 Claude 生成隊友時按名稱提及它：268若要使用 subagent 定義，請在要求 Claude 產生隊員時指明其名稱：

269 269 

270```text wrap theme={null}270```text wrap theme={null}

271Spawn a teammate using the security-reviewer agent type to audit the auth module.271Spawn a teammate using the security-reviewer agent type to audit the auth module.

272```272```

273 273 

274Claude Code 讀取您命名的 subagent 定義，並將其以下部分應用於隊友。當某個部分取決於隊友的[顯示模式](#choose-a-display-mode)時，該條目會說明：274Claude Code 會讀取您指定的 subagent 定義，並將其中以下部分套用到隊員。若某部分取決於隊員的[顯示模式](#choose-a-display-mode)，該項目會加以說明：

275 275 

276* **`tools`**：Claude Code 將隊友限制為定義的 `tools` 列表中的工具。對於進程內隊友，Claude Code 會將 `SendMessage` 添加到該列表，在[具有 Task tools 的工作階段](https://code.claude.com/docs/zh-TW/tools-reference.md#task-tool-availability)中，它還會添加 `TaskCreate`、`TaskGet`、`TaskList` 和 `TaskUpdate`。276* **`tools`**：Claude Code 會將隊員限制在定義的 `tools` 清單中的工具。對於 in-process 隊員，Claude Code 會在該清單中加入 `SendMessage`，而在[具備 Task 工具的工作階段](https://code.claude.com/docs/zh-TW/tools-reference.md#task-tool-availability)中，還會加入 `TaskCreate`、`TaskGet`、`TaskList` 與 `TaskUpdate`。

277* **`model`**：當您的生成提示未命名模型時，Claude Code 在任一顯示模式中使用定義的 `model`。請參閱[Claude Code 如何選擇隊友的模型](#specify-teammates-and-models)。277* **`model`**：當您的產生提示詞未指定模型時，Claude Code 在任一顯示模式下都會使用定義的 `model`。請參閱 [Claude Code 如何為隊員選擇模型](#specify-teammates-and-models)。

278* **`disallowedTools`**：對於進程內隊友，Claude Code 會從隊友的工具集中移除定義的 `disallowedTools` 中的工具。即使該列表中列出了 `SendMessage` 及其添加的 Task tools，這些工具仍然可用。278* **`disallowedTools`**：對於 in-process 隊員，Claude Code 會從隊員的工具集中移除定義的 `disallowedTools` 中的工具。即使清單中列出了 `SendMessage` 以及 Claude Code 加入的 Task 工具，它們仍可使用。

279* **`effort`**：對於進程內隊友，Claude Code 會依照 [frontmatter effort 規則](https://code.claude.com/docs/zh-TW/model-config.md#set-the-effort-level)應用定義的 [`effort`](https://code.claude.com/docs/zh-TW/sub-agents#supported-frontmatter-fields)。279* **`effort`**：對於 in-process 隊員，Claude Code 會依照 [frontmatter effort 規則](https://code.claude.com/docs/zh-TW/model-config.md#set-the-effort-level)套用定義的 [`effort`](https://code.claude.com/docs/zh-TW/sub-agents#supported-frontmatter-fields)。

280* **`autoCompactWindow`**：對於進程內隊友，Claude Code 會依照[該欄位的規則](https://code.claude.com/docs/zh-TW/sub-agents.md#subagent-auto-compact-window)應用定義的 [`autoCompactWindow`](https://code.claude.com/docs/zh-TW/sub-agents#supported-frontmatter-fields)。分割窗格隊友會忽略該欄位。需要 Claude Code v2.1.296 或更新版本。280* **`autoCompactWindow`**：對於 in-process 隊員，Claude Code 會依照[該欄位的規則](https://code.claude.com/docs/zh-TW/sub-agents.md#subagent-auto-compact-window)套用定義的 [`autoCompactWindow`](https://code.claude.com/docs/zh-TW/sub-agents#supported-frontmatter-fields)。split-pane 隊員會忽略此欄位。需要 Claude Code v2.1.296 或更新版本。

281* **Body**：對於進程內隊友，Claude Code 將定義的 body 附加到其預設系統提示中作為額外指示。對於分割窗格隊友，Claude Code 使用 body 代替其預設系統提示。281* **本文**：對於 in-process 隊員，Claude Code 會將定義的本文附加到其預設系統提示詞之後，作為額外指示。對於 split-pane 隊員，Claude Code 會使用本文取代其預設系統提示詞。

282* **`skills`**：Claude Code 在任一顯示模式中都不會將定義的 `skills` 應用於隊友。隊友從您的專案和使用者設定中載入 skills。282* **`skills`**：在任一顯示模式下，Claude Code 都不會將定義的 `skills` 套用到隊員。隊員會從您的專案與使用者設定載入 skill。

283* **`mcpServers`**：對於分割窗格隊友，Claude Code 在[該欄位的規則](https://code.claude.com/docs/zh-TW/sub-agents.md#scope-mcp-servers-to-a-subagent)下應用定義的 `mcpServers`，這些規則涵蓋使用 `--agent` 啟動的工作階段。進程內隊友忽略該欄位，並從您的專案和使用者設定中載入 MCP servers。283* **`mcpServers`**：對於 split-pane 隊員，Claude Code 會依照[該欄位的規則](https://code.claude.com/docs/zh-TW/sub-agents.md#scope-mcp-servers-to-a-subagent)套用定義的 `mcpServers`，這些規則也涵蓋以 `--agent` 啟動的工作階段。in-process 隊員會忽略此欄位，並從您的專案與使用者設定載入 MCP 伺服器。

284 284 

285當 Claude 向不再運行的進程內隊友傳送訊息時，Claude Code 會在同一工作階段中將其恢復，復原為其保存的任何對話，並將訊息作為其下一個提示給予它。在您恢復工作階段後，隊友不會以這種方式被恢復，根據[恢復限制](#limitations)。285當 Claude 傳訊息給已不再執行的 in-process 隊員時，Claude Code 會在同一個工作階段中將其帶回，還原為其保存的任何對話，並將該訊息作為它的下一個提示詞。在您恢復工作階段之後，隊員不會以這種方式被帶回，請參閱[恢復的限制](#limitations)。

286 286 

287對於它恢復的隊友，Claude Code 只有在您[信任代理檔案所在的資料夾](https://code.claude.com/docs/zh-TW/permissions.md#what-runs-before-you-trust-a-folder)時，才會重新應用來自專案的 `.claude/agents/` 目錄或 `--add-dir` 目錄的定義。信任父資料夾不算。在那之前，隊友會恢復時不帶定義的任何工具或指示，只保留 Claude Code 添加到每個進程內隊友的工具。請參閱[隊友的代理定義未被復原](https://code.claude.com/docs/zh-TW/errors.md#teammate-agent-definition-not-restored)以了解通知文本。287對於被帶回的隊員，只有在您已[信任 agent 檔案所在的資料夾](https://code.claude.com/docs/zh-TW/permissions.md#what-runs-before-you-trust-a-folder)時，Claude Code 才會重新套用來自專案 `.claude/agents/` 目錄或 `--add-dir` 目錄的定義。信任上層資料夾不算數。在此之前，隊員被帶回時不會具備定義中的任何工具或指示，只保留 Claude Code 為每個 in-process 隊員加入的工具。通知文字請參閱[隊員的 agent 定義未被還原](https://code.claude.com/docs/zh-TW/errors.md#teammate-agent-definition-not-restored)。

288 288 

289### 權限289### 權限

290 290 

291隊友開始時具有主管的權限模式，除了 [`dontAsk` 模式](https://code.claude.com/docs/zh-TW/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)，他們不會繼承。如果主管使用 `--dangerously-skip-permissions` 運行，所有隊友也會這樣做。生成後，您可以更改個別隊友的權限模式，但在生成時無法設定每個隊友的權限模式。291若要切換執行中隊員的權限模式，請按 [`Shift+Tab`](https://code.claude.com/docs/zh-TW/permission-modes#switch-permission-modes)，不過 in-process 隊員可能會改以組長的模式執行。對於 split-pane 隊員，請在其窗格中按下。對於 [in-process](#choose-a-display-mode) 隊員，請在[檢視其工作階段](#talk-to-teammates-directly)時按下，隊員會在開始下一個回合時檢查其模式。

292 292 

293[程序內](#choose-a-display-mode)隊友在主管即時的允許和拒絕規則下執行，因此 [`--disallowedTools`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags)、`--tools` 和 `--allowedTools` 都適用於它。對於分割窗格隊友，請逐一檢查每個旗標：293> [!NOTE]

294>

295> 當組長處於 [`acceptEdits`](https://code.claude.com/docs/zh-TW/permission-modes#auto-approve-file-edits-with-acceptedits-mode)、[`auto`](https://code.claude.com/docs/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 或 [`bypassPermissions`](https://code.claude.com/docs/zh-TW/permission-modes#skip-all-checks-with-bypasspermissions-mode) 模式時，未處於 [plan mode](#have-teammates-plan-before-implementing) 的 in-process 隊員會以組長的模式執行。將隊員切換為 Manual 並不會改變這一點，即使其狀態列顯示 Manual 也是如此。

296>

297> 若要讓它在編輯前先詢問，請在 agent 面板中的 `main` 列上按 Enter，並將組長也切換為 Manual 模式。此後組長也會詢問，任何其他處於 Manual 模式的隊員亦然。

298 

299您無法在產生隊員時為個別隊員設定權限模式。新隊員會以組長的模式啟動，包括由 `--dangerously-skip-permissions` 開啟的 `bypassPermissions` 模式。如果組長處於 [`dontAsk` 模式](https://code.claude.com/docs/zh-TW/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)，隊員則會改以 [Manual 模式](https://code.claude.com/docs/zh-TW/permission-modes.md#available-modes)啟動。

300 

301[in-process](#choose-a-display-mode) 隊員會在組長即時的允許與拒絕規則下執行，因此 [`--disallowedTools`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags)、`--tools` 與 `--allowedTools` 都會套用到它。對於 split-pane 隊員，請逐一確認每個旗標：

294 302 

295* **`--disallowedTools` 和 `--tools`**：隊友啟動時帶有主管的命令列拒絕規則和工具列表。需要 Claude Code v2.1.309 或更新版本。303* **`--disallowedTools` 與 `--tools`**：隊員會以組長的命令列拒絕規則與工具清單啟動。需要 Claude Code v2.1.309 或更新版本。

296* **`--allowedTools`**：Claude Code 不會將此旗標傳遞給分割窗格隊友，因此僅透過此旗標允許的操作在那裡不會被預先核准。若要事先核准這些操作，請在啟動主管時將規則放在 [`--settings`](https://code.claude.com/docs/zh-TW/settings#change-a-setting-for-one-session) 的 `permissions.allow` 下。例如，在您的 shell 中執行 `claude --settings '{"permissions":{"allow":["Bash(npm *)"]}}'`。這些規則適用於該工作階段的主管和每個分割窗格隊友。304* **`--allowedTools`**：Claude Code 不會將此旗標傳遞給 split-pane 隊員，因此僅透過它允許的動作在該處不會被預先核准。若要事先核准這些動作，請在啟動組長時，將規則放在 [`--settings`](https://code.claude.com/docs/zh-TW/settings#change-a-setting-for-one-session) 的 `permissions.allow` 下。例如，在您的 shell 中執行 `claude --settings '{"permissions":{"allow":["Bash(npm *)"]}}'`。這些規則會套用到該工作階段的組長以及每個 split-pane 隊員。

297 305 

298隊友權限提示會出現在主管工作階段中，因此請在那裡自己核准它們。您不需要核准[隊友的計畫](#have-teammates-plan-before-implementing)。306隊員的權限提示會出現在組長工作階段中，因此請您親自在那裡核准。您不需要核准[隊員的計畫](#have-teammates-plan-before-implementing)。

299 307 

300#### 代理之間的訊息308#### Agent 之間的訊息

301 309 

302當一個代理透過 `SendMessage` 向另一個代理發送訊息時，Claude Code 會告訴接收代理該訊息來自另一個 Claude 工作階段，而不是來自您。隊友無法批准權限提示或代表您提供同意，被拒絕某項操作的隊友無法將其轉發給另一個隊友以繞過檢查。相同的規則適用於來自[您其他 Claude Code 工作階段](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#how-a-session-treats-an-incoming-message)的訊息，完全在團隊之外。310當一個 agent 透過 `SendMessage` 傳訊息給另一個 agent 時，Claude Code 會告知接收端 agent 該訊息來自另一個 Claude 工作階段，而非來自您。隊員無法代表您核准權限提示或提供同意，而被拒絕執行某動作的隊員也無法將其轉交給另一名隊員來繞過檢查。相同的規則也適用於來自[您的其他 Claude Code 工作階段之一](https://code.claude.com/docs/zh-TW/cross-session-messaging.md#how-a-session-treats-an-incoming-message)、完全位於團隊之外的訊息。

303 311 

304在 [auto mode](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode) 中，分類器對代理之間的訊息應用兩項檢查：312在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)中，分類器會對 agent 之間的訊息套用兩項檢查：

305 313 

306* 它將從另一個代理轉發的批准聲明視為不受信任的輸入，而不是來自您的確認。314* 它會將從另一個 agent 轉達的核准聲明視為不受信任的輸入，而非來自您的確認。

307* 它在 Claude Code 傳遞訊息之前審查每條訊息，無論是純訊息還是結構化協議訊息（例如關閉請求或計畫批准回應）。它阻止的訊息永遠不會到達收件人。315* 它會在 Claude Code 傳遞每則訊息之前進行審查，無論是純文字訊息，還是關閉請求或計畫核准回應等結構化協定訊息。被它封鎖的訊息永遠不會送達收件者。

308 316 

309### Context 和通訊317### 上下文與溝通

310 318 

311每個隊友都有自己的 context window。生成時，隊友載入與常規工作階段相同的專案 context：CLAUDE.md、MCP servers 和 skills。如果您使用 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 啟動主管，隊友會從相同的受限來源列表載入。在 v2.1.281 之前，[分割窗格](#choose-a-display-mode)隊友載入每個設定來源。319每位隊員都有自己的上下文視窗。產生時，隊員會載入與一般工作階段相同的專案上下文：CLAUDE.md、MCP 伺服器與 skill。如果您以 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 啟動組長，隊員會從相同的受限來源清單載入。在 v2.1.281 之前，[split-pane](#choose-a-display-mode) 隊員會載入所有設定來源。

312 320 

313隊友也接收來自主管的生成提示。主管的對話歷史不會延續。321隊員也會收到來自組長的產生提示詞。組長的對話歷程不會延續過去。

314 322 

315**隊友如何分享資訊：**323**隊員如何共享資訊：**

316 324 

317* **自動訊息傳遞**：當隊友發送訊息時，它們會自動傳遞給收件人。主管不需要輪詢更新。325* **自動訊息傳遞**：當隊員傳送訊息時，訊息會自動傳遞給收件者。組長不需要輪詢更新。

318* **閒置通知**：當隊友完成並停止時，它會自動通知主管並在通知中包含其最終答案。隊友的回合因 API 錯誤而結束時會通知主管它失敗並包含錯誤文本。326* **閒置通知**：當隊員完成並停止時，會自動通知組長，並在通知中附上其最終答案。回合因 API 錯誤而結束的隊員會通知組長它已失敗，並附上錯誤文字。

319* **共享任務列表**：[具有 Task tools 的代理](https://code.claude.com/docs/zh-TW/tools-reference.md#task-tool-availability)可以看到任務狀態並認領可用工作。327* **共用任務清單**：[具備 Task 工具的 agent](https://code.claude.com/docs/zh-TW/tools-reference.md#task-tool-availability) 可以查看任務狀態並認領可用的工作。

320* **隊友訊息傳遞**：按名稱向一個特定隊友發送訊息。若要聯繫所有人，請為每個收件人發送一條訊息。328* **隊員訊息**：依名稱傳送訊息給某一位特定隊員。若要通知所有人，請為每位收件者各傳送一則訊息。

321 329 

322主管在生成隊友時為其分配名稱，任何隊友都可以按該名稱向任何其他隊友傳送訊息。若要獲得可在稍後提示中參考的可預測名稱，請在您的生成指示中告訴主管如何稱呼每個隊友。330組長在產生每位隊員時都會為其指定名稱，任何隊員都可以依該名稱傳訊息給其他任何隊員。若要取得可在之後的提示詞中參照的可預期名稱，請在產生指示中告訴組長每位隊員該如何命名。

323 331 

324### Token 使用332### Token 使用量

325 333 

326Agent teams 使用的 tokens 遠多於單個工作階段。每個隊友都有自己的 context window，token 使用量隨活躍隊友數量而增加。對於研究、審查和新功能工作，額外的 tokens 通常是值得的。對於日常任務，單個工作階段更具成本效益。請參閱 [agent team token 成本](https://code.claude.com/docs/zh-TW/costs.md#agent-team-token-costs)以了解使用指南。334Agent teams 使用的 token 明顯多於單一工作階段。每位隊員都有自己的上下文視窗，token 使用量會隨著作用中隊員的數量而增加。對於研究、審查與新功能開發，額外的 token 通常是值得的。對於例行任務，單一工作階段更具成本效益。使用指引請參閱 [agent team token 成本](https://code.claude.com/docs/zh-TW/costs.md#agent-team-token-costs)。

327 335 

328進程內隊友的請求落在主對話的 [cache TTL bucket](https://code.claude.com/docs/zh-TW/prompt-caching.md#which-ttl-each-request-gets) 之外，因此其快取在 Claude 訂閱上預設保留五分鐘。若要將其保留一小時，請將 [`subagentPromptCacheTtl`](https://code.claude.com/docs/zh-TW/settings-reference#subagentpromptcachettl) 設定為 `1h`。API 以更高的費率計費 1 小時快取寫入。336in-process 隊員的請求不屬於主要對話的[快取 TTL 分組](https://code.claude.com/docs/zh-TW/prompt-caching.md#which-ttl-each-request-gets)，因此其快取預設保留五分鐘，即使在 Claude 訂閱方案中也是如此。若要保留一小時，請將 [`subagentPromptCacheTtl`](https://code.claude.com/docs/zh-TW/settings-reference#subagentpromptcachettl) 設為 `1h`。API 會以較高的費率計費 1 小時快取寫入。

329 337 

330## 使用案例範例338## 使用案例範例

331 339 

488* **沒有嵌套團隊**：隊友無法生成自己的隊友。只有主管可以管理團隊。496* **沒有嵌套團隊**：隊友無法生成自己的隊友。只有主管可以管理團隊。

489* **沒有來自 in-process 隊友的背景 subagent**：in-process 隊友自己的 subagent 在前景中執行，因為隊友的背景工作無法超越主管的程序。Claude Code 在隊友生成定義設定 `background: true` 的 subagent 時會傳回錯誤。隊友的 `run_in_background: true` 請求也會失敗，可能傳回錯誤或在前景中無聲執行。從主要對話啟動的 subagent 遵循[背景預設](https://code.claude.com/docs/zh-TW/sub-agents.md#run-subagents-in-foreground-or-background)。497* **沒有來自 in-process 隊友的背景 subagent**：in-process 隊友自己的 subagent 在前景中執行，因為隊友的背景工作無法超越主管的程序。Claude Code 在隊友生成定義設定 `background: true` 的 subagent 時會傳回錯誤。隊友的 `run_in_background: true` 請求也會失敗，可能傳回錯誤或在前景中無聲執行。從主要對話啟動的 subagent 遵循[背景預設](https://code.claude.com/docs/zh-TW/sub-agents.md#run-subagents-in-foreground-or-background)。

490* **主管是固定的**：主要工作階段在其生命週期內是主管。您無法將隊友提升為主管或轉移領導權。498* **主管是固定的**：主要工作階段在其生命週期內是主管。您無法將隊友提升為主管或轉移領導權。

491* **權限在生成時設定**：隊友開始時具有 [權限](#permissions) 下所述的權限模式。您可以在生成後更改個別隊友的權限模式，但在生成時無法設定每個隊友的權限模式。499* **生成時無法為每個隊友設定權限模式**：隊友開始時具有 [權限](#permissions) 下所述的權限模式。

492* **分割窗格需要 tmux 或 iTerm2**：預設 in-process 模式在任何終端中工作。VS Code 的整合終端、Windows Terminal 或 Ghostty 不支援分割窗格模式。500* **分割窗格需要 tmux 或 iTerm2**：預設 in-process 模式在任何終端中工作。VS Code 的整合終端、Windows Terminal 或 Ghostty 不支援分割窗格模式。

493 501 

494## 後續步驟502## 後續步驟

442 442 

443執行 `/background` 或其別名 `/bg`，可將目前的對話移到背景工作階段。傳遞提示詞（例如 `/bg run the test suite and fix any failures`）可先再給一個指令。如果您執行 `/bg` 時 Claude 正在回應，該回應會在背景工作階段中繼續。443執行 `/background` 或其別名 `/bg`，可將目前的對話移到背景工作階段。傳遞提示詞（例如 `/bg run the test suite and fix any failures`）可先再給一個指令。如果您執行 `/bg` 時 Claude 正在回應，該回應會在背景工作階段中繼續。

444 444 

445結束仍有背景工作在執行的工作階段時（例如 subagent、背景 shell 命令、工作流程或 [monitor](https://code.claude.com/docs/zh-TW/tools-reference.md#monitor-tool)），會顯示 `Background work is running` 對話框，而不是立即結束。選擇 `Move to background and exit` 即可以與 `/background` 相同的方式將工作階段移到背景，並返回您的 shell。當 agent view [已關閉](#turn-off-agent-view)時，不會顯示此選項。445如果您在某些類型的背景工作（例如 subagent 或工作流程）仍在執行時結束工作階段，`Background work is running` 對話框會警告這些工作將會停止。選擇 `Move to background and exit` 即可以與 `/background` 相同的方式將工作階段移到背景，並返回您的 shell。當 agent view [已關閉](#turn-off-agent-view)時，不會顯示此選項。

446 446 

447如果清單上已有背景工作階段使用該對話的名稱，Claude Code 會為新列的名稱加上編號，例如 `my-session (2)`，並保留現有列的名稱不變。若要重新命名新列，請在 agent view 中選取它並按 `Ctrl+R`。447如果清單上已有背景工作階段使用該對話的名稱，Claude Code 會為新列的名稱加上編號，例如 `my-session (2)`，並保留現有列的名稱不變。若要重新命名新列，請在 agent view 中選取它並按 `Ctrl+R`。

448 448 

315* [受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)的 `env` 區塊中的釘選315* [受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)的 `env` 區塊中的釘選

316* 指向[應用程式推論設定檔 ARN](#map-each-model-version-to-an-inference-profile) 的釘選，因為這些由您的管理員管理316* 指向[應用程式推論設定檔 ARN](#map-each-model-version-to-an-inference-profile) 的釘選，因為這些由您的管理員管理

317 317 

318如果受管設定中的釘選仍出現更新提示，請將 Claude Code 更新至 v2.1.314 或更新版本。在 v2.1.314 之前，受管釘選在您接受後仍會保持有效，因此提示會在下次啟動時再次出現。

319 

318如果您尚未釘選模型，且目前的預設在您的帳戶中無法使用，Claude Code 會針對目前的工作階段改用備援模型並顯示通知。它會先嘗試預設模型的較早版本，當預設是 Opus 模型且沒有可用的 Opus 版本時，會改用預設的 Sonnet 模型。備援不會被保存。在您的 Amazon Bedrock 帳戶中啟用較新的模型，或[釘選一個版本](#4-pin-model-versions)以使選擇永久化。320如果您尚未釘選模型，且目前的預設在您的帳戶中無法使用，Claude Code 會針對目前的工作階段改用備援模型並顯示通知。它會先嘗試預設模型的較早版本，當預設是 Opus 模型且沒有可用的 Opus 版本時，會改用預設的 Sonnet 模型。備援不會被保存。在您的 Amazon Bedrock 帳戶中啟用較新的模型，或[釘選一個版本](#4-pin-model-versions)以使選擇永久化。

319 321 

322### 在特定模型上啟動工作階段

323 

320當您在特定的 Sonnet 或 Opus 版本上啟動工作階段時，例如使用 `--model`、`ANTHROPIC_MODEL` 或[`model` 設定](https://code.claude.com/docs/zh-TW/settings-reference#model)，該版本會作為工作階段針對相符 `sonnet` 或 `opus` 別名的釘選預設。Claude Code 會跳過您的模型所取代之內建預設的可用性檢查，並在您設定的模型上啟動，不會有備援通知。324當您在特定的 Sonnet 或 Opus 版本上啟動工作階段時，例如使用 `--model`、`ANTHROPIC_MODEL` 或[`model` 設定](https://code.claude.com/docs/zh-TW/settings-reference#model)，該版本會作為工作階段針對相符 `sonnet` 或 `opus` 別名的釘選預設。Claude Code 會跳過您的模型所取代之內建預設的可用性檢查，並在您設定的模型上啟動，不會有備援通知。

321 325 

322當您在下列項目上啟動工作階段時，它們不會作為釘選：326當您在下列項目上啟動工作階段時，它們不會作為釘選：

324* 模型別名，例如 `opus`328* 模型別名，例如 `opus`

325* Claude Code 無法識別的模型 ID，例如應用程式推論設定檔 ARN329* Claude Code 無法識別的模型 ID，例如應用程式推論設定檔 ARN

326 330 

327當這些檢查發現您的帳戶無法呼叫的模型時，Claude Code 會在此機器上記住該拒絕長達一天，並在該時間內啟動時跳過記住的模型，而不會再次詢問 Amazon Bedrock。Claude Code 會在距離上次檢查已過十分鐘後，再次檢查目前預設模型的記住拒絕，因此您的管理員重新啟用的預設會恢復。若要關閉此記憶，請設定 [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/zh-TW/env-vars)。331### 記住的模型拒絕

332 

333當啟動模型檢查發現您的帳戶無法呼叫的模型時，Claude Code 可以在此機器上記住該拒絕長達一天。在距離上次檢查已過十分鐘後，Claude Code 會在啟動時再次檢查目前預設模型的記住拒絕。如此一來，您的管理員重新啟用的預設就會恢復。若要關閉此記憶，請設定 [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/zh-TW/env-vars)。

328 334 

329### 當您的組織強制執行模型允許清單時335### 當您的組織強制執行模型允許清單時

330 336 

457 463 

458## AWS Guardrails464## AWS Guardrails

459 465 

460[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) 可讓您為 Claude Code 實施內容篩選。在 [Amazon Bedrock 主控台](https://console.aws.amazon.com/bedrock/)中建立 Guardrail，發佈版本，然後將 Guardrail 標頭新增至您的[設定檔](https://code.claude.com/docs/zh-TW/settings.md)。如果您使用跨區域推論設定檔，請在 Guardrail 上啟用跨區域推論。466[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) 可讓您為 Claude Code 實施內容篩選。在 [Amazon Bedrock 主控台](https://console.aws.amazon.com/bedrock/)中建立 Guardrail 並發佈版本。如果您使用跨區域推論設定檔，請在 Guardrail 上啟用跨區域推論。

461 467 

462範例設定：468若要透過 [Claude apps gateway](https://code.claude.com/docs/zh-TW/claude-apps-gateway) 套用 Guardrail，請依照[套用 Amazon Bedrock guardrail](https://code.claude.com/docs/zh-TW/claude-apps-gateway-config.md#apply-an-amazon-bedrock-guardrail) 操作。若未使用 Claude apps gateway，請將 Guardrail 標頭新增至您的[設定檔](https://code.claude.com/docs/zh-TW/settings.md)。

469 

470設定檔範例設定：

463 471 

464```json theme={null}472```json theme={null}

465{473{

469}477}

470```478```

471 479 

472如果您的組織改為透過 [Claude apps gateway](https://code.claude.com/docs/zh-TW/claude-apps-gateway) 政策傳遞 guardrail 標頭，它們會計為[需要核准的設定](https://code.claude.com/docs/zh-TW/server-managed-settings.md#environment-variables-and-the-approval-dialog)。

473 

474當 guardrail 在回應進行到一半時將其封鎖，已串流的文字會保留，而回覆會以 guardrail 上為被封鎖回應所設定的訊息作為結尾。480當 guardrail 在回應進行到一半時將其封鎖，已串流的文字會保留，而回覆會以 guardrail 上為被封鎖回應所設定的訊息作為結尾。

475 481 

476## 使用 Mantle 端點482## 使用 Mantle 端點

2512. `ANTHROPIC_AUTH_TOKEN` 環境變數。作為 `Authorization: Bearer` 標頭傳送。當透過[LLM 閘道或代理](https://code.claude.com/docs/zh-TW/llm-gateway)路由時使用此選項，該閘道或代理使用持有人令牌而不是 Anthropic API 金鑰進行驗證。2512. `ANTHROPIC_AUTH_TOKEN` 環境變數。作為 `Authorization: Bearer` 標頭傳送。當透過[LLM 閘道或代理](https://code.claude.com/docs/zh-TW/llm-gateway)路由時使用此選項，該閘道或代理使用持有人令牌而不是 Anthropic API 金鑰進行驗證。

2523. `ANTHROPIC_API_KEY` 環境變數。作為 `X-Api-Key` 標頭傳送。用於直接 Anthropic API 存取，使用來自 [Claude Console](https://platform.claude.com) 的金鑰。在互動模式下，系統會提示您一次以核准或拒絕金鑰，您的選擇會被記住。若要稍後變更，請使用 `/config` 中的「使用自訂 API 金鑰」切換。該切換僅在 `ANTHROPIC_API_KEY` 在您的環境中設定時出現。在非互動模式 (`-p`) 中，當金鑰存在時始終使用該金鑰。2523. `ANTHROPIC_API_KEY` 環境變數。作為 `X-Api-Key` 標頭傳送。用於直接 Anthropic API 存取，使用來自 [Claude Console](https://platform.claude.com) 的金鑰。在互動模式下，系統會提示您一次以核准或拒絕金鑰，您的選擇會被記住。若要稍後變更，請使用 `/config` 中的「使用自訂 API 金鑰」切換。該切換僅在 `ANTHROPIC_API_KEY` 在您的環境中設定時出現。在非互動模式 (`-p`) 中，當金鑰存在時始終使用該金鑰。

2534. [`apiKeyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#apikeyhelper) 指令碼輸出。用於動態或輪換認證，例如從保管庫擷取的短期令牌。2534. [`apiKeyHelper`](https://code.claude.com/docs/zh-TW/settings-reference#apikeyhelper) 指令碼輸出。用於動態或輪換認證，例如從保管庫擷取的短期令牌。

2545. `CLAUDE_CODE_OAUTH_TOKEN` 環境變數。由 [`claude setup-token`](#generate-a-long-lived-token) 產生的長期 OAuth 令牌。用於 CI 管道和指令碼，其中瀏覽器登入不可用。如果您在設定變數時執行 `/login`，Claude Code 會將目前工作階段切換到新登入，但會在每個新工作階段中再次讀取變數，直到您從 shell 設定檔或[設定檔](https://code.claude.com/docs/zh-TW/settings.md)的 `env` 區塊中移除它。2545. `CLAUDE_CODE_OAUTH_TOKEN` 環境變數。由 [`claude setup-token`](#generate-a-long-lived-token) 產生的長期 OAuth token。用於 CI 管道和指令碼，其中瀏覽器登入不可用。如果您在設定變數時執行 `/login`，Claude Code 會將目前工作階段切換到新登入。若要在新工作階段中保留該登入，請從您的 shell 設定檔以及[可設定它的設定檔](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)（例如您的使用者設定）中移除該變數。

2556. Anthropic 設定檔和聯盟認證，`ant` CLI 和 Workload Identity Federation 使用的認證。`ant auth login` 寫入的設定檔僅在您在 `ANTHROPIC_PROFILE` 中命名它時才排名在此處；否則它排名在 `/login` 下方。請參閱 [Anthropic 設定檔和聯盟認證](#anthropic-profiles-and-federation-credentials)。2556. Anthropic 設定檔和聯盟認證，`ant` CLI 和 Workload Identity Federation 使用的認證。`ant auth login` 寫入的設定檔僅在您在 `ANTHROPIC_PROFILE` 中命名它時才排名在此處；否則它排名在 `/login` 下方。請參閱 [Anthropic 設定檔和聯盟認證](#anthropic-profiles-and-federation-credentials)。

2567. 來自 `/login` 的訂閱 OAuth 憑證。這是 Claude Pro、Max、Ultra、Team 和 Enterprise 使用者的預設值。2567. 來自 `/login` 的訂閱 OAuth 憑證。這是 Claude Pro、Max、Ultra、Team 和 Enterprise 使用者的預設值。

257 257 

603>603>

604> `claude -p --worktree` 執行需要您自己清理，因為它結束時不會詢問。請使用 `git worktree remove <path>` 移除它們，如果 git 因為 worktree 被鎖定而拒絕，請先執行 `git worktree unlock <path>`。604> `claude -p --worktree` 執行需要您自己清理，因為它結束時不會詢問。請使用 `git worktree remove <path>` 移除它們，如果 git 因為 worktree 被鎖定而拒絕，請先執行 `git worktree unlock <path>`。

605 605 

606對於跨越許多檔案的單一大型機械式變更，[`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/zh-TW/commands) 會將工作分成 5 到 30 個單元，並向您展示計畫。接著它會在各自的 worktree 中執行每個單元，並為其開啟一個 PR。從您的 shell 執行 [`claude agents`](https://code.claude.com/docs/zh-TW/agent-view)（仍為研究預覽）可以在一個畫面中查看您電腦上所有在背景執行的內容。606對於跨越許多檔案的單一大型機械式變更，[`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/zh-TW/commands) 會將工作分成 5 到 30 個單元，並向您展示計畫。您核准後，每個單元都會取得自己的 worktree，並開啟一個 PR 或回報發生的情況。從您的 shell 執行 [`claude agents`](https://code.claude.com/docs/zh-TW/agent-view)（仍為研究預覽）可以在一個畫面中查看您電腦上所有在背景執行的內容。

607 607 

608第二個工作階段也是您能取得的最簡單的獨立審查者。一個工作階段撰寫速率限制器，另一個在沒有看過撰寫過程的情況下審查 `@src/middleware/rateLimiter.ts`，然後您將發現貼回第一個工作階段。這與 `/code-review` 的概念相同，只是由您傳遞訊息。608第二個工作階段也是您能取得的最簡單的獨立審查者。一個工作階段撰寫速率限制器，另一個在沒有看過撰寫過程的情況下審查 `@src/middleware/rateLimiter.ts`，然後您將發現貼回第一個工作階段。這與 `/code-review` 的概念相同，只是由您傳遞訊息。

609 609 

85| `--desktop` | 在目前目錄上開啟 [Claude Desktop 應用程式](https://code.claude.com/docs/zh-TW/desktop.md)並結束而不在終端機中啟動工作階段。新增 `--continue` 或 `--resume` 搭配工作階段 ID，以[在 Desktop 中開啟該工作階段](https://code.claude.com/docs/zh-TW/desktop.md#coming-from-the-cli)。此處的 `--resume` 僅採用工作階段 ID，不採用名稱或文字記錄路徑。不採用提示和其他旗標，除了 `--verbose` 和 `--debug` 旗標，因為應用程式會自行啟動工作階段。在 macOS 和 x64 Windows 上可用，當您使用 Claude 訂閱登入時。需要 Claude Code v2.1.285 或更新版本 | `claude --desktop` |85| `--desktop` | 在目前目錄上開啟 [Claude Desktop 應用程式](https://code.claude.com/docs/zh-TW/desktop.md)並結束而不在終端機中啟動工作階段。新增 `--continue` 或 `--resume` 搭配工作階段 ID，以[在 Desktop 中開啟該工作階段](https://code.claude.com/docs/zh-TW/desktop.md#coming-from-the-cli)。此處的 `--resume` 僅採用工作階段 ID，不採用名稱或文字記錄路徑。不採用提示和其他旗標，除了 `--verbose` 和 `--debug` 旗標，因為應用程式會自行啟動工作階段。在 macOS 和 x64 Windows 上可用，當您使用 Claude 訂閱登入時。需要 Claude Code v2.1.285 或更新版本 | `claude --desktop` |

86| `--disable-slash-commands` | 為此工作階段停用所有 skills 和命令 | `claude --disable-slash-commands` |86| `--disable-slash-commands` | 為此工作階段停用所有 skills 和命令 | `claude --disable-slash-commands` |

87| `--disallowedTools`, `--disallowed-tools` | 拒絕規則。裸工具名稱會從 Claude 的內容中移除相符的工具：`"Edit"` 移除 Edit、`"*"` 移除每個工具，`"mcp__*"` 移除每個 MCP 工具。範圍規則（例如 `Bash(rm *)`）會保留工具可用，並僅拒絕[如所寫](https://code.claude.com/docs/zh-TW/permissions.md#bash-rule-limits)相符的呼叫。命名 [`EndConversation`](https://code.claude.com/docs/zh-TW/tools-reference#endconversation-tool-behavior) 的規則在任何其他工具保持時無法移除它 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |87| `--disallowedTools`, `--disallowed-tools` | 拒絕規則。裸工具名稱會從 Claude 的內容中移除相符的工具：`"Edit"` 移除 Edit、`"*"` 移除每個工具，`"mcp__*"` 移除每個 MCP 工具。範圍規則（例如 `Bash(rm *)`）會保留工具可用，並僅拒絕[如所寫](https://code.claude.com/docs/zh-TW/permissions.md#bash-rule-limits)相符的呼叫。命名 [`EndConversation`](https://code.claude.com/docs/zh-TW/tools-reference#endconversation-tool-behavior) 的規則在任何其他工具保持時無法移除它 | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

88| `--effort` | 為目前工作階段設定[努力等級](https://code.claude.com/docs/zh-TW/model-config.md#adjust-effort-level)。選項：`low`、`medium`、`high`、`xhigh`、`max` 或 `ultracode`。可用的等級取決於模型。`ultracode` 要求 `xhigh` 努力並[啟用 ultracode](https://code.claude.com/docs/zh-TW/workflows.md#let-claude-decide-with-ultracode)，需要 Claude Code v2.1.203 或更新版本。覆蓋此工作階段的 [`modelSettings`](https://code.claude.com/docs/zh-TW/settings-reference#modelsettings) 和 [`effortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#effortlevel) 設定，不會保留 | `claude --effort high` |88| `--effort` | 為目前工作階段設定 [effort 等級](https://code.claude.com/docs/zh-TW/model-config.md#adjust-effort-level)。選項：`low`、`medium`、`high`、`xhigh`、`max` 或 `ultracode`。可用的等級取決於模型。`ultracode` 會請求 `xhigh` effort 並開啟 [ultracode](https://code.claude.com/docs/zh-TW/workflows.md#let-claude-decide-with-ultracode)，需要 Claude Code v2.1.203 或更新版本。在主要對話的模型上，會覆寫此工作階段的 [`modelSettings`](https://code.claude.com/docs/zh-TW/settings-reference#modelsettings) 和 [`effortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#effortlevel) 設定，且不會保留 | `claude --effort high` |

89| `--enable-auto-mode` | 在 v2.1.111 中移除。自動模式現在預設在 `Shift+Tab` 循環中；使用 `--permission-mode auto` 以它開始 | `claude --permission-mode auto` |89| `--enable-auto-mode` | 在 v2.1.111 中移除。自動模式現在預設在 `Shift+Tab` 循環中；使用 `--permission-mode auto` 以它開始 | `claude --permission-mode auto` |

90| `--environment <environment-id>` | 建立在[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments)上執行的新雲端工作階段，具有給定的 ID。環境 ID 以 `ccpool_` 開頭。請參閱 [`--environment` 分派行為](https://code.claude.com/docs/zh-TW/self-hosted-environments-testing#environment-dispatch-behavior)以了解分派行為和它拒絕的旗標組合。需要 Claude Code v2.1.224 或更新版本 | `claude -p "Fix the login bug" --environment ccpool_abc123` |90| `--environment <environment-id>` | 建立在[自託管環境](https://code.claude.com/docs/zh-TW/self-hosted-environments)上執行的新雲端工作階段，具有給定的 ID。環境 ID 以 `ccpool_` 開頭。請參閱 [`--environment` 分派行為](https://code.claude.com/docs/zh-TW/self-hosted-environments-testing#environment-dispatch-behavior)以了解分派行為和它拒絕的旗標組合。需要 Claude Code v2.1.224 或更新版本 | `claude -p "Fix the login bug" --environment ccpool_abc123` |

91| `--exclude-dynamic-system-prompt-sections` | 將每使用者內容（例如自動記憶位置）從系統提示移出並放入第一個使用者訊息。改善在不同使用者和執行相同任務的機器上的提示快取重複使用。僅適用於預設系統提示；當設定 `--system-prompt` 或 `--system-prompt-file` 時忽略。與 `-p` 搭配使用以進行指令碼化、多使用者工作負載 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |91| `--exclude-dynamic-system-prompt-sections` | 將每使用者內容（例如自動記憶位置）從系統提示移出並放入第一個使用者訊息。改善在不同使用者和執行相同任務的機器上的提示快取重複使用。僅適用於預設系統提示；當設定 `--system-prompt` 或 `--system-prompt-file` 時忽略。與 `-p` 搭配使用以進行指令碼化、多使用者工作負載 | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

33 33 

34**2. 繼續工作**34**2. 繼續工作**

35 35 

36審查會以背景 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 的形式執行，擁有自己的上下文視窗，因此不會填滿您的對話。審查完成時，發現的問題會出現在您的對話中。36在終端機工作階段中，審查會以背景 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 的形式執行，擁有自己的上下文視窗，因此不會填滿您的對話。審查完成時，發現的問題會出現在您的對話中。

37 37 

38**3. 處理發現的問題**38**3. 處理發現的問題**

39 39 

59| `/autocompact [auto\|<tokens>]` | 設定自動壓縮視窗：在 Claude Code 自動壓縮之前上下文視窗有多滿。傳遞大小（例如 `500k`）或 `auto` 以返回為您的模型調整的視窗。Claude Code 將該值保存到使用者設定並將其應用於目前工作階段。有關接受的值以及覆寫它的內容，請參閱[設定自動壓縮視窗](https://code.claude.com/docs/zh-TW/model-config.md#set-the-auto-compact-window)。沒有引數時，打開顯示目前視窗的對話框。需要 Claude Code v2.1.221 或更新版本 |59| `/autocompact [auto\|<tokens>]` | 設定自動壓縮視窗：在 Claude Code 自動壓縮之前上下文視窗有多滿。傳遞大小（例如 `500k`）或 `auto` 以返回為您的模型調整的視窗。Claude Code 將該值保存到使用者設定並將其應用於目前工作階段。有關接受的值以及覆寫它的內容，請參閱[設定自動壓縮視窗](https://code.claude.com/docs/zh-TW/model-config.md#set-the-auto-compact-window)。沒有引數時，打開顯示目前視窗的對話框。需要 Claude Code v2.1.221 或更新版本 |

60| `/autofix-pr [prompt]` | 生成一個[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#auto-fix-pull-requests)，監視目前分支的 PR 並在 CI 失敗或審查者留下評論時推送修復。使用 `gh pr view` 從您簽出的分支檢測打開的 PR；要監視不同的 PR，請先簽出其分支。預設情況下，雲端工作階段被告知修復每個 CI 失敗和審查評論；傳遞提示詞以給它不同的指示，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)的存取 |60| `/autofix-pr [prompt]` | 生成一個[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#auto-fix-pull-requests)，監視目前分支的 PR 並在 CI 失敗或審查者留下評論時推送修復。使用 `gh pr view` 從您簽出的分支檢測打開的 PR；要監視不同的 PR，請先簽出其分支。預設情況下，雲端工作階段被告知修復每個 CI 失敗和審查評論；傳遞提示詞以給它不同的指示，例如 `/autofix-pr only fix lint and type errors`。需要 `gh` CLI 和[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)的存取 |

61| `/background [prompt]` | 分離目前工作階段以作為[背景 agent](https://code.claude.com/docs/zh-TW/agent-view.md) 運行並釋放此終端機。傳遞提示詞以在分離前發送一個進一步的指示。使用 `claude agents` 監視工作階段。要將對話複製到新的背景工作階段，同時此工作階段保持運行，請使用 `/fork`。別名：`/bg` |61| `/background [prompt]` | 分離目前工作階段以作為[背景 agent](https://code.claude.com/docs/zh-TW/agent-view.md) 運行並釋放此終端機。傳遞提示詞以在分離前發送一個進一步的指示。使用 `claude agents` 監視工作階段。要將對話複製到新的背景工作階段，同時此工作階段保持運行，請使用 `/fork`。別名：`/bg` |

62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 跨程式碼庫並行協調大規模變更。研究程式碼庫，將工作分解為 5 到 30 個獨立單位，並呈現計畫。獲得批准後，在隔離的 [worktree](https://code.claude.com/docs/zh-TW/worktrees.md) 中為每個單位生成一個[背景 subagent](https://code.claude.com/docs/zh-TW/sub-agents.md#run-subagents-in-foreground-or-background)。每個 subagent 實現其單位、運行測試並發佈其變更。需要 git 儲存庫或建立 worktree 的 [`WorktreeCreate` hook](https://code.claude.com/docs/zh-TW/worktrees#non-git-version-control)。在 git 儲存庫外，`/batch` 需要 Claude Code v2.1.281 或更新版本。範例：`/batch migrate src/ from JavaScript to TypeScript` |62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/zh-TW/skills.md#bundled-skills)。** 跨程式碼庫並行協調大規模變更。研究程式碼庫，將工作分解為 5 到 30 個獨立單位，並呈現計畫。獲得批准後，在隔離的 [worktree](https://code.claude.com/docs/zh-TW/worktrees.md) 中為每個單位生成一個[背景 subagent](https://code.claude.com/docs/zh-TW/sub-agents.md#run-subagents-in-foreground-or-background)。每個 subagent 實現其單位、運行測試，並開啟 PR 或報告發生的情況。需要 git 儲存庫或建立 worktree 的 [`WorktreeCreate` hook](https://code.claude.com/docs/zh-TW/worktrees#non-git-version-control)。在 git 儲存庫外，`/batch` 需要 Claude Code v2.1.281 或更新版本。範例：`/batch migrate src/ from JavaScript to TypeScript` |

63| `/branch [name]` | 在此點建立目前對話的分支，以便您可以嘗試不同的方向而不會丟失目前的對話。切換到分支並保留原始分支，您可以使用 `/resume` 返回。要運行副本作為單獨的[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)而不是切換到它，請使用 `/fork`；要將側面任務交給 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 以報告回此對話，請使用 `/subtask` |63| `/branch [name]` | 在此點建立目前對話的分支，以便您可以嘗試不同的方向而不會丟失目前的對話。切換到分支並保留原始分支，您可以使用 `/resume` 返回。要運行副本作為單獨的[背景工作階段](https://code.claude.com/docs/zh-TW/agent-view.md)而不是切換到它，請使用 `/fork`；要將側面任務交給 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md) 以報告回此對話，請使用 `/subtask` |

64| `/btw [question]` | 詢問有關目前工作階段的[側面問題](https://code.claude.com/docs/zh-TW/interactive-mode.md#side-questions-with-%2Fbtw)而不添加到對話中。如果您運行 `/btw` 而沒有問題，Claude Code 會顯示您最近的側面問題，以便您可以瀏覽較早的答案；如果您還沒有提出問題，Claude Code 會列印使用行 |64| `/btw [question]` | 詢問有關目前工作階段的[側面問題](https://code.claude.com/docs/zh-TW/interactive-mode.md#side-questions-with-%2Fbtw)而不添加到對話中。如果您運行 `/btw` 而沒有問題，Claude Code 會顯示您最近的側面問題，以便您可以瀏覽較早的答案；如果您還沒有提出問題，Claude Code 會列印使用行 |

65| `/bug [report]` | 報告錯誤或分享您的對話。您選擇要包含多少工作階段歷史記錄，並在發送任何內容之前在同意螢幕上確認。當您在第一方連線上登入 Anthropic 時，報告會發送給 Anthropic；在第三方提供者上，或沒有 Anthropic 憑證，Claude Code 會將報告寫入[`~/.claude/feedback-bundles/` 下的本地存檔](https://code.claude.com/docs/zh-TW/data-usage#telemetry-services)，您可以自己轉發。在 [VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md#use-the-prompt-box)中，`/bug` 改為打開擴充功能自己的回饋對話框；需要 Claude Code v2.1.229 或更新版本。當您在 Claude 回應時運行它時，Claude Code 會立即打開對話框。在 v2.1.232 之前，Claude Code 會將命令排隊直到該回合完成。別名：`/share`。在 v2.1.212 之前，`/bug` 和 `/share` 是 `/feedback` 的別名 |65| `/bug [report]` | 報告錯誤或分享您的對話。您選擇要包含多少工作階段歷史記錄，並在發送任何內容之前在同意螢幕上確認。當您在第一方連線上登入 Anthropic 時，報告會發送給 Anthropic；在第三方提供者上，或沒有 Anthropic 憑證，Claude Code 會將報告寫入[`~/.claude/feedback-bundles/` 下的本地存檔](https://code.claude.com/docs/zh-TW/data-usage#telemetry-services)，您可以自己轉發。在 [VS Code 擴充功能](https://code.claude.com/docs/zh-TW/vs-code.md#use-the-prompt-box)中，`/bug` 改為打開擴充功能自己的回饋對話框；需要 Claude Code v2.1.229 或更新版本。當您在 Claude 回應時運行它時，Claude Code 會立即打開對話框。在 v2.1.232 之前，Claude Code 會將命令排隊直到該回合完成。別名：`/share`。在 v2.1.212 之前，`/bug` 和 `/share` 是 `/feedback` 的別名 |

335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 設為 `1` 可透過第二個非阻塞檔案描述元寫入終端機輸出，讓停止讀取的終端機（例如暫停的 tmux control-mode 窗格或停滯的 SSH 連線）無法在工作階段中途凍結 Claude Code。在 stdout 為終端機時，適用於 macOS、Linux 與 WSL。需要 Claude Code v2.1.261 或更新版本 |335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 設為 `1` 可透過第二個非阻塞檔案描述元寫入終端機輸出，讓停止讀取的終端機（例如暫停的 tmux control-mode 窗格或停滯的 SSH 連線）無法在工作階段中途凍結 Claude Code。在 stdout 為終端機時，適用於 macOS、Linux 與 WSL。需要 Claude Code v2.1.261 或更新版本 |

336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | 限制 Claude Code 重新傳送逾時的[非串流請求](https://code.claude.com/docs/zh-TW/errors.md#streaming-response-ended-before-any-complete-data-was-received)的次數。設為 `0` 時，請求會在第一次逾時時失敗。關於逾時時間，請參閱[調整重試行為](https://code.claude.com/docs/zh-TW/errors.md#tune-retry-behavior)。需要 Claude Code v2.1.285 或更新版本 |336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | 限制 Claude Code 重新傳送逾時的[非串流請求](https://code.claude.com/docs/zh-TW/errors.md#streaming-response-ended-before-any-complete-data-was-received)的次數。設為 `0` 時，請求會在第一次逾時時失敗。關於逾時時間，請參閱[調整重試行為](https://code.claude.com/docs/zh-TW/errors.md#tune-retry-behavior)。需要 Claude Code v2.1.285 或更新版本 |

337| `CLAUDE_CODE_NO_FLICKER` | 設為 `1` 以啟用[全螢幕呈現](https://code.claude.com/docs/zh-TW/fullscreen.md)，這是一項研究預覽功能，可減少閃爍並在長對話中保持記憶體用量穩定。覆寫 [`tui`](https://code.claude.com/docs/zh-TW/settings-reference#tui) 設定；您也可以使用 `/tui fullscreen` 切換 |337| `CLAUDE_CODE_NO_FLICKER` | 設為 `1` 以啟用[全螢幕呈現](https://code.claude.com/docs/zh-TW/fullscreen.md)，這是一項研究預覽功能，可減少閃爍並在長對話中保持記憶體用量穩定。覆寫 [`tui`](https://code.claude.com/docs/zh-TW/settings-reference#tui) 設定；您也可以使用 `/tui fullscreen` 切換 |

338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | 用於 Claude.ai 身分驗證的 OAuth refresh token。設定後，`claude auth login` 會直接交換此 token，而不會開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。適用於在自動化環境中佈建身分驗證 |338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | 用於 claude.ai 身分驗證的 OAuth 重新整理 token。設定後，`claude auth login` 會直接交換此 token，而不是開啟瀏覽器。需要 `CLAUDE_CODE_OAUTH_SCOPES`。適用於在自動化環境中佈建身分驗證。在[專案和本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略 |

339| `CLAUDE_CODE_OAUTH_SCOPES` | 以空格分隔、核發 refresh token 時所使用的 OAuth 範圍，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必要 |339| `CLAUDE_CODE_OAUTH_SCOPES` | 重新整理 token 核發時所用的 OAuth 範圍，以空格分隔，例如 `"user:profile user:inference user:sessions:claude_code"`。設定 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 時為必要項目。在[專案和本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略 |

340| `CLAUDE_CODE_OAUTH_TOKEN` | 用於 claude.ai 身分驗證的 OAuth access token。在 SDK 與自動化環境中可取代 `/login`。優先於儲存在鑰匙圈中的憑證。使用 [`claude setup-token`](https://code.claude.com/docs/zh-TW/authentication#generate-a-long-lived-token) 產生。除非您執行 [`/login`](https://code.claude.com/docs/zh-TW/authentication#authentication-precedence)，否則 Claude Code 會在整個工作階段中使用您設定的 token。若要取代已過期的 token，請產生新的 token 並重新啟動 |340| `CLAUDE_CODE_OAUTH_TOKEN` | 用於 claude.ai 身分驗證的 OAuth 存取 token。在 SDK 和自動化環境中可替代 `/login`。在[專案和本機設定](https://code.claude.com/docs/zh-TW/settings-reference.md#variables-claude-code-ignores-in-env)中會被忽略。優先於儲存在鑰匙圈中的憑證。使用 [`claude setup-token`](https://code.claude.com/docs/zh-TW/authentication#generate-a-long-lived-token) 產生。除非您執行 [`/login`](https://code.claude.com/docs/zh-TW/authentication#authentication-precedence)，否則 Claude Code 會在整個工作階段中使用您設定的 token。若要取代已過期的 token，請產生新的 token 並重新啟動 |

341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 已於 v2.1.160 移除，現在不具作用。先前會將[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)固定為 Claude Opus 4.6，而非目前的預設值。Opus 4.6 已不再支援快速模式 |341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 已於 v2.1.160 移除，現在不具作用。先前會將[快速模式](https://code.claude.com/docs/zh-TW/fast-mode.md)固定為 Claude Opus 4.6，而非目前的預設值。Opus 4.6 已不再支援快速模式 |

342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | 承載內容的 OpenTelemetry 屬性（模型回應、工具內容、系統提示詞、原始 API 主體）的最大長度，包含截斷標記，以 UTF-16 碼元計算（預設：61440，即 60 KB）。僅在您的遙測後端接受大於 64 KB 的屬性值時才調高，或調低以減少遙測量。需要 Claude Code v2.1.214 或更新版本。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | 承載內容的 OpenTelemetry 屬性（模型回應、工具內容、系統提示詞、原始 API 主體）的最大長度，包含截斷標記，以 UTF-16 碼元計算（預設：61440，即 60 KB）。僅在您的遙測後端接受大於 64 KB 的屬性值時才調高，或調低以減少遙測量。需要 Claude Code v2.1.214 或更新版本。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | 設為 `1` 可將 OpenTelemetry 匯出器的診斷錯誤寫入 stderr。預設情況下，這些錯誤只會在使用 `--debug` 時出現，因此設定錯誤的匯出器（例如 Prometheus 連接埠衝突）否則會無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | 設為 `1` 可將 OpenTelemetry 匯出器的診斷錯誤寫入 stderr。預設情況下，這些錯誤只會在使用 `--debug` 時出現，因此設定錯誤的匯出器（例如 Prometheus 連接埠衝突）否則會無聲失敗。需要 Claude Code v2.1.179 或更新版本。請參閱[監控](https://code.claude.com/docs/zh-TW/monitoring-usage.md) |

66| `This organization has been disabled` | [身分驗證](#this-organization-has-been-disabled) |66| `This organization has been disabled` | [身分驗證](#this-organization-has-been-disabled) |

67| `Your organization has disabled API key authentication` | [身分驗證](#your-organization-has-disabled-api-key-authentication) |67| `Your organization has disabled API key authentication` | [身分驗證](#your-organization-has-disabled-api-key-authentication) |

68| `Your organization has disabled Claude subscription access` | [身分驗證](#your-organization-has-disabled-claude-subscription-access) |68| `Your organization has disabled Claude subscription access` | [身分驗證](#your-organization-has-disabled-claude-subscription-access) |

69| `Routines are disabled by your organization's policy` | [身分驗證](#routines-are-disabled-by-your-organizations-policy) |69| `Scheduled tasks are off for your organization` | [身分驗證](#routines-are-disabled-by-your-organizations-policy) |

70| `Routines are off for your organization` | [身分驗證](#routines-are-disabled-by-your-organizations-policy) |

70| `Remote Control is only available when using Claude via api.anthropic.com` | [身分驗證](#remote-control-requires-the-anthropic-api) |71| `Remote Control is only available when using Claude via api.anthropic.com` | [身分驗證](#remote-control-requires-the-anthropic-api) |

71| `OAuth token refresh failed — run /login to re-authenticate` | [身分驗證](#remote-control-couldnt-refresh-your-login) |72| `OAuth token refresh failed — run /login to re-authenticate` | [身分驗證](#remote-control-couldnt-refresh-your-login) |

72| `JWT refresh failed: no OAuth token — run /login` | [身分驗證](#remote-control-couldnt-refresh-your-login) |73| `JWT refresh failed: no OAuth token — run /login` | [身分驗證](#remote-control-couldnt-refresh-your-login) |

251| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [命令列錯誤](#mcp-permission-prompt-tool-not-found) |252| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [命令列錯誤](#mcp-permission-prompt-tool-not-found) |

252| `OAuth callback port <port> is already in use — another process may be holding it` | [命令列錯誤](#oauth-callback-port-is-already-in-use) |253| `OAuth callback port <port> is already in use — another process may be holding it` | [命令列錯誤](#oauth-callback-port-is-already-in-use) |

253| `No available ports for OAuth redirect` | [命令列錯誤](#no-available-ports-for-oauth-redirect) |254| `No available ports for OAuth redirect` | [命令列錯誤](#no-available-ports-for-oauth-redirect) |

254| `Shell command failed for pattern "..."`，來自 `/security-review` 或任何注入動態上下文的 skill | [命令列錯誤](#security-review-fails-without-origin-head) |255| 來自 `/security-review` 或任何注入動態上下文之 skill 的 `Shell command failed for pattern "..."` | [命令列錯誤](#security-review-fails-without-origin-head) |

255| 來自注入動態上下文之 skill 的 `Shell command permission check failed for pattern "..."` | [命令列錯誤](#security-review-fails-without-origin-head) |256| 來自注入動態上下文之 skill 的 `Shell command permission check failed for pattern "..."` | [命令列錯誤](#security-review-fails-without-origin-head) |

256| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [命令列錯誤](#security-review-fails-without-origin-head) |257| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [命令列錯誤](#security-review-fails-without-origin-head) |

257| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [命令列錯誤](#no-shell-command-was-run) |258| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [命令列錯誤](#no-shell-command-was-run) |

755Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.756Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

756```757```

757 758 

759某些拒絕不會計入這十次，包括[因 hook 或 mod 的變更而產生的拒絕](#hook-changed-input-after-review)。

760 

758停止訊息在不同類型的工作階段中出現的位置不同：761停止訊息在不同類型的工作階段中出現的位置不同：

759 762 

760* 在互動工作階段中，訊息會以警告形式出現在逐字稿中，且該回合結束763* 在互動工作階段中，訊息會以警告形式出現在逐字稿中，且該回合結束

774 777 

775在 v2.1.302 之前，在直接連線至 Anthropic API 時，Claude Code 不會壓縮已長到超出伺服器檢查容量的對話。778在 v2.1.302 之前，在直接連線至 Anthropic API 時，Claude Code 不會壓縮已長到超出伺服器檢查容量的對話。

776 779 

780#### `a hook changed this call's input after auto mode reviewed it`

781 

782此拒絕表示某個 hook 或 mod 在伺服器審查之後[變更了該呼叫的輸入](https://code.claude.com/docs/zh-TW/hooks.md#pretooluse-updatedinput-in-auto-mode)，因此審查並未涵蓋實際將執行的內容。這並不是判定該動作不安全。

783 

784同一個 Claude 回應中的後續呼叫可能會以此原因遭到拒絕：

785 

786```text theme={null}

787another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged

788```

789 

790Claude 接著可以再次發出每個遭拒絕的呼叫，讓伺服器進行審查。若出現權限提示，請回應它。除非 Claude 在回覆中表示自動模式無法檢查該呼叫，否則您不需要做其他任何事。屆時，請停止該變更或自行核准該呼叫，並請 Claude 再試一次該呼叫：

791 

792* **停止變更**：關閉變更了該呼叫或同一個 Claude 回應中較早呼叫的 [hook](https://code.claude.com/docs/zh-TW/hooks.md#disable-or-remove-hooks) 或 [mod](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md#turn-mods-on-or-off)，或請您的管理員將其關閉。若要尋找 hook，請在 Claude Code 提示字元中執行 [`/hooks`](https://code.claude.com/docs/zh-TW/hooks#the-%2Fhooks-menu)。在終端機工作階段中，執行 `/plugin` 以查看作用中的 mod。

793* **自行核准該呼叫**：[切換至手動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#switch-permission-modes)

794 

777### Was not reviewed and did not run795### Was not reviewed and did not run

778 796 

779`was not reviewed and did not run` 拒絕表示對話太長，[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)分類器無法檢查該動作，因此該動作未執行。Claude Code 會將此訊息傳回給 Claude：797`was not reviewed and did not run` 拒絕表示對話太長，[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)分類器無法檢查該動作，因此該動作未執行。Claude Code 會將此訊息傳回給 Claude：

1188* 改用 Console API 金鑰而非訂閱進行身分驗證。設定方式請參閱 [Claude Console 身分驗證](https://code.claude.com/docs/zh-TW/authentication.md#claude-console-authentication)。1206* 改用 Console API 金鑰而非訂閱進行身分驗證。設定方式請參閱 [Claude Console 身分驗證](https://code.claude.com/docs/zh-TW/authentication.md#claude-console-authentication)。

1189* 如果您是管理員卻看不到啟用存取的選項，請聯絡 [Anthropic 支援](https://support.claude.com)1207* 如果您是管理員卻看不到啟用存取的選項，請聯絡 [Anthropic 支援](https://support.claude.com)

1190 1208 

1191### 您組織的政策已停用 routine1209### Scheduled tasks are off for your organization

1192 1210 

1193您 Team 或 Enterprise 組織中的 Owner 已在組織層級關閉[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)（前身為 routine）。當您嘗試建立或執行排程任務時會出現此錯誤，例如在 [claude.ai/code/routines](https://claude.ai/code/routines)。在 Claude Code v2.1.227 或更新版本中，相同的設定也會在 CLI 中[隱藏 `/schedule`](https://code.claude.com/docs/zh-TW/routines#troubleshooting)。1211您的組織已關閉[雲端排程任務](https://code.claude.com/docs/zh-TW/routines.md)，因此您無法建立或執行它們。來自 claude.ai 的訊息會稱之為 scheduled tasks 或 routines，並在後面附上一句關於您管理員的說明：

1194 1212 

1195```text theme={null}1213```text theme={null}

1196Routines are disabled by your organization's policy.1214Scheduled tasks are off for your organization. …

1215Routines are off for your organization. …

1197```1216```

1198 1217 

1199這是伺服器端設定，因此無法透過本機設定、環境變數或 CLI 旗標覆寫。1218您無法透過本機設定、環境變數或 CLI 旗標開啟它們。

1200 1219 

1201**處理方式：**1220**處理方式：**

1202 1221 

1203* 請您組織中的 Owner 在 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) 開啟 **Scheduled tasks (Was Routines)** 切換開關1222* 詢問您的 Team 或 Enterprise 擁有者，是否能在 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) 開啟標示為 **Scheduled tasks (Was Routines)** 或 **Routines** 的切換開關

1204 1223 

1205### Remote Control 需要 Anthropic API1224### Remote Control 需要 Anthropic API

1206 1225 

197* **如果您接受**：Claude Code 會將新模型 ID 寫入您的[使用者設定檔](https://code.claude.com/docs/zh-TW/settings.md)並重新啟動197* **如果您接受**：Claude Code 會將新模型 ID 寫入您的[使用者設定檔](https://code.claude.com/docs/zh-TW/settings.md)並重新啟動

198* **如果您拒絕**：Claude Code 會記住您的選擇，直到下一次預設版本變更198* **如果您拒絕**：Claude Code 會記住您的選擇，直到下一次預設版本變更

199 199 

200對於位於[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)之 `env` 區塊中的固定，Claude Code 不會執行檢查，也不會顯示提示。200對於位於[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)之 `env` 區塊中的固定，Claude Code 不會執行檢查，也不會顯示提示。如果針對此固定仍出現更新提示，請將 Claude Code 更新至 v2.1.314 或更新版本。在 v2.1.314 之前，受管固定在您接受後仍會持續生效，因此提示會在下次啟動時再次出現。

201 201 

202如果您尚未固定模型，且目前預設值在您的專案中無法使用，Claude Code 會在目前工作階段中回退並顯示通知。它會先嘗試預設模型的較早版本，當預設為 Opus 模型且沒有可用的 Opus 版本時，會回退到預設 Sonnet 模型。回退不會被保留。在 [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中啟用較新模型或[固定版本](#5-pin-model-versions)以使選擇永久化。202如果您尚未固定模型，且目前預設值在您的專案中無法使用，Claude Code 會在目前工作階段中回退並顯示通知。它會先嘗試預設模型的較早版本，當預設為 Opus 模型且沒有可用的 Opus 版本時，會回退到預設 Sonnet 模型。回退不會被保留。在 [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) 中啟用較新模型或[固定版本](#5-pin-model-versions)以使選擇永久化。

203 203 

204### 在特定模型上啟動工作階段

205 

204當您在特定 Sonnet 或 Opus 版本上啟動工作階段時，例如使用 `--model`、`ANTHROPIC_MODEL` 或 [`model` 設定](https://code.claude.com/docs/zh-TW/settings-reference#model)，該版本會作為工作階段針對相符 `sonnet` 或 `opus` 別名的固定預設值。Claude Code 會略過您設定的模型所取代之內建預設值的可用性檢查，並在您設定的模型上啟動，不會有回退通知。206當您在特定 Sonnet 或 Opus 版本上啟動工作階段時，例如使用 `--model`、`ANTHROPIC_MODEL` 或 [`model` 設定](https://code.claude.com/docs/zh-TW/settings-reference#model)，該版本會作為工作階段針對相符 `sonnet` 或 `opus` 別名的固定預設值。Claude Code 會略過您設定的模型所取代之內建預設值的可用性檢查，並在您設定的模型上啟動，不會有回退通知。

205 207 

206模型別名（例如 `opus`）不會作為固定，Claude Code 無法識別的模型 ID 也不會。208當您以模型別名（例如 `opus`）或 Claude Code 無法識別的模型 ID 啟動工作階段時，該值不會作為固定。

209 

210### 記住的模型拒絕

207 211 

208當這些檢查發現您的專案無法呼叫的模型時，Claude Code 會在此機器上記住拒絕長達一天，並在該時間內啟動時略過記住的模型，而不會再次詢問 Agent Platform。Claude Code 會在距離上次檢查已過十分鐘後，再次檢查目前預設模型的記住拒絕，因此您的管理員重新啟用的預設值會恢復。若要關閉此記憶功能，請設定 [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/zh-TW/env-vars)。212當啟動模型檢查發現您的專案無法呼叫的模型時，Claude Code 可以在此機器上記住該拒絕長達一天。在距離上次檢查已過十分鐘後，Claude Code 會在啟動時再次檢查目前預設模型的記住拒絕。您的管理員重新啟用的預設值便會恢復。若要關閉此記憶功能，請設定 [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/zh-TW/env-vars)。

209 213 

210### 當您的組織強制執行模型允許清單時214### 當您的組織強制執行模型允許清單時

211 215 

901 901 

902#### 在 hook 失敗時阻止操作902#### 在 hook 失敗時阻止操作

903 903 

904在大多數事件上，當 hook 失敗或逾時時，Claude Code 仍會執行該操作。如此一來，路徑錯誤或指令碼當機的原則 hook 會讓所有操作通過。若要改為阻止操作，請在 `command` 或 `http` hook 上設定 `"onFailure": "block"`。需要 Claude Code v2.1.295 或更新版本。904在大多數事件上，當 hook 失敗或逾時時，Claude Code 仍會執行該操作。如此一來，路徑錯誤或指令碼當機的原則 hook 會讓所有操作通過。若要改為阻止操作，請在 `command` 或 `http` hook 上設定 `"onFailure": "block"`。需要 Claude Code v2.1.295 或更新版本。關於 Agent SDK 回呼 hook，請參閱[在回呼失敗時阻止操作](https://code.claude.com/docs/zh-TW/agent-sdk/hooks.md#block-the-action-when-a-callback-fails)。

905 905 

906> [!NOTE]906> [!NOTE]

907>907>

1960| :- | :- |1960| :- | :- |

1961| `permissionDecision` | `"allow"` 會略過權限提示，但[沒有任何模式會自動核准的動作](https://code.claude.com/docs/zh-TW/permission-modes.md#actions-no-mode-auto-approves)和[從網路路徑讀取](https://code.claude.com/docs/zh-TW/permissions.md#network-paths)除外。對於[Agent SDK 應用程式標記為 `always_ask` 的工具](https://code.claude.com/docs/zh-TW/agent-sdk/custom-tools#require-approval-for-specific-tools)的呼叫，它也不會略過核准，除非[權限模式核准了該呼叫](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call)。`AskUserQuestion` 和 `ExitPlanMode` 需要[與 `"allow"` 搭配的 `updatedInput`](#allow-with-updatedinput)。關於 plan mode，請參閱[plan mode 中的 hook 核准](https://code.claude.com/docs/zh-TW/permissions.md#hook-approvals-in-plan-mode)。`"deny"` 會阻止工具呼叫。`"ask"` 會提示使用者確認。`"defer"` 會結束回合，讓工具稍後可以恢復，且需要使用 `-p` 旗標的[非互動模式](#defer-a-tool-call-for-later)。無論 hook 回傳什麼，[拒絕與詢問規則](https://code.claude.com/docs/zh-TW/permissions.md#manage-permissions)仍會被評估 |1961| `permissionDecision` | `"allow"` 會略過權限提示，但[沒有任何模式會自動核准的動作](https://code.claude.com/docs/zh-TW/permission-modes.md#actions-no-mode-auto-approves)和[從網路路徑讀取](https://code.claude.com/docs/zh-TW/permissions.md#network-paths)除外。對於[Agent SDK 應用程式標記為 `always_ask` 的工具](https://code.claude.com/docs/zh-TW/agent-sdk/custom-tools#require-approval-for-specific-tools)的呼叫，它也不會略過核准，除非[權限模式核准了該呼叫](https://code.claude.com/docs/zh-TW/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call)。`AskUserQuestion` 和 `ExitPlanMode` 需要[與 `"allow"` 搭配的 `updatedInput`](#allow-with-updatedinput)。關於 plan mode，請參閱[plan mode 中的 hook 核准](https://code.claude.com/docs/zh-TW/permissions.md#hook-approvals-in-plan-mode)。`"deny"` 會阻止工具呼叫。`"ask"` 會提示使用者確認。`"defer"` 會結束回合，讓工具稍後可以恢復，且需要使用 `-p` 旗標的[非互動模式](#defer-a-tool-call-for-later)。無論 hook 回傳什麼，[拒絕與詢問規則](https://code.claude.com/docs/zh-TW/permissions.md#manage-permissions)仍會被評估 |

1962| `permissionDecisionReason` | 對於 `"ask"`，會在權限提示中向使用者顯示。當 Claude Code 在沒有人能回應該提示的 `-p` 執行中[拒絕呼叫](https://code.claude.com/docs/zh-TW/headless.md#turn-off-permission-prompts-in-unattended-runs)時，Claude 會改為在工具結果中讀到原因。對於 `"deny"`，會向 Claude 顯示。對於 `"allow"` 和 `"defer"`，只會寫入[除錯日誌](#debug-hooks) |1962| `permissionDecisionReason` | 對於 `"ask"`，會在權限提示中向使用者顯示。當 Claude Code 在沒有人能回應該提示的 `-p` 執行中[拒絕呼叫](https://code.claude.com/docs/zh-TW/headless.md#turn-off-permission-prompts-in-unattended-runs)時，Claude 會改為在工具結果中讀到原因。對於 `"deny"`，會向 Claude 顯示。對於 `"allow"` 和 `"defer"`，只會寫入[除錯日誌](#debug-hooks) |

1963| `updatedInput` | 在執行前修改工具的輸入參數。會取代整個輸入物件，因此請將未變更的欄位與修改過的欄位一併包含。Claude Code 會根據您 hook 回傳的輸入（而非 Claude 傳送的輸入）評估權限規則，以及 Bash 命令的[自動移至背景資格](https://code.claude.com/docs/zh-TW/tools-reference.md#foreground-commands-that-move-to-the-background)。與 `"allow"` 搭配可自動核准，或與 `"ask"` 搭配向使用者顯示修改後的輸入。對於 `"defer"`，會被忽略 |1963| `updatedInput` | 在執行前修改工具的輸入參數。會取代整個輸入物件，因此請將未變更的欄位與修改過的欄位一起納入。Claude Code 會針對您的 hook 回傳的輸入（而非 Claude 傳送的輸入）評估權限規則和 Bash 命令的[自動移至背景資格](https://code.claude.com/docs/zh-TW/tools-reference.md#foreground-commands-that-move-to-the-background)。搭配 `"allow"` 可自動核准，搭配 `"ask"` 可向使用者顯示修改後的輸入。對於 `"defer"` 會被忽略。若沒有 `permissionDecision`，[自動模式可能會拒絕變更後的呼叫](#pretooluse-updatedinput-in-auto-mode) |

1964| `additionalContext` | 與工具結果一同加入 Claude 情境的字串。當 `permissionDecision` 為 `"defer"` 時會被忽略。請參閱[為 Claude 新增情境](#add-context-for-claude) |1964| `additionalContext` | 與工具結果一同加入 Claude 情境的字串。當 `permissionDecision` 為 `"defer"` 時會被忽略。請參閱[為 Claude 新增情境](#add-context-for-claude) |

1965 1965 

1966當多個 PreToolUse hook 回傳不同的決策時，優先順序為 `deny` > `defer` > `ask` > `allow`。1966當多個 PreToolUse hook 回傳不同的決策時，優先順序為 `deny` > `defer` > `ask` > `allow`。

1987>1987>

1988> PreToolUse 先前使用頂層的 `decision` 和 `reason` 欄位，但這些欄位在此事件中已棄用。請改用 `hookSpecificOutput.permissionDecision` 和 `hookSpecificOutput.permissionDecisionReason`。已棄用的值 `"approve"` 和 `"block"` 分別對應到 `"allow"` 和 `"deny"`。PostToolUse 和 Stop 等其他事件則繼續以頂層 `decision` 和 `reason` 作為其目前的格式。1988> PreToolUse 先前使用頂層的 `decision` 和 `reason` 欄位，但這些欄位在此事件中已棄用。請改用 `hookSpecificOutput.permissionDecision` 和 `hookSpecificOutput.permissionDecisionReason`。已棄用的值 `"approve"` 和 `"block"` 分別對應到 `"allow"` 和 `"deny"`。PostToolUse 和 Stop 等其他事件則繼續以頂層 `decision` 和 `reason` 作為其目前的格式。

1989 1989 

1990#### 自動模式中的 PreToolUse `updatedInput`

1991 

1992當您的 hook 在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)中回傳 `updatedInput` 但沒有 `permissionDecision` 時，Claude Code 可能會拒絕變更後的呼叫。[伺服器審查的](https://code.claude.com/docs/zh-TW/permission-modes.md#server-side-classifier-review)是 Claude 撰寫的輸入，而不是您的 hook 回傳的輸入。在直接連線到 Anthropic API 的互動式終端機工作階段和 VS Code 工作階段中，拒絕訊息會包含下列文字：

1993 

1994```text theme={null}

1995a hook changed this call's input after auto mode reviewed it

1996```

1997 

1998在出現此文字的拒絕之後，Claude 可以再次發出變更後的呼叫，讓伺服器審查它。若 Claude 在下一個回應中完全重複變更後的輸入，您的 hook 仍會執行：

1999 

2000* 它可以拒絕該呼叫，或將其送到權限提示

2001* 它回傳的任何 `updatedInput` 都會被捨棄，因此實際執行的就是伺服器審查過的內容

2002 

2003除非 [Claude 在回覆中告訴您自動模式無法檢查該呼叫](https://code.claude.com/docs/zh-TW/errors.md#hook-changed-input-after-review)，否則您不需要為了此拒絕而變更 hook。

2004 

2005在會顯示此文字的工作階段中，設定中或外掛 hook 檔案中的 [`command` hook](#command-hook-fields) 可以變更 Bash、PowerShell、Monitor、Edit、Write 和 NotebookEdit 呼叫而不會觸發此拒絕。拒絕仍可能出現，例如當任何 hook 變更了同一個 Claude 回應中較早的呼叫，或 Bash 命令要求在沙箱外執行時。

2006 

1990#### 自動模式中的 PreToolUse `ask` 決策2007#### 自動模式中的 PreToolUse `ask` 決策

1991 2008 

1992在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)中，PreToolUse hook 的 `"ask"` 通常會將工具呼叫送往權限提示，而[分類器](https://code.claude.com/docs/zh-TW/permission-modes.md#how-the-classifier-evaluates-actions)不會對其做出決定。有些呼叫則會走不同的路徑：2009在[自動模式](https://code.claude.com/docs/zh-TW/permission-modes.md#eliminate-prompts-with-auto-mode)中，PreToolUse hook 的 `"ask"` 通常會將工具呼叫送往權限提示，而[分類器](https://code.claude.com/docs/zh-TW/permission-modes.md#how-the-classifier-evaluates-actions)不會對其做出決定。有些呼叫則會走不同的路徑：

287 287 

288### 使用 Ctrl+R 進行反向搜尋288### 使用 Ctrl+R 進行反向搜尋

289 289 

290按 `Ctrl+R` 以互動方式搜尋您的命令歷史。在[全螢幕渲染](https://code.claude.com/docs/zh-TW/fullscreen.md)中，`Ctrl+R` 會開啟搜尋對話框：輸入以篩選、按 `Up` 和 `Down` 在符合項目中移動，以及按 `Ctrl+S` 循環切換範圍（此工作階段、此專案和所有專案）。按 `Enter` 或 `Tab` 將符合項目放在提示詞輸入中，或按 `Esc` 取消。下面的步驟說明傳統渲染器的內嵌搜尋：290按 `Ctrl+R` 以互動方式搜尋您的命令歷史。在[全螢幕渲染](https://code.claude.com/docs/zh-TW/fullscreen.md)中，`Ctrl+R` 會改為開啟搜尋對話框。在對話框中輸入以篩選，並按 `Up` 和 `Down` 在符合項目清單中移動，預覽窗格會顯示反白符合項目的開頭部分。

291 

292在對話框中，按 `Ctrl+S` 可在此工作階段、此專案和所有專案之間循環切換範圍。按 `Enter` 或 `Tab` 將符合項目放在提示詞輸入中，或按 `Esc` 取消。下面的步驟說明傳統渲染器的內嵌搜尋：

291 293 

2921. **開始搜尋**：按 `Ctrl+R` 啟動反向歷史搜尋2941. **開始搜尋**：按 `Ctrl+R` 啟動反向歷史搜尋

2932. **輸入查詢**：輸入要在先前命令中搜尋的文字。搜尋詞在符合結果中會被反白顯示2952. **輸入查詢**：輸入要在先前命令中搜尋的文字。目前的符合項目會出現在提示詞輸入中。

2943. **導覽符合項目**：再次按 `Ctrl+R` 循環瀏覽較舊的符合項目2963. **導覽符合項目**：再次按 `Ctrl+R` 循環瀏覽較舊的符合項目

2954. **搜尋範圍**：內嵌搜尋始終搜尋來自所有專案的提示詞2974. **搜尋範圍**：內嵌搜尋始終搜尋來自所有專案的提示詞

2965. **接受符合項目**：2985. **接受符合項目**：

300 * 按 `Ctrl+C` 取消並還原您的原始輸入302 * 按 `Ctrl+C` 取消並還原您的原始輸入

301 * 在空搜尋上按 `Backspace` 取消303 * 在空搜尋上按 `Backspace` 取消

302 304 

303內嵌搜尋會掃描您的完整提示詞歷史（最新優先），並將重複項目摺疊到最新出現的位置。全螢幕對話框會在選定的範圍內搜尋您的整個提示詞歷史（最新優先），並將重複項目摺疊到最新出現的位置：最近的提示詞會立即出現，而較舊提示詞的符合項目會在 Claude Code 載入其餘部分時填入。符合的提示詞會顯示搜尋詞反白顯示，因此您可以找到並重複使用先前的輸入。

304 

305接受符合項目或取消搜尋會立即生效，即使 Claude Code 仍在載入歷史。305接受符合項目或取消搜尋會立即生效，即使 Claude Code 仍在載入歷史。

306 306 

307## 背景 Bash 命令307## 背景 Bash 命令

39 39 

40從 JetBrains Marketplace 安裝 [Claude Code 外掛程式](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-)，然後重新啟動您的 IDE。40從 JetBrains Marketplace 安裝 [Claude Code 外掛程式](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-)，然後重新啟動您的 IDE。

41 41 

42> [!NOTE]

43>

44> JetBrains Marketplace 是第三方軟體，Anthropic 並未為其背書、維護或稽核。Anthropic 會將 Claude Code 外掛程式提交至 JetBrains Marketplace 以供發布。

45 

42如果 `claude` 安裝在您的 IDE 找不到的位置，請在外掛程式的 [Claude 命令設定](#general-settings)中設定完整路徑。46如果 `claude` 安裝在您的 IDE 找不到的位置，請在外掛程式的 [Claude 命令設定](#general-settings)中設定完整路徑。

43 47 

44Claude Code 適用於任何付費 Claude 訂閱（Pro、Max、Ultra、Team 或 Enterprise）或 Claude Console 帳戶，無需 API 金鑰。當您第一次執行 `claude` 時，系統會提示您[登入](https://code.claude.com/docs/zh-TW/authentication.md#log-in-to-claude-code) Claude Code。48Claude Code 適用於任何付費 Claude 訂閱（Pro、Max、Ultra、Team 或 Enterprise）或 Claude Console 帳戶，無需 API 金鑰。當您第一次執行 `claude` 時，系統會提示您[登入](https://code.claude.com/docs/zh-TW/authentication.md#log-in-to-claude-code) Claude Code。

278 278 

279在 v2.1.305 或更新版本上，收到命名工具搜尋或 Claude Code 無法識別原因的 `400` 或 `422` 後，Claude Code 會重新發送不含 [`defer_loading` 欄位和 `tool_reference` 區塊](https://code.claude.com/docs/zh-TW/mcp#tool-search-through-a-gateway)的請求。重試成功後，該對話中的後續請求也會省略它們。279在 v2.1.305 或更新版本上，收到命名工具搜尋或 Claude Code 無法識別原因的 `400` 或 `422` 後，Claude Code 會重新發送不含 [`defer_loading` 欄位和 `tool_reference` 區塊](https://code.claude.com/docs/zh-TW/mcp#tool-search-through-a-gateway)的請求。重試成功後，該對話中的後續請求也會省略它們。

280 280 

281開發人員的請求無需對閘道進行任何變更即可繼續運作，其 MCP 工具會預先載入。當 Claude Code 再次嘗試工具搜尋時，閘道會看到另一個被拒絕的請求及其重試。對於工具搜尋本身，Claude Code 預期閘道會轉發 `defer_loading` 欄位和 `tool_reference` 區塊及其 `anthropic-beta` 值。281開發人員的請求無需對閘道進行任何變更即可繼續運作，其 MCP 工具會預先載入。當 Claude Code 再次嘗試工具搜尋時，閘道可能會看到另一個被拒絕的請求及其後的重試。至於工具搜尋本身，Claude Code 預期閘道會轉送 `defer_loading` 欄位和 `tool_reference` 區塊，以及其 `anthropic-beta` 值。

282 282 

283### 禁用預發佈功能283### 禁用預發佈功能

284 284 

171* 沙箱二進位路徑 `sandbox.bwrapPath` 和 `sandbox.socatPath`171* 沙箱二進位路徑 `sandbox.bwrapPath` 和 `sandbox.socatPath`

172* 沙箱 `ripgrep` 二進位，[`sandbox.ripgrep`](https://code.claude.com/docs/zh-TW/settings-reference#sandbox-ripgrep)172* 沙箱 `ripgrep` 二進位，[`sandbox.ripgrep`](https://code.claude.com/docs/zh-TW/settings-reference#sandbox-ripgrep)

173* `sandbox.filesystem.disabled` 和 `sandbox.network.strictAllowlist`173* `sandbox.filesystem.disabled` 和 `sandbox.network.strictAllowlist`

174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/zh-TW/settings-reference#useautomodeduringplan)、[`syncClaudeAiSkills`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiskills) 和 [`syncClaudeAiPlugins`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiplugins)，其中任何管理員來源的 `false` 會關閉行為。開發人員的使用者或本機設定中的 `false` 也會關閉它；每個金鑰只能拒絕174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/zh-TW/settings-reference#useautomodeduringplan)、[`syncClaudeAiSkills`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiskills) 和 [`syncClaudeAiPlugins`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiplugins)，其中任何管理員來源的 `false` 會關閉行為。每個金鑰只能拒絕：

175 * 開發人員的使用者或本機設定中的 `false` 也會關閉它

176 * 對於 `useAutoModeDuringPlan`，開發人員使用 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 等選項排除的使用者或本機檔案中的 `false` 不計算。忽略被排除的檔案需要 Claude Code v2.1.314 或更新版本

175* [`enableArtifact`](https://code.claude.com/docs/zh-TW/settings-reference#enableartifact)，其中任何管理員來源的 `false` 會關閉 [Artifact 工具](https://code.claude.com/docs/zh-TW/artifacts.md)。開發人員的使用者、專案或本機設定中的 `false` 也會關閉它，沒有來源會將其開啟；請參閱 [哪些較低層級的值仍然計算](https://code.claude.com/docs/zh-TW/settings.md#exceptions-to-managed-settings-precedence)。需要 Claude Code v2.1.242 或更新版本177* [`enableArtifact`](https://code.claude.com/docs/zh-TW/settings-reference#enableartifact)，其中任何管理員來源的 `false` 會關閉 [Artifact 工具](https://code.claude.com/docs/zh-TW/artifacts.md)。開發人員的使用者、專案或本機設定中的 `false` 也會關閉它，沒有來源會將其開啟；請參閱 [哪些較低層級的值仍然計算](https://code.claude.com/docs/zh-TW/settings.md#exceptions-to-managed-settings-precedence)。需要 Claude Code v2.1.242 或更新版本

176* [`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel)，其中任何管理員來源中的最低上限適用。如果開發人員在自己的設定或使用 `--settings` 中設定較低的上限，Claude Code 會應用該上限；沒有來源可以提高上限。需要 Claude Code v2.1.267 或更新版本178* [`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel)，其中任何管理員來源中的最低上限適用。如果開發人員在自己的設定或使用 `--settings` 中設定較低的上限，Claude Code 會應用該上限；沒有來源可以提高上限。需要 Claude Code v2.1.267 或更新版本

177* `attribution` 中的提交預告片選擇退出，或在已棄用的 `includeCoAuthoredBy` 中，來自任何層級179* `attribution` 中的提交預告片選擇退出，或在已棄用的 `includeCoAuthoredBy` 中，來自任何層級

6134. 您的設定：您為模型儲存的等級或 [`effortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#effortlevel) 鍵，兩者之間以及各設定檔之間的優先順序說明於 [`modelSettings`](https://code.claude.com/docs/zh-TW/settings-reference#modelsettings)6134. 您的設定：您為模型儲存的等級或 [`effortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#effortlevel) 鍵，兩者之間以及各設定檔之間的優先順序說明於 [`modelSettings`](https://code.claude.com/docs/zh-TW/settings-reference#modelsettings)

6145. 模型的預設 effort：所有支援 effort 的模型都預設為 `high`，但 Opus 5.5、Sonnet 5.5 和 Haiku 5.5 預設為 `medium`，Opus 4.7 預設為 `xhigh`。如果您的組織為其[組織預設模型](#organization-default-model)設定了預設 effort 等級，該等級就是您執行該模型時的預設值。6145. 模型的預設 effort：所有支援 effort 的模型都預設為 `high`，但 Opus 5.5、Sonnet 5.5 和 Haiku 5.5 預設為 `medium`，Opus 4.7 預設為 `xhigh`。如果您的組織為其[組織預設模型](#organization-default-model)設定了預設 effort 等級，該等級就是您執行該模型時的預設值。

615 615 

616自動模型備援後適用的等級，請參閱[備援後的 effort 等級](#effort-level-after-a-fallback)。616自動模型備援後適用的等級，請參閱[備援後的 effort 等級](#effort-level-after-a-fallback)。關於 subagent 和隊員，請參閱[Subagent 與隊員的 effort 等級](#effort-level-of-subagents-and-teammates)。

617 617 

618除非上述來源之一為 Opus 5.5 設定了等級，否則 Opus 5.5 會從 `medium` 開始，且您使用者設定檔中的頂層 `effortLevel` 不會計入 Opus 5.5。該鍵是 Claude Code 開始按模型儲存等級之前 `/effort` 寫入的舊形式：它會繼續在先前適用的地方適用，即 Opus 5、Fable 5.1 及更早的模型，而 Opus 5.5 及其後發布的模型則會從自己的預設值開始，直到您使用 `/effort` 或 `/model` 選擇器為其選擇等級為止。專案、本機或受管設定中的頂層 `effortLevel`，或透過 `--settings` 傳入的 `effortLevel`，則適用於所有模型。618除非上述來源之一為 Opus 5.5 設定了等級，否則 Opus 5.5 會從 `medium` 開始，且您使用者設定檔中的頂層 `effortLevel` 不會計入 Opus 5.5。該鍵是 Claude Code 開始按模型儲存等級之前 `/effort` 寫入的舊形式：它會繼續在先前適用的地方適用，即 Opus 5、Fable 5.1 及更早的模型，而 Opus 5.5 及其後發布的模型則會從自己的預設值開始，直到您使用 `/effort` 或 `/model` 選擇器為其選擇等級為止。專案、本機或受管設定中的頂層 `effortLevel`，或透過 `--settings` 傳入的 `effortLevel`，則適用於所有模型。

619 619 

700 700 

701[`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel) 或[組織 effort 上限](#organization-effort-limits)仍會限制 skill 或 subagent 執行時的等級。如果您在[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中設定 `effortLevel`，Claude Code 會在 [effort 解析順序](#adjust-effort-level)的設定步驟套用它，使用者仍可使用 `/effort` 或 `--effort` 變更等級。若要讓使用者維持在某個等級或以下，請設定 [`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel)。701[`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel) 或[組織 effort 上限](#organization-effort-limits)仍會限制 skill 或 subagent 執行時的等級。如果您在[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)中設定 `effortLevel`，Claude Code 會在 [effort 解析順序](#adjust-effort-level)的設定步驟套用它，使用者仍可使用 `/effort` 或 `--effort` 變更等級。若要讓使用者維持在某個等級或以下，請設定 [`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel)。

702 702 

703#### Subagent 與隊員的 effort 等級

704 

705在主要對話的模型上，沒有自己 `effort` 的 [subagent](https://code.claude.com/docs/zh-TW/sub-agents.md#choose-an-effort-level) 或[隊員](https://code.claude.com/docs/zh-TW/agent-teams.md#specify-teammates-and-models)會以您在工作階段中選擇或透過 `--effort` 設定的等級執行。在其他模型上，該等級不適用。若要選擇 subagent 的等級，請在其定義中設定 `effort`。

706 

703#### 檢查您設定的 effort 等級707#### 檢查您設定的 effort 等級

704 708 

705選擇支援的模型時，effort 滑桿會出現在 `/model` 中。工作階段標頭中的等級（例如「with low effort」）來自您的 effort 設定，即使 Claude [仍以舊等級工作](#when-a-new-effort-level-starts)也是如此。頁尾也會在啟動時以及您變更等級時，短暫顯示為您工作階段設定的等級。709選擇支援的模型時，effort 滑桿會出現在 `/model` 中。工作階段標頭中的等級（例如「with low effort」）來自您的 effort 設定，即使 Claude [仍以舊等級工作](#when-a-new-effort-level-starts)也是如此。頁尾也會在啟動時以及您變更等級時，短暫顯示為您工作階段設定的等級。

330 330 

331在互動式 CLI 工作階段中，詳細測試版追蹤也需要您的組織被列入該功能的允許清單。Agent SDK 和非互動式 `-p` 工作階段不需要允許清單。331在互動式 CLI 工作階段中，詳細測試版追蹤也需要您的組織被列入該功能的允許清單。Agent SDK 和非互動式 `-p` 工作階段不需要允許清單。

332 332 

333> [!WARNING]

334>

335> 僅在除錯時設定 `ENABLE_BETA_TRACING_DETAILED`，請勿在正式環境中設定。詳細測試版追蹤的匯出量很高，且其[內容屬性](#new-context-gates)不屬於穩定跨度 schema 的一部分。

336 

333| 屬性 | 說明 | 由以下閘門控制 |337| 屬性 | 說明 | 由以下閘門控制 |

334| - | - | - |338| - | - | - |

335| `hook_event` | Hook 事件類型，例如 `PreToolUse` | |339| `hook_event` | Hook 事件類型，例如 `PreToolUse` | |

131 131 

132Claude Code 會在工作階段的偵錯記錄中記錄每個被忽略的金鑰。132Claude Code 會在工作階段的偵錯記錄中記錄每個被忽略的金鑰。

133 133 

134在[Claude Desktop](https://code.claude.com/docs/zh-TW/desktop.md) 工作階段中，應用程式管理提供者連線（例如[第三方提供者](https://code.claude.com/docs/zh-TW/third-party-integrations.md)上的 Code 標籤和 Cowork 工作階段），Claude Code 只會從[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)和 `~/.claude/settings.json` 讀取這些變數和 Proxy 變數 `HTTP_PROXY`、`HTTPS_PROXY` 和 `NO_PROXY`：它會忽略儲存庫自己的設定檔中的這些變數，因此簽出的儲存庫無法重新導向其認證來自應用程式的工作階段的 TLS 或 Proxy 路徑。在透過 claude.ai 登入的本機、SSH 或 WSL Code 標籤工作階段中，應用程式不會管理連線，Claude Code 會從每個設定範圍讀取這些變數，就像任何終端工作階段一樣；[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)無論您在何處啟動它們，都遵循上述雲端工作階段規則。在 v2.1.217 之前，當應用程式管理連線時，Claude Code 會忽略每個設定檔中的這些變數。134在由應用程式管理提供者連線的 [Claude Desktop](https://code.claude.com/docs/zh-TW/desktop.md) 工作階段中（例如[第三方提供者](https://code.claude.com/docs/zh-TW/third-party-integrations.md)上的 Code 標籤和 Cowork 工作階段），Claude Code 只會從[受管設定](https://code.claude.com/docs/zh-TW/managed-settings.md)和 `~/.claude/settings.json` 讀取這些變數（`CLAUDE_CODE_OAUTH_SCOPES` 除外）以及代理伺服器變數 `HTTP_PROXY`、`HTTPS_PROXY` 和 `NO_PROXY`。它會忽略儲存庫自己的設定檔中的這些變數，因此簽出的儲存庫無法重新導向憑證來自應用程式的工作階段的 TLS 或代理伺服器路徑。在 v2.1.217 之前，當應用程式管理連線時，Claude Code 會忽略每個設定檔中的這些變數。

135 

136在透過 claude.ai 登入的本機、SSH 或 WSL Code 標籤工作階段中，您可以在任何設定檔中設定這些變數和代理伺服器變數，`CLAUDE_CODE_OAUTH_SCOPES` 除外。Desktop 會在 Code 標籤和 Cowork 工作階段中自行設定 `CLAUDE_CODE_OAUTH_SCOPES`，因此您無法設定它。

137 

138當工作階段的啟動環境已設定某個變數時，Claude Code 會[忽略設定檔中的值](https://code.claude.com/docs/zh-TW/settings-reference.md#how-env-values-interact-with-your-shell)，並在[偵錯日誌](https://code.claude.com/docs/zh-TW/debug-your-config.md)中列出該變數的名稱。若要在本機工作階段中使用您自己的代理伺服器或憑證值，請[將其新增至已儲存的本機環境](https://code.claude.com/docs/zh-TW/desktop.md#set-environment-variables-for-local-sessions)。[雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md)無論您在何處啟動，都遵循上述雲端工作階段規則。

135 139 

136## 驗證您的設定140## 驗證您的設定

137 141 

383* **伺服器不審查工作階段**：回應完成時沒有審查結果，或伺服器回答它不審查此工作階段。最常見的原因是 LLM 閘道或代理伺服器丟棄了審查請求或結果，以及平台、區域或憑證尚未提供伺服器端檢查。Claude Code 會改用自己的分類器請求。一旦該備援在工作階段的其餘部分持續生效，它會在這些請求會被計費的帳戶上顯示[關於分類器請求費用的通知](https://code.claude.com/docs/zh-TW/auto-mode-classifier-billing.md)。383* **伺服器不審查工作階段**：回應完成時沒有審查結果，或伺服器回答它不審查此工作階段。最常見的原因是 LLM 閘道或代理伺服器丟棄了審查請求或結果，以及平台、區域或憑證尚未提供伺服器端檢查。Claude Code 會改用自己的分類器請求。一旦該備援在工作階段的其餘部分持續生效，它會在這些請求會被計費的帳戶上顯示[關於分類器請求費用的通知](https://code.claude.com/docs/zh-TW/auto-mode-classifier-billing.md)。

384* **伺服器對操作沒有給出判決**：Claude Code 會拒絕該操作，而不是在未經審查的情況下執行它。在任何連線上，當回應在審查結果到達前結束，或結果以 Claude Code 無法讀取的形式到達時，就會發生這種情況。截斷回應或重寫結果的 LLM 閘道或代理伺服器可能導致任一情況。在直接連接到 Anthropic API 時，當伺服器對該操作的檢查失敗（例如逾時）時也會發生。[伺服器未返回安全判決](https://code.claude.com/docs/zh-TW/errors.md#the-server-returned-no-safety-verdict)涵蓋拒絕訊息、拒絕重複發生時的情況以及應對方法。384* **伺服器對操作沒有給出判決**：Claude Code 會拒絕該操作，而不是在未經審查的情況下執行它。在任何連線上，當回應在審查結果到達前結束，或結果以 Claude Code 無法讀取的形式到達時，就會發生這種情況。截斷回應或重寫結果的 LLM 閘道或代理伺服器可能導致任一情況。在直接連接到 Anthropic API 時，當伺服器對該操作的檢查失敗（例如逾時）時也會發生。[伺服器未返回安全判決](https://code.claude.com/docs/zh-TW/errors.md#the-server-returned-no-safety-verdict)涵蓋拒絕訊息、拒絕重複發生時的情況以及應對方法。

385 385 

386 如果 [hook](https://code.claude.com/docs/zh-TW/hooks.md#pretooluse-updatedinput-in-auto-mode) 或 [mod](https://code.claude.com/docs/zh-TW/plugins/mods/overview.md) 在伺服器審查後變更了操作的輸入，Claude Code 可能會在沒有判決的情況下拒絕該操作。在直接連接到 Anthropic API 的互動式終端機和 VS Code 工作階段中，拒絕文字會包含 `a hook changed this call's input after auto mode reviewed it`。[其錯誤項目](https://code.claude.com/docs/zh-TW/errors.md#hook-changed-input-after-review)涵蓋應對方法。

387 

386要跳過詢問伺服器並始終使用 Claude Code 自己的分類器請求，請設定 [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/zh-TW/env-vars)。在直接連接到 Anthropic API 時，該變數需要 Claude Code v2.1.281 或更新版本。在該情況下將其設定為 `1`，會在尚未啟用伺服器審查的工作階段中開啟伺服器審查，除非您也設定了 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`。如果您設定 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` 並保持 `CLAUDE_CODE_AUTO_MODE_SERVER` 未設定，Claude Code 也會停止詢問伺服器，但[停用預發行功能](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#disable-pre-release-capabilities)所述的情況除外。388要跳過詢問伺服器並始終使用 Claude Code 自己的分類器請求，請設定 [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/zh-TW/env-vars)。在直接連接到 Anthropic API 時，該變數需要 Claude Code v2.1.281 或更新版本。在該情況下將其設定為 `1`，會在尚未啟用伺服器審查的工作階段中開啟伺服器審查，除非您也設定了 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`。如果您設定 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` 並保持 `CLAUDE_CODE_AUTO_MODE_SERVER` 未設定，Claude Code 也會停止詢問伺服器，但[停用預發行功能](https://code.claude.com/docs/zh-TW/llm-gateway-protocol.md#disable-pre-release-capabilities)所述的情況除外。

387 389 

388### 預設分類器模型390### 預設分類器模型

557* **被阻止的操作**：Claude Code 會顯示通知，並在 `/permissions` 的 **Recently blocked** 分頁中列出該操作，您可以在此[核准該操作，讓 Claude 可以重試](https://code.claude.com/docs/zh-TW/auto-mode-config.md#review-denials)。559* **被阻止的操作**：Claude Code 會顯示通知，並在 `/permissions` 的 **Recently blocked** 分頁中列出該操作，您可以在此[核准該操作，讓 Claude 可以重試](https://code.claude.com/docs/zh-TW/auto-mode-config.md#review-denials)。

558* **重複阻止**：如果分類器連續 3 次或總共 20 次阻止操作，自動模式會暫停，Claude Code 會恢復提示。核准被提示的操作即可恢復自動模式。請參閱[重複阻止閾值](#repeated-block-thresholds)以了解阻止如何計數。560* **重複阻止**：如果分類器連續 3 次或總共 20 次阻止操作，自動模式會暫停，Claude Code 會恢復提示。核准被提示的操作即可恢復自動模式。請參閱[重複阻止閾值](#repeated-block-thresholds)以了解阻止如何計數。

559* **分類器沒有判決**：當自動模式以外的安全檢查拒絕分類器自身的請求，或分類器的回應無法解析時，Claude Code 會阻止該操作，且不顯示通知，也不建立 **Recently blocked** 項目。請參閱[自動模式無法確定操作的安全性](https://code.claude.com/docs/zh-TW/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)以了解每種情況顯示的訊息和應對方法。561* **分類器沒有判決**：當自動模式以外的安全檢查拒絕分類器自身的請求，或分類器的回應無法解析時，Claude Code 會阻止該操作，且不顯示通知，也不建立 **Recently blocked** 項目。請參閱[自動模式無法確定操作的安全性](https://code.claude.com/docs/zh-TW/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)以了解每種情況顯示的訊息和應對方法。

560* **伺服器沒有判決**：在[伺服器端分類器審查](#server-side-classifier-review)下，Claude Code 會拒絕伺服器未給出判決的操作，並在連續十個沒有判決的回應後停止該回合。請參閱[伺服器未返回安全判決](https://code.claude.com/docs/zh-TW/errors.md#the-server-returned-no-safety-verdict)。562* **伺服器未提供判定結果**：在[伺服器端分類器審查](#server-side-classifier-review)下，若伺服器未對某個動作提供判定結果，Claude Code 會拒絕該動作，且在連續十個回應都沒有判定結果後，可能會停止該回合。請參閱[伺服器未傳回安全判定結果](https://code.claude.com/docs/zh-TW/errors.md#the-server-returned-no-safety-verdict)。

561* **檢查期間切換模式**：如果您在分類器檢查尚未完成時切換權限模式，Claude Code 會捨棄新模式不會請求的判決。您會改為被提示核准，或者該操作在 [`dontAsk` 模式](#allow-only-pre-approved-tools-with-dontask-mode)中被自動拒絕。563* **檢查期間切換模式**：如果您在分類器檢查尚未完成時切換權限模式，Claude Code 會捨棄新模式不會請求的判決。您會改為被提示核准，或者該操作在 [`dontAsk` 模式](#allow-only-pre-approved-tools-with-dontask-mode)中被自動拒絕。

562 564 

563#### 重複阻止閾值565#### 重複阻止閾值

199 199 

200訊息告訴 Claude 再次發出記錄的呼叫。如果也被拒絕，hook 每次都會變更輸入，因此關閉 mod 或 hook，或離開自動模式並自己批准呼叫。200訊息告訴 Claude 再次發出記錄的呼叫。如果也被拒絕，hook 每次都會變更輸入，因此關閉 mod 或 hook，或離開自動模式並自己批准呼叫。

201 201 

202> [!NOTE]

203>

204> 在[部分互動式終端機工作階段與 VS Code 工作階段](https://code.claude.com/docs/zh-TW/hooks.md#pretooluse-updatedinput-in-auto-mode)中，相同的拒絕會給出原因 `a hook changed this call's input after auto mode reviewed it`。在那裡重複的呼叫會帶有 mod 的第一次變更，且 `tool.call` hook 仍會在其上執行，但進一步的變更會被捨棄。除非 Claude 在其回覆中告訴您[自動模式無法檢查該呼叫](https://code.claude.com/docs/zh-TW/errors.md#hook-changed-input-after-review)，否則無需變更您的 mod。

205 

202### 關於您設定中的拒絕規則的訊息206### 關於您設定中的拒絕規則的訊息

203 207 

204`tried to lift a deny rule in your settings` 和 `the deny rules in your settings could not be checked for this call, so it is refused` 都來自內建防護。208`tried to lift a deny rule in your settings` 和 `the deny rules in your settings could not be checked for this call, so it is refused` 都來自內建防護。

31>31>

32> 另外兩項功能會在您的機器上而非雲端排程工作：[Desktop 排程任務](https://code.claude.com/docs/zh-TW/desktop-scheduled-tasks.md)和 [`/loop`](https://code.claude.com/docs/zh-TW/scheduled-tasks)。若要在這三者之間做選擇，請參閱[比較排程選項](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#compare-scheduling-options)。32> 另外兩項功能會在您的機器上而非雲端排程工作：[Desktop 排程任務](https://code.claude.com/docs/zh-TW/desktop-scheduled-tasks.md)和 [`/loop`](https://code.claude.com/docs/zh-TW/scheduled-tasks)。若要在這三者之間做選擇，請參閱[比較排程選項](https://code.claude.com/docs/zh-TW/scheduled-tasks.md#compare-scheduling-options)。

33 33 

34Team 和 Enterprise 的擁有者可以在 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) 透過 **Scheduled tasks (Was Routines)** 切換開關，為所有成員關閉排程任務。關閉此開關後，現有的排程任務會停止執行，成員也無法建立新的排程任務。34Team 和 Enterprise 的擁有者可以在 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) 透過 **Scheduled tasks (Was Routines)** 或 **Routines** 切換開關，為所有成員關閉排程任務。關閉此開關後，現有的排程任務會停止執行，成員也無法建立新的排程任務。

35 35 

36如果您的 Enterprise 組織透過[自訂角色](https://support.claude.com/en/articles/13930452)管理您的存取權，您還需要具備包含排程任務權限的角色。擁有者可以在 [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) 中，於角色的 **Remote sessions** 區段新增此權限。36如果您的 Enterprise 組織透過[自訂角色](https://support.claude.com/en/articles/13930452)管理您的存取權，您還需要具備包含排程任務權限的角色。擁有者可以在 [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) 中，於角色的 **Remote sessions** 區段新增此權限。

37 37 

485* **網址**：`claude.ai/code/routines`485* **網址**：`claude.ai/code/routines`

486* **CLI**：`/schedule` 的別名 `/routines`、該命令的說明，以及 Claude 在設定任務時的回覆486* **CLI**：`/schedule` 的別名 `/routines`、該命令的說明，以及 Claude 在設定任務時的回覆

487* **API**：`/fire` 端點路徑、其 beta 標頭、其回應 `type`、`<routine-fire-payload>` 標籤，以及 [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire) 參考頁面487* **API**：`/fire` 端點路徑、其 beta 標頭、其回應 `type`、`<routine-fire-payload>` 標籤，以及 [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire) 參考頁面

488* **組織設定**：**Scheduled tasks (Was Routines)** 切換開關488* **組織設定**：**Scheduled tasks (Was Routines)** 或 **Routines** 切換開關

489 489 

490## 疑難排解490## 疑難排解

491 491 

504 504 

505如果原因在於您的 CLI 登入方式或您位於雲端工作階段中，您仍可在 [claude.ai/code/routines](https://claude.ai/code/routines) 建立和管理排程任務。您在該處需要 Pro、Max、Ultra、Team 或 Enterprise 帳戶。如果您的組織關閉了排程任務或雲端工作階段，或您的角色中缺少這些權限，您也無法在網頁上建立排程任務。505如果原因在於您的 CLI 登入方式或您位於雲端工作階段中，您仍可在 [claude.ai/code/routines](https://claude.ai/code/routines) 建立和管理排程任務。您在該處需要 Pro、Max、Ultra、Team 或 Enterprise 帳戶。如果您的組織關閉了排程任務或雲端工作階段，或您的角色中缺少這些權限，您也無法在網頁上建立排程任務。

506 506 

507### "Routines are disabled by your organization's policy"507### 您的組織已關閉排程任務

508 508 

509您 Team 或 Enterprise 組織中的擁有者可能已在 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) 關閉了 **Scheduled tasks (Was Routines)** 切換開關。在 Claude Code v2.1.227 或更新版本中，同一個切換開關也會在 CLI 中隱藏 `/schedule`。這是伺服器端的組織設定，因此無法從您的本機設定覆寫。請聯絡擁有者，為您的組織重新開啟排程任務。509您的組織已關閉雲端排程任務，且您無法從本機設定變更此狀態。請詢問您的 Team 或 Enterprise 擁有者，是否能在 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) 開啟 **Scheduled tasks (Was Routines)** 或 **Routines** 切換開關。

510 510 

511### "The last run" 警告511### "The last run" 警告

512 512 

1074* **檔案系統權限提升**：過於寬泛的檔案系統寫入權限可能導致特權提升攻擊。允許寫入包含 `$PATH` 中可執行檔案的目錄、系統設定目錄或使用者 shell 設定檔（例如 `.bashrc` 或 `.zshrc`）可能導致當其他使用者或系統程序存取這些檔案時在不同安全上下文中執行程式碼。1074* **檔案系統權限提升**：過於寬泛的檔案系統寫入權限可能導致特權提升攻擊。允許寫入包含 `$PATH` 中可執行檔案的目錄、系統設定目錄或使用者 shell 設定檔（例如 `.bashrc` 或 `.zshrc`）可能導致當其他使用者或系統程序存取這些檔案時在不同安全上下文中執行程式碼。

1075* **Linux 沙箱強度**：Linux 實現提供強大的檔案系統和網路隔離，但包含一個 `enableWeakerNestedSandbox` 模式，使其能夠在 Docker 環境中工作而無需特權命名空間。此選項大大削弱了安全性，應僅在其他隔離被強制執行時使用。1075* **Linux 沙箱強度**：Linux 實現提供強大的檔案系統和網路隔離，但包含一個 `enableWeakerNestedSandbox` 模式，使其能夠在 Docker 環境中工作而無需特權命名空間。此選項大大削弱了安全性，應僅在其他隔離被強制執行時使用。

1076* **macOS 上的 Apple Events**：macOS 沙箱預設阻止 Apple Events。`allowAppleEvents` 設定解除此限制，使 `open` 和 `osascript` 等工具能夠運作，但它移除了程式碼執行隔離：沙箱化命令可以啟動其他應用程式而不進行沙箱化，無需使用者提示，並可以向執行中的應用程式傳送 AppleScript 命令，受限於每個應用程式的 macOS 自動化同意提示 (TCC)。它僅從使用者、受管或 CLI 設定中被接受。專案設定無法啟用它。1076* **macOS 上的 Apple Events**：macOS 沙箱預設阻止 Apple Events。`allowAppleEvents` 設定解除此限制，使 `open` 和 `osascript` 等工具能夠運作，但它移除了程式碼執行隔離：沙箱化命令可以啟動其他應用程式而不進行沙箱化，無需使用者提示，並可以向執行中的應用程式傳送 AppleScript 命令，受限於每個應用程式的 macOS 自動化同意提示 (TCC)。它僅從使用者、受管或 CLI 設定中被接受。專案設定無法啟用它。

1077* **macOS 上的 Mach 和 XPC 服務**：沙箱化命令可以連到沙箱外您在 [`network.allowMachLookup`](https://code.claude.com/docs/zh-TW/settings-reference#sandbox-network-allowmachlookup) 中列出的每個服務，而沙箱不會限制這些服務為這些命令所做的事情。

1077* **Linux 和 WSL2 上的使用者命名空間**：預設情況下，沙箱化命令無法建立使用者命名空間。如果您將 [`allowNestedUserNamespaces`](https://code.claude.com/docs/zh-TW/settings-reference#sandbox-allownestedusernamespaces) 設為 `true`，就會關閉一道安全邊界：來自沙箱化命令的程式碼可能最終在沙箱外執行。在開啟此設定之前，請閱讀[在 Linux 上 Chromium 或 rootless Podman 於沙箱內失敗](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux)中的警告。1078* **Linux 和 WSL2 上的使用者命名空間**：預設情況下，沙箱化命令無法建立使用者命名空間。如果您將 [`allowNestedUserNamespaces`](https://code.claude.com/docs/zh-TW/settings-reference#sandbox-allownestedusernamespaces) 設為 `true`，就會關閉一道安全邊界：來自沙箱化命令的程式碼可能最終在沙箱外執行。在開啟此設定之前，請閱讀[在 Linux 上 Chromium 或 rootless Podman 於沙箱內失敗](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux)中的警告。

1078 1079 

1079### 範圍1080### 範圍

16 16 

17## 包裝指令碼17## 包裝指令碼

18 18 

19當每個工作階段需要執行器無法自行完成的設定時，請使用包裝指令碼：佈建限定於工作階段建立者的短期憑證、匯出環境特定的祕密、準備語言工具鏈，或在子程序周圍套用資源限制。執行器每個工作階段啟動一次您的包裝指令碼，以取代 Claude Code 二進位檔案。透過 `exec` 進入 `$CLAUDE_RUNNER_CLAUDE_BIN`（執行器自己的二進位檔案）來結束包裝指令碼，以便訊號和退出碼正確傳播。19當每個工作階段需要執行器無法自行完成的設定時，請使用包裝指令碼：

20 

21* 佈建限定於工作階段建立者的短期憑證

22* 匯出環境特定的祕密

23* 準備語言工具鏈

24* 在子程序周圍套用資源限制

25 

26執行器每次啟動工作階段時（包括工作階段恢復或重新排入佇列時），都會啟動您的包裝指令碼，以取代 Claude Code 二進位檔案。透過 `exec` 進入 `$CLAUDE_RUNNER_CLAUDE_BIN`（執行器自己的二進位檔案）來結束包裝指令碼，以便訊號和退出碼正確傳播。

20 27 

21在啟動執行器時，將 `--exec-path` 或 `SELF_HOSTED_RUNNER_EXEC_PATH` 指向包裝指令碼，並依[快速入門](https://code.claude.com/docs/zh-TW/self-hosted-environments-quickstart.md#set-up-manually)所述替換 `<writable-dir>`：28在啟動執行器時，將 `--exec-path` 或 `SELF_HOSTED_RUNNER_EXEC_PATH` 指向包裝指令碼，並依[快速入門](https://code.claude.com/docs/zh-TW/self-hosted-environments-quickstart.md#set-up-manually)所述替換 `<writable-dir>`：

22 29 

139 146 

140### checkout147### checkout

141 148 

142每個儲存庫執行一次，取代執行器內建的複製與擷取。使用此 hook 從您透過 HTTPS 或 SSH 存取的直讀式鏡像複製、從封存檔植入工作樹，或套用每個工作階段的 git 身分驗證。執行器會設定下列變數，也可能設定表格未列出的其他 `CLAUDE_RUNNER_` 變數：149每當執行器啟動工作階段時（包括工作階段恢復或重新排入佇列時），都會為每個儲存庫執行，取代執行器內建的複製與擷取。使用此 hook 從您透過 HTTPS 或 SSH 存取的直讀式鏡像複製、從封存檔植入工作樹，或套用每個工作階段的 git 身分驗證。

150 

151執行器會設定下列變數，也可能設定表格未列出的其他 `CLAUDE_RUNNER_` 變數：

143 152 

144| 變數 | 說明 |153| 變數 | 說明 |

145| :- | :- |154| :- | :- |

179 188 

180### post-session189### post-session

181 190 

182在 Claude Code 子程序退出後、執行器拆卸工作區之前，每個會話執行一次。此掛鉤是您保存未提交工作的唯一機會：在 `--capacity` 高於 1 時，執行器在掛鉤返回後立即刪除每個會話的工作樹，在 `--capacity 1` 時重複使用的[規範複製](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)在下一個會話開始時硬重設，因此未提交的追蹤變更在任何一條路徑上都不會存活。典型用途是推送未提交變更的快照分支、存檔日誌或向您自己的系統發出會話結束事件。191在 Claude Code 子程序結束後、執行器拆除工作區之前執行。此 hook 是您保存未提交工作的唯一機會，因為未提交的已追蹤變更在以下任一路徑上都不會保留：

192 

193* **在 `--capacity` 高於 1 時**：執行器會在 hook 返回後立即刪除每個工作階段的 worktree

194* **在 `--capacity 1` 時**：重複使用的[規範複製](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)會在下一個工作階段開始時被硬重設

195 

196典型用途是推送未提交變更的快照分支、封存日誌，或向您自己的系統發出工作階段結束事件。

183 197 

184掛鉤在每個會話結束時觸發，其中生成了子程序，無論原因如何；下面的 `CLAUDE_RUNNER_EXIT_REASON` 值列舉了這些情況。當執行器突然終止時（例如 VM 搶佔或電源故障）無法觸發；如果您需要針對突然終止的保證，請改為使用 Claude Code `PostToolUse` 掛鉤從會話內定期快照。執行器設定：198掛鉤在每個會話結束時觸發，其中生成了子程序，無論原因如何；下面的 `CLAUDE_RUNNER_EXIT_REASON` 值列舉了這些情況。當執行器突然終止時（例如 VM 搶佔或電源故障）無法觸發；如果您需要針對突然終止的保證，請改為使用 Claude Code `PostToolUse` 掛鉤從會話內定期快照。執行器設定：

185 199 

275 289 

276### command290### command

277 291 

278在簽出後每個會話執行一次，代替內建的子程序生成。掛鉤接收與[包裝指令碼](#wrapper-scripts)相同的環境，應該以相同的方式 `exec` 進入 `"$CLAUDE_RUNNER_CLAUDE_BIN"`。使用 `command` 掛鉤將所有自訂保留在一個掛鉤目錄中；當包裝指令碼在其他地方時使用 `--exec-path`。如果也設定了 `--exec-path`，旗標優先，`command` 掛鉤被忽略。292每當工作階段啟動或恢復時，於簽出之後執行，取代內建的子程序產生。此 hook 接收與[包裝指令碼](#wrapper-scripts)相同的環境，並應以相同方式 `exec` 進入 `"$CLAUDE_RUNNER_CLAUDE_BIN"`。使用 `command` hook 可將所有自訂內容集中在一個 hook 目錄中；當包裝指令碼位於其他位置時，請使用 `--exec-path`。如果同時設定了 `--exec-path`，則該旗標優先，`command` hook 會被忽略。

279 293 

280始終 `exec` 執行器自己的二進位檔案，而不是 PATH 解析的 `claude`；否則您會破壞[版本固定](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#pin-the-version)。294始終 `exec` 執行器自己的二進位檔案，而不是 PATH 解析的 `claude`；否則您會破壞[版本固定](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#pin-the-version)。

281 295 

523 537 

524* **中繼資料端點**：如果您完全拒絕工作階段存取[雲端中繼資料端點](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#harden-your-deployment)，由其提供的憑證（例如執行個體設定檔）也不會傳達至 Claude Code。以檔案為基礎的 Web 身分，例如 Amazon EKS 上的 IAM Roles for Service Accounts (IRSA) 或 Workload Identity Federation 憑證檔案，則不依賴該端點。538* **中繼資料端點**：如果您完全拒絕工作階段存取[雲端中繼資料端點](https://code.claude.com/docs/zh-TW/self-hosted-environments-deploy.md#harden-your-deployment)，由其提供的憑證（例如執行個體設定檔）也不會傳達至 Claude Code。以檔案為基礎的 Web 身分，例如 Amazon EKS 上的 IAM Roles for Service Accounts (IRSA) 或 Workload Identity Federation 憑證檔案，則不依賴該端點。

525* **續期**：工作階段的存續時間可能比憑證更長，因此請使用會自行續期的方法，例如以檔案為基礎的 Web 身分539* **續期**：工作階段的存續時間可能比憑證更長，因此請使用會自行續期的方法，例如以檔案為基礎的 Web 身分

526* **包裝腳本**：Runner 會在每個工作階段啟動一次您的[包裝腳本](#provision-credentials-scoped-to-the-session-creator)，因此它匯出的憑證不會續期。Claude Code 會從其環境讀取 AWS 憑證，因此如果您的包裝腳本已為其他工作匯出 AWS 憑證，Claude Code 可能會使用這些憑證來簽署模型請求。540* **包裝腳本**：您的[包裝腳本](#provision-credentials-scoped-to-the-session-creator)匯出的憑證值在 Claude Code 執行期間不會續期，因此對於長時間的工作階段，請使用會自行續期的方法。Claude Code 會從其環境讀取 AWS 憑證，因此如果您的包裝腳本已為其他工作匯出 AWS 憑證，Claude Code 可以使用這些憑證來簽署模型請求。

527 541 

528**3. 在 runner 的環境中設定單一供應商的變數**542**3. 在 runner 的環境中設定單一供應商的變數**

529 543 

827 827 

828### 某些工作階段不計為閒置828### 某些工作階段不計為閒置

829 829 

830持有永遠不完成的背景任務的工作階段不計為閒置，因此 `--release-idle-session-min` 不會釋放該工作階段的插槽。等待從執行中工具呼叫內部請求的批准的工作階段也不計為閒置。始終將 `--kill-session-after-min` 與其一起設定作為硬後擋，以便沒有工作階段可以無限期地持有插槽。830持有持續執行中的背景任務的工作階段不計為閒置，因此 `--release-idle-session-min` 不會釋放該工作階段的插槽。等待從執行中工具呼叫內部請求的核准的工作階段也不計為閒置。請將 `--kill-session-after-min` 與其一起設定作為硬性後擋。

831 831 

832`--kill-session-after-min` 是失控工作階段的後擋。在 v2.1.260 或更新版本上的執行器上，達到限制的工作階段不會立即終止。執行器給它一個寬限窗口，預設 15 分鐘，您可以使用 [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/zh-TW/self-hosted-environments-reference#environment-variable-only-settings) 更改：832`--kill-session-after-min` 是失控工作階段的後擋。在 v2.1.260 或更新版本上的執行器上，達到限制的工作階段不會立即終止。執行器給它一個寬限窗口，預設 15 分鐘，您可以使用 [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/zh-TW/self-hosted-environments-reference#environment-variable-only-settings) 更改：

833 833 

153}153}

154```154```

155 155 

156在自訂探測中使用 `last_poll_age_ms` 作為活躍信號；無限增長的值表示輪詢迴圈卡住。`last_poll_at` 和 `last_poll_age_ms` 都是 `null`，直到第一次輪詢完成。156請針對 `last_poll_age_ms` 設定警報，但不要在存活探測中使用它；存活探測應維持以 HTTP 狀態碼為依據。此值是自上次成功輪詢以來經過的時間，因此當執行器無法連線至 Anthropic 時，它也會持續上升。`last_poll_at` 和 `last_poll_age_ms` 在第一次輪詢成功之前都是 `null`。若要偵測從一開始就失敗的輪詢，也請針對 `claude_code_self_hosted_runner_poll_errors_total` 設定警報，該指標列於 [Prometheus 指標](#prometheus-metrics)中。

157 157 

158協調器自己的 `/healthz` 位於其健康連接埠上，始終返回 `200`。主體攜帶報告最近一次輪詢是否成功的 `connected` 欄位，以及 `queue_counts` 中依狀態分類的產生佇列計數。若要了解 `connected` 為何是 `false`，請讀取頂層的 `last_error` 欄位，每次輪詢成功時都會將其重設為 `null`。請根據 `connected` 而非狀態碼來判斷就緒狀態與觸發警報。158協調器自己的 `/healthz` 位於其健康連接埠上，始終返回 `200`。主體攜帶報告最近一次輪詢是否成功的 `connected` 欄位，以及 `queue_counts` 中依狀態分類的產生佇列計數。若要了解 `connected` 為何是 `false`，請讀取頂層的 `last_error` 欄位，每次輪詢成功時都會將其重設為 `null`。請根據 `connected` 而非狀態碼來判斷就緒狀態與觸發警報。

159 159 

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/zh-TW/settings-reference#automode-classifyallshell) | 來自 `~/.claude/settings.json` 或 `--settings` 的 `true` | 即使受管來源設定為 `false` 也會採用 |313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/zh-TW/settings-reference#automode-classifyallshell) | 來自 `~/.claude/settings.json` 或 `--settings` 的 `true` | 即使受管來源設定為 `false` 也會採用 |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/zh-TW/settings-reference#remotecontrolatstartup) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使受管來源設定為 `true` 也會採用；專案或本機的 `true` 會被忽略 |314| [`remoteControlAtStartup`](https://code.claude.com/docs/zh-TW/settings-reference#remotecontrolatstartup) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使受管來源設定為 `true` 也會採用；專案或本機的 `true` 會被忽略 |

315| [`crossSessionInbound`](https://code.claude.com/docs/zh-TW/settings-reference#crosssessioninbound) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的較嚴格值，依 `accept` \< `hold` \< `refuse` 的等級排序 | 優先於受管、`--settings` 和使用者的值；不較嚴格的專案或本機值會被忽略 |315| [`crossSessionInbound`](https://code.claude.com/docs/zh-TW/settings-reference#crosssessioninbound) | 來自 `.claude/settings.json` 或 `.claude/settings.local.json` 的較嚴格值，依 `accept` \< `hold` \< `refuse` 的等級排序 | 優先於受管、`--settings` 和使用者的值；不較嚴格的專案或本機值會被忽略 |

316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/zh-TW/settings-reference#useautomodeduringplan) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使勝出的受管來源設定為 `true` 也會採用；`.claude/settings.json` 中的 `false` 會被忽略 |316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/zh-TW/settings-reference#useautomodeduringplan) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使勝出的受管來源設定為 `true` 也會採用；`.claude/settings.json` 中的 `false` 會被忽略。關於啟動時省略的檔案，請參閱[該鍵的條目](https://code.claude.com/docs/zh-TW/settings-reference.md#useautomodeduringplan) |

317| [`syncClaudeAiSkills`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiskills) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使勝出的受管來源設定為 `true` 也會採用；`.claude/settings.json` 中的 `false` 會被忽略 |317| [`syncClaudeAiSkills`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiskills) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使勝出的受管來源設定為 `true` 也會採用；`.claude/settings.json` 中的 `false` 會被忽略 |

318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiplugins) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使勝出的受管來源設定為 `true` 也會採用；`.claude/settings.json` 中的 `false` 會被忽略 |318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/zh-TW/settings-reference#syncclaudeaiplugins) | 來自任何受管來源、`--settings`、`~/.claude/settings.json` 或 `.claude/settings.local.json` 的 `false` | 即使勝出的受管來源設定為 `true` 也會採用；`.claude/settings.json` 中的 `false` 會被忽略 |

319| [`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel) | 來自任何範圍（包括 `--settings`）的較低上限 | 即使 Claude Code 套用的受管設定設定了較高的上限也會採用；以最低的上限為準。需要 Claude Code v2.1.267 或更新版本 |319| [`maxEffortLevel`](https://code.claude.com/docs/zh-TW/settings-reference#maxeffortlevel) | 來自任何範圍（包括 `--settings`）的較低上限 | 即使 Claude Code 套用的受管設定設定了較高的上限也會採用；以最低的上限為準。需要 Claude Code v2.1.267 或更新版本 |

925選擇 Claude Code 是否在 plan mode 中使用自動模式分類器來檢查 shell 命令。使用預設值 `true`，分類器在規劃期間檢查每個命令（當自動模式可用且您看不到提示時），除了[關鍵路徑移除](https://code.claude.com/docs/zh-TW/permission-modes.md#critical-paths)。設定 `false` 以針對內建唯讀集之外的每個命令獲得權限提示。在 `/config` 中顯示為**在計畫期間使用自動模式**。925選擇 Claude Code 是否在 plan mode 中使用自動模式分類器來檢查 shell 命令。使用預設值 `true`，分類器在規劃期間檢查每個命令（當自動模式可用且您看不到提示時），除了[關鍵路徑移除](https://code.claude.com/docs/zh-TW/permission-modes.md#critical-paths)。設定 `false` 以針對內建唯讀集之外的每個命令獲得權限提示。在 `/config` 中顯示為**在計畫期間使用自動模式**。

926 926 

927* **範圍**：[`User, local, or managed`](#scopes)。儲存庫無法為您關閉它。927* **範圍**：[`User, local, or managed`](#scopes)。儲存庫無法為您關閉它。

928 * 這些檔案中任一個或 `--settings` 中的 `false` 都會將其關閉，除非您使用 [`--setting-sources`](https://code.claude.com/docs/zh-TW/cli-reference#cli-flags) 等選項排除該使用者或本機檔案。忽略被排除的檔案需要 Claude Code v2.1.314 或更新版本

928* **類型**：布林值929* **類型**：布林值

929 * `true`：與未設定相同；當自動模式可用時，分類器在規劃期間檢查每個 shell 命令，而不是提示您，除了[關鍵路徑移除](https://code.claude.com/docs/zh-TW/permission-modes.md#critical-paths)。任何這些檔案中的 `false` 仍然會關閉它930 * `true`：與未設定相同；當自動模式可用時，分類器會在規劃期間檢查 shell 命令

930 * `false`：您會針對內建唯讀集之外的每個命令獲得權限提示931 * `false`：您會針對內建唯讀集之外的每個命令獲得權限提示

931* **預設值**：`true`932* **預設值**：`true`

932 933 

2073 2074 

2074### `sandbox.network.allowMachLookup`2075### `sandbox.network.allowMachLookup`

2075 2076 

2076列出 macOS 沙箱可以查找的其他 XPC 和 Mach 服務名稱。透過 XPC 通訊的工具（例如 iOS Simulator 或 Playwright）需要在此列出其服務。2077列出 macOS 沙箱可查找的其他 XPC 與 Mach 服務名稱。透過 XPC 通訊的工具（例如 iOS Simulator 或 Playwright）需要將其服務列在此處。沙箱化命令可以存取沙箱外您所列出的每個服務，而沙箱[不會限制這些服務為這些命令執行的操作](https://code.claude.com/docs/zh-TW/sandboxing.md#security-limitations)。

2077 2078 

2078* **範圍**：[`Any file`](#scopes)，但[對專案和本機設定有所限制](https://code.claude.com/docs/zh-TW/sandboxing.md#repository-settings-under-an-admin-required-sandbox)2079* **範圍**：[`Any file`](#scopes)，但[對專案和本機設定有所限制](https://code.claude.com/docs/zh-TW/sandboxing.md#repository-settings-under-an-admin-required-sandbox)

2079* **類型**：字串陣列，每個都是服務名稱；單一結尾的 `*` 會比對前綴，單獨的 `"*"` 則會比對所有服務2080* **類型**：字串陣列，每個都是服務名稱；單一結尾的 `*` 會比對前綴，單獨的 `"*"` 則會比對所有服務

2422 2423 

2423 在專案和本機設定中忽略此群組需要 Claude Code v2.1.282 或更高版本。2424 在專案和本機設定中忽略此群組需要 Claude Code v2.1.282 或更高版本。

2424 * 改變 Claude Code 如何啟動或同步的變數，例如 `CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR` 和 `CLAUDE_CODE_PLUGIN_SEED_DIR`。2425 * 改變 Claude Code 如何啟動或同步的變數，例如 `CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR` 和 `CLAUDE_CODE_PLUGIN_SEED_DIR`。

2426 * 設定您 claude.ai 登入的變數，例如 [`CLAUDE_CODE_OAUTH_TOKEN`、`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 和 `CLAUDE_CODE_OAUTH_SCOPES`](https://code.claude.com/docs/zh-TW/env-vars#variables)。

2425 * [螢幕閱讀器模式](https://code.claude.com/docs/zh-TW/accessibility.md)變數 `CLAUDE_AX_SCREEN_READER`，以及其他名稱以 `CLAUDE_AX_` 開頭的變數，例如 [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/zh-TW/env-vars#variables)。2427 * [螢幕閱讀器模式](https://code.claude.com/docs/zh-TW/accessibility.md)變數 `CLAUDE_AX_SCREEN_READER`，以及其他名稱以 `CLAUDE_AX_` 開頭的變數，例如 [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/zh-TW/env-vars#variables)。

2426 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/zh-TW/env-vars#variables)，它會設定未回應對話框的計時器。2428 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/zh-TW/env-vars#variables)，它會設定未回應對話框的計時器。

2427 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/zh-TW/env-vars#variables)，它會關閉附件處理。2429 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/zh-TW/env-vars#variables)，它會關閉附件處理。

40>40>

41> **macOS、Linux、WSL：**41> **macOS、Linux、WSL：**

42>42>

43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}43> ```bash theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell：**49> **Windows PowerShell：**

50>50>

51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}51> ```powershell theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD：**55> **Windows CMD：**

56>56>

57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57> ```batch theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}75> ```bash theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}87> ```powershell theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

416 416 

417當您要求 Claude 以特定 effort 等級執行非分叉 subagent 時，它也可以為該次叫用傳遞 `effort` 參數。此參數會覆寫 `effort` 欄位，並在 subagent [被恢復](#resume-subagents)時持續生效。[`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/zh-TW/env-vars#variables) 環境變數優先於兩者。每次叫用的參數需要 Claude Code v2.1.292 或更新版本。417當您要求 Claude 以特定 effort 等級執行非分叉 subagent 時，它也可以為該次叫用傳遞 `effort` 參數。此參數會覆寫 `effort` 欄位，並在 subagent [被恢復](#resume-subagents)時持續生效。[`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/zh-TW/env-vars#variables) 環境變數優先於兩者。每次叫用的參數需要 Claude Code v2.1.292 或更新版本。

418 418 

419#### 當 subagent 沒有 `effort` 欄位或參數時

420 

421在主對話的模型上，subagent 會以您在工作階段中選擇的等級執行，例如透過 `/effort` 選擇，或以 `--effort` 設定。在其他模型上，[該等級不適用](https://code.claude.com/docs/zh-TW/model-config.md#effort-level-of-subagents-and-teammates)。若要選擇其等級，請設定 `effort` 欄位。

422 

419### 控制子代理功能423### 控制子代理功能

420 424 

421您可以透過工具存取、權限模式和條件規則控制子代理可以做什麼。425您可以透過工具存取、權限模式和條件規則控制子代理可以做什麼。

69 69 

70透過此連接，工作階段可以複製任何公開儲存庫，但只有在 Claude GitHub App 安裝在私人儲存庫上時，才能在私人儲存庫中工作。[在您想要使用其私人儲存庫的每個 GitHub 帳戶或組織上安裝 Claude GitHub App](https://github.com/apps/claude/installations/new)。在 GitHub 組織上，組織擁有者可能需要核准安裝。安裝應用程式也會啟用[自動修復](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#auto-fix-pull-requests)，讓 Claude 能夠回應這些儲存庫中的 CI 失敗和提取要求審查意見。70透過此連接，工作階段可以複製任何公開儲存庫，但只有在 Claude GitHub App 安裝在私人儲存庫上時，才能在私人儲存庫中工作。[在您想要使用其私人儲存庫的每個 GitHub 帳戶或組織上安裝 Claude GitHub App](https://github.com/apps/claude/installations/new)。在 GitHub 組織上，組織擁有者可能需要核准安裝。安裝應用程式也會啟用[自動修復](https://code.claude.com/docs/zh-TW/claude-code-on-the-web.md#auto-fix-pull-requests)，讓 Claude 能夠回應這些儲存庫中的 CI 失敗和提取要求審查意見。

71 71 

72當您連接時，如果您擁有的 GitHub 帳戶已安裝 Claude GitHub App，Claude 也會將這些帳戶連結到您的 Claude 組織。在 Team 和 Enterprise 方案上，管理員可以在[已連接的 GitHub 帳戶清單](https://code.claude.com/docs/zh-TW/admin-setup.md#connected-github-accounts)中看到這些帳戶。72當您連接時，如果您擁有的 GitHub 帳戶已安裝 Claude GitHub App，Claude 也會將這些帳戶連結到您的 Claude 組織。在 Team 和 Enterprise 方案上，您的 Claude 組織的擁有者可以在[已連接的 GitHub 帳戶清單](https://code.claude.com/docs/zh-TW/admin-setup.md#connected-github-accounts)中看到這些帳戶。

73 73 

74如果上線流程在此時提示您安裝 Claude GitHub App，而您想稍後再安裝，請按一下**略過**。74如果上線流程在此時提示您安裝 Claude GitHub App，而您想稍後再安裝，請按一下**略過**。

75 75