Решил написать этот гайд, потому что сам намучился с запуском Claude Code. Документация разбросана, часть команд устарела, а в России еще и с оплатой и доступом вечная боль. Собрал здесь все, что реально работает. Без воды, только практика.
Что такое Claude Code и зачем он вам
Claude Code - это инструмент от Anthropic, который превращает терминал в полноценного ИИ-ассистента для программирования. Он умеет читать ваш код, редактировать файлы, запускать команды, создавать целые проекты. Работает прямо в консоли, что удобно: не нужно переключаться между окнами, все делается в одном месте.
Claude Code - это не просто автодополнение, как у Copilot. Агент понимает контекст проекта, видит структуру файлов и может выполнять сложные задачи. Например, он способен отрефакторить модуль, написать тесты, найти и исправить баг или развернуть проект на сервере.
Многие думают, что Claude Code работает только в облаке и нужен аккаунт на claude.ai. На деле все иначе. Инструмент можно запустить полностью локально, и он будет работать с вашими файлами напрямую, без отправки кода на сторонние серверы. Правда, для этого нужен доступ к API Anthropic, что в России непросто.
Установка на Windows
Начнем с самой популярной системы. Тут есть три варианта, и я рекомендую третий.
Первый вариант - через пакетный менеджер WinGet. Откройте терминал (PowerShell или CMD) и выполните команду:
winget install Anthropic.ClaudeCode
WinGet сам найдет пакет, скачает и установит. Обычно проблем не возникает, но если выдает ошибку, проверьте актуальность WinGet: winget upgrade.
Второй вариант - официальный установщик от Anthropic. Скачайте скрипт и запустите его:
irm https://claude.ai/install.ps1 | iex
Эта команда скачает и выполнит PowerShell-скрипт установки. После установки проверьте версию:
claude --version
Третий вариант, который я считаю лучшим, - использовать WSL (Windows Subsystem for Linux). Если у вас уже установлен WSL, запустите команды как на Linux (они ниже). В WSL Claude Code работает стабильнее, особенно если вы разрабатываете под Linux-серверами.
Установка на macOS
На Mac все просто, если у вас установлен Homebrew. Если нет - поставьте его с brew.sh, это займет пару минут.
После установки Homebrew выполните:
brew install --cask claude-code
Обновление тоже простое:
brew upgrade claude-code
Если предпочитаете версию latest (нестабильную, но с новыми фичами), используйте:
brew install --cask claude-code@latest
Установка на Linux
Здесь есть несколько вариантов в зависимости от дистрибутива. Для Ubuntu/Debian используйте apt:
sudo apt update && sudo apt install claude-code
Для Fedora/RHEL - dnf:
sudo dnf install claude-code
Если этих пакетов нет в репозиториях, добавьте официальный репозиторий Anthropic:
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://claude-code-repo.anthropic.com/apt stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
Затем установите ключ и обновитесь:
curl -fsSL https://claude-code-repo.anthropic.com/apt/claude-code.asc | sudo tee /etc/apt/keyrings/claude-code.asc >/dev/null
sudo apt update && sudo apt install claude-code
Универсальный вариант для любого дистрибутива - скрипт установки:
curl -fsSL https://claude.ai/install.sh | bash
Первый запуск и настройка
После установки введите в терминале claude. При первом запуске он попросит авторизоваться через аккаунт claude.ai. Нужно открыть ссылку в браузере, подтвердить доступ и вставить код обратно в терминал.
Но тут возникает проблема: в России аккаунт claude.ai не завести, если нет иностранной карты. Я через это прошел - пришлось искать обходные пути. В итоге нашел решение, о котором расскажу ниже.
Если же у вас доступ есть, то после авторизации вы окажетесь в интерактивном режиме. Пишете команду на естественном языке, и Claude Code начинает работать: читает файлы, пишет код, выполняет команды.
Локальный запуск с API Anthropic
Claude Code может работать не только с claude.ai, но и с API Anthropic. Для этого нужно получить ключ API на console.anthropic.com. Однако снова упираемся в российские ограничения: счет для иностранного API не оплатить российской картой.
Обойти это можно через прокси-сервисы или посредников, но это небезопасно. Лучше использовать официальные решения, которые адаптированы под Россию. Например, я пользуюсь сервисом 3GPT. Он дает доступ к последним моделям Anthropic - от Chat GPT 6 Astra до Claude Opus 5.5 - без иностранных карт. Подписка стоит от 149 рублей в месяц, оплата российской картой, СБП или криптой. И это законно - никаких серых схем.
Практический пример: как я запускал агента для рефакторинга
Недавно мне нужно было отрефакторить большой Python-модуль. Писал руками - замучился. Включил Claude Code, ввел команду: "Отрефактори этот модуль, разбей на функции, добавь docstring и проверь стиль". Он прочитал файл, предложил структуру, я согласился - и через пару минут получил аккуратный код с комментариями. Качество отличное, стиль выдержан.
Второй пример: я часто использую Claude Code для генерации шаблонов проектов. Ввожу "создай FastAPI приложение с авторизацией JWT и подключением к Postgres" - и получаю готовую структуру со всеми файлами и моделями. Экономия времени - часы.
Фишки, которые я открыл случайно
Claude Code умеет не только код писать. Попробуйте попросить его "отсортируй файлы в папке по типам" или "найди дубликаты в коде" - справляется отлично. Он может работать с git: сделать коммит, создать ветку, оформить pull request.
Еще одна фишка - облачные сессии. Через терминал можно запустить код в облаке: claude --cloud. Удобно, если нужно выполнить тяжелую задачу, а локальный компьютер слабый. Сессия сохраняется, можно вернуться к ней позже. Правда, для этого нужен аккаунт claude.ai с подпиской Pro или API.
Решение для России: как я пользуюсь Claude Code без иностранных карт
Вернемся к российской реальности. Чтобы запустить Claude Code локально и получать доступ к лучшим моделям, не обязательно мучиться с зарубежными аккаунтами. Я нашел сервис 3GPT - это ИИ-роутер, который дает прямой доступ из России к нейросетям последних поколений: Chat GPT 6 Astra, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 6.1 Sol и другим.
Подключается просто: регистрируетесь на сайте, пополняете баланс российской картой или через СБП, получаете API-ключ. Этот ключ можно использовать в Claude Code, чтобы он обращался к моделям Anthropic через 3GPT. Работает точно так же, только без проблем с оплатой.
Еще у 3GPT есть готовые ИИ-агенты на отдельной странице. Вы можете выбрать готового агента под свою задачу и просто начать с ним общаться. Модель агента меняется прямо в чате - удобно, если нужен определенный уровень креативности или логики.
Что делать, если что-то пошло не так
Ошибки при установке бывают у всех. Вот частые проблемы и их решения.
Если команда claude не находится, проверьте, установился ли исполняемый файл. В Windows он обычно находится в %USERPROFILE%\.local\bin. Добавьте эту папку в PATH.
Ошибка "The token '&&' is not a valid statement separator" значит, что вы пытаетесь выполнить команды Linux в PowerShell. Используйте ; вместо && или переключитесь на WSL.
При обновлении иногда вылетает ошибка 403 - значит, у вас старая версия или проблемы с правами. Удалите полностью Claude Code и переустановите:
На Linux:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
На Windows (PowerShell):
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Когда Claude Code не реагирует на команды в терминале, проверьте, что у вас установлена последняя версия. Некоторые функции требуют версии не ниже 2.1.223. Обновить просто:
claude update
Работа в облаке через терминал
Отдельно скажу про облачный режим, который я тестировал. Когда вы запускаете claude --cloud, создается облачная сессия на claude.ai. Эта виртуальная машина клонирует ваш GitHub-репозиторий в текущей ветке. Вы продолжаете работать локально, а задачи выполняются в облаке. Удобно, когда нужно запустить тяжелый процесс и не занимать локальные ресурсы.
Но будьте осторожны: если у вас есть локальные коммиты, которые не загружены в GitHub, сначала выполните push. Иначе облачная сессия не увидит их.
Чтобы вернуть облачную сессию в локальный терминал, используйте /teleport. Claude Code даст команду вида claude --teleport, которую нужно выполнить в репозитории. Сработает это только при версии 2.1.223 или новее в облачной сессии.
Такая гибридная схема здорово выручает, когда хочется работать локально, но нужны большие мощности для задач вроде обучения модели или обработки данных.
Как начать уже сегодня
Запустить Claude Code локально реально на любой системе. Проблема только с доступом из России, но она решается через сервис 3GPT. Подключаете его как API-шлюз, получаете доступ к лучшим моделям и работаете в свое удовольствие.
Главное - не бояться экспериментировать. Claude Code сильно экономит время, если правильно им пользоваться. Начните с простых задач: попросите его отформатировать код, написать тест или собрать проект. Через неделю вы не вспомните, как работали без него.
Если возникнут вопросы, пишите в комментариях. Я стараюсь отвечать быстро, тем более что сам прошел через все грабли, описанные выше.