工程 / 官方
大规模修复 MCP、Agent 与网关稳定性问题
Anthropic 于 2025 年 9 月 17 日发布 Claude Code v2.1.274,这是一次覆盖范围极广的版本更新,涉及新功能添加、大量 Bug 修复以及多项性能改进。新功能方面,版本新增内存临界警告提示、MCP 启动等待时间上限控制参数 CLAUDE_CODE_MCP_STARTUP_WAIT_MS、OpenTelemetry 追踪 span 的 effort 属性,以及 Claude apps 网关的 Postgres 连接超时配置项。修复层面,本次更新解决了会话因 unexpected tool_use_id 错误陷入无限重试的问题,修复了 MCP 工具调用在 Streamable HTTP 模式下约五分钟后超时的缺陷,以及 Agent 在自动更新重启后丢失 --model、--effort 等参数的问题。此外,VS Code 扩展、Claude Code on the web、Claude Tag 和 Code Review 模块均获得专项修复与改进。
v2.1.274 在新功能方面带来了若干实用补充。当系统内存使用达到临界状态时,Claude Code 现在会显示可见警告并提供释放内存或安全重启的操作步骤。新增的环境变量 CLAUDE_CODE_MCP_STARTUP_WAIT_MS 允许开发者精确控制首次非交互轮次等待 MCP 服务器连接的最长时间,设为 0 则表示不等待,有效避免启动阶段的不必要延迟。全屏模式下,折叠的队友和 Agent 消息现在支持点击展开。
MCP 相关修复是本次更新的重头戏。版本修复了配置为 http 模式但仅支持传统 HTTP+SSE 协议的 MCP 服务器在首次请求返回 422 或其他 4xx 错误时无法连接的问题。Streamable HTTP MCP 工具调用即使设置了更长的超时时间也会在约五分钟后超时的缺陷得到修复。此外,MCP 服务器发送 list-changed 通知但未声明 listChanged 时,提示和资源无法刷新的问题也一并解决。403 insufficient_scope 错误现在会明确列出缺失权限并引导用户通过 /mcp 重新认证,而非误报为登录过期。
Agent 与会话稳定性方面同样获得大量修复。claude agents 在自动更新重启后丢失 --model、--effort、--permission-mode 等关键参数的问题已修复。由 hook 驱动的会话(如活跃的 /goal)在上下文再次溢出时会错误提示「Prompt is too long」而非执行压缩,此问题现已解决。使用 --continue 或 --resume 恢复已压缩会话时丢失活跃 /goal 的缺陷也得到修复。自托管 runner 在多次令牌刷新失败后每轮都返回 401 的问题,通过持续重试并在收到 401 后主动获取新令牌的机制得以解决。
Claude apps 网关在本次更新中获得多项稳定性与性能提升。网关现在在收到 SIGTERM 信号时不再立即切断所有开放流,而是允许进行中的请求最多完成 25 秒后再退出,超时时间可通过 CLAUDE_GATEWAY_DRAIN_TIMEOUT_MS 配置。消费限额检查的数据库查询从四次往返优化为一次,显著降低高负载下的超时概率。网关启动时现在会对首次 Postgres 连接最多重试三次,避免数据库稍晚可达时导致启动失败。此外,Postgres 连接在消费检查期间断开时的未处理 Promise 拒绝问题也已修复。
VS Code 扩展、Claude Code on the web 及 Claude Tag 各自获得专项改进。VS Code 新增了窗口重载后继续中断步骤的能力,以及内存和指令的自定义菜单入口;修复了设置文件并发写入导致 settings.json 损坏或配置丢失的问题。Claude Code on the web 新增了差异视图的对比分支选择器,并修复了 GitHub 令牌续期短暂出错时 git 操作失败的问题。Claude Tag 修复了其他 Slack 应用 @提及 Claude 时无响应、频道搜索报错等多个实际使用中的痛点,并将进度清单限制在 2000 字符以内,避免在繁忙线程中频繁刷新。
本次更新还包含若干行为变更。Bedrock、Vertex、Foundry 及禁用遥测的安装版本现在默认使用 v2 MCP 客户端和 MCP 2026-07-28 协议与直连 HTTP 服务器通信,与其他安装版本保持一致,可通过 MCP_SDK_GENERATION=v1 或 MCP_PROTOCOL_NEGOTIATION=legacy 回退。/code-review 命令对没有专属调优配置的模型改为使用更精简的内联审查提示,不再派生大量审查子 Agent。插件和市场克隆现在默认将 Git LFS 文件保留为指针而非自动下载,需要时可在检出目录执行 git lfs pull 手动获取。
要点
- MCP 连接与工具调用稳定性大幅提升,修复了 HTTP+SSE 兼容性、Streamable HTTP 超时及 list-changed 通知刷新等多个关键缺陷
- Agent 参数在自动更新重启后不再丢失,/goal 等 hook 驱动会话的上下文溢出处理逻辑也得到修正
- Claude apps 网关优化了优雅关闭机制和消费检查性能,数据库查询从四次减少为一次,高负载稳定性显著改善
- VS Code 扩展修复了设置文件并发写入损坏问题,并新增内存管理和指令编辑的快捷入口
- Claude Tag 修复了多个 Slack 集成场景下的响应缺失和搜索错误,进度清单输出更加克制