Documentation — Spybara

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

Details

86`settingSources` 涵盖用户、项目和本地设置。无论其值如何，都会读取一些输入：86`settingSources` 涵盖用户、项目和本地设置。无论其值如何，都会读取一些输入：

87 87

88| 输入 | 行为 | 禁用方式 |88| 输入 | 行为 | 禁用方式 |

89| :------------------------------------------------------------- | :---------------------------------------------------- | :--------------------------------------------------------------------------------- |89| :------------------------------------------------------------- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |

93| [claude.ai MCP 连接器](/zh-CN/mcp#use-mcp-servers-from-claude-ai) | 当活跃身份验证方法是 claude.ai 订阅时加载。传递 `mcpServers: {}` 不会抑制它们 | 设置 `strictMcpConfig: true`，或在 `env` 中设置 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |93| [claude.ai MCP 连接器](/zh-CN/mcp#use-mcp-servers-from-claude-ai) | 当活跃身份验证方法是 claude.ai 订阅时加载。传递 `mcpServers: {}` 不会抑制它们 | 设置 `strictMcpConfig: true`、[`disableClaudeAiConnectors: true`](/zh-CN/mcp#disable-claude-ai-connectors) 在设置中，或在 `env` 中设置 `ENABLE_CLAUDEAI_MCP_SERVERS=false` |

94 94

95<Warning>95<Warning>

96 不要依赖默认 `query()` 选项进行多租户隔离。因为上述输入无论 `settingSources` 如何都会被读取，SDK 进程可能会获取主机级配置和按目录内存。对于多租户部署，在自己的文件系统中运行每个租户，并设置 `settingSources: []` 加上 `env` 中的 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。请参阅 [安全部署](/zh-CN/agent-sdk/secure-deployment)。96 不要依赖默认 `query()` 选项进行多租户隔离。因为上述输入无论 `settingSources` 如何都会被读取，SDK 进程可能会获取主机级配置和按目录内存。对于多租户部署，在自己的文件系统中运行每个租户，并设置 `settingSources: []` 加上 `env` 中的 `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`。请参阅 [安全部署](/zh-CN/agent-sdk/secure-deployment)。

agent-sdk/python.md +1 −1

Details

958```958```

959 959

960* `API_TIMEOUT_MS`：Anthropic 客户端上的每个请求超时，以毫秒为单位。默认 `600000`。适用于主循环和所有子代理。960* `API_TIMEOUT_MS`：Anthropic 客户端上的每个请求超时，以毫秒为单位。默认 `600000`。适用于主循环和所有子代理。

961* `CLAUDE_CODE_MAX_RETRIES`：最大 API 重试次数。默认 `10`。每次重试都有自己的 `API_TIMEOUT_MS` 窗口，因此最坏情况下的实际时间大约是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。961* `CLAUDE_CODE_MAX_RETRIES`：最大 API 重试次数。默认 `10`，上限为 `15`。每次重试都有自己的 `API_TIMEOUT_MS` 窗口，因此最坏情况下的实际时间大约是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。对于需要等待更长时间中断的无人值守运行，设置 `CLAUDE_CODE_RETRY_WATCHDOG=1` 以无限期重试容量错误。

962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：使用 `run_in_background` 启动的子代理的停滞监视器。默认 `600000`。在每个流事件时重置；停滞时中止子代理，将任务标记为失败，并将错误与任何部分结果一起呈现给父代理。不适用于同步子代理。962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：使用 `run_in_background` 启动的子代理的停滞监视器。默认 `600000`。在每个流事件时重置；停滞时中止子代理，将任务标记为失败，并将错误与任何部分结果一起呈现给父代理。不适用于同步子代理。

963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 与 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：当标头已到达但响应体停止流式传输时中止请求。当 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未设置时，默认值在直接 Anthropic API 上由服务器控制，在其他提供商上关闭。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 默认为 `300000` 并被限制为该最小值。中止的请求通过正常重试路径进行。963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 与 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：当标头已到达但响应体停止流式传输时中止请求。当 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未设置时，默认值在直接 Anthropic API 上由服务器控制，在其他提供商上关闭。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 默认为 `300000` 并被限制为该最小值。中止的请求通过正常重试路径进行。

964 964

agent-sdk/subagents.md +1 −1

Details

196在 Python SDK 中，这些字段名称使用 camelCase 以匹配线路格式。有关详细信息，请参阅 [`AgentDefinition` 参考](/zh-CN/agent-sdk/python#agentdefinition)。196在 Python SDK 中，这些字段名称使用 camelCase 以匹配线路格式。有关详细信息，请参阅 [`AgentDefinition` 参考](/zh-CN/agent-sdk/python#agentdefinition)。

197 197

198<Note>198<Note>

199 {/* min-version: 2.1.172 */}自 Claude Code v2.1.172 起，子代理可以生成自己的子代理。位于主代理下方五个级别的后台子代理无法生成进一步的子代理；前台子代理可以在任何深度生成。要防止子代理生成其他子代理，请从其 `tools` 数组中省略 `Agent` 或将其添加到 `disallowedTools`。有关完整的深度规则，请参阅[嵌套子代理](/zh-CN/sub-agents#spawn-nested-subagents)。199 {/* min-version: 2.1.172 */}自 Claude Code v2.1.172 起，子代理可以生成自己的子代理。位于主代理下方五个级别的子代理无法生成进一步的子代理，无论其是在前台还是后台运行。要防止子代理生成其他子代理，请从其 `tools` 数组中省略 `Agent` 或将其添加到 `disallowedTools`。有关完整的深度规则，请参阅[嵌套子代理](/zh-CN/sub-agents#spawn-nested-subagents)。

200</Note>200</Note>

201 201

202<h3 id="filesystem-based-definition-alternative">202<h3 id="filesystem-based-definition-alternative">

agent-sdk/typescript.md +8 −3

Details

551```551```

552 552

553* `API_TIMEOUT_MS`：Anthropic 客户端上的每个请求超时，以毫秒为单位。默认 `600000`。适用于主循环和所有子代理。553* `API_TIMEOUT_MS`：Anthropic 客户端上的每个请求超时，以毫秒为单位。默认 `600000`。适用于主循环和所有子代理。

554* `CLAUDE_CODE_MAX_RETRIES`：最大 API 重试次数。默认 `10`。每次重试都有自己的 `API_TIMEOUT_MS` 窗口，因此最坏情况下的实际时间大约是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。554* `CLAUDE_CODE_MAX_RETRIES`：最大 API 重试次数。默认 `10`，上限为 `15`。每次重试都有自己的 `API_TIMEOUT_MS` 窗口，因此最坏情况下的实际时间大约是 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` 加上退避。对于需要等待更长时间中断的无人值守运行，设置 `CLAUDE_CODE_RETRY_WATCHDOG=1` 以无限期重试容量错误。

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：使用 `run_in_background` 启动的子代理的停滞监视程序。默认 `600000`。在每个流事件上重置；在停滞时中止子代理，将任务标记为失败，并将错误与任何部分结果一起呈现给父级。不适用于同步子代理。555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`：使用 `run_in_background` 启动的子代理的停滞监视程序。默认 `600000`。在每个流事件上重置；在停滞时中止子代理，将任务标记为失败，并将错误与任何部分结果一起呈现给父级。不适用于同步子代理。

556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 与 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：当标头已到达但响应正文停止流式传输时中止请求。当 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未设置时，默认值在直接 Anthropic API 上由服务器控制，在其他提供商上关闭。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 默认为 `300000` 并被限制为该最小值。中止的请求通过正常重试路径进行。556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` 与 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`：当标头已到达但响应正文停止流式传输时中止请求。当 `CLAUDE_ENABLE_STREAM_WATCHDOG` 未设置时，默认值在直接 Anthropic API 上由服务器控制，在其他提供商上关闭。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` 默认为 `300000` 并被限制为该最小值。中止的请求通过正常重试路径进行。

557 557

1418```1418```

1419 1419

1420| `kind` | 含义 |1420| `kind` | 含义 |

1421| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |1421| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1424| `peer` | 保留用于来自另一个代理会话的消息。`from` 是发送者地址，`name` 是发送者的显示名称（如果可用）。`senderTaskId` 是发送消息的进程内后台子代理的任务 ID；对于跨会话对等体不存在。Agent SDK 不会发出此来源；将其视为未知来源。 |1424| `peer` | 来自另一个代理的消息。对于通过 `SendMessage` 发送到 `main` 的进程内[队友](/zh-CN/agent-teams)，`from` 是队友的名称，`senderTaskId` 是其任务 ID。对于跨会话对等体（例如另一个本地 Claude Code 进程），`from` 是发送者地址，`senderTaskId` 不存在。`name` 字段是保留的。 |

3654 status: "allowed" | "allowed_warning" | "rejected";3654 status: "allowed" | "allowed_warning" | "rejected";

3655 resetsAt?: number;3655 resetsAt?: number;

3656 utilization?: number;3656 utilization?: number;

3657 errorCode?: "credits_required";

3658 canUserPurchaseCredits?: boolean;

3659 hasChargeableSavedPaymentMethod?: boolean;

3657 };3660 };

3658 uuid: UUID;3661 uuid: UUID;

3659 session_id: string;3662 session_id: string;

3660};3663};

3661```3664```

3662 3665

3666{/* min-version: 2.1.181 */}当 `errorCode` 为 `"credits_required"` 时，拒绝来自 claude.ai 订阅，其包含的使用量已耗尽，会话在用户购买使用额度之前无法继续。`canUserPurchaseCredits` 指示经过身份验证的用户是否可以为帐户购买额度，`hasChargeableSavedPaymentMethod` 指示是否有保存的付款方式。所有三个字段在非信用额度必需拒绝的速率限制事件中不存在。需要 Claude Code v2.1.181 或更高版本。

3667

3663<h3 id="sdklocalcommandoutputmessage">3668<h3 id="sdklocalcommandoutputmessage">

3664 `SDKLocalCommandOutputMessage`3669 `SDKLocalCommandOutputMessage`

3665</h3>3670</h3>

agent-teams.md +21 −10

Details

90 90

91从那里，Claude 会填充一个 [共享任务列表](/zh-CN/interactive-mode#task-list)，为每个角度生成队友，让他们探索问题，并在完成时综合发现。91从那里，Claude 会填充一个 [共享任务列表](/zh-CN/interactive-mode#task-list)，为每个角度生成队友，让他们探索问题，并在完成时综合发现。

92 92

93负责人的终端列出所有队友及其正在处理的工作。使用 Shift+Down 循环浏览队友并直接向他们发送消息。在最后一个队友之后，Shift+Down 会回到负责人。93负责人的终端在提示输入下方的 agent 面板中列出队友。从该面板中：

95* **向上和向下箭头**：选择一个队友

96* **Enter**：打开所选队友的记录并直接向其发送消息

97* **Escape**：中断所选队友的当前轮次

99{/* min-version: 2.1.181 */}从 v2.1.181 开始，空闲队友的行会在 30 秒后隐藏，并在其下一轮时重新出现。队友在隐藏时仍然保持运行并可寻址。

94 100

95如果你想让每个队友在自己的分割窗格中，请参阅 [选择显示模式](#choose-a-display-mode)。101如果你想让每个队友在自己的分割窗格中，请参阅 [选择显示模式](#choose-a-display-mode)。

96 102

106 112

107Agent teams 支持两种显示模式：113Agent teams 支持两种显示模式：

108 114

109* **In-process**：所有队友在你的主终端内运行。使用 Shift+Down 循环浏览队友并输入以直接向他们发送消息。在任何终端中工作，无需额外设置。115* **In-process**：所有队友在你的主终端内运行。在 agent 面板中使用上下箭头键选择队友，然后按 Enter 查看它并输入以直接向它发送消息。在任何终端中工作，无需额外设置。

110* **Split panes**：每个队友获得自己的窗格。你可以同时看到每个人的输出，并点击窗格直接交互。需要 tmux 或 iTerm2。116* **Split panes**：每个队友获得自己的窗格。你可以同时看到每个人的输出，并点击窗格直接交互。需要 tmux 或 iTerm2。

111 117

112<Note>118<Note>

113 `tmux` 在某些操作系统上有已知限制，传统上在 macOS 上效果最好。在 iTerm2 中使用 `tmux -CC` 是进入 `tmux` 的建议入口点。119 `tmux` 在某些操作系统上有已知限制，传统上在 macOS 上效果最好。在 iTerm2 中使用 `tmux -CC` 是进入 `tmux` 的建议入口点。

114</Note>120</Note>

115 121

116默认值是 `"auto"`，如果你已经在 tmux 会话中运行或你的终端是 iTerm2，则使用分割窗格，否则使用 in-process。`"tmux"` 设置启用分割窗格模式，并根据你的终端自动检测是使用 tmux 还是 iTerm2。要覆盖，在 `~/.claude/settings.json` 中设置 [`teammateMode`](/zh-CN/settings#available-settings)：122默认值是 `"in-process"`。在 v2.1.179 之前，默认值是 `"auto"`，所以升级的会话如果之前打开了分割窗格，现在会保持在一个终端中，除非你显式设置模式。设置 `"auto"` 以在你已经在 tmux 会话中运行或你的终端是 iTerm2 时启用分割窗格，否则回退到 in-process。`"tmux"` 设置启用分割窗格模式，并根据你的终端自动检测是使用 tmux 还是 iTerm2。

123

124{/* min-version: 2.1.186 */}从 v2.1.186 开始，设置 `"iterm2"` 以显式使用 iTerm2 原生分割窗格。此模式需要 [`it2` CLI](https://github.com/mkusaka/it2)，如果 `it2` 缺失，会显示带有安装命令的错误。当你的终端是 iTerm2 且 tmux 可用作备选方案时，在 `"auto"` 或 `"tmux"` 下会出现提供安装 `it2` 或切换到 tmux 的设置提示。

125

126要覆盖默认值，在 `~/.claude/settings.json` 中设置 [`teammateMode`](/zh-CN/settings#available-settings)：

117 127

118```json theme={null}128```json theme={null}

119{129{

120 "teammateMode": "in-process"130 "teammateMode": "auto"

121}131}

122```132```

123 133

124要为单个会话强制 in-process 模式，将其作为标志传递：134要为单个会话设置模式，将其作为标志传递：

125 135

126```bash theme={null}136```bash theme={null}

127claude --teammate-mode in-process137claude --teammate-mode auto

128```138```

129 139

130分割窗格模式需要 [tmux](https://github.com/tmux/tmux/wiki) 或 iTerm2 与 [`it2` CLI](https://github.com/mkusaka/it2)。手动安装：140分割窗格模式需要 [tmux](https://github.com/tmux/tmux/wiki) 或 iTerm2 与 [`it2` CLI](https://github.com/mkusaka/it2)。手动安装：

166 176

167每个队友都是一个完整的、独立的 Claude Code 会话。你可以直接向任何队友发送消息，以提供额外的指示、提出后续问题或改变他们的方法。177每个队友都是一个完整的、独立的 Claude Code 会话。你可以直接向任何队友发送消息，以提供额外的指示、提出后续问题或改变他们的方法。

168 178

169* **In-process 模式**：使用 Shift+Down 循环浏览队友，然后输入向他们发送消息。按 Enter 查看队友的会话，然后按 Escape 中断他们的当前轮次。按 Ctrl+T 切换任务列表。179* **In-process 模式**：在 agent 面板中使用上下箭头键选择队友，然后按 Enter 查看其会话并输入以向其发送消息。在选定的队友上按 `x` 以停止它。按 Ctrl+T 切换任务列表。

170* **Split-pane 模式**：点击队友的窗格以直接与他们的会话交互。每个队友都有自己终端的完整视图。180* **Split-pane 模式**：点击队友的窗格以直接与他们的会话交互。每个队友都有自己终端的完整视图。

171 181

172<h3 id="assign-and-claim-tasks">182<h3 id="assign-and-claim-tasks">

422 432

423如果在你要求 Claude 创建队友后队友没有出现：433如果在你要求 Claude 创建队友后队友没有出现：

424 434

425* 在 in-process 模式中，队友可能已经在运行但不可见。按 Shift+Down 循环浏览活跃的队友。435* 在 in-process 模式中，队友出现在提示输入下方的代理面板中。使用上下箭头键选择一个，然后按 Enter 键查看它。

426* 检查你给 Claude 的任务是否足够复杂以保证需要队友。Claude 根据任务决定是否生成队友。436* 闲置后消失的队友行已被隐藏，而不是停止。闲置行在 30 秒后隐藏，并在队友的下一轮出现时重新出现。按名称向队友发送消息以将其恢复。

437* 检查你给 Claude 的任务是否足够复杂以保证需要团队。Claude 根据任务决定是否生成队友。

427* 如果你明确要求分割窗格，请确保 tmux 已安装并在你的 PATH 中可用：438* 如果你明确要求分割窗格，请确保 tmux 已安装并在你的 PATH 中可用：

428 ```bash theme={null}439 ```bash theme={null}

429 which tmux440 which tmux

440 队友在错误后停止451 队友在错误后停止

441</h3>452</h3>

442 453

443队友可能在遇到错误后停止，而不是恢复。在 in-process 模式中使用 Shift+Down 或在分割模式中点击窗格来检查他们的输出，然后：454队友可能在遇到错误后停止，而不是恢复。通过在代理面板中选择队友并在 in-process 模式中按 Enter 键，或在分割模式中点击窗格来检查他们的输出，然后：

444 455

445* 直接给他们额外的指示456* 直接给他们额外的指示

446* 生成一个替代队友来继续工作457* 生成一个替代队友来继续工作

agent-view.md +32 −3

Details

283 283

284一小组命令在 agent view 本身中运行而不是调度：`/exit` 和 `/quit` 关闭 agent view，`/logout` 将你登出。所有其他命令和 skill 都作为其第一个提示发送到新的后台会话。284一小组命令在 agent view 本身中运行而不是调度：`/exit` 和 `/quit` 关闭 agent view，`/logout` 将你登出，`/model` 设置 [调度模型](#set-the-model)。Skills、你自己的命令和提示扩展内置命令如 `/init` 作为其第一个提示发送到新的后台会话。其他内置命令显示 `attach to a session to run it` 提示。

285 285

286将重复任务打包为 [skill](/zh-CN/skills) 让你从 agent view 多次启动相同的工作流而无需重新输入提示。286将重复任务打包为 [skill](/zh-CN/skills) 让你从 agent view 多次启动相同的工作流而无需重新输入提示。

287 287

412 412

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

414 414

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

416

417```text theme={null}

418/model opus

419refactor auth

420/model sonnet

421run the test suite

422```

423

415每个后台会话可以在不同的模型上运行。要为一个会话覆盖它：424每个后台会话可以在不同的模型上运行。要为一个会话覆盖它：

416 425

417* 从 shell，用 `claude --bg` 传递 `--model`。426* 从 shell，用 `claude --bg` 传递 `--model`。

422 权限模式、模型和工作量431 权限模式、模型和工作量

423</h3>432</h3>

424 433

425后台会话从它运行的目录读取其 [settings](/zh-CN/settings)，就像你在那里启动了 `claude` 一样。434后台会话从它运行的目录读取其 [settings](/zh-CN/settings)，就像你在那里启动了 `claude` 一样。这包括项目设置中的 [`env` 值](/zh-CN/settings#available-settings)，所以在那里设置的 `ANTHROPIC_MODEL` 或提供商变量适用于该目录中的后台会话。

435

436云提供商选择，如 `CLAUDE_CODE_USE_BEDROCK` 或 `CLAUDE_CODE_USE_VERTEX`，以及 `ANTHROPIC_DEFAULT_*_MODEL` 别名遵循调度会话的 shell。网关端点变量如 `ANTHROPIC_BASE_URL` 及其配对的 `ANTHROPIC_AUTH_TOKEN` 不遵循。参见 [监督者进程](#the-supervisor-process) 了解后台会话如何获取提供商设置和凭证。

426 437

427[permission mode](/zh-CN/permissions) 取决于你如何启动会话。用 `/bg` 或 `←` 后台化现有会话会保持当前权限模式，所以你切换到 `acceptEdits` 或 `auto` 的会话在分离后仍保持该模式。从 agent view 输入调度或从你的 shell 运行 `claude --bg` 使用该目录设置中的 `defaultMode`，或调度的 [subagent 的 frontmatter](/zh-CN/sub-agents#supported-frontmatter-fields) 中的 `permissionMode`。438[permission mode](/zh-CN/permissions) 取决于你如何启动会话。用 `/bg` 或 `←` 后台化现有会话会保持当前权限模式，所以你切换到 `acceptEdits` 或 `auto` 的会话在分离后仍保持该模式。从 agent view 输入调度或从你的 shell 运行 `claude --bg` 使用该目录设置中的 `defaultMode`，或调度的 [subagent 的 frontmatter](/zh-CN/sub-agents#supported-frontmatter-fields) 中的 `permissionMode`。

428 439

508 519

509后台会话由每用户监督进程托管，与你的终端和 agent view 分离。监督进程在你第一次后台会话或打开 agent view 时自动启动，你不直接管理它。520后台会话由每用户监督进程托管，与你的终端和 agent view 分离。监督进程在你第一次后台会话或打开 agent view 时自动启动，你不直接管理它。

510 521

511监督进程及其会话使用与你的交互式会话相同的凭证进行身份验证，并且除了模型 API 外不进行额外的网络连接。522监督进程保持一个预热的工作进程就绪，以便从 agent view 或 `claude --bg` 的调度启动时不会有冷启动的延迟。当你调度时，监督进程将预热的工作进程分配给你的会话，将该会话的目录、设置和凭证应用到它，然后为下一次调度启动一个替代进程。如果没有可用的健康预热工作进程，监督进程会改为启动一个新进程。

523

524监督进程及其会话使用与你的交互式会话相同的凭证进行身份验证，并且除了模型 API 外不进行额外的网络连接。提供商选择变量如 `CLAUDE_CODE_USE_BEDROCK` 和 `ANTHROPIC_DEFAULT_*_MODEL` 别名从调度每个会话的 shell 中读取，并应用到其工作进程。

525

526{/* min-version: 2.1.174 */}后台会话不继承网关端点变量如 `ANTHROPIC_BASE_URL`、等效的 Bedrock、Vertex 和 Foundry 基础 URL 变量，或从启动监督进程的 shell 或调度 shell 中配对的 `ANTHROPIC_AUTH_TOKEN`。会话使用你的存储凭证和项目目录的[设置](/zh-CN/settings)中 `env` 块中的任何 `env` 值。要在项目中指向[LLM 网关](/zh-CN/llm-gateway)的后台会话，在该项目的 `.claude/settings.json` `env` 块中设置 `ANTHROPIC_BASE_URL`，而不是在你的 shell 中导出它。在 v2.1.174 之前，后台会话从监督进程的启动 shell 继承这些变量，因此它可以使用你在该 shell 中配置的网关，而不是为项目目录配置的网关。

512 527

513每个后台会话是其自己的 Claude Code 进程，由监督进程管理而不是与你的终端绑定。积极工作、等待你的输入或有终端连接的会话保持其进程运行。运行中的后台 shell 命令、子代理、动态工作流或监视器计为活跃工作，因此长时间运行的进程（如开发服务器）会保持会话活跃。528每个后台会话是其自己的 Claude Code 进程，由监督进程管理而不是与你的终端绑定。积极工作、等待你的输入或有终端连接的会话保持其进程运行。运行中的后台 shell 命令、子代理、动态工作流或监视器计为活跃工作，因此长时间运行的进程（如开发服务器）会保持会话活跃。

514 529

599 614

600在 Windows 上，如果监督进程没有响应停止请求，该命令会打印其进程 ID。用 `taskkill /PID <pid>` 结束该进程以完成恢复。当你传递了 `--keep-workers` 时，后台会话仍然被保留。615在 Windows 上，如果监督进程没有响应停止请求，该命令会打印其进程 ID。用 `taskkill /PID <pid>` 结束该进程以完成恢复。当你传递了 `--keep-workers` 时，后台会话仍然被保留。

601 616

617<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

618 后台调度失败，出现 `Could not resolve authentication method`

619</h3>

620

621如果后台调度失败，出现 `Could not resolve authentication method`，而交互式会话正常进行身份验证，则接收调度的工作进程没有获取凭证。在 v2.1.174 及更高版本上，监督进程在将[预热工作进程](#the-supervisor-process)分配给调度时提供新的凭证快照，所以这个错误意味着监督进程本身没有可用的存储凭证。确认你已运行 `/login` 或配置了 API 密钥，然后停止监督进程：

622

623```bash theme={null}

624claude daemon stop --any --keep-workers

625```

626

627下一个 `claude agents` 或 `claude --bg` 启动一个新的监督进程，该进程读取你存储的凭证。如果你使用环境变量（如 `ANTHROPIC_API_KEY`）而不是 `/login` 进行身份验证，请从设置了该变量的 shell 运行下一个命令。

628

629参见[错误参考](/zh-CN/errors#could-not-resolve-authentication-method)了解完整的原因和修复列表。在 v2.1.174 之前，一个闲置的预热工作进程在被分配给调度时可能会出现这个错误，即使你的凭证有效。升级以恢复。

630

602<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">631<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">

603 后台会话无法在 macOS 上读取 Desktop、Documents 或 Downloads632 后台会话无法在 macOS 上读取 Desktop、Documents 或 Downloads

604</h3>633</h3>

amazon-bedrock.md +2 −0

Details

219}219}

220```220```

221 221

222{/* min-version: 2.1.181 */}从 Claude Code v2.1.181 开始，`aws configure export-credentials --format process` 的平面输出也被接受，具有相同的密钥在顶级而不是嵌套在 `Credentials` 下。

223

222`Expiration` 是可选的。{/* min-version: 2.1.176 */}从 Claude Code v2.1.176 开始，当命令返回有效的 ISO 8601 `Expiration` 时，Claude Code 会缓存凭证直到该时间前五分钟。没有它，或在更早的版本上，凭证被缓存一小时。224`Expiration` 是可选的。{/* min-version: 2.1.176 */}从 Claude Code v2.1.176 开始，当命令返回有效的 ISO 8601 `Expiration` 时，Claude Code 会缓存凭证直到该时间前五分钟。没有它，或在更早的版本上，凭证被缓存一小时。

223 225

224<h3 id="3-configure-claude-code">226<h3 id="3-configure-claude-code">

chrome.md +1 −1

Details

198 未检测到扩展程序198 未检测到扩展程序

199</h3>199</h3>

200 200

201如果 Claude Code 的 setup-issues 行列出 `chrome`：201如果 Claude Code 无法检测到 Chrome 扩展程序：

202 202

2031. 验证 Chrome 扩展程序已安装并在 `chrome://extensions` 中启用2031. 验证 Chrome 扩展程序已安装并在 `chrome://extensions` 中启用

2042. 通过运行 `claude --version` 验证 Claude Code 是最新的2042. 通过运行 `claude --version` 验证 Claude Code 是最新的

claude-code-on-the-web.md +6 −3

Details

124 </Step>124 </Step>

125</Steps>125</Steps>

126 126

127<h3 id="link-artifacts-back-to-the-session">127<h3 id="link-output-back-to-the-session">

128 将工件链接回会话128 将输出链接回会话

129</h3>129</h3>

130 130

131每个云会话在 claude.ai 上都有一个成绩单 URL，会话可以从 `CLAUDE_CODE_REMOTE_SESSION_ID` 环境变量读取自己的 ID。使用这个在 PR 正文、提交消息、Slack 帖子或生成的报告中放置可追踪的链接，以便审查者可以打开生成它们的运行。131每个云会话在 claude.ai 上都有一个成绩单 URL，会话可以从 `CLAUDE_CODE_REMOTE_SESSION_ID` 环境变量读取自己的 ID。使用这个在 PR 正文、提交消息、Slack 帖子或生成的报告中放置可追踪的链接，以便审查者可以打开生成它们的运行。

132 132

133该变量的值使用 `cse_` 前缀，而成绩单 URL 路径采用相同的 ID，带有 `session_` 前缀。在构建链接时替换前缀。以下命令打印 URL：133从 v2.1.179 开始，Claude 在网络会话中创建的提交包括一个 `Claude-Session: <url>` git trailer，PR 正文包括会话 URL 在其自己的一行上。{/* min-version: 2.1.182 */}从 v2.1.182 开始，设置[`attribution.sessionUrl`](/zh-CN/settings#attribution-settings)为 `false` 以省略 trailer 和 PR 正文链接。

134

135要在提交或 PR 以外的其他内容中包含会话链接，如 Claude 发布的 Slack 消息或它写入的报告文件，请让 Claude 运行以下命令并使用其输出。该命令将环境变量值中的 `cse_` 前缀转换为成绩单 URL 期望的 `session_` 前缀：

134 136

135```bash theme={null}137```bash theme={null}

136echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"138echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

902* [设置参考](/zh-CN/settings)：所有配置选项904* [设置参考](/zh-CN/settings)：所有配置选项

903* [安全](/zh-CN/security)：隔离保证和数据处理905* [安全](/zh-CN/security)：隔离保证和数据处理

904* [数据使用](/zh-CN/data-usage)：Anthropic 从云会话保留的内容906* [数据使用](/zh-CN/data-usage)：Anthropic 从云会话保留的内容

907* [Claude Tag](https://claude.com/docs/claude-tag/overview)：在 Slack 中由组织管理的 @Claude，运行在相同的云环境中

claude-platform-on-aws.md +3 −1

Details

238}238}

239```239```

240 240

241配置了 `awsAuthRefresh` 后，`/login` 在 **Using 3rd-party platforms** 下显示 **Claude Platform on AWS · refresh credentials** 选项。选择它会运行配置的命令并重新读取您的 AWS 凭证，而无需重启 Claude Code。

242

241**选项 B：工作区 API 密钥**243**选项 B：工作区 API 密钥**

242 244

243工作区 API 密钥是一个长期有效的密钥，当您不想管理联合 AWS 凭证时很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下生成一个，并将其设置为 `ANTHROPIC_AWS_API_KEY`：245工作区 API 密钥是一个长期有效的密钥，当您不想管理联合 AWS 凭证时很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下生成一个，并将其设置为 `ANTHROPIC_AWS_API_KEY`：

251像对待任何其他生产凭证一样对待工作区 API 密钥。[用户设置文件](/zh-CN/settings) `env` 块是一种方便的方式，可以将密钥限定于您的机器，而无需全局导出。253像对待任何其他生产凭证一样对待工作区 API 密钥。[用户设置文件](/zh-CN/settings) `env` 块是一种方便的方式，可以将密钥限定于您的机器，而无需全局导出。

252 254

253<Note>255<Note>

254 `/login` 和 `/logout` 命令不会改变 AWS 上的 Claude Platform 身份验证。身份验证通过您的 AWS 凭证或工作区 API 密钥运行，而不是通过 Claude.ai 订阅。256 `/login` 和 `/logout` 命令不会将您登录到 Claude Platform on AWS 的 Claude.ai 订阅。身份验证通过您的 AWS 凭证或工作区 API 密钥运行。例外是当配置了 `awsAuthRefresh` 时，`/login` 显示的 **refresh credentials** 选项，它会重新读取您的 AWS 凭证，如上所述。

255</Note>257</Note>

256 258

257<h3 id="2-configure-claude-code">259<h3 id="2-configure-claude-code">

cli-reference.md +4 −1

Details

33| `claude daemon stop --any` | 停止后台会话 [supervisor](/zh-CN/agent-view#the-supervisor-process) 及其托管的会话。传递 `--keep-workers` 以保持后台会话运行，以便下一个 supervisor 重新连接到它们。`--any` 确认停止按需 supervisor，这是默认值。使用此命令从 [无响应的 supervisor](/zh-CN/agent-view#agent-view-says-the-background-service-did-not-respond) 恢复 | `claude daemon stop --any --keep-workers` |33| `claude daemon stop --any` | 停止后台会话 [supervisor](/zh-CN/agent-view#the-supervisor-process) 及其托管的会话。传递 `--keep-workers` 以保持后台会话运行，以便下一个 supervisor 重新连接到它们。`--any` 确认停止按需 supervisor，这是默认值。使用此命令从 [无响应的 supervisor](/zh-CN/agent-view#agent-view-says-the-background-service-did-not-respond) 恢复 | `claude daemon stop --any --keep-workers` |

36| `claude mcp login <name>` | {/* min-version: 2.1.186 */}运行配置的 MCP 服务器的 OAuth 流程而不打开交互式 `/mcp` 面板。适用于 HTTP、SSE 和 claude.ai 连接器服务器。在 SSH 上添加 `--no-browser` 以打印授权 URL 而不是打开浏览器，然后在提示处粘贴重定向 URL。需要 Claude Code v2.1.186 或更高版本。请参阅 [从命令行进行身份验证](/zh-CN/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

37| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}清除 MCP 服务器的存储 OAuth 凭据。需要 Claude Code v2.1.186 或更高版本 | `claude mcp logout sentry` |

36| `claude plugin` | 管理 Claude Code [plugins](/zh-CN/plugins)。别名：`claude plugins`。请参阅 [plugin 参考](/zh-CN/plugins-reference#cli-commands-reference) 了解子命令 | `claude plugin install code-review@claude-plugins-official` |38| `claude plugin` | 管理 Claude Code [plugins](/zh-CN/plugins)。别名：`claude plugins`。请参阅 [plugin 参考](/zh-CN/plugins-reference#cli-commands-reference) 了解子命令 | `claude plugin install code-review@claude-plugins-official` |

37| `claude project purge [path]` | 删除项目的所有本地 Claude Code 状态：记录、任务列表、调试日志、文件编辑历史、提示历史行和项目在 `~/.claude.json` 中的条目。省略 `[path]` 以从交互式列表中选择。标志：`--dry-run` 预览，`-y`/`--yes` 跳过确认，`-i`/`--interactive` 确认每一项，`--all` 用于每个项目。请参阅 [清除本地数据](/zh-CN/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |39| `claude project purge [path]` | 删除项目的所有本地 Claude Code 状态：记录、任务列表、调试日志、文件编辑历史、提示历史行和项目在 `~/.claude.json` 中的条目。省略 `[path]` 以从交互式列表中选择。标志：`--dry-run` 预览，`-y`/`--yes` 跳过确认，`-i`/`--interactive` 确认每一项，`--all` 用于每个项目。请参阅 [清除本地数据](/zh-CN/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

38| `claude remote-control` | 启动 [Remote Control](/zh-CN/remote-control) 服务器以从 Claude.ai 或 Claude 应用控制 Claude Code。在服务器模式下运行（无本地交互式会话）。请参阅 [服务器模式标志](/zh-CN/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |40| `claude remote-control` | 启动 [Remote Control](/zh-CN/remote-control) 服务器以从 Claude.ai 或 Claude 应用控制 Claude Code。在服务器模式下运行（无本地交互式会话）。请参阅 [服务器模式标志](/zh-CN/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

60| `--allowedTools`, `--allowed-tools` | 无需提示权限即可执行的工具。请参阅 [权限规则语法](/zh-CN/settings#permission-rule-syntax) 了解模式匹配。要限制哪些工具可用，请改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |62| `--allowedTools`, `--allowed-tools` | 无需提示权限即可执行的工具。请参阅 [权限规则语法](/zh-CN/settings#permission-rule-syntax) 了解模式匹配。要限制哪些工具可用，请改用 `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

65| `--ax-screen-reader` | {/* min-version: 2.1.181 */}渲染屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。强制使用经典渲染器，因此 [`tui`](/zh-CN/settings#available-settings) 设置在会话期间无效。优先于 [`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 和 [`axScreenReader`](/zh-CN/settings#available-settings) 设置。需要 Claude Code v2.1.181 或更高版本 | `claude --ax-screen-reader` |

63| `--bare` | 最小模式：跳过 hooks、skills、plugins、MCP 服务器、自动内存和 CLAUDE.md 的自动发现，以便脚本化调用启动更快。Claude 可以访问 Bash、文件读取和文件编辑工具。设置 [`CLAUDE_CODE_SIMPLE`](/zh-CN/env-vars)。请参阅 [bare mode](/zh-CN/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |66| `--bare` | 最小模式：跳过 hooks、skills、plugins、MCP 服务器、自动内存和 CLAUDE.md 的自动发现，以便脚本化调用启动更快。Claude 可以访问 Bash、文件读取和文件编辑工具。设置 [`CLAUDE_CODE_SIMPLE`](/zh-CN/env-vars)。请参阅 [bare mode](/zh-CN/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

65| `--bg` | 启动会话作为 [后台代理](/zh-CN/agent-view) 并立即返回。打印会话 ID 和管理命令。与 `--exec` 结合以作为后台作业运行 shell 命令而不是 Claude 会话，或与 `--agent` 结合以运行特定的 subagent | `claude --bg "investigate the flaky test"` |68| `--bg` | 启动会话作为 [后台代理](/zh-CN/agent-view) 并立即返回。打印会话 ID 和管理命令。与 `--exec` 结合以作为后台作业运行 shell 命令而不是 Claude 会话，或与 `--agent` 结合以运行特定的 subagent | `claude --bg "investigate the flaky test"` |

117| `--teammate-mode` | 设置 [agent team](/zh-CN/agent-teams) 队友的显示方式：`auto`（默认）、`in-process` 或 `tmux`。覆盖此会话的 [`teammateMode`](/zh-CN/settings#available-settings) 设置。请参阅 [选择显示模式](/zh-CN/agent-teams#choose-a-display-mode) | `claude --teammate-mode in-process` |120| `--teammate-mode` | 设置 [agent team](/zh-CN/agent-teams) 队友的显示方式：`in-process`（默认）、`auto`、`tmux` 或 {/* min-version: 2.1.186 */}}`iterm2`（在 v2.1.186 中添加）。默认值在 v2.1.179 中从 `auto` 更改。覆盖此会话的 [`teammateMode`](/zh-CN/settings#available-settings) 设置。请参阅 [选择显示模式](/zh-CN/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

119| `--tools` | 限制 Claude 可以使用的内置工具。使用 `""` 禁用所有，`"default"` 表示全部，或工具名称如 `"Bash,Edit,Read"`。MCP 工具不受影响；要拒绝这些工具，请改用 `--disallowedTools "mcp__*"`，或传递 `--strict-mcp-config` 而不带 `--mcp-config` 以便不加载 MCP 服务器 | `claude --tools "Bash,Edit,Read"` |122| `--tools` | 限制 Claude 可以使用的内置工具。使用 `""` 禁用所有，`"default"` 表示全部，或工具名称如 `"Bash,Edit,Read"`。MCP 工具不受影响；要拒绝这些工具，请改用 `--disallowedTools "mcp__*"`，或传递 `--strict-mcp-config` 而不带 `--mcp-config` 以便不加载 MCP 服务器 | `claude --tools "Bash,Edit,Read"` |

commands.md +3 −3

Details

24 24

25**并行运行工作。** `/agents` 打开管理器以处理 [子代理](/zh-CN/sub-agents)，Claude 可以将侧面任务委派给这些子代理，`/tasks` 列出当前会话后台运行的内容。`/background` 分离整个会话以继续作为 [后台代理](/zh-CN/agent-view) 运行，并释放您的终端。对于跨越代码库的大型更改，`/batch` 将其分解为独立单元，并在其自己的 [worktrees](/zh-CN/worktrees) 中运行每个单元。请参阅 [并行运行代理](/zh-CN/agents) 以了解这些方法如何相关联。25**并行运行工作。** `/agents` 打开管理器以处理 [子代理](/zh-CN/sub-agents)，Claude 可以将侧面任务委派给这些子代理，`/tasks` 列出当前会话后台运行的内容。`/background` 分离整个会话以继续作为 [后台代理](/zh-CN/agent-view) 运行，并释放您的终端。对于跨越代码库的大型更改，`/batch` 将其分解为独立单元，并在其自己的 [worktrees](/zh-CN/worktrees) 中运行每个单元。请参阅 [并行运行代理](/zh-CN/agents) 以了解这些方法如何相关联。

26 26

27**在您发布之前。** `/diff` 显示更改的内容，`/code-review` 检查差异以查找正确性错误和清理，并可以使用 `--fix` 应用这些发现，`/review` 或 `/security-review` 进行更深入的只读检查。`/code-review ultra` 在云中运行多代理审查。27**在您发布之前。** `/diff` 显示更改的内容，`/code-review` 检查差异以查找正确性错误和清理，并可以使用 `--fix` 应用这些发现，`/review` 运行相同的只读审查在 GitHub pull request 上，`/security-review` 进行更深入的只读检查。`/code-review ultra` 在云中运行多代理审查。

28 28

29**在会话之间。** `/clear` 在保持项目内存的同时开始新任务。`/resume` 和 `/branch` 让您返回或分叉早期的对话。`/teleport` 将网络会话拉入此终端，`/remote-control` 让您从另一台设备继续此本地会话。29**在会话之间。** `/clear` 在保持项目内存的同时开始新任务。`/resume` 和 `/branch` 让您返回或分叉早期的对话。`/teleport` 将网络会话拉入此终端，`/remote-control` 让您从另一台设备继续此本地会话。

30 30

64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/zh-CN/skills#bundled-skills).** 审阅当前差异以查找正确性错误以及重用、简化和效率清理。传递 `--fix` 以将发现应用到您的工作树，传递 `--comment` 以将其作为内联 GitHub PR 评论发布，或传递 `ultra` 以运行深度[云审阅](/zh-CN/ultrareview)。{/* min-version: 2.1.154 */}从 v2.1.154 开始，`/simplify` 运行单独的仅清理审阅，应用修复而不寻找错误。有关工作量级别和目标，请参阅[本地审阅差异](/zh-CN/code-review#review-a-diff-locally) |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/zh-CN/skills#bundled-skills).** 审阅当前差异以查找正确性错误以及重用、简化和效率清理。传递 `--fix` 以将发现应用到您的工作树，传递 `--comment` 以将其作为内联 GitHub PR 评论发布，或传递 `ultra` 以运行深度[云审阅](/zh-CN/ultrareview)。{/* min-version: 2.1.154 */}从 v2.1.154 开始，`/simplify` 运行单独的仅清理审阅，应用修复而不寻找错误。有关工作量级别和目标，请参阅[本地审阅差异](/zh-CN/code-review#review-a-diff-locally) |

65| `/color [color\|default]` | 为当前会话设置提示栏颜色。可用颜色：`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。使用 `default` 重置，或不带参数运行以选择随机颜色。当 [Remote Control](/zh-CN/remote-control) 连接时，颜色同步到 claude.ai/code |65| `/color [color\|default]` | 为当前会话设置提示栏颜色。可用颜色：`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。使用 `default` 重置，或不带参数运行以选择随机颜色。当 [Remote Control](/zh-CN/remote-control) 连接时，颜色同步到 claude.ai/code |

66| `/compact [instructions]` | 通过总结到目前为止的对话来释放上下文。可选择性地传递焦点说明以进行总结。请参阅[压缩如何处理规则、skills 和内存文件](/zh-CN/context-window#what-survives-compaction) |66| `/compact [instructions]` | 通过总结到目前为止的对话来释放上下文。可选择性地传递焦点说明以进行总结。请参阅[压缩如何处理规则、skills 和内存文件](/zh-CN/context-window#what-survives-compaction) |

67| `/config` | 打开[设置](/zh-CN/settings)界面以调整主题、模型、[输出样式](/zh-CN/output-styles)和其他偏好设置。别名：`/settings` |67| `/config [key=value ...]` | 打开[设置](/zh-CN/settings)界面以调整主题、模型、[输出样式](/zh-CN/output-styles)和其他偏好设置。{/* min-version: 2.1.181 */}从 v2.1.181 开始，传递一个或多个 `key=value` 对以直接设置设置而无需打开界面，例如 `/config thinking=false`。{/* min-version: 2.1.182 */}从 v2.1.182 开始，也接受命名的简写键，例如 `/config theme=dark` 或 `/config model=sonnet`。`key=value` 形式也适用于非交互模式（`-p`）和[远程控制](/zh-CN/remote-control)。运行 `/config --help` 以列出每个可设置的键及其选项。别名：`/settings` |

69| `/copy [N]` | 将最后一个助手响应复制到剪贴板。传递数字 `N` 以复制第 N 个最新响应：`/copy 2` 复制倒数第二个。当存在代码块时，显示交互式选择器以选择单个块或完整响应。在选择器中按 `w` 将选择内容写入文件而不是剪贴板，这在 SSH 上很有用 |69| `/copy [N]` | 将最后一个助手响应复制到剪贴板。传递数字 `N` 以复制第 N 个最新响应：`/copy 2` 复制倒数第二个。当存在代码块时，显示交互式选择器以选择单个块或完整响应。在选择器中按 `w` 将选择内容写入文件而不是剪贴板，这在 SSH 上很有用 |

117| `/review [PR]` | 在当前会话中本地审阅 pull request。要进行更深入的基于云的审阅，请参阅 [`/code-review ultra`](/zh-CN/ultrareview) |117| `/review [PR]` | 按编号审阅 GitHub pull request，使用与 `/code-review` 相同的审阅引擎。不带参数时，列出要选择的开放 PR。对于基于云的审阅，请参阅 [`/code-review ultra`](/zh-CN/ultrareview) |

119| `/run` | **[Skill](/zh-CN/skills#bundled-skills).** 启动并驱动您的项目应用以在运行的应用中看到更改工作，而不仅仅是在测试中。请参阅[运行和验证您的应用](/zh-CN/skills#run-and-verify-your-app)。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更高版本 |119| `/run` | **[Skill](/zh-CN/skills#bundled-skills).** 启动并驱动您的项目应用以在运行的应用中看到更改工作，而不仅仅是在测试中。请参阅[运行和验证您的应用](/zh-CN/skills#run-and-verify-your-app)。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更高版本 |

120| `/run-skill-generator` | **[Skill](/zh-CN/skills#bundled-skills).** 通过从干净环境编写每个项目的 [skill](/zh-CN/skills#run-and-verify-your-app)，教 `/run` 和 `/verify` 如何构建、启动和驱动您的项目应用。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更高版本 |120| `/run-skill-generator` | **[Skill](/zh-CN/skills#bundled-skills).** 通过从干净环境编写每个项目的 [skill](/zh-CN/skills#run-and-verify-your-app)，教 `/run` 和 `/verify` 如何构建、启动和驱动您的项目应用。{/* min-version: 2.1.145 */}需要 Claude Code v2.1.145 或更高版本 |

env-vars.md +16 −7

Details

148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 设置为 `1` 以禁用所有内置 [subagent](/zh-CN/sub-agents) 类型，如 Explore 和 Plan。仅适用于非交互模式（`-p` 标志）。对于想要空白状态的 SDK 用户很有用 |148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | 设置为 `1` 以禁用所有内置 [subagent](/zh-CN/sub-agents) 类型，如 Explore 和 Plan。仅适用于非交互模式（`-p` 标志）。对于想要空白状态的 SDK 用户很有用 |

150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 后台 subagents 的停滞超时（以毫秒为单位）。默认 `600000`（10 分钟）。计时器在每个流式进度事件时重置；如果在窗口内没有进度到达，subagent 会被中止，任务被标记为失败，将任何部分结果呈现给父级 |150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 后台 subagents 的停滞超时（以毫秒为单位）。默认 `600000`（10 分钟）。计时器在每个流式进度事件时重置；如果在窗口内没有进度到达，subagent 会被中止，任务被标记为失败，将任何部分结果呈现给父级 |

151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 设置触发自动压缩的上下文容量百分比（1-100）。使用较低的值（如 `50`）可更早进行压缩。此变量仅在 Claude Code 主动压缩时导致更早压缩：当设置 `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 时、在[云会话](/zh-CN/claude-code-on-the-web)中、在[远程控制](/zh-CN/remote-control)会话中，以及在没有[扩展上下文](/zh-CN/model-config#extended-context)的 Sonnet 4.6 和 Opus 4.6 上，默认在 200K 边界处压缩。在其他情况下，例如默认本地会话，当对话达到模型的上下文限制时自动压缩触发。覆盖只能降低阈值，因此高于默认值的值无效。适用于主对话和 subagents |151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 设置触发自动压缩的上下文容量百分比（1-100）。使用较低的值（如 `50`）可更早进行压缩。此变量仅在 Claude Code 主动压缩时导致更早压缩：当设置 `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 时、在[云会话](/zh-CN/claude-code-on-the-web)中、在没有[扩展上下文](/zh-CN/model-config#extended-context)的 Sonnet 4.6 和 Opus 4.6 上，默认在 200K 边界处压缩。在其他情况下，例如本地会话，当对话达到模型的上下文限制时自动压缩触发。覆盖只能降低阈值，因此高于默认值的值无效。适用于主对话和 subagents |

153| `CLAUDE_AX_SCREEN_READER` | 设置为 `1` 以呈现屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。设置为 `0` 以强制关闭屏幕阅读器模式，即使 [`axScreenReader`](/zh-CN/settings#available-settings) 为 `true`。[`--ax-screen-reader`](/zh-CN/cli-reference#cli-flags) 标志优先。需要 Claude Code v2.1.181 或更高版本 |

155| `CLAUDE_CLIENT_PRESENCE_FILE` | 外部工具（如屏幕锁定侦听器）在您解锁屏幕时创建并在您锁定屏幕时删除的文件的路径。文件存在时，Claude Code 跳过[远程控制移动推送通知](/zh-CN/remote-control#mobile-push-notifications)，因此当您主动使用计算机时停止获取推送。文件不存在或不可读时，通知照常发送。Claude Code 每个推送触发事件检查一次文件，而不是轮询它。需要 Claude Code v2.1.181 或更高版本 |

155| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 设置为 `1` 以从使用 `--add-dir` 指定的目录加载内存文件。加载 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 和 `CLAUDE.local.md`。默认情况下，其他目录不加载内存文件 |157| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | 设置为 `1` 以从使用 `--add-dir` 指定的目录加载内存文件。加载 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 和 `CLAUDE.local.md`。默认情况下，其他目录不加载内存文件 |

156| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 设置为 `1` 以在[全屏渲染](/zh-CN/fullscreen)中的每一帧上重新绘制整个屏幕，而不是发送增量更新。如果全屏模式显示陈旧或错位的文本片段，请使用此选项。Claude Code 在 Windows 上的后台会话和[代理视图](/zh-CN/agent-view)中自动启用此选项 |158| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | 设置为 `1` 以在[全屏渲染](/zh-CN/fullscreen)中的每一帧上重新绘制整个屏幕，而不是发送增量更新。如果全屏模式显示陈旧或错位的文本片段，请使用此选项。Claude Code 在 Windows 上的后台会话和[代理视图](/zh-CN/agent-view)中自动启用此选项 |

157| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 设置为 `1` 以在每个请求中发送[努力](/zh-CN/model-config#adjust-effort-level)参数，即使 Claude Code 不将模型 ID 识别为支持努力的。当通过 [LLM 网关](/zh-CN/llm-gateway)或第三方提供商路由时使用，这些提供商在自定义标识符下提供模型。拒绝 API 中努力参数的模型，包括 Claude 3 模型、Sonnet 4.0 和 4.5、Opus 4.0 和 4.1 以及 Haiku 4.5，仍被排除，以便请求不会失败 |159| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | 设置为 `1` 以在每个请求中发送[努力](/zh-CN/model-config#adjust-effort-level)参数，即使 Claude Code 不将模型 ID 识别为支持努力的。当通过 [LLM 网关](/zh-CN/llm-gateway)或第三方提供商路由时使用，这些提供商在自定义标识符下提供模型。拒绝 API 中努力参数的模型，包括 Claude 3 模型、Sonnet 4.0 和 4.5、Opus 4.0 和 4.1 以及 Haiku 4.5，仍被排除，以便请求不会失败 |

161| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 设置为 `0` 以停止 Claude Code 在发布新[工件](/zh-CN/artifacts)时自动打开浏览器。重新发布现有工件不会打开浏览器，无论此设置如何 |

159| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 设置为 `0` 以从系统提示的开头省略归属块（客户端版本和提示指纹）。禁用它会改善通过 [LLM 网关](/zh-CN/llm-gateway)路由时的 prompt caching 命中率。Anthropic API 缓存不受影响 |162| `CLAUDE_CODE_ATTRIBUTION_HEADER` | 设置为 `0` 以从系统提示的开头省略归属块（客户端版本和提示指纹）。禁用它会改善通过 [LLM 网关](/zh-CN/llm-gateway)路由时的 prompt caching 命中率。Anthropic API 缓存不受影响 |

160| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 设置用于自动压缩计算的上下文容量（以令牌为单位）。默认为模型的上下文窗口：标准模型为 200K，或[扩展上下文](/zh-CN/model-config#extended-context)模型为 1M。在 1M 模型上使用较低的值（如 `500000`）可将窗口视为 500K 用于压缩目的。该值上限为模型的实际上下文窗口。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 作为此值的百分比应用。设置此变量会将压缩阈值与状态行的 `used_percentage` 解耦，后者始终使用模型的完整上下文窗口 |163| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | 设置用于自动压缩计算的上下文容量（以令牌为单位）。默认为模型的上下文窗口：标准模型为 200K，或[扩展上下文](/zh-CN/model-config#extended-context)模型为 1M。在 1M 模型上使用较低的值（如 `500000`）可将窗口视为 500K 用于压缩目的。该值上限为模型的实际上下文窗口。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` 作为此值的百分比应用。设置此变量会将压缩阈值与状态行的 `used_percentage` 解耦，后者始终使用模型的完整上下文窗口 |

161| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆盖自动 [IDE 连接](/zh-CN/vs-code)。默认情况下，在支持的 IDE 的集成终端内启动时，Claude Code 会自动连接。设置为 `false` 以防止这种情况。设置为 `true` 以在自动检测失败时强制连接尝试，例如当 tmux 遮挡父终端时。优先于 [`autoConnectIde`](/zh-CN/settings#global-config-settings) 全局配置设置 |164| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 覆盖自动 [IDE 连接](/zh-CN/vs-code)。默认情况下，在支持的 IDE 的集成终端内启动时，Claude Code 会自动连接。设置为 `false` 以防止这种情况。设置为 `true` 以在自动检测失败时强制连接尝试，例如当 tmux 遮挡父终端时。优先于 [`autoConnectIde`](/zh-CN/settings#global-config-settings) 全局配置设置 |

170| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | 在 v2.1.186 中移除，现在是无操作。以前为流式 API 请求的连接、TLS 和响应标头阶段设置单独的超时。使用 `API_TIMEOUT_MS` 获取每个请求的超时 |

167| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆盖调试日志文件路径。尽管名称如此，这是文件路径，而不是目录。需要通过 `--debug`、`/debug` 或 `DEBUG` 环境变量单独启用调试模式：仅设置此变量不会启用日志记录。[`--debug-file`](/zh-CN/cli-reference#cli-flags) 标志同时执行两者。默认为 `~/.claude/debug/<session-id>.txt` |171| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 覆盖调试日志文件路径。尽管名称如此，这是文件路径，而不是目录。需要通过 `--debug`、`/debug` 或 `DEBUG` 环境变量单独启用调试模式：仅设置此变量不会启用日志记录。[`--debug-file`](/zh-CN/cli-reference#cli-flags) 标志同时执行两者。默认为 `~/.claude/debug/<session-id>.txt` |

168| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 写入调试日志文件的最小日志级别。值：`verbose`、`debug`（默认）、`info`、`warn`、`error`。设置为 `verbose` 以包含高容量诊断（如完整状态行命令输出），或提高到 `error` 以减少噪音 |172| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 写入调试日志文件的最小日志级别。值：`verbose`、`debug`（默认）、`info`、`warn`、`error`。设置为 `verbose` 以包含高容量诊断（如完整状态行命令输出），或提高到 `error` 以减少噪音 |

169| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 设置为 `1` 以禁用[1M 上下文窗口](/zh-CN/model-config#extended-context)支持。设置后，1M 模型变体在模型选择器中不可用。对于具有合规要求的企业环境很有用 |173| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | 设置为 `1` 以禁用[1M 上下文窗口](/zh-CN/model-config#extended-context)支持。设置后，1M 模型变体在模型选择器中不可用。对于具有合规要求的企业环境很有用 |

171| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 设置为 `1` 以禁用[顾问工具](/zh-CN/advisor)。`/advisor` 命令和 `--advisor` 标志变为不可用，任何配置的 `advisorModel` 被忽略。需要 Claude Code v2.1.98 或更高版本 |175| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | 设置为 `1` 以禁用[顾问工具](/zh-CN/advisor)。`/advisor` 命令和 `--advisor` 标志变为不可用，任何配置的 `advisorModel` 被忽略。需要 Claude Code v2.1.98 或更高版本 |

172| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 设置为 `1` 以关闭[后台代理和代理视图](/zh-CN/agent-view)：`claude agents`、`--bg`、`/background` 和按需监督员。等同于 [`disableAgentView`](/zh-CN/settings#available-settings) 设置 |176| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | 设置为 `1` 以关闭[后台代理和代理视图](/zh-CN/agent-view)：`claude agents`、`--bg`、`/background` 和按需监督员。等同于 [`disableAgentView`](/zh-CN/settings#available-settings) 设置 |

173| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 设置为 `1` 以禁用[全屏渲染](/zh-CN/fullscreen)并使用经典主屏幕渲染器。对话保持在您的终端的原生滚动条中，因此 `Cmd+f` 和 tmux 复制模式可以正常工作。优先于 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-CN/settings#available-settings) 设置。您也可以使用 `/tui default` 切换。不适用于从[代理视图](/zh-CN/agent-view)打开的后台会话，它们始终使用全屏渲染 |177| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | 设置为 `1` 以禁用[全屏渲染](/zh-CN/fullscreen)并使用经典主屏幕渲染器。对话保持在您的终端的原生滚动条中，因此 `Cmd+f` 和 tmux 复制模式可以正常工作。优先于 `CLAUDE_CODE_NO_FLICKER` 和 [`tui`](/zh-CN/settings#available-settings) 设置。您也可以使用 `/tui default` 切换。不适用于从[代理视图](/zh-CN/agent-view)打开的后台会话，它们始终使用全屏渲染 |

178| `CLAUDE_CODE_DISABLE_ARTIFACT` | 设置为 `1` 以禁用[工件](/zh-CN/artifacts)工具，该工具将会话输出发布为 claude.ai 上的私有网页。等同于 [`disableArtifact`](/zh-CN/settings#available-settings) 设置 |

175| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 设置为 `1` 以禁用[自动内存](/zh-CN/memory#auto-memory)。设置为 `0` 以在 `--bare` 模式或 [`autoMemoryEnabled: false`](/zh-CN/settings#available-settings) 会禁用它时强制启用自动内存。禁用后，Claude 不会创建或加载自动内存文件 |180| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | 设置为 `1` 以禁用[自动内存](/zh-CN/memory#auto-memory)。设置为 `0` 以在 `--bare` 模式或 [`autoMemoryEnabled: false`](/zh-CN/settings#available-settings) 会禁用它时强制启用自动内存。禁用后，Claude 不会创建或加载自动内存文件 |

176| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 设置为 `1` 以禁用所有后台任务功能，包括 Bash 和 subagent 工具上的 `run_in_background` 参数、自动后台处理和 Ctrl+B 快捷键 |181| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | 设置为 `1` 以禁用所有后台任务功能，包括 Bash 和 subagent 工具上的 `run_in_background` 参数、自动后台处理和 Ctrl+B 快捷键 |

210| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 设置为 `1` 以强制转录持久化、提示历史和 `claude agents` 注册，即使此 `claude` 是从另一个 Claude Code 会话内启动的。当继承的 `CLAUDE_CODE_CHILD_SESSION` 值（例如来自 Claude Code 的 Bash 工具首次启动的 tmux 服务器）导致真正的顶级会话被误分类为嵌套时使用。也在 v2.1.169 及更早版本上受尊重；对 v2.1.170 和 v2.1.171 无效，其中它覆盖的嵌套会话检测被移除 |215| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 设置为 `1` 以强制转录持久化、提示历史和 `claude agents` 注册，即使此 `claude` 是从另一个 Claude Code 会话内启动的。当继承的 `CLAUDE_CODE_CHILD_SESSION` 值（例如来自 Claude Code 的 Bash 工具首次启动的 tmux 服务器）导致真正的顶级会话被误分类为嵌套时使用。从 v2.1.178 开始，Claude Code 自动检测 tmux 情况并忽略继承的标记，因此 tmux 不再需要此变量。也在 v2.1.169 及更早版本上受尊重；对 v2.1.170 和 v2.1.171 无效，其中它覆盖的嵌套会话检测被移除 |

216| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | 设置为 `1` 以在您的终端支持但未自动检测到时强制对 `~~text~~` 进行删除线渲染，例如通过 SSH 而不转发 `TERM_PROGRAM`。没有这个，未检测到的终端显示文字 `~~` 标记而不是将文本呈现为删除线。需要 Claude Code v2.1.186 或更高版本 |

211| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 设置为 `1` 以在您的终端支持但未自动检测到时强制启用 DEC 私有模式 2026 [同步输出](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)。对于实现 BSU/ESU 但不回复能力探针的模拟器（如 Emacs `eat`）很有用。在 tmux 下无效 |217| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 设置为 `1` 以在您的终端支持但未自动检测到时强制启用 DEC 私有模式 2026 [同步输出](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)。对于实现 BSU/ESU 但不回复能力探针的模拟器（如 Emacs `eat`）很有用。在 tmux 下无效 |

212| `CLAUDE_CODE_FORK_SUBAGENT` | 设置为 `1` 以使[分叉 subagents](/zh-CN/sub-agents#fork-the-current-conversation)成为模型的默认值，或 `0` 以禁用它们，覆盖任何服务器端推出。启用后，Claude 生成一个分叉，一个继承完整对话上下文而不是从头开始的 subagent，每当它会以其他方式使用通用 subagent 时，所有 subagent 生成在后台运行。显式 [`/fork`](/zh-CN/commands) 命令无需此变量即可工作。在交互模式和通过 SDK 或 `claude -p` 中工作 |218| `CLAUDE_CODE_FORK_SUBAGENT` | 设置为 `1` 以让 Claude 生成[分叉 subagents](/zh-CN/sub-agents#fork-the-current-conversation)，或 `0` 以禁用它们，覆盖任何服务器端推出。启用后，Claude 可以请求 `fork` subagent 类型以生成分叉，一个继承完整对话上下文而不是从头开始的 subagent。没有 subagent 类型的生成仍使用通用 subagent，所有 subagent 生成在后台运行。显式 [`/fork`](/zh-CN/commands) 命令无需此变量即可工作。在交互模式和通过 SDK 或 `claude -p` 中工作 |

213| `CLAUDE_CODE_GIT_BASH_PATH` | 仅限 Windows：Git Bash 可执行文件 (`bash.exe`) 的路径。当 Git Bash 已安装但不在您的 PATH 中时使用。请参阅 [Windows 设置](/zh-CN/setup#set-up-on-windows) |219| `CLAUDE_CODE_GIT_BASH_PATH` | 仅限 Windows：Git Bash 可执行文件 (`bash.exe`) 的路径。当 Git Bash 已安装但不在您的 PATH 中时使用。请参阅 [Windows 设置](/zh-CN/setup#set-up-on-windows) |

214| `CLAUDE_CODE_GLOB_HIDDEN` | 设置为 `false` 以在 Claude 调用 [Glob 工具](/zh-CN/tools-reference#glob-tool-behavior)时从结果中排除点文件。默认包含。不影响 `@` 文件自动完成、`ls`、Grep 或 Read |220| `CLAUDE_CODE_GLOB_HIDDEN` | 设置为 `false` 以在 Claude 调用 [Glob 工具](/zh-CN/tools-reference#glob-tool-behavior)时从结果中排除点文件。默认包含。不影响 `@` 文件自动完成、`ls`、Grep 或 Read |

215| `CLAUDE_CODE_GLOB_NO_IGNORE` | 设置为 `false` 以使 [Glob 工具](/zh-CN/tools-reference#glob-tool-behavior)尊重 `.gitignore` 模式。默认情况下，Glob 返回所有匹配的文件，包括被 gitignore 的文件。不影响 `@` 文件自动完成，它有自己的 [`respectGitignore` 设置](/zh-CN/settings#available-settings) |221| `CLAUDE_CODE_GLOB_NO_IGNORE` | 设置为 `false` 以使 [Glob 工具](/zh-CN/tools-reference#glob-tool-behavior)尊重 `.gitignore` 模式。默认情况下，Glob 返回所有匹配的文件，包括被 gitignore 的文件。不影响 `@` 文件自动完成，它有自己的 [`respectGitignore` 设置](/zh-CN/settings#available-settings) |

221| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆盖 Claude Code 为活动模型假设的上下文窗口大小。仅在同时设置 `DISABLE_COMPACT` 时生效。当通过 `ANTHROPIC_BASE_URL` 路由到上下文窗口与其名称的内置大小不匹配的模型时使用 |227| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | 覆盖 Claude Code 为活动模型假设的上下文窗口大小。仅在同时设置 `DISABLE_COMPACT` 时生效。当通过 `ANTHROPIC_BASE_URL` 路由到上下文窗口与其名称的内置大小不匹配的模型时使用 |

222| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 设置大多数请求的最大输出令牌数。默认值和上限因模型而异；请参阅[最大输出令牌](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值会减少在[自动压缩](/zh-CN/costs#reduce-token-usage)触发之前可用的有效上下文窗口。 |228| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 设置大多数请求的最大输出令牌数。默认值和上限因模型而异；请参阅[最大输出令牌](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)。增加此值会减少在[自动压缩](/zh-CN/costs#reduce-token-usage)触发之前可用的有效上下文窗口。 |

225| `CLAUDE_CODE_MAX_TURNS` | 当未传递显式限制时，限制代理转换的数量。等同于传递 [`--max-turns`](/zh-CN/cli-reference#cli-flags)，当两者都设置时优先。不是正整数的值在启动时被拒绝并显示错误，而不是被视为无限制 |231| `CLAUDE_CODE_MAX_TURNS` | 当未传递显式限制时，限制代理转换的数量。等同于传递 [`--max-turns`](/zh-CN/cli-reference#cli-flags)，当两者都设置时优先。不是正整数的值在启动时被拒绝并显示错误，而不是被视为无限制 |

231| `CLAUDE_CODE_OAUTH_SCOPES` | 刷新令牌颁发时使用的空格分隔的 OAuth 作用域，例如 `"user:profile user:inference user:sessions:claude_code"`。设置 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 时为必需 |237| `CLAUDE_CODE_OAUTH_SCOPES` | 刷新令牌颁发时使用的空格分隔的 OAuth 作用域，例如 `"user:profile user:inference user:sessions:claude_code"`。设置 `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` 时为必需 |

232| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 身份验证的 OAuth 访问令牌。`/login` 对于 SDK 和自动化环境的替代方案。优先于钥匙链存储的凭证。使用 [`claude setup-token`](/zh-CN/authentication#generate-a-long-lived-token) 生成一个 |238| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 身份验证的 OAuth 访问令牌。`/login` 对于 SDK 和自动化环境的替代方案。优先于钥匙链存储的凭证。使用 [`claude setup-token`](/zh-CN/authentication#generate-a-long-lived-token) 生成一个 |

233| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 在 v2.1.160 中移除，现在是无操作。以前将[快速模式](/zh-CN/fast-mode)固定到 Claude Opus 4.6 而不是当前默认值。要在 Opus 4.6 上运行快速模式直到它被弃用，请先使用 `/model` 选择模型，然后 `/fast on` |239| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | 在 v2.1.160 中移除，现在是无操作。以前将[快速模式](/zh-CN/fast-mode)固定到 Claude Opus 4.6 而不是当前默认值。要在 Opus 4.6 上运行快速模式直到它被弃用，请先使用 `/model` 选择模型，然后 `/fast on` |

240| `CLAUDE_CODE_OTEL_DIAG_STDERR` | 设置为 `1` 以将 OpenTelemetry 导出器诊断错误写入 stderr。默认情况下，这些错误仅在 `--debug` 时出现，因此配置错误的导出器（如 Prometheus 端口冲突）会以其他方式无声失败。需要 Claude Code v2.1.179 或更高版本。请参阅[监控](/zh-CN/monitoring-usage) |

234| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待处理 OpenTelemetry spans 的超时时间（以毫秒为单位）（默认值：5000）。请参阅[监控](/zh-CN/monitoring-usage) |241| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 刷新待处理 OpenTelemetry spans 的超时时间（以毫秒为单位）（默认值：5000）。请参阅[监控](/zh-CN/monitoring-usage) |

235| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新动态 OpenTelemetry 标头的间隔（以毫秒为单位）（默认值：1740000 / 29 分钟）。请参阅[动态标头](/zh-CN/monitoring-usage#dynamic-headers) |242| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 刷新动态 OpenTelemetry 标头的间隔（以毫秒为单位）（默认值：1740000 / 29 分钟）。请参阅[动态标头](/zh-CN/monitoring-usage#dynamic-headers) |

236| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 导出器在关闭时完成的超时时间（以毫秒为单位）（默认值：2000）。如果在退出时丢弃指标，请增加此值。请参阅[监控](/zh-CN/monitoring-usage) |243| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry 导出器在关闭时完成的超时时间（以毫秒为单位）（默认值：2000）。如果在退出时丢弃指标，请增加此值。请参阅[监控](/zh-CN/monitoring-usage) |

242| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 设置为 `1` 以通过 HTTPS 而不是 SSH 克隆 GitHub `owner/repo` 插件源。在 CI 运行器、容器或任何没有为 `github.com` 配置 SSH 密钥的环境中很有用 |249| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | 设置为 `1` 以通过 HTTPS 而不是 SSH 克隆 GitHub `owner/repo` 插件源。在 CI 运行器、容器或任何没有为 `github.com` 配置 SSH 密钥的环境中很有用 |

243| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一个或多个只读插件种子目录的路径，在 Unix 上用 `:` 分隔，在 Windows 上用 `;` 分隔。使用此选项可将预填充的插件目录捆绑到容器镜像中。Claude Code 在启动时从这些目录注册市场，并使用预缓存的插件而无需重新克隆。请参阅[为容器预填充插件](/zh-CN/plugin-marketplaces#pre-populate-plugins-for-containers) |250| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 一个或多个只读插件种子目录的路径，在 Unix 上用 `:` 分隔，在 Windows 上用 `;` 分隔。使用此选项可将预填充的插件目录捆绑到容器镜像中。Claude Code 在启动时从这些目录注册市场，并使用预缓存的插件而无需重新克隆。请参阅[为容器预填充插件](/zh-CN/plugin-marketplaces#pre-populate-plugins-for-containers) |

244| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 设置为 `1` 以停止 Claude Code 在生成 PowerShell 以进行工具调用、hooks 和状态行命令时传递 `-ExecutionPolicy Bypass`，并改为尊重机器的有效执行策略。默认情况下，Claude Code 在进程范围内绕过执行策略，以便 `.ps1` 脚本和模块导入在默认受限的 Windows 安装上工作。无论此设置如何，进程范围的绕过永远不会覆盖组策略 `MachinePolicy` 或 `UserPolicy` |251| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 设置为 `1` 以停止 Claude Code 在生成 PowerShell 以进行工具调用、hooks 和状态行命令时传递 `-ExecutionPolicy Bypass`，并改为尊重机器的有效执行策略。默认情况下，Claude Code 在进程范围内绕过执行策略，以便 `.ps1` 脚本和模块导入在默认受限的 Windows 安装上工作。无论此设置如何，进程范围的绕过永远不会覆盖组策略 `MachinePolicy` 或 `UserPolicy` |

252| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非交互模式](/zh-CN/headless#background-tasks-at-exit)中带有 `-p` 标志的最大时间（以毫秒为单位），在最后一个转换后等待其结果是输出一部分的后台 subagents 和工作流。默认值：`600000`，或 10 分钟。超过上限时，剩余的后台任务被终止，进程退出。设置为 `0` 以无限期等待。此上限与适用于纯后台 shells 的 5 秒宽限期分开 |

245| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | 设置为 `1` 以在 `ANTHROPIC_BASE_URL` 指向自定义代理时传播 W3C 跟踪上下文。传播涵盖模型和 HTTP MCP 请求上的 `traceparent` 标头以及 Bash、PowerShell 和 hook 子进程的 `TRACEPARENT` 环境变量。默认情况下，仅当直接连接到 Anthropic API 时才启用传播。在 v2.1.152 中添加。请参阅[跟踪（测试版）](/zh-CN/monitoring-usage#traces-beta) |253| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | 设置为 `1` 以在 `ANTHROPIC_BASE_URL` 指向自定义代理时传播 W3C 跟踪上下文。传播涵盖模型和 HTTP MCP 请求上的 `traceparent` 标头以及 Bash、PowerShell 和 hook 子进程的 `TRACEPARENT` 环境变量。默认情况下，仅当直接连接到 Anthropic API 时才启用传播。在 v2.1.152 中添加。请参阅[跟踪（测试版）](/zh-CN/monitoring-usage#traces-beta) |

246| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 的主机平台设置，并代表其管理模型提供商路由。设置后，提供商选择、端点和身份验证变量（如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`）在设置文件中被忽略，以便用户设置无法覆盖主机的路由。Bedrock、Vertex 和 Foundry 的自动遥测选择退出也被跳过，因此遥测遵循标准 `DISABLE_TELEMETRY` 选择退出。请参阅[按 API 提供商的默认行为](/zh-CN/data-usage#default-behaviors-by-api-provider) |254| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | 由嵌入 Claude Code 的主机平台设置，并代表其管理模型提供商路由。设置后，提供商选择、端点和身份验证变量（如 `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_API_KEY`）在设置文件中被忽略，以便用户设置无法覆盖主机的路由。Bedrock、Vertex 和 Foundry 的自动遥测选择退出也被跳过，因此遥测遵循标准 `DISABLE_TELEMETRY` 选择退出。请参阅[按 API 提供商的默认行为](/zh-CN/data-usage#default-behaviors-by-api-provider) |

249| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在[云会话](/zh-CN/claude-code-on-the-web)中自动设置为当前会话的 ID。读取此值以构造返回会话转录的链接。请参阅[将工件链接回会话](/zh-CN/claude-code-on-the-web#link-artifacts-back-to-the-session) |257| `CLAUDE_CODE_REMOTE_SESSION_ID` | 在[云会话](/zh-CN/claude-code-on-the-web)中自动设置为当前会话的 ID。读取此值以构造返回会话转录的链接。请参阅[将输出链接回会话](/zh-CN/claude-code-on-the-web#link-output-back-to-the-session) |

251| `CLAUDE_CODE_RESUME_PROMPT` | 覆盖在恢复在中途结束的会话时注入的继续消息。默认为 `Continue from where you left off.`。长时间运行的代理的生成脚本可以将其设置为更具指导性的启动消息。空字符串使用默认值 |259| `CLAUDE_CODE_RESUME_PROMPT` | 覆盖在恢复在中途结束的会话时注入的继续消息。默认为 `Continue from where you left off.`。长时间运行的代理的生成脚本可以将其设置为更具指导性的启动消息。空字符串使用默认值 |

260| `CLAUDE_CODE_RETRY_WATCHDOG` | 设置为 `1` 用于无人值守会话，如评估工具、CI 作业或远程工作人员。无限期重试 `429` 和 `529` 容量错误，而不是在 `CLAUDE_CODE_MAX_RETRIES` 尝试后失败。监视程序在尝试之间退避最多 5 分钟，或直到限制在响应携带速率限制重置时间时重置，因此命中使用限制的会话会等待剩余窗口。需要 Claude Code v2.1.186 或更高版本 |

252| `CLAUDE_CODE_SAFE_MODE` | 设置为 `1` 以在安全模式下启动：CLAUDE.md、skills、plugins、hooks、MCP 服务器、自定义命令和代理、输出样式、工作流、自定义主题、自定义快捷键、状态行和文件建议命令、LSP 服务器和自动内存不加载，用于排除故障的破损配置。托管设置策略仍然适用，包括策略配置的 hooks、状态行和文件建议命令；托管插件、托管 skills、托管 CLAUDE.md 和策略配置的 MCP 服务器不适用。等同于传递 [`--safe-mode`](/zh-CN/cli-reference#cli-flags)。直接生成的子进程继承该变量 |261| `CLAUDE_CODE_SAFE_MODE` | 设置为 `1` 以在安全模式下启动：CLAUDE.md、skills、plugins、hooks、MCP 服务器、自定义命令和代理、输出样式、工作流、自定义主题、自定义快捷键、状态行和文件建议命令、LSP 服务器和自动内存不加载，用于排除故障的破损配置。托管设置策略仍然适用，包括策略配置的 hooks、状态行和文件建议命令；托管插件、托管 skills、托管 CLAUDE.md 和策略配置的 MCP 服务器不适用。等同于传递 [`--safe-mode`](/zh-CN/cli-reference#cli-flags)。直接生成的子进程继承该变量 |

253| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 对象，当设置 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 时限制特定脚本在每个会话中可以调用的次数。键是与命令文本匹配的子字符串；值是整数调用限制。例如，`{"deploy.sh": 2}` 允许 `deploy.sh` 最多被调用两次。匹配是基于子字符串的，所以 shell 扩展技巧如 `./scripts/deploy.sh $(evil)` 仍然计入上限。通过 `xargs` 或 `find -exec` 的运行时扇出不被检测；这是一个深度防御控制 |262| `CLAUDE_CODE_SCRIPT_CAPS` | JSON 对象，当设置 `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` 时限制特定脚本在每个会话中可以调用的次数。键是与命令文本匹配的子字符串；值是整数调用限制。例如，`{"deploy.sh": 2}` 允许 `deploy.sh` 最多被调用两次。匹配是基于子字符串的，所以 shell 扩展技巧如 `./scripts/deploy.sh $(evil)` 仍然计入上限。通过 `xargs` 或 `find -exec` 的运行时扇出不被检测；这是一个深度防御控制 |

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

316| `DISABLE_UPDATES` | 设置为 `1` 以阻止所有更新，包括手动 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更严格。当通过您自己的渠道分发 Claude Code 且用户不应自行更新时使用 |325| `DISABLE_UPDATES` | 设置为 `1` 以阻止所有更新，包括手动 `claude update` 和 `claude install`。比 `DISABLE_AUTOUPDATER` 更严格。当通过您自己的渠道分发 Claude Code 且用户不应自行更新时使用 |

319| `ENABLE_CLAUDEAI_MCP_SERVERS` | 设置为 `false` 以禁用 Claude Code 中的 [claude.ai MCP servers](/zh-CN/mcp#use-mcp-servers-from-claude-ai)。对于已登录的用户默认启用 |328| `ENABLE_CLAUDEAI_MCP_SERVERS` | 设置为 `false` 以禁用 Claude Code 中的 [claude.ai MCP servers](/zh-CN/mcp#use-mcp-servers-from-claude-ai)。对于已登录的用户默认启用。要按项目或按组织禁用，请改用设置中的 [`disableClaudeAiConnectors`](/zh-CN/settings#available-settings) |

320| `ENABLE_PROMPT_CACHING_1H` | 设置为 `1` 以请求 1 小时的 prompt cache TTL 而不是默认的 5 分钟。适用于 API 密钥、[Bedrock](/zh-CN/amazon-bedrock)、[Vertex](/zh-CN/google-vertex-ai)、[Foundry](/zh-CN/microsoft-foundry) 和 [Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 用户。订阅用户自动获得 1 小时 TTL。1 小时缓存写入按更高费率计费 |329| `ENABLE_PROMPT_CACHING_1H` | 设置为 `1` 以请求 1 小时的 prompt cache TTL 而不是默认的 5 分钟。适用于 API 密钥、[Bedrock](/zh-CN/amazon-bedrock)、[Vertex](/zh-CN/google-vertex-ai)、[Foundry](/zh-CN/microsoft-foundry) 和 [Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 用户。订阅用户自动获得 1 小时 TTL。1 小时缓存写入按更高费率计费 |

322| `ENABLE_TOOL_SEARCH` | 控制 [MCP 工具搜索](/zh-CN/mcp#scale-with-mcp-tool-search)。未设置：默认延迟所有 MCP 工具，但在 Vertex AI 上或当 `ANTHROPIC_BASE_URL` 指向非第一方主机时提前加载。值：`true`（始终延迟并发送 beta 标头，在 Vertex AI 上支持 Sonnet 4.5 及更高版本或 Opus 4.5 及更高版本的请求失败，或在不支持 `tool_reference` 的代理上）、`auto`（阈值模式：如果工具适合在上下文的 10% 内则提前加载）、`auto:N`（自定义阈值，例如 `auto:5` 表示 5%）、`false`（提前加载所有） |331| `ENABLE_TOOL_SEARCH` | 控制 [MCP 工具搜索](/zh-CN/mcp#scale-with-mcp-tool-search)。未设置：默认延迟所有 MCP 工具，但在 Vertex AI 上或当 `ANTHROPIC_BASE_URL` 指向非第一方主机时提前加载。值：`true`（始终延迟并发送 beta 标头，在 Vertex AI 上支持 Sonnet 4.5 及更高版本或 Opus 4.5 及更高版本的请求失败，或在不支持 `tool_reference` 的代理上）、`auto`（阈值模式：如果工具适合在上下文的 10% 内则提前加载）、`auto:N`（自定义阈值，例如 `auto:5` 表示 5%）、`false`（提前加载所有） |

341| `OTEL_LOG_RAW_API_BODIES` | 设置为 `1` 以将完整的 Anthropic Messages API 请求和响应 JSON 作为 `api_request_body` / `api_response_body` 日志事件发出，截断为 60 KB，或 `file:<dir>` 以将未截断的主体写入磁盘并发出 `body_ref` 路径。默认禁用；主体包括整个对话历史。请参阅[监控](/zh-CN/monitoring-usage#api-request-body-event) |350| `OTEL_LOG_RAW_API_BODIES` | 设置为 `1` 以将完整的 Anthropic Messages API 请求和响应 JSON 作为 `api_request_body` / `api_response_body` 日志事件发出，截断为 60 KB，或 `file:<dir>` 以将未截断的主体写入磁盘并发出 `body_ref` 路径。默认禁用；主体包括整个对话历史。请参阅[监控](/zh-CN/monitoring-usage#api-request-body-event) |

343| `OTEL_LOG_TOOL_DETAILS` | 设置为 `1` 以在 OpenTelemetry 跟踪和日志中包含工具输入参数、MCP 服务器名称、工具失败时的原始错误字符串和其他工具详情。默认禁用以保护 PII。请参阅[监控](/zh-CN/monitoring-usage) |352| `OTEL_LOG_TOOL_DETAILS` | 设置为 `1` 以在 OpenTelemetry 跟踪和日志中包含工具输入参数、MCP 服务器名称、工具失败时的原始错误字符串、`api_refusal` 事件上的拒绝 `category` 和其他工具详情。默认禁用以保护 PII。请参阅[监控](/zh-CN/monitoring-usage) |

errors.md +7 −3

Details

43| `OAuth token revoked` / `OAuth token has expired` | [身份验证](#oauth-token-revoked-or-expired) |43| `OAuth token revoked` / `OAuth token has expired` | [身份验证](#oauth-token-revoked-or-expired) |

44| `does not meet scope requirement user:profile` | [身份验证](#oauth-scope-requirement) |44| `does not meet scope requirement user:profile` | [身份验证](#oauth-scope-requirement) |

45| `Unable to connect to API` | [网络](#unable-to-connect-to-api) |45| `Unable to connect to API` | [网络](#unable-to-connect-to-api) |

46| `Waiting for API response · will retry in` | [自动重试](#automatic-retries)，或如果问题持续，则为[网络](#unable-to-connect-to-api) |

46| `SSL certificate verification failed` | [网络](#ssl-certificate-errors) |47| `SSL certificate verification failed` | [网络](#ssl-certificate-errors) |

47| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [网络](#host-not-allowed-in-a-cloud-session) |48| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [网络](#host-not-allowed-in-a-cloud-session) |

48| `Prompt is too long` | [请求错误](#prompt-is-too-long) |49| `Prompt is too long` | [请求错误](#prompt-is-too-long) |

66 67

67Claude Code 在向您显示错误之前会重试瞬时故障。服务器错误、过载响应、请求超时、临时 429 限流和断开的连接都会以指数退避方式重试最多 10 次。重试时，微调器显示 `Retrying in Ns · attempt x/y` 倒计时。68Claude Code 在向您显示错误之前会重试瞬时故障。服务器错误、过载响应、请求超时、临时 429 限流和断开的连接都会以指数退避方式重试最多 10 次。重试时，微调器显示 `Retrying in Ns · attempt x/y` 倒计时。

68 69

~~69当您看到本页上的错误之一时，这些重试已经用尽。您可以使用两个环境变量调整行为：~~70{/* min-version: 2.1.185 */}如果在请求仍然待处理时，响应流上 20 秒内没有数据到达，微调器会显示 `Waiting for API response · will retry in … · check your network`，然后再进行任何重试。请求尚未失败：倒计时运行到 Claude Code 中止停滞连接并重试的点，因此一旦数据恢复或重试成功，横幅就会自动清除。从 v2.1.185 开始，阈值为 20 秒；早期版本在 10 秒后显示横幅，措辞不同。如果它在每次尝试时都重新出现，请将其视为[网络问题](#unable-to-connect-to-api)。

72当您看到本页上的错误之一时，这些重试已经用尽。您可以使用这些环境变量调整行为：

70 73

71| 变量 | 默认值 | 效果 |74| 变量 | 默认值 | 效果 |

~~72| :------------------------------------------- | :----- | :-------------------------------- |~~75| :---------------------------------------------- | :----- | :-------------------------------------------------------------------------------------- |

~~73| [`CLAUDE_CODE_MAX_RETRIES`](/zh-CN/env-vars) | 10 | 重试次数。降低它以在脚本中更快地显示故障；提高它以等待更长的事件。 |~~76| [`CLAUDE_CODE_MAX_RETRIES`](/zh-CN/env-vars) | 10 | 重试次数。{/* min-version: 2.1.186 */}从 v2.1.186 开始上限为 15。降低它以在脚本中更快地显示故障。 |

77| [`CLAUDE_CODE_RETRY_WATCHDOG`](/zh-CN/env-vars) | 未设置 | 在 CI 作业等无人值守会话中设置为 `1`，以无限期重试 `429` 和 `529` 容量错误，而不是在 `CLAUDE_CODE_MAX_RETRIES` 次尝试后失败。 |

74| [`API_TIMEOUT_MS`](/zh-CN/env-vars) | 600000 | 每个请求的超时时间（毫秒）。为慢速网络或代理提高它。 |78| [`API_TIMEOUT_MS`](/zh-CN/env-vars) | 600000 | 每个请求的超时时间（毫秒）。为慢速网络或代理提高它。 |

75 79

76<h2 id="server-errors">80<h2 id="server-errors">

features-overview.md +1 −0

Details

47| **MCP** | 连接到外部服务 | 外部数据或操作 | 查询您的数据库、发布到 Slack、控制浏览器 |47| **MCP** | 连接到外部服务 | 外部数据或操作 | 查询您的数据库、发布到 Slack、控制浏览器 |

49 50

50**[Plugins](/zh-CN/plugins)** 是打包层。Plugin 将 skills、hooks、subagents 和 MCP servers 捆绑到单个可安装单元中。Plugin skills 是命名空间的（如 `/my-plugin:review`），因此多个 plugins 可以共存。当您想在多个存储库中重用相同的设置或通过 **[marketplace](/zh-CN/plugin-marketplaces)** 分发给他人时，使用 plugins。51**[Plugins](/zh-CN/plugins)** 是打包层。Plugin 将 skills、hooks、subagents 和 MCP servers 捆绑到单个可安装单元中。Plugin skills 是命名空间的（如 `/my-plugin:review`），因此多个 plugins 可以共存。当您想在多个存储库中重用相同的设置或通过 **[marketplace](/zh-CN/plugin-marketplaces)** 分发给他人时，使用 plugins。

51 52

fullscreen.md +2 −2

Details

44| :--------------------- | :-------------------------------------- | :--------------------------------------------- |44| :--------------------- | :-------------------------------------- | :--------------------------------------------- |

48 48

49如果鼠标捕获干扰您的工作流程，您可以[关闭它](#keep-native-text-selection)，同时保持无闪烁渲染。49如果鼠标捕获干扰您的工作流程，您可以[关闭它](#keep-native-text-selection)，同时保持无闪烁渲染。

50 50

57* **在提示输入框中点击**以在您正在输入的文本中的任何位置放置光标。57* **在提示输入框中点击**以在您正在输入的文本中的任何位置放置光标。

58* **点击 `/` 命令或 `@` 文件列表中的建议**以接受它。悬停会突出显示光标下的行。58* **点击 `/` 命令或 `@` 文件列表中的建议**以接受它。悬停会突出显示光标下的行。

59* **点击折叠的工具结果**以展开它并查看完整输出。再次点击以折叠。工具调用及其结果一起展开。只有有更多内容要显示的消息才可点击。59* **点击折叠的工具结果**以展开它并查看完整输出。再次点击以折叠。工具调用及其结果一起展开。只有有更多内容要显示的消息才可点击。

60* **点击 URL 或文件路径**以打开它。工具输出中的文件路径，如 Edit 或 Write 后打印的路径，在您的默认应用程序中打开。纯 `http://` 和 `https://` URL 在您的浏览器中打开。在大多数终端中，这替代了原生的 `Cmd` 点击或 `Ctrl` 点击，鼠标捕获会拦截这些。在 VS Code 集成终端和类似的基于 xterm.js 的终端中，继续使用 `Cmd` 点击。Claude Code 在那里遵从终端自己的链接处理程序，以避免打开链接两次。60* **在 macOS 上按住 `Cmd`，或在 Linux 和 Windows 上按住 `Ctrl`，然后点击 URL 或文件路径**以打开它。工具输出中的文件路径，如 Edit 或 Write 后打印的路径，在您的默认应用程序中打开。纯 `http://` 和 `https://` URL 在您的浏览器中打开。{/* min-version: 2.1.181 */}从 v2.1.181 开始，不按住 `Cmd` 或 `Ctrl` 的纯点击不再打开链接，与原生终端行为相匹配。在 VS Code 集成终端和类似的基于 xterm.js 的终端中，Claude Code 遵从终端自己的链接处理程序，该处理程序使用相同的手势。

61* **点击并拖动**以在对话中的任何位置选择文本。双击选择一个单词，匹配 iTerm2 的单词边界，以便文件路径作为一个单位选择。三击选择该行。61* **点击并拖动**以在对话中的任何位置选择文本。双击选择一个单词，匹配 iTerm2 的单词边界，以便文件路径作为一个单位选择。三击选择该行。

62* **用鼠标滚轮滚动**以在对话中移动。62* **用鼠标滚轮滚动**以在对话中移动。

63 63

glossary.md +8 −0

Details

44 44

45了解更多：[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)45了解更多：[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)

46 46

47<h3 id="artifact">

48 Artifact

49</h3>

51Claude Code 从您的会话发布到 claude.ai 上私有 URL 的实时交互式网页，因此您可以直观地查看输出或在您的组织内共享，而不是阅读终端文本。当会话重新发布时，页面会就地更新。您从 Claude Code 创建的 Artifacts 出现在与 claude.ai 对话中创建的 artifacts 相同的库中，但它们的共享仅限于您的组织，无法公开。

53了解更多：[将会话输出共享为 artifacts](/zh-CN/artifacts)

47<h3 id="auto-memory">55<h3 id="auto-memory">

48 Auto memory56 Auto memory

49</h3>57</h3>

headless.md +3 −1

Details

68 68

69如果 Claude 在 `claude -p` 运行期间启动 [后台 Bash 任务](/zh-CN/tools-reference#bash-tool-behavior)，例如开发服务器或监视构建，该任务将在 Claude 返回其最终结果并关闭 stdin 后约五秒钟被终止。宽限期允许在结果之后立即完成的任务仍然能够传递其输出。在 v2.1.163 之前，永不退出的后台进程会无限期地保持 `claude -p` 调用打开。69如果 Claude 在 `claude -p` 运行期间启动 [后台 Bash 任务](/zh-CN/tools-reference#bash-tool-behavior)，例如开发服务器或监视构建，该任务将在 Claude 返回其最终结果并关闭 stdin 后约五秒钟被终止。宽限期允许在结果之后立即完成的任务仍然能够传递其输出。在 v2.1.163 之前，永不退出的后台进程会无限期地保持 `claude -p` 调用打开。

70 70

71后台 [subagents](/zh-CN/sub-agents) 和工作流程不受五秒宽限期的限制，因为它们的结果是最终输出的一部分，所以 `claude -p` 会等待它们完成。从 v2.1.182 开始，该等待默认上限为十分钟，以便卡住的后台 agent 无法无限期地保持进程打开。使用 [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/zh-CN/env-vars) 调整上限，或将其设置为 `0` 以无限制地等待。

71<h2 id="examples">73<h2 id="examples">

72 示例74 示例

73</h2>75</h2>

232`--allowedTools` 标志使用 [权限规则语法](/zh-CN/settings#permission-rule-syntax)。尾部的 ` *` 启用前缀匹配，因此 `Bash(git diff *)` 允许任何以 `git diff` 开头的命令。空格在 `*` 之前很重要：没有它，`Bash(git diff*)` 也会匹配 `git diff-index`。234`--allowedTools` 标志使用 [权限规则语法](/zh-CN/settings#permission-rule-syntax)。尾部的 ` *` 启用前缀匹配，因此 `Bash(git diff *)` 允许任何以 `git diff` 开头的命令。空格在 `*` 之前很重要：没有它，`Bash(git diff*)` 也会匹配 `git diff-index`。

233 235

234<Note>236<Note>

235 用户调用的 [skills](/zh-CN/skills) 和自定义命令在 `-p` 模式下工作：在提示字符串中包含 `/skill-name`，Claude Code 会在运行前展开它。打开交互对话框的内置命令，例如 `/config` 和 `/login`，在 `-p` 模式下不可用。237 用户调用的 [skills](/zh-CN/skills) 和自定义命令在 `-p` 模式下工作：在提示字符串中包含 `/skill-name`，Claude Code 会在运行前展开它。打开交互对话框的内置命令，例如 `/login`，在 `-p` 模式下不可用。{/* min-version: 2.1.181 */}要从 `-p` 调用更改设置，请将 `key=value` 传递给 `/config`，例如 `/config thinking=false`。

236</Note>238</Note>

237 239

238<h3 id="customize-the-system-prompt">240<h3 id="customize-the-system-prompt">

interactive-mode.md +3 −1

Details

94| 快捷键 | 描述 | 注释 |94| 快捷键 | 描述 | 注释 |

95| :------ | :-------- | :------------------------------------------ |95| :------ | :-------- | :------------------------------------------ |

96| `/` 在开始 | 命令或 skill | 请参阅[命令](#commands)和 [skills](/zh-CN/skills) |96| `/` 在开始 | 命令或 skill | 请参阅[命令](#commands)和 [skills](/zh-CN/skills) |

~~97| `!` 在开始 | Shell 模式 | 直接运行命令并将执行输出添加到会话 |~~97| `!` 在开始 | Shell 模式 | 直接运行命令，将其输出添加到会话，并让 Claude 对其进行响应 |

98| `@` | 文件路径提及 | 触发文件路径自动完成 |98| `@` | 文件路径提及 | 触发文件路径自动完成 |

99 99

100<h3 id="transcript-viewer">100<h3 id="transcript-viewer">

326* 使用 `Escape`、`Backspace` 或在空提示上使用 `Ctrl+U` 退出326* 使用 `Escape`、`Backspace` 或在空提示上使用 `Ctrl+U` 退出

327* 将以 `!` 开头的文本粘贴到空提示中会自动进入 shell 模式，与键入的 `!` 行为相匹配327* 将以 `!` 开头的文本粘贴到空提示中会自动进入 shell 模式，与键入的 `!` 行为相匹配

328 328

329从 v2.1.186 开始，Claude 在命令输出进入记录后会自动响应，因此您可以运行 `! npm test` 并获得失败的解释，无需第二个提示。响应成本与发送普通提示相同。要恢复早期行为（其中输出被添加到上下文而不响应），请在 `settings.json` 中将 [`respondToBashCommands`](/zh-CN/settings#available-settings) 设置为 `false`。在 v2.1.186 之前，shell 模式始终将输出添加到上下文而不响应。

330

329这对于快速 shell 操作同时保持对话上下文很有用。331这对于快速 shell 操作同时保持对话上下文很有用。

330 332

331<h2 id="prompt-suggestions">333<h2 id="prompt-suggestions">

keybindings.md +4 −3

Details

347 设置操作347 设置操作

348</h3>348</h3>

349 349

350在 `Settings` 上下文中可用的操作：350在 `Settings` 上下文中可用的操作。`select:accept` 和 `confirm:no` 操作从[选择](#select-actions)和[确认](#confirmation-actions)上下文中重用，具有特定于设置的行为：更改会在您更改时立即应用于每个设置，因此 Escape 关闭面板并保存您的更改，而不是拒绝。

351 351

352| 操作 | 默认 | 描述 |352| 操作 | 默认 | 描述 |

353| :---------------- | :---- | :------------------------- |353| :---------------- | :----------- | :------------- |

354| `settings:search` | / | 进入搜索模式 |354| `settings:search` | / | 进入搜索模式 |

355| `settings:retry` | R | 重试加载使用数据（出错时） |355| `settings:retry` | R | 重试加载使用数据（出错时） |

357| `confirm:no` | Escape | 关闭面板。更改已保存 |

357 358

358<h3 id="doctor-actions">359<h3 id="doctor-actions">

359 Doctor 操作360 Doctor 操作

managed-mcp.md +8 −1

Details

162 162

163<Warning>163<Warning>

164 仅使用 `serverName` 条目的允许列表不是安全控制。名称是用户在运行 `claude mcp add` 或编辑配置文件时分配的标签，而不是底层服务器，因此用户可以将任何服务器称为 `github`。要强制执行实际运行的服务器，请添加 `serverCommand` 或 `serverUrl` 条目。164 `serverName` 条目（在任一列表中）不是安全控制。名称是用户在运行 `claude mcp add` 或编辑配置文件时分配的标签，而不是底层服务器，因此用户可以将任何服务器称为 `github`。对于 claude.ai 连接器，名称是 claude.ai 返回的显示名称，可能会更改。要强制执行实际运行的服务器，请添加 `serverCommand` 或 `serverUrl` 条目。

165</Warning>165</Warning>

166 166

167`serverName` 验证在两个列表之间有所不同：

168

169* {/* min-version: 2.1.182 */}在 `deniedMcpServers` 中，`serverName` 接受任何非空字符串，因此您可以按显示名称阻止 [claude.ai 连接器](/zh-CN/mcp#use-mcp-servers-from-claude-ai)。例如，`{ "serverName": "claude.ai Slack" }` 阻止 Slack 连接器。当您需要拒绝对重命名具有鲁棒性时，或当连接器名称冲突并获得 ` (N)` 后缀时，更倾向于使用 `serverUrl` 条目。

170* 在 `allowedMcpServers` 中，`serverName` 仅限于字母、数字、连字符和下划线。使用 `serverUrl` 来允许列表 claude.ai 连接器。

171

172要关闭所有 claude.ai 连接器，请参阅 [`disableClaudeAiConnectors`](/zh-CN/mcp#disable-claude-ai-connectors)。

173

167<h3 id="how-a-server-is-evaluated">174<h3 id="how-a-server-is-evaluated">

168 如何评估服务器175 如何评估服务器

169</h3>176</h3>

mcp.md +39 −1

Details

554 * OAuth 身份验证适用于 HTTP 服务器554 * OAuth 身份验证适用于 HTTP 服务器

555</Tip>555</Tip>

556 556

557<h3 id="authenticate-from-the-command-line">

558 从命令行进行身份验证

559</h3>

560

561从 v2.1.186 开始，`claude mcp login <name>` 直接从您的 shell 运行配置的服务器的 OAuth 流程，因此您无需在会话内打开 `/mcp` 面板。

562

563```bash theme={null}

564claude mcp login sentry

565```

566

567要稍后清除存储的凭据，请运行 `claude mcp logout <name>`。

568

569当您通过 SSH 连接时，添加 `--no-browser` 以便命令打印授权 URL 而不是打开浏览器。在您的本地计算机上打开 URL，然后将浏览器地址栏中的完整重定向 URL 粘贴回提示符。该命令需要交互式终端来执行粘贴步骤，因此请使用 `ssh -t` 连接。

570

571```bash theme={null}

572claude mcp login sentry --no-browser

573```

574

557<h3 id="use-a-fixed-oauth-callback-port">575<h3 id="use-a-fixed-oauth-callback-port">

558 使用固定的 OAuth 回调端口576 使用固定的 OAuth 回调端口

559</h3>577</h3>

852 870

853某些 Anthropic 托管的连接器（如 Microsoft 365、Gmail 和 Google Calendar）不支持来自 Claude Code 的本地 OAuth，因为上游身份提供商仅接受 claude.ai 注册的重定向 URL。从 v2.1.162 开始，在 `/mcp` 中对这些主机之一进行身份验证会显示一条消息，指导您改为在 claude.ai 上的"设置"→"连接器"中连接它。连接后，连接器会自动出现在 Claude Code 中。871某些 Anthropic 托管的连接器（如 Microsoft 365、Gmail 和 Google Calendar）不支持来自 Claude Code 的本地 OAuth，因为上游身份提供商仅接受 claude.ai 注册的重定向 URL。从 v2.1.162 开始，在 `/mcp` 中对这些主机之一进行身份验证会显示一条消息，指导您改为在 claude.ai 上的"设置"→"连接器"中连接它。连接后，连接器会自动出现在 Claude Code 中。

854 872

855要在 Claude Code 中禁用 claude.ai MCP 服务器，请将 `ENABLE_CLAUDEAI_MCP_SERVERS` 环境变量设置为 `false`：873<h3 id="disable-claude-ai-connectors">

874 禁用 claude.ai 连接器

875</h3>

876

877要在 Claude Code 中禁用 claude.ai MCP 服务器，请将 [`disableClaudeAiConnectors`](/zh-CN/settings#available-settings) 设置为 `true`（在任何设置范围内）：

878

879```json theme={null}

880{

881 "disableClaudeAiConnectors": true

882}

883```

884

885此设置使用任意源为真的语义：任何设置源中的 `true` 优先。已检入的项目 `.claude/settings.json` 可以选择退出云连接器，但项目级别的 `false` 无法重新启用用户级别或策略级别的 `true` 已禁用的连接器。通过 `--mcp-config` 显式传递的服务器不受影响。

886

887您也可以将 `ENABLE_CLAUDEAI_MCP_SERVERS` 环境变量设置为 `false`，这对当前 shell 会话具有相同的效果：

856 888

857```bash theme={null}889```bash theme={null}

858ENABLE_CLAUDEAI_MCP_SERVERS=false claude890ENABLE_CLAUDEAI_MCP_SERVERS=false claude

859```891```

860 892

893要阻止单个 claude.ai 连接器而不是全部，请按名称或 URL 模式将它们添加到 [`deniedMcpServers`](/zh-CN/managed-mcp)。例如，`serverName` 条目 `"claude.ai Slack"` 会阻止 Slack 连接器。要仅为当前项目切换连接器的开启或关闭，请使用 `/mcp` 面板。

894

895<Note>

896 这些客户端设置管理本地 Claude Code 会话。在 [Claude Code on the web](/zh-CN/claude-code-on-the-web) 会话中，claude.ai 连接器由远程主机预配，并作为显式 `--mcp-config` 条目到达，因此 `disableClaudeAiConnectors` 不适用。连接器 URL 也通过会话代理重写，因此针对供应商 URL 的 `deniedMcpServers` `serverUrl` 模式将不匹配。从您的 claude.ai 组织设置管理云会话可以使用哪些连接器。

897</Note>

898

861<h2 id="use-claude-code-as-an-mcp-server">899<h2 id="use-claude-code-as-an-mcp-server">

862 将 Claude Code 用作 MCP 服务器900 将 Claude Code 用作 MCP 服务器

863</h2>901</h2>

mcp-quickstart.md +2 −1

Details

61 服务器显示状态指示器：61 服务器显示状态指示器：

62 62

63 | 状态 | 含义 |63 | 状态 | 含义 |

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

65 | `✓ Connected` | 准备就绪。这是您应该为 `claude-code-docs` 看到的 |65 | `✓ Connected` | 准备就绪。这是您应该为 `claude-code-docs` 看到的 |

66 | `! Connected · tools fetch failed` | 服务器已连接但无法列出其工具。运行 `claude mcp get <name>` 以获取错误详情 |

67 | `✗ Failed to connect` | 服务器没有响应。请参阅[故障排除](#troubleshooting) |68 | `✗ Failed to connect` | 服务器没有响应。请参阅[故障排除](#troubleshooting) |

68 | `✗ Connection error` | 连接尝试抛出错误。请参阅[故障排除](#troubleshooting) |69 | `✗ Connection error` | 连接尝试抛出错误。请参阅[故障排除](#troubleshooting) |

model-config.md +2 −0

Details

94 94

95当启动时的活跃模型来自项目或托管设置而不是您自己的选择时，启动标题会显示哪个设置文件设置了它。运行 `/model` 以覆盖；项目或托管设置会在下次启动时重新应用。95当启动时的活跃模型来自项目或托管设置而不是您自己的选择时，启动标题会显示哪个设置文件设置了它。运行 `/model` 以覆盖；项目或托管设置会在下次启动时重新应用。

96 96

97当请求的模型有计划的停用日期或自动重新映射到更新的版本时，Claude Code 会显示一个警告，命名请求的模型。交互式会话将其显示为启动通知。从 v2.1.182 开始，当使用默认文本输出格式在[非交互模式](/zh-CN/headless)中时，相同的警告会写入 stderr。该检查还涵盖在[子代理 frontmatter](/zh-CN/sub-agents) 中设置的 `model`。对于 `--output-format json` 和 `stream-json`，stderr 警告被抑制；改为从[结果消息](/zh-CN/headless#get-structured-output)的 `modelUsage` 字段读取实际模型。

97使用示例：99使用示例：

98 100

99```bash theme={null}101```bash theme={null}

monitoring-usage.md +11 −2

Details

701 API 拒绝事件701 API 拒绝事件

702</h4>702</h4>

703 703

704当 API 请求返回 `stop_reason: "refusal"` 时记录。拒绝在成功响应流上到达，而不是作为 HTTP 错误，因此 `api_error` 事件不会为它们触发。此事件让您跟踪拒绝频率。704当 API 请求返回 `stop_reason: "refusal"` 时记录。拒绝在成功响应流上到达，而不是作为 HTTP 错误，因此 `api_error` 事件不会为它们触发。此事件让您跟踪拒绝频率并按与 `api_request` 和 `api_error` 相同的属性对拒绝进行分组。

705 705

706**事件名称**：`claude_code.api_refusal`706**事件名称**：`claude_code.api_refusal`

707 707

713* `event.sequence`：单调递增的计数器，用于在会话内排序事件713* `event.sequence`：单调递增的计数器，用于在会话内排序事件

714* `model`：来自请求的模型标识符714* `model`：来自请求的模型标识符

715* `request_id`：来自响应的 `request-id` 标头的 Anthropic API 请求 ID，例如 `"req_011..."`。仅当 API 返回时存在。715* `request_id`：来自响应的 `request-id` 标头的 Anthropic API 请求 ID，例如 `"req_011..."`。仅当 API 返回时存在。

716* `query_source`：发出请求的子系统，例如 `"repl_main_thread"`、`"compact"` 或子代理名称。有关定义，请参阅 [`api_request`](#api-request-event)。

717* `speed`：当 [快速模式](/zh-CN/fast-mode) 活跃时为 `"fast"`，或 `"normal"`

718* `attempt`：重试尝试次数。第一次尝试是 `1`。

719* `effort`：应用于请求的 [努力级别](/zh-CN/model-config#adjust-effort-level)。当模型不支持努力时不存在。

720* `server_fallback_hop`：当 API 的服务器端模型回退已在不同模型上重试此拒绝时为 `true`，因此用户没有看到此特定拒绝。当请求以拒绝结束时为 `false`。单个轮次可以发出 `true` hop 事件和稍后的 `false` 最终事件，当回退模型也拒绝时。

721* `has_category`：当 API 响应携带 `stop_details.category` 为 `"cyber"`、`"bio"`、`"frontier_llm"` 或 `"reasoning_extraction"` 时为 `true`。当响应没有类别或值在该集合之外时为 `false`。当 `server_fallback_hop` 为 `true` 时不存在，因为 hop 块不携带 `stop_details`。

722* `has_explanation`：当 API 响应携带 `stop_details.explanation` 时为 `true`，否则为 `false`。当 `server_fallback_hop` 为 `true` 时不存在。

723* `category`：来自 API 响应的 `stop_details.category` 值。`"cyber"`、`"bio"`、`"frontier_llm"` 或 `"reasoning_extraction"` 之一。仅当设置了 `OTEL_LOG_TOOL_DETAILS=1` 且 `has_category` 为 `true` 时存在。

724* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`：请求的技能、插件、代理和 MCP 归属。有关定义和编辑行为，请参阅 [成本计数器](#cost-counter)。

716 725

717<h4 id="api-request-body-event">726<h4 id="api-request-body-event">

718 API 请求主体事件727 API 请求主体事件

1155 1164

1156Claude Code 在内部重试失败的 API 请求，仅在放弃后才发出单个 `claude_code.api_error` 事件，因此事件本身是该请求的终端信号。中间重试尝试不会作为单独的事件记录。1165Claude Code 在内部重试失败的 API 请求，仅在放弃后才发出单个 `claude_code.api_error` 事件，因此事件本身是该请求的终端信号。中间重试尝试不会作为单独的事件记录。

1157 1166

1158事件上的 `attempt` 属性记录进行的总尝试次数。大于 `CLAUDE_CODE_MAX_RETRIES`（默认 `10`）的值表示请求在瞬时错误上耗尽了所有重试。较低的值表示不可重试的错误，例如 `400` 响应。1167事件上的 `attempt` 属性记录进行的总尝试次数。大于 `CLAUDE_CODE_MAX_RETRIES`（默认 `10`，上限为 `15`）的值表示请求在瞬时错误上耗尽了所有重试。较低的值表示不可重试的错误，例如 `400` 响应。

1159 1168

1160要区分从一个恢复的会话与停滞的会话，按 `session.id` 分组事件，并检查错误后是否存在更晚的 `api_request` 事件。1169要区分从一个恢复的会话与停滞的会话，按 `session.id` 分组事件，并检查错误后是否存在更晚的 `api_request` 事件。

1161 1170

network-config.md +2 −1

Details

117Claude Code 需要访问以下 URL。在您的代理配置和防火墙规则中将这些 URL 列入白名单，特别是在容器化或受限网络环境中。117Claude Code 需要访问以下 URL。在您的代理配置和防火墙规则中将这些 URL 列入白名单，特别是在容器化或受限网络环境中。

118 118

119| URL | 用途 |119| URL | 用途 |

120| ------------------------------ | -------------------------------------------------------------- |120| ------------------------------ | ------------------------------------------------------------------------------------------------ |

125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}2.1.116 版本之前的原生安装程序和原生自动更新程序 |125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}2.1.116 版本之前的原生安装程序和原生自动更新程序 |

127| `*.claudeusercontent.com` | 在 claude.ai 上查看[artifacts](/zh-CN/artifacts)。查看器从此源的沙箱子域加载每个 artifact 的内容。查看器的浏览器中需要此项，CLI 本身不需要 |

128 129

129如果您通过 npm 安装 Claude Code 或管理自己的二进制分发，最终用户可能不需要访问 `downloads.claude.ai` 或 `storage.googleapis.com`。130如果您通过 npm 安装 Claude Code 或管理自己的二进制分发，最终用户可能不需要访问 `downloads.claude.ai` 或 `storage.googleapis.com`。

permission-modes.md +3 −0

Details

235* 修改共享基础设施235* 修改共享基础设施

236* 不可逆地销毁会话开始前存在的文件236* 不可逆地销毁会话开始前存在的文件

237* 强制推送或直接推送到 `main`237* 强制推送或直接推送到 `main`

238* {/* min-version: 2.1.182 */}`git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop` 或 `git stash clear`，分类器推测这些会丢弃未提交的更改

239* `git commit --amend`，当 HEAD 处的提交不是在此会话中创建的

240* `terraform destroy`、`pulumi destroy`、`cdk destroy` 或 `terragrunt destroy`，以及应用会销毁资源的计划

238 241

239**默认允许**：242**默认允许**：

240 243

permissions.md +2 −2

Details

400以下配置类型从 `--add-dir` 目录加载：400以下配置类型从 `--add-dir` 目录加载：

401 401

402| 配置 | 从 `--add-dir` 加载 |402| 配置 | 从 `--add-dir` 加载 |

403| :----------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- |403| :------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------- |

405| `.claude/agents/` 中的 [Subagents](/zh-CN/sub-agents) | 是 |405| `.claude/agents/` 中的 [Subagents](/zh-CN/sub-agents) | 是 |

407| [CLAUDE.md](/zh-CN/memory) 文件、`.claude/rules/` 和 `CLAUDE.local.md` | 仅当设置 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` 时。`CLAUDE.local.md` 另外需要 `local` 设置源，默认启用 |407| [CLAUDE.md](/zh-CN/memory) 文件、`.claude/rules/` 和 `CLAUDE.local.md` | 仅当设置 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` 时。`CLAUDE.local.md` 另外需要 `local` 设置源，默认启用 |

408 408

409命令和输出样式从当前工作目录及其父目录、您在 `~/.claude/` 的用户目录和托管设置中发现。Hooks 和其他 `settings.json` 键从当前工作目录的 `.claude/` 文件夹加载，没有父目录回退，同时从您的用户 `~/.claude/settings.json` 和托管设置加载。要在项目间共享该配置，请使用以下方法之一：409命令和输出样式从当前工作目录及其父目录、您在 `~/.claude/` 的用户目录和托管设置中发现。Hooks 和其他 `settings.json` 键从当前工作目录的 `.claude/` 文件夹加载，没有父目录回退，同时从您的用户 `~/.claude/settings.json` 和托管设置加载。要在项目间共享该配置，请使用以下方法之一：

plugin-marketplaces.md +18 −4

Details

201 Plugin 条目201 Plugin 条目

202</h2>202</h2>

203 203

204`plugins` 数组中的每个 plugin 条目描述一个 plugin 及其位置。你可以包含 [plugin manifest 架构](/zh-CN/plugins-reference#plugin-manifest-schema)中的任何字段（如 `description`、`version`、`author`、`commands`、`hooks` 等），加上这些 marketplace 特定的字段：`source`、`category`、`tags` 和 `strict`。204`plugins` 数组中的每个 plugin 条目描述一个 plugin 及其位置。你可以包含 [plugin manifest 架构](/zh-CN/plugins-reference#plugin-manifest-schema)中的任何字段（如 `description`、`version`、`author`、`commands`、`hooks` 等），加上这些 marketplace 特定的字段：`source`、`category`、`tags`、`strict` 和 `relevance`。

205 205

206<h3 id="required-fields-1">206<h3 id="required-fields-1">

207 必需字段207 必需字段

234| `relevance` | object | {/* min-version: 2.1.152 */}告诉 Claude Code 何时向用户建议此 plugin 的信号。仅对管理员在托管设置中允许列表的 marketplace 生效。见 [为你的组织推荐 plugin](/zh-CN/plugin-relevance)。需要 Claude Code v2.1.152 或更高版本。 |

234| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}plugin 安装后是否启用（默认：true）。设置为 `false` 以安装禁用的 plugin，直到用户选择启用。优先于 plugin 的 `plugin.json` 中的同一字段。见 [默认启用](/zh-CN/plugins-reference#default-enablement)。需要 Claude Code v2.1.154 或更高版本。 |235| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}plugin 安装后是否启用（默认：true）。设置为 `false` 以安装禁用的 plugin，直到用户选择启用。优先于 plugin 的 `plugin.json` 中的同一字段。见 [默认启用](/zh-CN/plugins-reference#default-enablement)。需要 Claude Code v2.1.154 或更高版本。 |

235 236

236**组件配置字段：**237**组件配置字段：**

269 例如，托管在 `acme-corp/plugin-catalog` 的 marketplace（marketplace 源）可以列出从 `acme-corp/code-formatter` 获取的 plugin（plugin 源）。marketplace 源和 plugin 源指向不同的存储库，并独立固定。270 例如，托管在 `acme-corp/plugin-catalog` 的 marketplace（marketplace 源）可以列出从 `acme-corp/code-formatter` 获取的 plugin（plugin 源）。marketplace 源和 plugin 源指向不同的存储库，并独立固定。

270</Note>271</Note>

271 272

272基于 git 的源类型如下所示为 `github`、`url` 和 `git-subdir`。当在其中任何一个上同时设置 `ref` 和 `sha` 时，`sha` 是有效的固定。Claude Code 直接获取并检出固定的提交，所以即使上游的 `ref` 命名的分支或标签已被删除，只要提交仍然可从存储库到达，安装也会成功。273基于 git 的源类型如下所示为 `github`、`url` 和 `git-subdir`。当在其中任何一个上同时设置 `ref` 和 `sha` 时，`sha` 是有效的固定。Claude Code 直接获取并检出固定的提交。在大多数 git 主机上，包括 GitHub、GitLab 和 Bitbucket，这意味着即使上游的 `ref` 命名的分支或标签已被删除，只要提交仍然可从存储库到达，安装也会成功。某些服务器（如 AWS CodeCommit）不支持通过 SHA 获取提交。在这些服务器上，`ref` 必须仍然存在，固定的提交必须可从其到达。

273 274

274<h3 id="relative-paths">275<h3 id="relative-paths">

275 相对路径276 相对路径

507* **`${CLAUDE_PLUGIN_ROOT}`**：在 hooks 和 MCP server 配置中使用此变量来引用 plugin 安装目录中的文件。这是必要的，因为 plugins 在安装时被复制到缓存位置。对于应该在 plugin 更新后保留的依赖项或状态，请改用 [`${CLAUDE_PLUGIN_DATA}`](/zh-CN/plugins-reference#persistent-data-directory)。508* **`${CLAUDE_PLUGIN_ROOT}`**：在 hooks 和 MCP server 配置中使用此变量来引用 plugin 安装目录中的文件。这是必要的，因为 plugins 在安装时被复制到缓存位置。对于应该在 plugin 更新后保留的依赖项或状态，请改用 [`${CLAUDE_PLUGIN_DATA}`](/zh-CN/plugins-reference#persistent-data-directory)。

508* **`strict: false`**：由于这设置为 false，plugin 不需要自己的 `plugin.json`。marketplace 条目定义了一切。见下面的 [Strict 模式](#strict-mode)。509* **`strict: false`**：由于这设置为 false，plugin 不需要自己的 `plugin.json`。marketplace 条目定义了一切。见下面的 [Strict 模式](#strict-mode)。

509 510

510默认情况下，plugin 的 skills 从其 `source` 下的 `skills/` 目录加载，`skills` 下列出的任何路径都会添加到该扫描中。例外是 marketplace 根源，例如 `source: "./"` 的情况，其中多个 plugin 条目共享一个 `skills/` 文件夹。在这种情况下，在 `skills` 下列出特定子目录会使该列表成为该条目的完整集合，`skills/` 下的其他目录不会加载。列出 `skills/` 目录本身或 plugin 根目录会保持完整扫描。如果列出的路径都不存在，则改为运行默认扫描。511默认情况下，plugin 的 skills 从其 `source` 下的 `skills/` 目录加载。`skills` 字段中列出的路径添加到该扫描中：

512

513```json theme={null}

514"skills": ["./skills/", "./extra-skills/"]

515```

516

517当多个 plugin 条目在 marketplace 根目录（`source: "./"`）共享一个 `skills/` 文件夹时，改为列出特定子目录，以便每个条目仅加载自己的 skills：

518

519```json theme={null}

520"source": "./",

521"skills": ["./skills/code-review", "./skills/docs"]

522```

523

524使用 marketplace 根源，列出的路径是该条目的完整集合，共享 `skills/` 文件夹中的其他目录不会加载。列出 `./skills/` 本身或 plugin 根目录会保持完整扫描。如果列出的路径都不存在，则改为运行默认扫描。

511 525

512<h3 id="strict-mode">526<h3 id="strict-mode">

513 Strict 模式527 Strict 模式

1078* 检查 plugin 目录是否包含必需的文件1092* 检查 plugin 目录是否包含必需的文件

1079* 对于 GitHub 源，确保存储库是公开的或你有访问权限1093* 对于 GitHub 源，确保存储库是公开的或你有访问权限

1080* 通过手动克隆/下载来测试 plugin 源1094* 通过手动克隆/下载来测试 plugin 源

1081* 如果源同时固定了 `ref` 和 `sha`，删除的上游分支或标签不会阻止安装。如果安装仍然失败，请确认固定的提交仍然存在于存储库中1095* 如果源同时固定了 `ref` 和 `sha`，删除的上游分支或标签不会阻止大多数 git 主机（包括 GitHub、GitLab 和 Bitbucket）上的安装。在不支持通过 SHA 获取提交的服务器上（如 AWS CodeCommit），`ref` 必须仍然存在，固定的提交必须可从其到达。如果安装仍然失败，请确认固定的提交仍然存在于存储库中

1082 1096

1083<h3 id="private-repository-authentication-fails">1097<h3 id="private-repository-authentication-fails">

1084 私有存储库身份验证失败1098 私有存储库身份验证失败

plugin-relevance.md +188 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

5# 为您的组织推荐插件

7> 向marketplace插件条目添加relevance块，以便当用户的工作与之匹配时，Claude Code会建议他们安装。

9如果您为组织运营插件marketplace，您可以根据用户正在处理的内容让Claude Code向用户建议特定的插件。向`marketplace.json`中的插件条目添加`relevance`块，然后在托管设置中将marketplace加入允许列表。当用户的会话与声明的信号之一匹配时，Claude Code会显示该插件的安装建议。

11Marketplace声明的建议通过[托管设置](/zh-CN/settings#settings-files)按marketplace选择加入。在管理员将任何marketplace添加到允许列表之前，没有marketplace的`relevance`声明会产生建议，包括官方Anthropic marketplace。Claude Code还包括一个独立于此允许列表的内置建议；当[`spinnerTipsEnabled`](/zh-CN/settings#available-settings)设置为`false`时，该提示和所有marketplace声明的提示都会被禁用。

13{/* min-version: 2.1.152 */}此功能需要Claude Code v2.1.152或更高版本。较旧的客户端会忽略`relevance`字段。

15此页面适用于marketplace运营商和企业管理员。如果您想要安装插件，请参阅[发现和安装插件](/zh-CN/discover-plugins)。

17<h2 id="how-it-works">

18 工作原理

19</h2>

21`marketplace.json`中的每个插件条目都可以包含一个`relevance`对象。该对象命名一个主题和一个或多个信号。信号是Claude Code针对当前会话测试的模式，例如工作目录或Claude已读取的文件。

23信号匹配在用户的机器上本地进行。匹配不会增加网络流量，也不会向Anthropic或marketplace运营商报告哪些信号匹配或其值。

25当信号匹配且插件尚未安装时，Claude Code会在三个位置显示该插件：

27* **Spinner提示**：当Claude正在响应时，spinner下方会显示"使用\_topic\_？安装\_plugin\_插件"消息，附带`/plugin install`命令。

28* **会话启动建议**：{/* min-version: 2.1.153 */}如果`cwd`信号与工作目录匹配，在第一轮之前会显示一行`plugin suggestion: <name>@<marketplace> · /plugin`通知。此表面需要Claude Code v2.1.153或更高版本。

29* **`/plugin` Discover标签页**：{/* min-version: 2.1.154 */}插件被固定在Discover列表的顶部，带有"为此目录建议"或"为stripe命令建议"之类的注释。此表面需要Claude Code v2.1.154或更高版本。

31Spinner提示和会话启动通知是spinner提示系统的一部分。当用户或项目将`spinnerTipsEnabled`设置为`false`，或当配置了带有`excludeDefault`的自定义`spinnerTipsOverride`时，两者都会被禁用。Discover标签页的固定独立于提示设置。

33Claude Code永远不会自动安装插件。用户始终需要确认。

35<h2 id="add-relevance-to-a-plugin-entry">

36 向插件条目添加relevance

37</h2>

39向您的`marketplace.json`中的插件条目添加`relevance`对象。以下示例声明当Claude读取`.tf`文件或运行`terraform`时，`terraform-helpers`插件是相关的：

41```json theme={null}

42{

43 "name": "acme-corp-plugins",

44 "owner": { "name": "Acme Platform Team" },

45 "plugins": [

46 {

47 "name": "terraform-helpers",

48 "source": "./plugins/terraform-helpers",

49 "description": "Acme conventions and helpers for Terraform",

50 "relevance": {

51 "topic": "Terraform",

52 "signals": {

53 "cli": ["terraform"],

54 "filesRead": ["**/*.tf"]

55 }

56 }

57 }

58 ]

59}

60```

62具有`relevance`块但没有匹配信号的插件的行为与任何其他marketplace条目相同。它在Discover列表中以其正常位置出现，永远不会显示为spinner提示。

64<h2 id="field-reference">

65 字段参考

66</h2>

68<h3 id="relevance">

69 `relevance`

70</h3>

72| 字段 | 类型 | 描述 |

73| :-------- | :----- | :---------------------------------------------------------------------------------------------------------------------------- |

74| `topic` | string | 可选。在spinner提示中填充"使用\_topic\_？"的短语。通常是产品名称，例如`Stripe`。当插件名称不能自然地作为主题读取时，使用域名如`design`。默认为插件名称，每个连字符段首字母大写。会话启动通知不使用此值。最多64个字符。 |

75| `signals` | object | 确定插件何时相关的匹配器。至少需要一个信号才能使插件可被建议。请参阅下表。 |

77<h3 id="relevance-signals">

78 `relevance.signals`

79</h3>

81| 字段 | 类型 | 描述 |

82| :------------- | :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | array of strings | {/* min-version: 2.1.153 */}与会话工作目录匹配的Glob模式。作为绝对路径匹配，当在git存储库内时，作为相对于存储库根目录的路径匹配。正斜杠规范化且不区分大小写。每个模式都匹配目录本身及其下的所有内容，因此`infra`、`infra/`和`infra/**`的行为相同。这是唯一可以在会话启动时（第一轮之前）匹配的信号。最多10个模式，每个256个字符。 |

84| `cli` | array of strings | Claude在此会话中运行的shell命令中的命令名称，例如`["stripe"]`。适用于每个平台：在Windows上通过PowerShell或Git Bash运行的命令以相同方式记录。Claude Code每个shell工具调用记录一个命令名称：任何前导环境变量赋值和`sudo`之后的第一个令牌。复合命令仅贡献其前导命令，因此`cd infra && terraform plan`记录`cd`，而不是`terraform`。精确匹配。最多10个条目，每个64个字符。 |

85| `hosts` | array of strings | 此会话中Bash命令中`http://`或`https://` URL中看到的主机名，例如`["api.stripe.com"]`。仅限裸小写主机名：无方案、端口或路径。精确不区分大小写匹配。最多20个条目，每个128个字符。 |

86| `filesRead` | array of strings | {/* min-version: 2.1.153 */}与Claude在此会话中读取的文件路径匹配的Glob模式，例如`["**/*.tf"]`。正斜杠规范化且不区分大小写。最多10个模式，每个256个字符。 |

87| `manifestDeps` | array of objects | Claude在此会话中读取的包清单中声明的依赖项。每个条目是`{ "file": "...", "pattern": "..." }`，其中`file`是与清单文件路径匹配的正则表达式（如会话状态中记录的，通常是绝对路径），`pattern`是与该文件内容匹配的正则表达式。在末尾锚定`file`，例如JSON转义形式中的`[/\\\\]package\\.json$`，因为起始锚定的模式永远不会匹配绝对路径。路径对于此信号不进行分隔符规范化，因此Windows路径使用反斜杠。大于512 KB的清单文件会被跳过。两个值都是最多256个字符的JavaScript `RegExp`源字符串。`file`不区分大小写匹配。`pattern`区分大小写。最多10个条目。 |

89`cli`、`hosts`、`filesRead`和`manifestDeps`信号需要会话历史记录，因此它们只能在spinner提示和Discover标签页上匹配。只有`cwd`可以在会话启动时匹配。`filesRead`和`manifestDeps`信号测试会话的记录文件状态，其中还包括Claude已写入或编辑的文件以及自动加载的`CLAUDE.md`内存文件。

91以下示例使用`manifestDeps`在Claude读取了依赖于`stripe`的`package.json`后建议Stripe插件。`file`模式使用`[/\\\\]`以匹配正斜杠和反斜杠路径分隔符，使用`\\.`以使点为字面。在JSON中，正则表达式中的每个反斜杠都写两次。

93```json theme={null}

94{

95 "name": "stripe-helpers",

96 "source": "./plugins/stripe-helpers",

97 "relevance": {

98 "topic": "Stripe",

99 "signals": {

100 "manifestDeps": [

101 {

102 "file": "[/\\\\]package\\.json$",

103 "pattern": "\"stripe\"\\s*:"

104 }

105 ]

106 }

107 }

108}

109```

110

111<Note>

112 `relevance`和`relevance.signals`下的未知字段在加载时被忽略，因此较旧的Claude Code客户端继续加载您的marketplace。运行`claude plugin validate`以将它们显示为警告。

113</Note>

114

115<h2 id="enable-suggestions-in-managed-settings">

116 在托管设置中启用建议

117</h2>

118

119在`marketplace.json`中声明`relevance`本身是不够的。管理员必须在[托管设置](/zh-CN/settings#settings-files)中将marketplace加入允许列表，其建议才会显示给用户。

120

121将marketplace名称添加到`pluginSuggestionMarketplaces`。对于官方Anthropic marketplace以外的任何marketplace，还要在同一托管设置中声明marketplace源，要么作为该名称在`extraKnownMarketplaces`中的条目，要么作为`strictKnownMarketplaces`中的条目。如果在机器上注册的marketplace来自不同的源，则忽略允许列表中的名称。这可以防止无关的源以允许列表中的名称注册，以便在您的组织中建议其插件。

122

123以下`managed-settings.json`从GitHub存储库注册一个组织marketplace并启用其建议：

124

125```json theme={null}

126{

127 "extraKnownMarketplaces": {

128 "acme-corp-plugins": {

129 "source": {

130 "source": "github",

131 "repo": "acme-corp/claude-plugins"

132 }

133 }

134 },

135 "pluginSuggestionMarketplaces": ["acme-corp-plugins"]

136}

137```

138

139官方marketplace免除源声明要求，因为其名称只能从官方Anthropic源注册。仅允许列表中的名称就足够了：

140

141```json theme={null}

142{

143 "pluginSuggestionMarketplaces": ["claude-plugins-official"]

144}

145```

146

147有关`pluginSuggestionMarketplaces`和[`extraKnownMarketplaces`](/zh-CN/settings#extraknownmarketplaces)的完整配置详情，请参阅[设置参考](/zh-CN/settings)。

148

149<h2 id="what-the-user-sees">

150 用户看到的内容

151</h2>

152

153当会话期间信号匹配时，spinner提示读取：

154

155```text theme={null}

156Working with Terraform? Install the terraform-helpers plugin:

157/plugin install terraform-helpers@acme-corp-plugins

158```

159

160在会话启动时，匹配的`cwd`信号会显示一行通知：

161

162```text theme={null}

163plugin suggestion: terraform-helpers@acme-corp-plugins · /plugin

164```

165

166给定插件的建议在spinner提示和会话启动通知的组合中最多每三个会话出现一次，一旦插件被安装，两者都不会重复。会话启动通知在建议显示两次后还会停止出现。

167

168{/* min-version: 2.1.154 */}在`/plugin` Discover标签页中，插件被固定在其他结果上方，带有命名匹配信号的注释，例如`suggested for this directory`或`suggested for terraform commands`。Discover标签页固定给定插件一次；后续访问以正常顺序列出它。Discover标签页固定需要Claude Code v2.1.154或更高版本。在v2.1.152上仅显示spinner提示；会话启动通知在v2.1.153中添加。

169

170<h2 id="validate-your-marketplace">

171 验证您的marketplace

172</h2>

173

174针对您的marketplace目录运行`claude plugin validate`以在发布前检查`relevance`块：

175

176```

177claude plugin validate ./my-marketplace

178```

179

180验证器将`relevance`和`relevance.signals`下的未知键报告为警告，标记不是对象的`relevance`值，并拒绝包含方案、端口或路径的`signals.hosts`条目。

181

182<h2 id="see-also">

183 另请参阅

184</h2>

185

186* [创建和分发插件marketplace](/zh-CN/plugin-marketplaces)：构建托管您的插件的marketplace

187* [从您的CLI推荐您的插件](/zh-CN/plugin-hints)：从您自己的CLI而不是Claude Code的会话信号提示用户

188* [设置](/zh-CN/settings)：`pluginSuggestionMarketplaces`和`extraKnownMarketplaces`的完整参考

prompt-library.md +1 −1

Details

1217 "review-your-changes-before": {1217 "review-your-changes-before": {

1218 title: "在提交前审查你的更改",1218 title: "在提交前审查你的更改",

1219 teaches: "在问题仍然便宜时捕获它们。Claude 完整读取更改的文件，而不仅仅是差异行，所以它发现快速自审会遗漏的问题。",1219 teaches: "在问题仍然便宜时捕获它们。Claude 完整读取更改的文件，而不仅仅是差异行，所以它发现快速自审会遗漏的问题。",

1220 next: "运行 `/review` 以在一个命令中进行相同的检查"1220 next: "运行 `/code-review` 以在一个命令中进行相同的检查"

1221 },1221 },

1222 "review-a-pull-request": {1222 "review-a-pull-request": {

1223 title: "审查拉取请求",1223 title: "审查拉取请求",

remote-control.md +7 −2

Details

119 119

120在交互式终端会话中，当连接处于活动状态时，`/rc active` 指示器位于输入框下方的页脚中，如果终端太窄无法容纳它，则隐藏。指示器文本是指向 claude.ai 上会话的链接。使用向下箭头键选择它并按 Enter，或再次运行 `/remote-control`，打开状态面板，其中包含会话 URL 和 QR 码，您可以使用它从[另一个设备连接](#connect-from-another-device)。120在交互式终端会话中，当连接处于活动状态时，`/rc active` 指示器位于输入框下方的页脚中，如果终端太窄无法容纳它，则隐藏。指示器文本是指向 claude.ai 上会话的链接。使用向下箭头键选择它并按 Enter，或再次运行 `/remote-control`，打开状态面板，其中包含会话 URL 和 QR 码，您可以使用它从[另一个设备连接](#connect-from-another-device)。

121 121

122如果连接失败，指示器变为红色并显示 `/rc failed`。使用向下箭头键选择它并按 Enter 查看失败原因和关闭选项，或再次运行 `/remote-control` 以重试。122如果连接失败，会出现一条通知，显示失败原因，指示器从页脚消失。再次运行 `/remote-control` 以重试。

123 123

124<h3 id="connect-from-another-device">124<h3 id="connect-from-another-device">

125 从另一个设备连接125 从另一个设备连接

206* 在 iOS 上，焦点模式和通知摘要可能会抑制或延迟推送。检查设置 → 通知 → Claude。206* 在 iOS 上，焦点模式和通知摘要可能会抑制或延迟推送。检查设置 → 通知 → Claude。

207* 在 Android 上，激进的电池优化可能会延迟传递。在系统设置中将 Claude 应用从电池优化中豁免。207* 在 Android 上，激进的电池优化可能会延迟传递。在系统设置中将 Claude 应用从电池优化中豁免。

208 208

209Claude Code 在您在连接的终端中输入或专注时会跳过移动推送通知。{/* min-version: 2.1.181 */}从 v2.1.181 开始，您可以将 [`CLAUDE_CLIENT_PRESENCE_FILE`](/zh-CN/env-vars) 设置为标记文件路径，以将其扩展到您在机器上的任何时间，即使在另一个窗口中：当文件存在时，通知会被跳过。配置屏幕锁定侦听器或类似工具，以在屏幕解锁时创建文件，在屏幕锁定时删除文件。

210

209<h2 id="limitations">211<h2 id="limitations">

210 限制212 限制

211</h2>213</h2>

214* **本地进程必须保持运行**：Remote Control 作为本地进程运行。如果您关闭终端、退出 VS Code 或以其他方式停止 `claude` 进程，会话结束。216* **本地进程必须保持运行**：Remote Control 作为本地进程运行。如果您关闭终端、退出 VS Code 或以其他方式停止 `claude` 进程，会话结束。

215* **扩展网络中断**：如果您的机器处于唤醒状态但无法在大约 10 分钟以上的时间内到达网络，会话超时并且进程退出。再次运行 `claude remote-control` 以启动新会话。217* **扩展网络中断**：如果您的机器处于唤醒状态但无法在大约 10 分钟以上的时间内到达网络，会话超时并且进程退出。再次运行 `claude remote-control` 以启动新会话。

216* **Ultraplan 断开 Remote Control**：启动 [ultraplan](/zh-CN/ultraplan) 会话会断开任何活动的 Remote Control 会话，因为两个功能都占据 claude.ai/code 界面，一次只能连接一个。218* **Ultraplan 断开 Remote Control**：启动 [ultraplan](/zh-CN/ultraplan) 会话会断开任何活动的 Remote Control 会话，因为两个功能都占据 claude.ai/code 界面，一次只能连接一个。

217* **某些命令仅限本地**：在终端中打开交互式选择器的命令，例如 `/plugin` 或 `/resume`，仅从本地 CLI 工作。生成文本输出的命令，包括 `/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap` 和 `/reload-plugins`，可从移动和网络工作。{/* min-version: 2.1.166 */}从 v2.1.166 开始，`/mcp` 也可从移动和网络工作：它返回服务器状态的文本摘要而不是打开选择器，并接受与本地 CLI 相同的 `reconnect`、`enable` 和 `disable` [子命令](/zh-CN/commands#all-commands)，但有一个区别：从移动和网络，`/mcp reconnect` 不带服务器名称会重新连接每个已失败或需要身份验证的服务器，而本地 CLI 需要为 `reconnect` 指定服务器名称。219* **某些命令仅限本地**：在终端中打开交互式选择器的命令，例如 `/plugin` 或 `/resume`，仅从本地 CLI 工作。以下命令可从移动和网络工作：

220 * 文本输出命令：`/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins`

221 * {/* min-version: 2.1.166 */}从 v2.1.166 开始的 `/mcp`：返回服务器状态的文本摘要而不是打开选择器，并接受 `reconnect`、`enable` 和 `disable` [子命令](/zh-CN/commands#all-commands)。与本地 CLI 不同，不带服务器名称的 `/mcp reconnect` 会重新连接每个已失败或需要身份验证的服务器。

222 * {/* min-version: 2.1.181 */}从 v2.1.181 开始的 `/config`：传递 `key=value` 以设置一个设置，或不带参数运行它以列出您可以设置的键。

218 223

219<h2 id="troubleshooting">224<h2 id="troubleshooting">

220 故障排除225 故障排除

sandboxing.md +2 −0

Details

373* **命令因主机不允许错误而失败**：许多 CLI 工具需要到达特定的主机。在提示时授予权限会将主机添加到你的允许列表，以便该工具在将来在沙箱内运行。373* **命令因主机不允许错误而失败**：许多 CLI 工具需要到达特定的主机。在提示时授予权限会将主机添加到你的允许列表，以便该工具在将来在沙箱内运行。

374* **`jest` 挂起或失败**：`watchman` 与沙箱不兼容。改为运行 `jest --no-watchman`。374* **`jest` 挂起或失败**：`watchman` 与沙箱不兼容。改为运行 `jest --no-watchman`。

375* **Go 基础 CLI 在 macOS 上 TLS 验证失败**：`gh`、`gcloud` 和 `terraform` 等工具在 Seatbelt 下可能无法进行 TLS 验证。在 `excludedCommands` 中列出这些工具以在沙箱外运行它们。如果你使用 `httpProxyPort` 与 MITM 代理和自定义 CA，请改为将 [`enableWeakerNetworkIsolation`](/zh-CN/settings#sandbox-settings) 设置为 `true`。375* **Go 基础 CLI 在 macOS 上 TLS 验证失败**：`gh`、`gcloud` 和 `terraform` 等工具在 Seatbelt 下可能无法进行 TLS 验证。在 `excludedCommands` 中列出这些工具以在沙箱外运行它们。如果你使用 `httpProxyPort` 与 MITM 代理和自定义 CA，请改为将 [`enableWeakerNetworkIsolation`](/zh-CN/settings#sandbox-settings) 设置为 `true`。

376* **`open`、`osascript` 或基于浏览器的身份验证流在 macOS 上因错误 `-600` 失败**：沙箱默认阻止 Apple Events。在你的用户、托管或 CLI 设置中将 [`allowAppleEvents`](/zh-CN/settings#sandbox-settings) 设置为 `true` 以允许它们。项目设置对此密钥被忽略。启用它会移除代码执行隔离，因为沙箱化命令随后可以在没有用户提示的情况下启动其他未沙箱化的应用程序，并向运行的应用程序发送 AppleScript 命令，受 macOS 自动化同意提示 (TCC) 的约束。或者，将命令添加到 `excludedCommands` 以在沙箱外运行它。

376* **`docker` 命令失败**：`docker` 与沙箱不兼容。将 `docker *` 添加到 `excludedCommands` 以在沙箱外运行它。377* **`docker` 命令失败**：`docker` 与沙箱不兼容。将 `docker *` 添加到 `excludedCommands` 以在沙箱外运行它。

377* **Bubblewrap 在容器内启动失败**：在无特权容器中，bubblewrap 无法挂载新的 `/proc` 文件系统。将 [`enableWeakerNestedSandbox`](/zh-CN/settings#sandbox-settings) 设置为 `true`，以便内部沙箱绑定挂载容器的现有 `/proc`。仅在外部容器已提供你需要的隔离边界时使用此设置，因为它向沙箱化命令公开进程信息，而新的 `/proc` 挂载会隐藏这些信息。378* **Bubblewrap 在容器内启动失败**：在无特权容器中，bubblewrap 无法挂载新的 `/proc` 文件系统。将 [`enableWeakerNestedSandbox`](/zh-CN/settings#sandbox-settings) 设置为 `true`，以便内部沙箱绑定挂载容器的现有 `/proc`。仅在外部容器已提供你需要的隔离边界时使用此设置，因为它向沙箱化命令公开进程信息，而新的 `/proc` 挂载会隐藏这些信息。

378* **Linux 上的 Seccomp 过滤器**：seccomp 过滤器需要阻止 Unix 域套接字。`/sandbox` 中的 Dependencies 选项卡显示它是否可用。如果缺少，请运行 `npm install -g @anthropic-ai/sandbox-runtime` 以安装助手。379* **Linux 上的 Seccomp 过滤器**：seccomp 过滤器需要阻止 Unix 域套接字。`/sandbox` 中的 Dependencies 选项卡显示它是否可用。如果缺少，请运行 `npm install -g @anthropic-ai/sandbox-runtime` 以安装助手。

397* **通过 Unix 套接字的权限提升**：`allowUnixSockets` 配置可能会无意中授予对可能导致沙箱绕过的强大系统服务的访问权限。例如，允许访问 `/var/run/docker.sock` 有效地通过 Docker 套接字授予对主机系统的访问权限。仔细考虑你通过沙箱允许的任何 Unix 套接字。398* **通过 Unix 套接字的权限提升**：`allowUnixSockets` 配置可能会无意中授予对可能导致沙箱绕过的强大系统服务的访问权限。例如，允许访问 `/var/run/docker.sock` 有效地通过 Docker 套接字授予对主机系统的访问权限。仔细考虑你通过沙箱允许的任何 Unix 套接字。

398* **文件系统权限提升**：过于宽泛的文件系统写入权限可能导致权限提升攻击。允许写入包含 `$PATH` 中的可执行文件、系统配置目录或用户 shell 配置文件（例如 `.bashrc` 或 `.zshrc`）的目录可能导致当其他用户或系统进程访问这些文件时在不同的安全上下文中执行代码。399* **文件系统权限提升**：过于宽泛的文件系统写入权限可能导致权限提升攻击。允许写入包含 `$PATH` 中的可执行文件、系统配置目录或用户 shell 配置文件（例如 `.bashrc` 或 `.zshrc`）的目录可能导致当其他用户或系统进程访问这些文件时在不同的安全上下文中执行代码。

399* **Linux 沙箱强度**：Linux 实现提供强大的文件系统和网络隔离，但包括一个 `enableWeakerNestedSandbox` 模式，使其能够在 Docker 环境中工作而无需特权命名空间，或在禁用无特权用户命名空间的 Linux 主机上。此选项大大削弱了安全性，应仅在其他隔离被强制执行时使用。400* **Linux 沙箱强度**：Linux 实现提供强大的文件系统和网络隔离，但包括一个 `enableWeakerNestedSandbox` 模式，使其能够在 Docker 环境中工作而无需特权命名空间，或在禁用无特权用户命名空间的 Linux 主机上。此选项大大削弱了安全性，应仅在其他隔离被强制执行时使用。

401* **macOS 上的 Apple Events**：macOS 沙箱默认阻止 Apple Events。`allowAppleEvents` 设置解除此限制，以便 `open` 和 `osascript` 等工具可以工作，但它移除了代码执行隔离：沙箱化命令可以在没有用户提示的情况下启动其他未沙箱化的应用程序，并可以向运行的应用程序发送 AppleScript 命令，受限于每个应用程序的 macOS 自动化同意提示 (TCC)。它仅从用户、托管或 CLI 设置中被遵守。项目设置无法启用它。

400* **设置文件受保护**：沙箱自动拒绝对 Claude Code 的 `settings.json` 文件在每个范围和托管设置目录的写入访问，因此沙箱化命令无法修改其自己的策略。402* **设置文件受保护**：沙箱自动拒绝对 Claude Code 的 `settings.json` 文件在每个范围和托管设置目录的写入访问，因此沙箱化命令无法修改其自己的策略。

401 403

402<h3 id="platform-and-tool-compatibility">404<h3 id="platform-and-tool-compatibility">

settings.md +15 −8

Details

6 6

7> 使用全局和项目级设置以及环境变量配置 Claude Code。7> 使用全局和项目级设置以及环境变量配置 Claude Code。

8 8

9Claude Code 提供多种设置来配置其行为以满足您的需求。您可以在使用交互式 REPL 时运行 `/config` 命令来配置 Claude Code，这会打开一个选项卡式设置界面，您可以在其中查看状态信息并修改配置选项。9Claude Code 提供多种设置来配置其行为以满足您的需求。您可以通过运行 `/config` 命令来配置 Claude Code，这会打开一个选项卡式设置界面，您可以在其中查看状态信息并修改配置选项。{/* min-version: 2.1.181 */}从 v2.1.181 开始，您可以通过向 `/config` 传递 `key=value` 来更改单个选项而无需打开界面，例如 `/config verbose=true`。

10 10

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 配置作用域12 配置作用域

210`settings.json` 支持多个选项：210`settings.json` 支持多个选项：

211 211

212| 键 | 描述 | 示例 |212| 键 | 描述 | 示例 |

213| :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |213| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |

214| `advisorModel` | {/* min-version: 2.1.98 */}服务器端[advisor tool](/zh-CN/advisor)的模型。接受模型别名，如 `"opus"`、`"sonnet"` 或 `"fable"`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。当您运行 `/advisor` 时自动写入。取消设置以禁用 advisor。需要 Claude Code v2.1.98 或更高版本 | `"opus"` |214| `advisorModel` | {/* min-version: 2.1.98 */}服务器端 [advisor tool](/zh-CN/advisor) 的模型。接受模型别名，如 `"opus"`、`"sonnet"` 或 `"fable"`（{/* min-version: 2.1.170 */}v2.1.170+），或完整模型 ID。当您运行 `/advisor` 时自动写入。取消设置以禁用 advisor。需要 Claude Code v2.1.98 或更高版本 | `"opus"` |

215| `agent` | 将主线程作为命名 subagent 运行，并为从 `claude agents` 分派的会话设置默认 agent。应用该 subagent 的系统提示、工具限制和模型。请参阅[显式调用 subagents](/zh-CN/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |215| `agent` | 将主线程作为命名 subagent 运行，并为从 `claude agents` 分派的会话设置默认 agent。应用该 subagent 的系统提示、工具限制和模型。请参阅[显式调用 subagents](/zh-CN/sub-agents#invoke-subagents-explicitly) | `"code-reviewer"` |

216| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}当[远程控制](/zh-CN/remote-control)已连接时，允许 Claude 向您的手机发送主动推送通知，例如当长任务完成时。默认：`false`。在 `/config` 中显示为**Claude 决定时推送**。请参阅[移动推送通知](/zh-CN/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更高版本 | `true` |216| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}当[远程控制](/zh-CN/remote-control)已连接时，允许 Claude 向您的手机发送主动推送通知，例如当长任务完成时。默认：`false`。在 `/config` 中显示为**Claude 决定时推送**。请参阅[移动推送通知](/zh-CN/remote-control#mobile-push-notifications)。需要 Claude Code v2.1.119 或更高版本 | `true` |

237| `axScreenReader` | {/* min-version: 2.1.181 */}渲染屏幕阅读器友好的输出：没有装饰性边框或动画的平面文本。屏幕阅读器模式始终使用经典渲染器，因此在其活跃时 `tui` 设置无效。[`CLAUDE_AX_SCREEN_READER`](/zh-CN/env-vars) 环境变量和 [`--ax-screen-reader`](/zh-CN/cli-reference#cli-flags) 标志优先。需要 Claude Code v2.1.181 或更高版本 | `true` |

237| `blockedMarketplaces` | （仅 Managed 设置）市场源的阻止列表。在市场添加和插件安装、更新、刷新和自动更新时强制执行，因此在设置策略之前添加的市场无法用于获取插件。被阻止的源在下载前被检查，因此它们永远不会接触文件系统。请参阅 [Managed 市场限制](/zh-CN/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |238| `blockedMarketplaces` | （仅 Managed 设置）市场源的阻止列表。在市场添加和插件安装、更新、刷新和自动更新时强制执行，因此在设置策略之前添加的市场无法用于获取插件。被阻止的源在下载前被检查，因此它们永远不会接触文件系统。请参阅 [Managed 市场限制](/zh-CN/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

238| `channelsEnabled` | （仅 Managed 设置）为组织允许 [channels](/zh-CN/channels)。在 claude.ai Team 和 Enterprise 计划上，当此项未设置或为 `false` 时，channels 被阻止。对于使用 API 密钥身份验证的 [Anthropic Console](/zh-CN/authentication#claude-console-authentication) 账户，channels 默认被允许，除非您的组织部署 managed 设置，在这种情况下此键必须设置为 `true` | `true` |239| `channelsEnabled` | （仅 Managed 设置）为组织允许 [channels](/zh-CN/channels)。在 claude.ai Team 和 Enterprise 计划上，当此项未设置或为 `false` 时，channels 被阻止。对于使用 API 密钥身份验证的 [Anthropic Console](/zh-CN/authentication#claude-console-authentication) 账户，channels 默认被允许，除非您的组织部署 managed 设置，在这种情况下此键必须设置为 `true` | `true` |

239| `claudeMd` | （仅 Managed 设置）CLAUDE.md 风格的说明，作为组织管理的内存注入。仅在 managed 或策略设置中设置时被尊重，在用户、项目和本地设置中被忽略。请参阅[组织范围的 CLAUDE.md](/zh-CN/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |240| `claudeMd` | （仅 Managed 设置）CLAUDE.md 风格的说明，作为组织管理的内存注入。仅在 managed 或策略设置中设置时被尊重，在用户、项目和本地设置中被忽略。请参阅[组织范围的 CLAUDE.md](/zh-CN/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |

244| `deniedMcpServers` | 在 managed-settings.json 中设置时，明确阻止的 MCP servers 的拒绝列表。适用于所有作用域，包括 managed servers。拒绝列表优先于允许列表。请参阅 [Managed MCP 配置](/zh-CN/managed-mcp) | `[{ "serverName": "filesystem" }]` |245| `deniedMcpServers` | 在 managed-settings.json 中设置时，明确阻止的 MCP servers 的拒绝列表。适用于所有作用域，包括 managed servers。拒绝列表优先于允许列表。请参阅 [Managed MCP 配置](/zh-CN/managed-mcp) | `[{ "serverName": "filesystem" }]` |

245| `disableAgentView` | 设置为 `true` 以关闭[后台代理和代理视图](/zh-CN/agent-view)：`claude agents`、`--bg`、`/background` 和按需主管。通常在 [managed 设置](/zh-CN/permissions#managed-settings)中设置。等同于将 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 设置为 `1` | `true` |246| `disableAgentView` | 设置为 `true` 以关闭[后台代理和代理视图](/zh-CN/agent-view)：`claude agents`、`--bg`、`/background` 和按需主管。通常在 [managed 设置](/zh-CN/permissions#managed-settings)中设置。等同于将 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 设置为 `1` | `true` |

248| `disableArtifact` | 设置为 `true` 以禁用 [Artifact](/zh-CN/artifacts) 工具，该工具将会话输出发布为 claude.ai 上的私有网页。等同于将 `CLAUDE_CODE_DISABLE_ARTIFACT` 设置为 `1` | `true` |

247| `disableAutoMode` | 设置为 `"disable"` 以防止[自动模式](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)被激活。从 `Shift+Tab` 循环中删除 `auto` 并在启动时拒绝 `--permission-mode auto`。在[managed 设置](/zh-CN/permissions#managed-settings)中最有用，用户无法覆盖它 | `"disable"` |249| `disableAutoMode` | 设置为 `"disable"` 以防止[自动模式](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)被激活。从 `Shift+Tab` 循环中删除 `auto` 并在启动时拒绝 `--permission-mode auto`。在[managed 设置](/zh-CN/permissions#managed-settings)中最有用，用户无法覆盖它 | `"disable"` |

248| `disableBundledSkills` | 设置为 `true` 以禁用 Claude Code 附带的 [skills](/zh-CN/skills) 和工作流：捆绑的 skills 和工作流被完全删除，而内置斜杠命令（如 `/init`）保持可键入但对模型隐藏。来自插件、`.claude/skills/` 和 `.claude/commands/` 的 skills 不受影响。等同于将 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 设置为 `1` | `true` |250| `disableBundledSkills` | 设置为 `true` 以禁用 Claude Code 附带的 [skills](/zh-CN/skills) 和工作流：捆绑的 skills 和工作流被完全删除，而内置斜杠命令（如 `/init`）保持可键入但对模型隐藏。来自插件、`.claude/skills/` 和 `.claude/commands/` 的 skills 不受影响。等同于将 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 设置为 `1` | `true` |

251| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}禁用 [claude.ai MCP connectors](/zh-CN/mcp#use-mcp-servers-from-claude-ai)，以便它们不被自动获取或连接。在任何设置作用域中设置。任何源中的 `true` 优先，因此已检入的项目 `.claude/settings.json` 可以选择存储库退出云连接器，但项目级 `false` 无法覆盖用户或策略级 `true`。通过 `--mcp-config` 显式传递的 servers 不受影响。要拒绝单个连接器而不是所有连接器，请改用 [`deniedMcpServers`](/zh-CN/managed-mcp)。需要 Claude Code v2.1.182 或更高版本 | `true` |

249| `disableDeepLinkRegistration` | 设置为 `"disable"` 以防止 Claude Code 在启动时向操作系统注册 `claude-cli://` 协议处理程序。[深链接](/zh-CN/deep-links)让外部工具通过预填充的提示打开 Claude Code 会话。在协议处理程序注册受限或单独管理的环境中很有用 | `"disable"` |252| `disableDeepLinkRegistration` | 设置为 `"disable"` 以防止 Claude Code 在启动时向操作系统注册 `claude-cli://` 协议处理程序。[深链接](/zh-CN/deep-links)让外部工具通过预填充的提示打开 Claude Code 会话。在协议处理程序注册受限或单独管理的环境中很有用 | `"disable"` |

251| `disableRemoteControl` | {/* min-version: 2.1.128 */}禁用[远程控制](/zh-CN/remote-control)：阻止 `claude remote-control`、`--remote-control` 标志、自动启动和会话内切换。通常放在[managed 设置](/zh-CN/permissions#managed-settings)中用于每设备 MDM 强制执行，但适用于任何作用域。需要 Claude Code v2.1.128 或更高版本 | `true` |254| `disableRemoteControl` | {/* min-version: 2.1.128 */}禁用[远程控制](/zh-CN/remote-control)：阻止 `claude remote-control`、`--remote-control` 标志、自动启动和会话内切换。通常放在[managed 设置](/zh-CN/permissions#managed-settings)中用于每设备 MDM 强制执行，但适用于任何作用域。需要 Claude Code v2.1.128 或更高版本 | `true` |

288| `preferredNotifChannel` | 任务完成和权限提示通知的方法：`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"` 或 `"notifications_disabled"`。默认：`"auto"`，在 iTerm2、Ghostty 和 Kitty 中发送桌面通知，在其他终端中不执行任何操作。设置 `"terminal_bell"` 以在任何终端中响铃。在 `/config` 中显示为**通知**。请参阅[获取终端铃声或通知](/zh-CN/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |291| `preferredNotifChannel` | 任务完成和权限提示通知的方法：`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"` 或 `"notifications_disabled"`。默认：`"auto"`，在 iTerm2、Ghostty 和 Kitty 中发送桌面通知，在其他终端中不执行任何操作。设置 `"terminal_bell"` 以在任何终端中响铃。在 `/config` 中显示为**通知**。请参阅[获取终端铃声或通知](/zh-CN/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

290| `prUrlTemplate` | PR 徽章的 URL 模板，显示在页脚和工具结果摘要中。替换来自 `gh` 报告的 PR URL 中的 `{host}`、`{owner}`、`{repo}`、`{number}` 和 `{url}`。使用指向内部代码审查工具而不是 `github.com` 的 PR 链接。不影响 Claude 散文中的 `#123` 自动链接 | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |293| `prUrlTemplate` | PR 徽章的 URL 模板，显示在页脚和工具结果摘要中。替换来自 `gh` 报告的 PR URL 中的 `{host}`、`{owner}`、`{repo}`、`{number}` 和 `{url}`。使用指向内部代码审查工具而不是 `github.com` 的 PR 链接。不影响 Claude 散文中的 `#123` 自动链接 | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}当每个交互式会话启动时自动连接[远程控制](/zh-CN/remote-control)，而不是等待 `/remote-control`。设置为 `true` 以始终自动连接，`false` 以从不自动连接，或保留未设置以遵循您的组织的默认值。在 `/config` 中显示为**为所有会话启用远程控制**。请参阅[为所有会话启用远程控制](/zh-CN/remote-control#enable-remote-control-for-all-sessions) | `false` |

291| `requiredMaximumVersion` | 仅 Managed 设置。允许启动的最大 Claude Code 版本。如果运行版本较新，Claude Code 在启动时退出并指示用户通过组织的批准方法安装批准的版本；`claude install <version>` 也可能有效。后台自动更新和 `claude update` 跳过高于上限的版本，因此在范围内的安装保持在范围内。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作，以便用户可以恢复。早于此设置的版本忽略它 | `"2.1.150"` |295| `requiredMaximumVersion` | 仅 Managed 设置。允许启动的最大 Claude Code 版本。如果运行版本较新，Claude Code 在启动时退出并指示用户通过组织的批准方法安装批准的版本；`claude install <version>` 也可能有效。后台自动更新和 `claude update` 跳过高于上限的版本，因此在范围内的安装保持在范围内。`claude update`、`claude install` 和 `claude doctor` 在上限以上保持工作，以便用户可以恢复。早于此设置的版本忽略它 | `"2.1.150"` |

292| `requiredMinimumVersion` | 仅 Managed 设置。启动所需的最小 Claude Code 版本。如果运行版本较旧，Claude Code 在启动时退出并指示用户通过组织的批准方法更新。`claude update`、`claude install` 和 `claude doctor` 在下限以下保持工作，以便用户可以恢复。与 `minimumVersion` 不同，后者防止降级但从不阻止启动。早于此设置的版本忽略它 | `"2.1.150"` |296| `requiredMinimumVersion` | 仅 Managed 设置。启动所需的最小 Claude Code 版本。如果运行版本较旧，Claude Code 在启动时退出并指示用户通过组织的批准方法更新。`claude update`、`claude install` 和 `claude doctor` 在下限以下保持工作，以便用户可以恢复。与 `minimumVersion` 不同，后者防止降级但从不阻止启动。早于此设置的版本忽略它 | `"2.1.150"` |

298| `respondToBashCommands` | {/* min-version: 2.1.186 */}Claude 在输入框 `!` shell 命令运行后是否响应。设置为 `false` 以将命令输出添加到上下文而不响应。默认：`true`。请参阅[带 `!` 前缀的 Shell 模式](/zh-CN/interactive-mode#shell-mode-with-prefix)。需要 Claude Code v2.1.186 或更高版本 | `false` |

295| `showThinkingSummaries` | 在交互式会话中显示[扩展思考](/zh-CN/model-config#extended-thinking)摘要。未设置或 `false`（交互模式中的默认值）时，思考块由 API 编辑并显示为折叠的存根。编辑仅改变您看到的内容，而不是模型生成的内容：要减少思考支出，[降低预算或禁用思考](/zh-CN/model-config#extended-thinking)。此设置在非交互模式（`-p`）、Agent SDK 或 IDE 扩展（如 VS Code）中无效 | `true` |300| `showThinkingSummaries` | 在交互式会话中显示[扩展思考](/zh-CN/model-config#extended-thinking)摘要。未设置或 `false`（交互模式中的默认值）时，思考块由 API 编辑并显示为折叠的存根。编辑仅改变您看到的内容，而不是模型生成的内容：要减少思考支出，[降低预算或禁用思考](/zh-CN/model-config#extended-thinking)。此设置在非交互模式（`-p`）、Agent SDK 或 IDE 扩展（如 VS Code）中无效 | `true` |

305| `strictKnownMarketplaces` | （仅 Managed 设置）插件市场源的允许列表。未定义 = 无限制，空数组 = 锁定。在市场添加和插件安装、更新、刷新和自动更新时强制执行，因此在设置策略之前添加的市场无法用于获取插件。请参阅 [Managed 市场限制](/zh-CN/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |310| `strictKnownMarketplaces` | （仅 Managed 设置）插件市场源的允许列表。未定义 = 无限制，空数组 = 锁定。在市场添加和插件安装、更新、刷新和自动更新时强制执行，因此在设置策略之前添加的市场无法用于获取插件。请参阅 [Managed 市场限制](/zh-CN/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

306| `strictPluginOnlyCustomization` | （仅 Managed 设置）阻止 skills、agents、hooks 和 MCP servers 来自用户和项目源，因此它们只能来自插件或 managed 设置。`true` 锁定所有四个表面；数组仅锁定命名的表面。请参阅 [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |311| `strictPluginOnlyCustomization` | （仅 Managed 设置）阻止 skills、agents、hooks 和 MCP servers 来自用户和项目源，因此它们只能来自插件或 managed 设置。`true` 锁定所有四个表面；数组仅锁定命名的表面。请参阅 [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

308| `teammateMode` | [agent team](/zh-CN/agent-teams) 队友的显示方式：`auto`（在 tmux 或 iTerm2 中选择分割窗格，否则进程内）、`in-process` 或 `tmux`（使用 tmux 或 iTerm2 选择分割窗格，从您的终端检测）。`--teammate-mode` 覆盖此用于一个会话。请参阅[选择显示模式](/zh-CN/agent-teams#choose-a-display-mode) | `"in-process"` |313| `teammateMode` | [agent team](/zh-CN/agent-teams) 队友的显示方式：`in-process`（默认）、`auto`（在 tmux 或 iTerm2 中选择分割窗格，否则进程内）、`tmux`（使用 tmux 或 iTerm2 选择分割窗格，从您的终端检测）或 {/* min-version: 2.1.186 */}}`iterm2`（iTerm2 本机分割窗格通过 `it2` CLI，在 v2.1.186 中添加）。默认在 v2.1.179 中从 `auto` 更改。`--teammate-mode` 覆盖此用于一个会话。请参阅[选择显示模式](/zh-CN/agent-teams#choose-a-display-mode) | `"auto"` |

310| `theme` | {/* min-version: 2.1.119 */}界面的颜色主题：`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自定义主题参考，如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。默认：`"dark"`。请参阅[创建自定义主题](/zh-CN/terminal-config#create-a-custom-theme)。在 `/config` 中显示为**主题** | `"dark"` |315| `theme` | {/* min-version: 2.1.119 */}界面的颜色主题：`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"` 或自定义主题参考，如 `"custom:<slug>"` 或 `"custom:<plugin-name>:<slug>"`。默认：`"dark"`。请参阅[创建自定义主题](/zh-CN/terminal-config#create-a-custom-theme)。在 `/config` 中显示为**主题** | `"dark"` |

311| `tui` | 终端 UI 渲染器。使用 `"fullscreen"` 获取无闪烁的[替代屏幕渲染器](/zh-CN/fullscreen)，具有虚拟化滚动条。使用 `"default"` 获取经典主屏幕渲染器。通过 `/tui` 设置。您也可以设置 [`CLAUDE_CODE_NO_FLICKER`](/zh-CN/env-vars) 环境变量。后台会话从[代理视图](/zh-CN/agent-view)打开始终使用全屏渲染器，无论此设置如何 | `"fullscreen"` |316| `tui` | 终端 UI 渲染器。使用 `"fullscreen"` 获取无闪烁的[替代屏幕渲染器](/zh-CN/fullscreen)，具有虚拟化滚动条。使用 `"default"` 获取经典主屏幕渲染器。通过 `/tui` 设置。您也可以设置 [`CLAUDE_CODE_NO_FLICKER`](/zh-CN/env-vars) 环境变量。后台会话从[代理视图](/zh-CN/agent-view)打开始终使用全屏渲染器，无论此设置如何 | `"fullscreen"` |

389配置高级 sandboxing 行为。Sandboxing 将 bash 命令与您的文件系统和网络隔离。请参阅 [Sandboxing](/zh-CN/sandboxing) 了解详情。394配置高级 sandboxing 行为。Sandboxing 将 bash 命令与您的文件系统和网络隔离。请参阅 [Sandboxing](/zh-CN/sandboxing) 了解详情。

390 395

391| 键 | 描述 | 示例 |396| 键 | 描述 | 示例 |

392| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |397| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |

394| `failIfUnavailable` | 如果 `sandbox.enabled` 为 true 但 sandbox 无法启动（缺少依赖项或不支持的平台），则在启动时以错误退出。当为 false（默认）时，显示警告，命令无 sandbox 运行。用于需要 sandboxing 作为硬门的 managed 设置部署 | `true` |399| `failIfUnavailable` | 如果 `sandbox.enabled` 为 true 但 sandbox 无法启动（缺少依赖项或不支持的平台），则在启动时以错误退出。当为 false（默认）时，显示警告，命令无 sandbox 运行。用于需要 sandboxing 作为硬门的 managed 设置部署 | `true` |

411| `network.socksProxyPort` | 如果您想自带代理，使用的 SOCKS5 代理端口。如果未指定，Claude 将运行自己的代理。 | `8081` |416| `network.socksProxyPort` | 如果您想自带代理，使用的 SOCKS5 代理端口。如果未指定，Claude 将运行自己的代理。 | `8081` |

413| `enableWeakerNetworkIsolation` | （仅 macOS）允许在 sandbox 中访问系统 TLS 信任服务（`com.apple.trustd.agent`）。对于 Go 基础工具（如 `gh`、`gcloud` 和 `terraform`）在使用 `httpProxyPort` 与 MITM 代理和自定义 CA 时验证 TLS 证书是必需的。**通过打开潜在的数据泄露路径降低安全性**。默认：false | `true` |418| `enableWeakerNetworkIsolation` | （仅 macOS）允许在 sandbox 中访问系统 TLS 信任服务（`com.apple.trustd.agent`）。对于 Go 基础工具（如 `gh`、`gcloud` 和 `terraform`）在使用 `httpProxyPort` 与 MITM 代理和自定义 CA 时验证 TLS 证书是必需的。**通过打开潜在的数据泄露路径降低安全性**。默认：false | `true` |

419| `allowAppleEvents` | （仅 macOS）允许 sandboxed 命令发送 Apple Events。对于 `open`、`osascript` 和在浏览器中打开 URL 的工具是必需的，否则会失败并显示错误 `-600`。**删除代码执行隔离。** Sandboxed 命令可以无用户提示地启动其他应用程序无 sandbox；它们也可以向运行的应用程序（如 Terminal）发送 AppleScript 命令，受每个应用程序 macOS 自动化同意提示（TCC）的约束。仅从用户、managed 或 CLI 设置受尊重，不从项目设置。默认：false | `true` |

414| `bwrapPath` | （仅 Managed 设置，Linux/WSL2）bubblewrap (`bwrap`) 二进制文件的绝对路径。覆盖通过 `PATH` 的自动检测。仅从 [managed 设置](/zh-CN/settings#settings-precedence)受尊重，不从用户或项目设置。在 managed 环境中 `bwrap` 安装在非标准位置时很有用。 | `/opt/admin/bwrap` |420| `bwrapPath` | （仅 Managed 设置，Linux/WSL2）bubblewrap (`bwrap`) 二进制文件的绝对路径。覆盖通过 `PATH` 的自动检测。仅从 [managed 设置](/zh-CN/settings#settings-precedence)受尊重，不从用户或项目设置。在 managed 环境中 `bwrap` 安装在非标准位置时很有用。 | `/opt/admin/bwrap` |

416 422

467* 拉取请求描述是纯文本473* 拉取请求描述是纯文本

468 474

469| 键 | 描述 |475| 键 | 描述 |

470| :------- | :--------------------------------- |476| :----------- | :------------------------------------------------------------------------------------------------------------- |

472| `pr` | 拉取请求描述的归属。空字符串隐藏拉取请求归属 |478| `pr` | 拉取请求描述的归属。空字符串隐藏拉取请求归属 |

479| `sessionUrl` | 当从 web 或远程控制会话运行时，是否将 claude.ai 会话链接作为提交上的 `Claude-Session` trailer 和拉取请求描述中的链接附加。默认为 `true`。设置为 `false` 以省略链接 |

473 480

474**默认提交归属：**481**默认提交归属：**

475 482

497```504```

498 505

499<Note>506<Note>

500 `attribution` 设置优先于已弃用的 `includeCoAuthoredBy` 设置。要隐藏所有归属，将 `commit` 和 `pr` 设置为空字符串。507 `attribution` 设置优先于已弃用的 `includeCoAuthoredBy` 设置。要隐藏所有归属，将 `commit` 和 `pr` 设置为空字符串，并将 `sessionUrl` 设置为 `false`。

501</Note>508</Note>

502 509

503<h3 id="file-suggestion-settings">510<h3 id="file-suggestion-settings">

678 685

679`Setting sources` 行确认正在读取哪些源。它不显示哪一层提供了每个单独的键。同一对话框中的**配置**选项卡是一个编辑器，用于一组固定的切换，例如主题和详细输出，而不是您的 `settings.json` 内容的视图。686`Setting sources` 行确认正在读取哪些源。它不显示哪一层提供了每个单独的键。同一对话框中的**配置**选项卡是一个编辑器，用于一组固定的切换，例如主题和详细输出，而不是您的 `settings.json` 内容的视图。

680 687

681如果设置文件包含错误，例如无效的 JSON 或验证失败的值，Claude Code 在启动时显示设置问题通知，`/status` 列出受影响的文件。运行 `/doctor` 以查看每个错误的详情。688如果设置文件包含错误，例如无效的 JSON 或验证失败的值，`/status` 列出受影响的文件。运行 `/doctor` 以查看每个错误的详情。

682 689

683<h3 id="key-points-about-the-configuration-system">690<h3 id="key-points-about-the-configuration-system">

684 配置系统的关键点691 配置系统的关键点

skills.md +38 −1

Details

173 173

174`--add-dir` 标志和 `/add-dir` 命令[授予文件访问权限](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)而不是配置发现，但 skills 是一个例外：添加目录中的 `.claude/skills/` 会自动加载。此例外仅适用于 `--add-dir` 和 `/add-dir`。`settings.json` 中的 `permissions.additionalDirectories` 设置仅授予文件访问权限，不加载 skills。请参阅[实时变更检测](#live-change-detection)了解编辑如何在会话期间被拾取。174`--add-dir` 标志和 `/add-dir` 命令[授予文件访问权限](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)而不是配置发现，但 skills 是一个例外：添加目录中的 `.claude/skills/` 会自动加载。此例外仅适用于 `--add-dir` 和 `/add-dir`。`settings.json` 中的 `permissions.additionalDirectories` 设置仅授予文件访问权限，不加载 skills。请参阅[实时变更检测](#live-change-detection)了解编辑如何在会话期间被拾取。

175 175

176其他 `.claude/` 配置（如 subagents、命令和输出样式）不会从其他目录加载。有关加载和不加载的完整列表以及跨项目共享配置的推荐方式，请参阅[例外表](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)。176其他 `.claude/` 配置（如命令和输出样式）不会从其他目录加载。有关加载和不加载的完整列表以及跨项目共享配置的推荐方式，请参阅[例外表](/zh-CN/permissions#additional-directories-grant-file-access-not-configuration)。

177 177

178<Note>178<Note>

179 来自 `--add-dir` 目录的 CLAUDE.md 文件默认不加载。要加载它们，请设置 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`。请参阅[从其他目录加载](/zh-CN/memory#load-from-additional-directories)。179 来自 `--add-dir` 目录的 CLAUDE.md 文件默认不加载。要加载它们，请设置 `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`。请参阅[从其他目录加载](/zh-CN/memory#load-from-additional-directories)。

632 632

633插件 skills 不受 `skillOverrides` 影响。通过 `/plugin` 管理这些。633插件 skills 不受 `skillOverrides` 影响。通过 `/plugin` 管理这些。

634 634

635<h2 id="evaluate-and-iterate-on-a-skill">

636 评估和迭代 skill

637</h2>

638

639看到 skill 触发告诉你 Claude 找到了它，而不是它做了你想要的。要知道 skill 是否有效，分别测量两件事：Claude 是否在它应该的提示上调用它，以及当它确实调用时输出是否与你期望的相匹配。

640

641两者的检查都是基线比较。收集一些现实的提示，在一个新会话中运行每个提示，skill 可用，然后再次运行它[禁用](#override-skill-visibility-from-settings)，并比较结果。新会话很重要，因为编写 skill 的剩余上下文会掩盖书面说明中的差距。

642

643<h3 id="run-evals-with-skill-creator">

644 使用 skill-creator 运行 evals

645</h3>

646

647[`skill-creator` 插件](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/skill-creator)在 Claude Code 内自动化比较循环。从官方市场安装它：

648

649```text theme={null}

650/plugin install skill-creator@claude-plugins-official

651```

652

653如果 Claude Code 报告在任何市场中找不到该插件，你的市场要么缺失，要么已过期。运行 `/plugin marketplace update claude-plugins-official` 来刷新它，或 `/plugin marketplace add anthropics/claude-plugins-official`（如果你之前没有添加过）。然后重试安装。

654

655安装后，运行 `/reload-plugins` 以在当前会话中使插件的 skills 可用。然后要求 Claude 评估现有 skill，例如 `evaluate my summarize-changes skill with skill-creator`。该插件引导你编写测试用例并运行循环：

656

657* **测试用例**：在 skill 目录内的 `evals/evals.json` 中存储提示、输入文件和预期行为

658* **隔离运行**：为每个测试用例生成一个 [subagent](/zh-CN/sub-agents)，以便每次运行都从干净的上下文开始，并记录令牌计数和持续时间

659* **评分**：检查每个断言与输出，并将通过或失败与证据写入 `grading.json`

660* **基准**：将通过率、时间和令牌聚合为有 skill 与无 skill 的情况，放入 `benchmark.json`，以便你可以将通过率改进与令牌和时间开销进行比较

661* **版本比较**：在两个版本的 skill 之间运行盲 A/B，以便你可以在提交之前确认编辑是一个改进

662* **描述调整**：生成应该触发和不应该触发的提示，测量命中率，并在 skill 在错误的请求上激活时提议描述编辑

663* **审查查看器**：打开一个 HTML 报告，你可以在其中检查每个输出并记录定性反馈，下一次迭代会读取

664

665对于 eval 文件格式和完整迭代工作流，请参阅 agentskills.io 上的[评估 skill 输出质量](https://agentskills.io/skill-creation/evaluating-skills)。有关基准和比较模式的背景，请参阅 [skill-creator 公告](https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills)。

666

635<h2 id="share-skills">667<h2 id="share-skills">

636 共享 skills668 共享 skills

637</h2>669</h2>

8503. 尝试重新表述你的请求以更接近描述8823. 尝试重新表述你的请求以更接近描述

8514. 如果 skill 是用户可调用的，使用 `/skill-name` 直接调用它8834. 如果 skill 是用户可调用的，使用 `/skill-name` 直接调用它

852 884

885如果 frontmatter YAML 格式不正确，Claude Code 会加载 skill 主体但元数据为空，因此 `/skill-name` 仍然有效，但 Claude 没有 `description` 来匹配。使用 `--debug` 运行以查看解析错误。

886

853<h3 id="skill-triggers-too-often">887<h3 id="skill-triggers-too-often">

854 Skill 触发过于频繁888 Skill 触发过于频繁

855</h3>889</h3>

872</h2>906</h2>

873 907

874* **[调试你的配置](/zh-CN/debug-your-config)**：诊断为什么 skill 没有出现或触发908* **[调试你的配置](/zh-CN/debug-your-config)**：诊断为什么 skill 没有出现或触发

909* **[在 agentskills.io 上评估 skill 输出质量](https://agentskills.io/skill-creation/evaluating-skills)**：eval 文件格式和迭代工作流

910* **[Skill 创作最佳实践](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**：适用于 Claude 产品的写作指导

875* **[Subagents](/zh-CN/sub-agents)**：将任务委派给专门的代理911* **[Subagents](/zh-CN/sub-agents)**：将任务委派给专门的代理

876* **[Plugins](/zh-CN/plugins)**：打包和分发 skills 与其他扩展912* **[Plugins](/zh-CN/plugins)**：打包和分发 skills 与其他扩展

877* **[Hooks](/zh-CN/hooks)**：围绕工具事件自动化工作流913* **[Hooks](/zh-CN/hooks)**：围绕工具事件自动化工作流

878* **[Memory](/zh-CN/memory)**：管理 CLAUDE.md 文件以获得持久上下文914* **[Memory](/zh-CN/memory)**：管理 CLAUDE.md 文件以获得持久上下文

879* **[Commands](/zh-CN/commands)**：内置命令和捆绑 skills 的参考915* **[Commands](/zh-CN/commands)**：内置命令和捆绑 skills 的参考

880* **[Permissions](/zh-CN/permissions)**：控制工具和 skill 访问916* **[Permissions](/zh-CN/permissions)**：控制工具和 skill 访问

917* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**：提交到仓库的项目 skills 在该仓库在 Claude Tag 频道中使用时也会加载

slack.md +15 −1

Details

6 6

7> 直接从 Slack 工作区委派编码任务7> 直接从 Slack 工作区委派编码任务

8 8

9<Note>

10 Slack 中的 Claude Code 正在被 [Claude Tag](https://claude.com/docs/claude-tag/overview) 替代，用于 Team 和 Enterprise 工作区。Claude Tag 以您组织的共享身份运行 @Claude，具有管理员配置的访问权限，在同一 Slack 应用下运行，因此无需重新安装，现有设置在过渡期间继续工作。要切换工作区，请参阅 [从早期 Claude in Slack 迁移](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)。

11</Note>

9Slack 中的 Claude Code 将 Claude Code 的强大功能直接引入您的 Slack 工作区。当您使用编码任务提及 `@Claude` 时，Claude 会自动检测意图并在网络上创建 Claude Code 会话，允许您在不离开团队对话的情况下委派开发工作。13Slack 中的 Claude Code 将 Claude Code 的强大功能直接引入您的 Slack 工作区。当您使用编码任务提及 `@Claude` 时，Claude 会自动检测意图并在网络上创建 Claude Code 会话，允许您在不离开团队对话的情况下委派开发工作。

10 14

~~11此集成基于现有的 Claude for Slack 应用程序构建，但为与编码相关的请求添加了到网络上 Claude Code 的智能路由。~~15此集成基于现有的 Claude for Slack 应用程序构建，但为与编码相关的请求添加了到网络上 Claude Code 的智能路由。每个会话在您自己的 Claude 账户下运行，使用您连接的存储库和您的计划限制。

12 16

13<h2 id="use-cases">17<h2 id="use-cases">

14 用例18 用例

217 故障排除221 故障排除

218</h2>222</h2>

219 223

224<h3 id="claude-code-is-not-enabled-for-your-account">

225 "Claude Code 未为您的账户启用"

226</h3>

227

228此错误意味着您的 Claude 账户还没有云环境，而不是管理员需要启用任何内容。使用连接到 Slack 的同一账户在 [claude.ai/code](https://claude.ai/code) 登录一次。首次访问会创建您的默认云环境，错误将在您下次提及时清除。每个用户必须单独执行此操作。

229

220<h3 id="sessions-not-starting">230<h3 id="sessions-not-starting">

221 会话未启动231 会话未启动

222</h3>232</h3>

277 Claude for Slack 常规文档287 Claude for Slack 常规文档

278 </Card>288 </Card>

279 289

290 <Card title="Claude Tag" icon="users" href="https://claude.com/docs/claude-tag/overview">

291 Slack 中由组织管理的 @Claude，具有管理员配置的访问权限

292 </Card>

293

280 <Card title="Slack 应用程序市场" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">294 <Card title="Slack 应用程序市场" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">

281 从 Slack 市场安装 Claude 应用程序295 从 Slack 市场安装 Claude 应用程序

282 </Card>296 </Card>

statusline.md +1 −1

Details

15* 你在多个会话中工作，需要区分它们15* 你在多个会话中工作，需要区分它们

16* 你希望 git 分支和状态始终可见16* 你希望 git 分支和状态始终可见

17 17

18Claude Code 还可以呈现[页脚链接徽章](/zh-CN/settings#footer-link-badges)：当配置的正则表达式与对话中的文本匹配时出现的可点击芯片。这些独立于状态行，不与你的脚本交互；请改用 [`footerLinksRegexes`](/zh-CN/settings#footer-link-badges) 设置来配置它们。18状态行在其自己的行中呈现，位于内置页脚徽章上方，不会替换它们。要在对话中出现 ID 时向页脚添加可点击的链接徽章，而无需编写脚本，请改为配置 [`footerLinksRegexes`](/zh-CN/settings#footer-link-badges)。

19 19

20这是一个[多行状态行](#display-multiple-lines)的示例，它在第一行显示 git 信息，在第二行显示颜色编码的上下文栏。20这是一个[多行状态行](#display-multiple-lines)的示例，它在第一行显示 git 信息，在第二行显示颜色编码的上下文栏。

21 21

sub-agents.md +6 −11

Details

765Subagents 可以在前台（阻塞）或后台（并发）运行：765Subagents 可以在前台（阻塞）或后台（并发）运行：

766 766

767* **前台 subagents** 阻塞主对话直到完成。权限提示会在出现时传递给您。767* **前台 subagents** 阻塞主对话直到完成。权限提示会在出现时传递给您。

768* **后台 subagents** 在您继续工作时并发运行。它们使用会话中已授予的权限运行，并自动拒绝任何会提示的工具调用。如果后台 subagent 需要提出澄清问题，该工具调用失败，但 subagent 继续。768* **后台 subagents** 在您继续工作时并发运行。{/* min-version: 2.1.186 */}从 v2.1.186 开始，当后台 subagent 到达需要权限的工具调用时，提示会在您的主会话中显示，并命名正在请求的 subagent。批准以让 subagent 继续，或按 Esc 拒绝该单个工具调用而不停止 subagent。在 v2.1.186 之前，后台 subagents 自动拒绝任何会提示的工具调用。

~~769~~

770如果后台 subagent 由于缺少权限而失败，您可以启动一个新的前台 subagent 来执行相同的任务以使用交互式提示重试。

771 769

772Claude 根据任务决定是否在前台或后台运行 subagents。您也可以：770Claude 根据任务决定是否在前台或后台运行 subagents。您也可以：

773 771

776 774

777要禁用所有后台任务功能，请将 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 环境变量设置为 `1`。请参阅 [Environment variables](/zh-CN/env-vars)。775要禁用所有后台任务功能，请将 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 环境变量设置为 `1`。请参阅 [Environment variables](/zh-CN/env-vars)。

778 776

779当 [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) 设置为 `1` 时，每个 subagent 生成都在后台运行，无论 `background` 字段如何。分叉仍然在您的终端中出现权限提示；命名 subagents 自动拒绝任何会提示的内容，如上所述。777当 [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) 设置为 `1` 时，每个 subagent 生成都在后台运行，无论 `background` 字段如何。这些后台 subagents 的权限提示会在您的主会话中显示，如上所述。

780 778

781<h3 id="common-patterns">779<h3 id="common-patterns">

782 常见模式780 常见模式

849 847

850嵌套 subagent 的配置方式与顶级 subagent 相同，并从相同的 [scopes](#choose-the-subagent-scope) 解析。提示输入下方的 subagent 面板显示完整的树：每行显示后代的 `(+N)` 计数，打开一行显示该 subagent 的直接子代，带有返回到 `main` 的路径。[`/agents`](#use-the-%2Fagents-command) 中的 Running 选项卡将运行中的 subagents 列为平面列表。848嵌套 subagent 的配置方式与顶级 subagent 相同，并从相同的 [scopes](#choose-the-subagent-scope) 解析。提示输入下方的 subagent 面板显示完整的树：每行显示后代的 `(+N)` 计数，打开一行显示该 subagent 的直接子代，带有返回到 `main` 的路径。[`/agents`](#use-the-%2Fagents-command) 中的 Running 选项卡将运行中的 subagents 列为平面列表。

851 849

852深度计算为主对话下方的 subagent 级别数，无论每个级别是否在 [前台或后台](#run-subagents-in-foreground-or-background) 运行：850深度计算为主对话下方的 subagent 级别数，无论每个级别是否在 [前台或后台](#run-subagents-in-foreground-or-background) 运行。深度为五的 subagent 不接收 Agent 工具，无法进一步生成。限制是固定的且不可配置。

~~853~~

854* **前台 subagents**：可以在任何深度生成。每个级别阻塞其父级直到返回，所以链是自限制的：主对话等待整个链。

855* **后台 subagents**：深度为五的后台 subagent 不接收 Agent 工具，无法进一步生成。限制是固定的且不可配置，存在是为了防止失控的并发树。

856 851

857要防止特定 subagent 生成其他 subagents，从其 [`tools`](#available-tools) 列表中省略 `Agent` 或将其添加到 `disallowedTools`。852要防止特定 subagent 生成其他 subagents，从其 [`tools`](#available-tools) 列表中省略 `Agent` 或将其添加到 `disallowedTools`。

858 853

888 883

889恢复的 subagents 保留其完整的对话历史，包括所有以前的工具调用、结果和推理。Subagent 从它停止的地方继续，而不是从头开始。884恢复的 subagents 保留其完整的对话历史，包括所有以前的工具调用、结果和推理。Subagent 从它停止的地方继续，而不是从头开始。

890 885

891当 subagent 完成时，Claude 接收其代理 ID。内置的 Explore 和 Plan 代理是一次性的，不返回代理 ID，所以它们无法恢复；当您需要继续工作时，使用 `general-purpose` 或自定义 subagent。Claude 使用 `SendMessage` 工具，将代理的 ID 作为 `to` 字段来恢复它。`SendMessage` 工具仅在通过 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 启用 [agent teams](/zh-CN/agent-teams) 时可用。886当 subagent 完成时，Claude 接收其代理 ID。内置的 Explore 和 Plan 代理是一次性的，不返回代理 ID，所以它们无法恢复；当您需要继续工作时，使用 `general-purpose` 或自定义 subagent。Claude 使用 `SendMessage` 工具，将代理的 ID 作为 `to` 字段来恢复它。`SendMessage` 工具始终可用于通过代理 ID 或名称恢复 subagents。结构化的团队协议消息，例如 `shutdown_request` 和 `plan_approval_response`，需要启用 [agent teams](/zh-CN/agent-teams)。

892 887

893要恢复 subagent，要求 Claude 继续之前的工作：888要恢复 subagent，要求 Claude 继续之前的工作：

894 889

976分叉继承主会话在生成时拥有的一切。命名 subagent 从自己的定义开始。971分叉继承主会话在生成时拥有的一切。命名 subagent 从自己的定义开始。

977 972

978| | 分叉 | 命名 subagent |973| | 分叉 | 命名 subagent |

979| :----------- | :--------- | :--------------------------------------------------------------- |974| :----------- | :--------- | :-------------------------------------------------------------- |

980| 上下文 | 完整的对话历史 | 新鲜上下文，带有您传递的提示 |975| 上下文 | 完整的对话历史 | 新鲜上下文，带有您传递的提示 |

982| 模型 | 与主会话相同 | 来自 subagent 的 `model` 字段 |977| 模型 | 与主会话相同 | 来自 subagent 的 `model` 字段 |

983| 权限 | 提示在您的终端中出现 | [Auto-denied](#run-subagents-in-foreground-or-background) 在后台运行时 |978| 权限 | 提示在您的终端中出现 | [提示在后台运行时在您的主会话中出现](#run-subagents-in-foreground-or-background) |

985 980

986因为分叉的系统提示和工具定义与父级相同，其第一个请求重用父级的 [prompt cache](/zh-CN/prompt-caching#subagents-and-the-cache)。这使得分叉比为需要相同上下文的任务生成新 subagent 更便宜。981因为分叉的系统提示和工具定义与父级相同，其第一个请求重用父级的 [prompt cache](/zh-CN/prompt-caching#subagents-and-the-cache)。这使得分叉比为需要相同上下文的任务生成新 subagent 更便宜。

tools-reference.md +3 −2

Details

13| 工具 | 描述 | 需要权限 |13| 工具 | 描述 | 需要权限 |

14| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--- |14| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--- |

15| `Agent` | 生成一个具有自己 context window 的 [subagent](/zh-CN/sub-agents)，用于处理任务。请参阅 [Agent 工具行为](#agent-tool-behavior) | 否 |15| `Agent` | 生成一个具有自己 context window 的 [subagent](/zh-CN/sub-agents)，用于处理任务。请参阅 [Agent 工具行为](#agent-tool-behavior) | 否 |

16| `Artifact` | 将 HTML 或 Markdown 文件发布为 [artifact](/zh-CN/artifacts)：一个私有的、交互式的 claude.ai 页面，您可以在组织内共享。{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}需要 Team 或 Enterprise 计划和 `/login` 身份验证；请参阅[可用性](/zh-CN/artifacts#availability) | 是 |

16| `AskUserQuestion` | 提出多选问题以收集需求或澄清歧义 | 否 |17| `AskUserQuestion` | 提出多选问题以收集需求或澄清歧义 | 否 |

17| `Bash` | 在您的环境中执行 shell 命令。请参阅 [Bash 工具行为](#bash-tool-behavior) | 是 |18| `Bash` | 在您的环境中执行 shell 命令。请参阅 [Bash 工具行为](#bash-tool-behavior) | 是 |

18| `CronCreate` | 在当前会话中安排定期或一次性提示。任务是会话范围的，在 `--resume` 或 `--continue` 时如果未过期则会恢复。请参阅[计划任务](/zh-CN/scheduled-tasks) | 否 |19| `CronCreate` | 在当前会话中安排定期或一次性提示。任务是会话范围的，在 `--resume` 或 `--continue` 时如果未过期则会恢复。请参阅[计划任务](/zh-CN/scheduled-tasks) | 否 |

35| `ReadMcpResourceTool` | 按 URI 读取特定 MCP 资源 | 否 |36| `ReadMcpResourceTool` | 按 URI 读取特定 MCP 资源 | 否 |

36| `RemoteTrigger` | 在 claude.ai 上创建、更新、运行和列出 [Routines](/zh-CN/routines)。支持 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 存在于 claude.ai 上，需要 Pro、Max、Team 或 Enterprise 计划，因此此工具无法从 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 访问 | 否 |37| `RemoteTrigger` | 在 claude.ai 上创建、更新、运行和列出 [Routines](/zh-CN/routines)。支持 `/schedule` 命令。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Routines 存在于 claude.ai 上，需要 Pro、Max、Team 或 Enterprise 计划，因此此工具无法从 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 访问 | 否 |

37| `ScheduleWakeup` | 重新安排 [self-paced `/loop`](/zh-CN/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代结束时调用此工具以选择下一次运行的时间，范围在一分钟到一小时之间；您不需要直接调用它。待处理的唤醒显示在 [Stop hook input](/zh-CN/hooks#stop-input) 中的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用，其中没有间隔的 `/loop` 提示按固定时间表运行 | 否 |38| `ScheduleWakeup` | 重新安排 [self-paced `/loop`](/zh-CN/scheduled-tasks#let-claude-choose-the-interval) 的下一次迭代。Claude 在每次迭代结束时调用此工具以选择下一次运行的时间，范围在一分钟到一小时之间；您不需要直接调用它。待处理的唤醒显示在 [Stop hook input](/zh-CN/hooks#stop-input) 中的 `session_crons` 中。{/* plan-availability: feature=loop-dynamic providers=anthropic */}在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用，其中没有间隔的 `/loop` 提示按固定时间表运行 | 否 |

38| `SendMessage` | 向 [agent team](/zh-CN/agent-teams) 队友发送消息，或按 agent ID [恢复 subagent](/zh-CN/sub-agents#resume-subagents)。已停止的 subagents 在后台自动恢复。仅当设置了 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 时可用 | 否 |39| `SendMessage` | 向 [agent team](/zh-CN/agent-teams) 队友发送消息，或按 agent ID [恢复 subagent](/zh-CN/sub-agents#resume-subagents)。已停止的 subagents 在后台自动恢复。结构化的团队协议消息需要 agent teams | 否 |

39| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上传 `ONBOARDING.md` 并返回队友可以在 Claude Code 中打开的共享链接。在编写指南后从 `/team-onboarding` 调用。适用于 Pro、Max、Team 和 Enterprise 计划上的 claude.ai 订阅者 | 是 |40| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}上传 `ONBOARDING.md` 并返回队友可以在 Claude Code 中打开的共享链接。在编写指南后从 `/team-onboarding` 调用。适用于 Pro、Max、Team 和 Enterprise 计划上的 claude.ai 订阅者 | 是 |

40| `Skill` | 在主对话中执行 [skill](/zh-CN/skills#control-who-invokes-a-skill) | 是 |41| `Skill` | 在主对话中执行 [skill](/zh-CN/skills#control-who-invokes-a-skill) | 是 |

41| `TaskCreate` | 在任务列表中创建新任务 | 否 |42| `TaskCreate` | 在任务列表中创建新任务 | 否 |

102启动 subagent 本身不会提示权限。subagent 自己的工具调用在运行时根据您的权限规则进行检查：103启动 subagent 本身不会提示权限。subagent 自己的工具调用在运行时根据您的权限规则进行检查：

103 104

104* **前台 subagents** 显示您在主对话中会看到的相同权限提示，在每个工具调用发生时。105* **前台 subagents** 显示您在主对话中会看到的相同权限提示，在每个工具调用发生时。

105* **后台 subagents** 不显示提示。它们使用会话中已授予的权限运行，并自动拒绝任何会提示的工具调用。拒绝后，subagent 继续运行而不使用该工具。106* **后台 subagents** {/* min-version: 2.1.186 */}从 v2.1.186 起在您的主会话中显示权限提示。提示会指出是哪个 subagent 在请求，按 Esc 会拒绝该工具调用而不停止 subagent。在 v2.1.186 之前，后台 subagents 会自动拒绝任何会提示的工具调用并继续运行而不使用该工具。

106 107

107要首先限制 subagent 可以访问的内容，请缩小其 `tools` 字段，将 Bash 排除在列表之外，或在设置中设置拒绝规则，如[控制 subagent 功能](/zh-CN/sub-agents#control-subagent-capabilities)中所述。有关选择前台或后台的更多信息，请参阅[在前台或后台运行 subagents](/zh-CN/sub-agents#run-subagents-in-foreground-or-background)。108要首先限制 subagent 可以访问的内容，请缩小其 `tools` 字段，将 Bash 排除在列表之外，或在设置中设置拒绝规则，如[控制 subagent 功能](/zh-CN/sub-agents#control-subagent-capabilities)中所述。有关选择前台或后台的更多信息，请参阅[在前台或后台运行 subagents](/zh-CN/sub-agents#run-subagents-in-foreground-or-background)。

108 109

ultrareview.md +16 −13

Details

12 12

13Ultrareview 是在 Claude Code 网络基础设施上运行的深度代码审查。当您运行 `/code-review ultra` 时，Claude Code 在远程沙箱中启动一队审查代理来查找您的分支或拉取请求中的错误。13Ultrareview 是在 Claude Code 网络基础设施上运行的深度代码审查。当您运行 `/code-review ultra` 时，Claude Code 在远程沙箱中启动一队审查代理来查找您的分支或拉取请求中的错误。

14 14

~~15与本地 `/review` 相比，ultrareview 提供：~~15与本地 `/code-review` 或 `/review` 相比，ultrareview 提供：

16 16

17* **更高的信号质量**：每个报告的发现都经过独立复现和验证，因此结果专注于真实的错误而不是风格建议17* **更高的信号质量**：每个报告的发现都经过独立复现和验证，因此结果专注于真实的错误而不是风格建议

~~18* **更广泛的覆盖范围**：许多审查代理并行探索更改，这会发现单次审查可能遗漏的问题~~18* **更广泛的覆盖范围**：许多审查代理并行探索更改，这会发现中等工作量的本地审查可能遗漏的问题

19* **无本地资源使用**：审查完全在远程沙箱中运行，因此您的终端在运行时保持空闲，可用于其他工作19* **无本地资源使用**：审查完全在远程沙箱中运行，因此您的终端在运行时保持空闲，可用于其他工作

20 20

21Ultrareview 需要使用 Claude.ai 账户进行身份验证，因为它在 Claude Code 网络基础设施上运行。如果您仅使用 API 密钥登录，请先运行 `/login` 并使用 Claude.ai 进行身份验证。当使用 Claude Code 与 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时，Ultrareview 不可用，对于已启用零数据保留的组织也不可用。21Ultrareview 需要使用 Claude.ai 账户进行身份验证，因为它在 Claude Code 网络基础设施上运行。如果您仅使用 API 密钥登录，请先运行 `/login` 并使用 Claude.ai 进行身份验证。当使用 Claude Code 与 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry 时，Ultrareview 不可用，对于已启用零数据保留的组织也不可用。

42 42

43<Tip>43<Tip>

44 如果您的存储库太大而无法捆绑，Claude Code 会提示您改用 PR 模式。推送您的分支并打开草稿 PR，然后运行 `/code-review ultra <PR-number>`。44 如果您的存储库太大而无法捆绑，Claude Code 会提示您改用 PR 模式。推送您的分支并打开草稿 PR，然后运行 `/code-review ultra <PR-number>`。

46 如果拉取请求的差异太大，Claude Code 会在任何审查工作运行之前以范围提示拒绝审查。

45</Tip>47</Tip>

46 48

47启动前，Claude Code 显示一个确认对话框，其中包含审查范围（包括审查分支时的文件和行数）、您剩余的免费运行次数和估计成本。确认后，审查在后台继续进行，您可以继续使用您的会话。该命令仅在您使用 `/code-review ultra` 调用时运行；Claude 不会自动启动 ultrareview。49启动前，Claude Code 显示一个确认对话框，其中包含审查范围（包括审查分支时的文件和行数）、您剩余的免费运行次数和估计成本。确认后，审查在后台继续进行，您可以继续使用您的会话。该命令仅在您使用 `/code-review ultra` 调用时运行；Claude 不会自动启动 ultrareview。

95 97

96对于 GitHub 拉取请求上的自动审查，[Code Review](/zh-CN/code-review) 直接与您的存储库集成，并将发现作为内联 PR 注释发布，无需 CLI 步骤。98对于 GitHub 拉取请求上的自动审查，[Code Review](/zh-CN/code-review) 直接与您的存储库集成，并将发现作为内联 PR 注释发布，无需 CLI 步骤。

97 99

~~98<h2 id="how-ultrareview-compares-to-/review">~~100<h2 id="how-ultrareview-compares-to-/code-review-and-/review">

~~99 ultrareview 与 /review 的比较~~101 ultrareview 与 /code-review 和 /review 的比较

100</h2>102</h2>

101 103

102两个命令都审查代码，但它们针对工作流的不同阶段。104所有三个命令都审查代码，但它们针对工作流的不同阶段。

103 105

105| ---- | ---------- | ------------------------------- |107| ---- | -------------- | -------------------- | ------------------------------- |

109| 成本 | 计入正常使用量 | 免费运行，然后大约 \$5 到 \$20 每次审查作为使用额度 |111| 持续时间 | 几秒到几分钟 | 几分钟 | 大约 5 到 10 分钟 |

110| 最适合 | 迭代时的快速反馈 | 合并前对重大更改的信心 |112| 成本 | 计入正常使用量 | 计入正常使用量 | 免费运行，然后大约 \$5 到 \$20 每次审查作为使用额度 |

113| 最适合 | 迭代时的快速反馈 | 在批准前审查团队成员的 PR | 合并前对重大更改的信心 |

111 114

112使用 `/review` 在工作时获得快速反馈。在合并重大更改前使用 `/code-review ultra`，当您想要更深入的审查来捕捉单次审查可能遗漏的问题时。115使用 `/code-review` 获得工作时的快速反馈。使用 `/review <pr>` 查看 pull request，就像您在批准前所做的那样。在合并重大更改前使用 `/code-review ultra`，当您想要更深入的审查来捕捉单次审查可能遗漏的问题时。

113 116

114<h2 id="related-resources">117<h2 id="related-resources">

115 相关资源118 相关资源

whats-new/2026-w24.md +1 −1

Details

34 <span className="digest-feature-pill">v2.1.172</span>34 <span className="digest-feature-pill">v2.1.172</span>

35 </div>35 </div>

36 36

37 <p className="digest-feature-lede">子代理现在可以生成自己的子代理。提示下方的子代理面板显示完整的树：每一行都包含其后代的计数和返回到 <code>main</code> 的路径。后台子代理的深度限制为五级，以防止失控的并发树；前台链可以在任何深度生成，并且是自限制的。</p>37 <p className="digest-feature-lede">子代理现在可以生成自己的子代理。提示下方的子代理面板显示完整的树：每一行都包含其后代的计数和返回到 <code>main</code> 的路径。子代理链的深度限制为五级，以防止失控的并发树。</p>

38 38

39 <p className="digest-feature-try">打开代理视图以观看嵌套树的工作展开：</p>39 <p className="digest-feature-try">打开代理视图以观看嵌套树的工作展开：</p>

40 40

workflows.md +3 −2

Details

105进度视图显示每个阶段及其代理计数、令牌总数和经过的时间。页脚列出每个操作的键：105进度视图显示每个阶段及其代理计数、令牌总数和经过的时间。页脚列出每个操作的键：

106 106

107| 键 | 操作 |107| 键 | 操作 |

108| :------------ | :------------------------------------------ |108| :------------ | :-------------------------------------------------- |

109| `↑` / `↓` | 选择一个阶段或代理 |109| `↑` / `↓` | 选择一个阶段或代理 |

111| `Esc` | 返回一个级别 |111| `Esc` | 返回一个级别 |

112| `j` / `k` | 当代理详情溢出时在其中滚动 |112| `j` / `k` | 当代理详情溢出时在其中滚动 |

113| `f` | {/* min-version: 2.1.186 */}按状态过滤选定阶段中的代理列表。再次按下以循环 |

113| `p` | 暂停或恢复运行 |114| `p` | 暂停或恢复运行 |

114| `x` | 停止选定的代理，或当焦点在运行上时停止整个工作流 |115| `x` | 停止选定的代理，或当焦点在运行上时停止整个工作流 |

115| `r` | 重启选定的运行中代理 |116| `r` | 重启选定的运行中代理 |

198 199

199按 Enter 保存。工作流在未来会话中从任一位置作为 `/<name>` 运行。200按 Enter 保存。工作流在未来会话中从任一位置作为 `/<name>` 运行。

200 201

201{/* min-version: 2.1.178 */}截至 v2.1.178，保存到项目位置会写入您的工作目录和仓库根之间已存在的最近的 `.claude/workflows/` 目录，或如果尚不存在则写入仓库根。项目工作流也从该路径上的每个 `.claude/workflows/` 加载，当多个定义相同名称时 Claude Code 运行最接近工作目录的那个。202{/* min-version: 2.1.178 */}在具有多个 `.claude/` 目录的单体仓库中，您可以将工作流保存在它们适用的包旁边。截至 v2.1.178，保存到项目位置会写入您的工作目录和仓库根之间已存在的最近的 `.claude/workflows/` 目录，或如果尚不存在则写入仓库根。项目工作流也从该路径上的每个 `.claude/workflows/` 加载，当多个定义相同名称时 Claude Code 运行最接近工作目录的那个。

202 203

203如果项目工作流和个人工作流共享名称，项目工作流运行。204如果项目工作流和个人工作流共享名称，项目工作流运行。

204 205

zero-data-retention.md +2 −1

Details

58当为 Claude for Enterprise 上的 Claude Code 组织启用 ZDR 时，某些需要存储提示或完成的功能会在后端级别自动禁用：58当为 Claude for Enterprise 上的 Claude Code 组织启用 ZDR 时，某些需要存储提示或完成的功能会在后端级别自动禁用：

59 59

60| 功能 | 原因 |60| 功能 | 原因 |

~~61| -------------------------------------------------- | ------------------------ |~~61| -------------------------------------------------- | --------------------------------- |

62| [网络上的 Claude Code](/zh-CN/claude-code-on-the-web) | 需要服务器端存储对话历史。 |62| [网络上的 Claude Code](/zh-CN/claude-code-on-the-web) | 需要服务器端存储对话历史。 |

63| 来自 Desktop 应用的[云会话](/zh-CN/desktop#cloud-sessions) | 需要包含提示和完成的持久会话数据。 |63| 来自 Desktop 应用的[云会话](/zh-CN/desktop#cloud-sessions) | 需要包含提示和完成的持久会话数据。 |

64| [Artifacts](/zh-CN/artifacts) | 需要在 Anthropic 运营的基础设施上存储已发布的页面内容。 |

64| 反馈提交 (`/feedback`) | 提交反馈会将对话数据发送给 Anthropic。 |65| 反馈提交 (`/feedback`) | 提交反馈会将对话数据发送给 Anthropic。 |

65 66

66这些功能在后端被阻止，无论客户端显示如何。如果您在启动期间在 Claude Code 终端中看到禁用的功能，尝试使用它会返回一个错误，指示组织的政策不允许该操作。67这些功能在后端被阻止，无论客户端显示如何。如果您在启动期间在 Claude Code 终端中看到禁用的功能，尝试使用它会返回一个错误，指示组织的政策不允许该操作。

Documentation 2026-06-22 23:59 UTC to 2026-06-23 22:00 UTC