Когда такой запрос приходит в CCR, метка извлекается и удаляется, а запрос уходит на указанную в ней модель.
Ключ ко всему - поле описания на странице моделей. Оно работает одновременно выключателем и подсказкой: если описания не заполнены ни у одной модели, CCR ничего не вставляет, чтобы не писать в описания инструментов пустой список. Документация советует описывать модели через задачи, под которые они годятся, и приводит примеры формулировок - быстрая и дешёвая для поиска по коду и мелких правок, сильная для архитектуры и рискованного ревью, длинноконтекстная для больших логов и документов.
То есть выбор дешёвой модели на дешёвый шаг делается не правилом, а описанием, по которому агент выбирает сам.
Codex и заплатки
Второй механизм того же рода, но про совместимость.
У Codex есть свой инструмент правки файлов, устроенный необычно: он принимает не аргументы функции, а сырой текст заплатки. Многие сторонние модели, совместимые с OpenAI, с такими инструментами работают хуже, чем с обычными функциями.
CCR подменяет инструмент: наружу отдаёт обычную функцию с полем под заплатку и вкладывает в её описание полную грамматику формата. Когда модель отвечает, CCR переписывает ответ обратно в тот вид, которого ждёт Codex.
Оговорка честная и важная: файлы правит по-прежнему Codex, а не CCR. Для моделей с именами вида GPT подмена не применяется - они идут родным путём. И включается это не переключателем маршрута, а автоматически, по имени модели.
Наблюдаемость
Ради этого раздела инструмент и попал в тему про расход.
По каждому запросу видно, какой провайдер, какая модель и какой ключ в итоге выбрались, чем всё закончилось, сколько заняло, сколько токенов ушло, во сколько это оценивается и какие вызовы инструментов были внутри. Отдельно есть трассировка работы агента.
Это ровно то, чего не хватает при обычной работе: не общая цифра за месяц, а разбор одного запроса - почему пошло туда, куда пошло, и сколько это стоило.
Безопасность по умолчанию
Одна настройка стоит того, чтобы её знать.
Если ключ доступа к самому шлюзу не задан, адрес принудительно ставится в 127.0.0.1 - чтобы к вашему шлюзу с чужими ключами не подключился кто попало. Это записано в README открытым текстом.
Отдельно есть клиентские ключи к самому CCR: со своим сроком действия и локальными ограничениями на число запросов, токенов и изображений. То есть шлюз можно дать коллеге, не отдавая ключи провайдеров.
Что стоит знать заранее
Версии меняются очень быстро. Три релиза за август 2026 года, последний - 3.0.22 - вышел за день до того, как я это писал. Любая инструкция устаревает за недели.
Открытых обращений больше тысячи. На 25 августа 2026 года их 1091. Для проекта, который стоит между вашим агентом и деньгами, число заметное.
Требование к Node жёстче, чем кажется. В метаданных пакета стоит Node 22 и новее, и то же самое повторяет документация для командной строки.
Сборка под Windows делается только на Windows. В проекте есть встроенный модуль на нативном коде, поэтому упаковка настольного приложения под Windows требует Windows x64.
Проект живёт на спонсорах. Верх README занимает баннер спонсора, и его модели идут встроенной заготовкой провайдера. На работу это не влияет, но при выборе провайдера стоит помнить, чей баннер вы читаете.
Область захвата растёт. Кроме маршрутизации в третьей версии появились слияние моделей с добавлением зрения и поиска, хаб инструментов, автоматизация браузера, импорт состояния входа из Chrome и ретрансляция агента через мессенджеры - от Slack и Telegram до Feishu и DingTalk. Одни это назовут развитием, другие - расползанием.
Ошибки первого знакомства
Искать секцию Router в файле настроек. Это вторая версия. В третьей настройка через интерфейс, а конфигурация десктопа - в базе SQLite.
Путать порты. Шлюз моделей на 3456, интерфейс управления на 3458.
Открыть шлюз наружу, не задав ключ. Без ключа адрес принудительно локальный - и это защита, а не помеха.
Ждать, что подагенты сами возьмут дешёвую модель. Не возьмут, пока не заполнены описания моделей: без них механизм подстановки метки просто не включается.
Ставить через npm на Node 20. Нужен Node 22 или новее.
Считать, что CCR правит файлы за Codex. Не правит: он только переводит вызов инструмента туда и обратно.
Собирать настольное приложение под Windows на другой системе. Нативный модуль этого не позволит.
Брать инструкцию из статьи полугодовой давности. За это время сменилась мажорная версия и способ настройки.
Если свести к одной фразе: это уже не маршрутизатор, а пульт - и главная его ценность в том, что решение "какая модель на какой шаг" перестаёт быть разбросанным по конфигам каждого агента и становится одним видимым местом со счётчиком.
Источники
Статья сверена с репозиторием musistudio/claude-code-router (ветка main) 25 августа 2026 года: README, package.json, docs/src/content/docs/en/configuration.md, docs/src/content/docs/en/configuration/routing.md и дерево репозитория. Версия, звёзды, форки, число открытых обращений и дата последнего коммита сняты в тот же день через API GitHub и реестр npm. Проект недавно сменил мажорную версию: описания второй версии с правкой JSON-файла и своим маршрутизатором на JavaScript к текущей уже не относятся.
