С чего начать в соцсетях→
Вайбкодинг

Claude Code Router: тот же Claude Code на моделях Gemini, DeepSeek, OpenRouter и своей

Claude Code Router ставит между Claude Code и моделью свой шлюз. Интерфейс остаётся тем же, а запросы уходят туда, куда ты скажешь: в Gemini, DeepSeek, OpenRouter, Kimi или в модель на своём компьютере. Ниже установка точными командами, подключение провайдеров, запасная модель на случай лимита, проверка, что всё реально работает, честный разбор, чего роутер не даёт, и чинилка типовых ошибок.

Факты сверены 23 сентября 2026 года с официальным репозиторием musistudio/claude-code-router (лицензия MIT, около 37 тысяч звёзд, последний коммит 20 сентября) и с пакетом в npm версии 3.1.1. Для консольной версии нужен Node.js 22 или новее.

Сначала прочитай первый раздел, он за две минуты ставит правильные ожидания. Потом иди по установке сверху вниз, копируя команды блоками. После настройки обязательно прогони проверку из шестого раздела: без неё ты не узнаешь, на какой модели сидишь на самом деле.

1. Что это такое и чего от него ждать

Роутер меняет модель за интерфейсом. Сам Claude Code, твои папки, команды и привычный порядок работы остаются прежними.

Claude Code по умолчанию разговаривает только с моделями Anthropic и упирается в лимиты твоей подписки. Claude Code Router поднимает у тебя на компьютере локальный шлюз по адресу 127.0.0.1:3456 и подсовывает его Claude Code вместо серверов Anthropic. Дальше шлюз сам решает, в какого провайдера отправить запрос, повторяет его при сбое и переключается на запасную модель, если основная упёрлась в лимит.

Что ты получаешь

Тот же Claude Code, но с выбором модели: дешёвая для рутины, сильная для сложной задачи, запасная на случай лимита. Логи каждого запроса, расход токенов и оценку стоимости в одном окне.

Чего ты не получаешь

Бесплатного безлимитного Claude. Бесплатные маршруты ведут на модели других компаний, у которых свои лимиты и своё качество. Модели Anthropic через роутер по-прежнему оплачиваются.

Где это реально выгодно

Рутина, которая съедает лимит подписки: правки текстов, мелкие скрипты, разбор файлов, черновики. Её отдаёшь дешёвой модели, а подписку бережёшь под сложные задачи.

Claude Code заточен под модели Anthropic. Другие модели справляются с его инструментами хуже: чаще ошибаются в правке файлов и дольше думают над многошаговой задачей. Поэтому сначала проверяешь модель на маленькой задаче из шестого раздела и только потом отдаёшь ей настоящую работу.

2. Установка, десять минут один раз

Есть два пути. Приложение для Windows, macOS и Linux ставится как обычная программа. Консольная версия ставится одной командой и подходит, если ты уже работаешь в терминале.

Путь А. Приложение

Открой страницу релизов в репозитории и скачай файл под свою систему: .exe для Windows, .dmg для Mac на Apple Silicon, .AppImage для Linux. Установи и запусти, дальше всё настраивается мышкой в том же порядке, что и в пути Б.

Страница релизов Claude Code Router

Путь Б. Консоль

Сначала проверь версию Node.js. Нужна 22 или новее. Если меньше или команды нет вовсе, поставь версию LTS с сайта nodejs.org и открой новое окно терминала.

Проверка Node.js
node --version
Установка роутера и проверка, что команда появилась
npm install -g @musistudio/claude-code-router ccr --help
Запуск панели управления в браузере
ccr ui

Откроется панель по адресу 127.0.0.1:3458. Сам шлюз для моделей живёт рядом, на 127.0.0.1:3456. Если какой-то порт занят, роутер возьмёт следующий свободный и напишет в терминале настоящий адрес.

Ссылка на панель содержит служебный токен ccr_web_token. Относись к ней как к паролю: не вставляй в чаты, не показывай на скриншотах и в записях экрана.

3. Провайдеры: где взять модель и ключ

Роутер понимает форматы OpenAI, Anthropic, Gemini, OpenRouter, DeepSeek, Moonshot (Kimi), Mistral и любые совместимые. Ниже четыре рабочих варианта с разной ценой.

OpenRouter

Один ключ открывает сотни моделей разных компаний. Часть моделей помечена :free, на них действует суточный лимит запросов. Лимиты меняются, актуальные смотри на странице лимитов OpenRouter перед тем, как строить на них работу.

Gemini

Ключ выдаётся в Google AI Studio, у API есть бесплатный уровень с ограничением запросов в минуту и в сутки. Запросы на бесплатном уровне Google может использовать для улучшения своих продуктов, это прописано в условиях.

DeepSeek

Платно, но недорого: оплата за токены с пополняемого баланса. Хорош для кода и рутины, когда бесплатных лимитов уже не хватает.

Своя модель на компьютере

Через Ollama модель работает у тебя локально, бесплатно и без отправки кода наружу. Цена этому мощность твоего компьютера: слабый ноутбук потянет только маленькие модели.

Часть провайдеров не принимает российские карты или не отвечает на российские адреса. Проверь регистрацию и первый запрос до того, как строить на провайдере рабочий процесс.

Ключи храни в самом роутере и нигде больше. Не вставляй их в промпты, в файлы проекта и в переписку с моделью.

4. Настройка в панели, строго по порядку

Порядок взят из официальной документации. Если перепутать шаги, Claude Code не найдёт шлюз.

  1. Providers. Добавь провайдера из готового списка или свой адрес, вставь ключ и выбери хотя бы одну модель. Нажми проверку связи, пока не увидишь успешный ответ.
  2. API Keys. Создай ключ клиента для шлюза. Это отдельный ключ, он защищает доступ к шлюзу и не совпадает с ключом провайдера.
  3. Модель по умолчанию и маршруты. Назначь основную модель, а ниже порядок запасных, к которым роутер перейдёт при лимите или сбое.
  4. Server. Убедись, что шлюз запущен, и запомни его адрес.
  5. Agent Profiles. Создай профиль для Claude Code: укажи шлюз, ключ клиента и нужную модель. Имя профиля придумай короткое, например claude-deepseek.
Запуск Claude Code через профиль
ccr claude-deepseek

Вместо claude-deepseek подставь имя своего профиля. Если пользуешься приложением, готовую команду запуска можно скопировать прямо с карточки профиля, там она называется ccr-app.

5. Запасная модель, чтобы лимит не останавливал работу

Ради этого роутер и ставят. Основная модель упёрлась в лимит, запрос сам уходит к следующей.

  1. Основная модель: та, на которой хочешь работать большую часть времени. Например, сильная модель через OpenRouter.
  2. Первая запасная: другой провайдер, чтобы общий сбой одного сервиса не положил обе. Например, DeepSeek.
  3. Последняя запасная: локальная модель через Ollama. Она слабее, зато не зависит ни от интернета, ни от чужих лимитов.
  4. Повторы: одна-две попытки перед переходом к запасной. Больше ставить незачем, лимит повтором не лечится.
Открой в панели журнал запросов. Там видно, какой провайдер и какая модель фактически ответили на каждый запрос. Если все ответы идут от одной модели, запасные не настроены или ни разу не понадобились.
С чего начать в соцсетях

6. Проверка на маленькой задаче

Пять минут, которые экономят вечер. Проверяешь, что модель справляется с инструментами Claude Code, до того, как отдать ей проект.

Тестовое задание для новой модели, вставь в Claude Code в пустой папке
Создай в этой папке файл test_router.py с функцией, которая принимает список чисел и возвращает среднее, медиану и максимум. Потом создай файл test_test_router.py с тремя тестами на эту функцию, включая пустой список. Запусти тесты командой python -m pytest -q и покажи результат. Если тест упал, исправь код и запусти снова. В конце одной строкой напиши, сколько тестов прошло.
  • Модель создала оба файла сама и запустила тесты: годится для работы с кодом.
  • Модель описала код текстом, но файлы не создала: с инструментами Claude Code она не дружит, оставь её для разговоров и черновиков.
  • Модель зациклилась на исправлениях: слишком слабая для многошаговых задач, поставь её последней в список запасных.

7. Что нельзя гнать через чужие модели

Всё, что уходит через роутер, попадает к выбранному провайдеру. На бесплатных уровнях запросы часто используются для обучения.

  • Файлы .env, ключи, пароли, токены. Перед работой через стороннюю модель проверь, что их нет в папке проекта.
  • Персональные данные клиентов: имена, телефоны, переписки, выгрузки из CRM.
  • Код и документы, которые ты по договору обязан держать в тайне.
  • Финансовые таблицы и всё, что ты не готов увидеть в чужом датасете.

Для таких задач держи отдельный профиль на модели Anthropic по твоей подписке или локальную модель через Ollama. Роутер позволяет держать несколько профилей одновременно, переключение занимает одну команду.

8. Чинилка типовых ошибок

ccr: command not found

Установка прошла, а команды нет. Выполни npm prefix -g, проверь, что эта папка есть в PATH, и открой новое окно терминала.

Панель открылась, а модель не отвечает

Проверь на странице Server, что шлюз запущен, и нажми проверку связи у провайдера. Чаще всего дело в неверном ключе или в модели, которую провайдер не отдаёт на твоём тарифе.

Адрес панели сменился

Порт 3458 был занят, роутер взял следующий. Настоящий адрес всегда печатается в терминале после ccr ui или ccr start.

Профиль не найден

Имя в команде не совпадает с именем в Agent Profiles или профиль выключен. Скопируй имя из панели дословно.

Фоновый шлюз не останавливается

Команда ccr stop останавливает службу, запущенную через ccr ui или ccr start. Если запускал через ccr serve, останови его в том же окне сочетанием Ctrl+C.

Обновление и удаление
npm install -g @musistudio/claude-code-router@latest npm uninstall -g @musistudio/claude-code-router
Удаление пакета не стирает настройки и базы роутера. Если хочешь убрать всё начисто, удали и папку конфигурации, её путь указан в документации в разделе Configuration and data locations.
Официальная документация Claude Code Router
Следующий шаг
Хочешь так же, но под свой блог и продукт?

Я собрал систему, по которой обычный человек запускает блог с нуля и набирает аудиторию без съёмок, монтажа и команды. Внутри разбор, с которого стартовал сам.

Открыть разбор: с чего начать→