Claude Code v2.1.302：扩展 fork 子代理默认启用范围，调整自动模式与权限默认行为

Claude Code 发布 v2.1.302，此次更新重点涉及子代理调度、自动模式、权限默认值，以及插件、MCP 和云端会话的稳定性。这是 AI agent 工具版本更新，并非 Claude 基础模型发布。

fork 子代理扩展至更多入口

此前已在终端默认启用的 fork 子代理（subagent_type: "fork"），现在也默认用于 claude -p、Agent SDK、桌面应用和 VS Code。

需要关闭时，可设置 CLAUDE_CODE_FORK_SUBAGENT=0。claude mcp serve 不提供 fork 子代理，不在此次默认启用范围内。

子代理的执行方式也有调整：

• 桌面应用和 VS Code 中，主对话启动的子代理现在始终在后台运行，与终端行为一致。
• 在 claude -p、Agent SDK、桌面应用和 VS Code 中，子代理自身发起的 Agent 调用，现在默认在前台运行。
• prompt 与 agent hooks 对同一事件最多同时运行 12 个，其余排队等待。

这些变化主要影响通过多个入口组织代理任务、使用嵌套 Agent 调用或配置大量 hooks 的用户。

自动模式新增模型选择，权限默认值调整

新版增加环境变量 CLAUDE_CODE_AUTO_MODE_MODEL，用于选择客户端自动模式分类器使用的模型。它不会改变服务端自动模式所用的模型。

对于采用服务端分类器的自动模式，如果对话过长、无法完成安全检查，系统现在会先压缩对话；此前，这种情况会导致每次需要检查的工具调用都被拒绝。

claude -p 和 Agent SDK 的权限默认行为也发生变化：未指定权限模式时，在使用第三方提供商、关闭遥测或全新安装等情况下，会以 default 模式启动。显式指定 --permission-mode auto 仍会使用自动模式。依赖隐式默认行为的脚本和集成需要留意这一调整。

此外，/config 新增 Idle compaction 设置项，可关闭或重新开启空闲压缩；压缩完成后的提示也会说明关闭方法。更新同时修复了对话压缩期间停止当前轮次可能触发的“Prompt is too long”错误。

文件读取、MCP 与插件修复

Read 工具现在会拒绝超过 128 MB 的图片来源，修复此前可能将任意大小图片，或名称看似图片的管道、设备完整载入内存的问题。

MCP 方面，新版修复了服务器协商使用协议版本 2026-07-28，但省略 resultType、ttlMs 或 cacheScope 时，可能出现工具列表为空或所有工具调用失败的问题。会话中途切换到 Vertex 或 Bedrock 后，因 diagnostics 字段导致请求失败的问题也已修复。

插件相关调整包括：

• 修复部分子命令在设置写入完成前退出，导致变更丢失或遗留 .tmp 文件。
• 修复 git 默认使用 reftable 引用格式时，插件市场反复克隆、已安装插件版本显示为“unknown”的问题。
• 减少插件命令和 agent 文件加载时的文件系统调用，官方称这改善了启用大量插件时的启动速度，尤其是在 Windows 上；更新记录未提供性能倍率。

Windows 用户还获得了 exFAT、FAT32 项目目录中文件写入被拒绝或反复询问的修复。通过网关使用带前缀的 Opus 4、4.1 模型名称时，/autocompact 和 /effort 保存到错误模型的问题也已修复。

云端任务修正状态与重复执行问题

云端会话修复了一项可能造成重复工作的故障：计划任务运行中途失败后，可能在一小时或更久之后从头再次执行，例如重复发布同一份报告。

此次还修正了任务意外停止后仍显示 Completed、尚未启动就被归档却显示 Cancelled，以及恢复会话后费用和用量从零开始显示等问题。例行任务页面新增提示横幅，用于说明上次运行未能启动的原因，例如组织达到云端会话并发上限。

“Rewind to here”无法回退到较早消息的问题也已修复；自托管 runner 需要 Claude Code v2.1.246 或更高版本。

其他入口与使用限制

VS Code 更新涉及 MCP 登录授权页、流式代码块显示，以及浏览器未连接时误报“Browser connected”等问题。Claude Tag 则修复了 Slack 附件传递、私信重试、工作区选择和链接格式等问题，并调整了管理设置的分类。

另外，/design-sync 和 /design-login 新增通知：独立 Claude Design 将于 2026 年 12 月 14 日前关闭。

以上内容来自官方更新记录，各项变更按其标注的终端、SDK、桌面应用、VS Code、云端会话或 Claude Tag 范围适用；本文未进行独立功能或性能测试。