раздел 02 · подстраница 1

Первый запуск и /login

В этой главе - всё от чистой системы до первой работающей команды. Займёт минут пять, если интернет не подведёт.

Зачем это

Установка Claude Code - это один npm-пакет и один логин в браузере. Никаких лицензий, регистрационных ключей или Docker-образов. Главное - не накосячить с правами на глобальный npm.

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

  • macOS, Linux или Windows (через WSL2).
  • Node.js 20 или новее. Проверка: node --version.
  • Аккаунт Anthropic (можно создать прямо при первом логине).

Если Node не установлен - возьмите официальный установщик с nodejs.org или через nvm:

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

Установка

Глобальная установка npm-пакетом - официально рекомендуемый способ:

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

Если выдало ошибку EACCES - не запускайте через sudo. Это сломает права в ~/.npm. Лучше переключить префикс npm на домашнюю папку:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

Проверим, что всё встало:

claude --version
# claude-code 2.x.x

Первый запуск

Заходим в любую папку с проектом (или создаём пустую) и запускаем:

mkdir ~/claude-hello && cd ~/claude-hello
claude

При первом запуске Claude Code откроет в браузере страницу авторизации. Войдите через Google или email, привязанный к вашей подписке Pro/Max - и Claude Code получит OAuth-токен. Если используете API-ключ напрямую - выберите вариант "Use API key" и вставьте ключ из console.anthropic.com.

скриншот
Первый экран Claude Code после успешного логина: приветствие, текущая папка, статус модели
Где взять: docs.claude.com

После логина вы окажетесь в TUI-интерфейсе - текстовый prompt, в который можно писать прямо по-русски. Попробуйте:

> привет, какая сегодня дата и в какой папке мы находимся?

Claude ответит, при необходимости вызвав инструмент Bash для date и pwd. На каждый bash-вызов вас попросят подтвердить выполнение - это нормальное поведение в default-режиме (см. главу про режимы разрешений).

Первая полезная команда

Перед серьёзной работой запустите /init - Claude осмотрит репозиторий и создаст для себя CLAUDE.md с заметками о проекте:

> /init

Через минуту в корне появится файл CLAUDE.md - туда же можно дописывать свои правила. Этот файл Claude будет читать каждый раз, когда вы запускаете его в этой папке.

Если что-то не работает

claude: command not found

PATH не подхватил npm-префикс. Перезапустите терминал или выполните source ~/.zshrc / source ~/.bashrc.

Браузер не открылся при логине

В терминале появится URL - скопируйте его руками. Если вы на удалённом сервере - выполните claude на ноуте, скопируйте появившийся code=... и вставьте обратно в сессию на сервере. Или используйте API-ключ через переменную ANTHROPIC_API_KEY.

Permission denied при npm install

Не запускайте через sudo. Используйте npm config set prefix (см. выше) или volta / fnm.

Claude висит на "thinking"

Скорее всего сетевая проблема (особенно из России) - см. главу про прокси. Можно прервать через Esc.

Антипаттерны

  • Устанавливать через sudo npm install -g - сломаете права и потом будете чинить.
  • Игнорировать запрос подтверждения bash-команд "на автомате" - так пропустите опасную команду. Читайте, что Claude хочет выполнить.
  • Запускать claude в домашней папке ~. Он будет видеть весь home и индексировать кучу мусора. Создавайте под каждый проект отдельную папку.

Полезные ссылки