Claude Code 网关成本归属:按人按组查账
Claude Code 网关 2.1.317 起可按人、按天、按 IdP 组查花费,2.1.318 归到 AWS 账号,2.1.319 补预算优先级。effort 拉满花费涨 2.1-4.2 倍,分数不涨。
2026-11-11 17:45:26 · 主编:刘立永官方 CHANGELOG 显示,Claude Code 的 Claude apps gateway 在 2.1.317 新增 GET /v1/organizations/analytics/cost 管理 API,可按总额、每开发者、每天、每 IdP 组读取指定日期区间的历史花费;2.1.318 给 mantle upstream 加 assume_role,用于跨 AWS 账号与按开发者归属 AWS 成本。对多团队共用一个账号的组织,影响很直接:AI 花费第一次能落到人和项目,不必月底对着一张总账单估。
三版一条线:报表、跨账号归属、预算优先级
按官方 CHANGELOG 原文,2.1.317 带 admin: 的网关每天记录每个开发者的 IdP 组,OpenTelemetry 同步新增 anthropic.plan、anthropic.seat_type、anthropic.provider、anthropic.custom_base_url 四个属性,可与花费交叉比对。2.1.319 补上 admin.pooled_conflict_rule 和 admin.pooled_priority_order,决定一个开发者属于多个组时先由哪个共享预算扣费,并给网关后没有 spend limit 的开发者在 /usage 增加今日、本周、本月花费。2.1.321 改进繁忙副本的 spend limits:更早记账,限额错误按本地时间显示重置时间。
口径提示:Daily Briefing(11-4)、Claude World 11 月汇总、Claude News(11-5)都把 pooled_budget 记为 2.1.316 引入,另有资料记在 2.1.314,版本存在分歧,本文不据此下结论;版本日期均为第三方口径,官方 CHANGELOG 不标日期。
三套仪表盘别混用
据 claudegpt.si 11 月整理(第三方汇总):组织侧有 claude.ai/analytics/claude-code(看采纳率与日活)和 platform.claude.com/claude-code(看每日花费与人均表,官方标注为估算,实际费用以 Cost 页为准);终端 /usage 只读本机会话历史,一台机器一份,本地会话文件默认 30 天后删除。结论:分账只认网关报表或 OTel 导出,/usage 是个人即时视图,不能拿来结算。
effort 拉满,账单涨、分数不涨
据 zicode 11 月 3 日整理(转述 scbench.ai 10 月 14 日榜单,二手口径、一手数据未复核):effort 开到最大,花费多出 2.1 到 4.2 倍,通过数没有跟着涨;四个月尺度整个领域只涨 1.5 个百分点。对照官方能力:2.1.318 给 mod 的 $.model.fork 增加 effort 选项,让轻量旁路任务固定跑 low;2.1.317 起与主会话不同模型的子智能体改用该模型自己的 effort 或默认值。官方给的是按任务分档的开关,不是全局拉满的旋钮。
共享环境的配置保护比省钱更急
2.1.318 修了一批共享网络主目录故障(官方 CHANGELOG 原文):/logout、claude mcp remove 在配置文件无法更新时仍报成功;claude mcp add/remove 写配置不加锁;另一终端同账号重新登录会让任务报 Not logged in;~/.claude.json 在磁盘写满时被清空。同版新增 loginExpiresAt 与 credential_expires_at,登录到期前 10 天向 -p 输出发 stderr 告警。2.1.321 的 remote-control --settings 可统一下发配置,但改完不重启不生效。多人共用跳板机的团队,这些比预算数字更该先处理。
给企业技术团队的三条动作
第一,先统一成本拆分口径再谈降本。用网关 cost API 按 IdP 组或项目出月报,或用 OTel 打部门、成本中心标签,和财务账对一次;/usage 只作本机参考,不作结算依据。
第二,把 effort 分档写进共享配置。检索、格式化、生成测试骨架固定 low,主任务保留中档;共享 settings 用 --settings 下发,改完记得重启 remote-control,并把登录到期日纳入监控。
第三,凭据轮换与共享配置保护同步做。借升级窗口复核一轮 MCP 授权、轮换已签发令牌;共享主目录的 ~/.claude.json 与 settings 纳入备份和变更审计,避免并发写把配置清空。
我们给山东的制造与商贸客户做用友、金蝶、管家婆等 ERP 实施时,成本归集最怕两套账:财务一套、业务一套,月底对不上。AI 编码工具的账单同理——网关报表、终端 /usage、云厂商账单先对齐口径,再谈优化。
参考来源:
1. GitHub anthropics/claude-code CHANGELOG(截至 2026-11-10) https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
2. Claude Code Daily Briefing(2026-11-04,cost API 与版本日期) https://claude-news.today/en/briefings/briefing-2026-11-04
3. Claude News(2026-11-05,共享预算与 assume_role) https://claudenews.online/en/edition/2026-11-05
4. Claude World(2026-11,网关预算版本对照) https://claude-world.com/zh-tw/articles/claude-code-november-2026-whats-new
5. zicode(2026-11-03,effort 与 scbench.ai 榜单,二手口径) https://zicode.com/blog/slopcodebench-agent-code-decay
6. claudegpt.si(2026-11,三套仪表盘口径) https://claudegpt.si/news/claude-code-dashboard-three-kinds