Claude Code 计费排查:Pro / Max、API Key 与额外用量
订阅指南
已经付了 Claude Pro,却又看到 API 账单,这不一定是重复收了同一笔会员费。更常见的排查方向是:运行中的 Claude Code 使用了哪种认证,账单属于哪个账户。这里给出一条从观察到复核的排查路径,适用于个人 Pro / Max 用户;团队管理策略和第三方模型网关需要另外核对。
先把三笔钱放进不同的账本
订阅内用量、订阅之外的额外用量、Console 的 API 调用,不应靠“我买了 Pro”一句话混在一起。Pro / Max 的 Claude 与 Claude Code 共享限制;核对当天,官方列有五小时与每周限制。因此网页聊天已经消耗的额度,会影响后面的编程会话。
排查时保留四项信息就够了:扣费时间、账单所在平台、当时的登录方式、是否接受过继续使用的付费选项。单看银行卡商户名,往往无法区分这些来源。
| 账本 | 需要核对什么 | 不能据此推断什么 |
|---|---|---|
| Pro / Max 订阅 | 会员账号、有效期、用量窗口 | 会员不是无限量,也不等于 API 账户有余额 |
| 订阅的额外用量 | 是否启用、当前支出 / 额度设置 | 额外用量不等于再次续一个月会员 |
| Console API | 组织 / 项目、调用记录、自动充值 | API Key 可以属于另一个账户 |
检查 Key 是否存在,但别把 Key 打印出来
官方说明,ANTHROPIC_API_KEY 环境变量优先于订阅认证。这里的重点是“优先”:在浏览器里登录了 Pro,不能证明启动的进程没有继承旧 Key。先在 Claude Code 里输入 /status,记录认证类型和账号;再在启动它的同一个终端里执行下面的检查。
下面的 macOS / Linux shell 命令只返回 present 或 absent,不输出密钥值。不要把完整 Key 放到截图、工单或公开聊天里。若使用 IDE 集成终端,检查那个终端;在另一窗口里看到 absent,并不能代表 IDE 启动的进程也没有 Key。
if [ -n "${ANTHROPIC_API_KEY:-}" ]; then
printf "%s\n" "ANTHROPIC_API_KEY: present"
else
printf "%s\n" "ANTHROPIC_API_KEY: absent"
fi切回会员后,要做一次闭环验证
如果你明确要用个人会员额度,先退出正在运行的 Claude Code,在启动它的终端里执行 unset ANTHROPIC_API_KEY,再重新启动。该操作只修改当前 shell,既不撤销 API Key,也不替你改其他工具的配置。
接着在 Claude Code 内执行 /login,选择拥有 Pro / Max 的 Claude 账号,避免选到 Console 的按量付费路径。登录后再次 /status。判断修复成功的依据是认证方式与账号符合预期,不是登录弹窗消失。可以用一个小任务复核,但应避免同一 API 项目有其他程序同时运行,否则“账单有没有增长”不容易归因。
如果新开终端又变回 present,说明 Key 被重新注入了。检查你自己维护的 shell 启动配置、IDE 环境设置或环境管理工具,只修改负责这次注入的配置。不要整行批量删除所有含 Key 名的配置,其他项目可能仍需要它。Windows 用户可在 PowerShell 当前会话移除对应环境变量,并检查用户环境变量设置;不要照抄下面的 shell 语法。
unset ANTHROPIC_API_KEY
claude
# Inside Claude Code:
# /login
# /status仍然遇到限制?先区分容量问题与费用问题
正确登录之后的用量耗尽,才属于套餐容量问题。若短窗口先到上限,等短窗口重置可以恢复部分使用;若周额度也已耗尽,只等短窗口并不够。应以实际用量页面显示的限制与时间为准,而不是看到“5 小时”就认为所有额度都已恢复。
若你只打算支付固定会员费,就不要在限制提示中接受 API 付费继续使用,也要检查是否已启用额外用量或 Console 自动充值。它们分别控制不同支出。需要冲刺时,可以有意识地选择额外用量;持续多周不够用,再比较 Max 5x / 20x。
还有一个容易漏掉的边界:当前 Max 提供的月度 API credits,官方说明不能用于 Claude Code 或 Claude App 的额外用量。套餐里出现“credits”,不代表每个产品都能抵扣;必须阅读这些 credits 的适用范围。
$17 为年付折算月价,月付为 $20。
给支持人员的信息,应能复现问题
一份有用的说明可以写成:“个人 Pro,终端 /status 显示订阅认证;同一终端 Key 检查为 absent;周额度已满,短窗口重置后仍提示限制。”这比“会员不能用”更接近原因。附上版本、时间和已脱敏的提示即可,不要附上 Key 或登录凭据。
如果出现 API 扣费,整理扣费时段、项目和当时的认证路径;修改配置不会撤销已发生的调用费用。先让后续会话走到正确账本,再讨论历史账单。
写这篇时,我的商店里 Claude 仍为待上架,所以这里没有购买按钮。排查完成后发现现有会员够用,就无需再买一个。