← 返回全部文章
Analysis · 2026年10月12日 · 8 分钟阅读

Max 每月 $100–$200 API 额度:能用在哪、不能用在哪,claude -p 到底算谁的账

每月 $200 的 API 额度足够把本站最近四篇文章的实测再跑约 20 遍,适合拿来做脚本化工作。套餐的 5 小时窗口和每周上限仍然照旧,交互式 Claude Code 也不能用这笔额度。对 claude -p 来说,关键在于凭证:没有更高优先级凭证时,只要环境里设了 ANTHROPIC_API_KEY,我们测到的每次运行都会用这个 API key。

30 秒看懂结论

10 月 7 日,Anthropic 在发布 Haiku 5.5 时宣布,将向所有 Max 和 Team 套餐用户提供用于 Claude Platform 的每月 API 额度。原文是:“roll out a new monthly API credit to all Max and Team subscribers for use on the Claude Platform”。Max 5x 每月 $100,Max 20x 每月 $200;按支持页说法,Team 的额度按席位汇总,最多 $500。结合支持页和平台文档,先记住这些规则:

  • 额度发到组织里。领取时要把一个 Claude Console 组织绑定到套餐;可以在流程中新建组织,不需要银行卡。每个计费周期发放一次,年付套餐也是按月发放。组织内所有 API key 共用这笔余额,先扣每月 API 额度,再扣购买的额度;当期没用完的会过期,不结转。套餐用量上限不变。
  • 适用范围是 API 开发。Messages API、Message Batches API、Playground、Claude Managed Agents 和 Claude Agent SDK 都能用,支持所有当前模型。终端、IDE、桌面和网页里的交互式 Claude Code 会话不能用;Claude 应用的套餐超额用量,以及 Bedrock、Vertex、Foundry 上的调用也不能用。
  • claude -p 要看用哪个凭证。用绑定组织的 API key 运行 claude -p,按 Agent SDK 用量计费,可以扣这笔额度。用套餐登录态运行同一条命令,仍扣套餐用量上限。由 GitHub Action、IDE 插件或桌面应用发起的运行,即使带 -p,也算 Claude Code。
  • 我们测到 API key 会优先使用。在 Claude Code 2.1.293 和 2.1.294 上,排除更高优先级凭证后,设置 ANTHROPIC_API_KEY 会让 claude auth status 从 claude.ai 变成 api_key。用故意填错的 API key 执行 claude -p,直接报 401,没有回退到套餐登录态。交互式会话则会问一次。
  • 这次没有拆分套餐用量。5 月公布的方案原定 6 月 15 日实施:程序化用量单设每月额度,套餐用量上限留给交互式工作。方案在当天暂停。10 月这次保留原有套餐用量,另外给组织发 API 额度,通过 API key 使用,Pro 不在领取范围内。
  • $200 足够做不少脚本化工作。按 Claude Code 为本站实测报告的官方标价费用,提示词审计用 Opus 5.5 能完整跑 266 次,用 Haiku 5.5 能跑 5,154 次。最近四篇文章的实测合计只花了 $9.78。我们记录的另一批流量按标价折算约为 $900/月,那些会话实际跑在套餐上,而且大多是额度不覆盖的交互式工作。

结论:如果你有批处理任务、评测框架,或基于 SDK 开发的代理,需要使用 Claude Console 组织,就值得领取。交互式工作继续用套餐。API key 按命令或按项目设置,别放进 shell 配置文件;否则,每次继承了这个环境的 claude -p 运行都会转用 API key,很容易在不知情时改了计费来源。

10 月 7 日改了什么,和 6 月方案有何不同

Anthropic 今年两次为 Max 提出每月额度方案,但两次对套餐用量的安排不同。5 月方案的细节来自 Anthropic 开发者账号 5 月 13 日发布的推文线程(我们在浏览器里直接读过原帖和跟帖),以及支持页保留的暂停说明。把两次方案放在一起,就能看出区别:

5 月 13 日公布,原定 6 月 15 日实施10 月 7 日起推出
用途为程序化用量单设每月额度:Agent SDK、claude -p、Claude Code GitHub Action,以及基于 SDK 的第三方应用用于开发调用 API 的工具、应用和代理:Messages API、Message Batches API、Playground、Claude Managed Agents、Agent SDK
金额Pro $20,Max 5x $100,Max 20x $200;Team 每席位 $20 或 $100,Enterprise 依席位而定Max 5x $100,Max 20x $200;Team 每席位 $20 或 $100,汇总后最多 $500;Pro、Free、Enterprise 不符合领取条件
对套餐的影响用量上限不变,但留给交互式工作;程序化用量先扣专门额度,用尽后通过用量额度(Usage credits)按 API 费率付费套餐用量上限不变;用套餐登录态运行的 claude -p 和 SDK 仍扣套餐用量
第三方工具可以用 Claude 套餐,但像用户自己的脚本一样扣专门额度只有使用绑定组织的 API key 才能扣每月 API 额度;支持页说仍可使用套餐用量上限
状态6 月 15 日暂停;支持页 FAQ 现已说明那笔额度不提供了,原文为 “That credit isn’t available”正在逐步推出;符合条件的套餐启用满七天后会出现领取入口

Agent SDK 支持页还保留着 6 月 15 日的暂停说明:当时没有任何变化,SDK、命令行非交互式运行和第三方应用仍扣套餐用量上限。原文写道:“For now, nothing has changed: Claude Agent SDK, claude -p, and third-party app usage still draw from your subscription limits.”

同一页面上方的 10 月 7 日更新说,Max 和 Team 现在有了每月 API 额度,覆盖 Claude Agent SDK、claude -p、Claude API 和 Claude Managed Agents。它还明确说,Claude Agent SDK、claude -p 和第三方应用仍然可以使用套餐用量上限。两段合起来看,意思很清楚:什么都没从套餐里挪走,只是给使用 API key 的工作多了一笔额度。

Hacker News 最初的一些讨论把它当成了 6 月方案的落地,甚至有帖子将其概括为“Claude Max 和 Team 套餐现在被迫改用 API”(原标题:“Claude Max and Teams plans now forced to API”)。5 月的公告让人以为程序化用量迟早要移出套餐,但这次并没有发生。一位评论者引用网页存档指出,同一篇支持文章直到 10 月 6 日还保留着 6 月方案的说法,这也解释了误会从何而来。

不同套餐用户的处境也不一样。Max 用户现在保留原有套餐用量,又多了 API 额度;6 月方案原本要把交互式和程序化用量分开。Pro 原本预计会有 $20,这次没有。如果你的脚本一直用套餐登录态运行,要改用 API key 才能花到新增的额度。

哪些用量能抵扣,哪些不能

下表按支持页和平台文档整理。最容易看错的地方,是 claude -p 的凭证,以及由其他应用发起的运行如何归类。

用量类型每月 API 额度能否抵扣
Messages API 和 Message Batches API,所有当前模型能
Claude Console 中的 Playground能
Claude Managed Agents能
使用绑定组织 API key 的 Claude Agent SDK能
使用绑定组织 API key 的 claude -p能,按 Agent SDK 用量计费
用套餐登录态运行的 claude -p 或 Agent SDK不能,扣套餐用量上限
终端、IDE、桌面或网页中的交互式 Claude Code不能
由 Claude Code GitHub Action、IDE 插件或桌面应用发起的运行,即使带 -p不能,算 Claude Code
Claude、Claude Code 或 Claude Cowork 的套餐超额用量不能
通过 Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry 或 Claude Platform on AWS 使用 Claude不能

把交互式会话接到这个组织上,也绕不过限制。平台文档说,如果组织里只有每月 API 额度,却用它运行 Claude Code 会话,Claude Code 会显示 Credit balance too low · Add funds,并附上 Console 账单页的链接。这是文档描述,我们没有实测该场景。

还要分清两个名字。用量额度(Usage credits)以前叫“超额用量”:Pro 或 Max 用户在“设置 → 用量”里开启并设定支出上限后,超过套餐用量上限还可以继续工作,超出部分按 API 费率收费。每月 API 额度 则存放在 Claude Console 组织里,用于 API 开发。两者用途不同,后者不能拿来支付前者。

claude -p 算谁的账:凭证优先级实测

既然计费来源取决于凭证,就得先知道 Claude Code 在多个凭证同时存在时会选哪个。认证文档列出的顺序是:设置了 Bedrock、Vertex 或 Foundry 变量时,先用相应的云服务凭证;然后依次是 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper 脚本、CLAUDE_CODE_OAUTH_TOKEN、Anthropic 配置档中的凭证,最后才是通过 /login 保存的套餐登录态。

在交互式模式下,Claude Code 发现 ANTHROPIC_API_KEY 后,会问一次是否使用,并记住选择。/config 中的“使用自定义 API key”(原文:“Use custom API key”)开关,只在设置了这个环境变量时出现。非交互式模式则不同:文档说,只要存在 API key 就会使用,原文是 “the key is always used when present”。

我们用 Max 20x 套餐,在没有更高优先级凭证的干净环境里做了以下检查:

  • 先看 claude auth status 的变化。用套餐登录态时,它显示 "authMethod": "claude.ai" 和 "subscriptionType": "max"。设了 ANTHROPIC_API_KEY 后,变成 "authMethod": "api_key" 和 "apiKeySource": "ANTHROPIC_API_KEY",套餐字段随之消失。10 月 7 日的 Claude Code 2.1.293、10 月 12 日的 2.1.294 都是如此。它能告诉你接下来会发送哪个凭证,但不能告诉你组织会扣哪个余额;组织是否领到了额度,要到 Console 账单页另行确认。
  • 再看 -p 实际发送什么。我们保留钥匙串中的有效套餐登录态,在环境变量里故意填错 API key。两次执行 claude -p 都返回 api_error_status: 401,没有产生费用。2.1.293 的报错是 “Failed to authenticate. API Error: 401 API key is invalid”;2.1.294 的报错是 “Invalid API key · Fix external API key”。两次都没有回退到套餐登录态。
  • 环境变量中的 OAuth 令牌也优先于已保存的登录态。这一项只在 10 月 12 日测试:故意填错 CLAUDE_CODE_OAUTH_TOKEN 后,返回 “401 OAuth access token is invalid”,与文档列出的顺序一致。

这些测试证明的是 Claude Code 发送了哪个凭证,不是真实账单。有效 API key 最终如何扣款,本文依据的是支持页:用 API key 的 claude -p 算 Agent SDK 用量,用套餐登录态则扣套餐用量上限。

因此,如果你为了别的工具,把 API key 写进 shell 配置文件(如 .zshrc)并导出为环境变量,继承这个环境的每次 claude -p 运行都会转用 API key。费用记到该 API key 所属的组织,先扣每月 API 额度,用完再扣购买的额度;若是没有其他余额的预付费组织,请求就会停止。

交互式会话的处理方式则按文档所说:询问一次,记住选择,以后可以在 /config 的“使用自定义 API key”开关中更改。Claude Code 2.1.296 的更新日志也提到,拒绝会话的报错现在会指出哪个 API key 或认证令牌覆盖了 claude.ai 登录态,原文是 “name an API key or auth token that overrides your claude.ai login”。这是同一个问题的另一种表现。更稳妥的用法是按命令或按项目设置 API key,例如需要使用额度的任务才写 ANTHROPIC_API_KEY=… claude -p,别把它放进 shell 配置文件。

第三方应用还要另看认证规则。Agent SDK 文档要求第三方开发者使用 API key;除非事先获批,不得在产品中提供 claude.ai 登录或套餐速率限制。与此同时,支持页又说这些应用仍可使用套餐用量上限。按这两份文档,应用如果接收绑定组织的 API key,符合范围的请求可以扣每月 API 额度;如果使用套餐登录态,则扣套餐用量。第三方应用我们没有实测,这里依据的是 SDK 文档的认证要求和支持页说明。

按官方标价,$100 和 $200 能跑多少

我们用本站已经测过的任务来算。这些任务都是在小型仓库上运行的 claude -p,适合用每月 API 额度处理。费用取自 Claude Code 为当时运行报告的官方标价费用,下表次数均按能完整重复多少遍计算:

本站实测任务官方标价费用$100 能跑多少次$200 能跑多少次
在四个文件的仓库上,用 Opus 5.5 做一次提示词审计(/doctor prompt-audit)$0.75133266
同一任务,换成 Sonnet 5.5$0.41243487
同一任务,换成 Haiku 5.5$0.03882,5775,154
10 月 4 日的 mod 权限测试矩阵,共 48 次运行,使用 Haiku 4.5$0.92108217
9 月 26 日的 AGENTS.md 测试矩阵,共 114 次运行,使用 Haiku 4.5$2.164692
最近四篇文章的全部实测合计$9.781020

不过,Max 用户最想挪到这笔额度上的,可能恰恰是交互式 Claude Code 流量。我们扫描了一台机器在 7 月 10 日至 10 月 7 日期间的 12,901 次套餐调用,按 Opus 5.5 官方标价折算为 $2,678,大约 $900/月。这是测算值,不是实际账单:那些会话实际跑在套餐上。我们也没有逐次标注所有调用的执行模式;几乎全部调用来自交互式会话及其子代理,不在这笔额度的覆盖范围内。

$200 大约只有上述测算值的五分之一,而且其中绝大多数流量本来就不能用这笔额度支付。表格里的工作量则不同:全部加起来按标价只需 $9.78,$200 足够把这组实测重复约 20 遍。

六个容易忽略的细节

  1. 绑定前先选好组织。每个套餐只能绑定一个 Claude Console 组织,每个组织也只能接收一个套餐的额度。绑定后不能自行更换,后续修改要联系支持。请选实际准备用来开发的组织。
  2. 自动充值不看免费余额。扣费时先用每月 API 额度,但自动充值只盯着购买的额度。文档说,即便赠送额度还有剩余,只要购买的额度降到阈值就会充值;原文是 “reloads when that balance reaches your threshold, even if included credits remain”。因此,开着自动充值时,免费额度还没用完,也可能已经买入了新额度。
  3. 使用额度也计入支出上限。用每月 API 额度支付的用量,照样计入组织的每月支出上限。支出上限每月第一天重置,API 额度则随套餐计费周期刷新,两者日期可能不同。
  4. 预付费组织用尽余额后会停。如果组织既没有购买的额度,也没有开启自动充值,请求会返回 “Your credit balance is too low to access the Anthropic API”,直到下一笔每月 API 额度到账。这些用量不会转记到 Claude 套餐。通过 Anthropic 销售团队签约、按发票结算的组织是例外,超出额度的用量照常计费。
  5. 速率限制档位有小幅提升。按文档说法,绑定组织至少进入 Start 档位;每月 API 额度超过 $200 时,至少进入 Build 档位,也就是汇总额度超过 $200 的 Team 组织。除此之外,这笔额度不计入后续档位升级的累计要求。
  6. 到账时间跟着套餐走。符合条件的新套餐启用满七天后出现领取入口;每次套餐付款后不久发放,年付套餐按月发放。从 Max 5x 升到 Max 20x,额度会立即按比例调整。文档对 Google Play 套餐另有说明:调整较晚,最迟在下次续费时到账。取消套餐后不再发新额度,现有额度仍可用到过期。

我们自己的 Max 20x 账号在 10 月 7 日出现了领取入口:“设置 → 账单”下有一张“免费 API 额度”卡片(原文:“Free API credits”),API 额度区域显示 $200。文档所述的下一步是绑定组织并接受额度条款。我们没有领取这笔额度,因为这个账号还用于其他测量,绑定后又无法自行撤销。本文只报告页面说明与 Claude Code 的行为,没有实测领取流程。

具体怎么用

  1. 有脚本化工作就去领。例如评测框架、批量改写、定时 claude -p 任务,以及基于 Agent SDK 开发的代理。先想好使用哪个 Claude Console 组织,再创建或绑定;这项绑定不能自行更改。
  2. 交互式工作继续用套餐。每月 API 额度不能支付交互式用量。官方文档说,只持有这笔额度的组织运行 Claude Code 会话时,会提示 “Credit balance too low”。套餐的 5 小时窗口和每周上限都不受影响。
  3. API key 按命令或项目设置。要扣额度的任务用 ANTHROPIC_API_KEY=… claude -p …,也可以放在项目设置文件的 env 块里,别写进 shell 配置文件。用 claude auth status 查看当前 shell 会发送哪个凭证,再去 Console 核对该 API key 所属组织有没有额度。
  4. 给这类任务单独设工作区。组织内所有 API key 共用余额。给工作区设置支出上限,可以避免某个脚本失控,把当月所有任务可用的额度一次耗尽。
  5. 先检查自动充值设置。如果已经开启,确认你是否愿意在赠送额度尚未用完时,仍然自动补充购买的额度。
  6. 按 10 月的新规则安排工作。什么都没从套餐里挪走。如果你在 5 月为应对计划中的拆分改造过流程,现在可以重新评估哪些任务适合脚本化,再用新增额度去跑。

哪些环节没有实测

我们没有领取这笔额度。因此没有亲眼看到 Console 里的余额、“赠送额度”条目(原文:“Promotional credits”)、到期日,以及额度用尽时的表现。这些全部按 Anthropic 官方页面转述。绑定组织是我们无法自行撤销的账号变更,而这个账号还用于其他测量。

Team 按席位汇总、Google Play 到账时间、按发票结算组织的例外、速率限制档位提升,也全部来自文档,不是我们的实测结果。

第三方应用没有实测。我们没有拿绑定组织去测试 Zed、Paseo、T3 Code 或其他基于 SDK 的工具。本文依据的是 SDK 文档中第三方应用须使用 API key 的认证要求,以及支持页关于仍可使用套餐用量上限的说明。

凭证优先级测试故意使用了无效凭证。测试环境中没有设置更高优先级的凭证,结果只能证明 Claude Code 发送了哪个凭证,不能证明绑定组织的有效 API key 会产生怎样的真实账单。云服务变量、ANTHROPIC_AUTH_TOKEN 会排在本次测试的 API key 前面;如果使用 apiKeyHelper 脚本,也要按前文的完整顺序核对,不能把结果套到不同的凭证配置上。

费用表按官方标价计算。复用的是 Claude Code 为实测运行报告的费用,那些任务实际扣的是 Max 套餐用量。如果换成 Console API key,会按相同的官方费率计费,其中也包含提示词缓存的计价。

相关阅读

来源

  1. Anthropic:Claude Haiku 5.5 发布公告,2026 年 10 月 7 日。公告宣布向 Max 和 Team 套餐发放每月 API 额度,列出各档金额,并说明用途是试做调用 API 的工具、应用和代理。
  2. Anthropic:Max 和 Team 套餐的每月 API 额度。支持文章,2026 年 10 月 12 日检索,页面标注“本周更新”。包括领取资格、流程、覆盖范围,以及 claude -p、GitHub Action、IDE 和桌面应用运行、6 月额度方案的 FAQ。
  3. Anthropic:Max 和 Team 套餐的 API 额度。Claude Platform 文档,包含规则速查、自动充值、支出上限、速率限制档位、按发票结算组织的例外、余额用尽提示,以及不受覆盖的请求所触发的 Credit balance too low · Add funds。
  4. Anthropic:用 Claude 套餐运行 Claude Agent SDK。支持文章,保留了 6 月 15 日的暂停说明和 10 月 7 日的更新。
  5. X 上的 Claude Developers:2026 年 5 月 13 日的推文串。推文串于 2026 年 10 月 12 日在浏览器中直接读取。5 月方案的金额、原定从 6 月 15 日起为程序化用量单设额度、套餐用量留给交互式工作、超出后使用用量额度,以及第三方工具如何扣费等细节,来自该推文及支持页的暂停说明。
  6. X 上的 Claude Developers:2026 年 10 月 7 日的公告,宣布为 Max 和 Team 套餐提供每月 API 额度。
  7. Anthropic:Claude Code 认证文档。列出凭证优先级、交互式模式的一次性询问,以及非交互式模式下只要有 API key 就会使用的规则。原文:“In non-interactive mode (-p), the key is always used when present.”
  8. Anthropic:Claude Code 更新日志。2.1.296 说明,拒绝会话时会指出覆盖 claude.ai 登录态的 API key 或认证令牌;原文:“name an API key or auth token that overrides your claude.ai login”。
  9. Anthropic:Agent SDK 概览。第三方开发者未经批准,不得提供 claude.ai 登录或套餐速率限制,应使用 API key 认证。
  10. Anthropic:Claude Code 费用管理。说明用量额度(Usage credits)、/usage-credits 命令,以及 claude.ai 的“设置 → 用量”入口。
  11. Hacker News:关于 SDK 改用 API 额度、套餐仍否适用的讨论,2026 年 10 月 7 日。其中有评论者引用支持页在 10 月 6 日仍保留的旧说法。

本站实测:在 macOS 的干净环境中,使用 Max 20x 套餐运行 claude auth status 和 claude -p。2026 年 10 月 7 日使用 Claude Code 2.1.293,10 月 12 日使用 2.1.294;两天都故意填错 ANTHROPIC_API_KEY,10 月 12 日还测试了故意填错的 CLAUDE_CODE_OAUTH_TOKEN。官方标价费用复用自本站 9 月 26 日、10 月 4 日和 10 月 7 日文章中的运行记录。

FAQ

Max 套餐的每月 API 额度能用于 Claude Code 吗?

不能用于交互式 Claude Code。Anthropic 的条款明确排除终端、IDE、桌面和网页中的交互式会话,套餐用量上限也不会因此提高。这笔额度可通过绑定的 Claude Console 组织的 API key,用于 Messages API、Message Batches API、Playground、Claude Managed Agents 和 Claude Agent SDK。按官方文档说法,如果组织只有这笔额度,却用它运行 Claude Code 会话,会看到余额不足提示:Credit balance too low。我们没有领取额度,这一报错场景没有实测。

claude -p 能用每月 API 额度吗?

只有使用绑定的 Claude Console 组织的 API key 时才行,这类运行按 Agent SDK 用量计费。用套餐登录态运行时,claude -p 和 Agent SDK 仍扣套餐用量上限。由 Claude Code GitHub Action、IDE 插件或桌面应用发起的运行,即使带 -p,也算 Claude Code,不在这笔额度的覆盖范围内。

怎么确认 Claude Code 正在用哪个凭证?

运行 claude auth status。用套餐登录态时,authMethod 显示 claude.ai,并列出套餐类型;设了 ANTHROPIC_API_KEY 后,authMethod 变成 api_key,apiKeySource 显示 ANTHROPIC_API_KEY。这只能说明认证方式,不能证明会扣哪个余额;还要到 Claude Console 核对组织及其额度。文档说非交互式模式下只要有 API key 就会用。我们在 Claude Code 2.1.293 和 2.1.294 上排除更高优先级凭证后,用故意填错的 API key 测试,两次都报 401,没有回退到套餐登录态。这个测试证明的是发送了哪个凭证,不是真实账单。交互式会话会问一次,并记住选择。

这就是原定 6 月 15 日推出的 Agent SDK 额度吗?

不是。Anthropic 开发者账号在 5 月 13 日宣布,拟从 6 月 15 日起为 Agent SDK、claude -p、GitHub Action 和第三方应用等程序化用量单设每月额度,把套餐用量上限留给交互式工作。拟定金额为 Pro $20、Max 5x $100、Max 20x $200。该方案在 6 月 15 日当天暂停,支持页现已说明那笔额度不提供了。5 月方案的细节来自开发者账号的推文串和支持页的暂停说明。10 月的新额度存放在 Claude Console 组织里,通过 API key 使用,Pro 不在领取范围内;什么都没从套餐里挪走。

每月 API 额度和用量额度(Usage credits)有什么区别?

用量额度(Usage credits)以前叫超额用量,供 Pro 或 Max 用户在超过套餐用量上限后继续工作,按 API 费率收费,支出上限在“设置 → 用量”中设定。每月 API 额度则是发放给 Claude Console 组织、用于 API 开发的余额。两者存放位置和用途都不同,每月 API 额度不能抵扣 Claude Code 的套餐超额用量。

$200 的 API 额度实际能做多少事?

按 Claude Code 为本站实测报告的官方标价费用计算:提示词审计每次用 Opus 5.5 花 $0.75,可完整跑 266 次;用 Sonnet 5.5 每次 $0.41,可跑 487 次;用 Haiku 5.5 每次 $0.0388,可跑 5,154 次。10 月 4 日的 mod 权限测试矩阵共 48 次运行,合计 $0.92,能完整重复 217 遍。最近四篇文章的实测合计 $9.78,约能重复 20 遍。一台机器上记录的 Claude Code 流量,按 Opus 5.5 官方标价折算约为 $900/月;那些会话实际跑在套餐上,这不是实际账单,而且流量几乎都来自额度不覆盖的交互式会话及其子代理。

这篇对你有帮助吗?

相关阅读


文章独立产出 · 编辑政策

继续阅读 →