Claude Code 500, 529 и лимиты: сначала выберите правильную ветку восстановления

Если Claude Code показывает 500, 529 или сообщение про лимит, не начинайте с хаотичных retry или смены плана. Это разные ветки восстановления: 500 сначала ведет к status check, повторяющийся 529 сначала ведет к перегрузке, а 429 или явное usage wording ведет к проверке лимитов.

Главная ловушка - 529. В документации Claude Code он описан как перегрузка, а не как ваш личный лимит и не как сигнал срочно покупать больше usage. Сначала прочитайте точную строку терминала.

Сначала ветка, потом теория

Claude Code связывает runtime errors с кодами Claude API и автоматически повторяет часть transient failures до того, как вы увидите сообщение. Значит, видимая строка - это уже не самое начало сбоя. Это момент, когда нужен выбор ветки.

Полезный вопрос звучит не "Claude сейчас упал?" и не "у меня закончилась квота?". Полезный вопрос: к какому документированному классу относится эта строка? 500 ведет к status check, короткой паузе и одному same-path retry. Повторяющийся 529 ведет к capacity branch. Настоящий 429 ведет к API key и provider limits. Session или weekly limit ведет к usage window. Route mismatch требует /status до выводов о плане.

Состояние тоже нужно датировать. На проверке 20 апреля 2026 года Claude Status показывал operational для Claude API и Claude Code, но история статуса содержала уже решенные incidents 20 апреля и 15 апреля. Это не доказывает, что текущая ошибка локальная. Это доказывает, зачем сначала нужен status, а затем same-path verification.

Ветка 500: status, короткая пауза, один retry

Anthropic API docs сопоставляют HTTP 500 с api_error. Claude Code error reference показывает API Error: 500 Internal server error как infrastructure-side проблему, а не как следствие prompt, настроек или аккаунта.

Минимальная последовательность:

• Проверьте Claude Status.
• Подождите коротко и повторите тот же command или message один раз.
• Не меняйте одновременно model, auth route, shell profile и prompt.
• Если incident не опубликован, а тот же path все равно падает, сохраните детали и используйте /feedback или support route.

Если точный симптом - устойчивый API Error: 500, продолжайте в руководство по Claude Code API Error 500. Эта ветка только защищает от ошибки: лечить 500 как 529 или rate limit.

Ветка 529: перегрузка, а не ваш usage limit

Документация Claude Code прямо говорит: повторяющийся 529 означает capacity pressure across users, Claude Code уже сделал retry, а 529 не является вашим usage limit и не считается в quota.

Первый шаг не upgrade. Более безопасный порядок:

• Проверить status на capacity notices.
• Подождать несколько минут.
• Использовать /model только если task допускает другой model.
• Проверить ту же session и route после короткого cool-down.

Если repeated 529 возвращается после этих проверок, переходите к руководству по Claude Code overloaded error. Не называйте 529 rate limit: 529 overloaded_error и 429 rate_limit_error ведут к разным действиям.

Ветки лимитов: 429, temporary limiting, session windows

"Лимит" в Claude Code может означать три разные вещи.

Первая - настоящий API 429 rate_limit_error. Он относится к API key, Bedrock project, Vertex project, provider limits, concurrency, model limits и retry-after. Для этой ветки используйте Claude Code rate limit guide.

Вторая - сообщение Claude Code Server is temporarily limiting requests (not your usage limit). Это short-lived throttle: подождите, проверьте status при повторении, затем снова выполните ту же route. Это не доказательство исчерпанного плана.

Третья - реальное usage window: session limit, weekly limit, Opus limit или reset wording. Эта ветка относится к /usage, reset timing и плану. Для нее нужны rate-limit reached guide и usage limits diagnosis.

Ветка route override: проверьте auth до выводов о плане

Claude Help по API key environment variables говорит, что ANTHROPIC_API_KEY имеет приоритет над authenticated subscription, а /status показывает активный auth method. Поэтому проверка route - часть восстановления.

Используйте non-secret проверку:

• Запустите /status внутри Claude Code.
• Проверьте, задан ли ANTHROPIC_API_KEY, но не вставляйте ключ никуда.
• Подтвердите, идет ли запрос через subscription auth, direct API, Bedrock, Vertex или proxy.
• Повторите тот же request на intended route.

Если результат изменился после correction route, настоящей проблемой был route mismatch. Если intended route все еще падает с той же веткой, evidence становится чище.

Что сохранить перед эскалацией

Anthropic API errors могут содержать top-level request_id, а API response может иметь request-id header. В Claude Code также есть /status, /model, /usage и /feedback.

Сохраните короткий пакет:

• точную строку терминала с 500, 529, 429 или полным limiting message;
• время и timezone;
• результат Claude Status в тот момент;
• active route из /status;
• model и факт изменения /model;
• результат same-path retry;
• request ID или feedback context, если доступен.

После branch match, минимального действия и same-path verification не продолжайте случайные изменения. Чистый support packet полезнее.

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

Claude Code 529 - это rate limit?

Нет. В Claude Code повторяющийся 529 документирован как overload. Настоящий API rate limiting - это 429 rate_limit_error; temporary limiting и plan-window wording отдельно.

Что делать первым при Claude Code API Error 500?

Проверьте Claude Status, подождите коротко и повторите тот же command один раз. Если incident не опубликован, а тот же path все еще падает, сохраните детали и переходите к 500 guide или /feedback.

Что если Claude Status зеленый, но Claude Code падает?

Зеленый status исключает только опубликованный live incident. Все еще нужно проверить точный error, auth route, model и same-path retry.

Как понять, что API key перекрывает subscription?

Запустите /status и проверьте, установлен ли ANTHROPIC_API_KEY в shell или environment. Не раскрывайте сам ключ.

Нужно ли upgrade при 529?

Нет, не как первое действие. Repeated 529 - overload branch. Upgrade относится к явному plan-limit или usage-window wording.