Claude Code ошибка установки за 10 минут

Я, Арина Михална, могу подтвердить, что ошибка установки Claude code в 90% случаев — это не сломанный Claude Code, а PATH: система не видит команду Claude, потому что путь к ней не попал в переменную окружения. Лечится за 10 минут без переустановки: проверяешь версию Node.js, находишь актуальный путь и вручную дописываешь его в PATH — на Windows через системные переменные, на macOS и Linux через файл профиля.

Я, Арина Михална, ставила Claude Code на трёх машинах — рабочий Мак, старый Windows-ноут и виртуалку на Linux — и на каждой хоть раз влетала в свою версию этой ошибки. Разница между «не работает вообще» и «работает через 10 минут» — это не магия, а порядок действий. Ниже — он.

Почему возникает Claude is not recognized

Ошибка Claude is not recognized as an internal or external command (Windows) или command not found: Claude (macOS/Linux) значит одно: терминал ищет исполняемый файл Claude по списку папок из переменной PATH и не находит его там. Установщик может отработать без единой ошибки, а команда всё равно не запустится — потому что npm поставил пакет в папку, которой в PATH нет, или терминал не перечитал переменные после установки.

Разложила частые причины по тому, что реально в них не так:

Что видишь	Что происходит на самом деле	Что чинить
Claude is not recognized (Windows)	путь к npm global не в PATH	добавить путь вручную
command not found (macOS/Linux)	~/.zshrc или ~/.bashrc не подхватил путь	прописать export PATH в профиль
Claude code не запускается, тихо падает	несовместимая версия Node.js	обновить Node.js до 18+
команда находится, но виснет на старте	конфликт двух установок Node.js	оставить одну через nvm/fnm
ошибка сети/TLS при первом запуске	корпоративный прокси режет сертификат	настроить NODE_EXTRA_CA_CERTS

Диагностика: три команды, которые сразу говорят, где искать проблему

Не гадай — проверь. Три команды покрывают 80% причин.

node -v
npm config get prefix
echo $PATH

На Windows последнюю команду в PowerShell пишешь как $env:PATH, в cmd — echo %PATH%.

Что смотреть в выводе:

• node -v ниже v18 — Claude Code не гарантирует работу на старых версиях, обновляй Node.js первым делом, до всего остального.
• npm config get prefix — это путь, где лежит папка bin с исполняемым файлом Claude. Если этого пути нет в PATH из третьей команды — вот твоя ошибка целиком.
• echo $PATH — длинная строка через : (Linux/macOS) или ; (Windows). Ищи в ней путь из пункта выше глазами, не автоматически.

Claude code path windows: как прописать вручную

На Windows PATH чаще всего теряется потому, что npm ставит пакет в папку пользователя (%AppData%\npm), а системная переменная про неё не знает, или терминал открыт с момента до установки и просто не перечитал переменные.

Шаги:

1. Найди путь: npm config get prefix — обычно что-то вроде C:\Users\<имя>\AppData\Roaming\npm.
2. Открой «Изменение системных переменных среды» (через поиск в меню «Пуск»).
3. Кнопка «Переменные среды» → в блоке «Переменные пользователя» найди Path → «Изменить».
4. «Создать» → вставь путь из шага 1 → «ОК» на всех окнах.
5. Полностью закрой терминал (все окна, не одну вкладку) и открой заново.
6. Проверь: Claude --version.

macOS и Linux: когда профиль терминала не подхватывает путь

На Windows отсутствие macOS-раздела в большинстве гайдов не значит, что там всё гладко — просто ошибка выглядит по-другому: zsh: command not found: Claude. Причина та же — путь не в PATH, только чинится через файл профиля, а не через системные настройки.

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >>
~/.zshrc
source ~/.zshrc

Если используешь bash вместо zsh — замени ~/.zshrc на ~/.bashrc (Linux) или ~/.bash_profile (старый macOS). Проверить, какая у тебя оболочка: echo $SHELL.

Отдельная головная боль на macOS — Homebrew ставит свой Node.js в /opt/homebrew/bin, а официальный установщик Node.js — в /usr/local/bin. Если у тебя есть оба, which -a node покажет все версии сразу, и лишнюю нужно удалить, а не просто игнорировать: npm-пакеты, поставленные под одну версию, не всегда видны другой.

Проблемы с сетью, прокси и IDE-интеграцией

Если PATH в порядке, а Claude Code падает при первом запуске с ошибкой сети или TLS-сертификата — это почти всегда корпоративный прокси или антивирус, который подменяет сертификат. Решение: указать npm и Node.js доверять корпоративному сертификату через переменную NODE_EXTRA_CA_CERTS, а не отключать проверку TLS целиком — это дыра в безопасности, а не фикс.

Отдельно ловит боль связка с редакторами. Если ставишь Claude Code внутрь VSCode или JetBrains через встроенный терминал плагина, а не системный — есть шанс, что плагин запускает свою изолированную оболочку с собственным PATH, которая не видит то, что ты только что прописала руками. Проверка простая: открой обычный системный терминал (не встроенный в IDE) и повтори Claude --version там. Работает в системном, но не в IDE — значит, дело в конфигурации терминала редактора, а не в установке Claude Code.

Если ставишь Claude Code впервые и хочешь понять последовательность целиком, а не только фикс ошибок — у меня есть отдельный разбор как установить Claude Code с самого начала, без прыжков в диагностику. А если ошибка вылезла не при установке, а при попытке зайти в аккаунт из России — это другая история, разобрана в статье про доступ к Claude Code в России.

Таблица: какую ошибку лечить чем

Ошибка	Причина	Фикс
Claude is not recognized	путь не в PATH (Windows)	добавить путь в системные переменные
command not found: Claude	путь не в профиле shell	export PATH в ~/.zshrc или ~/.bashrc
падает на старте без текста ошибки	Node.js < 18	обновить Node.js
работает в терминале, не в IDE	PATH встроенного терминала плагина другой	открыть системный терминал
TLS/сертификат при первом запуске	корпоративный прокси	NODE_EXTRA_CA_CERTS
ошибка после обновления	осколки старой версии	uninstall + cache clean + install

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

По материалам: документации Claude Code по установке, раздела troubleshooting в документации Anthropic и страницы загрузки Node.js с актуальными системными требованиями.

Читайте также

• Claude Code оценка задачи: почему агент врёт
• Как установить Claude Code в 2026: пошаговый гайд для новичков
• Claude Code ошибки и решения в 2026: 6 фиксов
• Claude Code скачать в 2026: инструкция для Windows, Mac и Linux
• На портале «Мастерская нейросетей»: Как установить Claude в России в 2026 году

Если статья решила твою конкретную ошибку — не благодарите, идите ставьте Claude Code дальше. А если хочешь получать такие разборы раньше, чем они попадают в статьи, — в боте у меня лежит гайд по установке Claude из России, забрать можно за подписку на канал: «А.М. решает вопросы». Там же разбираю, из-за чего слетают аккаунты и на что смотреть до того, как что-то ломается, а не после.