Documentation 2026-06-30 23:02 UTC to 2026-07-01 21:01 UTC

85顧問的能力必須至少與主要模型相同。每個主要模型接受的顧問為：85顧問的能力必須至少與主要模型相同。每個主要模型接受的顧問為：

86 86 

87| 主要模型 | 接受的顧問 | 備註 |87| 主要模型 | 接受的顧問 | 備註 |

88| ----------------------------------------------- | ------------------------ | ------------------------------- |88| ----------------------------------------------- | ------------------------ | ------------------------------------------------------------ |

89| Haiku 4.5 | Fable、Opus、Sonnet | Haiku 可以呼叫顧問但不能充當顧問 |89| Haiku 4.5 | Fable、Opus、Sonnet | Haiku 可以呼叫顧問但不能充當顧問 |

90| Sonnet 4.6 | Fable、Opus、Sonnet | |90| Sonnet 4.6 | Fable、Opus、Sonnet | |

91| Sonnet 5 | Fable、Opus、Sonnet 5 | Sonnet 4.6 顧問會被拒絕 |91| Sonnet 5 | Fable、Opus、Sonnet 5 | Sonnet 4.6 顧問會被拒絕 |

92| Opus 4.6 或更新版本 | Fable、Opus（版本在主要模型版本或以上） | Opus 4.7 主要模型搭配 Opus 4.6 顧問會被拒絕 |92| Opus 4.6 或更新版本 | Fable、Opus（版本在主要模型版本或以上） | Opus 4.7 主要模型搭配 Opus 4.6 顧問會被拒絕。Opus 4.6 主要模型也接受 Sonnet 5 顧問 |

93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus 或 Sonnet 顧問會被拒絕 |93| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus 或 Sonnet 顧問會被拒絕 |

94 94 

95Fable 5 需要 Claude Code v2.1.170 或更新版本以及 Fable 5 存取權，無論它是充當主要模型還是顧問。95Fable 5 需要 Claude Code v2.1.170 或更新版本以及 Fable 5 存取權，無論它是充當主要模型還是顧問。

190`effort` 選項控制 Claude 應用多少推理。較低的努力等級每個回合使用更少的代幣並降低成本。並非所有模型都支援努力參數。請參閱 [努力](https://platform.claude.com/docs/en/build-with-claude/effort) 以了解哪些模型支援它。190`effort` 選項控制 Claude 應用多少推理。較低的努力等級每個回合使用更少的代幣並降低成本。並非所有模型都支援努力參數。請參閱 [努力](https://platform.claude.com/docs/en/build-with-claude/effort) 以了解哪些模型支援它。

191 191 

192| 等級 | 行為 | 適合 |192| 等級 | 行為 | 適合 |

193| :--------- | :-------- | :---------------------------------- |193| :--------- | :-------- | :------------------------------------------- |

194| `"low"` | 最少推理、快速回應 | 檔案查找、列出目錄 |194| `"low"` | 最少推理、快速回應 | 檔案查找、列出目錄 |

195| `"medium"` | 平衡推理 | 常規編輯、標準任務 |195| `"medium"` | 平衡推理 | 常規編輯、標準任務 |

196| `"high"` | 徹底分析 | 重構、除錯 |196| `"high"` | 徹底分析 | 重構、除錯 |

197| `"xhigh"` | 擴展推理深度 | 編碼和代理任務；建議在 Fable 5 和 Opus 4.7+ 上使用 |197| `"xhigh"` | 擴展推理深度 | 編碼和代理任務；建議在 Fable 5、Opus 4.7+ 和 Sonnet 5 上使用 |

198| `"max"` | 最大推理深度 | 需要深入分析的多步驟問題 |198| `"max"` | 最大推理深度 | 需要深入分析的多步驟問題 |

199 199 

200如果您不設定 `effort`，兩個 SDK 都會保留參數未設定，並遵循模型的預設行為。200如果您不設定 `effort`，兩個 SDK 都會保留參數未設定，並遵循模型的預設行為。

3138```typescript theme={null}3138```typescript theme={null}

3139type ModelInfo = {3139type ModelInfo = {

3140 value: string;3140 value: string;

3141 resolvedModel?: string;

3141 displayName: string;3142 displayName: string;

3142 description: string;3143 description: string;

3143 supportsEffort?: boolean;3144 supportsEffort?: boolean;

3144 supportedEffortLevels?: ("low" | "medium" | "high" | "xhigh" | "max")[];3145 supportedEffortLevels?: ("low" | "medium" | "high" | "xhigh" | "max")[];

3145 supportsAdaptiveThinking?: boolean;3146 supportsAdaptiveThinking?: boolean;

3146 supportsFastMode?: boolean;3147 supportsFastMode?: boolean;

3148 supportsAutoMode?: boolean;

3147};3149};

3148```3150```

3149 3151 

3152| 字段 | 類型 | 描述 |

3153| :------------------------- | :----------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3154| `value` | `string` | 在 API 呼叫中傳遞的模型標識符 |

3155| `resolvedModel` | `string \| undefined` | 此項目的 `value` 解析為的規範線路模型 ID。別名項目（如 `sonnet`）解析為明確的模型 ID（如 `claude-sonnet-5`），因此主機可以將儲存的明確模型 ID 與涵蓋它的別名項目進行匹配。{/* min-version: 2.1.197 */}需要 Claude Code v2.1.197 或更高版本。 |

3156| `displayName` | `string` | 人類可讀的顯示名稱 |

3157| `description` | `string` | 模型功能的描述 |

3158| `supportsEffort` | `boolean \| undefined` | 此模型是否支持努力級別 |

3159| `supportedEffortLevels` | `("low" \| "medium" \| "high" \| "xhigh" \| "max")[] \| undefined` | 此模型接受的努力級別 |

3160| `supportsAdaptiveThinking` | `boolean \| undefined` | 此模型是否支持自適應思考，其中 Claude 決定何時以及多少推理 |

3161| `supportsFastMode` | `boolean \| undefined` | 此模型是否支持快速模式 |

3162| `supportsAutoMode` | `boolean \| undefined` | 此模型是否支持自動模式 |

3163 

3150<h3 id="agentinfo">3164<h3 id="agentinfo">

3151 `AgentInfo`3165 `AgentInfo`

3152</h3>3166</h3>

284 284 

285隊友開始時具有主管的權限設定。如果主管使用 `--dangerously-skip-permissions` 運行，所有隊友也會這樣做。生成後，您可以更改個別隊友模式，但在生成時無法設定每個隊友的模式。285隊友開始時具有主管的權限設定。如果主管使用 `--dangerously-skip-permissions` 運行，所有隊友也會這樣做。生成後，您可以更改個別隊友模式，但在生成時無法設定每個隊友的模式。

286 286 

287當一個代理透過 `SendMessage` 向另一個代理發送訊息時，接收代理會被告知它來自另一個 Claude 工作階段，而不是來自您。隊友無法批准權限提示或代表您提供同意，被拒絕某項操作的隊友無法將其轉發給另一個隊友以繞過檢查。在 [auto mode](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 中，分類器將從另一個代理轉發的批准聲明視為不受信任的輸入，而不是來自您的確認。隊友權限提示會冒泡到主管工作階段，因此請在那裡自己批准它們。

288 

287<h3 id="context-and-communication">289<h3 id="context-and-communication">

288 Context 和通訊290 Context 和通訊

289</h3>291</h3>

283| :---------------------- | :---------------------------------------------------------------------------------------- |283| :---------------------- | :---------------------------------------------------------------------------------------- |

284| `<agent-name> <prompt>` | 如果第一個單詞與自訂 [subagent](/zh-TW/sub-agents) 名稱匹配，該 subagent 以工作階段的主代理身份執行，其 frontmatter 中的配置 |284| `<agent-name> <prompt>` | 如果第一個單詞與自訂 [subagent](/zh-TW/sub-agents) 名稱匹配，該 subagent 以工作階段的主代理身份執行，其 frontmatter 中的配置 |

285| `@<agent-name>` | 在提示中的任何地方提及自訂 subagent 以將其作為主代理執行 |285| `@<agent-name>` | 在提示中的任何地方提及自訂 subagent 以將其作為主代理執行 |

286| `@<repo>` | 提及您開啟 agent view 的目錄下的儲存庫以在那裡執行工作階段 |286| `@<repo>` | 提及儲存庫以在那裡執行工作階段。請參閱[分派到特定目錄](#dispatch-to-a-specific-directory)以了解列出哪些儲存庫 |

287| `/<command>` | 建議 [skills](/zh-TW/skills) 和 [commands](/zh-TW/commands) 作為提示分派 |287| `/<command>` | 建議 [skills](/zh-TW/skills) 和 [commands](/zh-TW/commands) 作為提示分派 |

288| `! <command>` | 執行 shell 命令作為背景工作而不是啟動 Claude 工作階段。該工作顯示為一行，您可以附加到、監視和分離 |288| `! <command>` | 執行 shell 命令作為背景工作而不是啟動 Claude 工作階段。該工作顯示為一行，您可以附加到、監視和分離 |

289| `#<number>` 或拉取請求 URL | 如果工作階段已在該 PR 上工作，選擇它而不是分派 |289| `#<number>` 或拉取請求 URL | 如果工作階段已在該 PR 上工作，選擇它而不是分派 |

299 分派到特定目錄299 分派到特定目錄

300</h4>300</h4>

301 301 

302新工作階段在您開啟 agent view 的目錄中執行。要針對不同的目錄：302新工作階段在您開啟 agent view 的目錄中執行。要針對不同的目錄，請使用以下任何方法：

303 303 

304* 在該目錄中開啟 `claude agents`。304* 在該目錄中開啟 `claude agents`。

305* 在包含多個儲存庫的父目錄中開啟 `claude agents`，並在提示中使用 `@<repo>` 提及一個以在那裡執行工作階段。305* 在父目錄中開啟 `claude agents`，並在提示中使用 `@<repo>` 提及子儲存庫。輸入 `@` 會列出啟動目錄下一級的 git 儲存庫，加上任何已在列表中有工作階段的目錄。名稱包含空格的目錄不會被列出。

306* 從 shell，`cd` 進入目錄並執行 `claude --bg "<prompt>"`。306* 從 shell，`cd` 進入目錄並執行 `claude --bg "<prompt>"`。

307 307 

308當 agent view 按目錄分組時，突出顯示的行的目錄成為分派目標，因此您可以滾動到組並在其中分派，無需重新輸入路徑。308當 agent view 按目錄分組時，突出顯示的行的目錄成為分派目標，因此您可以滾動到組並在其中分派，無需重新輸入路徑。

195 195 

196選擇器是當開發人員在 Claude Code 中運行 `/model` 時打開的互動式模型清單。每個發現的條目都標記為「來自 gateway」，並在提供時使用 `display_name`。[`availableModels` 受管設定](/zh-TW/settings#available-settings)限制發現可以添加的內容。196選擇器是當開發人員在 Claude Code 中運行 `/model` 時打開的互動式模型清單。每個發現的條目都標記為「來自 gateway」，並在提供時使用 `display_name`。[`availableModels` 受管設定](/zh-TW/settings#available-settings)限制發現可以添加的內容。

197 197 

198發現的 ID 僅在它完全匹配選擇器中已有的列，或當發現的和現有的 ID 都解析為 [Fable](/zh-TW/model-config#work-with-fable-5) 時才被跳過。內建列由別名（如 `sonnet`）鍵入，因此發現的 ID（如 `claude-sonnet-4-6`）在內建條目旁邊添加其自己的「來自 gateway」列，而不是替換它。198發現的 ID 僅在它完全匹配選擇器中已有的列，或當發現的和現有的 ID 都解析為 [Fable](/zh-TW/model-config#work-with-fable-5) 時才被跳過。{/* min-version: 2.1.197 */}自 Claude Code v2.1.197 起，發現的明確 ID 在兩者都解析為同一模型時也會折疊到內建條目中。內建列由別名（如 `sonnet`）鍵入，因此發現的明確 ID（如該別名目前解析到的模型 `claude-sonnet-5`）會折疊到 `sonnet` 列中，而別名不解析到的 ID（如 `claude-sonnet-4-6`）仍會在內建條目旁邊添加其自己的「來自 gateway」列。

199 199 

200結果被快取到 `~/.claude/cache/gateway-models.json`，或在 Windows 上 `%USERPROFILE%\.claude\cache\gateway-models.json`，並在每次啟動時刷新。如果請求失敗或 gateway 未實現 `/v1/models`，選擇器會回退到上次啟動的快取清單或內建模型清單。如果您的 gateway 在不匹配發現篩選器的別名下提供 Claude 模型，開發人員可以使用[模型配置](/zh-TW/model-config)變數手動添加這些別名。200結果被快取到 `~/.claude/cache/gateway-models.json`，或在 Windows 上 `%USERPROFILE%\.claude\cache\gateway-models.json`，並在每次啟動時刷新。如果請求失敗或 gateway 未實現 `/v1/models`，選擇器會回退到上次啟動的快取清單或內建模型清單。如果您的 gateway 在不匹配發現篩選器的別名下提供 Claude 模型，開發人員可以使用[模型配置](/zh-TW/model-config)變數手動添加這些別名。

201 201 

628* `event.sequence`：單調遞增計數器，用於排序工作階段內的事件628* `event.sequence`：單調遞增計數器，用於排序工作階段內的事件

629* `response_length`：回應文字的長度（字元數）629* `response_length`：回應文字的長度（字元數）

630* `response`：回應文字，在 60 KB 處截斷。預設為 `<REDACTED>`。設定 `OTEL_LOG_ASSISTANT_RESPONSES=1` 以包含它。當 `OTEL_LOG_ASSISTANT_RESPONSES` 未設定時，`OTEL_LOG_USER_PROMPTS` 會控制它，因此設定 `OTEL_LOG_ASSISTANT_RESPONSES=0` 以在啟用提示記錄時保持回應編輯630* `response`：回應文字，在 60 KB 處截斷。預設為 `<REDACTED>`。設定 `OTEL_LOG_ASSISTANT_RESPONSES=1` 以包含它。當 `OTEL_LOG_ASSISTANT_RESPONSES` 未設定時，`OTEL_LOG_USER_PROMPTS` 會控制它，因此設定 `OTEL_LOG_ASSISTANT_RESPONSES=0` 以在啟用提示記錄時保持回應編輯

631* `model`：模型識別碼（例如，"claude-sonnet-4-6"）631* `model`：模型識別碼（例如，"claude-sonnet-5"）

632* `request_id`：來自回應的 `request-id` 標頭的 Anthropic API 請求 ID。僅當 API 傳回時才存在632* `request_id`：來自回應的 `request-id` 標頭的 Anthropic API 請求 ID。僅當 API 傳回時才存在

633* `query_source`：發出請求的子系統，例如 `"repl_main_thread"`、`"compact"` 或子代理名稱633* `query_source`：發出請求的子系統，例如 `"repl_main_thread"`、`"compact"` 或子代理名稱

634 634 

129 129 

130輸入 `/deploy` 執行專案根目錄 skill。輸入限定名稱 `/apps/web:deploy` 以明確執行巢狀變體。130輸入 `/deploy` 執行專案根目錄 skill。輸入限定名稱 `/apps/web:deploy` 以明確執行巢狀變體。

131 131 

132一個 `<skill-name>` 項目在企業、個人或專案位置可以是磁碟上其他位置的目錄的符號連結。Claude Code 遵循符號連結並從目標目錄讀取 `SKILL.md`，如果相同的目標可從多個位置到達，Claude Code 會載入該 skill 一次。外掛 skills 以不同方式處理符號連結；請參閱[使用符號連結在市集中共享檔案](/zh-TW/plugins-reference#share-files-within-a-marketplace-with-symlinks)。

133 

132<Note>134<Note>

133 將 `.claude-plugin/plugin.json` 新增到 skill 資料夾，它會載入為名為 `<name>@skills-dir` 的[外掛](/zh-TW/plugins-reference#skills-directory-plugins)，因此它可以捆綁代理、hooks 和 MCP 伺服器。在專案的 `.claude/skills/` 中，這需要先接受工作區信任對話。135 將 `.claude-plugin/plugin.json` 新增到 skill 資料夾，它會載入為名為 `<name>@skills-dir` 的[外掛](/zh-TW/plugins-reference#skills-directory-plugins)，因此它可以捆綁代理、hooks 和 MCP 伺服器。在專案的 `.claude/skills/` 中，這需要先接受工作區信任對話。

134</Note>136</Note>

26| `irm is not recognized` 或 `&& is not valid` | [在您的 shell 上使用正確的命令](#wrong-install-command-on-windows) |26| `irm is not recognized` 或 `&& is not valid` | [在您的 shell 上使用正確的命令](#wrong-install-command-on-windows) |

27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [更新 Homebrew](#homebrew-cask-unavailable-or-outdated) |27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [更新 Homebrew](#homebrew-cask-unavailable-or-outdated) |

28| `'bash' is not recognized as the name of a cmdlet` | [使用 Windows 安裝程式命令](#wrong-install-command-on-windows) |28| `'bash' is not recognized as the name of a cmdlet` | [使用 Windows 安裝程式命令](#wrong-install-command-on-windows) |

29| `A parameter cannot be found that matches parameter name 'fsSL'` | [使用 Windows 安裝程式命令](#wrong-install-command-on-windows) |

29| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [安裝 shell](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |30| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [安裝 shell](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |

30| `Claude Code does not support 32-bit Windows` | [開啟 Windows PowerShell，而非 x86 項目](#claude-code-does-not-support-32-bit-windows) |31| `Claude Code does not support 32-bit Windows` | [開啟 Windows PowerShell，而非 x86 項目](#claude-code-does-not-support-32-bit-windows) |

31| `The process cannot access the file ... because it is being used by another process` | [清除下載資料夾並重試](#the-process-cannot-access-the-file-during-windows-install) |32| `The process cannot access the file ... because it is being used by another process` | [清除下載資料夾並重試](#the-process-cannot-access-the-file-during-windows-install) |

489 Windows 上的錯誤安裝命令490 Windows 上的錯誤安裝命令

490</h3>491</h3>

491 492 

492如果您看到 `'irm' is not recognized`、`The token '&&' is not valid` 或 `'bash' is not recognized as the name of a cmdlet`，您複製了不同 shell 或作業系統的安裝命令。493如果您看到 `'irm' is not recognized`、`The token '&&' is not valid`、`A parameter cannot be found that matches parameter name 'fsSL'` 或 `'bash' is not recognized as the name of a cmdlet`，您複製了不同 shell 或作業系統的安裝命令。

493 494 

494* **`irm` 未被識別**：您在 CMD 中，而非 PowerShell。您有兩個選項：495* **`irm` 未被識別**：您在 CMD 中，而非 PowerShell。您有兩個選項：

495 496 

510 irm https://claude.ai/install.ps1 | iex511 irm https://claude.ai/install.ps1 | iex

511 ```512 ```

512 513 

514* **`A parameter cannot be found that matches parameter name 'fsSL'`**：您在 Windows PowerShell 中執行了 macOS/Linux `curl -fsSL ... | bash` 安裝程式，其中 `curl` 是 `Invoke-WebRequest` 的別名，會拒絕 `-fsSL` 旗標。改用 PowerShell 安裝程式：

515 ```powershell theme={null}

516 irm https://claude.ai/install.ps1 | iex

517 ```

518 

513* **`bash` 未被識別**：您在 Windows 上執行了 macOS/Linux 安裝程式。改用 PowerShell 安裝程式：519* **`bash` 未被識別**：您在 Windows 上執行了 macOS/Linux 安裝程式。改用 PowerShell 安裝程式：

514 ```powershell theme={null}520 ```powershell theme={null}

515 irm https://claude.ai/install.ps1 | iex521 irm https://claude.ai/install.ps1 | iex

5982. 搜尋「Claude Code」5982. 搜尋「Claude Code」

5993. 點擊**卸載**5993. 點擊**卸載**

600 600 

601在 VS Code 整合終端中執行 `claude` 會自動重新安裝擴充功能。若要保持卸載狀態，請在 `/config` 中關閉**自動安裝 IDE 擴充功能**，或將 [`autoInstallIdeExtension`](/zh-TW/settings#global-config-settings) 設定為 `false`。您也可以將 [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/zh-TW/env-vars) 環境變數設定為 `1`。

602 

601若要也移除擴充功能資料並重設所有設定，請刪除您平台的擴充功能儲存目錄。603若要也移除擴充功能資料並重設所有設定，請刪除您平台的擴充功能儲存目錄。

602 604 

603在 macOS 上：605在 macOS 上：