Клиент писал мне на днях: «Скачал Claude Code, ввожу claude в терминале, а он мне - command not found». Классика. Проблема почти всегда не в инструменте, а в том, что человек пропустил один шаг из трех: установка, проверка, запуск. Разберу все три на каждой платформе и покажу, куда люди спотыкаются чаще всего.
Сразу важный момент: Claude Code - инструмент исключительно для терминала. Графического интерфейса у него нет, в этом вся его идея. Есть отдельный Claude Desktop, но это другой продукт с другими задачами. Хотите Claude в терминале - нужен именно Claude Code. С ним и работаем.
Установка на macOS: две рабочие команды
На Mac проще всего через Homebrew. Одна команда - и готово:
brew install --cask claude-codeЕсли Homebrew не стоит (а зря, поставьте), есть нативный установщик через curl:
curl -fsSL https://claude.ai/install.sh | bashХотите самую свежую версию - добавьте флаг: curl -fsSL https://claude.ai/install.sh | bash -s latest
Деталь, о которой редко пишут: установщик не показывает прогресс загрузки. Вы вводите команду, она молчит секунд тридцать-минуту, и кажется, что все зависло. У меня на ноутбуке процесс занял секунд сорок, и весь этот тайм-аут терминал промолчал. Не зависло - просто ждите. Когда установка завершится, откройте новое окно терминала и проверьте:
claude --versionУвидели номер версии и подпись (Claude Code) - все, инструмент стоит. Если оболочка говорит, что команда не найдена, значит каталог установки не прописан в PATH. Лечится добавлением пути в переменную окружения, но в 90% случаев достаточно просто открыть новое окно терминала.
Windows: нативно не работает, но есть WSL 2
Тут спотыкаются чаще всего. Claude Code не запускается нативно на Windows - ни в CMD, ни в PowerShell напрямую. Нужен WSL 2 или, как минимум, Git Bash. Рекомендую WSL 2: с ним меньше сюрпризов.
Шаг первый - в PowerShell от администратора:
wsl --installПосле установки перезагрузите компьютер. Обязательно, не «потом».
Шаг второй - обновите Ubuntu внутри WSL:
sudo apt update && sudo apt upgrade -yШаг третий - сама установка Claude Code уже внутри WSL-терминала:
curl -fsSL https://claude.ai/install.sh | bashКстати, на Debian, Fedora, RHEL и Alpine Claude Code ставится и через apt, dnf или apk. Если вы на Linux и предпочитаете пакетные менеджеры - никаких проблем.
Типичная ошибка новичков на Windows: терминал ругается «The token '&&' is not a valid statement separator» - вы в PowerShell, а не в WSL. Пишет «'irm' is not recognized» - та же история. Проверьте, в каком окружении находитесь, прежде чем искать проблему в установщике. На Reddit в тредах про Claude Code большинство тем с ошибками установки закрывается именно этим ответом.
Первый запуск: главное - правильная папка
Вот тут начинается то, о чем я говорил в начале. Команда claude стартует агент из текущей директории терминала. Не из «какой-то умной» директории, а из той, где вы сейчас стоите. Запустили из домашней папки - Claude будет работать с файлами домашней папки.
Правильная последовательность такая:
cd /path/to/your/project
claudeПеред запуском проверьте командой pwd, где вы находитесь, а список файлов посмотрите через ls. Путь должен заканчиваться на директорию проекта. Звучит банально, но половина вопросов «у меня Claude не видит мой код» решается именно так: человек запустил агента не из той папки.
Совет из практики: держите отдельную папку под проекты. У меня есть директория для всех экспериментов, и я всегда стартую Claude из нее или из ее подпапок. Так агент гарантированно не полезет куда-то лишний раз.
Вход в аккаунт: /login вместо API-ключей
После первого запуска введите /login. Терминал выдаст ссылку и код. Открываете браузер, подтверждаете вход в аккаунт, копируете код обратно в консоль. Все - теперь вы тратите общие токены подписки и в браузере, и в терминале. Отдельный API-ключ заводить не обязательно, хотя такой вариант существует. Для подписчиков claude.ai он просто лишний.
Пять команд, которых хватит на первое время
Не нужно учить сотню слэш-команд сразу. Вот минимальный набор для повседневной работы:
- claude - запуск агента из текущей папки
- /login - вход в аккаунт
- Ctrl+L - очистить видимую область терминала (файлы и история не трогаются)
- pwd и ls - проверить, где вы и что в папке
- claude --version - проверить установку
На Windows используем PowerShell (для WSL), на macOS и Linux - стандартный терминал. Команды во всех трех случаях выглядят одинаково. Удобно, если работаете на нескольких машинах.
А если нужен Claude без танцев с установкой
Терминальная версия - вещь мощная, но не для всех. Если вы не разработчик и нужен Claude для текстов, анализа документов, картинок и повседневных задач в бизнесе, ставить WSL и разбираться с PATH - оверкилл. Есть путь проще.
Я пользуюсь сервисом 3GPT от 3SELLER - это доступ ко всем флагманским моделям нейросетей прямо из России: ChatGPT 6 Astra, Claude Fable 5 и 5.1, Claude Opus 5.5, ChatGPT 5.5, ChatGPT 6.1 Sol, плюс Nano Banana для генерации изображений и видео. Никаких иностранных карт и VPN-квестов. Баланс пополняется российской картой, через СБП или криптой. Стоимость - от 149 рублей, и вы получаете весь набор топовых моделей сразу, а не одну подписку на один сервис.
Практический сценарий: в терминале я кодю с Claude Code, а для продающих текстов, лендингов и обработки изображений открываю 3GPT в браузере - и Claude, и GPT в одном окне. Изображения создаются и обрабатываются максимально реалистично, видеоролики и голос генерируются там же. Для человека, который живет в терминале, это не замена, а дополнение. Для всех остальных - часто единственный разумный вариант.
Фишка для тех, кто хочет готовое решение
У 3GPT есть еще одна штука, которую я поначалу недооценил, - готовые ИИ-агенты под конкретные задачи. Выбираете агента и начинаете диалог. Модель меняется прямо в чате: сегодня работаете на Claude, завтра переключаетесь на GPT, а контекст и настройки остаются на месте. Для рутинных процессов в бизнесе это экономит часы - не нужно каждый раз писать промпты с нуля.
Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT: https://3seller.com/3gpt
Что запомнить
Три шага: установить, проверить командой claude --version, запустить из правильной папки через cd и claude. На Mac - brew или curl. На Windows - только через WSL 2, нативно не взлетит. После установки - /login, и вы в игре.
А если цель не вайбкодинг, а нормальный доступ к Claude и другим топовым моделям из России - не усложняйте. Откройте 3GPT, пополните баланс российской картой или через СБП и работайте. Терминал подождет.