Claude Code 529 overloaded_error 修复

Claude Code 提示 API 过载（529 overloaded_error）时，通常是上游服务暂时繁忙。与 401/429 不同，529 一般不是你的配置问题，按本文等待并调整节奏即可。

错误表现

请求被拒绝，提示服务暂时过载，例如：

Error: overloaded_error
529: overloaded

错误含义

HTTP 529 overloaded_error 表示API 暂时过载：上游服务在所有用户中遇到高流量，暂时无法处理更多请求。

最常见原因

• Anthropic API 全局流量高峰
• 组织/账户短时间内使用量急剧增加
• 上游服务正在维护或波动

macOS / Linux 修复步骤

1. 等待片刻后重试（过载通常是暂时的，几分钟内恢复）。
2. 避免瞬时流量激增：逐步增加使用量，保持一致的调用模式。
3. 检查 ModelGate 公开状态页 是否有上游波动通知。
4. 若持续出现，可在 ~/.claude/settings.json 中降低默认模型档位，减轻上游压力。

Windows 修复步骤

1. 等待片刻后重试，不要连续快速点击重发。
2. 检查 ModelGate 公开状态页 的公告。
3. 关闭非必要的会话，只保留正在使用的窗口。
4. 若持续，改用较低的模型档位（如 Sonnet 替代 Opus）。

curl 验证

# macOS / Linux
curl -i https://modelgate.app/v1/messages \
  -H "x-api-key: 你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

# Windows PowerShell
curl.exe -i https://modelgate.app/v1/messages `
  -H "x-api-key: 你的Key" `
  -H "anthropic-version: 2023-06-01" `
  -H "content-type: application/json" `
  -d '{"model":"claude-sonnet-4-6","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

• 返回 529 → 上游过载，等待重试即可，与你的配置无关。
• 返回正常 → 说明已恢复，重启 Claude Code 继续使用。

ModelGate 示例

重试时建议使用指数退避：第 1 次等 5 秒，第 2 次等 30 秒，第 3 次等 2 分钟，避免加重过载。

检查清单

• 已查看 ModelGate 状态页 确认上游状态
• 已等待数分钟再重试，而非连续点击
• 已逐步增加使用量，避免瞬时激增
• 持续 1 小时以上未恢复时联系 ModelGate 管理员

相关教程

• Claude Code 常见报错排查 — 全部错误码速查
• Claude Code 接入教程 — 完整配置步骤
• 模型与计费说明 — 模型档位与计费规则