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

## CC Switch

CC Switch — десктоп-приложение с открытым исходным кодом ([farion1231/cc-switch](https://github.com/farion1231/cc-switch), сайт [ccswitch.io](https://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 и другие модели из [каталога](/models), работа из России без 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-ключ из [личного кабинета](/settings/keys)

## Установка

Актуальная версия на момент написания — v4.0.28. Сборки лежат на странице [Releases](https://github.com/farion1231/cc-switch/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:

```bash
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`).

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

![Редактирование профиля RouterAI для Claude Code: поля Name, Website URL, API Key и API Endpoint](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/1ded127ccc7acb03c485cebfa6941ba6.png)

![Advanced Options профиля: Upstream Format, Auth Field и Model Mapping с id моделей RouterAI](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/a7aa32b0de259b0ac93493790f1a11e9.png)

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

![Список провайдеров Claude Code: профиль RouterAI активен (In use)](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/006e8a46315c14d52b0928d60c4ad816.png)

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

```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`.

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

![Список провайдеров Codex: профиль RouterAI активен (In use)](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/17426cde76724c2702fe6d659600df34.png)

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

```toml
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](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/README.md).

## Выбор модели

Идентификаторы проверены по [каталогу RouterAI](/models); цены и актуальный список смотрите там же. Для агентов важна поддержка вызова инструментов (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`:

```bash
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](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/dc0d6813702447620cfbff97a64ae367.png)

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

![Codex через профиль CC Switch: provider custom, модель anthropic/claude-sonnet-5.5, ответ OK](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/db4d126df279ef9e246a3f4fdd3bb520.png)

Вернуться к официальному входу можно, включив в списке карточку **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`. Сверьтесь с [каталогом](/models).

### 401 Unauthorized

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

### 402 Payment Required

На балансе недостаточно средств — пополните его в разделе [Биллинг](/settings/billing).

### 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 пока не поддерживается.

## Что дальше

- [Каталог моделей](/models) — подберите модель под задачу
- [Вайб-кодинг в Claude Code](/pages/vibe-coding-claude-code) и [Вайб-кодинг в Codex](/pages/vibe-coding-codex) — настройка агентов без CC Switch
- [Вайб-кодинг в OpenCode](/pages/vibe-coding-opencode) — ещё один агент для того же профиля
- [Herdr: Claude Code и Codex в панелях](/pages/herdr-desktop-ai-agents-routerai) — десктоп для нескольких агентов
- [Руководство CC Switch](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/README.md) — маршрутизация, failover, MCP и Skills

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