Ошибка 529 overloaded_error от Claude означает, что в API Anthropic временно закончились ресурсы для запрошенной вами модели. Ваш ключ, тариф и сам запрос в порядке, и точно такой же запрос обычно проходит через несколько секунд. Чтобы приложение продолжало работать, сначала повторите запрос с задержкой, а затем отправьте его другому провайдеру, который поддерживает ту же модель Claude.

Большинство пользователей сталкиваются с этой ошибкой в Claude Code, когда сеанс прерывается сообщением API Error: Repeated 529 Overloaded errors. Мы смоделировали перегрузку в примере с повтором с помощью локального аналога API, так как настоящую перегрузку невозможно вызвать по требованию. Каждый запрос к OpenRouter в этом руководстве является реальным.

Коротко

Ошибка 529 overloaded_error означает, что у API Anthropic закончились ресурсы для этой модели среди всех пользователей. Ошибка 429 возникает из-за вашего собственного использования.
Сначала повторите запрос с экспоненциальной задержкой и добавлением случайности. SDK от Anthropic и Claude Code уже делают это.
Когда перегрузка затягивается, отправьте ту же модель другому провайдеру. В OpenRouter модели Claude Sonnet, Opus и Haiku 5.5 обслуживаются пятью провайдерами каждая, а маршрутизация по умолчанию выполняет переключение за вас.
В редких случаях, когда заняты абсолютно все провайдеры, укажите резервную модель с помощью параметра models.
В Claude Code запуск команды ori claude начинает сеанс в OpenRouter и обеспечивает такое же переключение при сбоях.

Что означает ошибка 529 overloaded?

API Anthropic возвращает код 529, когда трафик для модели превышает ее пропускную способность. Тело ответа выглядит следующим образом:

Эта ошибка не имеет к вам личного отношения. В справочнике ошибок Anthropic указано, что она возникает при высокой нагрузке на API со стороны всех пользователей, поэтому с ней может столкнуться любой при обращении к этой модели в данный момент, независимо от своего тарифного плана. Один из пользователей с тарифом Max сообщал, что Claude Code повторял попытки более восьми минут, прежде чем сдаться.

Ошибка, которая действительно исходит с вашей стороны — это 429 rate_limit_error. Она означает, что ваша организация исчерпала собственный лимит запросов или квоту расходов, и ее можно исправить, снизив частоту запросов или увеличив лимит. Ошибка 529 не связана с вашими лимитами использования, и согласно справочнику ошибок в Claude Code, она не расходует вашу квоту. Она исчезает, когда у Anthropic снова появляются свободные ресурсы, поэтому вы можете либо подождать, либо отправить запрос туда, где ресурсы есть прямо сейчас. Следующие три шага делают и то, и другое.

Шаг 1. Повторите запрос с экспоненциальной задержкой

Большинство ошибок 529 исчезают в течение нескольких секунд, поэтому начните с повторных попыток. Увеличивайте время ожидания после каждой попытки и добавляйте случайный фактор, чтобы множество клиентов не делали повторные запросы одновременно. Мы направили этот цикл на небольшой локальный сервер, который возвращает реальный ответ с ошибкой 529 для первых трех запросов, а затем успешно выполняет четвертый:

Четвертая попытка завершилась успешно примерно через восемь секунд после первой. Если вы используете официальные SDK Anthropic, у вас это уже настроено. Они , по умолчанию повторяют попытку дважды, и вы можете увеличить это значение с помощью max_retries.

Повторные попытки помогают при кратковременных всплесках нагрузки. Они не помогают, когда модель остается перегруженной в течение нескольких минут, а каждое ожидание добавляет задержку, которую замечают ваши пользователи. Для таких случаев вам нужен второй адрес для отправки запроса.

Шаг 2. Отправьте ту же модель другому провайдеру

API Anthropic — это не единственное место, где работает Claude. В OpenRouter модель Claude Sonnet 5.5 обслуживают пять провайдеров, то же самое относится к Opus 5.5 и Haiku 5.5. Вот что вернул наш API эндпоинтов для Sonnet 5.5 21 октября 2026 года:

Отправка запроса на глобальный эндпоинт вместо Anthropic не меняет стоимость услуг. Задержка и время безотказной работы у разных провайдеров могут отличаться, а руководство по оценке производительности LLM-провайдеров поможет их сравнить.

Вам не нужно ничего настраивать для их использования. Когда вы вызываете anthropic/claude-sonnet-5.5, наша маршрутизация по умолчанию распределяет запросы между провайдерами, обслуживающими эту модель, понижает приоритет тех провайдеров, у которых были серьезные сбои за последние 30 секунд, и повторяет неудачный запрос у следующего провайдера.

Если вы хотите выбрать, какой провайдер будет первым, задайте параметр order:

Anthropic ответил, поэтому переключения не произошло. Поле provider в каждом ответе указывает провайдера, который выполнил запрос, поэтому в ваших логах будет видно, когда трафик уходит от Anthropic. Установка order отключает балансировку нагрузки по умолчанию. Запросы будут следовать вашему списку вместо нашего рейтинга работоспособности и перейдут к оставшимся провайдерам только после сбоя тех, что вы указали.

Две настройки отключают переключение при сбоях, и их стоит проверить, если вы все еще видите ошибки 529:

Значение "allow_fallbacks": false удерживает запрос на указанных вами провайдерах. Если они все перегружены, вы получите ошибку обратно.
Значение "only": [...] ограничивает список провайдеров, которые вообще могут обслужить запрос. Если ни один из них не поддерживает модель, запрос завершится ошибкой до его начала.

Мы установили для параметра only значение ["openai"], чтобы посмотреть, как выглядит такой сбой:

В ошибке перечисляются все провайдеры, которые могли бы обслужить запрос, поэтому вы можете скопировать нужные идентификаторы прямо в свой список only.

Шаг 3. Добавьте резервную модель

Если все провайдеры какой-то модели заняты одновременно (например, во время всплеска спроса после нового релиза), на запрос может ответить вторая модель. Перечислите модели по порядку с помощью параметра models и отправьте запрос так же, как на шаге 2:

Модель Sonnet была доступна, поэтому она и ответила. Если бы она выдала ошибку у каждого провайдера, мы бы отправили запрос на Haiku 5.5, и поле model в ответе содержало бы ее имя. Резервные модели срабатывают при любой ошибке первой модели, включая превышение лимитов, недоступность сервиса и ошибки длины контекста. Если последняя модель в списке также потерпит неудачу, вы получите ее ошибку.

Выберите резервную модель, которая достаточно хороша для вашей задачи. Более компактная модель, такая как Haiku 5.5, подходит для рутинной работы, вроде коротких резюме или классификации, а наше руководство по самым дешевым инференс-решениям подскажет, как найти наименее затратную модель, способную справиться с задачей. Для работы, с которой хорошо справляется только более крупная модель, вместо мелкой резервной модели лучше положиться на второго провайдера и повторные попытки.

Как исправить ошибки 529 в Claude Code?

Claude Code уже выполняет шаг 1 за вас. Он с экспоненциальной задержкой и выдает сообщение API Error: Repeated 529 Overloaded errors только тогда, когда эти попытки исчерпаны. Вы можете изменить количество попыток с помощью переменной CLAUDE_CODE_MAX_RETRIES, но когда модель остается занятой, большее количество попыток означает лишь более длительное ожидание. Самый быстрый способ исправить ситуацию без какой-либо настройки — запустить команду /model и переключить модель, поскольку Anthropic отслеживает нагрузку для каждой модели отдельно.

Чтобы сохранить выбранную вами модель, запустите Claude Code в OpenRouter, что соответствует шагу 2. Самый быстрый способ — использовать Ori Harness, который запускает Claude Code на вашем компьютере с уже готовыми настройками OpenRouter:

Ori открывает браузер, чтобы вы могли войти в свою учетную запись OpenRouter, поэтому не нужно создавать или вставлять API-ключ. На OpenRouter работают только те сеансы, которые вы запускаете с помощью команды ori claude, а обычный claude работает как прежде.

Чтобы настроить все вручную, задайте три переменные окружения:

Если вы вошли в систему с учетной записью Claude, выполните команду /logout один раз и перезапустите приложение, чтобы переменные вступили в силу. Наше руководство по Claude Code рекомендует оставлять Anthropic провайдером с наивысшим приоритетом, поскольку именно с ним гарантированно работает Claude Code. Когда Anthropic перегружен, запросы перенаправляются к другим провайдерам, поддерживающим ту же модель.

Мы запускали Claude Code таким образом девять раз для небольшой задачи по исправлению багов с моделями Opus, Sonnet и Haiku 5.5, и каждая сессия завершилась успешно. Claude Code с OpenRouter берет на себя остальную часть настройки, включая выбор модели для каждой роли.

Часто задаваемые вопросы

Является ли ошибка 529 моей виной?

Нет. Ошибка 529 означает, что API Anthropic перегружен для данной модели среди всех пользователей. Ваш ключ, тарифный план и запрос в порядке. Ошибка 429 вызвана вашим собственным использованием.

Как долго длится ошибка 529 у Claude?

Обычно несколько секунд, поэтому повторные попытки с экспоненциальной задержкой решают большинство из них. Во время пиковой нагрузки перегрузка может длиться минуты, и именно тогда помогает отправка запроса другому провайдеру.

Предотвращает ли платный тариф или более высокий уровень ошибки 529?

Нет. Более высокий уровень повышает ваши лимиты запросов, что предотвращает ошибки 429, но ошибка 529 возникает из-за общего спроса на модель. Обслуживание модели через нескольких провайдеров — это то, что снижает ваши риски.

Как проверить, не упал ли Claude?

Anthropic публикует информацию об инцидентах на status.claude.com, и старый адрес status.anthropic.com перенаправляет туда. На OpenRouter на странице каждой модели отображается недавний аптайм для каждого провайдера, который ее обслуживает, например, для Claude Sonnet 5.5.

Дальнейшие действия

Ori Harness запускает Claude Code и другие агентские CLI на OpenRouter одной командой.
Маршрутизация провайдеров охватывает порядок, allow_fallbacks, only и сортировку по цене или пропускной способности.
Резервные модели (Model fallbacks) перечисляют, что вызывает переключение на резервную модель и как упорядочить модели.
Оптимизация аптайма объясняет, как мы отслеживаем работоспособность провайдеров.
Отказоустойчивость и резервные модели на OpenRouter: объяснение показывает, как совместная работа отказоустойчивости провайдеров и резервных моделей работает вместе.
Как заставить агента работать при исчезновении моделей рассматривает долгосрочную версию этой проблемы, когда модель выводится из эксплуатации.