具体错误消息及其含义
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 |
先免费试用
新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚，之后可获得面值 7.69231 倍的额度。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key常见问题
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 密钥 查看不限量方案AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。