截至 2026 年 10 月 8 日，Claude Code 有两套互不相干的限制。用 Pro、Max 或 Team 订阅登录时，拦住你的是订阅用量限制：一个每 5 小时重置的会话额度，加一个每周重置、所有模型共用的周限额；claude.ai 网页、Claude 桌面端和 Claude Code（终端与 IDE 插件）都从同一份额度里扣（Anthropic 帮助中心：用量限制如何计算）。用 Console API Key 或云厂商接入时，拦住你的是 API 速率限制：按组织层级计算的每分钟请求数和 token 数，超了返回 429（Claude API 速率限制文档）。
订阅额度到底有多少，Anthropic 没有公布条数、token 数或小时数，只公布了套餐之间的倍数。被打断时按这个顺序处理：
- 在 Claude Code 里运行
/usage，看 5 小时和每周两条用量条，以及各自的重置时间。 - 对照下面的报错原文，确认撞的是哪一种限制。
- 按类型选继续办法：等重置并让 Claude Code 自动续跑、开启额外用量、使用限额重置、换模型族（只对单模型限额有效）、升级套餐；API 用户则降低并发或提高层级。
Claude Code 报错原文对照：撞的是哪一种限制
终端里的提示原文是英文，判断类型只看前半句就够了。下表的报错文字与含义来自 Claude Code 错误参考，示例里的时间只是格式示意：
| 报错原文 | 撞的是什么 | 怎么继续 |
|---|---|---|
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 / You've hit your Sonnet limit | 只针对这一个模型族的限额 | 用 /model 换到另一个模型族就能继续 |
You've hit your monthly spend limit · raise it at claude.ai/settings/usage | 套餐额度用完，额外用量也到了你自己设的月支出上限 | 在设置 > 用量里调高上限，或等窗口重置 |
You've hit your individual spend limit / org's monthly spend limit / team's shared budget | Team 或 Enterprise 管理员设的支出上限 | 请管理员调高；/usage-credits 会向管理员发申请 |
API Error: Request rejected (429) | API Key、Amazon Bedrock 或 Google Cloud 项目的速率限制，不是套餐额度 | /status 确认当前凭据；降低并发；提高 API 层级 |
API Error: Server is temporarily limiting requests (not your usage limit) | 服务端短时限流，与你的额度无关 | 稍等重试；持续出现就看 status.claude.com |
API Error: Repeated 529 Overloaded errors | 服务整体过载，不计入你的额度 | 过几分钟再试，或用 /model 换模型 |
最容易判断错的是前两行：会话限额和周限额对所有模型生效，用 /model 从 Opus 换到 Sonnet 解决不了。只有提示里点名 Opus 或 Sonnet 时，换模型族才有用。529 的完整处理办法见 Claude 529 overloaded_error 是什么？怎么处理：先看报错来自哪一层。
Claude Code 额度是多少：官方只给倍数，不给条数
Anthropic 的套餐说明只用相对倍数描述额度，没有给出每 5 小时多少条消息、多少 token 或每周多少小时（Max 套餐说明）。一次请求实际消耗多少，取决于消息长度、附带的文件、对话已经有多长、用的模型和功能。
| 套餐（美国标价） | 每个 5 小时会话的额度 | 周限额 |
|---|---|---|
| Pro（$20/月） | 基准，记作 1 | 有，所有模型共用 |
| Max 5x（$100/月） | Pro 的 5 倍 | 有，倍数未公布 |
| Max 20x（$200/月） | Pro 的 20 倍 | 有，倍数未公布 |
| Team 标准席位 | Pro 的 1.25 倍 | 每个成员单独计算 |
| Team 高级席位 | Pro 的 6.25 倍 | 每个成员单独计算 |
两点容易被误读。第一，5x、20x 说的是每个会话的额度，Anthropic 没有说 Max 的周限额也是 Pro 的 5 倍或 20 倍，帮助中心还写明可能用每周、每月上限或按模型、功能等其他方式限制用量。第二，"Pro 每 5 小时约 45 条""每周 40–80 小时 Sonnet"这类具体数字不在 Anthropic 的任何公开文档里，拿它们估算自己还剩多少会出错；/usage 里的用量条才是你自己账号的读数。
Free 计划不包含 Claude Code，想先试用再决定的情况见 Claude Code 免费试用还有吗？2026 年现状、领取条件与下一步怎么选。Pro、Max 之间怎么选，Claude Max 和 Pro 限额差在哪？5x、20x 升级后仍有周上限 里有按月花费的比较。
Claude Code 每周限制是怎么计算的：两个窗口叠加
订阅用户同时受两个窗口约束，任意一个用完都会被拦：
- 5 小时会话额度：每 5 小时重置一次。终端提示里的
resets 3:45pm就是这个窗口的重置时间。 - 周限额：覆盖所有模型，每周在一个固定时间重置。这个时间是 Anthropic 分配给账号的，和你哪天开始订阅无关；下一次重置时间显示在 claude.ai 的设置 > 用量（Settings > Usage）里。
- 单模型限额：在上面两者之外，Opus、Sonnet 还可能单独触发
You've hit your Opus limit这类模型族限额。
所以"每周限制怎么算"的准确答案是：周限额按账号固定的重置时间滚动计算，网页聊天、桌面端和 Claude Code 的用量都计入；具体额度大小不公开，消耗速度主要由模型、上下文长度和工具调用决定。一周里前几天用得很猛，即使每个 5 小时窗口都还有余量，也可能先撞到周限额，这时只能等到周重置时间，或者用额外用量、限额重置继续。
2026 年 9 月的额度变化：周限额比促销前高 25%
今年 Claude Code 的周限额变过两次，5 小时额度也在 9 月有一次上调（Anthropic 帮助中心：5–8 月周限额促销）：
| 时间 | 变化 | 适用范围 |
|---|---|---|
| 2026 年 5 月 13 日 – 9 月 13 日 | Claude Code 周限额临时提高 50%，5 小时额度不变 | Claude Code 的周限额 |
| 2026 年 9 月 14 日起 | Claude Code 周限额永久比促销前高 25% | Pro、Max、Team、按席位计费的 Enterprise；Free 和按用量计费的 Enterprise 不含 |
| 2026 年 9 月 22 日 | Opus 5.5 发布，同时上调 5 小时额度，并给订阅用户发了一次限额重置 | Pro、Max、Team、按席位计费的 Enterprise |
如果你在 9 月中旬后感觉周限额"变少了"，原因是对比对象：促销期是促销前的 1.5 倍，现在是 1.25 倍，1.25 ÷ 1.5 ≈ 0.83，也就是比促销期低约 17%，但仍比促销前高 25%。9 月 22 日 5 小时额度上调了多少，Opus 5.5 发布公告 没有给出幅度。
Claude Code 额度怎么查看：/usage 和设置 > 用量
在 Claude Code 里：运行 /usage（别名 /cost、/stats）。Pro、Max、Team、Enterprise 订阅用户能看到 5 小时和每周的用量条、各自的重置时间，以及一份用量拆分（Claude Code 成本文档）：
- 用量分别来自哪些技能、子代理、插件和 MCP 服务器；
- 长上下文、缓存未命中这类行为占到近期用量 10% 以上时会被单独标出；
- 最耗额度的
/loop或定时任务； - 按
d、w在最近 24 小时和最近 7 天之间切换。
这份拆分只根据本机的会话记录估算，不包括其他电脑和 claude.ai 网页上的用量；顶部 Session 区块的美元金额是给 API 用户看的，对订阅计费没有意义。开启额外用量后，/usage 还会多出一行本月额外用量支出。
在网页或桌面端：claude.ai 的设置 > 用量显示同一份额度的剩余比例、周限额的下次重置时间、可用的限额重置，以及额外用量的开关和月支出上限。
确认走的是哪种计费：运行 /status 看当前生效的凭据。如果环境里设置了 ANTHROPIC_API_KEY 并被批准使用，Claude Code 会改用这把 Key，按 API 计费并受 API 速率限制，而不是用订阅额度（Claude Code 认证文档）。想回到订阅，执行 unset ANTHROPIC_API_KEY 后再用 /status 确认。
Claude Code 额度用完怎么办：五种官方办法
撞到订阅限额后，Anthropic 提供的继续办法只有下面几种。运行 /rate-limit-options 会列出当前可用的选项。
等待重置并让 Claude Code 自动续跑
Claude Code v2.1.234 及以上，用 claude.ai 订阅登录的交互式会话默认开启自动续跑：任务被额度打断后，会话底部显示 Continuing automatically at 3:45pm · esc to cancel，到点后 Claude 从中断处接着做，不会重发你的上一条消息（交互模式文档）。
使用时注意几点：
- 会话要保持打开；退出 Claude Code 后再恢复，等待不会重新开始。
- 重置时间在 24 小时以外（周限额常见）时，Claude Code 不会自动开始等待，需要在
/rate-limit-options里选 Wait here, then continue automatically。 - 续跑后如果马上又撞限，最多自动重来两次，之后停下并提示
Automatic continue stopped after repeated usage-limit hits。 - 按
Esc或在/rate-limit-options里选 Don't continue automatically 可取消。 - Claude 桌面端的 Code 标签页里对应的选项是 Auto-continue when limits reset。
使用限额重置（Reset for free）
Anthropic 会不定期给符合条件的套餐发放限额重置，用一次可以把 5 小时会话额度或周限额恢复满（什么是限额重置）。
- 只能在 claude.ai 网页或 Claude 桌面端的设置 > 用量里点 Reset for free 使用，Claude Code 终端、IDE 插件和手机端都不能用。
- 用了不能撤回；周限额照常按原定时间再重置一次。
- 没用掉的重置会在页面显示的日期过期；它也不会退还已经扣费的额外用量。
- 9 月 22 日随 Opus 5.5 发放的那次重置，据 Anthropic 员工发帖和应用内显示有效期到 2026 年 10 月 22 日，以设置 > 用量页显示的到期日为准；降级或取消订阅前没用掉就会作废。
发放次数和资格条件没有公开，设置 > 用量里看不到重置按钮，就是当前没有可用的重置。
开启额外用量，按 API 价格继续
Pro 和 Max 可以开启额外用量（usage credits），套餐额度用完后按 API 标准价继续计费，与订阅费分开结算（付费套餐的额外用量）：
- 在设置 > 用量开启，先充值（Add funds），可选自动续充；月支出上限可以设一个金额，也可以不设上限。每天最多兑换 $2,000。
- 在 Claude Code 里运行
/usage-credits会直接打开这个设置页；用 API Key 登录时没有这个命令。 - 预付折扣包：$45 买 $50 用量，$200 买 $250，$700 买 $1,000。
- 截至 2026 年 10 月 8 日的标准价（每百万 token，输入/输出）：Sonnet 5.5 $2/$10，Opus 5.5 $4/$20，Fable 5.1 $10/$50。
- 支出达到月上限而余额还有剩时，Claude Code 会在终端里提示你调高或取消上限，对应前面表格里的
monthly spend limit报错。
撞到 Opus 或 Sonnet 限额时换模型族
只有提示里点名 Opus limit 或 Sonnet limit 时，用 /model 换到另一个模型族才能继续，对话不会丢。Claude Code 里 opus 对应 Opus 5.5、sonnet 对应 Sonnet 5.5、haiku 对应 Haiku 5.5，opusplan 用 Opus 5.5 做规划、Sonnet 5.5 执行（模型配置文档）。各档模型的能力和价格差异见 Opus 5.5 和 Fable 5.1 怎么选？Claude 四档模型的价格与能力边界。
经常撞限：升级套餐
Pro 经常撞 5 小时额度，可以考虑 Max 5x（每个会话是 Pro 的 5 倍）；Max 5x 还不够再考虑 Max 20x。升级只放大套餐倍数，周限额依然存在，是否划算要拿你每月实际花在额外用量上的钱来比，具体算法见 Claude Max 和 Pro 限额差在哪？5x、20x 升级后仍有周上限。
第三方中转不能解决订阅限额
除了上面这些，Anthropic 没有提供其他越过套餐额度的办法。把 ANTHROPIC_BASE_URL 指向其他服务商后，请求根本不走你的订阅，费用、可用模型和限流规则都由那家服务商决定；它换掉的是计费渠道，不会让你的 Pro 或 Max 额度变多。
另外，中国大陆和香港不在 Anthropic 的支持国家和地区列表里。
API Key 用户的 429：RPM、ITPM、OTPM 按层级计算
用 Console API Key 运行 Claude Code 时，额度换成了按组织计算的三项每分钟上限：请求数（RPM）、输入 token 数（ITPM）和输出 token 数（OTPM），每个模型类别分开计算。截至 2026 年 10 月 8 日的标准层级（Claude API 速率限制文档）：
| 模型类别 | Start（RPM / ITPM / OTPM） | Build | Scale |
|---|---|---|---|
| Opus 5.5、Sonnet 5.5、Haiku 5.5（各自独立） | 1,000 / 2,000,000 / 400,000 | 5,000 / 5,000,000 / 1,000,000 | 10,000 / 10,000,000 / 2,000,000 |
| Fable 5.x | 1,000 / 500,000 / 100,000 | 2,000 / 1,500,000 / 300,000 | 4,000 / 4,000,000 / 800,000 |
| 每月支出上限 | $500 | $1,000 | $200,000 |
读这张表要注意：
- 新组织可能从更低的 Evaluation 层级起步，自己组织的实际上限以 Console 里的 Limits 页为准。
- 当前模型的缓存读取不计入 ITPM，提示缓存命中率越高，同样的 ITPM 能处理的上下文越多。
- 普通 429 会带
retry-after头，按它等待即可；因月支出上限触发的 429（enforced_spend_limit_reached）不带这个头，等多久都不会恢复，要提高上限或升级层级。 - 首次用 Console 账号登录 Claude Code 时会自动建一个名为 "Claude Code" 的工作区，它的流量计入组织总速率限制；可以在这个工作区的 Limits 页单独设上限，避免挤占生产服务。
在 Claude Code 里频繁遇到 429 时，先用 /status 确认用的是你预期的凭据，再降低并发：调低环境变量 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY、少开并行子代理，脚本化的大批量任务用 /model 换小模型。
Claude Code 额度为什么掉得快：长上下文、缓存失效和子代理
同样一句话，在开了一整天的会话里比在新会话里贵得多。Claude Code 成本文档 列出的主要原因：
- 长上下文：每次请求都会重发整段对话，工具调用的结果也会再发一次；会话越长，每个问题消耗越多。
- 缓存失效：离开超过缓存有效期后的第一条消息要重新处理全部上下文。订阅额度内缓存有效期是 1 小时，开始消耗额外用量后降到 5 分钟，API Key 默认也是 5 分钟。
- 后台任务：定时任务和
/loop在你没操作时也会按间隔带着完整上下文运行。 - 子代理和 Agent Teams：每个子代理单独发请求；队友在规划模式下运行时，Agent Teams 的 token 用量约为普通会话的 7 倍。
- 模型选择：Opus 每一轮的消耗是 Sonnet 的数倍，Sonnet 又高于 Haiku。从 v2.1.280 起，Pro 上
default解析为 Opus 5.5，从没手动选过模型的 Pro 用户其实一直在用 Opus。 - 非交互调用：
claude -p和 Agent SDK 同样从订阅额度里扣。
对应的省额度办法：
- 换任务时用
/clear开新会话（不耗额度）；同一任务中途用/compact压缩，但压缩本身也是一次大请求。 - 日常编码用
/model sonnet，只在复杂架构或多步推理时切回 Opus；子代理在配置里指定model: haiku。 - 简单任务用
/effort调低推理强度。 - 用
/mcp关掉不用的 MCP 服务器，能用gh这类命令行工具的就不用 MCP。 - 定期看
/usage的拆分，哪一项被标出占比超过 10%，就先处理哪一项。
Claude Code 额度相关问答
Claude Pro 额度是多少，有多少 token？
Anthropic 没有公布 Pro 每 5 小时或每周有多少 token、多少条消息，只说明了 Max 5x、Max 20x 每个会话分别是 Pro 的 5 倍和 20 倍。同一份额度能用多久，取决于模型、对话长度、附件和工具调用。想知道自己还剩多少，看 /usage 或设置 > 用量里的百分比。
"You've used 90% of your session limit" 是什么意思？
这是 5 小时会话额度的提醒：当前窗口已经用掉约九成，还没被拦。剩下的一成在长会话里可能几轮就用完。可以先把当前任务收尾，或者提前开启额外用量；真正撞限时，提示会变成 You've hit your session limit，并附上重置时间。
Claude Code 的并发限制是多少？
订阅套餐没有公布并发数量。同一账号开多个 Claude Code 会话、跑多个子代理都可以，但它们共用同一份 5 小时和每周额度，并行越多用得越快。用 API Key 时，限制是组织级的 RPM、ITPM、OTPM，同一组织下所有 Key 和工作区共享，并发过高就会收到 429。
换成 Sonnet 能解除周限额吗？
不能。会话限额和周限额覆盖所有模型，换模型不会恢复。只有提示是 You've hit your Opus limit 或 You've hit your Sonnet limit 时，换到另一个模型族才能继续。不过平时用 Sonnet 能让同一份周限额撑得更久。
Claude 529 overloaded 会扣我的额度吗？
不会。529 表示服务整体过载，Claude Code 已经自动重试过几次，这次失败不计入你的额度。过几分钟再试，或用 /model 换个模型（容量按模型分别计算）。持续出现时看 status.claude.com。
从 Pro 升级到 Max 后，本周额度会马上重置吗？
公开文档没有写升级会不会立即重置当前的 5 小时或周计数。升级费用按当期剩余天数折算。如果手里还有没用的限额重置，降级或取消订阅前先用掉，否则会作废。
