Agent Model Connector

限流 / 配额不足修复指南——Claude Code 与 Codex CLI

Claude Code 或 Codex CLI 接入 DeepSeek、OpenRouter 等服务商时遇到"限流 / 配额不足"的分步修复方法。

报错输出

429 Too Many Requests {"error":{"message":"Rate limit reached for requests"}}
常见变体
402 Payment Required {"error":{"message":"Insufficient Balance"}}
anthropic: Request failed with status 529: {"error":{"message":"Overloaded"}}

具体文本随 Agent 版本与服务商略有差异，以状态码和消息类型为准。

快速定位

状态码告诉你被哪一层限流：429 = 速率限制，402 = 余额不足，529 = 服务商过载。

Claude Code 
claude /status
Codex CLI 
codex exec "hi"

常见原因

  • 服务商限制了每分钟请求数，限流窗口尚未重置。
  • 账户余额用尽；部分服务商将其表现为 429 或 402。
  • 免费额度用尽（OpenRouter 免费模型）。
  • 长时间 Agent 会话在短时间内爆发大量请求。

按场景修复

1 长会话期间触发

  • 降低并行度：减少子代理或并发请求。
  • 长时间任务改用更便宜/更快的模型。
  • 重试之间加入小间隔，而不是密集打 API。

2 免费额度用尽

  • OpenRouter 免费模型约为每分钟 20 次、每天每模型 200 次请求。
  • 在多个免费模型之间轮换可延长免费使用。
  • 充值 $10 可提高每日免费上限。

3 余额相关拒绝

  • 充值账户；部分服务商将余额不足报告为 429 或 402。
  • 设置预算上限，避免失控会话耗尽余额。
  • 修改配置前，先到用量页面确认被拒绝的请求。

Agent 差异修复

Claude Code

修复
等待限流窗口结束、充值账户，或改用更便宜的模型。长会话中，把 CLAUDE_CODE_SUBAGENT_MODEL 设为便宜模型供子代理调用。
验证
窗口重置后重试 `claude /status` 和一条简短消息。

Codex CLI

修复
降低并行度（减少子代理）、改用更快的模型，或充值提升限额。
验证
到服务商后台确认被拒绝的请求，然后重试 `codex exec "hi"`。

Claude Code 与 Codex CLI 对照速查

Claude Code Codex CLI
状态码 429 / 402 / 529 429 / 402 / 529
余额检查 Provider dashboard Provider dashboard
子代理用便宜模型 CLAUDE_CODE_SUBAGENT_MODEL model in config.toml

避免复发

  • 在服务商后台设置预算上限。
  • 日常任务用便宜模型，把前沿模型留给难题。
  • 工作流中加入退避重试，而不是立即重试。

相关错误

超时 / 请求超时 401 未授权

相关接入指南

Claude Code 接入 DeepSeek 查看接入指南 Claude Code 接入 OpenRouter 查看接入指南 Codex CLI 接入 DeepSeek 查看接入指南 Codex CLI 接入 OpenRouter 查看接入指南

常见问题

OpenRouter 免费额度限制是什么？

免费模型约为每分钟 20 次、每天每模型 200 次请求。充值 $10 可提高每日免费上限。

529 算限流吗？

529 表示服务商过载，而不是你的密钥被限流。等待后重试；更换模型或端点通常有帮助。

全部排障指南