工程 / 官方
Opus 5 成默认模型,子智能体嵌套深度扩至三层
Anthropic 于 2025 年 7 月 24 日发布 Claude Code v2.1.219,核心亮点是将 Claude Opus 5(claude-opus-5)设为默认 Opus 模型,支持 100 万 token 上下文,快速模式定价为每百万 token 输入 10 美元、输出 50 美元。子智能体嵌套深度从默认 1 层提升至 3 层,开发者可通过环境变量 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 恢复旧行为。动态工作流默认规模调整为中等(目标少于 15 个智能体),并新增 workflowSizeGuideline 配置键供任意设置文件覆盖。此外,沙箱网络新增严格白名单模式,MCP 服务器错误信息更加完善,多项 Windows、Vim 模式、屏幕阅读器及远程控制的 Bug 也得到修复。
Claude Opus 5 是本次更新最受关注的变化。该模型现已成为 Claude Code 中 Opus 系列的默认选项,提供高达 100 万 token 的上下文窗口,快速模式定价为输入 10 美元、输出 50 美元(每百万 token)。与此同时,Opus 4.7 被移出快速模式,/fast 命令现在仅对 Opus 5 和 Opus 4.8 生效。模型选择器界面也做了调整,仅高亮显示最新模型名称,避免误导用户。
子智能体能力得到显著增强。此前子智能体默认只能嵌套 1 层,v2.1.219 将上限提升至 3 层,深度 2 及以上的子智能体在 stream-json 模式下启用 --forward-subagent-text 时也会正常出现,并以其父级 Agent tool_use id 作为标识键。这一改动为复杂多智能体工作流提供了更大的编排空间,如需禁用嵌套,可将环境变量 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 设为 1。
动态工作流管理迎来多项改进。默认规模指引从无限制调整为中等(建议少于 15 个智能体),运行中的工作流状态栏现在会显示当前默认规模,并提示用户前往 /config 修改。新增的 workflowSizeGuideline 配置键允许在任意设置文件中覆盖该建议值,当该键已设置时,/config 中对应行将自动隐藏,避免重复配置。
安全与网络控制方面,新增 sandbox.network.strictAllowlist 设置,启用后沙箱命令访问非白名单主机时将直接拒绝而非弹出提示,适合对网络访问有严格管控需求的企业环境。MCP 相关能力也有所完善:headless stream-json 初始化事件新增 mcp_server_errors 字段,列出因配置校验被跳过的 --mcp-config 条目;终端运行时会打印启动警告;MCP 配置值若存在隐藏的前后空白字符,现在也会给出提示。
本次更新修复了多个影响稳定性和用户体验的问题。自托管 Runner 重启期间已批准的权限不再丢失,SIGTERM 信号处理更加干净,结构化失败分类让钩子错误、Runner 崩溃和配置错误可被区分对待。Windows 平台上 CLAUDE_CODE_GIT_BASH_PATH 指向非 bash/sh 二进制时不再异常退出,而是忽略并给出警告。Vim 模式、屏幕阅读器模式以及远程控制客户端的快速模式状态同步问题也均已修复。
要点
- Claude Opus 5 成为默认 Opus 模型,支持 100 万 token 上下文,Opus 4.7 退出快速模式。
- 子智能体嵌套深度默认从 1 层扩展至 3 层,复杂多智能体工作流编排能力大幅提升。
- 新增沙箱严格网络白名单,MCP 错误信息更透明,适合企业级安全管控场景。
- 动态工作流默认规模调整为中等,新增配置键支持灵活覆盖,工作流管理更规范。
- 修复十余处 Bug,涵盖 Windows 路径处理、Vim 模式、屏幕阅读器及自托管 Runner 稳定性。