Claude Code API Key 和订阅计费怎么选：先看 /status

用 Claude Pro、Max、Team 或 Enterprise 账号登录 Claude Code 写代码，不需要 API Key，用量从订阅额度里扣。账单转到 API 的常见原因有三个：环境里有 ANTHROPIC_API_KEY，你在交互模式下批准过它；用 claude -p 跑脚本时环境里有这个 Key（非交互模式不询问，直接用）；或者 /login 时登录的是 Claude Console 账号。想知道当前走哪本账，在会话里运行 /status：登录和 API Key 同时存在时，它会标出没在用的那一个。

下面的规则来自截至 2026 年 10 月 10 日的 Claude Code 官方认证文档、成本管理文档和 Claude 帮助中心。最容易弄错的有三点：API Key 在交互模式下要你批准一次才生效，并不是悄悄接管；2026 年 10 月 7 日起 Max 和 Team 每月附带一笔 API 额度，但它不付交互式 Claude Code；当前 API 标价对应的是 Opus 5.5、Sonnet 5.5 和 Fable 5.1。

先确认当前走哪条路

Claude Code 同时找到多种凭据时，按Claude Code 官方认证文档（Authentication）列出的固定顺序只用其中一种。订阅登录排在最后一位：前面任何一项生效，订阅就不计费。

这张表有三个容易忽略的地方：

• 环境变量的作用范围比终端大：apiKeyHelper、ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 对 CLI 以及包装 CLI 的界面都生效，包括 VS Code 扩展、Agent SDK 和 GitHub Actions。Claude Desktop 和云端会话不读这些变量；文档写明云端会话始终用订阅凭据，在云环境里设置 Key 也不会覆盖订阅。
• 订阅脚本令牌排在 API Key 后面：同一个环境里既有 CLAUDE_CODE_OAUTH_TOKEN 又有 ANTHROPIC_API_KEY，-p 模式会用 Key，费用进 Console。
• 不设任何变量也可能走 API：/login 时选了 Claude Console 账号，用量按 token 记到 Console 组织。官方成本管理文档说明，第一次用 Console 账号登录 Claude Code 时，会自动建一个名为 “Claude Code” 的工作区来汇总这部分花费。

先看本机设置了哪些相关变量。下面这行只列出变量名，不打印 Key 的值，适合截图发给同事：

env | cut -d= -f1 | grep -E '^(ANTHROPIC_|CLAUDE_CODE_)'

然后在 Claude Code 里运行 /status。如果它显示的是订阅账号，后面的问题按订阅额度排查；如果显示的是 API Key 或 Console 账号，就按本节的表找到对应来源。

为什么有订阅还会出现 API 账单

最常见的是以前批准过环境里的 API Key。官方认证文档的原话是：有有效的 Claude 订阅、同时环境里设置了 ANTHROPIC_API_KEY 时，Claude Code 在你批准后使用这个 Key。批准只问一次，之后每次启动都直接用，也会跳过登录提示。很多人是几周前随手点了同意，后来只看到 Console 在扣钱。如果这个 Key 所属的组织已被停用或过期，表现会变成认证失败，而不是计费。

第二种是非交互模式。claude -p、git hook、cron 任务、CI 流水线都属于这一类。文档写明 -p 模式下只要有 Key 就用，不会询问；同一台机器上交互模式拒绝过 Key，也不影响 -p。

第三种是登录的账号本身就是 Console 账号。这时 /status 显示的是 Console 组织，用量进 Console 的 “Claude Code” 工作区。

第四种是把 Max 的月度 API 额度当成了 Claude Code 额度。2026 年 10 月 7 日起，Max 和 Team 每月附带一笔 Claude API 额度，用于 Claude API、Managed Agents、Agent SDK 和 Console playground；claude -p 和 Agent SDK 只有在使用关联 Console 组织的 API Key 时才从这笔额度里扣。交互式 Claude Code 和用量积分都不用这笔额度，所以“订了 Max、关联了 Console、交互模式又用了 Key”的组合仍会产生 API 费用。

还有一种不是 API 账单，但常被混在一起：订阅额度用完后开启了用量积分。帮助中心说明用量积分按标准 API 价格计费，费用以附加项目出现在你的 Claude 订阅账单上。

判断时不要先买 Max，也不要先删 Console 里的 Key。先拿到 /status 的结果，再决定是改登录、移除变量，还是管理用量积分。

/status、/usage、/cost 和 Console 分别看什么

/status 是第一入口，路由没确认之前，后面任何数字都容易读错。

旧教程常让你跑 /cost 看花费。现行的Claude Code 成本管理文档（Manage costs effectively）把这类会话美元估算放在 /usage 的 Session 区块里，并写明 Pro 和 Max 订阅用户的用量已包含在订阅里，这个数字和计费无关。它是 Claude Code 在本地按标价算出来的；组织管理员配置了合同价时，Total cost 一行会注明按组织配置的价格计算，但仍是估算，准账在 Console 的 Usage 页面。

/usage 的计划用量构成也只算本机的会话记录，其他设备和 claude.ai 上的用量不在里面。想核对整个账号的额度，以 claude.ai 的 Settings > Usage 为准；按用量排查 token 去向，可以看Claude Code 用量查看与 Token 审计。

/usage-credits 也能顺带确认路由：成本管理文档说明，这个命令要先通过 /login 用 claude.ai 订阅登录，API Key 认证下不可用。

什么时候应该用 API Key

API Key 适合需要程序化访问、按项目记账或给别人提供服务的工作，不是订阅额度不够时的随手替代。按用途分：

CLAUDE_CODE_OAUTH_TOKEN 由 claude setup-token 生成，认证文档写明它有效期一年、通过你的 Claude 订阅认证，只能发模型请求；命令不会把令牌保存到任何地方，需要你自己复制进环境变量，bare 模式不读它。它适合“同一个人在自己的机器或流水线上跑脚本”，不是给团队共用的。

给别人用的产品必须走 API Key。Claude Code 的法律与合规页面（Legal and compliance）写明：OAuth 认证只面向 Claude Free、Pro、Max、Team、Enterprise 的购买者，用于 Claude Code 和其他 Anthropic 原生应用的普通使用；用 Agent SDK 等开发产品或服务的开发者应使用 Claude Console 或受支持云平台的 API Key；Anthropic 不允许第三方开发者在自家应用里提供 Claude.ai 登录，也不允许代用户通过 Free、Pro、Max 凭据转发请求。Pro 和 Max 的公开用量上限以“个人的普通使用”为前提。

第三方工具能不能用订阅，目前没有一条通用答案。Claude 帮助中心在 2026 年 10 月 7 日更新的说明里写着，你仍可以在订阅额度内使用 Claude Agent SDK、claude -p 和第三方应用；同一页说明，之前宣布的 Agent SDK 用量调整已于 6 月 15 日暂停，“什么都没有改变”。另一方面，2026 年 4 月有媒体报道 OpenClaw 这类代理框架不再计入订阅额度，改为按用量付费、用量包或 API Key，之后又有部分回调的报道。用之前先看该工具自己的文档写的是哪种计费；无论哪种，都不要把个人订阅凭据给别人或给你产品的用户使用。

区分 API 和 Claude Code 两个产品本身，可以看Claude API 和 Claude Code 区别；Key、模型和网关的具体设置在Claude Code API 配置。如果只是本地写代码经常碰到额度上限，问题在计划档位，先看Claude Pro vs Max 怎么选，不要把它当成 API Key 设置问题。

Usage Credits 和价格边界

订阅、用量积分、Max 月度 API 额度和 Console API 余额是四个不同的钱包，彼此不能互抵。

订阅价格（Claude 官方价格页，截至 2026 年 10 月 10 日，不含税）：

用量积分（Usage credits，也叫 extra usage）面向 Pro、Max 5x 和 Max 20x：在 Settings > Usage 开启、绑定付款方式、设月度花费上限后，计划额度用完时按标准 API 价格继续用，Claude 对话和 Claude Code 终端共用这笔积分。帮助中心写明月度 API 额度不能用来付用量积分。想预付打折，可以买用量包：$45 买 $50、$200 买 $250、$700 买 $1,000，个人每月最多买 $2,000 的折扣包，超出部分按标准价。

用量积分期间有一个隐形成本：成本管理文档说明，订阅额度内的提示缓存有效期是 1 小时，开始扣用量积分后降到 5 分钟。离开超过 5 分钟再回来，下一条消息会重新处理整段上下文。

Max 和 Team 的月度 API 额度（2026 年 10 月 7 日起）：Max 5x 每月 $100，Max 20x 每月 $200，Team Standard 每席 $20、Premium 每席 $100，团队合并成一个池，上限每月 $500。Free、Pro 和 Enterprise 不在范围内。需要关联一个 Claude Console 组织领取，可用于 Claude API、Managed Agents、Agent SDK 和 Console playground，不付交互式 Claude Code，也不付用量积分；每个周期刷新，不结转。

API 标价（每百万 token，输入 / 输出）：Fable 5.1 为 $10 / $50，Opus 5.5 为 $4 / $20，Sonnet 5.5 为 $2 / $10，Haiku 5.5 在 100K 以内为 $0.10 / $0.50。用量积分也按这个价格扣。

按这些标价算一轮较重的 Claude Code 对话。假设一轮读入 200K 输入 token、写出 20K 输出 token、没有缓存命中：

• Opus 5.5：0.2 × $4 + 0.02 × $20 = $0.80 + $0.40 = $1.20
• Sonnet 5.5：0.2 × $2 + 0.02 × $10 = $0.40 + $0.20 = $0.60
• Fable 5.1：0.2 × $10 + 0.02 × $50 = $2.00 + $1.00 = $3.00

如果 200K 输入里有 180K 命中缓存（Opus 5.5 缓存读取 $0.20/百万），Opus 5.5 这一轮是 0.18 × $0.20 + 0.02 × $4 + 0.02 × $20 = $0.036 + $0.08 + $0.40 = $0.516。也就是说，$20 的积分在没有缓存时大约够 16 轮这样的 Opus 5.5 对话。token 数是假设，真实会话差别很大，但足以说明：缓存失效和换用 Fable 会让 API 计费涨得很快。

所以问题不是“API 一定更便宜”或“订阅一定更便宜”。长时间交互式写代码通常订阅更划算，CI、后端、批处理和给别人用的服务走 API Key。用量积分怎么算更值，见Claude 额外使用费用；年付、用量包等正规省钱方式见Claude Code 优惠 2026；各档方案的额度倍数见Claude 用量限制总表。需要单独买 API 额度时，API 在 Claude Console 预付充值，和订阅分开，具体步骤见Claude API Key 怎么购买。

如何切回订阅登录

官方认证文档给出的做法是：运行 unset ANTHROPIC_API_KEY 退回订阅，再用 /status 确认当前生效的是哪种认证。按来源分几种情况：

1. Key 来自当前 shell：在启动 Claude Code 的同一个终端里移除它，再启动。

   bash复制

   unset ANTHROPIC_API_KEY
   claude

   进入会话后运行 /status。如果之前用的是 ANTHROPIC_AUTH_TOKEN，同样 unset 它。

2. 想保留变量、只在交互模式不用它：在会话里打开 /config，关闭 “Use custom API key”。这个开关只在环境里有 ANTHROPIC_API_KEY 时出现；它只管交互模式，-p 仍然会用 Key。

3. 登录的是 Console 账号：在会话里运行 /logout，再 /login 选择 Claude 订阅账号，最后 /status 确认。

4. 新开终端后 Key 又回来了：说明它写在更持久的位置。检查 .zshrc、.bashrc、项目的 .env、终端配置、devcontainer、CI secret 和启动脚本，从源头删掉或改名。

移除变量不会删掉 Console 里的 Key，只是当前环境不再用它。需要在一台机器上分开个人和工作账号时，文档建议给每个账号设一个独立的 CLAUDE_CONFIG_DIR。登录凭据在 macOS 上存于钥匙串，在 Linux 和 Windows 上存于 ~/.claude/.credentials.json；/logout 会清掉当前登录。

不要混淆的几件事

• Pro 不包含 API 调用。帮助中心的说法是付费订阅提升的是聊天体验，Claude API 另行计费。Pro 能用 Claude Code，但给自己的程序调 API 要在 Console 另外付费。
• Max 的月度 API 额度不是 Claude Code 额度。它付的是 API 和 Agent SDK，不付交互式会话，也不付用量积分。
• /usage 里的美元数字不是订阅账单。订阅看计划用量条和 Settings > Usage，API 看 Console 的 Usage 页面。
• 用量积分不是订阅额度。它是额度用完后你主动开启的按量付费，出现在订阅账单上。云端会话赠金是另一笔一次性额度，已于 2026 年 10 月 7 日截止领取，区别见Claude 云端会话赠金、用量积分和限额重置。
• API Error: 529 Overloaded 和计费无关。它表示服务端过载，通常稍后重试即可，处理方法见Claude API 529 overloaded_error 怎么解决。
• 不要把真实 API Key 贴进工单、群聊、截图或排障提示。证明变量是否存在，用上面只列变量名的命令就够了。
• “国内低价订阅”不是同一种东西。Claude 的支持地区不包括中国大陆。闲鱼等平台出售的共享账号和“半年优惠码”，2026 年 3 月社区已有封号警告；Anthropic 的条款禁止共享账号，客服也不发放一次性折扣或优惠码。正规的少花钱方式是年付、用量包和官方限时活动。

团队里怎么定这条规则

团队环境里，把 Claude Code 的计费方式写成一条明确规则，比靠每个人记住可靠。成本管理文档说明，组织里混用不同登录方式时，每个开发者按自己认证的那种方式计量，所以规则要落到“谁用哪种凭据”：

• 交互式写代码：用 Team 或 Enterprise 席位登录。席位额度按 5 小时和每周两个窗口重置，和 Claude 聊天、Cowork 共用，大小取决于 Standard 还是 Premium 席位。超出后是否开用量积分、上限多少，由管理员在 claude.ai 的 Organization settings > Usage 设置。
• CI、仓库机器人、服务端代理、批处理：用 Console 组织的 API Key，在 Console 为 “Claude Code” 工作区或对应工作区设花费上限。
• 个人脚本令牌：claude setup-token 生成的令牌绑定个人订阅，只给本人用，不放进团队共用的 secret。
• Team 的月度 API 额度：每席 $20 或 $100、团队上限每月 $500，只抵 API 侧的用量，预算表里和席位费分开列。

长任务开跑前做一次检查：记下当前 /status、当前 shell 里有哪些 ANTHROPIC_ 和 CLAUDE_CODE_ 变量、这次任务应该记在个人席位还是 Console 项目。三项对不上，例如任务写的是个人席位、环境里却有 API Key，就先修环境再开跑，比事后追账便宜。

排查时交出的材料也要克制：/status 里的账号和认证方式描述、变量名列表、Settings > Usage 的计划用量与积分分区、Console Usage 的工作区和时间范围。这些足够客服或同事判断方向，不需要完整 Key、.env 文件或 Console 截图。

给队友的一句话结论：先看 /status，再判断是订阅额度问题、API Key 问题，还是用量积分问题。

验证路径

上面的规则截至 2026 年 10 月 10 日，依据以下官方页面：

• Claude Code 官方认证文档（Authentication）：凭据优先级、交互模式的一次性批准、/status 标记、setup-token、云端会话
• Claude Code 成本管理文档（Manage costs effectively）：/usage、/usage-credits、Console 工作区、团队计费、缓存有效期
• Claude Code 法律与合规页面（Legal and compliance）：OAuth 和 API Key 各自的允许用途
• Claude 帮助中心：Agent SDK、claude -p 与第三方应用的订阅用量说明
• Claude 帮助中心：付费方案的用量积分和用量包
• Claude 官方价格页：订阅价和 API 标价

这些页面更新频繁，价格和额度变动时以页面当日显示为准。

你自己排查时按同样顺序：先 /status，再列出 ANTHROPIC_ 和 CLAUDE_CODE_ 变量，最后看 Settings > Usage 或 Console 的 Usage 页面。先拿到路由答案，再决定是改登录、移除变量、管理用量积分，还是比较订阅方案。

常见问题

Claude Code 一定需要 API Key 吗？

不需要。用 Claude Pro、Max、Team 或 Enterprise 账号通过 /login 登录就能用，用量从订阅额度里扣。API Key 适合 CI、后端服务、给别人用的产品，或需要按 Console 项目记账的场景。

为什么我有 Pro 或 Max，还出现 API 计费？

最常见的是环境里有 ANTHROPIC_API_KEY，而你在交互模式下批准过它，或者用 claude -p 跑了任务（这种模式有 Key 就直接用）。也可能是 /login 登录的是 Console 账号。先运行 /status，它会标出没在用的凭据。

Claude Pro 订阅包含 API Key 吗？

不包含。Pro 订阅能用 Claude 聊天和 Claude Code，Claude API 另行计费，需要在 Claude Console 预付充值并创建 Key。Max 和 Team 从 2026 年 10 月 7 日起每月附带一笔 API 额度，Pro 没有。

Max 每月送的 API 额度能抵 Claude Code 吗？

只能抵一部分。它付 Claude API、Managed Agents、Agent SDK 和 Console playground；claude -p 和 Agent SDK 要用关联 Console 组织的 API Key 才扣这笔额度。交互式 Claude Code 和用量积分都不用它。

Usage credits 是订阅额度吗？

不是。用量积分是 Pro、Max 用户在计划额度用完后主动开启的续用方式，按标准 API 价格计费，费用出现在订阅账单上。订阅本身有自己的额度和重置周期。

订阅不够用时应该改用 API 吗？

只有任务本身是 API 型工作时才改。交互式写代码碰到上限，可以等额度重置、开用量积分或升级 Max；按上文的估算，重度交互式使用改按 token 计费通常更贵。先用Claude Code 用量查看与 Token 审计找出额度花在哪里。

/cost 显示的是我的订阅账单吗？

不是。现行成本管理文档把会话美元估算放在 /usage 的 Session 区块，并说明它面向 API 用户，对 Pro、Max 订阅用户和计费无关。订阅看 Settings > Usage，API 看 Console 的 Usage 页面。

如何停止 Claude Code 使用 API Key？

在启动 Claude Code 的同一个环境里运行 unset ANTHROPIC_API_KEY，重新启动后用 /status 确认；想保留变量的话，在 /config 关闭 “Use custom API key”（只对交互模式有效）。Key 反复出现，就去 shell 配置、项目 .env 或 CI secret 里删掉。

Claude Pro 和 Max 订阅价格 2026 年是多少？

截至 2026 年 10 月 10 日，官方价格页列出 Pro 每月 $20 或年付 $200，Max 5x 每月 $100，Max 20x 每月 $200（Max 只有月付），均不含税。Team Standard 年付每席每月 $20，Premium $100。

Claude Code 订阅在国内能用吗？

Claude 的支持地区不包括中国大陆。市面上的共享账号、低价代充和转售优惠码不在官方渠道内，有封号风险，Anthropic 条款也禁止共享账号。

能把 Claude 订阅用在 OpenClaw、Cline 这类第三方工具里吗？

官方说法有出入。帮助中心 2026 年 10 月 7 日的说明写着第三方应用仍可使用订阅额度；法律与合规页面则禁止第三方开发者代用户通过 Free、Pro、Max 凭据转发请求，2026 年 4 月也有媒体报道 OpenClaw 类工具改为单独计费。以该工具自己的文档为准，给别人用的产品一律走 API Key。