Claude Code: установщик или npm, что ставится на компьютер и почему не через sudo

Установка Claude Code выглядит как задача на одну команду, пока команда не упирается в версию Node.js, права доступа или особенности Windows. Дальше начинается разбор: почему npm ругается, чем скрипт с сайта отличается от пакета, и стоит ли повторять установку от суперпользователя.

Разбираем техническую сторону: что именно ложится на диск, чем отличаются способы установки, какая версия Node.js нужна и почему sudo помечен в документации как нежелательный.

Оглавление

• Что именно устанавливается на компьютер

• Установщик или npm: в чем разница

• Где появляется проблема с Node.js

• Как поставить Claude Code на Windows

• Как установить Claude Code на macOS

• Почему нельзя просто добавить sudo

Claude Code работает не так, как обычный чат Claude AI в браузере.

В браузере разработчик сам приносит модели контекст: вставляет код, прикладывает файлы, объясняет структуру проекта, получает ответ и переносит изменения обратно.

Claude Code запускается из терминала и работает непосредственно с файлами проекта. Поэтому ему можно дать задачу в контексте существующей кодовой базы, а не собирать нужные куски кода вручную перед каждым запросом.

Практическая разница хорошо видна на задаче, затрагивающей несколько файлов.

В чате сначала приходится найти нужные файлы, передать их содержимое Claude, объяснить связи между ними, получить предложенные изменения и затем перенести результат обратно.

В Claude Code работа начинается внутри самого проекта.

Именно поэтому установка имеет значение. Здесь появляется локальный инструмент, которому нужно корректное окружение и доступ к проекту. Ошибка в Node.js или правах уже не похожа на ситуацию, когда просто не открылся сайт.

Claude Code работает на Windows и macOS. Использовать его можно из терминала, а также в десктопном приложении.

Для Windows предусмотрен отдельный установщик.

В PowerShell команда выглядит так:

irm https://claude.ai/install.ps1 | iex

Для CMD используется отдельный install.cmd.

Второй путь:

npm install -g @anthropic-ai/claude-code

На первый взгляд результат одинаковый: после установки пользователь получает Claude Code и может запускать его из командной строки. Но цепочка установки различается.

При использовании отдельного установщика Claude Code ставится через предназначенный для системы сценарий.

При установке через npm в цепочке появляется Node.js и сам npm. Следовательно, появляется еще одна точка, в которой версии и окружение могут не совпасть.

Официальная документация Anthropic описывает нативную установку как основной вариант, а npm оставляет в числе доступных способов. При npm-установке загружается тот же нативный бинарный файл Claude Code для соответствующей платформы.

Поэтому выбирать npm только потому, что Claude Code якобы обязательно должен постоянно работать через Node.js, неверно. Node.js нужен именно в сценарии установки через npm.

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

npm install -g @anthropic-ai/claude-code

Если Node.js ставится только ради Claude Code, отдельный установщик убирает из процесса дополнительную зависимость.

Базовое требование для npm-установки Claude Code — Node.js версии 18 и выше. В используемой нами сборке начиная с версии 2.1.198 npm-пакет требует Node.js 22 и выше.

Отсюда довольно типичный сценарий.

Node.js на компьютере уже установлен. Разработчик помнит, что он есть, и сразу запускает:

npm install -g @anthropic-ai/claude-code

Установка не проходит ожидаемым образом.

Первая реакция — искать проблему в Claude Code. Но сначала имеет смысл проверить не наличие Node.js как такового, а его версию.

Особенно легко столкнуться с такой ситуацией на рабочем компьютере, где окружение настраивалось давно. Node.js установлен, npm работает, старые проекты запускаются, поэтому сама мысль о несовместимой версии возникает не сразу.

Если используется npm-путь, проверка должна идти до установки:

Есть ли Node.js.

Какая версия установлена.

Соответствует ли она требованиям конкретной версии Claude Code.

Только после этого запускать глобальную установку.

Если версия Node.js ниже требуемой, повторять ту же команду установки Claude Code несколько раз бессмысленно. Сначала нужно привести Node.js к подходящей версии, затем возвращаться к npm.

На Windows есть три сценария из исходных условий.

PowerShell

Открываем PowerShell и выполняем:

irm https://claude.ai/install.ps1 | iex

CMD

Для командной строки Windows предусмотрен отдельный установщик install.cmd.

npm

Если Node.js уже установлен и его версия соответствует требованиям:

npm install -g @anthropic-ai/claude-code

Здесь есть довольно банальная причина ошибок: команды PowerShell и CMD нельзя воспринимать как взаимозаменяемые.

Если команда irm не распознается, вероятная причина в том, что она запущена не в PowerShell. Если CMD-команда запускается в PowerShell, проблема будет уже обратной. В актуальной документации Anthropic эти случаи отдельно вынесены в раздел диагностики Windows.

Поэтому перед поиском сложной причины стоит посмотреть, где именно выполняется команда.

PowerShell и CMD выглядят для неопытного пользователя почти как два черных окна для ввода текста. Для установщика разница вполне конкретная.

После завершения установки не нужно сразу открывать большой репозиторий и проверять Claude Code на сложной задаче.

Сначала:

claude doctor

Эта команда позволяет проверить состояние установки.

Разбираю Claude Code и ИИ-агентов на практике: как применять их в реальных рабочих задачах, автоматизировать рутину, собирать собственных ИИ-ассистентов и зарабатывать с помощью новых технологий. Практические разборы, инструменты, кейсы и эксперименты: от первого ИИ-агента до полноценных рабочих систем. Подписывайтесь.

t.me

max.ru

MAX — быстрое и легкое приложение для общения и решения пов…

На macOS логика та же, хотя проблем с двумя разными командными оболочками Windows уже нет.

Если выбран вариант через npm:

npm install -g @anthropic-ai/claude-code

Перед этим проверяем Node.js. Для npm-пакета требуется Node.js 18+, а начиная с указанной выше сборки 2.1.198 нужно ориентироваться на Node.js 22+.

После установки:

claude doctor

Дальше Claude Code можно запускать из терминала и переходить к работе с проектом.

Смысл doctor здесь не в формальности. Проверка разделяет два этапа диагностики.

Если claude doctor показывает проблему, искать ее нужно в установке или окружении. Если проверка проходит, а сложности возникают уже во время работы с конкретным проектом, круг возможных причин становится другим.

Один из старых рефлексов при проблемах с глобальными npm-пакетами выглядит так:

npm install -g ...

получаем ошибку прав и запускаем:

sudo npm install -g ...

С Claude Code так делать нельзя.

Anthropic прямо предупреждает, что sudo npm install -g может привести к проблемам с правами и создает риски безопасности.

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

Поэтому ошибка permissions не является приглашением дописать sudo.

Если npm требует права, нужно разбираться с конфигурацией установки. Сам Claude Code не следует ставить глобально через sudo.

Рекомендуем прочитать

- Claude Code собирает интерфейс сам: навык /design — холст, артборды и вопрос о роли дизайнера.

- Сколько стоит Claude Code и как это оплачивается из России — тарифы, лимиты и способы оплаты.

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