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 应用多少推理。较低的努力级别每个轮次使用更少的令牌并降低成本。并非所有模型都支持努力参数。有关哪些模型支持它，请参阅 [Effort](https://platform.claude.com/docs/en/build-with-claude/effort)。190`effort` 选项控制 Claude 应用多少推理。较低的努力级别每个轮次使用更少的令牌并降低成本。并非所有模型都支持努力参数。有关哪些模型支持它，请参阅 [Effort](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>

264 为队友使用 subagent 定义264 为队友使用 subagent 定义

265</h3>265</h3>

266 266 

267生成队友时，你可以引用来自任何 [subagent 范围](/zh-CN/sub-agents#choose-the-subagent-scope) 的 [subagent](/zh-CN/sub-agents) 类型：项目、用户、插件或 CLI 定义。这让你定义一个角色一次，例如安全审查员或测试运行器，并将其同时重用为委派的 subagent 和 agent team 队友。267当生成队友时，你可以引用来自任何 [subagent 范围](/zh-CN/sub-agents#choose-the-subagent-scope) 的 [subagent](/zh-CN/sub-agents) 类型：项目、用户、插件或 CLI 定义。这让你定义一个角色一次，例如安全审查员或测试运行器，并将其同时重用为委派的 subagent 和 agent team 队友。

268 268 

269要使用 subagent 定义，在要求 Claude 生成队友时按名称提及它：269要使用 subagent 定义，在要求 Claude 生成队友时按名称提及它：

270 270 

284 284 

285队友从负责人的权限设置开始。如果负责人使用 `--dangerously-skip-permissions` 运行，所有队友也会这样做。生成后，你可以更改个别队友模式，但在生成时无法设置每个队友的模式。285队友从负责人的权限设置开始。如果负责人使用 `--dangerously-skip-permissions` 运行，所有队友也会这样做。生成后，你可以更改个别队友模式，但在生成时无法设置每个队友的模式。

286 286 

287当一个代理通过 `SendMessage` 向另一个代理发送消息时，接收代理被告知它来自另一个 Claude 会话，而不是来自你。队友无法批准权限提示或代表你提供同意，被拒绝某项操作的队友无法将其转发给另一个队友以绕过检查。在 [auto mode](/zh-CN/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>

281| :---------------------- | :--------------------------------------------------------------------------------------- |281| :---------------------- | :--------------------------------------------------------------------------------------- |

282| `<agent-name> <prompt>` | 如果第一个单词匹配自定义 [subagent](/zh-CN/sub-agents) 名称，该 subagent 作为会话的主代理运行，使用其 frontmatter 中的配置 |282| `<agent-name> <prompt>` | 如果第一个单词匹配自定义 [subagent](/zh-CN/sub-agents) 名称，该 subagent 作为会话的主代理运行，使用其 frontmatter 中的配置 |

283| `@<agent-name>` | 在提示中的任何地方提及自定义 subagent 以作为主代理运行它 |283| `@<agent-name>` | 在提示中的任何地方提及自定义 subagent 以作为主代理运行它 |

284| `@<repo>` | 提及你打开 agent view 的目录下的存储库以在那里运行会话 |284| `@<repo>` | 提及一个存储库以在那里运行会话。参见 [调度到特定目录](#dispatch-to-a-specific-directory) 了解列出了哪些存储库 |

285| `/<command>` | 建议 [skills](/zh-CN/skills) 和 [commands](/zh-CN/commands) 作为提示调度 |285| `/<command>` | 建议 [skills](/zh-CN/skills) 和 [commands](/zh-CN/commands) 作为提示调度 |

286| `! <command>` | 运行 shell 命令作为后台作业而不是启动 Claude 会话。该作业显示为一行，你可以附加到、观看和分离 |286| `! <command>` | 运行 shell 命令作为后台作业而不是启动 Claude 会话。该作业显示为一行，你可以附加到、观看和分离 |

287| `#<number>` 或拉取请求 URL | 如果会话已在处理该 PR，选择它而不是调度 |287| `#<number>` 或拉取请求 URL | 如果会话已在处理该 PR，选择它而不是调度 |

297 调度到特定目录297 调度到特定目录

298</h4>298</h4>

299 299 

300新会话在你打开 agent view 的目录中运行。要针对不同的目录：300新会话在你打开 agent view 的目录中运行。要针对不同的目录，使用以下任何一种：

301 301 

302* 在该目录中打开 `claude agents`。302* 在该目录中打开 `claude agents`。

303* 在保存多个存储库的父目录中打开 `claude agents`，并在提示中用 `@<repo>` 提及一个以在那里运行会话。303* 在父目录中打开 `claude agents` 并在提示中用 `@<repo>` 提及一个子存储库。输入 `@` 会列出启动目录下一级的 git 存储库，加上任何已在列表中有会话的目录。名称包含空格的目录不会被列出。

304* 从 shell，`cd` 进入目录并运行 `claude --bg "<prompt>"`。304* 从 shell，`cd` 进入目录并运行 `claude --bg "<prompt>"`。

305 305 

306当 agent view 按目录分组时，突出显示的行的目录成为调度目标，所以你可以滚动到一个组并在不重新输入路径的情况下调度到它。306当 agent view 按目录分组时，突出显示的行的目录成为调度目标，所以你可以滚动到一个组并在不重新输入路径的情况下调度到它。

416 设置模型416 设置模型

417</h3>417</h3>

418 418 

419agent view 标题中显示的模型名称是调度默认值。你从输入启动的新会话使用此模型，这来自你的用户设置中的 [`model` 设置](/zh-CN/settings#available-settings)。通过在 [`/model` 选择器](/zh-CN/model-config) 中选择模型来设置它，或直接编辑设置。要为整个 agent view 会话覆盖它，在打开 agent view 时传递 `--model`。参见 [权限模式、模型和工作量](#permission-mode-model-and-effort)。419agent view 标题中显示的模型名称是调度默认值。你从输入启动的新会话使用此模型，这来自你的用户设置中的 [`model` 设置](/zh-CN/settings#available-settings)。通过在 [`/model` 选择器](/zh-CN/model-config) 中选择模型来设置它，或直接编辑设置。

420 

421要为整个 agent view 会话覆盖调度默认值，在打开 agent view 时传递 `--model`。参见 [权限模式、模型和工作量](#permission-mode-model-and-effort)。

420 422 

421要从 agent view 内部更改调度默认值，在调度输入中输入 `/model` 后跟模型名称并按 `Enter`。标题更新以显示该模型，带有 `(session)` 标记，之后调度的会话使用它。输入 `/model default` 以清除覆盖并返回调度默认值。此覆盖持续当前 `claude agents` 运行的其余部分，不写入你的设置文件。以下示例在 Opus 上调度一个会话，在 Sonnet 上调度下一个：423要从 agent view 内部更改调度默认值，在调度输入中输入 `/model` 后跟模型名称并按 `Enter`。标题更新以显示该模型，带有 `(session)` 标记，之后调度的会话使用它。输入 `/model default` 以清除覆盖并返回调度默认值。此覆盖持续当前 `claude agents` 运行的其余部分，不写入你的设置文件。以下示例在 Opus 上调度一个会话，在 Sonnet 上调度下一个：

422 424 

268| `CLAUDE_CODE_SCROLL_SPEED` | 在[全屏渲染](/zh-CN/fullscreen#mouse-wheel-scrolling)中设置鼠标滚轮滚动倍数。接受 1 到 20 的值，以及低于 1 的分数值（如 `0.5`）以减慢终端上原生滚动路径中加速的触控板和滚轮滚动。设置为 `3` 以匹配 `vim`（如果您的终端每个刻度线发送一个滚轮事件而不进行放大）。在 JetBrains IDE 终端中被忽略，Claude Code 使用其自己的滚动处理 |268| `CLAUDE_CODE_SCROLL_SPEED` | 在[全屏渲染](/zh-CN/fullscreen#mouse-wheel-scrolling)中设置鼠标滚轮滚动倍数。接受 1 到 20 的值，以及低于 1 的分数值（如 `0.5`）以减慢终端上原生滚动路径中加速的触控板和滚轮滚动。设置为 `3` 以匹配 `vim`（如果您的终端每个刻度线发送一个滚轮事件而不进行放大）。在 JetBrains IDE 终端中被忽略，Claude Code 使用其自己的滚动处理 |

269| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/zh-CN/hooks#sessionend) hooks 的时间预算（以毫秒为单位）。适用于会话退出、`/clear` 和通过交互式 `/resume` 切换会话。默认预算为 1.5 秒，自动提高到设置文件中配置的最高每个 hook `timeout`，最高 60 秒。插件提供的 hooks 上的超时不会提高预算 |269| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/zh-CN/hooks#sessionend) hooks 的时间预算（以毫秒为单位）。适用于会话退出、`/clear` 和通过交互式 `/resume` 切换会话。默认预算为 1.5 秒，自动提高到设置文件中配置的最高每个 hook `timeout`，最高 60 秒。插件提供的 hooks 上的超时不会提高预算 |

270| `CLAUDE_CODE_SESSION_ID` | 在 Bash 和 PowerShell 工具子进程中自动设置为当前会话 ID，[hook 命令](/zh-CN/hooks)子进程和 stdio [MCP server](/zh-CN/mcp) 子进程。对于 Bash、PowerShell 和 hooks，这与传递给 [hooks](/zh-CN/hooks) 的 `session_id` 字段匹配，并在 `/clear` 时更新。MCP 服务器子进程保留它生成时的 ID。在 `--resume <session-id>` 上它接收恢复的 ID，与 hooks 和 Bash 匹配。在 `--continue` 或 `--resume` 没有显式 ID 时它可能接收初始启动 ID。用于将脚本和外部工具与启动它们的 Claude Code 会话相关联 |270| `CLAUDE_CODE_SESSION_ID` | 在 Bash 和 PowerShell 工具子进程中自动设置为当前会话 ID，[hook 命令](/zh-CN/hooks)子进程和 stdio [MCP server](/zh-CN/mcp) 子进程。对于 Bash、PowerShell 和 hooks，这与传递给 [hooks](/zh-CN/hooks) 的 `session_id` 字段匹配，并在 `/clear` 时更新。MCP 服务器子进程保留它生成时的 ID。在 `--resume <session-id>` 上它接收恢复的 ID，与 hooks 和 Bash 匹配。在 `--continue` 或 `--resume` 没有显式 ID 时它可能接收初始启动 ID。用于将脚本和外部工具与启动它们的 Claude Code 会话相关联 |

271| `CLAUDE_CODE_SHELL` | 覆盖自动 shell 检测。当您的登录 shell 与您的首选工作 shell 不同时很有用（例如，`bash` 与 `zsh`） |271| `CLAUDE_CODE_SHELL` | 设置 Claude Code 用于运行 Bash 工具命令的 shell。接受 `bash` 或 `zsh` 二进制文件的路径，例如 `/opt/homebrew/bin/bash`。不支持 `fish` 等其他 shells。如果该值不是有效的 `bash` 或 `zsh` 路径，Claude Code 会忽略它并回退到自动检测。自动检测在您的 `$SHELL` 指向 `bash` 或 `zsh` 时使用它，否则它会选择在您的 `PATH` 和标准安装位置上找到的第一个有效的 `zsh` 然后 `bash` |

272| `CLAUDE_CODE_SHELL_PREFIX` | 命令前缀以包装 Claude Code 生成的 shell 命令：Bash 工具调用、[hook](/zh-CN/hooks) 命令、[状态行](/zh-CN/statusline)命令和 stdio [MCP server](/zh-CN/mcp) 启动命令。PowerShell hooks 和 exec 形式的 hooks 运行时不带前缀。对于日志记录或审计很有用。设置裸可执行文件路径如 `/path/to/logger.sh` 将每个命令作为 `/path/to/logger.sh '<command>'` 运行。包装器在 `$1` 中接收命令行作为单个 shell 引用的参数，因此包装器必须使用 shell 重新评估 `$1`，例如 `exec bash -c "$1"`。将 `$1` 视为裸可执行文件路径会破坏传递参数的 stdio MCP 服务器，如 `npx -y <package>`。对于 Bash 工具调用，`$1` 包含 Claude Code 组装的完整 shell 调用，包括环境设置，而不仅仅是 Claude 运行的命令 |272| `CLAUDE_CODE_SHELL_PREFIX` | 命令前缀以包装 Claude Code 生成的 shell 命令：Bash 工具调用、[hook](/zh-CN/hooks) 命令、[状态行](/zh-CN/statusline)命令和 stdio [MCP server](/zh-CN/mcp) 启动命令。PowerShell hooks 和 exec 形式的 hooks 运行时不带前缀。对于日志记录或审计很有用。设置裸可执行文件路径如 `/path/to/logger.sh` 将每个命令作为 `/path/to/logger.sh '<command>'` 运行。包装器在 `$1` 中接收命令行作为单个 shell 引用的参数，因此包装器必须使用 shell 重新评估 `$1`，例如 `exec bash -c "$1"`。将 `$1` 视为裸可执行文件路径会破坏传递参数的 stdio MCP 服务器，如 `npx -y <package>`。对于 Bash 工具调用，`$1` 包含 Claude Code 组装的完整 shell 调用，包括环境设置，而不仅仅是 Claude 运行的命令 |

273| `CLAUDE_CODE_SIMPLE` | 设置为 `1` 以使用最小系统提示和仅 Bash、文件读取和文件编辑工具运行。MCP 工具来自 `--mcp-config` 仍然可用。禁用 hooks、skills、plugins、MCP servers、自动内存和 CLAUDE.md 的自动发现。OAuth 令牌和钥匙链凭证不被读取，所以 Anthropic 身份验证必须来自 `ANTHROPIC_API_KEY` 或 `--settings` 中的 `apiKeyHelper`。等同于传递 [`--bare`](/zh-CN/headless#start-faster-with-bare-mode) |273| `CLAUDE_CODE_SIMPLE` | 设置为 `1` 以使用最小系统提示和仅 Bash、文件读取和文件编辑工具运行。MCP 工具来自 `--mcp-config` 仍然可用。禁用 hooks、skills、plugins、MCP servers、自动内存和 CLAUDE.md 的自动发现。OAuth 令牌和钥匙链凭证不被读取，所以 Anthropic 身份验证必须来自 `ANTHROPIC_API_KEY` 或 `--settings` 中的 `apiKeyHelper`。等同于传递 [`--bare`](/zh-CN/headless#start-faster-with-bare-mode) |

274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 设置为 `1` 以在任何模型上使用较短的系统提示和缩写的工具描述。设置为 `0`、`false`、`no` 或 `off` 以选择退出，即使在实验或服务器配置会以其他方式启用它的模型上。完整的工具集、hooks、MCP 服务器和 CLAUDE.md 发现保持启用 |274| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 设置为 `1` 以在任何模型上使用较短的系统提示和缩写的工具描述。设置为 `0`、`false`、`no` 或 `off` 以选择退出，即使在实验或服务器配置会以其他方式启用它的模型上。完整的工具集、hooks、MCP 服务器和 CLAUDE.md 发现保持启用 |

378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | 使用 Vertex AI 时覆盖 Claude Sonnet 4.6 的区域 |378| `VERTEX_REGION_CLAUDE_4_6_SONNET` | 使用 Vertex AI 时覆盖 Claude Sonnet 4.6 的区域 |

379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | 使用 Vertex AI 时覆盖 Claude Opus 4.7 的区域。在 v2.1.111 中添加 |379| `VERTEX_REGION_CLAUDE_4_7_OPUS` | 使用 Vertex AI 时覆盖 Claude Opus 4.7 的区域。在 v2.1.111 中添加 |

380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | 使用 Vertex AI 时覆盖 Claude Opus 4.8 的区域。在 v2.1.154 中添加 |380| `VERTEX_REGION_CLAUDE_4_8_OPUS` | 使用 Vertex AI 时覆盖 Claude Opus 4.8 的区域。在 v2.1.154 中添加 |

381| `VERTEX_REGION_CLAUDE_5_SONNET` | 使用 Vertex AI 时覆盖 Claude Sonnet 5 的区域。在 v2.1.197 中添加 |

381| `VERTEX_REGION_CLAUDE_FABLE_5` | 使用 Vertex AI 时覆盖 Claude Fable 5 的区域。在 v2.1.170 中添加 |382| `VERTEX_REGION_CLAUDE_FABLE_5` | 使用 Vertex AI 时覆盖 Claude Fable 5 的区域。在 v2.1.170 中添加 |

382| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | 使用 Vertex AI 时覆盖 Claude Haiku 4.5 的区域 |383| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | 使用 Vertex AI 时覆盖 Claude Haiku 4.5 的区域 |

383 384 

195 195 

196选择器是当开发者在 Claude Code 中运行 `/model` 时打开的交互式模型列表。每个发现的条目都标记为"来自 gateway"，并在提供时使用 `display_name`。[`availableModels` 托管设置](/zh-CN/settings#available-settings)限制了发现可以添加的内容。196选择器是当开发者在 Claude Code 中运行 `/model` 时打开的交互式模型列表。每个发现的条目都标记为"来自 gateway"，并在提供时使用 `display_name`。[`availableModels` 托管设置](/zh-CN/settings#available-settings)限制了发现可以添加的内容。

197 197 

198仅当发现的 ID 与选择器中已有的行完全匹配时，或当发现的和现有的 ID 都解析为 [Fable](/zh-CN/model-config#work-with-fable-5) 时，才会跳过发现的 ID。内置行按别名（如 `sonnet`）键入，因此发现的 ID（如 `claude-sonnet-4-6`）在内置条目旁边添加自己的"来自 gateway"行。198仅当发现的 ID 与选择器中已有的行完全匹配时，或当发现的和现有的 ID 都解析为 [Fable](/zh-CN/model-config#work-with-fable-5) 时，才会跳过发现的 ID。{/* min-version: 2.1.197 */}从 Claude Code v2.1.197 开始，当发现的显式 ID 和内置条目都解析为同一模型时，发现的显式 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-CN/model-config)变量手动添加这些别名。200结果被缓存到 `~/.claude/cache/gateway-models.json`，或在 Windows 上 `%USERPROFILE%\.claude\cache\gateway-models.json`，并在每次启动时刷新。如果请求失败或 gateway 未实现 `/v1/models`，选择器会回退到上次启动的缓存列表或内置模型列表。如果您的 gateway 在不匹配发现过滤器的别名下提供 Claude 模型，开发者可以使用[模型配置](/zh-CN/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-CN/plugins-reference#share-files-within-a-marketplace-with-symlinks)。

133 

132<Note>134<Note>

133 将 `.claude-plugin/plugin.json` 添加到 skill 文件夹中，它会作为[插件](/zh-CN/plugins-reference#skills-directory-plugins)加载，名称为 `<name>@skills-dir`，因此它可以捆绑 agents、hooks 和 MCP servers。在项目的 `.claude/skills/` 中，这需要首先接受工作区信任对话框。135 将 `.claude-plugin/plugin.json` 添加到 skill 文件夹中，它会作为[插件](/zh-CN/plugins-reference#skills-directory-plugins)加载，名称为 `<name>@skills-dir`，因此它可以捆绑 agents、hooks 和 MCP servers。在项目的 `.claude/skills/` 中，这需要首先接受工作区信任对话框。

134</Note>136</Note>

361WebSearch 权限规则不接受 specifier。`allow` 或 `deny` 中的裸 `WebSearch` 条目是唯一的形式。361WebSearch 权限规则不接受 specifier。`allow` 或 `deny` 中的裸 `WebSearch` 条目是唯一的形式。

362 362 

363<Note>363<Note>

364 WebSearch 在 Claude API 和 Microsoft Foundry 上可用。在 Google Cloud Vertex AI 上，它适用于 Claude 4 模型，包括 Opus、Sonnet 和 Haiku。Amazon Bedrock 不公开服务器端网络搜索工具。364 WebSearch 在 Claude API 和 Microsoft Foundry 上可用。在 Google Cloud Vertex AI 上，它适用于 Claude 4 及更高版本的模型，包括 Opus、Sonnet 和 Haiku。Amazon Bedrock 不公开服务器端网络搜索工具。

365</Note>365</Note>

366 366 

367<h2 id="write-tool-behavior">367<h2 id="write-tool-behavior">

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-CN/settings#global-config-settings) 设置为 `false`。您也可以将 [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/zh-CN/env-vars) 环境变量设置为 `1`。

602 

601要也删除扩展数据并重置所有设置，请删除您平台的扩展存储目录。603要也删除扩展数据并重置所有设置，请删除您平台的扩展存储目录。

602 604 

603在 macOS 上：605在 macOS 上：