Claude 用量与成本有了查询接口：按模型、工作区、API 密钥拆分账单
核心概要
Anthropic 在 Claude 平台发布用量与成本分析 API 的测试版，提供两个组织级端点，按模型、工作区、API 密钥以及请求背后的用户或服务账号等维度过滤和分组，报告 Claude Console 与 Claude Enterprise 组织的 token 用量和成本。此前这类数据由用量与成本 API 以及 Claude Enterprise 分析 API 的四个报表端点提供，这些接口现转为旧版但仍受支持，官方给出两条迁移路径。新接口需携带 analytics-usage-cost-2026-08-24 测试版标头调用。
深度剖析
Claude 平台新增一组组织级分析端点，把 token 用量和成本作为可查询的数据返回，覆盖 Claude Console 与 Claude Enterprise 两类组织。 此前同类数据由用量与成本 API 以及 Claude Enterprise 分析 API 的 usage_report、cost_report、user_usage_report、user_cost_report 四个端点提供，这些接口现在被标记为旧版。 两个新端点分别是 /v1/organizations/analytics/usage 与 /v1/organizations/analytics/cost，以 analytics-usage-cost-2026-08-24 测试版标头开放测试。
查询结果可以按维度过滤和分组，让运营者把花费落到具体的模型、工作区、密钥或调用者上。 可用的分组维度包括模型、工作区、API 密钥，以及每个请求背后的用户或服务账号。 这一维度列表随测试版发布一并给出，适用于 Claude Console 和 Claude Enterprise 组织。
旧接口没有被关闭，已有集成可以按官方迁移说明切换。 四个旧报表端点与旧版用量与成本 API 均保持受支持状态。 平台给出两条迁移路径：从用量与成本 API 迁移，以及从 Claude Enterprise 用量与成本报表迁移。
启示与展望
发布说明描述的是 Claude Console 与 Claude Enterprise 组织的组织级用量与成本查询，接口处于测试版，需携带指定测试版标头；旧版接口继续受支持，迁移路径由平台另行给出。
新接口以测试版形式发布，发布说明未给出其正式版时间；旧版用量与成本 API 及四个报表端点仍受支持，但未说明支持期限。