
Главное за минуту
- Ошибка 403 означает, что ключ API не разрешает использовать запрошенный ресурс. Проверь ключ и выбранный ресурс.
- Ошибка 529 говорит о временной перегрузке API. Официальные SDK повторяют временные сбои автоматически.
- При сообщении об ограничении мощности повтори попытку через несколько минут. Оно может не появиться на странице статуса.
Что означают 403, 529 и App unavailable
Если Claude возвращает 403, сначала проверяй разрешения ключа API. Код 529 означает временную перегрузку API. Если сообщение App unavailable связано с ограничением мощности, повтори попытку через несколько минут.
Эти сообщения указывают на разные уровни проблемы. Ошибка 403 относится к доступу ключа к конкретному ресурсу. Ошибка 529 возникает на стороне временно перегруженного API. Ограничение мощности в приложении относится к управлению текущей нагрузкой.
Не ориентируйся только на страницу состояния Claude. Anthropic отдельно поясняет, что ограничения мощности не отображаются там, поскольку считаются обычным управлением нагрузкой, а не технической неисправностью.
Если проблема возникает в API, сохрани тело ответа и идентификатор запроса. API возвращает ошибки в JSON: верхнеуровневый объект error содержит поля type и message, а ответ также включает request_id для отслеживания и отладки.
- Увидел 403: проверь, разрешено ли этому ключу API использовать указанный ресурс.
- Увидел 529: считай ошибку временной перегрузкой API и подготовь повторный запрос.
- Увидел сообщение об ограничении мощности: повтори попытку через несколько минут.
- Не увидел инцидент на странице статуса: учитывай, что ограничения мощности там не показываются.
Что подготовить перед диагностикой Claude
Для разбора ошибки API понадобятся её код, поля type и message, а также request_id. Каждый ответ API дополнительно содержит уникальный заголовок request-id, поэтому идентификатор можно взять из ответа и использовать при отладке.
Если ошибка появляется при входе в Claude, проверь условия в браузере. Справочный центр рекомендует убедиться, что доступ выполняется без VPN, отключить активные расширения, а затем очистить кэш и cookie.
Если сбой связан с длинным запросом или файлами, зафиксируй размер запроса и способ отправки. Для Messages API и Token Counting API установлен максимум 32 MB, для Batch API действует максимум 256 MB, а для Files API максимум составляет 500 MB.
Для запроса без streaming учти ограничение по длительности. SDK проверяют, что запросы к Messages API без streaming не должны предполагать ожидание дольше 10 минут.
Если ошибка произошла при streaming через SSE, не считай первоначальный статус 200 доказательством успешного завершения. При server-sent events ошибка может появиться уже после того, как API вернул ответ со статусом 200.
- Сохрани код ошибки, type и message из объекта error.
- Сохрани request_id из тела ответа или уникальный request-id из заголовка.
- Проверь размер запроса относительно лимита используемого API.
- Определи, отправлялся ли запрос со streaming или без него.
Как действовать при ошибке 403
Ошибка 403 permission_error означает, что ключ API не имеет разрешения на использование указанного ресурса. Это не то же самое, что ошибка 401: код 401 указывает на проблему с самим ключом API.
Начни с сопоставления ключа и ресурса, который указан в запросе. Проверка должна касаться именно разрешения ключа на этот ресурс, потому что официальное описание 403 связывает ошибку с отсутствием такого разрешения.
Если вместо 403 приходит 404, проверь путь эндпоинта и идентификаторы ресурсов в URL. Код 404 означает, что запрошенный ресурс не найден, поэтому его диагностика отличается от проверки разрешений при 403.
Если ответ содержит 400, не своди его к проблеме разрешений. Код 400 означает проблему с форматом или содержанием запроса. Такой же код обычно возвращается, когда использование достигает лимита расходов, установленного для организации или рабочего пространства.
Если ошибка связана с конкретным запросом и самостоятельно определить причину не удалось, приложи его идентификатор при обращении в поддержку. Anthropic рекомендует передавать этот ID, чтобы помочь разбору проблемы.
- Прочитай type и message в JSON-ответе, чтобы подтвердить тип permission_error.
- Проверь разрешение ключа API на ресурс, указанный в запросе.
- Если код изменился на 401, проверь сам ключ API.
- Если код изменился на 404, проверь путь эндпоинта и идентификаторы ресурсов в URL.
- Передай request_id поддержке, если вопрос относится к конкретному запросу.
Что делать с 529 и временными сбоями
Код 529 overloaded_error означает, что API временно перегружен. Для такого ответа уместна повторная попытка, но её нужно отличать от бесконечного немедленного повторения одного и того же запроса.
Официальные SDK автоматически повторяют временные сбои с экспоненциальной задержкой. К таким сбоям относятся ошибки соединения, ограничения скорости и серверные ошибки 5xx. По умолчанию SDK выполняют две повторные попытки.
Проверь настройку max_retries, если используешь официальный SDK. Этот параметр позволяет изменить число автоматических повторов или отключить такое поведение.
Для ошибки 500 официальная рекомендация также состоит в повторной отправке запроса с экспоненциальной задержкой. Код 500 обозначает неожиданную внутреннюю ошибку в системах Anthropic.
При ошибке 504 запрос завершился по тайм-ауту во время обработки. Для длительных запросов Anthropic предлагает рассмотреть Messages API со streaming.
При streaming отслеживай не только первоначальный HTTP-ответ. В режиме SSE ошибка способна возникнуть после ответа API со статусом 200, поэтому обработчик должен учитывать последующие события потока.
- При 529 повтори запрос как временно не выполненный из-за перегрузки API.
- Если используешь официальный SDK, учти две автоматические повторные попытки по умолчанию.
- Проверь max_retries, чтобы настроить или отключить автоматические повторы.
- При 500 используй повтор с экспоненциальной задержкой.
- При 504 рассмотри Messages API со streaming для длительного запроса.
Лимиты, из-за которых запрос может не пройти
Код 413 request_too_large появляется, когда запрос превышает максимально допустимое число байтов. Допустимый размер зависит от API, поэтому сравнивать запрос нужно с лимитом конкретного эндпоинта.
Для Messages API и Token Counting API максимальный размер запроса составляет 32 MB. Для Batch API максимум равен 256 MB, а для Files API установлен предел 500 MB.
Если Claude сообщает об ошибке длины, прикрепи меньше файлов, уменьши их размер или начни новый разговор. Это варианты, которые рекомендует справочный центр Claude.
На платных тарифах с включённым выполнением кода Claude автоматически управляет длинными разговорами. При приближении к пределу контекста сервис суммирует ранние сообщения.
Предупреждение Approaching 5-hour limit появляется, когда пользователь приближается к ограничению своего тарифа в пределах пятичасовой сессии. Это предупреждение относится к лимиту использования, а не к разрешению ключа API.
Ошибка 429 может означать достижение лимита скорости, месячного потолка расходов уровня использования или лимита расходов в рабочем пространстве Claude Code. Поэтому при 429 проверь, какой именно лимит указан в сообщении.
- При 413 уменьши запрос до предела того API, который используешь.
- При ошибке длины прикрепи меньше файлов.
- При ошибке длины уменьши размер прикреплённых файлов.
- При ошибке длины начни новый разговор.
- При 429 проверь лимит скорости, месячный потолок расходов и лимит расходов Claude Code.
Коды ошибок и ограничения Claude API
| Код или ограничение | Что означает и что проверить |
|---|---|
| 400 | Проблема с форматом или содержанием запроса; код также обычно возвращается при достижении установленного лимита расходов. |
| 401 | Проблема с ключом API. |
| 402 | Проблема с платёжной или биллинговой информацией. |
| 403 | Ключ API не имеет разрешения на использование указанного ресурса. |
| 404 | Ресурс не найден; проверь путь эндпоинта и идентификаторы ресурсов в URL. |
| 413 | Запрос превышает максимально допустимое число байтов. |
| 429 | Достигнут лимит скорости, месячный потолок расходов или лимит расходов Claude Code. |
| 500 | Внутренняя ошибка Anthropic; повтори запрос с экспоненциальной задержкой. |
| 504 | Истёк тайм-аут обработки; для длительных запросов рассмотри Messages API со streaming. |
| 529 | API временно перегружен. |
| Messages API | Максимальный размер запроса составляет 32 MB. |
| Token Counting API | Максимальный размер запроса составляет 32 MB. |
Когда проблема связана с моделью или параметрами
Код 400 может указывать на формат или содержимое запроса, поэтому после проверки лимита расходов посмотри на параметры выбранной модели. Некоторые возможности зависят от конкретной версии Claude.
Claude 4.6 и более поздние модели, а также Claude Mythos Preview не поддерживают prefill сообщений ассистента. Если запрос использует prefill с одной из этих моделей, убери неподдерживаемую конструкцию перед повторной отправкой.
Claude 4.7 и более поздние модели не поддерживают extended thinking. При диагностике запроса к этим моделям проверь, не передаётся ли удалённая возможность.
Параметр thinking с типом between_tools поддерживается только Claude Sonnet 5.5. Отправка thinking: {"type": "between_tools"} другой модели возвращает 400 invalid_request_error.
Не переносись автоматически с одного кода на другой сценарий. Для 403 проверяются разрешения ключа, для 400 формат, содержимое, установленный лимит расходов и совместимость параметров, а для 529 учитывается временная перегрузка API.
- Проверь, поддерживает ли выбранная модель prefill сообщений ассистента.
- Проверь использование extended thinking с Claude 4.7 и более поздними моделями.
- Передавай between_tools только Claude Sonnet 5.5.
- После исправления параметров повторно прочитай type и message в JSON-ответе.
Как отличить общий инцидент от локальной ошибки
Страница Claude Status помогает проверить опубликованные инциденты сервиса, но не отражает ограничения мощности. Если сервис предлагает повторить попытку из-за мощности, подожди несколько минут даже тогда, когда на странице состояния нет технической проблемы.
Опубликованные инциденты могут затрагивать не только генерацию ответов. Например, 1 октября 2026 года была устранена задержка, из-за которой купленные кредиты Claude Platform применялись не сразу.
Известны и более широкие сбои. 29 июля Anthropic начала расследовать отключение Claude в 7:49 p.m. UTC.
Если статус не сообщает об инциденте, продолжи локальную проверку по коду ошибки. Для входа отключи VPN и расширения браузера, очисти кэш и cookie. Для API проверь type, message, request_id, размер запроса, разрешения ключа и совместимость параметров модели.
Перед новой попыткой проверь официальную страницу состояния и актуальные условия сервиса. Лимиты использования, доступность функций моделей и текущие инциденты могут относиться к разным причинам ошибки.
- Проверь страницу состояния Claude на опубликованный инцидент.
- Если сообщение относится к ограничению мощности, повтори попытку через несколько минут.
- Если инцидента нет, не исключай ограничение мощности: оно не отображается на странице статуса.
- Если проблема сохраняется в конкретном API-запросе, подготовь request_id для поддержки.
Частые вопросы
Почему Claude API возвращает 403?
Код 403 permission_error означает, что ключ API не имеет разрешения на использование ресурса, указанного в запросе.
Нужно ли менять ключ API при ошибке 403?
Сначала проверь разрешение ключа на конкретный ресурс. Проблема с самим ключом обозначается отдельным кодом 401.
Что делать при ошибке 529?
529 означает временную перегрузку API. Официальные SDK автоматически повторяют временные сбои дважды по умолчанию с экспоненциальной задержкой; поведение настраивается через max_retries.
Почему App unavailable не отображается на странице статуса?
Если сообщение связано с ограничением мощности, оно может не отображаться на странице статуса: Anthropic относит такие ситуации к обычному управлению нагрузкой. Повтори попытку через несколько минут.
Почему ошибка появилась после ответа 200?
При streaming через SSE ошибка может возникнуть уже после того, как API вернул первоначальный ответ со статусом 200.
Что приложить к обращению в поддержку Anthropic?
Приложи идентификатор конкретного запроса. Ответ об ошибке содержит request_id, а каждый ответ API также получает уникальный заголовок request-id.
Что делать, если Claude сообщает о слишком длинном запросе?
Прикрепи меньше файлов, уменьши их размер или начни новый разговор. Для API также сравни размер запроса с лимитом выбранного эндпоинта.
Источники и проверка
- Errores de la Claude API, platform.claude.com (первоисточник). Прочитано 4 октября 2026.
- Claude Status, status.claude.com (первоисточник). Прочитано 4 октября 2026.
- Troubleshoot Claude error messages | Claude Help Center, support.claude.com (первоисточник). Прочитано 4 октября 2026.
- Anthropic confirms Claude is down worldwide, bleepingcomputer.com. Прочитано 4 октября 2026.
Подготовлено с помощью ИИ по первоисточникам и проверено автоматически: факты, числа и цитаты сверены с источниками. Человек статью перед выходом не читал. Если нашёл ошибку, напиши через контакты.