# Claude Code 用订阅还是 API？Pro、Max 计费与额度怎么查

说明 Claude Code 的套餐登录、额外使用量和 API 三种计费路径，检查 API key 优先级，并区分 Max、Ultra 赠送 API 额度的适用范围。

原页面：https://ccmaxplan.com/articles/claude-code-subscription-vs-api

发布时间：2026-11-03T03:04:49.464985+00:00

更新时间：2026-11-03T03:04:49.464985+00:00

个人在终端里使用 Claude Code，已有 Pro、Max 或 Ultra 时，可以先用 **Claude 订阅账号登录**。如果要把 Claude 接入自己的程序、按 API 使用量结算，或需要单独管理开发预算，则使用 Console 的 API 计费。

先确认**当前登录方式与额度来源**。同一台电脑安装同一个 Claude Code，仍可能因为环境配置不同而走向另一套账单。

## 先认清三种费用

| 使用方式             | 费用从哪里出                 | 适合核对的位置                   |
| ---------------- | ---------------------- | ------------------------- |
| 用 Claude 套餐登录    | Pro、Max 或 Ultra 包含的使用量 | Claude Settings → Usage   |
| 达到套餐限制后用使用量积分    | 另行购买的 usage credits    | Claude 的使用量与账单设置          |
| 用 Console API 身份 | API 余额及对应计费规则          | Console 的 Usage 与 Billing |

套餐登录时，Claude Code 与网页、手机、桌面 Claude 共用一份使用量。白天处理大量文档，晚上再运行长代码任务，可能在同一个额度窗口内互相影响。

## 已有 Pro，怎样确认走的是订阅

在 Claude Code 中检查当前账号与状态。官方说明可以使用 `/status` 查看状态，需要切换登录时使用 `/login`，选择订阅对应的 Claude 账号，而非继续沿用 Console 身份。

**检查环境中是否设置了 `ANTHROPIC_API_KEY`。** 官方明确说明，该环境变量存在时，Claude Code 会优先使用 API key，而不是订阅身份。修改前先确认这把 key 是否仍被其他工具需要；如要停止对当前终端生效，可清理相应配置后重新启动会话并核对状态。

无需把 key 打印到屏幕、截图或发给别人。排查只需确认它是否存在、来自哪里，以及当前 Claude Code 显示的计费方式。

如果用量达到套餐上限，工具提示切换 API 继续使用，而你希望费用仍限制在套餐内，可以拒绝该选项并等待重置。

## 哪类工作先用套餐，哪类工作用 API

**个人交互式改代码、读仓库、跑测试**，先用已购买的套餐比较直接。通过一次真实工作周期观察额度消耗，再判断是否升级；不要用固定“每天能写多少行代码”来估算容量。

**自建应用、后台服务、代理程序**，应围绕 API 的模型用量、预算和项目权限设计。API 开销跟任务规模相关，循环、长上下文和并发调用都会影响总量，应在 Console 设置预算并观察用量。

临时大任务也可考虑 API，先设支出上限，再评估任务是否值得继续。API 的费用不能直接套用 Pro 月费，买了 Pro 也不会给 Console 自动增加 API 余额。

## Max 与 Ultra 每月赠送 API 额度，怎样使用

截至 2026 年 11 月 3 日，Max 附带每月 100 美元 API 额度，Ultra 为 200 美元。有效新订阅满七天后，可以在网页 Billing 中关联 Console 组织；领取者还需具备对应组织权限。

这笔额度可用于官方列出的 API、Playground、Managed Agents 和 Agent SDK 等用途，**不覆盖交互式 Claude Code，也不抵扣聊天或 Claude Code 的超额使用费**。

一个重要区别是：自行用所关联组织的 API key 运行 `claude -p` 或 Agent SDK，官方按相应 Agent SDK 用途说明赠送额度的适用性；从 IDE、桌面应用或 Claude Code GitHub Action 发起的运行仍可能归入 Claude Code 用途。不能仅看到命令里有 `-p` 就判断一定可抵扣。

赠送额度按周期到期，不结转。余额耗尽后，如果 Console 中还有购买余额或开启了自动充值，API 使用会继续从这些来源扣费；应一并检查这些设置。

## 一次费用异常怎样定位

先记下任务时间与所用终端，再检查 Claude Code 当前身份、API key 环境变量和两个后台的用量记录。

* Claude 的套餐使用量增加：检查是否为正常的共享额度消耗。
* Console API 余额减少：检查当前身份、环境变量以及其他使用同一组织 key 的程序。
* Claude 另有超额账单：检查是否开启使用量积分及相关预算。

对照这三处记录，可以查出订阅以外的费用从哪里产生。不要为了排查直接新买套餐或重复充值。

## 常见问题

Q: Claude Pro 包含 Claude Code 吗？
A: 包含。用 Pro 对应的 Claude 账号登录，Claude Code 消耗套餐使用量，并与其他客户端共享额度。

Q: 为什么买了 Pro，API 还要付款？
A: Pro 订阅和 Console API 分别计费，Pro 不附带每月 API 额度。API 请求按 Console 的余额及规则结算。

Q: 登录了订阅账号，为什么仍然扣 API 余额？
A: 优先检查 `ANTHROPIC_API_KEY`。官方说明该环境变量会使 Claude Code 使用 API key，随后核对当前状态及 Console 用量。

Q: Max 赠送的 100 美元能用来连续聊天吗？
A: 赠送额度适用于指定 Claude Platform 开发用途，不抵扣聊天超额使用或交互式 Claude Code。

Q: Claude Code 用完额度后只能升级吗？
A: 可以等待重置，也可按当前资格使用额外使用量积分或选择 API 计费。每种方式都应先确认费用来源和预算。

Q: 同一个订阅在网页和终端各有一份额度吗？
A: 套餐登录下，网页、桌面、手机和 Claude Code 共用使用量，不能分别当作独立额度池计算。

## 来源与核对日期

资料核对日期：2026 年 11 月 3 日。

* [Use Claude Code with your Pro, Max, or Ultra plan](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-max-or-ultra-plan)
* [Monthly API credits for Max, Ultra, and Team plans](https://support.claude.com/en/articles/17154008-monthly-api-credits-for-max-ultra-and-team-plans)
* [管理付费 Claude 计划的使用额度 | Anthropic Help Center](https://support.claude.com/zh-CN/articles/12429409-%E7%AE%A1%E7%90%86%E4%BB%98%E8%B4%B9-claude-%E8%AE%A1%E5%88%92%E7%9A%84%E4%BD%BF%E7%94%A8%E9%A2%9D%E5%BA%A6)
* [What is the Pro plan?](https://support.claude.com/en/articles/8325606-what-is-the-pro-plan)