Claude API 费用：新 API 告诉你谁在花 token、花在哪里

10 月 29 日，Anthropic 以 beta 形式推出了 Usage and Cost Analytics API，这是一个用于统计组织内 token 用量和 Claude API 费用的新 API。根据 Claude Release Notes，原有的 Usage and Cost API 从当天起成为“legacy”API，但仍然受支持。

Claude API 费用报告有哪些新变化？

这个 API 有两个端点：

1. GET /v1/organizations/analytics/usage 返回 token 数和请求数，
2. GET /v1/organizations/analytics/cost 返回 以美元计的费用。

最有意思的是数据的拆分方式。在一次请求中，我们可以 按最多五个维度 对结果分组：模型、workspace、API 密钥、服务层级、上下文窗口、推理区域、产品，以及所谓的“actor”，也就是实际发出请求的一方。actor 可以是用户、服务账号、AWS 或 Google Cloud 的身份；如果都没有，就是 API 密钥本身。

结果以排行榜形式返回，默认按用量从高到低排序。所以“这个月哪些 API 密钥花得最多？”只需要一次请求，而不是写个脚本把多份报告的数据拼起来。

针对 Claude Code 有现成的用法：用 products[]=claude_code&group_by[]=actor 发起请求，就能得到每个用户的费用。前不久 有测量显示，智能体的隐藏摘要吃掉了会话费用的 16–22%，这个功能来得正是时候。

请求长什么样？

文档中的一个例子：9 月第一周每天的 token 用量，按模型分别统计。

curl --globoff "https://api.anthropic.com/v1/organizations/analytics/usage?\
starting_at=2026-09-01T00:00:00Z&\
ending_at=2026-09-08T00:00:00Z&\
time_bucket_width=1d&\
group_by[]=model&\
limit=10" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: analytics-usage-cost-2026-08-24" \
  -H "x-api-key: $ANTHROPIC_API_KEY"

每一行由三部分组成：时间范围、包含各维度的 group，以及包含数字的 usage（或 cost）。usage 中包括未缓存的输入 token、写入缓存和从缓存读取的 token、输出 token、网页搜索次数和请求数等。同样的数据也可以通过 SDK 和 CLI ant（ant beta:organization:analytics:usage list）获取。

几个细节：

1. 时间区间为 1 分钟、1 小时或 1 天，全部使用 UTC。
2. 一次请求 最多覆盖 31 天，按分钟区间时只能覆盖 24 小时。
3. 数据最早可追溯到 2026 年 1 月 1 日，且最多回溯 365 天。
4. 每页结果有 1 到 1000 行（默认 20 行）。

费用端点显示什么？

/cost 端点返回两个金额：amount 是 折扣后、扣除额度前 的费用，list_amount 是按标价计算的费用。金额以美分为单位，保留六位小数，所以 "41280.000000" 表示 412.80 美元。

另外两个维度 cost_type 和 token_type 可以把费用拆分到各类 token、网页搜索、代码执行和会话上。它们不计入五个维度的上限。

需要注意什么？

第一，延迟。数据 通常在 4 小时内更新，有时最长需要 24 小时，而旧的 Usage and Cost API 通常在 5 分钟内就能看到数据。所以如果要做“即时”告警，最好另找方案。

第二，数据修正。日历月结束后约 7 天内数值仍可能变化，所以 10 月的最终总额要到 11 月 7 日前后才能拿到。

第三，Priority Tier。在已购买的 Priority Tier 下发出的请求会出现在用量中，但其 token 费用为零，因为承诺费用是单独结算的。

第四，访问权限。这个 API 只面向组织：在 Claude Console 中需要 Admin API 密钥，在 Claude Enterprise 中需要具有 read:analytics 权限的密钥。个人账号无法使用。 它也可以在 Claude Platform on AWS 和 Claude Models on Google Cloud 上使用，采用各自云平台的身份验证。

这在 AI 领域算新鲜事吗？

Claude Console 之前就有费用报告。新的地方在于，同一套端点和字段同时服务于 Claude Console 中的组织和 Claude Enterprise。对 Enterprise 来说，这也意味着一个限制的取消：旧报告 每个区间只返回前 100 个分组，新报告则全部返回。

这是 Anthropic 在支出管控方向上的又一步，紧随 Claude smart reports 之后，后者展示团队用 Claude 做了什么以及花了多少钱。

常见问题

如何查看 Claude API 费用？

可以在 Claude Console 的 Usage 和 Cost 页面查看，也可以使用 Admin API 密钥，通过 Usage and Cost Analytics API（/v1/organizations/analytics/cost 端点）以编程方式获取。每个 API 响应中也包含一个 usage 块，显示该请求的 token 数。

旧的 Usage and Cost API 会停止工作吗？

截至 10 月 29 日不会。根据 Claude Release Notes，它的状态是“legacy”，但仍然受支持，文档中也提供了迁移指南。

如何查看每个 Claude Code 用户花了多少钱？

使用费用端点并带上参数 products[]=claude_code&group_by[]=actor。Claude Console 中的组织也可以使用独立的 Claude Code Analytics API。