故障排查 · 额度

看到 Claude usage limit reached 之后

截至 2026-11-09,Claude Code 里看到以 You've hit your 开头(session、weekly、Opus、Sonnet 限额)或以 Fable limit reached 开头的提示时,先看提示里的重置时刻,再选一条路:等重置;换别的模型(只对 Opus、Sonnet 与 Fable 限额有用);用 /usage-credits 开 usage credits;升级套餐。session 限额是 5 小时额度,周限额到账号的每周重置时刻恢复;Max 与 Ultra 计划的 Fable 另有单独的周限额。2026 年 10 月 30 日起,Anthropic 把 Max 5x 改名为 Max、Max 20x 改名为 Ultra,价格不变;已验证的 Ultra 账号没有 5 小时限制,所以它撞到的是周限额或 Fable 周限额(帮助中心与 Claude Code 错误文档 2026-10-26 抓取,2026-11-06 与 2026-11-09 复核)。也可以改用按 token 计费的 API 继续干活。

更新于 2026-11-10

一把 Key 调用 Claude、GPT 与主流国产模型,按 token 计费,几分钟上手。

#额度#5 小时窗#周额度#Claude Code

四个要点

5 小时

滚动窗

短周期限额,按滚动窗口计算,到点自动恢复,不需要联系任何人。

每周

周额度

更长周期的总量上限。撞到它时,5 小时窗恢复了也依然不能用。

按模型

Opus、Sonnet 与 Fable 限额

截至 2026-11-09,Opus 或 Sonnet 限额只管这个模型家族,用 /model 换到家族外的模型就能继续。Max 与 Ultra 最多可把周限额的 50% 用在 Fable 上,之后用 usage credits 继续或换模型。+50% 周额度加成 2026-05-13 至 2026-09-13,已结束,见下方时间线。

0 点 / 2 点

两个不同的重置时刻

这是 QCode 侧的口径:日限额按北京时间 0 点重置,加油包按次日凌晨 2 点单独重置。

这条报错到底在说什么

截至 2026-11-09,Claude Code 官方错误文档列出的套餐限额提示分别对应 session、weekly、Opus、Sonnet 限额,格式都是 You've hit your … limit · resets 加一个时刻(官方示例是 3:45pm 和 Mon 12:00am;2026-10-26 抓取,2026-11-09 复核),逐条解释见下文「先分清你撞的是哪一个」。

等重置期间界面底部显示 Usage limit reached · limit resets 加时刻。Claude Code 在重置时刻之前会拦下后续请求;session 与 weekly 两个限额对所有模型共用,换模型不能恢复,只有撞上按模型家族算的限额时,切到家族外的模型才还能继续。关键在于这个时刻:如果是几小时后,那多半是 5 小时滚动窗;如果是几天后,那是周额度。

两者都由 Anthropic 官方按订阅档位设定,和你的网络、客户端版本、API key 都没有关系。 Max 与 Ultra 计划另有 Fable 单独的周限额,撞到时的报错以 Fable limit reached 开头。Claude Code 里撞到 5 小时会话额度时,如果正好在回复中途,可能会多跑一小会儿把手头这一步做完,这时会看到 Usage limit reached · wrapping up。

这个 wrap-up allowance 很小、有上限,用量计入周限额,只适用于已经在进行的回复,不适用于撞限后再发的新消息;Pro 每个周限额周期最多一次,Max 每次撞到 5 小时会话额度都可能适用(仍在周限额内)。已验证的 Ultra 账号没有 5 小时限制,所以 wrap-up allowance 不适用;Ultra 账号还没被验证、仍有临时限制时,wrap-up allowance 与 Max 的规则相同,直到限制去掉。

官方说这个功能逐步推出,你的账号上可能还没有(帮助中心 11145838,2026-11-06 抓取)。开了 usage credits 之后看到 monthly spend limit 的提示,说明是你自己设的支出上限:在 Settings > Usage 调高。看到 temporarily limiting requests(括号里写明 not your usage limit)则是服务端的短时限流,不动你的额度:稍等再试(Claude Code 错误文档,2026-11-09 复核)。

官方现行口径与最近一条公告

帮助中心 15910845 一文 2026-09-20 抓取已是过去式:+50% 的加成 2026 年 5 月 13 日至 2026 年 9 月 13 日,并写明自 2026 年 9 月 14 日起标准周限额比促销前高 25%(Pro、Max、Team 与按席位 Enterprise;5 小时限额不在这条促销里)。2026-10-08 复核:该帮助中心文章未变;帮助中心发布说明最新一条曾为 2026-09-28(Claude Sonnet 5.5 发布),本次 2026-10-20 抓到最新一条为 2026-10-07:Claude Haiku 5.5 发布,Max 与 Team 套餐加上每月 API 额度。10 月以来没有新的官方周限额调整公告。

时间线

2026 年 5 月 13 日

帮助中心记载的周额度限时加成开始,同一条说明写明 5 小时限额不受这条促销影响。2026 年 8 月上旬起,公开讨论里大量开发者公开记录「几分钟烧掉大部分额度」的情况,多与并行线程和全库扫描相关。

2026 年 8 月 18 日

2026-08-18 帮助中心把 +50% 周额度加成延长至 2026-08-31,并提到产能紧张;该条是当时口径。加成最终到 2026-09-13 到期,官方说原本打算把周限额调回原水平,最后决定把其中一部分从 2026-09-14 起留下。

2026-09-14

帮助中心 2026-09-20 抓取是过去式:+50% 加成 2026-05-13 至 09-13,09-14 起标准周限额比促销前高 25%。从这一天起,一部分加成被永久留在 Claude Code 的标准周限额里,2026-10-20 复核这条未变。

先分清你撞的是哪一个

可以确认的

截至 2026-11-09,Claude Code 里的限额提示分别是这个意思(Claude Code 错误文档与帮助中心,2026-11-09 抓取)。一、"You've hit your session limit · resets 3:45pm":滚动 5 小时额度用完,所有模型共用;到提示里的重置时刻恢复。办法:等重置、运行 /usage-credits,或升级套餐;已验证的 Ultra 账号没有 5 小时限制。

二、"You've hit your weekly limit · resets Mon 12:00am":所有模型共用的周额度用完;周限额每周在分配给账号的固定时刻重置一次(看 /usage 或 Settings > Usage)。办法:等重置、运行 /usage-credits,或升级套餐,新套餐的额度立刻生效。三、"You've hit your Opus limit · resets 3:45pm"(或 Sonnet 同格式的提示):只限这个模型家族。

运行 /model 换成家族之外的模型就能继续,下一次请求会重读整段对话、没有缓存命中;错误文档没写这类限额的周期长度,以提示里的重置时刻为准。四、Fable 限额(Max 与 Ultra):最多可把周限额的 50% 用在 Fable 上,和其它模型从同一份周限额里扣。用到上限后,交互式会话里 Claude Code 会询问是用 usage credits 继续用 Fable,还是换回默认模型;没人回答这个确认提示时(Remote Control、后台或 agent team 会话),这一轮以 "Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent" 结束。

Pro 的 Fable 从一开始就走 usage credits。+50% 周额度加成到 2026-09-13 为止、已结束,日期见上方时间线。帮助中心现在写得更直白:付费套餐有两类用量限额——每 5 小时重置一次的 session 限额,和每周重置一次的周限额;你在 claude.ai、Claude Code 与 Claude Desktop 上的用量都算同一份额度。

Claude Code 的错误文档补了一句:一次用量会同时计入这两份额度。 2026-10-26 复核帮助中心、2026-11-06 再核:usage credits 按标准 API 价计费,可在 Settings > Usage 设每月支出上限;Max 与 Ultra 附送的每月 API 额度不能用于 usage credits。

官方没有给出的那部分

网上有说法称官方在额度紧张时把请求静默切换到更小或量化的模型,这个说法没有官方说明,公开讨论里也没有成规模的第一人称证据。被拒绝、被截断、被分类器拦下,与「换了小模型」是不同的现象。各套餐 session 与周限额的具体数值,官方没有公布:帮助中心的说法是能发多少条消息随消息长度、附件、当前会话长度与所用模型浮动,并保留为了容量与公平使用再设周封顶、月封顶或按模型与功能限流的余地。周限额按账户自己被分配的时刻每周重置一次,官方没有一张对所有账户统一的表;下一次重置时间写在 /usage 与 Settings > Usage 里。

两种限额的区别

5 小时滚动窗

短周期上限。到点自动恢复,恢复时刻就写在报错里。撞到它通常是短时间内密集使用造成的。

周额度

更长周期的总量上限。撞到它之后,等 5 小时窗恢复也没有用。官方现在给的出路是等重置、升级套餐(升级后新套餐的额度立刻生效),或者开启 usage credits,按 API 标准价继续干活。 usage credits 可在 Settings > Usage 设每月支出上限;Max 与 Ultra 的 Fable 周限额撞线时,同样是等重置、开 usage credits 或改用其它模型。

为什么有人几分钟就烧完

官方的 Claude Code 用量指南(2026-10-20 抓取)说,几乎所有「上午就把额度用完」的情况都出在同样的几个习惯上:任务之间不清上下文,以及用小模型就够的事却上最贵的模型。官方给的对策是按任务选模型——日常改动交给 Sonnet,真正难的问题再上 Opus,开始新任务前先 /clear;长时间不清的会话,每一轮都要把前面的内容重发一遍。

官方错误文档还写明,一次用量会同时计入 session 与周额度两份额度,一次大范围的多分支工作可能先把周额度烧完。在此之前的公开讨论里也能看到几个共同点:多线程并行跑、让模型扫描整个代码库、以及用最贵的模型做本来用小模型就够的任务;收紧任务范围、明确禁止大规模重构、把简单任务交给轻量模型,是社区里反复被验证有效的做法。

在 QCode 上:按 token 计费,不受订阅周额度约束

额度用完时先分清是哪一侧的额度:上面这些提示来自你的 Claude 订阅,而 QCode 的 API 按 token 计费,不受订阅周额度约束。QCode 这一侧,个人套餐按天给额度、30 天有效,当天不够可以买加油包。名下没有个人套餐、不想包月的,按量包 ¥26 起买一笔额度,7 天内用完为止;额度用完时请求返回 HTTP 402,到期后返回 HTTP 401。一把密钥覆盖 Claude、GPT 与 GLM、Kimi、DeepSeek、Qwen,各模型单价见 /models。

常见问题

怎么判断我撞的是 5 小时窗还是周额度?

在 Claude Code 里提示本身就写明了:写 session limit 的是 5 小时窗,写 weekly limit 的是周额度,写 Opus limit 或 Sonnet limit 的是单个模型家族的限额。再看报错里那个恢复时刻。几小时之后的一般是 5 小时滚动窗;几天之后的是周额度。这是最快也最可靠的判断方法。在 Claude Code 里也可以运行 /usage,它会列出你套餐的各道限额和各自的重置时刻。 如果报错以 Fable limit reached 开头,撞的是 Max 或 Ultra 计划单独给 Fable 的周限额。已验证的 Ultra 账号没有 5 小时窗,撞到的是周限额或 Fable 周限额;还没被验证的 Ultra 账号有临时限制,验证完成后自动去掉。

5 小时窗或周限额能自己重置吗?

只有拿到 limit reset 时才行(帮助中心说它偶尔发给符合条件的套餐);其余情况都会自动恢复,不需要找客服:5 小时窗到提示里的时刻恢复,周限额每周在分配给账号的固定时刻重置一次,两者都能在 /usage 或 Settings > Usage 看到。从 v2.1.234 起,用 claude.ai 订阅登录的交互式会话默认会在原地等着,到重置点自己接着跑。limit reset 用一次就把 5 小时额度或周限额(看它针对哪一个)立刻恢复满;周限额仍按它原来的日子重置,而终端和 IDE 里的 Claude Code 没有这个入口,要在网页或桌面端用。想在重置前继续干活,可以运行 /usage-credits 或升级套餐,新套餐的额度立刻生效。除此之外,任何声称能帮你「立刻解除官方限额」的说法都值得怀疑。

官方那个 50% 加成结束了吗?

结束了。帮助中心 2026-09-20 抓取、2026-10-08 与 2026-10-20 复核仍是过去式:促销 +50% 为 2026-05-13 至 2026-09-13;2026-09-14 起标准周限额比促销前高 25%。不要按 +50% 规划长期容量。

为什么改一个函数就把周额度烧掉一大截?

常见原因是模型超出了你给的范围:先扫全库、再质疑架构、顺手重构配置,最后才碰那个 bug。把任务范围写死、明确禁止大规模重构,通常能显著改善。

QCode 的额度也有 5 小时窗吗?

QCode 这一侧不按小时窗算。个人套餐是日额度,北京时间 0 点重置,30 天有效;当天不够用可以买加油包,加油包按北京时间次日凌晨 2 点单独重置——比日限额晚 2 小时,给跨零点赶工留出缓冲。按量包则是一笔总额度,7 天内用完为止,额度用完时请求返回 HTTP 402,到期后返回 HTTP 401。

换到 QCode 就不会再看到这条报错了吗?

用 QCode 密钥跑的请求不会再碰到它:这些请求不影响你官方订阅的额度,QCode 的 API 按 token 计费,不受订阅周额度约束;你的 Claude 订阅仍按它自己的限额和重置时刻走。QCode 的价值在于额度用尽时你有别的模型家族可以立刻切换。

信息来源

报错原文与限额规则:Anthropic 帮助中心 https://support.claude.com/en/articles/11145838、https://support.claude.com/en/articles/12429409、https://support.claude.com/en/articles/15424964、https://support.claude.com/en/articles/17007452、https://support.claude.com/en/articles/15910845;Claude Code 官方文档 https://code.claude.com/docs/en/errors;发布说明 2026-09-28(Sonnet 5.5)与 2026-10-07(Haiku 5.5);帮助中心 11647753、12429409、17007452 与发布说明 12138966。此前于 2026-09-20 抓取,2026-10-08 与 2026-10-20 复核,2026-10-26 再核;帮助中心 15910845 写 +50% 加成为 2026 年 5 月 13 日至 2026 年 9 月 13 日,2026 年 9 月 14 日起标准周限额比促销前高 25%。2026-11-06 另核对帮助中心 https://support.claude.com/en/articles/11145838 与 https://support.claude.com/en/articles/17728952(Ultra、wrap-up allowance 与已验证账号)与 Claude Code 错误文档 https://code.claude.com/docs/en/errors(报错原文)。2026-11-09 复核限额提示、等待横幅、Fable 确认提示与周限额重置:https://code.claude.com/docs/en/errors、https://code.claude.com/docs/en/interactive-mode、https://code.claude.com/docs/en/model-config 与帮助中心 11647753、15424964、17007452。2026 年 10 月的 QCode 口径以 https://docs.qcode.cc/docs/reference/payg-packs 与 https://qcode.cc/pay-as-you-go 为准。

额度用尽时,还能换一个模型家族继续干活

一把密钥覆盖多家模型;个人套餐用户额度不够时买加油包,没有套餐的买按量包,¥26 起,7 天内用完为止。

相关阅读

加密货币充值指南

9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。

官方限额与临时加成以 Anthropic 公告原文为准。帮助中心 2026-09-20 抓取、2026-10-08 复核均为过去式(促销 2026-05-13 至 2026-09-13,官方原文写明 2026-09-14 起标准周限额比促销前高 25%);09-14 起的这条 25% 口径,本页 2026-10-20 再核未变。模型可用性以 /models 为准。QCode 侧的日额度、加油包与按量包口径以本站定价页与文档为准。 2026-10-26 复核:付费计划有 5 小时会话额度与周额度,Max 另有 Fable 周限额;usage credits 按标准 API 价、可设每月支出上限。2026-11-06 再核:Max 与 Ultra 都另有 Fable 周限额,已验证的 Ultra 账号没有 5 小时限制。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79