# Claude 529 overloaded error: what it means and what to do

Authors: AutoRouter
Author profile: https://autorouter.com/about
Published: 2026-11-16T21:47:00.000Z
Reading time: 8 min
Canonical: https://autorouter.com/blog/claude-529-overloaded-error
Part of: How to cut Claude Code and Codex costs (https://autorouter.com/blog/cut-claude-code-and-codex-costs.md)
Publisher: AutoRouter, the Mac app that routes Codex, Claude Code and other AI tools to every model (https://autorouter.com)

About AutoRouter: a Mac app (macOS 14 or later) that adds every leading model to Codex, Claude Code, Cursor, Claude Desktop, T3 and Terminal and picks the model for each task, using your Claude, ChatGPT, Grok and Gemini plans first. Install from https://autorouter.com/AutoRouter.dmg, or ask your agent to follow https://autorouter.com/setup.md. Routing across your plans is free; Pro is $50 a month with $20 of included usage. Unrelated to OpenRouter's Auto Router.

> A 529 `overloaded_error` means Anthropic's API is temporarily at capacity across all users, so the problem is on Anthropic's side and has nothing to do with your rate limit, usage limit or bill. Claude Code retries it up to 10 times with backoff before showing "Repeated 529 Overloaded errors"; when you see that, check status.claude.com, wait a few minutes, or run /model to switch models, because capacity is tracked per model.

## Key facts

- HTTP 529 with error type `overloaded_error` means the Claude API is temporarily overloaded; Anthropic says it can occur when the API has high traffic across all users ([Claude API errors](https://platform.claude.com/docs/en/api/errors), checked November 16, 2026).
- Claude Code retries 529s up to 10 times by default, with backoff starting at 500 ms and capped at 32 seconds, before it shows "Repeated 529 Overloaded errors" ([Claude Code error reference](https://code.claude.com/docs/en/errors)).
- A 529 is not your usage limit and doesn't count against your quota, and the Claude API bills only successful requests.
- Capacity is tracked per model, so switching with /model or a `--fallback-model` chain keeps work going while one model is overloaded.
- status.anthropic.com now redirects to status.claude.com, which lists the Claude API, claude.ai and Claude Code as separate components.

![A 529 means Anthropic is at capacity. A Claude request fails. The error is 529 overloaded_error: Anthropic is full: wait or switch; The error is 429 with retry-after: Your rate limit: slow down; The error is 429, no retry-after: Monthly spend cap: raise tier; The error is 500 api_error: Server fault: retry, then report. Source: Claude API errors and rate limits docs, checked November 16, 2026.](https://autorouter.com/blog/images/claude-529-overloaded-error/1-which-error.png)

A 529 error from Claude means Anthropic's API is temporarily at capacity across all users, so the fault is on Anthropic's side and has nothing to do with your rate limit, usage limit or credit balance. The API returns it as HTTP 529 with the error type `overloaded_error`, and Anthropic [describes it](https://platform.claude.com/docs/en/api/errors) as something that "can occur when the API experiences high traffic across all users" (as of November 16, 2026). Claude Code retries a 529 on its own before it shows you anything, so by the time you read "Repeated 529 Overloaded errors", the fix is to wait a few minutes, check [status.claude.com](https://status.claude.com), or switch to another model. AutoRouter, the Mac app for Codex and Claude Code, wrote this post.

## What does the Claude 529 overloaded error mean?

A 529 means the Claude API had no capacity for your request at that moment. It is one of the HTTP errors listed in [Anthropic's error reference](https://platform.claude.com/docs/en/api/errors), with a JSON body whose `error.type` is `overloaded_error` and a `request_id` you can give support. Anthropic's Claude Code docs say the API is ["temporarily at capacity across all users"](https://code.claude.com/docs/en/errors#api-error-repeated-529-overloaded-errors) when it happens, and that a 529 "is not your usage limit and doesn't count against your quota."

```json
{
  "type": "error",
  "error": {
    "type": "overloaded_error",
    "message": "..."
  },
  "request_id": "req_..."
}
```

529 isn't a standard HTTP status code, so check the `error.type` field as well as the number. On the Claude API you also aren't charged for it, because Anthropic [bills only successful API calls](https://support.claude.com/en/articles/8977456-how-do-i-pay-for-my-claude-api-usage) and says failed requests aren't charged.

## How is a 529 different from a 429 rate limit error?

A 429 is about your organization's limits and a 529 is about Anthropic's capacity for everyone. A 429 `rate_limit_error` means your organization went over a [rate limit](https://platform.claude.com/docs/en/api/rate-limits) (requests, input tokens or output tokens per minute), grew its usage too fast for its ramp limit, or reached its usage tier's monthly spend cap. Slowing down fixes a rate limit, and the response's `retry-after` header says how long to wait. A spend-cap 429 has no `retry-after` header and keeps failing until the next month or a higher tier, so retrying it never helps.

| Error                     | Type                                                | Whose problem                          | Does retrying help?                  | What to do                                          |
| ------------------------- | --------------------------------------------------- | -------------------------------------- | ------------------------------------ | --------------------------------------------------- |
| 529                       | `overloaded_error`                                  | Anthropic's capacity, for all users    | Yes, after a wait                    | Wait, check status, or switch models                |
| 429 with `retry-after`    | `rate_limit_error`                                  | Your organization's rate or ramp limit | Yes, after the `retry-after` seconds | Send requests more slowly, or ask for a higher tier |
| 429 without `retry-after` | `rate_limit_error` (`enforced_spend_limit_reached`) | Your usage tier's monthly spend cap    | No, until access resumes             | Request a tier increase in the Claude Console       |
| 400 naming a spend limit  | `invalid_request_error`                             | A spend limit you set                  | No                                   | Raise or remove your own limit                      |
| 500                       | `api_error`                                         | An unexpected failure inside Anthropic | Usually, with backoff                | Retry; report it with the request ID if it persists |

On a Claude subscription in Claude Code, a short throttle shows as `API Error: Server is temporarily limiting requests (not your usage limit)`, and reaching your plan's limit shows its own message with a reset time. [How Claude Code usage limits work](/blog/claude-code-usage-limits) covers those plan limits. Every row above comes from Anthropic's [errors](https://platform.claude.com/docs/en/api/errors) and [rate limits](https://platform.claude.com/docs/en/api/rate-limits) docs, checked November 16, 2026.

## What does Claude Code do when it gets a 529?

Claude Code retries a 529 up to 10 times with exponential backoff before it shows an error, according to its [error reference](https://code.claude.com/docs/en/errors#automatic-retries) (checked November 16, 2026). The first wait starts at 500 milliseconds and later waits are capped at 32 seconds. While it retries, the spinner shows a `Retrying in Ns · attempt x/y` countdown, and from the third attempt the line under it names the 529 and where to check service status. Only when every retry fails does Claude Code print `API Error: Repeated 529 Overloaded errors`.

![Claude Code retries a 529 up to 10 times. 1. Gets a 529 (The API is at capacity); 2. Wait, then retry (Backoff from 0.5 s to 32 s); 3. Up to 10 retries (Spinner counts each attempt); 4. Error shown (Repeated 529 Overloaded errors). Source: Claude Code error reference, checked November 16, 2026.](https://autorouter.com/blog/images/claude-529-overloaded-error/2-retries.png)

When one model is under particularly high load, Claude Code also suggests a switch, for example `Opus is experiencing high load, please use /model to switch to Sonnet`. Five environment variables change the retry behavior:

| Variable                                     | Default | What it changes                                                                 |
| -------------------------------------------- | ------- | ------------------------------------------------------------------------------- |
| `CLAUDE_CODE_MAX_RETRIES`                    | 10      | How many times Claude Code retries; lower it to fail faster in scripts          |
| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | 500     | The first wait after a 529, up to 32,000                                        |
| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`  | 32000   | The longest wait between 529 retries, up to 300,000                             |
| `CLAUDE_CODE_RETRY_WATCHDOG`                 | unset   | Set to `1` in unattended jobs to retry 429 and 529 capacity errors indefinitely |
| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`     | unset   | Caps how long each request waits out 429 and 529 errors with the watchdog on    |

The two overload delay variables need Claude Code v2.1.292 and v2.1.296 or later, and they have no effect when the watchdog is on. If you call the API from your own code, Anthropic's official SDKs [retry 5xx errors twice by default](https://platform.claude.com/docs/en/api/errors) with exponential backoff, and `max_retries` changes that.

## How do I fix a 529 overloaded error in Claude Code?

You can't fix a 529 on your side, but you can keep working while Anthropic recovers. Anthropic's own advice for a [repeated 529](https://code.claude.com/docs/en/errors#api-error-repeated-529-overloaded-errors) is to check the status page, try again in a few minutes, or switch models, since capacity is tracked per model.

1. **Check the status page.** Open [status.claude.com](https://status.claude.com), or the provider or gateway named in the error message if you don't use Anthropic's API directly.
2. **Wait, then send again.** Your message is still in the conversation, so for a long prompt you can type `try again` instead of pasting it.
3. **Switch models.** Run `/model` and pick another model, such as Sonnet when Opus is overloaded. The switch lasts until you change it back.
4. **Set a fallback chain.** Start Claude Code with `--fallback-model` so it moves to the next model on its own when the primary one is overloaded. The switch covers the current prompt only.
5. **For unattended jobs, wait it out.** Set `CLAUDE_CODE_RETRY_WATCHDOG=1` in CI so a 529 doesn't fail the run.

```bash
# Try Sonnet, then Haiku, when the main model is overloaded (up to three models)
claude --fallback-model sonnet,haiku

# Keep a CI run waiting through 429 and 529 capacity errors
CLAUDE_CODE_RETRY_WATCHDOG=1 claude -p "run the test suite and fix failures"
```

To keep a fallback chain across sessions, set `fallbackModel` as an array in your [settings](https://code.claude.com/docs/en/model-config#fallback-model-chains), for example `["claude-sonnet-5", "claude-haiku-5-5"]`. Claude Code doesn't confirm the chain at startup and `/status` doesn't show it; the notice when it switches is the first sign it's set. Rate-limit, billing and authentication errors never trigger a fallback. [How to change the model in Claude Code](/blog/claude-code-model-settings) covers `/model` and model aliases.

## How can you tell if a 529 is you or Anthropic?

A 529 from the Claude API is always on Anthropic's side, so the useful question is which service returned it. The trailing sentence of Claude Code's error names where to look: status.claude.com on Anthropic's API, the cloud provider's status page on Amazon Bedrock, Google Cloud or Microsoft Foundry, or the gateway host when `ANTHROPIC_BASE_URL` points somewhere else.

- **Read the status page by component.** As of November 16, 2026, [status.claude.com](https://status.claude.com) lists claude.ai, the Claude Console, the Claude API and Claude Code separately, and status.anthropic.com redirects there. A notice on claude.ai alone doesn't mean the API is overloaded: at 21:30 UTC that day, claude.ai showed degraded performance while the Claude API showed operational.
- **Check it from a terminal.** The status page serves its current state as JSON: `curl -s https://status.claude.com/api/v2/summary.json`.
- **Rule out your own limits.** Errors that point at your account are 429s and 400s. Run `/status` in Claude Code to confirm which credential it is using; a stray `ANTHROPIC_API_KEY` can send requests through a low-tier key instead of your subscription.
- **Keep the request ID.** If 529s persist with no posted incident, run `/feedback` in Claude Code, or send the `request_id` from the error body to Anthropic support.

## Can you switch to a non-Claude model when Claude is overloaded?

Claude Code's built-in model aliases, such as `opus`, `sonnet` and `haiku`, all point at Claude models, so `/model` and fallback chains help when one Claude model is overloaded and another isn't. [AutoRouter](https://autorouter.com), the Mac app for Codex and Claude Code, adds 20+ models to Claude Code's `/model` picker, including models from providers other than Anthropic. On AutoRouter Pro ($50 a month as of November 16, 2026, with paid models billed at the provider's price plus 10%, from $20 of included usage and then credits), you can pick one of those while a Claude model is at capacity and switch back later. The [models page](https://autorouter.com/models) lists them with their makers and prices.

## Questions

### Is Claude down when I get a 529?

Not necessarily: a 529 means the API was at capacity for that request, which can be brief and limited to one model. Check [status.claude.com](https://status.claude.com) for the Claude API component. If it shows no incident and other models work, the overload is probably limited to the model you were using.

### Does a 529 error count against my Claude usage limit?

No. Anthropic's Claude Code docs say a 529 [doesn't count against your quota](https://code.claude.com/docs/en/errors#api-error-repeated-529-overloaded-errors), and on the API failed requests [aren't charged](https://support.claude.com/en/articles/8977456-how-do-i-pay-for-my-claude-api-usage). [Claude API vs subscription](/blog/subscription-vs-api-pricing) explains how API billing works. [How to cut Claude Code and Codex costs](/blog/cut-claude-code-and-codex-costs) covers what makes a plan's real limits last.

### Why do I get 529 errors on Opus but not on Sonnet?

Capacity is tracked per model, so one model can be overloaded while another has room. That is why Claude Code suggests switching, for example from Opus to Sonnet, when one model is under high load.

### Should I retry a 529 in my own code?

Yes, with exponential backoff and a cap. Anthropic's SDKs already retry 5xx errors twice by default; raise `max_retries` for batch jobs, and spread retries out over time. For work that can wait, the [Message Batches API](https://platform.claude.com/docs/en/api/rate-limits#message-batches-api) runs requests asynchronously and isn't subject to ramp limits.

## Sources

- [Claude API errors](https://platform.claude.com/docs/en/api/errors), Claude Platform docs, checked November 16, 2026
- [Rate limits](https://platform.claude.com/docs/en/api/rate-limits), Claude Platform docs, checked November 16, 2026
- [Error reference](https://code.claude.com/docs/en/errors), Claude Code docs, checked November 16, 2026
- [Model configuration: fallback model chains](https://code.claude.com/docs/en/model-config#fallback-model-chains), Claude Code docs
- [How do I pay for my Claude API usage?](https://support.claude.com/en/articles/8977456-how-do-i-pay-for-my-claude-api-usage), Claude Help Center
- [Claude status](https://status.claude.com), Anthropic, checked November 16, 2026

## Read next

- [What is the Claude session limit, and when does it reset?](https://autorouter.com/blog/claude-session-limit.md): The Claude session limit is the five-hour usage limit on Claude's Pro and Max plans: it starts when you send your first message and resets in full five hours later, as of November 16, 2026. claude.ai, Claude Desktop and Claude Code all count toward it, Anthropic publishes no message count for it, and verified Ultra accounts don't have one. AutoRouter, the Mac app for Codex and Claude Code, makes it last longer by sending quick work to lower-cost models.
- [Claude 5-hour limit vs weekly limit: what resets when](https://autorouter.com/blog/claude-5-hour-limit-vs-weekly-limit.md): Claude's 5-hour limit starts with your first message and resets in full five hours later, while the weekly limit resets at a fixed day and time Anthropic assigns to your account, as of November 16, 2026. Every request counts against both at once, so whichever runs out first stops you. Pro and Max have both limits, and verified Ultra accounts have only the weekly one.
- [How to check your Claude Code usage](https://autorouter.com/blog/check-claude-code-usage.md): Run /usage in Claude Code to see your plan usage bars, a breakdown of what used your plan, and, for API users, a session token and cost estimate. Add a status line to keep plan and context usage on screen. AutoRouter, the Mac app for Codex and Claude Code, also shows the model and cost of every turn.

Tags: [Claude Code](https://autorouter.com/blog/tags/claude-code.md), [Guides](https://autorouter.com/blog/tags/guides.md)

Drafted with AI from the sources linked above, then checked and edited by the AutoRouter team.
