Шаг 1: получите настоящее сообщение об ошибке
claude --version # is the CLI there at all?
claude # start it directly: the real error prints here
claude doctor # install health checkЕсли в терминале всё работает, а сбой возникает только в расширении или приложении, проблема в окружении, из которого запускается оболочка (PATH, версия Node, переменные прокси), а не в самом Claude Code. Если сбой возникает и в терминале, ищите решение по сообщению, которое он выводит.
Известные причины (из трекера задач)
- Возобновление фонового сеанса в VS Code. Открытие сеанса, запущенного с помощью
claude --bgвызывает именно эту ошибку — о ней сообщали на macOS, Windows и Linux (#77162). Сначала остановите фонового агента или откройте новый сеанс. - Windows: оставшийся процесс после сбоя. Приложение не может запуститься повторно, потому что старый процесс всё ещё удерживает блокировку (#42776, #53247). Завершите оставшиеся
claudeпроцессы в диспетчере задач; надёжное решение, о котором сообщают в этом обсуждении, — полная перезагрузка Windows. - Настольное приложение на Apple Silicon завершается с ошибкой при каждом запуске сеанса, хотя CLI работает (#59866, дубликат известной проблемы) — обновите приложение; пока используйте CLI в терминале.
- Node.js ниже 18 или повреждённый PATH после установки через npm — оболочка не может запустить CLI.
node -v; перейдите на нативный установщик, чтобы убрать зависимость от Node. - Некорректный `~/.claude/settings.json`. Лишняя запятая в блоке хуков или разрешений приводит к немедленному завершению CLI. Проверьте корректность JSON.
- Несовместимость командных оболочек в Windows — сбой инструмента PowerShell при запуске из Git Bash с определённой моделью (#87980); попробуйте другую командную оболочку.
Если ничего из перечисленного не подходит
- Обновите всё:
claude update, а также обновите расширение VS Code или настольное приложение. - Переустановите с помощью нативного установщика (
curl -fsSL https://claude.ai/install.sh | bash, либо однострочных команд PowerShell / CMD из руководства по установке). - Запустите VS Code из терминала, чтобы он унаследовал то же окружение, в котором CLI работает.
- Создайте новую задачу в трекере и приложите вывод
claude doctor— сообщения о сбоях в трекере быстро рассматривают.
Связанные материалы
Если Claude Code запускается, но затем выдаёт ошибку API, это другая проблема: см. Ошибка API 500, перегрузка / 529, Ошибка API 400 или Ошибки OAuth. Для расширения см. Claude Code в VS Code.
Устали бороться с этой ошибкой?
Запускайте Claude Code через шлюз AI Prime Tech: те же модели Claude на собственных вышестоящих аккаунтах шлюза, две переменные окружения для переключения, а новые аккаунты получают $5 бесплатного баланса для API по коду FIXIT — без банковской карты.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyЧасто задаваемые вопросы
Что означает «Процесс Claude Code завершился с кодом 1»?
Расширение VS Code или настольное приложение запустило CLI Claude Code, и тот завершился с ошибкой. Запустите claude в терминале, чтобы увидеть настоящее сообщение об ошибке.
Как исправить завершение Claude Code с кодом 1 в Windows?
Завершите оставшиеся процессы claude (или перезагрузите Windows, если приложение не запускается повторно), проверьте node -v и PATH, проверьте корректность ~/.claude/settings.json и при необходимости переустановите с помощью нативного установщика.
Почему Claude Code работает в терминале, но не в VS Code?
VS Code запущен с другим окружением (PATH, Node, переменные прокси). Запустите VS Code из терминала, в котором claude работает, или исправьте переменные в профиле командной оболочки.
Запускайте Claude Code через шлюз
Те же модели, две переменные окружения, кредиты с балансом в 7.69231 раза больше номинала — или безлимитный тариф с фиксированной оплатой. Для новых аккаунтов: $5 бесплатного баланса для API по коду FIXIT.
Получить API-ключ Посмотреть безлимитные тарифыAI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.