OmniRoute на практике: зачем AI-шлюз на 352 модели и как едино вызвать Claude Code, Codex и Cursor

Когда в одну неделю открыты Claude Code, Codex и Cursor, время чаще уходит не на «найти модель сильнее», а на три ключа, три Base URL и три временные схемы после обрыва квоты. Польза OmniRoute на практике — свернуть эти входы в один локальный AI Gateway и уже потом решить, какие модели достойны дневного профиля.

Цифра: в публичных материалах OmniRoute v3.8.50 — 352 провайдера и около 1 312 уникальных ID чат-моделей. Это не «ровно 352 модели». Заголовочные 352 — ширина доступа. Приёмка спрашивает, выдержит ли один endpoint Claude Code, Codex и Cursor без нового env-файла каждый день. (GitHub: OmniRoute)

Вывод: сначала единый вход, потом счёт моделей. Если вы уже прыгаете между тремя агентами и их переменными, 30 минут приёмки окупятся. Один официальный тариф и почти нет обрывов квоты — не добавляйте шлюз из-за картинки с числом 352.

Текст для тех, кто держит Claude Code и Cursor вместе; для небольших команд, которым нужны Codex CLI и редактор на одном токене; и для тех, кто лучше поставит шлюз на облачный Mac, чем соберёт его на каждом ноутбуке.

Обновлено 11 сентября 2026. Размеры каталога — публичные цифры того дня; перед внутренней вики сверьте живой вызов /v1/models.

Что на самом деле значит 352

Сниппеты поиска сжимают «352 providers» в «352 модели». Более осторожное чтение README и omniroute.online такое:

• 352 — число зарегистрированных провайдеров; примерно 150 с флагом бесплатного обнаружения.
• Чат-каталог — 1 200+ ID моделей (около 1 312 рядом с v3.8.50).
• Бесплатные лимиты, OAuth, локальные модели и облачные каталоги имеют разные знаменатели. Не складывайте их в продажную цифру.

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

OmniRoute — самостоятельно размещаемый AI-шлюз под MIT. Локальный порт по умолчанию — 20128. Инструменты бьют в localhost; шлюз маршрутизирует по каталогу, квоте и откату. Публичный сайт сравнивает его с другими роутерами по числу провайдеров, политике отката, сжатию токенов и CLI-настройке — не по новому окну чата.

Каталог удобнее видеть полкой, шлюз — кладовщиком. Полка может быть длинной; кладовщик каждый день отгружает несколько рядов. 352 описывает ширину полки. Дневной профиль описывает правила отгрузки. Если перепутать одно с другим, «мы достучались до многих моделей» принимают за «у нас уже есть рабочий кодировочный контур».

Зачем трём инструментам один шлюз

1. Протоколы разные. Claude Code говорит Anthropic Messages, Codex — OpenAI Chat Completions, Cursor хочет OpenAI-совместимый URL. Без шлюза в голове остаются три модели.
2. Ключи разъезжаются. Anthropic в Claude Code, OpenAI в Codex, третий агрегатор в Cursor. Ротация и увольнение превращаются в угадайку.
3. Квоты не синхронизируются. Claude встал — Cursor всё ещё бьёт в официальный API. Бесплатный пул Codex кончился — редактор не знает.
4. Имена не переиспользуются. Один и тот же DeepSeek или GLM может иметь три ID. Непонятно, разрыв в качестве от модели или от написания.

Шлюз не сольёт три продукта в один. Он сольёт вопрос «какую переменную править». Для небольшой команды это ближе к ежедневной работе, чем ещё один сайт-агрегатор.

Если на том же хосте нужны ещё MCP и серверы инструментов, держите полосы раздельно. Внутренняя заметка про развёртывание MCP-сервера на облачном Mac mini — путь инструментов; OmniRoute — путь моделей. Не отлаживайте оба в одном процессе.

Мы ещё спрашиваем, делят ли три инструмента общий язык отказа. Если Claude Code уходит в таймаут, Codex отдаёт 429, а Cursor показывает только «provider error», и в журнале шлюза нет общего имени провайдера и ID модели, прыжок почти ничего не дал эксплуатации. Единый вызов — не три одинаковых интерфейса, а один человек, который объясняет один сбой по одному журналу.

Как три инструмента сходятся в один вход

Официальные документы дают команды omniroute setup-*: прочитать живой каталог и записать собственный конфиг каждого инструмента. (CLI Integrations)

Для демонстрации omniroute run claude или omniroute run codex подставляют окружение в один процесс. Это годится для скриншота, не для общей рабочей станции.

Claude Code при открытии каталога шлюза обычно фильтрует нативный /model до ID, которые начинаются с claude или anthropic. Kimi, GLM и DeepSeek по-прежнему идут через профиль или ANTHROPIC_MODEL; их просто нет в этом списке. (Настройка Claude Code)

Приёмка пройдена, если запросы всех трёх инструментов видны в консоли OmniRoute, сбой называет провайдера, а смена модели не требует трёх кабинетов вендоров.

На первой сборке отделите «оно отвечает» от «это можно в день». Ответ доказывает только открытый порт. Ежедневность требует одну и ту же короткую задачу в трёх инструментах, сбой с ID модели в журнале шлюза и смену профиля без трёх экскурсий по GUI. Победу часто объявляют на первом ответе, а потом выясняется, что Cursor всё ещё на официальном API, у Claude Code лишний /v1, а профиль Codex живёт только в одной вкладке терминала.

Приёмочный список на 30 минут

• [ ] Node.js установлен, omniroute запускается на Mac, который останется включённым.
• [ ] http://localhost:20128 показывает каталог, не пустую страницу.
• [ ] /v1/models с ключом шлюза возвращает живое число. Не копируйте маркетинговую цифру.
• [ ] Сначала один инструмент — Claude Code или Codex, не все три.
• [ ] Отправьте короткую повторяемую задачу и прочитайте журнал: ID модели, задержка, класс ошибки.
• [ ] Отключите предпочтительную модель и посмотрите, сработал ли откат.
• [ ] Подключите второй инструмент и убедитесь, что каталог тот же, а не частный список псевдонимов.
• [ ] Ключи вендоров остаются на шлюзе. В инструментах — только токен шлюза.

Если каталог так и не загрузился, 352 — плакат. Если каталог огромный, а откат не случается, вы добавили прокси и единую точку отказа.

Зафиксируйте короткую задачу. «Перечислить тестовые файлы в папке и объяснить одну функцию» достаточно. Открытая болтовня — слабая приёмка: не видно ни ошибочного ID, ни того, пошла ли смена инструментов по той полосе, о которой вы думаете. Оставьте строку: время, инструмент, ID модели, откат да/нет, сырая ошибка. Через две недели эта таблица скажет, сломало ли шлюз обновление или просто исчез бесплатный провайдер.

Когда внедрять, когда не стоит

Сжатие токенов (проект говорит о 15–95% экономии) — не печатный станок по умолчанию. Оно помогает длинным репозиториям и повторяющемуся контексту; на коротком дополнении может лишь добавить преобразование. Включите и выключите на одной задаче и сравните качество и счёт.

Маршрутизация не чинит сломанный JSON вызова инструментов. Если агенты падают на аргументах, сначала прочитайте почему ИИ-агентам нужен JSON, а потом добавляйте ещё один прыжок.

Есть и непарадная причина отказаться: никто не дежурит. Шлюз становится новой единой точкой отказа. Закрытая крышка, упавший процесс, просроченный сертификат или смена API каталога останавливают все три инструмента сразу. Если машине нельзя дать политику перезапуска и снимок, удобство одного входа сотрёт общий простой. Сначала дежурство, потом 352.

Почему шлюз ставят на облачный Mac

Шлюз на ноутбуке годится одному человеку. Как только Cursor, Claude Code и CI-хост делят каталог, сервис исчезает вместе с крышкой. Облачный Mac, который не гаснет, умеет снимки и умеет отзывать доступ, — более подходящий дом.

• Держите процесс под launchd или равным супервизором.
• Открывайте 20128 только в тоннеле или частной сети. Консоль в интернет не публикуйте.
• Ключи — на машине, не в git и не в чатах.
• Перед обновлением снимайте снимок, чтобы откатить смену каталога.

Mac здесь не «более дорогая модель». Это точка встречи, которой три инструмента пользуются, когда ноутбук спит. Разделение доступа смотрите на странице поддержки Mac ZekVPS; учётная запись шлюза не должна быть администратором хоста.

Для двоих и больше мы предпочитаем один хост шлюза плюс редактор у каждого, а не шлюз на каждый ноутбук. Второй вариант выглядит изолированнее и копирует маршруты, логику бесплатного пула и обновления трижды. Цена общего шлюза — более жёсткая граница: коллеги получают токен шлюза, не ключи апстрима и не правят боевые маршруты. Когда линия записана, 352 провайдера перестают быть 352 способами промахнуться кликом.

Частые вопросы

Сначала единый вход, потом шире каталог

OmniRoute — не соревнование выходного дня на 1 300 моделей. Это способ не крутить три почти просроченных ключа, уходить в откат вместо простоя и сравнивать модели по одному журналу. 352 описывает ширину, не ваш профиль по умолчанию.

Когда личный опыт сошёлся, шлюз обычно переносят на облачный Mac со снимками, чтобы редакторы коллег смотрели в тот же вход. Границы хоста сверьте на странице сервиса ZekVPS и уже потом решайте: ноутбук или удалённый узел.

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