Claude Code 2.1.321:CI 里的静默失败
2.1.321 与 2.1.319 把 claude -p 写盘失败、auto mode 动作被拒、remote-control 无应答由静默退出 0 改为退出 1;73 条变更多为修复,CI 假绿灯被堵住。
2026-11-12 17:29:19 · Editor: 刘立永Claude Code 2.1.321(11 月 9 日发布)修了 CI 最容易误判的一类问题:claude -p 在 Linux 上遇到 NFS 导出写满或配额用尽、transcript 丢行时,过去会静默退出 0,现在打印错误并退出 1。影响是「绿灯但没干活」的假成功被堵住。该版在 GitHub Releases 页面列出 73 条可见变更,绝大多数是修复。
三个「退出 0」被改成「退出 1」
官方 CHANGELOG 里同类的至少三处,跨 2.1.319 与 2.1.321 两个版本:
• 2.1.321:claude -p 在 Linux 上因完整 NFS 导出或配额用尽丢失 transcript 行时,打印错误,text 与 json 输出均退出 1。
• 2.1.319:claude -p 在 auto mode 因没有可用安全检查而拒绝动作时,过去文本输出退出 0,现在 text 与 JSON 均退出 1。
• 2.1.319:claude remote-control 首跑问题无人应答(脚本、服务、批处理、Ctrl+C)时,过去静默退出 0,现在说明原因并退出 1;同一版还修了「管道输入一个不带换行的 y 被忽略」,现在按 yes 处理。
口径说明:以上是 GitHub 官方 CHANGELOG 条目原文的中文转述,官方 CHANGELOG 不写日期;2.1.321 的 Releases 页面标注「released this 09 Nov 19:22」,2.1.319 按第三方版本时间线记为 11 月 6 日。
网络与磁盘:无限等待也曾被当成「没出错」
同一批修复里还有几条更隐蔽的:登录、token 刷新与登出在「对端接受连接但 TLS 握手永不回应」时会无限等待,2.1.321 起不再挂死;内存耗尽导致 transcript 读不出来时,新消息不保存、claude -p / SDK / VS Code 会话挂起,也一并修掉。2.1.317 另有一条:claude -p 在磁盘满或配额用尽导致 ~/.claude.json 写入失败时,原来退出 0,改为报错并退出 1;该条官方同时注明「完整 NFS 导出可能仍检测不到」,是明确的口径边界,不能当全覆盖。共同点是:失败没有异常、没有非零退出码,只有上游流水线会把它记成成功。
后台任务与指标同样会骗人
2.1.321 还改了两类「看起来完成」的信号:后台命令通知与 TaskStop 结果对超过 1000 字符的命令只把开头和结尾交给 Claude,以省上下文;被服务中断的后台 agent 不再报成「用户停止」并拒绝恢复。指标侧,2.1.319 把 OpenTelemetry 的 claude_code.session.count 计数口径修正为「预启动进程在被认领时才计一次」,此前未认领的 prewarm 进程也被计入。做容量与用量看板的团队,跨版本对比之前要先确认计数定义变了,否则同一段时间的会话数会平白少一截。
73 条是什么口径
73 是 GitHub Releases 页面 v2.1.321 段「What's changed」下可见的「-」条目数(含末尾被截断的一条),不是官方公布的变更总数;同页 v2.1.322 只有 1 条、v2.1.319 为 69 条、v2.1.317 为 73 条,均为页面可见数。截至 11 月 12 日,官方 CHANGELOG 与 Releases 顶部仍是 2.1.322,没有 2.1.323;版本序列里 2.1.320、2.1.315、2.1.313 也不存在。用「版本号变大」推断「变更变多」不成立,逐条核对条目才是可靠做法。
给企业技术团队的三条动作
第一,把非交互运行的退出码接进流水线断言。claude -p / SDK 任务不要只看进程是否结束,还要校验退出码与预期产物(输出文件、测试结果、commit),并对 NFS/SMB 共享盘上的会话单独加超时;上述修复只在客户端升到 2.1.319 及以后才生效。
第二,把版本核对写进变更单。锁一个团队统一版本,升级前读官方 CHANGELOG 对应版本段,重点看「Changed」与「Removed」条目——它们改变既有行为,比「Added」更容易让老脚本失效。
第三,凭据与共享配置同步复核。TLS 握手挂死、token 刷新失败这类问题在共享构建机上表现最像「网络慢」;借升级窗口做一轮凭据轮换,把 settings 基线纳入版本管理与变更审计,避免一台机器改了、其他没改。
我们给山东的制造、商贸客户做用友、金蝶、管家婆等 ERP 实施与系统集成时,最常返工的不是功能,而是「任务显示成功、数据其实没落库」:共享目录权限、磁盘配额、接口超时都会造成这种假绿灯。编码 Agent 接入 CI 后按同一套办法管——退出码、产物、超时三样都要验,单看日志不够。
参考来源:
1. GitHub anthropics/claude-code CHANGELOG(截至 2026-11-12 检索,含 2.1.317 / 2.1.319 / 2.1.321 条目原文) https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
2. GitHub anthropics/claude-code Release v2.1.321(2026-11-09,页面标注 released this 09 Nov 19:22,73 条可见条目) https://github.com/anthropics/claude-code/releases/tag/v2.1.321
3. ScriptByAI《Claude Code Timeline: Release Date and Major Updates (2026)》(版本日期核对,2026-11-12 检索,第三方口径) https://www.scriptbyai.com/claude-code-timeline/
4. AI Done Now《Claude Code 2.1.319: denyInsteadOfPrompting, MCP Background Tasks》(2026-11-11,无人值守运行的第三方解读) https://www.aidonenow.com/blog/claude-code-2-1-319-denyinsteadofprompting-mcp-background-tasks-what-changes-for-unattended-runs-and-notifications