Documentation — Spybara

admin-setup.md +1 −1

Details

97| [MCP 服务器控制](https://code.claude.com/docs/zh-CN/managed-mcp.md) | 限制用户可以添加或连接哪些 MCP 服务器、部署一组固定的服务器，或在用户自有服务器之外为每个用户提供远程服务器 | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`，或已部署的 `managed-mcp.json` 文件 |97| [MCP 服务器控制](https://code.claude.com/docs/zh-CN/managed-mcp.md) | 限制用户可以添加或连接哪些 MCP 服务器、部署一组固定的服务器，或在用户自有服务器之外为每个用户提供远程服务器 | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`，或已部署的 `managed-mcp.json` 文件 |

98| [插件市场控制](https://code.claude.com/docs/zh-CN/plugins/org.md#restrict-what-users-can-install) | 限制用户可以添加和从中安装的市场来源，并拒绝在单次运行中旁加载插件、Agent 和 MCP 服务器的 CLI 标志。阻止 [`command` 插件来源](https://code.claude.com/docs/zh-CN/plugins/marketplace-reference#command-plugin-source)，并通过允许列表指定哪些市场的插件可以在终端中被推荐 | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |98| [插件市场控制](https://code.claude.com/docs/zh-CN/plugins/org.md#restrict-what-users-can-install) | 限制用户可以添加和从中安装的市场来源，并拒绝在单次运行中旁加载插件、Agent 和 MCP 服务器的 CLI 标志。阻止 [`command` 插件来源](https://code.claude.com/docs/zh-CN/plugins/marketplace-reference#command-plugin-source)，并通过允许列表指定哪些市场的插件可以在终端中被推荐 | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |

99| [自定义锁定](https://code.claude.com/docs/zh-CN/settings-reference.md#strictpluginonlycustomization) | 阻止来自用户和项目来源的 skill、Agent、hook 和 MCP 服务器，使它们只能来自插件或托管设置。锁定 skill 还会停止同步[开发人员在 claude.ai 上启用的 skill](https://code.claude.com/docs/zh-CN/skills.md#where-synced-skills-load) | `strictPluginOnlyCustomization` |99| [自定义锁定](https://code.claude.com/docs/zh-CN/settings-reference.md#strictpluginonlycustomization) | 阻止来自用户和项目来源的 skill、Agent、hook 和 MCP 服务器。锁定 skill 还会停止同步[开发人员在 claude.ai 上启用的 skill](https://code.claude.com/docs/zh-CN/skills.md#where-synced-skills-load) | `strictPluginOnlyCustomization` |

100| [禁用 claude.ai 同步](https://code.claude.com/docs/zh-CN/settings-reference.md#syncclaudeaiskills) | 阻止 Claude Code 加载开发人员在 claude.ai 上启用的 [skill](https://code.claude.com/docs/zh-CN/skills.md#how-synced-skills-behave) 和[插件](https://code.claude.com/docs/zh-CN/plugins/loading.md#synced-plugins)。如果您在 claude.ai 上为组织关闭 Skills，Claude Code 会停止同步这两者，并且在 v2.1.273 或更高版本中还会移除已同步的内容。若要在不关闭 Skills 的情况下停止其中任意一项，请在托管设置中将其对应的键设置为 `false` | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |100| [禁用 claude.ai 同步](https://code.claude.com/docs/zh-CN/settings-reference.md#syncclaudeaiskills) | 阻止 Claude Code 加载开发人员在 claude.ai 上启用的 [skill](https://code.claude.com/docs/zh-CN/skills.md#how-synced-skills-behave) 和[插件](https://code.claude.com/docs/zh-CN/plugins/loading.md#synced-plugins)。如果您在 claude.ai 上为组织关闭 Skills，Claude Code 会停止同步这两者，并且在 v2.1.273 或更高版本中还会移除已同步的内容。若要在不关闭 Skills 的情况下停止其中任意一项，请在托管设置中将其对应的键设置为 `false` | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |

101| [Hook 限制](https://code.claude.com/docs/zh-CN/settings-reference.md#allowmanagedhooksonly) | 限制运行哪些 hook 并限制 HTTP hook URL；完整的影响列表请参阅[在 `allowManagedHooksOnly` 下运行的内容](https://code.claude.com/docs/zh-CN/settings-reference#what-runs-under-allowmanagedhooksonly) | `allowManagedHooksOnly`、`allowedHttpHookUrls` |101| [Hook 限制](https://code.claude.com/docs/zh-CN/settings-reference.md#allowmanagedhooksonly) | 限制运行哪些 hook 并限制 HTTP hook URL；完整的影响列表请参阅[在 `allowManagedHooksOnly` 下运行的内容](https://code.claude.com/docs/zh-CN/settings-reference#what-runs-under-allowmanagedhooksonly) | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

102| [登录强制](https://code.claude.com/docs/zh-CN/settings-reference.md#forceloginmethod) | 将登录限制为特定方式或特定 Anthropic 组织。方式限制适用于 VS Code 扩展、Agent SDK、`claude setup-token` 和 `/install-github-app`，而终端的交互式登录界面（通过 `/login` 或首次运行引导进入）会预先选中该方式，但不强制执行；Claude Code 会在终端、VS Code 扩展和 Agent SDK 中对 claude.ai 账户登录验证组织，但不会对 Claude Console 登录或[网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway)登录检查组织。在 v2.1.212 之前，这两个键仅对终端登录生效。设置后，通过 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 进行身份验证的会话会在启动时被阻止；云提供商会话不受影响，除非同时存在上述凭据之一，或存在先前 Claude Console 登录时保存的 API 密钥 | `forceLoginMethod`、`forceLoginOrgUUID` |102| [登录强制](https://code.claude.com/docs/zh-CN/settings-reference.md#forceloginmethod) | 将登录限制为特定方式或特定 Anthropic 组织。方式限制适用于 VS Code 扩展、Agent SDK、`claude setup-token` 和 `/install-github-app`，而终端的交互式登录界面（通过 `/login` 或首次运行引导进入）会预先选中该方式，但不强制执行；Claude Code 会在终端、VS Code 扩展和 Agent SDK 中对 claude.ai 账户登录验证组织，但不会对 Claude Console 登录或[网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway)登录检查组织。在 v2.1.212 之前，这两个键仅对终端登录生效。设置后，通过 `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN` 或 `apiKeyHelper` 进行身份验证的会话会在启动时被阻止；云提供商会话不受影响，除非同时存在上述凭据之一，或存在先前 Claude Console 登录时保存的 API 密钥 | `forceLoginMethod`、`forceLoginOrgUUID` |

advisor.md +4 −5

Details

8 8

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

10>10>

11> 顾问工具是实验性的，需要 Anthropic API。它在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行为、定价和可用性可能会改变。11> 顾问工具是实验性的，需要 Anthropic API 或 [Claude Platform on AWS](https://code.claude.com/docs/zh-CN/claude-platform-on-aws.md)。在 Claude Platform on AWS 上，需要 Claude Code v2.1.300 或更高版本。它在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。行为、定价和可用性可能会改变。

12 12

13顾问工具让 Claude 在任务期间的关键时刻咨询第二个通常更强大的模型，例如在提交方法之前、陷入重复错误时或在声明任务完成之前。顾问接收完整的对话，包括每个工具调用和结果，并返回 Claude 在继续之前应用的指导。13顾问工具让 Claude 在任务期间的关键时刻咨询第二个通常更强大的模型，例如在提交方法之前、陷入重复错误时或在声明任务完成之前。顾问接收完整的对话，包括每个工具调用和结果，并返回 Claude 在继续之前应用的指导。

14 14

174 174

175## 要求175## 要求

176 176

177顾问工具需要以下所有条件：177* **提供商**：Anthropic API 或 [Claude Platform on AWS](https://code.claude.com/docs/zh-CN/claude-platform-on-aws.md)，而不是 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry。在 Claude Platform on AWS 上，顾问需要 Claude Code v2.1.300 或更高版本。

~~178~~ 178* **LLM 网关**：通过配置了 `ANTHROPIC_BASE_URL` 的 [LLM 网关](https://code.claude.com/docs/zh-CN/llm-gateway)，可用性取决于网关是否将请求完整转发到 Anthropic API。如果网关或其上游不识别顾问工具，请参阅[自动重试和错误转发](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#automatic-retry-and-error-forwarding)了解 Claude Code 如何响应。

179* **仅 Anthropic API**：顾问是服务器执行的工具。它在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。通过配置了 `ANTHROPIC_BASE_URL` 的 [LLM 网关](https://code.claude.com/docs/zh-CN/llm-gateway)，可用性取决于网关是否将请求完整转发到 Anthropic API。如果网关或其上游不识别顾问工具，请参阅[自动重试和错误转发](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#automatic-retry-and-error-forwarding)了解 Claude Code 如何响应。

180* **支持的主模型**：Fable、Opus 4.6 或更高版本、Sonnet 4.6 或更高版本、Haiku 4.5 或 Haiku 5.5。请参阅[选择顾问模型](#choose-an-advisor-model)了解每个主模型接受哪些顾问。179* **支持的主模型**：Fable、Opus 4.6 或更高版本、Sonnet 4.6 或更高版本、Haiku 4.5 或 Haiku 5.5。请参阅[选择顾问模型](#choose-an-advisor-model)了解每个主模型接受哪些顾问。

181* **功能标志获取**：Claude Code 通过从 Anthropic 获取的功能标志来启用顾问。在设置了关闭标志获取的变量（例如 `DISABLE_TELEMETRY`）的会话中，顾问保持关闭状态。请参阅[需要功能标志获取的功能](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)。180* **功能标志获取**：除非您使用的是 Claude Platform on AWS，否则顾问需要从 Anthropic 获取的功能标志。设置了关闭获取的变量（例如 `DISABLE_TELEMETRY`）的会话不会拥有该标志。要检查您的会话，请参阅[哪些会话会跳过获取或在没有该标志的情况下启动](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)。

182 181

183## 关闭顾问182## 关闭顾问

184 183

agent-sdk/agent-loop.md +1 −1

Details

220 220

221> [!NOTE]221> [!NOTE]

222>222>

223> `effort` 在每个响应内交换延迟和令牌成本以获得推理深度。[扩展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 是一个单独的功能，在输出中产生 `thinking` 块，[Python](https://code.claude.com/docs/zh-CN/agent-sdk/python.md#thinkingconfig) 或 [TypeScript](https://code.claude.com/docs/zh-CN/agent-sdk/typescript.md#thinkingconfig) 上 `ThinkingConfig` 的 `display` 字段控制你是否接收它们的文本。它们是独立的：你可以设置 `effort: "low"` 并启用扩展思考，或 `effort: "max"` 而不启用它。223> `effort` 在每个响应内以延迟和 token 成本换取推理深度。[扩展思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 会在输出中产生 `thinking` 块，[Python](https://code.claude.com/docs/zh-CN/agent-sdk/python.md#thinkingconfig) 或 [TypeScript](https://code.claude.com/docs/zh-CN/agent-sdk/typescript.md#thinkingconfig) 上 `ThinkingConfig` 的 `display` 字段控制您是否接收它们的文本。

224 224

225对于执行简单、范围明确的任务（如列出文件或运行单个 grep）的 Agent，使用较低的 effort 来降低成本和延迟。在顶级 `query()` 选项中为[会话](https://code.claude.com/docs/zh-CN/sub-agents.md#choose-an-effort-level)设置 `effort`，或在 [`AgentDefinition`](https://code.claude.com/docs/zh-CN/agent-sdk/subagents#agentdefinition-configuration) 上使用 `effort` 字段为每个子代理设置以覆盖会话级别。225对于执行简单、范围明确的任务（如列出文件或运行单个 grep）的 Agent，使用较低的 effort 来降低成本和延迟。在顶级 `query()` 选项中为[会话](https://code.claude.com/docs/zh-CN/sub-agents.md#choose-an-effort-level)设置 `effort`，或在 [`AgentDefinition`](https://code.claude.com/docs/zh-CN/agent-sdk/subagents#agentdefinition-configuration) 上使用 `effort` 字段为每个子代理设置以覆盖会话级别。

226 226

agent-sdk/observability.md +2 −3

Details

220附加最终用户身份后，这些事件将成为每个用户的审计跟踪，您可以将其转发到安全信息和事件管理 (SIEM) 平台：220附加最终用户身份后，这些事件将成为每个用户的审计跟踪，您可以将其转发到安全信息和事件管理 (SIEM) 平台：

221 221

222* `tool_decision` 和 `tool_result`：每个工具调用、该调用是被允许还是被拒绝，以及其结果222* `tool_decision` 和 `tool_result`：每个工具调用、该调用是被允许还是被拒绝，以及其结果

223* `safety_event`：哪项检查拒绝了某个工具调用或要求为其显示权限提示，例如权限规则或自动模式分类器。某些调用[没有安全事件](https://code.claude.com/docs/zh-CN/monitoring-usage.md#calls-without-a-safety-event)。需要 Claude Code v2.1.307 或更高版本

224* `mcp_server_connection`：MCP 服务器连接和连接失败223* `mcp_server_connection`：MCP 服务器连接和连接失败

225* `permission_mode_changed`：权限模式更改224* `permission_mode_changed`：权限模式更改

226 225

227这些事件导出为以 `claude_code.` 前缀命名的日志记录，例如 `claude_code.safety_event`。有关完整的安全相关事件列表和每个事件携带的属性，请参阅监控参考中的[审计安全事件](https://code.claude.com/docs/zh-CN/monitoring-usage.md#audit-security-events)。226这些事件导出为以 `claude_code.` 前缀命名的日志记录，例如 `claude_code.tool_decision`。有关完整的安全相关事件列表和每个事件携带的属性，请参阅监控参考中的[审计安全事件](https://code.claude.com/docs/zh-CN/monitoring-usage.md#audit-security-events)。

228 227

229## 控制导出中的敏感数据228## 控制导出中的敏感数据

230 229

233| 变量 | 添加 |232| 变量 | 添加 |

234| - | - |233| - | - |

236| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` 事件上的工具输入参数，例如文件路径、shell 命令和搜索模式，以及[成本和 token 指标](https://code.claude.com/docs/zh-CN/monitoring-usage.md#cost-counter)上的真实 Agent、skill、插件和 MCP 服务器名称。自动模式分类器在阻止调用时指明的内置规则，以 [`classifier_category`](https://code.claude.com/docs/zh-CN/monitoring-usage#tool-decision-event) 的形式记录在 `claude_code.tool_decision` 和 `claude_code.safety_event` 事件上 |235| `OTEL_LOG_TOOL_DETAILS=1` | `claude_code.tool_result` 事件上的工具输入参数，例如文件路径、shell 命令和搜索模式，以及[成本和 token 指标](https://code.claude.com/docs/zh-CN/monitoring-usage.md#cost-counter)上的真实 Agent、skill、插件和 MCP 服务器名称。自动模式分类器在阻止调用时指明的内置规则，以 [`classifier_category`](https://code.claude.com/docs/zh-CN/monitoring-usage#tool-decision-event) 的形式记录在 `claude_code.tool_decision` 事件上 |

237| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool` 上的[`tool.output` 跨度事件](https://code.claude.com/docs/zh-CN/monitoring-usage#tool-output-span-event)，包含文件内容、Bash 输出以及 MCP 工具、WebFetch 和 WebSearch 返回的内容，默认在 60 KB 处截断，可通过 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 配置，需要 Claude Code v2.1.214 或更高版本。来自 MCP 工具、WebFetch 和 WebSearch 的结果需要 Claude Code v2.1.283 或更高版本。需要启用[跟踪](#read-agent-traces)。跨度属性在[其自己的门控](https://code.claude.com/docs/zh-CN/monitoring-usage.md#new-context-gates)下携带工具内容 |236| `OTEL_LOG_TOOL_CONTENT=1` | `claude_code.tool` 上的[`tool.output` 跨度事件](https://code.claude.com/docs/zh-CN/monitoring-usage#tool-output-span-event)，包含文件内容、Bash 输出以及 MCP 工具、WebFetch 和 WebSearch 返回的内容，默认在 60 KB 处截断，可通过 `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 配置，需要 Claude Code v2.1.214 或更高版本。来自 MCP 工具、WebFetch 和 WebSearch 的结果需要 Claude Code v2.1.283 或更高版本。需要启用[跟踪](#read-agent-traces)。跨度属性在[其自己的门控](https://code.claude.com/docs/zh-CN/monitoring-usage.md#new-context-gates)下携带工具内容 |

238| `OTEL_LOG_RAW_API_BODIES` | 完整的 Anthropic Messages API 请求和响应 JSON 作为 `claude_code.api_request_body` 和 `claude_code.api_response_body` 日志事件。设置为 `1` 表示在 60 KB 处截断的内联体，或 `file:<dir>` 表示磁盘上的未截断体，事件中有 `body_ref` 路径。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 配置内联截断限制，需要 Claude Code v2.1.214 或更高版本。体包括整个对话历史记录，扩展思考内容被编辑。启用此项意味着同意上述三个变量将揭示的所有内容 |237| `OTEL_LOG_RAW_API_BODIES` | 完整的 Anthropic Messages API 请求和响应 JSON 作为 `claude_code.api_request_body` 和 `claude_code.api_response_body` 日志事件。设置为 `1` 表示在 60 KB 处截断的内联体，或 `file:<dir>` 表示磁盘上的未截断体，事件中有 `body_ref` 路径。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` 配置内联截断限制，需要 Claude Code v2.1.214 或更高版本。体包括整个对话历史记录，扩展思考内容被编辑。启用此项意味着同意上述三个变量将揭示的所有内容 |

239 238

agent-sdk/python.md +1 −1

Details

1383| :- | :- | :- |1383| :- | :- | :- |

1387 1387

1388可选的 `display` 字段控制思考文本以 `"summarized"` 还是 `"omitted"` 形式返回。在 Claude Opus 4.7 及更高版本上，API 默认值为 `"omitted"`，因此请设置 `"summarized"` 以在 [`ThinkingBlock`](#thinkingblock) 输出中接收思考内容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供商上，对于其能识别的较早模型，Claude Code 不会传递 `display`。这些模型包括 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它们使用各自的默认值。1388可选的 `display` 字段控制思考文本以 `"summarized"` 还是 `"omitted"` 形式返回。在 Claude Opus 4.7 及更高版本上，API 默认值为 `"omitted"`，因此请设置 `"summarized"` 以在 [`ThinkingBlock`](#thinkingblock) 输出中接收思考内容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供商上，对于其能识别的较早模型，Claude Code 不会传递 `display`。这些模型包括 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它们使用各自的默认值。

1389 1389

agent-sdk/typescript.md +4 −2

Details

664| `rewindFiles(userMessageId, options?)` | 将文件恢复到指定用户消息时的状态。传递 `{ dryRun: true }` 可预览更改。需要 `enableFileCheckpointing: true`。请参阅[文件检查点功能](https://code.claude.com/docs/zh-CN/agent-sdk/file-checkpointing.md) |664| `rewindFiles(userMessageId, options?)` | 将文件恢复到指定用户消息时的状态。传递 `{ dryRun: true }` 可预览更改。需要 `enableFileCheckpointing: true`。请参阅[文件检查点功能](https://code.claude.com/docs/zh-CN/agent-sdk/file-checkpointing.md) |

666| `setModel()` | 更改模型（仅在流式输入模式下可用）。传递 `undefined` 或字符串 `"default"` 会重置为 [Claude Code 的默认模型](https://code.claude.com/docs/zh-CN/model-config.md)。如果新模型不支持自动模式，处于 `auto` 模式的会话会[切换到 `default` 模式](https://code.claude.com/docs/zh-CN/agent-sdk/permissions#auto-mode-auto) |666| `setModel()` | 更改模型（仅在流式输入模式下可用）。传递 `undefined` 或字符串 `"default"` 会重置为 [Claude Code 的默认模型](https://code.claude.com/docs/zh-CN/model-config.md)。如果新模型不支持自动模式，处于 `auto` 模式的会话会[切换到 `default` 模式](https://code.claude.com/docs/zh-CN/agent-sdk/permissions#auto-mode-auto) |

667| `setMaxThinkingTokens()` | *已弃用：* 请改用 `thinking` 选项。更改最大思考 token 数。传递 `null` 会将思考重置为会话默认值：会话中途的覆盖会被清除，对于禁用了思考的会话，思考保持关闭 |667| `setMaxThinkingTokens()` | *已弃用：* 请改用 `thinking` 选项。更改最大思考 token 数。传递 `null` 可撤销之前的调用，并恢复会话启动时使用的 `thinking` 或 `maxThinkingTokens` 选项 |

669| `updateSettings(source, settings)` | 将一个允许列表中的键写入项目的本地设置文件或您的用户设置文件，使该值在之后的会话中保持有效。请参阅 [`updateSettings()`](#updatesettings)。需要 TypeScript SDK v0.3.257 或更高版本，其捆绑了 Claude Code v2.1.257 |669| `updateSettings(source, settings)` | 将一个允许列表中的键写入项目的本地设置文件或您的用户设置文件，使该值在之后的会话中保持有效。请参阅 [`updateSettings()`](#updatesettings)。需要 TypeScript SDK v0.3.257 或更高版本，其捆绑了 Claude Code v2.1.257 |

5430type ThinkingConfig =5430type ThinkingConfig =

5431 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)5431 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5432 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget5432 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5433 | { type: "disabled" }; // No extended thinking5433 | { type: "disabled" }; // Turn thinking off where the model and provider allow it

5434```5434```

5435 5435

5436关于 `disabled`，请参阅[无法关闭思考的情况](https://code.claude.com/docs/zh-CN/model-config.md#where-you-cant-turn-thinking-off)。

5437

5436可选的 `display` 字段控制思考文本以 `"summarized"` 还是 `"omitted"` 方式返回。在 Claude Opus 4.7 及更高版本上，API 默认值为 `"omitted"`，因此请设置 `"summarized"` 以在 `thinking` 块中接收思考内容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供商上，对于 Claude Code 能识别的较早模型，Claude Code 不会传递 `display`。这些模型是 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它们使用各自的默认值。5438可选的 `display` 字段控制思考文本以 `"summarized"` 还是 `"omitted"` 方式返回。在 Claude Opus 4.7 及更高版本上，API 默认值为 `"omitted"`，因此请设置 `"summarized"` 以在 `thinking` 块中接收思考内容。在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 等提供商上，对于 Claude Code 能识别的较早模型，Claude Code 不会传递 `display`。这些模型是 Opus 4.6、Sonnet 4.6、Haiku 4.5 及更早的模型，它们使用各自的默认值。

5437 5439

5438### `SpawnedProcess`5440### `SpawnedProcess`

agent-view.md +3 −1

Details

169 169

170当列表[按目录分组](#organize-the-list)时，摘要以彩色文字显示的会话状态开头，例如 `Needs input · double jump or wall climb?`。在默认的按状态分组中，组标题已经指明了状态，因此行只显示摘要。170当列表[按目录分组](#organize-the-list)时，摘要以彩色文字显示的会话状态开头，例如 `Needs input · double jump or wall climb?`。在默认的按状态分组中，组标题已经指明了状态，因此行只显示摘要。

171 171

172轮次结束时的摘要和每次轮次中途的重写，都是通过您的常规提供商发送的一个简短 Haiku-class 请求，按与会话本身相同的[数据使用条款](https://code.claude.com/docs/zh-CN/data-usage.md)计费和处理。两次模型重写之间每 15 秒的更新复用会话自身的输出，不发送请求。在未配置 Haiku-class 模型的第三方提供商或网关上，请求改用会话的主模型；设置 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/zh-CN/model-config#environment-variables) 可选择一个模型。172#### 行摘要的成本

173

174轮次结束时的摘要和每次轮次中途的重写，都是通过您的常规提供商发送的一个简短请求，按与会话本身相同的[数据使用条款](https://code.claude.com/docs/zh-CN/data-usage.md)计费和处理。在第三方提供商或网关上，摘要使用您在 [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/zh-CN/model-config#environment-variables) 中设置的模型。未设置该变量时，摘要使用您的提供商用于后台任务的模型：请参阅 [Amazon Bedrock](https://code.claude.com/docs/zh-CN/amazon-bedrock.md#4-pin-model-versions)、[Google Cloud 的 Agent Platform](https://code.claude.com/docs/zh-CN/google-vertex-ai.md#5-pin-model-versions)、[Microsoft Foundry](https://code.claude.com/docs/zh-CN/microsoft-foundry.md#4-pin-model-versions) 或您的[网关](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#requests-and-defaults-by-connection-method)。

173 175

174### 拉取请求状态176### 拉取请求状态

175 177

chrome.md +1 −1

Details

128 128

129### 计划模式下的浏览器工具129### 计划模式下的浏览器工具

130 130

131在[计划模式](https://code.claude.com/docs/zh-CN/permission-modes.md#analyze-before-you-edit-with-plan-mode)下，Claude 在录制 GIF、打开新标签页或运行快捷方式之前会显示权限提示。在交互式 CLI 会话中，如果[绕过权限模式可用](https://code.claude.com/docs/zh-CN/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)且[功能标志获取](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)已关闭，这些调用将在不提示的情况下运行。131在[计划模式](https://code.claude.com/docs/zh-CN/permission-modes.md#analyze-before-you-edit-with-plan-mode)下，Claude 在录制 GIF 或打开新标签页之前会显示权限提示。在交互式 CLI 会话中，如果[绕过权限模式可用](https://code.claude.com/docs/zh-CN/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)且[功能标志获取](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)已关闭，这些调用将在不提示的情况下运行。

132 132

133设置了 `createIfEmpty` 的 `tabs_context_mcp` 调用也会触发提示，包含上述任一操作的 `browser_batch` 调用同样如此。133设置了 `createIfEmpty` 的 `tabs_context_mcp` 调用也会触发提示，包含上述任一操作的 `browser_batch` 调用同样如此。

134 134

claude-apps-gateway.md +1 −1

Details

313>313>

314> `gatewayInternalNetworks` 适用于恰好使用公网地址空间编址的内部网络。它并不能让网关暴露在互联网上变得安全：受信任的网关可以推送在开发人员机器上运行命令的设置。314> `gatewayInternalNetworks` 适用于恰好使用公网地址空间编址的内部网络。它并不能让网关暴露在互联网上变得安全：受信任的网关可以推送在开发人员机器上运行命令的设置。

315>315>

316> 请通过防火墙或负载均衡器规则，确保从您的网络外部无法访问网关。将网关的 [`access_control.allow_cidrs`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning) 设置为您在此处声明的相同地址块，使网关本身拒绝来自其他任何地方的客户端。如果网关位于负载均衡器或入口之后，还需将 `listen.trusted_proxies` 设置为该前端，否则网关会用前端自身的地址而不是开发人员的地址来匹配 `allow_cidrs`。316> 请通过防火墙或负载均衡器规则，确保从您的网络外部无法访问网关。将网关的 [`access_control.allow_cidrs`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning) 设置为您在此处声明的相同地址块。如果负载均衡器或入口[应列入 `listen.trusted_proxies`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#listen)，也请将其列在那里，否则网关会用前端自身的地址而不是开发人员的地址来匹配 `allow_cidrs`。

317 317

318请将该键添加到与登录键相同的托管设置来源中：托管设置文件、MDM 配置描述文件或注册表策略。Claude Code 会忽略用户设置、项目设置和服务器托管设置中的该键。318请将该键添加到与登录键相同的托管设置来源中：托管设置文件、MDM 配置描述文件或注册表策略。Claude Code 会忽略用户设置、项目设置和服务器托管设置中的该键。

319 319

claude-apps-gateway-config.md +6 −2

Details

59| `port` | 否 | 绑定端口。默认 `8080`。 |59| `port` | 否 | 绑定端口。默认 `8080`。 |

60| `public_url` | 除非 `host` 是环回地址 | 外部可见的 `https://` 源，用于构建 IdP `redirect_uri` 和发现元数据。当 `host` 不是环回地址时需要，无论 TLS 是在代理（如 ALB、Ingress 或 Cloud Run）还是通过 `tls` 在网关本身终止，因为网关永远不会从 `X-Forwarded-*` 标头派生自己的源；这些标头可被客户端欺骗。没有它启动会失败。下面的 `trusted_proxies` 仅控制客户端 IP 解析。还需要启用[遥测](#telemetry)，因为网关从此 URL 构建它推送给客户端的 OTLP 端点。 |60| `public_url` | 除非 `host` 是环回地址 | 外部可见的 `https://` 源，用于构建 IdP `redirect_uri` 和发现元数据。当 `host` 不是环回地址时需要，无论 TLS 是在代理（如 ALB、Ingress 或 Cloud Run）还是通过 `tls` 在网关本身终止，因为网关永远不会从 `X-Forwarded-*` 标头派生自己的源；这些标头可被客户端欺骗。没有它启动会失败。下面的 `trusted_proxies` 仅控制客户端 IP 解析。还需要启用[遥测](#telemetry)，因为网关从此 URL 构建它推送给客户端的 OTLP 端点。 |

61| `tls.cert` / `tls.key` | 否 | 如果网关自己终止 TLS，则为 PEM 路径 |61| `tls.cert` / `tls.key` | 否 | 如果网关自己终止 TLS，则为 PEM 路径 |

62| `trusted_proxies` | 否 | 网关前面的负载均衡器的 CIDR 或 IP。设置后，网关仅从这些对等方信任 `X-Forwarded-For`，并记录真实客户端 IP 用于按 IP 速率限制和审计。等同于 nginx `set_real_ip_from`。`X-Forwarded-For` 条目写成 `ipv4:port` 或 `[ipv6]:port`（如某些负载均衡器所做），读取时端口被丢弃。带有端口附加且无括号的 IPv6 地址可能被读取为不同的地址或根本不被读取，因此在任何写入该形式的代理上关闭端口选项。 |62| `trusted_proxies` | 否 | 要信任的前端的 CIDR 或 IP。设置后，网关仅信任来自这些对端的 `X-Forwarded-For`，并记录真实客户端 IP，用于按 IP 的速率限制和审计。 |

64仅当某个前端传递的最后一个 `X-Forwarded-For` 条目不是由任何开发者写入的时，才将其列入 `trusted_proxies`。不要列出开发者连接时使用的任何地址或地址范围。为收到的每个连接追加其地址的前端符合条件。按开发者发送的原样传递该标头的前端则不符合条件。

66以 `ipv4:port` 或 `[ipv6]:port` 形式写入的 `X-Forwarded-For` 条目（某些负载均衡器会这样写）在读取时会去掉端口。附加了端口但没有方括号的 IPv6 地址可能被读取为另一个地址，或根本无法读取。请在任何写入该形式的代理上关闭端口选项。

63 67

64### `oidc`68### `oidc`

65 69

1659 1663

1660这两种信号都使用网关解析得到的客户端地址。如果负载均衡器、端口转发或隧道中继了流量，但未列在 `listen.trusted_proxies` 中，网关看到的将是中继的地址（通常是私有地址），因此运行时警告和私有允许列表都无法捕获经由它中继的流量。1664这两种信号都使用网关解析得到的客户端地址。如果负载均衡器、端口转发或隧道中继了流量，但未列在 `listen.trusted_proxies` 中，网关看到的将是中继的地址（通常是私有地址），因此运行时警告和私有允许列表都无法捕获经由它中继的流量。

1661 1665

1662在此类前端之后，请先设置 [`listen.trusted_proxies`](#listen)，使网关能看到真实的客户端地址，并且无论如何都要确保网关及其前面的所有组件无法从公网访问。1666如果该中转方[应列入 `listen.trusted_proxies`](#listen)，请将其列入。无论如何，都应确保网关及其前面的所有组件无法从公共互联网访问。

1663 1667

1664### `load_test_mode`1668### `load_test_mode`

1665 1669

claude-apps-gateway-deploy.md +2 −2

Details

131 131

132登录按客户端 IP 地址进行速率限制，默认值适合小团队。每个地址每 10 分钟获得 30 次登录开始和 10 次代码提交。向数千名开发者的推出可能在第一个早上达到这些限制，原因有两个：132登录按客户端 IP 地址进行速率限制，默认值适合小团队。每个地址每 10 分钟获得 30 次登录开始和 10 次代码提交。向数千名开发者的推出可能在第一个早上达到这些限制，原因有两个：

133 133

134* **网关看不到您的负载均衡器后面。** 没有 [`listen.trusted_proxies`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#listen)，每个开发者似乎都来自负载均衡器的地址并共享一个限制。首先设置它。网关在第一次忽略 `X-Forwarded-For` 标头时会记录警告。134* **网关看不到您的负载均衡器后面。** 没有 [`listen.trusted_proxies`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#listen)，每个开发者似乎都来自负载均衡器的地址并共享一个限制。网关在第一次忽略 `X-Forwarded-For` 标头时会记录警告。如果该负载均衡器[应列入 `listen.trusted_proxies`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#listen)，请在更改其他任何内容之前先将其列入。如果开发者仍然共享一个地址，请提高 [`rate_limits`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning)。

135* **许多开发者共享几个 NAT 或 VPN 出口地址。** 即使 `trusted_proxies` 正确，他们也共享这些地址的限制。提高 [`rate_limits`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning) 以适应。135* **许多开发者共享几个 NAT 或 VPN 出口地址。** 即使 `trusted_proxies` 正确，他们也共享这些地址的限制。提高 [`rate_limits`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning) 以适应。

136 136

137要调整 `max`，将开发者数除以他们共享的出口地址数。估计在一个 `window_seconds` 周期内有多少人登录，默认为 10 分钟。然后将其加倍以覆盖重试和同时登录 Claude Code 和 Claude Desktop 的开发者。137要调整 `max`，将开发者数除以他们共享的出口地址数。估计在一个 `window_seconds` 周期内有多少人登录，默认为 10 分钟。然后将其加倍以覆盖重试和同时登录 Claude Code 和 Claude Desktop 的开发者。

418| 启动显示 `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | 已安装的 Claude Code 版本早于网关支持 | 让开发者更新 Claude Code 到包含 Cloud gateway 支持的版本 |418| 启动显示 `Gateway login is configured in managed settings, but this Claude Code build does not include Cloud gateway support.` | 已安装的 Claude Code 版本早于网关支持 | 让开发者更新 Claude Code 到包含 Cloud gateway 支持的版本 |

419| 启动退出，显示 `Administrator policy requires a Cloud gateway sign-in on this machine` | 开发者的环境设置了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，其设置配置了 [`apiKeyHelper`](https://code.claude.com/docs/zh-CN/settings-reference#apikeyhelper)，或来自早期 Claude Console 登录的 API 密钥仍然保存 | 让开发者清除每个适用的项：取消设置变量、删除 `apiKeyHelper` 条目，或运行 `claude auth logout` 删除保存的密钥。之后，使用 `CLAUDE_CODE_USE_*` 选择云提供商的会话无需登录即可启动；对于其他所有会话，让他们启动 `claude` 并使用 `/login` 登录。另请参阅[管理员策略需要 Cloud gateway 登录](https://code.claude.com/docs/zh-CN/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in)。 |419| 启动退出，显示 `Administrator policy requires a Cloud gateway sign-in on this machine` | 开发者的环境设置了 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN`，其设置配置了 [`apiKeyHelper`](https://code.claude.com/docs/zh-CN/settings-reference#apikeyhelper)，或来自早期 Claude Console 登录的 API 密钥仍然保存 | 让开发者清除每个适用的项：取消设置变量、删除 `apiKeyHelper` 条目，或运行 `claude auth logout` 删除保存的密钥。之后，使用 `CLAUDE_CODE_USE_*` 选择云提供商的会话无需登录即可启动；对于其他所有会话，让他们启动 `claude` 并使用 `/login` 登录。另请参阅[管理员策略需要 Cloud gateway 登录](https://code.claude.com/docs/zh-CN/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in)。 |

420| 启动或 `/login` 在托管设置加载时返回 403 后报告 `Claude Code may not be enabled for your organization` | 网关或其前面的某个组件用 403 响应了 `/managed/settings` 请求。网关自身的设置路由从不返回 403。状态来自 [`access_control`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning) IP 检查或网关前面的代理或 WAF。审计日志将 IP 检查拒绝记录为 `access.denied` 并说明原因。开发者保持登录状态。 | 检查审计日志中失败时的 `access.denied`，修复 `access_control` 列表或前端，然后让开发者再次启动 `claude` |420| 启动或 `/login` 在托管设置加载时返回 403 后报告 `Claude Code may not be enabled for your organization` | 网关或其前面的某个组件用 403 响应了 `/managed/settings` 请求。网关自身的设置路由从不返回 403。状态来自 [`access_control`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#http-tuning) IP 检查或网关前面的代理或 WAF。审计日志将 IP 检查拒绝记录为 `access.denied` 并说明原因。开发者保持登录状态。 | 检查审计日志中失败时的 `access.denied`，修复 `access_control` 列表或前端，然后让开发者再次启动 `claude` |

421| CLI `/login`：`The gateway is limiting sign-in attempts right now`，或在较旧版本上 `Request failed with status code 429`。`/device` 页面可能向尚未尝试过的开发者显示 `Too many attempts` | 达到了每 IP 登录速率限制。要么 `listen.trusted_proxies` 不覆盖负载均衡器，所以每个开发者共享其地址，要么许多开发者共享一个 NAT 或 VPN 出口地址。具有 `result: rate_limited` 的审计事件显示相同的一个或几个 `client_ip` 值。 | 首先将 `listen.trusted_proxies` 设置为负载均衡器的源范围，然后如果开发者仍然共享地址，提高 `rate_limits`。请参阅[大规模推出](#large-rollouts)。 |421| CLI `/login`：`The gateway is limiting sign-in attempts right now`，或在较旧版本上 `Request failed with status code 429`。`/device` 页面可能向尚未尝试过的开发者显示 `Too many attempts` | 达到了每 IP 登录速率限制。要么 `listen.trusted_proxies` 不覆盖负载均衡器，所以每个开发者共享其地址，要么许多开发者共享一个 NAT 或 VPN 出口地址。具有 `result: rate_limited` 的审计事件显示相同的一个或几个 `client_ip` 值。 | 如果负载均衡器[应列入 `listen.trusted_proxies`](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config#listen)，请先将其列入。然后，如果开发者仍然共享地址，请提高 `rate_limits`。请参阅[大规模推出](#large-rollouts)。 |

422| CLI `/login`：`Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | 网关主机名解析为至少一个公网 IP 地址。Claude Code 检查每个解析的地址，要求每个都是私网。常见原因是双栈名称，其中一个族解析为公网地址，包括 AWS 内部双栈负载均衡器，它们返回公网范围的 AAAA 地址。 | 让网关名称在开发者机器上仅解析为私网地址。对于双栈名称，删除公网范围的记录或提供单独的仅内部 DNS 名称。请参阅[私网前提条件](https://code.claude.com/docs/zh-CN/claude-apps-gateway#prerequisites)。如果地址是您的组织拥有并在内部使用的公网空间，请[声明该块](https://code.claude.com/docs/zh-CN/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)。 |422| CLI `/login`：`Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | 网关主机名解析为至少一个公网 IP 地址。Claude Code 检查每个解析的地址，要求每个都是私网。常见原因是双栈名称，其中一个族解析为公网地址，包括 AWS 内部双栈负载均衡器，它们返回公网范围的 AAAA 地址。 | 让网关名称在开发者机器上仅解析为私网地址。对于双栈名称，删除公网范围的记录或提供单独的仅内部 DNS 名称。请参阅[私网前提条件](https://code.claude.com/docs/zh-CN/claude-apps-gateway#prerequisites)。如果地址是您的组织拥有并在内部使用的公网空间，请[声明该块](https://code.claude.com/docs/zh-CN/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)。 |

423| CLI `/login`：`Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` 或 `HTTP_PROXY` 适用于网关主机，且代理的主机名解析为公网地址。主机名仅解析为私网地址的代理是允许的，不会触发此错误 | 在开发者的机器上将网关主机添加到 `NO_PROXY`，以便连接是直接的，或使用主机名解析为私网地址的代理。消息会命名要添加的确切 `NO_PROXY` 条目 |423| CLI `/login`：`Gateway login would go through proxy <proxy>, which is not on a private network` | `HTTPS_PROXY` 或 `HTTP_PROXY` 适用于网关主机，且代理的主机名解析为公网地址。主机名仅解析为私网地址的代理是允许的，不会触发此错误 | 在开发者的机器上将网关主机添加到 `NO_PROXY`，以便连接是直接的，或使用主机名解析为私网地址的代理。消息会命名要添加的确切 `NO_PROXY` 条目 |

424| CLI `/login`：`Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | 网关在 [`gatewayInternalNetworks`](https://code.claude.com/docs/zh-CN/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) 中声明的块上，开发者的机器从该块外的地址到达它：VPN 地址池、容器或 WSL2 NAT 段，或不是您的网络 | 让开发者从您的网络上的主机 OS 运行 `/login`。如果显示的地址也是您的组织自己的公网空间，将网关的条目替换为覆盖两者的块，最多 `/8`；第二个重叠条目会被拒绝。如果没有能覆盖两者的块，请参阅[为网关选择地址](#choose-an-address-for-the-gateway) |424| CLI `/login`：`Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | 网关在 [`gatewayInternalNetworks`](https://code.claude.com/docs/zh-CN/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) 中声明的块上，开发者的机器从该块外的地址到达它：VPN 地址池、容器或 WSL2 NAT 段，或不是您的网络 | 让开发者从您的网络上的主机 OS 运行 `/login`。如果显示的地址也是您的组织自己的公网空间，将网关的条目替换为覆盖两者的块，最多 `/8`；第二个重叠条目会被拒绝。如果没有能覆盖两者的块，请参阅[为网关选择地址](#choose-an-address-for-the-gateway) |

claude-code-on-the-web.md +1 −1

Details

36 36

37每个云端会话都在一个[云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)中运行，这是一个保存的配置，控制网络访问、环境变量和设置脚本。37每个云端会话都在一个[云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)中运行，这是一个保存的配置，控制网络访问、环境变量和设置脚本。

38 38

39* **您的第一个环境**：如果您还没有环境，入门流程会设置一个具有[**受信任**网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#access-levels)的**默认**环境，要么为您创建它，要么要求您创建它。请参阅[默认环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#the-default-environment)，了解在您的计划上会发生哪种情况39* **您的第一个环境**：如果您还没有环境，入门流程会设置一个具有[**受限**网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#access-levels)的**默认**环境。请参阅[默认环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#the-default-environment)，了解这在您的计划上如何运作

40* **会话使用哪个环境**：请参阅[默认环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#the-default-environment)，了解当您有多个环境时会话如何选择环境40* **会话使用哪个环境**：请参阅[默认环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#the-default-environment)，了解当您有多个环境时会话如何选择环境

41* **更改会话可以访问的内容或在启动时运行的内容**：请参阅[配置云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)41* **更改会话可以访问的内容或在启动时运行的内容**：请参阅[配置云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)

42* **无需任何配置即已安装的内容**：请参阅[已安装的工具](https://code.claude.com/docs/zh-CN/cloud-environments.md#installed-tools)42* **无需任何配置即已安装的内容**：请参阅[已安装的工具](https://code.claude.com/docs/zh-CN/cloud-environments.md#installed-tools)

claude-directory.md +2 −2

Details

146* **自动内存**：扫描不删除项目 [自动内存](https://code.claude.com/docs/zh-CN/memory.md#auto-memory) 目录中的内存文件，`projects/<project>/memory/`。Claude Code 仅在整个保留期内该目录为空时才删除该目录。在 v2.1.228 之前，扫描将内存目录内的文件夹视为会话数据，可能删除其下的旧文件。146* **自动内存**：扫描不删除项目 [自动内存](https://code.claude.com/docs/zh-CN/memory.md#auto-memory) 目录中的内存文件，`projects/<project>/memory/`。Claude Code 仅在整个保留期内该目录为空时才删除该目录。在 v2.1.228 之前，扫描将内存目录内的文件夹视为会话数据，可能删除其下的旧文件。

147* **Claude Desktop 和 Cowork 会话记录**：Claude Code 保留您在 Claude Desktop 或 Cowork 中启动或最近继续的会话的会话记录，无论其年龄如何。要给这些会话记录设置年龄限制，请设置 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/zh-CN/settings-reference#desktopsessioncleanupperioddays)。需要 Claude Code v2.1.248 或更高版本；早期版本在 `cleanupPeriodDays` 后删除它们。147* **Claude Desktop 和 Cowork 会话记录**：Claude Code 保留您在 Claude Desktop 或 Cowork 中启动或最近继续的会话的会话记录，无论其年龄如何。要给这些会话记录设置年龄限制，请设置 [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/zh-CN/settings-reference#desktopsessioncleanupperioddays)。需要 Claude Code v2.1.248 或更高版本；早期版本在 `cleanupPeriodDays` 后删除它们。

148 148

149 在以下任一情况下，Claude Code 改为在 `cleanupPeriodDays` 后删除这些会话记录：149 在以下情况下，Claude Code 会改为在 `cleanupPeriodDays` 之后删除这些会话记录：

150 150

151 * [托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md)设置了 `cleanupPeriodDays`151 * [托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md)设置了 `cleanupPeriodDays`

152 * [HIPAA 配置适用于您的会话](https://code.claude.com/docs/zh-CN/hipaa-setup.md#check-how-developers-sign-in-and-connect)152 * [HIPAA 配置适用于您的会话](https://code.claude.com/docs/zh-CN/hipaa-setup.md#check-how-developers-sign-in-and-connect)

170* **Linux**：`/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`，或当您的系统设置 `$TMPDIR` 时在其下的相同形状170* **Linux**：`/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`，或当您的系统设置 `$TMPDIR` 时在其下的相同形状

171* **Windows**：`%TEMP%\claude\<project>\<session-id>\scratchpad\`171* **Windows**：`%TEMP%\claude\<project>\<session-id>\scratchpad\`

172 172

173`<project>` 是您的工作目录路径，其中除字母和数字外的每个字符都被替换为 `-`，例如 `-Users-you-my-project`。如果您设置了 [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/zh-CN/env-vars)，树会改为移动到该目录下。Hooks 接收当前会话的路径作为 [`scratchpad_dir`](https://code.claude.com/docs/zh-CN/hooks#common-input-fields)。173`<project>` 是您的工作目录路径，其中除字母和数字外的每个字符都被替换为 `-`，例如 `-Users-you-my-project`。在 Windows 上，`<project>` 是该字符串的 16 个字符的哈希值，例如 `73295dabccd14c56`。在 Desktop 应用会话中，它可以是该字符串本身。要获取确切路径，请询问 Claude。如果您设置了 [`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/zh-CN/env-vars)，树会改为移动到该目录下。hook 接收当前会话的路径作为 [`scratchpad_dir`](https://code.claude.com/docs/zh-CN/hooks#common-input-fields)。

174 174

175暂存文件的生命周期与会话的会话记录相同：[保留扫描](#cleaned-up-automatically)在删除会话记录时删除该目录，而 [`claude purge`](#clear-local-data) 不会触及临时目录。由于该目录位于系统临时位置下，您的操作系统也可能清除它，例如在重启时。要保留 Claude 在那里写入的内容，请让 Claude 将其移动到您的项目中。175暂存文件的生命周期与会话的会话记录相同：[保留扫描](#cleaned-up-automatically)在删除会话记录时删除该目录，而 [`claude purge`](#clear-local-data) 不会触及临时目录。由于该目录位于系统临时位置下，您的操作系统也可能清除它，例如在重启时。要保留 Claude 在那里写入的内容，请让 Claude 将其移动到您的项目中。

176 176

claude-platform-on-aws.md +2 −2

Details

8 8

9AWS 上的 Claude Platform 是 Anthropic 运营的 Claude API，支持 AWS 身份验证、IAM 访问控制和 AWS Marketplace 计费。请求直接到达 Anthropic 的 API，因此您获得与 [Claude API](https://platform.claude.com/docs) 相同的模型和 API 功能，并遵循相同的发布计划。您使用 AWS 凭证或工作区 API 密钥进行身份验证，并通过 AWS Marketplace 付款。9AWS 上的 Claude Platform 是 Anthropic 运营的 Claude API，支持 AWS 身份验证、IAM 访问控制和 AWS Marketplace 计费。请求直接到达 Anthropic 的 API，因此您获得与 [Claude API](https://platform.claude.com/docs) 相同的模型和 API 功能，并遵循相同的发布计划。您使用 AWS 凭证或工作区 API 密钥进行身份验证，并通过 AWS Marketplace 付款。

10 10

11Claude Code 通过 Anthropic 的功能标志服务启用的客户端功能默认处于关闭状态，[advisor 工具](https://code.claude.com/docs/zh-CN/advisor.md)不可用。有关完整列表，请参阅[功能可用性矩阵](https://code.claude.com/docs/zh-CN/feature-availability.md#summary-by-provider)。

13使用本指南将 Claude Code 指向您已通过 AWS 上的 Claude Platform 配置的工作区。有关在此之前的 AWS 订阅和工作区设置，请参阅 [AWS 上的 Claude Platform 文档](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。11使用本指南将 Claude Code 指向您已通过 AWS 上的 Claude Platform 配置的工作区。有关在此之前的 AWS 订阅和工作区设置，请参阅 [AWS 上的 Claude Platform 文档](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。

14 12

15> [!NOTE]13> [!NOTE]

16>14>

17> 通过 AWS Marketplace 订阅会配置一个与您的 AWS 账户关联的新 Anthropic 组织。此组织与您已有的任何 Anthropic 组织分开，凭证不会在它们之间转移。使用来自 AWS 关联组织的工作区 ID 和 API 密钥，而不是来自预先存在的 Claude Console 账户的凭证。15> 通过 AWS Marketplace 订阅会配置一个与您的 AWS 账户关联的新 Anthropic 组织。此组织与您已有的任何 Anthropic 组织分开，凭证不会在它们之间转移。使用来自 AWS 关联组织的工作区 ID 和 API 密钥，而不是来自预先存在的 Claude Console 账户的凭证。

18 16

17部分 Claude Code 功能在 AWS 上的 Claude Platform 中不可用或工作方式有所不同。请参阅[功能可用性矩阵](https://code.claude.com/docs/zh-CN/feature-availability.md#summary-by-provider)以及[需要获取功能标志的功能](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)。

19## 前置条件19## 前置条件

20 20

21在配置 Claude Code 之前，您需要：21在配置 Claude Code 之前，您需要：

cloud-environments.md +17 −13

Details

37 37

38**Default** 本身不带有任何配置：38**Default** 本身不带有任何配置：

39 39

~~40* [**Trusted** 网络访问](#access-levels)：会话可以访问包注册表和其他[允许列表中的域](#default-allowed-domains)，但无法通过会话的网络访问其他任何内容。~~40* [**Limited** 网络访问](#access-levels)：会话可以访问包注册表和其他[允许列表中的域](#default-allowed-domains)。

41* 无其他配置：**Default** 不定义任何环境变量或设置脚本，因此会话只以[预安装的工具](#installed-tools)开始。41* 无其他配置：**Default** 不定义任何环境变量或设置脚本，因此会话只以[预安装的工具](#installed-tools)开始。

42 42

43只有 **Default** 可用时，每个会话都在其中运行。当您有多个环境时，会话会按界面选择一个：43只有 **Default** 可用时，每个会话都在其中运行。当您有多个环境时，会话会按界面选择一个：

198 198

199## 网络访问199## 网络访问

200 200

201每个环境都设置一个网络访问级别，控制其会话可以进行的出站连接。默认级别 **Trusted** 允许包注册表和其他[允许列表中的域](#default-allowed-domains)；**Custom** 采用您自己的域列表。201每个环境都设置一个网络访问级别，控制其会话可以进行的出站连接。新环境默认为 **Limited** 并勾选 **Allow package managers**，因此其会话可以访问包注册表和其他[允许列表中的域](#default-allowed-domains)。

202 202

203要更改环境的网络访问，[打开它进行编辑](#configure-your-environment)并在对话框中使用 **Network access** 选择器。[共享环境](#organization-shared-environments)在那里以只读方式打开，因此 Owner 改为从[管理设置](https://claude.ai/admin-settings)中的 **Cloud environments** 页面更改其网络访问。打开选择器的控件出现在[Default 环境](#the-default-environment)下列出的应用使用入口上，以及[云端定时任务编辑器](https://code.claude.com/docs/zh-CN/routines.md#environments-and-network-access)中。个人环境在您的 claude.ai 账户设置中没有单独的页面。203要更改环境的网络访问，[打开它进行编辑](#configure-your-environment)并在对话框中使用 **Network access** 选择器。[共享环境](#organization-shared-environments)在那里以只读方式打开，因此 Owner 改为从[管理设置](https://claude.ai/admin-settings)中的 **Cloud environments** 页面更改其网络访问。打开选择器的控件出现在[Default 环境](#the-default-environment)下列出的应用使用入口上，以及[云端定时任务编辑器](https://code.claude.com/docs/zh-CN/routines.md#environments-and-network-access)中。个人环境在您的 claude.ai 账户设置中没有单独的页面。

204 204

210 210

211### 访问级别211### 访问级别

212 212

213**Network access** 字段在[环境对话框](#configure-your-environment)中采用以下四个级别之一：213**Network access** 字段在[环境对话框](#configure-your-environment)中采用以下三个级别之一：

214 214

215| 级别 | 出站连接 |215| 级别 | 出站连接 |

216| :- | :- |216| :- | :- |

217| **None** | 通过会话的网络没有出站网络访问 |217| **None** | 通过会话的网络没有出站网络访问 |

218| **Trusted** | 仅限[允许列表中的域](#default-allowed-domains)：包注册表、GitHub、云 SDK |218| **Limited** | 勾选 **Allow package managers** 时，包含包注册表、GitHub 和云 SDK 的[默认允许列表](#default-allowed-domains)，以及您[列出的任何域](#allow-specific-domains)。请参阅[被阻止的请求是什么样子](https://code.claude.com/docs/zh-CN/errors.md#host-not-allowed-in-a-cloud-session)。 |

219| **Full** | 任何域 |219| **Full** | 任何域 |

220| **Custom** | 您自己的允许列表，可选择包含默认值 |

221 220

222无论您选择哪个级别，会话仍然可以访问这些，因为每一个都采用不经过会话的网络允许列表的路径：221无论您选择哪个级别，会话仍然可以访问这些，因为每一个都采用不经过会话的网络允许列表的路径：

223 222

226* 您在环境的[网络密钥](#add-network-secrets)上列出的主机，除了[永远不会获得该密钥的主机](#requests-that-never-get-the-credential)225* 您在环境的[网络密钥](#add-network-secrets)上列出的主机，除了[永远不会获得该密钥的主机](#requests-that-never-get-the-credential)

227* Anthropic API，用于 Claude Code 自己的请求，即使在 **None** 下也是如此，如[安全性和隔离](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md#security-and-isolation)下所述226* Anthropic API，用于 Claude Code 自己的请求，即使在 **None** 下也是如此，如[安全性和隔离](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md#security-and-isolation)下所述

228 227

228保存为 **Trusted** 或 **Custom** 的环境仍可访问相同的主机，并按以下方式打开：

229

230* **保存为 Trusted**：以 **Limited** 打开，并勾选 **Allow package managers**

231* **保存为 Custom**：以 **Limited** 打开，其 **Allowed domains** 列表和 **Allow package managers** 保持您的设置；如果列表包含单独的 `*`，则以 **Full** 打开

232

229### 允许特定域233### 允许特定域

230 234

231要允许不在 Trusted 列表中的域，请在环境的网络访问设置中选择 **Custom**，然后在 **Allowed domains** 字段中每行列出一个域。此示例允许内部项目可能需要的三个主机。235要允许不在[默认允许列表](#default-allowed-domains)中的域，请在环境的 **Network access** 选择器中选择 **Limited**，然后在 **Allowed domains** 字段中每行列出一个域。前导 `*.` 匹配每个子域。此示例允许内部项目可能需要的三个主机。

232 236

233```text theme={null}237```text theme={null}

234api.example.com238api.example.com

236registry.example.com240registry.example.com

237```241```

238 242

239此环境中的会话现在可以访问 `api.example.com`、`internal.example.com` 的任何子域和 `registry.example.com`，但无法通过会话的网络访问其他域。[GitHub 流量](#github-proxy)、[MCP 连接器流量](#network-access)和对环境[网络密钥](#add-network-secrets)的主机的请求（除了[永远不会获得该密钥的主机](#requests-that-never-get-the-credential)）不经过此允许列表。前导 `*.` 匹配每个子域。要同时保留 [Trusted 域](#default-allowed-domains)，请勾选 **Also include default list of common package managers**；不勾选则只允许您列出的内容。243勾选 **Allow package managers** 时，此环境中的会话除了可以访问您列出的域之外，还可以访问[默认允许列表](#default-allowed-domains)。清除该复选框可排除默认允许列表。[GitHub 流量](#github-proxy)、[MCP 连接器流量](#network-access)和对环境[网络密钥](#add-network-secrets)的主机的请求（除了[永远不会获得该密钥的主机](#requests-that-never-get-the-credential)）不经过此允许列表。

240 244

241如果您的组织使用 [Artifact](https://code.claude.com/docs/zh-CN/artifacts.md#availability)，会话读取 Artifact 时不需要在列表中包含 `*.frame.claudeusercontent.com`。当列表中没有该主机时，Claude Code 通过会话与 Anthropic 的连接读取 Artifact 内容。在两种情况下保留允许列表中的主机：245如果您的组织使用 [Artifact](https://code.claude.com/docs/zh-CN/artifacts.md#availability)，会话读取 Artifact 时不需要在列表中包含 `*.frame.claudeusercontent.com`。当列表中没有该主机时，Claude Code 通过会话与 Anthropic 的连接读取 Artifact 内容。在两种情况下保留允许列表中的主机：

242 246

243* **此环境中的会话打开另一个组织的公开 Artifact**：Claude Code 直接从主机获取这些 Artifact，因此将其添加到此列表。247* **此环境中的会话打开另一个组织的公开 Artifact**：Claude Code 直接从主机获取这些 Artifact，因此将其添加到此列表。

244* **您正在配置本地 CLI 或自托管运行器**：在该允许列表中保留主机。请参阅[网络访问要求](https://code.claude.com/docs/zh-CN/network-config.md#network-access-requirements)和自托管[网络要求](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#network-requirements)。248* **您正在配置本地 CLI 或自托管运行器**：在该允许列表中保留主机。请参阅[网络访问要求](https://code.claude.com/docs/zh-CN/network-config.md#network-access-requirements)和自托管[网络要求](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#network-requirements)。

245 249

246每个环境都有自己的允许域列表；没有组织级别的允许列表可供管理员推送到每个成员的环境。[服务器管理的设置](https://code.claude.com/docs/zh-CN/server-managed-settings.md)也不会将域添加到环境的网络允许列表。要为团队提供一个标准列表，Owner 可以创建一个具有 **Custom** 网络访问和该列表的[组织共享环境](#organization-shared-environments)。250每个环境都有自己的允许域列表；没有组织级别的允许列表可供管理员推送到每个成员的环境。[服务器管理的设置](https://code.claude.com/docs/zh-CN/server-managed-settings.md)也不会将域添加到环境的网络允许列表。要为团队提供一个标准列表，Owner 可以创建一个具有 **Limited** 网络访问和该列表的[组织共享环境](#organization-shared-environments)。

247 251

248### GitHub 代理252### GitHub 代理

249 253

255* **仓库范围**：代理为附加到会话的仓库处理 GitHub API 请求。针对其他仓库的 API 请求会收到 403，其消息以 `GitHub access to` 开头并包含 `is not enabled for this session`。当仓库未附加时，您通过 `github.com/{owner}/{repo}/archive/` 或 `codeload.github.com` URL 获取的源代码归档也会收到相同的 403，即使是公开仓库也是如此。259* **仓库范围**：代理为附加到会话的仓库处理 GitHub API 请求。针对其他仓库的 API 请求会收到 403，其消息以 `GitHub access to` 开头并包含 `is not enabled for this session`。当仓库未附加时，您通过 `github.com/{owner}/{repo}/archive/` 或 `codeload.github.com` URL 获取的源代码归档也会收到相同的 403，即使是公开仓库也是如此。

256* **GraphQL 限制**：代理会拒绝发往 GitHub GraphQL 端点的请求，返回 403，其消息以 `GitHub GraphQL is not available from Claude Code sessions` 开头，并指明 REST 回退方式 `gh api repos/{owner}/{repo}/...`。使用 GraphQL 的 `gh` 子命令（例如 `gh pr` 和 `gh issue`）也会收到相同的 403。无论您提供的凭据如何，限制都适用于通过代理的每个请求，因此您设置的 `GH_TOKEN` 会收到相同的 403。Claude 无法通过代理访问仅存在于 GraphQL 中的 GitHub API，例如 Projects v2。260* **GraphQL 限制**：代理会拒绝发往 GitHub GraphQL 端点的请求，返回 403，其消息以 `GitHub GraphQL is not available from Claude Code sessions` 开头，并指明 REST 回退方式 `gh api repos/{owner}/{repo}/...`。使用 GraphQL 的 `gh` 子命令（例如 `gh pr` 和 `gh issue`）也会收到相同的 403。无论您提供的凭据如何，限制都适用于通过代理的每个请求，因此您设置的 `GH_TOKEN` 会收到相同的 403。Claude 无法通过代理访问仅存在于 GraphQL 中的 GitHub API，例如 Projects v2。

257 261

258来自公开仓库的已提交文件通过 `raw.githubusercontent.com` 到达，改由[安全代理](#security-proxy)处理。该域在默认 [Trusted 列表](#default-allowed-domains)中，因此除非环境的[访问级别](#access-levels)排除它，否则这些文件保持可访问。262来自公开仓库的已提交文件通过 `raw.githubusercontent.com` 到达，改由[安全代理](#security-proxy)处理。该域在[默认允许列表](#default-allowed-domains)中，因此只要环境的[网络访问](#access-levels)允许该列表，这些文件就保持可访问。

259 263

260### 安全代理264### 安全代理

261 265

391service redis-server start395service redis-server start

392```396```

393 397

394Docker 可用于运行容器化服务。让 Claude 运行 `docker compose up` 以启动您项目的服务。拉取镜像的网络访问遵循您环境的[访问级别](#access-levels)，[Trusted 默认值](#default-allowed-domains)包括 Docker Hub 和其他常见注册表。398Docker 可用于运行容器化服务。让 Claude 运行 `docker compose up` 以启动您项目的服务。拉取镜像的网络访问遵循您环境的[访问级别](#access-levels)，[默认允许列表](#default-allowed-domains)包括 Docker Hub 和其他常见注册表。

395 399

396如果您的镜像很大或拉取速度很慢，请将 `docker compose pull` 或 `docker compose build` 添加到您的[设置脚本](#setup-scripts)。[环境缓存](#environment-caching)保留拉取的镜像，因此每个新会话的磁盘上都有它们。缓存仅保存文件，不保存运行中的进程，因此 Claude 仍然在每个会话中启动容器。400如果您的镜像很大或拉取速度很慢，请将 `docker compose pull` 或 `docker compose build` 添加到您的[设置脚本](#setup-scripts)。[环境缓存](#environment-caching)保留拉取的镜像，因此每个新会话的磁盘上都有它们。缓存仅保存文件，不保存运行中的进程，因此 Claude 仍然在每个会话中启动容器。

397 401

445 449

446* **以零退出**：如果脚本以非零状态退出，会话将[无法启动](https://code.claude.com/docs/zh-CN/web-quickstart.md#setup-script-failed)，或者在缺少脚本未能安装的内容的情况下启动。在非关键命令后附加 `|| true`，以便间歇性安装失败不会导致脚本失败。450* **以零退出**：如果脚本以非零状态退出，会话将[无法启动](https://code.claude.com/docs/zh-CN/web-quickstart.md#setup-script-failed)，或者在缺少脚本未能安装的内容的情况下启动。在非关键命令后附加 `|| true`，以便间歇性安装失败不会导致脚本失败。

447* **在五分钟内完成**：将脚本的总运行时间保持在大约五分钟以内，以便[环境缓存](#environment-caching)可以建立。当设置耗时超过五分钟时，环境不会被缓存。使用 `&` 和 `wait` 并行运行独立的安装，并将任何无法容纳的单个下载移至 [SessionStart hook](#setup-scripts-vs-sessionstart-hooks)，在后台启动它。如果新会话在设置期间停滞或失败，请参阅[新会话在设置期间挂起或超时](https://code.claude.com/docs/zh-CN/web-quickstart.md#new-sessions-hang-or-time-out-during-setup)。451* **在五分钟内完成**：将脚本的总运行时间保持在大约五分钟以内，以便[环境缓存](#environment-caching)可以建立。当设置耗时超过五分钟时，环境不会被缓存。使用 `&` 和 `wait` 并行运行独立的安装，并将任何无法容纳的单个下载移至 [SessionStart hook](#setup-scripts-vs-sessionstart-hooks)，在后台启动它。如果新会话在设置期间停滞或失败，请参阅[新会话在设置期间挂起或超时](https://code.claude.com/docs/zh-CN/web-quickstart.md#new-sessions-hang-or-time-out-during-setup)。

448* **安装需要网络访问**：包安装需要连接到注册表。默认的 **Trusted** 级别涵盖[常见包注册表](#default-allowed-domains)，包括 npm、PyPI、RubyGems 和 crates.io；使用 **None** 网络访问时，安装会失败。452* **安装需要网络访问**：包安装需要连接到注册表。在默认的 **Limited** 级别下勾选 **Allow package managers** 时，可访问[常见包注册表](#default-allowed-domains)，包括 npm、PyPI、RubyGems 和 crates.io。使用 **None** 网络访问时，安装会失败。

449* **环境的变量尚未设置**：脚本在会话设置环境的[环境变量](#set-environment-variables)之前运行。请在脚本本身中设置脚本所需的任何值。453* **环境的变量尚未设置**：脚本在会话设置环境的[环境变量](#set-environment-variables)之前运行。请在脚本本身中设置脚本所需的任何值。

450 454

451### 环境缓存455### 环境缓存

541* **每个会话一个仓库**：在 Anthropic 托管环境中，具有多个仓库的会话不会从任何仓库的 `.claude/settings.json` 加载 hook，因此您在那里定义的 SessionStart hook 不会运行。请改为使用[设置脚本](#setup-scripts)为这些会话安装依赖项。对于自托管环境，请参阅[适用哪个仓库的设置](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)。545* **每个会话一个仓库**：在 Anthropic 托管环境中，具有多个仓库的会话不会从任何仓库的 `.claude/settings.json` 加载 hook，因此您在那里定义的 SessionStart hook 不会运行。请改为使用[设置脚本](#setup-scripts)为这些会话安装依赖项。对于自托管环境，请参阅[适用哪个仓库的设置](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)。

542* **不适用于项目的云端线程**：[项目](https://code.claude.com/docs/zh-CN/claude-projects.md#what-threads-pick-up-from-your-repositories)中的云端线程不会运行来自仓库 `.claude/settings.json` 的 hook，无论仓库数量多少。在 Anthropic 托管环境中，请使用[设置脚本](#setup-scripts)为线程安装依赖项。在自托管环境中，请改为使用[运行程序主机设置](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)中的 hook。546* **不适用于项目的云端线程**：[项目](https://code.claude.com/docs/zh-CN/claude-projects.md#what-threads-pick-up-from-your-repositories)中的云端线程不会运行来自仓库 `.claude/settings.json` 的 hook，无论仓库数量多少。在 Anthropic 托管环境中，请使用[设置脚本](#setup-scripts)为线程安装依赖项。在自托管环境中，请改为使用[运行程序主机设置](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration.md#repository-settings-in-sessions-with-several-repositories)中的 hook。

543* **没有仅云端的范围**：hooks 在本地和云会话中都运行。要跳过本地运行，请在 `CLAUDE_CODE_REMOTE` 环境变量不为 `true` 时提前退出，就像[依赖项安装脚本](#install-dependencies-with-a-sessionstart-hook)所做的那样。547* **没有仅云端的范围**：hooks 在本地和云会话中都运行。要跳过本地运行，请在 `CLAUDE_CODE_REMOTE` 环境变量不为 `true` 时提前退出，就像[依赖项安装脚本](#install-dependencies-with-a-sessionstart-hook)所做的那样。

544* **需要网络访问**：安装命令需要连接到包注册表。如果您的环境使用 **None** 网络访问，这些 hooks 会失败。**Trusted** 下的[默认允许列表](#default-allowed-domains)涵盖 npm、PyPI、RubyGems 和 crates.io。548* **需要网络访问**：安装命令需要连接到包注册表。如果您的环境使用 **None** 网络访问，这些 hook 会失败。在默认的 **Limited** 级别下勾选 **Allow package managers** 时，[默认允许列表](#default-allowed-domains)涵盖 npm、PyPI、RubyGems 和 crates.io。

545* **代理兼容性**：在 Anthropic 托管环境中，所有出站流量都经过[安全代理](#security-proxy)，某些包管理器无法与此代理正确配合工作；Bun 是一个已知的例子。在[自托管环境](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#default-deny-egress)中，出站流量改为经过您自己的网络边界。549* **代理兼容性**：在 Anthropic 托管环境中，所有出站流量都经过[安全代理](#security-proxy)，某些包管理器无法与此代理正确配合工作；Bun 是一个已知的例子。在[自托管环境](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#default-deny-egress)中，出站流量改为经过您自己的网络边界。

546* **增加启动延迟**：hook 在每次会话启动或恢复时运行，不同于受益于[环境缓存](#environment-caching)的设置脚本。请通过跳过已完成的工作来保持安装脚本快速，就像[依赖项安装脚本](#install-dependencies-with-a-sessionstart-hook)所做的那样。550* **增加启动延迟**：hook 在每次会话启动或恢复时运行，不同于受益于[环境缓存](#environment-caching)的设置脚本。请通过跳过已完成的工作来保持安装脚本快速，就像[依赖项安装脚本](#install-dependencies-with-a-sessionstart-hook)所做的那样。

547 551

549 553

550## 默认允许的域554## 默认允许的域

551 555

552使用 **Trusted** 网络访问，会话默认可以访问以下域。标记为 `*` 的域表示通配符子域匹配，因此 `*.gcr.io` 允许 `gcr.io` 的任何子域。556在 **Limited** 网络访问下勾选 **Allow package managers** 时（新环境中默认即为此状态），会话可以访问以下域。标记为 `*` 的域表示通配符子域匹配，因此 `*.gcr.io` 允许 `gcr.io` 的任何子域。

553 557

554> [accordion] Anthropic 服务558> [accordion] Anthropic 服务

555>559>

commands.md +1 −1

Details

65| `/bug [report]` | 报告 bug 或分享您的对话。您可以选择包含多少会话历史，并在发送任何内容之前在同意屏幕上确认。当您通过第一方连接登录 Anthropic 时，报告会发送给 Anthropic；在第三方提供商上，或没有 Anthropic 凭据时，Claude Code 会将报告写入[位于 `~/.claude/feedback-bundles/` 下的本地归档](https://code.claude.com/docs/zh-CN/data-usage#telemetry-services)，由您自行转发。在 [VS Code 扩展](https://code.claude.com/docs/zh-CN/vs-code.md#use-the-prompt-box)中，`/bug` 会改为打开扩展自己的反馈对话框；需要 Claude Code v2.1.229 或更高版本。如果在 Claude 回复时运行此命令，Claude Code 会立即打开对话框。在 v2.1.232 之前，Claude Code 会将该命令排队，直到该轮次结束。别名：`/share`。在 v2.1.212 之前，`/bug` 和 `/share` 是 `/feedback` 的别名 |65| `/bug [report]` | 报告 bug 或分享您的对话。您可以选择包含多少会话历史，并在发送任何内容之前在同意屏幕上确认。当您通过第一方连接登录 Anthropic 时，报告会发送给 Anthropic；在第三方提供商上，或没有 Anthropic 凭据时，Claude Code 会将报告写入[位于 `~/.claude/feedback-bundles/` 下的本地归档](https://code.claude.com/docs/zh-CN/data-usage#telemetry-services)，由您自行转发。在 [VS Code 扩展](https://code.claude.com/docs/zh-CN/vs-code.md#use-the-prompt-box)中，`/bug` 会改为打开扩展自己的反馈对话框；需要 Claude Code v2.1.229 或更高版本。如果在 Claude 回复时运行此命令，Claude Code 会立即打开对话框。在 v2.1.232 之前，Claude Code 会将该命令排队，直到该轮次结束。别名：`/share`。在 v2.1.212 之前，`/bug` 和 `/share` 是 `/feedback` 的别名 |

66| `/cd <path>` | 将此会话移动到新的工作目录，同时保留对话。输入部分路径可查看匹配的目录建议；按 `Tab` 接受其中一个。有关移动后 Claude Code 会立即从新目录应用哪些内容，以及 `/cd` 与 `/add-dir` 的区别，请参阅[将会话移动到另一个目录](https://code.claude.com/docs/zh-CN/permissions.md#move-the-session-to-another-directory) |66| `/cd <path>` | 将此会话移动到新的工作目录，同时保留对话。输入部分路径可查看匹配的目录建议；按 `Tab` 接受其中一个。有关移动后 Claude Code 会立即从新目录应用哪些内容，以及 `/cd` 与 `/add-dir` 的区别，请参阅[将会话移动到另一个目录](https://code.claude.com/docs/zh-CN/permissions.md#move-the-session-to-another-directory) |

67| `/chrome` | 配置 [Claude in Chrome](https://code.claude.com/docs/zh-CN/chrome.md) 设置 |67| `/chrome` | 配置 [Claude in Chrome](https://code.claude.com/docs/zh-CN/chrome.md) 设置 |

68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。** 加载适用于您项目语言的 [Claude API](https://platform.claude.com/docs/en/api/overview) 和 [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) 参考资料。当您的代码导入 `anthropic` 或 `@anthropic-ai/sdk` 时也会自动激活。有关每个子命令的作用及其所需版本，请参阅[处理 Claude API 项目](https://code.claude.com/docs/zh-CN/skills.md#work-on-claude-api-projects) |68| `/claude-api [migrate\|upgrade\|api-version\|managed-agents-onboard\|managed-agents-secure\|prompt-audit\|cost-optimize\|latency-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。** 加载适用于您项目语言的 [Claude API](https://platform.claude.com/docs/en/api/overview) 和 [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) 参考资料。当您的代码导入 `anthropic` 或 `@anthropic-ai/sdk` 时也会自动激活。有关每个子命令的作用及其所需版本，请参阅[处理 Claude API 项目](https://code.claude.com/docs/zh-CN/skills.md#work-on-claude-api-projects) |

69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。** 让 Claude 通过 [Claude in Chrome](https://code.claude.com/docs/zh-CN/chrome.md) 在您的浏览器中执行任务，例如测试页面、填写表单或读取控制台日志。当会话启用了 Chrome 集成时可用（例如使用 `claude --chrome`），或者当 Claude Code 可以提议[安装扩展](https://code.claude.com/docs/zh-CN/chrome.md#install-the-extension-when-claude-asks)时可用 |69| `/claude-in-chrome [task]` | **[Skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。** 让 Claude 通过 [Claude in Chrome](https://code.claude.com/docs/zh-CN/chrome.md) 在您的浏览器中执行任务，例如测试页面、填写表单或读取控制台日志。当会话启用了 Chrome 集成时可用（例如使用 `claude --chrome`），或者当 Claude Code 可以提议[安装扩展](https://code.claude.com/docs/zh-CN/chrome.md#install-the-extension-when-claude-asks)时可用 |

70| `/clear [name]` | 使用空上下文开始新对话。传递名称可在 `/resume` 选择器中为之前的对话添加标签。要在继续同一对话的同时释放上下文，请改用 `/compact`。使用 `/resume` 恢复之前的对话，或者在同一 Claude Code 进程中，从[回退菜单的上一个会话条目](https://code.claude.com/docs/zh-CN/checkpointing.md#rewind-past-a-cleared-conversation)恢复。别名：`/reset`、`/new` |70| `/clear [name]` | 使用空上下文开始新对话。传递名称可在 `/resume` 选择器中为之前的对话添加标签。要在继续同一对话的同时释放上下文，请改用 `/compact`。使用 `/resume` 恢复之前的对话，或者在同一 Claude Code 进程中，从[回退菜单的上一个会话条目](https://code.claude.com/docs/zh-CN/checkpointing.md#rewind-past-a-cleared-conversation)恢复。别名：`/reset`、`/new` |

71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。** 审查当前 diff，或您传递的 PR 编号、分支或路径，查找正确性 bug。根据您的模型和 effort 级别，审查还会涵盖清理机会。传递 `--fix` 可让 Claude 应用发现的问题，传递 `--comment` 可将其发布到 GitHub PR 或 GitLab Merge Request 上，传递 `ultra` 可运行深度[云端审查](https://code.claude.com/docs/zh-CN/ultrareview.md)。发布到 GitLab Merge Request 需要 Claude Code v2.1.257 或更高版本。在以 `github.com` PR 为目标使用 `ultra` 时，传递 `--post` 可在启动对话框中预先选择[将完成的发现发布到 PR](https://code.claude.com/docs/zh-CN/ultrareview.md#post-findings-to-the-pull-request)；`--post` 需要 Claude Code v2.1.227 或更高版本。有关 effort 级别、目标指定方式以及它与 `/simplify` 的关系，请参阅[使用 `/code-review` 在本地审查](https://code.claude.com/docs/zh-CN/code-review-local)。别名：`/review` |71| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [--max-findings n\|all\|default] [pr#\|branch\|path]` | **[Skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。** 审查当前 diff，或您传递的 PR 编号、分支或路径，查找正确性 bug。根据您的模型和 effort 级别，审查还会涵盖清理机会。传递 `--fix` 可让 Claude 应用发现的问题，传递 `--comment` 可将其发布到 GitHub PR 或 GitLab Merge Request 上，传递 `ultra` 可运行深度[云端审查](https://code.claude.com/docs/zh-CN/ultrareview.md)。发布到 GitLab Merge Request 需要 Claude Code v2.1.257 或更高版本。在以 `github.com` PR 为目标使用 `ultra` 时，传递 `--post` 可在启动对话框中预先选择[将完成的发现发布到 PR](https://code.claude.com/docs/zh-CN/ultrareview.md#post-findings-to-the-pull-request)；`--post` 需要 Claude Code v2.1.227 或更高版本。有关 effort 级别、目标指定方式以及它与 `/simplify` 的关系，请参阅[使用 `/code-review` 在本地审查](https://code.claude.com/docs/zh-CN/code-review-local)。别名：`/review` |

common-workflows.md +1 −1

Details

466claude --worktree feature-auth466claude --worktree feature-auth

467```467```

468 468

469在第二个终端中使用不同的名称运行相同的命令以启动隔离的并行会话。在没有提交的存储库中，该命令失败并显示 `Failed to resolve base branch "HEAD": git rev-parse failed`。有关清理、`.worktreeinclude` 和非 git VCS 支持，请参阅 [Worktrees](https://code.claude.com/docs/zh-CN/worktrees.md)。要从一个屏幕而不是单独的终端监视并行会话，请参阅[后台代理](https://code.claude.com/docs/zh-CN/agent-view.md)。469在第二个终端中使用不同的名称运行相同的命令以启动隔离的并行会话。有关清理、`.worktreeinclude` 和非 git VCS 支持，请参阅 [Worktrees](https://code.claude.com/docs/zh-CN/worktrees.md)。要从一个屏幕而不是单独的终端监视并行会话，请参阅[后台 Agent](https://code.claude.com/docs/zh-CN/agent-view.md)。

470 470

471## 编辑前规划471## 编辑前规划

472 472

context-window.md +1 −1

Details

19 19

20## 压缩后保留的内容20## 压缩后保留的内容

21 21

22当长会话压缩时，Claude Code 会总结对话历史以适应上下文窗口。从 v2.1.198 开始，总结请求继承您会话的[扩展思考](https://code.claude.com/docs/zh-CN/model-config.md#extended-thinking)配置，因此当您的会话启用思考时，它会在启用思考的情况下进行推理，否则保持关闭。思考仅影响摘要的生成方式；您的会话设置之后保持不变。每种内容的处理方式取决于其加载方式：22当长会话压缩时，Claude Code 会总结对话历史以适应上下文窗口。

23 23

24| 机制 | 压缩后 |24| 机制 | 压缩后 |

25| :- | :- |25| :- | :- |

env-vars.md +6 −5

Details

243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 设置为 `1` 可禁用 Claude Code 随附的 [skill](https://code.claude.com/docs/zh-CN/skills.md) 和工作流：随附 skill 和工作流会被完全移除，而 `/init` 等内置命令仍可输入，但会对模型隐藏。`/doctor` 与内置命令一样仍可输入；请改用 `DISABLE_DOCTOR_COMMAND` 将其隐藏。来自插件、`.claude/skills/` 和 `.claude/commands/` 的 skill 不受影响。等同于 [`disableBundledSkills`](https://code.claude.com/docs/zh-CN/settings-reference#disablebundledskills) 设置 |243| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | 设置为 `1` 可禁用 Claude Code 随附的 [skill](https://code.claude.com/docs/zh-CN/skills.md) 和工作流：随附 skill 和工作流会被完全移除，而 `/init` 等内置命令仍可输入，但会对模型隐藏。`/doctor` 与内置命令一样仍可输入；请改用 `DISABLE_DOCTOR_COMMAND` 将其隐藏。来自插件、`.claude/skills/` 和 `.claude/commands/` 的 skill 不受影响。等同于 [`disableBundledSkills`](https://code.claude.com/docs/zh-CN/settings-reference#disablebundledskills) 设置 |

244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 适用于嵌入 Claude Code 并提供自己的浏览器指导的宿主。设置为 `1` 可在保留 [Claude in Chrome](https://code.claude.com/docs/zh-CN/chrome.md) 浏览器工具可用的同时，省略系统提示词中的 Chrome 部分以及 `/claude-in-chrome` [随附 skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。在 VS Code 中，v2.1.314 或更高版本的扩展还会将 Claude in Chrome 指令排除在会话消息之外。需要 Claude Code v2.1.257 或更高版本 |244| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | 适用于嵌入 Claude Code 并提供自己的浏览器指导的宿主。设置为 `1` 可在保留 [Claude in Chrome](https://code.claude.com/docs/zh-CN/chrome.md) 浏览器工具可用的同时，省略系统提示词中的 Chrome 部分以及 `/claude-in-chrome` [随附 skill](https://code.claude.com/docs/zh-CN/skills.md#bundled-skills)。在 VS Code 中，v2.1.314 或更高版本的扩展还会将 Claude in Chrome 指令排除在会话消息之外。需要 Claude Code v2.1.257 或更高版本 |

246| `CLAUDE_CODE_DISABLE_CRON` | 设置为 `1` 可禁用[会话范围的定时任务](https://code.claude.com/docs/zh-CN/scheduled-tasks.md)。`/loop` skill 和 cron 工具将不可用，所有已安排的任务都会停止触发，包括会话中途已在运行的任务 |246| `CLAUDE_CODE_DISABLE_CRON` | 设置为 `1` 可禁用[会话作用域的定时任务](https://code.claude.com/docs/zh-CN/scheduled-tasks.md#disable-scheduled-tasks)。`/loop` skill 和 `CronCreate` 将不可用，任何已安排的任务都会停止触发，包括会话中途已在运行的任务 |

247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 设为 `1` 可关闭 `auto` 和 `bypassPermissions` 模式下针对关键路径删除操作的[时间限制和拒绝](https://code.claude.com/docs/zh-CN/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)。这些删除操作随后在 `auto` 模式下交由分类器处理，在 `bypassPermissions` 模式下，只要 Claude Code 能够显示提示，就会显示不限时的提示。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置 `env` 块传递的副本。需要 Claude Code v2.1.281 或更高版本 |247| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | 设为 `1` 可关闭 `auto` 和 `bypassPermissions` 模式下针对关键路径删除操作的[时间限制和拒绝](https://code.claude.com/docs/zh-CN/permission-modes.md#time-limits-and-denials-in-auto-and-bypasspermissions-modes)。这些删除操作随后在 `auto` 模式下交由分类器处理，在 `bypassPermissions` 模式下，只要 Claude Code 能够显示提示，就会显示不限时的提示。请在启动 Claude Code 的环境中设置它，因为 Claude Code 会忽略通过设置 `env` 块传递的副本。需要 Claude Code v2.1.281 或更高版本 |

248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 设置为 `1` 可从 API 请求中移除预发布的 `anthropic-beta` 请求标头、与其配对的请求体字段，以及 `defer_loading` 和 `eager_input_streaming` 等 beta 工具架构字段。当代理网关因 `anthropic-beta` 标头返回 `Unexpected value(s)` 错误或返回 `Extra inputs are not permitted` 错误而拒绝请求时使用。[禁用预发布功能](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#disable-pre-release-capabilities)列出了该变量移除的内容（包括 [MCP 工具搜索](https://code.claude.com/docs/zh-CN/mcp.md#scale-with-mcp-tool-search)）以及 Claude Code 仍会发送的内容 |248| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 设置为 `1` 可从 API 请求中移除预发布的 `anthropic-beta` 请求标头、与其配对的请求体字段，以及 `defer_loading` 和 `eager_input_streaming` 等 beta 工具架构字段。当代理网关因 `anthropic-beta` 标头返回 `Unexpected value(s)` 错误或返回 `Extra inputs are not permitted` 错误而拒绝请求时使用。[禁用预发布功能](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#disable-pre-release-capabilities)列出了该变量移除的内容（包括 [MCP 工具搜索](https://code.claude.com/docs/zh-CN/mcp.md#scale-with-mcp-tool-search)）以及 Claude Code 仍会发送的内容 |

249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 设置为 `1` 可禁用内置的 [Explore 和 Plan 子代理](https://code.claude.com/docs/zh-CN/sub-agents.md#built-in-subagents)。Claude 会改用其搜索工具或 general-purpose 子代理进行探索，[计划模式](https://code.claude.com/docs/zh-CN/permission-modes.md#analyze-before-you-edit-with-plan-mode)会直接读取文件，而不是启动 Explore 和 Plan Agent。名为 `Explore` 或 `Plan` 的自定义子代理不受影响。若要在 Agent SDK 或非交互模式下移除所有内置子代理类型，请改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更高版本 |249| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 设置为 `1` 可禁用内置的 [Explore 和 Plan 子代理](https://code.claude.com/docs/zh-CN/sub-agents.md#built-in-subagents)。Claude 会改用其搜索工具或 general-purpose 子代理进行探索，[计划模式](https://code.claude.com/docs/zh-CN/permission-modes.md#analyze-before-you-edit-with-plan-mode)会直接读取文件，而不是启动 Explore 和 Plan Agent。名为 `Explore` 或 `Plan` 的自定义子代理不受影响。若要在 Agent SDK 或非交互模式下移除所有内置子代理类型，请改用 `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`。需要 Claude Code v2.1.198 或更高版本 |

251| `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` | 设置为 `1` 可关闭功能标志获取。需要 Claude Code v2.1.319 或更高版本。设置此变量后，[Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md#requirements) 和其他[需要获取功能标志的功能](#features-that-need-feature-flag-fetching)将不可用。除非同时设置了 `DISABLE_TELEMETRY`，否则遥测事件日志记录保持开启。旧名称 `DISABLE_GROWTHBOOK` 仍然有效，并且它是 v2.1.124 至 v2.1.318 唯一读取的名称 |

251| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 设置为 `1` 可禁用 "How is Claude doing?" 会话质量调查。当设置了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 时，调查也会被禁用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新选择启用。若要设置采样率而不是完全禁用，请使用 [`feedbackSurveyRate`](https://code.claude.com/docs/zh-CN/settings-reference#feedbacksurveyrate) 设置。请参阅[会话质量调查](https://code.claude.com/docs/zh-CN/data-usage.md#session-quality-surveys) |252| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 设置为 `1` 可禁用 "How is Claude doing?" 会话质量调查。当设置了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 时，调查也会被禁用，除非 `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` 重新选择启用。若要设置采样率而不是完全禁用，请使用 [`feedbackSurveyRate`](https://code.claude.com/docs/zh-CN/settings-reference#feedbacksurveyrate) 设置。请参阅[会话质量调查](https://code.claude.com/docs/zh-CN/data-usage.md#session-quality-surveys) |

252| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 设置为 `1` 可禁用文件[检查点功能](https://code.claude.com/docs/zh-CN/checkpointing.md)。`/rewind` 命令将无法恢复代码更改。覆盖 [`fileCheckpointingEnabled`](https://code.claude.com/docs/zh-CN/settings-reference#filecheckpointingenabled) 设置 |253| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | 设置为 `1` 可禁用文件[检查点功能](https://code.claude.com/docs/zh-CN/checkpointing.md)。`/rewind` 命令将无法恢复代码更改。覆盖 [`fileCheckpointingEnabled`](https://code.claude.com/docs/zh-CN/settings-reference#filecheckpointingenabled) 设置 |

253| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | 设置为 `1` 可阻止 Claude Code 展开文件和目录的 [`@` 提及](https://code.claude.com/docs/zh-CN/common-workflows#reference-files-and-directories)。Claude 会改为获得所提及的路径，并附带一条让其使用文件工具读取这些路径的说明。在[项目和本地设置](https://code.claude.com/docs/zh-CN/settings-reference.md#variables-claude-code-ignores-in-env)中会被忽略。需要 Claude Code v2.1.299 或更高版本 |254| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | 设置为 `1` 可阻止 Claude Code 展开文件和目录的 [`@` 提及](https://code.claude.com/docs/zh-CN/common-workflows#reference-files-and-directories)。Claude 会改为获得所提及的路径，并附带一条让其使用文件工具读取这些路径的说明。在[项目和本地设置](https://code.claude.com/docs/zh-CN/settings-reference.md#variables-claude-code-ignores-in-env)中会被忽略。需要 Claude Code v2.1.299 或更高版本 |

453| `DISABLE_FEEDBACK_COMMAND` | 设置为 `1` 可禁用 `/feedback` 命令和 [Claude 起草的反馈](https://code.claude.com/docs/zh-CN/tools-reference.md#sendfeedback-tool-behavior)。同时还会禁用通过同一路径报告的 `/bug` 和 `/share`；在 v2.1.212 之前，它们是 `/feedback` 的别名，因此该命令在所有名称下都会被禁用。也接受旧名称 `DISABLE_BUG_COMMAND` |454| `DISABLE_FEEDBACK_COMMAND` | 设置为 `1` 可禁用 `/feedback` 命令和 [Claude 起草的反馈](https://code.claude.com/docs/zh-CN/tools-reference.md#sendfeedback-tool-behavior)。同时还会禁用通过同一路径报告的 `/bug` 和 `/share`；在 v2.1.212 之前，它们是 `/feedback` 的别名，因此该命令在所有名称下都会被禁用。也接受旧名称 `DISABLE_BUG_COMMAND` |

454| `DISABLE_GROWTHBOOK` | 设置为 `1` 或 `true` 可禁用功能标志获取，并对每个标志使用代码中的默认值。这会使 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md#requirements) 以及其他[需要获取功能标志的功能](#features-that-need-feature-flag-fetching)不可用。设置为 `0` 或 `false` 会保持获取开启。除非同时设置了 `DISABLE_TELEMETRY`，否则遥测事件日志记录保持开启 |455| `DISABLE_GROWTHBOOK` | 设置为 `1` 可关闭[功能标志获取](#features-that-need-feature-flag-fetching)。需要 Claude Code v2.1.124 或更高版本。已被 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 取代，后者需要 v2.1.319 或更高版本：请使用该名称，除非有运行 v2.1.318 或更早版本的机器读取该配置。此名称仍然有效 |

456| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | 设置为 `1` 可隐藏 `/install-github-app` 命令。使用第三方提供商（Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry）时已默认隐藏 |457| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | 设置为 `1` 可隐藏 `/install-github-app` 命令。使用第三方提供商（Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry）时已默认隐藏 |

457| `DISABLE_INTERLEAVED_THINKING` | 设置为 `1` 可阻止发送 interleaved-thinking beta 标头。适用于您的 LLM 网关或提供商不支持[交错思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)的情况 |458| `DISABLE_INTERLEAVED_THINKING` | 设置为 `1` 可阻止发送 interleaved-thinking beta 标头。适用于您的 LLM 网关或提供商不支持[交错思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking)的情况 |

569 570

570Claude Code 通过从 Anthropic 获取的功能标志来启用部分功能。在以下会话中，Claude Code 会跳过该获取操作：571Claude Code 通过从 Anthropic 获取的功能标志来启用部分功能。在以下会话中，Claude Code 会跳过该获取操作：

571 572

572* 设置了 `DISABLE_GROWTHBOOK`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 的会话；[变量表](#variables)中每个变量所在的行说明了哪些值会关闭获取573* 设置了 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 的会话；[变量表](#variables)中每个变量所在的行说明了哪些值会关闭获取

573* 使用[第三方提供商](https://code.claude.com/docs/zh-CN/third-party-integrations.md)（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry）的会话，除非嵌入 Claude Code 的宿主平台设置了 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`574* 使用[第三方提供商](https://code.claude.com/docs/zh-CN/third-party-integrations.md)（例如 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry）的会话，除非嵌入 Claude Code 的宿主平台设置了 `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`

574* [Claude apps 网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway)会话575* [Claude apps 网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway)会话

575 576

576关闭获取后，您将无法：577关闭获取后，您将无法：

577 578

578* 在设置了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK` 的情况下使用 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md)。关于 `DISABLE_TELEMETRY` 和 `DO_NOT_TRACK`，请参阅 [Remote Control 要求](https://code.claude.com/docs/zh-CN/remote-control.md#requirements)579* 在设置了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](#variables) 的情况下使用 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md)。关于 `DISABLE_TELEMETRY` 和 `DO_NOT_TRACK`，请参阅 [Remote Control 要求](https://code.claude.com/docs/zh-CN/remote-control.md#requirements)

579* 在 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md#requirements) 不可用时[向本机以外的会话发送消息](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#message-sessions-on-other-machines)。关闭获取后，本机上会话之间的消息传递仍可正常工作580* 在 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md#requirements) 不可用时[向本机以外的会话发送消息](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#message-sessions-on-other-machines)。关闭获取后，本机上会话之间的消息传递仍可正常工作

580* 运行 [`claude import` 或 `/import` 命令](https://code.claude.com/docs/zh-CN/cli-reference#cli-commands)581* 运行 [`claude import` 或 `/import` 命令](https://code.claude.com/docs/zh-CN/cli-reference#cli-commands)

581* 运行 [`/skill-doctor`](https://code.claude.com/docs/zh-CN/skills#find-unused-skills) 或在 `/plugin` 的 **Stats** 选项卡中打开其报告582* 运行 [`/skill-doctor`](https://code.claude.com/docs/zh-CN/skills#find-unused-skills) 或在 `/plugin` 的 **Stats** 选项卡中打开其报告

582* 在 Pro、Max 和 Ultra 计划中运行 [`/restart`](https://code.claude.com/docs/zh-CN/commands)583* 在 Pro、Max 和 Ultra 计划中运行 [`/restart`](https://code.claude.com/docs/zh-CN/commands)

583* 将您的 claude.ai 账户中启用的 [skill](https://code.claude.com/docs/zh-CN/skills.md#where-synced-skills-load) 和[插件](https://code.claude.com/docs/zh-CN/plugins/loading.md#synced-plugins)同步到终端会话中584* 将您的 claude.ai 账户中启用的 [skill](https://code.claude.com/docs/zh-CN/skills.md#where-synced-skills-load) 和[插件](https://code.claude.com/docs/zh-CN/plugins/loading.md#synced-plugins)同步到终端会话中

584* 启用 [You should know mod](https://code.claude.com/docs/zh-CN/interactive-mode.md#you-should-know-suggestions)585* 启用 [You should know mod](https://code.claude.com/docs/zh-CN/interactive-mode.md#you-should-know-suggestions)

585* 使用 [advisor 工具](https://code.claude.com/docs/zh-CN/advisor.md#requirements)586* 使用 [advisor 工具](https://code.claude.com/docs/zh-CN/advisor.md#requirements)，但在 Claude Platform on AWS 上使用 Claude Code v2.1.300 或更高版本时除外

586* 使用 [MCP 任务](https://code.claude.com/docs/zh-CN/mcp.md#mcp-tasks-that-run-on-the-server)587* 使用 [MCP 任务](https://code.claude.com/docs/zh-CN/mcp.md#mcp-tasks-that-run-on-the-server)

587* 阅读或回复 [Artifact 上的评论](https://code.claude.com/docs/zh-CN/artifacts.md#collect-comments-on-an-artifact)588* 阅读或回复 [Artifact 上的评论](https://code.claude.com/docs/zh-CN/artifacts.md#collect-comments-on-an-artifact)

588* 让 Claude 读取[其他组织的公开 Artifact](https://code.claude.com/docs/zh-CN/artifacts.md#read-an-artifact-shared-with-you)589* 让 Claude 读取[其他组织的公开 Artifact](https://code.claude.com/docs/zh-CN/artifacts.md#read-an-artifact-shared-with-you)

errors.md +17 −10

Details

562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 500 | 当 API 以 `529` 过载错误拒绝请求时，该请求各次重试之间退避的起始延迟（毫秒）。当 API 容量已满时，可将其提高（最高 32000），以便在更长的时间窗口内分散重试。当 `CLAUDE_CODE_RETRY_WATCHDOG` 设置为 `1`，或被拒绝的请求是在[快速模式](https://code.claude.com/docs/zh-CN/fast-mode.md#handle-rate-limits)下发送时，此变量无效。需要 Claude Code v2.1.292 或更高版本。 |562| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 500 | 当 API 以 `529` 过载错误拒绝请求时，该请求各次重试之间退避的起始延迟（毫秒）。当 API 容量已满时，可将其提高（最高 32000），以便在更长的时间窗口内分散重试。当 `CLAUDE_CODE_RETRY_WATCHDOG` 设置为 `1`，或被拒绝的请求是在[快速模式](https://code.claude.com/docs/zh-CN/fast-mode.md#handle-rate-limits)下发送时，此变量无效。需要 Claude Code v2.1.292 或更高版本。 |

563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 32000 | 当 API 以 `529` 过载错误拒绝请求时，该请求各次重试之间退避的上限（毫秒）。当 API 容量已满时，可将其提高（最高 64000），使后续重试之间的间隔持续拉大。当 `CLAUDE_CODE_RETRY_WATCHDOG` 设置为 `1`，或被拒绝的请求是在[快速模式](https://code.claude.com/docs/zh-CN/fast-mode.md#handle-rate-limits)下发送时，此变量无效。需要 Claude Code v2.1.296 或更高版本。 |563| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 32000 | 当 API 以 `529` 过载错误拒绝请求时，该请求各次重试之间退避的上限（毫秒）。当 API 容量已满时，可将其提高（最高 64000），使后续重试之间的间隔持续拉大。当 `CLAUDE_CODE_RETRY_WATCHDOG` 设置为 `1`，或被拒绝的请求是在[快速模式](https://code.claude.com/docs/zh-CN/fast-mode.md#handle-rate-limits)下发送时，此变量无效。需要 Claude Code v2.1.296 或更高版本。 |

564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 600000 | 每次请求尝试接收其响应头的时限（毫秒）。它不限制流式响应在此之后持续的时长。为慢速网络或代理提高它。关于它如何限制首字节截止时间，请参阅 [No response from API](#no-response-from-api)。 |564| [`API_TIMEOUT_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 600000 | 每次请求尝试接收其响应头的时限（毫秒）。它不限制流式响应在此之后持续的时长。为慢速网络或代理提高它。关于它如何限制首字节截止时间，请参阅 [No response from API](#no-response-from-api)。 |

565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/zh-CN/env-vars) | 未设置 | 超时的[非流式请求](#streaming-response-ended-before-any-complete-data-was-received)的重新发送次数限制。达到该限制时，请求失败。生成时间超过超时时间的 Claude 响应在每次重新发送时都会再次超时，因此请设置较低的数值（例如 `0`）以更快地失败。在本地会话中，每次非流式尝试在 300 秒后超时；当您为 `API_TIMEOUT_MS` 设置正值时，则在该值指定的时间后超时。需要 Claude Code v2.1.285 或更高版本。 |565| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](https://code.claude.com/docs/zh-CN/env-vars) | 未设置 | 超时的[非流式请求](#streaming-response-ended-before-any-complete-data-was-received)的重新发送次数限制。达到该限制时，请求失败。生成时间超过超时时间的 Claude 响应在每次重新发送时都会再次超时，因此请设置较低的数值（例如 `0`）以更快地失败。关于每次尝试的超时时间，请参阅[非流式尝试的等待时长](#how-long-a-non-streaming-attempt-waits)。需要 Claude Code v2.1.285 或更高版本。 |

566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 未设置 | 流式请求的第一个响应字节的截止时间（毫秒）。需要 Claude Code v2.1.242 或更高版本。对于当此未设置时 Claude Code 如何选择截止时间，请参阅 [No response from API](#no-response-from-api)。 |566| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](https://code.claude.com/docs/zh-CN/env-vars) | 未设置 | 流式请求的第一个响应字节的截止时间（毫秒）。需要 Claude Code v2.1.242 或更高版本。对于当此未设置时 Claude Code 如何选择截止时间，请参阅 [No response from API](#no-response-from-api)。 |

567 567

568#### 非流式尝试的等待时长

569

570非流式尝试会在达到其请求超时或正文空闲超时时结束，以先到者为准：

571

572* **请求超时**：当您为 `API_TIMEOUT_MS` 设置正值时为该值，否则在本地会话中为 300 秒。

573* **[正文空闲超时](https://code.claude.com/docs/zh-CN/network-config.md#streaming-idle-watchdogs)**：在该超时生效且您未将其关闭的情况下，5 到 6 分钟未收到响应即超时，无论您将 `API_TIMEOUT_MS` 设置得多高。

574

568## 服务器错误575## 服务器错误

569 576

570这些错误中的大多数来自推理提供商：Anthropic API 上的 Anthropic 服务，以及 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自定义网关上该提供商端点后面的服务。[自动模式无法确定操作的安全性](#auto-mode-cannot-determine-the-safety-of-an-action)和[Agent 因 API 错误而提前终止](#agent-terminated-early-due-to-an-api-error)也涵盖了您这一方的原因，例如无法调用分类器模型的 Amazon Bedrock 账户或达到用量限制的子代理。577这些错误中的大多数来自推理提供商：Anthropic API 上的 Anthropic 服务，以及 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自定义网关上该提供商端点后面的服务。[自动模式无法确定操作的安全性](#auto-mode-cannot-determine-the-safety-of-an-action)和[Agent 因 API 错误而提前终止](#agent-terminated-early-due-to-an-api-error)也涵盖了您这一方的原因，例如无法调用分类器模型的 Amazon Bedrock 账户或达到用量限制的子代理。

2212此错误并非客户端网络问题。云端会话和[云端定时任务](https://code.claude.com/docs/zh-CN/routines.md)运行在沙箱虚拟机中，其经由会话网络的出站流量会按照[云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)的允许列表进行过滤：2219此错误并非客户端网络问题。云端会话和[云端定时任务](https://code.claude.com/docs/zh-CN/routines.md)运行在沙箱虚拟机中，其经由会话网络的出站流量会按照[云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)的允许列表进行过滤：

2213 2220

2214* **GitHub 和连接器流量**：[GitHub 操作](https://code.claude.com/docs/zh-CN/cloud-environments.md#github-proxy)和 MCP 连接器流量使用独立的通道，因此在其他主机被阻止时它们仍可能正常工作2221* **GitHub 和连接器流量**：[GitHub 操作](https://code.claude.com/docs/zh-CN/cloud-environments.md#github-proxy)和 MCP 连接器流量使用独立的通道，因此在其他主机被阻止时它们仍可能正常工作

2215* **默认环境**：**Default** 环境使用 **Trusted** 访问级别，该级别允许包含软件包仓库、云提供商 API、容器镜像仓库和常见开发域名的[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)，并在该路径上阻止其他域名2222* **默认环境**：**Default** 环境使用 **Limited** 访问级别，并勾选了 **Allow package managers**。其会话可以访问包含软件包仓库、云提供商 API、容器镜像仓库和常见开发域名的[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)。

2216 2223

2217**解决方法：**2224**解决方法：**

2218 2225

2219以下步骤用于更改您自己的环境。[组织共享环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#organization-shared-environments)在选择器中以只读方式打开，因此请让 Owner 在[管理设置](https://claude.ai/admin-settings)的 **Cloud environments** 页面中更改其网络访问。2226以下步骤用于更改您自己的环境。[组织共享环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#organization-shared-environments)在选择器中以只读方式打开，因此请让 Owner 在[管理设置](https://claude.ai/admin-settings)的 **Cloud environments** 页面中更改其网络访问。

2220 2227

2221* 打开您的环境进行编辑，可以从[云端定时任务的表单](https://code.claude.com/docs/zh-CN/routines.md#environments-and-network-access)打开，也可以从您启动云端会话的[环境选择器](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)打开。2228* 打开您的环境进行编辑，可以从[云端定时任务的表单](https://code.claude.com/docs/zh-CN/routines.md#environments-and-network-access)打开，也可以从您启动云端会话的[环境选择器](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)打开。

2222* 在 **Edit cloud environment** 对话框中，将 **Network access** 从 **Trusted** 更改为 **Custom**，然后将被阻止的域名添加到 **Allowed domains**。每行输入一个域名。勾选 **Also include default list of common package managers**，可在自定义域名之外保留[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)。如果您需要不受限制的访问，请改为选择 **Full**。2229* 在 **Edit cloud environment** 对话框中，在 **Network access** 下选择 **Limited**，然后将被阻止的域名添加到 **Allowed domains**。每行输入一个域名。勾选 **Allow package managers**，可在您自己的域名之外允许[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)。如果您需要不受限制的访问，请改为选择 **Full**。

2223* 点击 **Save changes**。下一次运行将使用更新后的允许列表。对于已经打开的云端会话，请参阅[网络访问更改何时作用于现有会话](https://code.claude.com/docs/zh-CN/cloud-environments.md#network-access)。2230* 点击 **Save changes**。下一次运行将使用更新后的允许列表。对于已经打开的云端会话，请参阅[网络访问更改何时作用于现有会话](https://code.claude.com/docs/zh-CN/cloud-environments.md#network-access)。

2224 2231

2225有关访问级别和默认允许列表，请参阅[网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#network-access)。本地 CLI 会话不受此策略影响。2232有关访问级别和默认允许列表，请参阅[网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#network-access)。本地 CLI 会话不受此策略影响。

2342**解决方法：**2349**解决方法：**

2343 2350

2344* **未登录**：消息后续为 `: not signed in. Run /login, then retry.`。请运行 `/login`，然后再次发送2351* **未登录**：消息后续为 `: not signed in. Run /login, then retry.`。请运行 `/login`，然后再次发送

2345* **您的组织拒绝**：例如 `: Feedback has not been enabled for your organization.` 或 `: Feedback collection is not available for organizations with custom data retention policies.`。如果消息附有 `To report a bug, open an issue`，请在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交 issue。之后在七天内，`/feedback` 可能会提示它已[被您组织的策略禁用](#feedback-is-disabled-by-your-organizations-policy)。已排队的草稿会保留在队列中，并仍会[按计划过期](https://code.claude.com/docs/zh-CN/tools-reference.md#discard-or-keep-a-draft)2352* **您的组织拒绝**：例如 `: Feedback has not been enabled for your organization.` 或 `: Feedback collection is not available for organizations with custom data retention policies.`。之后在七天内，`/feedback` 可能会提示它已[被您组织的策略禁用](#feedback-is-disabled-by-your-organizations-policy)。已排队的草稿会保留在队列中，并仍会[按计划过期](https://code.claude.com/docs/zh-CN/tools-reference.md#discard-or-keep-a-draft)

2346* **凭据被拒绝**：消息后续为 `: the sign-in this session uses is not allowed to send feedback` 或 `: the server did not accept the credentials this session uses`。请在 Claude Code 提示符处运行 `/status`，查看此会话发送的是哪个登录、令牌或 API 密钥2353* **凭据被拒绝**：消息后续为 `: the sign-in this session uses is not allowed to send feedback` 或 `: the server did not accept the credentials this session uses`。请在 Claude Code 提示符处运行 `/status`，查看此会话发送的是哪个登录、令牌或 API 密钥

2347* **紧跟在 `Couldn't send feedback` 之后的 `(request timed out)` 或 `(couldn't reach the service)`**：请再次发送报告或已排队的草稿。对话框会保留您的文本，已排队草稿的消息会显示 `The draft is still queued.`。如果其他请求也在失败，请检查您的网络连接，并参阅 [Unable to connect to API](#unable-to-connect-to-api)。如果持续失败，请在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交报告2354* **紧跟在 `Couldn't send feedback` 之后的 `(request timed out)` 或 `(couldn't reach the service)`**：请再次发送报告或已排队的草稿。对话框会保留您的文本，已排队草稿的消息会显示 `The draft is still queued.`。如果其他请求也在失败，请检查您的网络连接，并参阅 [Unable to connect to API](#unable-to-connect-to-api)。如果持续失败，请在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交报告

2348* **紧跟在 `Couldn't send feedback` 之后的 `(server returned <status>)`，或没有任何原因**：该状态码是服务的响应代码。如果服务发送了自己的消息，该消息会跟在状态码之后，例如 `(server returned 403: Access Forbidden)`。如果持续失败，请在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交报告2355* **紧跟在 `Couldn't send feedback` 之后的 `(server returned <status>)`，或没有任何原因**：该状态码是服务的响应代码。如果服务发送了自己的消息，该消息会跟在状态码之后，例如 `(server returned 403: Access Forbidden)`。如果持续失败，请在 [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues) 提交报告

3492* **`Error: Workspace not trusted. <folder> is your home directory`**：由于主目录的信任从不保存，先在那里运行 `claude` 也无济于事。请改为在项目目录中运行 `claude ultrareview`（先在那里运行一次 `claude` 以接受信任对话框），或追加 `--trust-workspace`。3499* **`Error: Workspace not trusted. <folder> is your home directory`**：由于主目录的信任从不保存，先在那里运行 `claude` 也无济于事。请改为在项目目录中运行 `claude ultrareview`（先在那里运行一次 `claude` 以接受信任对话框），或追加 `--trust-workspace`。

3493* **`No answer in time.` 后跟 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 问题在 5 分钟内未得到回答。再次运行 `claude ultrareview` 并回答该问题。3500* **`No answer in time.` 后跟 `Error: Workspace not trusted`**：`Trust <folder>? [y/N]` 问题在 5 分钟内未得到回答。再次运行 `claude ultrareview` 并回答该问题。

3494* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 问题处拒绝了，例如回答 `n` 或按 Enter。若要开始审查，请再次运行 `claude ultrareview` 并回答 `y`。3501* **`Ultrareview did not start: <folder> is not trusted`**：您在 `Trust <folder>? [y/N]` 问题处拒绝了，例如回答 `n` 或按 Enter。若要开始审查，请再次运行 `claude ultrareview` 并回答 `y`。

3495* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 后面跟着的不是标志，例如 PR 编号或 `false`。如果您不信任该文件夹，请省略该标志。要在本次运行中信任它，请将 PR 编号或基准分支放在该标志之前：`claude ultrareview 1234 --trust-workspace`。3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**：`--trust-workspace` 后面跟了非标志的内容，例如 PR 编号或 `false`。如果您不信任该文件夹，请不要使用该标志。如果要在本次运行中信任它，请将 PR 编号或基准分支放在该标志之前：`claude ultrareview 1234 --trust-workspace`。

3496 3503

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

3498 3505

3557 3564

3558* 安装后您尚未启动过会话，因此 Claude Code 还没有获取该标志。即使该功能对您可用，第一次运行 `claude import` 也可能打印此消息。3565* 安装后您尚未启动过会话，因此 Claude Code 还没有获取该标志。即使该功能对您可用，第一次运行 `claude import` 也可能打印此消息。

3559* 您通过 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Claude Platform on AWS 使用 Claude Code，或通过 [Claude apps gateway](https://code.claude.com/docs/zh-CN/claude-apps-gateway#availability-and-limitations) 使用。Claude Code 在这些会话中不会获取功能标志，因此 `claude import` 始终不可用。3566* 您通过 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或 Claude Platform on AWS 使用 Claude Code，或通过 [Claude apps gateway](https://code.claude.com/docs/zh-CN/claude-apps-gateway#availability-and-limitations) 使用。Claude Code 在这些会话中不会获取功能标志，因此 `claude import` 始终不可用。

3560* 您设置了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK` 或 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/zh-CN/env-vars)，这些会关闭功能标志的获取，因此 `claude import` 始终不可用。3567* 您设置了 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、[`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-CN/env-vars#variables)、`DISABLE_GROWTHBOOK` 或 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/zh-CN/env-vars)，这些变量会关闭功能标志的获取，因此 `claude import` 保持不可用。

3561 3568

3562**解决方法：**3569**解决方法：**

3563 3570

3799 3806

3800以下相关消息会在命令运行之前就出现：3807以下相关消息会在命令运行之前就出现：

3801 3808

3802* `Shell command permission check failed for pattern "..."`：该命令的权限检查未允许它运行。[注入命令的权限检查](https://code.claude.com/docs/zh-CN/skills.md#permission-checks-on-injected-commands)介绍了在各种权限模式下哪些结果会导致中止，以及如何使用 `allowed-tools` 预先批准命令3809* `Shell command permission check failed for pattern "..."`：该命令的权限检查未允许它运行。[注入命令的权限检查](https://code.claude.com/docs/zh-CN/skills.md#permission-checks-on-injected-commands)介绍了在各权限模式下哪些结果会导致中止，以及如何使用 `allowed-tools` 预先批准命令

3803* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：该 skill 的 frontmatter 要求 bash，而机器上没有 bash。请安装 Git for Windows，或将 frontmatter 改为 `shell: powershell`。请参阅[注入命令的运行方式](https://code.claude.com/docs/zh-CN/skills.md#how-injected-commands-run)3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``：该 skill 的 frontmatter 要求 bash，但机器上没有 bash。请安装 Git for Windows，或将 frontmatter 改为 `shell: powershell`。请参阅[注入命令的运行方式](https://code.claude.com/docs/zh-CN/skills.md#how-injected-commands-run)

3804 3811

3805**解决方法：**3812**解决方法：**

3806 3813

3953 3960

3954* **您没有传入基础分支**：Claude Code 与仓库的默认分支进行了比较，并建议您显式传入基础分支，如上例所示3961* **您没有传入基础分支**：Claude Code 与仓库的默认分支进行了比较，并建议您显式传入基础分支，如上例所示

3955* **您传入的基础分支已存在于您的克隆中**：提示为 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3962* **您传入的基础分支已存在于您的克隆中**：提示为 ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3956* **您传入的基础分支不在您的克隆中**：Claude Code 在比较之前从 origin 获取了该分支。提示为 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；当 Claude Code 无法判断您的克隆是否为浅克隆时，会改为建议 `git fetch --unshallow origin`。在 v2.1.221 之前，对于每个获取的基础分支，提示都会建议 `git fetch --unshallow origin`，而在完整克隆上，该命令会失败并显示 `fatal: --unshallow on a complete repository does not make sense`。3963* **您传入的基础分支不在您的克隆中**：Claude Code 在比较之前从 origin 获取了该分支。提示为 ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``；当 Claude Code 无法判断您的克隆是否为浅克隆时，它会改为建议 `git fetch --unshallow origin`。在 v2.1.221 之前，对于每个获取的基础分支，提示都会建议 `git fetch --unshallow origin`，而在完整克隆上，该命令会失败并显示 `fatal: --unshallow on a complete repository does not make sense`。

3957 3964

3958**解决方法：**3965**解决方法：**

3959 3966

6615 6622

6616**2. 更新共享该主目录的每台主机**6623**2. 更新共享该主目录的每台主机**

6617 6624

6618如果多台主机共享此主目录，请先将每台主机上的 Claude Code 更新到消息中指出的版本或更高版本。旧版本可能会将已移走的 `.config.json` 写回。6625如果多台主机共享此主目录，请先将每台主机上的 Claude Code 更新到消息中指出的版本或更高版本。

6619 6626

6620**3. 停止 Claude Code**6627**3. 停止 Claude Code**

6621 6628

feature-availability.md +4 −4

Details

112 <td>✓</td>112 <td>✓</td>

113 <td>✓</td>113 <td>✓</td>

114 <td>✗</td>114 <td>✗</td>

115 <td>✗</td>115 <td>✓（Claude Code v2.1.300 或更高版本）</td>

116 <td>✗</td>116 <td>✗</td>

117 <td>✗</td>117 <td>✗</td>

118 </tr>118 </tr>

221 221

222> [!NOTE]222> [!NOTE]

223>223>

224> 如果您通过 [LLM gateway](https://code.claude.com/docs/zh-CN/llm-gateway) 进行身份验证，功能可用性与网关转发到的基础提供商相匹配，除了 Claude Code 本身关闭的功能。每当 `ANTHROPIC_BASE_URL` 指向 `api.anthropic.com` 以外的主机时，Claude Code 会关闭功能，例如 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md#requirements) 和 [server-managed settings](https://code.claude.com/docs/zh-CN/server-managed-settings.md#platform-availability)，无论网关转发什么。某些仅限 Anthropic 的功能，例如 [Advisor](https://code.claude.com/docs/zh-CN/advisor.md)，仅在网关将请求完整转发到 Anthropic API 时才有效。224> 如果您通过 [LLM gateway](https://code.claude.com/docs/zh-CN/llm-gateway) 进行身份验证，功能可用性与网关转发到的基础提供商相匹配，除了 Claude Code 本身关闭的功能。每当 `ANTHROPIC_BASE_URL` 指向 `api.anthropic.com` 以外的主机时，Claude Code 会关闭功能，例如 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md#requirements) 和 [server-managed settings](https://code.claude.com/docs/zh-CN/server-managed-settings.md#platform-availability)，无论网关转发什么。某些功能，例如 [Advisor](https://code.claude.com/docs/zh-CN/advisor.md#requirements)，仅在网关完整转发请求时才有效。

225>225>

226> 有关 Claude Code 发送的请求在 Amazon Bedrock 或 Agent Platform 格式网关、`ANTHROPIC_BASE_URL` 网关和 Claude apps gateway 登录之间如何不同，请参阅[按连接方法的客户端行为](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior)。226> 有关 Claude Code 发送的请求在 Amazon Bedrock 或 Agent Platform 格式网关、`ANTHROPIC_BASE_URL` 网关和 Claude apps gateway 登录之间如何不同，请参阅[按连接方法的客户端行为](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#how-the-connection-method-changes-client-behavior)。

227 227

244 244

245> [tab] Claude Platform on AWS245> [tab] Claude Platform on AWS

246>246>

247> **不可用：** 所有[需要 Claude 订阅的功能](#features-that-require-a-claude-subscription)，加上 [fast mode](https://code.claude.com/docs/zh-CN/fast-mode.md)、[Advisor](https://code.claude.com/docs/zh-CN/advisor.md)、[Channels](https://code.claude.com/docs/zh-CN/channels.md)、[GitHub Actions](https://code.claude.com/docs/zh-CN/github-actions.md)、[analytics dashboard](https://code.claude.com/docs/zh-CN/analytics.md)、[server-managed settings](https://code.claude.com/docs/zh-CN/server-managed-settings.md) 和 [`/design-sync` 和 `/import` 命令](https://code.claude.com/docs/zh-CN/commands#all-commands)。247> **不可用：** 所有[需要 Claude 订阅的功能](#features-that-require-a-claude-subscription)，加上 [fast mode](https://code.claude.com/docs/zh-CN/fast-mode.md)、[Channels](https://code.claude.com/docs/zh-CN/channels.md)、[GitHub Actions](https://code.claude.com/docs/zh-CN/github-actions.md)、[analytics dashboard](https://code.claude.com/docs/zh-CN/analytics.md)、[server-managed settings](https://code.claude.com/docs/zh-CN/server-managed-settings.md) 和 [`/design-sync` 和 `/import` 命令](https://code.claude.com/docs/zh-CN/commands#all-commands)。

248>248>

249> **Amazon Bedrock 不可用的地方可用：** [web search](https://code.claude.com/docs/zh-CN/tools-reference.md#websearch-tool-behavior)。249> **Amazon Bedrock 不可用的地方可用：** [web search](https://code.claude.com/docs/zh-CN/tools-reference.md#websearch-tool-behavior)，以及 Claude Code v2.1.300 或更高版本中的 [Advisor](https://code.claude.com/docs/zh-CN/advisor.md)。

250>250>

251> **部分支持：**251> **部分支持：**

252>252>

glossary.md +2 −2

Details

54 54

55### Auto mode55### Auto mode

56 56

57一种[权限模式](#permission-mode)，其中单独的分类器模型审查操作而不是您，因此 Claude Code 可以在不询问您的情况下运行大多数操作。Claude Code 仍然会在您的显式 ask 规则匹配的操作之前询问您。分类器阻止范围升级、不受信任的基础设施和[提示词注入](#prompt-injection)。工具结果从它看到的内容中被剥离，因此文件或网页中的恶意内容无法直接操纵它。57一种[权限模式](#permission-mode)，其中由单独的分类器模型代替您审查操作，因此 Claude Code 可以在不询问您的情况下运行大多数操作。Claude Code 仍然会在您的显式 ask 规则匹配的操作之前询问您。分类器阻止范围升级、不受信任的基础设施和[提示词注入](#prompt-injection)。

58 58

59* **Claude Code v2.1.283 或更高版本**：自动模式是交互式终端和 VS Code 会话的[内置起始权限模式](https://code.claude.com/docs/zh-CN/permission-modes.md#which-mode-a-session-starts-in)59* **Claude Code v2.1.283 或更高版本**：自动模式是交互式终端和 VS Code 会话的[内置起始权限模式](https://code.claude.com/docs/zh-CN/permission-modes.md#which-mode-a-session-starts-in)

60* **早期版本**：自动模式仅在 Pro、Max、Ultra 和 Team 计划上是内置起始权限模式60* **早期版本**：自动模式仅在 Pro、Max、Ultra 和 Team 计划上是内置起始权限模式

261 261

262### Prompt injection262### Prompt injection

263 263

264嵌入在文件、网页或工具结果中的恶意指令，试图将 Claude 重定向到您从未要求的操作。Claude Code 的防御包括权限系统、命令注入检测和信任验证。[Auto mode](#auto-mode) 添加了一个服务器端探针，扫描工具结果中的可疑内容，以及一个分类器，用于审查剥离工具结果的操作，因此注入的文本无法直接操纵它。264嵌入在文件、网页或工具结果中的恶意指令，试图将 Claude 重定向到您并未要求的操作。Claude Code 的防御包括权限系统、命令注入检测和信任验证。在[自动模式](#auto-mode)中，一个服务器端探针会扫描工具结果中的可疑内容，并由一个分类器审查操作。

265 265

266了解更多：[防止提示注入](https://code.claude.com/docs/zh-CN/security.md#protect-against-prompt-injection)266了解更多：[防止提示注入](https://code.claude.com/docs/zh-CN/security.md#protect-against-prompt-injection)

267 267

hooks.md +1 −1

Details

2341 2341

2342#### 为自动模式分类器注释结果2342#### 为自动模式分类器注释结果

2343 2343

2344返回 `classifierContext` 可将关于工具调用结果的简短说明发送给[自动模式](https://code.claude.com/docs/zh-CN/permission-modes.md#eliminate-prompts-with-auto-mode)分类器，而不是发送给 Claude。分类器[从不接收工具结果本身](https://code.claude.com/docs/zh-CN/permission-modes.md#how-the-classifier-evaluates-actions)，因此该字段是在分类器审查后续操作之前，告知其某次调用返回内容的受支持方式。该字段需要 Claude Code v2.1.236 或更高版本。2344返回 `classifierContext` 可将关于工具调用结果的简短说明发送给[自动模式](https://code.claude.com/docs/zh-CN/permission-modes.md#eliminate-prompts-with-auto-mode)分类器，而不是发送给 Claude。该说明供分类器审查后续操作时使用。该字段需要 Claude Code v2.1.236 或更高版本。

2345 2345

2346下面的示例告知分类器某次查询输出的来源：2346下面的示例告知分类器某次查询输出的来源：

2347 2347

llm-gateway.md +1 −1

Details

47 47

48当[网关凭证变量](https://code.claude.com/docs/zh-CN/llm-gateway-connect.md#set-the-credential-variable)或 `apiKeyHelper` 处于活动状态时，请求会使用该凭证代替开发人员的 claude.ai 订阅登录，订阅的使用限制不适用于这些请求。Claude Code 在机器上保存了 claude.ai 登录信息，但不会在这些请求中发送它。该流量按令牌计费给拥有网关转发的凭证的人，例如您的组织的 Anthropic Console 账户，或当网关路由到那里时您的 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 账户。48当[网关凭证变量](https://code.claude.com/docs/zh-CN/llm-gateway-connect.md#set-the-credential-variable)或 `apiKeyHelper` 处于活动状态时，请求会使用该凭证代替开发人员的 claude.ai 订阅登录，订阅的使用限制不适用于这些请求。Claude Code 在机器上保存了 claude.ai 登录信息，但不会在这些请求中发送它。该流量按令牌计费给拥有网关转发的凭证的人，例如您的组织的 Anthropic Console 账户，或当网关路由到那里时您的 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 账户。

49 49

50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-CN/llm-gateway-connect#set-the-base-url-and-credential)是指向 Claude Code 网关的变量。仅设置该变量，不设置网关凭证，不会替换订阅。请求仍然通过网关路由，但保存的 claude.ai 登录保持活动凭证，因此其使用限制和计费适用。将此流量转发给 Anthropic 的网关必须转发 `anthropic-beta` 中的 OAuth 功能；请参阅[请求头参考](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#request-headers)。50[`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-CN/llm-gateway-connect#set-the-base-url-and-credential) 是让 Claude Code 指向网关的变量。仅设置该变量，不设置网关凭据，不会替换订阅。请求仍然通过网关路由，但保存的 claude.ai 登录仍是活动凭据，因此其用量限制和计费适用。将此流量转发给 Anthropic 的网关必须转发 `Authorization` 以及 `anthropic-beta` 中的 OAuth 功能；请参阅[请求头参考](https://code.claude.com/docs/zh-CN/llm-gateway-protocol.md#request-headers)。

51 51

52## 相关页面52## 相关页面

53 53

llm-gateway-protocol.md +3 −3

Details

40 40

41| 格式 | 选择方式 | 端点 | 原样转发 |41| 格式 | 选择方式 | 端点 | 原样转发 |

42| :- | :- | :- | :- |42| :- | :- | :- | :- |

44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` 配合 `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens`（可选） | `anthropic_beta` 和 `anthropic_version` 请求体字段 |44| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` 配合 `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`, `/model/{model}/invoke-with-response-stream`, `/model/{model}/count-tokens`（可选） | `anthropic_beta` 和 `anthropic_version` 请求体字段 |

45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` 配合 `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict`（可选） | `anthropic-beta` 和 `anthropic-version` 请求头，以及 `anthropic_version` 请求体字段 |45| Google Cloud's Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` 配合 `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`, `:streamRawPredict`, `count-tokens:rawPredict`（可选） | `anthropic-beta` 和 `anthropic-version` 请求头，以及 `anthropic_version` 请求体字段 |

46 46

115 115

116## 请求标头116## 请求标头

117 117

118Claude Code 会在 API 请求中包含以下标头。标头名称在传输时不区分大小写。请原样转发 `anthropic-version` 和 `anthropic-beta`，当上游为 [Claude Platform on AWS](https://code.claude.com/docs/zh-CN/claude-platform-on-aws.md) 时还需转发 `anthropic-workspace-id`；其余标头网关可用于路由、归因和追踪，无需转发。118Claude Code 会在 API 请求中包含以下标头。标头名称在传输时不区分大小写。请原样转发 `anthropic-version` 和 `anthropic-beta`，当上游为 [Claude Platform on AWS](https://code.claude.com/docs/zh-CN/claude-platform-on-aws.md) 时还需转发 `anthropic-workspace-id`。当您的网关使用开发者的 claude.ai 登录（而非网关自己的密钥）向 Anthropic 进行身份验证时，还需转发 `Authorization`。其余标头网关可用于路由、归因和追踪，无需转发。

119 119

120| 标头 | 描述 |120| 标头 | 描述 |

121| :- | :- |121| :- | :- |

122| `Authorization`、`x-api-key` | 开发者的网关凭据，根据开发者设置的[凭据变量](https://code.claude.com/docs/zh-CN/llm-gateway-connect.md#set-the-credential-variable)，出现在其中一个或两个标头中 |122| `Authorization`、`x-api-key` | 开发者的网关凭据，根据开发者设置的[凭据变量](https://code.claude.com/docs/zh-CN/llm-gateway-connect.md#set-the-credential-variable)，出现在其中一个或两个标头中。在使用 claude.ai 登录且没有网关凭据时，`Authorization` 携带该登录的令牌 |

123| `anthropic-version` | API 版本，当前为 `2023-06-01`。Amazon Bedrock 格式和 Google Cloud's Agent Platform 格式的请求还会携带 `anthropic_version` 请求体字段，其值为提供商的方言字符串，而不是此标头的值 |123| `anthropic-version` | API 版本，当前为 `2023-06-01`。Amazon Bedrock 格式和 Google Cloud's Agent Platform 格式的请求还会携带 `anthropic_version` 请求体字段，其值为提供商的方言字符串，而不是此标头的值 |

124| `anthropic-beta` | 请求的以逗号分隔的功能值。请原样转发此标头；不要对单个值设置允许列表，因为该集合会随 Claude Code 版本发布而变化。当开发者使用 claude.ai 登录进行身份验证时（在设置了 `ANTHROPIC_BASE_URL` 但未设置网关凭据变量的情况下可能出现），此标头还会携带上游所需的 OAuth 功能值，将其移除会导致这些请求以 `401` 失败 |124| `anthropic-beta` | 请求的以逗号分隔的功能值。请原样转发此标头；不要对单个值设置允许列表，因为该集合会随 Claude Code 版本发布而变化。当开发者使用 claude.ai 登录进行身份验证时（在设置了 `ANTHROPIC_BASE_URL` 但未设置网关凭据变量的情况下可能出现），此标头还会携带上游所需的 OAuth 功能值，将其移除会导致这些请求以 `401` 失败 |

managed-settings.md +1 −1

Details

52* **交付控制**：[`policyHelper`](https://code.claude.com/docs/zh-CN/settings-reference#policyhelper)、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/zh-CN/settings-reference#wslinheritswindowssettings) 和 [`managedSourcesBehavior`](https://code.claude.com/docs/zh-CN/settings-reference#managedsourcesbehavior)52* **交付控制**：[`policyHelper`](https://code.claude.com/docs/zh-CN/settings-reference#policyhelper)、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/zh-CN/settings-reference#wslinheritswindowssettings) 和 [`managedSourcesBehavior`](https://code.claude.com/docs/zh-CN/settings-reference#managedsourcesbehavior)

53* **网关登录密钥**：[`forceLoginGatewayUrl`](https://code.claude.com/docs/zh-CN/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/zh-CN/settings-reference#gatewayinternalnetworks) 和 [`forceLoginMethod`](https://code.claude.com/docs/zh-CN/settings-reference#forceloginmethod) 的 `"gateway"` 值53* **网关登录密钥**：[`forceLoginGatewayUrl`](https://code.claude.com/docs/zh-CN/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/zh-CN/settings-reference#gatewayinternalnetworks) 和 [`forceLoginMethod`](https://code.claude.com/docs/zh-CN/settings-reference#forceloginmethod) 的 `"gateway"` 值

54 54

55托管设置文件、MDM 配置文件或 claude.ai 控制台对其到达的每个人应用一个策略。要为一组开发者提供不同的策略，请将不同的文件或配置文件部署到该组；claude.ai 控制台[还不能针对一个组](https://code.claude.com/docs/zh-CN/server-managed-settings.md#current-limitations)，而自托管[Claude 应用网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway)按 IdP 组交付托管设置。55使用托管设置文件或 MDM 配置文件时，其覆盖到的每个人都会获得同一个策略。要为一组开发者提供不同的策略，请将不同的文件或配置文件部署到该组。在 Enterprise 计划中，您还可以在服务器托管设置中[为每个组提供各自的配置](https://code.claude.com/docs/zh-CN/server-managed-settings.md#give-groups-different-settings)。自托管 [Claude 应用网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway)按 IdP 组交付托管设置。

56 56

57当多个机制向同一台机器交付策略时，Claude Code 默认使用一个并忽略其他的。[Claude Code 如何组合托管源](#how-claude-code-combines-managed-sources)给出了顺序和适用于每个源的选择加入。57当多个机制向同一台机器交付策略时，Claude Code 默认使用一个并忽略其他的。[Claude Code 如何组合托管源](#how-claude-code-combines-managed-sources)给出了顺序和适用于每个源的选择加入。

58 58

memory.md +1 −1

Details

163 163

164内联形式为该单次启动在 Bash 或 Zsh 中设置变量。要为每个会话保持它，请将其添加到 `~/.claude/settings.json` 中的 `env` 块，如 [设置环境变量](https://code.claude.com/docs/zh-CN/env-vars.md#set-environment-variables) 中所示。164内联形式为该单次启动在 Bash 或 Zsh 中设置变量。要为每个会话保持它，请将其添加到 `~/.claude/settings.json` 中的 `env` 块，如 [设置环境变量](https://code.claude.com/docs/zh-CN/env-vars.md#set-environment-variables) 中所示。

165 165

166这从其他目录加载 `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md` 和 `CLAUDE.local.md`。如果您从 [`--setting-sources`](https://code.claude.com/docs/zh-CN/cli-reference) 中排除 `local`，则跳过 `CLAUDE.local.md`。166设置该变量后，Claude Code 会加载其他目录中的 `CLAUDE.md`、`.claude/CLAUDE.md`、`CLAUDE.local.md` 和 `.claude/rules/*.md` 文件，但设置了 [`paths` 字段](#path-specific-rules) 的规则除外。如果您从 [`--setting-sources`](https://code.claude.com/docs/zh-CN/cli-reference) 中排除 `local`，则跳过 `CLAUDE.local.md`。

167 167

168### 使用 `.claude/rules/` 组织规则168### 使用 `.claude/rules/` 组织规则

169 169

model-config.md +22 −15

Details

168 168

169有关这些消息，请参阅 [Model is not a recognized model id](https://code.claude.com/docs/zh-CN/errors.md#model-is-not-a-recognized-model-id) 和 [Model not found](https://code.claude.com/docs/zh-CN/errors.md#model-not-found)。169有关这些消息，请参阅 [Model is not a recognized model id](https://code.claude.com/docs/zh-CN/errors.md#model-is-not-a-recognized-model-id) 和 [Model not found](https://code.claude.com/docs/zh-CN/errors.md#model-not-found)。

170 170

171如果您使用 `--model` 标志、`ANTHROPIC_MODEL` 环境变量或 `model` 设置来设置模型，Claude Code 不会预先拒绝拼写错误的值。会话会正常启动，第一个请求会产生 [There's an issue with the selected model](https://code.claude.com/docs/zh-CN/errors.md#theres-an-issue-with-the-selected-model)。在 Anthropic API 上，不以 `claude-` 开头且与某个模型名称或别名拼写相近的值，还可能产生一条[建议该名称的启动警告](#fix-a-mistyped-model-name)。171如果您使用 `--model` 标志、`ANTHROPIC_MODEL` 环境变量或 `model` 设置来设置模型，Claude Code 不会预先拒绝拼写错误的值。会话会正常启动，第一个请求会产生 [There's an issue with the selected model](https://code.claude.com/docs/zh-CN/errors.md#theres-an-issue-with-the-selected-model)。在 Anthropic API 上，如果该值与某个模型名称或别名拼写相近且不以 `claude-` 开头，您可能会看到一条[建议最接近名称的警告](#fix-a-mistyped-model-name)。

172 172

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

174 174

195}195}

196```196```

197 197

198#### 修复拼写错误的模型名称

199

200以下任一警告都表示 Claude Code 无法识别您设置的模型 ID，而该 ID 与它能识别的某个模型名称或别名拼写相近：

201

202```text theme={null}

203⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

204Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

205```

206

207* **您输错了 ID**：[在您设置模型的位置](#setting-your-model)将其改为建议的值

208* **该 ID 是有意设置的**：保持原样。会话会按您所写的内容发送它。如果 Claude Code 为其假定的上下文窗口不正确，请[更正该窗口](#correct-the-window-for-a-gateway-or-custom-model-id)

209

198#### 为新会话设置默认模型210#### 为新会话设置默认模型

199 211

200设置 `ANTHROPIC_DEFAULT_MODEL=<alias|name>` 来选择会话默认启动的模型。需要 Claude Code v2.1.236 或更高版本。212设置 `ANTHROPIC_DEFAULT_MODEL=<alias|name>` 来选择会话默认启动的模型。需要 Claude Code v2.1.236 或更高版本。

772| :- | :- |784| :- | :- |

775| 通过环境变量禁用 | 设置 [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/zh-CN/env-vars)，这在 Anthropic API 上关闭思考，除了 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 模型。在[第三方提供商](https://code.claude.com/docs/zh-CN/third-party-integrations.md)上，Claude Code 改为省略 `thinking` 参数，自适应推理模型可能仍然思考 |787| 通过环境变量禁用 | 设置 [`MAX_THINKING_TOKENS=0`](https://code.claude.com/docs/zh-CN/env-vars) |

788

789Claude Code 默认折叠思考输出。按 `Ctrl+O` 切换详细模式并将推理视为灰色斜体文本。Anthropic API 上的交互式会话默认接收编辑的思考块，因此如果您想要完整摘要在展开时可用，请在设置中设置 [`showThinkingSummaries: true`](https://code.claude.com/docs/zh-CN/settings-reference#showthinkingsummaries)。您需要为所有生成的思考 token 付费，即使折叠或编辑。

790

791#### 无法关闭思考的情况

776 792

777您不能在 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型上关闭思考。对于这些模型，会话切换和 `/config` 行显示 `Thinking can't be turned off`，而不是提供切换，保存的 `alwaysThinkingEnabled: false` 或 `MAX_THINKING_TOKENS=0` 在那里没有效果。在这些模型上，模型根据 effort 级别按步骤决定思考多少。保存的设置在您切换到接受它的模型时再次应用。793您不能在 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 模型上关闭思考。对于这些模型，会话切换和 `/config` 行显示 `Thinking can't be turned off`，而不是提供切换，保存的 `alwaysThinkingEnabled: false` 或 `MAX_THINKING_TOKENS=0` 在那里没有效果。在这些模型上，模型根据 effort 级别按步骤决定思考多少。保存的设置在您切换到接受它的模型时再次应用。

778 794

779Claude Code 默认折叠思考输出。按 `Ctrl+O` 切换详细模式并将推理视为灰色斜体文本。Anthropic API 上的交互式会话默认接收编辑的思考块，因此如果您想要完整摘要在展开时可用，在[设置](https://code.claude.com/docs/zh-CN/settings.md)中设置 `showThinkingSummaries: true`。您需要为所有生成的思考 token 付费，即使折叠或编辑。795要停止或减少思考，请使用适用于您的提供商的步骤：

796

797* **Anthropic API**：您可以在 `claude-opus-5`、`claude-sonnet-5` 和 `claude-haiku-4-5` 等模型上关闭思考。`sonnet` 等[别名](#model-aliases)选择的是无法关闭思考的模型，因此请按其 ID [设置模型](#setting-your-model)。

798* **[第三方提供商](https://code.claude.com/docs/zh-CN/third-party-integrations.md)**：在 Amazon Bedrock 和 Microsoft Foundry 等提供商上，具有[自适应推理](#adaptive-reasoning-and-fixed-thinking-budgets)的模型在关闭思考后仍可能思考。请[降低 effort 级别](#set-the-effort-level)以减少思考。

780 799

781### 扩展上下文800### 扩展上下文

782 801

900 919

901一旦 Claude Code 识别了该 ID 或使用了您提供的窗口，在该 ID 上启动会话时就不会再出现该警告。920一旦 Claude Code 识别了该 ID 或使用了您提供的窗口，在该 ID 上启动会话时就不会再出现该警告。

902 921

903#### 修正拼错的模型名称

~~904~~

905以下任一警告都表示 Claude Code 无法识别您设置的模型 ID，且该 ID 的拼写与它能识别的某个模型名称或别名非常接近：

~~906~~

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

~~911~~

912* **您拼错了 ID**：在[您设置模型的位置](#setting-your-model)将其改为建议的名称

913* **该 ID 是有意设置的**：保持原样即可。会话会按您填写的内容原样发送该 ID。如果 Claude Code 为其假设的上下文窗口不正确，请[更正窗口](#correct-the-window-for-a-gateway-or-custom-model-id)

~~914~~

915#### `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 适用于哪些 ID922#### `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 适用于哪些 ID

916 923

917在 [LLM 网关](https://code.claude.com/docs/zh-CN/llm-gateway)或其他自定义部署上，Claude Code 可能会为模型 ID 假设一个与模型实际窗口不同的上下文窗口，无论它是否将 ID 解析为 Claude 模型。设置 [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/zh-CN/env-vars) 为 Claude Code 应该假设的窗口。924在 [LLM 网关](https://code.claude.com/docs/zh-CN/llm-gateway)或其他自定义部署上，Claude Code 可能会为模型 ID 假设一个与模型实际窗口不同的上下文窗口，无论它是否将 ID 解析为 Claude 模型。设置 [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/zh-CN/env-vars) 为 Claude Code 应该假设的窗口。

monitoring-usage.md +21 −6

Details

710* `skill.name`：请求活跃的 skill，由 Skill 工具或 `/` 命令设置，或由生成的子代理继承。内置、捆绑、用户定义以及官方市场插件的 skill 名称按原样显示。第三方插件的 skill 名称会被替换为 `"third-party"`。当没有活跃的 skill 时不存在。710* `skill.name`：请求活跃的 skill，由 Skill 工具或 `/` 命令设置，或由生成的子代理继承。内置、捆绑、用户定义以及官方市场插件的 skill 名称按原样显示。第三方插件的 skill 名称会被替换为 `"third-party"`。当没有活跃的 skill 时不存在。

711* `plugin.name`：当活跃的 skill 或子代理由插件提供时，为所属插件。官方市场插件名称按原样显示。第三方插件名称会被替换为 `"third-party"`。当 skill 和子代理都没有所属插件时不存在。711* `plugin.name`：当活跃的 skill 或子代理由插件提供时，为所属插件。官方市场插件名称按原样显示。第三方插件名称会被替换为 `"third-party"`。当 skill 和子代理都没有所属插件时不存在。

712* `marketplace.name`：所属插件的安装来源市场。即使设置了 `OTEL_LOG_TOOL_DETAILS=1`，也仅针对官方市场插件发出。否则不存在。712* `marketplace.name`：所属插件的安装来源市场。即使设置了 `OTEL_LOG_TOOL_DETAILS=1`，也仅针对官方市场插件发出。否则不存在。

713* `mcp_server.name`：此请求所使用的工具结果对应的 MCP 服务器。内置、claude.ai 代理以及官方注册表的服务器名称按原样显示。用户配置的服务器名称会被替换为 `"custom"`。当请求未使用任何 MCP 工具结果时不存在。在 v2.1.222 之前，Claude Code 会在 MCP 工具调用之后的每个请求上设置此属性，而不仅仅是在使用了工具结果的请求上，因此在您升级后，聚合此属性的仪表板会显示数值下降。713* `mcp_server.name`：该请求所使用的工具结果所属的 MCP 服务器。内置、claude.ai 代理和官方注册表中的服务器名称按原样显示。用户配置的服务器名称会被替换为 `"custom"`。当请求未使用任何 MCP 工具结果时不存在。在 v2.1.222 之前，Claude Code 会在 MCP 工具调用之后的每个请求上设置此属性，而不仅仅是在使用了工具结果的请求上设置，因此聚合此属性的仪表板在您升级后会显示下降。

714* `mcp_tool.name`：此请求所使用的结果对应的 MCP 工具，其编辑和版本行为与 `mcp_server.name` 相同。当请求未使用任何 MCP 工具结果时不存在。714 * 从 v2.1.312 开始，由 Anthropic 官方市场中的插件声明的、具有固定 URL 的远程服务器名称也会按原样显示，格式为 `plugin_<plugin>_<server>`。当插件的市场副本并非来自 Anthropic 注册的来源时（例如在云端会话中从种子目录挂载的副本），该名称会被替换为 `"custom"`。

715* `mcp_tool.name`：该请求所使用的结果所属的 MCP 工具，其编辑和版本行为与 `mcp_server.name` 相同，只是当 `mcp_server.name` 显示 `plugin_<plugin>_<server>` 名称时，它可能为 `"custom"`。当请求未使用任何 MCP 工具结果时不存在。

715 716

716#### Token 计数器717#### Token 计数器

717 718

998 * 在同一交互式 CLI 会话中较早的权限提示中授予的、在会话剩余时间内有效的授权999 * 在同一交互式 CLI 会话中较早的权限提示中授予的、在会话剩余时间内有效的授权

999 * 工具本身是安全的1000 * 工具本身是安全的

1000 1001

1001 `source` 值并不表明匹配的是其中哪个来源。要查明是哪个来源拒绝了调用，请查找具有相同 `tool_use_id` 的[安全事件](#safety-event)，并读取其 `category` 和 `rule_source` 属性。部分被拒绝的调用[没有安全事件](#calls-without-a-safety-event)。1002 `source` 值并不指明匹配的是上述哪个来源。当存在 `classifier_verdict` 时，它给出决定该调用的分类器结果。没有任何 `tool_decision` 属性会指明拒绝该调用的权限规则或设置。

1002 1003

1003 当权限提示请求本身失败时，Claude Code 也会报告 `"config"`。例如，当 Agent SDK 的 [`canUseTool`](https://code.claude.com/docs/zh-CN/agent-sdk/typescript#canusetool) 回调或 [`--permission-prompt-tool`](https://code.claude.com/docs/zh-CN/cli-reference#cli-flags) 工具返回无效结果时，或者当请求挂起期间输入流关闭时，该请求都会失败。1004 当权限提示请求本身失败时，Claude Code 也会报告 `"config"`。例如，当 Agent SDK 的 [`canUseTool`](https://code.claude.com/docs/zh-CN/agent-sdk/typescript#canusetool) 回调或 [`--permission-prompt-tool`](https://code.claude.com/docs/zh-CN/cli-reference#cli-flags) 工具返回无效结果时，或者当请求挂起期间输入流关闭时，该请求都会失败。

1004 * `"hook"`：由 `PreToolUse` 或 `PermissionRequest` hook 返回了该决策。1005 * `"hook"`：由 `PreToolUse` 或 `PermissionRequest` hook 返回了该决策。

1046 1047

1047#### 安全事件1048#### 安全事件

1048 1049

1049当某项检查拒绝工具调用或要求权限提示时记录，但[没有安全事件的调用](#calls-without-a-safety-event)除外。当[沙箱的网络代理](https://code.claude.com/docs/zh-CN/sandboxing.md#network-isolation)拒绝连接或请求时，以及当 hook 阻止结果时，也会记录。需要 Claude Code v2.1.307 或更高版本。1050Claude Code 已停止发送 `claude_code.safety_event`：

1051

1052* **v2.1.312 及更高版本**：这些版本不发送该事件，也没有任何设置可以启用它

1053* **v2.1.307 至 v2.1.311**：会话在下一次刷新功能标志时停止发送该事件。不[获取功能标志](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)的会话（例如在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上）可能会继续发送该事件。

1054

1055要查看被拒绝的工具调用，请查询 [`tool_decision`](#tool-decision-event) 事件，这些事件会显示调用被拒绝，但并不总是显示是哪项检查拒绝了它。

1056

1057此处的事件详情描述的是 v2.1.307 至 v2.1.311 版本中的事件，在这些版本中，安全事件会记录如下[情况](#safety-event-categories)：

1058

1059* 某项检查拒绝了工具调用或要求显示权限提示，但[没有安全事件的调用](#calls-without-a-safety-event)除外

1060* [沙箱的网络代理](https://code.claude.com/docs/zh-CN/sandboxing.md#network-isolation)拒绝了某个连接或请求

1061* 某个 hook 阻止了结果或轮次的结束

1050 1062

1051该事件与其他事件一起导出，没有单独的设置。该事件自身的属性不包含命令文本、文件路径、主机名或 MCP 服务器和工具名称。该记录还携带每个事件都有的[标准属性](#standard-attributes)，其中可能包括 `workspace.host_paths` 和[仓库属性](#repository-attributes)。要查看事件背后的命令或 MCP 工具，请设置 `OTEL_LOG_TOOL_DETAILS=1`，并读取匹配的 `tool_decision` 事件上的 `tool_parameters`。1063该事件与其他事件一起导出，没有单独的设置。该事件自身的属性不包含命令文本、文件路径、主机名或 MCP 服务器和工具名称。该记录还携带每个事件都有的[标准属性](#standard-attributes)，其中可能包括 `workspace.host_paths` 和[仓库属性](#repository-attributes)。要查看事件背后的命令或 MCP 工具，请设置 `OTEL_LOG_TOOL_DETAILS=1`，并读取匹配的 `tool_decision` 事件上的 `tool_parameters`。

1052 1064

1663 1675

1664### 将安全问题映射到事件1676### 将安全问题映射到事件

1665 1677

1678涉及 `safety_event` 的行仅适用于 v2.1.307 至 v2.1.311 版本中[仍发送该事件](#safety-event)的会话。

1679

1666构建检测规则时，查找您想要监控的信号并查询您的后端以获取相应的事件和属性：1680构建检测规则时，查找您想要监控的信号并查询您的后端以获取相应的事件和属性：

1667 1681

1668| 信号 | 事件 | 关键属性 |1682| 信号 | 事件 | 关键属性 |

1672| 自动模式分类器允许或阻止了工具调用，或 Claude Code 在没有分类器判定的情况下拒绝了调用 | 存在 `classifier_verdict` 的 [`tool_decision`](#tool-decision-event)。对于没有判定的拒绝，`classifier_verdict` 为 `"no_verdict"` 或 `"unavailable"` | `classifier_verdict`、`permission_mode`、`tool_name`；设置 `OTEL_LOG_TOOL_DETAILS=1` 时还有 `classifier_category` |1686| 自动模式分类器允许或阻止了工具调用，或 Claude Code 在没有分类器判定的情况下拒绝了调用 | 存在 `classifier_verdict` 的 [`tool_decision`](#tool-decision-event)。对于没有判定的拒绝，`classifier_verdict` 为 `"no_verdict"` 或 `"unavailable"` | `classifier_verdict`、`permission_mode`、`tool_name`；设置 `OTEL_LOG_TOOL_DETAILS=1` 时还有 `classifier_category` |

1676| hook 拒绝了哪个工具调用，以及 hook 阻止了哪个结果或轮次结束 | [`safety_event`](#safety-event)，对于被拒绝的调用，其 `category` 为 `"hook"` 且 `decision` 为 `"reject"`；对于被阻止的结果或轮次结束，其 `category` 为 `"hook_review"` | `category`、`decision`、`hook_event`；工具调用还有 `tool_use_id` |1690| hook 拒绝的工具调用 | `decision` 为 `"reject"` 且 `source` 为 `"hook"` 的 [`tool_decision`](#tool-decision-event) | `decision`、`source`、`tool_use_id` |

1691| hook 阻止了哪个结果或轮次结束 | `category` 为 `"hook_review"` 的 [`safety_event`](#safety-event) | `category`、`hook_event`；工具调用还有 `tool_use_id` |

1677| 沙箱的网络代理拒绝了来自 Bash 或 PowerShell 命令的连接或请求 | 存在 `sandbox_violation_count` 且其值不为 `"0"` 的 [`safety_event`](#safety-event) | `sandbox_violation_count`、`category`、`sandbox_enabled`、`tool_use_id` |1692| 沙箱的网络代理拒绝了来自 Bash 或 PowerShell 命令的连接或请求 | 存在 `sandbox_violation_count` 且其值不为 `"0"` 的 [`safety_event`](#safety-event) | `sandbox_violation_count`、`category`、`sandbox_enabled`、`tool_use_id` |

permission-modes.md +7 −5

Details

25 25

26审查每项操作的模式在 CLI 中名为 **Manual**，在 `claude --help` 中、在 VS Code 和 JetBrains 扩展中以及在桌面应用中也是如此。其配置值是 `default`，这是 hook 和 SDK 集成使用的。CLI 在您输入值的任何地方接受 `manual` 作为别名，例如 `claude --permission-mode manual` 或 `"defaultMode": "manual"`。26审查每项操作的模式在 CLI 中名为 **Manual**，在 `claude --help` 中、在 VS Code 和 JetBrains 扩展中以及在桌面应用中也是如此。其配置值是 `default`，这是 hook 和 SDK 集成使用的。CLI 在您输入值的任何地方接受 `manual` 作为别名，例如 `claude --permission-mode manual` 或 `"defaultMode": "manual"`。

27 27

28对 [受保护路径](#protected-paths) 的写入永远不会自动批准，除非在 `bypassPermissions` 模式下以及在 plan 模式会话中，其中绕过权限可用，意味着会话以 [将 `bypassPermissions` 放入模式循环](#switch-permission-modes) 的方式启动。28每种模式对写入 [受保护路径](#protected-paths) 都有各自的规则。

29 29

30模式设置基线。在顶部分层 [权限规则](https://code.claude.com/docs/zh-CN/permissions.md#manage-permissions) 以预批准或阻止特定工具。拒绝规则在每种模式下都会阻止，包括 `bypassPermissions`。拒绝和询问规则不适用于 [`EndConversation`](https://code.claude.com/docs/zh-CN/tools-reference#endconversation-tool-behavior)，只要 Claude 仍然至少有一个其他工具可以调用。允许规则在 `bypassPermissions` 中无效。30模式设置基线。在顶部分层 [权限规则](https://code.claude.com/docs/zh-CN/permissions.md#manage-permissions) 以预批准或阻止特定工具。拒绝规则在每种模式下都会阻止，包括 `bypassPermissions`。拒绝和询问规则不适用于 [`EndConversation`](https://code.claude.com/docs/zh-CN/tools-reference#endconversation-tool-behavior)，只要 Claude 仍然至少有一个其他工具可以调用。允许规则在 `bypassPermissions` 中无效。

31 31

484* 向其他仓库或组织发起 Pull Request、使用 `gh repo fork` 进行 fork，或推送到第三方仓库，除非您指定了该外部目标484* 向其他仓库或组织发起 Pull Request、使用 `gh repo fork` 进行 fork，或推送到第三方仓库，除非您指定了该外部目标

485* 来自敏感本地存储的内容，或来自名称、路径或类型表明其为敏感文件的内容，进入提交、推送、PR 或 issue 文本、gist 或粘贴、或包发布，除非您同时指定了来源和目标。会话记录和对话日志、凭据和配置类点文件夹（例如 SSH 密钥、云凭据、浏览器配置文件和 shell 历史记录）以及用户数据导出都包括在内，仓库为私有也不能解除此阻止485* 来自敏感本地存储的内容，或来自名称、路径或类型表明其为敏感文件的内容，进入提交、推送、PR 或 issue 文本、gist 或粘贴、或包发布，除非您同时指定了来源和目标。会话记录和对话日志、凭据和配置类点文件夹（例如 SSH 密钥、云凭据、浏览器配置文件和 shell 历史记录）以及用户数据导出都包括在内，仓库为私有也不能解除此阻止

486* 写入 Claude Code 会话记录，即 `~/.claude/projects/` 或您所配置的配置目录下的 `.jsonl` 历史文件，无论是直接写入还是通过 shell 命令写入。该规则还涵盖 Claude Code 为其自身检查而附加到每条会话记录条目中的元数据行。读取会话记录不会被阻止486* 写入 Claude Code 会话记录，即 `~/.claude/projects/` 或您所配置的配置目录下的 `.jsonl` 历史文件，无论是直接写入还是通过 shell 命令写入。该规则还涵盖 Claude Code 为其自身检查而附加到每条会话记录条目中的元数据行。读取会话记录不会被阻止

487* 递归强制删除，例如 `rm -rf "$VAR"` 或 `Remove-Item -Recurse -Force $dir`，其目标是在分类器所见对话中任何地方都未赋值的 shell 变量，或以此类变量为根的 glob。该值仅来自先前的命令输出，而分类器从不接收这些输出，因此分类器无法根据其他删除规则验证删除目标。当您指明要删除的确切路径，或 Claude 将解析后的字面路径写入命令并重新运行删除时，该阻止会解除。分类器能够解析目标的删除操作不受影响。487* 递归强制删除，例如 `rm -rf "$VAR"` 或 `Remove-Item -Recurse -Force $dir`，其目标是在分类器所见对话中未赋值的 shell 变量，或以此类变量为根的 glob。没有该赋值，分类器就无法判断该命令会删除什么。

488 488

489 直接位于变量下的 glob（例如 `rm -rf "$VAR"/*`）则属于[关键路径](#critical-paths)。目标为单独的 `*` 或以 `/*` 或 `\*` 结尾的 `Remove-Item` 永远不会到达分类器：Claude Code 会[直接拒绝它们](#remove-item-in-powershell)。489 当您指明要删除的确切路径，或 Claude 将解析后的字面路径写入命令并重新运行删除时，该阻止会解除。分类器能够解析目标的删除操作不受影响。

490

491 直接位于变量下的 glob（例如 `rm -rf "$VAR"/*`）则属于[关键路径](#critical-paths)。对于目标为单独的 `*` 或以 `/*` 或 `\*` 结尾的 `Remove-Item`，请参阅 [PowerShell 中的 Remove-Item](#remove-item-in-powershell)：Claude Code 会直接拒绝该命令。

490 492

491其中一些类别依赖于[环境](https://code.claude.com/docs/zh-CN/auto-mode-config.md#define-trusted-infrastructure)条目，例如敏感远程目标和受保护的 IaC 作用域，您可以将它们收窄到具体名称。493其中一些类别依赖于[环境](https://code.claude.com/docs/zh-CN/auto-mode-config.md#define-trusted-infrastructure)条目，例如敏感远程目标和受保护的 IaC 作用域，您可以将它们收窄到具体名称。

492 494

730 732

731## 受保护的路径733## 受保护的路径

732 734

733对一小组路径的写入永远不会自动批准，唯一的例外是 `bypassPermissions` 模式，以及可使用[绕过权限](#skip-all-checks-with-bypasspermissions-mode)的 plan 模式交互式终端会话。这可以防止意外损坏存储库状态和 Claude 自己的配置。735一小组路径保存着仓库状态和 Claude 自己的配置，因此每种模式对写入这些路径都有各自的规则：

734 736

735| 模式 | 受保护路径写入 |737| 模式 | 受保护路径写入 |

736| :- | :- |738| :- | :- |

737| `default`、`acceptEdits` | 提示 |739| `default`、`acceptEdits` | 提示 |

738| `plan` | 在[绕过权限](#skip-all-checks-with-bypasspermissions-mode)可用的交互式终端会话中允许。否则，当[自动模式](#eliminate-prompts-with-auto-mode)在规划期间可用时路由到分类器，当它不可用时提示 |740| `plan` | 在[绕过权限](#skip-all-checks-with-bypasspermissions-mode)可用的交互式终端会话中允许。否则，当[自动模式](#eliminate-prompts-with-auto-mode)在规划期间可用时路由到分类器，当它不可用时提示 |

740| `dontAsk` | 拒绝 |742| `dontAsk` | 拒绝 |

741| `bypassPermissions` | 允许 |743| `bypassPermissions` | 允许 |

742 744

plugins/org.md +5 −4

Details

185| `disableSideloadFlags` | 在启动时拒绝 `--plugin-dir`、`--plugin-url`、`--agents`、Agent SDK `plugins` 选项以及 [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/zh-CN/env-vars#variables) 变量中命名的文件夹，并且也拒绝 `--mcp-config`，除非其中的每个服务器都是进程内 `type: "sdk"` 条目。拒绝 Agent SDK 应用程序在会话中途通过 [`addPlugins`](https://code.claude.com/docs/zh-CN/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) 添加的插件文件夹 | 不限制 `.mcp.json`、`claude mcp add` 或 SDK 提供的服务器。将其与[`allowedMcpServers`](https://code.claude.com/docs/zh-CN/managed-mcp)配对 |185| `disableSideloadFlags` | 在启动时拒绝 `--plugin-dir`、`--plugin-url`、`--agents`、Agent SDK `plugins` 选项以及 [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/zh-CN/env-vars#variables) 变量中命名的文件夹，并且也拒绝 `--mcp-config`，除非其中的每个服务器都是进程内 `type: "sdk"` 条目。拒绝 Agent SDK 应用程序在会话中途通过 [`addPlugins`](https://code.claude.com/docs/zh-CN/agent-sdk/typescript#load-more-plugin-folders-with-addplugins) 添加的插件文件夹 | 不限制 `.mcp.json`、`claude mcp add` 或 SDK 提供的服务器。将其与[`allowedMcpServers`](https://code.claude.com/docs/zh-CN/managed-mcp)配对 |

187| `allowManagedHooksOnly` | 限制哪些 hooks 运行。请参阅[`allowManagedHooksOnly`](https://code.claude.com/docs/zh-CN/settings-reference#allowmanagedhooksonly) | 不信任用户自己启用的插件中的 hooks |187| `allowManagedHooksOnly` | 限制哪些 hooks 运行。请参阅[`allowManagedHooksOnly`](https://code.claude.com/docs/zh-CN/settings-reference#allowmanagedhooksonly) | 不信任用户自己启用的插件中的 hooks |

188| `strictPluginOnlyCustomization` | 阻止不来自插件、托管设置或 Claude Code 内置的 skill、Agent、hook 和 MCP 服务器。它还会阻止 [skill 目录插件](#keep-skills-directory-plugins-loading)加载。设置 `true` 以覆盖所有四种类型，或 `skills`、`agents`、`hooks` 和 `mcp` 值的数组（例如 `["skills", "hooks"]`）以覆盖某些 | 不限制用户安装哪些插件。将其与 `strictKnownMarketplaces` 配对 |188| `strictPluginOnlyCustomization` | 阻止来自用户和项目源的 skill、Agent、hook 和 MCP 服务器。它还会阻止 [skill 目录插件](#keep-skills-directory-plugins-loading)加载。设置 `true` 以覆盖所有四种类型，或设置 `skills`、`agents`、`hooks` 和 `mcp` 值的数组（例如 `["skills", "hooks"]`）以覆盖其中部分类型 | 不限制用户安装哪些插件，也不拒绝旁加载插件、Agent 和 MCP 服务器的 CLI 标志。将其与 `strictKnownMarketplaces` 和 `disableSideloadFlags` 配对 |

191| `allowedChannelPlugins` | 替换允许推送频道消息的默认插件列表。需要 `channelsEnabled: true` | 请参阅[限制哪些频道插件可以运行](https://code.claude.com/docs/zh-CN/channels.md#restrict-which-channel-plugins-can-run) |191| `allowedChannelPlugins` | 替换允许推送频道消息的默认插件列表。需要 `channelsEnabled: true` | 请参阅[限制哪些频道插件可以运行](https://code.claude.com/docs/zh-CN/channels.md#restrict-which-channel-plugins-can-run) |

336 336

337### 为用户组分配发布频道337### 为用户组分配发布频道

338 338

339要运行稳定和早期访问频道，托管两个指向相同插件的不同 ref 的市场。然后通过单独的端点托管设置或网关策略为每个用户组提供自己的市场。来自管理控制台的服务器托管设置[应用于组织中的每个用户](https://code.claude.com/docs/zh-CN/server-managed-settings.md#current-limitations)，因此它们无法为不同的组分配不同的设置。339要运行稳定和早期访问频道，托管两个指向相同插件的不同 ref 的市场。然后通过单独的端点托管设置或网关策略为每个用户组提供自己的市场。在 Enterprise 计划中，您还可以使用来自管理控制台的服务器托管设置。

340 340

341* 将单独的[端点托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md#delivery-mechanisms)（例如托管设置文件或 MDM 配置文件）部署到每个组的设备。要检查按组文件或配置文件是否在也有组织范围源的设备上应用，请参阅[Claude Code 如何组合托管源](https://code.claude.com/docs/zh-CN/managed-settings.md#precedence-within-the-managed-tier)。341* 将单独的[端点托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md#delivery-mechanisms)（例如托管设置文件或 MDM 配置文件）部署到每个组的设备。要检查按组文件或配置文件是否在也有组织范围源的设备上应用，请参阅[Claude Code 如何组合托管源](https://code.claude.com/docs/zh-CN/managed-settings.md#precedence-within-the-managed-tier)。

342* 为每个组定义一个[Claude 应用网关策略](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config.md#managed)。默认情况下，网关应用第一个匹配规则适合用户的策略，因此请对策略进行排序，使每个用户都能到达其所在组的策略。该策略的 `extraKnownMarketplaces` 映射不与任何其他策略的合并，因此在其中列出组需要的每个市场，而不仅仅是其频道市场。342* 为每个组定义一个[Claude 应用网关策略](https://code.claude.com/docs/zh-CN/claude-apps-gateway-config.md#managed)。默认情况下，网关应用第一个匹配规则适合用户的策略，因此请对策略进行排序，使每个用户都能到达其所在组的策略。该策略的 `extraKnownMarketplaces` 映射不与任何其他策略的合并，因此在其中列出组需要的每个市场，而不仅仅是其频道市场。

343* 在 Enterprise 计划中，在管理控制台中[为每个组提供其自己的配置](https://code.claude.com/docs/zh-CN/server-managed-settings.md#give-groups-different-settings)。组的配置不会与组织范围的配置合并，因此请将该组需要的每个设置都放在该组自己的配置中，包括每个市场。

343 344

344使用任一机制，稳定组接收此配置：345使用上述任一机制，稳定组接收此设置：

345 346

346```json theme={null}347```json theme={null}

347{348{

383 384

384这些来自安全审查的请求在当前设置架构中没有专用键。最接近的现有控制是：385这些来自安全审查的请求在当前设置架构中没有专用键。最接近的现有控制是：

385 386

386* **按用户或按组目标**：每个插件键应用于接收设置的每个用户。服务器托管设置为每个组织交付一个配置。对于按组策略，使用单独的端点托管设置或网关策略，如[为用户组分配发布频道](#assign-release-channels-to-user-groups)下所述。387* **按用户或按组目标**：每个插件键应用于接收设置的每个用户。对于按组策略，请为每个组交付其各自的设置，如[为用户组分配发布频道](#assign-release-channels-to-user-groups)下所述。

387* **限制允许市场内的条目**：允许列表匹配市场源。要从允许的市场阻止一个插件，在托管 `enabledPlugins` 中将其设置为 `false`。388* **限制允许市场内的条目**：允许列表匹配市场源。要从允许的市场阻止一个插件，在托管 `enabledPlugins` 中将其设置为 `false`。

388* **隐藏 `/plugin`**：没有键禁用命令。最接近的等效项结合仅命名您的市场的允许列表、您提供的插件的托管 `enabledPlugins` 条目和 `disableSideloadFlags`。389* **隐藏 `/plugin`**：没有键禁用命令。最接近的等效项结合仅命名您的市场的允许列表、您提供的插件的托管 `enabledPlugins` 条目和 `disableSideloadFlags`。

389* **通过允许列表门控 `--plugin-dir`**：允许列表不覆盖 `--plugin-dir`。`disableSideloadFlags` 覆盖。390* **通过允许列表门控 `--plugin-dir`**：允许列表不覆盖 `--plugin-dir`。`disableSideloadFlags` 覆盖。

quickstart.md +6 −6

Details

35>35>

36> **macOS、Linux、WSL：**36> **macOS、Linux、WSL：**

37>37>

~~38> ```bash theme={null}~~38> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

39> curl -fsSL https://claude.ai/install.sh | bash39> curl -fsSL https://claude.ai/install.sh | bash

40> ```40> ```

41>41>

43>43>

44> **Windows PowerShell：**44> **Windows PowerShell：**

45>45>

~~46> ```powershell theme={null}~~46> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

47> irm https://claude.ai/install.ps1 | iex47> irm https://claude.ai/install.ps1 | iex

48> ```48> ```

49>49>

50> **Windows CMD：**50> **Windows CMD：**

51>51>

~~52> ```batch theme={null}~~52> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

53> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd53> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

54> ```54> ```

55>55>

67 67

68> [tab] Homebrew68> [tab] Homebrew

69>69>

~~70> ```bash theme={null}~~70> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

71> brew install --cask claude-code71> brew install --cask claude-code

72> ```72> ```

73>73>

79 79

80> [tab] WinGet80> [tab] WinGet

81>81>

~~82> ```powershell theme={null}~~82> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

83> winget install Anthropic.ClaudeCode83> winget install Anthropic.ClaudeCode

84> ```84> ```

85>85>

261 261

262| 命令 | 功能 | 示例 |262| 命令 | 功能 | 示例 |

263| - | - | - |263| - | - | - |

267 267

remote-control.md +4 −4

Details

33 * 您将 [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-CN/env-vars) 指向 `api.anthropic.com` 以外的主机，例如 [LLM gateway](https://code.claude.com/docs/zh-CN/llm-gateway) 或代理。取消设置该变量以使用 Remote Control。33 * 您将 [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/zh-CN/env-vars) 指向 `api.anthropic.com` 以外的主机，例如 [LLM gateway](https://code.claude.com/docs/zh-CN/llm-gateway) 或代理。取消设置该变量以使用 Remote Control。

34 * 您通过企业 [Claude apps gateway](https://code.claude.com/docs/zh-CN/claude-apps-gateway) 登录。34 * 您通过企业 [Claude apps gateway](https://code.claude.com/docs/zh-CN/claude-apps-gateway) 登录。

35* **功能标志评估**：如果您设置了[关闭功能标志评估的环境变量](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)，Remote Control 是否可用取决于您设置的是哪一个：35* **功能标志评估**：如果您设置了[关闭功能标志评估的环境变量](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)，Remote Control 是否可用取决于您设置的是哪一个：

36 * 如果您设置了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK`，Remote Control 不可用。在您的 shell 环境或 [`settings.json` 文件](https://code.claude.com/docs/zh-CN/settings-reference#all-settings)的 `env` 块中取消设置该变量，以使用 Remote Control。36 * 如果您设置了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-CN/env-vars#variables)，Remote Control 不可用。无论该变量设置在何处（您的 shell 环境中或 [`settings.json` 文件](https://code.claude.com/docs/zh-CN/settings-reference#all-settings)的 `env` 块中），都请取消设置它，以使用 Remote Control。

37 * 如果您仅设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，Remote Control 保持可用，除非您的组织需要[受信任的设备](#trusted-devices)。如果需要，取消设置该变量以使用 Remote Control。使用设置了任一变量的 Remote Control 需要 Claude Code v2.1.283 或更高版本，在 Claude Desktop 应用中则需要 v2.1.304 或更高版本。37 * 如果您仅设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，Remote Control 保持可用，除非您的组织需要[受信任的设备](#trusted-devices)。如果需要，取消设置该变量以使用 Remote Control。使用设置了任一变量的 Remote Control 需要 Claude Code v2.1.283 或更高版本，在 Claude Desktop 应用中则需要 v2.1.304 或更高版本。

38* **工作区信任**：在您尚未信任的目录中，`claude remote-control` 会打印信任该目录会启用的功能，并在启动前询问 `Trust <directory>? [y/N]`。回答 `y` 会保存该选择，但在您的主目录中除外，在主目录中信任永远不会被保存，每次运行时都会返回该问题。当其标准输入或输出不是终端时，该命令无法询问并以 [`Workspace not trusted`](https://code.claude.com/docs/zh-CN/errors#workspace-not-trusted-when-starting-remote-control) 错误退出。38* **工作区信任**：在您尚未信任的目录中，`claude remote-control` 会打印信任该目录会启用的功能，并在启动前询问 `Trust <directory>? [y/N]`。回答 `y` 会保存该选择，但在您的主目录中除外，在主目录中信任永远不会被保存，每次运行时都会返回该问题。当其标准输入或输出不是终端时，该命令无法询问并以 [`Workspace not trusted`](https://code.claude.com/docs/zh-CN/errors#workspace-not-trusted-when-starting-remote-control) 错误退出。

39 39

217 217

218#### 设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 时的自动连接218#### 设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 时的自动连接

219 219

220如果仅设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，您的会话不会通过组织的管理员默认值或 Claude Code 自身的默认值自动连接。如果是其他原因导致您无法使用 Remote Control，例如 `DISABLE_GROWTHBOOK` 或 LLM 网关，请改为从[要求](#requirements)开始排查。220如果仅设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`，您的会话不会通过组织的管理员默认值或 Claude Code 自身的默认值自动连接。如果是其他原因导致您无法使用 Remote Control，例如 [`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-CN/env-vars#variables) 或 LLM 网关，请改为从[要求](#requirements)开始排查。

221 221

222在仅设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 的情况下开启自动连接之前，请确认您的 Claude Code 版本满足[这些变量的要求](#requirements)。然后检查您的组织是否要求 [Trusted Devices](#trusted-devices)：222在仅设置了 `DISABLE_TELEMETRY` 或 `DO_NOT_TRACK` 的情况下开启自动连接之前，请确认您的 Claude Code 版本满足[这些变量的要求](#requirements)。然后检查您的组织是否要求 [Trusted Devices](#trusted-devices)：

223 223

458 458

459设置了[环境变量](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)来关闭功能标志评估，完整消息命名了 Claude Code 找到的变量。在 2.1.154 之前的版本上，相同的配置会产生"Remote Control is not yet enabled for your account"。要做什么取决于消息命名的变量：459设置了[环境变量](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)来关闭功能标志评估，完整消息命名了 Claude Code 找到的变量。在 2.1.154 之前的版本上，相同的配置会产生"Remote Control is not yet enabled for your account"。要做什么取决于消息命名的变量：

460 460

461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 或 `DISABLE_GROWTHBOOK`**：在设置它的任何地方取消设置变量，在您的 shell 环境或[`settings.json` 文件](https://code.claude.com/docs/zh-CN/settings-reference#all-settings)的 `env` 块中。461* **`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 或 `DISABLE_GROWTHBOOK`**：在设置它的任何地方取消设置变量，在您的 shell 环境或[`settings.json` 文件](https://code.claude.com/docs/zh-CN/settings-reference#all-settings)的 `env` 块中。

462* **`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`**：在 Pro、Max、Ultra、Team 或 Enterprise 套餐上，且 `DISABLE_GROWTHBOOK` 未设置，这些变量会保留 Remote Control 可用，除非您的组织需要[可信设备](#trusted-devices)。如果需要，在设置它的任何地方取消设置变量以使用 Remote Control。在 v2.1.154 到 v2.1.282 上，设置任一变量都会看到此消息，因此请将 Claude Code 更新到满足[这些变量的要求](#requirements)的版本。462* **`DISABLE_TELEMETRY` 或 `DO_NOT_TRACK`**：在 Pro、Max、Ultra、Team 或 Enterprise 套餐上，且 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 和 `DISABLE_GROWTHBOOK` 均未设置时，即使设置了这些变量，Remote Control 仍然可用，除非您的组织要求使用[可信设备](#trusted-devices)。如果要求，请在设置该变量的任何地方取消设置它以使用 Remote Control。在 v2.1.154 到 v2.1.282 上，设置任一变量都会看到此消息，因此请将 Claude Code 更新到满足[这些变量的要求](#requirements)的版本。

463 463

464### "Remote Control is only available when using Claude via api.anthropic.com"464### "Remote Control is only available when using Claude via api.anthropic.com"

465 465

routines.md +4 −4

Details

111* **Environment variables**：提供 Claude 在每次运行期间可以使用的值。它们[对使用该环境的任何人都可见](https://code.claude.com/docs/zh-CN/cloud-environments.md#what-carries-over-from-your-setup)，因此在 Anthropic 托管的环境中，请改为将 Claude 在运行期间调用的 API 的密钥存储为[网络密钥](https://code.claude.com/docs/zh-CN/cloud-environments.md#add-network-secrets)。该部分还列出了永远不会获得密钥的请求111* **Environment variables**：提供 Claude 在每次运行期间可以使用的值。它们[对使用该环境的任何人都可见](https://code.claude.com/docs/zh-CN/cloud-environments.md#what-carries-over-from-your-setup)，因此在 Anthropic 托管的环境中，请改为将 Claude 在运行期间调用的 API 的密钥存储为[网络密钥](https://code.claude.com/docs/zh-CN/cloud-environments.md#add-network-secrets)。该部分还列出了永远不会获得密钥的请求

112* **Setup script**：安装任务所需的依赖和工具。结果会被[缓存](https://code.claude.com/docs/zh-CN/cloud-environments.md#environment-caching)，因此脚本不会在每个会话中重新运行112* **Setup script**：安装任务所需的依赖和工具。结果会被[缓存](https://code.claude.com/docs/zh-CN/cloud-environments.md#environment-caching)，因此脚本不会在每个会话中重新运行

113 113

114系统提供了一个 **Default** 环境，具有 **Trusted** 网络访问，仅允许[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)中的包注册表、云提供商 API、容器注册表和常见开发域名通过会话的网络。您添加到任务中的连接器通过 Anthropic 的服务器访问其服务，因此无需更改允许列表。114系统提供了一个 **Default** 环境，具有 **Limited** 网络访问，并勾选了 **Allow package managers**。其运行可以访问[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)：包注册表、云提供商 API、容器注册表和常见开发域名。您添加到任务中的连接器通过 Anthropic 的服务器访问其服务，因此无需更改允许列表。

115 115

116如果您的任务需要直接访问您自己的服务或该列表之外的域名，请在运行前编辑环境的[网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#network-access)。要使用单独的环境，请先[创建一个](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)。116如果您的任务需要直接访问您自己的服务或该列表之外的域名，请在运行前编辑环境的[网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#network-access)。要使用单独的环境，请先[创建一个](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)。

117 117

431 431

432每个定时任务都使用一个[云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)，用于控制网络访问、环境变量和设置脚本。任务在每次运行时都会继承该环境的网络策略。432每个定时任务都使用一个[云环境](https://code.claude.com/docs/zh-CN/cloud-environments.md)，用于控制网络访问、环境变量和设置脚本。任务在每次运行时都会继承该环境的网络策略。

433 433

434**Default** 环境使用 **Trusted** 网络访问，仅允许[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)中的主机通过会话的网络。通过该路径向允许列表以外主机发出的请求会失败，并返回 `403` 和 `x-deny-reason: host_not_allowed`。MCP 连接器流量通过 Anthropic 的服务器路由，而不经过该路径，因此您添加到任务中的连接器无需将其主机添加到 **Allowed domains** 即可正常工作。请在[连接器](#connectors)下移除您不需要的任何连接器。434**Default** 环境使用 **Limited** 访问并勾选了 **Allow package managers**，因此其运行可以访问[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)中的主机。向被阻止的主机发出的请求会失败，并返回 `403` 和 `x-deny-reason: host_not_allowed`。MCP 连接器流量通过 Anthropic 的服务器路由，因此您添加到任务中的连接器无需将其主机添加到 **Allowed domains** 即可正常工作。请在[连接器](#connectors)下移除您不需要的任何连接器。

435 435

436要在您自己的某个环境中允许更多域名，请按照以下步骤操作。[组织共享环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#organization-shared-environments)在此处以只读方式打开，因此需要由 Owner 在[管理设置](https://claude.ai/admin-settings)的 **Cloud environments** 页面中更改其网络访问。436要在您自己的某个环境中允许更多域名，请按照以下步骤操作。[组织共享环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#organization-shared-environments)在此处以只读方式打开，因此需要由 Owner 在[管理设置](https://claude.ai/admin-settings)的 **Cloud environments** 页面中更改其网络访问。

437 437

447 447

448将鼠标悬停在列表中的环境上，然后点击右侧出现的设置图标。448将鼠标悬停在列表中的环境上，然后点击右侧出现的设置图标。

449 449

450**4. 更改网络访问级别**450**4. 添加域名**

451 451

452在 **Edit cloud environment** 对话框中，将 **Network access** 更改为 **Custom**，并在 **Allowed domains** 中输入您的域名。勾选 **Also include default list of common package managers**，以便在自定义域名之外保留[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)。如需不受限制的访问，请改为选择 **Full**。452在 **Edit cloud environment** 对话框中，在 **Network access** 下选择 **Limited**，并在 **Allowed domains** 中输入您的域名。勾选 **Allow package managers**，以便在您自己的域名之外同时允许[默认允许列表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)。如需不受限制的访问，请改为选择 **Full**。

453 453

454**5. 保存**454**5. 保存**

455 455

sandbox-environments.md +2 −3

Details

6 6

7> 比较 Claude Code 沙箱选项：内置沙箱化 Bash 工具、沙箱运行时、开发容器、Docker 和虚拟机。为您的威胁模型选择合适的隔离方案。7> 比较 Claude Code 沙箱选项：内置沙箱化 Bash 工具、沙箱运行时、开发容器、Docker 和虚拟机。为您的威胁模型选择合适的隔离方案。

8 8

9隔离 Claude Code 会限制会话可以读取、写入和访问网络的内容。当您让 Claude 在较少权限提示的情况下工作、以无人值守方式运行它，或将其指向您不完全信任的代码时，这一点最为重要。9隔离 Claude Code 会限制会话可以读取、写入和访问网络的内容。当您让 Claude 在较少权限提示的情况下工作或以无人值守方式运行它时，这一点最为重要。

10 10

11Claude Code 可以在多种隔离环境中运行，从轻量级的按命令沙箱到完全独立的虚拟机。本页面比较了它们隔离的内容和所需条件，帮助您为威胁模型选择合适的方案，并展示如何在整个组织中强制实施该选择。11Claude Code 可以在多种隔离环境中运行，从轻量级的按命令沙箱到完全独立的虚拟机。本页面比较了它们隔离的内容和所需条件，帮助您为威胁模型选择合适的方案，并展示如何在整个组织中强制实施该选择。

12 12

44| 在您自己的机器上日常工作期间减少权限提示 | [sandboxed Bash tool](https://code.claude.com/docs/zh-CN/sandboxing.md)，使用 `/sandbox` 启用 |44| 在您自己的机器上日常工作期间减少权限提示 | [sandboxed Bash tool](https://code.claude.com/docs/zh-CN/sandboxing.md)，使用 `/sandbox` 启用 |

45| 让 Claude 使用 `--dangerously-skip-permissions` 或自动模式无人值守工作 | 预配置的 [dev container](https://code.claude.com/docs/zh-CN/devcontainer.md)、任何容器或虚拟机，或 [sandbox runtime](#sandbox-runtime) |45| 让 Claude 使用 `--dangerously-skip-permissions` 或自动模式无人值守工作 | 预配置的 [dev container](https://code.claude.com/docs/zh-CN/devcontainer.md)、任何容器或虚拟机，或 [sandbox runtime](#sandbox-runtime) |

46| 隔离 MCP 服务器和 hooks 以及 Bash，不使用 Docker | sandbox runtime |46| 隔离 MCP 服务器和 hooks 以及 Bash，不使用 Docker | sandbox runtime |

47| 在不受信任的存储库上工作 | 专用虚拟机，或 [cloud session](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md)（如果您有 Claude 订阅）；使用 `claude --cloud` 启动时不需要 GitHub |

48| 在团队中标准化沙箱环境 | 预配置的 [dev container](https://code.claude.com/docs/zh-CN/devcontainer.md)，复制到您的存储库中 |47| 在团队中标准化沙箱环境 | 预配置的 [dev container](https://code.claude.com/docs/zh-CN/devcontainer.md)，复制到您的存储库中 |

49| 从没有本地设置的设备使用 Claude Code | [cloud session](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md)，需要 Claude 订阅；如需克隆 GitHub 仓库，还需要连接的 GitHub 账户 |48| 从没有本地设置的设备使用 Claude Code | [cloud session](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md)，需要 Claude 订阅；如需克隆 GitHub 仓库，还需要连接的 GitHub 账户 |

50| 为组织中的每个开发人员要求隔离 | [在整个组织中强制实施隔离](#enforce-isolation-across-an-organization) |49| 为组织中的每个开发人员要求隔离 | [在整个组织中强制实施隔离](#enforce-isolation-across-an-organization) |

157 156

158## Virtual machine157## Virtual machine

159 158

160专用虚拟机提供最强的分离，具有自己的内核，在云或 microVM 部署中，还有自己的虚拟化硬件。选项包括云实例、本地虚拟机管理程序和 microVM（如 Firecracker）。当您评估不受信任的代码、您的安全策略要求代理和主机之间的内核级分离，或没有主机级方法满足您的合规要求时，使用此方法。159专用虚拟机提供最强的分离，具有自己的内核，在云或 microVM 部署中，还有自己的虚拟化硬件。选项包括云实例、本地虚拟机管理程序和 microVM（如 Firecracker）。当您的安全策略要求 Agent 和主机之间的内核级分离，或没有主机级方法满足您的合规要求时，使用此方法。

161 160

162[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) 提供了一个具有自己的 Docker 守护程序和工作区同步的 microVM，可以在任何安装了 Docker Sandboxes 的主机上运行 Claude Code。它是来自 Docker 的免费独立产品，不需要 Docker Desktop。161[Docker Sandboxes](https://docs.docker.com/ai/sandboxes/) 提供了一个具有自己的 Docker 守护程序和工作区同步的 microVM，可以在任何安装了 Docker Sandboxes 的主机上运行 Claude Code。它是来自 Docker 的免费独立产品，不需要 Docker Desktop。

163 162

sandboxing.md +1 −1

Details

739 739

740沙箱无法在原生 Windows 上运行，因此设置 `failIfUnavailable` 后，Claude Code 会在这些机器上于启动时退出。如果您的设备群包含 Windows 主机，您可以：740沙箱无法在原生 Windows 上运行，因此设置 `failIfUnavailable` 后，Claude Code 会在这些机器上于启动时退出。如果您的设备群包含 Windows 主机，您可以：

741 741

742* **按操作系统下发配置**：仅在 macOS 和 Linux 机器上通过您的 MDM 或作为[托管设置文件](https://code.claude.com/docs/zh-CN/managed-settings.md#delivery-mechanisms)进行部署。[服务器托管设置](https://code.claude.com/docs/zh-CN/server-managed-settings.md#current-limitations)适用于组织中的所有用户742* **按操作系统下发配置**：仅在 macOS 和 Linux 机器上通过您的 MDM 或作为[托管设置文件](https://code.claude.com/docs/zh-CN/managed-settings.md#delivery-mechanisms)进行部署。[服务器托管设置](https://code.claude.com/docs/zh-CN/server-managed-settings.md#give-groups-different-settings)跟随成员，而非设备。

743* **将 Windows 用户迁移到受支持的环境**：让他们在 WSL2 或容器内运行 Claude Code743* **将 Windows 用户迁移到受支持的环境**：让他们在 WSL2 或容器内运行 Claude Code

744 744

745### 防止开发者扩大策略745### 防止开发者扩大策略

scheduled-tasks.md +5 −3

Details

92* 处理当前分支的 Pull Request：评审意见、失败的 CI 运行、合并冲突92* 处理当前分支的 Pull Request：评审意见、失败的 CI 运行、合并冲突

93* 在没有其他待处理事项时，执行清理工作，例如查找 bug 或简化代码93* 在没有其他待处理事项时，执行清理工作，例如查找 bug 或简化代码

94 94

~~95Claude 不会在该范围之外发起新的工作，并且推送或删除等不可逆操作只有在延续会话记录中已授权的内容时才会执行。~~95每次运行在推送或删除任何内容之前，都会经过会话的[权限检查](https://code.claude.com/docs/zh-CN/permissions.md)。

97单独的 `/loop` 会以[动态选择的间隔](#let-claude-choose-the-interval)运行此提示词：

96 98

97```text theme={null}99```text theme={null}

98/loop100/loop

99```101```

100 102

101单独的 `/loop` 会以[动态选择的间隔](#let-claude-choose-the-interval)运行此提示词。添加间隔（例如 `/loop 15m`）即可改为按固定计划运行。要用您自己的默认提示词替换内置提示词，请参阅[使用 loop.md 自定义默认提示词](#customize-the-default-prompt-with-loop-md)。103添加间隔（例如 `/loop 15m`）即可改为按固定计划运行。要用您自己的默认提示词替换内置提示词，请参阅[使用 loop.md 自定义默认提示词](#customize-the-default-prompt-with-loop-md)。

102 104

103### 使用 loop.md 自定义默认提示词105### 使用 loop.md 自定义默认提示词

104 106

227 229

228## 禁用会话范围的定时任务230## 禁用会话范围的定时任务

229 231

230在您的环境中设置 `CLAUDE_CODE_DISABLE_CRON=1` 以完全禁用调度程序。cron 工具和 `/loop` 变得不可用，任何已计划的任务都停止触发。有关禁用标志的完整列表，请参阅[环境变量](https://code.claude.com/docs/zh-CN/env-vars.md)。232在您的环境中设置 `CLAUDE_CODE_DISABLE_CRON=1` 以完全禁用调度程序。`CronCreate` 和 `/loop` 变得不可用，任何已计划的任务都停止触发。当项目的 `.claude/scheduled_tasks.json` 文件中存有任务时，`CronList` 和 `CronDelete` 仍然可用，因此您仍可以让 Claude 列出或取消这些任务。有关禁用标志的完整列表，请参阅[环境变量](https://code.claude.com/docs/zh-CN/env-vars.md)。

231 233

232## 限制234## 限制

233 235

self-hosted-environments-configuration.md +4 −4

Details

183 183

184* **会话向其推送结果的仓库**：运行器会使会话失败，并在非零退出时将脚本 stderr 的末尾部分呈现给用户。请将原因以简短的一行写入 stderr，将其放在最后写入，然后以非零状态退出。请勿将机密信息打印到 stderr，并在部署 hook 之前移除 `set -x`。184* **会话向其推送结果的仓库**：运行器会使会话失败，并在非零退出时将脚本 stderr 的末尾部分呈现给用户。请将原因以简短的一行写入 stderr，将其放在最后写入，然后以非零状态退出。请勿将机密信息打印到 stderr，并在部署 hook 之前移除 `set -x`。

185 185

186 如果 git 的 `couldn't find remote ref` 出现在 hook stderr 的大约最后 4 KB 中，运行器会改为报告分支已被删除。此时会话的错误消息会说明该分支在远程上已不存在，并请用户恢复它。如果该分支确实存在，请参阅[会话失败并显示 `no longer exists on the remote` 或 `couldn't find remote ref`](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。186 如果 git 的 `couldn't find remote ref` 出现在 hook stderr 的大约最后 4 KB 中，运行器会改为报告分支缺失。如果该分支确实存在，请参阅[会话失败并显示 `couldn't be found in the remote repository` 或 `couldn't find remote ref`](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。

187* **会话仅从中读取的仓库**，例如添加到正在运行的会话中的仓库：运行器会跳过该仓库并继续处理其余仓库。运行器会向会话发布一个 `Skipped` 步骤，并删除 hook 在检出路径处留下的任何内容。187* **会话仅从中读取的仓库**，例如添加到正在运行的会话中的仓库：运行器会跳过该仓库并继续处理其余仓库。运行器会向会话发布一个 `Skipped` 步骤，并删除 hook 在检出路径处留下的任何内容。

188 188

189 当 `Skipped` 步骤提到 checkout hook 时，请在运行器日志中的 `[runner:warn] checkout hook failed` 行中查找失败详情。当该步骤表示某个源引用 `no longer exists on remote` 时，请参阅[会话失败并显示 `no longer exists on the remote` 或 `couldn't find remote ref`](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。如果跳过后会话完全没有仓库，运行器仍然会使会话失败。189 当 `Skipped` 步骤提到 checkout hook 时，请在运行器日志中的 `[runner:warn] checkout hook failed` 行中查找失败详情。当该步骤表示某个源引用 `no longer exists on remote` 时，请参阅[会话失败并显示 `couldn't be found in the remote repository` 或 `couldn't find remote ref`](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy#no-longer-exists-on-the-remote)。如果跳过后会话完全没有仓库，运行器仍然会使会话失败。

190 190

191当 hook 成功时，运行器会在会话结束后删除检出路径。191当 hook 成功时，运行器会在会话结束后删除检出路径。

192 192

638 638

639* 位于标准系统路径的企业作用域[托管 MCP 文件](https://code.claude.com/docs/zh-CN/managed-mcp.md)：Linux 运行器主机上为 `/etc/claude-code/managed-mcp.json`，macOS 主机上为 `/Library/Application Support/ClaudeCode/managed-mcp.json`。适用于只允许加载管理员列出的服务器的锁定机群。有关优先级规则，请参阅[使用 managed-mcp.json 进行独占控制](https://code.claude.com/docs/zh-CN/managed-mcp.md#exclusive-control-with-managed-mcp-json)。当运行器主机上存在此文件时，Claude Code 会跳过 Anthropic 控制平面下发给会话的 MCP 服务器（包括 claude.ai 连接器），并在会话子进程的 stderr 上以警告形式列出它们的名称，运行器会以 `debug` 日志级别记录这些警告。在 v2.1.229 之前，这些会话会在启动时退出并显示 `You cannot dynamically configure MCP servers when an enterprise MCP config is present`。639* 位于标准系统路径的企业作用域[托管 MCP 文件](https://code.claude.com/docs/zh-CN/managed-mcp.md)：Linux 运行器主机上为 `/etc/claude-code/managed-mcp.json`，macOS 主机上为 `/Library/Application Support/ClaudeCode/managed-mcp.json`。适用于只允许加载管理员列出的服务器的锁定机群。有关优先级规则，请参阅[使用 managed-mcp.json 进行独占控制](https://code.claude.com/docs/zh-CN/managed-mcp.md#exclusive-control-with-managed-mcp-json)。当运行器主机上存在此文件时，Claude Code 会跳过 Anthropic 控制平面下发给会话的 MCP 服务器（包括 claude.ai 连接器），并在会话子进程的 stderr 上以警告形式列出它们的名称，运行器会以 `debug` 日志级别记录这些警告。在 v2.1.229 之前，这些会话会在启动时退出并显示 `You cannot dynamically configure MCP servers when an enterprise MCP config is present`。

640* 运行器主机上[托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md)中的 [`managedMcpServers`](https://code.claude.com/docs/zh-CN/settings-reference#managedmcpservers) 键：提供 HTTP 和 SSE 服务器，但不进行独占控制，因此来自其他来源的服务器仍会加载。需要 Claude Code v2.1.259 或更高版本。640* 运行器主机上[托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md)中的 [`managedMcpServers`](https://code.claude.com/docs/zh-CN/settings-reference#managedmcpservers) 键：提供 HTTP 和 SSE 服务器，但不进行独占控制，因此来自其他来源的服务器仍会加载。需要 Claude Code v2.1.259 或更高版本。

641* `<repo>/.mcp.json`：项目作用域。在[项目](https://code.claude.com/docs/zh-CN/claude-projects.md#what-threads-pick-up-from-your-repositories)线程之外，将该文件提交到仓库，其中的服务器在云端会话中会被自动批准。在包含多个仓库的会话中，[最多只会加载一个仓库的该文件](#repository-settings-in-sessions-with-several-repositories)。641* `<repo>/.mcp.json`：项目作用域。在[项目](https://code.claude.com/docs/zh-CN/claude-projects.md#what-threads-pick-up-from-your-repositories)线程之外，将该文件提交到仓库，其中的服务器在云端会话中会被自动批准。在包含多个仓库的会话中，[最多只会加载一个仓库的该文件](#repository-settings-in-sessions-with-several-repositories)。使用 [`--trust-workspace false`](https://code.claude.com/docs/zh-CN/self-hosted-environments-reference#runner-cli-flags) 时，会话会跳过该文件中的服务器，除非有未由仓库提交的设置批准了它们，例如主机 `~/.claude/settings.json` 中的 [`enabledMcpjsonServers`](https://code.claude.com/docs/zh-CN/settings-reference#enabledmcpjsonservers)。需要 Claude Code v2.1.319 或更高版本。

642* 来自您的包装脚本的 [`--mcp-config`](https://code.claude.com/docs/zh-CN/cli-reference#cli-flags) 文件：将该标志追加在 `"$@"` 之后，例如 `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`。为了在会话中途更新会话所下发的服务器时让该文件中的服务器保持运行，请让您的包装脚本将[完整环境](#wrapper-scripts)传递给子进程，就像 `exec` 所做的那样。在 v2.1.299 之前，该文件中的 stdio、HTTP 和 SSE 服务器会在第一次未指明它们的此类更新时关闭。642* 来自您的包装脚本的 [`--mcp-config`](https://code.claude.com/docs/zh-CN/cli-reference#cli-flags) 文件：将该标志追加在 `"$@"` 之后，例如 `exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --mcp-config /etc/claude/mcp.json`。为了在会话中途更新会话所下发的服务器时让该文件中的服务器保持运行，请让您的包装脚本将[完整环境](#wrapper-scripts)传递给子进程，就像 `exec` 所做的那样。在 v2.1.299 之前，该文件中的 stdio、HTTP 和 SSE 服务器会在第一次未指明它们的此类更新时关闭。

643 643

644当您的组织启用了连接器下发时，Anthropic 的控制平面会通过服务器提供的 MCP 配置，将您在 claude.ai 上配置的连接器下发到以交互方式创建的会话，请求经由 `api.anthropic.com` 路由。以编程方式创建的会话（例如 [CLI 调度](https://code.claude.com/docs/zh-CN/self-hosted-environments-testing.md#run-the-test-loop)）不会接收连接器下发；请改为通过本节列出的任何其他来源为它们提供 MCP 服务器。子进程的 OAuth 令牌不带有直接获取连接器的作用域，因此子进程本身不会尝试获取；下发由服务器驱动。644当您的组织启用了连接器下发时，Anthropic 的控制平面会通过服务器提供的 MCP 配置，将您在 claude.ai 上配置的连接器下发到以交互方式创建的会话，请求经由 `api.anthropic.com` 路由。以编程方式创建的会话（例如 [CLI 调度](https://code.claude.com/docs/zh-CN/self-hosted-environments-testing.md#run-the-test-loop)）不会接收连接器下发；请改为通过本节列出的任何其他来源为它们提供 MCP 服务器。子进程的 OAuth 令牌不带有直接获取连接器的作用域，因此子进程本身不会尝试获取；下发由服务器驱动。

908 908

909在其他任何包含多个仓库的会话中，Claude Code 从会话启动所在的目录读取项目设置，因此最多只有一个仓库的 `.claude/settings.json` 作为项目设置生效。在其他仓库的文件中定义的 hook 不会运行，其中的拒绝规则不会生效，其 `env` 也不会被设置。909在其他任何包含多个仓库的会话中，Claude Code 从会话启动所在的目录读取项目设置，因此最多只有一个仓库的 `.claude/settings.json` 作为项目设置生效。在其他仓库的文件中定义的 hook 不会运行，其中的拒绝规则不会生效，其 `env` 也不会被设置。

910 910

911* **`--capacity 1`（默认值）并使用内置检出**：会话在其仓库列表中的第一个仓库中启动。该仓库的 `.claude/settings.json` 作为项目设置生效，其 `.mcp.json` 会被加载，而其他仓库的则不会。911* **`--capacity 1`（默认值）并使用内置检出**：会话在其仓库列表中的第一个仓库中启动。该仓库的 `.claude/settings.json` 作为项目设置生效，其 [`.mcp.json`](#mcp-servers) 会被加载，而其他仓库的则不会。

912* **`--capacity` 大于 1，或使用 [`checkout` hook](#checkout)**：会话在包含各检出内容的按会话目录中启动。没有任何仓库的 `.claude/settings.json` 作为项目设置生效，没有任何仓库的 `.mcp.json` 会被加载，并且 hook 命令中的 [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/zh-CN/hooks#reference-scripts-by-path) 是该目录，而不是某个检出目录。912* **`--capacity` 大于 1，或使用 [`checkout` hook](#checkout)**：会话在包含各检出内容的按会话目录中启动。没有任何仓库的 `.claude/settings.json` 作为项目设置生效，没有任何仓库的 `.mcp.json` 会被加载，并且 hook 命令中的 [`$CLAUDE_PROJECT_DIR`](https://code.claude.com/docs/zh-CN/hooks#reference-scripts-by-path) 是该目录，而不是某个检出目录。

913 913

914无论会话在何处启动，每个仓库的 `CLAUDE.md` 都会被加载。在项目线程之外，其 skill 也会被加载。运行器将每个仓库作为[附加目录](https://code.claude.com/docs/zh-CN/permissions.md#additional-directories-grant-file-access-not-configuration)传递给 Claude Code，因此 Claude Code 还会从每个仓库的 `.claude/settings.json` 中读取 `enabledPlugins` 和 `extraKnownMarketplaces` 键。914无论会话在何处启动，每个仓库的 `CLAUDE.md` 都会被加载。在项目线程之外，其 skill 也会被加载。运行器将每个仓库作为[附加目录](https://code.claude.com/docs/zh-CN/permissions.md#additional-directories-grant-file-access-not-configuration)传递给 Claude Code，因此 Claude Code 还会从每个仓库的 `.claude/settings.json` 中读取 `enabledPlugins` 和 `extraKnownMarketplaces` 键。

self-hosted-environments-deploy.md +9 −3

Details

916* **运行器记录包含 `rejecting the malformed poll response` 的 `Poll failed` 行**：运行器收到的工作轮询响应的正文不是队列的预期 JSON。原因之一是拦截代理或强制门户用自己的页面进行了应答。如果运行器通过代理连接，请配置代理以将来自 `api.anthropic.com` 的响应原封不动地传递。916* **运行器记录包含 `rejecting the malformed poll response` 的 `Poll failed` 行**：运行器收到的工作轮询响应的正文不是队列的预期 JSON。原因之一是拦截代理或强制门户用自己的页面进行了应答。如果运行器通过代理连接，请配置代理以将来自 `api.anthropic.com` 的响应原封不动地传递。

917 917

918 运行器拒绝该格式错误的响应，在 `claude_code_self_hosted_runner_poll_errors_total` [指标](https://code.claude.com/docs/zh-CN/self-hosted-environments-reference.md#prometheus-metrics) 的 `transport` 类型下计数，并按 [会话生命周期](https://code.claude.com/docs/zh-CN/self-hosted-environments#session-lifecycle) 中描述的失败轮询计划重试。运行器继续为其实时会话提供服务。在 v2.1.246 之前，运行器将这样的响应读取为空工作队列，这可能会结束其实时会话或使其退出。918 运行器拒绝该格式错误的响应，在 `claude_code_self_hosted_runner_poll_errors_total` [指标](https://code.claude.com/docs/zh-CN/self-hosted-environments-reference.md#prometheus-metrics) 的 `transport` 类型下计数，并按 [会话生命周期](https://code.claude.com/docs/zh-CN/self-hosted-environments#session-lifecycle) 中描述的失败轮询计划重试。运行器继续为其实时会话提供服务。在 v2.1.246 之前，运行器将这样的响应读取为空工作队列，这可能会结束其实时会话或使其退出。

919* **会话失败，显示 `no longer exists on the remote` 或 `couldn't find remote ref`**：运行器会将 git 的 `couldn't find remote ref` 理解为分支已被删除。但该分支可能仍然存在。请在您的 git 主机上按消息中的确切名称查找该分支，然后逐一检查符合情况的原因：919* **会话失败，显示 `couldn't be found in the remote repository` 或 `couldn't find remote ref`**：在您的 git 主机上查找该分支。请按消息中的确切名称进行搜索。

920 920

921 * **分支已不存在**：请按消息的要求恢复该分支。921 会话的错误中包含 `Retrying will fail the same way until you fix the missing branch described below.`。当错误指明了分支时，`Last output before exit:` 下的文本如下：

922

923 ```text theme={null}

924 The branch '<ref>' couldn't be found in the remote repository <repo>. If it was never pushed, push it. If it was deleted after a merge, restore it from its pull request. Then send a new message, or start a new session from a branch that has been pushed. (couldn't find remote ref)

925 ```

926

927 * **分支不在主机上**：如果该分支从未被推送，请推送它；如果它在合并后被删除，请从其 Pull Request 中恢复它。

922 * **分支存在，且您不管理该运行器**：将完整消息发送给运行器的管理员，并告知其该分支存在。928 * **分支存在，且您不管理该运行器**：将完整消息发送给运行器的管理员，并告知其该分支存在。

923 * **分支存在，且运行器有 `checkout` hook**：您的 hook 中的某个 git 命令可能会在 hook 以非零状态退出之前将 `couldn't find remote ref` 打印到 stderr。找到该命令，并更正它请求的 ref 或它从中获取的远程。运行器会将会话请求的修订版本作为 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration#checkout) 传递给您的 hook。929 * **分支存在，且运行器有 `checkout` hook**：您的 hook 中的某个 git 命令可能会在 hook 以非零状态退出之前将 `couldn't find remote ref` 打印到 stderr。找到该命令，并更正它请求的 ref 或它从中获取的远程。运行器会将会话请求的修订版本作为 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration#checkout) 传递给您的 hook。

924 * **分支存在，且运行器没有 `checkout` hook**：运行器会自行获取该分支。如果某个 [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) 适用于该仓库，请确认其重写到的目标主机上存在同名分支，如果不存在，请将该分支推送到那里。930 * **分支存在，且运行器没有 `checkout` hook**：运行器会自行获取该分支。如果某个 [`--git-host-rewrite`](#rewrite-git-urls-for-private-networks) 适用于该仓库，请确认其重写到的目标主机上存在同名分支，如果不存在，请将该分支推送到那里。

925 * **分支存在，且运行器早于 v2.1.301**：按照 [固定版本](#pin-the-version) 中的说明升级运行器，以便其他类型的失败显示其自身的错误。在 v2.1.301 之前，错误输出中包含 `couldn't find remote ref` 的其他失败也会被报告为分支已删除。931 * **分支存在，且运行器早于 v2.1.301**：按照 [固定版本](#pin-the-version) 中的说明升级运行器，以便其他类型的失败显示其自身的错误。在 v2.1.301 之前，错误输出中包含 `couldn't find remote ref` 的其他失败也会被报告为分支已删除。

926 932

927 升级运行器或修复原因后，请重试该会话或启动新会话。如果这些检查都未能找到原因，请[报告问题](#report-an-issue)。933 升级运行器或修复原因后，请向该会话发送一条新消息，或从一个已推送的分支启动新会话。如果这些检查都未能找到原因，请[报告问题](#report-an-issue)。在 v2.1.314 之前，该消息显示分支 `no longer exists on the remote`。对于该消息，请执行相同的检查。

928 934

929 对于会话推送结果的源，删除的分支会导致会话失败。对于会话仅从中读取的 git 源，运行器跳过该源并继续处理其余源。当跳过会导致会话完全没有仓库时，运行器会使会话失败。在 v2.1.228 之前，这样的会话在空目录中启动。935 对于会话推送结果的源，删除的分支会导致会话失败。对于会话仅从中读取的 git 源，运行器跳过该源并继续处理其余源。当跳过会导致会话完全没有仓库时，运行器会使会话失败。在 v2.1.228 之前，这样的会话在空目录中启动。

930* **Claude Tag 有时不在 Slack 中发布其回复**：回复提醒是一个[由控制平面提供的 hook](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled)。请使用 `claude --version` 确认运行器为 Claude Code v2.1.229 或更高版本，因为较旧的运行器会忽略所提供的 hook；确认 `python3 --version` 在运行器镜像中能够成功执行，因为这些 hook 会运行 `python3`；并确认没有任何设置文件关闭了 hook，无论是 `managed-settings.json`、运行器用户的 `~/.claude/settings.json`、仓库的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `disableAllHooks`，还是托管设置中的 `allowManagedHooksOnly` 或涵盖 hook 的 [`strictPluginOnlyCustomization`](https://code.claude.com/docs/zh-CN/settings-reference#strictpluginonlycustomization)。936* **Claude Tag 有时不在 Slack 中发布其回复**：回复提醒是一个[由控制平面提供的 hook](https://code.claude.com/docs/zh-CN/self-hosted-environments-configuration.md#how-each-session’s-config-is-assembled)。请使用 `claude --version` 确认运行器为 Claude Code v2.1.229 或更高版本，因为较旧的运行器会忽略所提供的 hook；确认 `python3 --version` 在运行器镜像中能够成功执行，因为这些 hook 会运行 `python3`；并确认没有任何设置文件关闭了 hook，无论是 `managed-settings.json`、运行器用户的 `~/.claude/settings.json`、仓库的 `.claude/settings.json` 或 `.claude/settings.local.json` 中的 `disableAllHooks`，还是托管设置中的 `allowManagedHooksOnly` 或涵盖 hook 的 [`strictPluginOnlyCustomization`](https://code.claude.com/docs/zh-CN/settings-reference#strictpluginonlycustomization)。

self-hosted-environments-reference.md +2 −1

Details

125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | 运行器在会话达到其 `--kill-session-after-min` 限制后等待的时间，以便运行中的轮次完成或释放完成，然后才终止会话 |125| `SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS` | `900000` | 运行器在会话达到其 `--kill-session-after-min` 限制后等待的时间，以便运行中的轮次完成或释放完成，然后才终止会话 |

126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | 运行器在轮次完成后计算会话繁忙的时间上限，用于 `--drain-wait-sec` 排空，而会话的进程向 Anthropic 报告轮次的结束。`0` 或不可用的值回退到默认值，因此无法关闭保持。需要 Claude Code v2.1.275 或更高版本。 |126| `SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS` | `7000` | 运行器在轮次完成后计算会话繁忙的时间上限，用于 `--drain-wait-sec` 排空，而会话的进程向 Anthropic 报告轮次的结束。`0` 或不可用的值回退到默认值，因此无法关闭保持。需要 Claude Code v2.1.275 或更高版本。 |

127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | 运行器等待操作系统向陷入不可中断 I/O 的子进程传递 `SIGKILL` 的时间，然后自己退出。下限为 `--post-session-hook-timeout-sec` 加 15 秒，设置 `--push-outcome-on-release` 时再加 30 秒，因此有效最小值在默认值处为 75 秒。 |127| `SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS` | `30000` | 运行器等待操作系统向陷入不可中断 I/O 的子进程传递 `SIGKILL` 的时间，然后自己退出。下限为 `--post-session-hook-timeout-sec` 加 15 秒，设置 `--push-outcome-on-release` 时再加 30 秒，因此有效最小值在默认值处为 75 秒。 |

128| `CLAUDE_RUNNER_DISABLE_RENEWAL_WARNING` | 未设置 | 当为 `1` 时，运行器不会在会话中发布 `The server has refused to renew this session's access to the model`。每次被拒绝后，它会等到下一次计划的续订时再次请求。需要 Claude Code v2.1.319 或更高版本。 |

128| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | 新克隆的 git 获取深度。设置正整数，或 `full` 或 `0` 以进行完整获取。对于工作区中已存在的克隆，请参阅[复用预热的检出](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)。 |129| `CLAUDE_RUNNER_FETCH_DEPTH` | `50` | 新克隆的 git 获取深度。设置正整数，或 `full` 或 `0` 以进行完整获取。对于工作区中已存在的克隆，请参阅[复用预热的检出](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)。 |

129| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | 在 git 服务器自身的进度数字持续上升期间（例如服务器为大型仓库准备 pack 时），每次尝试中 git 获取等待首批数据的最长时间（以毫秒为单位）。`0` 或 `off` 会关闭此等待：此类获取在两分钟内没有收到数据时将被中断。任何其他整数都会被限制在 `120000` 到 `1800000` 之间，即 2 到 30 分钟。需要 Claude Code v2.1.295 或更高版本。 |130| `CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS` | `600000` | 在 git 服务器自身的进度数字持续上升期间（例如服务器为大型仓库准备 pack 时），每次尝试中 git 获取等待首批数据的最长时间（以毫秒为单位）。`0` 或 `off` 会关闭此等待：此类获取在两分钟内没有收到数据时将被中断。任何其他整数都会被限制在 `120000` 到 `1800000` 之间，即 2 到 30 分钟。需要 Claude Code v2.1.295 或更高版本。 |

130| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | 未设置 | 当为 `1` 时，跳过 `checkout` 钩子运行后的 `.git` 存在检查。当您的钩子物化非 git 源时设置此项。 |131| `CLAUDE_RUNNER_SKIP_GIT_VERIFY` | 未设置 | 当为 `1` 时，跳过 `checkout` 钩子运行后的 `.git` 存在检查。当您的钩子物化非 git 源时设置此项。 |

135 136

136会话子进程向 Anthropic 发送操作遥测，除非您关闭它。不发送代码或存储库内容。在运行器进程上设置遥测变量；运行器在应用服务器提供的环境变量后重新声明它们，因此操作员的设置始终优先。137会话子进程向 Anthropic 发送操作遥测，除非您关闭它。不发送代码或存储库内容。在运行器进程上设置遥测变量；运行器在应用服务器提供的环境变量后重新声明它们，因此操作员的设置始终优先。

137 138

138一个控制特定于自托管环境：`CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` 选择加入 Datadog 操作指标，这在自托管环境中默认关闭。一般 Claude Code 遥测控制 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_ERROR_REPORTING` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 适用于会话子进程，如[环境变量参考](https://code.claude.com/docs/zh-CN/env-vars.md)中所述。`DISABLE_GROWTHBOOK` 相关但不同：设置 `DISABLE_GROWTHBOOK=1` 禁用功能标志获取，遥测保持开启，除非也设置了 `DISABLE_TELEMETRY`。139一个控制特定于自托管环境：`CLAUDE_CODE_BYOC_ENABLE_DATADOG=1` 选择加入 Datadog 操作指标，这在自托管环境中默认关闭。一般 Claude Code 遥测控制 `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_ERROR_REPORTING` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 适用于会话子进程，如[环境变量参考](https://code.claude.com/docs/zh-CN/env-vars.md)中所述。[`CLAUDE_CODE_DISABLE_FEATURE_FLAGS`](https://code.claude.com/docs/zh-CN/env-vars#variables) 相关但不同：设置 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1` 禁用功能标志获取，遥测保持开启，除非也设置了 `DISABLE_TELEMETRY`。`CLAUDE_CODE_DISABLE_FEATURE_FLAGS` 需要 Claude Code v2.1.319 或更高版本。

139 140

140`CLAUDE_CODE_ENABLE_TELEMETRY` 无关：它启用 OpenTelemetry 导出到您自己的收集器，如[监控](https://code.claude.com/docs/zh-CN/monitoring-usage.md)中所述，不控制 Anthropic 的分析。141`CLAUDE_CODE_ENABLE_TELEMETRY` 无关：它启用 OpenTelemetry 导出到您自己的收集器，如[监控](https://code.claude.com/docs/zh-CN/monitoring-usage.md)中所述，不控制 Anthropic 的分析。

141 142

server-managed-settings.md +41 −2

Details

108 108

109在运行的会话中，`/status` 在获取失败后显示相同的行，对于某些跳过获取的原因，例如第三方提供商变量或用户 shell 中导出的自定义 `ANTHROPIC_BASE_URL`。109在运行的会话中，`/status` 在获取失败后显示相同的行，对于某些跳过获取的原因，例如第三方提供商变量或用户 shell 中导出的自定义 `ANTHROPIC_BASE_URL`。

110 110

111### 为不同的组提供不同的设置

112

113在 Enterprise 计划中，您可以为每个成员组提供各自的配置，而不是使用一个组织范围的配置。如果您的组织已[启用 HIPAA](https://code.claude.com/docs/zh-CN/hipaa-setup.md)，则组配置暂不可用。每个组都必须已经存在，可以是通过 SCIM 从您的身份提供商同步的组，也可以是您在管理控制台中管理的自定义组。

114

115每个成员最多接收一个配置，并且在每台设备上都相同：

116

117* **属于某个有配置的组的成员**：其所属组中排名最高的配置

118* **其他任何人**，包括其唯一有配置的组已被删除的成员：通用配置（如果您设置了的话）

119

120各配置之间不会合并，也不会与组织范围的配置合并，因此每个配置都必须包含您希望该组拥有的所有设置。要对每个成员应用某项限制，请将其放入每个组配置以及通用配置中。

121

122在完成以下最后一个步骤之前，成员会继续接收组织范围的配置，因此您可以先设置并测试所有内容：

123

124**1. 为每个组添加配置**

125

126在 [**Organization settings > Claude Code > Managed settings**](https://claude.ai/admin-settings/claude-code) 中，点击 **Add configuration**，选择组，然后选择一个起点。要为某个组放宽策略，请选择由您的身份提供商同步的组，这样就没有人能在管理控制台中将自己添加到该组。

127

128要保留成员当前拥有的内容并更改少数设置，请从组织范围配置的副本开始。编辑该配置并保存。

129

130**2. 设置通用配置**

131

132在 **Everyone else** 上点击 **Set**，并为不匹配任何组配置的成员添加 JSON。要让他们保持当前拥有的内容，请粘贴您的组织范围配置。如果您跳过此步骤，他们的本地会话将不会接收任何服务器管理的设置，而设备上的任何[端点托管设置](https://code.claude.com/docs/zh-CN/managed-settings.md#delivery-mechanisms)仍然适用。

133

134**3. 对组进行排名**

135

136拖动配置以调整顺序。属于多个组的成员只会接收排名最高的配置，因此请将限制最严格或最具体的组放在顶部。

137

138**4. 检查谁会获得什么**

139

140在页面底部的 **Check effective settings** 下，搜索某个成员以查看其将接收哪个配置。请分别检查每个组中的一个成员、属于多个组的一个成员，以及不匹配任何组配置的一个成员。

141

142**5. 切换到基于组的模式**

143

144点击页面顶部横幅中的 **Switch to group-based configurations** 并确认。成员会在大约一小时内接收其配置，但[仅在下次启动时生效的键](#fetch-and-caching-behavior)除外。要切换回去，请从同一横幅切换到组织范围模式：组织范围的配置将再次生效（如果您有的话），并且您的组配置会被保留。

145

146组的模型限制仅在本地会话中有效。云端和远程 Cowork 会话使用通用配置中的 [`availableModels`](https://code.claude.com/docs/zh-CN/model-config#restrict-model-selection) 列表。如果您没有设置通用配置，该列表来自您的组织范围配置，即使在您切换到基于组的模式之后也是如此。如果您在通用配置中省略该键，则成员在这些会话中不受此列表限制。

147

148如果您使用组的配置来设置 API 请求的去向，这仅适用于 Claude Code，而不适用于调用该 API 的其他工具。

149

111### 访问控制150### 访问控制

112 151

113以下角色可以管理服务器管理的设置：152以下角色可以管理服务器管理的设置：

115* **Primary Owner**154* **Primary Owner**

116* **Owner**155* **Owner**

117 156

118限制对受信任人员的访问，因为设置更改适用于组织中的所有用户。157限制对受信任人员的访问，因为设置更改可能会适用于组织中的所有用户。

119 158

120### 仅限托管的设置159### 仅限托管的设置

121 160

125 164

126服务器管理的设置有以下限制：165服务器管理的设置有以下限制：

127 166

128* 设置统一应用于组织中的所有用户。尚不支持按组配置。167* 在 Team 计划中，设置统一应用于组织中的所有用户。[组配置](#give-groups-different-settings)需要 Enterprise 计划。

129* 您无法通过服务器管理的设置分发 [`managed-mcp.json`](https://code.claude.com/docs/zh-CN/managed-mcp) 文件。改为在那里传递 `allowedMcpServers` 和 `deniedMcpServers` 策略键。在 Claude Code v2.1.259 或更高版本上，您还可以通过 [`managedMcpServers`](https://code.claude.com/docs/zh-CN/managed-mcp#provide-servers-through-managed-settings) 提供远程服务器，它仅接受 `http` 和 `sse` 服务器，并且不会像文件那样获得独占控制。168* 您无法通过服务器管理的设置分发 [`managed-mcp.json`](https://code.claude.com/docs/zh-CN/managed-mcp) 文件。改为在那里传递 `allowedMcpServers` 和 `deniedMcpServers` 策略键。在 Claude Code v2.1.259 或更高版本上，您还可以通过 [`managedMcpServers`](https://code.claude.com/docs/zh-CN/managed-mcp#provide-servers-through-managed-settings) 提供远程服务器，它仅接受 `http` 和 `sse` 服务器，并且不会像文件那样获得独占控制。

130 169

131 Claude Code 在其[系统路径](https://code.claude.com/docs/zh-CN/managed-mcp.md#exclusive-control-with-managed-mcp-json)处部署的 `managed-mcp.json` 与托管设置层分开读取，因此当服务器管理的设置生效时，该文件仍然适用。170 Claude Code 在其[系统路径](https://code.claude.com/docs/zh-CN/managed-mcp.md#exclusive-control-with-managed-mcp-json)处部署的 `managed-mcp.json` 与托管设置层分开读取，因此当服务器管理的设置生效时，该文件仍然适用。

settings-example.md +1 −1

Details

245* `cleanupPeriodDays` 将会话记录和其他本地数据的保留期缩短为七天245* `cleanupPeriodDays` 将会话记录和其他本地数据的保留期缩短为七天

246* `companyAnnouncements` 在启动时显示消息246* `companyAnnouncements` 在启动时显示消息

247 247

248管理员将这样的文件部署为 `managed-settings.json`，或通过 MDM 或 [server-managed settings](https://code.claude.com/docs/zh-CN/server-managed-settings.md) 部署相同的 JSON。一个部署的文件适用于它到达的每台机器或帐户。要为一个组提供不同的值，请将不同的文件或配置文件部署到该组，因为 [server-managed settings 还不支持按组策略](https://code.claude.com/docs/zh-CN/server-managed-settings.md#current-limitations)。248管理员将这样的文件部署为 `managed-settings.json`，或通过 MDM 或 [server-managed settings](https://code.claude.com/docs/zh-CN/server-managed-settings.md) 部署相同的 JSON。一个部署的文件适用于它到达的每台机器或帐户。要为一个组提供不同的值，请将不同的文件或配置文件部署到该组。在 Enterprise 计划中，您也可以改为在 server-managed settings 中[为该组提供其自己的配置](https://code.claude.com/docs/zh-CN/server-managed-settings.md#give-groups-different-settings)。

249 249

250> [tab] Copyable settings file250> [tab] Copyable settings file

251>251>

skills.md +1 −0

Details

91| `managed-agents-secure [<agent-id>]` | 读取某个 Managed Agent 的设置，并报告其中哪些与[保护您的 Managed Agents 部署](https://platform.claude.com/docs/en/managed-agents/secure-deployment)指南相符、哪些与之不同。需要 [`ant` CLI](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 或更高版本 |91| `managed-agents-secure [<agent-id>]` | 读取某个 Managed Agent 的设置，并报告其中哪些与[保护您的 Managed Agents 部署](https://platform.claude.com/docs/en/managed-agents/secure-deployment)指南相符、哪些与之不同。需要 [`ant` CLI](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart) | v2.1.304 或更高版本 |

94| `latency-optimize` | 找出您现有 Claude API 代码中时间花在哪里，并提议缩短用户等待时间的更改 | v2.1.319 或更高版本 |

96| `preserved-thinking-migration` | 查找您的集成对早期轮次、其系统提示或其工具列表所做的编辑，这些编辑使[保留的思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)块失效，测量每个块丢弃多少推理，并提议一次一个修复，在每次更改后重新测量 | v2.1.282 或更高版本 |97| `preserved-thinking-migration` | 查找您的集成对早期轮次、其系统提示或其工具列表所做的编辑，这些编辑使[保留的思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)块失效，测量每个块丢弃多少推理，并提议一次一个修复，在每次更改后重新测量 | v2.1.282 或更高版本 |

tools-reference.md +1 −1

Details

197时间限制从命令进入后台的时刻开始计算：197时间限制从命令进入后台的时刻开始计算：

198 198

199* Claude 在后台启动的命令获得 30 分钟，或 Claude 使用 `run_in_background` 传递的 `timeout`，最多 2 小时199* Claude 在后台启动的命令获得 30 分钟，或 Claude 使用 `run_in_background` 传递的 `timeout`，最多 2 小时

200* 在前台启动然后移到后台的命令，例如在其超时时，从移动时获得 30 分钟200* 在前台启动、然后在达到其超时时移到后台的命令，从移动时起获得 30 分钟

201 201

202在使用 `-p` 标志且以文本形式（而不是使用 `--input-format stream-json`）传递提示词的运行中，两个默认值都是 10 分钟而不是 30 分钟，因为该运行会[在其结果之后等待后台命令](https://code.claude.com/docs/zh-CN/headless.md#background-tasks-at-exit)。202在使用 `-p` 标志且以文本形式（而不是使用 `--input-format stream-json`）传递提示词的运行中，两个默认值都是 10 分钟而不是 30 分钟，因为该运行会[在其结果之后等待后台命令](https://code.claude.com/docs/zh-CN/headless.md#background-tasks-at-exit)。

203 203

vs-code.md +4 −1

Details

399 399

400如果重新加载在 Claude 执行某个步骤的过程中将其中断，对话恢复后 Claude 会继续该步骤，并在聊天中显示一条通知来标记此次继续。需要 Claude Code v2.1.274 或更高版本。如果该步骤是在一小时以前被中断的，或者该会话在其他地方打开，对话恢复后将处于空闲状态。400如果重新加载在 Claude 执行某个步骤的过程中将其中断，对话恢复后 Claude 会继续该步骤，并在聊天中显示一条通知来标记此次继续。需要 Claude Code v2.1.274 或更高版本。如果该步骤是在一小时以前被中断的，或者该会话在其他地方打开，对话恢复后将处于空闲状态。

401 401

402当聊天中的通知包含 `plan mode is now off, so Claude did not continue on its own` 时，表示该步骤是在计划模式下被中断的。若要继续制定计划，请在发送下一条消息之前，在模式指示器中选择 **Plan**。

403

402#### 关闭重新加载后的继续执行404#### 关闭重新加载后的继续执行

403 405

404若要阻止 Claude 在重新加载后继续被中断的步骤，请打开 [Continue After Reload 设置](vscode://settings/claudeCode.continueAfterReload)并取消勾选。406若要阻止 Claude 在重新加载后继续被中断的步骤，请打开 [Continue After Reload 设置](vscode://settings/claudeCode.continueAfterReload)并取消勾选。

626 628

627## VS Code 命令和快捷键629## VS Code 命令和快捷键

628 630

629要打开命令面板，请在 Mac 上按 `Cmd+Shift+P`，在 Windows/Linux 上按 `Ctrl+Shift+P`。在其中输入"Claude Code"即可查看 Claude Code 扩展的所有可用 VS Code 命令。631要打开命令面板，请在 Mac 上按 `Cmd+Shift+P`，在 Windows/Linux 上按 `Ctrl+Shift+P`。在其中输入"Claude Code"即可查看该扩展在命令面板中提供的命令。

630 632

631某些快捷键取决于当前哪个面板处于"焦点"状态（接收键盘输入）。当光标位于代码文件中时，编辑器处于焦点状态。当光标位于 Claude 的提示词输入框中时，Claude 处于焦点状态。使用 `Cmd+Esc` / `Ctrl+Esc` 在两者之间切换。633某些快捷键取决于当前哪个面板处于"焦点"状态（接收键盘输入）。当光标位于代码文件中时，编辑器处于焦点状态。当光标位于 Claude 的提示词输入框中时，Claude 处于焦点状态。使用 `Cmd+Esc` / `Ctrl+Esc` 在两者之间切换。

632 634

651| Rename Session Tab | - | 重命名当前活动 Claude 标签页中的会话。需要 Claude Code v2.1.257 或更高版本 |653| Rename Session Tab | - | 重命名当前活动 Claude 标签页中的会话。需要 Claude Code v2.1.257 或更高版本 |

652| Add Session Tab to Group | - | 将当前活动 Claude 标签页中的会话添加到您选择或创建的[会话组](#organize-sessions-into-groups)中。需要 Claude Code v2.1.257 或更高版本 |654| Add Session Tab to Group | - | 将当前活动 Claude 标签页中的会话添加到您选择或创建的[会话组](#organize-sessions-into-groups)中。需要 Claude Code v2.1.257 或更高版本 |

653| Mark Session as Unread | - | 在会话列表中将当前活动 Claude 标签页中的会话标记为未读。需要 Claude Code v2.1.257 或更高版本 |655| Mark Session as Unread | - | 在会话列表中将当前活动 Claude 标签页中的会话标记为未读。需要 Claude Code v2.1.257 或更高版本 |

656| `claude-vscode.toggleDictation` | `Cmd+D` (Mac) / `Ctrl+D` (Windows/Linux) | 开始或停止[语音听写](https://code.claude.com/docs/zh-CN/voice-dictation.md)。该快捷键需要 Claude 处于焦点状态。此命令不在命令面板中 |

654| Show Logs | - | 查看扩展调试日志 |657| Show Logs | - | 查看扩展调试日志 |

655| Logout | - | 注销您的 Anthropic 账户 |658| Logout | - | 注销您的 Anthropic 账户 |

656 659

web-quickstart.md +5 −3

Details

80* **Pro、Max 和 Ultra**：您会自动获得一个名为**Default**的环境。80* **Pro、Max 和 Ultra**：您会自动获得一个名为**Default**的环境。

81* **Team 和 Enterprise**：入门流程显示**Create your first cloud environment**表单。保持预填充的名称和网络访问不变，然后单击**Create & finish**以创建**Default**环境。如果所有者已打开[Quick setup](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise)，入门流程会为您创建**Default**。81* **Team 和 Enterprise**：入门流程显示**Create your first cloud environment**表单。保持预填充的名称和网络访问不变，然后单击**Create & finish**以创建**Default**环境。如果所有者已打开[Quick setup](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md#quick-setup-for-team-and-enterprise)，入门流程会为您创建**Default**。

82 82

83**Default** 使用[`Trusted` 网络访问](https://code.claude.com/docs/zh-CN/cloud-environments#access-levels)：会话可以访问[常见包注册表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)和其他允许列表中的域，以及通过会话网络的其他任何内容都无法访问。有关无需任何配置即可使用的内容，请参阅[已安装的工具](https://code.claude.com/docs/zh-CN/cloud-environments.md#installed-tools)。83**Default** 使用[**Limited** 网络访问](https://code.claude.com/docs/zh-CN/cloud-environments.md#access-levels)：会话可以访问[常见包注册表](https://code.claude.com/docs/zh-CN/cloud-environments.md#default-allowed-domains)和其他允许列表中的域。有关无需任何配置即可使用的内容，请参阅[已安装的工具](https://code.claude.com/docs/zh-CN/cloud-environments.md#installed-tools)。

84 84

85对于第一个项目，**Default** 环境可以按原样使用。要更改其网络访问、添加环境变量或在会话启动前运行[设置脚本](https://code.claude.com/docs/zh-CN/cloud-environments.md#setup-scripts)，请[编辑它或创建其他环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)。85对于第一个项目，**Default** 环境可以按原样使用。要更改其网络访问、添加环境变量或在会话启动前运行[设置脚本](https://code.claude.com/docs/zh-CN/cloud-environments.md#setup-scripts)，请[编辑它或创建其他环境](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)。

86 86

116/web-setup116/web-setup

117```117```

118 118

119确认提示以将您的 `gh` 令牌发送到您的 Claude 账户。成功后，Claude Code 打印 `Connected as <your-github-username>` 并在您的浏览器中打开 [claude.ai/code](https://claude.ai/code)。如果您还没有云环境，`/web-setup` 会创建一个具有 Trusted 网络访问且没有设置脚本的环境。您可以[稍后编辑环境或添加变量](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)。`/web-setup` 完成后，您可以使用 [`--cloud`](https://code.claude.com/docs/zh-CN/claude-code-on-the-web#from-terminal-to-cloud) 从终端启动云会话，或使用 [`/schedule`](https://code.claude.com/docs/zh-CN/routines) 设置定期任务。119确认提示以将您的 `gh` 令牌发送到您的 Claude 账户。成功后，Claude Code 打印 `Connected as <your-github-username>` 并在您的浏览器中打开 [claude.ai/code](https://claude.ai/code)。

120

121如果您还没有云环境，`/web-setup` 会创建一个具有默认 **Limited** 网络访问且没有设置脚本的环境。您可以[稍后编辑环境或添加变量](https://code.claude.com/docs/zh-CN/cloud-environments.md#configure-your-environment)。`/web-setup` 完成后，您可以使用 [`--cloud`](https://code.claude.com/docs/zh-CN/claude-code-on-the-web#from-terminal-to-cloud) 从终端启动云端会话，或使用 [`/schedule`](https://code.claude.com/docs/zh-CN/routines) 设置定期任务。

120 122

121#### 删除 `/web-setup` 令牌123#### 删除 `/web-setup` 令牌

122 124

246 248

247常见原因：249常见原因：

248 250

249* 包安装失败，因为注册表不在您的[网络访问级别](https://code.claude.com/docs/zh-CN/cloud-environments.md#access-levels)中。`Trusted` 涵盖大多数包管理器；`None` 阻止它们全部。251* 包安装失败，因为注册表不在您的[网络访问级别](https://code.claude.com/docs/zh-CN/cloud-environments.md#access-levels)中。勾选了 **Allow package managers** 的 **Limited** 涵盖大多数包管理器；**None** 阻止它们全部。

250* 脚本引用在新鲜克隆中不存在的文件或路径。252* 脚本引用在新鲜克隆中不存在的文件或路径。

251* 在本地工作的命令在 Ubuntu 上需要不同的调用。253* 在本地工作的命令在 Ubuntu 上需要不同的调用。

252 254

whats-new.md +0 −249 deleted

File Deleted View Diff

~~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> Claude Code 功能的每周摘要，包含代码片段、演示和背景信息，说明为什么这些功能很重要。~~

9每周开发摘要突出了最有可能改变您工作方式的功能。每个条目都包括可运行的代码、简短的演示和完整文档的链接。有关每个错误修复和次要改进，请参阅[更新日志](https://code.claude.com/docs/en/changelog.md)。

~~11**Week 37**~~

~~13September 7–11, 2026~~

~~15**`claude plugin eval`**：针对一套测试用例运行您的插件，对结果进行评分，并与无插件基线进行比较。`claude plugin eval init` 为您起草用例和评分器。~~

17本周还有：将任何 **Claude Code Desktop 窗格**弹出到其自己的窗口中，稍后将其停靠回来；**`maxEffortLevel`** 设置限制每个提供商的努力级别；以及 **WebFetch** 在五分钟内未完成下载的页面会失败而不是挂起。

~~19[阅读 Week 37 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w37.md)~~

~~21**Week 36**~~

~~23August 31 – September 4, 2026~~

~~25**Claude Fable 5.1**：在 Claude Code 中可用，具有 1M 令牌上下文窗口。~~

27本周还有：在 Pro 和 Max 计划上，**Desktop 应用中的计算机使用**在 macOS 上在后台工作，同时您继续工作；在全屏渲染中，**`/diff`** 在对话旁边打开一个实时面板，在 Claude 编辑时刷新；**`/skill-doctor`** 显示您每个技能在上下文中的成本以及它被使用的频率。

~~29[阅读 Week 36 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w36.md)~~

~~31**Week 35**~~

~~33August 24–28, 2026~~

~~35**在 Desktop 应用中恢复终端会话**：在 Claude Code Desktop 提示框中键入 `/resume` 以继续您从 CLI 启动的任何会话，保持完整的对话和上下文。~~

37本周还有：**Claude 起草的反馈**在会话中出现问题时让 Claude 编写反馈报告，您审查并从 `/feedback` 发送；**`--restricted`** 启动没有命令运行工具或您的用户和项目设置的会话，用于共享机器上的评估工具；**`modelPicker`** 设置控制 `/model` 选择器列出的模型。

~~39[阅读 Week 35 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w35.md)~~

~~41**Week 34**~~

~~43August 17–21, 2026~~

45**`/design`**：一个研究预览版，将 Claude Design 的画板工作流程引入 CLI 和 Claude Code Desktop，基于 artifacts 构建，因此 Claude 为您的 UI 草拟可编辑的画板并实现您选择的那个。

47本周还有：内置的 **Concise output style** 使 Claude 以结果开头并跳过前言；任何运行 `claude remote-control` 的机器都会在您的手机上显示为 **device card**，以便您可以从 Code 选项卡在其上启动会话；**`ANTHROPIC_DEFAULT_MODEL`** 设置新会话启动的模型。

~~49[阅读 Week 34 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w34.md)~~

~~51**Week 33**~~

~~53August 10–14, 2026~~

55**Desktop 上的使用限制后自动继续**：当您在 Claude Code Desktop 中达到会话限制时，在限制卡上检查 **Auto-continue when limits reset**，应用将在限制重置后重试中断的回合。

57本周还有：**fork mode** 在交互式会话中默认启用，因此 Claude 可以将侧任务交给继承完整对话的子代理；**GitLab** 合并请求 URL 适用于 `--worktree` 和 `claude agents` 视图，市场克隆裸 `gitlab.com` URL；在提示中键入 **`@`** 按名称提及另一个 Claude 会话。

~~59[阅读 Week 33 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w33.md)~~

~~61**Week 32**~~

~~63August 3–7, 2026~~

65**跨会话消息传递**：在 macOS 和 Linux 上，您的 Claude Code 会话现在可以相互发送消息，因此 Claude 可以将发现或决定从一个会话传递到另一个会话，而不是您重新解释它。

67本周还有：**自托管环境**在您的组织运营的基础设施上运行 Claude Code 云会话，在 Team 和 Enterprise 计划上处于公开测试版；**auto mode** 从 8 月 14 日开始成为 Pro、Max 和 Team 计划上新会话的默认权限模式；**VS Code extension** 获得 Focus view。

~~69[阅读 Week 32 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w32.md)~~

~~71**Week 30**~~

~~73July 20–24, 2026~~

~~75**Claude Opus 5**：Claude Code 中的新默认 Opus 模型，具有 1M 令牌上下文窗口和快速模式，每 MTok 费用为 \$10/\$50。~~

77本周还有：**Claude Code Desktop** 在公开测试版中打开 iOS Simulator 窗格，以便 Claude 可以运行您的应用并在您观看时点击浏览它；**Claude Security plugin** 运行您的代码库的多代理漏洞扫描，并将您选择的发现转变为您自己应用的补丁；**`/code-review`** 作为后台子代理运行。

~~79[阅读 Week 30 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w30.md)~~

~~81**Week 29**~~

~~83July 13–17, 2026~~

85**Artifacts 调用您的 MCP 连接器**：已发布的 artifact 可以在查看者打开页面时通过每个查看者自己的 MCP 连接器拉取实时数据并采取行动，本周还添加了公开共享链接、Team 和 Enterprise 上的编辑器角色以及从 Claude Tag 会话创建的 artifacts。

87本周还有：**屏幕阅读器模式**用纯线性文本替换视觉终端界面，适用于 VoiceOver 和 NVDA 等屏幕阅读器；**`/fork`** 将您的对话复制到新的后台会话中，同时您继续工作；**auto mode** 在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上不再需要选择加入变量。

~~89[阅读 Week 29 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w29.md)~~

~~91**Week 28**~~

~~93July 6–10, 2026~~

95**桌面应用内置浏览器**：Claude Code 桌面版获得了内置浏览器，因此 Claude 可以调出文档、设计或任何其他网站，并以与本地开发服务器预览相同的方式与页面交互。

97本周还有：**`/doctor`** 是一个完整的设置检查，可以诊断问题并修复它们，`/checkup` 是其别名；**自动模式**阻止成绩单篡改，并在未解决的变量上在 `rm -rf` 之前询问；**代理视图行**显示彩色状态词和分类器编写的标题。

~~99[阅读 Week 28 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w28.md)~~

~~100~~

101**Week 27**

~~102~~

103June 29 – July 3, 2026

~~104~~

105**Claude Sonnet 5**：Pro、Team Standard 和 Enterprise 订阅席位的新默认模型，具有顶级编码和工具使用能力，采用 Sonnet 定价，原生 1M 令牌上下文窗口，默认启用自适应思考。

~~106~~

107本周还有：**Chrome 中的 Claude** 在所有直接 Anthropic 计划上正式推出；**子代理默认在后台运行**，以便 Claude 在它们运行时继续工作；**Claude Desktop on Linux** 在 Ubuntu 和 Debian 上进入测试版；**`/radio`** 调入 Claude FM lo-fi 电台。

~~108~~

109[阅读 Week 27 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w27.md)

~~110~~

111**Week 26**

~~112~~

113June 22–26, 2026

~~114~~

115**`claude mcp login`**：从您的 shell 中验证配置的 MCP 服务器，而不是使用交互式 `/mcp` 菜单，稍后可以使用 `claude mcp logout` 清除其存储的凭证。

~~116~~

117本周还有：**shell 模式响应命令输出**（`! npm test` 无需第二个提示即可获得解释）；**`/rewind`** 可以从运行 `/clear` 之前恢复对话；**后台子代理**现在在主会话中显示权限提示，而不是自动拒绝。

~~118~~

119[阅读 Week 26 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w26.md)

~~120~~

121**Week 25**

~~122~~

123June 15–19, 2026

~~124~~

125**Artifacts**：将会话的输出转换为 claude.ai 上的实时、可共享页面，在会话工作时原地更新，现在在 Team 和 Enterprise 计划中处于测试版。

~~126~~

127本周还有：**拒绝和询问规则与工具参数匹配**，使用 `Tool(param:value)`，例如 `Agent(model:opus)`；**`/config key=value`** 从提示、`-p` 模式和远程控制中设置任何设置；**自动模式阻止破坏性 git 命令**，当您没有要求丢弃本地工作时。

~~128~~

129[阅读 Week 25 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w25.md)

~~130~~

131**Week 24**

~~132~~

133June 8–12, 2026

~~134~~

135**`/cd`**：在对话中途将当前会话移动到新的工作目录，无需重建提示缓存。

~~136~~

137本周还有：**子代理可以生成自己的子代理**（后台链最多五层深）；**`--safe-mode`** 启动 Claude Code 时禁用所有自定义以进行故障排除；**`fallbackModel`** 配置最多三个按顺序尝试的备用模型。

~~138~~

139[阅读 Week 24 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w24.md)

~~140~~

141**Week 23**

~~142~~

143June 1–5, 2026

~~144~~

145**Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上的 Auto mode**：auto mode 现在在第三方提供商上可用，支持 Opus 4.7 和 Opus 4.8，用后台安全检查替换权限提示。

~~146~~

147本周还有：**更安全的自动编辑**在 `acceptEdits` 模式下写入可以运行代码的文件前提示；**`/plugin list`** 内联打印您安装的插件；**版本要求**让托管部署要求批准的 Claude Code 版本范围。

~~148~~

149[阅读 Week 23 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w23.md)

~~150~~

151**Week 22**

~~152~~

153May 25–29, 2026

~~154~~

155**Claude Opus 4.8**：Max、Team Premium、Enterprise 按需付费和 Anthropic API 账户的新默认模型，默认情况下高努力级别，对于最困难的任务使用 `/effort xhigh`。

~~156~~

157本周还有：**动态工作流**从 Claude 编写的脚本中编排数十到数百个子代理；**security-guidance plugin** 在 Claude 工作时审查其更改以查找漏洞；**快速模式**在 Opus 4.8 上运行，每 MTok 费用为 \$10/\$50。

~~158~~

159[阅读 Week 22 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w22.md)

~~160~~

161**Week 21**

~~162~~

163May 18–22, 2026

~~164~~

165**Pro 计划上的 Auto mode**：auto mode 现在在 Pro 账户上运行，支持 Sonnet 4.6 和 Opus，用后台安全检查替换权限提示。

~~166~~

167本周还有：**`/usage`** 按 skill、subagent、plugin 和 MCP server 分解驱动您计划限制的因素；新的 **`/code-review`** 命令报告正确性错误；**后台会话**出现在 `/resume` 中，固定时保持活跃。

~~168~~

169[阅读 Week 21 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w21.md)

~~170~~

171**Week 20**

~~172~~

173May 11–15, 2026

~~174~~

175**Agent view**：`claude agents` 为每个 Claude Code 会话打开一个屏幕，显示正在运行的内容、被您阻止的内容以及已完成的内容。

~~176~~

177本周还有：**`/goal`** 让 Claude 在多个回合中继续工作，直到满足完成条件；**快速模式**现在默认在 Opus 4.7 上运行；**Rewind 菜单**可以使用"Summarize up to here"压缩早期上下文。

~~178~~

179[阅读 Week 20 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w20.md)

~~180~~

181**Week 19**

~~182~~

183May 4–8, 2026

~~184~~

185**插件从 `.zip` 存档和 URL 加载**：`--plugin-dir` 现在接受 `.zip` 文件，`--plugin-url` 为当前会话获取插件存档。

~~186~~

187本周还有：**`worktree.baseRef`** 选择新的 worktrees 是从远程默认分支还是本地 `HEAD` 分支；**auto mode 硬拒绝规则**无条件阻止操作，无论允许例外如何；**hooks 看到活跃的努力级别**通过 `effort.level` 和 `$CLAUDE_EFFORT`。

~~188~~

189[阅读 Week 19 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w19.md)

~~190~~

191**Week 18**

~~192~~

193April 27 – May 1, 2026

~~194~~

195**没有 Git Bash 的 Windows**：不再需要 Git for Windows，当 Bash 不存在时，Claude Code 使用 PowerShell 作为 shell 工具。

~~196~~

197本周还有：**`claude ultrareview`** 将云代码审查带到 CI 和脚本；**`claude project purge`** 清理项目的本地状态；将 **PR URL 粘贴到 `/resume`** 中找到创建它的会话。

~~198~~

199[阅读 Week 18 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w18.md)

~~200~~

201**Week 17**

~~202~~

203April 20–24, 2026

~~204~~

205**`/ultrareview`** 作为公开研究预览版开放：一队错误搜寻代理在云中运行，发现结果会自动返回到您的 CLI 或桌面应用。

~~206~~

207本周还有：**会话回顾**显示终端失焦时发生的情况；**自定义主题**让您可以从 `/theme` 或插件构建和发布调色板；**Claude Code 网页版**进行了重新设计，包括新的会话侧边栏和拖放布局。

~~208~~

209[阅读 Week 17 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w17.md)

~~210~~

211**Week 16**

~~212~~

213April 13–17, 2026

~~214~~

215**Claude Opus 4.7** 成为 Max 和 Team Premium 的新默认版本，具有新的 `xhigh` 努力级别（推荐用于大多数编码工作）和交互式 `/effort` 滑块来调整它。

~~216~~

217本周还有：**Routines** 在 Claude Code 网页版上从计划、GitHub 事件或 API 调用触发模板化云代理；**移动推送通知**在长任务完成或 Claude 需要您时向您的手机发送通知；`/usage` 显示驱动您限制的因素；CLI 迁移到本机二进制文件。

~~218~~

219[阅读 Week 16 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w16.md)

~~220~~

221**Week 15**

~~222~~

223April 6–10, 2026

~~224~~

225**Ultraplan** 进入早期预览：从您的 CLI 在云中草拟计划，在网页编辑器中审查和评论，然后远程运行或拉回本地。第一次运行现在会自动为您创建云环境。

~~226~~

227本周还有：**Monitor** 工具将后台事件流式传输到对话中，以便 Claude 可以跟踪日志并实时响应，`/loop` 在您省略间隔时自动调整速度，`/team-onboarding` 将您的设置打包成可重放的指南，`/autofix-pr` 从您的终端打开 PR 自动修复。

~~228~~

229[阅读 Week 15 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w15.md)

~~230~~

231**Week 14**

~~232~~

233March 30 – April 3, 2026

~~234~~

235**计算机使用**在研究预览版中来到 CLI：Claude 可以打开本机应用、点击 UI 并从您的终端验证更改。最适合关闭只有 GUI 才能验证的事情。

~~236~~

237本周还有：`/powerup` 交互式课程、无闪烁的替代屏幕渲染、每个工具的 MCP 结果大小覆盖（最高 500K）和 Bash 工具 `PATH` 上的插件可执行文件。

~~238~~

239[阅读 Week 14 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w14.md)

~~240~~

241**Week 13**

~~242~~

243March 23–27, 2026

~~244~~

245**Auto mode** 在研究预览版中推出：分类器处理您的权限提示，以便安全操作无中断运行，风险操作被阻止。这是批准所有内容和 `--dangerously-skip-permissions` 之间的中间地带。

~~246~~

247本周还有：桌面应用中的计算机使用、Web 上的 PR 自动修复、使用 `/` 的成绩单搜索、适用于 Windows 的本机 PowerShell 工具和条件 `if` hooks。

~~248~~

249[阅读 Week 13 摘要 →](https://code.claude.com/docs/zh-CN/whats-new/2026-w13.md)

whats-new/2026-w13.md +0 −118 deleted

File Deleted View Diff

~~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# 第13周 · 2026年3月23–27日~~

~~7> 自动模式用于免提权限、内置计算机使用、云端PR自动修复、转录搜索和Windows PowerShell工具。~~

~~9发布版本 [v2.1.83 → v2.1.85](https://code.claude.com/docs/en/changelog.md#2-1-83)~~

~~106项功能 · 3月23–27日~~

~~12自动模式~~

~~13研究预览~~

15自动模式将您的权限提示交给分类器处理。安全的编辑和命令无需中断即可运行；任何破坏性或可疑的操作都会被阻止并显示。这是批准每个文件写入和使用 `--dangerously-skip-permissions` 运行之间的折中方案。

17![Claude Code 提示页脚显示黄色的'自动模式开启（Shift+Tab切换）'指示器](https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/auto-mode.png?fit=max\&auto=format\&n=CfffsX01JHFnIKvD\&q=85\&s=367c9e9d4ba5bc57ec4b935154bf1fbb)

~~19使用 Shift+Tab 切换到自动模式，或将其设置为默认值：~~

~~21```json ~/.claude/settings.json {3} theme={null}~~

~~22{~~

~~23 "permissions": {~~

~~24 "defaultMode": "auto"~~

~~25 }~~

~~26}~~

~~27```~~

~~29[权限模式指南](https://code.claude.com/docs/zh-CN/permission-modes.md)~~

~~31计算机使用~~

~~32Desktop~~

34Claude 现在可以从 Claude Code Desktop 应用控制您的实际桌面：打开原生应用、点击 iOS 模拟器、驱动硬件控制面板，并验证屏幕上的更改。默认情况下它是关闭的，每次操作前都会询问。最适合用于其他方法无法到达的事情：没有 API 的应用、专有工具、任何仅作为 GUI 存在的东西。

36![Claude Desktop 设置，计算机使用切换已启用，显示允许 Claude 在您允许的应用中截屏和控制键盘和鼠标的选项](https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/computer-use.png?fit=max\&auto=format\&n=CfffsX01JHFnIKvD\&q=85\&s=d631de2017edafff463505f8ddbc0f51)

~~38在设置中启用它，授予操作系统权限，然后要求 Claude 端到端验证更改：~~

~~40```text title="Claude Code" wrap theme={null}~~

~~41打开 iOS 模拟器，点击完成入门流程，并对每个步骤进行截屏~~

~~42```~~

~~44[计算机使用指南](https://code.claude.com/docs/zh-CN/desktop.md#let-claude-use-your-computer)~~

~~46PR 自动修复~~

~~47Web~~

~~49打开 PR 时切换开关然后离开。Claude 监视 CI，修复失败，处理细节，并推送直到通过。不再需要通过六轮 lint 错误来照看 PR。~~

51![Claude Code web CI 面板显示自动修复切换已启用，描述为'主动修复 CI 失败和审查评论'](https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/auto-fix.png?fit=max\&auto=format\&n=CfffsX01JHFnIKvD\&q=85\&s=c62b181c6c5d96929f0b43525f9f3584)

~~53在 Claude Code web 上创建 PR 后，在 CI 面板中切换自动修复。~~

~~55[自动修复拉取请求](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md#auto-fix-pull-requests)~~

~~57转录搜索~~

~~58v2.1.83~~

~~60在转录模式中按 `/` 搜索您的对话。`n` 和 `N` 逐步浏览匹配项。最后有办法找到 Claude 在 400 条消息前运行的那个 Bash 命令。~~

~~62打开转录模式并搜索：~~

~~64```text Claude Code theme={null}~~

~~65Ctrl+O # 打开转录~~

~~66/migrate # 搜索"migrate"~~

~~67n # 下一个匹配项~~

~~68N # 上一个匹配项~~

~~69```~~

~~71[全屏指南](https://code.claude.com/docs/zh-CN/fullscreen.md#search-and-review-the-conversation)~~

~~73PowerShell 工具~~

~~74预览~~

~~75v2.1.84~~

~~77Windows 获得了与 Bash 并行的原生 PowerShell 工具。Claude 可以运行 cmdlet、管道对象，并使用 Windows 原生路径，无需通过 Git Bash 翻译所有内容。~~

~~79从设置中选择加入：~~

~~81```json .claude/settings.json {3} theme={null}~~

~~82{~~

~~83 "env": {~~

~~84 "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"~~

~~85 }~~

~~86}~~

~~87```~~

~~89[PowerShell 工具文档](https://code.claude.com/docs/zh-CN/tools-reference.md#powershell-tool)~~

~~91条件 hooks~~

~~92v2.1.85~~

~~94Hooks 现在可以使用权限规则语法声明 `if` 字段。您的 pre-commit 检查仅针对 `Bash(git commit *)` 生成，而不是每个 bash 调用，减少繁忙会话中的进程开销。~~

~~96将 hook 限制为仅 git 提交：~~

~~98```json .claude/settings.json {5} theme={null}~~

~~99{~~

100 "hooks": {

101 "PreToolUse": [{

102 "hooks": [{

103 "if": "Bash(git commit *)",

104 "type": "command",

105 "command": ".claude/hooks/lint-staged.sh"

106 }]

107 }]

108 }

109}

110```

~~111~~

112[Hooks 参考](https://code.claude.com/docs/zh-CN/hooks.md)

~~113~~

114其他亮点

~~115~~

116Plugin `userConfig` 现已公开：在启用时提示设置，钥匙串支持的密钥粘贴的图像插入 `[Image #N]` 芯片，您可以按位置引用`managed-settings.d/` 分层策略片段的 drop-in 目录`CwdChanged` 和 `FileChanged` hook 事件用于 direnv 风格的设置Agents 可以在 frontmatter 中声明 `initialPrompt` 以自动提交第一轮`Ctrl+X Ctrl+E` 打开您的外部编辑器，匹配 readline在任何响应前中断会自动恢复您的输入`/status` 现在在 Claude 响应时也能工作深层链接在您首选的终端中打开，而不是首次检测到的离开 75+ 分钟后的空闲返回提示到 `/clear`VS Code：速率限制横幅，Esc 两次倒带选择器

~~117~~

118[v2.1.83–v2.1.85 完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-83)

whats-new/2026-w14.md +0 −98 deleted

File Deleted View Diff

~~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# 第 14 周 · 3 月 30 日 – 4 月 3 日，2026 年~~

~~7> CLI 中的计算机使用、交互式产品内课程、无闪烁渲染、按工具 MCP 结果大小覆盖以及 PATH 上的插件可执行文件。~~

~~9发布版本 [v2.1.86 → v2.1.91](https://code.claude.com/docs/en/changelog.md#2-1-86)~~

~~105 项功能 · 3 月 30 日 – 4 月 3 日~~

~~12CLI 中的计算机使用~~

~~13研究预览~~

15上周计算机使用功能登陆了桌面应用。本周它进入了 CLI：Claude 可以打开原生应用、点击 UI、测试自己的更改，以及修复损坏的内容，所有这些都可以从你的终端完成。Web 应用已经有验证循环；原生 iOS、macOS 和其他仅限 GUI 的应用没有。现在有了。最适合在没有 API 可调用的应用和工具上闭合循环。仍处于早期阶段；预期会有粗糙的边缘。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/cli-computer-use.mp4?fit=max&auto=format&n=CfffsX01JHFnIKvD&q=85&s=c17a337902308d7c9121013ded0494db" />

~~19需要 macOS 和 Pro 或 Max 计划；否则，`computer-use` 不会出现在 `/mcp` 中。运行 `/mcp`，找到 `computer-use`，然后将其打开。然后要求 Claude 端到端验证更改：~~

~~21```text title="Claude Code" wrap theme={null}~~

~~22Open the iOS simulator, tap through onboarding, and screenshot each step~~

~~23```~~

~~25[计算机使用指南](https://code.claude.com/docs/zh-CN/computer-use.md)~~

~~27/powerup~~

~~28v2.1.90~~

30交互式课程，通过动画演示教授 Claude Code 功能，直接在你的终端内进行。Claude Code 发布频繁，上个月会改变你工作方式的功能可能会被遗漏。运行一次 `/powerup`，你就会知道有什么功能。

32<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/powerup.mp4?fit=max&auto=format&n=CfffsX01JHFnIKvD&q=85&s=fb88beddc0ecc8029da5ab029e4b28f1" />

~~34运行它：~~

~~36```text title="Claude Code" wrap theme={null}~~

~~37/powerup~~

~~38```~~

~~40[命令参考](https://code.claude.com/docs/zh-CN/commands.md)~~

~~42无闪烁渲染~~

~~43v2.1.89~~

45选择加入新的替代屏幕渲染器，具有虚拟化的回滚。提示输入保持固定在底部，鼠标选择可跨长对话工作，重绘时的闪烁消失了。取消设置 `CLAUDE_CODE_NO_FLICKER` 以回滚。

47<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/CfffsX01JHFnIKvD/images/whats-new/flicker-free.mp4?fit=max&auto=format&n=CfffsX01JHFnIKvD&q=85&s=7719e35e52a3f9734b0cf69edac333ad" />

~~49设置环境变量并重启 Claude Code：~~

~~51```bash theme={null}~~

~~52export CLAUDE_CODE_NO_FLICKER=1~~

~~53claude~~

~~54```~~

~~56[全屏渲染](https://code.claude.com/docs/zh-CN/fullscreen.md)~~

~~58MCP 结果大小覆盖~~

~~59v2.1.91~~

61MCP 服务器作者现在可以通过在工具的 `tools/list` 条目中设置 `anthropic/maxResultSizeChars` 来提高特定工具的截断上限，最高可达 500K 字符的硬上限。上限曾经是全局的，所以偶尔返回数据库架构或完整文件树等固有大型有效负载的工具会达到默认限制，并被持久化到磁盘，带有文件引用。按工具覆盖在工具真正需要时将这些结果保持内联。

~~63在你的服务器的 `tools/list` 响应中注释工具：~~

~~65```json highlight={5} theme={null}~~

~~66{~~

~~67 "name": "get_schema",~~

~~68 "description": "Returns the full database schema",~~

~~69 "_meta": {~~

~~70 "anthropic/maxResultSizeChars": 500000~~

~~71 }~~

~~72}~~

~~73```~~

~~75[MCP 参考](https://code.claude.com/docs/zh-CN/mcp.md#raise-the-limit-for-a-specific-tool)~~

~~77PATH 上的插件可执行文件~~

~~78v2.1.91~~

80在插件根目录的 `bin/` 目录中放置可执行文件，Claude Code 会在启用插件时将该目录添加到 Bash 工具的 `PATH`。Claude 随后可以从任何 Bash 工具调用中将二进制文件作为裸命令调用，无需绝对路径或包装脚本。便于将 CLI 助手与调用它们的命令、代理和钩子一起打包。

~~82在插件根目录添加 `bin/` 目录：~~

~~84```text highlight={4, 5} theme={null}~~

~~85my-plugin/~~

~~86├── .claude-plugin/~~

~~87│ └── plugin.json~~

~~88└── bin/~~

~~89 └── my-tool~~

~~90```~~

~~92[插件参考](https://code.claude.com/docs/zh-CN/plugins/manifest-reference.md#standard-layout)~~

~~94其他成就~~

96自动模式后续：新的 `PermissionDenied` 钩子在分类器拒绝时触发（返回 `retry: true` 让 Claude 尝试不同的方法），`/permissions` → 最近拒绝让你用 `r` 手动重试`PreToolUse` 钩子中 `permissionDecision` 的新 `defer` 值：`-p` 会话在工具调用处暂停并以 `deferred_tool_use` 有效负载退出，以便 SDK 应用或自定义 UI 可以显示它，然后用 `--resume` 恢复`/buddy`：孵化一个小生物来观看你编码。一个愚人节玩笑，不再可用`disableSkillShellExecution` 设置阻止来自技能、斜杠命令和插件命令的内联 shell编辑工具现在可以在通过 `cat` 或 `sed -n` 查看的文件上工作，无需单独的读取超过 50K 的钩子输出保存到磁盘，带有路径和预览，而不是注入到上下文中思考摘要在交互式会话中默认关闭（`showThinkingSummaries: true` 以恢复）语音模式：按住说话修饰符组合、Windows WebSocket、macOS Apple Silicon 麦克风权限`claude-cli://` 深层链接接受多行提示（编码 `%0A`）

~~98[v2.1.86–v2.1.91 的完整更改日志 →](https://code.claude.com/docs/en/changelog.md#2-1-86)~~

whats-new/2026-w15.md +0 −80 deleted

File Deleted View Diff

~~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# 第15周 · 2026年4月6–10日~~

~~7> Ultraplan 云规划、具有自适应 /loop 的 Monitor 工具、用于打包设置的 /team-onboarding 以及从终端运行的 /autofix-pr。~~

~~9发布版本 [v2.1.92 → v2.1.101](https://code.claude.com/docs/en/changelog.md#2-1-92)~~

~~104 项功能 · 4月6–10日~~

~~12Ultraplan~~

~~13研究预览~~

15从终端在云中启动 Plan Mode，然后在浏览器中查看结果。Claude 在网络会话的 Claude Code 中起草计划，同时您的终端保持空闲；准备好后，您可以对各个部分进行评论、请求修订，并选择远程执行或将其发送回 CLI。从 v2.1.101 开始，首次运行会自动创建默认云环境，因此在尝试之前无需进行网络设置步骤。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/aFXPQxiBOW99MHS3/images/whats-new/ultraplan.mp4?fit=max&auto=format&n=aFXPQxiBOW99MHS3&q=85&s=e8f2f23730c6a5c289dbf3e7b13eadf6" />

~~19运行命令，或在任何提示中包含关键字：~~

~~21```text title="Claude Code" wrap theme={null}~~

~~22/ultraplan migrate the auth service from sessions to JWTs~~

~~23```~~

~~25[Ultraplan 指南](https://code.claude.com/docs/zh-CN/ultraplan)~~

~~27Monitor 工具~~

~~28v2.1.98~~

30一个新的内置工具，可生成后台监视程序并将其事件流式传输到对话中：每个事件都作为新的转录消息出现，Claude 立即对其做出反应。跟踪训练运行、监督 PR 的 CI，或在开发服务器崩溃发生时立即自动修复，所有这些都无需 Bash sleep 循环占用回合。

32<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/aFXPQxiBOW99MHS3/images/whats-new/monitor-tool.mp4?fit=max&auto=format&n=aFXPQxiBOW99MHS3&q=85&s=f4156c15a0999de5c5157f54a3117c89" />

~~34要求 Claude 在您继续工作时监视某些内容：~~

~~36```text title="Claude Code" wrap theme={null}~~

~~37Tail server.log in the background and tell me the moment a 5xx shows up~~

~~38```~~

~~40这与 `/loop` 配对，现在可自适应：省略间隔，Claude 会根据任务安排下一个时刻，或使用 Monitor 工具完全跳过轮询。~~

~~42```text title="Claude Code" wrap theme={null}~~

~~43/loop check CI on my PR~~

~~44```~~

~~46[Monitor 工具参考](https://code.claude.com/docs/zh-CN/tools-reference.md#monitor-tool)~~

~~48/autofix-pr~~

~~49CLI~~

51PR 自动修复在第 13 周登陆网络。现在您可以在不离开终端的情况下启用它：`/autofix-pr` 推断当前分支的开放 PR 并在一个步骤中为其启用 Claude Code on the web 上的自动修复。推送您的分支，运行命令，然后离开；Claude 监视 CI 和审查评论并推送修复，直到它变为绿色。

53<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/aFXPQxiBOW99MHS3/images/whats-new/autofix-pr.mp4?fit=max&auto=format&n=aFXPQxiBOW99MHS3&q=85&s=95f191eb4711130a128aec3f6b720527" />

~~55从 PR 的分支运行它：~~

~~57```text title="Claude Code" wrap theme={null}~~

~~58/autofix-pr~~

~~59```~~

~~61[自动修复拉取请求](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md#auto-fix-pull-requests)~~

~~63/team-onboarding~~

~~64v2.1.101~~

66从您的本地 Claude Code 使用情况生成团队成员快速入门指南。在您熟悉的项目中运行它，并将输出交给新团队成员，以便他们可以重放您的设置，而不是从默认值开始。

~~68在您花费了真实时间的项目中运行它：~~

~~70```text title="Claude Code" wrap theme={null}~~

~~71/team-onboarding~~

~~72```~~

~~74[命令参考](https://code.claude.com/docs/zh-CN/commands.md)~~

~~76其他亮点~~

78焦点视图：在无闪烁模式下按 `Ctrl+O` 将视图折叠到您的最后一个提示、单行工具摘要（带有 diffstats）和 Claude 的最终响应登录屏幕上的引导式 [Amazon Bedrock](https://code.claude.com/docs/zh-CN/amazon-bedrock.md) 和 [Google Cloud 的 Agent Platform](https://code.claude.com/docs/zh-CN/google-vertex-ai.md) 设置向导：选择"第三方平台"进行分步身份验证、区域、凭证检查和模型固定`/agents` 获得选项卡式布局：Running 选项卡显示带有 `● N running` 计数的实时子代理，以及库选项卡中的 Run agent 和 View running instance 操作默认工作量级别现在对 API 密钥、Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、Team 和 Enterprise 用户为 `high`（使用 `/effort` 控制）`/cost` 为订阅用户显示按模型和缓存命中的分解`/release-notes` 现在是交互式版本选择器状态行：新的 `refreshInterval` 设置每 N 秒重新运行命令，JSON 输入中的 `workspace.git_worktree``CLAUDE_CODE_PERFORCE_MODE`：Edit/Write 在只读文件上失败，并显示 `p4 edit` 提示，而不是静默覆盖OS CA 证书存储现在默认受信任，因此企业 TLS 代理无需额外设置即可工作（`CLAUDE_CODE_CERT_STORE=bundled` 选择退出）由 Mantle 提供支持的 Amazon Bedrock：设置 `CLAUDE_CODE_USE_MANTLE=1`强化的 Bash 工具权限：反斜杠转义标志、环境变量前缀、`/dev/tcp` 重定向和复合命令现在正确提示`UserPromptSubmit` hooks 可以通过 `hookSpecificOutput.sessionTitle` 设置会话标题

~~80[v2.1.92–v2.1.101 的完整更改日志 →](https://code.claude.com/docs/en/changelog.md#2-1-92)~~

whats-new/2026-w16.md +0 −89 deleted

File Deleted View Diff

~~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# 第 16 周 · 2026 年 4 月 13–17 日~~

7> Claude Opus 4.7 配备新的 xhigh 努力级别、Claude Code 网页版上的 Routines、移动推送通知在 Claude 需要您时 ping 您的手机、显示限制驱动因素的 /usage 分解，以及替代捆绑 JavaScript 的原生二进制文件。

~~9发布版本 [v2.1.105 → v2.1.113](https://code.claude.com/docs/en/changelog.md#2-1-105)~~

~~105 项功能 · 4 月 13–17 日~~

~~12Claude Opus 4.7~~

~~13新模型~~

15Anthropic 最强大的编码模型现在是 Max 和 Team Premium 的默认模型，也可以从 `/model` 在其他地方使用。它添加了一个新的 `xhigh` 努力级别，位于 `high` 和 `max` 之间：为大多数编码和代理任务提供最佳结果，在您第一次切换到 4.7 时应用为默认值。`/effort` 现在在您不带参数调用它时打开一个交互式箭头键滑块，因此您可以在不记住级别名称的情况下平衡智能与速度。

~~17一次性切换模型和努力级别：~~

~~19```text Claude Code theme={null}~~

~~20> /model opus~~

~~21> /effort xhigh~~

~~22```~~

~~24[模型配置：努力级别](https://code.claude.com/docs/zh-CN/model-config.md#adjust-effort-level)~~

~~26Routines~~

~~27web~~

29模板化云代理，按计划、GitHub 事件或 API 调用触发。在 Claude Code 网页版上定义一次例程，包括提示、它可以接触的仓库和它需要的连接器，然后让 PR 打开、发布发布或您自己的 webhook 在您的机器不运行的情况下触发它。触发选择器现在涵盖 GitHub 事件和可选过滤器，并为每个例程提供一个令牌化的 `/fire` 端点供外部系统使用。

31![在 Claude Code 网页版上创建具有计划、GitHub 事件和 API 触发器的例程](https://mintcdn.com/claude-code/FTi4SBJ9YRs7d-5X/images/whats-new/routines.png?fit=max\&auto=format\&n=FTi4SBJ9YRs7d-5X\&q=85\&s=2ba818ea9280c549511cb48b9b4d1dc5)

~~33从网页 UI 创建一个，或从您的终端搭建：~~

~~35```text Claude Code theme={null}~~

~~36> /schedule daily PR review at 9am~~

~~37```~~

~~39[Routines 指南](https://code.claude.com/docs/zh-CN/routines.md)~~

~~41/usage breakdown~~

~~42CLI~~

44更好地了解您的 Claude Code 使用情况。`/usage` 现在显示驱动您的限制的因素：并行会话、子代理、缓存未命中和长上下文，每个都显示过去 24 小时的百分比和优化提示。按 `d` 或 `w` 在日视图和周视图之间切换。

46![/usage 命令显示对限制使用的贡献分解](https://mintcdn.com/claude-code/FTi4SBJ9YRs7d-5X/images/whats-new/usage.png?fit=max\&auto=format\&n=FTi4SBJ9YRs7d-5X\&q=85\&s=792a4b43cbef4e2931974831f076bca6)

~~48随时运行它：~~

~~50```text Claude Code theme={null}~~

~~51> /usage~~

~~52```~~

~~54[命令参考](https://code.claude.com/docs/zh-CN/commands.md)~~

~~56移动推送通知~~

~~57mobile~~

59连接了 [Remote Control](https://code.claude.com/docs/zh-CN/remote-control.md)，Claude 可以在长任务完成或需要决定继续时向您的手机发送推送通知。在 `/config` 中使用"Claude 决定时推送"打开它，或在您的提示中请求一个。当您启动长代理运行并想离开终端时很有用。

61<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/uII1TETOZxBUZ3lB/images/whats-new/push-notifications.mp4?fit=max&auto=format&n=uII1TETOZxBUZ3lB&q=85&s=c91a967139596500cbdb581a53822ac1" />

~~63要求 Claude 在完成时 ping 您：~~

~~65```text Claude Code theme={null}~~

~~66> notify me when the tests pass~~

~~67```~~

~~69[Remote Control：移动推送通知](https://code.claude.com/docs/zh-CN/remote-control.md#mobile-push-notifications)~~

~~71原生二进制文件~~

~~72v2.1.113~~

74`claude` CLI 现在生成原生的每平台二进制文件，而不是捆绑的 JavaScript，因此已安装的 `claude` 命令不再调用 Node。npm 包通过可选依赖项（如 `@anthropic-ai/claude-code-darwin-arm64`）拉入正确的二进制文件，因此您的安装命令不会改变。独立安装程序已经提供了此二进制文件；npm 现在与其匹配。

~~76升级并检查您正在运行的内容：~~

~~78```bash theme={null}~~

~~79claude update~~

~~80claude --version~~

~~81```~~

~~83[设置指南](https://code.claude.com/docs/zh-CN/setup.md)~~

~~85其他亮点~~

87新的 [`/ultrareview`](https://code.claude.com/docs/zh-CN/ultrareview)：使用并行多代理分析和对抗性批评通过在云中进行全面代码审查。不带参数运行它来审查您当前的分支，或 `/ultrareview <PR#>` 来审查特定 PR[自动模式](https://code.claude.com/docs/zh-CN/permission-modes.md#eliminate-prompts-with-auto-mode)现在可供 Max 订阅者在 Opus 4.7 上使用，`--enable-auto-mode` 标志不再需要[会话回顾](https://code.claude.com/docs/zh-CN/interactive-mode.md#session-recap)显示您离开时发生的一行摘要；按需运行 `/recap` 或从 `/config` 关闭它新的 `/tui` 命令和 `tui` 设置在对话中间切换经典和无闪烁渲染；焦点视图从 `Ctrl+O` 移至其自己的 `/focus` 命令插件可以通过顶级 `monitors` 清单键提供后台监视器，在会话启动或技能调用时自动启用`/theme` 中的"自动（匹配终端）"选项遵循您的终端的深色/浅色模式`/fewer-permission-prompts` 扫描您的记录以查找常见的只读 Bash 和 MCP 调用，并为 `.claude/settings.json` 提议一个允许列表Claude 现在可以通过 Skill 工具发现并运行内置命令，如 `/init`、`/review` 和 `/security-review``PreCompact` hooks 可以通过以代码 2 退出或返回 `{"decision":"block"}` 来阻止压缩`ENABLE_PROMPT_CACHING_1H` 选择 API 密钥、Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 用户进入 1 小时提示缓存 TTL`sandbox.network.deniedDomains` 设置从更广泛的 `allowedDomains` 通配符中分离特定域`/undo` 现在是 `/rewind` 的别名，`/proactive` 是 `/loop` 的别名强化的 Bash 权限：拒绝规则现在通过 `env`/`sudo`/`watch` 包装器匹配，`Bash(find:*)` 允许规则不再自动批准 `-exec` 或 `-delete`

~~89[v2.1.105–v2.1.113 的完整更改日志 →](https://code.claude.com/docs/en/changelog.md#2-1-105)~~

whats-new/2026-w17.md +0 −74 deleted

File Deleted View Diff

~~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# 第17周 · 2026年4月20–24日~~

~~7> /ultrareview 作为研究预览版开放，返回终端时自动生成会话摘要，可以在插件中构建和发布自定义颜色主题，以及重新设计的网页版 Claude Code。~~

~~9发布版本 [v2.1.114 → v2.1.119](https://code.claude.com/docs/en/changelog.md#2-1-114)~~

~~104 项功能 · 4月20–24日~~

~~12/ultrareview~~

~~13research preview~~

15现已公开研究预览版。Ultrareview 在云中针对您的分支或 PR 运行一队 bug 搜寻代理，发现的问题会自动返回到 CLI 或桌面应用。在合并关键更改（如身份验证或数据迁移）之前运行它。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/FTi4SBJ9YRs7d-5X/images/whats-new/ultrareview.mp4?fit=max&auto=format&n=FTi4SBJ9YRs7d-5X&q=85&s=0fb1271365d38f414ad155aeb8edb08e" />

~~19审查您当前所在的分支：~~

~~21```text Claude Code theme={null}~~

~~22> /ultrareview~~

~~23```~~

~~25或将其指向 PR：~~

~~27```text Claude Code theme={null}~~

~~28> /ultrareview 1234~~

~~29```~~

~~31[Ultrareview 指南](https://code.claude.com/docs/zh-CN/ultrareview.md)~~

~~33会话摘要~~

~~34CLI~~

~~36将焦点从会话转移开，然后返回时会看到一行摘要，说明您离开期间发生了什么。在同时运行多个 Claude 会话时，有助于保持工作流程。~~

38<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/FTi4SBJ9YRs7d-5X/images/whats-new/session-recap.mp4?fit=max&auto=format&n=FTi4SBJ9YRs7d-5X&q=85&s=0a8db1470bd0161a47efeb2f322af76f" />

~~40按需生成摘要，或从 `/config` 关闭自动摘要：~~

~~42```text Claude Code theme={null}~~

~~43> /recap~~

~~44```~~

~~46[交互模式：会话摘要](https://code.claude.com/docs/zh-CN/interactive-mode.md#session-recap)~~

~~48自定义主题~~

~~49v2.1.118~~

51从 `/theme` 构建和切换命名颜色主题，或在 `~/.claude/themes/` 中手动编辑 JSON 文件。每个主题选择一个基础预设，并仅覆盖您关心的令牌。插件也可以附带主题。

~~53打开主题选择器并创建新主题：~~

~~55```text Claude Code theme={null}~~

~~56> /theme~~

~~57```~~

~~59[终端配置：创建自定义主题](https://code.claude.com/docs/zh-CN/terminal-config.md#create-a-custom-theme)~~

~~61网页版 Claude Code~~

~~62web~~

64[claude.ai/code](https://claude.ai/code) 的新外观与重新设计的桌面应用相匹配：会话侧边栏、拖放布局和刷新的例程视图。关键部分已重建，以实现更快的响应和更可靠的体验。

66![网页版 Claude Code 重新设计概览：新 UI、速度和可靠性、跨网页、移动和 CLI 工作](https://mintcdn.com/claude-code/FTi4SBJ9YRs7d-5X/images/whats-new/web-redesign.jpeg?fit=max\&auto=format\&n=FTi4SBJ9YRs7d-5X\&q=85\&s=a2aca1b49e295b7337f5779038db8e2c)

~~68[网页版 Claude Code](https://code.claude.com/docs/zh-CN/claude-code-on-the-web.md)~~

~~70其他改进~~

72[Vim 可视模式](https://code.claude.com/docs/zh-CN/interactive-mode.md#vim-editor-mode)：在提示输入中按 `v` 进行字符选择或按 `V` 进行行选择，带有运算符和可视反馈Hooks 现在可以通过 [`type: "mcp_tool"`](https://code.claude.com/docs/zh-CN/hooks#mcp-tool-hook-fields) 直接调用 MCP 工具，因此 hook 可以访问已连接的服务器，而无需生成进程`/cost` 和 `/stats` 已合并到 [`/usage`](https://code.claude.com/docs/zh-CN/commands)；旧名称仍然可用作打开相关选项卡的输入快捷方式`/config` 更改（主题、编辑器模式、详细信息等）现在持久化到 `~/.claude/settings.json`，并遵循与其他 [设置](https://code.claude.com/docs/zh-CN/settings.md) 相同的项目/本地/策略优先级[分叉的子代理](https://code.claude.com/docs/zh-CN/sub-agents.md#fork-the-current-conversation) 可以通过 `CLAUDE_CODE_FORK_SUBAGENT=1` 在外部构建上启用：分叉继承您的完整对话上下文，而不是从头开始Pro 和 Max 订阅者在 Opus 4.6 和 Sonnet 4.6 上的默认 [努力级别](https://code.claude.com/docs/zh-CN/model-config.md#adjust-effort-level) 现在是 `high`（之前是 `medium`）原生 macOS 和 Linux 构建用嵌入式 `bfs` 和 `ugrep`（通过 Bash 可用）替换了 `Glob` 和 `Grep` 工具，可实现更快的搜索，无需单独的工具往返`--from-pr` 现在除了接受 github.com 外，还接受 GitLab 合并请求、Bitbucket 拉取请求和 GitHub Enterprise PR URL自动模式：在 [`autoMode.allow`、`soft_deny` 或 `environment`](https://code.claude.com/docs/zh-CN/auto-mode-config) 中包含 `"$defaults"`，以在内置列表旁边添加自定义规则，而不是替换它新的 [`claude plugin tag`](https://code.claude.com/docs/zh-CN/plugins/dependencies#tag-plugin-releases-for-version-resolution) 命令为具有版本验证的插件创建发布 git 标签Opus 4.7 会话现在针对模型的原生 1M 上下文窗口进行计算，修复了膨胀的 `/context` 百分比和过早的自动压缩`/resume` 在大型会话上的速度提高了 67%，现在在重新读取之前提供总结陈旧的大型会话的选项

~~74[v2.1.114–v2.1.119 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-114)~~

whats-new/2026-w18.md +0 −80 deleted

File Deleted View Diff

~~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# 第 18 周 · 2026 年 4 月 27 日 – 5 月 1 日~~

7> Claude Code 在 Windows 上无需 Git Bash 即可运行，claude auth login 在浏览器回调无法到达 localhost 时接受粘贴的 OAuth 代码，claude project purge 清理每个项目的本地状态，将 PR URL 粘贴到 /resume 中可找到创建该会话的会话。

~~9发布版本 [v2.1.120 → v2.1.126](https://code.claude.com/docs/en/changelog.md#2-1-120)~~

~~104 项功能 · 4 月 27 日 – 5 月 1 日~~

~~12无需浏览器回调即可登录~~

~~13v2.1.126~~

15`claude auth login` 现在接受在浏览器回调无法到达 localhost 时直接粘贴到终端的 OAuth 代码。这涵盖了 WSL2、SSH 会话和容器，其中重定向到本地端口不起作用。同一版本还修复了在慢速或代理连接以及仅 IPv6 devcontainers 上的登录超时。

~~17登录，然后粘贴浏览器中的代码：~~

~~19```bash theme={null}~~

~~20claude auth login~~

~~21```~~

~~23[CLI 参考](https://code.claude.com/docs/zh-CN/cli-reference.md#cli-commands)~~

~~25claude project purge~~

~~26v2.1.124~~

28删除项目的所有 Claude Code 状态：记录、任务、文件历史和项目的配置条目。支持 `--dry-run` 预览、`-y`/`--yes` 跳过确认、`-i`/`--interactive` 选择以及 `--all` 清除每个项目。

~~30预览将删除的内容：~~

~~32```bash theme={null}~~

~~33claude project purge --dry-run~~

~~34```~~

~~36然后真正运行它：~~

~~38```bash theme={null}~~

~~39claude project purge~~

~~40```~~

~~42[CLI 参考](https://code.claude.com/docs/zh-CN/cli-reference.md)~~

~~44通过 PR URL 恢复~~

~~45v2.1.122~~

~~47当你使用 `gh pr create` 创建拉取请求时，Claude Code 会将其链接到生成它的会话。现在你可以仅从 PR URL 返回到该会话，而无需记住其名称。~~

~~49打开会话选择器：~~

~~51```text Claude Code theme={null}~~

~~52> /resume~~

~~53```~~

55将 PR URL 粘贴到选择器中。粘贴的第一个字符将你置于搜索模式，列表筛选到创建该 PR 的会话。按 Enter 恢复它。GitHub、GitHub Enterprise、GitLab 和 Bitbucket 拉取和合并请求 URL 都可以使用。

~~57```text Claude Code theme={null}~~

~~58https://github.com/your-org/your-repo/pull/1234~~

~~59```~~

~~61要打开已筛选到 PR 的选择器，请在命令行上传递 PR 号：~~

~~63```bash theme={null}~~

~~64claude --from-pr 1234~~

~~65```~~

~~67[会话：使用会话选择器](https://code.claude.com/docs/zh-CN/sessions.md#use-the-session-picker)~~

~~69Windows 无需 Git Bash~~

~~70Windows~~

72不再需要 Git for Windows。当 Bash 不存在时，Claude Code 使用 PowerShell 作为 shell 工具，当启用 PowerShell 工具时，它被视为主要 shell。现在自动检测通过 Microsoft Store、MSI 不带 PATH 或 `.NET` 全局工具安装的 PowerShell 7。

~~74[设置指南](https://code.claude.com/docs/zh-CN/setup.md)~~

~~76其他优化~~

78MCP 服务器可以通过其配置中的 `alwaysLoad: true` 选择退出工具搜索延迟，以便该服务器的所有工具始终可用新的 `claude plugin prune` 删除孤立的自动安装的插件依赖项，`plugin uninstall --prune` 级联删除`/skills` 现在有一个类型过滤搜索框，因此你可以在长列表中找到技能而无需滚动`PostToolUse` hooks 可以通过 `hookSpecificOutput.updatedToolOutput` 替换任何工具的工具输出，不仅仅是 MCP 工具新的 [`claude ultrareview`](https://code.claude.com/docs/zh-CN/ultrareview) 子命令从 CI 或脚本非交互式地运行 `/ultrareview`：将发现打印到 stdout（`--json` 用于原始输出）并在完成时退出 0 或失败时退出 1`--dangerously-skip-permissions` 现在绕过对 `.claude/`、`.git/`、`.vscode/`、shell 配置文件和其他以前受保护的路径的写入提示，而灾难性删除命令仍然作为安全网提示`/model` 选择器可以在 `ANTHROPIC_BASE_URL` 指向 Anthropic 兼容网关时列出来自网关的 `/v1/models` 端点的模型；自 v2.1.129 起使用 `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` 选择加入在启动期间遇到瞬时错误的 MCP 服务器现在自动重试最多 3 次，而不是保持断开连接`ANTHROPIC_BEDROCK_SERVICE_TIER` 选择 Amazon Bedrock 服务层：`default`、`flex` 或 `priority``/terminal-setup` 启用 iTerm2 的剪贴板访问设置，以便 `/copy` 工作，包括来自 tmuxGoogle Cloud 的 Agent Platform 现在支持基于 X.509 证书的工作负载身份联合 (mTLS ADC)重大内存泄漏修复：图像繁重的会话、大型记录历史上的 `/usage` 以及没有进度事件的长时间运行工具

~~80[v2.1.120–v2.1.126 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-120)~~

whats-new/2026-w19.md +0 −35 deleted

File Deleted View Diff

~~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# 第19周 · 2026年5月4–8日~~

7> 从.zip存档和URL加载插件，使用Ctrl+R跨每个项目搜索命令历史，从本地HEAD或远程默认分支创建新worktrees，以及使用自动模式硬拒绝规则无条件阻止操作。

~~9Releases [v2.1.128 → v2.1.136](https://code.claude.com/docs/en/changelog.md#2-1-128)~~

~~102 features · 5月4–8日~~

~~12从.zip存档和URL加载插件~~

14`--plugin-dir` 现在除了接受目录外，还接受 `.zip` 插件存档，新的 `--plugin-url` 标志可以从URL为当前会话获取插件存档。这对于在将插件添加到marketplace之前尝试插件，或从artifact store发送内部插件很有用。

~~16直接从URL加载插件：~~

~~18```bash terminal theme={null}~~

~~19claude --plugin-url https://example.com/my-plugin.zip~~

~~20```~~

~~22[Plugins指南](https://code.claude.com/docs/zh-CN/plugins/overview.md)~~

~~24跨所有项目搜索历史~~

~~25v2.1.129~~

27`Ctrl+R` 反向搜索现在默认搜索所有项目中的所有提示，恢复了v2.1.124之前的行为。在搜索时按 `Ctrl+S` 可以缩小范围到当前项目或会话。当你记得上周在另一个repo中运行的命令，但不想费力去寻找时，这很方便。

~~29[Interactive mode：命令历史](https://code.claude.com/docs/zh-CN/interactive-mode.md#command-history)~~

~~31其他改进~~

33新的 `worktree.baseRef` 设置（`fresh` | `head`）控制 `--worktree`、`EnterWorktree` 工具和agent-isolation worktrees是从远程默认分支还是本地 `HEAD` 创建分支；默认的 `fresh` 将未推送的提交排除在新worktrees之外新的 `settings.autoMode.hard_deny` 规则在自动模式下无条件阻止匹配的操作，无论allow例外如何，用于不应该自动运行的操作，即使应用了更广泛的allow规则Hooks现在通过 `effort.level` JSON输入字段和 `$CLAUDE_EFFORT` 环境变量接收活跃的effort level，Bash工具命令可以读取 `$CLAUDE_EFFORT``CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` 选择退出全屏alternate-screen渲染器，并将对话保留在终端的原生scrollback中`CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` 允许Homebrew或WinGet安装在后台运行升级并提示重启`CLAUDE_CODE_SESSION_ID` 现在在Bash工具子进程环境中，与传递给hooks的 `session_id` 匹配`/mcp` 现在显示已连接服务器的工具计数，并标记以0个工具连接的服务器`--channels` 现在适用于console（API key）身份验证Bash、hooks、MCP和LSP等子进程不再继承 `OTEL_*` 环境变量，因此通过Bash工具运行的OTEL检测应用不再获取CLI自己的OTLP端点Sub-agent进度摘要现在命中prompt cache，将 `cache_creation` token成本降低约3倍多个OAuth和凭证可靠性修复：并行会话在refresh-token竞争后不再在401处死亡，MCP OAuth刷新令牌在多个服务器并发刷新时不再丢失，并修复了来自并发凭证写入的罕见登录循环新的 `parentSettingsBehavior` 管理员密钥让管理员选择SDK `managedSettings` 进入策略合并

~~35[v2.1.128–v2.1.136的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-128)~~

whats-new/2026-w20.md +0 −61 deleted

File Deleted View Diff

~~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# 第 20 周 · 2026 年 5 月 11–15 日~~

~~7> 从一个屏幕管理每个 Claude Code 会话，使用 agent view，让 Claude 持续朝着目标工作直到条件满足，并在 Opus 4.7 上默认运行快速模式。~~

~~9发布版本 [v2.1.139 → v2.1.142](https://code.claude.com/docs/en/changelog.md#2-1-139)~~

~~103 项功能 · 5 月 11–15~~

~~12Agent view~~

~~13research preview~~

15`claude agents` 为每个 Claude Code 会话打开一个屏幕：显示正在运行的内容、被阻止等待您输入的内容以及已完成的内容。分派一个错误修复、一个拉取请求审查和一个不稳定测试调查作为三行，在另一个窗口中继续工作，仅在某一行需要您时才介入。附加到任何行以进入其完整对话，然后按 `←` 返回列表。每个后台会话在没有附加终端的情况下继续运行。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/ITvjicPxe1SM3GX7/images/whats-new/agent-view.mp4?fit=max&auto=format&n=ITvjicPxe1SM3GX7&q=85&s=0eefe6cbe75464c8f7902bba630ab7a4" />

~~19从您的 shell 打开仪表板：~~

~~21```bash terminal theme={null}~~

~~22claude agents~~

~~23```~~

~~25[Agent view](https://code.claude.com/docs/zh-CN/agent-view.md)~~

~~27/goal~~

~~28v2.1.139~~

30设置完成条件，Claude 会在多个回合中持续朝着该条件工作，无需您在每一步进行提示。在每个回合之后，一个快速模型检查条件是否满足；如果不满足，Claude 会开始另一个回合，而不是将控制权交还给您。适用于具有可验证结束状态的大量工作，例如迁移模块直到每个调用站点都编译并通过测试。一旦条件满足，目标就会清除，并在交互式、`-p` 和 Remote Control 中工作。

32<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/ITvjicPxe1SM3GX7/images/whats-new/goal.mp4?fit=max&auto=format&n=ITvjicPxe1SM3GX7&q=85&s=6806df3780c548b93a02d6fa71da276b" />

~~34设置一个目标并让 Claude 运行直到它满足：~~

~~36```text Claude Code theme={null}~~

~~37> /goal all tests in test/auth pass and the lint step is clean~~

~~38```~~

~~40[Goals](https://code.claude.com/docs/zh-CN/goal.md)~~

~~42Fast mode on Opus 4.7~~

~~43research preview~~

45`/fast` 现在默认在 Opus 4.7 上运行，而不是 Opus 4.6。快速模式是一个高速 Opus 配置：相同的模型质量，速度约为 2.5 倍，但每个令牌的成本更高，适用于快速迭代和实时调试。定价保持不变，为 $30/$150 每 MTok，与 Opus 4.6 快速模式相同。要将快速模式固定到 Opus 4.6，请设置 `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`。

47![Claude Code 模型选择器显示 Opus 4.7 Fast 1M 作为默认值，并启用了 Fast 切换](https://mintcdn.com/claude-code/ITvjicPxe1SM3GX7/images/whats-new/fast-mode-opus-47.png?fit=max\&auto=format\&n=ITvjicPxe1SM3GX7\&q=85\&s=6b6d92f7748ce5328a1ee9a269fb1a87)

~~49切换快速模式，现在在 Opus 4.7 上运行：~~

~~51```text Claude Code theme={null}~~

~~52> /fast~~

~~53```~~

~~55[Fast mode on Opus 4.7](https://code.claude.com/docs/zh-CN/fast-mode.md#understand-the-cost-tradeoff)~~

~~57其他改进~~

59`claude agents` 获得了分派标志（`--add-dir`、`--settings`、`--mcp-config`、`--plugin-dir`、`--permission-mode`、`--model`、`--effort`、`--dangerously-skip-permissions`）来配置后台会话，`claude agents --cwd <path>` 将会话列表范围限制在一个目录新的 hook `args: string[]` exec 形式直接生成命令而不使用 shell，因此路径占位符永远不需要引用新的 `continueOnBlock` 配置选项用于 `PostToolUse` hooks，将 hook 的拒绝原因反馈给 Claude 并继续该回合，而不是结束它hook JSON 输出中的新 `terminalSequence` 字段让 hooks 发出桌面通知、窗口标题和铃声，无需控制终端Rewind 菜单添加了"总结到此处"以压缩早期上下文，同时保持最近的回合完整当设置 `ANTHROPIC_API_KEY`、`apiKeyHelper` 或 `ANTHROPIC_AUTH_TOKEN` 时，Remote Control、`/schedule`、claude.ai MCP 连接器和通知首选项现在被禁用，即使与 claude.ai 登录一起使用；取消设置 API 密钥以使用这些功能MCP stdio 服务器现在在其环境中接收 `CLAUDE_PROJECT_DIR`，与 hooks 匹配，插件配置可以在命令中引用 `${CLAUDE_PROJECT_DIR}``claude plugin details <name>` 显示插件的组件清单和预计的每个会话令牌成本，`/plugin` 详细信息窗格现在也列出了插件提供的 LSP 服务器具有根级 `SKILL.md` 且没有 `skills/` 子目录的插件现在被显示为一个 skill`/feedback` 现在可以包括过去 24 小时或 7 天内的最近会话，用于跨越多个会话的问题Agent tool `subagent_type` 现在不区分大小写和分隔符匹配，因此 `"Code Reviewer"` 解析为 `code-reviewer`

~~61[v2.1.139–v2.1.142 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-139)~~

whats-new/2026-w21.md +0 −31 deleted

File Deleted View Diff

~~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# 第 21 周 · 2026 年 5 月 18–22 日~~

7> 在 Pro 计划上使用自动模式并支持 Sonnet 4.6，在 /usage 中查看哪些 skills、subagents 和 MCP servers 驱动您的计划限制，并使用新的 /code-review 命令查看差异。

~~9Releases [v2.1.143 → v2.1.149](https://code.claude.com/docs/en/changelog.md#2-1-143)~~

~~101 feature · 5 月 18–22~~

~~12Pro 计划上的自动模式~~

~~13CLI~~

15自动模式现已在 Pro 计划上可用，并支持 Sonnet 4.6 以及 Opus。它用后台安全检查替代权限提示：常规操作无需中断您即可运行，而破坏性或可疑操作会被阻止并显示。

~~17更新 Claude Code，然后使用 Shift+Tab 切换模式；一旦您的账户满足要求，自动模式就会出现：~~

~~19```bash terminal theme={null}~~

~~20claude update~~

~~21```~~

~~23该命令打印 `Successfully updated` 和新版本号，或如果不需要更新则打印 `Claude Code is up to date`。一旦自动模式激活，提示符页脚会显示 `auto mode on`。~~

~~25[自动模式要求](https://code.claude.com/docs/zh-CN/permission-modes.md#eliminate-prompts-with-auto-mode)~~

~~27其他改进~~

29[`/usage`](https://code.claude.com/docs/zh-CN/costs#track-your-costs) 现在显示按类别细分的内容，说明是什么驱动您的计划限制，将最近的使用情况归因于 skills、subagents、plugins 和单个 MCP servers"Extra usage"在整个 CLI 中重命名为"usage credits"，`/extra-usage` 现在是 `/usage-credits`。旧名称仍然有效。该命令需要通过 `/login` 使用您的 claude.ai 订阅登录，不适用于 API 密钥身份验证。新的 [`/code-review`](https://code.claude.com/docs/zh-CN/code-review) 命令在选定的工作量级别（如 `/code-review high`）报告正确性错误，`--comment` 将发现作为内联 GitHub PR 注释发布。`/simplify` 保留为单独的仅清理审查。后台会话现在与交互式会话一起出现在 `/resume` 中，标记为 `bg`，在 `claude agents` 中使用 `Ctrl+T` 固定的会话在空闲时保持活跃`claude agents --json` 将实时会话列为 JSON 以供脚本编写，例如状态栏和会话选择器PowerShell 工具现在在 Windows 上默认为 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 用户启用；使用 `CLAUDE_CODE_USE_POWERSHELL_TOOL=0` 选择退出`claude plugin disable` 现在在另一个启用的插件依赖于目标时拒绝，`claude plugin enable` 强制启用传递依赖`/plugin` marketplace 浏览窗格显示预计的上下文成本，Discover 和 Browse 屏幕在安装前列出插件的命令、agents、skills、hooks 和 MCP/LSP servers新的 `worktree.bgIsolation: "none"` 设置允许后台会话直接编辑工作副本，无需 `EnterWorktree`，适用于 worktrees 不实用的存储库Markdown 输出呈现 GFM 任务列表复选框，`/diff` 详细视图使用键盘滚动状态行 JSON 输入现在在检测到时包括 GitHub 存储库和 PR 信息Enterprise：`allowAllClaudeAiMcps` 托管设置加载 claude.ai 云 MCP 连接器以及 `managed-mcp.json`

~~31[v2.1.143–v2.1.149 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-143)~~

whats-new/2026-w22.md +0 −80 deleted

File Deleted View Diff

~~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# 第 22 周 · 2026 年 5 月 25–29 日~~

7> 在 Claude Opus 4.8 上运行 Claude Code，使用动态工作流编排大型任务，使用 security-guidance 插件捕获安全问题，并以更低的价格在 Opus 4.8 上使用快速模式。

~~9发布版本 [v2.1.150 → v2.1.157](https://code.claude.com/docs/en/changelog.md#2-1-150)~~

~~104 项功能 · 5 月 25–29~~

~~12Claude Opus 4.8~~

~~13新模型~~

15Opus 4.8 现在是 Max、Team Premium、Enterprise 按量付费和 Anthropic API 上的默认模型。它默认为高努力级别；对于更难的任务，使用 `/effort xhigh`。需要 v2.1.154 或更高版本。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/opus-4-8.mp4?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=6ebcf5fe136467da2b254de1fe749ea7" />

~~19按名称切换到 Opus 4.8，或从模型选择器中选择它：~~

~~21```text title="Claude Code" wrap theme={null}~~

~~22/model claude-opus-4-8~~

~~23```~~

~~25[模型配置](https://code.claude.com/docs/zh-CN/model-config.md#available-models)~~

~~27Dynamic workflows~~

~~28研究预览~~

30工作流是 Claude 为您的任务编写的编排脚本，在后台跨许多子代理运行。当任务太大而无法由一个对话来协调时，请使用工作流：整个代码库审计、大型迁移、需要交叉检查的研究问题。使用 `/workflows` 管理运行。

32![Claude Code on Opus 4.8 showing a Dynamic workflow requested indicator for a prompt that asks for a workflow to migrate every internal fetch() call](https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/dynamic-workflows.png?fit=max\&auto=format\&n=QsIrGXGFg6xd7joy\&q=85\&s=26671fa8607cec3453ed9753f821bd4f)

~~34描述任务并请求工作流：~~

~~36```text title="Claude Code" wrap theme={null}~~

~~37create a workflow that migrates every internal fetch() call to the new HttpClient wrapper~~

~~38```~~

~~40[Dynamic workflows](https://code.claude.com/docs/zh-CN/workflows.md)~~

~~42Security guidance plugin~~

~~43插件~~

45security-guidance 插件审查 Claude 的代码更改是否存在漏洞，并在同一会话中修复它们。它在每次编辑时运行快速模式检查，在每个回合结束时进行模型审查，以及在提交或推送时进行更深入的代理审查。在 `.claude/claude-security-guidance.md` 中添加项目规则。

47<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/QsIrGXGFg6xd7joy/images/whats-new/security-guidance.mp4?fit=max&auto=format&n=QsIrGXGFg6xd7joy&q=85&s=c91d865936411586f42b24c558bcdd1d" />

~~49从官方 Anthropic 市场安装它：~~

~~51```text title="Claude Code" wrap theme={null}~~

~~52/plugin install security-guidance@claude-plugins-official~~

~~53```~~

~~55然后在当前会话中激活它：~~

~~57```text title="Claude Code" wrap theme={null}~~

~~58/reload-plugins~~

~~59```~~

~~61[Security guidance plugin](https://code.claude.com/docs/zh-CN/security-guidance.md)~~

~~63Fast mode on Opus 4.8~~

~~64研究预览~~

~~66快速模式现在默认为 Opus 4.8，价格为 \$10/\$50 每 MTok：标准速率的 2 倍，速度约为 2.5 倍。Opus 4.7 和 4.6 保持在 \$30/\$150。Opus 4.6 快速模式已弃用。~~

~~68切换快速模式，现在在 Opus 4.8 上：~~

~~70```text title="Claude Code" wrap theme={null}~~

~~71/fast~~

~~72```~~

~~74[快速模式定价](https://code.claude.com/docs/zh-CN/fast-mode.md#understand-the-cost-tradeoff)~~

~~76其他亮点~~

78在 `claude agents` 中，在 shell 命令前加上 `!` 以将其作为后台作业运行，您可以附加到该作业并从中分离；也可用作 `claude --bg --exec 'pytest -x'``.claude/skills` 目录中的插件现在会自动加载，无需市场，`claude plugin init <name>` 为新插件搭建框架新的 `/reload-skills` 命令重新扫描技能目录而无需重启，`SessionStart` hooks 可以返回 `reloadSkills: true` 以使它们安装的技能在同一会话中可用技能和命令可以在 frontmatter 中设置 `disallowed-tools` 以在技能处于活动状态时从模型中删除工具新的 `MessageDisplay` hook 事件让 hooks 在显示助手消息文本时转换或隐藏它Claude Code 现在在找不到主模型时切换到您配置的 `--fallback-model` 以继续会话的其余部分，而不是使每个请求都失败插件可以在 `plugin.json` 或市场条目中声明 `defaultEnabled: false`，以便它们安装时不会打开，直到您启用它们Vim 模式：在 NORMAL 模式下按 `/` 打开反向历史搜索，与 Bash 和 Zsh vi-mode 匹配流式工具执行现在始终启用，包括在禁用遥测和在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上`←←` 打开代理视图现在在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 和禁用遥测时有效Chrome 中的 Claude：通过 `/chrome` → "选择浏览器…" 选择要使用的连接浏览器，或在浏览器操作运行时在聊天中选择（当有多个连接时）`claude mcp list` 和 `claude mcp get` 现在将未批准的 `.mcp.json` 服务器显示为待批准，而不是在输出被管道传输时自动批准和连接

~~80[v2.1.150–v2.1.157 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-150)~~

whats-new/2026-w23.md +0 −70 deleted

File Deleted View Diff

~~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# 第 23 周 · 2026 年 6 月 1–5 日~~

7> 在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上运行自动模式，在 acceptEdits 模式下提示写入可运行代码的文件，使用 /plugin list 列出已安装的插件，以及为托管部署要求批准的版本范围。

~~9发布版本 [v2.1.158 → v2.1.165](https://code.claude.com/docs/en/changelog.md#2-1-158)~~

~~104 项功能 · 6 月 1–5 日~~

~~12Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上的自动模式~~

~~13v2.1.158~~

15自动模式现已在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上可用，支持 Opus 4.7 和 Opus 4.8，用第三方提供商的后台安全检查替代权限提示。通过设置 `CLAUDE_CODE_ENABLE_AUTO_MODE=1` 来选择加入。

~~17在第三方提供商上选择加入，然后使用 Shift+Tab 切换到自动模式：~~

~~19```bash terminal theme={null}~~

~~20export CLAUDE_CODE_ENABLE_AUTO_MODE=1~~

~~21```~~

~~23[在第三方提供商上启用自动模式](https://code.claude.com/docs/zh-CN/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)~~

~~25更安全的自动编辑~~

~~26v2.1.160~~

28Claude Code 现在在写入可运行代码的文件之前进行提示，即使在 `acceptEdits` 模式下也是如此。受保护的集合包括 shell 启动文件，如 `.zshenv` 和 `.bash_login`、`~/.config/git/` 下的 git 配置，以及构建工具配置，如 `.npmrc`、`.bazelrc` 和 `.pre-commit-config.yaml`。除了 `bypassPermissions` 模式外，这些写入在任何模式下都不会自动批准。

~~30在 acceptEdits 模式下工作；Claude 现在在写入这些文件之前暂停：~~

~~32```bash terminal theme={null}~~

~~33claude --permission-mode acceptEdits~~

~~34```~~

~~36[受保护的路径](https://code.claude.com/docs/zh-CN/permission-modes.md#protected-paths)~~

~~38使用 /plugin list 列出已安装的插件~~

~~39v2.1.163~~

41新的 `/plugin list` 命令内联打印已安装的插件，无需打开 `/plugin` 菜单，也可从 shell 中作为 `claude plugin list` 使用。在交互形式中，添加 `--enabled` 或 `--disabled` 以仅显示处于该状态的插件。

~~43列出当前打开的插件：~~

~~45```text Claude Code theme={null}~~

~~46> /plugin list --enabled~~

~~47```~~

~~49[插件命令](https://code.claude.com/docs/zh-CN/plugins/cli-reference.md#plugin-list)~~

~~51托管部署的版本要求~~

~~52v2.1.163~~

54两个托管设置 `requiredMinimumVersion` 和 `requiredMaximumVersion` 允许您的组织要求批准的 Claude Code 版本范围。超出范围的客户端在启动时退出，并告诉用户通过组织的方法进行更新。`claude update`、`claude install` 和 `claude doctor` 继续工作，以便用户仍然可以恢复。

~~56向托管设置添加下限，以便较旧的客户端拒绝启动：~~

~~58```json managed-settings.json theme={null}~~

~~59{~~

~~60 "requiredMinimumVersion": "2.1.163"~~

~~61}~~

~~62```~~

~~64[决定要强制执行的内容](https://code.claude.com/docs/zh-CN/admin-setup.md#decide-what-to-enforce)~~

~~66其他改进~~

68[动态工作流](https://code.claude.com/docs/zh-CN/workflows.md)的触发关键字从 `workflow` 更改为 `ultracode`；用您自己的话要求工作流仍然有效，关键字在提示中以紫色突出显示[Stop 和 SubagentStop hooks](https://code.claude.com/docs/zh-CN/hooks.md) 可以返回 `hookSpecificOutput.additionalContext` 以向 Claude 提供反馈并继续轮次，而不是被视为错误`claude mcp` list、get 和 add 不再打印机密：环境变量引用不会展开，凭证标头和 URL 机密会被编辑并行工具批处理中失败的 Bash 命令不再取消其他命令；每个工具独立返回自己的结果当您使用单文件 `grep`、`egrep` 或 `fgrep` 查看文件时，编辑文件不再需要单独的 Read单击自动完成菜单中的命令现在会将其填充到您的提示中，而不是立即运行；按 Enter 键运行在 `--tools` 中列出 `Grep` 或 `Glob` 现在在具有嵌入式搜索的本机构建上提供专用搜索工具，而不是静默忽略这些名称`/effort` 现在确认您选择的级别将作为新会话的默认值持久化`OTEL_RESOURCE_ATTRIBUTES` 值现在作为标签附加到指标数据点，因此您可以按自定义维度（如团队或存储库）对使用指标进行切片Windsurf 在 `/ide`、`/terminal-setup` 和 `/scroll-speed` 中重命名为 Devin Desktop，遵循编辑器的品牌重塑`/btw` 获得了 `c to copy` 快捷键，可将原始 markdown 答案复制到剪贴板

~~70[v2.1.158–v2.1.165 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-158)~~

whats-new/2026-w24.md +0 −55 deleted

File Deleted View Diff

~~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# 第24周 · 2026年6月8日–12日~~

~~7> 使用 /cd 将会话移动到新目录，让子代理生成自己的子代理，并使用安全模式排查损坏的配置。~~

~~9发布版本 [v2.1.166 → v2.1.176](https://code.claude.com/docs/en/changelog.md#2-1-166)~~

~~103 项功能 · 6月8日–12日~~

~~12使用 /cd 移动会话~~

~~13v2.1.169~~

15新的 `/cd` 命令将当前会话移动到不同的工作目录，而无需重建提示缓存：新目录的 `CLAUDE.md` 作为消息附加，而不是替换系统提示。会话重新定位到新目录的项目存储，因此 `--resume` 和 `--continue` 会在那里找到它。如果您之前未在该目录中工作过，Claude 会提示您信任该目录。

~~17将会话移动到另一个项目而无需重新启动：~~

~~19```text Claude Code theme={null}~~

~~20> /cd ../other-project~~

~~21```~~

~~23[命令参考](https://code.claude.com/docs/zh-CN/commands.md#all-commands)~~

~~25子代理可以生成子代理~~

~~26v2.1.172~~

28子代理现在可以生成自己的子代理。提示下方的子代理面板显示完整的树：每一行都包含其后代的计数和返回到 `main` 的路径。子代理链的深度限制为五级，以防止失控的并发树。

~~30打开代理视图以观看嵌套树的工作展开：~~

~~32```text Claude Code theme={null}~~

~~33> /agents~~

~~34```~~

~~36[生成嵌套子代理](https://code.claude.com/docs/zh-CN/sub-agents.md#let-subagents-spawn-their-own-subagents)~~

~~38使用安全模式排查问题~~

~~39v2.1.169~~

41使用 `--safe-mode` 启动 Claude Code，或设置 `CLAUDE_CODE_SAFE_MODE`，以禁用所有自定义项启动：`CLAUDE.md`、skills、plugins、hooks、MCP 服务器以及自定义命令和代理不会加载。身份验证、模型选择、内置工具和权限仍然有效。如果问题在安全模式下消失，则其中一个表面是原因。

~~43启动干净会话以隔离损坏的配置：~~

~~45```bash terminal theme={null}~~

~~46claude --safe-mode~~

~~47```~~

~~49[针对干净配置进行测试](https://code.claude.com/docs/zh-CN/debug-your-config.md#test-against-a-clean-configuration)~~

~~51其他改进~~

53[`fallbackModel`](https://code.claude.com/docs/zh-CN/model-config#fallback-model-chains) 配置最多三个备用模型，在主模型过载或不可用时按顺序尝试，`--fallback-model` 现在也适用于交互式会话会话标题现在以您的对话语言生成；使用 `language` 设置固定特定的标题`claude agents --json` 添加 `--all` 以包含已完成的会话以及新的 `id` 和 `state` 字段，不再省略被阻止或新分派的会话在 `/plugin` 中浏览市场的插件现在有搜索栏新的 `disableBundledSkills` 设置和 `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` 隐藏捆绑的 skills、工作流和内置命令不让模型看到拒绝规则在工具名称位置接受 glob，因此 `"*"` 拒绝所有工具，拒绝规则中的未知工具名称现在在启动时发出警告代理消息传递得到加强：通过 `SendMessage` 从其他代理中继的消息不再携带用户权限，自动模式会阻止它们Amazon Bedrock 在 `AWS_REGION` 未设置时从 `~/.aws` 配置文件读取 AWS 区域，`/status` 显示区域来自何处新的 `enforceAvailableModels` 托管设置使 `availableModels` 允许列表也约束默认模型Chrome 浏览器工具中的 Claude 现在在单个批处理调用中加载，而不是每个工具一个`claude update` 在下载前宣布目标版本，而不是保持沉默新的 `footerLinksRegexes` 设置将正则表达式匹配的链接徽章添加到页脚行

~~55[v2.1.166–v2.1.176 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-166)~~

whats-new/2026-w25.md +0 −60 deleted

File Deleted View Diff

~~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# 第 25 周 · 2026 年 6 月 15–19 日~~

~~7> 从您的会话中使用 Artifacts 发布实时可共享页面，在拒绝和询问规则中匹配工具参数，以及使用 /config 从提示中设置任何设置。~~

~~9发布版本 [v2.1.178 → v2.1.183](https://code.claude.com/docs/en/changelog.md#2-1-178)~~

~~103 项功能 · 6 月 15–19 日~~

~~12Artifacts~~

14Artifact 是一个实时交互式页面，Claude Code 从您的会话发布到 claude.ai 上的私有 URL，并在会话继续工作时实时更新。当终端文本不是合适的媒介时，请要求创建一个，例如带有内联注释差异的 PR 演练或从会话数据构建的仪表板。Artifacts 在 Team 和 Enterprise 计划中处于测试阶段。

16<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/1ylKDoQynT1UgfEK/images/whats-new/artifacts.mp4?fit=max&auto=format&n=1ylKDoQynT1UgfEK&q=85&s=7f5391559d2bc69989621b36322fcff1" />

~~18向 Claude 要求一个页面，然后批准发布提示：~~

~~20```text title="Claude Code" wrap theme={null}~~

~~21Make an artifact that walks through this PR with the diff annotated inline.~~

~~22```~~

~~24[创建 Artifact](https://code.claude.com/docs/zh-CN/artifacts.md#create-an-artifact)~~

~~26按输入参数匹配~~

~~27v2.1.178~~

29拒绝和询问权限规则现在可以使用 `Tool(param:value)` 语法匹配工具的输入参数。例如，`Agent(model:opus)` 匹配请求 Opus 模型层级的子代理生成。该值接受 `*` 作为通配符，因此 `Agent(isolation:*)` 匹配任何显式隔离值。

~~31在 `settings.json` 中的拒绝列表中添加参数规则：~~

~~33```json .claude/settings.json {3} theme={null}~~

~~34{~~

~~35 "permissions": {~~

~~36 "deny": ["Agent(model:opus)"]~~

~~37 }~~

~~38}~~

~~39```~~

~~41[按输入参数匹配](https://code.claude.com/docs/zh-CN/permissions.md#match-by-input-parameter)~~

~~43从提示中设置任何设置~~

~~44v2.1.181~~

~~46将 `key=value` 传递给 `/config` 以直接更改设置，无需打开设置界面。该语法也适用于使用 `-p` 标志的非交互模式和远程控制。~~

~~48从提示中设置 `thinking` 设置：~~

~~50```text title="Claude Code" wrap theme={null}~~

~~51/config thinking=false~~

~~52```~~

~~54[命令参考](https://code.claude.com/docs/zh-CN/commands.md#all-commands)~~

~~56其他改进~~

58自动模式现在在您未要求丢弃本地工作时阻止破坏性 git 命令（`git reset --hard`、`git clean -fd`、`git stash drop`），并在您未要求特定堆栈时阻止 `terraform destroy`将新的 `attribution.sessionUrl` 设置设为 `false` 以在 web 和远程控制会话中的提交和 PR 中省略 claude.ai 会话链接在 `/config` 界面中，Enter 和 Space 都可以更改选定的设置，Esc 现在保存并关闭而不是还原新的 `sandbox.allowAppleEvents` 选择加入设置允许沙箱命令在 macOS 上发送 Apple Events指向 `CLAUDE_CLIENT_PRESENCE_FILE` 到标记文件以在您在机器上时抑制移动推送通知长段落现在逐行流式传输，而不是等待第一个换行符API 连接在思考中断开现在自动重试，而不是显示"思考时连接已关闭"设置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 后，每个会话都有一个隐式团队，因此您可以直接使用 Agent 工具的 `name` 参数生成队友嵌套 `.claude/skills` 目录中的 Skills 在处理那里的文件时加载；在名称冲突时，嵌套 skill 显示为 `<dir>:<name>`，以便两者都保持可用修复了 prompt caching 在自定义 `ANTHROPIC_BASE_URL` 和 Foundry 上不读取的问题修复了 Write 和 Edit 在网络驱动器和云同步文件夹上生成零字节或截断文件的问题

~~60[v2.1.178–v2.1.183 完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-178)~~

whats-new/2026-w26.md +0 −42 deleted

File Deleted View Diff

~~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# 第 26 周 · 2026 年 6 月 22–26 日~~

~~7> 使用 claude mcp login 从 shell 中对 MCP 服务器进行身份验证，使用 ! 前缀获取对 shell 模式命令输出的响应，以及使用 /rewind 从 /clear 之前恢复对话。~~

~~9发布版本 [v2.1.185 → v2.1.193](https://code.claude.com/docs/en/changelog.md#2-1-185)~~

~~102 项功能 · 6 月 22–26 日~~

~~12从 CLI 对 MCP 服务器进行身份验证~~

~~13v2.1.186~~

15新的 `claude mcp login <name>` 和 `claude mcp logout <name>` 命令从 shell 而不是交互式 `/mcp` 菜单对配置的 MCP 服务器进行身份验证。`claude mcp login` 直接运行服务器的 OAuth 流程，`claude mcp logout` 清除存储的凭证。

~~17为配置的服务器运行 OAuth 流程而无需打开会话：~~

~~19```bash terminal theme={null}~~

~~20claude mcp login sentry~~

~~21```~~

~~23[从命令行进行身份验证](https://code.claude.com/docs/zh-CN/mcp.md#authenticate-from-the-command-line)~~

~~25Shell 模式响应命令输出~~

~~26v2.1.186~~

28使用 `!` 前缀运行的命令现在会在输出进入记录后从 Claude 获得响应，因此您可以运行 `! npm test` 并获得对失败的解释，而无需第二个提示。响应成本与发送普通提示相同。要保持之前的行为（其中输出被添加到上下文而不获得响应），请在 `settings.json` 中将 `respondToBashCommands` 设置为 `false`。

~~30运行命令并获得对其输出的响应：~~

~~32```text Claude Code theme={null}~~

~~33> ! npm test~~

~~34```~~

~~36[带有 ! 前缀的 Shell 模式](https://code.claude.com/docs/zh-CN/interactive-mode.md#shell-mode-with-prefix)~~

~~38其他改进~~

40`/rewind` 现在可以从运行 `/clear` 之前恢复对话新的 `sandbox.credentials` 设置阻止沙箱命令读取凭证文件和秘密环境变量组织配置的模型限制现在适用于模型选择器、`--model`、`/model` 和 `ANTHROPIC_MODEL`，当选择受限制的模型时显示"受您的组织设置限制"消息新的 `autoMode.classifyAllShell` 设置将所有 Bash 和 PowerShell 命令路由通过自动模式分类器，拒绝原因现在显示在记录、拒绝提示和 `/permissions` 中新的 `claude_code.assistant_response` OpenTelemetry 日志事件携带模型的响应文本；已经记录提示内容的部署在升级时开始接收它，因此设置 `OTEL_LOG_ASSISTANT_RESPONSES=0` 以仅保留提示后台子代理现在在主会话中显示权限提示而不是自动拒绝；对话框显示哪个代理在请求，Esc 仅拒绝该工具`/install-github-app` 现在可以仅安装 GitHub App 并跳过 Actions 工作流和秘密步骤您在沙箱网络权限对话框中允许的主机在会话的其余部分被记住，而不是在每次连接时重新提示流式响应使用的 CPU 减少约 37%，来自终端输出缓存的长会话内存增长被减少`/review <pr>` 现在使用与 `/code-review medium` 相同的审查引擎Bash 模式 `!` 命令获得实时文件路径自动完成

~~42[v2.1.185–v2.1.193 的完整更改日志 →](https://code.claude.com/docs/en/changelog.md#2-1-185)~~

whats-new/2026-w27.md +0 −65 deleted

File Deleted View Diff

~~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# 第 27 周 · 6 月 29 日 – 7 月 3 日，2026 年~~

~~7> Claude Sonnet 5 成为默认模型，Claude in Chrome 正式推出，子代理默认在后台运行，Claude Desktop 在 Linux 上推出测试版，/radio 调入 Claude FM。~~

~~9发布版本 [v2.1.195 → v2.1.201](https://code.claude.com/docs/en/changelog.md#2-1-195)~~

~~105 项功能 · 6 月 29 日 – 7 月 3 日~~

~~12Claude Sonnet 5~~

~~13新模型~~

15Sonnet 5 是 Pro、Team Standard 和 Enterprise 订阅席位的新默认模型：以 Sonnet 定价提供顶级编码和工具使用能力，具有原生 1M 令牌上下文窗口和默认启用的自适应思考。API 定价在 8 月 31 日前为促销价格，每 MTok 2 美元/10 美元。需要 v2.1.197 或更高版本。

~~17按名称切换到 Sonnet 5，或从模型选择器中选择：~~

~~19```text Claude Code theme={null}~~

~~20> /model claude-sonnet-5~~

~~21```~~

~~23[模型配置](https://code.claude.com/docs/zh-CN/model-config.md#available-models)~~

~~25Claude in Chrome 正式推出~~

~~26v2.1.198~~

28Chrome 集成已对所有直接 Anthropic 计划的用户结束预览阶段，正式推出。Claude Code 通过 Claude in Chrome 扩展程序驱动您的浏览器：它打开标签页、点击浏览页面、填充表单、读取控制台日志并共享您的登录状态，因此它可以测试它构建的应用程序，而无需您切换上下文。

~~30[使用 Claude Code 与 Chrome](https://code.claude.com/docs/zh-CN/chrome.md)~~

~~32子代理默认在后台运行~~

~~33v2.1.198~~

35Claude 现在在子代理运行时继续工作，并在子代理完成时获取其结果，而不是暂停对话以等待。Claude 仍然在需要结果才能继续时在前台运行子代理，后台子代理在您的主会话中显示每个权限提示。使用 `background` frontmatter 字段固定子代理的行为。

~~37[在前台或后台运行子代理](https://code.claude.com/docs/zh-CN/sub-agents.md#run-subagents-in-foreground-or-background)~~

~~39Claude Desktop on Linux~~

~~40Desktop~~

42Claude 桌面应用现已在 Ubuntu 22.04+ 和 Debian 12+ 上以测试版形式提供，支持 x86\_64 和 arm64。您可以获得与 macOS 和 Windows 相同的 Chat、Cowork 和 Claude Code 体验：并行会话、可视化差异审查、集成终端和编辑器以及实时应用预览。从 Anthropic 的 apt 存储库安装，因此更新通过常规包更新到达。

~~44[Claude Desktop on Linux](https://code.claude.com/docs/zh-CN/desktop-linux.md)~~

~~46/radio~~

~~47CLI~~

49Claude FM 已上线。`/radio` 在您的浏览器中打开 lo-fi 电台流，用于编码时的背景音乐，当没有浏览器可用时打印流 URL。在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。

51<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/x358isu_VzLnyTEN/images/whats-new/radio.mp4?fit=max&auto=format&n=x358isu_VzLnyTEN&q=85&s=36a0c33859cef119c7192dceea8bcbd3" />

~~53从任何会话调入：~~

~~55```text Claude Code theme={null}~~

~~56> /radio~~

~~57```~~

~~59[所有命令](https://code.claude.com/docs/zh-CN/commands.md#all-commands)~~

~~61其他亮点~~

63[Artifacts](https://code.claude.com/docs/zh-CN/artifacts.md) 现已正式推出，包含在 Pro 和 Max 计划中，加入 Team 和 Enterprise管理员可以在组织控制台中设置 [组织默认模型](https://code.claude.com/docs/zh-CN/model-config.md#organization-default-model)；当您尚未选择模型时，它在 `/model` 中显示为"组织默认"堆叠的技能调用，如 `/skill-a /skill-b do XYZ`，现在加载所有前导技能（最多 5 个），而不仅仅是第一个`AskUserQuestion` 对话框默认不再自动继续；通过 `/config` 选择加入空闲超时"default"权限模式现在在 CLI、`--help`、VS Code 和 JetBrains 中命名为"Manual"；`--permission-mode manual` 与 `default` 一起被接受新的 `/dataviz` 技能提供图表和仪表板设计指导，带有可运行的调色板验证器内置的 Explore 代理现在继承主会话的模型（上限为 Opus），而不是在 Haiku 上运行从 `claude agents` 启动的后台代理现在在 worktree 中完成代码工作时提交、推送并打开草稿 PR，而不是停下来询问您带有连字符标识符（如 `code-reviewer`）的 Hook 匹配器现在精确匹配而不是子字符串匹配；使用 `mcp__brave-search__.*` 匹配来自连字符 MCP 服务器的所有工具与您的使用限制无关的瞬时服务器速率限制错误现在对订阅者自动重试并进行退避，而不是使轮次失败流式空闲监视程序现在默认对所有提供商启用：当响应流在 5 分钟内不产生任何事件时，它会中止并重试（`CLAUDE_ENABLE_STREAM_WATCHDOG=0` 禁用）

~~65[v2.1.195–v2.1.201 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-195)~~

whats-new/2026-w28.md +0 −38 deleted

File Deleted View Diff

~~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# 第 28 周 · 2026 年 7 月 6–10 日~~

~~7> 从 Desktop 应用的内置浏览器浏览外部网站，使用 /doctor 运行完整的设置检查，并获取自动模式的文本记录保护和代理视图升级。~~

~~9发布版本 [v2.1.202 → v2.1.206](https://code.claude.com/docs/en/changelog.md#2-1-202)~~

~~102 项功能 · 7 月 6–10 日~~

~~12Desktop 上的应用内浏览器~~

~~13Desktop~~

15Desktop 上的 Claude Code 现在具有内置浏览器。Claude 可以打开文档、设计或任何其他网站，并以与处理本地开发服务器预览相同的方式读取、点击和与页面交互。浏览器是沙箱化的且可配置的：您可以选择浏览会话是否持续，安全分类器会审查对外部网站的操作。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/x358isu_VzLnyTEN/images/whats-new/desktop-browser.mp4?fit=max&auto=format&n=x358isu_VzLnyTEN&q=85&s=8033e85a1cb0a37870a79e702c18f4e4" />

~~19[浏览外部网站](https://code.claude.com/docs/zh-CN/desktop.md#browse-external-sites)~~

~~21/doctor 是完整的设置检查~~

~~22v2.1.205~~

24`/doctor` 现在可以诊断问题并修复它们，而不是打印只读报告。它检查安装健康状况，查找未使用的 skills、MCP 服务器和插件与其上下文成本的对比，针对已检入的文件对本地 `CLAUDE.md` 文件进行重复数据删除，建议修剪 Claude 可以从代码库派生的 `CLAUDE.md` 内容，并标记缓慢的 hooks。它首先报告发现，然后在更改任何内容之前请求确认。`/checkup` 是它的别名。

~~26从任何会话运行检查：~~

~~28```text Claude Code theme={null}~~

~~29> /doctor~~

~~30```~~

~~32[所有命令](https://code.claude.com/docs/zh-CN/commands.md#all-commands)~~

~~34其他改进~~

36自动模式现在阻止篡改会话文本记录文件，并在运行 `rm -rf` 处理无法从上下文解析的变量之前询问`/cd` 现在在您输入时建议目录路径，与 `/add-dir` 匹配`/commit-push-pr` 自动允许 `git push` 到存储库配置的推送远程，除了 `origin`Gateway：`/login` 现在支持 Anthropic 运营的公共网关端点`EnterWorktree` 在进入项目 `.claude/worktrees/` 目录之外的 git worktree 之前请求确认后台代理在 Claude Code 更新后立即升级到新版本，而不是在您附加时支付缓慢的过时会话升级代理视图行现在显示彩色状态词和分类器编写的标题，而不是原始工具调用文本，编辑、合并、评论或推送到现有 PR 的会话在 `claude agents` 中链接它自动更新二进制下载现在流式传输到磁盘，而不是在内存中缓冲，将更新程序的峰值内存使用量减少了大约 400 MB后台任务通知现在明确说明没有发生人工输入，防止虚构的文本记录内批准被执行在 Opus 4.8 上改进了 `/code-review` 发现质量，涵盖所有工作量级别

~~38[v2.1.202–v2.1.206 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-202)~~

whats-new/2026-w29.md +0 −44 deleted

File Deleted View Diff

~~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# 第29周 · 2026年7月13–17日~~

~~7> 通过MCP连接器将实时数据拉入已发布的工件中，并在新的屏幕阅读器模式下使用Claude Code。~~

~~9发布版本 [v2.1.207 → v2.1.212](https://code.claude.com/docs/en/changelog.md#2-1-207)~~

~~102项功能 · 7月13–17~~

~~12工件调用您的MCP连接器~~

~~13web~~

15已发布的工件现在可以在每次有人查看时调用MCP连接器，因此仪表板显示实时数据并可以按需执行操作，而不是构建它的会话中的快照。每次调用都通过查看者自己的连接运行，查看者在页面首次连接器调用前批准访问。本周还添加了公开共享链接、Team和Enterprise计划上的编辑者角色，以及从Claude Tag会话创建的工件。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/ItzF3QVI6L0QypjJ/images/whats-new/artifacts-mcp.mp4?fit=max&auto=format&n=ItzF3QVI6L0QypjJ&q=85&s=ff8b81ed52b26c773899dc28cec959e6" />

~~19在您的提示中命名连接器和您想要的数据：~~

~~21```text title="Claude Code" wrap theme={null}~~

~~22Build a dashboard artifact of open pull requests that pulls the live list through my GitHub connector when the page loads.~~

~~23```~~

~~25[使用MCP连接器拉取实时数据](https://code.claude.com/docs/zh-CN/artifacts.md#pull-live-data-with-mcp-connectors)~~

~~27屏幕阅读器模式~~

~~28CLI~~

30屏幕阅读器模式用纯文本、线性文本替换可视化终端界面：不使用框、旋转器和原地重绘，Claude Code打印标记的行，屏幕阅读器（如VoiceOver或NVDA）按顺序读取，因此您可以批准权限并端到端审查输出。使用标志按会话打开它，使用`CLAUDE_AX_SCREEN_READER`环境变量按shell打开它，或使用`axScreenReader`设置在任何地方打开它。

~~32在屏幕阅读器模式下启动会话：~~

~~34```bash terminal theme={null}~~

~~35claude --ax-screen-reader~~

~~36```~~

~~38[打开屏幕阅读器模式](https://code.claude.com/docs/zh-CN/accessibility.md#turn-on-screen-reader-mode)~~

~~40其他改进~~

42`/fork`现在将您的对话复制到新的后台会话中，在`claude agents`中有自己的行，同时您继续工作；它曾经启动的会话内分叉子代理现在是`/subtask`[自动模式](https://code.claude.com/docs/zh-CN/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry)在Amazon Bedrock、Google Cloud的Agent Platform和Microsoft Foundry上不再需要`CLAUDE_CODE_ENABLE_AUTO_MODE`选择加入；管理员可以使用`disableAutoMode`关闭它运行时间超过两分钟的MCP工具调用现在自动移到后台，以便会话保持可用；使用`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`调整或禁用阈值新的`claude auto-mode reset`恢复默认自动模式配置，`--yes`跳过确认提示新的[企业启动器](https://code.claude.com/docs/zh-CN/corporate-launcher.md)支持：`CLAUDE_CODE_PROCESS_WRAPPER`或`processWrapper`设置通过必需的包装器可执行文件运行Claude Code从其自己的二进制文件启动的进程，例如后台服务和代理视图会话`vimInsertModeRemaps`设置将两键插入模式序列（如`jj`）映射到vim模式中的Escape`--forward-subagent-text`和`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`在[stream-json输出](https://code.claude.com/docs/zh-CN/headless.md)中包含子代理文本和思考块会话范围的上限停止失控循环：WebSearch调用和子代理生成各默认为200，可使用`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`和`CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION`调整"始终允许"权限规则保存在存储库根目录，因此在git worktree中授予的批准在会话和worktree中持续Amazon Bedrock、Google Cloud的Agent Platform和AWS上的Claude Platform现在默认为Claude Opus 4.8折叠的工具摘要行显示实时经过时间计数器，因此长时间运行的工具调用可见地计时，而不是看起来卡住

~~44[v2.1.207–v2.1.212的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-207)~~

whats-new/2026-w30.md +0 −59 deleted

File Deleted View Diff

~~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# 第 30 周 · 7 月 20–24 日，2026 年~~

~~7> Opus 5 成为默认的 Opus 模型，Claude Code Desktop 添加了 iOS 模拟器窗格，Claude Security 插件扫描您的代码以查找漏洞。~~

~~9发布版本 [v2.1.214 → v2.1.219](https://code.claude.com/docs/en/changelog.md#2-1-214)~~

~~103 项功能 · 7 月 20–24 日~~

~~12Claude Opus 5~~

~~13新模型~~

15Claude Opus 5 是 Claude Code 中新的默认 Opus 模型。它是 Max、Team Premium、Enterprise 按量付费以及 Anthropic API 上的默认模型，也是 AWS 上的 Claude Platform、Amazon Bedrock 和 Google Cloud 的 Agent Platform 上的默认模型。在 Anthropic API 以及 Max、Team 和 Enterprise 计划上，Opus 5 运行时具有 [100 万令牌上下文窗口](https://code.claude.com/docs/zh-CN/model-config.md#extended-context)；在 Amazon Bedrock 和 Google Cloud 的 Agent Platform 上，选择 100 万模型变体。快速模式转移到 Opus 5，价格为每百万令牌 $10/$50。需要 v2.1.219 或更高版本。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/N3yEaTYPXMXFrF6k/images/whats-new/opus-5.mp4?fit=max&auto=format&n=N3yEaTYPXMXFrF6k&q=85&s=8536b1cb3180e539008f39930403e47b" />

~~19按名称切换到 Opus 5，或从模型选择器中选择它：~~

~~21```text Claude Code theme={null}~~

~~22> /model claude-opus-5~~

~~23```~~

~~25[模型配置](https://code.claude.com/docs/zh-CN/model-config.md#available-models)~~

~~27Claude Code Desktop 中的 iOS 模拟器~~

~~28Desktop~~

30macOS 上的 Claude Code Desktop 获得了 iOS 模拟器窗格，在 Pro、Max 和 Team 计划上处于公开测试版。当 Claude 在模拟器中构建、启动或检查您的应用时，该窗格会在对话旁边打开并实时流式传输设备屏幕，因此您可以观看 Claude 点击应用以验证其更改或自己驱动设备。需要安装了 iOS 平台的 Xcode 以及 Claude Desktop v1.24012.0 或更高版本。

32![Claude Code Desktop 显示 iOS 模拟器窗格，在对话旁边显示 iPhone 应用](https://mintcdn.com/claude-code/N3yEaTYPXMXFrF6k/images/whats-new/ios-simulator.jpg?fit=max\&auto=format\&n=N3yEaTYPXMXFrF6k\&q=85\&s=6c88418ed14ed0fb12cc1af75b17f2ee)

~~34要求 Claude 运行或测试您的应用，当应用启动时窗格会打开：~~

~~36```text Claude Code theme={null}~~

~~37> Build the app and run it in the simulator to check the onboarding flow.~~

~~38```~~

~~40[在模拟器中测试 iOS 应用](https://code.claude.com/docs/zh-CN/desktop-ios-simulator.md#run-your-app-in-the-simulator)~~

~~42Claude Security 插件~~

~~43plugin~~

45Claude Security 插件在 Claude Code 会话内运行代码库的多代理漏洞扫描：代理映射您的架构、构建威胁模型、搜索漏洞，并在将报告写入 `CLAUDE-SECURITY-<timestamp>/` 目录之前独立审查每项发现。扫描整个存储库或仅扫描分支的差异、拉取请求或单个提交，然后将您选择的发现转换为经过审查的补丁，您可以自己应用。

~~47从官方 Anthropic 市场安装插件，运行 `/reload-plugins`，然后使用 `/claude-security` 启动扫描：~~

~~49```text Claude Code theme={null}~~

~~50> /plugin install claude-security@claude-plugins-official~~

~~51```~~

~~53[扫描并修复您的代码库](https://code.claude.com/docs/zh-CN/claude-security.md#scan-and-fix-your-codebase)~~

~~55其他改进~~

57[`/code-review`](https://code.claude.com/docs/zh-CN/code-review-local) 现在作为具有自己上下文窗口的后台子代理运行，因此审查工作不会进入您的对话，发现会在完成时到达`/verify`、`/code-review` 和 `/deep-research` 仅在您调用时运行；Claude 不再自动启动它们[Emoji 快捷代码](https://code.claude.com/docs/zh-CN/interactive-mode.md#emoji-shortcodes)在提示词输入框中自动补全：输入 `:heart:` 以插入 emoji，或在 `:` 后输入两个或更多字符以获得建议；使用 `emojiCompletionEnabled` 关闭它具有 `context: fork` 的 skill [默认在后台运行](https://code.claude.com/docs/zh-CN/skills.md#run-skills-in-a-subagent)，skill 的 frontmatter 中的 `background: false` 在同一轮次中等待结果会话默认运行最多 20 个子代理并发；使用 `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` 更改 [限制](https://code.claude.com/docs/zh-CN/sub-agents.md#concurrent-subagent-limit)`--max-budget-usd` 现在对子代理强制执行上限：一旦支出达到上限，Claude 无法启动更多，运行中的后台子代理会停止新的 [`sandbox.filesystem.disabled`](https://code.claude.com/docs/zh-CN/sandboxing#disable-filesystem-isolation) 设置跳过文件系统隔离，同时保持网络出口控制在自动模式下，对危险 `rm` 命令、后台作业和可疑 Windows 路径的检查不再打开权限对话框；自动模式分类器会对其进行判决Bash 权限检查在更多 shell 形式上失败关闭，包括文件描述符重定向、`[[ ]]` 比较中的 Zsh 变量下标、可能运行不安全选项的 `help` 和 `man` 调用，以及超过 10,000 个字符的命令[快速模式](https://code.claude.com/docs/zh-CN/fast-mode.md)不再支持 Opus 4.7：`/fast` 现在适用于 Opus 5 和 Opus 4.8长时间运行的工具调用会发出定期进度心跳，而不是保持沉默

~~59[v2.1.214–v2.1.219 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-214)~~

whats-new/2026-w32.md +0 −69 deleted

File Deleted View Diff

~~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# 第 32 周 · 2026 年 8 月 3–7 日~~

~~7> Claude Code 会话可以相互发送消息，自托管环境在您的基础设施上运行云会话，自动模式成为默认权限模式。~~

~~9发布版本 [v2.1.220 → v2.1.224](https://code.claude.com/docs/en/changelog.md#2-1-220)~~

~~103 项功能 · 8 月 3–7 日~~

~~12跨会话消息传递~~

~~13v2.1.224~~

15您的 Claude Code 会话现在可以相互发送消息。Claude 使用 `ListAgents` 工具发现您的其他会话，并使用 `SendMessage` 发送消息，可以在您要求时发送，也可以自动发送，例如在一个会话中的更改影响另一个会话的工作后。消息是 Claude 为另一个会话编写的文本，永远不会是您的对话历史或文件。在 macOS 和 Linux 上可用。需要 v2.1.224 或更高版本。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/N3yEaTYPXMXFrF6k/images/whats-new/cross-session-messaging.mp4?fit=max&auto=format&n=N3yEaTYPXMXFrF6k&q=85&s=8f33c3390f78660a4a26dc980f46159f" />

~~19在同一台机器上打开两个会话，要求其中一个会话传递一些内容：~~

~~21```text title="Claude Code" wrap theme={null}~~

~~22告诉处理支付 API 的会话 users.name 现在是 users.display_name~~

~~23```~~

~~25一旦 Claude 读取了消息，另一个会话会显示一个 `Message from` 行；按 `Ctrl+O` 展开它。要查看 Claude 可以访问哪些会话，请运行 `/list-agents`。~~

~~27[向另一个会话发送消息](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#message-another-session)~~

~~29自托管环境~~

~~30v2.1.224~~

32自托管环境在您组织自己的基础设施上运行 Claude Code 云会话，在 Team 和 Enterprise 计划上处于公开测试阶段。在您的机器或容器上运行 `claude self-hosted-runner` 将它们转变为运行器。当有人在从 claude.ai、移动或桌面应用程序或 `claude --cloud` 启动会话时选择您的环境时，该会话在您的网络内运行，可以访问您的内部服务。所有者首先在 [管理设置](https://claude.ai/admin-settings/cloud-environments) 中打开 **允许自托管环境**。

34![自托管环境管理页面，列出了 linux-dev 和 macos-prod 等环境及其状态和活跃会话计数](https://mintcdn.com/claude-code/N3yEaTYPXMXFrF6k/images/whats-new/self-hosted-environments.jpg?fit=max\&auto=format\&n=N3yEaTYPXMXFrF6k\&q=85\&s=ae9152cb1670c8af517d1aee57689b14)

~~36以所有者身份登录，运行引导式设置，它将引导您创建环境并启动运行器：~~

~~38```bash terminal theme={null}~~

~~39claude self-hosted-runner setup~~

~~40```~~

~~42运行器注册后，该环境在管理设置中显示 **健康**。~~

~~44[自托管环境快速入门](https://code.claude.com/docs/zh-CN/self-hosted-environments-quickstart.md#set-up-an-environment-and-runner)~~

~~46自动模式成为默认值~~

~~47CLI~~

49从 8 月 14 日开始，自动模式是 Pro、Max 和 Team 计划上新会话的默认权限模式。如果您自己设置了默认模式，它将保持不变，除非您接受一次性切换提示，而您的组织管理的默认值不会改变。您仍然可以随时切换模式。已在这些计划上生效：自动模式进行的分类器调用不再计入您的使用限制。

~~51在切换前以自动模式启动每个会话，请在您的用户设置中将其设置为默认值：~~

~~53```json ~/.claude/settings.json {3} theme={null}~~

~~54{~~

~~55 "permissions": {~~

~~56 "defaultMode": "auto"~~

~~57 }~~

~~58}~~

~~59```~~

~~61新会话随后在状态栏中显示 `auto mode on`。~~

~~63[自动模式要求和控制](https://code.claude.com/docs/zh-CN/permission-modes.md#eliminate-prompts-with-auto-mode)~~

~~65其他改进~~

67VS Code 扩展获得 [焦点视图](https://code.claude.com/docs/zh-CN/vs-code.md#extension-settings)，它将工具活动隐藏在每轮一个可展开行之后；从命令菜单或使用 `Ctrl+Alt+F`（Mac 上为 `Ctrl+Option+F`）切换它沙箱凭据文件在 Linux 和 WSL2 上接受 [`mode: "mask"`](https://code.claude.com/docs/zh-CN/sandboxing#mask-credential-files)，因此沙箱中的命令读取哨兵副本，而沙箱代理在出口时替换真实值；凭据掩蔽还获得 `extract`、JWT 感知的 `decode` 和 AWS SigV4 重新签名选项市场可以使用新的 `archive` 源将插件分发为 [zip 存档](https://code.claude.com/docs/zh-CN/plugins/marketplace-reference.md#archive-plugin-source)，通过 HTTPS 下载，带有可选的 SHA-256 固定校验，因此安装无需 git 或 npm`/review` 现在是 [`/code-review`](https://code.claude.com/docs/zh-CN/code-review-local) 的别名，`/code-review` 不带 effort 级别时会重用您上次输入的级别您使用 [`/fork`](https://code.claude.com/docs/zh-CN/agent-view#copy-the-session-with-%2Ffork) 复制的会话现在在其自己的 worktree 中进行代码更改，而不是在原始会话的检出中您从 [`/plugin`](https://code.claude.com/docs/zh-CN/plugins/install#install-a-plugin) 安装的插件在安全的情况下会在当前会话中激活；安装摘要会报告 `Plugin is now active.` 或告诉您运行 `/reload-plugins`在 worktree 中更改了代码的[后台会话](https://code.claude.com/docs/zh-CN/agent-view.md#how-file-edits-are-isolated)现在会在完成前提交和推送，仅当任务需要时才打开草稿 Pull Request，并遵循您的 `CLAUDE.md` 中的 git 指令每个会话 200 个子代理的上限被移除，因此长时间运行的会话不再拒绝新的子代理；[并发](https://code.claude.com/docs/zh-CN/sub-agents.md#concurrent-subagent-limit) 和深度限制仍然适用仓库中签入的设置不再能打开 [Remote Control 自动连接](https://code.claude.com/docs/zh-CN/remote-control.md#enable-remote-control-for-all-sessions)；改为在您的用户或托管设置中设置 `remoteControlAtStartup`，项目和本地设置只能将其关闭[Worktree 隔离](https://code.claude.com/docs/zh-CN/worktrees.md#how-claude-code-enforces-isolation) 现在不仅阻止文件编辑，还阻止到达主检出的 Bash 命令和 git 重定向，适用于每种会话类型以及会话的子代理Bash 命令不再能从权限检查中隐藏其自身的一部分，制表符或不可见的 Unicode 填充不再从批准对话框中隐藏命令的一部分PreToolUse 自动允许 hook 不再绕过 Claude Code 内部侧任务（如摘要和压缩）中的工具限制[Ultraplan](https://code.claude.com/docs/zh-CN/ultraplan) 研究预览版被移除，包括 `/ultraplan` 命令和 `ultraplan` 关键字；改为使用计划模式或 Web 版 Claude Code

~~69[v2.1.220–v2.1.224 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-220)~~

whats-new/2026-w33.md +0 −57 deleted

File Deleted View Diff

~~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# 第 33 周 · 2026 年 8 月 10–14 日~~

~~7> Claude Code Desktop 在用量限制重置后自动继续，fork 模式默认启用，GitLab 合并请求和市场加入 GitHub。~~

~~9发布版本 [v2.1.225 → v2.1.233](https://code.claude.com/docs/en/changelog.md#2-1-225)~~

~~103 项功能 · 8 月 10–14~~

~~12Desktop 上用量限制重置后自动继续~~

~~13Desktop~~

15当您在 Claude Code Desktop 的 Code 选项卡中达到会话限制时，限制卡现在提供一个**限制重置时自动继续**复选框。勾选它，Desktop 应用将在重置后重试中断的轮次。该卡显示重试时间。每周限制卡不提供此选项。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/2SnAdpL4dJ18nKb3/images/whats-new/desktop-auto-continue.mp4?fit=max&auto=format&n=2SnAdpL4dJ18nKb3&q=85&s=1937f489695feaea715e48ecfd7e62cd" />

~~19下次出现会话限制卡时，勾选**限制重置时自动继续**并保持会话打开。该卡显示 `Auto-resuming at` 后跟重置时间，一旦限制重置，轮次将自动继续。~~

~~21[达到用量限制时该怎么办](https://code.claude.com/docs/zh-CN/errors.md#youve-hit-your-session-limit)~~

~~23Fork 模式默认启用~~

~~24v2.1.232~~

26Fork 模式现在在交互式会话中默认启用。Claude 可以请求 `fork` 子代理类型，它继承完整的对话和提示词缓存，而不是从头开始，因此您不必为辅助任务重新解释上下文。Claude 在交互式会话中生成的子代理（agent team 队友生成的除外）也默认在后台运行。

~~28使用需要您迄今为止讨论的所有内容的任务自己启动 fork：~~

~~30```text Claude Code theme={null}~~

~~31> /subtask draft unit tests for the parser changes so far~~

~~32```~~

~~34fork 出现在您的输入框下方的面板中，其结果在完成时到达您的对话。要关闭 fork 模式，请设置 `CLAUDE_CODE_FORK_SUBAGENT=0`。~~

~~36[启用或关闭 fork 模式](https://code.claude.com/docs/zh-CN/sub-agents.md#turn-fork-mode-on-or-off)~~

~~38GitLab 合并请求和市场~~

~~39v2.1.232~~

41插件市场克隆裸 `gitlab.com` URL，包括嵌套子组。在 v2.1.233 或更高版本上，将 GitLab 合并请求 URL 传递给 `--worktree` 以从其分支，`claude agents` 视图将链接到合并请求的会话标记为 `!N`。Claude Code 还会对 GitLab 令牌族（如 `glpat-` 和 `glrt-`）进行脱敏处理，并以与保护 `gh` 相同的方式保护 `glab` CLI 的配置存储。

~~43在从合并请求分支的 worktree 中启动会话：~~

~~45```bash terminal theme={null}~~

~~46claude --worktree https://gitlab.com/group/project/-/merge_requests/42~~

~~47```~~

~~49当 `origin` 在 gitlab.com 上时，Claude Code 获取 `merge-requests/42/head` 并在其自己的 worktree 中的该分支上打开会话。~~

~~51[从拉取或合并请求分支 worktree](https://code.claude.com/docs/zh-CN/worktrees.md#branch-from-a-pull-request)~~

~~53其他改进~~

55在输入框中键入 `@` 以按名称[提及另一个 Claude 会话](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#message-another-session)，Claude 使用 `SendMessage` 直接向其发送消息；与恰好一个活跃会话完全匹配的裸名称现在无需确认步骤即可传递一台机器上的交互式会话保持[唯一名称](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#see-which-sessions-claude-can-reach)：如果您启动或重命名会话时使用另一个活跃会话已在使用的名称，Claude Code 会为您的会话提供 `name-word-word` 变体并告知您插件市场接受[`command` 源](https://code.claude.com/docs/zh-CN/plugins/marketplace-reference#command-plugin-source)：本地命令打印插件目录，Claude Code 在每个会话中重新解析并应用，无需重启在 Linux 和 WSL 上，设置[`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](https://code.claude.com/docs/zh-CN/tools-reference#memory-limit-on-linux-and-wsl) 为大小（如 `4G`）以限制 Bash 和 PowerShell 工具命令可以使用的内存任务跟踪工具，如 `TaskCreate`、`TaskUpdate` 和 `TodoWrite`，[在 Opus 4.8、Sonnet 5、Fable 5、Mythos 5 及这些系列中的更高版本上不再可用](https://code.claude.com/docs/zh-CN/tools-reference.md#task-tool-availability)；设置 `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` 以重新启用它们[`/code-review`](https://code.claude.com/docs/zh-CN/code-review-local) 在高、超高和最大努力级别现在像其他级别一样在后台 Agent 中运行[`/plugin install plugin@marketplace`](https://code.claude.com/docs/zh-CN/plugins/install#install-a-plugin) 首先刷新市场，因此新发布的插件无需手动市场更新即可安装设置接受[`additionalMarketplaces` 和 `allowedMarketplaces`](https://code.claude.com/docs/zh-CN/settings-reference#marketplace-key-aliases) 作为 `extraKnownMarketplaces` 和 `strictKnownMarketplaces` 的别名在较新的模型上，Claude 可以[使用 Write 工具覆盖现有文件](https://code.claude.com/docs/zh-CN/tools-reference.md#write-tool-behavior)而无需在此会话中首先读取它，与 Edit 工具的规则匹配；较旧的模型需要读取VS Code 扩展可以[将会话列表组织成组](https://code.claude.com/docs/zh-CN/vs-code.md#organize-sessions-into-groups)：右键单击以创建、重命名或删除组，使用 Cmd/Ctrl- 或 Shift-单击一次移动多个会话如果您的组织通过[具有支出限制的 Claude 应用网关](https://code.claude.com/docs/zh-CN/claude-apps-gateway-spend-limits.md)路由 Claude Code，Claude Code 会在您达到限制时显示限制期间、其重置时间和运营商的消息

~~57[v2.1.225–v2.1.233 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-225)~~

whats-new/2026-w34.md +0 −69 deleted

File Deleted View Diff

~~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# 第 34 周 · 2026 年 8 月 17–21 日~~

~~7> 使用 /design skill 草拟可编辑的 UI 画板，设置 Concise 输出样式，并从手机在您的机器上启动 Claude Code 会话。~~

~~9发布版本 [v2.1.234 → v2.1.239](https://code.claude.com/docs/en/changelog.md#2-1-234)~~

~~103 项功能 · 8 月 17–21~~

~~12/design~~

~~13research preview~~

15`/design` skill 将 Claude Design 的画板工作流程引入 CLI 和 Claude Code Desktop，基于 artifacts 构建。使用简要说明运行它，Claude 会发布一个可编辑画板的画布供您的 UI 使用。选择一个，调整它，然后让 Claude 实现它。适用于 Pro、Max、Team 和 Enterprise。需要 v2.1.234 或更高版本。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/2SnAdpL4dJ18nKb3/images/whats-new/design-skill.mp4?fit=max&auto=format&n=2SnAdpL4dJ18nKb3&q=85&s=0b376a94227c14a4204af89c4c9fd7ac" />

~~19描述您想要设计的内容，让 Claude 草拟选项：~~

~~21```text Claude Code theme={null}~~

~~22> /design redesign the composer based on what people actually use it for~~

~~23```~~

~~25Claude 打印已发布画布的链接。打开它，选择一个画板，并告诉 Claude 要实现哪个选项。~~

~~27[artifacts 可用的位置](https://code.claude.com/docs/zh-CN/artifacts.md#availability)~~

~~29Concise 输出样式~~

~~30v2.1.237~~

32Concise 是一种新的内置输出样式。Claude 以结果开头，跳过前言和叙述，同时以与默认样式相同的彻底程度完成工作。当您要求解释或更多详细信息时，Claude 会完整回答。错误报告、安全警告和破坏性操作的确认保持其完整内容。

34<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/2SnAdpL4dJ18nKb3/images/whats-new/concise-output-style.mp4?fit=max&auto=format&n=2SnAdpL4dJ18nKb3&q=85&s=dfb40ec8921ed1bc82eb629042a8ec17" />

~~36在 `/config` 中的 **Output style** 下打开它，或在您的设置文件中设置它：~~

~~38```json ~/.claude/settings.json {2} theme={null}~~

~~39{~~

~~40 "outputStyle": "Concise"~~

~~41}~~

~~42```~~

~~44运行 `/clear` 或启动新会话，Claude 的回复以结果开头。~~

~~46[内置输出样式](https://code.claude.com/docs/zh-CN/output-styles.md#built-in-output-styles)~~

~~48从手机在您的机器上启动会话~~

~~49mobile~~

~~51任何运行 `claude remote-control` 的机器现在都会在 Claude 应用的 Code 标签页顶部显示为设备卡片。Remote Control 也已退出研究预览。~~

53![Claude 移动应用中的 Code 标签页，其中 Devices 部分显示连接的 MacBook 作为设备卡片，位于会话列表上方](https://mintcdn.com/claude-code/2SnAdpL4dJ18nKb3/images/whats-new/remote-control-phone-start.jpg?fit=max\&auto=format\&n=2SnAdpL4dJ18nKb3\&q=85\&s=9f0ebedab23aa0e1732cc37782573907)

~~55在您想要访问的机器上启动 Remote Control，然后在手机上打开 Code 标签页：~~

~~57```bash terminal theme={null}~~

~~58claude remote-control~~

~~59```~~

~~61您的机器显示为 Code 标签页顶部的设备卡片。点击它以选择目录并在那里启动会话。~~

~~63[启动 Remote Control 会话](https://code.claude.com/docs/zh-CN/remote-control.md#start-a-remote-control-session)~~

~~65其他改进~~

67Claude Code 现在在 claude.ai 使用限制重置时自动继续您的会话；从 `/config` 中的 **Continue automatically at usage limit** 行关闭它可选的 [`spellcheck` 设置](https://code.claude.com/docs/zh-CN/interactive-mode#check-spelling-as-you-type)在您键入时在提示输入中为拼写错误的单词加下划线，使用您安装的 `aspell`、`hunspell` 或 `ispell`在具有开放 GitLab 合并请求的分支上，使用通过 `glab auth login` 进行身份验证的 `glab` CLI，页脚显示一个 [`MR !N` 徽章](https://code.claude.com/docs/zh-CN/interactive-mode#gitlab-merge-requests)，其颜色取决于合并请求是草稿、开放还是可合并从手机或 claude.ai/code 更改工作量级别，它 [应用于您机器上的会话](https://code.claude.com/docs/zh-CN/remote-control.md#what-connected-devices-see)；由 Desktop 或 VS Code 托管的 Remote Control 会话也向连接的设备显示会话的当前权限模式您可以在 Claude 工作时打开 [`/permissions`](https://code.claude.com/docs/zh-CN/permissions#manage-permissions) 或运行 `/add-dir <path>`；权限规则更改适用于当前轮次的其余部分当后台任务使 [`/goal`](https://code.claude.com/docs/zh-CN/goal#background-work-defers-evaluation) 等待时，Claude 在 30 分钟后检查它们，而不是无限期等待，并继续检查，在会话空闲时以更长的间隔检查；设置 `CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0` 以选择退出您自己的提示现在在成绩单中呈现 markdown，具有突出显示的代码块、内联代码和列表，与回复的方式相同新的 [`ANTHROPIC_DEFAULT_MODEL`](https://code.claude.com/docs/zh-CN/model-config#set-a-default-model-for-new-sessions) 环境变量设置新会话启动的模型；`/model` 选择仍会覆盖它并在重启后保持使用 `SendMessage` 上的 `notify_when_idle` 输入，Claude 可以要求同一机器上的另一个 Claude Code 会话 [在它下次空闲时发送一个通知](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#get-a-notice-when-another-session-goes-idle)将 [`keybindingFlavor`](https://code.claude.com/docs/zh-CN/interactive-mode#make-ctrl-w-delete-back-to-whitespace) 设置为 `"readline"`，使提示中的 `Ctrl+W` 删除回到前一个空格，如 Bash 所做的那样，而不是在标点符号（如 `/`）处停止在本机 Windows 上，您的 Claude Code 会话现在可以 [相互消息](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#availability)，使用 `SendMessage` 并使用 `ListAgents` 找到彼此，如在 macOS 和 Linux 上一样自托管运行器接受 `--defer-shutdown-max-min`，它 [在 SIGTERM 后的设定分钟数内继续为附加会话提供服务](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy.md#defer-the-drain-past-the-first-signal)自托管运行器接受 `--proxy-authorization-command` 或 `--proxy-authorization-file` 为 [需要一个的出口代理提供新的 `Proxy-Authorization` 标头](https://code.claude.com/docs/zh-CN/self-hosted-environments-deploy#authenticate-to-an-egress-proxy)

~~69[v2.1.234–v2.1.239 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-234)~~

whats-new/2026-w35.md +0 −65 deleted

File Deleted View Diff

~~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# 第 35 周 · 2026 年 8 月 24–28 日~~

~~7> 在 Claude Code Desktop 应用中恢复终端会话，查看 Claude 为您起草的反馈报告，并在受限模式下启动会话。~~

~~9发布版本 [v2.1.240 → v2.1.250](https://code.claude.com/docs/en/changelog.md#2-1-240)~~

~~103 项功能 · 8 月 24–28 日~~

~~12在 Desktop 应用中恢复终端会话~~

~~13Desktop~~

15在 Claude Code Desktop 提示框中输入 `/resume` 以选择您从 CLI 启动的任何会话，并在应用中继续该会话，保持完整的对话和上下文。按标题、文件夹或分支搜索您的会话，并在恢复前预览您停止的位置。

17<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/desktop-resume-cli-session.mp4?fit=max&auto=format&n=f9HTZGyMtxIFOUgt&q=85&s=41e4a5fda6b9d63280589f2cbdabf44f" />

~~19在 Desktop 会话中，运行命令以列出您的终端会话：~~

~~21```text Claude Code theme={null}~~

~~22> /resume~~

~~23```~~

~~25选择一个会话并按 `Enter`。对话将在您停止的位置在应用中打开。~~

~~27[在 CLI 和 Desktop 之间移动](https://code.claude.com/docs/zh-CN/desktop.md#coming-from-the-cli)~~

~~29Claude 起草的反馈~~

~~30CLI~~

32当工具持续失败、Claude 无法帮助处理请求或您指出错误时，Claude 现在会使用 `SendFeedback` 工具为您起草反馈报告。您的提示上方会显示一张卡片，您可以从那里查看、发送或关闭它。在您发送之前，任何内容都不会到达 Anthropic。需要 v2.1.238 或更高版本。

34![一个 Claude Code 会话，其中 Claude 已起草了一份标题为"Sandbox image pull fails behind proxy"的错误报告，显示为提示上方的卡片，带有查看、发送或关闭的选项](https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/claude-drafted-feedback.jpg?fit=max\&auto=format\&n=f9HTZGyMtxIFOUgt\&q=85\&s=5cacb3be0dffd1cbd417381f3721637e)

~~36运行 `/feedback` 不带参数以打开来自每个会话的草稿队列：~~

~~38```text Claude Code theme={null}~~

~~39> /feedback~~

~~40```~~

~~42选择一份草稿，然后编辑、发送或丢弃它。要关闭起草功能，请在 `/config` 中将 **Claude-drafted feedback** 设置为 `off`。~~

~~44[SendFeedback 工具行为](https://code.claude.com/docs/zh-CN/tools-reference.md#sendfeedback-tool-behavior)~~

~~46受限模式~~

~~47v2.1.248~~

49受限模式启动 Claude Code 时不包含运行命令或代码的内置工具。当评估工具在共享机器上驱动 `claude` 时使用它。使用 `--restricted` 启动或设置 `CLAUDE_CODE_RESTRICTED=1`。Claude Code 还会移除 `WebFetch`，将文件工具限制在工作目录中，仅加载托管设置和 `--settings`，并拒绝 `bypassPermissions` 权限模式。

~~51运行不带命令运行工具的非交互式查询：~~

~~53```bash terminal theme={null}~~

~~54claude --restricted -p "review src/ for SQL injection risks"~~

~~55```~~

57要为 Claude 恢复已移除的工具之一，请在 `--tools` 中将其与您想要的其他内置工具一起列出，例如 `--tools "Bash,Read,Edit"`。`--tools` 是一个允许列表，其 `default` 预设不会恢复已移除的工具。

~~59[CLI 标志](https://code.claude.com/docs/zh-CN/cli-reference.md#cli-flags)~~

~~61其他亮点~~

63设置新的 [`modelPicker`](https://code.claude.com/docs/zh-CN/settings-reference#modelpicker) 设置以使用您自己的有序、标记的条目扩展或替换 `/model` 选择器的内置列表，包括 Amazon Bedrock 或 Google Cloud 的 Agent Platform 模型 ID将 [`promptCacheTtl`](https://code.claude.com/docs/zh-CN/prompt-caching#choose-the-ttl-yourself) 设置为 `1h` 以在使用 API 密钥或云提供商时在主对话上保持一小时的提示缓存；`subagentPromptCacheTtl` 为子代理和主对话外的所有其他请求设置 TTL在 Pro、Max、Team 和 Enterprise 计划上，[`/usage`](https://code.claude.com/docs/zh-CN/costs#plan-usage-breakdown) 添加了 Loops 分解：运行计数、总令牌数、每次运行的令牌数以及使用最多令牌的 `/loop` 和计划任务的最后一次运行按合同费率的组织可以设置 [`modelPricing`](https://code.claude.com/docs/zh-CN/costs#report-spend-at-your-contracted-rates) 托管设置，以便 `/usage`、状态行和 OpenTelemetry 按这些费率而不是列表价格报告成本`/login` 在 **Anthropic Console 账户**选项下提供 **使用您的 Console 账户登录**，因此 Console 组织的成员如果不允许 API 密钥，可以在不创建 API 密钥的情况下登录运行 `/permissions` 并打开新的 [**Auto mode** 标签页](https://code.claude.com/docs/zh-CN/auto-mode-config.md#edit-rules-from-permissions)以查看和编辑自动模式分类器规则，而无需打开设置文件当自动模式可用时，Manual 和 `acceptEdits` 权限模式中的 Bash 权限提示提供 [**是的，并切换到自动模式**](https://code.claude.com/docs/zh-CN/permission-modes.md#switch-permission-modes)选项；选择它以批准命令并将会话切换到自动模式在您 [使用 `/cd` 移动会话](https://code.claude.com/docs/zh-CN/permissions#move-the-session-to-another-directory)后，新目录的项目设置、hooks、`.mcp.json` 服务器、skills 和子代理立即生效，而不是在下一个 `--resume` 时生效在非交互式会话中，包括 `-p` 运行、Agent SDK 运行和云会话，Claude Code [继续响应](https://code.claude.com/docs/zh-CN/errors.md#the-response-above-may-be-incomplete)，该响应被服务器错误、连接断开或停滞中断，当部分响应包含文本且没有工具调用时在其 `maxTurns` 限制处停止的子代理返回其输出标记为部分，并提示 Claude 可以 [使用 `SendMessage` 继续它](https://code.claude.com/docs/zh-CN/sub-agents#resume-subagents)，而不是显示为已完成在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上，同一机器上的会话现在可以 [相互消息](https://code.claude.com/docs/zh-CN/cross-session-messaging.md#availability)，`/loop` 可以 [选择自己的间隔](https://code.claude.com/docs/zh-CN/scheduled-tasks.md#let-claude-choose-the-interval)，`/model` 和 `/effort` 立即应用而不是在回合结束后应用本机安装程序和自动更新程序下载 zstd 压缩的构建，在 Linux x64 上约为 75 MB 而不是 340 MB，本机构建按需加载代码，每个会话使用的内存大约少 40 到 70 MB

~~65[v2.1.240–v2.1.250 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-240)~~

whats-new/2026-w36.md +0 −72 deleted

File Deleted View Diff

~~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# 第 36 周 · 8 月 31 日 – 9 月 4 日，2026 年~~

~~7> 切换到 Claude Fable 5.1，让计算机使用在 Desktop 上后台运行，并在实时 /diff 面板中观看 Claude 的编辑。~~

~~9Releases [v2.1.251 → v2.1.261](https://code.claude.com/docs/en/changelog.md#2-1-251)~~

~~104 个功能 · 8 月 31 日 – 9 月 4 日~~

~~12Claude Fable 5.1~~

~~13新模型~~

15Claude Fable 5.1 在 Claude Code 中可用，具有 1M 令牌上下文窗口，`fable` 别名现在选择它。在 Claude 应用网关会话中，`fable` 仍然选择 Fable 5。如果您的网关提供 Fable 5.1，请运行 `/model claude-fable-5-1`。需要 v2.1.257 或更高版本。

~~17将当前会话切换到 Fable 5.1 并将其保存为默认值：~~

~~19```text Claude Code theme={null}~~

~~20> /model fable~~

~~21```~~

~~23在 Anthropic API 上，选择器仅在服务器报告您的组织可用时才列出 Fable，但键入 `/model fable` 会直接与服务器检查。~~

~~25[使用 Fable](https://code.claude.com/docs/zh-CN/model-config.md#work-with-fable)~~

~~27计算机使用在 Desktop 上后台运行~~

~~28Desktop~~

30在 macOS 上，Claude Code Desktop 应用中的计算机使用现在可以在后台工作：Claude 可以在您批准的应用中查看和操作，同时您继续工作。后台计算机使用在 Pro 和 Max 计划上处于测试阶段。

32![一个 Claude Code Desktop 会话，其中 Claude 请求使用 Xcode，旁边有一张计算机使用权限卡，上面写着"让 Claude 在您批准的应用中查看和操作，在后台或完全控制您的屏幕"，以及一个"启用"按钮](https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/background-computer-use.jpg?fit=max\&auto=format\&n=f9HTZGyMtxIFOUgt\&q=85\&s=a599a6c6fa544cb8d1b426b93706caf4)

~~34[让 Claude 使用您的计算机](https://code.claude.com/docs/zh-CN/desktop.md#let-claude-use-your-computer)~~

~~36全屏渲染中的实时 diff 面板~~

~~37v2.1.260~~

39在全屏渲染中，`/diff` 现在在对话旁边打开一个面板，而不是您必须关闭的查看器。该面板列出更改的文件及其添加和删除的行数，并在每次 Claude 编辑文件或运行 shell 命令时刷新。在面板中用鼠标选择行以将其附加到您的下一个提示。

41<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/diff-panel.mp4?fit=max&auto=format&n=f9HTZGyMtxIFOUgt&q=85&s=9d7553c19e7f227891cd95f1f59d796d" />

~~43启用全屏渲染，在 git 存储库中，并在至少 110 列宽的终端中，切换面板：~~

~~45```text Claude Code theme={null}~~

~~46> /diff~~

~~47```~~

~~49再次运行 `/diff` 或单击其标题中的 `✕` 来关闭它。~~

~~51[Diff 面板](https://code.claude.com/docs/zh-CN/interactive-mode.md#diff-panel)~~

~~53使用 /skill-doctor 查找未使用的 skills~~

~~54CLI~~

56`/skill-doctor` 显示您的每个 skill 在上下文中的成本以及它被使用的频率，因此您可以决定关闭哪些。[skill 列表](https://code.claude.com/docs/zh-CN/skills.md#skill-descriptions-are-cut-short)中的每个 skill 都会在每个回合中添加到您的上下文中，无论 Claude 是否使用它。需要 v2.1.252 或更高版本，在跳过[功能标志获取](https://code.claude.com/docs/zh-CN/env-vars.md#features-that-need-feature-flag-fetching)的会话中不可用。

~~58在交互式会话中运行它以在 `/plugin` 管理器的**Stats**选项卡中打开报告：~~

~~60```text Claude Code theme={null}~~

~~61> /skill-doctor~~

~~62```~~

~~64在非交互模式下使用 `-p`，Claude Code 会将报告打印为文本。~~

~~66[查找未使用的 skills](https://code.claude.com/docs/zh-CN/skills.md#find-unused-skills)~~

~~68其他亮点~~

70[`PreModelSwitch`](https://code.claude.com/docs/zh-CN/hooks#premodelswitch) hook 可以阻止您请求的模型切换，[`PostModelSwitch`](https://code.claude.com/docs/zh-CN/hooks#postmodelswitch) hook 可以在会话的模型更改后为 Claude 添加上下文[`/cost`](https://code.claude.com/docs/zh-CN/costs#prompt-cache-statistics) 添加了一行 `Prompt cache (main)`：从缓存提供的输入令牌份额、缓存未命中、缓存是否预热，以及当 Claude Code 可以命名一个时上次未命中的可能原因。状态行脚本获得匹配的 `prompt_cache` 对象组织可以在[`managedMcpServers`](https://code.claude.com/docs/zh-CN/managed-mcp#provide-servers-through-managed-settings) 托管设置下列出 HTTP 和 SSE MCP 服务器，以将其提供给每个用户，除了用户自己添加的服务器`/effort` 和 `/model` 选择器现在[为每个模型保存单独的努力级别](https://code.claude.com/docs/zh-CN/model-config.md#adjust-effort-level)；按 `s` 而不是 `Enter` 仅将级别应用于当前会话默认情况下，自动模式分类器[现在也阻止](https://code.claude.com/docs/zh-CN/permission-modes.md#what-the-classifier-blocks-by-default)诸如从云实例元数据端点请求凭证或连接到 Claude 未启动的同级容器等操作在自动模式下，Claude Code 在 Claude [首次读取工作目录外的文件](https://code.claude.com/docs/zh-CN/permission-modes.md#first-read-outside-the-working-directories)之前询问您，并提供从那时起阻止此类读取的选项提高 [`bashOutputMaxChars`](https://code.claude.com/docs/zh-CN/settings-reference#bashoutputmaxchars) 和 [`taskOutputMaxChars`](https://code.claude.com/docs/zh-CN/settings-reference#taskoutputmaxchars)，最高可达 128,000 个字符，以便 Claude 内联接收来自成功命令或后台任务的更多输出提示的[字编辑快捷键遵循 readline](https://code.claude.com/docs/zh-CN/interactive-mode.md#make-ctrl-w-delete-back-to-whitespace) 对所有人，`keybindingFlavor` 设置不再有任何效果。`Ctrl+W` 删除回到前一个空格，`Alt+B`、`Alt+F` 和 `Alt+D` 将标点符号（如 `/` 和 `.`）视为单词分隔符如果您在项目的 `.claude/settings.json` 或 `.claude/settings.local.json` 中将 `defaultMode` 设置为 `"bypassPermissions"`，它[不再生效](https://code.claude.com/docs/zh-CN/permission-modes.md#which-mode-a-session-starts-in)，会话以手动模式启动；改为在用户或托管设置中设置 `"bypassPermissions"`，或传递 `--permission-mode`基于座位的企业计划现在[默认为 Opus 5](https://code.claude.com/docs/zh-CN/model-config.md#default-model-setting)在 VS Code 扩展中，单击提示框底部的模型名称以[打开模型选择器](https://code.claude.com/docs/zh-CN/vs-code.md#use-the-prompt-box)在 VS Code 扩展中，在命令菜单的"自定义"部分中选择**输出样式**以[选择输出样式](https://code.claude.com/docs/zh-CN/vs-code.md#use-the-prompt-box)，包括您的自定义样式

~~72[v2.1.251–v2.1.261 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-251)~~

whats-new/2026-w37.md +0 −42 deleted

File Deleted View Diff

~~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# 第37周 · 2026年9月7日–11日~~

~~7> 使用 claude plugin eval 测试您的插件，并将 Claude Code Desktop 窗格弹出到各自的窗口中。~~

~~9发布版本 [v2.1.263 → v2.1.269](https://code.claude.com/docs/en/changelog.md#2-1-263)~~

~~102 项功能 · 9月7日–11日~~

~~12使用 claude plugin eval 测试插件~~

~~13v2.1.269~~

15`claude plugin eval` 针对一套测试用例运行您的插件，对结果进行评分，默认情况下每个用例都会再次运行一次（不使用插件），以便您可以看到它的贡献。`claude plugin eval init` 询问您什么是好的结果，然后提议测试用例和对其进行评分的检查，尝试一次该套件，并写入文件。每次运行，以及每个有第二个模型判断回复的检查，都是您账户上的真实模型调用。

17![claude plugin eval 的终端输出：一个包含七个用例的表格，每个用例都显示有插件和无插件的分数、两者之间的差值、运行次数和成本，后面是一个汇总行，显示平均差值、总持续时间和总成本](https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/plugin-eval.jpg?fit=max\&auto=format\&n=f9HTZGyMtxIFOUgt\&q=85\&s=913066f6d4a2a15426e98a627802f47f)

~~19从您的插件根目录，让 Claude 起草该套件：~~

~~21```bash terminal theme={null}~~

~~22claude plugin eval init~~

~~23```~~

25当 Claude 告诉您该套件已准备好时，退出 `claude plugin eval init` 打开的会话，并运行 `claude plugin eval .` 来对每个用例进行评分。汇总表在您的终端中打印，`evals/results/` 下的 `report.html` 包含每次运行的详细信息。

~~27[使用 evals 测试插件](https://code.claude.com/docs/zh-CN/plugin-evals.md)~~

~~29将 Desktop 窗格弹出到各自的窗口中~~

~~30Desktop~~

32在 Claude Code Desktop 应用中，您可以将任何窗格弹出到其自己的窗口中。将 diff 或终端拖到第二个屏幕，同时 Claude 在主窗口中继续工作，然后在完成后将窗格停靠回去。

34<video autoPlay muted loop playsInline src="https://mintcdn.com/claude-code/f9HTZGyMtxIFOUgt/images/whats-new/desktop-pop-out-panes.mp4?fit=max&auto=format&n=f9HTZGyMtxIFOUgt&q=85&s=ff3770dd09bb15ed9cf17a460f3d1e23" />

~~36[整理您的工作区](https://code.claude.com/docs/zh-CN/desktop.md#arrange-your-workspace)~~

~~38其他改进~~

40在顶级或 `modelSettings` 下按模型设置 [`maxEffortLevel`](https://code.claude.com/docs/zh-CN/settings-reference#maxeffortlevel) 以限制每个提供商（包括 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry）上的努力级别；任何更高的级别都以上限运行将 `--plugin-dir` 指向一个插件文件夹，以 [加载每个具有清单的直接子文件夹](https://code.claude.com/docs/zh-CN/plugins/create.md#load-a-directory-or-archive-for-one-session)如果 WebFetch 在五分钟内未完成下载页面，[获取失败并显示截止时间错误](https://code.claude.com/docs/zh-CN/tools-reference.md#webfetch-tool-behavior)，而不是挂起；设置 `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` 以更改截止时间，或设置为 `0` 以移除限制将 `--json` 传递给 `claude plugin install`、`uninstall`、`update`、`enable` 或 `disable` 以将结果打印为 [stdout 最后一行的一个 JSON 对象](https://code.claude.com/docs/zh-CN/plugins/cli-reference.md#plugin-json-result)当自动模式分类器阻止一个操作时，Claude 收到的原因 [通常会命名匹配的规则](https://code.claude.com/docs/zh-CN/auto-mode-config.md#fix-a-denial-with-an-allow-rule-an-environment-entry-or-a-retry)，例如 `[Data Exfiltration]`当您在提示中途键入 `/` 时，您现在可以从 [匹配命令的列表](https://code.claude.com/docs/zh-CN/interactive-mode.md#complete-a-command-mid-prompt)中选择，而不是单个建议。该列表在全屏渲染中键入时打开。插件技能也可以按其名称（不带插件前缀）进行匹配在 VS Code 扩展中，单击提示框底部的代理计数以打开 [代理地图](https://code.claude.com/docs/zh-CN/vs-code.md#use-the-prompt-box)，您可以在其中打开子代理的只读记录或停止它在 VS Code 扩展中，在命令菜单的"自定义"部分中选择 **Hooks** 或 **Permissions** 以 [在您的用户、项目和本地设置中添加或删除 hooks 和权限规则](https://code.claude.com/docs/zh-CN/vs-code.md#use-the-prompt-box)Claude 可以选择一个 [浏览器标签图标](https://code.claude.com/docs/zh-CN/artifacts.md#create-an-artifact)来匹配它发布的每个工件在 Claude Code 网页版中，在 Claude 读取之前在云会话中取回一条排队的消息：从队列中删除它，或按 `Esc` 或 `Up`，文本返回到消息框

~~42[v2.1.263–v2.1.269 的完整更新日志 →](https://code.claude.com/docs/en/changelog.md#2-1-263)~~

Documentation 2026-11-10 21:57 UTC to 2026-11-11 22:59 UTC