Как установить Claude Code: пошаговая установка

Claude Code ставится одной командой, но перед ней нужно подготовить окружение. Ниже — порядок для macOS, Windows и Linux, проверка, что всё заработало, и разбор ошибок, которые встречаются чаще всего.

Если вы в России, сначала прочитайте про доступ и оплату: установка пройдёт, а вот вход в аккаунт без решённого вопроса с доступом — нет.

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

Три вещи, без которых дальше будет больно:

• Терминал. На Mac — встроенный Terminal или iTerm. На Windows — Windows Terminal. На Linux — любой.
• Node.js версии 18 или новее, если ставите через npm. Проверить: node -v.
• Git. Нужен не для установки, а для работы: без него нельзя откатить неудачную правку. Проверить: git --version.

Установка на macOS

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

# 1. Node.js через Homebrew (если ещё не стоит)
brew install node

# 2. Сам Claude Code
npm install -g @anthropic-ai/claude-code

# 3. Проверка
claude --version

Если всё встало правильно, последняя команда ответит номером версии — примерно так:

2.1.220 (Claude Code)

Если Homebrew не установлен, поставьте его с сайта brew.sh — на Mac он всё равно понадобится.

Установка на Windows

Есть два пути, и они дают разный опыт.

Нативный. Ставите Node.js с сайта nodejs.org (версия LTS), открываете Windows Terminal и выполняете ту же команду:

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

Через WSL. Ставите подсистему Linux, дальше работаете как в Linux:

wsl --install

После перезагрузки внутри Ubuntu ставите Node и Claude Code обычными командами Linux.

Установка на Linux

# Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Claude Code
npm install -g @anthropic-ai/claude-code
claude --version

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

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

Перейдите в папку проекта (или создайте пустую) и запустите:

mkdir ~/proba && cd ~/proba
claude

При первом запуске инструмент попросит войти в аккаунт — через подписку или API-ключ. Дальше можно писать задачи обычным текстом.

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

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

Проверь, что окружение готово к работе, и покажи результат таблицей.

Выполни и покажи фактический вывод:
1. Версии: node, npm, git, python3 — и сама версия claude.
2. Где лежат глобальные пакеты npm и входит ли эта папка в PATH.
3. Инициализирован ли git в текущей папке, и если нет — предложи команду.
4. Создай файл proba.txt со словом «работает», покажи содержимое папки,
   потом удали файл.

Ответь таблицей «что проверял → что реально вернулось → норма или проблема».
Если команда не нашлась, напиши это прямо и дай команду установки под мою
систему. Ничего не выдумывай: показывай только реальный вывод.

Частые ошибки установки

command not found: claude. Система не видит исполняемый файл. Перезапустите терминал. Если не помогло, посмотрите путь глобальных пакетов (npm config get prefix) и добавьте его подпапку bin в PATH.

EACCES: permission denied. Нет прав на папку глобальных пакетов npm. Не лечите это через sudo npm install — переназначьте префикс npm на папку в домашнем каталоге.

Установка идёт, а вход не проходит. Это уже не установка, а доступ к сервису. Разбор — в статье про Claude Code в России.

Всё поставилось, но агент не видит файлы. Вы запустили его не в той папке. Claude Code работает с той директорией, из которой запущен.

Что настроить сразу после установки

Три настройки, которые окупаются в первый же день:

1. Файл правил проекта. Опишите стек, структуру папок и то, что нельзя менять. Агент будет читать его в начале каждой сессии.
2. Файл с секретами вне репозитория. Ключи и пароли не должны попадать в git ни при каких условиях.
3. Скиллы под ваши повторяющиеся задачи. Как это устроено — в статье про скиллы и правила Claude Code.

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