Claude errors: коды ошибок и сообщения интерфейса в 2026

Почти любая техническая ошибка Claude сводится к одному из трёх: серверы перегружены, вы упёрлись в лимит своего тарифа, или что-то не так с ключом либо самим запросом. Различить их можно за секунды, если знать код или текст сообщения. Ниже разбор по всем кодам из официальной документации Anthropic, сообщений в чате и в Claude Code, плюс что делать в каждом случае.

Речь именно про технические сбои. Если Claude отвечает, но отвечает плохо (путает факты, выдумывает), это другая история, её мы разбирали в статье про то, почему нейросеть ошибается по смыслу.

Сообщения об ошибках в чате claude.ai

В веб-интерфейсе и приложении вы видите не коды, а текст. Вот что документирует справка Anthropic.

«Due to unexpected capacity constraints, Claude is unable to respond to your message»

Перевод: серверы сейчас перегружены спросом. Это самое частое сообщение и главный источник паники. Важное уточнение из справки: capacity constraints, это не авария и не блокировка вашего аккаунта. Сервис работает, он просто распределяет нагрузку и придерживает часть запросов. Обычно проходит за минуты. Платный тариф даёт приоритет в часы пика, но не отменяет перегрузку полностью.

«5-hour limit reached - resets [время]»

Вы израсходовали свою квоту в пятичасовом окне. Это ваш лимит, а не сбой. В сообщении указано время сброса, до него остаётся ждать либо (на платных тарифах с включёнными usage credits) продолжать работу за отдельную оплату. Есть и предупреждение заранее: «Approaching 5-hour limit».

«Your message will exceed the length limit for this chat»

Диалог упёрся в максимальную длину. Лечится не ожиданием, а действием: разбить текст на части, попросить краткую выжимку важного и начать новый чат, скормив в него эту выжимку.

Ошибка входа

Здесь справка советует по порядку: отключить VPN, выключить расширения браузера, очистить кэш и куки, проверить status.claude.com на активные инциденты. Для пользователей из России пункт про VPN коварен: без него не пустит вовсе, а с «шумным» сервером может выкидывать при входе. Подробный разбор доступа: что делать, если Claude не работает.

Коды ошибок API: что значит каждый

Если вы обращаетесь к Claude через API (свой код, бот, сторонний клиент), в ответ приходит HTTP-код и JSON с полем type. Полный список кодов документирован, выдумывать их не нужно:

• 400 invalid_request_error: проблема в формате или содержимом самого запроса. Повторять бессмысленно, пока не поправите тело запроса.
• 401 authentication_error: беда с API-ключом. Он неверный, отозван или истёк.
• 402 billing_error: вопрос к оплате и платёжным данным в консоли.
• 403 permission_error: ключ есть, но прав на этот ресурс у него нет. Проверьте настройки организации и workspace.
• 404 not_found_error: не найден ресурс. Обычно опечатка в пути эндпоинта или в id.
• 409 conflict_error: запрос конфликтует с текущим состоянием ресурса (например, значение должно быть уникальным, а оно занято).
• 413 request_too_large: запрос больше допустимого размера. Для Messages API это 32 МБ, для Batch API 256 МБ, для Files API 500 МБ.
• 429 rate_limit_error: вы упёрлись в лимит скорости своего аккаунта.
• 500 api_error: внутренняя ошибка на стороне Anthropic. Повторять с экспоненциальной задержкой.
• 504 timeout_error: запрос не успел обработаться. Документация советует использовать стриминг для долгих запросов.
• 529 overloaded_error: API временно перегружен.

Все ошибки приходят JSON-ом с полем request_id (тот же идентификатор есть в заголовке ответа request-id, выглядит как req_018EeWyXxfu5pfWkrYcMdjWG). Если пишете в поддержку, этот id, единственное, что реально ускорит разбор. Что такое API и как подключить его из России, разбирали отдельно.

По теме: Claude status: как проверить статус и доступность Claude в 2026

429 против 529: главная путаница

Эти два кода постоянно путают, а действия при них противоположные.

429, это про вас. Ваш аккаунт превысил лимит скорости. В ответе смотрите заголовок retry-after: если он есть, ждите ровно столько, сколько там указано. Отдельный нюанс из документации: если организация резко нарастила потребление, 429 может прилететь из-за acceleration limits, то есть из-за самой скорости роста трафика. Лечение: наращивать нагрузку плавно и держать ровный профиль потребления.

529, это про них. API перегружен трафиком всех пользователей сразу. В вашем коде чинить нечего, помогает только повтор через пару секунд или проверка страницы статуса. Полезная деталь: отклонённые 529 запросы не тарифицируются.

Официальные SDK, кстати, уже умеют это сами: они повторяют временные сбои (обрывы соединения, rate limits, 5xx) с экспоненциальной задержкой, по умолчанию дважды, и уважают заголовок retry-after. Число повторов настраивается опцией maximum-retries.

Прежде чем чинить код, откройте status.claude.com. Половина «моя интеграция сломалась» на деле оказывается инцидентом на стороне сервиса, который отпустит сам через десять минут.

Ошибки Claude Code

У консольного инструмента свой справочник ошибок. Самые частые и что с ними делать по официальной инструкции:

• Repeated 529 Overloaded: проверить страницу статуса, подождать, при необходимости переключить модель командой /model.
• Request rejected (429): проверить, какой ключ активен, командой /status, снизить параллельность запросов, запросить более высокий тариф лимитов.
• Prompt is too long: контекст переполнен. Команды /compact (сжать диалог), /clear (начать заново), /context (посмотреть, что именно съело контекст). Отключение неиспользуемых MCP-серверов тоже освобождает место.
• Invalid API key: проверить опечатки, убедиться, что ключ не отозван в консоли, убрать переменную ANTHROPIC_API_KEY и зайти через /login.
• Unable to connect to API: проверить связь командой curl -I https://api.anthropic.com, настроить прокси через HTTPS_PROXY, проверить фаервол.
• Credit balance is too low: пополнить баланс или перейти на подписку через /login.

Отдельно про упор в тариф: сообщение «You've hit your session/weekly limit» лечится ожиданием сброса, а посмотреть, сколько осталось, можно командой /usage. Как устроены эти квоты, подробно в разборе лимитов и токенов Claude Code. Универсальная диагностика на все случаи: claude doctor.

По теме: Заблокировали Claude: что делать и как подать апелляцию

Почему обрывается длинный ответ

Обрыв на середине длинного ответа обычно не про ошибку модели, а про сеть и время. Документация Anthropic прямо предупреждает: не ставьте большой max_tokens без стриминга. Часть сетей рвёт простаивающие соединения, и запрос отваливается по таймауту, так и не получив ответа. Для запросов дольше 10 минут рекомендуется streaming Messages API или Message Batches API, где результат можно опрашивать, не держа соединение открытым.

Ещё тонкость: при стриминге ошибка может прийти уже после того, как API вернул код 200. Такие ошибки приходят событиями внутри потока и обычной обработкой кодов не ловятся. А в Claude Code на обрыв ответа есть простой приём из документации: прочитать то, что успело прийти, и ответить словом continue, чтобы модель продолжила с места разрыва.

Порядок действий при любой ошибке

1. Прочитайте текст ошибки целиком. В нём почти всегда есть либо код, либо прямое указание причины. Скриншот с обрезанным сообщением, худший вход в диагностику.
2. Определите сторону. 429, лимиты, 401, 400, 413, это ваша сторона. 500, 529, capacity constraints, это сторона сервиса.
3. Если сторона сервиса: откройте status.claude.com и подождите. Ничего чинить не нужно.
4. Если ваша сторона: сверьте код со списком выше и действуйте точечно. При 429 смотрите retry-after, при 401 перевыпустите ключ, при 400 правьте запрос.
5. При ошибке входа из России: сначала попробуйте другой сервер VPN и режим инкогнито, потом уже всё остальное.
6. Если сбой повторяется и это API, сохраните request_id и приложите его к обращению в поддержку.

Частые вопросы

Ошибка 529 означает, что меня заблокировали?

Нет. 529 overloaded_error относится к нагрузке на API целиком, а не к вашему аккаунту. Отклонённые по этой причине запросы даже не тарифицируются. Ждите и повторяйте.

Поможет ли платная подписка от ошибок?

Частично. Платные тарифы дают более высокие лимиты и приоритет в часы пика, поэтому 429 и сообщения о пятичасовом лимите вы увидите реже. Но перегрузку серверов (529 и capacity constraints) подписка не отменяет: в сильные пики их ловят и платные пользователи.

Почему ошибки чаще приходят в определённое время?

Нагрузка неравномерна в течение суток: пик приходится на рабочие часы американского побережья. Практический вывод простой: тяжёлые задачи лучше запускать в наше утро.

Что делать при «Prompt is too long»?

Это не сбой, а переполненный контекст. В Claude Code: /compact для сжатия диалога или /clear для чистого старта, /context покажет, что занимает место. В чате: попросить выжимку и перенести её в новый диалог.

Стоит ли писать в поддержку?

При 529, capacity constraints и упоре в лимит, нет, они пройдут сами. Есть смысл писать при устойчивых 500, при 402 и 403, которые не объясняются вашими настройками, и вообще при любой ошибке, которая повторяется несколько дней. К обращению приложите request_id.