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-ключи: кнопка «Подключить Claude Code, Cline и др.»

Окно «Подключить программу», выбран Claude Code: адрес и ключ уже подставлены (на скриншоте ключ скрыт)
Установка Claude Code
- macOS / Linux
- Windows
Через npm:Проверка:
Подключение Claude Code к RuAPI
Три способа конфигурации, в порядке предпочтения:Способ 1: settings.json (рекомендуется)
Откройте ~/.claude/settings.json (macOS / Linux) или %USERPROFILE%\.claude\settings.json (Windows). Если файла нет — создайте и впишите, подставив свой ключ:
Что означает каждое поле
Что означает каждое поле
Почему модель в поле model, а не в ANTHROPIC_MODEL
Почему модель в поле model, а не в ANTHROPIC_MODEL
Переменная
ANTHROPIC_MODEL тоже задаёт модель, но она сильнее поля model: пока она задана, выбор «по умолчанию» в /model после перезапуска сбрасывается. Если ANTHROPIC_MODEL осталась в env от старой настройки — удалите её.Почему AUTH_TOKEN, а не ANTHROPIC_API_KEY
Почему AUTH_TOKEN, а не ANTHROPIC_API_KEY
ANTHROPIC_API_KEY тоже работает (RuAPI принимает оба заголовка), но с ним Claude Code при первом запуске спрашивает, использовать ли этот ключ, — если случайно ответить «нет», запросы пойдут мимо RuAPI. С ANTHROPIC_AUTH_TOKEN такого вопроса нет. Переменная ANTHROPIC_SMALL_FAST_MODEL устарела — вместо неё используйте ANTHROPIC_DEFAULT_HAIKU_MODEL.Способ 2: переменные окружения
Для быстрой пробы:- macOS / Linux (zsh / bash)
- Windows (PowerShell)
ANTHROPIC_MODEL здесь задаёт модель только для этого окна. Для постоянной настройки используйте способ 1: если прописать ANTHROPIC_MODEL в ~/.zshrc или ~/.bashrc, выбор модели «по умолчанию» в /model перестанет сохраняться.Способ 3: через CC Switch
Если вы часто переключаетесь между RuAPI и официальным аккаунтом, поставьте CC Switch и управляйте провайдерами через GUI.Первый запрос
Откройте новый терминал (чтобы переменные подгрузились), зайдите в любой проект:Проверка через /status
Внутри Claude Code введите /status:
- строка
Anthropic base URLдолжна показыватьhttps://www.ruapi.ai; - строка
Auth tokenдолжна называтьANTHROPIC_AUTH_TOKEN.
settings.json. Подробнее — на странице 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.
Решение проблем
Unable to connect to Anthropic services / Failed to connect to api.anthropic.com
Unable to connect to Anthropic services / Failed to connect to api.anthropic.com
В некоторых версиях Claude Code при первом запуске проверяет связь с
api.anthropic.com, даже если указан ANTHROPIC_BASE_URL, а из России этот адрес недоступен. Как обойти — на странице Claude Code в России.Модель не найдена (503) или 404
Модель не найдена (503) или 404
- Опечатка в ID модели. На RuAPI имена Claude совпадают с официальными (семейства Claude Sonnet, Claude Opus, Claude Haiku); точные имена всех моделей — в меню
/modelили на странице цен. - Не добавляйте
/v1кANTHROPIC_BASE_URL.
403 / недостаточно средств
403 / недостаточно средств
Проверьте баланс USD на главной странице Консоли и пополните баланс в USDT. Длинный контекст и tool calls сжигают токены быстро — 5–10 USD на старте обычно достаточно.
Таймаут / нет соединения
Таймаут / нет соединения
- Проверьте доступность:
curl -I https://www.ruapi.ai. - Если за корпоративным прокси — убедитесь, что
HTTPS_PROXYне направляет запросы в недоступный шлюз. - VPN не требуется.
Продвинутое
- MCP-серверы: не зависят от того, какой API стоит за бэкендом — настраиваются как обычно.
- Tool calls / function calling: RuAPI передаёт вызовы инструментов Anthropic без изменений.
- Streaming / SSE: включён по умолчанию, дополнительной настройки не требуется.
- Заголовки
anthropic-versionиanthropic-beta, которые отправляет Claude Code, поддерживаются. - Кэширование промптов: метки
cache_controlпередаются в API Anthropic — см. Кэширование промптов.