Claude code не работает

Если Claude Code не работает, начни с 2 команд в обычном терминале: claude --version и, если программа найдена, claude doctor. Затем выбери ветку по ошибке: вход, ответ модели или отдельный инструмент. Переустановка нужна далеко не при каждом отказе.

Проверено: 23 октября 2026 года по официальной документации Anthropic - установка и вход, справочник ошибок. Это сверка документации, без испытаний на всех операционных системах.

Как проверить, почему Claude Code не работает?

Сначала сохрани дословное сообщение и место, где оно появилось. Ошибка оболочки до запуска и отказ отдельного MCP - подключения к внешним инструментам - требуют разных проверок.

Один HTTP-код не заменяет текст ошибки. Например, 429 может сообщать о частоте запросов или ограничении расходов посредника. Повторять запрос до выяснения причины не стоит.

Что делать, если команда не найдена или окно не открывается?

Введи в обычном терминале, где ты запускаешь Claude Code:

claude --version

Если появился номер версии, оболочка нашла исполняемый файл. Если команда не распознана, ещё не время чинить аккаунт: проверь, установлен ли отдельный CLI - программа для терминала - и доступен ли его каталог через PATH - список мест, где терминал ищет программы.

На macOS и Linux официальный путь нативной установки - ~/.local/bin/claude, на Windows - %USERPROFILE%\.local\bin\claude.exe. Наличие расширения редактора не означает, что отдельная команда доступна в терминале. Полный порядок для твоей системы есть в инструкции установки Claude Code.

Windows и WSL - среду Linux внутри Windows - проверяй раздельно. Также сравнивай панель расширения и встроенный терминал редактора. Запиши, какой вариант запускается, вместо удаления всех установленных копий.

Когда версия выводится, выполни:

claude doctor

Прочитай замечания об установке и настройках. Если нужно обновление, используй тот же способ, которым устанавливал Claude Code. После изменения открой новый терминал и снова проверь версию. Не ставь Node.js только ради номера версии: нативный бинарный файл Claude Code его не вызывает. Для MCP, запускаемого через npx, требования к Node.js проверяй в документации самого сервера.

Как проверить вход, регион и источник доступа?

В уже открытом диалоге Claude Code введи /status. Команды с начальным / здесь вводятся внутри агента, а не в обычной командной строке.

Проверь, используешь ли ты подписку Claude или API-ключ. Если ожидал подписку Claude, но видишь API-ключ, сначала выясни, откуда он взялся. Одобренный ключ из ANTHROPIC_API_KEY может использоваться вместо сохранённого входа по подписке. Его значение никому не отправляй.

Если это действительно случайно оставшийся ключ и ты хочешь вернуться к своей подписке, убери переменную только из текущей оболочки:

# Bash или Zsh
unset ANTHROPIC_API_KEY

# Windows PowerShell
Remove-Item Env:ANTHROPIC_API_KEY

Затем заново запусти Claude Code и проверь /status. Это временное изменение: если ключ задан в профиле оболочки или настройках запуска, он может вернуться. На рабочем компьютере сначала согласуй изменение с администратором. Другие источники доступа, например корпоративный шлюз, этими командами не отключаются.

При явном Login expired или указании Please run /login выполни /login. Если браузер завершил вход, но удалённый терминал его не получил, проверь предложенный самим клиентом ручной ввод кода: при удалённом запуске, в контейнере или WSL браузер и Claude Code могут работать на разных компьютерах или в разных средах. Код вводи только в свою текущую попытку входа.

При App unavailable in region проверяй поддерживаемые страны в официальной справке, на которую ссылается документация установки. Переустановка не меняет условия доступа. При явной блокировке аккаунта дальнейшее решение принадлежит Anthropic. Для остальных случаев есть отдельный разбор Request failed 403: один 403 ещё не означает бан.

Не начинай с /logout и удаления настроек: выход удаляет сохранённые входы MCP и секреты плагинов. Сначала установи, что именно требует повторной авторизации.

Как отличить лимит, перегрузку и проблему сети?

Читай полное сообщение. У каждого отказа свой следующий шаг.

• Исчерпана квота плана. Открой /usage и посмотри время сброса. Перезапуск компьютера её не обновляет. Если ждать нельзя, решение об изменении плана или расходах принимает владелец оплаты.
• Ограничен API-ключ или бюджет. Сверь источник в /status и ограничения в кабинете соответствующего провайдера. Наличие подписки Claude не подтверждает баланс отдельного API-ключа.
• 500 или 529 Overloaded. Проверь страницу статуса сервиса, указанную в ошибке; для прямого Anthropic это status.claude.com. Дождись завершения текущих повторных попыток клиента. Не запускай параллельно одну и ту же задачу, особенно с внешними действиями.
• Request timed out или ошибка подключения. Зафиксируй, какой адрес и на каком этапе недоступен. Работа сайта в браузере не доказывает доступность API из терминала: настройки сети у них могут различаться.
• SELF_SIGNED_CERT_IN_CHAIN или ошибка доверия сертификату. Проверь корпоративный прокси и сертификат организации с администратором. Не выключай TLS - проверку защищённого соединения - ради продолжения работы.

Что проверить, если ответ есть, а действие не выполняется?

Не работает один MCP-сервер. Открой /mcp, выбери проблемное подключение и прочитай его состояние. Требование входа, ожидание подтверждения и ошибка соединения - разные ситуации. Если нужен вход, пройди его для этого сервера; если требуется одобрение проекта, реши, доверяешь ли подключению.

Не вставляй в конфиг случайный адрес и не подменяй токен чужим. Ответ 401, 404 или 405 при ручном обращении к адресу сам по себе не подтверждает работоспособность MCP: важны правильный адрес, способ запроса, авторизация и доступность нужного инструмента внутри Claude Code.

Агент отвечает, но запрещена команда. Посмотри объяснение отказа и настройки разрешений. Внутри сессии /doctor помогает проверить установку, настройки и расширения, предлагая исправления после подтверждения. Не подтверждай непонятную правку автоматически и не выдавай полный доступ ко всему компьютеру. Для подробностей открой настройку Claude Code и разрешений.

Проблема появилась только в одном проекте. Сравни его правила, настройки и MCP с рабочим окружением. Меняй по одному параметру, сохраняя прежний вариант. Правила, заданные организацией, должен разбирать её администратор.

Зависает длинный разговор. Если ошибка указывает на заполненный контекст, попробуй /compact для сжатия диалога. При Not enough messages to compact сохрани краткую запись задачи и начни новый диалог с меньшим объёмом данных. Если сжатие сообщает об ошибке входа или сети, сначала устрани её.

Как убедиться, что проблема устранена?

Проверяй тот этап, который раньше не работал. Номер версии, успешный вход и ответ модели - три отдельных результата.

Чтобы не проверять ответ на рабочем проекте, создай отдельную папку и обычный файл proverka.txt со строкой:

Проверка чтения: жёлтый блокнот.

Используй только нейтральный текст без закрытых данных: запрос к модели расходует квоту или API-баланс. Отдельная папка не изолирует компьютер, поэтому не выдавай разрешения на запись и лишние команды. Открой Claude Code в этой папке и отправь:

Прочитай proverka.txt и верни его содержимое дословно.
Ничего не изменяй. Не используй сетевые инструменты, MCP
и команды оболочки. Только прочитай файл и ответь.

Сверь ответ со своим файлом и убедись, что содержимое папки не изменилось. Это учебный пример, а не результат проведённого здесь теста. Успех подтверждает ответ модели и чтение этого файла; доступ к конкретному MCP или право на публикацию он не подтверждает. Их проверяй отдельно подходящим действием без записи.

Если перед сбоем агент отправлял сообщение, публиковал страницу или менял удалённые данные, сначала открой целевой сервис и проверь результат. Пропавший ответ терминала не доказывает, что операция не выполнилась. Повтор при неизвестном исходе может создать дубль.

Если ошибка осталась, подготовь для поддержки:

• дословное сообщение, время и шаг, на котором оно появилось;
• ОС, оболочку и вариант запуска - терминал, расширение или удалённая машина;
• версию клиента и замечания из claude doctor;
• ожидаемый способ доступа и результат уже сделанных проверок.

Перед отправкой убери ключи, токены, коды входа, контакты и закрытые данные проекта. Передай сетевую ошибку администратору сети, ошибку отдельного MCP его владельцу, а отказ аккаунта - поддержке провайдера.

Куда перейти после проверки запуска?

Хочешь разобраться, как задавать агенту правила и управлять разрешениями? Посмотри программу ClaudeBase: в ней есть материалы о рабочем окружении, правилах проекта и разрешениях. Программа открыта без оплаты; доступ к базе - после оплаты. Подписки Anthropic и OpenAI оплачиваются отдельно.

Подписка не снимает блокировки аккаунтов. Предложение относится к дальнейшему обучению работе с агентом: помощь по конкретной ошибке запуска в составе базы не подтверждена.

Источники

Все страницы открыты 23 октября 2026 года:

• Anthropic: установка и вход - запуск, PATH, авторизация, старый ключ и сертификаты.
• Anthropic: справочник ошибок - лимиты, серверные ошибки, вход, сеть и MCP.
• Anthropic: производительность и стабильность - проверки внутри сессии и сжатие контекста.
• Установка и обновление - способы установки и нативный бинарный файл.
• Подключение MCP - состояния серверов и одобрение проекта.