Установка Claude Code CLI — пошаговая инструкция

Простым языком

Claude Code — это программа, которую ты устанавливаешь на компьютер. После установки пишешь ей задачи прямо в терминале — и она делает. Терминал — это такое чёрное окошко с командами, не пугайся.

Установка занимает 10 минут. Нужен компьютер (Mac или Linux), интернет и аккаунт на сайте Anthropic. Всё это бесплатно на старте. Поехали.

Что понадобится

macOS, Linux или WSL2 — Windows только через WSL, нативно не поддерживается
Node.js 20 LTS — более старые версии могут не работать
Аккаунт Anthropic — console.anthropic.com, нужна кредитная карта для API
Терминал — iTerm2, Terminal.app, Windows Terminal — любой

Шаг 1: Установка Node.js

Рекомендуется установить через nvm — это позволяет иметь несколько версий:

# Установка nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# Перезапусти терминал, затем:
nvm install 20
nvm use 20
nvm alias default 20

# Проверка
node --version   # должно быть v20.x.x
npm --version    # должно быть 10.x.x

Если nvm не подходит — скачай Node.js 20 LTS напрямую с nodejs.org. Главное — версия 18 или выше.

Шаг 2: Установка Claude Code

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

# Проверка установки
claude --version

Если команда claude не найдена после установки — проверь PATH для глобальных npm-пакетов:

# Найти директорию глобальных пакетов npm
npm root -g

# Добавить в PATH (вставь в ~/.zshrc или ~/.bashrc)
export PATH="$(npm root -g)/../bin:$PATH"

# Применить без перезапуска терминала
source ~/.zshrc

Шаг 3: Авторизация

Создай директорию проекта и запусти Claude Code:

mkdir my-first-project
cd my-first-project
claude

При первом запуске Claude Code предложит авторизоваться. Нажми Enter — откроется браузер с Anthropic Console. Войди или зарегистрируйся, подтверди доступ.

Если авторизация слетела или нужно переключить аккаунт:

claude auth login

Шаг 4: Создание CLAUDE.md

CLAUDE.md — главный конфиг проекта. Claude читает его при каждом запуске. Это твой «брифинг» для AI: что за проект, какой стек, какие правила.

Создай в корне проекта (/CLAUDE.md):

# Мой первый проект

Бот для учёта личных расходов. Telegram + PostgreSQL.

## Стек
- Python 3.12 + aiogram v3
- PostgreSQL 16
- Docker Compose
- Деплой на VPS (Ubuntu 22.04)

## Ключевые правила
- Код, комментарии, переменные — на русском
- Conventional commits: feat/fix/refactor/docs
- Тесты обязательны для бизнес-логики
- НИКОГДА не коммитить .env
- SQL только через параметризованные запросы

## Структура
src/
├── handlers/   # aiogram хендлеры
├── services/   # бизнес-логика
├── database/   # модели и миграции
└── utils/      # утилиты

Чем подробнее CLAUDE.md — тем меньше объяснений в промптах. Заполни один раз, пользуйся всегда.

Шаг 5: Глобальные настройки

Для правил, общих для всех проектов, создай ~/.claude/CLAUDE.md. Claude читает его в дополнение к проектному файлу:

mkdir -p ~/.claude

cat > ~/.claude/CLAUDE.md << 'EOF'
# Глобальные правила

Разработчик: Иван, GMT+7, macOS.

## Язык
- Код, комментарии, переменные — русский
- Общение — русский, технический жаргон допустим

## Безопасность
- НИКОГДА не коммитить .env, токены, пароли
- SQL только через параметризацию
- Rate limiting на публичных endpoints

## Git
- Conventional commits: feat/fix/refactor/docs/test
- Коммитить только по явной команде
EOF

Проверка и типичные проблемы

# Проверь версии
node --version    # v20.x.x
claude --version  # 1.x.x

# Первый запрос
cd my-first-project
claude "Привет! Какие файлы ты видишь в этом проекте?"

`command not found: claude` — глобальные пакеты npm не в PATH. Попробуй npx claude или добавь путь в .zshrc
`Authentication failed` — перелогинься: claude auth login
CLAUDE.md не читается — файл должен быть в директории, откуда запускается claude
Медленная работа — переключись на Sonnet для рутинных задач: в 5 раз быстрее Opus
Ошибка прав при `npm install -g` — используй nvm, тогда sudo не нужен