Если Claude Code показывает 500, повторяющийся 529 или предупреждает, что ответ может быть неполным, не отправляйте всю задачу заново. Обрыв ответа не доказывает, что изменения файлов, shell-команды или внешняя запись не произошли. Повтор запроса может второй раз запустить уже завершённые tool calls.
Сначала определите ветку ошибки, дождитесь восстановления нужного service path, возобновите ту же сессию и сверьте фактическое состояние. Только после этого отправляйте continue. 500 — это api_error, повторяющийся 529 — общая перегрузка, а mid-response notice означает: завершённые blocks сохранены, но последний block мог оборваться.
Главная ловушка - 529. В документации Claude Code он описан как перегрузка, а не как ваш личный лимит и не как сигнал срочно покупать больше usage. Сначала прочитайте точную строку терминала.
| Точная строка | Считайте это | Первый шаг | Проверка на том же path | Когда идти глубже |
|---|---|---|---|---|
500 до начала вывода | внутренняя ошибка сервиса | Проверить Claude Status и подождать | Та же session, auth route и model | Ошибка остаётся без опубликованного incident |
Повторяющийся 529 до начала вывода | capacity overload across users | Проверить status и подождать; /model только если task это допускает | Та же session и route после cool-down | Повторяется после status и route checks |
Server error mid-response, закрытое соединение или stalled stream | часть turn уже завершена | Не повторять всю задачу; прочитать сохранённый вывод и проверить state | Возобновить ту же session и отправить continue после сверки | Нельзя установить, завершился ли tool или внешний write |
429 | лимит API key или provider | Проверить окно ожидания, Console limits, model limits и активный API path | Retry только после окна или correction path | Headers или Console все еще показывают исчерпанные limits |
Server is temporarily limiting requests, session limit, weekly limit | Claude Code throttle или usage window | Cool down или проверить plan/session window | Вернуться к тому же workflow после изменения окна | Сообщение прямо называет plan или reset window |
| Лимиты не похожи на ваш аккаунт | не тот путь авторизации | Запустить /status, проверить ANTHROPIC_API_KEY или proxy | Подтвердить intended subscription или API-key path | Тот же path все равно падает с чистой веткой |
Сначала ветка, потом теория
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 до выводов о плане.
Состояние нужно датировать. При проверке 4 августа 2026 года Claude Status показывал operational для Claude API и Claude Code, а история содержала уже решённые model incidents от 3 августа. Это не доказывает, что текущая ошибка локальная: live status — только первая проверка перед сверкой session и фактического state.
Ветка 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 ведут к разным действиям.
Возобновите исходную сессию, а не пересказывайте задачу
Текущий справочник ошибок Claude Code отдельно описывает сбой после начала ответа. При server error mid-response, закрытом соединении или stalled stream Claude Code сохраняет полностью завершённые blocks и отбрасывает оборванный финальный block. Предупреждение существует именно потому, что повторная отправка может выполнить те же инструменты дважды.
Если интерфейс остался открыт, прочитайте сохранённую часть. Завершённый edit, результат command, тест или шаг deployment — это повод проверить state, а не считать весь план выполненным. После восстановления сервиса отправляйте continue только после сверки.
Если процесс завершился, перейдите в исходный каталог проекта:
bashclaude --continue claude --resume
claude --continue открывает последнюю session текущего каталога, а claude --resume — picker. Документация sessions говорит, что восстанавливается история, включая tool calls и results. Новая session с пересказом по памяти теряет именно те данные, которые нужны для защиты от дублей.
Не возобновляйте одну session в двух терминалах: сообщения могут перемешаться в одном transcript. Для альтернативной ветки создайте явный fork, не второго исполнителя на том же state.
Сверьте побочные эффекты до команды continue
Conversation показывает намерение, а реальные owners показывают результат.
| Возможный эффект | Что проверить | Безопасное решение |
|---|---|---|
| Прямой edit файла | git status --short, git diff -- <path>, содержимое | Сохранить или осознанно отменить edit, не заказывать его повторно |
| Bash изменил файлы | working tree, generated files, output, timestamps | Считать command потенциально завершённым: checkpoint мог его не записать |
| Test, build или migration ещё работают | терминал, процессы, lock files, отчёт, migration table | Дождаться или остановить явно; не запускать копию |
| Commit или branch | git status, текущая branch, git log -1 --oneline | Продолжать от наблюдаемого Git state |
| CI, deployment, ticket, API или database write | run/deployment/request ID, запись, idempotency key | Проверить у внешнего owner; обрыв stream не равен отказу |
Минимальная read-only проверка Git:
bashgit status --short git diff --stat git diff git log -1 --oneline
Она не доказывает remote state. Если turn мог создать PR, deployment, запись базы, сообщение или платёж, проверьте соответствующую систему. Новая локальная session не отменяет уже принятую внешнюю операцию.
После сверки отправьте ограниченную инструкцию:
textСначала перечисли завершённые tool calls из оборванного turn и сопоставь их с текущим working tree и внешним state, который я предоставлю. Не повторяй commands и не делай внешних изменений. Назови один следующий шаг и жди подтверждения.
Checkpoint помогает с edit, но не является журналом транзакций
Checkpointing сохраняет snapshots для прямых file-editing tools и остаётся доступным после resume, поэтому /rewind полезен для подтверждённо неверного edit.
Официальные ограничения исключают Bash changes, большинство background subagent edits, параллельные ручные изменения и некоторые linked paths. Checkpoint не откатывает deployment, API, database, message или payment. Для файлов нужен Git, для удалённых действий — audit trail их владельца.
Сначала установите, что именно надо отменить. Blind rewind, за которым следует blind replay, создаёт новый дубль вместо определённости.
Ветки лимитов: 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.
Можно ли повторить всю задачу после outage?
Не при сообщении о неполном ответе. Возобновите ту же session, прочитайте сохранённые blocks, сверьте local и remote state, затем отправьте ограниченный continue.
/rewind отменяет shell-команды и deployment?
Нет. Checkpoint покрывает поддерживаемые прямые file edits, но не Bash и remote side effects. Git, процессы, CI, deployment, API и database проверяются отдельно.
