Claude Code

Overloaded 529 服务过载

报错原文

API Error: Overloaded (529) — overloaded_error

出现场景

长任务或高峰时段(尤其模型刚发布/大版本更新后)频繁中断, 报错后当前任务直接终止, 没有自动重试。

可能原因(按概率)

1. Anthropic 服务端整体负载过高, 官方模型容量不足
2. 本地网络抖动被误判成过载(常与真实 529 混淆, 需先排除代理不稳定)
3. Claude Code 客户端对 529 没有做退避重试, 一次失败就中断整个任务

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

1. 先确认不是代理问题: 直接 curl -x $HTTPS_PROXY https://api.anthropic.com 看是否连通正常
2. 手动重试, 官方目前对交互模式下 529 未做自动退避, 需要人工重新触发
3. 高峰期(工作日白天美西时间)提前避开或切到用量较低时段
4. 批量/脚本任务用 --print 模式配合 --fallback-model 指定降级模型, 交互模式该参数暂不支持
5. 频繁遇到可切换到有独立容量池的中转网关, 部分网关对 529 会自动切换上游节点重试