Claude Code

Claude Code 2.1.325:账单串线已修

v2.1.325(11-13)修复以 claude.ai 登录启动的后台会话误用 shell 里 API key 计费;/cost 与 --max-budget-usd 开始计入 mod 调用,凭据隔离同步收紧。

2026-11-14 17:25:30 · Editor: 刘立永

Claude Code v2.1.325(GitHub Release,2026-11-13)修复了一条直接关系账单归属的缺陷:以 claude.ai 账号登录启动的后台会话,此前会使用并计费启动该后台服务时 shell 里的 API key 或 token。结果是订阅账号的活儿记到了 API 余额上,成本归属失真。同一版还改了 /cost 的统计口径与凭据隔离边界,属于企业团队必须跟着调账的一类更新。

一条修复,三种账单串线

官方 Release 原文为「Fixed background sessions started on your claude.ai login using (and billing) an API key or token from the shell that started the background service」。配套的两条同属一类:会话在后台被移到另一个登录态,现在会被拒绝并给出提示;Amazon Bedrock 的 token 计数在 managed setting 的 allowedProviders 不允许时,仍把整段会话发给 Bedrock,现已修复——这既是数据边界,也是计费边界。

为什么容易串线?第三方技术资料梳理的凭据选用顺序是:云厂商设置、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper、CLAUDE_CODE_OAUTH_TOKEN、Anthropic profiles,最后才轮到 /login 的订阅账号;且文档口径下 claude -p 只要环境里有 key 就会使用它。后台服务由某个 shell 拉起,那个 shell 的残留 key 于是赢了。同类问题不止一家:openclaw 的 PR #195171(2026-11-08)修的正是 /compact 把费用记到存储的 API key 而非 CLI 登录账号。以上为第三方资料与社区 PR,按实践参考看待。

/cost 与预算上限的统计口径变了

官方原文:「Changed /cost, $.session.usage(), --max-budget-usd and the cost and token metrics to count a mod's $.model.complete and $.model.classify calls」。含义很具体:插件 mod 自己发起的模型调用,过去可能没进会话成本与预算上限,从 2.1.325 起计入。对用 --max-budget-usd 卡夜间作业预算的团队,同一份脚本的账面成本会上升,阈值要按新口径重新标定,否则会误判为「用量暴涨」。

两个口径要分清:--max-budget-usd 是客户端估算的软上限,第三方指南明确提示实际花费可能略超、子代理开销计入其中;/cost 显示的是单机会话的估算值,不等于 Console 账单。另有第三方文章转述 Anthropic 成本指南的「约每开发者每活跃日 13 美元、每月 150 至 250 美元」,属交互式使用均值,不是自动化作业的基准,本文只作量级参考。本版还删掉了云端会话与 Remote Control 里「让管理员提高额度」这句预算报错文案——只是文案,不是额度策略调整。

凭据与配置的隔离边界

同版有多条收紧:Claude Code 自用启动的沙箱网络桥等辅助进程,不再在环境里携带登录 token 与 API key;ripgrep、本地 git 命令与沙箱运行时的 helper 程序,不再携带 mTLS 客户端私钥口令。依赖这些令牌透传的 git credential helper 或 hook 会拿不到凭据,需要改为显式注入。

配置层也有两条与企业共享环境直接相关:提交进仓库的 .claude/settings.local.json 过去可能在某些子目录启动时被当成用户自己的配置,现已修复;相对路径的 deny 与 ask 规则在切换目录后不再覆盖项目的问题也一并修掉。账号邮箱校验则扩展到拒绝把你的邮箱当作客户端身份,用于脚本执行、文件写入、web fetch 与 MCP 调用。此外第三方简报记录 11 月 13 日 claude.ai 与 Claude Code 出现约两小时的认证错误事故,提醒我们凭据链不稳时账单与任务状态都可能断档。

给企业技术团队的三条动作

第一,升级窗口做凭据轮换与环境清场。轮换 API key 与 token 后,用只打印变量名和文件行号、不打印值的清点脚本,扫一遍 shell profile、项目 settings 文件与 .env;无人值守的 claude -p 作业显式指定账号来源,不继承启动 shell 的残留 key。

第二,按新口径做成本拆分与三方对账。用 2.1.325 重跑一次典型作业,记录 /cost 与 --max-budget-usd 的新读数,再和网关日志、Console 账单对齐;按人、按项目、按作业类型打标,别只盯会话总额。mod 与子代理调用要单列,否则预算表永远差一截。

第三,保护共享环境配置。把 .claude/settings.local.json 纳入 gitignore,权限与凭据基线统一由 managed settings 分发并留变更记录;CI runner 用干净的 HOME 与最小环境变量启动,避免复用到别人的账号或私钥。

我们给山东的制造、商贸客户做用友、金蝶、管家婆等 ERP 实施时,最忌讳「两套账」:接口凭据、作业归属、成本拆分只要有一处对不上,月底核对就是事故。编码 Agent 接进共享开发环境后按同一本账管——凭据有名有主、成本可拆可核、配置受控留痕,升级时先对账再放量。

参考来源:
1. GitHub Release v2.1.325(2026-11-13,后台会话误计费、/cost 口径与凭据隔离条目) https://github.com/anthropics/claude-code/releases/tag/v2.1.325
2. GitHub CHANGELOG(2026-11-14 检索,2.1.325 条目原文) https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
3. Daily Betterment《Claude Extra Usage Cost》(第三方,凭据优先级与 claude -p 口径) https://dailybetterment.com/claude-extra-usage-cost
4. openclaw PR #195171(2026-11-08,/compact 计费到存储 API key) https://github.com/openclaw/openclaw/pull/195171
5. Fast.io《How to Set Claude Code Cost Limits》(第三方,--max-budget-usd 软上限与子代理计入) https://www.fast.io/resources/claude-code-cost-limit
6. Claude Code Daily Briefing(2026-11-14,第三方,11-13 认证事故) https://claude-news.today/en/briefings/briefing-2026-11-14