这个月 Claude API 花了我多少钱?
最后更新:2026年9月30日
登录 Claude Console,打开 Cost 页面:选择月份,它会按模型和工作区显示你的组织花了多少。剩余余额在 Settings → Billing 中。在浏览器之外,Cost API 返回相同的数据,但只对管理员凭据(例如 Admin API 密钥)开放。Pro 或 Max 等 Claude 套餐单独计费,不计入这个合计。
数字在哪里
登录 Claude Console,打开 Cost 页面。选择工作区、模型和月份;它会显示每日费用图表和合计,包括网页搜索和代码执行。
- Cost 页面(
platform.claude.com/cost)——花了多少美元。选择一个工作区或“All Workspaces”,一个模型或“All Models”。你可以将数据导出为 CSV。 - Usage 页面(
platform.claude.com/usage)——显示 token 而不是美元:按模型和 API 密钥统计的输入和输出、因速率限制被拦下的请求,以及你的缓存命中率。同样可以导出 CSV。 - Billing 页面(Settings → Billing)——你的余额、余额使用情况和支出上限。
你需要 Developer、Billing 或 Admin 角色才能查看报告。两个页面都不按人拆分费用;Anthropic 对此说得很明白。对于 Claude Code,有一个单独的分析 API,提供按用户估算的费用。
余额、自动充值,以及余额归零时会怎样
默认是预付费。你在 Settings → Billing → Buy credits 中购买余额,每次请求都按当前价格扣减。使用 Console 账户登录时,Claude Code 也从同一笔余额中扣减。
- 余额归零时,在你充值之前,你将无法再调用 API 或使用 playground。
- 自动充值会替你购买余额。你设定触发购买的余额值,以及充值到的金额。
- 余额在购买一年后过期。日期无法延长,购买也不退款。
- 只有成功的调用才计费;失败的请求不花钱。
一些签有销售合同的组织会改为按月开具发票。对他们来说,在发票到来之前,Cost 页面就是累计合计。
把两个数字分开看。余额是你购买的余额还剩多少。费用是你花了多少。月中充值时,余额会跳升,而费用不会:要看本月的支出,请看 Cost 页面。
支出上限和提醒
每个用量等级都有每月上限:Anthropic 列出的是 Start $500、Build $1,000、Scale $200,000。达到上限后,API 会暂停到下个月第一天的 00:00 UTC,返回 HTTP 429 和错误代码 enforced_spend_limit_reached,除非你先升到更高的等级。
- 你自己为组织设定的上限:Settings → Billing → Spend limits → Adjust limit(或 Set limit)。它不能超过你所在等级的上限。达到后,请求会返回 HTTP 400,消息以“You have reached your specified API usage limits”开头。
- 按工作区:Settings → Workspaces,然后是该工作区的 Spend limits 标签页。该上限必须低于组织的上限;如果没有设置,则适用组织的上限。Default Workspace 不能设置上限。
- 提醒:在同一个标签页中,“Add notification”会在工作区支出达到你设定的金额时发送电子邮件。只有组织管理员可以更改这些设置。
Console 在首次登录 Claude Code 时创建的 Claude Code 工作区,是所有工作区中仅有的可以按用户设置每月支出上限的一个。
为什么数字会滞后
Anthropic 表示,用量和费用数据通常会在请求后五分钟内出现,不过偶尔延迟会更长。
Cost API 以 UTC 的整天计数。在瑞士,新的月份从当地时间 01:00 或 02:00 开始,而不是午夜。今天的数字会一直增长,直到这一天结束。
自己查询 API
Cost API 是 Admin API 的一部分。普通 API 密钥不行。费用报告需要 Admin API 密钥,它以 sk-ant-admin01- 开头,只有组织管理员才能创建。个人账户无法访问 Admin API。
你在 Settings → Admin keys(platform.claude.com/settings/admin-keys)中创建该密钥。它只显示一次。限定于某个工作区的密钥会被拒绝。如果你的 Console 账户还没有组织,请先在 Settings → Organization 中创建一个。
curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2026-09-01T00:00:00Z&\
limit=31&\
group_by[]=description" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
- 分段始终为一天。不指定
limit时返回七天;最多 31 天。 - 把
data中所有results的amount相加。注意:金额是以美分为单位的十进制字符串。USD 下的"123.45"表示 $1.23,所以要除以 100。 group_by[]=description会为每一行加上模型和 token 类型;workspace_id按工作区拆分。Default Workspace 显示为null。- 如果
has_more为 true,请把page设为next_page后再次查询。
Priority Tier 的费用另行计费,不在此报告中。Token 数量来自 /v1/organizations/usage_report/messages,按分钟、小时或天分段统计。Anthropic 允许每分钟查询一次。
Claude 套餐包含 API 费用吗?
不包含。付费的 Claude 套餐不包括 API 或 Console。API 单独计费,用你在 Console 中充值的余额支付。
Pro、Max、Team 和 Enterprise 都是如此。两者都想要?那就在 claude.ai 上付套餐费,同时在 Console 里设置计费。套餐本身的限额如何运作,见监控 Claude 用量限额。OpenAI 的同一问题,见这个月 OpenAI API 花了我多少钱?
在 AI Cockpit 中
Anthropic API 卡片用你输入的 Admin API 密钥读取上面提到的费用报告,并且只读取。没有这种密钥,卡片保持为空;如果报告拒绝某个密钥,卡片会提示需要组织的管理员密钥。这张卡片看的是 API 支出,不是 Claude 套餐。
- Mac 菜单栏:今天、本月,以及自产生费用的第一天以来的合计。下方是金额最大的五项费用(含本月和合计)、过去 30 天的曲线(默认开启),以及当今天的费用达到你日中位数的 1.8 倍或更多时给出提示。
- iPhone 和 iPad:今天、本月和合计。本月的金额也计入卡片上方的总费用行。
- Apple Watch(通过 iPhone App):一行显示今天和本月。
默认每 15 分钟刷新一次,可在 5 到 60 分钟之间选择。它不做的事:显示你的余额、支出限额或 Token,也不购买额度。由于卡片没有可对照的上限,它没有百分比警告阈值。若要自己设上限,Mac 6.8 和 iOS 2.9 新增了所有 API 费用合并计算的每月预算,在 75% 和 100% 时发出警告。从 Mac 6.8 和 iOS 2.8 起,卡片会把报告中的美分正确换算为美元。
App 读取哪些服务、为什么每项都需要自己的密钥:一览 AI API 费用。关于管理员密钥和空卡片的简短解答,见常见问题页面。