Ошибки Claude Code и способы их исправления

Подробные руководства по каждой ошибке

• Ошибка API: 500 (внутренняя ошибка сервера) — сбои сервиса, сбои отдельных моделей, сжатие контекста при 0%.
• Перегрузка / ошибка API 529 — нехватка ресурсов, повторные попытки, всплески запросов от субагентов.
• Ошибка API 400 — слишком длинный промпт, одновременное использование инструментов и другие отклонённые запросы.
• Ошибки OAuth — превышено время ожидания 15000 мс, код состояния 500 при входе.
• Процесс завершился с кодом 1 — аварийное завершение расширения VS Code и настольного приложения.
• Достигнут лимит частоты запросов / 429 — три вида лимитов и способы их повышения.
• Промпт слишком длинный / достигнут лимит контекста — что заполняет контекстное окно, ложные срабатывания, сбои сжатия контекста, ограничения длины claude.ai.
• Достигнут лимит использования — ограничения по периодам для сеансов, недельного использования и Opus, «заданные лимиты использования API», «недостаточный баланс кредитов».
• Аутентификация 401 / 403 — недействительные учётные данные, недействительный ключ API, «вход не выполнен», host_not_allowed.
• Ошибки подключения — ECONNRESET, «ожидание ответа API», сертификаты, прокси, переменные повторных попыток.
• Зависает, застревает, не отвечает — на каком этапе происходит зависание, клавиши для выхода, известные ошибки зависания, память.
• claude.ai не работает — «что-то пошло не так», ограничения ресурсов, лимит в 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.

«Нет доступных вышестоящих серверов»

Это не ошибка API: балансировщик нагрузки перед сервисом сообщает, что ни один сервер обработки запросов недоступен. На официальной конечной точке это означает сбой сервиса; на шлюзе — что весь пул вышестоящих серверов недоступен или ограничен по частоте запросов. Подождите и повторите попытку; не меняйте конфигурацию.

Claude Code вообще не работает

• Запускается, затем завершается без сообщения → выполните claude /doctor; обычно проблема в версии Node или PATH.
• Зависает при запуске или во время сеанса → см. зависания и застрявшие сеансы и ошибки подключения.
• command not found → см. руководство по установке.
• Инструменты выдают ошибки доступа → /permissionsили --allowedTools в скриптах.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

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

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.