2026 年 7 月 2 日,Claude Code 发布 v2.1.199,这是一个专注于修复和稳定性的重要版本,重点解决了 Subagent 错误处理、后台代理可靠性和各类边缘情况问题。
核心修复:Subagent 错误处理大升级
速率限制错误不再静默失败
之前版本中,当子代理遇到速率限制(rate limit)或服务器错误时,会静默返回空结果,父代理无从得知出了什么问题。
v2.1.199 修复了这个问题:
- 被速率限制或服务器错误打断的子代理,现在会将部分工作结果返回给父代理
- 报告 API 错误(如用量限制)的子代理,不再以「成功」结果上报,而是明确上报错误
# 之前的行为
Parent Agent: 子代理已完成
<空结果,没有任何提示>
# 修复后的行为
Parent Agent: 子代理遇到速率限制,已返回部分结果:
<部分工作内容>
[子代理在 X 步完成前因速率限制中断]
新的速率限制重试策略
临时性的服务端速率限制错误(429,与用量限制无关)现在对订阅用户自动重试:
- 使用指数退避重试,而不是直接失败
CLAUDE_CODE_RETRY_WATCHDOG现在将非容量类瞬态错误的默认重试次数提升至 300 次CLAUDE_CODE_MAX_RETRIES的上限从 15 次提升至无上限
Linux 后台代理致命 Bug 修复
修复了一个严重的 Linux 问题:不干净的关机会留下损坏的 worker 记录,导致后台代理守护进程每约 50 秒就会杀死自身和所有运行中的代理。
这个 Bug 对 Linux 服务器上运行后台 Claude Code 的用户影响极大,现已修复。
Stacked Slash-Skill 调用修复
当你连续调用多个 Skill(如 /skill-a /skill-b)时,之前只会加载第一个 Skill。
v2.1.199 修复了这个问题:现在最多可以加载前 5 个 Skill。
# 现在正确工作
> /code-review /security-check /format-check
# 三个 Skill 都会被加载并执行SSL 证书错误处理改进
修复了 SSL 证书错误(TLS 检查代理、缺少 NODE_EXTRA_CA_CERTS、过期证书)的处理方式:
之前:消耗所有重试次数后才显示错误提示 现在:立即失败并显示具体的修复建议
# 常见 SSL 错误修复
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
claude后台代理其他修复
- macOS SSH 冷启动修复:修复了通过 SSH 在 macOS 上冷启动后台代理时出现的「Could not switch to audit session」错误
claude stop竞争条件修复:claude stop命令不再被后台代理重启所悄悄撤销- 进度指示器修复:长命令运行时,后台任务的进度指示器不再卡住数分钟
- 低内存提示改进:内存不足的机器上,后台会话现在会显示「内存不足,建议释放资源」而不是通用错误
代理面板 UI 修复
- 当其他子代理还在工作时,空闲子代理不再从代理面板消失
- 多余的空闲代理现在折叠成一个可展开的摘要行
- 查看子代理时输入
/model或/fast,会显示提示说明该命令作用于主代理
版本管理修复
修复了从启动恢复对话框重置损坏配置文件时的问题: 之前会直接销毁配置文件,现在会先备份文件再重置,防止不可恢复的数据丢失。
总结
v2.1.199 是一个专注于生产环境可靠性的版本。如果你在生产环境运行 Claude Code 后台代理,尤其是 Linux 服务器用户,强烈建议立即升级。
npm update -g @anthropic-ai/claude-code
claude --version # 应显示 2.1.199来源:Claude Code Changelog v2.1.199 — Anthropic,2026-07-02