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

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.

CC Switch — это кроссплатформенное десктопное приложение для управления конфигурациями Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw. Один GUI вместо ручной правки ~/.claude/settings.json, ~/.codex/config.toml и ~/.openclaw/openclaw.json.
Если вы пользуетесь только одним CLI (например, только Claude Code), CC Switch не обязателен — см. прямую настройку Claude Code. CC Switch удобен, когда инструментов несколько и провайдеров несколько.

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

1

Регистрация и пополнение

Создайте аккаунт на www.ruapi.ai и пополните баланс через USDT. См. руководство по пополнению.
2

Создайте API-ключ

Консоль → Токены → Создать токен. Скопируйте строку, начинающуюся с sk-.... Подробнее в API-ключи и безопасность.
3

Установите хотя бы один CLI

CC Switch не устанавливает Claude Code, Codex и т. д. — он лишь управляет их конфигурацией. Сначала установите CLI по инструкциям Claude Code или Codex.

​
Установка CC Switch

Скачайте сборку со страницы релизов:
Скачайте cc-switch-x.y.z-arm64.dmg (Apple Silicon) или cc-switch-x.y.z-x64.dmg (Intel) → откройте → перетащите CC Switch.app в Программы.
Если при первом запуске появится «не удаётся проверить разработчика», откройте Системные настройки → Конфиденциальность и безопасность, прокрутите вниз и нажмите Открыть всё равно.

​
Добавьте RuAPI в CC Switch (Claude Code)

Откройте CC Switch, выберите слева вкладку Claude Code:
1

Нажмите «Добавить провайдера»

Кнопка + Add Provider в правом верхнем углу.
2

Выберите «Custom Provider»

Пролистайте список пресетов до конца и выберите Custom Provider. Если в списке уже есть готовый пресет «RuAPI», возьмите его — останется только вставить API-ключ.
3

Основная информация

ПолеЗначение
NameRuAPI
Websitehttps://www.ruapi.ai
IconНеобязательно
4

Переменные окружения

Перейдите на вкладку Environment Variables (или Endpoint config):
ПеременнаяЗначение
ANTHROPIC_BASE_URLhttps://www.ruapi.ai
ANTHROPIC_API_KEYsk-ваш-токен-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.
5

Сохраните и активируйте

Нажмите Save → на главном экране нажмите Enable на строке с RuAPI. Зелёный статус — Claude Code теперь работает через RuAPI.

​
Добавьте RuAPI в CC Switch (Codex)

Переключитесь на вкладку Codex слева и повторите тот же процесс, но переменные окружения другие:
ПеременнаяЗначение
OPENAI_BASE_URLhttps://www.ruapi.ai/v1
OPENAI_API_KEYsk-ваш-ключ (тот же токен подходит)
OPENAI_MODEL (опционально)gpt-5 или другая модель по умолчанию
Codex работает по OpenAI-совместимому протоколу — OPENAI_BASE_URL должен заканчиваться на /v1.

​
Проверка переключения

После переключения в CC Switch поведение разное для разных инструментов:

Claude Code

Перезапускать не нужно — CC Switch переключает на лету. Можно продолжать работу в уже открытом claude.

Codex / OpenClaw / Gemini CLI

Закройте и снова откройте терминал (или перезапустите CLI), чтобы новые переменные окружения подхватились.
Быстрая проверка: 
# Claude Code
claude "В одном предложении: через какой API ты работаешь?"

# Codex
codex "В одном предложении: через какой API ты работаешь?"
Нормальный ответ без 401 и сетевых ошибок = переключение успешно.

​
Возврат к официальному провайдеру

В главном окне CC Switch выберите другого провайдера → Enable. CC Switch автоматически перезапишет соответствующие файлы конфигурации.
Можно одновременно держать RuAPI, официальный аккаунт Anthropic/OpenAI и любых других релееров и переключаться одним кликом — это и есть главное удобство CC Switch.

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

  1. Закройте текущую сессию claude и откройте новый терминал.
  2. Проверьте, не выставлен ли вручную export ANTHROPIC_BASE_URL — переменные окружения в shell перекрывают settings-файл, который пишет CC Switch.
  3. Выполните cat ~/.claude/settings.json и убедитесь, что блок env содержит конфигурацию RuAPI.
  • ANTHROPIC_API_KEY должен быть полностью скопирован (с префиксом sk- и всеми символами в конце).
  • В Консоли → Токены убедитесь, что ключ активен и нужная модель не исключена из allowlist.
  • Проверьте баланс USD.
  • Опечатка в ID модели. Популярные ID Claude на RuAPI: claude-sonnet-4-6, claude-opus-4-7, claude-haiku-4-5.
  • Не добавляйте /v1 к ANTHROPIC_BASE_URL.
Убедитесь, что Claude Code хотя бы раз запускался (тогда создаётся ~/.claude/settings.json). Без установленного Claude Code переключать нечего.

​
Что дальше

  • Настроить Claude Code напрямую (без CC Switch)? — см. Claude Code.
  • Настроить Codex? — см. Codex.
  • Настроить OpenClaw? — см. OpenClaw.