На этой странице перечислены ошибки runtime, которые отображает Claude Code, и способы восстановления после каждой из них, а также что проверить, когда ответы кажутся неправильными без ошибки. Для ошибок установки, таких какDocumentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
command not found или сбои TLS во время установки, см. Troubleshooting installation and login.
Эти ошибки и команды восстановления применяются во всех интерфейсах: CLI, Desktop app и Claude Code on the web, поскольку все три используют один и тот же Claude Code CLI. Для проблем, специфичных для конкретного интерфейса, см. раздел troubleshooting на странице этого интерфейса.
Claude Code вызывает Claude API для получения ответов модели, поэтому большинство ошибок runtime соответствуют базовому коду ошибки API. На этой странице описано, что каждая ошибка означает в Claude Code и как восстановиться. Для определений кодов состояния HTTP в исходном виде см. Claude Platform error reference.
Найдите вашу ошибку
Сопоставьте сообщение, которое вы видите в терминале, с разделом ниже.| Сообщение | Раздел |
|---|---|
API Error: 500 ... Internal server error | Server errors |
API Error: Repeated 529 Overloaded errors | Server errors |
Request timed out | Server errors, или Network, если сообщение упоминает вашу интернет-соединение |
<model> is temporarily unavailable, so auto mode cannot determine the safety of... | Server errors |
Auto mode could not evaluate this action and is blocking it for safety | Server errors |
Auto mode classifier transcript exceeded context window | Server errors |
You've hit your session limit / You've hit your weekly limit | Usage limits |
Server is temporarily limiting requests | Usage limits |
Request rejected (429) | Usage limits |
Credit balance is too low | Usage limits |
Not logged in · Please run /login | Authentication |
Invalid API key | Authentication |
This organization has been disabled | Authentication |
Routines are disabled by your organization's policy | Authentication |
OAuth token revoked / OAuth token has expired | Authentication |
does not meet scope requirement user:profile | Authentication |
Unable to connect to API | Network |
SSL certificate verification failed | Network |
403 with x-deny-reason: host_not_allowed in a cloud or routine session | Network |
Prompt is too long | Request errors |
Error during compaction: Conversation too long | Request errors |
Request too large | Request errors |
Image was too large | Request errors |
PDF too large / PDF is password protected | Request errors |
Extra inputs are not permitted | Request errors |
There's an issue with the selected model | Request errors |
Claude Opus is not available with the Claude Pro plan | Request errors |
thinking.type.enabled is not supported for this model | Request errors |
max_tokens must be greater than thinking.budget_tokens | Request errors |
API Error: 400 due to tool use concurrency issues | Request errors |
| Responses seem lower quality than usual | Response quality |
Автоматические повторные попытки
Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. Во время повторных попыток спиннер показывает обратный отсчетRetrying in Ns · attempt x/y.
Когда вы видите одну из ошибок на этой странице, эти повторные попытки уже исчерпаны. Вы можете настроить поведение с помощью двух переменных окружения:
| Переменная | По умолчанию | Эффект |
|---|---|---|
CLAUDE_CODE_MAX_RETRIES | 10 | Количество попыток повтора. Снизьте его, чтобы быстрее выявлять сбои в скриптах; повысьте его, чтобы ждать более длительных инцидентов. |
API_TIMEOUT_MS | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |
Ошибки сервера
Эти ошибки исходят от инфраструктуры Anthropic, а не от вашей учетной записи или запроса.API Error: 500 Internal server error
Claude Code отображает исходное тело ответа API для любого статуса 5xx. Пример ниже показывает ответ 500:- Проверьте status.claude.com на наличие активных инцидентов
- Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в разговоре, поэтому для длинного запроса вы можете ввести
try againвместо вставки всего текста. - Если ошибка сохраняется без опубликованного инцидента, запустите
/feedback, чтобы Anthropic могла расследовать детали вашего запроса. См. Сообщить об ошибке, если/feedbackнедоступна у вашего провайдера.
API Error: Repeated 529 Overloaded errors
API временно работает на полную мощность для всех пользователей. Claude Code уже несколько раз повторила попытку перед отображением этого сообщения:- Проверьте status.claude.com на наличие уведомлений о емкости
- Попробуйте еще раз через несколько минут
- Запустите
/modelи переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, напримерOpus is experiencing high load, please use /model to switch to Sonnet.
Request timed out
API не ответила до истечения срока соединения.- Повторите запрос
- Для долгосрочных задач разбейте работу на более мелкие запросы
- Если причина в медленной сети или прокси, повысьте
API_TIMEOUT_MS, как описано в Automatic retries - Если тайм-ауты частые и ваша сеть в остальном здорова, см. Network and connection errors ниже
Auto mode cannot determine the safety of an action
Модель, которую auto mode использует для классификации действий, не смогла принять решение, поэтому auto mode не одобрила действие автоматически. Сообщение, которое вы видите, зависит от того, почему классификатор не сработал. Чтения, поиски и редактирования в вашем рабочем каталоге пропускают классификатор, поэтому они продолжают работать во всех этих случаях. Когда модель классификатора перегружена:- Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно
- Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже
- Это временно и не связано с auto mode eligibility; вам не нужно менять настройки
- Повторите действие; это обычно успешно срабатывает при следующей попытке
- Запустите
claude --debugи повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки
- Одобрите или отклоните действие в появившемся запросе
- Запустите
/compact, чтобы уменьшить размер разговора, чтобы последующие действия снова поместились в окне классификатора
Лимиты использования
Эти ошибки означают, что квота, привязанная к вашей учетной записи или плану, была достигнута. Они отличаются от server errors, которые влияют на всех.You’ve hit your session limit
Планы подписки включают скользящий лимит использования. Когда он заканчивается, вы видите одно из этих сообщений:- Дождитесь времени сброса, показанного в ошибке
- Запустите
/usage, чтобы увидеть лимиты вашего плана и когда они сбрасываются - Запустите
/extra-usage, чтобы купить дополнительное использование на Pro и Max, или запросить его у администратора на Team и Enterprise. См. Extra usage for paid plans для информации о том, как это выставляется счетом. - Чтобы обновить ваш план для более высоких базовых лимитов, см. claude.com/pricing
rate_limits в custom status line, или в Desktop app нажмите usage ring рядом с выбором модели.
Server is temporarily limiting requests
API применила краткосрочный дроссель, который не связан с квотой вашего плана.- Подождите немного и попробуйте еще раз
- Проверьте status.claude.com, если это сохраняется
Request rejected (429)
Вы достигли лимита скорости, настроенного для вашего ключа API, проекта Amazon Bedrock или проекта Google Vertex AI.- Запустите
/statusи подтвердите, что активные учетные данные — это те, которые вы ожидаете. СлучайныйANTHROPIC_API_KEYв вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки. - Проверьте консоль вашего провайдера на предмет активных лимитов и запросите более высокий уровень, если необходимо
- Для ключей Anthropic API см. rate limits reference для информации о том, как работают уровни и как установить лимиты для каждого рабочего пространства
- Снизьте параллелизм: понизьте
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, избегайте запуска множества параллельных подагентов или переключитесь на меньшую модель с/modelдля высокообъемных скриптовых запусков
Credit balance is too low
Ваша организация Console исчерпала предоплаченные кредиты.- Добавьте кредиты на platform.claude.com/settings/billing и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся перед тем, как он упадет до нуля
- Переключитесь на аутентификацию подписки с помощью
/login, если у вас есть план Pro, Max, Team или Enterprise - Установите лимиты расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. Manage costs effectively.
Ошибки аутентификации
Эти ошибки означают, что Claude Code не может доказать вашу личность API. Запустите/status в любое время, чтобы увидеть, какие учетные данные в настоящее время активны.
Not logged in
Для этого сеанса нет доступных действительных учетных данных.- Запустите
/loginдля аутентификации с помощью вашей подписки Claude или учетной записи Console - Если вы ожидали, что переменная окружения будет аутентифицировать вас, подтвердите, что
ANTHROPIC_API_KEYустановлена и экспортирована в оболочке, где вы запустилиclaude - Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт
apiKeyHelper, который получает ключ при запуске - См. Authentication precedence, чтобы понять, какие учетные данные выигрывают, когда присутствуют несколько
Invalid API key
Переменная окруженияANTHROPIC_API_KEY или скрипт apiKeyHelper вернули ключ, который API отклонила.
- Проверьте опечатки и подтвердите, что ключ не был отозван в Console
- Запустите
env | grep ANTHROPICв той же оболочке. Такие инструменты, как direnv, dotenv shell plugins и IDE terminals, могут загружать устаревший ключ из файла.envв вашем проекте без явной установки. - Отмените установку
ANTHROPIC_API_KEYи запустите/login, чтобы вместо этого использовать аутентификацию подписки - Если ключ поступает из скрипта
apiKeyHelper, запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout - Запустите
/status, чтобы подтвердить, какой источник учетных данных Claude Code фактически использует
This organization has been disabled
УстаревшийANTHROPIC_API_KEY из отключенной организации Console переопределяет вашу подписку входа.
/login, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла .env, используется даже если у вас есть работающая подписка Pro или Max. В неинтерактивном режиме (-p) ключ всегда используется, когда он присутствует.
Что делать:
- Отмените установку
ANTHROPIC_API_KEYв текущей оболочке и удалите его из профиля вашей оболочки, затем перезапуститеclaude - Запустите
/statusпосле этого, чтобы подтвердить, что активные учетные данные — это ваша подписка - Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая привязана к вашему
/login. Свяжитесь с поддержкой или войдите с другой учетной записью.
Routines are disabled by your organization’s policy
Ваш администратор Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из/schedule и пользовательского интерфейса Routines на claude.ai/code.
- Попросите вашего администратора включить переключатель Routines на claude.ai/admin-settings/claude-code
- Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. scheduled tasks
OAuth token revoked or expired
Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.- Запустите
/login, чтобы войти снова - Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите
/logout, чтобы полностью очистить сохраненный токен, затем/login - Для повторных запросов на вход между запусками см. проверки системных часов и macOS Keychain в Troubleshooting
- Для других сбоев, включая
403 Forbiddenи проблемы с браузером OAuth, см. Login and authentication
OAuth scope requirement
Сохраненный токен предшествует требованию области разрешений, которое требует более новая функция. Вы видите это чаще всего из/usage и индикатора использования строки состояния:
- Запустите
/login, чтобы создать новый токен с текущими областями. Вам не нужно сначала выходить.
Ошибки сети и соединения
Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения. Они обычно исходят из вашей локальной сети, прокси или брандмауэра, или из политики сети облачной среды.Unable to connect to API
Соединение TCP с API не удалось или никогда не завершилось.api.anthropic.com, или требуемый корпоративный прокси, который не настроен.
Что делать:
- Подтвердите, что вы можете достичь хоста API из той же оболочки, запустив
curl -I https://api.anthropic.com. На Windows PowerShell используйтеcurl.exe -I https://api.anthropic.com, чтобы встроенный псевдонимInvoke-WebRequestне использовался. - Если вы находитесь за корпоративным прокси, установите
HTTPS_PROXYперед запуском Claude Code и см. Network configuration - Если вы маршрутизируете через шлюз LLM или ретранслятор, установите
ANTHROPIC_BASE_URLна его адрес. См. LLM gateway configuration для настройки. - Убедитесь, что ваш брандмауэр разрешает хосты, перечисленные в Network access requirements
- Прерывистые сбои автоматически повторяются; постоянные сбои указывают на проблему локальной сети
curl успешен, но Claude Code все еще не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:
- На Linux и WSL проверьте
/etc/resolv.confна недостижимый сервер имен. WSL в частности может наследовать неработающий распознаватель от хоста. - На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте
ifconfigна устаревшие интерфейсыutunи удалите расширение сети VPN в System Settings. - Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.
SSL certificate errors
Прокси или устройство безопасности в вашей сети перехватывает трафик TLS с собственным сертификатом, и Claude Code ему не доверяет.- Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью
NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem - См. Network configuration для полных инструкций по настройке
- Не устанавливайте
NODE_TLS_REJECT_UNAUTHORIZED=0, что полностью отключает проверку сертификата
Host not allowed in a cloud session
Исходящий HTTP-запрос из облачной сессии или процедуры был заблокирован политикой сети среды.- Откройте процедуру для редактирования или запустите облачную сессию. Выберите значок облака, показывающий имя вашей среды, например Default, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.
- В диалоговом окне Update cloud environment измените Network access с Trusted на Custom, затем добавьте заблокированный домен в Allowed domains. Введите один домен в строку. Установите флажок Also include default list of common package managers, чтобы сохранить список разрешений по умолчанию вместе с вашими пользовательскими доменами. Выберите Full вместо этого, если вы хотите неограниченный доступ.
- Нажмите Save changes. Следующий запуск использует обновленный список разрешений.
Ошибки запроса
Эти ошибки означают, что API получила ваш запрос, но отклонила его содержимое.Prompt is too long
Разговор плюс прикрепленные файлы превышают контекстное окно модели.- Запустите
/compact, чтобы суммировать более ранние ходы и освободить место, или/clear, чтобы начать заново - Запустите
/context, чтобы увидеть разбивку того, что потребляет окно: системный запрос, инструменты, файлы памяти и сообщения - Отключите MCP servers, которые вы не используете, с помощью
/mcp disable <name>, чтобы удалить их определения инструментов из контекста - Обрежьте большие файлы памяти
CLAUDE.md, или переместите инструкции в path-scoped rules, которые загружаются только при необходимости - Подагенты наследуют каждое определение инструмента MCP от родительского сеанса, что может заполнить их контекстное окно перед первым ходом. Отключите MCP servers, которые вы не используете, перед созданием подагентов.
- Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили
DISABLE_AUTO_COMPACT, повторно включите его или запустите/compactвручную перед заполнением окна.
Error during compaction: Conversation too long
/compact сама не удалась, потому что недостаточно свободного контекста для хранения создаваемого ею резюме.
/compact после просмотра Prompt is too long.
Что делать:
- Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите
/compactснова. - Если отступление не освобождает достаточно места, запустите
/clear, чтобы начать свежий сеанс. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью/resume.
Request too large
Исходное тело запроса превысило лимит байтов API перед токенизацией, обычно из-за большого вставленного файла или вложения.- Нажмите Esc дважды и вернитесь назад перед ходом, который добавил переразмеренное содержимое
- Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude могла читать их по частям
- Для изображений см. Image was too large ниже
Image was too large
Вставленное или прикрепленное изображение превышает лимиты размера или размеров API.- Нажмите Esc дважды и вернитесь назад перед ходом, где было добавлено изображение
- Измените размер изображения перед вставкой. API принимает изображения до 8000 пикселей на самой длинной стороне для одного изображения или 2000 пикселей, когда в контексте много изображений.
- Сделайте более плотный скриншот соответствующего региона вместо полного экрана
PDF errors
PDF, который вы прикрепили, не удалось обработать.- Для больших PDF-файлов попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как
pdftotext, и ссылайтесь на выходной файл по пути - Для защищенных или недействительных PDF-файлов удалите пароль или повторно экспортируйте файл из исходного приложения, затем попробуйте еще раз
Extra inputs are not permitted
Прокси или шлюз LLM между Claude Code и API удалили заголовок запросаanthropic-beta, поэтому API отклонила поля, которые от него зависят.
context_management, effort и инструмент input_examples, вместе с заголовком anthropic-beta, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые она не распознает.
Что делать:
- Настройте ваш шлюз для пересылки заголовка
anthropic-beta. См. LLM gateway configuration. - В качестве резервного варианта установите
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1перед запуском. Это отключает функции, требующие заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.
There’s an issue with the selected model
Настроенное имя модели не было распознано или ваша учетная запись не имеет доступа к ней.- Запустите
/model, чтобы выбрать из моделей, доступных вашей учетной записи - Используйте псевдоним, такой как
sonnetилиopus, вместо полного версионного ID. Псевдонимы отслеживают последний выпуск, поэтому они не устаревают. См. Model configuration. - Если неправильная модель продолжает возвращаться, где-то установлен устаревший ID. Проверьте в порядке приоритета: флаг
--model, переменная окруженияANTHROPIC_MODEL, затем полеmodelв.claude/settings.local.json, файл.claude/settings.jsonвашего проекта и~/.claude/settings.json. Удалите устаревшее значение, и Claude Code вернется к стандартной модели вашей учетной записи. - Для развертываний Vertex AI см. Vertex AI troubleshooting.
Claude Opus is not available with the Claude Pro plan
Ваш активный план подписки не включает выбранную модель.- Запустите
/modelи выберите модель, которую включает ваш план - Если вы недавно обновили свой план и все еще видите это, запустите
/logout, затем/login. Сохраненный токен отражает ваш план на момент входа, поэтому обновление в Интернете не вступает в силу в существующем сеансе, пока вы не повторно аутентифицируетесь. - См. claude.com/pricing для информации о том, какие модели включает каждый план
thinking.type.enabled is not supported for this model
Ваша версия Claude Code старше минимальной для Opus 4.7. CLI отправила конфигурацию thinking, которую модель больше не принимает.- Запустите
claude update, чтобы обновиться до v2.1.111 или позже, затем перезапустите Claude Code - Если вы не можете обновиться, запустите
/modelи выберите Opus 4.6 или Sonnet вместо этого - Если вы столкнулись с этим в Agent SDK, см. SDK troubleshooting
Thinking budget exceeds output limit
Настроенный бюджет расширенного thinking превышает максимальную длину ответа, поэтому для фактического ответа не осталось места.MAX_THINKING_TOKENS установлена выше лимита вывода провайдера, или когда Plan Mode повышает бюджет thinking.
Что делать:
- Понизьте
MAX_THINKING_TOKENS, или повысьтеCLAUDE_CODE_MAX_OUTPUT_TOKENSвыше бюджета thinking - См. Extended thinking для информации о том, как бюджет взаимодействует с длиной вывода
Tool use or thinking block mismatch
История разговора достигла API в несогласованном состоянии, обычно после того, как вызов инструмента был прерван или ход был отредактирован в середине потока.tool_use, tool_result и thinking в истории больше не соответствует тому, что ожидает API.
Что делать:
- Запустите
/rewind, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед поврежденным ходом и продолжить оттуда. См. Checkpointing для информации о том, как создаются и восстанавливаются контрольные точки.
Responses seem lower quality than usual
Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии моделей. Она может переключиться на резервную модель в конкретных случаях, таких как достижение квоты Opus или отсутствие вашей модели в регионе Bedrock или Vertex AI; проверка Model selection ниже ловит оба, и Model configuration объясняет, когда применяется резервная версия. Сначала проверьте эти пункты:- Model selection: запустите
/model, чтобы подтвердить, что вы находитесь на модели, которую ожидаете. Предыдущий выбор/modelили переменная окруженияANTHROPIC_MODELмогут поместить вас на меньшую модель, чем вы предполагали. - Effort level: запустите
/effort, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы по дизайну. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед предположением, что вы ниже максимума. См. Adjust effort level для значений по умолчанию для каждой модели и ярлыкаultrathink. - Context pressure: запустите
/context, чтобы увидеть, насколько полно окно. Если оно близко к емкости, запустите/compactв естественной точке разрыва или/clear, чтобы начать заново. См. Explore the context window для информации о том, как auto-compact влияет на более ранние ходы. - Stale instructions: большие или устаревшие файлы
CLAUDE.mdи определения инструментов MCP потребляют контекст и могут направлять ответы./doctorотмечает переразмеренные файлы памяти и определения подагентов;/contextпоказывает использование токенов инструментов MCP.
/rewind, чтобы вернуться перед плохим ходом, затем переформулируйте запрос с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. Checkpointing.
Если качество все еще кажется неправильным после проверки вышеуказанного, запустите /feedback и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает стенограмму разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. Report an error, если /feedback недоступна у вашего провайдера.
Сообщить об ошибке
На этой странице рассматриваются ошибки из Claude API. Для ошибок из других компонентов Claude Code см. соответствующее руководство:- MCP server не удалось подключиться или аутентифицироваться: MCP
- Скрипт hook не удалось или заблокировал инструмент: Debug hooks
- Permission denied или ошибки файловой системы во время установки: Troubleshoot installation and login
- Запустите
/feedbackвнутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Обратная связь недоступна на развертываниях Bedrock, Vertex AI и Foundry. - Запустите
/doctor, чтобы проверить проблемы локальной конфигурации - Проверьте status.claude.com на наличие активных инцидентов
- Поищите existing issues на GitHub