Содержание
Вы установили Claude Code, но при вводе claude в терминале получаете вот такое — знакомо?
zsh: command not found: claude
bash: claude: command not found
'claude' is not recognized as an internal or external command # WindowsЭта ошибка означает «исполняемый файл claude не найден», и причина почти всегда — «папка установки не добавлена в PATH». Сама установка зачастую прошла успешно — просто оболочка не знает, где искать. В этой статье разберём способы установки и их расположение, как починить PATH, конфликты нескольких установок, ловушки Windows и обновление — на основе официальной информации.
Главное сразу. (1) command not found почти всегда означает лишь «~/.local/bin (папка установки) не в PATH» — добавьте её, перезапустите терминал, и всё заработает. (2) Ошибку прав доступа npm (EACCES) НЕ нужно лечить через sudo — вместо этого перейдите на нативный установщик. (3) Если застряли, запустите claude doctor — он разом проверяет целостность установки, настройки и результат обновления. Точные команды и значения по умолчанию меняются от версии к версии, поэтому сверяйтесь с актуальной официальной документацией.
Установлен, но не найден
— просто папка установки не в PATH
Бинарник точно существует. Просто в PATH оболочки нет его расположения.
Поэтому решение — «добавить одну строку в PATH» — обычно меньше минуты.
1. О чём говорит эта ошибка
Когда вы вводите команду, оболочка (zsh / bash / PowerShell) по очереди просматривает папки, перечисленные в переменной окружения PATH, и запускает первый подходящий исполняемый файл. command not found: claude означает, что ни в одной из этих папок не нашлось claude.
Важный момент: это вовсе не обязательно означает, что установка провалилась. Нативный установщик кладёт claude в ~/.local/bin (в Windows: %USERPROFILE%\.local\bin), но если эта папка не в PATH, бинарник существует, а оболочка его не находит. Поэтому большинство случаев решается «добавить одну строку в PATH и перезапустить терминал». Прежде чем подозревать сбой установки, запустите ls ~/.local/bin/claude и проверьте, есть ли там бинарник.
В Windows «не та оболочка» для команды установки (например, запуск команды для PowerShell в CMD) даёт другие ошибки — об этом в §4. Сначала разберёмся с правильными способами установки и их расположением.
2. Способы установки и где лежит бинарник
Вот основные способы установки по состоянию на 2026 год и то, куда попадает бинарник (рекомендуется нативный установщик).
| Способ | Команда (общий вид) | Расположение / примечание |
|---|---|---|
| Нативный (рекомендуется) mac/Linux | curl -fsSL https://claude.ai/install.sh | bash | ~/.local/bin/claude. Автообновление |
| Нативный (рекомендуется) Windows | В PowerShell: irm https://claude.ai/install.ps1 | iex | %USERPROFILE%\.local\bin\claude.exe |
| npm | npm install -g @anthropic-ai/claude-code | Нужен Node 18+. Устанавливает тот же нативный бинарник |
| Homebrew (mac) | brew install --cask claude-code | Без автообновления → brew upgrade |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | Без автообновления → winget upgrade |
Суть в том, что официально рекомендуется нативный установщик. Версия из npm устанавливает тот же нативный бинарник (Node 18+ нужен только во время установки; для работы бинарнику Node не требуется), но она чаще приводит к проблемам с правами доступа и PATH. Если ставите с нуля, нативный вариант — безопасный выбор. Учтите, что установка только расширения для VS Code встраивает приватный CLI внутрь расширения и НЕ добавляет claude в PATH — если вам нужен claude в терминале, установите его отдельно.
3. Основные причины и их устранение
Вот распространённые причины вокруг command not found в паре со способами устранения.
Главные причины с установкой / PATH
~/.local/bin вне PATH. Добавьте export PATH="$HOME/.local/bin:$PATH" в ~/.zshrc/~/.bashrc и перезапустите терминал.sudo npm (официально не рекомендуется). Переход на нативный установщик — самый быстрый и безопасный способ.which -a claude (Win: where.exe claude) и оставьте только нативную.Could not find native binary package ... появляется, когда вы установили с пропуском опциональных зависимостей. Переустановите без --omit=optional и т. п.
Если сомневаетесь, «переустановить через нативный установщик» решает большинство из этого —
он разом обходит проблемы прав доступа, Node и конфликтов.
Конкретный способ починить PATH (macOS zsh): echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, затем source ~/.zshrc. В Linux bash сделайте то же самое в ~/.bashrc. После изменения откройте новый терминал.
4. Ловушки, характерные для Windows
В Windows классический провал — запуск команды установки в «не той оболочке». По тексту ошибки видно, какая именно путаница произошла.
Как распознать путаницу с оболочкой
| Ошибка | Смысл и решение |
|---|---|
'irm' is not recognized ... | Команду для PowerShell запустили в CMD → используйте PowerShell: irm ... | iex |
The token '&&' is not valid | Команду для CMD запустили в PowerShell → используйте команду для CMD |
'bash' is not recognized ... | Установщик для Linux запустили в Windows → используйте установщик для PowerShell |
Прочие замечания по Windows: (1) Перезапустите терминал после установки (изменение PATH вступает в силу в новом терминале). (2) Старый Claude Desktop, зарегистрировавший WindowsApps\Claude.exe, может привести к тому, что claude запускает десктоп-приложение вместо CLI — обновите Claude Desktop. (3) Если Git Bash не найден, укажите в настройках в CLAUDE_CODE_GIT_BASH_PATH путь к вашему bash.exe. Запуск под WSL — тоже вариант.
5. Автообновление и обновление вручную
Нативные установки обновляются в фоне автоматически и применяются при следующем запуске. Чтобы обновить вручную, используйте claude update; чтобы переустановить/закрепить конкретную версию, используйте claude install <version> (также принимаются stable / latest). Проверяйте результат обновления через claude doctor.
Когда автообновление не работает на установке npm
Если глобальная папка npm недоступна для записи, автообновление падает. claude doctor перечислит способы починки, а корневое решение — перейти на нативную установку. Чтобы просто остановить автообновление, задайте DISABLE_AUTOUPDATER в env настроек (обновления вручную продолжат работать); чтобы заблокировать все обновления, задайте DISABLE_UPDATES.
6. Алгоритм диагностики
Когда причина неясна, идите сверху вниз. Большинство случаев решается к шагу 3.
Локализуйте проблему сверху вниз
claude doctor (из оболочки, если не запускается) для проверки целостности установки.which -a claude / where.exe claude, чтобы увидеть, где и сколько установлено (есть ли конфликты).~/.local/bin в PATH и перезапустите терминал.
Правило: «существует ли бинарник → в PATH ли он → нет ли конфликта?» именно в таком порядке.
Когда застряли, нативная переустановка — надёжное последнее средство.
Итоги
«command not found: claude» в Claude Code в большинстве случаев — это просто «папка установки (~/.local/bin) не в PATH». Бинарник существует, поэтому добавьте одну строку в PATH и перезапустите терминал — и всё заработает. Для установки рекомендуется нативный установщик (версии из npm нужен Node 18+, и у неё больше ловушек с правами/PATH). EACCES в npm нужно лечить переходом на нативный вариант, а не sudo.
Диагностируйте так: (1) claude doctor -> (2) which -a claude / where.exe claude на конфликты -> (3) добавить ~/.local/bin в PATH -> (4) удалить лишние версии -> (5) нативная переустановка. В Windows следите за путаницей с оболочкой (например, irm в CMD), необходимостью перезапустить терминал и конфликтом со старым Claude Desktop (Claude.exe). Обновляйте через claude update / claude install, а остановить автообновление можно через DISABLE_AUTOUPDATER. Когда застряли, нативная переустановка — надёжное решение. По теме: сборник ошибок Claude Code, ошибки аутентификации / входа.
FAQ
Q. Я установил его, но получаю command not found: claude.
A. Почти наверняка папка установки не в вашем PATH. Сначала проверьте, существует ли бинарник, через ls ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin); если он там, добавьте export PATH="$HOME/.local/bin:$PATH" в ~/.zshrc/~/.bashrc и откройте новый терминал. Сама установка обычно прошла успешно.
Q. npm install -g падает с ошибкой прав доступа (EACCES).
A. Не используйте sudo npm (официально не рекомендуется; это провоцирует проблемы с правами и безопасностью). Самый быстрый и безопасный путь — перейти на нативный установщик (mac/Linux: curl -fsSL https://claude.ai/install.sh | bash). У нативной сборки нет ловушек с правами доступа и не требуется Node. Можно также перенести глобальный префикс npm в каталог, доступный пользователю для записи, но официальная рекомендация — нативный вариант.
Q. У меня несколько установок claude, и запускается старая версия.
A. Запустите which -a claude (Windows: where.exe claude), чтобы увидеть все claude в PATH. Возможно, у вас смешаны npm-global, Homebrew, WinGet и нативная установки. Оставьте нативную (~/.local/bin) и удалите остальные (например, npm uninstall -g @anthropic-ai/claude-code), чтобы свести всё к одной установке.
Q. В Windows при вводе claude открывается десктоп-приложение.
A. Старый Claude Desktop зарегистрировал WindowsApps\Claude.exe, и он в PATH имеет приоритет над CLI. Обновите Claude Desktop, чтобы это устранить. Также, если после запуска установщика для PowerShell его не находит или показывает старую версию, перезапустите терминал, чтобы изменение PATH вступило в силу.
Q. Обновления не работают / я хочу их остановить.
A. Нативные установки обновляются в фоне автоматически и применяются при следующем запуске. Вручную используйте claude update; для переустановки/закрепления — claude install <version>. Если автообновление падает на глобальной установке npm, это проблема прав на запись — следуйте указаниям claude doctor и перейдите на нативный вариант. Чтобы остановить автообновление, задайте DISABLE_AUTOUPDATER в env настроек; чтобы заблокировать все обновления, задайте DISABLE_UPDATES.
