Claude Code - агент для программирования от Anthropic, который живет прямо в терминале. Никаких окон, вкладок и кнопок: вы описываете задачу текстом, а он читает файлы проекта, вносит правки, запускает команды и сам разбирается с ошибками. Я перевел на него рефакторинг, написание тестов и разбор чужого легаси - рутину он съедает быстрее любого плагина, который я пробовал.
Ниже - установка Claude в терминал на macOS, Linux и Windows в 2027 году: актуальная команда установки, лечение ошибки command not found и обход проблемы оплаты из России. Все шаги проверены на живых машинах, без воды.
Claude Code: агент, а не очередной чат-бот
Главное отличие от браузерной версии Claude - доступ к вашей файловой системе. Агент видит проект целиком: может открыть десятки файлов, найти связь между модулем оплаты и упавшим тестом, поправить код сразу в нескольких местах и запустить сборку, чтобы убедиться, что ничего не сломалось. В веб-чате вы копируете файлы руками. В терминале - просто ставите задачу.
Сама установка бесплатна. Платить придется за работу: либо подписка Anthropic, либо оплата через API-ключ по токенам. К этому вернемся, потому что именно этап оплаты - главная заноза для пользователей из России.
Что проверить до установки
Пять минут на подготовку экономят час дебага потом. Вот минимальный набор:
- macOS версии 13 или новее, свежий Linux-дистрибутив либо Windows 10/11 с PowerShell 5.1 и выше
- Git для Windows-версии: нативному установщику нужен Git Bash, он входит в комплект Git for Windows
- Рабочий аккаунт Anthropic или API-ключ для авторизации после установки
- Стабильный доступ к серверам Anthropic - из России напрямую не достучаться, ниже расскажу обходной путь
Установка на macOS и Linux: одна команда curl
Anthropic рекомендует нативный установщик, и я с этим полностью согласен - возиться с Node.js не придется, скрипт сам поставит все нужные компоненты. Актуальную команду всегда берите с официальной страницы code.claude.com/docs/setup, она обновляется вместе с релизами. Базовый вариант выглядит так:
curl -fsSL https://claude.ai/install.sh | bashСкрипт скачивает бинарник, настраивает файлы, включает фоновые обновления и прописывает путь в PATH. Нюанс, который сбивает с толку новичков: во время загрузки прогресс не отображается. Окно молчит, курсор мигает. Не закрывайте его и не жмите Ctrl+C - просто подождите. В конце появится строка Claude Code successfully installed!
Альтернатива для Mac: Homebrew
Если вся система у вас живет на brew, логично поставить и Claude Code туда же:
brew install --cask claude-codeОба способа рабочие, разница только в механике обновлений. Нативный установщик обновляет приложение сам в фоне, brew - вместе с остальными пакетами по вашему расписанию. Я сижу на нативном варианте: меньше шансов забыть про апдейт.
Установка на Windows: PowerShell, а не командная строка
На Windows открываем PowerShell версии 5.1 или выше. Права администратора не нужны. Команда установки:
irm https://claude.ai/install.ps1 | iexСкрипт скачает Claude Code и пропишет путь в PATH автоматически. Дальше ключевой момент, на котором спотыкается половина людей: закройте окно терминала и откройте новое. PATH подхватывается только свежим процессом. Если продолжить работу в старом окне, получите command not found и потратите полчаса на поиски несуществующей поломки. Проверено на коллегах - спотыкаются регулярно.
Про WSL отдельная ремарка. Если работаете в Linux-окружении на Windows, ставьте Claude Code внутри WSL по инструкции для Mac и Linux выше. Окружение предсказуемее, привычные unix-команды работают как положено, а не через костыли.
Проверка: claude --version
Откройте новое окно терминала и введите:
claude --versionУвидели что-то вроде 2.1.211 (Claude Code) - значит, все встало как надо. Номер версии будет другим, релизы выходят часто. Если команда не найдена, переходите к разделу про ошибки ниже.
Первый запуск и авторизация через браузер
Введите claude и нажмите Enter. При первом запуске терминал выдаст ссылку на авторизацию: жмете Enter, открывается браузер, логинитесь в аккаунт Claude и подтверждаете доступ терминала. После этого возвращаетесь в консоль - и можно работать. Если у вас есть API-ключ вместо подписки, авторизацию можно пройти через переменную окружения ANTHROPIC_API_KEY без учетной записи.
Дальше переходите в папку своего проекта и снова запускаете claude. Агент подхватит контекст каталога и будет готов принимать задачи. Полезные команды внутри сессии: /help покажет список возможностей, /clear сбросит контекст, /exit завершит работу. Команда claude doctor проверит состояние установки, если что-то пошло не так.
Что происходит в первые пять минут внутри
После авторизации агент предложит выбрать тему оформления и уточнит пару настроек. Дальше открывается рабочий экран с приглашением ввода. Пишете задачу обычным языком, агент показывает план действий, спрашивает подтверждение на правки и подсвечивает измененные файлы в diff. Отмена на любом шаге - через предложенные опции или Ctrl+C. Первое время это выглядит непривычно: терминал, который разговаривает с вами и одновременно правит код.
/init и claude.md: два шага, которые экономят часы
Первое, что я делаю в новом проекте, - ввожу /init. Claude Code пройдется по репозиторию и соберет файл claude.md: описание структуры, стека и конвенций. Дальше агент опирается на этот файл в каждой сессии. По сути, это брифинг для нового сотрудника: две минуты сейчас против часов переделок потом.
Файл claude.md стоит дописать руками. Вписывайте команды сборки и тестов, список файлов, которые трогать нельзя, принятый в команде стиль кода. Обычный markdown, правится в любой момент. Чем конкретнее бриф, тем меньше агент фантазирует.
Контекст: почему длинные сессии устают
У любой модели есть ограничение на объем внимания. В Claude Code это ощущается так: длинная сессия на сотню правок начинает терять детали, агент забывает договоренности из начала диалога. Лечится просто - /compact сжимает историю диалога, /clear сбрасывает совсем. Я привык чистить контекст после каждой завершенной подзадачи. Дешевле начать заново с хорошим claude.md, чем тащить за собой килограмм устаревшего диалога.
Обновления идут сами
Нативный установщик настраивает фоновые обновления, отдельно качать новые версии не нужно. Хотите проверить вручную - наберите claude update. Текущую версию показывает claude --version. На этом администрирование заканчивается, дальше вы просто работаете.
Ошибки, на которых спотыкаются чаще всего
command not found: claude (Mac и Linux). Каталог установки не попал в PATH. В девяти случаях из десяти помогает перезапуск терминала. В обсуждениях на Reddit разработчики сходятся в том же: прежде чем копаться в конфигах, просто перезапустите окно консоли. Не помогло - проверьте, что папка ~/.local/bin существует и прописана в PATH в вашем .zshrc или .bashrc.
claude is not recognized (Windows). Та же история с PATH. Закройте PowerShell и откройте заново. Дальше проверяйте, что путь C:\Users\ВашеИмя\.local\bin добавлен в переменные среды.
Ошибки dyld и built for Mac OS X 13.0. Версия macOS слишком старая для нативного бинарника. Либо обновляйте систему, либо ставьте через Homebrew - там сборки с более широкой совместимостью.
Установщик молчит несколько минут. Так и задумано: прогресс скачивания не показывается. Окно не трогаем, ждем строку об успешной установке.
Старый способ через npm официально мертв
Инструкции с командой npm install -g @anthropic-ai/claude-code до сих пор гуглятся на первых страницах. Знайте: Anthropic отказалась от этого пути и больше его не рекомендует. Ставка через npm может поставить кривую сборку или вообще упасть на свежих версиях Node.js. Нативный установщик - единственный официальный путь, все остальное - компромисс и потенциальные глюки.
Безопасность: агенту можно не все
Claude Code по умолчанию спрашивает подтверждение перед правкой файлов и запуском команд. Не отключайте эти подтверждения, пока не понимаете, что делаете. Агент ошибается, как и любой человек, только быстрее и масштабнее.
Практические правила из опыта. Секреты и ключи держите вне проекта или добавляйте в игнор-список, чтобы они не всплывали в контексте. Опасные операции гоняйте только в git-репозитории с чистым статусом: откат через git спасал меня не раз. И не оставляйте агента один на один с продакшеном без присмотра - злодей он неопасный, но оптимизм у него нередко избыточный.
Интеграция с редактором: терминал и IDE вместе
Для тех, кто не любит жить в чистой консоли: есть официальное расширение для VS Code и JetBrains-редакторов. Ставится из магазина расширений, работает с той же учеткой и теми же моделями. Я все равно сижу в терминале - привычка, но коллегам на Windows расширение заходит лучше.
Сколько стоит: подписка против API
Вариантов два. Подписка Claude Pro за $20 в месяц дает лимитированный доступ, Max за $100 и $200 - повышенные лимиты и приоритет. Оплата через API-ключ считается по токенам: дешево при редких задачах и заметно дорого при активной разработке - интенсивная сессия способна сжечь несколько долларов за вечер, я видел счета и на десятки долларов в неделю.
Мой ориентир простой: эпизодическая работа - API по факту, ежедневная разработка - подписка. У обеих схем есть общий знаменатель: нужен способ оплатить сервис Anthropic, а с российскими картами это отдельный квест.
Как достучаться до Claude из России
Прямой доступ из России закрыт: Anthropic не принимает российские карты и блокирует регистрацию с российских IP. Схема с иностранными картами и VPN рабочая, но дорогая и хрупкая - карты блокируют, подписки слетают, часть платежей просто не проходит.
Я для повседневной работы использую 3GPT от 3SELLER - ИИ-роутер с прямым доступом из России к флагманским моделям. Внутри: Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 6 Astra, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для генерации изображений. Есть генерация видео и голоса. Подписка стоит 149₽, пополнить баланс можно российской картой, через СБП или криптой - никаких иностранных карт.
Честно про нюанс. Claude Code в терминале - отдельный продукт Anthropic, для его авторизации нужна именно учетка Anthropic. 3GPT закрывает другую задачу: доступ к самим моделям для ежедневной работы. Код, продающие тексты, анализ данных, создание сайтов и лендингов - все это решается в браузере без установки и настройки. Для большинства задач, ради которых люди ставят Claude Code, этого хватает, а цена выходит ниже любой подписки Max.
Отдельная фишка сервиса - готовые ИИ-агенты под конкретные задачи: выбираете агента, начинаете диалог, модель меняется прямо в чате. Для бизнес-рутины это часто удобнее терминала: ничего не нужно устанавливать и настраивать. Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT.
Мой рабочий сценарий: где Claude Code отстреливает лучше всего
Тесты. На прошлой неделе агент прочитал модуль платежей на полторы тысячи строк и написал к нему набор тестов, покрывающий все ветки. Руками на это ушел бы день, у него - вечер, включая прогон и починку упавших кейсов. Мне осталось ревьюить.
Разбор легаси. Приношу проект без документации, прошу объяснить, что где лежит и как связаны модули. Claude Code строит карту репозитория и отвечает на вопросы с указанием конкретных файлов и строк. Новые разработчики в команде разгоняются в разы быстрее.
Рефакторинг и миграции. Смена версии фреймворка, переезд с одной библиотеки на другую - задачи, где важна последовательность правок в десятках файлов. Агент не забывает обновить импорты и поправить конфиги, за человеком тут остается только контроль и ревью.
Повседневный бизнес тоже уезжает в агентов: продающие тексты, лендинги, обработка изображений, видеоролики и озвучка. Часть этих задач я гоняю через 3GPT - быстрее, чем заводить отдельные подписки под каждую модель.
С чего начать прямо сегодня
Порядок простой. Ставьте Claude Code нативным установщиком: curl-команда на Mac и Linux, PowerShell на Windows. Откройте новое окно терминала, проверьте claude --version, авторизуйтесь через браузер и запустите /init в своем проекте. Если упретесь в оплату подписки - берите доступ к моделям через 3GPT за 149₽ с оплатой российской картой или СБП и продолжайте работу без танцев с иностранными платежами. Терминал установлен - дальше дело за задачами.