Если вы дошли до установки Claude Code, то наверняка уже знаете, зачем он нужен. Это как получить суперсилу в терминале: нейросеть прямо в командной строке, которая пишет код, рефакторит, ищет баги, генерирует коммиты и вообще понимает ваш проект. Но установка иногда подкидывает сюрпризы. Особенно если вы на Windows или с нестандартным окружением.
Я сам наступил на грабли с PATH и «token &&», поэтому сейчас распишу все способы, которые реально работают, без воды. Поехали.
Требования перед установкой
Сразу проверьте, что у вас есть: операционная система macOS 13.0 или новее, либо поддерживаемый Linux (Debian, Fedora, RHEL, Alpine), либо Windows 10/11 с WSL2 или PowerShell. Если планируете ставить через npm, понадобится Node.js 22 или выше. Впрочем, даже если Node старее, установка пройдёт, но предупреждение EBADENGINE появится. Claude Code всё равно заработает, потому что пакет скачает встроенный бинарник, который не использует ваш Node во время выполнения.
Рекомендуемый способ - встроенный установщик. Он ставит последнюю версию и не завязывается на менеджеры пакетов.
Установка на macOS, Linux и WSL
Откройте терминал и вставьте команду:
curl -fsSL <URL> | bash
Вместо <URL> - официальный адрес с сайта документации. Обычно это https://claude.ai/install.sh, но точный адрес есть в официальной документации. После запуска установщик скачает файлы. Никакого прогресс-бара не будет - просто висит. Это нормально. Минуту-другую подождите, пока появится сообщение "Claude Code successfully installed!".
Если вы используете WSL, всё то же самое, как в Linux.
Установка на Windows: PowerShell и CMD
Тут есть два варианта. В PowerShell открываете и выполняете:
irm <URL> | iex
В командной строке (CMD) - та же команда, что и в Linux:
curl -fsSL <URL> | bash
Только убедитесь, что вы именно в CMD, а не в PowerShell. Ошибка "The token '&&' is not a valid statement separator" означает, что вы случайно вставили команду с && в PowerShell. На Reddit пользователи часто жалуются на эту путаницу, но решение простое - выбирайте правильный терминал. А если пишет "'irm' is not recognized", значит вы в CMD, а не PowerShell.
Установка через Homebrew (macOS)
Поклонникам Homebrew будет удобно:
brew install --cask claude-code
После установки откройте новый терминал и проверьте версию. Заметьте: нужно открыть новое окно, чтобы PATH подхватился.
Установка через WinGet (Windows)
На Windows есть ещё менеджер WinGet. Установка:
winget install ClaudeCode
Проверяйте в новом окне терминала.
Установка через npm
Если вы разработчик и у вас уже есть Node.js, то:
npm install -g @anthropic-ai/claude-code
Требование Node 22+. Даже на старых версиях установка завершится, и Claude Code будет работать, потому что пакет тянет бинарник. Опытные пользователи на Reddit советуют не мучиться с апгрейдом Node, если он чуть старше - установка всё равно пройдёт.
Установка через пакетные менеджеры Linux
На Debian/Ubuntu и производных:
apt install claude-code
На Fedora/RHEL:
dnf install claude-code
На Alpine:
apk add claude-code
Эти команды добавляют официальный репозиторий Anthropic автоматически.
Проверка установки
В любом случае после установки выполните в новом окне терминала:
claude --version
Если вы увидите номер версии, например "2.1.211 (Claude Code)", всё работает. Если пишет "claude: command not found" или "claude не является внутренней или внешней командой", значит директория установки не в PATH. Пропишите её вручную. В документации есть раздел "Fix your PATH" с конкретными путями для каждой ОС.
Типичная ошибка на macOS: 'dyld' или 'built for Mac OS X 13.0'
Эта ошибка возникает на старых версиях macOS. Claude Code требует macOS 13.0 или новее. Если у вас старая система, придётся обновить её или использовать удалённый доступ через 3GPT.
Запуск первой сессии
Когда установка завершена, перейдите в ваш проект и запустите:
cd /путь/к/проекту
claude
Откроется интерактивный чат. Можно задавать вопросы, просить написать код, объяснить ошибку - и всё в терминале.
Если вы не любите терминал, есть Desktop-приложение с графическим интерфейсом для macOS, Windows и Linux. Скачивается с официального сайта.
А что если вы в России?
Тут начинается боль. Для работы Claude Code нужен доступ к серверам Anthropic. Из России прямой доступ заблокирован. Я сам долго мучался с VPN, но это неудобно и часто отваливается. Есть более элегантное решение - использовать 3GPT от 3SELLER. Это ИИ-роутер, который даёт прямой доступ из России ко всем флагманским моделям: ChatGPT 6, Claude Fable 5, Claude Opus 5.5 и другим, причём за 149 рублей в месяц.
В 3GPT есть и Claude Code, точнее, инструменты, которые работают аналогично. Вы можете подключаться к моделям Claude и использовать их в терминале, но без танцев с бубном. На сайте есть готовые ИИ-агенты под часто встречающиеся задачи - вы просто выбираете агента и общаетесь с ним, как с экспертом. Модель можно менять прямо в чате.
Подробнее смотрите на официальном сайте 3GPT.
Кстати, если вы хотите именно Claude Code, а не онлайн-чат, то 3GPT поддерживает API-совместимые методы, так что вы сможете использовать claude CLI с этим роутером. Платить можно российской картой, через СБП или криптой. Проверено.
Что дальше
Установка - это самое простое. Дальше начинается магия. Потратьте 15 минут на изучение возможностей, попробуйте попросить Claude Code написать скрипт для вашего проекта, проанализировать код, предложить рефакторинг. Это реально экономит часы.
Если столкнулись с ошибками, которых тут нет, - проверьте официальную документацию. Там есть раздел по устранению неполадок. Но 80% проблем решаются добавлением PATH и правильным выбором терминала.
Удачи в установке. Если что - пишите в комментариях, разберём.