Половина знакомых разработчиков за последний год переключилась на Claude Code. Смысл простой: агент живет прямо в терминале и работает с вашим проектом напрямую. Читает файлы, правит код, запускает тесты, делает коммиты. Никакого копирования кусков кода между окном чата и редактором - пишете задачу обычным текстом, агент сам разбирается в проекте.
Звучит здорово, но между вами и этой магией стоит установка. И вот тут в интернете лежит минное поле: гайды годовалой давности советуют команды, которые Anthropic уже официально похоронила. Разбираю актуальный способ установки для Windows, macOS и Linux, плюс вариант вообще без терминала для тех, кто с консолью не дружит.
Что вы получите после установки: три сценария из практики
Разбор легаси-кода. Кидаете агенту в незнакомый проект на сто тысяч строк задачу "объясни, как устроен модуль биллинга". Через пару минут получаете разбор по файлам со ссылками на конкретные функции. Раньше на такое уходил день с чтением кода и блокнотом рядом.
Рефакторинг с тестами. Просите вынести логику из контроллеров в сервисный слой. Агент сам находит затронутые места, правит импорты, запускает тесты и отчитывается, что сломалось, а что зеленое. Правки, на которые раньше уходил вечер, съедаются за полчаса.
Рутина по гиту. Осмысленные коммиты по всему диффу, ревью чужого пулл-реквеста с вопросами к автору, поиск по истории "где мы меняли эту логику". Скучные задачи, на которые жалко мозгов, агент отрабатывает без нареканий.
Сначала удалите из головы команду из старых статей
npm install -g @anthropic-ai/claude-code - если встретили эту команду в статье или на форуме, знайте: Anthropic официально объявила этот способ установки устаревшим. Кое-где она еще отрабатывает, но поддержки больше нет. В обсуждениях на Reddit разработчики подтверждают: на свежих системах установка через npm все чаще падает с ошибками или ставит кривую версию.
Актуальная схема выглядит иначе: встроенный установщик от Anthropic либо системные менеджеры пакетов. Homebrew на macOS, WinGet на Windows, apt, dnf или apk на Linux. Дальше - только про рабочие способы.
Вариант для тех, кто боится терминала: Desktop-приложение
Claude Code существует не только в консоли. Есть полноценное Desktop-приложение для macOS, Windows и Linux - скачиваете с официального сайта, устанавливаете как обычную программу, логинитесь. Никаких команд, никакого черного окна с белым текстом. Интерфейс с кнопками, историей диалогов и настройками.
Для первого знакомства с агентом идеальный вход. Ограничения всплывут позже: классический терминальный режим дает больше гибкости в рабочих процессах, плюс Claude Code встраивается в VS Code и JetBrains IDE, работает в веб-версии, в Slack и даже в CI/CD через GitHub Actions и GitLab. Но для старта Desktop хватает с головой.
Установка на Windows: два пути и одна ловушка
Начну с Windows, потому что именно здесь возникает большинство вопросов. Выбор между нативной установкой и вариантом через WSL (Linux-подсистема внутри Windows) делается просто: где лежат ваши проекты и где комфортнее работать, туда и ставим. У чистой Windows-установки есть свои ограничения, о них ниже.
Первым делом нужен Git Bash. Claude Code запускает команды через него, и без него установщик откажется работать. Обычно git на машине разработчика уже стоит, но если нет, ставим одной строкой:
winget install Git.Git
В худшем случае, когда в системе отсутствует даже winget, качаем Git с официального сайта git-scm.com вручную. При установке оставляйте все галочки по умолчанию: Git Bash, интеграция с Explorer, добавление в PATH. Менять их без нужды не стоит.
Дальше PowerShell, и вот ловушка, на которой спотыкаются почти все. Нужна версия 7 или выше, и запускать надо команду pwsh, а не powershell. Старый PowerShell 5.1, который открывается из меню Пуск по умолчанию, для установки не годится. Совет от себя: поставьте Windows Terminal. Не обязателен, но в нем в соседних табах живут и PowerShell, и Linux-оболочка, а это экономит массу нервов.
В открытом PowerShell 7+ установка Claude Code сводится к одной команде:
irm https://claude.ai/install.ps1 | iex
Скрипт сам скачает бинарник и пропишет его в системе. Существует и вариант через WinGet, но скрипт проще и работает везде. После завершения открываете терминал в папке проекта и запускаете команду claude - агент перед вами.
Установка на macOS
На Mac рекомендуемый путь - встроенный установщик. Открываете терминал и выполняете:
curl -fsSL https://claude.ai/install.sh | bash
Затем прописываем путь к бинарнику в PATH, чтобы система находила команду claude:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
Нюанс для владельцев свежих маков: терминал там по умолчанию работает с zsh, поэтому путь стоит дописать в .zshrc вместо .bashrc. Если после установки команда claude не находится - это оно самое.
Альтернатива для тех, кто уже живет в Homebrew: brew install --cask claude-code. Разницы в итоге никакой, выбирайте, что ближе вашим привычкам по обновлению пакетов.
Установка на Linux
Linux радует разнообразием, и Claude Code подстраивается. Универсальный путь - тот же curl-скрипт, что и на macOS, он отрабатывает на любом дистрибутиве. Если хотите держать пакет в системном менеджере, Anthropic дает нативные варианты: apt для Debian и Ubuntu, dnf для Fedora и RHEL, apk для Alpine.
Отдельная история - WSL. Для Linux-подсистемы внутри Windows работает тот же Linux-сценарий: curl-скрипт в терминале подсистемы, и готово. Один практический момент из опыта: держите проекты внутри файловой системы WSL, а не на диске Windows через /mnt. Иначе доступ к файлам замедляется в разы, и агент вместо работы будет ждать диск - в тредах Reddit об этой ловушке предупреждают регулярно.
Первый запуск: что происходит после команды claude
Установка сама по себе ничего не дает, проверяем работоспособность. Откройте терминал в папке проекта, над которым хотите работать, и введите claude. Откроется интерактивный сеанс: при первом запуске агент предложит залогиниться в аккаунт, дальше просто пишете задачу обычным текстом.
Из приятного: Claude Code не творит произвол. Перед выполнением потенциально опасных действий - удаление файлов, установка зависимостей, пуш в репозиторий - он спрашивает разрешение. Внутри сеанса можно переключать модели: мощную Opus для планирования архитектуры, более быстрые для рутины. За пару дней вы настроите баланс между контролем и автономностью, и работа пойдет в удовольствие.
Одна привычка, которая сразу поднимет качество: заведите в корне проекта файл CLAUDE.md и опишите там стек, стандарты кода и особенности архитектуры. Агент читает этот файл при старте и держит контекст проекта в голове. Меньше лишних вопросов, точнее правки.
Засада, о которой молчат все инструкции: доступ из России
Установка бесплатна, а вот использование - нет. Для полноценной работы нужен доступ к моделям Claude: подписка Anthropic или API-ключ. Официальные цены - от 20 долларов в месяц за Pro и от 100 за Max, либо оплата API по факту. У кого есть иностранная карта, вопрос закрыт тривиально. Остальных ждет главное препятствие всей этой затеи: российские карты платформа не принимает, сайт без VPN открывается через раз, а оформление подписки через посредников добавляет к цене 30-50% и нервной переписки.
Обходной путь я нашел для себя давно и лучше с тех пор не встречал. Сервис 3GPT - это ИИ-роутер, дающий прямой доступ из России ко всем флагманским моделям: Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, ChatGPT 6 Astra, ChatGPT 6.1 Sol, ChatGPT 5.5, Nano Banana для изображений, плюс генерация видео и голоса. Все это за 149 рублей, оплата российской картой, через СБП или криптой. Никаких иностранных карт и VPN-акробатики.
Официальный сайт находится здесь: https://3seller.com/3gpt. Регистрация занимает пару минут, после чего вы работаете с топовыми моделями мира в одном окне.
Что это дает на практике. Продающие тексты и целые сайты - для бизнеса. Создание и обработка максимально реалистичных изображений - для маркетплейсов и рекламы. Видеоролики и генерация голоса - для контента. По сути весь набор задач, ради которых люди мучаются с иностранными подписками, закрывается за 149 рублей в месяц.
Отдельная фишка, которую я тащу в свой ежедневный процесс: готовые ИИ-агенты под конкретные задачи. Заходите на страницу агентов 3GPT, выбираете нужного под свою задачу и сразу начинаете общение. Модель агента меняется прямо в чате: сегодня задача считается на GPT, завтра переключаетесь на Claude, если он лучше подходит под стиль. Гибкость, которой нет ни в одном отдельном приложении.
Типовые проблемы при установке и их лечение
По письмам читателей и собственному опыту собрал пятерку ошибок, с которыми сталкиваются чаще всего.
- Команда claude не находится после установки на macOS или Linux. Бинарник установлен, но путь не попал в PATH. Допишите export PATH="$HOME/.local/bin:$PATH" в конфиг своей оболочки и перезапустите терминал.
- Установщик на Windows отказывается стартовать. В девяти случаях из десяти в системе нет Git Bash. Проверьте наличие git, поставьте через winget install Git.Git и повторите.
- Команда irm | iex выдает странные ошибки. Вы запустили старый PowerShell 5.1 вместо pwsh. Установите PowerShell 7 и выполняйте установку оттуда.
- После npm-установки все глючит. Способ устарел, сносите его и ставьте нативным установщиком по инструкции выше.
- Не проходит вход в аккаунт на первом запуске. Проверьте сеть и блокировщики, а при повторных сбоях загляните в официальный раздел документации по устранению неполадок при установке и входе - там разобраны все типовые сценарии.
Какой способ выбрать под вашу ситуацию
Соберу навигацию одной фразой. Терминал пугает - берите Desktop-приложение, три минуты и вы работаете. macOS - curl-скрипт или Homebrew, одна команда. Linux - тот же скрипт либо apt, dnf, apk под свой дистрибутив. Windows - Git Bash, PowerShell 7, irm | iex, вся последовательность выше занимает минут десять с учетом скачиваний. Разработчику со стажем отдельная установка может вообще не понадобиться: расширения для VS Code и JetBrains ставятся прямо из IDE.
И второй слой решения: инструмент ставится бесплатно, но модели, к которым он обращается, стоят денег. Если полный доступ к Claude из России вам пока недоступен, начинайте с 3GPT - там Claude Fable 5, Opus 5.5 и весь парк топовых моделей за 149 рублей с оплатой картой РФ или СБП, плюс готовые агенты под бизнес-задачи. Для большинства практических сценариев это самый короткий путь от "хочу нейросети" до "работаю с ними каждый день".
Практический план на сегодня. Определите свою систему, пройдите соответствующий блок установки, запустите claude в тестовом проекте и дайте агенту первую простую задачу - например, попросите объяснить структуру проекта. Увидите, как он ходит по файлам, и сразу поймете, зачем все это было нужно. А параллельно откройте 3GPT и убедитесь, что доступ к топовым моделям из России - вопрос 149 рублей и двух минут регистрации.