Source: https://aiprimetech.io/ru/claude-code/errors/ [Главная](/ru/) › [Claude Code](/ru/claude-code/) › Ошибки [Обзор](/ru/claude-code/)[Установка](/ru/claude-code/install/)[Справочник CLI](/ru/claude-code/cli/)[Цены и лимиты](/ru/claude-code/pricing/)[Agent SDK](/ru/claude-code/sdk/)[Навыки и плагины](/ru/claude-code/skills/)[GitHub](/ru/claude-code/github/)[Веб, настольное приложение и IDE](/ru/claude-code/web-and-desktop/)[Модели](/ru/claude-code/models/)[Ошибки](/ru/claude-code/errors/)[Открытый исходный код?](/ru/claude-code/open-source/)[Практическое руководство](/ru/claude-code/tutorial/)[Для студентов](/ru/claude-code/for-students/)[Автоматизация QA](/ru/claude-code/qa-automation/)[Сравнение с Cursor](/ru/claude-code/vs-cursor/)[Сравнение с Codex и OpenCode](/ru/claude-code/vs-codex/)[Субагенты](/ru/claude-code/subagents/)[Хуки](/ru/claude-code/hooks/)[MCP](/ru/claude-code/mcp/)[Экосистема](/ru/claude-code/ecosystem/)[VS Code](/ru/claude-code/vscode/)[OpenRouter](/ru/claude-code/openrouter/)[Ограничения частоты запросов](/ru/claude-code/rate-limits/)[Руководство на китайском языке](/claude-code/zh/) Последнее обновление: 11 октября 2026 # Ошибки Claude Code и способы их исправления Claude Code показывает ошибки API со статусом HTTP в сообщении, поэтому код уже многое объясняет. Здесь описано, что каждый из них означает в контексте сеанса агента и какой способ исправления действительно работает. ## TLDR - 500 / 529 — сбой или перегрузка на стороне модели; повторите запрос с увеличивающимися интервалами или смените модель, в ваших настройках исправлять нечего. - 400 — обычно контекст слишком длинный для модели; используйте /compact или /clear либо перейдите на вариант с контекстом 1M. - 429 — ограничение частоты запросов; параллельные потоки Claude Code сначала достигают лимита одновременных запросов. - 401 — неверный ключ для конечной точки: ключ из консоли используется с URL шлюза или наоборот. - Лимит использования / недельный лимит — ограничение периода подписки, а не ошибка API; он сбрасывается автоматически, а при работе через API такого ограничения периода нет. ## Подробные руководства по каждой ошибке - [Ошибка API: 500 (внутренняя ошибка сервера)](/ru/claude-code/errors/api-error-500/) — сбои сервиса, сбои отдельных моделей, сжатие контекста при 0%. - [Перегрузка / ошибка API 529](/ru/oshibka-529-claude/) — нехватка ресурсов, повторные попытки, всплески запросов от субагентов. - [Ошибка API 400](/ru/claude-code/errors/api-error-400/) — слишком длинный промпт, одновременное использование инструментов и другие отклонённые запросы. - [Ошибки OAuth](/ru/claude-code/errors/oauth-error/) — превышено время ожидания 15000 мс, код состояния 500 при входе. - [Процесс завершился с кодом 1](/ru/claude-code/errors/process-exited-code-1/) — аварийное завершение расширения VS Code и настольного приложения. - [Достигнут лимит частоты запросов / 429](/ru/claude-code/rate-limits/) — три вида лимитов и способы их повышения. - [Промпт слишком длинный / достигнут лимит контекста](/ru/claude-code/errors/prompt-too-long/) — что заполняет контекстное окно, ложные срабатывания, сбои сжатия контекста, ограничения длины claude.ai. - [Достигнут лимит использования](/ru/claude-code/errors/usage-limit-reached/) — ограничения по периодам для сеансов, недельного использования и Opus, «заданные лимиты использования API», «недостаточный баланс кредитов». - [Аутентификация 401 / 403](/ru/claude-code/errors/auth-401-403/) — недействительные учётные данные, недействительный ключ API, «вход не выполнен», host_not_allowed. - [Ошибки подключения](/ru/claude-code/errors/connection-lost/) — ECONNRESET, «ожидание ответа API», сертификаты, прокси, переменные повторных попыток. - [Зависает, застревает, не отвечает](/ru/claude-code/errors/claude-code-hangs/) — на каком этапе происходит зависание, клавиши для выхода, известные ошибки зависания, память. - [claude.ai не работает](/ru/claude-code/errors/claude-ai-not-working/) — «что-то пошло не так», ограничения ресурсов, лимит в 5 часов, ошибки входа. ## Ошибка API 500 (и 529 — перегрузка) 500 означает сбой вышестоящего сервиса; 529 — явный код Anthropic «модель достигла предела нагрузки». Ни одна из этих ошибок не вызвана вашим промптом. Claude Code самостоятельно повторяет запрос несколько раз; если попытки исчерпаны, подождите минуту и возобновите работу с помощью claude -c. Переключение уровня модели с помощью /model часто помогает сразу, поскольку доступные ресурсы зависят от модели. На этом шлюзе при перегрузке вышестоящего аккаунта запросы автоматически перенаправляются на другой, поэтому ошибки 529 здесь встречаются реже, чем при работе через один аккаунт. ## Ошибка API 400 — некорректный запрос / слишком длинный контекст В Claude Code ошибка 400 почти всегда означает, что диалог вместе с прочитанными файлами больше не помещается в контекстное окно модели. /compact сжимает историю; /clear начинает заново; либо переключитесь на (1M) вариант модели. Другие причины ошибок 400: неподдерживаемый параметр после обновления (выполните claude update) или изображение либо файл, которые модель не может принять. ## Ошибка API 429 — ограничение частоты запросов / частота превышена Действуют три лимита: запросы в минуту, токены в минуту и одновременные запросы. Сеансы агентов сначала достигают лимита одновременных запросов — каждый субагент создаёт параллельный потоковый запрос, который занимает слот до завершения. Уменьшите параллелизм, дождитесь истечения retry-after, а для длительной работы запросите повышение лимита одновременных запросов для вашего аккаунта шлюза. ## Ошибка OAuth: превышено время ожидания 15000 мс Процесс /login не смог связаться со службой аутентификации Anthropic за 15 секунд. Это проблема сети, а не аккаунта: корпоративный прокси, VPN, который блокирует обратный вызов, или регион, где конечная точка аутентификации отвечает медленно. Повторите попытку один раз; если проблема сохраняется, настройте HTTPS_PROXY для своей сети или полностью обойдите OAuth, используя ключ API — с ANTHROPIC_API_KEY (и ANTHROPIC_BASE_URL для шлюза) Claude Code вообще не запускает процесс входа. ## Ошибка OAuth: запрос завершился с кодом состояния 500 Служба аутентификации вернула ошибку сервера во время входа или обновления токена. Причина не на вашей стороне; подождите несколько минут и снова выполните /login. Если нужно работать прямо сейчас, описанный выше способ с ключом API позволяет обойти OAuth, а claude setup-token на компьютере, где вход работает, создаёт долгоживущий токен, который можно перенести на компьютер, где войти не удаётся. ## Ошибка: процесс Claude Code завершился с кодом 1 Это сообщение расширения IDE или настольного приложения о том, что запущенный им CLI аварийно завершился при старте — настоящая ошибка находится уровнем ниже. Откройте терминал и выполните claude напрямую: вы увидите фактическое сообщение, которое почти всегда указывает на версию Node.js ниже 18, неисправный PATH после установки через npm, повреждённую нативную установку или settings.json с некорректным JSON (лишняя запятая в блоке хуков — классический пример). claude doctor проверяет первые три причины; линтер JSON выявляет четвёртую. Повторная установка с помощью нативного установщика исправляет большинство остальных проблем. ## 401 / ошибки аутентификации invalid x-api-key или authentication_error означает, что ключ не принадлежит этой конечной точке. Если ANTHROPIC_BASE_URL указывает на шлюз, нужен ключ шлюза; ключ из консоли Anthropic будет отклонён, и обратное тоже верно. /status показывает, какие конечная точка и ключ сейчас используются. Если одновременно используются /login и ключ API, приоритет имеет ключ. Циклическое обновление токена, Not logged in после успешного входа и ошибки 403 от прокси описаны на [странице 401 / 403](/ru/claude-code/errors/auth-401-403/). ## «Нет доступных вышестоящих серверов» Это не ошибка API: балансировщик нагрузки перед сервисом сообщает, что ни один сервер обработки запросов недоступен. На официальной конечной точке это означает сбой сервиса; на шлюзе — что весь пул вышестоящих серверов недоступен или ограничен по частоте запросов. Подождите и повторите попытку; не меняйте конфигурацию. ## Claude Code вообще не работает - Запускается, затем завершается без сообщения → выполните claude /doctor; обычно проблема в версии Node или PATH. - Зависает при запуске или во время сеанса → см. [зависания и застрявшие сеансы](/ru/claude-code/errors/claude-code-hangs/) и [ошибки подключения](/ru/claude-code/errors/connection-lost/). - command not found → см. руководство по установке. - Инструменты выдают ошибки доступа → /permissionsили --allowedTools в скриптах. ## Устали бороться с этой ошибкой? Запускайте Claude Code через шлюз AI Prime Tech: те же модели Claude на собственных вышестоящих аккаунтах шлюза, две переменные окружения для переключения, а новые аккаунты получают $5 бесплатного баланса для API по коду FIXIT — без банковской карты. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Создать аккаунт с кодом FIXIT](/register?promo=FIXIT) ## Часто задаваемые вопросы Почему Claude Code постоянно возвращает ошибку API 500? Сервер модели даёт сбой или перегружен (529 явно обозначает перегрузку). Повторите попытку после паузы, переключите уровень модели через /model или возобновите работу с помощью claude -c. Причина не в вашей конфигурации.Как исправить ошибку Claude Code 400, связанную с длиной контекста? Выполните /compact, чтобы кратко изложить содержимое сеанса, /clear, чтобы сбросить его, или переключитесь на вариант модели с контекстом 1M.Почему Claude Code сообщает о недействительном ключе API? Ключ не соответствует конечной точке в ANTHROPIC_BASE_URL. Для URL шлюза нужен ключ шлюза; для URL Anthropic — ключ из консоли. ## Запускайте Claude Code через шлюз Те же модели, две переменные окружения, кредиты с балансом в 7.69231 раза больше номинала — или безлимитный тариф с фиксированной оплатой. Для новых аккаунтов: $5 бесплатного баланса для API по коду FIXIT.[Получить API-ключ](/register?promo=FIXIT) [Посмотреть безлимитные тарифы](/ru/plans/) AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза. ## Другие руководства по Claude Code [Claude Code: полное руководство](/ru/claude-code/)[Как установить Claude Code](/ru/claude-code/install/)[Документация CLI Claude Code: команды и флаги](/ru/claude-code/cli/)[Цены и лимиты Claude Code: подробное объяснение](/ru/claude-code/pricing/)[Claude Code SDK, теперь Claude Agent SDK](/ru/claude-code/sdk/)[Навыки и плагины Claude Code](/ru/claude-code/skills/)[Claude Code в GitHub: App, Action и @claude](/ru/claude-code/github/)[Есть ли у Claude Code веб-интерфейс? Веб-версия, настольное приложение и IDE](/ru/claude-code/web-and-desktop/)[Какую модель использует Claude Code и как её изменить](/ru/claude-code/models/)[Открыт ли исходный код Claude Code?](/ru/claude-code/open-source/)[Практическое руководство по Claude Code: ваш первый полноценный сеанс](/ru/claude-code/tutorial/)[Claude для студентов: Claude Code, API и что на самом деле дают образовательные программы](/ru/claude-code/for-students/)[Как использовать Claude Code для автоматизации QA](/ru/claude-code/qa-automation/)[Claude Code и Cursor: что и когда выбрать — и как использовать оба инструмента](/ru/claude-code/vs-cursor/)[Claude Code, Codex и OpenCode: сравнение терминальных агентов](/ru/claude-code/vs-codex/)[Субагенты Claude Code: как они работают, как их определять и как устроены команды агентов](/ru/claude-code/subagents/)[Хуки Claude Code: детерминированный контроль над действиями агента](/ru/claude-code/hooks/)[MCP в Claude Code: подключение серверов, области действия, удалённый MCP и реальные примеры](/ru/claude-code/mcp/)[Экосистема Claude Code: маршрутизаторы, фреймворки, плагины и списки, в которых они собраны](/ru/claude-code/ecosystem/)[Claude Code в VS Code: расширение, работа через терминал и ошибки](/ru/claude-code/vscode/)[Как использовать OpenRouter в Claude Code и когда этого делать не стоит](/ru/claude-code/openrouter/)[Ошибка ограничения частоты запросов Claude: что означает «API error: rate limit reached» и как её исправить](/ru/claude-code/rate-limits/)[Как пользоваться Claude Code: от установки до повседневной работы](/claude-code/zh/)