2026 年 8 月 8 日发布的 v2.1.225(以及紧随其后的 v2.1.226),延续了近期版本围绕多设备协作稳定性的打磨节奏——这次的重点是网关消费上限提示、claude agents 的工作区信任提示,以及一大批针对 Remote Control 和跨会话消息的可靠性修复。本文基于官方 Changelog 逐条解读。
网关消费上限:额度用尽时看到的信息更完整
Added gateway spend-limit support to Claude Code's usage warning; the
limit-reached message now names the cap, its reset time, and the
operator's message (requires the gateway on 2.1.225)
企业通过自建网关代理 Claude Code 流量时,通常会设置一个消费上限(spend limit)来控制成本。此前如果达到上限,用户看到的提示信息可能不够清晰——现在这条提示会明确说明具体的额度上限、什么时候重置、以及网关运营方留下的自定义提示信息。这项能力需要网关本身也升级到 2.1.225 才能生效,是一次前后端配套的改进。
claude agents 命令新增工作区信任提示
Added a workspace trust prompt to claude agents for untrusted
directories, matching the behavior of claude
claude agents 命令此前在进入不受信任的目录时,没有像主命令 claude 一样弹出信任确认提示——这意味着 Agent 管理界面存在一个行为不一致的安全缺口。现已修复为与主命令保持一致的信任提示行为。
一批 Remote Control 与跨会话消息可靠性修复
Fixed conversation history breaking on Remote Control session resume
after very large conversations were compacted
长会话经过 Compaction(压缩)之后,如果再通过 Remote Control 恢复会话,此前可能出现对话历史断裂的问题——现已修复。对于依赖长会话 + 多设备恢复工作流的用户,这是一个值得关注的稳定性改进。
Fixed cross-session messages staying parked without a notice or
expiry in headless sessions and during startup
v2.1.224 刚引入的跨会话消息,此前在无头(headless)会话和启动过程中,可能出现消息一直停留在待处理状态、既没有通知也不会过期的问题——这是一个典型的「新功能刚上线就补边界情况」的快速迭代节奏,也说明跨会话消息这条产品线还在积极打磨中。
Fixed claude self-hosted-runner registering and then failing every
session when --base-dir cannot be created or written; it now exits at
startup with a clear error
同样是 v2.1.224 引入的自托管运行环境,此前如果 --base-dir 无法创建或写入,会先完成注册、然后让每一个会话都失败——现在改为在启动阶段就直接报错退出,避免用户看到一堆莫名其妙的会话失败才意识到是目录权限问题。
MCP OAuth 与 Token 认证的两处修复
Fixed a transient 401 replacing a long-lived CLAUDE_CODE_OAUTH_TOKEN
with a stored login's short-lived token, breaking headless sessions
until restart
Fixed MCP OAuth servers on macOS intermittently failing with a burst of
401 errors, as if never authenticated, after a keychain read timed out
第一处修复解决的是一个相当隐蔽的问题——一次临时性的 401 错误,可能导致系统误判长期有效的 CLAUDE_CODE_OAUTH_TOKEN 已失效,进而用一个短期登录 Token 替换它,最终导致无头会话在重启前持续失败。第二处则是 macOS Keychain 读取超时后,MCP OAuth 服务器可能出现一连串 401 错误,表现得像是从未认证过——两处都是「认证状态被错误地当作永久失效」这一类问题的变体,现已修复。
SendMessage 支持主动发起对话
SendMessage can now start a conversation with your Remote Control
sessions on other machines by name (ListAgents shows them as
"name [ref]"), instead of only replying after they message you first
这是对 v2.1.224 跨会话消息能力的一个重要补完——此前SendMessage 只能在对方先发消息给你之后才能回复,现在可以直接按名称主动发起对话,ListAgents 会以name [ref] 的格式列出可联系的 Remote Control 会话。这让跨会话消息从「被动应答」升级为「主动协调」,对于多设备协作场景更加实用。
v2.1.226:纯稳定性修复
2.1.226 (August 8, 2026)
Bug fixes and reliability improvements
紧随 v2.1.225 之后同一天发布的 v2.1.226,Changelog 中只有一句笼统的「Bug 修复和可靠性改进」,没有列出具体条目——这种模式通常意味着是对前一版本发现的小问题做紧急收尾。
总结
v2.1.225 没有引入耀眼的新功能,而是把 v2.1.224 刚上线的两项重量级能力(自托管运行环境、跨会话消息)打磨得更扎实——从启动报错、消息过期到主动发起对话,每一处都是新功能上线后自然会暴露的边界情况。对于正在评估是否启用这两项新能力的团队,等到 v2.1.225 及以上版本会是更稳妥的选择。
来源:Claude Code Changelog v2.1.225/v2.1.226 — Claude Code 官方文档,Anthropic