报 429 rate limit exceeded / concurrency limit exceeded 怎么解决

同一个问题的其他写法

• {"type":"error","error":{"type":"concurrency_limit_error","message":"User concurrency limit exceeded"}}
• {"type":"error","error":{"type":"rate_limit_error","message":"API Key token rate exceeded"}}
• exceeded retry limit, last status: 429 Too Many Requests

三种 429 的区别

CCSub 在转发请求之前会依次做三项检查，任何一项不通过都返回 HTTP 429：

• API Key request rate exceeded：限制的是单把 Key 每分钟的请求次数，默认 60 次 / 分钟，可以自己在 Keys 页面调整。
• API Key token rate exceeded：限制的是单把 Key 每分钟的 Token 速率，默认不限，只有你自己设置过才会出现。
• User concurrency limit exceeded：限制的是整个账号同时进行的请求数，默认 10 个，用户自己不能调整。

前两种的 error.type 是 rate_limit_error，第三种是 concurrency_limit_error。

每分钟请求数超了

计数方式是固定的 60 秒窗口：从这把 Key 的第一个请求开始算，60 秒内超过上限的请求直接返回 429，下一个窗口重新计数。Claude Code 一次操作除了主对话，还会发生成标题、后台小任务等额外请求；opencode、Cline 这类工具在执行工具调用时请求也很密集，默认的 60 次在高强度使用时可能不够。

处理方法：

1. 打开控制台的 API Keys，编辑这把 Key，在「速率限制」里打开「自定义速率限制」，调高「每分钟请求数（req/min）」。
2. 不同工具、不同项目分别用不同的 Key。速率是按 Key 单独计算的，分开后互不影响，也方便在使用记录里按 Key 看用量。
3. 自己写的批量脚本，给请求加上间隔或排队，收到 429 后等几秒再重试，不要立即重发。

Token 速率超了

只有你在 Keys 页面给这把 Key 设置过 Token 速率时才会出现。要注意它的计算方式：每个请求按请求体里声明的 max_tokens 累加，而不是实际消耗的 Token。Claude Code 每个请求的 max_tokens 常常是几万，如果你设了一个十几万的 Token 速率，每分钟可能只够几次请求。不需要限制的话，把 Token 速率留空即可。

账号并发超了

并发统计的是同一个账号下、同时在等待上游开始返回结果的请求数（非流式请求要等到完整结果返回）。账号下所有 Key 共用这个上限，所以多建 Key 不能绕开。容易撞到的场景：

• 同时开了好几个 Claude Code 或 Codex 窗口，每个都在跑任务；
• Claude Code 一次派出很多个并行子代理；
• 批量脚本、评测脚本用高并发打接口。

处理方法是降低并发：少开几个同时运行的会话，批量任务把并发数调到 10 以下。如果你的业务确实需要更高的并发，可以发邮件联系客服说明使用场景。

不同工具里长什么样

• Claude Code 会先自动重试，界面显示 Retrying in Ns · attempt x/10，重试耗尽后才显示 API Error: 429 ...。
• Codex 重试耗尽后显示 exceeded retry limit, last status: 429 Too Many Requests。
• 自己写代码：根据 error.type 区分，rate_limit_error 可以等到下一分钟再发，concurrency_limit_error 要等手上已有的请求返回后再发新请求。

常见问题

相关报错

• API Error: 402 {"type":"error","error":{"type":"insufficient_balance","message":"余额不足，请前往 https://www.ccsub.net/purchase 充值"}}账户可用余额不够，或月卡当天额度用完。看 message 是哪种：充值按量余额、等北京时间 0 点额度重置，或在余额本来够时等几分钟再试。
• API Error: 503 {"type":"error","error":{"type":"overloaded_error","message":"上游线路暂时不可用，请稍后重试（不是您账户余额的问题） | Upstream temporarily unavailable, please retry shortly (this is not about your account balance)."}}CCSub 已自动换线重试过，这次仍没有可用线路。等一两分钟在原会话里发「继续」，或用 /model 换个型号；不扣费，也不是你的余额问题。
• API Error: 504 {"type":"error","error":{"type":"timeout_error","message":"Upstream timed out"}}等上游的时间超过上限了。自己调用时改成流式（stream: true），上下文太长就 /compact，长输出拆成几次；偶发一次直接重试即可，不计费。