Что на самом деле означает 529 Overloaded
По официальному справочнику ошибок Claude Code на 2026-10-08, 529 означает, что API временно работает на пределе мощности: это не ваш лимит использования, и в квоту он не засчитывается. Правка кода не поможет — поможет правка стратегии повторов.
Обновлено 2026-10-08
Закончилась квота подписки или постоянно 429? Можно перейти на API с оплатой по токенам и продолжить работу с одним ключом.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard / AMEX или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре тезиса
Перегрузка провайдера
Возвращается, когда на стороне сервера не хватает мощности. Не связано с квотой ключа, параметрами или телом запроса.
Вас ограничивают по скорости
Вот это означает, что вы превысили собственную скорость или квоту. 529 и 429 требуют разной обработки — не кладите их в одну ветку.
Единственный рабочий приём на клиенте
Экспоненциальный бэкофф с джиттером. Немедленный повтор усугубляет перегрузку и быстрее приводит к лимиту.
Структурное смягчение
Если ту же работу можно отправить другому провайдеру, перегрузка одного перестаёт означать простой. Цена — принять различия моделей.
Чем 529 отличается от 429 и 503
529 означает, что сервер перегружен именно сейчас: это проблема мощности, обычно временная. 429 означает, что вы упёрлись в собственный потолок по скорости или квоте — проблема лимитов. 503 обычно означает недоступность сервиса или обслуживание. Ни один из кодов не говорит, что запрос составлен неверно, но обработка разная: 529 — отступить и повторить, 429 — снизить темп или поднять лимиты, 503 — подождать и следить за страницей статуса. Свести все три в один catch — самая частая ошибка.
Почему обсуждение периодически растёт
Каждый раз при выходе новой модели или массовой миграции мощности провайдеров временно уплотняются, и разговоров про 529 становится больше. Такие волны обычно спадают по мере расширения мощностей — но тому, у кого горит срок, «дождаться расширения» не годится в качестве ответа.
Порядок диагностики
Убедитесь, что код действительно 529, а не 429. Тела ответов различаются — считайте их в логах раздельно.
Проверьте страницу статуса провайдера. Если это масштабный инцидент, любые правки на клиенте — только смягчение.
Проверьте, не усиливает ли ваша логика повторов перегрузку: отсутствие джиттера, отсутствие потолка и мгновенный повтор — всё это усиление. В Claude Code начиная с версии 2.1.292 (2026-10-06) базовую задержку повторов при 529 можно увеличить переменной CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS.
Прежде чем повторять, разберитесь, какой это код
Что подтверждено
529 сигнализирует о перегрузке мощностей на стороне сервера и не связан с содержимым запроса — эта семантика зафиксирована в документации разработчиков моделей. В официальном справочнике ошибок Claude Code (сверено 2026-10-08) текст ошибки такой: API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary., и там же сказано: A 529 is not your usage limit and doesn't count against your quota — то есть 529 не ваш лимит использования и в квоту не засчитывается. Мощности учитываются отдельно для каждой модели, поэтому можно выполнить /model и переключиться на другую модель, чтобы продолжить работу. По CHANGELOG Claude Code, с версии 2.1.286 при настройках повторов по умолчанию неудачный вызов модели отправляет не более 14 запросов, а в 2.1.292 добавлена CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS. Экспоненциальный бэкофф с джиттером — широко проверенный приём на стороне клиента.
Не считать фактом
Утверждение «529 — это способ тихо придушить активных пользователей» не имеет подтверждений и здесь не заявляется. Различие между 529 и 429 описано в публичной документации, а их смешение ведёт к выбору неверного решения.
Два подхода
Только бэкофф на клиенте
Дёшево внедряется и заметно снижает долю отказов. Но пока провайдер перегружен, остаётся только ждать.
Дать работе уходить к разным провайдерам
Перегрузка одного перестаёт означать простой. Цена — принять различия в повадках моделей, и у каждого маршрута свои режимы отказа.
Как правильно писать повторы
Три пункта. Первый: экспоненциальный бэкофф, а не фиксированный интервал — сначала секунда, дальше удвоение. Второй: добавьте случайный джиттер. Если все клиенты ждут одинаково, повторы приходят синхронной волной, и перегрузка только затягивается. Третий: поставьте потолки на число повторов и на суммарное ожидание, иначе одна перегрузка заставит очередь задач расти без предела. Отдельно: если потоковый запрос оборвался посередине, не повторяйте его вслепую с начала — сначала проверьте, можно ли продолжить с уже полученного. Если вы пользуетесь Claude Code: по документации он перед показом ошибки автоматически повторяет временные сбои до 10 раз с экспоненциальным бэкоффом (перепроверено 2026-10-08); в версии 2.1.286 (релиз на GitHub 2026-09-30) изменился подсчёт повторов — по формулировке changelog, one limit now covers a whole model call, so with the default retry settings a failing call sends at most 14 requests, то есть один лимит покрывает весь вызов модели, и при настройках по умолчанию неудачный вызов отправляет не более 14 запросов; а в версии 2.1.292 (релиз на GitHub 2026-10-06) появилась переменная окружения CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS — по формулировке changelog, to set a longer base delay for the backoff when retrying an overloaded (529) request, то есть чтобы задать более длинную базовую задержку бэкоффа при повторе запроса после 529. Значения по умолчанию для этой переменной changelog не называет, и эта страница его не угадывает.
Что QCode может и чего не может
Может: одним ключом переключиться на другое семейство моделей во время перегрузки, не дожидаясь, пока восстановится одна модель. Не может: мы не разработчик моделей и не меняем мощности его серверов; запросы через QCode тоже могут завершаться ошибкой. Мы предлагаем возможность сменить семейство моделей, а не обещание безотказной работы.
Частые вопросы
Нужно ли менять параметры запроса при 529?
Нет. 529 не связан с содержимым запроса: ни изменение max_tokens, ни правка параметров модели, ни сокращение промпта его не уберут. Менять нужно стратегию повторов.
Можно ли обрабатывать 529 и 429 одинаково?
Не рекомендуется. При 529 следует отступить и повторить тот же запрос; 429 означает, что нужно снизить темп отправки или поднять лимиты, а слепые повторы будут снова и снова упираться в ограничитель.
Сколько ждать?
Обычная схема: первая пауза в секунду, дальше удвоение, плюс случайный джиттер и потолки на число повторов и общее ожидание. Конкретные значения зависят от того, какую задержку терпит ваша задача. В Claude Code (официальная документация и CHANGELOG на 2026-10-08): число повторов задаёт CLAUDE_CODE_MAX_RETRIES, по умолчанию 10; с версии 2.1.286 при настройках по умолчанию неудачный вызов модели отправляет не более 14 запросов; с 2.1.292 через CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS можно задать более длинную базовую задержку для повторов после 529.
Что делать, если 529 пришёл посреди потокового ответа?
Сначала проверьте, годится ли уже полученное. Если можно продолжить — продолжайте; повторяйте целиком только если нельзя. Слепой перезапуск удваивает оплату и добавляет нагрузки.
Бывает ли 529 у QCode?
Может. Перегрузка на стороне разработчиков моделей реальна, и мы от неё не защищены. Мы можем дать возможность увести ту же работу в другое семейство моделей, но не обещать безотказность.
Многомаршрутность убирает единую точку отказа?
Нет. Она снижает вероятность того, что один сбой остановит работу, но у каждого маршрута свои режимы отказа, да и сам слой маршрутизации может отказать. Это смягчение, а не устранение.
Источники
Семантика кодов состояния соответствует официальной API-документации разработчиков моделей. Поведение повторов в Claude Code и CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS взяты из CHANGELOG Claude Code от Anthropic (записи 2.1.286 и 2.1.292), страниц релизов обеих версий на GitHub и документации Claude Code об ошибках; всё получено и проверено 2026-10-08. Мы намеренно не приводим сторонние проценты доступности: такие цифры меняются со временем, а авторитетного независимого измерения, на которое можно сослаться, у нас нет.
Один маршрут перегружен — есть другой
Один ключ на несколько семейств моделей: когда маршрут под нагрузкой, переключитесь и продолжайте.
Читайте также
Claude Code: частые вопросы и обработка ошибок
Что означают частые коды и как их обрабатывать.
Ограничения Claude Code
Как применяются квоты и лимиты скорости.
Маршрутизация между моделями
Как на деле работает один ключ на несколько семейств.
Семантика кодов состояния соответствует официальной документации разработчиков моделей и может меняться между версиями; сведения о Claude Code сверены 2026-10-08 с официальными CHANGELOG и документацией, и решающими остаются они. Ничто на этой странице не является обязательством по доступности.