Содержание
Случалось ли, что работу в Claude Code прерывала вот такая ошибка?
API Error: 529 {"type":"error","error":
{"type":"overloaded_error","message":"Overloaded"}}
# или
API Error: 500 Internal server error.529 Overloaded означает, что API Anthropic временно перегружен (испытывает наплыв запросов), а 500 означает, что внутри сервера произошла непредвиденная ошибка. И то и другое — на стороне сервера, и, что самое важное, это не ошибка в вашем запросе или настройках и не исчерпание вашего лимита. В официальной документации прямо сказано, что «529 — это не ваш лимит использования и не засчитывается в вашу квоту». Иными словами, это ошибки того рода, которые обычно проходят сами после «подождите немного и повторите».
Главное сразу. (1) 529/500 — на стороне сервера, не ваша вина (и не расходуют вашу квоту). (2) Claude Code уже автоматически повторяет запрос до 10 раз с экспоненциальной задержкой, прежде чем вообще что-то вам показать — когда появляется дружелюбное сообщение, эти повторы уже исчерпаны. (3) Решение — «проверить страницу статуса → подождать → сменить модель через /model». Ёмкость отслеживается отдельно по каждой модели, поэтому, даже когда Opus перегружен, Sonnet часто проходит.
Это на стороне сервера, не ваша вина
— Claude Code повторяет запрос ещё до того, как что-то вам покажет
Поэтому решение — «подождать и повторить / переключиться через /model / проверить status.claude.com».
Чинить какой-либо код или настройку, по сути, не нужно.
1. О чём говорит эта ошибка
HTTP 529 (overloaded_error / сообщение «Overloaded») — признак того, что API Anthropic временно перегружен. Официальное описание буквально таково: «API временно перегружен» и «может возникать, когда API испытывают высокий трафик со стороны всех пользователей». Это значит, что дело не в вине какого-то одного человека, а в том, что общий спрос ненадолго превысил предложение.
HTTP 500 (api_error) — это непредвиденная внутренняя ошибка на стороне Anthropic. В документации сказано, что она «не вызвана вашим промптом, настройками или аккаунтом». С этим связана и 504 (timeout_error), возникающая, когда длинный запрос превышает время ожидания (заметьте: Anthropic документирует 504, тогда как 502/503 обычно приходят от вышестоящей инфраструктуры вроде шлюзов).
Ключевой момент: «529 и 500 — это проблемы на стороне сервера, и они не расходуют вашу квоту использования». Они совершенно отличаются и от лимита тарифного плана usage limit reached, и от вашего собственного лимита скорости 429 (различия разбираем в §4). Поэтому не нужно напрягаться и чинить код или настройки — по умолчанию это «подождать и повторить».
2. Claude Code уже повторяет запрос за вас
На самом деле ещё до того, как вы увидите сообщение об ошибке, Claude Code уже повторял запрос в фоне. Согласно официальной документации —
Поведение автоматического повтора
Ошибки сервера, ответы о перегрузке, тайм-ауты запросов, временные троттлинги 429 и разрывы соединения — всё это повторяется до 10 раз с экспоненциальной задержкой. Во время повторов спиннер показывает обратный отсчёт Retrying in Ns · attempt x/y. К моменту, когда появляется дружелюбная строка API Error:, эти 10 повторов уже исчерпаны.
То есть «529 мелькнула, но всё продолжилось» — это нормально: автоповтор её поглотил. И наоборот, если вы дошли до дружелюбного сообщения («Repeated 529 Overloaded errors … try again in a moment. If it persists, check https://status.claude.com»), это признак того, что нагрузка достаточно высока, чтобы даже повторы не помогли восстановиться. Повторы можно настроить через CLAUDE_CODE_MAX_RETRIES (по умолчанию 10), а предельное время на один запрос — через API_TIMEOUT_MS (по умолчанию 600000 мс = 10 минут): уменьшите число, чтобы быстро падать в скриптах, увеличьте — чтобы переждать более длинный инцидент.
3. Что можете сделать вы
Действия при 529/500 на самом деле очень просты. Пробуйте их по порядку.
Подождать, переключить, проверить
/feedback (укажите request_id, чтобы ускорить разбор).
Не уверены? 1) подождать → 2) переключиться через /model → 3) проверить статус.
Помогает и сдвиг работы на непиковые часы. Чинить какую-либо настройку, по сути, не нужно.
Примечание: сообщение «Server is temporarily limiting requests» официально описано как «кратковременный троттлинг на стороне сервера, не связанный с вашим лимитом использования.» Оно тоже проходит после короткого ожидания и отличается от лимита тарифного плана usage limit.
4. Отличие от похожих ошибок
У семейства ошибок «всё остановилось» причины могут быть прямо противоположными. Сначала разделите по принципу «на стороне сервера или на вашей стороне?»
| Ошибка | Чья проблема | Расходует квоту? | Основное решение |
|---|---|---|---|
| 529 Overloaded | Сторона сервера (ёмкость, затрагивает всех) | Нет | Подождать и повторить, /model, проверка статуса |
| 500 / 504 | Сторона сервера (внутренняя ошибка / тайм-аут) | Нет | Повторить; если не проходит — /feedback |
| 429 Rate limit | Ваша сторона (лимит скорости вашего API-ключа) | Да (ваша скорость) | Снизить темп, поднять уровень, выждать retry-after |
| usage limit reached | Ваша сторона (квота плана Pro/Max) | Да (план) | Дождаться сброса; решения |
| 400 Invalid request | Ваша сторона (некорректный запрос) | Нет | Исправить тело запроса |
Памятка: 5xx (включая 529) — это сторона сервера = проходит, если подождать. 429 и usage limit касаются вашего «объёма» = настройте скорость или план. 400 касается вашего «содержимого» = исправьте запрос. 429 и 529 особенно легко перепутать, но 429 несёт заголовок retry-after и расходует квоту, тогда как 529 не имеет заголовка и квоту не расходует — это разные вещи. О других частых ошибках Claude Code см. сводку ошибок.
5. Для разработчиков (API/SDK)
Если вы запускаете собственное приложение на API/SDK, правильный подход — рассматривать 529/500 как «временное событие, которое в норме может случаться».
(1) Официальные SDK выбрасывают типизированные исключения (OverloadedError, InternalServerError и т. д.) и автоматически повторяют временные ошибки с экспоненциальной задержкой — перехватывайте классы исключений, а не совпадения строк. (2) Если повторяете сами, используйте «экспоненциальную задержку + джиттер». (3) Заголовок retry-after присутствует при 429, но НЕ при 529, поэтому при 529 ждите по своей собственной задержке, а не по времени из заголовка. (4) Имейте резервную модель (в Claude Code есть --fallback-model). (5) Наращивайте трафик постепенно, чтобы избежать «лимита ускорения» 429 после всплеска использования. Если нужна стабильная доступность, вариантами также являются Priority Tier и Message Batches API. Об основах см. Что такое AI API.
6. Кратковременный всплеск или инцидент?
Одна и та же 529/500 означает разное в зависимости от того, что это — «всплеск, исчезающий мгновенно» или «непрерывный сбой, который повторяется».
Кратковременный всплеск (одна или несколько ошибок, проходящих при повторе) — это в пределах нормального колебания спроса. Автоповтор обычно его поглощает, и на вашей стороне чинить нечего. С другой стороны, «Repeated 529» или 500, переживающая повторы, — признак того, что стоит заподозрить активный инцидент: сначала проверьте status.claude.com, и если опубликован сбой, ждать восстановления — единственно верный шаг. Если 500 не проходит без опубликованного инцидента, сообщите через /feedback, указав request_id. В любом случае всё, что пользователь может сделать при 529/500, — это «повторить, переключиться через /model, проверить статус и сообщить» — и этого действительно достаточно.
Итоги
Ошибки Claude Code «API Error: 529 Overloaded» и «500 Internal server error» — это события на стороне сервера, когда API Anthropic временно перегружен или столкнулся с внутренней ошибкой. Это не ошибка в вашем запросе или настройках, не исчерпание вашего лимита, и квоту они не расходуют. Claude Code автоматически повторяет запрос до 10 раз с экспоненциальной задержкой, прежде чем что-то вам показать; дружелюбное сообщение означает, что эти повторы исчерпаны.
Решение простое: (1) подождать и повторить -> (2) сменить модель через /model (ёмкость считается по моделям) -> (3) проверить status.claude.com -> (4) /feedback, если 500 не проходит. Они отличаются от 429 (ваша скорость) и usage limit (ваш план), и 529 не несёт retry-after. Разработчикам стоит закладывать это в архитектуру через автоповтор SDK, экспоненциальную задержку + джиттер и резервную модель. Если ошибка повторяется, заподозрите инцидент и проверьте страницу статуса — в любом случае чинить какой-либо код или настройку, по сути, не нужно. Связанное: решения для usage limit, сравнение Opus/Sonnet/Haiku, сводка ошибок Claude Code.
FAQ
Q. «529 Overloaded» вызвана чем-то, что сделал я, или моим кодом?
A. Нет — это проблема на стороне сервера. 529 означает, что API Anthropic временно перегружен (затор по всем пользователям); ваш запрос, настройки и аккаунт здесь ни при чём. В документации прямо сказано: «529 — это не ваш лимит использования и не засчитывается в вашу квоту.» Обычно она проходит, если подождать немного и повторить.
Q. Мне постоянно предлагают повторить — стоит ли долбить запрос самому?
A. Как правило, нет. Claude Code уже автоматически повторяет запрос до 10 раз с экспоненциальной задержкой, прежде чем показать ошибку (Retrying in Ns · attempt x/y). Дружелюбное сообщение появилось потому, что эти 10 повторов были исчерпаны. Подождите немного, а для длинного промпта просто введите «попробуй ещё раз», чтобы перезапустить с исходным контекстом. Количество настраивается через CLAUDE_CODE_MAX_RETRIES.
Q. В чём разница между 529 и 429?
A. 529 — это перегрузка на стороне сервера (затрагивает всех; вашу квоту не расходует), тогда как 429 — это ваш собственный лимит скорости (вы превысили RPM вашего API-ключа и т. п. — речь о вашей квоте скорости). Подсказка: 429 несёт заголовок retry-after, а 529 — нет. 429 требует настройки с вашей стороны (снизить темп, поднять уровень); 529 же требует лишь «подождать и повторить» или переключения через /model.
Q. Почему переключение через /model иногда срабатывает?
A. Потому что ёмкость (затор) отслеживается по каждой модели. Даже если Opus под высокой нагрузкой, Sonnet может пройти мгновенно, если у него есть запас. Claude Code и сам иногда предлагает переключиться при нагрузке («Opus is experiencing high load, please use /model to switch to Sonnet»). Когда вы спешите, переключение на более лёгкую или другую модель через /model — быстрый обходной путь.
Q. Я постоянно получаю 529/500 без перерыва. Что делать?
A. Заподозрите активный инцидент и проверьте status.claude.com. Если опубликован сбой, всё, что вы можете, — это дождаться восстановления. Если 500 не проходит без опубликованного инцидента, сообщите об этом через /feedback, указав request_id, чтобы Anthropic мог провести разбор. Поскольку 529/500 — события на стороне сервера, чинить какой-либо код или настройку вам, по сути, не нужно.
