Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 и выше. Проверьте:
node --version
Если не установлен — берите LTS-версию с nodejs.org. Для macOS:
brew install node

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

npm install -g @anthropic-ai/claude-code
Проверка:
claude --version

​
Настройка endpoint-а RuAPI

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

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

Откройте ~/.claude/settings.json (macOS / Linux) или %USERPROFILE%\.claude\settings.json (Windows). Если файла нет — создайте: 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ruapi.ai",
    "ANTHROPIC_API_KEY": "sk-ваш-токен-RuAPI",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}
Не добавляйте /v1 в конце ANTHROPIC_BASE_URL. SDK Anthropic сам подставляет /v1/messages, лишний /v1 приведёт к 404.
ПолеЗначение
ANTHROPIC_BASE_URLEndpoint RuAPI
ANTHROPIC_API_KEYВаш токен RuAPI (не официальный ключ Anthropic)
ANTHROPIC_MODELМодель Claude по умолчанию. claude-sonnet-4-6 — лучший баланс цены и качества
ANTHROPIC_SMALL_FAST_MODELМаленькая модель для внутренних задач (генерация заголовков, автодополнение путей). claude-haiku-4-5 экономит токены

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

Для быстрой пробы: 
export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_API_KEY="sk-ваш-ключ"
claude
Чтобы сохранить навсегда — добавьте эти строки в ~/.zshrc или ~/.bashrc.

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

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

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

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

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

Внутри сессии: 
/model claude-opus-4-7
/model claude-haiku-4-5
Полный список — в галерее моделей.

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

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