Что на самом деле означает 529 Overloaded
По официальному справочнику ошибок Claude Code на 2026-10-20, 529 Overloaded означает, что API Claude временно работает на пределе мощности: это состояние, затрагивающее всех пользователей, а не только вас, и в квоту оно не засчитывается. При повторной проверке добавились значения по умолчанию для повторов, которые теперь документированы официально: CLAUDE_CODE_MAX_RETRIES по умолчанию 10 (потолок 15 начиная с 2.1.186), базовая задержка повторов после 529 по умолчанию 500 мс (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, можно поднять до 32000), а потолок бэкоффа по умолчанию 32000 мс (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, можно поднять до 64000). Правка кода не поможет — поможет правка стратегии повторов.
Обновлено 2026-10-20
Один ключ для Claude, GPT и ведущих китайских моделей, оплата по токенам, старт за несколько минут.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре тезиса
Перегрузка провайдера
Возвращается, когда на стороне сервера не хватает мощности. Не связано с квотой ключа, параметрами или телом запроса. Официальный справочник ошибок указывает, что 529 затрагивает всех пользователей сразу: это проблема на стороне провайдера, а не у вас.
Вас ограничивают по скорости
Вот это означает, что вы превысили собственную скорость или квоту. 529 и 429 требуют разной обработки — не кладите их в одну ветку. В официальном справочнике есть деталь, которую легко упустить: если 429 сообщает о достижении лимита расходов или об исчерпании кредитов, Claude Code сразу считает это ошибкой и не повторяет запрос — для 529 поведение ровно обратное.
Единственный рабочий приём на клиенте
Экспоненциальный бэкофф с джиттером. Немедленный повтор усугубляет перегрузку и быстрее приводит к лимиту. В официальном справочнике базовая задержка повторов после 529 по умолчанию 500 мс (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS), а потолок бэкоффа по умолчанию 32000 мс (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS).
Структурное смягчение
Если ту же работу можно отправить другому семейству моделей, перегрузка одного провайдера перестаёт означать простой. Цена — принять различия моделей.
Чем 529 отличается от 429 и 503
По состоянию на 2026-10-20, 529 означает, что сервер перегружен именно сейчас: это проблема мощности, обычно временная; официальный справочник ошибок указывает, что это состояние затрагивает всех пользователей сразу, а не только вас, и в квоту оно не засчитывается. 429 означает, что вы упёрлись в собственный потолок по скорости или квоте — проблема лимитов; в официальном справочнике также сказано, что 429 с сообщением о достижении лимита расходов или об исчерпании кредитов приводит к немедленной ошибке без повтора. 503 обычно означает недоступность сервиса или обслуживание.
Ни один из кодов не говорит, что запрос составлен неверно, но обработка разная: 529 — отступить и повторить, 429 — снизить темп или поднять лимиты, 503 — подождать и следить за страницей статуса. Свести все три в один catch — самая частая ошибка.
Почему обсуждение периодически растёт
Каждый раз при выходе новой модели или массовой миграции у провайдеров временно нарастает нагрузка на мощности, и разговоров про 529 становится больше. Такие волны обычно спадают по мере расширения мощностей — но тому, у кого горит срок, «дождаться расширения» не годится в качестве ответа. На официальной странице статуса за 2026-10 есть две проверяемые записи: 2026-10-07 инцидент с лимитами расходов привёл к тому, что некоторые организации ошибочно были приостановлены как достигшие лимита, и запросы на Claude API, Claude Code и других продуктах Claude отклонялись — запись помечена как решённая; 2026-10-13 инцидент с данными об использовании на platform.claude.com прямо говорит, что на запросы к API это не повлияло.
Обе записи — про лимиты расходов и данные об использовании, а не про нехватку мощности. Claude Code выпустил подряд две версии — 2026-10-08 и 2026-10-09: 2.1.295 добавил предел общего ожидания в режиме повторов без присмотра, а 2.1.296 — настраиваемый потолок бэкоффа для 529; последняя версия 2.1.304 вышла 2026-10-19.
Порядок диагностики
Убедитесь, что код действительно 529, а не 429. Тела ответов различаются — считайте их в логах раздельно.
Проверьте страницу статуса провайдера. Если это масштабный инцидент, любые правки на клиенте — только смягчение. Официальная страница статуса перечисляет Claude API (api.anthropic.com) и Claude Code как два отдельных компонента, поэтому проверьте, какой из них затронут; на 2026-10-20 все компоненты на странице показывают рабочее состояние.
Проверьте, не усиливает ли ваша логика повторов перегрузку: отсутствие джиттера, отсутствие потолка и мгновенный повтор — всё это усиление. В Claude Code начиная с версии 2.1.292 (2026-10-06) базовую задержку повторов при 529 можно увеличить переменной CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS; с версии 2.1.295 (2026-10-08) переменная CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS ограничивает суммарное ожидание 429 и 529 в режиме повторов без присмотра; с версии 2.1.296 (2026-10-09) переменная CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS позволяет поднять потолок бэкоффа.
Прежде чем повторять, разберитесь, какой это код
Что подтверждено
529 сигнализирует о перегрузке мощностей на стороне сервера и не связан с содержимым запроса — эта семантика зафиксирована в документации разработчиков моделей. В официальном справочнике ошибок Claude Code (сверено 2026-10-20) текст ошибки такой: 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 и переключиться на другую модель, чтобы продолжить работу; кроме того, 529 затрагивает всех пользователей сразу. Тот же справочник приводит значения по умолчанию для повторов: CLAUDE_CODE_MAX_RETRIES — 10 (потолок 15 начиная с 2.1.186), CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS — 500 мс (можно поднять до 32000), CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS — 32000 мс (можно поднять до 64000), а CLAUDE_CODE_RETRY_WATCHDOG со значением 1 повторяет ошибки мощности 429 и 529 без ограничения.
По CHANGELOG Claude Code, с версии 2.1.286 при настройках повторов по умолчанию неудачный вызов модели отправляет не более 14 запросов, в 2.1.292 добавлена CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, в 2.1.295 — CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, в 2.1.296 — CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS. Экспоненциальный бэкофф с джиттером — широко проверенный приём на стороне клиента.
Не считать фактом
Для 529 справочник ошибок называет три действия: проверить страницу статуса на сообщения о мощности, повторить через несколько минут и переключиться на другую модель командой /model; там же сказано, что 529 затрагивает всех пользователей одновременно, а мощности учитываются отдельно для каждой модели. Считать, что это тихое ограничение активных пользователей, оснований нет, а смешение 529 и 429 уводит к неверному решению.
Два подхода
Только бэкофф на клиенте
Дёшево внедряется и заметно снижает долю отказов. Но пока провайдер перегружен, остаётся только ждать.
Дать работе уходить к разным семействам моделей
Перегрузка одного перестаёт означать простой. Цена — принять различия в повадках моделей, и у каждого маршрута свои режимы отказа. Многомаршрутность — это смягчение, а не устранение: сам механизм переключения тоже может отказать.
Как правильно писать повторы
Три пункта. Первый: экспоненциальный бэкофф, а не фиксированный интервал — сначала секунда, дальше удвоение. Второй: добавьте случайный джиттер. Если все клиенты ждут одинаково, повторы приходят синхронной волной, и перегрузка только затягивается. Третий: поставьте потолки на число повторов и на суммарное ожидание, иначе одна перегрузка заставит очередь задач расти без предела.
Отдельно: если потоковый запрос оборвался посередине, не повторяйте его вслепую с начала — сначала проверьте, можно ли продолжить с уже полученного. Если вы пользуетесь Claude Code: по документации он перед показом ошибки автоматически повторяет временные сбои до 10 раз с экспоненциальным бэкоффом (перепроверено 2026-10-20); в версии 2.1.286 (релиз на GitHub 2026-09-30) изменился подсчёт повторов — по смыслу changelog один лимит покрывает весь вызов модели, и при настройках по умолчанию неудачный вызов отправляет не более 14 запросов; в версии 2.1.292 (релиз на GitHub 2026-10-06) появилась переменная окружения CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, чтобы задать более длинную базовую задержку бэкоффа при повторе запроса после 529; в версии 2.1.295 (релиз на GitHub 2026-10-08) появилась CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, ограничивающая суммарное ожидание 429 и 529 в режиме повторов без присмотра; в версии 2.1.296 (релиз на GitHub 2026-10-09) появилась CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, чтобы поднять потолок бэкоффа при 529.
Официальный справочник теперь называет и значения по умолчанию: CLAUDE_CODE_MAX_RETRIES — 10 (потолок 15 начиная с 2.1.186), CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS — 500 мс (можно поднять до 32000), CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS — 32000 мс (можно поднять до 64000), а CLAUDE_CODE_RETRY_WATCHDOG со значением 1 повторяет ошибки мощности 429 и 529 без ограничения.
Что QCode может и чего не может
Может: одним ключом переключиться на другое семейство моделей во время перегрузки, не дожидаясь, пока восстановится одна модель. Не может: мы не разработчик моделей и не меняем мощности его серверов; запросы через QCode тоже могут завершаться ошибкой. Мы предлагаем возможность сменить семейство моделей, а не обещание безотказной работы.
Частые вопросы
Нужно ли менять параметры запроса при 529?
Нет. 529 не связан с содержимым запроса: ни изменение max_tokens, ни правка параметров модели, ни сокращение промпта его не уберут. Менять нужно стратегию повторов.
Можно ли обрабатывать 529 и 429 одинаково?
Не рекомендуется. При 529 следует отступить и повторить тот же запрос; 429 означает, что нужно снизить темп отправки или поднять лимиты, а слепые повторы будут снова и снова упираться в ограничитель.
Сколько ждать?
Обычная схема: первая пауза в секунду, дальше удвоение, плюс случайный джиттер и потолки на число повторов и общее ожидание. Конкретные значения зависят от того, какую задержку терпит ваша задача. В Claude Code (официальный справочник ошибок и CHANGELOG на 2026-10-20): число повторов задаёт CLAUDE_CODE_MAX_RETRIES, по умолчанию 10 (потолок 15 начиная с 2.1.186); с версии 2.1.286 при настройках по умолчанию неудачный вызов модели отправляет не более 14 запросов; с 2.1.292 через CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS можно задать более длинную базовую задержку для повторов после 529 (в официальном документе указано значение по умолчанию 500 мс, до 32000); с 2.1.295 переменная CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS ограничивает суммарное ожидание 429 и 529 в режиме повторов без присмотра; с 2.1.296 через CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS можно поднять потолок бэкоффа (в официальном документе указано значение по умолчанию 32000 мс, до 64000); если задать CLAUDE_CODE_RETRY_WATCHDOG равным 1, ошибки мощности 429 и 529 будут повторяться без ограничения.
Что делать, если 529 пришёл посреди потокового ответа?
Сначала проверьте, годится ли уже полученное. Если можно продолжить — продолжайте; повторяйте целиком только если нельзя. Слепой перезапуск удваивает оплату и добавляет нагрузки.
Бывает ли 529 у QCode?
Может. Перегрузка на стороне разработчиков моделей реальна, и мы от неё не защищены. Мы можем дать возможность увести ту же работу в другое семейство моделей, но не обещать безотказность.
Что значит 529 overloaded и почему эта ошибка появляется, если лимит не менялся?
529 Overloaded — это состояние мощности на стороне сервиса: официальный справочник ошибок указывает, что 529 означает заполнение мощности сразу у всех пользователей, а не ваш лимит использования, и в квоту он не засчитывается, поэтому неизменный лимит — это ожидаемо. Мощности учитываются отдельно для каждой модели, поэтому можно выполнить /model и переключиться на другую модель, чтобы продолжить работу; официальная рекомендация — повторить через несколько минут и проверить страницу статуса, где публикуются сообщения о доступной мощности. Повышение лимита или изменение параметров здесь не помогают. Многомаршрутность снижает вероятность того, что один сбой остановит работу, но у каждого маршрута свои режимы отказа, да и сам механизм переключения может отказать. Это смягчение, а не устранение.
Источники
Семантика кодов состояния соответствует официальной API-документации разработчиков моделей. Поведение повторов в Claude Code и CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS взяты из CHANGELOG Claude Code от Anthropic (записи 2.1.286, 2.1.292, 2.1.295 и 2.1.296), страниц релизов этих версий на GitHub, справочника ошибок и документации по переменным среды Claude Code, а также официальной страницы статуса со списком компонентов и инцидентов; всё получено и проверено 2026-10-20. Мы намеренно не приводим сторонние проценты доступности: такие цифры меняются со временем, а авторитетного независимого измерения, на которое можно сослаться, у нас нет.
Один маршрут перегружен — есть другой
Один ключ на несколько семейств моделей: когда маршрут под нагрузкой, переключитесь и продолжайте.
Читайте также
Claude Code: частые вопросы и обработка ошибок
Ответы на частые вопросы при работе с Claude Code: начало работы, квоты и разбор проблем.
Ограничения Claude Code
Как отличить окно в 5 часов от недельной квоты и что делать при достижении лимита.
Маршрутизация между моделями
Матрица выбора между семействами моделей и переключение с одним ключом.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Семантика кодов состояния соответствует официальной документации разработчиков моделей и может меняться между версиями; сведения о Claude Code сверены 2026-10-20 с официальными CHANGELOG и документацией, и решающими остаются они. Ничто из описанного не является обязательством по доступности.