Что такое Claude Code
Claude Code — это AI-ассистент, который работает прямо в терминале и понимает контекст всего вашего проекта. В отличие от веб-чатов, он не требует копировать фрагменты кода туда-обратно: достаточно написать задачу в командной строке — и Claude прочитает нужные файлы, предложит изменения или внесёт их сам.
Инструмент разработан компанией Anthropic и используется инженерами по всему миру для рефакторинга, написания тестов, ревью кода, работы с git и решения архитектурных задач. Главное отличие от плагинов в IDE — Claude Code работает с проектом целиком, а не только с открытым файлом.
Почему в России нужен gateway
Anthropic не продаёт доступ к своим сервисам напрямую в России. Российские карты не принимаются при регистрации на anthropic.com, а геоблокировка закрывает часть точек входа. VPN частично обходит это, но создаёт нестабильность: соединение прерывается, компании запрещают VPN на рабочих машинах, и решение перестаёт быть рабочим в продакшне.
API gateway — правильное решение этой проблемы. Это совместимый прокси-сервис: Claude Code работает в точности так же, как с официальным Anthropic, но запросы идут через российскую инфраструктуру gateway. Вы платите в рублях, получаете токен в личном кабинете и прописываете его один раз.
Установка Claude Code
Claude Code устанавливается через npm — стандартным способом, без каких-либо отличий от официальной инструкции. После установки инструмент готов к работе, нужно только указать параметры подключения.
- npm install -g @anthropic-ai/claude-code
- Проверить установку: claude --version
- Node.js должен быть версии 18 или выше
Подключение через gateway
После регистрации на claude-gateway.ru и оплаты любого тарифа вы получаете API-ключ в личном кабинете. Его нужно прописать в двух переменных окружения вместе с адресом gateway. Удобнее всего добавить их в ~/.zshrc или ~/.bashrc, чтобы они загружались автоматически при каждом запуске терминала.
- export ANTHROPIC_BASE_URL="https://claude-gateway.ru/api"
- export ANTHROPIC_AUTH_TOKEN="ваш_токен_из_кабинета"
- На Windows в PowerShell: $env:ANTHROPIC_BASE_URL = "https://claude-gateway.ru/api"
- После этого: source ~/.zshrc (или перезапустить терминал)
Первый запуск и базовые команды
Запустите claude в папке проекта — инструмент проиндексирует структуру и будет готов к работе. После этого можно давать задачи на естественном языке: объяснить функцию, исправить баг, написать тест, добавить обработку ошибок. Claude Code сам решает, какие файлы читать и что менять.
- claude — запустить в текущей папке проекта
- claude "объясни функцию calculateTotal" — разовый вопрос без интерактивного режима
- claude "добавь обработку ошибок в файл api.ts" — задача на изменение файла
- claude "напиши юнит-тесты для модуля auth" — генерация тестов
- /help — посмотреть список доступных команд внутри сессии
Практические сценарии использования
Рефакторинг: попросите Claude Code привести функцию к определённому стилю, разбить большой модуль на части или заменить устаревший паттерн на современный. Инструмент сам найдёт все вхождения и внесёт согласованные правки.
Работа с git: Claude Code может написать подробный commit message по diff, создать описание для pull request или объяснить изменения в конкретном коммите. Для этого достаточно дать задачу в терминале прямо в папке репозитория.
Дебаггинг: опишите симптом проблемы — Claude Code прочитает стек вызовов, проверит связанные файлы и предложит гипотезы с конкретными правками. Это быстрее, чем вручную трассировать зависимости.
Контроль расхода токенов
Каждый запрос к Claude Code потребляет токены: входные (то, что отправляется модели) и выходные (ответ). Чем больше контекст — файлы, история сессии — тем больше расход. Для экономии используйте флаг --no-files, если задача не требует чтения кода, и завершайте сессию после решения задачи, а не держите её открытой.
В личном кабинете на claude-gateway.ru видна статистика по каждому запросу: сколько токенов использовано, какая модель вызывалась, остаток по тарифу. Это позволяет предсказуемо управлять расходами без сюрпризов в конце месяца.
Итог
Claude Code в России работает без VPN и зарубежных карт через API gateway. Настройка занимает пять минут: установить npm-пакет, зарегистрироваться, оплатить тариф в рублях, прописать две переменные — и инструмент готов к работе в любом проекте.
Попробовать без риска можно на пробном тарифе — он даёт достаточно токенов, чтобы оценить инструмент на реальной задаче.