Source: https://aiprimetech.io/zh/claude-code/rate-limits/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › 速率限制

[概览](/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 速率限制错误：“API error: rate limit reached”的含义与解决方法

“API 错误：已达到速率限制”表示 Claude Code 向你展示了 API 返回的 HTTP 429。这不是程序缺陷，也不是计费问题：你在一个时间窗口内发送的请求超出了端点允许的范围，它也告诉了你何时可以再次请求。下面介绍你触及了哪种限制、为什么智能体会话会触及它，以及哪些方法确实能提高限制。

## TLDR
- 三种限制同时生效：每分钟请求数、每分钟 token 数、并发请求数。Claude Code 通常最先触及并发限制。
- 响应中包含 retry-after；Claude Code 会自行退避重试。如果持续失败，请减少并行子智能体的数量。
- 在 Anthropic 上，限制会随消费档位提高。在此网关上，新账户的初始限制较为保守，可申请提高。
- 529（“过载”）是另一种情况——模型对所有用户都已达到容量上限；请等待或切换档位。

## 具体错误消息及其含义 
- API Error: 429 {"type":"rate_limit_error", ...} / “已达到速率限制” ——你在该时间窗口内超出了请求数、token 数或并发数限制。请等待 retry-after.
- rate limit reached for <model> 并附有针对特定模型的说明——限制按模型分别设置；使用以下命令切换档位 /model 通常能立即奏效。
- “你已达到用量上限” / “限制将于……重置”——这不是速率限制，而是 Pro/Max 订阅的滚动用量上限。请等待重置，或使用 API 密钥。
- 529 overloaded_error ——这是容量问题，不是你的问题。请采用退避策略重试；错误指南对此有详细说明。
- 400 … tool use concurrency ——单轮中并行工具调用过多；这不是 429，但会出现在同类会话中。 

## Claude 速率限制：三种上限 

Anthropic 按模型、按组织实施每分钟请求数（RPM）、每分钟输入和输出 token 数（ITPM/OTPM）以及正在处理的并发请求数限制，并根据用量档位调整——随着累计消费增加，档位会自动提升。网关则按账户实施各自对应的限制。具体数值公布在 Anthropic 文档中，也会显示在你的控制台中；对 Claude Code 来说，关键的是并发数和 OTPM，因为智能体会话会持续发出耗时长、并行且输出量大的请求。 

## 为什么聊天客户端未触及限制，Claude Code 却会触及 

聊天客户端一次只发送一个请求。Claude Code 每轮都使用流式传输（在整个请求期间占用一个并发名额），并行运行子智能体（每个子智能体再占一个名额），并且每轮都会重新发送完整对话（每分钟 token 数随会话长度增加）。在大型仓库上运行十个子智能体，就意味着十路同时进行的流式请求，以及每分钟数十万 token——这就是 429。 

## 解决方法，按奏效频率排序 
- 1。让它重试。Claude Code 会遵循 retry-after；大多数 429 错误会在几秒内消失。
- 2。减少并行运行的子智能体；将繁重任务按顺序执行，而不是同时分派。
- 3. /compact ——上下文越小，每轮的 token 数就越少，这是调整 TPM 的手段。
- 4。使用以下命令为当前任务切换档位 /model ；限制按模型分别设置。
- 5。将后台任务交给 Haiku；主循环继续使用 Sonnet/Opus。
- 6。申请更高的限制：在 Anthropic 上，提高消费档位或联系销售申请；在此网关上，向支持团队发送电子邮件，说明你的账户和工作负载——新账户的并发限制起初较为保守，正是为了避免一个失控的智能体耗尽资源池，可申请提高。 

```
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20
```

## 此网关上的速率限制 

请求费用从余额扣除或计入固定费率套餐；速率限制按账户设置，与价格无关。网关汇集了多个上游账户，因此当其中一个账户触及某模型的 429，而另一个仍有余量时，会进行故障转移，而不会将错误返回给用户——这也是此处会话比使用单个控制台密钥遇到更少 429 错误的原因之一。你最可能触及的是并发限制；向支持团队说明你运行的并行智能体数量，即可调整。 

 | 计划 | 时长 | 价格

 | 1 小时不限量 | 1 小时 | $1

 | 24 小时不限量 | 24 小时 | $10

 | 1 周不限量 | 1 周 | $49

 | 15 天不限量 | 15 天 | $89

[所有不限量套餐 →](/zh/plans/)

## 先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚，之后可获得面值 7.69231 倍的额度。

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

[使用优惠码 CLAUDECODE 创建账户](/register?promo=CLAUDECODE)

## 常见问题

Claude Code 中的“API 错误：已达到速率限制”是什么意思？

这是一个 HTTP 429：你超出了该模型每分钟请求数、token 数或并发请求数的限制。Claude Code 会按 retry-after 等待后重试；如果问题持续，请减少并行子智能体并执行 /compact。Claude 有哪些速率限制？

包括每分钟请求数、每分钟输入/输出 token 数以及并发请求数，均按模型设置；在 Anthropic 上随用量档位调整，在网关上按账户设置。智能体会话容易触及并发数和输出 token 数限制。如何提高 Claude 的速率限制？

在 Anthropic 上：增加消费（档位会自动提升）或联系销售。在此网关上：向支持团队发送电子邮件，说明工作负载；可申请提高并发限制。“已达到用量上限”和速率限制是一回事吗？

不是。前者是 Pro/Max 订阅的滚动用量上限。速率限制按分钟计算，会自行解除；用量上限则按其既定时间表重置。

## 通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。 新账户：使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。[获取 API 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

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

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code CLI 文档：命令与参数](/zh/claude-code/cli/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code SDK，现已更名为 Claude Agent SDK](/zh/claude-code/sdk/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 子智能体：工作原理、定义方法与智能体团队](/zh/claude-code/subagents/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例](/zh/claude-code/mcp/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误](/zh/claude-code/vscode/)[如何在 Claude Code 中使用 OpenRouter（以及何时不宜使用）](/zh/claude-code/openrouter/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)