工程 / 官方
大规模修复与功能调整,涵盖插件、云会话与 Slack 集成
Anthropic 于 2025 年 10 月 16 日发布 Claude Code v2.1.302,这是一次覆盖范围极广的版本更新。新版本新增了 CLAUDE_CODE_AUTO_MODE_MODEL 环境变量,允许用户为客户端自动模式分类器指定模型;在 /config 中加入空闲压缩开关;并提示独立版 Claude Design 将于 2026 年 12 月 14 日关闭。修复方面,本次更新解决了切换至 Vertex 或 Bedrock 时请求失败、Read 工具将超大图片文件全量载入内存、PowerShell 工具无法找到插件 bin 目录中命令等多个问题。云会话方面修复了「回退到此处」功能失效、定时任务重复执行等严重 bug。Claude Tag Slack 集成也获得大量修复,包括 HEIC 等图片格式无法传递、企业 Grid 直信忽略工作区设置等问题。此外,Windows 平台 exFAT/FAT32 驱动器文件写入被拒的问题也得到解决。
本次更新最值得关注的新增功能是 CLAUDE_CODE_AUTO_MODE_MODEL 环境变量,开发者可借此为客户端自动模式分类器单独指定模型,而不影响服务端自动模式所使用的模型。与此同时,/config 页面新增了空闲压缩(Idle Compaction)开关行,用户可随时关闭或重新开启该功能,且每次空闲压缩完成后的提示信息也会说明如何关闭它。
在 Bug 修复层面,本次更新解决了多个影响稳定性的关键问题。切换至 Vertex 或 Bedrock 网关后请求因「Extra inputs are not permitted」报错失败的问题已修复;Read 工具此前会将任意大小的图片文件完整载入内存,现已对超过 128 MB 的图片来源拒绝处理;/autocompact 和 /effort 在网关以前缀方式命名 Opus 4 或 4.1 时会保存到错误模型的问题也一并修复。
插件与工具链方面同样获得多项修复。git 默认使用 reftable 引用格式时,插件市场每次刷新都会重新克隆、新安装的 git 插件版本显示为「unknown」的问题已解决;PowerShell 工具无法找到插件 bin 目录中命令、搜索无结果时管道至 Select-Object 报错的问题也得到修复。Windows 用户此前在 exFAT 或 FAT32 驱动器上的项目中每次文件写入都会被拒绝或弹出询问,该问题现已修复。
云会话方面的修复同样重要。「回退到此处」功能此前在云会话中除最新消息外全部失效,现已修复(自托管运行器需升级至 v2.1.246 或更高版本)。定时任务在中途失败后可能在一小时或更长时间后从头重新运行(导致重复发送报告等操作)的严重 bug 已修复。此外,云会话的费用与用量在会话于新进程中恢复后从零重新计算的问题也得到解决。
Claude Tag Slack 集成在本次更新中获得大量修复与改进。HEIC、SVG、TIFF 和 BMP 格式的图片此前无法传递给 Claude,现在会作为工作文件送达;Slack Enterprise Grid 上的直信此前忽略工作区下拉选择,现已正确在用户最后打开 Claude 的已连接工作区下运行。管理员设置方面,Claude 的访问权限现已整理为「Bundles、Connectors、Skills and plugins、Channels」四个标签页,仓库搜索覆盖范围也扩展至最多 100 个已连接 GitHub 账户。
行为变更方面,fork 子代理(subagent_type: fork)现已在 claude -p、Agent SDK、桌面应用和 VS Code 中默认开启,与终端保持一致;可通过 CLAUDE_CODE_FORK_SUBAGENT=0 关闭。桌面应用和 VS Code 现在始终在后台运行主会话的子代理,与终端行为统一。提示词与代理钩子现在限制同一事件最多同时运行 12 个,其余排队等待,以避免资源竞争。
要点
- 新增 CLAUDE_CODE_AUTO_MODE_MODEL 变量,支持为客户端自动模式分类器单独指定模型,不影响服务端配置
- Read 工具现拒绝处理超过 128 MB 的图片来源,防止大文件被完整载入内存造成资源耗尽
- Windows 平台 exFAT/FAT32 驱动器上的文件写入被拒问题已修复,多插件场景下启动速度也得到提升
- 云会话定时任务重复执行、费用重置等严重 bug 已修复,「回退到此处」功能恢复正常
- Claude Tag Slack 集成获得大量修复,包括多种图片格式支持、Enterprise Grid 工作区路由及管理员设置重组