Как подключить Claude Code к RuAPI из России

Claude Code — официальный консольный ассистент для написания кода от Anthropic. По умолчанию он обращается к api.anthropic.com, но через переменную ANTHROPIC_BASE_URL его можно сразу направить на RuAPI (https://www.ruapi.ai) без каких-либо прокси. Подписка Anthropic и вход в аккаунт Anthropic при этом не нужны.

На этой странице описана прямая настройка. Если удобнее графический интерфейс с несколькими провайдерами, смотрите CC Switch.

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

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

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

Node.js ≥ 22 (для установки через npm)

Установка через npm требует Node.js 22 или новее. Проверьте:

node --version

Если не установлен или версия старше — берите LTS-версию с nodejs.org. Для macOS:

brew install node

Для официального установщика (см. ниже) Node.js не нужен.

Установка Claude Code

macOS / Linux
Windows

Через npm:

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

Или официальным установщиком (Node.js не нужен):

curl -fsSL https://claude.ai/install.sh | bash

Проверка:

claude --version

В PowerShell через npm:

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

Или официальным установщиком:

irm https://claude.ai/install.ps1 | iex

Claude Code работает в Windows нативно. Если установить Git for Windows, Claude Code сможет запускать команды через Git Bash; без него он использует PowerShell. Можно работать и внутри WSL2 — там ставьте по инструкции для macOS / Linux.

Если официальный установщик с claude.ai не открывается в вашей сети — ставьте через npm, результат тот же.

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

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

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

Откройте ~/.claude/settings.json (macOS / Linux) или %USERPROFILE%\.claude\settings.json (Windows). Если файла нет — создайте и впишите, подставив свой ключ:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ruapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-ключ-RuAPI",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Не добавляйте /v1 в конце ANTHROPIC_BASE_URL. SDK Anthropic сам подставляет /v1/messages, лишний /v1 приведёт к 404.

Что означает каждое поле

Поле	Значение
`ANTHROPIC_BASE_URL`	Адрес RuAPI: `https://www.ruapi.ai` (без `/v1` на конце)
`ANTHROPIC_AUTH_TOKEN`	Ваш ключ RuAPI (не официальный ключ Anthropic). Отправляется в заголовке `Authorization: Bearer`
`ANTHROPIC_MODEL`	Модель по умолчанию. Claude Sonnet — оптимальное соотношение цены и качества
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Во что превращается алиас `opus` (команда `/model opus`, режим планирования)
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Во что превращается алиас `sonnet`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Лёгкая модель для фоновых задач (заголовки сессий и т. п.). Claude Haiku экономит токены

Почему 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)

export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-ключ"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

Чтобы сохранить навсегда — добавьте эти строки в ~/.zshrc или ~/.bashrc.

$env:ANTHROPIC_BASE_URL   = "https://www.ruapi.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-ваш-ключ"
$env:ANTHROPIC_MODEL      = "claude-sonnet-5"
claude

Для постоянного сохранения:

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.ruapi.ai", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-ваш-ключ", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", "User")

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

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

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

Откройте новый терминал (чтобы переменные подгрузились), зайдите в любой проект:

cd ~/some-project
claude

В интерактивном режиме спросите что-нибудь простое:

> Ответь одним русским предложением: привет

Должен прийти ответ от Claude, а в Консоли RuAPI → Журнал запросов появится запрос со списанием токенов.

Чтобы убедиться, что запрос действительно прошёл через RuAPI, откройте Консоль → Журнал запросов и проверьте самую свежую запись — название модели должно совпадать с тем, что вы прописали.

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

Внутри сессии:

/model claude-opus-5-5

Полный список — на странице цен.

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

401 Unauthorized / Invalid token

ANTHROPIC_AUTH_TOKEN должен быть ключом RuAPI (sk-...), а не официальным sk-ant-... от Anthropic.
Следите за лишними пробелами и переносами строк при копировании.
В Консоли RuAPI → API-ключи убедитесь, что ключ активен и что вызываемая модель входит в «Доступные модели» ключа (если список задан).

Модель не найдена (503) или 404

Опечатка в ID модели. На RuAPI имена Claude совпадают с официальными — точные имена возьмите со страницы цен (семейства Claude Sonnet, Claude Opus, Claude Haiku).
Не добавляйте /v1 к ANTHROPIC_BASE_URL.

403 / недостаточно средств

Проверьте баланс USD на главной странице Консоли и пополните баланс в USDT. Длинный контекст и tool calls сжигают токены быстро — 5–10 USD на старте обычно достаточно.

Таймаут / нет соединения

Проверьте доступность: curl -I https://www.ruapi.ai.
Если за корпоративным прокси — убедитесь, что HTTPS_PROXY не направляет запросы в недоступный шлюз.
VPN не требуется.

Хочу держать и официальный аккаунт, и RuAPI

Используйте CC Switch для переключения одним кликом или direnv, чтобы привязывать разные переменные окружения к разным каталогам проектов.

Продвинутое

MCP-серверы: не зависят от того, какой API стоит за бэкендом — настраиваются как обычно.
Tool calls / function calling: RuAPI передаёт вызовы инструментов Anthropic без изменений.
Streaming / SSE: включён по умолчанию, дополнительной настройки не требуется.

Больше про Claude Code — в официальной документации.

Начало работы

Руководства

Справочник API

Гайды по моделям

Интеграции

Возможности

Рецепты

Юридическая информация

Как подключить Claude Code к RuAPI из России

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

Установка Claude Code

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

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

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

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

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

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

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

Продвинутое

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

​Установка Claude Code

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

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

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

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

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

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

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

​Продвинутое

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

Установка Claude Code

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

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

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

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

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

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

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

Продвинутое