工程 / 官方
子智能体模型控制、大文件读取与数十项修复
Anthropic 于 2025 年 10 月 9 日发布 Claude Code v2.1.296,带来多项新能力与大规模缺陷修复。新功能方面,开发者可通过环境变量 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL 为所有工作流智能体统一指定模型,同时保留其他子智能体的独立模型设置;子智能体前置元数据新增 autoCompactWindow 字段,支持比主对话更早触发上下文压缩;Read 工具新增 allow_large 选项,允许在上下文空间充足时一次性读取超出常规大小限制的文本文件。Claude 应用网关的托管策略新增 code 键,与 Claude Desktop 的 Code 标签页联动。此外,本次更新修复了托管设置中 PreToolUse 钩子拒绝工具调用后意外终止会话、非 UTF-8 文件编辑替换全部非 ASCII 字符、Windows 下 PowerShell 长命令始终触发权限询问等六十余项问题,并对 VSCode 扩展、云会话、Slack 集成及代码审查模块进行了专项改进。
此次更新在子智能体编排层面带来实质性增强。新增的 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL 环境变量允许开发者为工作流中的所有智能体统一指定运行模型,而不影响其他子智能体各自的模型配置,适合需要在成本与能力之间精细调配的多智能体流水线场景。与此同时,子智能体定义中新增的 autoCompactWindow 字段让子智能体可以独立于主对话提前触发上下文压缩,有助于在长任务中维持稳定的推理质量。
Read 工具新增 allow_large 选项,解决了此前大型文本文件必须分块读取的痛点。当 Claude 判断需要完整文件内容且当前上下文窗口有足够空间时,可通过该选项一次性加载超出默认大小限制的文件,减少多轮读取带来的上下文碎片化问题。Claude 应用网关的托管策略同步新增 code 键,其配置语义与 cli 键一致,并可联动开启 Claude Desktop 的网关模式,为企业统一管控桌面端代码功能提供了标准化入口。
本次修复覆盖范围极广,其中若干问题对安全性与数据完整性影响较为显著。Edit 和 NotebookEdit 工具此前会将 Windows-1252、Shift-JIS、GBK 等非 UTF-8 编码文件中的所有非 ASCII 字符替换为乱码,现已改为直接拒绝此类编辑操作,避免文件损坏。Bash 权限检查中存在的一个漏洞——通过赋值 BASH_ARGV0 变量后使用可绕过审批——现已修复,相关命令将正常触发权限询问。共享转录和调试日志中的密钥脱敏逻辑也得到补全,修复了部分跟随无值键的字段未被遮蔽的问题。
插件与 MCP 生态的稳定性在本版本中得到集中治理。修复了插件市场在名称与 JavaScript 保留字 constructor 相同时安装失败的问题,现在 add 命令会明确拒绝此类名称;名为 constructor 或 prototype 的插件密钥在下次保存选项时被意外删除的问题也一并修复。此外,从 claude.ai 同步的插件因其声明的市场依赖同样来自 claude.ai 而被禁用的逻辑错误已得到纠正,技能同步循环下载、安装永不完成的问题也在多会话共享配置目录的场景下得到解决。
Windows 平台和 VSCode 扩展获得多项专项修复。Windows 下 PowerShell 命令超过约 1 KB 时始终触发权限询问的问题已修复,允许规则和只读检测现可正常作用于最长 32 KB 的命令;stdio MCP 服务器在关闭时被强制终止的问题也已改为先关闭 stdin、等待 300 毫秒后再终止进程树。VSCode 扩展方面,修复了 claudeCode.spinnerVerbs 设置项缺失导致 settings.json 验证失败的问题,以及 Windows 完整路径格式的聊天链接无法正确打开文件的问题。Slack 集成(Claude Tag)同步修复了线程页脚重复显示、含括号 URL 链接断裂、六位数字被误识别为十六进制颜色等多个体验问题。
要点
- 新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL 环境变量,支持为工作流智能体统一指定模型,同时保留其他子智能体的独立配置,提升多智能体编排的灵活性。
- Read 工具的 allow_large 选项解除了大文件单次读取的限制,在上下文空间充足时可完整加载超大文本文件,减少分块读取带来的上下文碎片。
- 修复了 Edit 工具对非 UTF-8 编码文件(Windows-1252、Shift-JIS、GBK)的破坏性替换行为,现改为拒绝操作,保护文件完整性。
- Windows 平台 PowerShell 长命令权限检查上限从约 1 KB 提升至 32 KB,允许规则和只读检测得以正常生效。
- 插件市场、MCP 钩子、云会话、Slack 集成及代码审查模块均获得针对性修复,整体稳定性显著提升。