Туториал Claude Code Router: подключаем Claude Code к DeepSeek, Gemini и любой модели
Опенсорсный роутер сохраняет привычный опыт Claude Code, но направляет каждый запрос более дешёвым моделям — DeepSeek, Kimi, Gemini или локальной модели Ollama. Установка через npm, настройка провайдеров в консоли ccr ui, маршрутизация по сценариям и проверка реальной задачей. 15 шагов со скриншотами.
Коротко: что делает Claude Code Router
- Claude Code Router (CCR) — бесплатный опенсорсный прокси: Claude Code сохраняет интерфейс, системный промпт и инструменты, а вызовы модели уходят туда, куда вы укажете — DeepSeek, Kimi K2, Gemini, OpenRouter или локальную модель Ollama.
- Установка — одна npm-команда (npm install -g @musistudio/claude-code-router), а веб-консоль ccr ui сама правит ~/.claude-code-router/config.json — JSON руками редактировать не нужно.
- Маршрутизация идёт по сценариям: default, background, think (рассуждения в Plan Mode), longContext (включается автоматически после порога в 60 000 токенов) и webSearch — каждому слоту своя модель.
- ccr code запускает сессию через роутер с базовым URL http://127.0.0.1:3456; обычная команда claude работает как раньше. Известная особенность: /cost остаётся на $0 — расходы смотрите в панели провайдера.
Claude Code Router: Use Gemini 2.5 Pro FREE API in Claude Code
Видео-первоисточник:AI With Nathan10:52
claude-code-router — official README
Факты о продукте:musistudio on GitHubDocs
Шаги и скриншоты следуют видео; названия полей config.json, роли роутера и поведение transformer сверены с официальным README.
Кадры — атрибутированные скриншоты из исходного видео, каждый со ссылкой на свой таймкод. Текст гайда оригинальный — это не транскрипт.
Настраиваем Claude Code Router шаг за шагом
1 · Направляем Claude Code на более дешёвые модели
- 1
Почему Claude Code нужен роутер
Claude Code привязан к моделям Claude, а они недёшевы: Opus 4.1 официально стоит $15 за миллион входных токенов и $75 за миллион выходных. Опенсорсный проект Claude Code Router (CCR) сохраняет опыт Claude Code, но направляет каждый запрос выбранной модели — DeepSeek, Kimi, Gemini или локальной Ollama.
Официальные тарифы Anthropic до перехода — вот счёт, которого помогает избежать CCR.Смотреть на 0:30 - 2
Установите Claude Code, затем роутер
CCR предполагает, что Claude Code уже установлен: npm install -g @anthropic-ai/claude-code. Затем установите роутер: npm install -g @musistudio/claude-code-router. Конфигурация провайдеров будет жить в ~/.claude-code-router/config.json.
Две npm-установки из официального README — роутер никогда не заменяет Claude Code.Смотреть на 3:36 - 3
Дождитесь окончания глобальной установки
npm подтягивает зависимости роутера (предупреждение о deprecated node-domexception — это нормально). После завершения команда ccr доступна везде.
npm скачивает пакеты во время глобальной установки @musistudio/claude-code-router.Смотреть на 3:49
2 · Добавляем провайдеров в консоли ccr ui
- 4
Откройте консоль настройки через ccr ui
Вместо ручного редактирования JSON запустите ccr ui. В браузере откроется вкладка на 127.0.0.1:3456: слева управляются провайдеры, справа секция Router раздаёт модели по сценариям, ниже — Custom Transformers.
Первый запуск консоли ccr ui — провайдеры пусты, слоты роутера ждут.Смотреть на 4:08 - 5
Добавьте провайдера из шаблона
Нажмите Add Provider и выберите шаблон — в видео используется OpenRouter; пресеты есть и для deepseek, gemini, dashscope, modelscope, siliconflow и volcengine. Шаблон сам подставит API URL и список моделей по умолчанию, а transformer можно оставить пустым.
Шаблоны провайдеров в ccr ui — выберите один, и URL с моделями подставятся сами.Смотреть на 4:30 - 6
Вставьте API-ключ и выберите модели
По-настоящему важны три поля: API URL (уже подставлен), секретный ключ и список моделей. В видео под OpenRouter добавляются DeepSeek R1 и Kimi K2, затем сохранение — провайдер появляется в левой панели, готовый к назначению.
Форма Edit Provider: URL, ключ, модели — всё остальное может остаться по умолчанию.Смотреть на 4:53 - 7
Разницу API пусть закрывают transformer'ы
Transformer'ы переписывают тело запроса и ответа, чтобы сторонние API оставались совместимыми с Claude Code. В CCR есть разумные дефолты — например, transformer deepseek для api.deepseek.com и tooluse для deepseek-chat — свой писать почти никогда не приходится.
Примеры глобальных и модельных transformer'ов из README, включая пресет DeepSeek.Смотреть на 3:54 - 8
Добавьте бесплатный ключ Gemini для задач с рассуждениями
Добавьте второго провайдера из шаблона Gemini и создайте бесплатный API-ключ в Google AI Studio (Get API key → Create API key). Вставьте, сохраните — скоро вы назначите этого провайдера слотам think, longContext и webSearch.
Создание бесплатного API-ключа Gemini в Google AI Studio для провайдера CCR.Смотреть на 5:45
3 · Задаём правила маршрутизации
- 9
Разберитесь в пяти ролях роутера
default обслуживает общие задачи (и всё, что вы не назначили). background выполняет фоновые задания — здесь маленькая или локальная модель экономит деньги. think берёт на себя тяжёлые рассуждения вроде Plan Mode. longContext включается автоматически после longContextThreshold (по умолчанию 60 000 токенов), а webSearch требует модель с поддержкой функции — в OpenRouter добавьте :online к имени модели. /model переключает модель прямо посреди сессии.
Объект Router в README: все роли, порог 60K и суффикс :online.Смотреть на 1:06 - 10
Назначьте модель каждому сценарию
В секции Router выбирайте из моделей сохранённых провайдеров: в видео DeepSeek R1 становится default, Kimi K2 — для повседневных задач, Gemini 2.5 Pro (окно в 1 млн токенов) — longContext, а быстрый Gemini Flash — webSearch. По завершении нажмите Save and Restart в правом верхнем углу.
Заполнение слота Default моделью deepseek/deepseek-r1-0528 из сохранённого провайдера.Смотреть на 5:15 - 11
Запустите сессию через роутер командой ccr code
Вернитесь в терминал и запустите ccr code. На приветственном экране Claude Code появится Overrides (via env) — API Base URL http://127.0.0.1:3456 — доказательство, что запросы теперь идут через роутер. Обычная команда claude по-прежнему запускает сессию без роутера, ничего удалять не нужно.
Блок Overrides на приветственном экране: ваш трафик идёт через локальный прокси CCR.Смотреть на 6:45
4 · Запускаем реальную задачу и проверяем
- 12
Дайте ему реальную задачу по коду
Пишите промпт как обычно — в видео просят неоновый арканоид с современной анимацией. Claude Code планирует список задач и выполняет его шаг за шагом через маршрутизированные модели. Возможны косметические странности: счётчик входных токенов может застыть на нуле.
Claude Code проходит свой список задач, пока CCR направляет вызовы модели.Смотреть на 7:06 - 13
Проверьте готовый результат
Агент завершает сводкой функций — визуальные эффекты, адаптивность, управление, игровая механика — а файлы ложатся в проект (index.html, style.css, script.js). Откройте HTML в браузере и проверьте результат сами.
Итоговая сводка Claude Code по неоновому арканоиду.Смотреть на 7:30 - 14
Сверьте реальное использование в панели провайдера
Страница Your Activity в OpenRouter — источник истины: там видны маршрутизированные вызовы — повторяющиеся запросы Kimi K2 и вызов DeepSeek — с количеством токенов и расходами. Так вы убедитесь, что CCR действительно использует ваши дешёвые модели.
Использование OpenRouter после сессии: маршрутизированные модели с реальными счётчиками запросов.Смотреть на 7:45 - 15
Знайте о шероховатостях, прежде чем полагаться на него
Команда /cost в маршрутизированной сессии показывает $0.0000, а статистика по моделям — claude-sonnet с нулями: учёт стоимости пока не подключён к внешним провайдерам. Сам роутинг работает исправно; расход пока сверяйте в панели провайдера.
Известный дефект /cost в маршрутизированных сессиях — панели провайдеров остаются вашим реальным счётчиком.Смотреть на 9:25