网关花了多少钱一查便知：2.1.317 新增成本报告接口与 IdP 分组记录

上一版（2.1.316）给网关加了分组共享预算，解决的是「怎么设上限」。CLI 2.1.317 紧接着补上另一半：「已经花了多少、花在谁和哪个组上」。更新说明里，Claude 应用网关（Claude apps gateway）新增了一个成本报告接口，并配套增加了每日的 IdP 分组记录。

新接口：analytics/cost

按更新说明，管理员 API 里新增了：

GET /v1/organizations/analytics/cost

用途是读取过去一段日期范围内的花费，可以按下面几种方式汇总：

• 整体总额；
• 按每位开发者；
• 按天；
• 按每个 IdP 组。

更新说明没有展开请求参数、返回字段和鉴权细节，所以具体怎么传日期、返回什么格式，请以官方网关文档为准。

配套的每日 IdP 分组记录

要按 IdP 组汇总，网关得先知道每个人当时属于哪些组。2.1.317 因此加了一项记录：

• 对设置了 admin: 的 Claude 应用网关，每天记录一次每位开发者所属的 IdP 组；
• 记录保留的时长由 admin.identity_retention_days 决定；
• 成本报告按组分组时，用的就是这份记录。

由于记录是按天保存、并按 admin.identity_retention_days 保留的，保留天数大概率决定了你能按组往回查多远（更新说明没有明说，请以文档为准）。如果需要按季度或按年对账，建议提前确认这个设置。

适合怎么用

• 对账与分摊：月底按 IdP 组出一份花费，直接对应到部门或项目；
• 找异常：按开发者、按天看，哪一天、哪个人的花费突然拉高；
• 和限额配合：先用成本报告看清真实用量，再去调个人限额或 pooled_budget 共享预算，设得更有依据。

同版本里与网关相关的修复

• 网关不再把 Amazon Bedrock 的「Input is too long.」错误藏起来。此前这会让会话每一轮都报「upstream rejected the request」，而不是去压缩上下文；
• 当某个组的共享预算用完后，状态栏和 /usage 曾把开发者自己的消费限额显示成已用 100%，这个显示问题也修复了。

小结

2.1.317 的成本报告接口，加上按天保存的 IdP 分组记录，让网关管理员第一次能直接按「总额 / 开发者 / 天 / IdP 组」回看历史花费。用网关管团队用量的话，建议先确认 admin.identity_retention_days 的设置是否覆盖你的对账周期。