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

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

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

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

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

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 он повторяет перегрузку, ошибки сервера и тайм-ауты до 10 раз с экспоненциальной паузой, если ответ ещё не начал приходить. Сначала метка в спиннере пишет просто API error, а начиная с версии 2.1.198 с третьей попытки называет конкретную причину. Для 529 под отсчётом появляется ещё и строка с адресом страницы статуса.

Код 529 в API Anthropic называется overloaded_error. Это общая нагрузка на сервис, а не ваш тариф: в справочнике ошибок API лимиты вашей организации отвечают кодом 429, в том числе при резком росте нагрузки с вашей стороны. Поэтому переустановка Claude Code, повторный вход в аккаунт или покупка дополнительного объёма 529 не лечат.

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

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. Прежде чем что-то менять, сверьте точную строку:

Строка про обрыв посреди ответа заслуживает отдельного внимания. Начиная с версии 2.1.199 Claude Code сохраняет уже готовые блоки текста и вызовы инструментов и не отправляет запрос заново: повторная отправка могла бы выполнить те же команды дважды. Последний, прерванный блок при этом может пропасть. Если к этому моменту Claude успел что-то записать в файлы или запустить, сначала проверьте результат, а потом продолжайте — порядок проверки описан в материале о безопасном продолжении после 500 и 529.

Если на экране на самом деле 429, начните с /status: он показывает, какие учётные данные сейчас активны. Переменная ANTHROPIC_API_KEY в окружении перекрывает подписку Pro, Max, Team или Enterprise, даже если вы вошли в аккаунт, и тогда запросы идут через ключ с низким лимитом. В интерактивном режиме Claude Code один раз спрашивает разрешения на такую подмену, а в режиме -p использует ключ всегда. Вернуться к подписке можно командой unset ANTHROPIC_API_KEY. Дальше по лимитам — в разборе Claude Code Rate Limit Reached. Для 500 есть отдельная инструкция по Claude Code API Error 500, а если Claude Code вообще не может соединиться с сервером — по ошибкам Unable to connect to API.

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

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

• Подписка Claude или ключ Anthropic API — 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 переключится на следующую модель из списка и покажет об этом уведомление. Настройка описана в документации по моделям.

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

claude --fallback-model sonnet,haiku

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

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

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

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

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

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

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

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 файла настроек, тогда она действует при любом способе запуска:

{
  "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:

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

В описание добавьте точный текст ошибки, время, модель, маршрут из /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.