Учебник по Claude Code, часть 5: Как установить Claude Code?

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

Установка Claude Code не имеет графического интерфейса с кнопкой «Далее», всё выполняется в командной строке. Если вы привыкли работать с npm, весь процесс займёт не больше двух минут.

Предварительные требования

Перед началом убедитесь, что у вас есть:

Node.js 18 или выше
Проверка: выполните в терминале node -v. Если версия ниже 18, обновите её с помощью nvm, fnm или скачайте с nodejs.org.
Учётная запись Anthropic
Зарегистрироваться можно по адресу https://console.anthropic.com. Аккаунт предоставит API-ключ, который понадобится после установки. Регистрация бесплатна, оплата идёт по факту использования.
Доступ к API Anthropic из сети
Домен по умолчанию: api.anthropic.com. Если требуется прокси, настройте переменные HTTP_PROXY или HTTPS_PROXY в терминале.

Способ 1: Глобальная установка через npm

Это самый распространённый способ: установив один раз, можно использовать везде.

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

После завершения выполните claude --version. Если вывелся номер версии, установка прошла успешно. Команда claude будет доступна в любой директории.

Если возникли ошибки прав доступа (часто на macOS в каталог /usr/local/lib), есть два решения:

Используйте sudo для установки (просто, но есть вопросы безопасности).
Настройте npm на использование домашнего каталога, чтобы избежать sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Затем добавьте ~/.npm-global/bin в PATH и перезапустите терминал.

Способ 2: Однократное использование через npx

Если не хотите ничего устанавливать глобально или просто пробуете, используйте npx.

npx @anthropic-ai/claude-code

npx временно загрузит последнюю версию пакета и не оставит глобальных команд. При каждом запуске проверяется обновление, поэтому вы всегда будете на последней версии. Минус: немного медленнее (требуется загрузка) и не подходит для автоматических скриптов.

Когда подходит: первое знакомство, использование на чужой машине, редкое использование.

Проверка запуска

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

claude --help

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

Оба способа устанавливают одну и ту же программу; последующая авторизация и использование полностью одинаковы. Выберите тот, который удобнее.

Часто задаваемые вопросы

Слишком низкая версия Node
Если Node ниже 18, возникнет ошибка, а не предупреждение. Обновите Node — это самое простое решение.
Тайм-аут сети
Проблемы с загрузкой пакетов через npm или подключением к API могут быть из-за прокси или файрвола. Сначала проверьте, доступен ли curl https://api.anthropic.com, затем продолжайте.
Использование родной cmd в Windows
Теоретически возможно, но рекомендуется использовать Git Bash, WSL2 или Windows Terminal, чтобы избежать странных проблем с преобразованием путей.