Если Claude Code показывает API Error: 529, относитесь к этому прежде всего как к перегрузке, а не как к сигналу о том, что у вас внезапно закончился личный лимит. В официальных Anthropic API docs код 529 определен как overloaded_error, поэтому первый вопрос здесь не про plan, cost или upgrade. Первый вопрос такой: вы видите live incident, зеленый статус при том же path, ошибочно читаете 429 как 529, или Claude Code вообще идет не по тому auth route, который вы предполагали?
Сначала проверьте Claude Status, а затем используйте /status вместе с environment variables, чтобы понять, каким путем Claude Code реально отправляет запросы. Если статус зеленый, не превращайте это в хаотичную серию изменений. Гораздо полезнее сделать один короткий same-path retry или route check и понять, восстанавливается ли именно тот path, который падал.
Если статус и route уже проверены, а тот же path продолжает отдавать 529, не относитесь к этому как к локальной задаче «еще немного подкрутить». Сохраните точный текст ошибки и любой request_id, затем эскалируйте с чистой историей. Ошибки Anthropic, status surface и Claude Code help pages были повторно проверены 11 апреля 2026 года; в тот момент публичный статус был зеленым. Это не отменяет ветку перегрузки. Это только делает следующую проверку уже.
Маршрут за 30 секунд
API Error: 529 лучше рассматривать как задачу маршрутизации, а не как общую теорию о том, почему Claude Code сегодня ведет себя странно. Главный вопрос звучит так: в какой ветке вы находитесь сейчас, и какой минимально правильный ход нужен именно там? Начните с коррекции кода ошибки: если в логе реально 429, здесь уже не ваша страница. Если это действительно 529, оставайтесь в overload playbook.
| Что вы видите | Кто, скорее всего, владеет проблемой | Самый безопасный первый шаг | Что проверять на том же path | Когда пора эскалировать |
|---|---|---|---|---|
На самом деле это 429 или usage warning, а не 529 | Rate-limit или usage branch, а не настоящая overload recovery | Переключиться на rate-limit / usage diagnosis, не продолжая retry по 529 сценарию | Подтвердить точный код и понять, не упираетесь ли вы в plan или API usage | После проверки выясняется, что код все же 529 |
| Claude Status красный или активен новый incident | Перегрузка или деградация на стороне Anthropic | Перестать менять локальные настройки и дождаться восстановления | Повторить тот же path после окончания incident | Статус зеленый, а тот же path все еще возвращает 529 |
| Status зеленый, но тот же path все равно дает 529 | Временная или локализованная перегрузка | Сделать один bounded same-path retry с короткой паузой | Убедиться, восстановился ли именно тот path без лишних изменений | Несколько коротких retry на том же path все еще заканчиваются 529 |
| Claude Code может идти через API key, proxy или другой provider route | ANTHROPIC_API_KEY, proxy path или неверно понятый auth owner | Проверить /status, env variables и route config | Сравнить тот же запрос на intended route | После возврата на intended route ошибка с текущими evidence остается |
Эта таблица и есть практическая ценность страницы. Все остальное нужно только затем, чтобы вы уверенно выбрали строку и не начали лечить другую проблему. Чаще всего время теряется не из-за отсутствия советов, а из-за того, что читатель слишком рано берет неправильную ветку и делает много «энергичных», но малоинформативных шагов.
Что означает 529 и почему это не 429
Anthropic в API error docs различает эти коды прямо: 429 это rate_limit_error, а 529 это overloaded_error. Для читателя оба ответа могут выглядеть как «Claude Code меня не пускает дальше». Для восстановления это не одна и та же история.
Если код действительно 529, разумнее всего сначала исходить из перегрузки сервиса. Значит, важнее проверить статус, удержать тот же route и сделать короткий retry, чем уходить в квоты, биллинг или смену плана. Если код оказывается 429, тогда вы уже в другой ветке. В этом случае полезнее перейти к гайду по Claude Code token usage или к более узкому гайду по Claude Code rate limit reached.
Эта путаница возникает потому, что пользователи часто помнят только ощущение «меня ограничили», но не сам код. Для операционного решения код важнее впечатления. 529 не доказывает, что исчерпан ваш личный лимит, а 429 не становится перегрузкой только потому, что сервис выглядит занятым.
Поэтому самый полезный практический рефлекс простой: прежде чем менять что-то дорогое или разрушительное, проверьте точный код. Если вы видите 529 или overloaded_error, продолжайте читать эту страницу. Если это 429 или явное quota warning, переключайте playbook сразу.
Если Claude Status показывает incident прямо сейчас
Status идет первым, потому что он может сэкономить целый раунд бессмысленной локальной отладки. Если Claude Status красный для Claude API, Claude Code, login или соседних компонентов, самый безопасный ход обычно состоит в том, чтобы перестать менять локальную среду и дождаться восстановления.
Этот совет легко недооценить, потому что ошибка возникает в вашем терминале, в вашем репозитории и под вашим аккаунтом. Но если реальный incident активен, переустановка, перепривязка route, повторный login и хаотичная смена credentials чаще добавляют шум, а не ускоряют recovery.
Что действительно полезно в этой ветке: сохранить точный текст ошибки, отметить время и не потерять request_id, если он есть. Anthropic пишет в docs, что error responses включают request_id, а обычные API responses несут request-id header. Когда incident закрыт, вернитесь к тому же самому path, который падал раньше, и проверьте его снова. Только same-path verification говорит, был ли incident всей историей или только ее частью.
Но эта ветка не должна разрастись в универсальное объяснение. Как только статус снова зеленый, вопрос меняется. Теперь нужно не «подождать еще», а выяснить, почему именно ваш path не вернулся к норме.
Если статус зеленый, а тот же path все равно возвращает 529
Зеленый status не означает, что пора начинать случайно менять plan, auth method или shell config. Он означает только то, что live-incident branch больше не выглядит главным объяснением. Ветка overload при этом не исчезает.
Это самая раздражающая ситуация: официальный код говорит о перегрузке, публичный статус выглядит спокойным, а терминал все равно ломается. В этом месте полезны issue threads вроде #3558 и #3572. Они не доказывают одну универсальную причину, но показывают, что повторяющийся 529 в Claude Code при визуально здоровом статусе не является выдумкой пользователя.
Правильный первый ход здесь — сделать один bounded same-path retry. Коротко подождите и повторите тот же action на том же route. Не меняйте одновременно model, billing path, auth route и session state. Иначе вы лишите себя главного диагностического сигнала: вы уже не поймете, восстановился ли исходный path сам или вы просто переключились на другую ветку.
Именно здесь читатели часто совершают слишком крупные шаги слишком рано: reinstall, upgrade plan, массовая правка env variables, новый auth flow. Эти шаги могут когда-нибудь помочь, но они плохо отвечают на самый важный вопрос: восстановился ли тот же самый path после короткой паузы?
Если несколько bounded retry на том же path все равно заканчиваются 529, прекращайте превращать overload symptom в длинный local-debug marathon. Сохраняйте evidence и эскалируйте. Зеленый статус плюс повторяемый same-path failure уже сам по себе делает ваш support case более четким.
Если вы на самом деле оказались на usage или API-key route
529 troubleshooting часто уходит не туда еще и потому, что пользователи уверены: Claude Code точно работает по тому auth route, который они держат в голове. Anthropic в help guidance для Pro / Max прямо говорит: если в окружении есть ANTHROPIC_API_KEY, Claude Code использует этот ключ вместо subscription auth. Этого одного факта достаточно, чтобы объяснить многие запутанные расследования.
Если вы уверены, что тестируете subscription path, но shell экспортирует ANTHROPIC_API_KEY, не делайте выводы о plan limits или общей доступности сервиса слишком рано. Сначала проверьте /status, текущую среду и реальный route. Ошибка в понимании active path делает все последующие выводы ненадежными.
То же относится к proxy, wrapper или alternate provider route. Безопасный первый ход здесь не состоит в provider shopping. Сначала вернитесь к intended route, очистите неверные предположения и повторите тот же запрос там, где вы изначально хотели его тестировать. Если после удаления неожиданного API key или возврата к intended auth path ошибка исчезает, значит настоящей веткой был route mismatch. Если intended path все равно дает 529, перегрузка остается лучшей рабочей гипотезой.
Эта секция тоже должна оставаться узкой. Если дальше выясняется, что настоящая проблема в usage exhaustion, shared-plan drain или API tier behavior, лучше перейти к гайду по диагностике Claude Code usage limits. Если же реальный симптом это 500, правильнее уйти в отдельный материал по Claude Code API Error 500.
Как проверить фикс и когда эскалировать
Скорость восстановления 529 резко растет, когда вы перестаете спрашивать «что-нибудь изменилось?» и начинаете спрашивать «восстановился ли этот конкретный path после одного конкретного действия?». Именно поэтому same-path verification так важен. Он одновременно защищает вас от blind retries, неосознанного branch switching и слабых support reports.
Перед эскалацией соберите минимальный полезный пакет evidence с того же failing path:
- точный текст ошибки, включая
529илиoverloaded_error - любое значение
request_idилиrequest-id - что показывал Claude Status в момент сбоя
- был ли это bounded retry на том же path, возврат на intended route или исходно неправильный route
- минимальные reproduction steps или relevant
/statusoutput
Этот список короткий намеренно. Support важнее чистая воспроизводимая история, чем длинный дневник всех случайных попыток. Формулировка вроде «зеленый status, тот же path после короткого retry все еще дает 529, request_id приложен» полезна. Формулировка вроде «я много чего менял, но проблема осталась» почти не помогает.
Граница эскалации тоже проста: если status checked, route checked, bounded retry done, а тот же path все еще отдает 529, прекращайте импровизацию. В этот момент ценнее не очередная попытка, а аккуратная передача доказательств.
Frequently Asked Questions
Claude Code API Error: 529 и 429 rate_limit_error это одно и то же?
Нет. Anthropic в API error docs определяет их как разные типы ошибок. 429 относится к rate limits, 529 — к overload.
Почему я все еще вижу 529, когда Claude Status зеленый?
Потому что зеленый публичный статус исключает только live-incident branch. Он не гарантирует, что именно ваш Claude Code path уже восстановился. Следующий полезный шаг — короткий same-path retry или route check, а не случайные локальные изменения.
Нужно ли сразу менять plan или покупать больше usage?
Нет, не как первый ход. 529 сначала означает overload, а не личное исчерпание квоты. Сначала уточните код и active route, а уже потом думайте про plan и billing.
Что проверить, если я ожидал subscription path, а Claude Code ведет себя иначе?
Проверьте, установлен ли ANTHROPIC_API_KEY, и используйте /status вместе с env variables, чтобы подтвердить активный route. Anthropic прямо пишет, что этот ключ перекрывает subscription auth.
Что именно отправлять в support?
Точный текст ошибки, любой request_id, результат status check, path который вы тестировали, и минимальные reproduction steps. Цель не в том, чтобы рассказать всю историю, а в том, чтобы убрать неоднозначность.
Рабочее правило
Claude Code API Error: 529 лучше лечить как overload-first проблему, а не как загадку про личный лимит. Сначала Status, потом стабильный path, один bounded move, проверка на том же path и только потом эскалация с evidence, если путь все еще падает.