Home/Wiki Errors/Claude Code
Claude Code / Provider outage

API Error: Repeated 529 Overloaded errors - Claude Code

Claude Code reached the model service, but the provider is overloaded, timing out, or returning a transient server error.

Claude Code 529 overloadedClaude Code internal server errorClaude Code request timed out
Paste an error to match it against the wiki. / 粘贴报错后自动匹配。

Error text / 报错原文

  • API Error: Repeated 529 Overloaded errors
  • API Error: 500
  • Internal server error
  • Request timed out

What it means

Claude Code reached the model service, but the provider is overloaded, timing out, or returning a transient server error.

Most common causes

  • Regional or model-specific provider incident
  • Very long request triggering slower routing
  • Network or proxy interruption during streaming
  • Auto mode selecting a temporarily unavailable model

Fastest fix

  • Retry after a short backoff
  • Switch model with /model
  • Reduce the request size and attached context
  • Check the provider status page before changing local config

Safe fix

  • Add retry/backoff to automation around headless runs
  • Keep a smaller fallback prompt for outage windows
  • Avoid making destructive file edits while the agent is intermittently failing
  • Record the exact timestamp and model for support

What not to do

  • Do not delete local auth when the error is 5xx or 529
  • Do not keep hammering requests in a tight loop
  • Do not assume every timeout is a broken MCP server

How to confirm the fix

Run the smallest reproducible command first, then retry the agent task only after authentication, quota, and tool discovery are stable.

claude doctor
curl -I https://status.anthropic.com || true
node --version

Related errors

Related tools

Sources