# Ошибка 529 в Claude Code: что делать, когда API перегружен

> 529 в Claude Code — перегрузка выбранной модели, а не ваш лимит, и повторы к этому моменту уже сделаны. Смените модель через /model или задайте fallbackModel.

- URL: https://blog.laozhang.ai/ru/posts/claude-code-overloaded-error
- Published: 2026-04-11
- Updated: 2026-09-28
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Topic: Claude Code
- Tags: Claude Code, ошибка 529, overloaded_error, fallbackModel, Anthropic, Устранение неполадок

---
Когда Claude Code посреди задачи пишет `Repeated 529 Overloaded errors`, он уже сам повторил запрос до 10 раз с нарастающей паузой и только потом сдался. Повторять то же самое вручную прямо сейчас почти бесполезно. Ошибка 529 означает, что у провайдера закончились свободные мощности для выбранной модели сразу у всех пользователей; квоту она не расходует, и ваш лимит тут ни при чём.

Мощности считаются отдельно для каждой модели, поэтому самый быстрый способ продолжить — переключиться на другую модель командой `/model` (в приложении Claude Desktop — через выбор модели). Если модель менять не хочется, подождите несколько минут и проверьте страницу статуса, которую называет само сообщение. Чтобы следующая перегрузка не прерывала работу, задайте резервную цепочку `fallbackModel`, а для CI и скриптов включите `CLAUDE_CODE_RETRY_WATCHDOG=1` — тогда Claude Code будет ждать, а не падать.

## Что стоит за сообщением о перегрузке

Итоговый текст на маршруте Anthropic API выглядит так:

```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.
```

До этого сообщения вы, скорее всего, видели в спиннере обратный отсчёт `Retrying in Ns · attempt x/y`. Так выглядят автоматические повторы: по [документации Claude Code](https://code.claude.com/docs/en/errors#automatic-retries) он повторяет перегрузку, ошибки сервера и тайм-ауты до 10 раз с экспоненциальной паузой, если ответ ещё не начал приходить. Сначала метка в спиннере пишет просто `API error`, а начиная с версии 2.1.198 с третьей попытки называет конкретную причину. Для 529 под отсчётом появляется ещё и строка с адресом страницы статуса.

Код 529 в API Anthropic называется `overloaded_error`. Это общая нагрузка на сервис, а не ваш тариф: в [справочнике ошибок API](https://platform.claude.com/docs/en/api/errors) лимиты вашей организации отвечают кодом 429, в том числе при резком росте нагрузки с вашей стороны. Поэтому переустановка Claude Code, повторный вход в аккаунт или покупка дополнительного объёма 529 не лечат.

Иногда Claude Code подсказывает выход сам:

```text
Opus is experiencing high load, please use /model to switch to Sonnet
```

В приложении Claude Desktop (вкладка Code или Cowork) та же подсказка звучит как `Opus is experiencing high load. Switch to Sonnet.`, а модель меняется в выборе модели внутри приложения. Для моделей Fable в тексте будет стоять Fable.

## Какая строка у вас на экране и что делать дальше

Похожие по смыслу ошибки ведут в разные стороны. Резервная модель, например, спасает от 529, но не срабатывает на 429. Прежде чем что-то менять, сверьте точную строку:

| Строка на экране | Что произошло | Повторял ли Claude Code | Что делать |
| --- | --- | --- | --- |
| `Repeated 529 Overloaded errors` | У выбранной модели нет свободных мощностей у провайдера | Да, до 10 раз | `/model` → другая модель, или подождать несколько минут и проверить статус |
| `Opus is experiencing high load…` | Та же перегрузка, Claude Code назвал модель | Да | Переключиться на предложенную модель |
| `Server error mid-response. The response above may be incomplete.` | Перегрузка или 5xx пришли, когда часть ответа уже была готова | Нет, намеренно | Прочитать, что осталось на экране, и ответить `continue` |
| `Request rejected (429)` | Упёрлись в лимит своего API-ключа, проекта Bedrock или Google Cloud | Повторы лимит не снимут, резервная модель не включается | `/status`, проверить активные учётные данные и лимиты |
| `Server is temporarily limiting requests (not your usage limit)` | Короткое ограничение со стороны API, не ваша квота | Да, с версии 2.1.199 | Немного подождать и повторить |
| `API Error: 500 Internal server error` | Сбой внутри API, не связанный с вашим запросом | Да | Подождать минуту, проверить статус |

![Схема: четыре строки ошибок Claude Code — 529, обрыв посреди ответа, 429 и 500 — и следующий шаг для каждой](https://blog.laozhang.ai/posts/ru/claude-code-overloaded-error/img/error-line-map.webp)

Строка про обрыв посреди ответа заслуживает отдельного внимания. Начиная с версии 2.1.199 Claude Code сохраняет уже готовые блоки текста и вызовы инструментов и не отправляет запрос заново: повторная отправка могла бы выполнить те же команды дважды. Последний, прерванный блок при этом может пропасть. Если к этому моменту Claude успел что-то записать в файлы или запустить, сначала проверьте результат, а потом продолжайте — порядок проверки описан в материале [о безопасном продолжении после 500 и 529](https://blog.laozhang.ai/ru/posts/claude-code-500-529-rate-limit).

Если на экране на самом деле 429, начните с `/status`: он показывает, какие учётные данные сейчас активны. Переменная `ANTHROPIC_API_KEY` в окружении перекрывает подписку Pro, Max, Team или Enterprise, даже если вы вошли в аккаунт, и тогда запросы идут через ключ с низким лимитом. В интерактивном режиме Claude Code один раз спрашивает разрешения на такую подмену, а в режиме `-p` использует ключ всегда. Вернуться к подписке можно командой `unset ANTHROPIC_API_KEY`. Дальше по лимитам — в разборе [Claude Code Rate Limit Reached](https://blog.laozhang.ai/ru/posts/claude-code-rate-limit-reached). Для 500 есть отдельная инструкция [по Claude Code API Error 500](https://blog.laozhang.ai/ru/posts/claude-code-500-529-rate-limit), а если Claude Code вообще не может соединиться с сервером — [по ошибкам Unable to connect to API](https://blog.laozhang.ai/ru/posts/claude-api-error-connection-error).

## Какую страницу статуса проверять

Последнее предложение в сообщении об ошибке зависит от того, куда Claude Code отправляет запросы, и называет именно вашу страницу:

- **Подписка Claude или ключ Anthropic API** — [status.claude.com](https://status.claude.com).
- **Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry** — страница статуса этого облачного провайдера. Перегрузка там относится к его мощностям, а не к status.claude.com.
- **Свой шлюз через `ANTHROPIC_BASE_URL`** — в сообщении стоит хост шлюза. Проверяйте его статус и пишите в его поддержку: Claude Code видит только ответ шлюза.

Зелёная страница статуса не опровергает вашу ошибку. По состоянию на 28 сентября 2026 года на status.claude.com перечислены сервисы (claude.ai, Claude Console, Claude API, Claude Code и другие), а отдельных строк для моделей там нет. При этом сами инциденты часто названы по моделям: 15 сентября 2026 года — «Intermittent error spikes for Claude Mythos 5.1 and Claude Fable 5.1», 2–3 сентября — «Elevated errors for Claude Sonnet 5». Поэтому читайте не общий индикатор, а заголовки открытых инцидентов. Если там названа ваша модель, переключение через `/model` — прямое решение. Если инцидентов нет, а ошибка повторяется снова и снова, переходите к последнему разделу.

## Резервная модель: чтобы следующая перегрузка не останавливала работу

Вместо того чтобы каждый раз вручную запускать `/model`, можно заранее задать цепочку резервных моделей. Если основная модель перегружена, недоступна или вернула другую серверную ошибку, которую нет смысла повторять, Claude Code переключится на следующую модель из списка и покажет об этом уведомление. Настройка описана в [документации по моделям](https://code.claude.com/docs/en/model-config#fallback-model-chains).

На одну сессию — флагом через запятую:

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

Постоянно — массивом `fallbackModel` в `~/.claude/settings.json` (или в `.claude/settings.json` проекта):

```json
{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}
```

Флаг важнее настройки. Каждый элемент — имя модели или псевдоним, а `"default"` означает модель по умолчанию. Прежде чем полагаться на цепочку, учтите её ограничения:

- **Переключение действует только на текущий ход.** Следующее сообщение снова уходит в основную модель, так что при затяжной перегрузке цепочка будет срабатывать на каждом ходу.
- **Не больше трёх моделей** после удаления дублей, лишние элементы игнорируются.
- **Не срабатывает на 429**, ошибки авторизации и оплаты, слишком большой запрос, сетевые ошибки и отказ по политике организации — они обрабатываются как обычно.
- **Настройку нигде не видно заранее.** При запуске Claude Code её не подтверждает, `/status` её не показывает. Первый признак, что цепочка работает, — уведомление о переключении.
- **Модели вне `availableModels` отбрасываются**, если администратор ограничил список разрешённых моделей.
- **При сжатии контекста** Claude Code не переходит на модель с окном контекста меньше, чем у основной.
- **Субагенты** начиная с версии 2.1.247 тоже используют цепочку; модель основной сессии при этом не меняется.

![Схема цепочки fallbackModel: основная модель перегружена, ход переходит к sonnet и haiku, следующее сообщение снова идёт в основную модель; на 429, авторизацию и сетевые ошибки цепочка не срабатывает](https://blog.laozhang.ai/posts/ru/claude-code-overloaded-error/img/fallback-chain.webp)

Какую модель ставить резервной, зависит от задачи, а не от того, какая модель «свободнее»: заранее этого знать нельзя. Смысл в том, чтобы резервная модель отличалась от основной — мощности считаются по модели. Работа на резервной модели оплачивается как обычный запрос к ней на вашем маршруте: по подписке она расходует лимиты плана, по API-ключу — тарифицируется по цене этой модели.

## Запуски без присмотра: CI и скрипты

В интерактивной сессии после 529 вы решаете сами: подождать или сменить модель. В CI-задаче, скрипте с `claude -p` или на удалённом воркере решать некому, и после 10 неудачных попыток задача просто падает. Для таких запусков есть переменная `CLAUDE_CODE_RETRY_WATCHDOG` (нужна версия 2.1.186 или новее):

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
claude -p "Прогони тесты и исправь упавшие" --fallback-model sonnet,haiku
```

С ней Claude Code повторяет ошибки 429 и 529 бесконечно, делая паузы до 5 минут между попытками, вместо того чтобы остановиться. Начиная с версии 2.1.199 для прочих временных сбоев — ошибок сервера, тайм-аутов, обрывов соединения — число повторов по умолчанию вырастает до 300, это примерно три часа ожидания. Исключение одно: если 429 сообщает о лимите расходов или закончившихся кредитах, Claude Code с версии 2.1.239 падает сразу, потому что ожидание здесь ничего не даст.

Переменную можно задать и в ключе `env` файла настроек, тогда она действует при любом способе запуска:

```json
{
  "env": {
    "CLAUDE_CODE_RETRY_WATCHDOG": "1"
  }
}
```

Учтите, что бесконечные повторы упираются в тайм-аут самой CI-задачи: если он меньше времени, которое вы готовы ждать, задачу остановит раннер. Обратная ситуация — когда скрипт должен быстро понять, что сервис недоступен, и переключиться на запасной план. Тогда уменьшите `CLAUDE_CODE_MAX_RETRIES`: по умолчанию 10, а с версии 2.1.186 без watchdog больше 15 не поставить.

Ещё одна особенность `-p`: если ответ оборвался посреди текста без вызовов инструментов, Claude Code с версии 2.1.246 сам просит модель продолжить, до трёх раз подряд. И помните, что в режиме `-p` переменная `ANTHROPIC_API_KEY` используется всегда, если она задана, так что CI может работать по другому маршруту и с другими лимитами, чем ваш терминал.

## Когда остановиться и сообщить о проблеме

Имеет смысл писать о проблеме, если 529 повторяется снова и снова, на другой модели тоже, а открытого инцидента на вашей странице статуса нет. Порядок действий из [раздела Report an error](https://code.claude.com/docs/en/errors#report-an-error):

1. Запустите `/feedback` внутри Claude Code — он отправит в Anthropic расшифровку сессии с вашим описанием. На Bedrock, Google Cloud Agent Platform, Microsoft Foundry и других сторонних провайдерах команда вместо этого сохраняет локальный архив, который отправляют своему представителю Anthropic.
2. Выполните `claude doctor` в оболочке или `/doctor` в сессии, чтобы исключить проблемы установки.
3. Поищите похожий случай среди [issues Claude Code на GitHub](https://github.com/anthropics/claude-code/issues).

В описание добавьте точный текст ошибки, время, модель, маршрут из `/status` (подписка, API-ключ, облачный провайдер или шлюз) и то, пробовали ли вы другую модель и срабатывала ли резервная цепочка. Если запросы идут через шлюз, начните с его поддержки: только там видно, откуда взялся 529.

## Частые вопросы

**Сколько ждать, пока перегрузка пройдёт?**

Официального срока нет. Сообщение говорит, что перегрузка обычно временная, и документация советует попробовать снова через несколько минут. Если на странице статуса открыт инцидент по вашей модели, ориентируйтесь на его обновления, а работу продолжайте на другой модели.

**Расходует ли ошибка 529 мой лимит?**

Нет. По документации Claude Code, 529 не является вашим лимитом использования и не учитывается в квоте. Лимиты — это 429.

**Я вызываю Claude API из своего кода, а не через Claude Code. Что меняется?**

Официальные SDK Anthropic сами повторяют временные ошибки, включая 529, но по умолчанию только два раза; число задаётся параметром `max_retries` (`maxRetries` в TypeScript). Для поддержки сохраняйте `request_id` из тела ответа с ошибкой. Как выстроить повторы и резерв в собственном коде, разобрано в статье [Claude API 529 overloaded_error](https://blog.laozhang.ai/ru/posts/claude-api-error-529-overloaded).

## Источники

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 2026-09-28.

- [документации Claude Code](https://code.claude.com/docs/en/errors) (code.claude.com)
- [справочнике ошибок API](https://platform.claude.com/docs/en/api/errors) (platform.claude.com)
- [status.claude.com](https://status.claude.com/) (status.claude.com)
- [документации по моделям](https://code.claude.com/docs/en/model-config) (code.claude.com)
- [issues Claude Code на GitHub](https://github.com/anthropics/claude-code/issues) (github.com)