Claude Code 订阅与 API 计费:价格与区别
Claude Code 既可以使用 Claude 订阅,也可以按 API 计费。使用订阅(Pro、Max、Team 或 Enterprise)时,用量包含在套餐额度之内。使用 API 密钥时,按 token 付费,没有套餐额度上限。如果设置并批准了 ANTHROPIC_API_KEY,Claude Code 会使用它,而不是你的订阅。
其他语言版本: English · Español · Deutsch · Français · 日本語 · Português (Brasil) · 한국어 · Italiano · Nederlands · 繁體中文
本指南由 Switch 提供。Switch 是一款独立的 Claude Desktop 配置文件管理工具,目前在正式发布前开放抢先体验。
为 Claude Code 付费的两种方式
订阅登录。你用自己的 claude.ai 账号登录。所有付费套餐都包含 Claude Code,并与套餐共用额度:每五小时重置一次的会话额度,以及每周额度。截至 2026 年 10 月,Pro 每月 US$20,Max 每月 US$100 或 US$200(claude.com/pricing)。
API 计费。你使用 Claude Console 账号、API 密钥或云服务提供商。用量按 token 随用随付,计入该账号,没有硬性上限(Claude Code 中的模型、用量和限制)。API 价格因模型而异,按每百万输入和输出 token 收费;当前费率请见 Anthropic 的价格页面。
哪种方式适合你
订阅的月费是可预期的。代价是碰到额度上限时,你要么停下来,要么改用付费积分。API 计费是随用随付,费用取决于你用了多少,不过 API 账号有速率限制,管理员也可以为工作区设置支出上限。
作为参考,Anthropic 的费用页面指出,在企业部署中,平均每位开发者每个活跃日约 US$13,每月 US$150 到 US$250,90% 的用户每个活跃日低于 US$30。你自己的数字取决于所选模型、代码库大小和使用习惯。
如果是日常稳定使用、而且看重可预期的账单,订阅更合适。Anthropic 也建议,在密集的编程冲刺期间,可以使用带 API 积分的 Console 账号。
如何查看当前生效的是哪种方式
在 Claude Code 中运行 /status。Anthropic 的认证文档说明,它会确认当前生效的认证方式;如果同时配置了登录和 API 密钥,它会标出未在使用的那一个。
其他判断方法:使用订阅时,/usage 会显示套餐用量进度条;使用 API 计费时,其中的 Session 区块会显示估算的美元费用。API 用户也可以运行 /cost 查看累计支出。
ANTHROPIC_API_KEY 会覆盖你的订阅
这是意外费用最常见的原因。在 Claude Code 的认证优先顺序中,环境变量 ANTHROPIC_API_KEY 的优先级高于订阅登录。在交互模式下,Claude Code 会询问一次是否使用该密钥,并记住你的选择;在非交互模式(-p)下,它总是使用该密钥。Anthropic 帮助中心提醒,这会产生 API 费用,而不是使用套餐包含的用量。
要改回使用订阅:
unset ANTHROPIC_API_KEY然后从 shell 配置文件中删除设置该变量的那一行,重新启动 Claude Code,并用 /status 确认。在该变量仍然设置的情况下,你也可以在 /config 中通过“Use custom API key”开关更改之前的选择。Claude Desktop 不读取这个变量,它通过 OAuth 登录。
只使用套餐额度
使用订阅时碰到额度上限,Claude Code 可能会提示你改用 API 积分继续。Anthropic 表示,你可以拒绝并等待额度重置。如果不想再看到这个选项,请退出登录,只用 Pro 或 Max 的凭据重新登录,并且不要添加 Console 凭据(在 Pro 或 Max 套餐中使用 Claude Code)。API 积分自动充值是 Console 中的设置,如果你以前用过 API 计费,请到那里检查。
如果你的工作账号和个人套餐采用不同的计费方式,请为每个账号设置各自的 CLAUDE_CONFIG_DIR,避免登录混在一起。请查看在一台 Mac 上使用多个 Claude Code 账号;如果你在 Claude Desktop 中使用 Claude Code,也可以查看 Switch 与 Claude Code。