TL;DR
Claude API 限流分三层:RPM(每分钟请求数)、TPD(每日 token 配额)、并发连接数。触发后返回 HTTP 429,附带retry-after秒数。本文实测各层限制、给出错误处理代码,并解释通过 CodeGateway 接入如何平滑接触这三类限制。
一、为什么会被限流?
Anthropic 对 Claude API 设置了四层独立的访问限制:
RPM:每分钟最多发送多少次请求,触发 429 rate_limit_error
TPD(输入/输出):每日 token 配额上限,触发 429 或 529 overloaded_error
并发:同时在途的最大请求数,触发 529 overloaded_error
这四个维度相互独立——RPM 没超,但并发超了一样返回错误。
实测背景:在 CodeGateway 的后台日志里,90% 以上的限流出现在批量任务(一次性并发发 10+ 请求)和流量高峰两个场景。单用户正常使用几乎不会触发。
二、Anthropic 官方限制档位(2026 年)
Anthropic 按 Tier 1–5 划分限制,新账号从 Tier 1 开始,累计消费后自动升级。
Tier 1(新账号):RPM 50,输入 TPD 5M,输出 TPD 100K
Tier 2(累计 $40):RPM 1,000,输入 TPD 40M,输出 TPD 400K
Tier 3(累计 $200):RPM 2,000,输入 TPD 200M,输出 TPD 2M
Tier 4(累计 $2,000):RPM 4,000,输入 TPD 1B,输出 TPD 10M
数据来源:Anthropic 官方限流文档(2026-05),具体数字随 Anthropic 策略调整。
