按计量机制分类的消息
You've hit your session limit · resets 3pm
You've hit your weekly limit · resets Thu 9am
You've hit your Opus limit · resets Thu 9am
Usage credits are required for this model
Usage credits required for 1M context · run /usage-credits to purchase or /model to switch
You have reached your specified API usage limits. You will regain access on 2026-10-01 at 00:00 UTC.
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.
API Error: Server is temporarily limiting requests (not your usage limit) · Rate limited
订阅用量窗口(Pro / Max)
前三种属于套餐的滚动用量窗口:开启数小时后重置的会话窗口、每周窗口,以及顶级模型单独的每周窗口。它们按 token 而非消息计量,因此带有多个子代理的长时间代理会话,会比聊天快得多地耗尽窗口额度。 /usage 显示各项的当前用量; /stats 显示用量消耗在何处。无需修复,也无需重启:消息中包含重置时间。
这些窗口的两个问题引发了问题跟踪器中的大多数讨论。重置基准时间按账户固定,无法更改(#76272,30 次回应,同一套餐的用户却有不同的重置日)。此外,即使没有可见的工作,用量计也可能变化: #54750 和 #82506 报告称,本地使用很少,会话用量却达到 100%,而 #62466 (24 次回应)展示了一个循环,其中 image couldn't be processed API 错误耗尽了全部额度,却没有产生任何结果。如果空闲时用量仍在增加,请先检查后台会话、计划任务和重试循环,再判断计数器是否有误。
“此模型需要用量额度”
这条消息最让订阅用户困惑,因为它会在套餐仍有配额时出现。它表示你选择的模型或窗口不在套餐范围内,需要使用额外的用量额度付费。
最常见的触发原因是模型默认使用 1M token 的窗口: #62052 记录了一种显示为*已达到用量限制*的情况,实际原因却是 1M 上下文档位的访问限制,解决方法是在以下位置选择非 1M 变体: /model (或设置 CLAUDE_CODE_DISABLE_1M_CONTEXT=1). #78610 (未关闭,49 次回应)汇集了一些报告:套餐*已包含*的模型也会出现该提示,有时用量跟踪器还会消失;这些情况与服务事故同时发生,因此购买任何额度前,请先查看 status.claude.com 并重试。
控制台计费:“指定的 API 用量限制”和“余额过低”
这些提示来自 API 密钥,而非订阅。*您已达到指定的 API 使用限额*指的是在 Anthropic 控制台(设置 → 限额)中为组织配置的月度支出限额;到达消息中注明的日期,或管理员提高限额后,即可恢复访问。*您的余额过低*表示预付余额已用完;API 采用预付费方式,因此充值前无法运行任何请求。这两种情况都不是故障,也都不会受以下操作影响: /compact、重启或重新安装。
如果您在同一台机器上同时使用 API 密钥和订阅,请记住密钥优先:当环境中存在 ANTHROPIC_API_KEY 时,即使您以为自己在使用 Max,Claude Code 也会通过该密钥计费,这就是有些人触及了自己根本不知道存在的控制台限额的原因。 /status 会显示当前使用的是哪一种方式。
“服务器正在临时限制请求(并非您的使用限额)”
括号中的说明已经解释了一切:Anthropic 在负载较高时从服务端限流,您的配额不受影响。 #53915 (未关闭,68 条评论)是主要讨论帖;其中的抱怨与其说是针对限流,不如说是针对 Claude Code 会停止而不是重试,导致无人值守的会话中断。等待片刻,然后使用以下命令恢复: claude -c;对于长时间运行的任务,请设置 CLAUDE_CODE_RETRY_WATCHDOG=1 ,让客户端持续重试,并将其视为 529 过载 ,而不是使用限额。
继续工作:API 方式没有会话时间窗口
订阅购买的是使用时间窗口,API 密钥购买的是 token。当时间窗口成为问题时——例如周二就用完了每周限额,或任务进行到一半触及 Opus 限额——实际可行的做法是将同一个 Claude Code 指向 API 端点,继续完成本周的工作。通过此网关使用时,密钥按 token 预付费,计费倍率见 定价页面,没有会话或每周重置限制,且首次加密货币充值可获得双倍到账金额(+50%)。订阅额度重置后,取消设置密钥即可切回订阅。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude # billed per token, no session or weekly window
每分钟速率限制(429)又是另一种机制,详情见 速率限制页面.
厌倦了与这个问题反复较劲?
改为通过 AI Prime Tech 网关运行 Claude Code:使用相同的 Claude 模型,由网关自己的上游账户提供服务,设置两个环境变量即可切换,新账户可获得 $5 免费 API 额度 使用优惠码 FIXIT — 无需银行卡。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key常见问题
“您已达到指定的 API 使用限额”是什么意思?
您已达到 Anthropic 控制台中为组织设置的月度支出限额。到达消息中注明的日期,或管理员提高限额后,即可恢复访问。此限额适用于 API 密钥,不适用于 Pro/Max 订阅。
为什么我已有订阅,Claude 仍提示需要使用额度?
您选择的模型或 1M 上下文窗口不在套餐覆盖范围内。在 /model 中选择非 1M 版本或其他模型;如果套餐内的模型也出现此提示,请查看 status.claude.com,已有多起报告与服务故障同时出现。
如何解决 Claude Code 中的“余额过低”提示?
您正在使用的 API 密钥已耗尽预付余额。请在控制台充值,或取消设置 ANTHROPIC_API_KEY,改用订阅账号登录。
“服务器正在临时限制请求(并非您的使用限额)”会占用我的限额吗?
不会。这是负载较高时的服务端限流。稍等后使用 claude -c 恢复;无人值守运行时设置 CLAUDE_CODE_RETRY_WATCHDOG=1,让会话重试而不是停止。
达到每周限额后,如何继续使用 Claude Code?
使用 ANTHROPIC_API_KEY 将其指向 API 端点;API 使用按 token 计费,没有会话或每周时间窗口。订阅额度重置后再切回即可。
通过网关运行 Claude Code
相同的模型,两个环境变量,面值 7.69231 倍的额度,或固定费率不限量方案。 新账户:使用优惠码 FIXIT 可获得 $5 免费 API 额度。
获取 API 密钥 查看不限量方案AI Prime Tech 是独立的 API 网关,与 Anthropic 无关联,也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。