Перейти к основному содержанию
Claude Code — официальный консольный ассистент для написания кода от Anthropic. По умолчанию он обращается к api.anthropic.com, но через переменную ANTHROPIC_BASE_URL его можно сразу направить на RuAPI (https://www.ruapi.ai) без каких-либо прокси. Подписка Anthropic и вход в аккаунт Anthropic при этом не нужны. RuAPI принимает нативный формат Anthropic Messages (/v1/messages) — тот, который документация Claude Code описывает для шлюза, подключаемого через ANTHROPIC_BASE_URL (LLM gateway protocol). Поэтому конвертеры вроде claude-code-router или LiteLLM не нужны. Обновлено: 05.11.2026 Почему из России Claude Code лучше подключать через RuAPI, а не через аккаунт Anthropic, — коротко на странице www.ruapi.ai/claude-code-v-rossii; ниже — как всё настроить.
На этой странице описана прямая настройка. Если удобнее графический интерфейс с несколькими провайдерами, смотрите CC Switch.

Предварительные требования

1

Аккаунт RuAPI и API-ключ

Если ещё нет: зарегистрируйтесь на www.ruapi.ai, пополните баланс в USDT, затем Консоль → API-ключи → Создать ключ, чтобы получить строку sk-.... См. Пополнение и API-ключи и безопасность.
2

Node.js ≥ 22

Claude Code устанавливается через npm, а для npm нужен Node.js 22 или новее. Проверьте:
Если не установлен или версия старше — берите LTS-версию с nodejs.org. Для macOS:
Быстрее всего — скопировать готовые настройки из Консоли. Откройте Консоль → API-ключи, нажмите Подключить Claude Code, Cline и др. и выберите Claude Code: адрес RuAPI и ваш ключ уже подставлены. Установите программу по шагам ниже, а раздел «Подключение Claude Code к RuAPI» можно пропустить.
Страница API-ключей RuAPI: адрес https://www.ruapi.ai и кнопка «Подключить Claude Code, Cline и др.»

Консоль → API-ключи: кнопка «Подключить Claude Code, Cline и др.»

Окно «Подключить программу» в Консоли RuAPI с готовыми настройками для Claude Code

Окно «Подключить программу», выбран Claude Code: адрес и ключ уже подставлены (на скриншоте ключ скрыт)

Установка Claude Code

Через npm:
Проверка:
Официальные установщики Claude Code с claude.ai (install.sh, install.ps1, install.cmd) из России не работают: claude.ai перенаправляет на страницу «недоступно в вашем регионе» (claude.com/app-unavailable-in-region). Ставьте через npm — пакет и программа скачиваются с registry.npmjs.org, а программа та же самая. По нашей проверке 03.11.2026 этот адрес открывается из России без VPN. Если Claude Code предложит перейти на нативную установку (claude install), не соглашайтесь: она тоже скачивает файлы с claude.ai.

Подключение Claude Code к RuAPI

Три способа конфигурации, в порядке предпочтения:

Способ 1: settings.json (рекомендуется)

Откройте ~/.claude/settings.json (macOS / Linux) или %USERPROFILE%\.claude\settings.json (Windows). Если файла нет — создайте и впишите, подставив свой ключ:
Не добавляйте /v1 в конце ANTHROPIC_BASE_URL. SDK Anthropic сам подставляет /v1/messages, лишний /v1 приведёт к 404.
Переменная ANTHROPIC_MODEL тоже задаёт модель, но она сильнее поля model: пока она задана, выбор «по умолчанию» в /model после перезапуска сбрасывается. Если ANTHROPIC_MODEL осталась в env от старой настройки — удалите её.
ANTHROPIC_API_KEY тоже работает (RuAPI принимает оба заголовка), но с ним Claude Code при первом запуске спрашивает, использовать ли этот ключ, — если случайно ответить «нет», запросы пойдут мимо RuAPI. С ANTHROPIC_AUTH_TOKEN такого вопроса нет. Переменная ANTHROPIC_SMALL_FAST_MODEL устарела — вместо неё используйте ANTHROPIC_DEFAULT_HAIKU_MODEL.

Способ 2: переменные окружения

Для быстрой пробы:
ANTHROPIC_MODEL здесь задаёт модель только для этого окна. Для постоянной настройки используйте способ 1: если прописать ANTHROPIC_MODEL в ~/.zshrc или ~/.bashrc, выбор модели «по умолчанию» в /model перестанет сохраняться.

Способ 3: через CC Switch

Если вы часто переключаетесь между RuAPI и официальным аккаунтом, поставьте CC Switch и управляйте провайдерами через GUI.

Первый запрос

Откройте новый терминал (чтобы переменные подгрузились), зайдите в любой проект:
В интерактивном режиме спросите что-нибудь простое:
Должен прийти ответ от Claude, а в Консоли RuAPI → Журнал запросов появится запрос со списанием токенов.
Чтобы убедиться, что запрос действительно прошёл через RuAPI, откройте Консоль → Журнал запросов и проверьте самую свежую запись — название модели должно совпадать с тем, что вы прописали.

Проверка через /status

Внутри Claude Code введите /status:
  • строка Anthropic base URL должна показывать https://www.ruapi.ai;
  • строка Auth token должна называть ANTHROPIC_AUTH_TOKEN.
Если строки с адресом нет, переменные не подхватились — откройте новый терминал или проверьте settings.json. Подробнее — на странице Claude Code в России.

Переключение моделей

Внутри сессии:
Кроме Claude, в Claude Code работают модели других производителей: DeepSeek, GPT, Gemini, Kimi, GLM, Qwen, MiniMax и Grok. Claude Code отправляет запросы в формате Anthropic Messages, а RuAPI сам переводит их в формат, который понимает модель. Мы проверили каждое семейство запросами в формате Claude Code (вызов инструмента, следующий шаг с результатом инструмента, обычный и потоковый ответ) — например, deepseek-flash, gpt-5.4-mini, gemini-3.8-flash, kimi-k3.1-pro, glm-5.3, qwen3.8-max, MiniMax-M3.1-Flash, grok-4.7:
Меню /model само показывает все эти модели, доступные вашему ключу; модели других производителей в нём записаны с приставкой anthropic/ (например, anthropic/kimi-k3.1-pro) — так требует Claude Code. В команде /model подходят оба варианта, с приставкой и без. Полный список с ценами — на странице цен. Для DeepSeek есть отдельная инструкция — Claude Code на DeepSeek.
Встроенный веб-поиск Claude Code (WebSearch) с моделями других производителей недоступен: этот инструмент им просто не передаётся. Ваши обычные инструменты (команды, правка файлов, MCP) работают со всеми моделями.

Как сэкономить

Чтение кода, мелкие правки, тесты и рутинные вопросы спокойно выполняет deepseek-flash — он во много раз дешевле Claude Sonnet. Сделайте его основной моделью (в settings.json — "model": "deepseek-flash"), а на сложную задачу (большой рефакторинг, запутанная ошибка) переключайтесь отдельно:
Закончили — вернитесь командой /model deepseek-flash; если в меню /model вы сделали Sonnet моделью по умолчанию, верните там же deepseek-flash, иначе следующий запуск тоже начнётся на Sonnet. Меняйте модель между задачами, а не посреди одной: у каждой модели свой кэш промптов, и после смены длинный контекст первый раз оплачивается полностью. Как перевести на DeepSeek весь Claude Code, включая фоновые задачи, — в инструкции Claude Code на DeepSeek; другие способы сократить счёт — в статье Экономия в Claude Code и Cline.

Решение проблем

В некоторых версиях Claude Code при первом запуске проверяет связь с api.anthropic.com, даже если указан ANTHROPIC_BASE_URL, а из России этот адрес недоступен. Как обойти — на странице Claude Code в России.
  • ANTHROPIC_AUTH_TOKEN должен быть ключом RuAPI (sk-...), а не официальным sk-ant-... от Anthropic.
  • Следите за лишними пробелами и переносами строк при копировании.
  • В Консоли RuAPI → API-ключи убедитесь, что ключ активен и что вызываемая модель входит в «Доступные модели» ключа (если список задан).
  • Опечатка в ID модели. На RuAPI имена Claude совпадают с официальными (семейства Claude Sonnet, Claude Opus, Claude Haiku); точные имена всех моделей — в меню /model или на странице цен.
  • Не добавляйте /v1 к ANTHROPIC_BASE_URL.
Проверьте баланс USD на главной странице Консоли и пополните баланс в USDT. Длинный контекст и tool calls сжигают токены быстро — 5–10 USD на старте обычно достаточно.
  • Проверьте доступность: curl -I https://www.ruapi.ai.
  • Если за корпоративным прокси — убедитесь, что HTTPS_PROXY не направляет запросы в недоступный шлюз.
  • VPN не требуется.
Используйте CC Switch для переключения одним кликом или direnv, чтобы привязывать разные переменные окружения к разным каталогам проектов.

Продвинутое

  • MCP-серверы: не зависят от того, какой API стоит за бэкендом — настраиваются как обычно.
  • Tool calls / function calling: RuAPI передаёт вызовы инструментов Anthropic без изменений.
  • Streaming / SSE: включён по умолчанию, дополнительной настройки не требуется.
  • Заголовки anthropic-version и anthropic-beta, которые отправляет Claude Code, поддерживаются.
  • Кэширование промптов: метки cache_control передаются в API Anthropic — см. Кэширование промптов.
Больше про Claude Code — в официальной документации.