首页 › Claude Code › 错误 › 已达到用量限制
概览安装CLI 参考文档定价与限制Agent SDK技能与插件GitHub网页、桌面与 IDE模型错误是否开源?教程学生指南QA 自动化与 Cursor 对比与 Codex 和 OpenCode 对比子智能体钩子MCP生态系统VS CodeOpenRouter速率限制中文指南
最后更新:2026 年 11 月

已达到 Claude 使用上限:会话、每周和 Opus 上限、“指定的 API 使用上限”、“额度余额过低” — 以及应对方法

Claude 有三套独立的计量机制,而相关消息听起来很相似:Pro 和 Max 的订阅用量窗口(会话、每周、按模型);Anthropic 控制台的预付余额和支出限额;以及与任何人的配额都无关的服务器端限流。仔细阅读具体措辞,就能知道触发的是哪种限制,以及该等待、付费还是切换端点。

TLDR

  • You've hit your session limit · resets 3pm / 每周限额 / Opus 限额——属于订阅用量窗口;会自动重置,无需修复。
  • You have reached your specified API usage limits / credit balance is too low ——控制台计费:达到支出限额,或预付余额耗尽。
  • Usage credits are required for this model 出现在订阅中——所选模型或 1M 窗口不在套餐范围内;请选择其他模型。
  • Server is temporarily limiting requests (not your usage limit) ——服务器端限流;请等待,这与你的配额无关。

按计量机制分类的消息

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

使用优惠码 FIXIT 创建账户

常见问题

“您已达到指定的 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 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。

更多 Claude Code 指南

Claude Code 错误及修复方法Claude Code“API 错误:500”:含义及真正有效的修复方法Claude“过载”错误(API 错误 529):含义及应对方法Claude Code API 错误 400:提示词过长、工具使用并发问题及其他错误Claude Code OAuth 错误:超出 15000ms 超时时限,以及状态码 500“Claude Code 进程退出,退出码为 1”:如何找到真正的错误并修复Claude“提示词过长”“输入对于请求的模型而言过长”和“已达到上下文上限”:什么占满了窗口,以及如何释放空间Claude Code 401 和 403:身份验证凭据无效、API 密钥无效、“未登录”、host_not_allowedClaude Code 连接错误:ECONNRESET、响应中途连接丢失、“正在等待 API 响应”、“无法连接到 API”、SSL 证书错误Claude Code 挂起、卡住或停止响应:如何定位卡住的位置并恢复Claude.ai 无法正常使用:“出了点问题”、容量限制、“已达到 5 小时上限”、“登录时出错”及其他问题