Skip to main content
Claude Code — официальный консольный ассистент для написания кода от Anthropic. По умолчанию он стучится в api.anthropic.com, но через переменную ANTHROPIC_BASE_URL его можно сразу направить на RuAPI без каких-либо прокси.
На этой странице описана прямая настройка. Если удобнее графический интерфейс с несколькими провайдерами, смотрите CC Switch.

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

1

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

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

Node.js ≥ 18

Claude Code требует Node.js 18 и выше. Проверьте:
Если не установлен — берите LTS-версию с nodejs.org. Для macOS:

​
Установка 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.

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

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

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

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

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

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

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

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

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

  • ANTHROPIC_API_KEY должен быть токеном RuAPI (sk-...), а не официальным sk-ant-... от Anthropic.
  • Следите за лишними пробелами и переносами строк при копировании.
  • В Консоли RuAPI → Токены убедитесь, что ключ активен, а allowlist моделей (если задан) не исключает вызываемую модель.
  • Опечатка в ID модели. На RuAPI имена Claude совпадают с официальными — точные имена возьмите со страницы цен (семейства Claude Sonnet, Claude Opus, Claude Haiku).
  • Не добавляйте /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: включён по умолчанию, дополнительной настройки не требуется.
Больше про Claude Code — в официальной документации.