Справочник по ошибкам
Найдите сообщения об ошибках runtime Claude Code, узнайте, что они означают и как их исправить.
На этой странице перечислены ошибки runtime, которые отображает Claude Code, и способы восстановления после каждой из них, а также что проверить, когда ответы кажутся неправильными без ошибки. Для ошибок установки, таких как command not found или сбои TLS во время установки, см. Troubleshoot 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, если сообщение упоминает вашу интернет-соединение |
Server error mid-response. The response above may be incomplete. |
Server errors |
Connection closed mid-response / Response stalled mid-stream |
Server errors |
<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 |
Agent terminated early due to an API error |
Server errors |
You've hit your session limit / You've hit your weekly limit |
Usage limits |
Usage credits required for 1M context |
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 |
Could not resolve authentication method |
Authentication |
Invalid API key |
Authentication |
This organization has been disabled |
Authentication |
Your organization has disabled API key authentication |
Authentication |
Your organization has disabled Claude subscription access |
Authentication |
Routines are disabled by your organization's policy |
Authentication |
Remote Control is only available when using Claude via api.anthropic.com |
Authentication |
OAuth token revoked / OAuth token has expired |
Authentication |
does not meet scope requirement user:profile |
Authentication |
AWS credentials expired or invalid |
Authentication |
AWS authentication failed |
Authentication |
Unable to connect to API |
Network |
Waiting for API response · will retry in |
Automatic retries, или Network, если это продолжается |
SSL certificate verification failed |
Network |
SSL certificate error (...) during login or startup |
Network |
403 with x-deny-reason: host_not_allowed in a cloud or routine session |
Network |
Couldn't reconnect to your Remote Control 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 |
Unable to resize image |
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 |
Model ... is not a recognized model id |
Request errors |
Claude Opus is not available with the Claude Pro plan |
Request errors |
Model ... is restricted by your organization's settings |
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 |
Claude Code is unable to respond to this request, which appears to violate our Usage Policy |
Request errors |
<model> has safety measures that flagged this message for a cybersecurity topic |
Request errors |
Installation was killed before it could finish (exit code 137) |
Installation errors |
The connection dropped while downloading the update |
Installation errors |
Download timed out: exceeded the total deadline |
Installation errors |
--bg and --print conflict |
Command-line errors |
Error: --json-schema is not a valid JSON Schema |
Command-line errors |
Could not import <server>: <reason> |
Command-line errors |
Marketplace "<name>" is registered from an untrusted source |
Plugin errors |
Ignoring N permissions.allow entries from ... this workspace has not been trusted |
Configuration warnings |
| Responses seem lower quality than usual | Response quality |
Automatic retries
Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. {/* min-version: 2.1.198 /}Начиная с версии 2.1.198, это охватывает соединения, которые разрываются в середине ответа перед любым видимым выводом: Claude Code повторно отправляет запрос с той же задержкой и ход продолжается вместо остановки с ошибкой соединения. {/ min-version: 2.1.199 */}Начиная с версии 2.1.199, временные дроссели 429, которые не содержат заголовки квоты вашего плана, также повторяются, когда вы вошли с подписью claude.ai; более ранние версии повторяли их только для входов по ключу API и Enterprise.
Два класса сбоев не повторяются, потому что повторная попытка не может быть успешной:
- {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет
NODE_EXTRA_CA_CERTSили истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. SSL certificate errors. Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются. - {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет incomplete-response notice вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.
Во время повторных попыток спиннер показывает обратный отсчет Retrying in Ns · attempt x/y после метки ошибки. Метка называет конкретную причину первой попытки для сбоев, на которые вы можете действовать немедленно: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок она читается как API error вначале. {/* min-version: 2.1.198 */}Начиная с версии 2.1.198, она переключается на конкретную причину третьей попытки, или при последней попытке, когда CLAUDE_CODE_MAX_RETRIES позволяет менее трёх; более ранние версии переключаются только при последней попытке.
{/* min-version: 2.1.198 */}Начиная с версии 2.1.198, обычная подсказка спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой — это перегрузка 529, строка ниже обратного отсчета также указывает, где проверить статус сервиса: status.claude.com на Anthropic API, или хост провайдера или шлюза, указанный в сообщении, на других конфигурациях.
{/* min-version: 2.1.185 */}Если данные не поступают на поток ответов в течение 20 секунд, пока запрос все еще ожидает, спиннер показывает Waiting for API response · will retry in … · check your network перед началом любой повторной попытки. Запрос еще не завершился с ошибкой: обратный отсчет продолжается до момента, когда Claude Code прерывает зависшее соединение и повторяет попытку, поэтому баннер исчезает самостоятельно, когда данные возобновляются или повторная попытка успешна. Начиная с версии 2.1.185 пороговое значение составляет 20 секунд; в более ранних версиях баннер отображается через 10 секунд с другой формулировкой. Если он появляется при каждой попытке, рассматривайте это как проблему с сетью.
Когда вы видите одну из ошибок на этой странице, эти повторные попытки уже исчерпаны, если только она не принадлежит к классу, который не повторяется, такому как сбой проверки сертификата. Вы можете настроить поведение с помощью этих переменных окружения:
| Переменная | По умолчанию | Эффект |
|---|---|---|
CLAUDE_CODE_MAX_RETRIES |
10 | Количество попыток повтора. {/* min-version: 2.1.186 /}Ограничено 15 начиная с версии 2.1.186; {/ min-version: 2.1.199 */}начиная с версии 2.1.199 CLAUDE_CODE_RETRY_WATCHDOG повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |
CLAUDE_CODE_RETRY_WATCHDOG |
не установлено | Установите значение 1 в автоматических сеансах, таких как задания CI, чтобы повторять попытки при ошибках емкости 429 и 529 бесконечно вместо отказа после CLAUDE_CODE_MAX_RETRIES попыток. {/* min-version: 2.1.199 */}Начиная с версии 2.1.199, это также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на CLAUDE_CODE_MAX_RETRIES, если вы явно установите эту переменную. |
API_TIMEOUT_MS |
600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |
Ошибки сервера
Эти ошибки поступают от поставщика услуг вывода, а не от вашей учетной записи или запроса. На Anthropic API это означает инфраструктуру Anthropic. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или пользовательском шлюзе это означает инфраструктуру этого поставщика.
API Error: 500 Internal server error
Claude Code отображает код состояния и сообщение об ошибке API для любого ответа 5xx. Пример ниже показывает ответ 500 на Anthropic API:
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.
Завершающее предложение указывает, где проверить состояние службы, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают страницу состояния этого поставщика. Пользовательский ANTHROPIC_BASE_URL указывает хост шлюза.
Это указывает на неожиданный сбой внутри API. Это не вызвано вашим запросом, параметрами или учетной записью.
Что делать:
- Проверьте status.claude.com или страницу состояния поставщика, указанную в сообщении, на предмет активных инцидентов
- Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в беседе, поэтому для длинного запроса вы можете ввести
try againвместо вставки всего текста. - Если ошибка сохраняется без опубликованного инцидента, запустите
/feedback, чтобы Anthropic могла провести расследование с деталями вашего запроса. См. Report an error, если/feedbackнедоступен в вашей среде.
API Error: Repeated 529 Overloaded errors
API временно работает на полную мощность для всех пользователей. Claude Code уже несколько раз повторил попытку перед отображением этого сообщения:
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
Завершающее предложение варьируется в зависимости от поставщика так же, как ошибка 500 выше.
529 — это не ваш лимит использования и не учитывается в вашей квоте.
Что делать:
- Проверьте status.claude.com или страницу состояния поставщика, указанную в сообщении, на предмет уведомлений о емкости
- Повторите попытку через несколько минут
- Запустите
/modelи переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, напримерOpus is experiencing high load, please use /model to switch to Sonnet.
Request timed out
API не ответил до истечения срока подключения.
Request timed out
Это может произойти в периоды высокой нагрузки или когда модель генерирует очень большой ответ. Время ожидания запроса по умолчанию составляет 10 минут.
Что делать:
- Повторите запрос
- Для долгосрочных задач разбейте работу на более мелкие запросы
- Если причина в медленной сети или прокси, увеличьте
API_TIMEOUT_MS, как описано в Automatic retries - Если тайм-ауты частые и ваша сеть в остальном здорова, см. Network and connection errors ниже
The response above may be incomplete
Потоковый ответ не удался после того, как Claude уже произвел видимый результат. Повторная отправка запроса может привести к двойному выполнению одних и тех же вызовов инструментов, поэтому Claude Code сохраняет то, что уже было передано, и добавляет это уведомление вместо отказа от хода. Какой вариант вы видите, указывает на причину:
API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.
- {/* min-version: 2.1.199 */}
Server error mid-response: ошибка перегрузки или 5xx сервера в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбрасывал частичный результат и сообщал весь ход как ошибку. Connection closed mid-response: соединение разорвалось.Response stalled mid-stream: поток перестал отправлять данные.
Что делать:
- Прочитайте ответ, который был передан. Ничего не потеряно, но последние предложения или вызовы инструментов могут отсутствовать.
- Ответьте
continue, чтобы Claude продолжил с того места, где остановился - Если одна и та же ошибка появляется до какого-либо видимого результата, Claude Code повторяет запрос вместо его завершения. См. Automatic retries.
Auto mode cannot determine the safety of an action
Модель, которую auto mode использует для классификации действий, не смогла принять решение, поэтому auto mode не одобрила действие автоматически. Сообщение, которое вы видите, зависит от того, почему классификатор не сработал.
Чтения, поиски и редактирования в вашем рабочем каталоге пропускают классификатор, поэтому они продолжают работать во всех этих случаях.
Когда модель классификатора перегружена:
<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.
Что делать:
- Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно
- Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже
- Это временно и не связано с auto mode eligibility; вам не нужно менять параметры
Когда классификатор вернул непарсируемый ответ:
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
Что делать:
- Повторите действие; это обычно успешно при следующей попытке
- Запустите
claude --debugи повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки
Когда отдельная проверка безопасности API заблокировала запрос классификатора из-за более раннего содержимого беседы:
Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
Что делать:
- Это не решение о вашем действии. Содержимое, уже находящееся в вашей беседе, вызвало фильтр безопасности на API, когда auto mode отправил беседу классификатору
- Повторная попытка не поможет; то же содержимое беседы снова вызовет фильтр
- Переключитесь на другой permission mode, чтобы вы могли одобрить действие при появлении запроса, или начните новую беседу без содержимого, вызывающего проблему
Когда беседа выросла больше, чем контекстное окно классификатора:
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
В интерактивном сеансе auto mode возвращается к обычному запросу разрешения для этого действия, чтобы вы могли одобрить или отклонить его вручную. В non-interactive mode запуск прерывается, потому что стенограмма только растет и повторная попытка не может быть успешной.
Что делать:
- Одобрите или отклоните действие в появившемся запросе
- Запустите
/compact, чтобы уменьшить размер беседы, чтобы последующие действия снова поместились в окне классификатора
Agent terminated early due to an API error
{/* min-version: 2.1.199 */}Запрос API subagent не удался окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера закончились, поэтому subagent остановился до завершения своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API был возвращен Claude как если бы это был результат subagent.
Agent terminated early due to an API error: <error detail>
Что делать:
- Сопоставьте деталь ошибки после двоеточия с ее собственным разделом на этой странице, например Usage limits или Server errors, и следуйте шагам этого раздела
- После того как основная ошибка исчезнет, попросите Claude повторить задачу или resume the subagent
Когда ограничение скорости, перегрузка или ошибка сервера прерывает foreground subagent, который уже произвел текстовый результат, Claude получает этот частичный результат, отмеченный как неполный, вместо этой ошибки. {/* min-version: 2.1.200 */}Subagent, единственным результатом которого были вызовы инструментов, также получает эту ошибку; в v2.1.199 эта форма возвращала пустой частичный результат вместо этого. См. API errors in subagents.
Ограничения использования
Эти ошибки означают, что достигнута квота, связанная с вашей учетной записью или планом. Они отличаются от ошибок сервера, которые влияют на всех.
Вы достигли лимита сеанса
Планы подписки включают скользящий лимит использования. Когда он исчерпывается, вы видите одно из этих сообщений:
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении.
Что делать:
- Дождитесь времени сброса, указанного в ошибке
- Запустите
/usageдля просмотра лимитов вашего плана и времени их сброса - Запустите
/usage-creditsдля покупки дополнительного использования на Pro и Max, или для запроса у администратора на Team и Enterprise. См. usage credits for paid plans для информации о выставлении счетов. - Для обновления вашего плана на более высокие базовые лимиты см. claude.com/pricing
Чтобы отслеживать оставшийся лимит перед его исчерпанием, добавьте поля rate_limits в пользовательскую строку состояния, или в приложении Desktop нажмите на кольцо использования рядом с выбором модели.
Требуются кредиты использования для контекста 1M
Выбранная модель использует расширенное окно контекста на 1M токенов, и ваш план включает его только через кредиты использования.
API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недельного использования имеют оставшуюся емкость. См. Extended context для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.
{/* min-version: 2.1.172 */}Когда эта ошибка появляется в середине разговора, потому что контекст вырос более 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом уровне впоследствии, поэтому никаких действий не требуется. На версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая /compact; запустите /clear на этих версиях для восстановления. Приведенные ниже шаги применяются, когда вы явно выбрали модель [1m].
Что делать:
- Запустите
/modelи выберите вариант без суффикса[1m]для возврата к стандартному окну контекста - Запустите
/usage-creditsдля включения тарифицированного выставления счетов для варианта 1M на Pro и Max, или для запроса у администратора на Team и Enterprise - Если ошибка сохраняется после
/model, ID модели 1M может быть установлен в другом месте. См. There's an issue with the selected model для проверки мест конфигурации в порядке приоритета. - Чтобы полностью удалить варианты 1M из выбора модели, установите
CLAUDE_CODE_DISABLE_1M_CONTEXT=1
Сервер временно ограничивает запросы
API применил кратковременное дросселирование, которое не связано с квотой вашего плана.
API Error: Server is temporarily limiting requests (not your usage limit)
Claude Code различает это от вашего лимита плана по отсутствию унифицированных заголовков квоты, которые несет реальный ответ лимита. {/* min-version: 2.1.199 */}Начиная с v2.1.199 это автоматически повторяется с отступом перед отображением, независимо от способа аутентификации. На более ранних версиях сеанс, подписанный на подписку claude.ai, не прошел ход при первом возникновении; только API ключ и аутентификация Enterprise повторили попытку.
Что делать:
- Подождите немного и попробуйте снова
- Проверьте status.claude.com если проблема сохраняется
Запрос отклонен (429)
Вы достигли лимита скорости, настроенного для вашего API ключа, проекта Amazon Bedrock или проекта Google Cloud.
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский ANTHROPIC_BASE_URL указывает на хост шлюза.
Что делать:
- Запустите
/statusи подтвердите, что активные учетные данные - это те, которые вы ожидаете. СлучайныйANTHROPIC_API_KEYв вашей среде может маршрутизировать запросы через ключ низкого уровня вместо вашей подписки. - Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо
- Для API ключей Anthropic см. rate limits reference для информации о том, как работают уровни и как установить ограничения расходов для каждого рабочего пространства
- Снизьте параллелизм: понизьте
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с/modelдля высокообъемных скриптовых запусков
Баланс кредитов слишком низкий
Ваша организация Console исчерпала предоплаченные кредиты.
Credit balance is too low
Что делать:
- Добавьте кредиты на platform.claude.com/settings/billing, и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся до того, как он упадет до нуля
- Переключитесь на аутентификацию подписки с
/loginесли у вас есть план Pro, Max, Team или Enterprise - Установите ограничения расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. Manage costs effectively.
Ошибки аутентификации
Эти ошибки означают, что Claude Code не может подтвердить вашу личность перед API. Запустите /status в любой момент, чтобы увидеть, какие учетные данные в настоящее время активны.
Not logged in
Для этого сеанса нет действительных учетных данных.
Not logged in · Please run /login
Что делать:
- Запустите
/loginдля аутентификации с помощью вашей подписки Claude или учетной записи Console - Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что
ANTHROPIC_API_KEYустановлена и экспортирована в оболочке, где вы запустилиclaude - Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт
apiKeyHelper, который получает ключ при запуске - См. Authentication precedence, чтобы понять, какие учетные данные использует Claude Code, когда присутствует несколько
Если вам предлагается войти повторно, см. Not logged in or token expired для исправления системных часов и macOS Keychain.
Could not resolve authentication method
Сеанс достиг клиента API без каких-либо учетных данных. Это появляется в background sessions, облачных сеансах и контекстах Agent SDK, где проверка интерактивного входа не выполняется перед первым запросом.
Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
{/* min-version: 2.1.174 */}До версии 2.1.174 фоновый или облачный сеанс, назначенный неактивному предварительно инициализированному рабочему процессу, мог завершиться ошибкой таким образом, даже если были настроены действительные учетные данные. Обновитесь для восстановления. В текущих версиях ошибка означает, что рабочему процессу не было доступно никаких учетных данных.
Что делать:
- Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены
- Убедитесь, что
ANTHROPIC_API_KEY,CLAUDE_CODE_OAUTH_TOKENили учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке - Для Agent SDK см. authentication setup
- Запустите
/statusв интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается
Invalid API key
Переменная окружения ANTHROPIC_API_KEY или скрипт apiKeyHelper вернули ключ, который API отклонил.
Invalid API key · Fix external API key
Что делать:
- Проверьте опечатки и убедитесь, что ключ не был отозван в Console
- Запустите
env | grep ANTHROPICв той же оболочке. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла.envв вашем проекте без явной установки. - Отмените установку
ANTHROPIC_API_KEYи запустите/loginдля использования аутентификации подписки - Если ключ поступает из скрипта
apiKeyHelper, запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout - Запустите
/status, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code
This organization has been disabled
Устаревший ANTHROPIC_API_KEY из отключенной организации Console переопределяет вашу подписку входа.
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.
Переменные окружения имеют приоритет над /login, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла .env, используется даже если у вас есть рабочая подписка Pro или Max. В неинтерактивном режиме (-p) ключ всегда используется, когда он присутствует.
Что делать:
- Отмените установку
ANTHROPIC_API_KEYв текущей оболочке и удалите его из профиля вашей оболочки, затем перезапуститеclaude - Запустите
/statusпосле этого, чтобы подтвердить, что активные учетные данные — это ваша подписка - Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая связана с вашим
/login. Свяжитесь с поддержкой или войдите с другой учетной записью.
Your organization has disabled API key authentication
Это сообщение требует Claude Code версии 2.1.169 или более поздней. Администратор организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после · варьируется в зависимости от того, откуда поступил ключ:
Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
Переменные окружения и apiKeyHelper имеют приоритет над /login, поэтому запуск только /login не помогает, пока один из них все еще предоставляет ключ. См. Authentication precedence.
Что делать:
- Если сообщение называет
ANTHROPIC_API_KEY, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла.env, затем перезапуститеclaude - Если сообщение называет
apiKeyHelper, удалите параметрapiKeyHelperиз вашегоsettings.json - Запустите
/loginдля входа с помощью вашей учетной записи claude.ai - Запустите
/statusпосле этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API - Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console
Your organization has disabled Claude subscription access
Ваша организация Claude не позволяет входить в Claude Code с помощью подписки. Повторный запуск /login с той же учетной записью возвращает ту же ошибку.
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.
Agent SDK и неинтерактивный режим -p представляют это как код ошибки oauth_org_not_allowed.
Что делать:
- Попросите администратора включить доступ Claude Code для вашей организации
- Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. Claude Console authentication для настройки.
- Если вы администратор и не видите опцию для включения доступа, свяжитесь с Anthropic support
Routines are disabled by your organization's policy
Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из /schedule и пользовательского интерфейса Routines на claude.ai/code.
Routines are disabled by your organization's policy.
Это параметр на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.
Что делать:
- Попросите владельца в вашей организации включить переключатель Routines на claude.ai/admin-settings/claude-code
- Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. scheduled tasks
Remote Control requires the Anthropic API
Сеанс не взаимодействует с Anthropic API напрямую, поэтому нет бэкенда claude.ai для Remote Control для сопряжения.
Remote Control is only available when using Claude via api.anthropic.com.
Это появляется на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. {/* min-version: 2.1.196 */}Начиная с версии 2.1.196, это также появляется, когда ANTHROPIC_BASE_URL указывает на хост, отличный от api.anthropic.com, такой как LLM gateway или прокси, даже если вы входите с claude.ai.
Что делать:
- Отмените установку
ANTHROPIC_BASE_URLи перезагрузите сеанс, или запустите Remote Control из сеанса, который взаимодействует с Anthropic API напрямую - Для этого и других сообщений запуска Remote Control см. Troubleshoot Remote Control
OAuth token revoked or expired
Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.
OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error
Что делать:
- Запустите
/loginдля повторного входа - Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите
/logoutдля полной очистки сохраненного токена, затем/login - Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в Troubleshooting
- Для других сбоев, включая
403 Forbiddenи проблемы с браузером OAuth, см. Login and authentication
OAuth scope requirement
Сохраненный токен предшествует области разрешений, которая требуется более новой функции. Вы видите это чаще всего из /usage и индикатора использования в строке состояния:
OAuth token does not meet scope requirement: user:profile
Что делать:
- Запустите
/loginдля получения нового токена с текущими областями. Вам не нужно предварительно выходить.
AWS credentials expired or invalid
{/* min-version: 2.1.198 */}Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда awsAuthRefresh установлен в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое уже запустил Claude Code, не создало учетные данные, которые API принимает. Это появляется при 401 от Claude Platform on AWS или Mantle endpoint, что является тем, как эти провайдеры сообщают об истекшем токене безопасности.
Подсказка действия в середине называет команду awsAuthRefresh из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная AWS credentials expired or invalid:
AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
Без настроенного awsAuthRefresh, тот же 401 показывает вместо этого общее сообщение Please run /login, которое не может обновить учетные данные AWS.
Что делать:
- Запустите команду
awsAuthRefresh, названную в сообщении, такую какaws sso login --profile myprofile, в другом терминале и завершите вход в браузер, затем повторите попытку - В интерактивном сеансе запустите
/login, выберите 3rd-party platform, затем выберите Claude Platform on AWS · refresh credentials в разделе Using 3rd-party platforms для запуска той же команды без перезагрузки Claude Code. См. Configure AWS credentials - Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью
aws sts get-caller-identityв той же оболочке и профиле
AWS authentication failed
{/* min-version: 2.1.198 */}Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда awsAuthRefresh установлен в вашем файле параметров. Ваш провайдер AWS вернул 403, или Amazon Bedrock вернул 401.
Claude Code не может определить, какую причину вы получили. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как AccessDeniedException из-за отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.
401 от Amazon Bedrock также попадает сюда, а не в AWS credentials expired or invalid, потому что Amazon Bedrock не сообщает об истекшем токене как 401. 401 от этой конечной точки обычно поступает из чего-то другого в пути запроса, такого как корпоративный прокси.
Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:
AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
Подсказка действия в середине называет команду awsAuthRefresh из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная AWS authentication failed.
Что делать:
- Запустите команду
awsAuthRefresh, названную в сообщении, илиaws sso login, на случай, если причиной является истекшие учетные данные - Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в IAM configuration присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона
- Запустите
aws sts get-caller-identityдля подтверждения того, какой идентификатор используют ваши запросы; устаревшийAWS_PROFILEили профиль по умолчанию — это частая причина несоответствия разрешений
Ошибки сети и подключения
Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения. Обычно они возникают в вашей локальной сети, прокси или брандмауэре, либо в политике сети облачной среды.
Unable to connect to API
TCP-соединение с API не удалось или никогда не завершилось.
Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings
Распространённые причины включают отсутствие доступа в Интернет, VPN, который блокирует 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 и см. Конфигурация сети - Если вы маршрутизируете через шлюз LLM или ретранслятор, установите
ANTHROPIC_BASE_URLна его адрес. См. Подключение Claude Code к шлюзу LLM для настройки. - Убедитесь, что ваш брандмауэр разрешает хосты, указанные в Требования к доступу в сеть
- Перебойные сбои автоматически повторяются; постоянные сбои указывают на локальную проблему с сетью
Если curl работает успешно, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:
- На Linux и WSL проверьте
/etc/resolv.confна наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста. - На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте
ifconfigна наличие устаревших интерфейсовutunи удалите сетевое расширение VPN в Параметрах системы. - Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.
SSL certificate errors
Прокси или устройство безопасности в вашей сети перехватывает трафик TLS с помощью собственного сертификата, и Claude Code ему не доверяет.
Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected
{/* min-version: 2.1.199 */}Начиная с версии 2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо того, чтобы появиться после полного бюджета повторных попыток. Более ранние версии потратили несколько минут на повторные попытки перед её отображением. Переходящие условия TLS, такие как истечение времени ожидания при установлении соединения, всё ещё повторяются.
Во время /login и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:
SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
Что делать:
- Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью
NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem - См. Конфигурация сети для полных инструкций по настройке
- Не устанавливайте
NODE_TLS_REJECT_UNAUTHORIZED=0, что полностью отключает проверку сертификата
Host not allowed in a cloud session
Исходящий HTTP-запрос из облачной сессии или подпрограммы был заблокирован политикой сети среды.
HTTP 403
x-deny-reason: host_not_allowed
Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачная среда маршрутизирует исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси завершил соединение, а не пункт назначения.
Это не проблема сети на стороне клиента. Облачные сессии и подпрограммы работают внутри изолированной среды, исходящий трафик которой фильтруется в соответствии со списком разрешений среды. Среда Default использует доступ Trusted, который разрешает список разрешений по умолчанию реестров пакетов, API поставщиков облачных услуг, реестров контейнеров и распространённых доменов разработки, но блокирует всё остальное.
Что делать:
- Откройте подпрограмму для редактирования или запустите облачную сессию. Выберите облачный значок, показывающий имя вашей среды, например Default, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.
- В диалоговом окне Update cloud environment измените Network access с Trusted на Custom, затем добавьте заблокированный домен в Allowed domains. Введите один домен в строку. Установите флажок Also include default list of common package managers, чтобы сохранить список разрешений по умолчанию вместе с вашими пользовательскими доменами. Выберите Full вместо этого, если вы хотите неограниченный доступ.
- Нажмите Save changes. Следующий запуск использует обновленный список разрешений.
См. Доступ в сеть для уровней доступа и списка разрешений по умолчанию. Локальные сессии CLI не затронуты этой политикой.
Couldn't reconnect to your Remote Control session
Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
Возобновление с помощью claude --resume или claude --continue переподключается к сессии Remote Control, записанной в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённая сессия. Ваша локальная сессия продолжает работать без Remote Control.
Что делать:
- Запустите
/remote-controlдля повторной попытки подключения - Запустите Claude Code без
--resumeдля создания новой сессии Remote Control - Для других сообщений при запуске Remote Control см. Troubleshoot Remote Control
Вы не увидите это сообщение, когда сервер подтвердит, что предыдущая сессия больше не существует; Claude Code создаст новую в этом случае. {/* min-version: 2.1.200 */}До версии 2.1.200 любой сбой переподключения создавал новую сессию Remote Control, которая оставляла дополнительные сессии в списке сессий на claude.ai/code.
Ошибки запроса
Эти ошибки связаны с содержимым вашего запроса. Большинство из них возвращаются API после отклонения запроса; несколько производятся локально Claude Code перед отправкой запроса.
Prompt is too long
Разговор плюс прикреплённые файлы превышают контекстное окно модели.
Prompt is too long
Что делать:
- Запустите
/compactдля суммирования предыдущих ходов и освобождения места, или/clearдля начала заново - Запустите
/contextдля просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения - Отключите MCP серверы, которые вы не используете, с помощью
/mcp disable <name>для удаления их определений инструментов из контекста - Обрежьте большие файлы памяти
CLAUDE.md, или переместите инструкции в правила с областью действия пути, которые загружаются только при необходимости - Подагенты наследуют каждое определение инструмента MCP из родительской сессии, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.
- Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили
DISABLE_AUTO_COMPACT, переактивируйте его или запустите/compactвручную перед заполнением окна.
Смотрите Explore the context window для интерактивного просмотра того, как заполняется контекст.
Error during compaction: Conversation too long
/compact сам по себе не удался, потому что недостаточно свободного контекста для хранения создаваемого им резюме.
Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
Это может произойти, когда окно уже полно в момент срабатывания auto-compact, или когда вы запускаете /compact после появления Prompt is too long.
Что делать:
- Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите
/compactснова. - Если отступление не освобождает достаточно места, запустите
/clearдля начала новой сессии. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью/resume.
Request too large
Тело необработанного запроса превысило лимит байтов API перед токенизацией, обычно из-за большого вставленного файла или вложения.
Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.
Это ограничение размера HTTP запроса, отдельное от лимита контекстного окна.
Что делать:
- Нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, который добавил содержимое с избыточным размером
- Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude мог читать их по частям
- Для изображений смотрите Image was too large ниже
Image was too large
Вставленное или прикреплённое изображение превышает ограничения размера или размеров API.
Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
{/* min-version: 2.1.142 */}Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторять одну и ту же ошибку при каждом последующем сообщении. Для восстановления в этих версиях нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, где было добавлено изображение.
Что делать:
- Измените размер изображения перед вставкой. API принимает изображения размером до 8000 пикселей по самому длинному краю для одного изображения, или 2000 пикселей, когда в контексте много изображений.
- Сделайте более плотный скриншот соответствующей области вместо полного экрана
Unable to resize image
Claude Code не смог уменьшить масштаб прикреплённого изображения перед отправкой его в API.
Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Claude Code обычно автоматически изменяет размер больших изображений. Эти ошибки означают, что встроенный обработчик изображений не смог загрузиться или вернул ошибку, поэтому изображение не удалось изменить в размер, чтобы соответствовать лимитам API.
Что делать:
- Если сообщение просит вас преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Claude Code может проверить размеры для этих форматов без обработчика изображений.
- Если сообщение сообщает об ограничении размера или размеров, измените размер или перекомпрессируйте изображение ниже этого лимита перед прикреплением.
PDF errors
Прикреплённый PDF не удалось обработать.
PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.
Что делать:
- Для больших PDF попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как
pdftotext, и ссылайтесь на выходной файл по пути - Для защищённых или недействительных PDF удалите пароль или переэкспортируйте файл из исходного приложения, затем попробуйте снова
Extra inputs are not permitted
Прокси или LLM шлюз между Claude Code и API удалил заголовок запроса anthropic-beta, поэтому API отклонил поля, которые от него зависят.
API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
Claude Code отправляет поля только для бета-версии, такие как context_management, effort и примеры инструментов input_examples, вместе с заголовком anthropic-beta, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые он не распознаёт.
Что делать:
- Настройте ваш шлюз для пересылки заголовка
anthropic-beta. Смотрите feature pass-through для того, что шлюзы должны пересылать. - В качестве резервного варианта установите
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1перед запуском. Это отключает функции, которые требуют заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.
There's an issue with the selected model
Имя настроенной модели не было распознано, или ваша учётная запись не имеет доступа к ней. Начиная с v2.1.160 конечная подсказка, показанная здесь в её интерактивной форме, варьируется в зависимости от поверхности.
There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.
Что делать:
- Interactive CLI: запустите
/modelдля выбора из моделей, доступных вашей учётной записи. - Non-interactive mode (
-p): передайте--modelс действительным псевдонимом или ID, или установитеANTHROPIC_MODEL. Текст ошибки показываетRun --modelна этой поверхности. - Agent SDK: текст ошибки опускает подсказку, потому что модель установлена программно. Установите
modelнаOptionsв TypeScript илиClaudeAgentOptions(model=...)в Python, и обработайте структурированную ошибкуmodel_not_foundдля отображения вашего собственного повтора или средства выбора модели. - Используйте псевдоним, такой как
sonnetилиopus, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите Model configuration. - Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в порядке приоритета: флаг
--model, переменная окруженияANTHROPIC_MODEL, затем полеmodelв.claude/settings.local.json, файл вашего проекта.claude/settings.jsonи~/.claude/settings.json. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи. - Для развёртываний Google Cloud's Agent Platform смотрите Google Cloud's Agent Platform troubleshooting.
Model is not a recognized model id
Строка модели, которую вы передали переключателю модели, не является псевдонимом модели, ID модели, который знает эта версия Claude Code, или ID, который начинается с claude-. Обычные причины — опечатка в ID, отображаемое имя, такое как Sonnet 5, где ожидается ID claude-sonnet-5, или псевдоним, который распознают только более новые версии Claude Code. Claude Code немедленно отклоняет переключение. До v2.1.200 Claude Code сохранял строку и не удавался при следующем запросе с There's an issue with the selected model.
Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
Конечная подсказка называет ближайший совпадающий псевдоним или ID модели. Когда ничего не совпадает достаточно близко, она читает Run /model to see available models. вместо этого.
Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод Agent SDK setModel() или приложением, таким как Desktop app, которое запускает Claude Code CLI для вас.
Что делать:
- Запустите
/modelбез аргумента, чтобы открыть средство выбора и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID - Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите
claude update. Полный ID, который начинается сclaude-, проходит эту проверку даже когда модель новее вашей версии Claude Code, поэтому обновление не требуется для них. - Модель, сохранённая до v2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в There's an issue with the selected model.
- Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS и за LLM gateway или пользовательским
ANTHROPIC_BASE_URL, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code принимает любую строку и пропускает её.
Claude Opus is not available with the Claude Pro plan
Ваш активный план подписки не включает выбранную модель.
Claude Opus is not available with the Claude Pro plan · Select a different model in /model
Что делать:
- Запустите
/modelи выберите модель, которую включает ваш план - Если вы недавно обновили свой план и всё ещё видите это, запустите
/logout, затем/login. Сохранённый токен отражает ваш план на момент входа, поэтому обновление в интернете не вступает в силу в существующей сессии до переаутентификации. - Смотрите claude.com/pricing для того, какие модели включает каждый план
Model is restricted by your organization's settings
Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена availableModels списком разрешений в управляемых параметрах. Когда ограниченная модель была установлена с --model, ANTHROPIC_MODEL или параметром model, Claude Code подставляет разрешённую модель и продолжает. Ввод /model <name> для ограниченной модели отклоняется с Run /model to choose a different model. и сессия сохраняет свою текущую модель.
Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
Claude Code рассматривает псевдоним семейства моделей, один из opus, sonnet, haiku или fable, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на Claude Platform on AWS ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений availableModels, и уведомление о подстановке называет эту версию. Claude Code отклоняет /model <alias> только когда каждая версия семейства ограничена. До v2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.
Что делать:
- Запустите
/modelдля выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора. - Если ограниченная модель была установлена в
--model,ANTHROPIC_MODELили полеmodelфайла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске - Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить её. Смотрите Organization model restrictions.
thinking.type.enabled is not supported for this model
Ваша версия Claude Code старше минимума для Sonnet 5, Opus 4.8 или Opus 4.7. CLI отправил конфигурацию мышления, которую модель больше не принимает.
API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
Что делать:
- Запустите
claude updateи перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже - Если вы не можете обновиться, запустите
/modelи выберите Opus 4.6 или Sonnet 4.6 вместо этого - {/* min-version: agent-sdk@0.3.197 */}Если вы столкнулись с этим в Agent SDK, обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже
Thinking budget exceeds output limit
Настроенный бюджет расширенного мышления превышает максимальную длину ответа, поэтому для фактического ответа не остаётся места.
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда MAX_THINKING_TOKENS установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.
Что делать:
- Понизьте
MAX_THINKING_TOKENS, или повысьтеCLAUDE_CODE_MAX_OUTPUT_TOKENSвыше бюджета мышления - Смотрите Extended thinking для того, как бюджет взаимодействует с длиной вывода
Tool use or thinking block mismatch
История разговора достигла API в несогласованном состоянии, обычно после прерывания вызова инструмента или редактирования хода в процессе.
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified
Все три варианта означают одно и то же: последовательность блоков tool_use, tool_result и thinking в истории больше не совпадает с тем, что ожидает API.
Что делать:
- {/* max-version: 2.1.155 */}Если вы используете Opus 4.7 или Opus 4.8, сначала запустите
claude update. Версии до v2.1.156 могут вызвать эту ошибку при нормальном использовании инструмента, и/rewindеё не очищает. - Запустите
/rewind, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите Checkpointing для того, как создаются и восстанавливаются контрольные точки.
Usage Policy refusal
API отказался отвечать, потому что содержимое в разговоре вызвало проверку Usage Policy. Сообщение включает ID запроса, который вы можете цитировать в поддержку, если вы считаете, что отказ неправильный.
API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.
Проверка оценивает весь разговор, а не только ваш последний prompt, поэтому отправка нового сообщения в той же сессии обычно повторно вызывает тот же отказ. То же самое применяется после выхода и переоткрытия сессии с --continue или --resume, так как стенограмма на диске всё ещё содержит вызывающее содержимое. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry это сообщение также охватывает запросы, которые меры безопасности модели отметили как тему кибербезопасности. Смотрите Safety measures flagged a cybersecurity topic.
Что делать:
- Нажмите Esc дважды или запустите
/rewindдля возврата к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или примите другой подход. Смотрите Checkpointing. - Если вы не можете определить, какой ход вызвал это, запустите
/clearдля начала новой разговора в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в/resume. - В non-interactive mode (
-p), где перемотка недоступна, повторите попытку с переформулированным prompt в новой сессии без--continue. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с--modelтакже может разрешить отказ в некоторых случаях.
Safety measures flagged a cybersecurity topic
Меры безопасности модели отметили содержимое в разговоре как тему кибербезопасности. Сообщение называет модель, которая отметила запрос:
API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.
If you were not engaging in a cybersecurity topic, please send feedback via /feedback.
Сообщение ссылается на Cyber Verification Program, который предоставляет доступ для законной работы в области кибербезопасности. Сама защита находится на стороне сервера и предшествует v2.1.203; этот выпуск изменил только формулировку сообщения и страницу, на которую оно ссылается.
То, что вы видите, зависит от вашего поставщика и режима:
- На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry флаг кибербезопасности производит сообщение Usage Policy refusal вместо этого.
- Non-interactive mode опускает предложение
/feedback.
{/* max-version: 2.1.202 */}До v2.1.203 сообщение читалось <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: с последующей ссылкой на форму исключения.
Что делать:
- Если ваша работа требует этого содержимого, подайте заявку на доступ через Cyber Verification Program
- Если ваш запрос не был о теме кибербезопасности, запустите
/feedbackдля сообщения о ложном срабатывании - Чтобы продолжить работу в той же сессии, нажмите Esc дважды или запустите
/rewindдля возврата к контрольной точке перед ходом, который вызвал флаг, затем примите другой подход. Смотрите Checkpointing.
Ошибки установки
Эти ошибки появляются при установке или обновлении Claude Code из скрипта установки, claude install или claude update. Для проблем с command not found, PATH, разрешениями и TLS во время установки см. Устранение неполадок установки и входа.
Установка была прервана до завершения
Скрипт установки сообщает, когда этап claude install завершается сигналом. На Linux код выхода 137 означает, что процесс получил SIGKILL, а на хосте с низким объёмом памяти это обычно означает, что ядро активировало средство защиты от нехватки памяти (OOM killer). Скрипт выводит это объяснение и завершается с кодом 137:
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
Для любого другого фатального сигнала и для кода выхода 137 на macOS скрипт выводит Installation was killed before it could finish (exit code <N>) с фактическим кодом выхода и опускает объяснение о нехватке памяти. Сообщение поступает из скрипта установки, который используют macOS и Linux, и также охватывает установки внутри WSL; встроенные скрипты установки Windows никогда его не выводят. До версии 2.1.200 скрипт завершался только с простой строкой Killed оболочки.
Что делать:
- Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик
- Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. Установка прервана на серверах Linux с низким объёмом памяти для команд файла подкачки.
Соединение разорвалось при загрузке обновления
Соединение с сервером загрузки закрылось, пока claude install, claude update или автоматический обновитель загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. {/* min-version: 2.1.202 */}До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой aborted вместо повторной попытки.
The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
Текст в скобках указывает, какая попытка не удалась, и основную ошибку сети. claude update предваряет сообщение с Error: Failed to install native update на stderr.
Загрузка, которая остаётся подключённой, но не завершается в течение 10 минут, завершается с ошибкой Download timed out: exceeded the total deadline. Claude Code не повторяет истёкшую по времени загрузку, потому что соединение, которое слишком медленно для завершения в установленный срок, не завершится и при немедленной повторной попытке. Приведённые ниже шаги применяются к обоим сообщениям. До версии 2.1.205 тот же 10-минутный срок сообщался как универсальный timeout of 600000ms exceeded HTTP-клиента.
Обычная причина — прокси или шлюз, который закрывает длительную передачу до её завершения. Двоичный файл Claude Code — это большая загрузка, поэтому ограничение соединения прокси, которое никогда не влияет на обычный трафик API, всё равно может его прервать.
Что делать:
- Запустите
claude updateснова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени запустите его снова из более быстрой или менее ограниченной сети. - Если ваша сеть требует прокси, установите
HTTPS_PROXYперед запуском установщика илиclaude update. См. Проверка подключения к сети. - Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с
downloads.claude.ai. См. Требования к доступу в сеть. - Запустите
claude doctorиз вашей оболочки для диагностики установки
Ошибки командной строки
Эти ошибки поступают из командной строки claude и её подкоманд. Claude Code выводит их перед запуском вашего запроса или отправкой любого запроса API.
Конфликт между --bg и --print
Это сообщение требует Claude Code v2.1.198 или более поздней версии. Вы объединили --bg с -p или --print в одном вызове claude. --bg запускает фоновый сеанс, к которому вы позже подключаетесь с помощью claude agents, а --print запускает неинтерактивно и никогда не запускает интерактивный сеанс, к которому подключается claude agents. До версии v2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не удавалось подключить.
--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
Что делать:
- Удалите
-pили--print.--bgпринимает запрос в качестве позиционального аргумента, поэтомуclaude --bg "<task>"— это полная команда. См. Dispatch new agents from your shell. - Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите
--bgи запуститеclaude -p "<task>"
Значение --json-schema не является допустимой JSON Schema
Схема, которую вы передали в --json-schema в неинтерактивном режиме, не прошла компиляцию JSON Schema, поэтому claude завершает работу с кодом 1 вместо запуска запроса. До версии v2.1.205 недопустимая схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово format, считалась недопустимой.
Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
Текст после второго двоеточия — это диагностика валидатора и указывает на ключевое слово или местоположение, которое не прошло проверку. Схемы, использующие ключевое слово format, такие как "format": "email", являются допустимыми: Claude Code принимает format как аннотацию и не применяет её.
Claude Code выполняет две проверки перед компиляцией схемы: он отклоняет значение, которое не является парсируемым JSON, с помощью Error: --json-schema is not valid JSON, и допустимый JSON, который не является объектом, с помощью Error: --json-schema must be a JSON object.
Что делать:
- Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду
- Если диагностика —
schema too large, уменьшите вложенность схемы и повторное использование$ref - См. Get structured output для рабочей схемы и команды
Не удалось импортировать сервер из Claude Desktop
Claude Code не смог добавить один из серверов, которые вы выбрали в claude mcp add-from-claude-desktop. Команда по-прежнему импортирует другие выбранные серверы и выводит одну строку для каждого сервера, который не удалось добавить. До версии v2.1.205 первый сервер, который не прошёл проверку, останавливал импорт и ни один из выбранных серверов не был добавлен.
Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
Текст после имени сервера — это причина. Наиболее распространённая — проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые claude mcp ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный политикой MCP вашей организации.
Что делать:
- Переименуйте сервер в
claude_desktop_config.json, используя только буквы, цифры, дефисы и подчёркивания, затем снова запуститеclaude mcp add-from-claude-desktop - Добавьте этот сервер напрямую с помощью
claude mcp addилиclaude mcp add-jsonпод допустимым именем. См. Import MCP servers from Claude Desktop.
Ошибки плагинов
Эти ошибки возникают из конфигурации плагинов и маркетплейсов. Для проблем с плагинами, которые не производят одно из сообщений на этой странице, таких как URL маркетплейса, который не загружается, или плагин, который устанавливается, но не появляется, см. Устранение неполадок плагинов.
Marketplace зарегистрирован из ненадежного источника
Маркетплейс зарегистрирован под именем, которое зарезервировано для официальных маркетплейсов Anthropic, но его зарегистрированный источник не является репозиторием GitHub anthropics. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как ее имя было зарезервировано, продолжала загружаться.
Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
Что делать:
- Запустите
claude plugin marketplace remove <name>, затем снова добавьте маркетплейс из официального репозиторияgithub.com/anthropics - Если вы публикуете сторонний маркетплейс, который использовал имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей повторно добавить его из вашего источника
- См. список зарезервированных имен в разделе Marketplace schema
Предупреждения о конфигурации
Claude Code выводит эти сообщения в stderr при запуске, а не показывает ошибку в диалоговом окне. Они сообщают о конфигурации, которую он прочитал, но не применил.
Рабочее пространство не было доверено
Claude Code обнаружил правила permissions.allow или записи permissions.additionalDirectories в файле .claude/settings.json или .claude/settings.local.json проекта и не применил их, потому что правила разрешения из параметров проекта требуют доверия рабочему пространству. Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. Правила deny и ask не затронуты.
Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.
Что делать:
- Запустите
claudeв каталоге и примите диалоговое окно доверия. {/* min-version: 2.1.200 */}Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 в этой ситуации диалоговое окно не появлялось, поэтому этот шаг не мог быть завершен там. - В неинтерактивном режиме с флагом
-pдиалоговое окно не показывается. Установите записьhasTrustDialogAcceptedв~/.claude.json, используя точный ключprojects, который выводит сообщение. - {/* min-version: 2.1.200 */}Если сообщение указывает на
.claude/settings.local.jsonи вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный.claude/settings.local.jsonкак предоставленный репозиторием в этих рабочих пространствах. См. Правила разрешения проекта и доверие рабочему пространству.
Ответы кажутся менее качественными, чем обычно
Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно заключается в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:
- Настроенный
--fallback-modelберёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке - Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна
- Автоматический откат модели на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке
Проверка выбора модели ниже перехватывает второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение /model. Конфигурация модели объясняет, когда применяется каждый откат.
Сначала проверьте следующее:
- Выбор модели: запустите
/model, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор/modelили переменная окруженияANTHROPIC_MODELмогут привести вас к меньшей модели, чем вы предполагали. - Уровень усилий: запустите
/effort, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или проектной работы. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. Adjust effort level для значений по умолчанию для каждой модели и сокращениеultrathink. - Давление контекста: запустите
/context, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите/compactв естественной точке разрыва или/clear, чтобы начать заново. См. Explore the context window для информации о том, как auto-compact влияет на предыдущие ходы. - Устаревшие инструкции: большие или устаревшие файлы
CLAUDE.mdи определения инструментов MCP потребляют контекст и могут направлять ответы. {/* min-version: 2.1.205 */}Проверка/doctorотмечает файлы памяти большого размера и неиспользуемые расширения, а/contextпоказывает использование токенов инструментов MCP. До версии v2.1.205/doctorоткрывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.
Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите /rewind, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. Checkpointing.
Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите /feedback и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. Report an error, если /feedback недоступен в вашей среде.
{/* min-version: 2.1.201 */}Если Sonnet 5 отклоняет запрос и ссылается на подозреваемую инъекцию подсказки на Claude Code v2.1.200 или более ранней версии, запустите claude update, чтобы получить исправление v2.1.201.
Сообщить об ошибке
Для ошибок компонентов, которые не рассматриваются на этой странице, см. соответствующее руководство:
- Серверу MCP не удалось подключиться или пройти аутентификацию: MCP
- Скрипт hook не выполнился или заблокировал инструмент: Debug hooks
- Отказано в доступе или ошибки файловой системы при установке: Troubleshoot installation and login
Если ошибка не указана здесь или предложенное исправление не помогает:
- Запустите
/feedbackвнутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков/feedbackсохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic. - Запустите
claude doctorиз вашей оболочки для диагностики только для чтения вашей установки или запустите/doctorвнутри Claude Code, чтобы найти и исправить проблемы конфигурации - Проверьте status.claude.com на предмет активных инцидентов
- Поищите существующие проблемы на GitHub