工程 / 官方
大规模修复与多项体验升级
Anthropic 于 2025 年 10 月 26 日发布 Claude Code v2.1.311,这是一次覆盖面极广的维护性更新。本次发布修复了超过 50 个已知问题,涉及启动性能、子代理(subagent)工具调用、MCP 服务器连接、云端与远程控制会话、文件读写操作、屏幕阅读器无障碍支持等多个方面。其中,标准上下文会话在请求超过 200K token 时因报错中断的问题得到修复,Claude Code 现在会自动压缩对话并继续执行。此外,自托管运行器新增了 --hold-idle-file 和 --max-hold-min 参数,用于在宿主机报告有进程残留时保持空闲会话。VS Code 扩展同步获得多项修复,包括代码块语法高亮、语音听写停止逻辑以及登录 shell 导致扩展宿主冻结等问题。云端会话、Claude Tag 和 Code Review 模块也分别收到针对性改进。
本次更新最受关注的修复之一,是解决了标准上下文会话在单次请求超过 200K token 时抛出「Usage credits required for 1M context」错误并中断的问题。Claude Code 现在会在触发该限制时自动压缩对话历史并继续执行,避免用户工作流被意外打断。与此同时,Write 和 Edit 工具在修改数千行文件后出现最长 5 秒卡顿、并错误报告「0 行变更」的问题也一并得到修复。
子代理(subagent)相关的多个稳定性问题在本版本中集中修复。此前,子代理无法使用在其启动后才完成连接的 MCP 服务器提供的工具;后台子代理启动的隔离工作树(worktree)可能在子代理仍在运行时被提前删除;SubagentStop 钩子每分钟触发约两次而非在子代理结束时触发一次。这些问题均已得到修复,整体提升了多代理协作场景下的可靠性。
MCP 相关的多处错误显示与命名问题也在本次更新中得到纠正。claude mcp add、claude mcp remove 和 /mcp 命令在仓库根目录以下运行时,会错误地显示当前文件夹名称而非 ~/.claude.json 中对应的项目条目;claude mcp list 和 claude mcp get 在连接失败行中会将错误码重复显示两次(如 ENOENT: ENOENT:…)。此外,/mcp 在清除认证后将正常工作的服务器标记为失败、或对无需凭据的服务器显示「已认证」等误导性状态,均已修复。
云端与远程控制会话的稳定性得到显著改善。远程控制会话在网络代理拦截启动请求时会卡在「Connecting」状态长达约两分钟,该问题已修复。Cowork 云端会话在重启后丢失连接器和大部分工具的问题,以及 WebFetch 和 WebSearch 在响应停滞时无限挂起的问题(现在超过 300 秒后会主动失败)也一并解决。此外,Claude 发送给云端或远程控制会话的消息在 Claude 移动端被错误显示为用户自己消息的问题同样得到修复。
VS Code 扩展在本次更新中新增了代码块语法高亮功能,支持浅色、深色和高对比度深色三种主题。同时修复了多个影响日常使用的问题:自定义技能和自定义斜杠命令从 VS Code 或 JetBrains 面板发送时遗漏当前打开文件或选中行的内容;macOS 和 Linux 上登录 shell 执行启动文件读取 PATH 时导致扩展宿主冻结;语音听写在点击发送按钮后未停止录音等。扩展还新增了在 VS Code 遥测设置关闭时自动为 Claude Code 会话设置 DISABLE_TELEMETRY 的逻辑。
在行为变更方面,ultrathink 关键词在交互式终端中现在会以 xhigh 努力级别运行,适用于 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.1 等模型。--output-format json 和 stream-json 输出现在会将 DEL、C1 控制字符及 Unicode 格式字符转义为 \uXXXX 形式。模型名称和 ID 在后缀无实际效果的模型上不再显示 [1m] 后缀标签。此外,DISABLE_COMPACT 在设置文件和模组的 $.env.set 中现在只能关闭压缩,不能重新开启,以防止配置冲突。
要点
- 标准上下文会话超过 200K token 时不再中断,Claude Code 会自动压缩对话并继续,显著提升长任务的连续性。
- 子代理稳定性大幅改善,修复了 MCP 工具调用失败、工作树提前删除、钩子频繁触发等多个多代理协作场景下的关键问题。
- MCP 命令的错误显示与状态标注问题得到系统性修复,减少了因误导性提示导致的排查成本。
- VS Code 扩展新增代码块语法高亮,并修复了自定义命令遗漏上下文、扩展宿主冻结等影响开发体验的问题。
- ultrathink 关键词行为收窄,仅在能实际提升努力级别的场景下生效,避免在引号或文件路径中误触发。