Claude Code не запускается на Windows: причины и фикс
Если Claude Code не запускается на Windows, причина обычно в одной из пяти вещей: старая версия Node, кривой путь в PATH, проблема с npm, отсутствие ключа или права на папку. Реже антивирус блокирует терминальный агент. Диагностика занимает пару минут, дальше конкретный фикс.
Быстрая проверка за минуту
node --version # нужно 18 или выше npm --version claude --version # если команды нет, проблема в установке
Если node или npm не находятся, проблема в PATH или Node вообще не установлен.
Пять частых причин
| Симптом | Причина | Фикс |
|---|---|---|
| «command not found: claude» | Claude Code не установлен или нет в PATH | npm install -g @anthropic-ai/claude-code |
| Ошибки про старый Node | Node ниже 18 | Обновить Node до LTS |
| EACCES, Permission denied | Нет прав на папку npm | Запустить терминал от администратора или сменить папку npm |
| Ошибка авторизации при запуске | Не задан ANTHROPIC_API_KEY | Задать ключ в переменной окружения |
| Антивирус ругается на агент | Эвристика на терминальный процесс | Добавить папку claude в исключения |
Чистая установка
- Поставьте Node LTS с официального сайта.
- Откройте свежий терминал и проверьте
node --version. - Установите Claude Code:
npm install -g @anthropic-ai/claude-code. - Задайте ключ:
$env:ANTHROPIC_API_KEY="sk-ant-..."в PowerShell. - Запустите
claudeи проверьте любым сообщением.
claude всё ещё не находится, переоткройте терминал. PATH обновляется только в новой сессии. На PowerShell это ловит многих.Если ничего не помогло
Попробуйте WSL2: там Node и npm ставятся чище, а Claude Code работает стабильнее. Как поставить WSL2 с нуля, разобрано отдельно. Из РФ прямой доступ часто упирается в геоблок, тогда выручает реселлерский шлюз CLOD с оплатой рублём.
Частые вопросы
Claude Code работает на Windows без WSL?
Да, работает. WSL нужен не всегда, только когда под Windows ловятся баги версий или нужны unix-инструменты.
Какая версия Node нужна?
Версия 18 или выше. Лучше ставить LTS. На старых версиях Claude Code либо не запустится, либо будет глючить.
Нужно ли запускать терминал от администратора?
Обычно нет. Только если ловите EACCES на установке или доступе к папке npm. Чаще проблему решает смена папки npm, а не права админа.
Антивирус блокирует Claude Code, что делать?
Добавьте папку установки и процесса claude в исключения. Это эвристика на терминальный агент, а не реальная угроза.