cc-switch + TheRouter.ai

Управляйте несколькими coding clients через одну routing key, а не через набор разрозненных локальных конфигов.

cc-switch полезен, когда команда переключается между Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw, но хочет единый desktop control plane для provider presets. TheRouter хорошо сочетается с этим сценарием, потому что одна tenant routing key может обслуживать все эти клиенты, сохраняя маршрутизацию, failover и биллинг в одном месте.

Когда эта страница действительно нужна

Выбирайте этот путь, если вы администрируете несколько локальных coding clients или хотите workflow на основе presets. Если команде нужен только один инструмент, отдельный гид по Cursor или Claude Code обычно быстрее.

1. Сначала создайте routing key в TheRouter

Сначала создайте tenant API key в dashboard. Именно эту key вы вставите в cc-switch. Не используйте management key.

text

Dashboard → API Keys
Create Key
Сразу скопируйте полный tenant key

Ожидаемый формат: sk-...

2. Выберите целевой клиент внутри cc-switch

В cc-switch сначала выберите приложение, которое вы хотите вести через TheRouter. Presets особенно полезны для этих целей:

text

Claude Code  → Anthropic-compatible путь TheRouter
Codex        → OpenAI-compatible путь TheRouter
Gemini CLI   → Gemini-native путь TheRouter
OpenCode     → OpenAI-compatible путь TheRouter
OpenClaw     → OpenAI-compatible путь TheRouter

3. Добавьте preset TheRouter

Откройте Add Provider, найдите TheRouter, вставьте key и активируйте preset. Если preset не отображается, обновите cc-switch до сборки с актуальными provider presets.

text

cc-switch → target app → Add Provider
Search: TheRouter
Paste: sk-...
Enable the preset
Restart the target CLI if required

4. Не перепутайте базовые URL по протоколам

cc-switch избавляет от ручного редактирования файлов, но не стирает протокольные границы. TheRouter использует разные стили base URL в зависимости от нативного клиента.

text

Claude Code preset:
  base URL = https://api.therouter.ai

Codex / OpenCode / OpenClaw preset:
  base URL = https://api.therouter.ai/v1

Gemini CLI preset:
  base URL = https://api.therouter.ai

5. Сначала проверьте цепочку, потом отлаживайте desktop app

Подтвердите, что key живая, а model aliases существуют, еще до того как начнете винить cc-switch или целевой CLI.

bash

curl https://api.therouter.ai/v1/models \
  -H "Authorization: Bearer $THEROUTER_API_KEY" | head -c 400

Затем перезапустите нужный CLI и выполните его самый короткий test request или status-check.

Частые ошибки

text

1. Используется management key вместо tenant routing key
2. Смешаны OpenAI-compatible и Anthropic-native base URL
3. После смены preset не перезапущен целевой CLI
4. От cc-switch ожидают автоматической правки неверного model alias
5. Команда продолжает использовать старые кэшированные model IDs после смены провайдера

cc-switch не делает все клиенты одинаковыми

cc-switch упрощает конфиг-менеджмент, но не превращает все инструменты в один API-протокол. Claude Code, Gemini CLI и OpenAI-compatible клиенты все равно должны использовать правильный preset TheRouter для своего нативного request shape.

Соседние setup-пути

Откройте соседний гид, если вам нужен точный client-level path, а не workflow через switcher.

Интеграция Cursor

Пошагово

Подключите Cursor к TheRouter через OpenAI-совместимый base URL, model aliases и проверку первого coding-запроса.

Открыть путь

Интеграция Claude Code

Пошагово

Запустите Claude Code через Anthropic-совместимый путь TheRouter — точные шаги вместо угадывания переменных окружения.

Открыть путь

Интеграция OpenClaw

Agent framework

Подключите OpenClaw к OpenAI-совместимому endpoint TheRouter и держите multimodal agent workflow под одним ключом.

Открыть путь

Хаб coding tools

Tool hub

Соберите в одной точке quick configs для Windsurf, Cline, Continue, OpenCode, OpenClaw и cc-switch.

Открыть путь

Что дальше

Английский оригинал

Если нужны точные оригинальные формулировки и полный контекст, откройте исходную страницу.

Открыть

Хаб coding tools

Хаб

Если вы еще выбираете между несколькими локальными клиентами, вернитесь к общей карте входа.

Открыть

Claude Code на русском

RU гид

Если вам не нужен switcher и вы ведете команду только через Claude Code, эта страница будет короче.

Открыть

Хаб coding tools

Дальше

Claude Code на русском