Claude Code в России: как запустить без VPN и не потерять нервы

Месяц назад я потратил три часа, пытаясь заставить Claude Code работать через VPN. Соединение рвалось на середине задачи, агент перезапускался с нуля, прогресс терялся. После пятой попытки я просто переключился на PlusVibe API — и с тех пор это стало стандартной настройкой для всех проектов.

Если коротко: Claude Code в России работает, но требует один нетривиальный шаг с базовым URL. Дальше — пошагово.

Что такое Claude Code и зачем он нужен

Claude Code — это CLI-агент от Anthropic, который живёт в терминале и работает с вашей кодовой базой напрямую. Не "напиши код в чате", а именно агент: читает файлы, редактирует их, запускает команды, итерирует по ошибкам.

Главное отличие от Cursor или Copilot — контекст. Claude Code видит весь проект, а не только открытый файл. Это критично, когда рефакторишь что-то, что затрагивает 20 файлов сразу.

Из неочевидного: агент умеет работать автономно (флаг --dangerously-skip-permissions для доверенных проектов) — запускаешь задачу, уходишь пить кофе, возвращаешься к готовому PR. Работает не всегда идеально, но 70% задач закрывает без участия человека.

Почему напрямую из России не работает

Anthropic блокирует российские IP на уровне API. Ошибка выглядит так:

Error: 403 Forbidden
{"error": {"type": "permission_error", "message": "Your access has been restricted"}}

VPN решает проблему, но создаёт другие. Длинные агентные сессии (10–20 минут работы) рвутся при малейшей нестабильности тоннеля. Агент получает ошибку соединения, паникует и либо останавливается, либо начинает придумывать — оба исхода плохие.

Есть и корпоративный аспект: на серверах и в CI/CD VPN обычно не настраивают. Команды из 3+ человек не могут полагаться на "у каждого свой VPN".

Решение: OpenAI-совместимый прокси

Claude Code поддерживает переменную ANTHROPIC_BASE_URL — можно указать любой совместимый эндпоинт. PlusVibe API поднят в России, принимает запросы без геоблокировки и полностью совместим с протоколом Anthropic.

Одна строка в окружении — и всё работает как будто ты в Берлине.

Установка — шаг за шагом

Шаг 1. Установите Claude Code

npm install -g @anthropic-ai/claude-code

Требует Node.js 18+. Проверить: node --version.

Шаг 2. Получите ключ PlusVibe

Регистрация на plusvibeapi.ru/register — без иностранных карт, оплата рублями. Ключ выглядит как sk-pv-....

Шаг 3. Пропишите переменные

В ~/.bashrc или ~/.zshrc:

export ANTHROPIC_API_KEY="sk-pv-ваш_ключ"
export ANTHROPIC_BASE_URL="https://plusvibeapi.ru"

Затем source ~/.bashrc (или перезапустите терминал).

Шаг 4. Запустите

claude

Если видите интерактивный режим — всё работает. Первый тест: /status внутри агента покажет модель и статус соединения.

Шаг 5 (опционально). Для CI/CD

В GitHub Actions:

env:
  ANTHROPIC_API_KEY: ${{ secrets.PLUSVIBE_API_KEY }}
  ANTHROPIC_BASE_URL: https://plusvibeapi.ru

Какие модели доступны

По умолчанию Claude Code использует Opus. Сменить модель: /model claude-sonnet-4-6 прямо в сессии. Для большинства задач Sonnet быстрее и в 5× дешевле Opus — разница в качестве заметна только на очень запутанном легаси-коде.

Частые проблемы

"Could not resolve host"

Проверьте, что переменная установлена в текущей сессии: echo $ANTHROPIC_BASE_URL. Если пусто — добавление в .bashrc не применилось. Запустите source ~/.bashrc.

"Invalid API key"

Ключ PlusVibe начинается с sk-pv-, не с sk-ant-. Убедитесь, что в переменной именно он, а не старый ключ Anthropic.

Агент "завис" и не отвечает

Ctrl+C прерывает текущий шаг без потери контекста сессии. После нажатия Claude Code спрашивает, продолжать ли — отвечаете "да" или даёте новую инструкцию.

7 вопросов, которые задают чаще всего