CC Switch через RouterAI: один профиль провайдера для Claude Code, Codex и других CLI-агентов

CC Switch

CC Switch — десктоп-приложение с открытым исходным кодом (farion1231/cc-switch, сайт ccswitch.io), которое переключает провайдера у CLI-агентов одной кнопкой. Вместо ручной правки JSON и TOML в каталогах агентов вы один раз описываете профиль, а приложение записывает в конфиг только адрес, ключ и модель: плагины, хуки, MCP и ваши комментарии остаются на месте. По README актуальной версии поддержаны Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi, MiniMax Code, Kimi Code и Oh My Pi.

RouterAI подключается как собственный (custom) провайдер: в одном профиле доступны Claude, GPT, DeepSeek и другие модели из каталога, работа из России без VPN и оплата в рублях. В этой статье подробно разобраны Claude Code (Anthropic-протокол) и Codex (OpenAI-совместимый протокол).

Требования

Windows 10 и новее, macOS 12 и новее или Linux (x86_64/ARM64, glibc 2.35+, WebKitGTK 4.1: Ubuntu 22.04+, Debian 12+, свежий Fedora)
Установленные агенты, которые вы хотите переключать (Claude Code, Codex)
API-ключ из личного кабинета

Установка

Актуальная версия на момент написания — v4.0.28. Сборки лежат на странице Releases:

Система	Что скачать или выполнить
Windows	`CC-Switch-v4.0.28-Windows.msi` или `Windows-Portable.zip` (для ARM — файлы с `arm64`)
macOS	`brew install --cask cc-switch` или `CC-Switch-v4.0.28-macOS.dmg`
Linux	`Linux-x86_64.deb`, `.rpm` или `.AppImage` (для ARM — `Linux-arm64`)
Arch Linux	`paru -S cc-switch-bin`

Например, для Debian и Ubuntu:

sudo apt install ./CC-Switch-v4.0.28-Linux-x86_64.deb
cc-switch

При первом запуске приложение покажет приветствие (кнопка Got it) и сохранит уже существующие настройки Claude Code, Codex, Gemini CLI и Grok Build как провайдера default, а также добавит официальные профили — ничего из прежней конфигурации не теряется.

Подключение к RouterAI

В списке пресетов при добавлении провайдера много сторонних сервисов. Для RouterAI они не нужны: выбирайте пункт Custom Configuration (в списке пресетов он первый).

Claude Code

Claude Code работает с Anthropic Messages API, поэтому адрес — https://routerai.ru/api (без /v1).

В боковой панели выберите Claude Code и нажмите Add Provider в правом верхнем углу.
Выберите Custom Configuration.
Name — RouterAI. Поле Website URL необязательное.
API Key — ключ из личного кабинета (на кадрах — заглушка sk-xxxxxxxxxxxxxxxx).
API Endpoint — https://routerai.ru/api.
Разверните Advanced Options. Upstream Format оставьте Anthropic Messages (Native), Auth Field — ANTHROPIC_AUTH_TOKEN (Default).
В таблице Model Mapping в колонке Requested model впишите id моделей из каталога для ролей Sonnet, Opus и Haiku (см. ниже). Роль Haiku лучше заполнить: иначе фоновые задачи Claude Code отправят провайдеру исходное имя модели Claude, и такой запрос может быть отклонён.
Нажмите Add, затем Enable на карточке профиля. Claude Code перезапускать не нужно.

Редактирование профиля RouterAI для Claude Code: поля Name, Website URL, API Key и API Endpoint

Advanced Options профиля: Upstream Format, Auth Field и Model Mapping с id моделей RouterAI

После сохранения профиль отмечен как In use, а вверху страницы видно Direct · RouterAI.

Список провайдеров Claude Code: профиль RouterAI активен (In use)

CC Switch записывает профиль в ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://routerai.ru/api",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-5.5"
  }
}

В файле есть и другие служебные переменные (имена моделей для меню /model и т. п.) — их добавляет сам CC Switch.

Codex

Codex обращается к OpenAI-совместимому API, поэтому адрес — https://routerai.ru/api/v1.

В боковой панели выберите Codex, нажмите Add Provider и выберите Custom Configuration.
Name — RouterAI, API Key — ключ.
API Request URL — https://routerai.ru/api/v1.
В блоке Models форма подставляет строку с моделью по умолчанию. Замените её: в Actual Request Model впишите id из каталога, например anthropic/claude-sonnet-5.5, в Menu Display Name — любое понятное имя, в Context Window — размер контекста. Кнопка Add manually добавляет ещё строки, Fetch Models подтягивает список с /v1/models.
Нажмите Add, затем Enable. После изменений перезапустите Codex.

Список провайдеров Codex: профиль RouterAI активен (In use)

В ~/.codex/config.toml появится такая конфигурация (ключ CC Switch кладёт в experimental_bearer_token, а не в auth.json):

model_provider = "custom"
model = "anthropic/claude-sonnet-5.5"

[model_providers.custom]
name = "custom"
wire_api = "responses"
base_url = "https://routerai.ru/api/v1"
experimental_bearer_token = "sk-xxxxxxxxxxxxxxxx"

Ключи лежат в конфигах агентов открытым текстом — не добавляйте эти файлы в git.

Gemini CLI и OpenCode

OpenCode относится к «coexist»-инструментам: кнопка Add записывает провайдера в его собственный конфиг, а выбираете модель вы уже внутри OpenCode. Для него в документации CC Switch есть пресет OpenAI Compatible — адрес тот же, https://routerai.ru/api/v1. Gemini CLI ожидает Gemini-формат запросов; для провайдеров другого формата в CC Switch есть режим Routing (вкладка вверху страницы агента, кнопка Start routing), который конвертирует форматы на вашей машине. Подробности — в руководстве CC Switch.

Выбор модели

Идентификаторы проверены по каталогу RouterAI; цены и актуальный список смотрите там же. Для агентов важна поддержка вызова инструментов (tool calling).

Модель	Агент	Для чего
`anthropic/claude-sonnet-5.5`	Claude Code, Codex	Основная модель: фичи, отладка, рефакторинг
`anthropic/claude-opus-5`	Claude Code	Роль Opus: сложные рефакторинги и архитектурные изменения
`anthropic/claude-haiku-5.5`	Claude Code	Роль Haiku: быстрые и фоновые задачи
`openai/gpt-5.5`	Codex	Родная для Codex модель OpenAI
`deepseek/deepseek-v4-flash`	Codex, OpenCode	Недорогие массовые правки

Модель, которую вы временно выбрали в Claude Code командой /model, в профиль не сохраняется: после переключения провайдера туда и обратно вернётся значение из профиля.

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

Сначала проверьте ключ и адрес напрямую. Для Claude Code путь запроса — /v1/messages, то есть https://routerai.ru/api/v1/messages:

curl https://routerai.ru/api/v1/messages \
  -H "x-api-key: sk-xxxxxxxxxxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"anthropic/claude-haiku-5.5","max_tokens":20,"messages":[{"role":"user","content":"Ответь одним словом: OK"}]}'

Затем запустите агента в папке проекта. Для Claude Code достаточно claude: в шапке видна активная модель, а запрос «Run npm test and briefly say what the tests check» выполнится через RouterAI. Переключить роль можно командой /model или флагом claude --model sonnet (также opus, haiku).

Claude Code через профиль CC Switch: запуск npm test на демо-проекте, в шапке модель Opus 5

Для Codex быстрая проверка — codex exec "Reply with one word: OK". В шапке ответа указаны provider: custom и модель из профиля.

Codex через профиль CC Switch: provider custom, модель anthropic/claude-sonnet-5.5, ответ OK

Вернуться к официальному входу можно, включив в списке карточку Claude Official (для Codex — OpenAI Official) и перезапустив агента. Быстро переключать профили можно и из системного трея.

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

404 Not Found

Проверьте адрес. Для Claude Code API Endpoint — https://routerai.ru/api (клиент сам добавляет /v1/messages), для Codex API Request URL — https://routerai.ru/api/v1. При проверке через curl используйте путь /api/v1/messages: на /api/messages вернётся 404.

400 Model not found

Id модели пишется целиком, с префиксом производителя: anthropic/claude-sonnet-5.5, а не claude-sonnet-5.5. Сверьтесь с каталогом.

401 Unauthorized

Ключ неверный или скопирован не полностью. Откройте профиль (значок карандаша на карточке) и проверьте API Key; в Claude Code итоговое значение видно в блоке Config JSON в ANTHROPIC_AUTH_TOKEN. Ключ берите в личном кабинете.

402 Payment Required

На балансе недостаточно средств — пополните его в разделе Биллинг.

Codex не видит изменений

Для Codex после правки профиля или списка моделей нужно перезапустить терминал или сам Codex. Claude Code перезапуска не требует. Если в форме Codex осталась строка gpt-5.6-sol, замените её моделью из каталога RouterAI.

Приложение не запускается в Linux

Нужны glibc 2.35+ и WebKitGTK 4.1. На более старых дистрибутивах (RHEL, Rocky, Alma 8–9) CC Switch пока не поддерживается.

Что дальше

Каталог моделей — подберите модель под задачу
Вайб-кодинг в Claude Code и Вайб-кодинг в Codex — настройка агентов без CC Switch
Вайб-кодинг в OpenCode — ещё один агент для того же профиля
Herdr: Claude Code и Codex в панелях — десктоп для нескольких агентов
Руководство CC Switch — маршрутизация, failover, MCP и Skills

Инструкция проверена на CC Switch 4.0.28.