额度是怎么算的:两层限制
用订阅账号登录的 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 差多少
| Pro | Max 5x | Max 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:45pm | 5 小时会话额度用完 | 等到提示的时间;换模型无效 |
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,见下文 |
撞到订阅额度上限后,官方给出的选择有四个:
- 等重置。 报错里写了恢复时间,
/usage也能看到两层额度的进度条和重置时间。新版本的 Claude Code 支持等额度恢复后自动继续被打断的任务。 - 开启用量额度(usage credits)。 Pro 和 Max 可以在 Settings → Usage 里预充值,超出套餐的部分按标准 API 价格计费,可以设置每月上限。终端里运行
/usage-credits会打开这个页面。 - 升档。 官方在 Pro 之上还有 Max 5x / 20x,但本站的 Max 代充已停售,升档需要海外卡在官网完成。
- 改走 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% 的行为提示。注意这份明细是按本机会话记录估算的,不包含其他设备和网页版的用量。
怎么省额度
下面的做法都出自官方文档,按效果从大到小排:
- 换任务就
/clear。 这是最有效的一条。无关的旧上下文会在之后每一条消息里重复计费,而/clear本身不花额度。 - 日常用 Sonnet,难题再切 Opus。 用
/model随时切换;简单的子代理任务可以指定更小的模型。 - 提需求要具体。 “改进这个项目”会触发大范围扫描;“给 auth.ts 的登录函数加输入校验”只读必要的文件。
- 复杂任务先用计划模式。 按 Shift+Tab 切到 plan mode,确认方向后再动手,避免做错重来。
- 发现跑偏立刻按 Esc。 及时打断比事后返工便宜得多。
- CLAUDE.md 保持精简。 它每次会话都会完整加载,官方建议控制在 200 行以内,专项流程挪到按需加载的 skills 里。
- 关掉不用的 MCP 服务器。 用
/context看是什么占了上下文,用/mcp停掉暂时不用的。 - 把刷屏的操作交给子代理。 跑测试、读日志这类输出很长的操作放进子代理,主会话只收摘要。
- 简单任务降低推理强度。 用
/effort调低;部分模型的扩展思考无法关闭。 - 长时间离开后回来,优先从摘要恢复。 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 账号被封怎么办。