Установка Claude Code: требования, три способа и проверка результата

Claude Code — инструмент Anthropic для работы с кодом из терминала. Он читает файлы проекта, вносит правки, запускает команды и разбирает ошибки, а общение с ним идёт обычным текстом. Отличие от браузерного чата в том, что контекст не нужно переносить руками: инструмент видит проект целиком.

Установка занимает несколько минут, но ровно на ней спотыкается большинство: не та версия Node.js, установка от администратора, разные способы для Windows и macOS. Разбираем требования и порядок действий.

Что нужно до установки

Node.js. Claude Code требует версию 18 и выше, а начиная со сборки 2.1.198 npm-пакет требует Node.js 22 и выше. Проверить установленную версию можно командой node --version.

Подписка. Доступ даёт Claude Pro — 20 долларов в месяц при помесячной оплате или 17 долларов в месяц при годовой. Тариф Max от 100 долларов в месяц даёт в 5 или 20 раз больше лимитов.

Операционная система. Работает на Windows и macOS, из терминала и из десктопного приложения.

Способ первый: скрипт с сайта

Самый короткий путь для Windows. Открываете PowerShell и выполняете:

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

Скрипт скачивает и ставит всё необходимое, включая настройку путей. Отдельно настраивать переменные среды не нужно.

Способ второй: установщик для командной строки

Если привычнее CMD, скачивается отдельный установщик install.cmd и запускается оттуда же. Результат тот же, отличается только оболочка.

Способ третий: пакет npm

Универсальный вариант, работает и на Windows, и на macOS:

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

Ставить эту команду через sudo нельзя. В документации отмечено, что установка от суперпользователя ведёт к проблемам с правами и повышает риски безопасности: файлы попадают туда, куда обычный пользователь не имеет доступа, и каждое обновление начинает требовать тех же прав.

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

После установки выполните claude doctor. Команда проверяет окружение и показывает, что именно не в порядке: версия Node.js, доступность каталога установки, права.

Если проверка проходит, запускается claude — и дальше работа идёт разговором.

Что делать, если не ставится

Порядок диагностики от простого к сложному:

• проверить версию Node.js командой node --version, при необходимости обновить;

• перезапустить терминал, чтобы подхватились новые пути;

• убедиться, что установка шла не от администратора;

• запустить claude doctor и читать конкретную ошибку, а не гадать.

Такой порядок закрывает большинство случаев, не доводя до переустановки системы пакетов.