结论前置:Anthropic 于 2026 年 10 月 29 日推出 Usage and Cost Analytics API 测试版,为 Claude Console 与 Enterprise 组织提供统一的用量和成本查询。企业可按模型、工作区及调用身份等维度分析消耗;旧接口仍受支持,但新接口数据并非实时,迁移时需重做刷新与报表校验。
新接口聚焦组织级消耗分析
Anthropic 在 2026 年 10 月 29 日的平台更新中宣布推出 Usage and Cost Analytics API,目前处于 beta 阶段。两个 GET 端点分别为 /v1/organizations/analytics/usage 和 /v1/organizations/analytics/cost,用于组织的 Token 用量、请求数与美元成本分析。它不是新模型,也不是模型调用价格调整。
统一入口不等于所有组织字段都相同
官方说明,新接口同时服务 Claude Console 与 Claude Enterprise 组织,可按模型、工作区、API Key 及请求背后的用户或服务账号等维度归因。具体维度的适用范围仍因组织类型而异,不能把某一类型组织的字段假定为处处有值。接入需使用相应管理凭据或分析读取权限,并携带 analytics-usage-cost-2026-08-24 测试版请求头。
重要限制:分析数据不是实时消费流水
官方文档说明,数据通常在使用发生后 4 小时内刷新,最长可能需要 24 小时;响应中的 data_refreshed_at 用来标记数据刷新进度。这个时间之后的用量可能缺失或不完整,迟到事件与对账也可能修订历史数据。因此,企业不能仅凭刚拉取到的汇总结果判断当前是否已经超出预算。
旧接口仍可用,迁移不能只替换地址
Anthropic 将旧 Usage and Cost API 以及 Enterprise Analytics 的相关用量、成本报表端点标为 legacy,但明确表示继续支持。新接口的结果按行组织,分页与时间分桶等规则也有变化。已有报表应按照官方迁移说明验证,而不是直接改 URL 后沿用旧解析逻辑。此次上线没有宣布旧接口立即停用。
中蓝科创观察:先建立能解释的消耗账
企业可以先从工作区与模型两类维度建立日级分析,再逐步映射到内部项目或业务负责人。映射应来自企业自己的账户与项目管理规则,不能把平台中的调用身份自动等同于业务订单归属。成本变化也不必然代表效率变化,仍应结合任务完成率、质量复核量和实际交付结果评估。以上为中蓝科创实施分析,不是厂商公布的经营成效。
试点建议:并行核对,再决定切换
中蓝科创建议先选择一个完整统计区间,新旧报表并行采集,核对分页是否取全、空值是否被误当作零、时间范围与时区是否一致,并记录每次刷新时间。预算预警与执行限制应另设及时可靠的控制机制;分析接口更适合历史归因和趋势观察。采集凭据应留在受控服务端,报表权限也应与财务、业务和运维角色分离。
官方来源:Claude Platform 2026 年 10 月 29 日更新记录、Usage and Cost Analytics API 文档。企业试点建议为中蓝科创分析。
