Source: https://aiprimetech.io/zh/claude-code/errors/usage-limit-reached/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › [错误](/zh/claude-code/errors/) › 已达到用量限制

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：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](https://github.com/anthropics/claude-code/issues/76272)，30 次回应，同一套餐的用户却有不同的重置日）。此外，即使没有可见的工作，用量计也可能变化： [#54750](https://github.com/anthropics/claude-code/issues/54750) 和 [#82506](https://github.com/anthropics/claude-code/issues/82506) 报告称，本地使用很少，会话用量却达到 100%，而 [#62466](https://github.com/anthropics/claude-code/issues/62466) （24 次回应）展示了一个循环，其中 image couldn't be processed API 错误耗尽了全部额度，却没有产生任何结果。如果空闲时用量仍在增加，请先检查后台会话、计划任务和重试循环，再判断计数器是否有误。 

## “此模型需要用量额度” 

这条消息最让订阅用户困惑，因为它会在套餐仍有配额时出现。它表示你选择的模型或窗口不在套餐范围内，需要使用额外的用量额度付费。 

最常见的触发原因是模型默认使用 1M token 的窗口： [#62052](https://github.com/anthropics/claude-code/issues/62052) 记录了一种显示为*已达到用量限制*的情况，实际原因却是 1M 上下文档位的访问限制，解决方法是在以下位置选择非 1M 变体： /model （或设置 CLAUDE_CODE_DISABLE_1M_CONTEXT=1). [#78610](https://github.com/anthropics/claude-code/issues/78610) （未关闭，49 次回应）汇集了一些报告：套餐*已包含*的模型也会出现该提示，有时用量跟踪器还会消失；这些情况与服务事故同时发生，因此购买任何额度前，请先查看 status.claude.com 并重试。 

## 控制台计费：“指定的 API 用量限制”和“余额过低” 

这些提示来自 API 密钥，而非订阅。*您已达到指定的 API 使用限额*指的是在 Anthropic 控制台（设置 → 限额）中为组织配置的月度支出限额；到达消息中注明的日期，或管理员提高限额后，即可恢复访问。*您的余额过低*表示预付余额已用完；API 采用预付费方式，因此充值前无法运行任何请求。这两种情况都不是故障，也都不会受以下操作影响： /compact、重启或重新安装。 

如果您在同一台机器上同时使用 API 密钥和订阅，请记住密钥优先：当环境中存在 ANTHROPIC_API_KEY 时，即使您以为自己在使用 Max，Claude Code 也会通过该密钥计费，这就是有些人触及了自己根本不知道存在的控制台限额的原因。 /status 会显示当前使用的是哪一种方式。 

## “服务器正在临时限制请求（并非您的使用限额）” 

括号中的说明已经解释了一切：Anthropic 在负载较高时从服务端限流，您的配额不受影响。 [#53915](https://github.com/anthropics/claude-code/issues/53915) （未关闭，68 条评论）是主要讨论帖；其中的抱怨与其说是针对限流，不如说是针对 Claude Code 会停止而不是重试，导致无人值守的会话中断。等待片刻，然后使用以下命令恢复： claude -c；对于长时间运行的任务，请设置 CLAUDE_CODE_RETRY_WATCHDOG=1 ，让客户端持续重试，并将其视为 [529 过载](/zh/claude-code/errors/overloaded-529/) ，而不是使用限额。 

## 继续工作：API 方式没有会话时间窗口 

订阅购买的是使用时间窗口，API 密钥购买的是 token。当时间窗口成为问题时——例如周二就用完了每周限额，或任务进行到一半触及 Opus 限额——实际可行的做法是将同一个 Claude Code 指向 API 端点，继续完成本周的工作。通过此网关使用时，密钥按 token 预付费，计费倍率见 [定价页面](/claude-code/zh/pricing/)，没有会话或每周重置限制，且首次加密货币充值可获得双倍到账金额（+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）又是另一种机制，详情见 [速率限制页面](/zh/claude-code/rate-limits/).

## 厌倦了与这个问题反复较劲？

改为通过 AI Prime Tech 网关运行 Claude Code：使用相同的 Claude 模型，由网关自己的上游账户提供服务，设置两个环境变量即可切换，新账户可获得 $5 免费 API 额度 使用优惠码 FIXIT — 无需银行卡。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[使用优惠码 FIXIT 创建账户](/register?promo=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 密钥](/register?promo=FIXIT) [查看不限量方案](/zh/plans/)

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。

## 更多 Claude Code 指南

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