Claude Code Router — единый шлюз для маршрутизации запросов кодинг-агентов

Claude Code Router (CCR) — это локальный AI-шлюз и панель управления для кодинг-агентов. Агент подключается не напрямую к провайдеру, а к стабильному локальному адресу http://127.0.0.1:3456. CCR принимает запрос и пересылает его тому провайдеру, модели и аккаунту, которые вы выбрали. Сменить провайдера можно в любой момент — конфигурация агента при этом не меняется.

Проект написан на TypeScript. Он распространяется тремя способами: десктоп-приложение для macOS, Windows и Linux, npm-пакет и Docker-образ. Лицензия — MIT.

Зачем нужен шлюз

У каждого кодинг-агента своя конфигурация модели. Когда агентов несколько, а провайдеров ещё больше, настройка превращается в рутину. Ключи раскиданы по файлам, смена модели требует правки конфигов, а сбой провайдера останавливает работу. CCR закрывает эти проблемы:

• Все агенты и провайдеры в одном месте. Не нужно настраивать модели отдельно для каждого клиента.
• Смена провайдера без смены привычек. Рабочий процесс остаётся прежним, конфиги агентов не редактируются.
• Запросы не отваливаются. Ретраи, пулы ключей, ротация ключей и упорядоченные fallback-модели.
• Расширение возможностей моделей. Vision через Fusion, веб-поиск, MCP-инструменты и ToolHub.
• Полная наблюдаемость. Логи запросов, выбранные маршруты, задержка, расход токенов, оценка стоимости и статус аккаунтов.

CCR понимает протоколы OpenAI Chat / Responses, Anthropic Messages и Gemini Generate Content / Interactions. Также есть готовые пресеты для OpenRouter, DeepSeek, SiliconFlow, Moonshot, Kimi Code, Mistral, Z.AI, Bailian и любых совместимых провайдеров с собственным адресом.

Поддерживаемые агенты

CCR работает с десятью агентами и любыми совместимыми API-клиентами:

• Claude Code — CLI и приложение;
• Codex — CLI и приложение;
• Grok CLI;
• Kimi CLI;
• Kilo Code;
• OpenCode — CLI и приложение;
• Pi;
• ZCode — приложение;
• Claude Design — приложение;
• WorkBuddy — приложение.

Быстрый старт

Десктоп-приложение

Самый простой путь — скачать готовое приложение для своей ОС со страницы релизов. Дальше пять шагов:

1. Откройте Providers → Add Provider. Выберите готовый пресет или укажите свой адрес, введите API-ключ, выберите протокол и модели, сохраните.
2. Откройте раздел Server и нажмите Start. Локальный шлюз начнёт слушать http://127.0.0.1:3456.
3. В разделе Agent Config выберите агента, назначьте ему модель и примените профиль.
4. Работайте с агентом как обычно.
5. Загляните в Logs. Там видно, какой провайдер и модель обработали запрос, статус, токены, задержку и ошибки.

Для условий маршрутизации, ретраев, перезаписи запросов и fallback-моделей откройте раздел Routing.

CLI

Npm CLI требует Node.js 22 или новее. CLI запускает тот же шлюз и веб-интерфейс управления — без Electron:

npm install -g @musistudio/claude-code-router
ccr ui

Управление доступно на http://127.0.0.1:3458. Шлюз остаётся на порту 3456. Дальше та же цепочка: Providers → Server → Agent Profiles. Сервисные режимы, аутентификация и команды профилей описаны в справочнике по CLI.

Docker

npm run docker:compose:up

Docker открывает интерфейс управления и маршруты шлюза на http://127.0.0.1:3458. Если планируете выставлять CCR наружу, сначала прочитайте гайд по развёртыванию.

Как это устроено

Claude Code · Codex · Grok CLI · Kimi CLI · Kilo Code · OpenCode · Pi · ZCode · WorkBuddy
                                   │
                                   ▼
                      Claude Code Router :3456
           Профили · Маршрутизация · Ключи · Инструменты · Логи
                                   │
                                   ▼
                  Выбранный провайдер, модель и аккаунт

Агент уверен, что общается со своим обычным API. На самом деле запрос принимает CCR. Он проверяет условия, применяет правила и пересылает запрос выбранному провайдеру. Ответ возвращается по той же цепочке.

Маршрутизация запросов

Маршрутизация — центральная функция CCR. Правила задаются в интерфейсе и применяются к каждому запросу:

• Условия срабатывают на заголовках и теле запроса. Например, длинные запросы можно отправлять одной модели, а короткие — другой.
• Префиксы и перезапись меняют запрос до отправки провайдеру.
• Ретраи повторяют неудачные запросы автоматически.
• Упорядоченные fallback-модели включаются, если основная модель недоступна. Список моделей обходится по порядку.

Инструменты и расширения

CCR добавляет моделям то, чего у них нет «из коробки»:

• Fusion-модели — добавляют vision к текстовым моделям.
• Веб-поиск — даёт модели доступ к свежим данным.
• MCP-инструменты и ToolHub — подключают внешние инструменты через протокол MCP.
• Автоматизация браузера — встроена в шлюз, плюс есть импорт сессии из Chrome для авторизованных сайтов.
• Плагины шлюза, локальные маршруты и виртуальные модели — для нестандартных сценариев.

Ключевые возможности

Кому подойдёт

• Тем, кто работает с несколькими агентами. Все модели настраиваются в одном окне, а не в десятке конфигов.
• Тем, кто хочет снизить затраты. Дешёвая модель для рутины, дорогая — для сложных задач, и переключение одним профилем.
• Тем, кому нужна надёжность. Ретраи и fallback-модели не дадут рабочему дню остановиться из-за сбоя одного провайдера.
• Тем, кто хочет видеть картину целиком. Логи показывают, сколько токенов и денег ушло на каждый запрос.

Документация

Полная документация живёт на отдельном сайте ccrdesk.top. Основные разделы:

• Установка и запуск
• Настройка провайдеров
• Маршрутизация и конфигурация
• Справочник по CLI
• Развёртывание в Docker
• Решение частых проблем

Лицензия

Проект распространяется по лицензии MIT.