Claude Code

429 Too Many Requests 限流

报错原文

API Error: Request rejected (429) · Rate limited / Number of concurrent connections has exceeded your rate limit

出现场景

并发开多个 session 或子代理(subagent)时报错, 部分场景是刚启动就报, 有的是用量面板明明还有额度也照样报。

可能原因(按概率)

1. 单个组织下所有 API Key 和会话共享同一限流池, 并行开多个窗口是在瓜分同一份额度而非叠加
2. 启动阶段客户端并发打了多个初始化请求导致瞬时触发限流
3. 实际是 529 过载被错误展示成 429(客户端展示层 bug)

修复步骤(从最简单的开始)

1. 减少同时运行的 Claude Code 会话/子代理数量, 串行执行
2. 稍等几十秒到几分钟后重试, 不要立刻连续重试(会加剧限流)
3. claude /status 查看实际用量面板, 确认是否真的到额度上限还是展示误报
4. 用量确实经常触顶的账户, 联系 Anthropic sales 申请提额, 或改用有独立并发池的多账号/中转方案分摊负载