# Claude Code 529 overloaded: why it happens, what to do

> A 529 overloaded error means Anthropic's API is at capacity, not that your quota ran out. Why Claude Code shows it, what helps and what doesn't.

Source: https://shuriken.sh/guides/claude-code-529-overloaded

A 529 overloaded error means Anthropic's API is at capacity, not that your quota ran out. Why Claude Code shows it, what helps and what doesn't.

By Shuriken Updated 27 October 2026 5 min read

**Contents**

A 529 "overloaded" error in Claude Code means Anthropic's API is at capacity for everyone at that moment. It is not your usage limit, and it doesn't count against your quota. Claude Code has already retried several times before it shows you the error. Wait a few minutes, check status.claude.com, or switch model with /model.

## What the 529 overloaded error means #

The message looks like this:

text
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

Two sentences in Anthropic's [Claude Code error reference](https://code.claude.com/docs/en/errors) settle it: "The API is temporarily at capacity across all users." and "A 529 is not your usage limit and doesn't count against your quota." The [API error list](https://platform.claude.com/docs/en/api/errors) describes the 529 overloaded_error as one that "can occur when the API experiences high traffic across all users."

The cause is on Anthropic's side, not in your plan, prompt or settings, which is also why the fixes for a usage limit don't work on it. Three errors get mixed up:

| You see | What it means | Counts against your limit? | What helps |
| --- | --- | --- | --- |
| Repeated 529 Overloaded errors | The API is at capacity for all users | No | Wait, or use another model |
| 429 or "You've hit your session limit" | You or your organisation reached a limit | It is the limit | Wait for the reset, or another account or key |
| API Error: 500 | An unexpected failure inside the API | No | Wait a minute and send again |

If yours says 429, our guide to the [Claude Code 429 error](https://shuriken.sh/guides/claude-code-429-rate-limit-error) is the one you want. If it names your session or weekly limit, read [what to do when you reach Claude's limit](https://shuriken.sh/guides/claude-limit-reached-what-to-do). A 400 that mentions tool_use or tool_result is different again: it repeats on every message in that conversation, and our guide to [API Error 400 on tool use](https://shuriken.sh/guides/claude-code-api-error-400-tool-use) has the fix.

## Claude Code already retried for you #

By the time you read the error, Claude Code has used up its retries. Per Anthropic's docs, Claude Code retries transient failures, overloaded responses among them, up to 10 times with exponential backoff. While it does, the spinner shows Retrying in Ns · attempt x/y, and from the third try it names the reason. On a 529 the line underneath points you to status.claude.com.

You can tune that behaviour with environment variables (defaults as of 22 October 2026, from the same page):

| Variable | Default | What it does |
| --- | --- | --- |
| CLAUDE_CODE_MAX_RETRIES | 10 | How many retries. Capped at 15 |
| CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS | 500 | First wait between 529 retries |
| CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS | 32000 | Longest wait between 529 retries |
| CLAUDE_CODE_RETRY_WATCHDOG | unset | 1 retries 429 and 529 capacity errors with no end. Meant for unattended runs such as CI |

The watchdog is a sharp tool. It keeps a CI job alive through an overload, but it also keeps retrying a 429, so in an interactive session it can hide the fact that you've hit a real limit.

## What to do about a 529 #

- Check the status page. Open [status.claude.com](https://status.claude.com) and look at the Claude Code and Claude API rows. You can subscribe there by email, Slack or webhook to hear when it clears.
- Wait a few minutes, then send again. Anthropic calls the error "usually temporary". Your message is still in the conversation, so a short "try again" does; there's no need to paste a long prompt again.
- Switch model with /model. Anthropic's docs say capacity "is tracked per model", and Claude Code sometimes suggests it itself: Opus is experiencing high load, please use /model to switch to Sonnet. One cost to know: Anthropic's [prompt caching page](https://code.claude.com/docs/en/prompt-caching) says each model has its own cache, so the first turn on the new model reads your whole conversation with no cache hits.
- Set a fallback model for next time. claude --fallback-model sonnet,haiku falls back to those models, in order, when the main one is overloaded or not available. The switch lasts for that turn; your next message tries the main model first again. The fallbackModel setting keeps it for every session.
- Give long unattended jobs more patience. For a script or CI run that can wait, raise CLAUDE_CODE_MAX_RETRIES or set CLAUDE_CODE_RETRY_WATCHDOG=1. Overloads come from load, so a job that can run later often finishes without trouble.

Shuriken moves a running chat to another of your own accounts when one reaches its limit, on every device.

[Download](https://shuriken.sh/download)

## What doesn't help #

- Logging out and back in, or another Claude account. The overload is across all users, and each account asks the same busy model. A different account rarely gets a different answer.
- Buying extra usage. Usage credits pay for work past your plan's limit. A 529 isn't your limit, so they don't target it.
- Resending in a tight loop. Claude Code's backoff already spaces the retries out. Sending faster by hand only adds to the queue.
- Reinstalling Claude Code. Nothing on your machine is broken. If /doctor and /status look normal and the status page shows a capacity notice, it's the API.

## How Shuriken handles a 529 #

Shuriken runs your Claude Code chats on your own computers and servers, and a 529 at 2 am shouldn't leave a chat dead until morning. This is what it does:

- More of Claude Code's own retries. Unless you set your own, Shuriken raises CLAUDE_CODE_MAX_RETRIES to 15, the most Claude Code honours without the watchdog. We leave the watchdog off on purpose: it would also retry a usage limit forever, and then the chat could never move on.
- Then the chat pauses, it doesn't die. When Claude Code gives up, the chat shows "Paused: the API is overloaded. This continues on its own." The first retry stays on the same account, because moving a chat throws away its prompt cache.
- Two tries elsewhere, then patience. If it's still overloaded, Shuriken tries another of your accounts, at most twice, then waits and tries again: 5 seconds, then doubling, up to a minute between tries. After about five hours it slows to every 5 minutes, and it never gives up. Another account usually meets the same busy model, so the waiting does most of the work; the moves are there because they cost little to try.

A 529 is different from running out. When an account reaches your switch point or a limit, [source switching](https://shuriken.sh/features/source-switching) moves the chat to another of your accounts. And if every Claude sign-in and key you added is out, a Claude Code chat can go on, between turns, on an endpoint you added for Claude Code that serves another company's models, as long as the chat's history can be read there. Use only accounts you own and are entitled to use: providers' terms may not allow sharing a subscription sign-in. We wrote up the related case of a [refused account](https://shuriken.sh/blog/how-switching-picks-the-next-account) separately.

If you'd like your chats to wait out an overload by themselves, [download Shuriken](https://shuriken.sh/download).

Try the free tool: [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude)

Share

[X](https://x.com/intent/post?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-529-overloaded&text=Claude%20Code%20529%20overloaded%3A%20why%20it%20happens%2C%20what%20to%20do)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-529-overloaded)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-529-overloaded&t=Claude%20Code%20529%20overloaded%3A%20why%20it%20happens%2C%20what%20to%20do)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-529-overloaded&title=Claude%20Code%20529%20overloaded%3A%20why%20it%20happens%2C%20what%20to%20do)[E-mail](mailto:?subject=Claude%20Code%20529%20overloaded%3A%20why%20it%20happens%2C%20what%20to%20do&body=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-529-overloaded)

## Sources

- [Error reference: Repeated 529 Overloaded errors, automatic retries (Claude Code docs)](https://code.claude.com/docs/en/errors) (accessed 22 October 2026)
- [Claude API errors: 529 overloaded_error (Claude API docs)](https://platform.claude.com/docs/en/api/errors) (accessed 22 October 2026)
- [CLI reference: --fallback-model (Claude Code docs)](https://code.claude.com/docs/en/cli-reference) (accessed 22 October 2026)
- [Claude status page](https://status.claude.com) (accessed 22 October 2026)
- [How Claude Code uses prompt caching: switching models (Claude Code docs)](https://code.claude.com/docs/en/prompt-caching) (accessed 22 October 2026)
- [Model configuration: fallback model chains (Claude Code docs)](https://code.claude.com/docs/en/model-config) (accessed 22 October 2026)

## Frequently asked questions

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

No. Anthropic's error reference says a 529 is not your usage limit and doesn't count against your quota. It means the API is at capacity for everyone.

**How long does a 529 overloaded error last?**

Usually minutes. Anthropic calls it usually temporary. If it keeps coming back, check status.claude.com for a capacity notice or an incident.

**Is a 529 the same as a 429?**

No. A 429 means you or your organisation reached a rate or usage limit. A 529 means the API as a whole is overloaded, whoever is asking.

**Will switching to another Claude account fix a 529?**

Rarely. The overload is shared by all users and tracked per model, so another account asks the same busy model. Switching model with /model is what Anthropic suggests.

Source switching

One account runs dry. The next one takes over.

Add the Claude, Codex and Gemini accounts you own. At your switch point, your chats move to another of them and keep going.

[Download](https://shuriken.sh/download)

[Other platforms](https://shuriken.sh/download#main)

## Keep reading

- [How to check your Claude Code usage: Guide 27 Oct 2026 6 min read To check Claude Code usage, type /usage or open Settings › Usage on claude.ai. Both read one pool: your 5-hour session and your weekly limit.](https://shuriken.sh/guides/check-claude-code-usage)
- [Claude Code and Codex in one project: Story 27 Oct 2026 3 min read How to use Claude Code and Codex together on one project: a chat per agent, one set of MCP servers for both, and each agent on its own sources.](https://shuriken.sh/blog/claude-and-codex-together)
- [How to switch Claude accounts without logging out: Guide 27 Oct 2026 7 min read Three ways to use several Claude accounts in Claude Code without /logout and /login: one config per account, a switcher CLI, or a harness.](https://shuriken.sh/guides/switch-claude-accounts-without-logging-out)
- [Claude's 5-hour limit, explained: Guide 27 Oct 2026 6 min read Claude's 5-hour window starts with your first message and resets five hours later. An idle account has no window running, so it saves nothing up.](https://shuriken.sh/guides/claude-5-hour-limit-explained)
- [Claude's weekly limit, explained: Guide 27 Oct 2026 6 min read Paid Claude plans have a weekly limit on top of the 5-hour window. When it resets, how model limits fit in, and why parallel agents reach it in two days.](https://shuriken.sh/guides/claude-weekly-limit-explained)
- [Codex usage limits explained (2026): Guide 27 Oct 2026 5 min read How Codex limits work on ChatGPT Plus and Pro: the 5-hour and weekly windows, the 2026 changes, checking yours with /status, and using several accounts.](https://shuriken.sh/guides/codex-usage-limits)
- [Anthropic API rate limit tiers: how to move up: Guide 27 Oct 2026 5 min read Anthropic API rate limit tiers set a monthly spend cap and per-minute limits. The tiers in October 2026, how to move up, and what Claude Code hits first.](https://shuriken.sh/guides/anthropic-api-rate-limit-tiers)
- [/compact vs /clear in Claude Code: when to use which: Guide 27 Oct 2026 5 min read Use /clear when you start a new task and /compact when one task has a long history. A decision table, what auto-compact keeps and what a summary loses.](https://shuriken.sh/guides/claude-code-compact-vs-clear)

## Free tools

- [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude)
- [Codex limit reset tracker](https://shuriken.sh/tools/limit-resets/codex)