TL;DR
Claude Code 的「用量限制」其实是两套完全不同的东西,读错会白折腾:
- 5 小时会话限额(社区里常说的 5h limit):多数付费订阅自带的会话窗口额度,每五小时重置一次,另外还有一条每周限额。这是订阅席位的额度,跨模型共享——撞上之后用
/model换模型也恢复不了。 - 模型专属限额:Opus、Sonnet 各自还有一条额度。撞的是这一条时,换到另一个模型家族还能继续干活。
撞上 5 小时限额,实际只有三条路:等窗口重置(不额外花钱,损失的是时间)、开官方 usage credits 转按量付费(按标准 API 价计费,代码不中断)、把 Claude Code 指向另一条按量计费的 API 通道(按 token 扣费,没有会话窗口这个概念)。
第三种常被误解成「绕过 Claude 的限额」,这里必须写清楚:它不是绕过任何规则,而是换一种接入方式——订阅席位的会话额度只存在于订阅席位里,按 token 计费的 API 通道不设会话窗口,但同样按 token 扣费、账户里的可用额度用完为止。
下面把三条路拆开算账,并讲清「订阅的 5 小时限额」和「API 侧的 429 限流」为什么是两个完全不同的问题。
一、Claude Code 的「5 小时限额」到底是什么
1.1 官方口径:一个每五小时重置的会话窗口,外加一条每周限额
Anthropic 官方帮助中心《Manage usage credits for paid Claude plans》写得很直接:多数付费套餐都有一个每五小时重置的会话限额(session limit),以及一条每周限额(weekly limit)。
这句话里有三个关键信息,缺一个就会理解错:
- 窗口是滚动的,不是自然时段。重置是「从你开始消耗算起每五小时一轮」,不是每天 0 点、也不是每天早上 9 点。所以「等一下午」这种按自然时段算的等待方式基本没用。
- 会话限额和每周限额是两条线。5 小时窗口重置了,不代表这周还有额度;每周额度用完,5 小时窗口再空也没用。
- 套餐之间不一样。按同一份官方说明:Ultra 套餐有每周限额,通过验证的 Ultra 账号没有 5 小时限额;Max 和 Ultra 还各自有一条针对 Fable 的独立每周限额。(官方口径,as-of 2026-11-07)
所以「我 Max 套餐为什么还有限额」这个问题,答案不在额度本身,而在于该套餐具体带哪几条线、以什么方式重置。
1.2 两种限额必须分清:会话 / 每周限额,和模型专属限额
Claude Code 官方文档《Claude Code costs》里,把开发者常问的限额问题分成了两类,行为完全不同:
- 「You've hit your session limit」或「You've hit your weekly limit」:这是订阅套餐上的席位用量窗口,所有模型共享。因此用
/model换模型不能恢复访问。官方文档在解释开发者该怎么判断自己撞的是哪条线时,明确写了这一点。 - 「You've hit your Opus limit」或「You've hit your Sonnet limit」:这是模型专属的额度。撞的是这条时,用
/model换到该模型家族之外的模型,开发者可以继续工作。
这条区分很实用:
- 撞到的是模型专属限额,换一个模型家族就能接着干(模型能力差异另说)。
- 撞到的是会话 / 每周限额,换模型没有任何用,只能等窗口重置、或者换一条计费通道。
1.3 你可以先自测:用 /usage 看用量条
在 Claude Code 里执行 /usage,会看到套餐用量条、活动统计和用量构成(Pro、Max、Ultra、Team、Enterprise 套餐都有)。官方文档提到,这类用量视图还会把消耗拆给各个技能、子代理、插件和单独的 MCP 服务器,用百分比标出来——这在排查「到底是谁把我的额度吃掉」时比凭感觉有用。
二、为什么容易撞上,以及官方给了哪些开关
2.1 撞上限额通常不是因为你「用得多」
限额是按席位窗口算的,一个长任务 + 多个子代理并行,很容易在两三个小时内吃掉一整轮窗口额度。典型的吃法有三种:
- 连续跑长时间自动任务,输出 token 大头全在生成侧;
- 开了子代理 / 插件,消耗被拆成多路并行;
- 上下文反复重建(长会话、频繁
/clear之外的重试),输入侧的计费量被放大。
2.2 官方提供的三个应对手段
Anthropic 官方文档给出了三个可以直接用的开关:
/usage-credits:如果套餐开启了 usage credits,可以在超出额度后请求继续使用。- 自动等待并续跑:Claude Code v2.1.234 起支持在 claude.ai 用量限额重置后自动继续会话(可在
/config的「Continue automatically at usage limit」里关闭);v2.1.284 起,/rate-limit-options进入/help与命令菜单,可以选择让 Claude Code 自己开始等、还是由开发者确认后再等;托管设置autoContinueAtUsageLimit可以决定组织的默认值。(官方文档 + CHANGELOG,as-of 2026-11-07) /usage:随时查看当前窗口的剩余情况。
2.3 官方 usage credits 是什么
按同一份官方说明:当你把套餐自带的额度用完(任何一条 5 小时会话限额、每周限额,或 Max / Ultra 的 Fable 每周限额),开启了 usage credits 之后,请求会切换成按量计费并继续工作,后续按标准 API 价计费,直到达到你设置的月度支出上限或余额耗尽。usage credits 与 Max / Ultra 套餐自带的月度 API 额度是两笔独立的钱,月度 API 额度不适用于 usage credits。
这一点很重要:官方自己也提供「撞限额之后转按量付费」的路径,只是价格是 Anthropic 的标准 API 价、账单走 Anthropic。
三、撞上之后的三条路,怎么选
3.1 路一:等窗口重置
- 成本:不额外花钱。
- 代价:等待时间不可控,可能撞在下班前;重试往往赶不上原来的工作节奏。
- 适合:任务可以打断、且当前窗口剩余额度还很充裕的情况。
3.2 路二:开官方 usage credits,转标准 API 价
- 成本:按 Anthropic 标准 API 价计费,另算 usage credits 的支出上限。
- 优点:账单、额度上限都在 Anthropic 侧,不涉及第三方。
- 适合:已经在用官方 API 额度、且愿意把用量成本交给 Anthropic 计费的人。
3.3 路三:换一条按量计费的 API 通道
思路是把 Claude Code 指向一条按 token 计费的兼容端点,而不是订阅席位:
- 额度不按会话窗口发放,因此不存在「等几小时重置」这一层;
- 计费口径是 官方刊例价 × 固定 1.07x 倍率,按实际 token 扣费,用多少扣多少;
- 需要的动作是:充值拿额度 → 创建 API key → 把 Claude Code 的 base_url 指过去。
如果你现在正卡在窗口里,可以直接走这条:Claude API 充值页 选面额拿额度,再按第五节的步骤配好 base_url,任务就能接着跑。
这里要把话说满,避免被理解成「无限量」或「绕过限额」:按量计费通道同样按 token 计费,账户可用额度用完为止;它改变的只是额度的发放形态(按量 vs 席位窗口),不是计费本身。它也不改变 Claude Code 的任何官方限制规则。
3.4 三条路对比
- 等重置:免费,占时间,适合可中断任务。
- 官方 usage credits:标准 API 价,账单在 Anthropic,适合已有官方 API 账单的团队。
- 按量计费通道:按 token 扣费、可控可预算,适合需要连续产出、且希望多模型统一结算的场景。
判断标准其实只有两条:这段工作能不能等,以及你更愿意把用量成本记在哪一边的账上。
四、别把它和 API 侧的 429 限流搞混
这是最常见的误诊。Claude Code 有两种完全不同的「用不了」:
- 本文说的 5 小时会话限额:订阅席位额度耗尽,出现在用订阅跑 Claude Code 的场景,官方界面会提示你撞了 session / weekly limit,等窗口重置。
- API 侧限流:你在用 API key 调 Anthropic 接口,触发的是每分钟请求数(RPM)、每日 token 配额(TPD)、并发连接数这类服务端限制,表现为 HTTP 429 / 529,带
retry-after头。
两者的排查方式完全不一样:
- 429 / 529 要看响应头里的
retry-after和x-ratelimit-*,按精确等待时间退避重试; - 会话限额没有任何可调参数,只能等重置、切换计费通道,或者按官方文档的提示改设置。
如果你走的是 API 这条路,把限流的分层、退避重试、并发控制一次讲透的是这篇文章:Claude API 限流详解:429 / 529 怎么读、怎么退避。本文只讲订阅侧的会话窗口,两者不要互相套用。
五、把 Claude Code 指向按量计费端点:实操步骤
以下步骤以 CodeGateway 的兼容端点为例(端点形态与 Claude Code 直接接 Anthropic 官方 API 的写法一致)。
5.1 第一步:充值拿额度
到 Claude API 充值页 选面额(自定义金额 $5 起,预设档位 $10 / $20 / $50 / $100),充值后额度全额入账。支付方式支持信用卡(Visa / Mastercard / AmEx)、Stripe Link与银行转账;由 Stripe 提供收银台,手续费按 Stripe 费率单列。
5.2 第二步:创建 API key
在控制台创建一把 key(API key 与 workspace 绑定,按用量计费)。这一步不需要额外申请,按量计费模式下额度来自账户余额。
5.3 第三步:改 base_url 与 key
Claude Code 认两个环境变量。把它指到兼容端点即可:
export ANTHROPIC_BASE_URL="https://api.codegateway.dev"
export ANTHROPIC_AUTH_TOKEN="你的 API key"写进 shell 配置或项目级环境文件,保证每次开新终端都生效:
# ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="https://api.codegateway.dev"
export ANTHROPIC_AUTH_TOKEN="你的 API key"想临时切回官方订阅,把这两行注释掉、重开一个终端即可——两种模式的切换成本就是一行环境变量。
5.4 第四步:验证
在 Claude Code 里发一个最小请求(例如让它读一个文件),确认:
- 没有再出现订阅侧的 session / weekly limit 提示;
- 请求日志里能看到这次调用计入了按量扣费;
- 需要看实时费率时看 定价页。
如果排查的是 429 / 529 而不是会话限额,转到上一节链接的那篇限流文章。
六、成本怎么算:倍率、服务费和额度换算
以下数字均为线上定价页 2026-11-07 现值,费率随时可能调整,请以 定价页 当日展示为准。
- 消费倍率:官方刊例价 × 1.07x(平坦倍率,无阶梯)。倍率用来覆盖全球加速、高可用基础设施、API Key 管理等运营成本。
- 充值服务费:按充值面额收取 2%,入账面额不受影响。
- 支付手续费:另按 Stripe 费率收取,约 3.9% + $0.30 / 笔,结账页分项展示。
- 实付金额 = 充值面额 + 充值服务费 + Stripe 手续费。
按上表费率做一次算术推算(下例为按官方单价 × 1.07x 的换算,token 用量为假设值,非实测):
以 claude-sonnet-5-5 为例,官方输入 $2.00 / MTok、输出 $10.00 / MTok,对应站内实价输入 $2.14 / MTok、输出 $10.70 / MTok(缓存读写另按各自费率计费)。
假设某次会话窗口内实际消耗 20 万输入 tokens + 2 万输出 tokens:
- 输入:0.2 × $2.14 ≈ $0.43
- 输出:0.02 × $10.70 ≈ $0.21
- 合计约 $0.64(未计缓存读写,也未计充值时的 2% 服务费与 Stripe 手续费)
同样的算法可以套在任何一次实际用量上。充值面额换算的参考(按 1.07x 折算):
- $10 面额 ≈ 4.67M 输入 tokens,或 ≈ 0.93M 输出 tokens
- $50 面额 ≈ 23.4M 输入 tokens,或 ≈ 4.67M 输出 tokens
充值档位是预付费余额,不是订阅套餐:没有月费,余额不过期,用多少扣多少。退款规则以 充值与计费说明与 退款政策 为准,倍率与分档的说明见 阶梯倍率详解。
七、常见问题
Q:撞了 5 小时限额,换个模型继续不行吗?
A:分情况。撞的是 session / weekly limit(订阅席位额度,跨模型共享)时,换模型没有任何用,官方文档明确写了这一点。撞的是 Opus / Sonnet 专属限额时,换到该模型家族之外的模型可以继续工作。用 /usage 看用量构成有助于判断你撞的是哪一条。
Q:5 小时窗口是每天重置一次吗?
A:不是。它是滚动的每五小时重置一次的会话窗口,重置点取决于你何时开始消耗,不是自然时段。
Q:套餐自带额度用完了,还能继续写代码吗?
A:可以。官方提供的路径是 usage credits——开启后请求会转成按量计费并继续工作,按标准 API 价计费,直到达到你设置的月度支出上限。另一条路是走按 token 计费的 API 通道,本文第五节写的是后者。
Q:按量计费是不是就「无限量」了?
A:不是。按量计费同样按 token 扣费,账户可用额度用完为止;它只是把额度从「每五小时发放一次的席位窗口」换成「账户余额里的可用额度」,不存在会话窗口重置这一层。计费规则和退款规则与订阅无关,可在 定价页 核对。
Q:延迟和稳定性会不会比官方差?
A:这条我们不打算用形容词回答。延迟、可用性和错误率请看 真实成本与可靠性数据 与 状态页;倍率口径在 定价页。
Q:Claude Code 的 base_url 要怎么配才不影响别的工具?
A:Claude Code 认 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量,按项目或按 shell 配置都行。只想临时切一次,就在当前终端 export 完直接跑;想长期切换,写进 shell 配置文件。想从零把 Claude Code 装起来,可以看 Claude Code 快速上手 与 不用 Anthropic 官方 key 接入 Claude Code。
八、相关资料
- Claude API 限流详解:429 / 529 怎么读、怎么退避 —— API 侧限流,与本文的订阅会话窗口不是一回事
- 定价页:固定倍率与完整费率
- Claude API 充值页:面额、到账额度与订阅比价
- 阶梯倍率详解
- 充值与计费说明
- Claude Code 快速上手
九、出站参考
- Anthropic 帮助中心:Manage usage credits for paid Claude plans —— 五小时会话限额、每周限额、usage credits 的官方口径
- Claude Code 文档:Claude Code costs —— 会话限额与模型专属限额的区分、
/usage、/usage-credits、自动等待续跑 - Claude Code 文档:Interactive mode —— 等待限额重置的操作说明
- Anthropic 定价页 —— 官方刊例价
口径说明:本文中 Anthropic 侧的规则与引用均按官方文档与帮助中心 2026-11-07 的表述整理;CodeGateway 侧倍率为 1.07x、充值服务费 2%,为线上定价页 2026-11-07 现值,调整后请以 定价页 当日展示为准。
