SpyBara
Go Premium

Documentation 2026-07-10 17:00 UTC to 2026-07-11 19:03 UTC

22 files changed +251 −50. View all changes and history on the product overview
2026
Fri 31 22:02 Wed 29 19:02 Tue 28 23:57 Mon 27 21:02 Sun 26 19:02 Sat 25 21:59 Fri 24 23:01 Thu 23 23:57 Wed 22 23:59 Tue 21 23:00 Mon 20 23:01 Sat 18 16:02 Fri 17 22:57 Thu 16 22:59 Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01
Details

835 835 

836* **[自定义工具指南](/zh-CN/agent-sdk/custom-tools)**:构建您自己的 MCP 服务器,与您的 SDK 应用程序在进程中运行836* **[自定义工具指南](/zh-CN/agent-sdk/custom-tools)**:构建您自己的 MCP 服务器,与您的 SDK 应用程序在进程中运行

837* **[权限](/zh-CN/agent-sdk/permissions)**:使用 `allowedTools` 和 `disallowedTools` 控制您的代理可以使用哪些 MCP 工具837* **[权限](/zh-CN/agent-sdk/permissions)**:使用 `allowedTools` 和 `disallowedTools` 控制您的代理可以使用哪些 MCP 工具

838* **[MCP 输出限制和警告](/zh-CN/mcp#mcp-output-limits-and-warnings)**:SDK 如何处理超过 `MAX_MCP_OUTPUT_TOKENS` 的工具结果,包括持久化到磁盘的回退和 `anthropic/maxResultSizeChars` 按工具注解

838* **[TypeScript SDK 参考](/zh-CN/agent-sdk/typescript)**:完整的 API 参考,包括 MCP 配置选项839* **[TypeScript SDK 参考](/zh-CN/agent-sdk/typescript)**:完整的 API 参考,包括 MCP 配置选项

839* **[Python SDK 参考](/zh-CN/agent-sdk/python)**:完整的 API 参考,包括 MCP 配置选项840* **[Python SDK 参考](/zh-CN/agent-sdk/python)**:完整的 API 参考,包括 MCP 配置选项

840* **[MCP 服务器目录](https://github.com/modelcontextprotocol/servers)**:浏览可用的 MCP 服务器,用于数据库、API 等841* **[MCP 服务器目录](https://github.com/modelcontextprotocol/servers)**:浏览可用的 MCP 服务器,用于数据库、API 等

Details

267 267 

268将这些环境变量设置为特定的 Amazon Bedrock 模型 ID。268将这些环境变量设置为特定的 Amazon Bedrock 模型 ID。

269 269 

270如果没有 `ANTHROPIC_DEFAULT_OPUS_MODEL`,Amazon Bedrock 上的 `opus` 别名会解析为 Opus 4.6。将其设置为 Opus 4.8 ID 以使用最新模型270如果没有这些变量,Amazon Bedrock 上的 `opus` 别名会解析为 Opus 4.8,`sonnet` 别名会解析为 Sonnet 4.5。将每个变量设置为特定版本以固定其别名

271 271 

272```bash theme={null}272```bash theme={null}

273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'273export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'


280Claude Code 使用这些默认模型当未设置固定变量时:280Claude Code 使用这些默认模型当未设置固定变量时:

281 281 

282| 模型类型 | 默认值 |282| 模型类型 | 默认值 |

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

284| 主模型 | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| 主模型 | `us.anthropic.claude-opus-4-8` |

285| 小型/快速模型 | 与主模型相同 |285| 小型/快速模型 | 与主模型相同 |

286 286 

287后台任务(如会话标题生成)使用小型/快速模型,通常是 Haiku 级别的模型。在 Amazon Bedrock 上,Claude Code 默认将其设置为主模型,因为并非每个账户或区域都启用了 Haiku。要为后台任务使用 Haiku,请将 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 设置为您账户中可用的模型 ID。287后台任务(如会话标题生成)使用小型/快速模型,通常是 Haiku 级别的模型。在 Amazon Bedrock 上,Claude Code 默认将其设置为主模型,因为并非每个账户或区域都启用了 Haiku。要为后台任务使用 Haiku,请将 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 设置为您账户中可用的模型 ID。

Details

276 3. 固定模型版本276 3. 固定模型版本

277</h3>277</h3>

278 278 

279AWS 上的 Claude Platform 使用与直接 Claude API 相同的模型 ID。默认别名 `fable`、`opus`、`sonnet` 和 `haiku` 解析为 Claude Code 为 AWS 上的 Claude Platform 内置的默认值,这些值可能滞后于最新版本。如果没有 `ANTHROPIC_DEFAULT_OPUS_MODEL`,`opus` 别名解析为 Opus 4.7279AWS 上的 Claude Platform 使用与直接 Claude API 相同的模型 ID。默认别名 `fable`、`opus`、`sonnet` 和 `haiku` 解析为 Claude Code 为 AWS 上的 Claude Platform 内置的默认值,这些值可能滞后于最新版本。如果没有 `ANTHROPIC_DEFAULT_OPUS_MODEL`,`opus` 别名解析为 Opus 4.8

280 280 

281如果您将 Claude Code 部署到团队,请显式固定模型 ID,以便新版本不会一次性移动所有人:281如果您将 Claude Code 部署到团队,请显式固定模型 ID,以便新版本不会一次性移动所有人:

282 282 

283```bash theme={null}283```bash theme={null}

284export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5284export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5

285export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7285export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8

286export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5286export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

287export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5287export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

288```288```

Details

275 275 

276有时您希望 Claude 在每次编辑之前请求许可。有时您只是希望它发货。您不应该永远选择一个。276有时您希望 Claude 在每次编辑之前请求许可。有时您只是希望它发货。您不应该永远选择一个。

277 277 

278*Shift+Tab* 循环通过 Claude 获得多少自由度:*Manual*(`default` 设置值)在每个操作之前请求,*acceptEdits* 让文件编辑和常见文件系统命令流通,同时仍在其他 shell 命令之前检查,*plan* 在触及任何东西之前为您的批准提议更改。Plan 模式是信任构建者,所以对于任何触及多个文件的东西,从那里开始。278*Shift+Tab* 循环通过 Claude 获得多少自由度:*Manual*(`default` 设置值)在文件编辑和大多数 shell 命令之前请求,*acceptEdits* 让文件编辑和常见文件系统命令流通,同时仍在其他 shell 命令之前检查,*plan* 在触及任何东西之前为您的批准提议更改。Plan 模式是信任构建者,所以对于任何触及多个文件的东西,从那里开始。

279 279 

280*现在尝试:* 在您的下一个重构上,按 Shift+Tab 直到您看到"plan",然后描述更改。您将在单个文件移动之前获得完整的提议。280*现在尝试:* 在您的下一个重构上,按 Shift+Tab 直到您看到"plan",然后描述更改。您将在单个文件移动之前获得完整的提议。

281 281 


444针对您最常被问到的问题的单行回复。444针对您最常被问到的问题的单行回复。

445 445 

446| 问题 | 回复 |446| 问题 | 回复 |

447| ------------------- | ------------------------------------------------------------------------------------------------------- |447| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

448| "它在 VS Code 中工作吗?" | 是的。有一个 VS Code 扩展和一个 JetBrains 插件,具有相同的功能,嵌入在您的编辑器中。[VS Code →](/zh-CN/vs-code) |448| "它在 VS Code 中工作吗?" | 是的。有一个 VS Code 扩展和一个 JetBrains 插件,具有相同的功能,嵌入在您的编辑器中。[VS Code →](/zh-CN/vs-code) |

449| "我必须先配置什么吗?" | 不。安装,然后在任何仓库中运行 `claude`。运行一次 `/init`,您就设置好了。[快速入门 →](/zh-CN/quickstart) |449| "我必须先配置什么吗?" | 不。安装,然后在任何仓库中运行 `claude`。运行一次 `/init`,您就设置好了。[快速入门 →](/zh-CN/quickstart) |

450| "我的代码去哪里了?" | CLI 在您的终端中运行,并将上下文发送到 Anthropic 的 API 进行推理,没有第三方服务器。根据您的企业计划,您的代码和提示不用于训练模型。[数据使用 →](/zh-CN/data-usage) |450| "我的代码去哪里了?" | CLI 在您的终端中运行,并将上下文发送到 Anthropic 的 API 进行推理,没有第三方服务器。根据您的企业计划,您的代码和提示不用于训练模型。[数据使用 →](/zh-CN/data-usage) |

451| "它能看到我的整个仓库吗?" | 它读取您给它访问权限的内容。您工作目录内的文件读取不提示;权限提示门控编辑、shell 命令和该目录外的任何东西。[权限 →](/zh-CN/permissions) |451| "它能看到我的整个仓库吗?" | 它读取您给它访问权限的内容。您工作目录内的文件读取不提示;权限提示门控编辑、非只读 shell 命令和该目录外的文件工具读取一组内置的只读 shell 命令(如 `ls` 和 `cat`)无需提示即可运行;使用[沙箱 `denyRead` 规则](/zh-CN/sandboxing#filesystem-isolation)限制它。[权限 →](/zh-CN/permissions) |

452| "这与 Copilot 有什么不同?" | Copilot 自动完成行。Claude Code 是一个读取文件、运行命令和进行多文件编辑的代理。[概述 →](/zh-CN/overview) |452| "这与 Copilot 有什么不同?" | Copilot 自动完成行。Claude Code 是一个读取文件、运行命令和进行多文件编辑的代理。[概述 →](/zh-CN/overview) |

453| "我应该首先尝试什么?" | 您一直在推迟的错误,因为它很乏味。"文件 \[file] 中的测试不稳定,找出原因。" [快速入门 →](/zh-CN/quickstart) |453| "我应该首先尝试什么?" | 您一直在推迟的错误,因为它很乏味。"文件 \[file] 中的测试不稳定,找出原因。" [快速入门 →](/zh-CN/quickstart) |

454 454 

desktop.md +1 −1

Details

94 94 

95<span id="auto-mode-availability" />95<span id="auto-mode-availability" />

96 96 

97Auto mode 是一个研究预览版,在 Anthropic API 上对所有用户可用,需要 Claude Opus 4.6 或更高版本,或 Sonnet 4.6 或更高版本。在路由到 Google Cloud 的 Agent Platform 的企业部署中,Auto mode 处于关闭状态,直到你[设置 `CLAUDE_CODE_ENABLE_AUTO_MODE`](/zh-CN/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry),并且只有 Claude Sonnet 5、Opus 4.7 和 Opus 4.8 在那里受支持。97Auto mode 在 Anthropic API 上对所有用户可用,需要 Claude Opus 4.6 或更高版本,或 Sonnet 4.6 或更高版本。在路由到 Google Cloud 的 Agent Platform 的企业部署中,Auto mode 处于关闭状态,直到你[设置 `CLAUDE_CODE_ENABLE_AUTO_MODE`](/zh-CN/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry),并且只有 Claude Sonnet 5、Opus 4.7 和 Opus 4.8 在那里受支持。

98 98 

99<Tip title="最佳实践">99<Tip title="最佳实践">

100 在 Plan 中启动复杂任务,以便 Claude 在进行更改之前制定方法。一旦你批准计划,切换到 Accept edits 或 Manual 来执行它。有关此工作流的更多信息,请参阅[先探索,然后计划,然后编码](/zh-CN/best-practices#explore-first-then-plan-then-code)。100 在 Plan 中启动复杂任务,以便 Claude 在进行更改之前制定方法。一旦你批准计划,切换到 Accept edits 或 Manual 来执行它。有关此工作流的更多信息,请参阅[先探索,然后计划,然后编码](/zh-CN/best-practices#explore-first-then-plan-then-code)。

desktop-linux.md +10 −2

Details

75 从下载的文件安装75 从下载的文件安装

76</h3>76</h3>

77 77 

78如果您无法使用 apt 存储库请首先从 [claude.com/download](https://claude.com/download) 下载适用于您的架构(x64 或 arm64)的 `.deb` 软件包。然后使用软件安装程序打开下载的文件或从包含下载文件的目录使用 apt 安装它78如果您无法通过 apt 存储库安装请直接从存储库的软件包池下载 `.deb` 软件包。此命令在存储库索引中查找您的架构的最新软件包然后将其下载到当前目录

79 

80```bash theme={null}

81curl -fLO "https://downloads.claude.ai/claude-desktop/apt/stable/$(curl -s "https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-$(dpkg --print-architecture)/Packages" | grep '^Filename: pool/main/c/claude-desktop/claude-desktop_' | sort -V | tail -n 1 | cut -d' ' -f2)"

82```

83 

84如果命令失败并显示 `Remote file name has no length`,则查找未返回软件包路径。这可能意味着无法获取存储库索引,例如当您的网络阻止 `downloads.claude.ai` 时,或者您的架构不存在软件包。确认您的网络可以访问 `downloads.claude.ai`,并且 `dpkg --print-architecture` 输出 `amd64` 或 `arm64`;存储库不为其他架构发布软件包。

85 

86然后使用软件安装程序(如 GNOME Software)打开下载的文件,或从包含下载文件的目录使用 apt 安装它:

79 87 

80```bash theme={null}88```bash theme={null}

81sudo apt install ./claude-desktop_*.deb89sudo apt install ./claude-desktop_*.deb


83 91 

84如果 apt 报告 `E: Unsupported file ./claude-desktop_*.deb given on commandline`,则该模式与当前目录中的 `.deb` 文件不匹配。确认下载已完成,然后从包含该文件的目录再次运行该命令。92如果 apt 报告 `E: Unsupported file ./claude-desktop_*.deb given on commandline`,则该模式与当前目录中的 `.deb` 文件不匹配。确认下载已完成,然后从包含该文件的目录再次运行该命令。

85 93 

86以这种方式安装的 `.deb` 不会接收更新。要通过 apt 获取更新,请添加上面显示的存储库,或取消注释软件包写入 `/etc/apt/sources.list.d/claude-desktop.list` 的占位符条目中的 `deb` 94以这种方式安装的 `.deb` 不会接收更新。要通过 apt 获取更新,请从 [添加 Anthropic 的 apt 存储库](#install) 步骤注册存储库。该软件包还会向 `/etc/apt/sources.list.d/claude-desktop.list` 写入一个注释掉的存储库条目;取消注释其 `deb` 行等同于注册存储库

87 95 

88<h2 id="update">96<h2 id="update">

89 更新97 更新

errors.md +13 −13

Details

31| `Auto mode could not evaluate this action and is blocking it for safety` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |31| `Auto mode could not evaluate this action and is blocking it for safety` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |

32| `Auto mode classifier transcript exceeded context window` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |32| `Auto mode classifier transcript exceeded context window` | [服务器错误](#auto-mode-cannot-determine-the-safety-of-an-action) |

33| `Agent terminated early due to an API error` | [服务器错误](#agent-terminated-early-due-to-an-api-error) |33| `Agent terminated early due to an API error` | [服务器错误](#agent-terminated-early-due-to-an-api-error) |

34| `You've hit your session limit` / `You've hit your weekly limit` | [使用限制](#you%E2%80%99ve-hit-your-session-limit) |34| `You've hit your session limit` / `You've hit your weekly limit` | [使用限制](#youve-hit-your-session-limit) |

35| `Usage credits required for 1M context` | [使用限制](#usage-credits-required-for-1m-context) |35| `Usage credits required for 1M context` | [使用限制](#usage-credits-required-for-1m-context) |

36| `Server is temporarily limiting requests` | [使用限制](#server-is-temporarily-limiting-requests) |36| `Server is temporarily limiting requests` | [使用限制](#server-is-temporarily-limiting-requests) |

37| `Request rejected (429)` | [使用限制](#request-rejected-429) |37| `Request rejected (429)` | [使用限制](#request-rejected-429) |


42| `This organization has been disabled` | [身份验证](#this-organization-has-been-disabled) |42| `This organization has been disabled` | [身份验证](#this-organization-has-been-disabled) |

43| `Your organization has disabled API key authentication` | [身份验证](#your-organization-has-disabled-api-key-authentication) |43| `Your organization has disabled API key authentication` | [身份验证](#your-organization-has-disabled-api-key-authentication) |

44| `Your organization has disabled Claude subscription access` | [身份验证](#your-organization-has-disabled-claude-subscription-access) |44| `Your organization has disabled Claude subscription access` | [身份验证](#your-organization-has-disabled-claude-subscription-access) |

45| `Routines are disabled by your organization's policy` | [身份验证](#routines-are-disabled-by-your-organization%E2%80%99s-policy) |45| `Routines are disabled by your organization's policy` | [身份验证](#routines-are-disabled-by-your-organizations-policy) |

46| `Remote Control is only available when using Claude via api.anthropic.com` | [身份验证](#remote-control-requires-the-anthropic-api) |46| `Remote Control is only available when using Claude via api.anthropic.com` | [身份验证](#remote-control-requires-the-anthropic-api) |

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

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


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

54| `SSL certificate error (...)` during login or startup | [网络](#ssl-certificate-errors) |54| `SSL certificate error (...)` during login or startup | [网络](#ssl-certificate-errors) |

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

56| `Couldn't reconnect to your Remote Control session` | [网络](#couldn%E2%80%99t-reconnect-to-your-remote-control-session) |56| `Couldn't reconnect to your Remote Control session` | [网络](#couldnt-reconnect-to-your-remote-control-session) |

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

58| `Error during compaction: Conversation too long` | [请求错误](#error-during-compaction-conversation-too-long) |58| `Error during compaction: Conversation too long` | [请求错误](#error-during-compaction-conversation-too-long) |

59| `Request too large` | [请求错误](#request-too-large) |59| `Request too large` | [请求错误](#request-too-large) |


61| `Unable to resize image` | [请求错误](#unable-to-resize-image) |61| `Unable to resize image` | [请求错误](#unable-to-resize-image) |

62| `PDF too large` / `PDF is password protected` | [请求错误](#pdf-errors) |62| `PDF too large` / `PDF is password protected` | [请求错误](#pdf-errors) |

63| `Extra inputs are not permitted` | [请求错误](#extra-inputs-are-not-permitted) |63| `Extra inputs are not permitted` | [请求错误](#extra-inputs-are-not-permitted) |

64| `There's an issue with the selected model` | [请求错误](#there%E2%80%99s-an-issue-with-the-selected-model) |64| `There's an issue with the selected model` | [请求错误](#theres-an-issue-with-the-selected-model) |

65| `Model ... is not a recognized model id` | [请求错误](#model-is-not-a-recognized-model-id) |65| `Model ... is not a recognized model id` | [请求错误](#model-is-not-a-recognized-model-id) |

66| `Claude Opus is not available with the Claude Pro plan` | [请求错误](#claude-opus-is-not-available-with-the-claude-pro-plan) |66| `Claude Opus is not available with the Claude Pro plan` | [请求错误](#claude-opus-is-not-available-with-the-claude-pro-plan) |

67| `Model ... is restricted by your organization's settings` | [请求错误](#model-is-restricted-by-your-organization%E2%80%99s-settings) |67| `Model ... is restricted by your organization's settings` | [请求错误](#model-is-restricted-by-your-organizations-settings) |

68| `thinking.type.enabled is not supported for this model` | [请求错误](#thinking-type-enabled-is-not-supported-for-this-model) |68| `thinking.type.enabled is not supported for this model` | [请求错误](#thinking-type-enabled-is-not-supported-for-this-model) |

69| `max_tokens must be greater than thinking.budget_tokens` | [请求错误](#thinking-budget-exceeds-output-limit) |69| `max_tokens must be greater than thinking.budget_tokens` | [请求错误](#thinking-budget-exceeds-output-limit) |

70| `API Error: 400 due to tool use concurrency issues` | [请求错误](#tool-use-or-thinking-block-mismatch) |70| `API Error: 400 due to tool use concurrency issues` | [请求错误](#tool-use-or-thinking-block-mismatch) |


271 271 

272这些错误表示与您的账户或计划相关的配额已达到。它们不同于[服务器错误](#server-errors),后者会影响所有人。272这些错误表示与您的账户或计划相关的配额已达到。它们不同于[服务器错误](#server-errors),后者会影响所有人。

273 273 

274<h3 id="you’ve-hit-your-session-limit">274<h3 id="youve-hit-your-session-limit">

275 您已达到会话限制275 您已达到会话限制

276</h3>276</h3>

277 277 


312 312 

313* 运行 `/model` 并选择不带 `[1m]` 后缀的变体以回退到标准上下文窗口313* 运行 `/model` 并选择不带 `[1m]` 后缀的变体以回退到标准上下文窗口

314* 运行 `/usage-credits` 在 Pro 和 Max 上为 1M 变体启用按量计费,或在 Team 和 Enterprise 上向您的管理员请求314* 运行 `/usage-credits` 在 Pro 和 Max 上为 1M 变体启用按量计费,或在 Team 和 Enterprise 上向您的管理员请求

315* 如果 `/model` 后错误仍然存在,1M 模型 ID 可能在其他地方设置。有关要按优先级顺序检查的配置位置,请参阅[所选模型存在问题](#there%E2%80%99s-an-issue-with-the-selected-model)。315* 如果 `/model` 后错误仍然存在,1M 模型 ID 可能在其他地方设置。有关要按优先级顺序检查的配置位置,请参阅[所选模型存在问题](#theres-an-issue-with-the-selected-model)。

316* 要从模型选择器中完全删除 1M 变体,请设置 [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/zh-CN/env-vars)316* 要从模型选择器中完全删除 1M 变体,请设置 [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/zh-CN/env-vars)

317 317 

318<h3 id="server-is-temporarily-limiting-requests">318<h3 id="server-is-temporarily-limiting-requests">


491* 使用 Console API 密钥而不是您的订阅进行身份验证。有关设置,请参阅 [Claude Console 身份验证](/zh-CN/authentication#claude-console-authentication)。491* 使用 Console API 密钥而不是您的订阅进行身份验证。有关设置,请参阅 [Claude Console 身份验证](/zh-CN/authentication#claude-console-authentication)。

492* 如果您是管理员且看不到启用访问的选项,请联系 [Anthropic 支持](https://support.claude.com)492* 如果您是管理员且看不到启用访问的选项,请联系 [Anthropic 支持](https://support.claude.com)

493 493 

494<h3 id="routines-are-disabled-by-your-organization’s-policy">494<h3 id="routines-are-disabled-by-your-organizations-policy">

495 例程被您的组织的策略禁用495 例程被您的组织的策略禁用

496</h3>496</h3>

497 497 


687 687 

688有关访问级别和默认允许列表,请参阅[网络访问](/zh-CN/claude-code-on-the-web#network-access)。本地 CLI 会话不受此策略影响。688有关访问级别和默认允许列表,请参阅[网络访问](/zh-CN/claude-code-on-the-web#network-access)。本地 CLI 会话不受此策略影响。

689 689 

690<h3 id="couldn’t-reconnect-to-your-remote-control-session">690<h3 id="couldnt-reconnect-to-your-remote-control-session">

691 无法重新连接到您的 Remote Control 会话691 无法重新连接到您的 Remote Control 会话

692</h3>692</h3>

693 693 


841* 配置您的网关以转发 `anthropic-beta` 头。请参阅[功能传递](/zh-CN/llm-gateway-protocol#feature-pass-through)了解网关必须转发的内容。841* 配置您的网关以转发 `anthropic-beta` 头。请参阅[功能传递](/zh-CN/llm-gateway-protocol#feature-pass-through)了解网关必须转发的内容。

842* 作为备选方案,在启动前设置 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/zh-CN/env-vars)。这会禁用需要测试版头的功能,以便请求通过无法转发它的网关成功。842* 作为备选方案,在启动前设置 [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/zh-CN/env-vars)。这会禁用需要测试版头的功能,以便请求通过无法转发它的网关成功。

843 843 

844<h3 id="there’s-an-issue-with-the-selected-model">844<h3 id="theres-an-issue-with-the-selected-model">

845 There's an issue with the selected model845 There's an issue with the selected model

846</h3>846</h3>

847 847 


864 Model is not a recognized model id864 Model is not a recognized model id

865</h3>865</h3>

866 866 

867您传递给模型切换的模型字符串不是模型别名、此 Claude Code 版本知道的模型 ID,也不是以 `claude-` 开头的 ID。常见原因是 ID 中的拼写错误、显示名称(如 `Sonnet 5`,其中需要 ID `claude-sonnet-5`)或仅较新 Claude Code 版本识别的别名。Claude Code 立即拒绝切换。在 v2.1.200 之前,Claude Code 保存字符串并在下一个请求时失败,出现[所选模型有问题](#there%E2%80%99s-an-issue-with-the-selected-model)。867您传递给模型切换的模型字符串不是模型别名、此 Claude Code 版本知道的模型 ID,也不是以 `claude-` 开头的 ID。常见原因是 ID 中的拼写错误、显示名称(如 `Sonnet 5`,其中需要 ID `claude-sonnet-5`)或仅较新 Claude Code 版本识别的别名。Claude Code 立即拒绝切换。在 v2.1.200 之前,Claude Code 保存字符串并在下一个请求时失败,出现[所选模型有问题](#theres-an-issue-with-the-selected-model)。

868 868 

869```text theme={null}869```text theme={null}

870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?


878 878 

879* 运行不带参数的 `/model` 来打开选择器并从您账户可用的模型中选择,然后传递那里显示的别名或 ID879* 运行不带参数的 `/model` 来打开选择器并从您账户可用的模型中选择,然后传递那里显示的别名或 ID

880* 如果您使用了较新 Claude Code 版本支持的别名,运行 `claude update`。以 `claude-` 开头的完整 ID 即使模型比您的 Claude Code 版本更新,也会通过此检查,因此不需要升级。880* 如果您使用了较新 Claude Code 版本支持的别名,运行 `claude update`。以 `claude-` 开头的完整 ID 即使模型比您的 Claude Code 版本更新,也会通过此检查,因此不需要升级。

881* v2.1.200 之前保存的模型不会被此检查修复。如果过时的值一直出现,请从[所选模型有问题](#there%E2%80%99s-an-issue-with-the-selected-model)下列出的位置中删除它。881* v2.1.200 之前保存的模型不会被此检查修复。如果过时的值一直出现,请从[所选模型有问题](#theres-an-issue-with-the-selected-model)下列出的位置中删除它。

882* 检查仅在 Anthropic API 上运行。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 和 [LLM 网关](/zh-CN/llm-gateway)后面或自定义 `ANTHROPIC_BASE_URL`,您的提供商或网关定义模型名称,因此 Claude Code 接受任何字符串并将其传递。882* 检查仅在 Anthropic API 上运行。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 和 [LLM 网关](/zh-CN/llm-gateway)后面或自定义 `ANTHROPIC_BASE_URL`,您的提供商或网关定义模型名称,因此 Claude Code 接受任何字符串并将其传递。

883 883 

884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">


897* 如果您最近升级了计划但仍然看到这个,运行 `/logout` 然后 `/login`。存储的令牌反映您登录时的计划,因此在现有会话中在网络上升级不会生效,直到您重新进行身份验证。897* 如果您最近升级了计划但仍然看到这个,运行 `/logout` 然后 `/login`。存储的令牌反映您登录时的计划,因此在现有会话中在网络上升级不会生效,直到您重新进行身份验证。

898* 请参阅 [claude.com/pricing](https://claude.com/pricing) 了解每个计划包含哪些模型898* 请参阅 [claude.com/pricing](https://claude.com/pricing) 了解每个计划包含哪些模型

899 899 

900<h3 id="model-is-restricted-by-your-organization’s-settings">900<h3 id="model-is-restricted-by-your-organizations-settings">

901 Model is restricted by your organization's settings901 Model is restricted by your organization's settings

902</h3>902</h3>

903 903 

glossary.md +1 −1

Details

64 Auto mode64 Auto mode

65</h3>65</h3>

66 66 

67一种[权限模式](#permission-mode),其中单独的分类器模型在后台审查每个操作而不是向您显示批准提示。分类器阻止范围升级、不受信任的基础设施和[提示注入](#prompt-injection)。它永远看不到工具结果,因此注入的指令无法影响其决策。Auto mode 是研究预览。67一种[权限模式](#permission-mode),其中单独的分类器模型在后台审查操作因此大多数操作无需批准提示即可运行;显式 ask 规则仍会提示。分类器阻止范围升级、不受信任的基础设施和[提示注入](#prompt-injection)。它永远看不到工具结果,因此注入的指令无法影响其决策。

68 68 

69了解更多:[使用 auto mode 消除提示](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)69了解更多:[使用 auto mode 消除提示](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)

70 70 

Details

232 232 

233将这些环境变量设置为特定的 Google Cloud 的 Agent Platform 模型 ID。233将这些环境变量设置为特定的 Google Cloud 的 Agent Platform 模型 ID。

234 234 

235如果没有 `ANTHROPIC_DEFAULT_OPUS_MODEL`,Google Cloud 的 Agent Platform 上的 `opus` 别名会解析为 Opus 4.6。将其设置为 Opus 4.8 ID 以使用最新模型235如果没有这些变量,Google Cloud 的 Agent Platform 上的 `opus` 别名会解析为 Opus 4.8,`sonnet` 别名会解析为 Sonnet 4.5。将每个变量设置为特定版本以固定其别名

236 236 

237```bash theme={null}237```bash theme={null}

238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


245Claude Code 在未设置固定变量时使用这些默认模型:245Claude Code 在未设置固定变量时使用这些默认模型:

246 246 

247| 模型类型 | 默认值 |247| 模型类型 | 默认值 |

248| :------ | :--------------------------- |248| :------ | :---------------- |

249| 主模型 | `claude-sonnet-4-5@20250929` |249| 主模型 | `claude-opus-4-8` |

250| 小型/快速模型 | 与主模型相同 |250| 小型/快速模型 | 与主模型相同 |

251 251 

252后台任务(如会话标题生成)使用小型/快速模型,通常是 Haiku 级别的模型。在 Google Cloud 的 Agent Platform 上,Claude Code 默认将其设置为主模型,因为 Haiku 可能不会在每个项目或区域中启用。要为后台任务使用 Haiku,请将 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 设置为在您的项目中可用的模型 ID。252后台任务(如会话标题生成)使用小型/快速模型,通常是 Haiku 级别的模型。在 Google Cloud 的 Agent Platform 上,Claude Code 默认将其设置为主模型,因为 Haiku 可能不会在每个项目或区域中启用。要为后台任务使用 Haiku,请将 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 设置为在您的项目中可用的模型 ID。

Details

189* **Manual**:Claude 在文件编辑和 shell 命令之前询问189* **Manual**:Claude 在文件编辑和 shell 命令之前询问

190* **Accept edits**:Claude 编辑文件并运行常见的文件系统命令(如 `mkdir` 和 `mv`)而不询问,仍然询问其他命令190* **Accept edits**:Claude 编辑文件并运行常见的文件系统命令(如 `mkdir` 和 `mv`)而不询问,仍然询问其他命令

191* **Plan**:Claude 探索并提出计划而不编辑您的源文件;权限提示仍然适用,如 Manual 模式191* **Plan**:Claude 探索并提出计划而不编辑您的源文件;权限提示仍然适用,如 Manual 模式

192* **Auto**:Claude 使用后台安全检查评估所有操作。目前是研究预览192* **Auto**:Claude 使用后台安全检查评估所有操作

193 193 

194您也可以在 `.claude/settings.json` 中允许特定命令,以便 Claude 不会每次都询问。这对于受信任的命令(如 `npm test` 或 `git status`)很有用。设置可以从组织范围的策略范围到个人偏好。有关详细信息,请参阅[权限](/zh-CN/permissions)。194您也可以在 `.claude/settings.json` 中允许特定命令,以便 Claude 不会每次都询问。这对于受信任的命令(如 `npm test` 或 `git status`)很有用。设置可以从组织范围的策略范围到个人偏好。有关详细信息,请参阅[权限](/zh-CN/permissions)。

195 195 

model-config.md +17 −9

Details

41| **`opus[1m]`** | 使用 Opus 和[100 万令牌上下文窗口](https://platform.claude.com/docs/zh-CN/build-with-claude/context-windows#1m-token-context-window)用于长会话 |41| **`opus[1m]`** | 使用 Opus 和[100 万令牌上下文窗口](https://platform.claude.com/docs/zh-CN/build-with-claude/context-windows#1m-token-context-window)用于长会话 |

42| **`opusplan`** | 特殊模式,在 Plan Mode 中使用 `opus`,然后在执行时切换到 `sonnet` |42| **`opusplan`** | 特殊模式,在 Plan Mode 中使用 `opus`,然后在执行时切换到 `sonnet` |

43 43 

44在 Anthropic API 上,`opus` 解析为 Opus 4.8,`sonnet` 解析为 Sonnet 5。在 [Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 上,`opus` 解析为 Opus 4.7,`sonnet` 解析为 Sonnet 4.6。在 Amazon Bedrock、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上,`opus` 解析为 Opus 4.6,`sonnet` 解析为 Sonnet 4.5;通过显式选择完整模型名称或设置 `ANTHROPIC_DEFAULT_OPUS_MODEL` 或 `ANTHROPIC_DEFAULT_SONNET_MODEL` 可以在这些提供商上获得更新的模型。44每个别名解析为什么取决于提供商:

45 45 

46别名指向您的提供商推荐的版本,并随时间更新。要固定到特定版本,请使用完整模型名称(例如 `claude-opus-4-8`)或设置相应的环境变量`ANTHROPIC_DEFAULT_OPUS_MODEL`。46* **Anthropic API**:`opus` 解析为 Opus 4.8,`sonnet` 解析为 Sonnet 5

47* **[Claude Platform on AWS](/zh-CN/claude-platform-on-aws)**:`opus` 解析为 Opus 4.8,`sonnet` 解析为 Sonnet 4.6。

48* **Amazon Bedrock 和 Google Cloud 的 Agent Platform**:`opus` 解析为 Opus 4.8,`sonnet` 解析为 Sonnet 4.5。

49* **Microsoft Foundry**:`opus` 解析为 Opus 4.6,`sonnet` 解析为 Sonnet 4.5。

50 

51当别名解析为较旧的模型时,可以通过显式选择完整模型名称或设置 `ANTHROPIC_DEFAULT_OPUS_MODEL` 或 `ANTHROPIC_DEFAULT_SONNET_MODEL` 来获得更新的模型。

52 

53别名指向您的提供商推荐的版本,并随时间更新。要固定到特定版本,请使用完整模型名称(例如 `claude-opus-4-8`),或设置相应的环境变量,如 `ANTHROPIC_DEFAULT_OPUS_MODEL`。

47 54 

48<Note>55<Note>

49 Sonnet 5 需要 Claude Code v2.1.197 或更高版本。Opus 4.8 需要 v2.1.154 或更高版本。运行 `claude update` 进行升级。56 Sonnet 5 需要 Claude Code v2.1.197 或更高版本。Opus 4.8 需要 v2.1.154 或更高版本。运行 `claude update` 进行升级。


105 112 

106Claude Code 会拒绝无法识别的字符串,显示 `Model "<name>" is not a recognized model id.`,会话会保持其当前模型,而不是保存该字符串并在下一个请求时失败。有关恢复步骤,请参阅[错误参考](/zh-CN/errors#model-is-not-a-recognized-model-id)。113Claude Code 会拒绝无法识别的字符串,显示 `Model "<name>" is not a recognized model id.`,会话会保持其当前模型,而不是保存该字符串并在下一个请求时失败。有关恢复步骤,请参阅[错误参考](/zh-CN/errors#model-is-not-a-recognized-model-id)。

107 114 

108该检查仅在 Anthropic API 上运行。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 和 [LLM 网关](/zh-CN/llm-gateway)后面或自定义 `ANTHROPIC_BASE_URL` 上,您的提供商或网关定义模型名称,所以 Claude Code 会通过任何字符串而不检查它。该检查也不涵盖 `--model` 标志、`ANTHROPIC_MODEL` 环境变量或 `model` 设置;那里的拼写错误值会在第一个请求时产生[所选模型出现问题](/zh-CN/errors#there%E2%80%99s-an-issue-with-the-selected-model)。115该检查仅在 Anthropic API 上运行。在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 和 [LLM 网关](/zh-CN/llm-gateway)后面或自定义 `ANTHROPIC_BASE_URL` 上,您的提供商或网关定义模型名称,所以 Claude Code 会通过任何字符串而不检查它。该检查也不涵盖 `--model` 标志、`ANTHROPIC_MODEL` 环境变量或 `model` 设置;那里的拼写错误值会在第一个请求时产生[所选模型出现问题](/zh-CN/errors#theres-an-issue-with-the-selected-model)。

109 116 

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

111 118 


338`default` 的行为取决于您的账户类型:345`default` 的行为取决于您的账户类型:

339 346 

340* **Max、Team Premium、Enterprise 按使用量付费和 Anthropic API**:默认为 Opus 4.8347* **Max、Team Premium、Enterprise 按使用量付费和 Anthropic API**:默认为 Opus 4.8

341* **AWS 上的 Claude Platform**:默认为 Opus 4.7348* **AWS 上的 Claude Platform**:默认为 Opus 4.8

342* **Pro、Team Standard 和 Enterprise 订阅席位**:默认为 Sonnet 5349* **Pro、Team Standard 和 Enterprise 订阅席位**:默认为 Sonnet 5

343* **Amazon BedrockGoogle Cloud 的 Agent Platform 和 Microsoft Foundry**:默认为 Sonnet 4.5350* **Amazon BedrockGoogle Cloud 的 Agent Platform**:默认为 Opus 4.8

351* **Microsoft Foundry**:默认为 Sonnet 4.5

344 352 

345Enterprise 按使用量付费是指按使用量而非按订阅席位计费的 Enterprise 组织。353Enterprise 按使用量付费是指按使用量而非按订阅席位计费的 Enterprise 组织。

346 354 


404 412 

405本部分涵盖来自 Fable 5 的基于内容的回退。有关模型过载或不可用时的基于可用性的回退,请参阅 [Fallback model chains](#fallback-model-chains)。413本部分涵盖来自 Fable 5 的基于内容的回退。有关模型过载或不可用时的基于可用性的回退,请参阅 [Fallback model chains](#fallback-model-chains)。

406 414 

407Fable 5 运行时具有网络安全和生物学内容的安全分类器。当分类器标记请求时,Claude Code 在默认 Opus 模型上重新运行该请求,并在记录中显示通知:Anthropic API 和 [LLM gateway](/zh-CN/llm-gateway) 部署上的 Opus 4.8,或 [Claude Platform on AWS](/zh-CN/claude-platform-on-aws) 上的 Opus 4.7415Fable 5 运行时具有网络安全和生物学内容的安全分类器。当分类器标记请求时,Claude Code Opus 4.8 上重新运行该请求,并在记录中显示通知

408 416 

409会话随后在该 Opus 模型上继续。要返回 Fable 5,请运行 `/model fable`。417会话随后在该 Opus 模型上继续。要返回 Fable 5,请运行 `/model fable`。

410 418 


468 476 

469Fable 5、Sonnet 5、Opus 4.8、Opus 4.6 和 Sonnet 4.6 上的默认工作量是 `high`,Opus 4.7 上的默认工作量是 `xhigh`。477Fable 5、Sonnet 5、Opus 4.8、Opus 4.6 和 Sonnet 4.6 上的默认工作量是 `high`,Opus 4.7 上的默认工作量是 `xhigh`。

470 478 

471当您首次运行 Fable 5、Opus 4.8 或 Opus 4.7 时,Claude Code 会应用该模型的默认工作量,即使您之前为另一个模型设置了不同的级别:Fable 5 和 Opus 4.8 上的 `high`,Opus 4.7 上的 `xhigh`。切换后再次运行 `/effort` 以选择不同的级别。该默认值在会话间保持,直到您做出明确的工作量选择,例如在交互式会话中运行 `/effort` 或使用 `--effort` 启动。{/* min-version: 2.1.205 */}`low`、`medium`、`high` 和 `xhigh` 在会话间持续存在。`max` 提供最深入的推理,对令牌支出没有限制,仅适用于当前会话,除非通过 `CLAUDE_CODE_EFFORT_LEVEL` 环境变量设置。在 [non-interactive mode](/zh-CN/headless) 中使用 `/effort` 时,带有 `-p` 标志,仅适用于当前会话,不会保存为您的默认值。非交互式 `/effort` 也无法释放上面的模型默认保持:在 Fable 5、Opus 4.8 和 Opus 4.7 上,它报告 `Not applied`,会话保持在模型的默认工作量,因此改为在启动时传递 `--effort`。`max` 提供最深入的推理,对令牌支出没有限制,仅适用于当前会话,除非通过 `CLAUDE_CODE_EFFORT_LEVEL` 环境变量设置。479当您首次运行 Fable 5、Opus 4.8 或 Opus 4.7 时,Claude Code 会应用该模型的默认工作量,即使您之前为另一个模型设置了不同的级别:Fable 5 和 Opus 4.8 上的 `high`,Opus 4.7 上的 `xhigh`。切换后再次运行 `/effort` 以选择不同的级别。该默认值在会话间保持,直到您做出明确的工作量选择,例如在交互式会话中运行 `/effort` 或使用 `--effort` 启动。`low`、`medium`、`high` 和 `xhigh` 在会话间持续存在。{/* min-version: 2.1.205 */}在 [non-interactive mode](/zh-CN/headless) 中使用 `/effort` 时,带有 `-p` 标志,仅适用于当前会话,不会保存为您的默认值。非交互式 `/effort` 也无法释放上面的模型默认保持:在 Fable 5、Opus 4.8 和 Opus 4.7 上,它报告 `Not applied`,会话保持在模型的默认工作量,因此改为在启动时传递 `--effort`。`max` 提供最深入的推理,对令牌支出没有限制,仅适用于当前会话,除非通过 `CLAUDE_CODE_EFFORT_LEVEL` 环境变量设置。

472 480 

473`/effort` 菜单还提供 `ultracode`。Ultracode 是一个 Claude Code 设置,而不是模型工作量级别:它向模型发送 `xhigh`,并且还让 Claude 为实质性任务编排[动态工作流](/zh-CN/workflows)。它仅适用于当前会话。481`/effort` 菜单还提供 `ultracode`。Ultracode 是一个 Claude Code 设置,而不是模型工作量级别:它向模型发送 `xhigh`,并且还让 Claude 为实质性任务编排[动态工作流](/zh-CN/workflows)。它仅适用于当前会话。

474 482 


568 576 

5691M 上下文窗口使用标准模型定价,超过 200K 的令牌无需额外费用。对于订阅中包含扩展上下文的计划,使用仍由您的订阅覆盖。对于通过使用额度访问扩展上下文的计划,令牌计入使用额度。5771M 上下文窗口使用标准模型定价,超过 200K 的令牌无需额外费用。对于订阅中包含扩展上下文的计划,使用仍由您的订阅覆盖。对于通过使用额度访问扩展上下文的计划,令牌计入使用额度。

570 578 

571如果您的账户支持 1M 上下文,该选项会出现在最新版本的 Claude Code 的模型选择器(`/model`)中。如果您看不到它,请尝试重新启动您的会话。579如果您的账户支持 1M 上下文,该选项会出现在最新版本的 Claude Code `/model` 选择器中。如果您看不到它,请尝试重新启动您的会话。

572 580 

573您也可以将 `[1m]` 后缀与模型别名或完整模型名称一起使用:581您也可以将 `[1m]` 后缀与模型别名或完整模型名称一起使用:

574 582 


589 597 

590两种配置会改为将窗口预算设为 200K,并在该边界自动压缩:598两种配置会改为将窗口预算设为 200K,并在该边界自动压缩:

591 599 

592* **LLM 网关**:当 `ANTHROPIC_BASE_URL` 指向[网关](/zh-CN/llm-gateway)时,Claude Code 无法验证 1M 支持。要使用完整窗口,请在模型选择器中选择 Sonnet 5 (1M context),它映射到 `sonnet[1m]`。600* **LLM gateway**:当 `ANTHROPIC_BASE_URL` 指向[网关](/zh-CN/llm-gateway)时,Claude Code 无法验证 1M 支持。要使用完整窗口,请在模型选择器中选择 Sonnet 5 (1M context),它映射到 `sonnet[1m]`。

593* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**:将 Sonnet 5 会话视为具有 200K 窗口,适用于需要限制上下文的部署。601* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**:将 Sonnet 5 会话视为具有 200K 窗口,适用于需要限制上下文的部署。

594 602 

595<h2 id="checking-your-current-model">603<h2 id="checking-your-current-model">

Details

187Auto mode 还指示 Claude 继续工作而无需停止以提出澄清问题,尽管当您的提示或技能明确依赖它时 Claude 仍然会提问。要在保持权限提示的同时获得更强的自主行为,请改为设置[主动输出风格](/zh-CN/output-styles)。187Auto mode 还指示 Claude 继续工作而无需停止以提出澄清问题,尽管当您的提示或技能明确依赖它时 Claude 仍然会提问。要在保持权限提示的同时获得更强的自主行为,请改为设置[主动输出风格](/zh-CN/output-styles)。

188 188 

189<Warning>189<Warning>

190 Auto mode 是研究预览版。它减少提示但不保证安全。将其用于您信任一般方向的任务,而不是作为敏感操作审查的替代品。190 Auto mode 减少提示但不保证安全。将其用于您信任一般方向的任务,而不是作为敏感操作审查的替代品。

191</Warning>191</Warning>

192 192 

193Auto mode 仅在您的账户满足所有这些要求时可用:193Auto mode 仅在您的账户满足所有这些要求时可用:

permissions.md +4 −4

Details

15Claude Code 使用分层权限系统来平衡功能和安全性:15Claude Code 使用分层权限系统来平衡功能和安全性:

16 16 

17| 工具类型 | 示例 | 需要批准 | "是,不再询问"行为 |17| 工具类型 | 示例 | 需要批准 | "是,不再询问"行为 |

18| :------ | :------------ | :--- | :------------ |18| :------ | :------------ | :------------------------------------ | :------------ |

19| 只读 | 文件读取、Grep | 否 | 不适用 |19| 只读 | 文件读取、Grep | 否,在[工作目录和其他目录](#working-directories)内 | 不适用 |

20| Bash 命令 | Shell 执行 | 是 | 每个项目目录和命令永久有效 |20| Bash 命令 | Shell 执行 | 是,除了内置的[只读命令](#read-only-commands)集合 | 每个项目目录和命令永久有效 |

21| 文件修改 | Edit/Write 文件 | 是 | 直到会话结束 |21| 文件修改 | Edit/Write 文件 | 是 | 直到会话结束 |

22 22 

23<h2 id="manage-permissions">23<h2 id="manage-permissions">


51| `default` | 标准行为:在首次使用每个工具时提示权限。{/* min-version: 2.1.200 */}在 CLI 和 VS Code 及 JetBrains 扩展中标记为 Manual,Claude Code 接受 `manual` 作为别名。标签和别名需要 Claude Code v2.1.200 或更高版本 |51| `default` | 标准行为:在首次使用每个工具时提示权限。{/* min-version: 2.1.200 */}在 CLI 和 VS Code 及 JetBrains 扩展中标记为 Manual,Claude Code 接受 `manual` 作为别名。标签和别名需要 Claude Code v2.1.200 或更高版本 |

52| `acceptEdits` | 自动接受工作目录或 `additionalDirectories` 中路径的文件编辑和常见文件系统命令(`mkdir`、`touch`、`mv`、`cp` 等) |52| `acceptEdits` | 自动接受工作目录或 `additionalDirectories` 中路径的文件编辑和常见文件系统命令(`mkdir`、`touch`、`mv`、`cp` 等) |

53| `plan` | Claude 读取文件并运行只读 shell 命令来探索,但不编辑您的源文件。在 CLI 和 VS Code 扩展中标记为 Plan |53| `plan` | Claude 读取文件并运行只读 shell 命令来探索,但不编辑您的源文件。在 CLI 和 VS Code 扩展中标记为 Plan |

54| `auto` | 自动批准工具调用,并进行后台安全检查以验证操作与您的请求一致。目前处于研究预览阶段 |54| `auto` | 自动批准工具调用,并进行后台安全检查以验证操作与您的请求一致 |

55| `dontAsk` | 自动拒绝工具,除非通过 `/permissions` 或 `permissions.allow` 规则预先批准 |55| `dontAsk` | 自动拒绝工具,除非通过 `/permissions` 或 `permissions.allow` 规则预先批准 |

56| `bypassPermissions` | 跳过权限提示,除了由显式 `ask` 规则强制的提示。根目录和主目录删除操作(如 `rm -rf /`)仍会作为断路器提示 |56| `bypassPermissions` | 跳过权限提示,除了由显式 `ask` 规则强制的提示。根目录和主目录删除操作(如 `rm -rf /`)仍会作为断路器提示 |

57 57 

security.md +2 −2

Details

22 22 

23Claude Code 默认使用严格的只读权限。当需要额外操作时(编辑文件、运行测试、执行命令),Claude Code 会请求明确的权限。用户可以控制是否批准一次性操作或自动允许操作。23Claude Code 默认使用严格的只读权限。当需要额外操作时(编辑文件、运行测试、执行命令),Claude Code 会请求明确的权限。用户可以控制是否批准一次性操作或自动允许操作。

24 24 

25Claude Code 在运行可以修改您的系统的 Bash 命令之前需要获得批准。一组内置的只读命令,如 `ls`、`cat` 和 `git status`,无需提示即可运行。这种方法使用户和组织能够直接配置权限。25Claude Code 在运行可以修改您的系统的 Bash 命令之前需要获得批准。一组内置的[只读命令](/zh-CN/permissions#read-only-commands),如 `ls`、`cat` 和 `git status`,无需提示即可运行。这种方法使用户和组织能够直接配置权限。

26 26 

27有关详细的权限配置,请参阅 [Permissions](/zh-CN/permissions)。27有关详细的权限配置,请参阅 [Permissions](/zh-CN/permissions)。

28 28 


33为了降低代理系统中的风险:33为了降低代理系统中的风险:

34 34 

35* **沙箱化 bash 工具**:使用文件系统和网络隔离的 [Sandbox](/zh-CN/sandboxing) bash 命令,减少权限提示同时保持安全性。使用 `/sandbox` 启用以定义 Claude Code 可以自主工作的边界35* **沙箱化 bash 工具**:使用文件系统和网络隔离的 [Sandbox](/zh-CN/sandboxing) bash 命令,减少权限提示同时保持安全性。使用 `/sandbox` 启用以定义 Claude Code 可以自主工作的边界

36* **写入访问限制**:Claude Code 只能写入启动它的文件夹及其子文件夹——它不能在没有明确权限的情况下修改父目录中的文件虽然 Claude Code 可以读取工作目录外的文件(对于访问系统库和依赖项很有用)但写入操作严格限制在项目范围内创建了清晰的安全边界36* **工作目录边界**:Claude Code 只能写入启动它的文件夹及其子文件夹,不能在没有明确权限的情况下修改父目录中的文件使用 Read、Grep Glob 工具读取此边界外的路径在批准提示后是可能的。使用[额外目录](/zh-CN/permissions#working-directories)扩展边界以跳过提示或使用[沙箱 `denyRead` 规则](/zh-CN/sandboxing#filesystem-isolation)限制对只读 Bash 命令可用的更广泛读取访问这些规则仅在启用沙箱时适用

37* **提示疲劳缓解**:支持按用户、按代码库或按组织的白名单常用安全命令37* **提示疲劳缓解**:支持按用户、按代码库或按组织的白名单常用安全命令

38* **Accept Edits 模式**:自动批准文件编辑和一组固定的文件系统 Bash 命令,如 `mkdir`、`touch`、`rm`、`mv`、`cp` 和 `sed`,用于工作目录中的路径。其他 Bash 命令和超出范围的路径仍然会提示38* **Accept Edits 模式**:自动批准文件编辑和一组固定的文件系统 Bash 命令,如 `mkdir`、`touch`、`rm`、`mv`、`cp` 和 `sed`,用于工作目录中的路径。其他 Bash 命令和超出范围的路径仍然会提示

39 39 

setup.md +1 −1

Details

36</h2>36</h2>

37 37 

38<Tip>38<Tip>

39 更喜欢图形界面?[桌面应用](/zh-CN/desktop-quickstart)让您无需使用终端即可使用 Claude Code。下载适用于 [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)、[Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 或 [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 的版本。39 更喜欢图形界面?[桌面应用](/zh-CN/desktop-quickstart)让您无需使用终端即可使用 Claude Code。下载适用于 [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)、[Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 或 [Linux](/zh-CN/desktop-linux) 的版本。

40 40 

41 初次使用终端?请参阅[终端指南](/zh-CN/terminal-guide)获取分步说明。41 初次使用终端?请参阅[终端指南](/zh-CN/terminal-guide)获取分步说明。

42</Tip>42</Tip>

Details

10 10 

11要添加自定义工具,请连接一个 [MCP server](/zh-CN/mcp)。要使用可重用的基于提示的工作流扩展 Claude,请编写一个 [skill](/zh-CN/skills),它通过现有的 `Skill` 工具运行,而不是添加新的工具条目。11要添加自定义工具,请连接一个 [MCP server](/zh-CN/mcp)。要使用可重用的基于提示的工作流扩展 Claude,请编写一个 [skill](/zh-CN/skills),它通过现有的 `Skill` 工具运行,而不是添加新的工具条目。

12 12 

13Permission required 列显示该工具在默认权限模式下是否对工作目录内的路径进行提示。标记为"否"的文件访问工具,包括 `Read`、`Grep` 和 `Glob`,仍然会对[工作目录和其他目录](/zh-CN/permissions#working-directories)之外的路径进行提示。`Bash` 标记为"是",但运行一组内置的[只读命令](/zh-CN/permissions#read-only-commands)而无需提示。

14 

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

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

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

Details

46如果您的问题未列出,请按照下面的诊断检查来缩小原因范围。46如果您的问题未列出,请按照下面的诊断检查来缩小原因范围。

47 47 

48<Tip>48<Tip>

49 如果您宁愿完全跳过终端,[Claude Code Desktop 应用](/zh-CN/desktop-quickstart)可让您通过图形界面安装和使用 Claude Code。为 [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)[Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 下载它,无需任何命令行设置即可开始编码49 如果您宁愿完全跳过终端,[Claude Code Desktop 应用](/zh-CN/desktop-quickstart)可让您通过图形界面安装和使用 Claude Code。为 [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs)[Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs) 下载它,无需任何命令行设置即可开始编码。在 Linux 上,按照 [Linux 安装说明](/zh-CN/desktop-linux)使用 apt 安装应用

50</Tip>50</Tip>

51 51 

52<h2 id="run-diagnostic-checks">52<h2 id="run-diagnostic-checks">

Details

15| 登录循环、OAuth 错误、`403 Forbidden`、"organization disabled"、Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 凭据 | [故障排除安装和登录](/zh-CN/troubleshoot-install#login-and-authentication) |15| 登录循环、OAuth 错误、`403 Forbidden`、"organization disabled"、Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 凭据 | [故障排除安装和登录](/zh-CN/troubleshoot-install#login-and-authentication) |

16| 设置未应用、hooks 未触发、MCP 服务器未加载 | [调试您的配置](/zh-CN/debug-your-config) |16| 设置未应用、hooks 未触发、MCP 服务器未加载 | [调试您的配置](/zh-CN/debug-your-config) |

17| `API Error: 5xx`、`529 Overloaded`、`429`、请求验证错误 | [错误参考](/zh-CN/errors) |17| `API Error: 5xx`、`529 Overloaded`、`429`、请求验证错误 | [错误参考](/zh-CN/errors) |

18| `model not found` 或 `you may not have access to it` | [错误参考](/zh-CN/errors#there%E2%80%99s-an-issue-with-the-selected-model) |18| `model not found` 或 `you may not have access to it` | [错误参考](/zh-CN/errors#theres-an-issue-with-the-selected-model) |

19| VS Code 扩展未连接或未检测到 Claude | [VS Code 集成](/zh-CN/vs-code#fix-common-issues) |19| VS Code 扩展未连接或未检测到 Claude | [VS Code 集成](/zh-CN/vs-code#fix-common-issues) |

20| JetBrains 插件或 IDE 未检测到 | [JetBrains 集成](/zh-CN/jetbrains#troubleshooting) |20| JetBrains 插件或 IDE 未检测到 | [JetBrains 集成](/zh-CN/jetbrains#troubleshooting) |

21| 高 CPU 或内存、响应缓慢、挂起、搜索找不到文件 | [性能和稳定性](#performance-and-stability)下方 |21| 高 CPU 或内存、响应缓慢、挂起、搜索找不到文件 | [性能和稳定性](#performance-and-stability)下方 |

vs-code.md +2 −2

Details

103提示框支持多个功能:103提示框支持多个功能:

104 104 

105* **权限模式**:点击提示框底部的模式指示器以切换模式,或在 VS Code 设置中的 `claudeCode.initialPermissionMode` 下设置默认值。请参阅[权限模式](/zh-CN/permission-modes#switch-permission-modes)了解指示器提供的每种模式。105* **权限模式**:点击提示框底部的模式指示器以切换模式,或在 VS Code 设置中的 `claudeCode.initialPermissionMode` 下设置默认值。请参阅[权限模式](/zh-CN/permission-modes#switch-permission-modes)了解指示器提供的每种模式。

106 * **Manual**:Claude 在每个操作前请求许可106 * **Manual**:Claude 在文件编辑和大多数 shell 命令前请求许可

107 * **Plan Mode**:Claude 描述它将做什么,并在进行更改前等待批准。VS Code 会自动将计划作为完整的 Markdown 文档打开,您可以添加内联注释以在 Claude 开始前提供反馈。107 * **Plan**:Claude 描述它将做什么,并在进行更改前等待批准。VS Code 会自动将计划作为完整的 Markdown 文档打开,您可以添加内联注释以在 Claude 开始前提供反馈。

108 * **Edit automatically**:Claude 进行编辑而不询问。108 * **Edit automatically**:Claude 进行编辑而不询问。

109* **命令菜单**:点击 `/` 或输入 `/` 以打开命令菜单。选项包括附加文件、切换模型、切换扩展思考、查看计划使用情况(`/usage`)以及启动 [Remote Control](/zh-CN/remote-control) 会话(`/remote-control`)。自定义部分提供对 MCP servers、hooks、memory、permissions 和 plugins 的访问。带有终端图标的项目在集成终端中打开。109* **命令菜单**:点击 `/` 或输入 `/` 以打开命令菜单。选项包括附加文件、切换模型、切换扩展思考、查看计划使用情况(`/usage`)以及启动 [Remote Control](/zh-CN/remote-control) 会话(`/remote-control`)。自定义部分提供对 MCP servers、hooks、memory、permissions 和 plugins 的访问。带有终端图标的项目在集成终端中打开。

110 * {/* min-version: 2.1.203 */}设置部分包括**为所有会话启用 Remote Control**,它设置 [`remoteControlAtStartup`](/zh-CN/settings#available-settings) 以便[每个新的交互式会话都自动连接到 Remote Control](/zh-CN/remote-control#enable-remote-control-for-all-sessions)。需要 Claude Code v2.1.203 或更高版本。110 * {/* min-version: 2.1.203 */}设置部分包括**为所有会话启用 Remote Control**,它设置 [`remoteControlAtStartup`](/zh-CN/settings#available-settings) 以便[每个新的交互式会话都自动连接到 Remote Control](/zh-CN/remote-control#enable-remote-control-for-all-sessions)。需要 Claude Code v2.1.203 或更高版本。

whats-new.md +16 −0

Details

8 8 

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

10 10 

11<Update label="Week 28" description="July 6–10, 2026" tags={["v2.1.202–v2.1.206"]}>

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

13 

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

15 

16 [阅读 Week 28 摘要 →](/zh-CN/whats-new/2026-w28)

17</Update>

18 

19<Update label="Week 27" description="June 29 – July 3, 2026" tags={["v2.1.195–v2.1.201"]}>

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

21 

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

23 

24 [阅读 Week 27 摘要 →](/zh-CN/whats-new/2026-w27)

25</Update>

26 

11<Update label="Week 26" description="June 22–26, 2026" tags={["v2.1.185–v2.1.193"]}>27<Update label="Week 26" description="June 22–26, 2026" tags={["v2.1.185–v2.1.193"]}>

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

13 29 

whats-new/2026-w27.md +103 −0 created

Details

1> ## Documentation Index

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

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

4 

5# 第 27 周 · 6 月 29 日 – 7 月 3 日,2026 年

6 

7> Claude Sonnet 5 成为默认模型,Claude in Chrome 正式推出,子代理默认在后台运行,Claude Desktop 在 Linux 上推出测试版,/radio 调入 Claude FM。

8 

9<div className="digest-meta">

10 <span>发布版本 <a href="/zh-CN/docs/changelog#2-1-195">v2.1.195 → v2.1.201</a></span>

11 <span>5 项功能 · 6 月 29 日 – 7 月 3 日</span>

12</div>

13 

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Claude Sonnet 5</span>

17 <span className="digest-feature-pill">新模型</span>

18 </div>

19 

20 <p className="digest-feature-lede">Sonnet 5 是 Pro、Team Standard 和 Enterprise 订阅席位的新默认模型:以 Sonnet 定价提供顶级编码和工具使用能力,具有原生 1M 令牌上下文窗口和默认启用的自适应思考。API 定价在 8 月 31 日前为促销价格,每 MTok 2 美元/10 美元。需要 v2.1.197 或更高版本。</p>

21 

22 <p className="digest-feature-try">按名称切换到 Sonnet 5,或从模型选择器中选择:</p>

23 

24 ```text Claude Code theme={null}

25 > /model claude-sonnet-5

26 ```

27 

28 <a className="digest-feature-link" href="/zh-CN/docs/model-config#available-models">模型配置</a>

29</div>

30 

31<div className="digest-feature">

32 <div className="digest-feature-header">

33 <span className="digest-feature-title">Claude in Chrome 正式推出</span>

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

35 </div>

36 

37 <p className="digest-feature-lede">Chrome 集成已对所有直接 Anthropic 计划的用户正式推出预览版。Claude Code 通过 Claude in Chrome 扩展程序驱动您的浏览器:它打开标签页、点击浏览页面、填充表单、读取控制台日志并共享您的登录状态,因此它可以测试它构建的应用程序,而无需您切换上下文。</p>

38 

39 <a className="digest-feature-link" href="/zh-CN/docs/chrome">使用 Claude Code 与 Chrome</a>

40</div>

41 

42<div className="digest-feature">

43 <div className="digest-feature-header">

44 <span className="digest-feature-title">子代理默认在后台运行</span>

45 <span className="digest-feature-pill">v2.1.198</span>

46 </div>

47 

48 <p className="digest-feature-lede">Claude 现在在子代理运行时继续工作,并在子代理完成时获取其结果,而不是暂停对话以等待。Claude 仍然在需要结果才能继续时在前台运行子代理,后台子代理在您的主会话中显示每个权限提示。使用 <code>background</code> frontmatter 字段固定子代理的行为。</p>

49 

50 <a className="digest-feature-link" href="/zh-CN/docs/sub-agents#run-subagents-in-foreground-or-background">在前台或后台运行子代理</a>

51</div>

52 

53<div className="digest-feature">

54 <div className="digest-feature-header">

55 <span className="digest-feature-title">Claude Desktop on Linux</span>

56 <span className="digest-feature-pill">Desktop</span>

57 </div>

58 

59 <p className="digest-feature-lede">Claude 桌面应用现已在 Ubuntu 22.04+ 和 Debian 12+ 上以测试版形式提供,支持 x86\_64 和 arm64。您可以获得与 macOS 和 Windows 相同的 Chat、Cowork 和 Claude Code 体验:并行会话、可视化差异审查、集成终端和编辑器以及实时应用预览。从 Anthropic 的 apt 存储库安装,因此更新通过常规包更新到达。</p>

60 

61 <a className="digest-feature-link" href="/zh-CN/docs/desktop-linux">Claude Desktop on Linux</a>

62</div>

63 

64<div className="digest-feature">

65 <div className="digest-feature-header">

66 <span className="digest-feature-title">/radio</span>

67 <span className="digest-feature-pill">CLI</span>

68 </div>

69 

70 <p className="digest-feature-lede">Claude FM 已上线。<code>/radio</code> 在您的浏览器中打开 lo-fi 电台流,用于编码时的背景音乐,当没有浏览器可用时打印流 URL。在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。</p>

71 

72 <Frame>

73 <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/claude-code/x358isu_VzLnyTEN/images/whats-new/radio.mp4?fit=max&auto=format&n=x358isu_VzLnyTEN&q=85&s=36a0c33859cef119c7192dceea8bcbd3" data-path="images/whats-new/radio.mp4" />

74 </Frame>

75 

76 <p className="digest-feature-try">从任何会话调入:</p>

77 

78 ```text Claude Code theme={null}

79 > /radio

80 ```

81 

82 <a className="digest-feature-link" href="/zh-CN/docs/commands#all-commands">所有命令</a>

83</div>

84 

85<div className="digest-wins">

86 <p className="digest-wins-title">其他亮点</p>

87 

88 <div className="digest-wins-grid">

89 <div><a href="/zh-CN/docs/artifacts">Artifacts</a> 现已正式推出,包含在 Pro 和 Max 计划中,加入 Team 和 Enterprise</div>

90 <div>管理员可以在组织控制台中设置 <a href="/zh-CN/docs/model-config#organization-default-model">组织默认模型</a>;当您尚未选择模型时,它在 <code>/model</code> 中显示为"组织默认"</div>

91 <div>堆叠的技能调用,如 <code>/skill-a /skill-b do XYZ</code>,现在加载所有前导技能(最多 5 个),而不仅仅是第一个</div>

92 <div><code>AskUserQuestion</code> 对话框默认不再自动继续;通过 <code>/config</code> 选择加入空闲超时</div>

93 <div>"default"权限模式现在在 CLI、`--help`、VS Code 和 JetBrains 中命名为"Manual";`--permission-mode manual` 与 `default` 一起被接受</div>

94 <div>新的 <code>/dataviz</code> 技能提供图表和仪表板设计指导,带有可运行的调色板验证器</div>

95 <div>内置的 Explore 代理现在继承主会话的模型(上限为 Opus),而不是在 Haiku 上运行</div>

96 <div>从 <code>claude agents</code> 启动的后台代理现在在 worktree 中完成代码工作时提交、推送并打开草稿 PR,而不是停止询问</div>

97 <div>带有连字符标识符(如 <code>code-reviewer</code>)的 Hook 匹配器现在精确匹配而不是子字符串匹配;使用 <code>mcp\_\_brave-search\_\_.\*</code> 匹配来自连字符 MCP 服务器的所有工具</div>

98 <div>与您的使用限制无关的瞬时服务器速率限制错误现在对订阅者自动重试并进行退避,而不是使轮次失败</div>

99 <div>流式空闲监视程序现在默认对所有提供商启用:当响应流在 5 分钟内不产生任何事件时,它会中止并重试(<code>CLAUDE\_ENABLE\_STREAM\_WATCHDOG=0</code> 禁用)</div>

100 </div>

101</div>

102 

103[v2.1.195–v2.1.201 的完整更新日志 →](/zh-CN/changelog#2-1-195)

whats-new/2026-w28.md +63 −0 created

Details

1> ## Documentation Index

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

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

4 

5# 第 28 周 · 2026 年 7 月 6–10 日

6 

7> 从 Desktop 应用的内置浏览器浏览外部网站,使用 /doctor 运行完整的设置检查,并获取自动模式的文本记录保护和代理视图升级。

8 

9<div className="digest-meta">

10 <span>发布版本 <a href="/zh-CN/docs/changelog#2-1-202">v2.1.202 → v2.1.206</a></span>

11 <span>2 项功能 · 7 月 6–10 日</span>

12</div>

13 

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Desktop 上的应用内浏览器</span>

17 <span className="digest-feature-pill">Desktop</span>

18 </div>

19 

20 <p className="digest-feature-lede">Desktop 上的 Claude Code 现在具有内置浏览器。Claude 可以打开文档、设计或任何其他网站,并以与处理本地开发服务器预览相同的方式读取、点击和与页面交互。浏览器是沙箱化的且可配置的:您可以选择浏览会话是否持续,安全分类器会审查对外部网站的操作。</p>

21 

22 <Frame>

23 <video autoPlay muted loop playsInline className="w-full" 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" data-path="images/whats-new/desktop-browser.mp4" />

24 </Frame>

25 

26 <a className="digest-feature-link" href="/zh-CN/docs/desktop#browse-external-sites">浏览外部网站</a>

27</div>

28 

29<div className="digest-feature">

30 <div className="digest-feature-header">

31 <span className="digest-feature-title">/doctor 是完整的设置检查</span>

32 <span className="digest-feature-pill">v2.1.205</span>

33 </div>

34 

35 <p className="digest-feature-lede"><code>/doctor</code> 现在可以诊断问题并修复它们,而不是打印只读报告。它检查安装健康状况,查找未使用的 skills、MCP 服务器和插件与其上下文成本的对比,针对已检入的文件对本地 <code>CLAUDE.md</code> 文件进行重复数据删除,建议修剪 Claude 可以从代码库派生的 <code>CLAUDE.md</code> 内容,并标记缓慢的 hooks。它首先报告发现,然后在更改任何内容之前请求确认。<code>/checkup</code> 是它的别名。</p>

36 

37 <p className="digest-feature-try">从任何会话运行检查:</p>

38 

39 ```text Claude Code theme={null}

40 > /doctor

41 ```

42 

43 <a className="digest-feature-link" href="/zh-CN/docs/commands#all-commands">所有命令</a>

44</div>

45 

46<div className="digest-wins">

47 <p className="digest-wins-title">其他改进</p>

48 

49 <div className="digest-wins-grid">

50 <div>自动模式现在阻止篡改会话文本记录文件,并在运行 <code>rm -rf</code> 处理无法从上下文解析的变量之前询问</div>

51 <div><code>/cd</code> 现在在您输入时建议目录路径,与 <code>/add-dir</code> 匹配</div>

52 <div><code>/commit-push-pr</code> 自动允许 <code>git push</code> 到存储库配置的推送远程,除了 <code>origin</code></div>

53 <div>Gateway:<code>/login</code> 现在支持 Anthropic 运营的公共网关端点</div>

54 <div><code>EnterWorktree</code> 在进入项目 <code>.claude/worktrees/</code> 目录之外的 git worktree 之前请求确认</div>

55 <div>后台代理在 Claude Code 更新后立即升级到新版本,而不是在您附加时支付缓慢的过时会话升级</div>

56 <div>代理视图行现在显示彩色状态词和分类器编写的标题,而不是原始工具调用文本,编辑、合并、评论或推送到现有 PR 的会话在 <code>claude agents</code> 中链接它</div>

57 <div>自动更新二进制下载现在流式传输到磁盘,而不是在内存中缓冲,将更新程序的峰值内存使用量减少了大约 400 MB</div>

58 <div>后台任务通知现在明确说明没有发生人工输入,防止虚构的文本记录内批准被执行</div>

59 <div>在 Opus 4.8 上改进了 <code>/code-review</code> 发现质量,涵盖所有工作量级别</div>

60 </div>

61</div>

62 

63[v2.1.202–v2.1.206 的完整更新日志 →](/zh-CN/changelog#2-1-202)