Claude · 教程

Claude Code 额度怎么算?5 小时窗口、周限额与 Pro / Max 差别

Claude Code 提示 usage limit 是怎么回事?讲清 5 小时窗口和周限额怎么算、Pro / Max 5x / Max 20x 差多少、达到上限后的几种选择、怎么省额度,以及何时该升档或改走 API。

更新于 2026年10月22日

额度是怎么算的:两层限制

用订阅账号登录的 Claude Code 没有”每月多少次”这种算法,而是两层同时生效的滚动额度:

层级周期说明
会话额度(session)每 5 小时重置档位之间的 5 倍、20 倍指的就是这一层
周限额(weekly)每周固定时间重置所有模型共用,重置时间按账号分配

每一次请求会同时计入这两层。所以会出现这样的情况:5 小时窗口刚刷新,却因为本周总量用完而继续被拦。

此外还有三点容易被忽略:

  • 网页版和终端共用一份。 官方 Claude Code 与 Pro / Max 套餐说明 写明,claude.ai 和 Claude Code 里的全部活动都计入同一份额度。
  • 可能有按模型系列的单独上限。 报错里出现 Opus limit 或 Sonnet limit 时,只限制该系列模型。
  • 官方不公布条数。 能发多少条取决于消息长度、附件、当前对话长度、所用模型和功能。Anthropic 还保留按容量情况调整限制的权利。

所以本文不会给你”Pro 每 5 小时 X 条”这样的数字,那种数字没有官方出处,而且很快会过期。

Pro / Max 5x / Max 20x 差多少

ProMax 5xMax 20x
官方价$20/月$100/月$200/月
每个 5 小时会话的用量基准Pro 的 5 倍Pro 的 20 倍
周限额有有,更高有,更高
周限额具体倍数—官方未公布官方未公布
Claude Code包含包含包含
适合轻中度、偶尔写代码每天写代码长时间 Agent、多任务并行

倍数出自官方 Max 套餐说明:5 倍和 20 倍指的是每个会话的用量。周限额只说”适用于所有模型、每周固定时间重置”,没有写倍数。免费账号不包含 Claude Code。

各档位在模型和功能上的完整对比,见 Claude Pro 和 Max 的区别。

提示达到上限是什么意思,怎么办

终端里常见的几种提示含义不同,处理方式也不同。以下报错原文来自官方 错误参考文档:

提示含义怎么办
You've hit your session limit · resets 3:45pm5 小时会话额度用完等到提示的时间;换模型无效
You've hit your weekly limit · resets Mon 12:00am周限额用完等每周重置,或开启用量额度、升档
You've hit your Opus limit / Sonnet limit该模型系列的单独上限/model 换到另一个系列可继续
API Error: Repeated 529 Overloaded errors服务端繁忙,不是你的额度稍后重试,或换模型
Request rejected (429)API Key 或云平台的速率限制/status 确认当前用的是哪种凭证
Credit balance is too low走的是 API 计费且余额不足多半是误用了 API Key,见下文

撞到订阅额度上限后,官方给出的选择有四个:

  1. 等重置。 报错里写了恢复时间,/usage 也能看到两层额度的进度条和重置时间。新版本的 Claude Code 支持等额度恢复后自动继续被打断的任务。
  2. 开启用量额度(usage credits)。 Pro 和 Max 可以在 Settings → Usage 里预充值,超出套餐的部分按标准 API 价格计费,可以设置每月上限。终端里运行 /usage-credits 会打开这个页面。
  3. 升档。 官方在 Pro 之上还有 Max 5x / 20x,但本站的 Max 代充已停售,升档需要海外卡在官网完成。
  4. 改走 API。 用 Console 账号按量付费,和订阅额度无关。

需要提醒的是:用量额度按 API 标准价计费,单价明显高于订阅内的额度。偶尔救急合适;如果每周都要买,升档更划算。

怎么查看还剩多少额度

不用等到报错才知道额度见底,有三个地方可以随时看:

  • 终端里运行 /usage:显示 5 小时会话和每周额度的进度条、各自的重置时间,以及下一节会讲到的用量归因明细。
  • 网页 Settings → Usage:同样的两条进度条,这里还能管理用量额度和月度上限。
  • 状态栏:可以把上下文占用配置到 Claude Code 的状态栏里持续显示,方便判断什么时候该清理会话。

官方偶尔会给符合条件的订阅用户发放一次”限额重置”(limit reset),可以把会话额度或周限额立即恢复到满额。它有使用期限,用了不能撤销,而且目前只能在网页或桌面端的 Usage 页面点击领取,终端里没有这个按钮。有没有、什么时候发,都由官方决定,不能当成固定权益来规划。

另外要分清两个概念:/usage 里显示的美元金额是按 API 标价估算的会话成本,主要给 API 用户参考;订阅用户不会因此被扣钱,真正要看的是那两条进度条。

额度为什么掉得这么快

Claude Code 比聊天费额度,原因在于它的工作方式。按官方 成本管理文档 的解释,主要是这些:

  • 上下文越长,每一轮越贵。 每次请求都会带上完整对话;Claude 每调用一批工具,又是一次带着全部历史的请求。一个开了一整天的会话里问一句话,消耗的是整段历史。
  • 缓存过期。 订阅用户的提示缓存有效期约一小时。离开超过这个时间再回来,第一条消息要重新处理全部上下文。
  • 子代理和并行任务。 每个子代理都有自己的请求;Agent teams 的用量大致和成员数量成正比。
  • 定时任务。 /loop 之类的任务即使你不在,也会按间隔带着完整上下文运行。
  • 模型选择。 Opus 比 Sonnet 消耗大得多。
  • 压缩本身也要花额度。 /compact 需要读完它要总结的对话。

想知道自己的额度花在哪,运行 /usage:订阅用户能看到按技能、子代理、插件、MCP 服务器归因的占比,以及”长上下文""缓存未命中”这类占比超过 10% 的行为提示。注意这份明细是按本机会话记录估算的,不包含其他设备和网页版的用量。

怎么省额度

下面的做法都出自官方文档,按效果从大到小排:

  1. 换任务就 /clear。 这是最有效的一条。无关的旧上下文会在之后每一条消息里重复计费,而 /clear 本身不花额度。
  2. 日常用 Sonnet,难题再切 Opus。 用 /model 随时切换;简单的子代理任务可以指定更小的模型。
  3. 提需求要具体。 “改进这个项目”会触发大范围扫描;“给 auth.ts 的登录函数加输入校验”只读必要的文件。
  4. 复杂任务先用计划模式。 按 Shift+Tab 切到 plan mode,确认方向后再动手,避免做错重来。
  5. 发现跑偏立刻按 Esc。 及时打断比事后返工便宜得多。
  6. CLAUDE.md 保持精简。 它每次会话都会完整加载,官方建议控制在 200 行以内,专项流程挪到按需加载的 skills 里。
  7. 关掉不用的 MCP 服务器。 用 /context 看是什么占了上下文,用 /mcp 停掉暂时不用的。
  8. 把刷屏的操作交给子代理。 跑测试、读日志这类输出很长的操作放进子代理,主会话只收摘要。
  9. 简单任务降低推理强度。 用 /effort 调低;部分模型的扩展思考无法关闭。
  10. 长时间离开后回来,优先从摘要恢复。 Pro 和 Max 在恢复大会话时会提示这个选项。

什么时候升档,什么时候走 API

你的情况建议
一周撞一两次会话上限,等一会儿就能接受留在 Pro,按上一节调整习惯
一周多次撞会话上限,影响工作节奏官方建议升 Max 5x;本站已停售,可先开用量额度或改走 API
在 5x 上仍然经常撞周限额,或长期并行多个任务官方建议升 Max 20x;本站已停售
偶尔一次超量,平时够用开用量额度,设一个月度上限
用量很不规律,或要接进 CI、脚本API 按量
团队多人使用,需要统一管理和核算官方 Team / Enterprise 或 API(需在官网自行订阅,本站不提供)

关于订阅和 API 的取舍,官方文档给了一个参考:企业部署中,每位开发者每个活跃日的 API 成本平均约 13 美元,九成用户低于 30 美元。每天都在用的人,订阅通常更省;一个月只用几天的人,API 更灵活。

有一个坑要单独说:如果系统里设置了 ANTHROPIC_API_KEY 环境变量,Claude Code 会用这把 Key 走 API 计费,而不是你的订阅额度。出现”订阅明明还有额度却在扣 API 余额”时,运行 /status 确认当前凭证,详细处理见 Claude Code 安装与登录。

国内怎么升档

升档和开通一样,卡在付款上:官方只接受海外发行的卡。本站与成交站的 Claude Max 代充已停售,目前只提供 Claude Pro,开通方式见 Claude Pro 充值 和 Claude Code 充值,停售说明见 Claude Max 页。需要 Max 的只能用海外卡在官网自行订阅。

如果你同时在比较其他编程工具的额度,可以看 开发者选购指南。另外提醒一句:达到使用上限只是额度问题,和封号无关;真正的账号停用是另一回事,见 Claude 账号被封怎么办。

常见问题

Claude Code 的额度多久恢复?
有两层。会话额度每 5 小时重置一次;周限额每周在一个固定时间重置,这个时间按账号分配。报错信息里会直接写明恢复时间,也可以在终端运行 /usage 或到网页 Settings 的 Usage 页面查看。
Pro 跑 Claude Code 一个窗口能发多少条?
官方不公布固定条数。消耗取决于模型、上下文长度、读了多少文件、调用了多少次工具。任何写死数字的说法都只能当参考,以 /usage 里的进度条为准。
Max 20x 的周限额也是 Pro 的 20 倍吗?
官方文档只写明 Max 5x 和 20x 是 Pro 每个会话用量的 5 倍和 20 倍,周限额的具体倍数没有公布,不能直接按 20 倍推算。
网页版聊天会占用 Claude Code 的额度吗?
会。同一个订阅账号下,claude.ai、桌面端和 Claude Code 共用同一份额度,任何一边的消耗都计入同一个 5 小时窗口和周限额。
撞到上限后换模型有用吗?
看提示。如果是某个模型系列的单独上限(例如 Opus limit),用 /model 换到别的系列可以继续;如果是 session limit 或 weekly limit,所有模型共用,换模型没用。
529 Overloaded 是额度用完了吗?
不是。529 是服务端整体繁忙,不计入你的额度,稍后重试或换一个模型即可。