工程 / 官方
大规模修复后台 Agent 稳定性问题
Anthropic 于 2025 年 7 月 7 日发布 Claude Code v2.1.203,此版本以大规模缺陷修复为主,涵盖超过 25 项问题修正。核心改动集中在后台 Agent 会话的稳定性上:修复了会话令牌过期导致后台会话永久无响应的问题,会话现可自动恢复;修复了 macOS 上因误判低内存而导致切换后台 Agent 时卡顿 15 至 20 秒的回归问题;修复了返回 claude agents 界面时子 Agent 被静默停止并从头重跑的严重缺陷。此外,本次更新还修复了 Windows 平台下 PATH 继承错误、ANTHROPIC_BASE_URL 丢失导致 401 鉴权失败、以及 git worktree 相关的多项问题。性能方面,二进制体积与启动内存各减少约 7 MB,交互会话的上下文指示器不再在每轮对话后重新分析全量记录,流式响应期间的实时预览也不再触发全屏重绘。
Claude Code v2.1.203 在后台 Agent 会话稳定性方面进行了全面整治。此前,当守护进程的会话令牌过期时,后台会话会陷入永久无响应状态,用户无法附加、回复或停止会话;新版本引入自动恢复机制,令牌失效后会话可自行重建连接。与此同时,macOS 上因误判低内存触发的 15 至 20 秒卡顿问题(该问题在 2.1.196 版本引入)也得到修复。
子 Agent 的工作连续性问题在本次更新中得到重点关注。过去,用户返回 claude agents 界面时,正在运行的子 Agent 会被静默终止,提示词从头重新执行,导致已完成的工作全部丢失。v2.1.203 修复了这一行为,子 Agent 的工作成果现在可以正常延续。此外,TaskStop 和 TaskOutput 命令此前无法定位由其他 Agent 派生的后台 Agent,现在错误信息会列出所有运行中 Agent 的 ID 与描述,便于排查。
Windows 平台用户将受益于多项针对性修复。后台 Agent 此前会从守护进程继承过时的 PATH,而非从调度 Shell 获取,导致工具缺失;该问题现已修复。后台会话与 agent-view 会话丢失 Shell 导出的 ANTHROPIC_BASE_URL 的问题也得到解决,此前该缺陷会将 API 密钥发送至默认端点并返回 401 错误。另外,Windows 上执行 /clear 后后台任务输出被空文件永久覆盖的问题同样得到修正。
git worktree 相关场景的多个边界问题在本次版本中集中修复。Bash 在拥有大量 git worktree 的仓库中会因参数列表过长而失败;worktree 隔离的子 Agent 有时会在父级 checkout 而非自身 worktree 中执行 Shell 命令;多仓库工作区中嵌套仓库的 worktree 创建会被拒绝,导致后台会话无法隔离编辑。上述问题均已修复。此外,@ 目录选择器未显示已注册 git worktree 的问题也一并解决。
性能与体验方面,本次更新带来多项改进。通过将一个大型捆绑依赖改为懒加载,二进制体积与启动内存各减少约 7 MB。交互会话中,上下文用量指示器不再在每轮对话后重新分析完整记录,有效降低了内存与 CPU 占用。流式响应期间,实时预览不再触发全屏重绘,响应性显著提升。子 Agent 行为也得到优化,Agent 将更少地将整个任务再次委托给另一个子 Agent。
界面与配置层面,本次版本新增了登录即将过期的提醒,用户可在后台会话被中断前提前重新鉴权。手动权限模式下,页脚现在会显示灰色 ⏸ 标识,使当前模式始终可见。MCP 方面,会话的附加工作目录现已加入 roots/list,目录集合变更时会发送 notifications/roots/list_changed 通知。左方向键不再关闭后台任务、差异对比和工作流详情视图,改为按 Esc 键关闭。VSCode 扩展新增了「为所有会话启用远程控制」的设置开关。
要点
- 后台 Agent 会话稳定性大幅提升:令牌过期自动恢复、macOS 卡顿修复、子 Agent 工作成果不再丢失,是本次更新最核心的改动。
- Windows 平台专项修复覆盖 PATH 继承、ANTHROPIC_BASE_URL 丢失及任务输出被清空等多个痛点,Windows 用户体验显著改善。
- 性能优化实质可感:二进制体积与启动内存各减少约 7 MB,交互会话 CPU 与内存回归问题得到修正,流式响应渲染效率提升。
- MCP 集成增强:会话附加工作目录纳入 roots/list 并支持变更通知,为依赖 MCP 的工具链提供更完整的上下文感知能力。
- 新增登录过期预警与手动权限模式可视化标识,减少因鉴权中断或模式不明导致的操作失误。