# Claude 529 overloaded_error: что это значит и как исправить в 2026 году

> Ошибка 529 overloaded_error: у Anthropic не хватает мощности для выбранной модели Claude. Это не ваш лимит — подождите, смените модель или настройте повторы.

- Source: https://www.aifreeapi.com/ru/posts/claude-529-overloaded-error
- Language: ru
- Published: 2026-03-19
- Updated: 2026-10-14
- Publisher: AI Free API (https://www.aifreeapi.com)

## Что означает Claude 529 Overloaded Error: короткий ответ

`529 overloaded_error` — это сигнал Anthropic о том, что у выбранной модели прямо сейчас не хватает вычислительной мощности для всех пользователей сразу. В [справочнике ошибок API](https://platform.claude.com/docs/en/api/errors) он описан одной строкой: «The API is temporarily overloaded», а 529 может появляться «when the API experiences high traffic across all users». Ваш запрос, ключ и настройки здесь ни при чём, и это не ваш лимит: в [русском справочнике ошибок Claude Code](https://code.claude.com/docs/ru/errors) прямо сказано, что ошибка 529 «не учитывается в вашей квоте».

Что делать, зависит от того, где вы её увидели:

| Где появилась 529 | Первое действие | Если не помогло |
|---|---|---|
| Claude Code, строка `Retrying in Ns · attempt x/10` | Ничего не трогать: клиент ещё повторяет запрос | Дождаться итогового сообщения |
| Claude Code, `Repeated 529 Overloaded errors` или `529 Overloaded` | Проверить [status.claude.com](https://status.claude.com), повторить через пару минут | `/model` → другая модель; настроить резервную модель |
| Свой код на Claude API или SDK | Дать SDK доделать повторы, записать `request_id` | Переключить запрос на другую модель, растянуть паузы |
| Чат claude.ai, «Due to unexpected capacity constraints…» | Повторить через несколько минут | Это не авария, на странице статуса её не будет |

Главное правило из официальной документации Claude Code: мощность считается **для каждой модели отдельно** («capacity is tracked per model»). Поэтому, если перегрузка затянулась, смена модели обычно работает быстрее, чем ожидание.

## Где вы увидели 529: тексты ошибки и что за ними стоит

Одна и та же перегрузка выглядит по-разному в зависимости от того, какой слой выводит сообщение. Строки ниже оставлены на английском: именно так они появляются в терминале и в логах.

### В Claude Code

| Текст на экране | Что происходит | Что делать |
|---|---|---|
| `API error · Retrying in 1s · attempt 2/10` | Первые попытки: причина ещё не названа | Ждать |
| `529 Overloaded · Retrying in 24s · attempt 10/10` | С версии 2.1.198 причина видна с третьей попытки; под отсчётом — ссылка на страницу статуса | Ждать: это ещё не ошибка |
| `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.` | Повторы исчерпаны, ход завершён | Статус → повтор → `/model` |
| `API Error: 529 Overloaded. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.` | Тот же итог в общем формате 5xx (так он выглядит в отчётах пользователей версий 2.1.241 и 2.1.286) | То же |
| `Opus is experiencing high load, please use /model to switch to Sonnet` | Перегружена именно Opus (на Fable сообщение называет Fable) | Переключиться, как предлагают |
| `Opus is experiencing high load. Switch to Sonnet.` | То же во вкладке Code приложения Claude Desktop и в Cowork | Сменить модель в списке моделей приложения |
| `…If it persists, check your inference gateway (127.0.0.1:8787)` | Запросы идут через ваш прокси или шлюз (`ANTHROPIC_BASE_URL`) | Смотреть логи и upstream этого шлюза, а не Anthropic |
| Вместо status.claude.com назван Bedrock, Google Cloud или Microsoft Foundry | Ошибку вернул облачный провайдер | Смотреть статус этого провайдера |
| `Agent terminated early due to an API error: API Error: 529 Overloaded.` | Перегрузку получил субагент | Перезапустить задачу или настроить резервную модель |
| `API Error: Server error mid-response. The response above may be incomplete.` | Перегрузка пришла посреди ответа (версия 2.1.199+); готовая часть сохранена | Проверить, что успело выполниться, и продолжить |

Последнюю строку Claude Code не повторяет автоматически намеренно: после того как модель закончила блок текста или вызов инструмента, повтор мог бы выполнить те же действия второй раз. Подробности — в разделе [Automatic retries](https://code.claude.com/docs/en/errors#automatic-retries).

Если в строке после `529 Overloaded.` стоит ссылка `https://…/docs/en/api/errors`, перед вами старый формат: весной 2026 года сам API добавлял адрес документации в текст ошибки (например, `"message":"Overloaded. https://docs.claude.com/en/api/errors"` в [issue #39767](https://github.com/anthropics/claude-code/issues/39767)). Смысл тот же.

### В Claude API и SDK

| Что вы получили | Что это |
|---|---|
| HTTP 529 и тело `{"type":"error","error":{"type":"overloaded_error","message":"Overloaded"},"request_id":"req_…"}` | Прямой ответ API о перегрузке |
| `anthropic.InternalServerError` со `status_code == 529` | Python- или TypeScript-SDK уже дважды повторил запрос и сдался: отдельного класса для перегрузки нет, все коды от 500 и выше приходят как `InternalServerError` |
| `event: error` с `overloaded_error` после ответа HTTP 200 | Перегрузка в потоковом режиме; по [документации о стриминге](https://platform.claude.com/docs/en/build-with-claude/streaming#error-events) это то же, что 529 без потока |
| `anthropic stream error (overloaded_error): Overloaded` и похожие | Сторонний клиент пересказывает то же событие потока |

### В чате claude.ai

В веб-чате и приложениях Claude код 529 обычно не показывается. Перегрузку там сообщает строка `Due to unexpected capacity constraints, Claude is unable to respond to your message. Please try again soon.` В [справке Anthropic](https://support.claude.com/en/articles/12466728) уточняется: это не авария, а управление нагрузкой, такие эпизоды на странице статуса не публикуются и обычно проходят через несколько минут.

Фраза «Claude is temporarily overloaded…» в официальной справке не описана, поэтому на её точную формулировку опираться нельзя; по смыслу это та же нехватка мощности.

## 529 vs 429, 500 и 503: ваш лимит или перегрузка Anthropic

529 говорит о нехватке мощности у Anthropic, 429 — о том, что упёрлись вы. Остальные коды из той же семьи сообщают о другом:

| Код или сообщение | Чья проблема | Что делать |
|---|---|---|
| `529 overloaded_error` | Мощность модели на стороне Anthropic | Повтор с паузами, другая модель |
| `429 rate_limit_error` | Лимит вашей организации: частота, токены, месячный потолок расходов | Уважать `retry-after`, снизить параллельность |
| «5-hour limit reached», «You've reached your weekly limit» | Лимит подписки Pro/Max | Ждать сброса окна или подключить usage credits |
| `API Error: Server is temporarily limiting requests (not your usage limit)` | Короткое ограничение на стороне сервера, не лимит плана | Claude Code повторяет сам (с версии 2.1.199) |
| `500 api_error` | Непредвиденный сбой внутри Anthropic | Повтор с паузами; если держится — в поддержку с request ID |
| `504 timeout_error` | Запрос не уложился по времени | Стриминг или Batch API для длинных запросов |
| `502`, `503` | Этих кодов нет в списке ошибок Anthropic API | Искать прокси, шлюз или облако между вами и Anthropic |

С 11 августа 2025 года часть сценариев резкого роста трафика, которые раньше заканчивались 529, отдаёт 429: так работают ограничения на ускорение (acceleration limits), об этом сказано в [release notes](https://platform.claude.com/docs/en/release-notes/overview). Если ваша организация внезапно увеличила нагрузку в разы и получила 429, это не перегрузка, а сигнал наращивать трафик постепенно.

В облаках коды другие. На [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/troubleshooting-api-error-codes.html) `overloaded_error` с кодом 529 означает нехватку мощности модели, `ServiceUnavailable` 503 — временную перегрузку сервиса, а `ThrottlingException` 429 — превышение квоты аккаунта. В Google Cloud нехватка мощности приходит как 429 с текстом `Resource exhausted, please try again later.`; при 429 в Claude Code проверьте, что модель доступна в вашем регионе, или попробуйте `CLOUD_ML_REGION=global`.

Если вы упёрлись именно в лимиты подписки, а не в перегрузку, нужен другой разбор: [Лимиты Claude Code: как посмотреть, понять ошибку и продолжить](/ru/posts/claude-code-rate-limit), а про недельные ограничения — [Лимиты Claude Code с 14 сентября: почему +25% означает на 17% меньше](/ru/posts/claude-code-usage-limit-issues).

## Claude Code model overloaded retrying: окно повторов около 160 секунд

До сообщения `Repeated 529` Claude Code делает до 10 повторов с экспоненциальной паузой. По умолчанию первая пауза для 529 — 500 мс, потолок — 32 000 мс ([раздел Tune retry behavior](https://code.claude.com/docs/en/errors#tune-retry-behavior)). Если пауза каждый раз удваивается, всё окно выглядит так:

`0,5 + 1 + 2 + 4 + 8 + 16 + 32 + 32 + 32 + 32 = 159,5 с` — примерно 2 мин 40 с.

Разбор сборки 2.1.220 участником сообщества ([issue #81330](https://github.com/anthropics/claude-code/issues/81330)) добавляет к каждой паузе случайный разброс до +25 %, то есть окно растягивается максимум примерно до 200 секунд. Там же описано, что в той версии сессии с API-ключом на моделях класса Opus и Fable сдавались уже после трёх 529 подряд. Это наблюдение по старой сборке, а не официальное правило, но оно объясняет, почему счётчик показывал `attempt N/10`, а ошибка приходила раньше.

Чтобы понять, хватит ли этого окна, сравните его с реальными инцидентами. 22 сентября 2026 года ошибки на Mythos 5.1, Fable 5.1 и Opus 5 длились с 00:50 до 02:10 UTC, 24 августа ошибки на нескольких моделях — с 04:50 до 07:36 UTC. Каждый ход, начатый в такие часы, исчерпывает свои примерно три минуты повторов и падает. Отсюда ощущение, что «529 никогда не проходит», хотя следующий запрос после восстановления сработает.

![Паузы между 10 повторами Claude Code по умолчанию: шесть коротких и четыре по 32 секунды, итого 159,5 с; ниже в одном масштабе инцидент 22 сентября 2026 года на 80 минут, окно по умолчанию 159,5 с и растянутое окно 382 с](https://www.aifreeapi.com/posts/ru/claude-529-overloaded-error/img/retry-window.webp)

### Как растянуть окно повторов в Claude Code

| Переменная | По умолчанию | Что меняет | Версия |
|---|---|---|---|
| `CLAUDE_CODE_MAX_RETRIES` | 10 | Число повторов, не больше 15 | 2.1.186+ (потолок) |
| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | 500 | Первая пауза после 529, до 32 000 | 2.1.292+ |
| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | 32 000 | Потолок паузы после 529, до 64 000 | 2.1.296+ |
| `CLAUDE_CODE_RETRY_WATCHDOG` | не задана | `1` — повторять 429 и 529 без ограничения; для CI и автономных запусков | 2.1.199+ |
| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | без предела | Сколько максимум ждать 429 и 529 в этом режиме | 2.1.295+ |

```bash
# Интерактивная сессия: окно примерно 6,5 минуты вместо 2,5
export CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS=2000
export CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=64000

# Или для CI и ночных запусков: пережидать перегрузку, но не дольше 30 минут на запрос
export CLAUDE_CODE_RETRY_WATCHDOG=1
export CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=1800000
```

Используйте один из двух блоков. Расчёт для первого при тех же 10 повторах и удвоении: `2 + 4 + 8 + 16 + 32 + 64 + 64 + 64 + 64 + 64 = 382 с`, около 6,4 минуты. Режим `CLAUDE_CODE_RETRY_WATCHDOG` отключает обе настройки пауз и ждёт столько, сколько нужно, но с версии 2.1.239 сразу останавливается на 429 из-за лимита расходов или закончившихся кредитов. Эти переменные меняются почти с каждым релизом (на 14 октября 2026 года последняя версия — 2.1.299), поэтому проверьте свою через `claude --version` и обновитесь командой `claude update`.

## Что делать при 529 в Claude Code: ждать, /model или резервная модель

![Схема действий при 529 в Claude Code: при отсчёте Retrying ждать; после Repeated 529 проверить инцидент по своей модели — да: /model sonnet или haiku, нет: повторить через пару минут, затем /feedback; если назван шлюз или облако — проверить их; при частых 529 — claude --fallback-model sonnet,haiku](https://www.aifreeapi.com/posts/ru/claude-529-overloaded-error/img/claude-code-529-steps.webp)

1. **Пока идёт отсчёт `Retrying in …`, не прерывайте.** Прерывание лишь оборвёт попытки, у которых ещё есть шанс пройти.
2. **После `Repeated 529` откройте [status.claude.com](https://status.claude.com)** или страницу провайдера, названную в сообщении. Если там инцидент по вашей модели, ждать придётся до его конца — быстрее перейти к шагу 3.
3. **Смените модель командой `/model`.** Например, с `opus` на `sonnet` или `haiku`. Исходное сообщение остаётся в разговоре, так что длинный запрос не нужно вставлять заново: достаточно написать `try again`.
4. **Настройте резервную цепочку, если 529 повторяется регулярно.** Тогда Claude Code переключится сам:

```bash
claude --fallback-model sonnet,haiku
```

Или постоянно, в `settings.json`:

```json
{
  "fallbackModel": ["sonnet", "haiku"]
}
```

5. **Если ошибка держится, а инцидента нет**, выполните `/feedback`: Anthropic получит данные о ваших запросах.

У резервной цепочки есть ограничения, о которых стоит знать заранее ([Fallback model chains](https://code.claude.com/docs/en/model-config#fallback-model-chains)):

- в цепочке не больше трёх моделей, лишние игнорируются;
- переключение действует только на текущий ход, следующее сообщение снова идёт в основную модель;
- `/status` цепочку не показывает, первое подтверждение — уведомление в момент переключения;
- 429, ошибки авторизации и биллинга переключение не вызывают;
- с версии 2.1.247 цепочка работает и для субагентов, а при сжатии контекста Claude Code не переходит на модель с меньшим окном;
- настройка `fallbackModel` появилась в версии 2.1.166; без цепочки Opus при перегрузке сам на Sonnet не переходит — Claude Code только предлагает сделать это через `/model`.

Алиасы зависят от провайдера. На Anthropic API на 14 октября 2026 года `opus` — это Opus 5.5, `sonnet` — Sonnet 5.5, `haiku` — Haiku 5.5. На Bedrock и Google Cloud `sonnet` и `haiku` указывают на Sonnet 4.5 и Haiku 4.5. О текущей Opus подробнее — в статье [Claude Opus 5.5: сколько стоит API и что проверить при переходе с Opus 5](/ru/posts/claude-opus-5-5).

## Claude не работает или перегружена одна модель: status.claude.com

Большинство недавних инцидентов на [status.claude.com](https://status.claude.com) касались отдельных моделей, а не всего Claude, — поэтому смена модели и помогает:

| Дата (UTC) | Инцидент | Затронуто |
|---|---|---|
| 6 октября 2026, 12:24–12:43 | Elevated errors for Claude Opus 5.5 | Только Opus 5.5 |
| 5 октября 2026, 12:40–13:10 | Elevated errors for Claude Mythos 5.1 and Claude Fable 5.1 | Две модели |
| 29 сентября 2026, 14:00–14:59 | Elevated errors on claude.ai, Claude Code, Claude Cowork and the Claude API | Все сервисы, плюс проблемы со входом |
| 22 сентября 2026, 00:50–02:10 | Elevated errors for multiple models | Mythos 5.1, Fable 5.1, Opus 5 |
| 3 сентября 2026, до 16:16 | Elevated errors for multiple models | Mythos/Fable 5.1 и 5, Opus 5, Opus 4.8, Opus 4.6 |
| 24 августа 2026, 04:50–07:36 | Elevated errors for multiple models | Opus 5, Fable 5 и другие |

Время указано в UTC; московское на три часа больше. В записях на странице статуса пишут «elevated errors», а не «529»: о том, что пользователи видели именно 529, известно из их отчётов (например, [issue #89156](https://github.com/anthropics/claude-code/issues/89156) утром 24 августа).

Как пользоваться страницей статуса:

- Смотрите компонент: по состоянию на 14 октября 2026 года их шесть — claude.ai, Claude Console, Claude API, Claude Code, Claude Cowork и Claude for Government.
- Для автоматической проверки подходят `https://status.claude.com/api/v2/summary.json` и `https://status.claude.com/api/v2/incidents.json`; подписаться можно по почте, SMS, в Slack, Microsoft Teams, через webhook или RSS/Atom.
- Зелёная страница не гарантирует, что перегрузки нет: короткие нехватки мощности в чате туда не попадают, а запись об инциденте появляется с задержкой. 5 октября ошибки начались в 12:40 UTC, а запись появилась в 13:05.
- Если вы работаете через Bedrock, Google Cloud или свой шлюз, страница Anthropic о вашем маршруте ничего не скажет: мощность там управляется провайдером.

## 529 в Claude API: повторы SDK, request ID и смена модели в коде

Официальные SDK сами повторяют 429, ошибки от 500 и выше, обрывы соединения, 408 и 409 — по умолчанию **два раза** с экспоненциальной паузой и с учётом заголовка `retry-after`. Число задаётся параметром `max_retries` (в TypeScript, Java и PHP — `maxRetries`).

Не оборачивайте SDK в свой цикл повторов, не отключив встроенный: попытки перемножаются. Пять внешних попыток по три запроса SDK (первый плюс два повтора) — это 15 запросов к перегруженной модели.

Полезнее сменить модель. Пример для Python SDK; модели и порядок подставьте свои:

```python
import anthropic

client = anthropic.Anthropic(max_retries=2)  # SDK сам повторит 529 дважды

MODELS = ["claude-opus-5-5", "claude-sonnet-5-5"]  # основная и резервная


def ask(messages: list[dict]) -> anthropic.types.Message:
    last_error: Exception | None = None
    for model in MODELS:
        try:
            return client.messages.create(
                model=model,
                max_tokens=1024,
                messages=messages,
            )
        except anthropic.RateLimitError:
            raise  # 429 — ваш лимит, другая модель тут не спасёт
        except anthropic.InternalServerError as e:
            if e.status_code != 529:
                raise  # 500 и прочие сбои разбирайте отдельно
            print(f"529 на {model}, request-id: {e.response.headers.get('request-id')}")
            last_error = e
    raise last_error


reply = ask([{"role": "user", "content": "Привет, Claude"}])
print(reply.content[0].text)
```

Если раньше в таком коде стояла `claude-sonnet-4-6`, замените её: по [обзору моделей](https://platform.claude.com/docs/en/about-claude/models/overview) это уже устаревшая (legacy) модель, хотя она ещё доступна; текущие — `claude-fable-5-1`, `claude-opus-5-5`, `claude-sonnet-5-5` и `claude-haiku-5-5`.

Ещё несколько правил для продакшена:

- **Сохраняйте request ID.** Он есть в заголовке `request-id` каждого ответа и в поле `request_id` тела ошибки, а в Python и TypeScript SDK — в свойстве `_request_id`. С ним разговор с поддержкой идёт по конкретному запросу.
- **Обрабатывайте ошибку внутри потока.** После HTTP 200 поток может прислать `event: error` с `overloaded_error`. Часть ответа к этому моменту уже пришла, поэтому решите, повторять ли запрос целиком.
- **Наращивайте трафик постепенно**, чтобы не упереться в 429 из-за ограничений на ускорение.
- **Несрочное отправляйте через Batch API**: по [описанию уровней обслуживания](https://platform.claude.com/docs/en/api/service-tiers) он подходит для задач, которые могут подождать.
- **Priority Tier больше не продаётся.** На той же странице сказано, что новые обязательства по мощности Priority Tier купить нельзя: действующие работают до конца контракта, а за гарантированной мощностью предлагают обращаться в отдел продаж. Кроме того, Priority Tier не поддерживает Opus 5.5, Sonnet 5.5, Haiku 5.5 и Fable 5.1, так что старый совет «перейти на Priority Tier, чтобы не ловить 529» больше не работает.

## Частые вопросы об ошибке 529 в Claude

### Model overloaded в Claude — что это значит?

Это пересказ той же ошибки 529: у выбранной модели сейчас не хватает мощности. В Claude Code перегрузку отдельной модели сообщает строка `Opus is experiencing high load, please use /model to switch to Sonnet`. Если такое сообщение появилось, переключитесь на предложенную модель.

### Claude 529 overloaded error — это моя вина?

Нет. Ошибку вызывает нагрузка всех пользователей на конкретную модель, а не ваш запрос, ключ или аккаунт. Исключение — если между вами и Anthropic стоит свой прокси: тогда сообщение называет его адрес («check your inference gateway»), и разбираться нужно с ним.

### Сколько обычно длится 529?

Фиксированного срока нет. Короткие перегрузки проходят за время, пока Claude Code повторяет запрос (около 160 секунд по умолчанию), а опубликованные инциденты с конца августа по начало октября 2026 года длились от 19 минут до 2 часов 46 минут. Если ошибка держится дольше нескольких минут, не ждите — смените модель.

### 529 — это то же самое, что 429?

Нет. 429 означает, что упёрлись в лимит вы: частота запросов, токены, потолок расходов или лимит подписки. 529 означает, что не хватает мощности у Anthropic. Против 429 помогает снизить нагрузку, против 529 — подождать или сменить модель.

### Списываются ли деньги или лимит подписки за ошибку 529?

В Claude Code — нет: ошибка 529 не учитывается в квоте подписки. Для оплаты API по токенам Anthropic отдельного правила не публикует. Отклонённый с кодом 529 запрос ничего не сгенерировал, а при перегрузке посреди потока часть ответа уже могла быть создана. Сверьте расход в Claude Console по request ID. Для чата claude.ai официального заявления о лимитах при перегрузке нет.

### Защищает ли подписка Max или Pro от 529?

В документации Anthropic нет обещания, что подписчики получают приоритет при перегрузке, и 529 получают в том числе владельцы Max — например, в [issue #39767](https://github.com/anthropics/claude-code/issues/39767) и [#89267](https://github.com/anthropics/claude-code/issues/89267). Против перегрузки работают смена модели и резервная цепочка, а не тариф.

### Почему чат Claude пишет о перегрузке, а status.claude.com зелёный?

Сообщения «Due to unexpected capacity constraints…» в чате Anthropic считает обычным управлением нагрузкой, а не аварией, поэтому на страницу статуса они не попадают. Попробуйте ещё раз через несколько минут. Если же ошибки идут во всех сервисах сразу, на странице статуса обычно появляется инцидент.
