工程 / 官方
修复多项稳定性问题
Anthropic 于北京时间 2025 年 9 月 1 日发布了 Claude Code v2.1.252 版本,此次更新以缺陷修复为主,涉及四个影响日常使用体验的关键问题。首先,部分 Mac 用户在执行 Bash 命令时会遭遇「task output swap refused」错误,本次已予以修复。其次,在尚未生成 .claude/settings.local.json 文件的项目中,「始终允许」权限选项无法正常保存的问题得到解决。第三,当 claude.ai 连接质量下降时,由 Claude Desktop 或 VS Code 托管的远程控制会话在工具执行完毕后会出现数分钟的卡顿,此问题已被修复。最后,后台任务在磁盘写满等场景下产生的超大错误输出,会导致对话内容超出 API 请求体积上限,本次更新同样对此进行了处理。
Anthropic 发布了 Claude Code v2.1.252,这是一次以稳定性修复为核心的维护版本更新。此次发布由工程师 ashwin-ant 主导,共涵盖四项针对真实用户场景的缺陷修复,旨在提升工具在复杂开发环境下的可靠性。
其中一项修复针对部分 Mac 用户在运行 Bash 命令时出现的「task output swap refused (tasks dir moved or linked)」报错。该错误通常在任务目录被移动或以符号链接方式挂载时触发,影响正常的命令执行流程,此次更新对底层任务输出机制进行了调整以规避该问题。
另一项修复解决了权限持久化的问题:当项目目录下尚不存在 .claude/settings.local.json 文件时,用户设置的「始终允许」选项在会话结束后无法被保留。这一问题对新建项目的用户影响尤为明显,修复后系统将在必要时自动创建该配置文件。
在远程控制场景下,由 Claude Desktop 或 VS Code 托管的会话在网络连接至 claude.ai 出现波动时,工具执行完毕后可能出现长达数分钟的无响应状态。本次更新改善了降级连接条件下的会话恢复逻辑,减少了不必要的等待时间。
此外,后台任务通知机制也得到了优化。当任务失败并产生体积极大的错误输出时(例如磁盘写满导致的 git 操作错误),原有实现会将完整错误内容附加至对话上下文,进而超出 API 单次请求的大小限制。新版本对此类输出进行了截断或压缩处理,确保对话流程不受影响。
要点
- Mac 用户执行 Bash 命令时遭遇的「task output swap refused」错误已在 v2.1.252 中修复,涉及任务目录被移动或符号链接的场景。
- 新建项目中「始终允许」权限选项无法保存的问题得到解决,系统现在会在缺少配置文件时自动创建。
- Claude Desktop 与 VS Code 托管的远程控制会话在网络降级时的卡顿问题已被修复,提升了弱网环境下的使用体验。
- 后台任务产生超大错误输出时导致 API 请求超限的问题已处理,避免对话流程被意外中断。