Справочник по ошибкам

​

Найдите вашу ошибку

​

Automatic retries

• Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет NODE_EXTRA_CA_CERTS или истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. SSL certificate errors. Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.
• Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет incomplete-response notice вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.
• Amazon Bedrock streaming response with an unexpected content-type завершается ошибкой при первой попытке, потому что шлюз или прокси, переписывающий ответ, переписал бы повторную попытку таким же образом. Требуется Claude Code версии 2.1.208 или позже.

​

Ошибки сервера

​

API Error: 500 Internal server error

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.

• Проверьте status.claude.com или страницу состояния поставщика, указанную в сообщении, на предмет активных инцидентов
• Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в беседе, поэтому для длинного запроса вы можете ввести try again вместо вставки всего текста.
• Если ошибка сохраняется без опубликованного инцидента, запустите /feedback, чтобы Anthropic могла провести расследование с деталями вашего запроса. См. Report an error, если /feedback недоступен в вашей среде.

​

API Error: Repeated 529 Overloaded errors

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.

• Проверьте status.claude.com или страницу состояния поставщика, указанную в сообщении, на предмет уведомлений о емкости
• Повторите попытку через несколько минут
• Запустите /model и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например Opus is experiencing high load, please use /model to switch to Sonnet.

​

Request timed out

Request timed out

• Повторите запрос
• Для долгосрочных задач разбейте работу на более мелкие запросы
• Если причина в медленной сети или прокси, увеличьте API_TIMEOUT_MS, как описано в Automatic retries
• Если тайм-ауты частые и ваша сеть в остальном здорова, см. Network and connection errors ниже

​

The response above may be incomplete

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.

• 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

<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 и повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки

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)

• Одобрите или отклоните действие в появившемся запросе
• Запустите /compact, чтобы уменьшить размер беседы, чтобы последующие действия снова поместились в окне классификатора

​

Agent terminated early due to an API error

Agent terminated early due to an API error: <error detail>

• Сопоставьте деталь ошибки после двоеточия с ее собственным разделом на этой странице, например Usage limits или Server errors, и следуйте шагам этого раздела
• После того как основная ошибка исчезнет, попросите Claude повторить задачу или resume the subagent

​

Ограничения использования

​

Вы достигли лимита сеанса

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

• Дождитесь времени сброса, указанного в ошибке
• Для лимита Opus запустите /model и переключитесь на другую модель, чтобы продолжить работу
• Запустите /usage для просмотра лимитов вашего плана и времени их сброса
• Запустите /usage-credits для покупки дополнительного использования на Pro и Max, или для запроса у администратора на Team и Enterprise. См. usage credits for paid plans для информации о выставлении счетов.
• Для обновления вашего плана на более высокие базовые лимиты см. claude.com/pricing

​

Требуются кредиты использования для контекста 1M

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

• Запустите /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 Error: Server is temporarily limiting requests (not your usage limit)

• Подождите немного и попробуйте снова
• Проверьте status.claude.com если проблема сохраняется

​

Запрос отклонен (429)

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

• Запустите /status и подтвердите, что активные учетные данные - это те, которые вы ожидаете. Случайный ANTHROPIC_API_KEY в вашей среде может маршрутизировать запросы через ключ низкого уровня вместо вашей подписки.
• Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо
• Для API ключей Anthropic см. rate limits reference для информации о том, как работают уровни и как установить ограничения расходов для каждого рабочего пространства
• Снизьте параллелизм: понизьте CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с /model для высокообъемных скриптовых запусков

​

Баланс кредитов слишком низкий

Credit balance is too low

• Добавьте кредиты на platform.claude.com/settings/billing, и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся до того, как он упадет до нуля
• Переключитесь на аутентификацию подписки с /login если у вас есть план Pro, Max, Team или Enterprise
• Установите ограничения расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. Manage costs effectively.

​

Ошибки аутентификации

​

Not logged in

Not logged in · Please run /login

• Запустите /login для аутентификации с помощью вашей подписки Claude или учетной записи Console
• Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что ANTHROPIC_API_KEY установлена и экспортирована в оболочке, где вы запустили claude
• Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт apiKeyHelper, который получает ключ при запуске
• См. Authentication precedence, чтобы понять, какие учетные данные использует Claude Code, когда присутствует несколько

​

Could not resolve authentication method

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

• Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены
• Убедитесь, что ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN или учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке
• Для Agent SDK см. authentication setup
• Запустите /status в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается

​

Invalid API key

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

​

Your apiKeyHelper script is failing

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

• Запустите команду, настроенную в apiKeyHelper, непосредственно в вашей оболочке, чтобы воспроизвести сбой
• Если команда сообщает об истекшей сессии, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в ваш SSO или хранилище секретов
• Исправьте команду так, чтобы она выводила ключ на stdout и выходила с кодом 0. См. rotate credentials with apiKeyHelper для рабочей настройки.
• Запустите /status, чтобы подтвердить, что apiKeyHelper является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели Cloud authentication в терминале.

​

This organization has been disabled

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.

• Отмените установку ANTHROPIC_API_KEY в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите claude
• Запустите /status после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка
• Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая связана с вашим /login. Свяжитесь с поддержкой или войдите с другой учетной записью.

​

Your organization has disabled API key authentication

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

• Если сообщение называет ANTHROPIC_API_KEY, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла .env, затем перезапустите claude
• Если сообщение называет apiKeyHelper, удалите параметр apiKeyHelper из вашего settings.json
• Запустите /login для входа с помощью вашей учетной записи claude.ai
• Запустите /status после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API
• Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console

​

Your organization has disabled Claude subscription access

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

• Попросите администратора включить доступ Claude Code для вашей организации
• Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. Claude Console authentication для настройки.
• Если вы администратор и не видите опцию для включения доступа, свяжитесь с Anthropic support

​

Routines are disabled by your organization’s policy

Routines are disabled by your organization's policy.

• Попросите владельца в вашей организации включить переключатель Routines на claude.ai/admin-settings/claude-code
• Для одноразовой запланированной работы, которая не требует routines на уровне организации, см. scheduled tasks

​

Remote Control requires the Anthropic API

Remote Control is only available when using Claude via api.anthropic.com.

• Отмените установку 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

​

Login expired

Login expired · Please run /login

Failed to authenticate: OAuth session expired and could not be refreshed

• Запустите /login для повторного входа. Повторная попытка без входа показывает то же сообщение при каждом запросе.
• В неинтерактивном режиме запустите claude в том же окружении, завершите /login, затем повторно запустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью ANTHROPIC_API_KEY или generate a long-lived token with claude setup-token.
• Если вход продолжает не выполняться, см. Login and authentication

​

OAuth scope requirement

OAuth token does not meet scope requirement: user:profile

• Запустите /login для получения нового токена с текущими областями. Вам не нужно предварительно выходить.

​

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, названную в сообщении, такую как 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

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 sso login, на случай, если причиной является истекшие учетные данные
• Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в IAM configuration присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона
• Запустите aws sts get-caller-identity для подтверждения того, какой идентификатор используют ваши запросы; устаревший AWS_PROFILE или профиль по умолчанию — это частая причина несоответствия разрешений

​

AWS default-chain credential resolve timed out

API Error: AWS default-chain credential resolve timed out

• Запустите aws sts get-caller-identity в той же оболочке с тем же AWS_PROFILE. Если он также зависает, исправьте профиль; команда credential_process, которая запрашивает интерактивно, — это частая причина.
• Завершите шаг входа перед запуском Claude Code, например aws sso login --profile myprofile, чтобы цепь разрешилась из локального кэша SSO вместо ожидания потока браузера
• Если ваша цепь запускает интерактивный вход, который законно требует более 60 секунд, такой как SSO с MFA через оболочку, как aws-vault, повысьте лимит в миллисекундах с помощью CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

​

Ошибки сети и подключения

​

Unable to connect to 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

• Убедитесь, что вы можете достичь хоста 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 для настройки.
• Убедитесь, что ваш брандмауэр разрешает хосты, указанные в Требования к доступу в сеть
• Перебойные сбои автоматически повторяются; постоянные сбои указывают на локальную проблему с сетью

• На Linux и WSL проверьте /etc/resolv.conf на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.
• На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте ifconfig на наличие устаревших интерфейсов utun и удалите сетевое расширение VPN в Параметрах системы.
• Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.

​

Bedrock streaming response has an unexpected content-type

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

• Настройте шлюз для передачи тела ответа InvokeModelWithResponseStream и его заголовка Content-Type без изменений. Промежуточный узел, который повторно отправляет поток как события, отправляемые сервером, является распространённой причиной.
• Если шлюз переписывает только заголовок и передаёт двоичное тело без изменений, установите CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 для пропуска проверки до исправления шлюза. См. Ошибки потоковой передачи за шлюзом или прокси.

​

SSL certificate errors

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

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 403
x-deny-reason: host_not_allowed

• Откройте подпрограмму для редактирования или запустите облачную сессию. Выберите облачный значок, показывающий имя вашей среды, например Default, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.
• В диалоговом окне Update cloud environment измените Network access с Trusted на Custom, затем добавьте заблокированный домен в Allowed domains. Введите один домен в строку. Установите флажок Also include default list of common package managers, чтобы сохранить список разрешений по умолчанию вместе с вашими пользовательскими доменами. Выберите Full вместо этого, если вы хотите неограниченный доступ.
• Нажмите Save changes. Следующий запуск использует обновленный список разрешений.

​

Couldn’t reconnect to your Remote Control session

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

• Запустите /remote-control для повторной попытки подключения
• Запустите Claude Code без --resume для создания новой сессии Remote Control
• Для других сообщений при запуске Remote Control см. Troubleshoot Remote Control

​

Ошибки запроса

​

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 вручную перед заполнением окна.

​

Error during compaction: Conversation too long

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

• Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите /compact снова.
• Если отступление не освобождает достаточно места, запустите /clear для начала новой сессии. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью /resume.

​

Request too large

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

• Нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, который добавил содержимое с избыточным размером
• Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude мог читать их по частям
• Для изображений смотрите Image was too large ниже

​

Image was too large

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

• Измените размер изображения перед вставкой. API принимает изображения размером до 8000 пикселей по самому длинному краю для одного изображения, или 2000 пикселей, когда в контексте много изображений.
• Сделайте более плотный скриншот соответствующей области вместо полного экрана

​

Unable to resize image

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.

• Если сообщение просит вас преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Claude Code может проверить размеры для этих форматов без обработчика изображений.
• Если сообщение сообщает об ограничении размера или размеров, измените размер или перекомпрессируйте изображение ниже этого лимита перед прикреплением.

​

PDF errors

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

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

• Настройте ваш шлюз для пересылки заголовка anthropic-beta. Смотрите feature pass-through для того, что шлюзы должны пересылать.
• В качестве резервного варианта установите CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 перед запуском. Это отключает функции, которые требуют заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.

​

There’s an issue with the selected model

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 вернётся к умолчанию вашей учётной записи.
• Claude Code сообщает об истёкшем входе claude.ai как Login expired, а не как об этой ошибке. До v2.1.206 истёкший вход, который больше не удалось обновить, не удавался для каждой модели с этой ошибкой; запустите /login, если вы видите это в более старой версии.
• Для развёртываний Google Cloud’s Agent Platform смотрите Google Cloud’s Agent Platform troubleshooting.

​

Model is not a recognized model id

Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

• Запустите /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

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

• Запустите /model для выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.
• Если ограниченная модель была установлена в --model, ANTHROPIC_MODEL или поле model файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске
• Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить её. Смотрите Organization model restrictions.

​

thinking.type.enabled is not supported for this model

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 вместо этого
• Если вы столкнулись с этим в 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

• Понизьте MAX_THINKING_TOKENS, или повысьте CLAUDE_CODE_MAX_OUTPUT_TOKENS выше бюджета мышления
• Смотрите Extended thinking для того, как бюджет взаимодействует с длиной вывода

​

Tool use or thinking block mismatch

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

• Если вы используете Opus 4.7 или Opus 4.8, сначала запустите claude update. Версии до v2.1.156 могут вызвать эту ошибку при нормальном использовании инструмента, и /rewind её не очищает.
• Запустите /rewind, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите Checkpointing для того, как создаются и восстанавливаются контрольные точки.

​

Usage Policy refusal

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.

• Нажмите 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.

• На Amazon Bedrock, Google Cloud’s Agent Platform и Microsoft Foundry флаг кибербезопасности производит сообщение Usage Policy refusal вместо этого.
• Non-interactive mode опускает предложение /feedback.

• Если ваша работа требует этого содержимого, подайте заявку на доступ через Cyber Verification Program
• Если ваш запрос не был о теме кибербезопасности, запустите /feedback для сообщения о ложном срабатывании
• Чтобы продолжить работу в той же сессии, нажмите Esc дважды или запустите /rewind для возврата к контрольной точке перед ходом, который вызвал флаг, затем примите другой подход. Смотрите Checkpointing.

​

Ошибки установки

​

Установка была прервана до завершения

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.

• Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик
• Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. Установка прервана на серверах Linux с низким объёмом памяти для команд файла подкачки.

​

Соединение разорвалось при загрузке обновления

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

• Запустите claude update снова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени запустите его снова из более быстрой или менее ограниченной сети.
• Если ваша сеть требует прокси, установите HTTPS_PROXY перед запуском установщика или claude update. См. Проверка подключения к сети.
• Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с downloads.claude.ai. См. Требования к доступу в сеть.
• Запустите claude doctor из вашей оболочки для диагностики установки

​

Ошибки командной строки

​

Конфликт между —bg и —print

--bg и --print конфликтуют: --print никогда не запускает интерактивный сеанс, к которому подключается `claude agents`, поэтому задание было бы недоступным. Запрос — это позиционный аргумент — удалите --print: `claude --bg '<task>'`.

• Удалите -p или --print. --bg принимает запрос в качестве позиционного аргумента, поэтому claude --bg "<task>" — это полная команда. См. Dispatch new agents from your shell.
• Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите --bg и запустите claude -p "<task>"

​

Значение —json-schema не является допустимой JSON Schema

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

• Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду
• Если диагностика — schema too large, уменьшите вложенность схемы и повторное использование $ref
• См. Get structured output для рабочей схемы и команды

​

Не удалось импортировать сервер из Claude Desktop

Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

• Переименуйте сервер в claude_desktop_config.json, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите claude mcp add-from-claude-desktop
• Добавьте этот сервер напрямую с помощью claude mcp add или claude mcp add-json под допустимым именем. См. Import MCP servers from Claude Desktop.

​

Инструмент запроса разрешения MCP не найден

Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

• Проверьте, что сервер запускается и остаётся подключённым: запустите claude mcp list в том же каталоге и подтвердите, что сервер указан как подключённый
• Подтвердите, что имя инструмента совпадает с именем mcp__<server>__<tool>, которое предоставляет сервер
• Если серверу требуется более 30 секунд для запуска, увеличьте MCP_TIMEOUT

​

Ошибки плагинов

​

Marketplace is registered from an untrusted source

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

​

Plugin command references user_config in a shell command

Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}

Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.

headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).

• Для хука добавьте массив args, чтобы он выполнялся в exec форме, где каждый ${user_config.KEY} становится одним аргументом без оболочки между ними. Или удалите ссылку и прочитайте переменную окружения $CLAUDE_PLUGIN_OPTION_<KEY> внутри скрипта
• Для monitor удалите ссылку и пусть скрипт monitor прочитает значение из файла конфигурации
• Для headersHelper переместите ${user_config.KEY} в поле headers сервера, которое не анализируется оболочкой, или прочитайте значение внутри скрипта помощника

​

Ошибки инструментов

​

Agent would be spawned with zero tools

Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.

• Исправьте каждую запись, которую ошибка называет, в соответствии с инструментами, доступными подагентам
• Удалите записи для инструментов, которые сессия не имеет, такие как инструменты MCP с сервера, который не подключён
• Чтобы дать подагенту каждый инструмент, который есть у родителя, удалите поле tools вместо перечисления инструментов

​

File is covered by a Read deny rule

File is covered by a Read deny rule in your permission settings and cannot be edited.

• Если Claude должен иметь возможность редактировать файл, удалите или сузьте правило отказа Read в /permissions или в параметрах
• Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа Edit для того же пути, чтобы инструменты Write и NotebookEdit также были заблокированы

​

Ошибки фоновой сессии

​

Команды, отклоненные в фоновой сессии

Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.

• Используйте форму, указанную в сообщении, например /mcp reconnect <server>, /mcp enable или /mcp disable
• Для потоков входа и авторизации запустите команду из обычной сессии claude в терминале

​

Ошибки средства запуска CLAUDE_CODE_PROCESS_WRAPPER

CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

• Установите переменную на абсолютный путь исполняемого файла, который заканчивается вызовом exec "$@". Полный контракт см. в разделе контракт средства запуска
• Проверьте /status, который показывает разрешенную команду запуска в записи Self-exec и предупреждает, когда работающая фоновая служба не совпадает с ней, или запустите claude daemon status из оболочки
• После исправления значения в блоке env параметров перезагрузите фоновую службу с помощью claude daemon stop --any, чтобы следующая отправка запустила завернутую

​

Предупреждения о конфигурации

​

Рабочее пространство не было доверено

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 в каталоге и примите диалоговое окно доверия. Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 диалоговое окно не появлялось в этой ситуации, поэтому этот шаг не мог быть завершен там.
• В неинтерактивном режиме с флагом -p диалоговое окно не отображается. Установите запись hasTrustDialogAccepted в ~/.claude.json, используя точный ключ projects, который выводит сообщение.
• Если сообщение указывает на .claude/settings.local.json и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный .claude/settings.local.json как предоставленный репозиторием в этих рабочих пространствах. На версии 2.1.207 и более поздних обновление недостаточно вне репозитория git, если вы не доверили папке: определение того, что папка находится вне репозитория, запускает git, и Claude Code запускает эту проверку только после того, как вы примете диалоговое окно доверия, поэтому используйте первый шаг. Ваш домашний каталог и любой другой домашний каталог конфигурации исключены и не ждут диалогового окна. См. Правила разрешения проекта и доверие рабочему пространству.

​

Ответы кажутся менее качественными, чем обычно

• Настроенный --fallback-model берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке
• Проверка запуска Amazon Bedrock или Google Cloud’s Agent Platform обнаруживает, что ваша модель по умолчанию недоступна
• Автоматический fallback модели на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке

• Выбор модели: запустите /model, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор /model или переменная окружения ANTHROPIC_MODEL могут привести вас к меньшей модели, чем вы предполагали.
• Уровень усилий: запустите /effort, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы над дизайном. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. Adjust effort level для значений по умолчанию для каждой модели и сокращение ultrathink.
• Давление контекста: запустите /context, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите /compact в естественной точке разрыва или /clear, чтобы начать заново. См. Explore the context window для того, как auto-compact влияет на предыдущие ходы.
• Устаревшие инструкции: большие или устаревшие файлы CLAUDE.md и определения инструментов MCP потребляют контекст и могут направлять ответы. Проверка /doctor отмечает файлы памяти большого размера и неиспользуемые расширения, а /context показывает использование токенов инструментов MCP. До версии 2.1.205 /doctor открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.

​

Сообщить об ошибке

• Серверу MCP не удалось подключиться или пройти аутентификацию: MCP
• Скрипт hook не выполнился или заблокировал инструмент: Debug hooks
• Отказано в доступе или ошибки файловой системы при установке: Troubleshoot installation and login

• Запустите /feedback внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Отправка в Anthropic требует аутентификации. На Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry и других сторонних поставщиков, или когда учетные данные Anthropic не настроены, /feedback сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.
• Запустите claude doctor из вашей оболочки для диагностики только для чтения вашей установки или запустите проверку /doctor внутри Claude Code, чтобы найти и исправить проблемы настройки
• Проверьте status.claude.com на наличие активных инцидентов
• Поищите существующие проблемы на GitHub