OmniRoute для Claude Code: шлюз за 10 минут и три строки

Что нужно на входе

Три вещи, и ни одна не про деньги. Первая проверяется одной строкой в окне для ввода команд («Терминал» на Mac, «PowerShell» на Windows):

node --version

Ответ вида v20.x и выше подходит. Пусто или ошибка: сначала поставь Node с сайта nodejs.org, это обычная установка через мастера. Остальные две вещи в таблице.

Своей учётной записи шлюз не просит: он открытый, лицензия MIT, работает целиком на твоей машине.

Ставим шлюз: две команды

Первая команда скачивает и ставит шлюз. Вставь её в окно для ввода команд и нажми Enter:

npm install -g omniroute

Пойдут строки про скачивание пакетов. У меня установка началась в 13:28:39 и закончилась в 13:30:46, в конце шлюз напечатал, сколько всего пакетов подтянул:

added 1171 packages in 2m
3.8.50

Вторая команда запускает шлюз. Набери одно слово и нажми Enter:

omniroute

Через несколько секунд в окне появится рисунок из символов с названием проекта, а под ним главное: адрес панели и адрес, на который надо будет направить Claude Code.

  ✔ OmniRoute is running! (started in 7.3s)
    Dashboard:  http://localhost:20128
    API Base:   http://localhost:20128/v1

Dashboard это панель управления в браузере. API Base это вход, куда стучатся программы. Разница между ними решает половину всех проблем с подключением, к этому вернусь через два раздела.

Окно с этими строками закрывать нельзя: пока оно открыто, шлюз работает. Закроешь: шлюз остановится, и Claude Code перестанет получать ответы.

Мой прогон 21.09.2026 на macOS 25.3, среда Node v25.9.0, в отдельной папке (основной профиль я не трогал): установка шла с 13:28:39 до 13:30:46, подтянулось 1171 пакет, версия шлюза 3.8.50, на диске 2.6 ГБ. Сам шлюз поднялся за 7.3 секунды и занял порт 20128. Запрос без ключа шлюз завернул с кодом 401, то есть защита на входе работает сразу из коробки.

Панель: где взять ключ

Открой в браузере адрес http://localhost:20128. Это и есть панель, она живёт только у тебя на компьютере, наружу ничего не уходит.

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

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

Внутри нужны два пункта бокового меню.

Providers, подпись под ним Manage AI providers: сюда заводятся модели, которыми ты хочешь пользоваться. Список пустой, поэтому первая кнопка на экране так и называется Add your first provider, дальше та же кнопка живёт сверху как Add Provider. Порядок внутри такой:

• нажми Add Provider, в списке Select a provider выбери своего: у бесплатных рядом стоит метка Free
• в поле с подсказкой Enter your API key вставь ключ провайдера. Провайдеру, который работает без ключа, поле не нужно
• нажми Save Provider. Карточка появится в списке со статусом Active и числом подтянутых моделей строкой вида 12 models
• сомневаешься, что ключ рабочий: на карточке есть Test Connection. Ключ неверный, и статус переключится на Inactive, моделей у карточки не будет

Ключей пока нет: начни с бесплатных, у меня отдельно разобрано, как взять бесплатный ключ Gemini и ключи NVIDIA, обе процедуры занимают пару минут.

API Keys, подпись Manage API keys and access: вот здесь выдаётся ключ самого шлюза. Нажимаешь кнопку Create API Key, даёшь ключу любое имя, и он появляется на экране строкой, рядом кнопка Copy API Key. Копируй сразу: панель показывает ключ один раз, дальше в списке остаётся только маска, и при потере ключ не восстанавливают, а выпускают заново. Готовую пару «адрес входа плюс ключ» потом видно в пункте Endpoints, подпись Your AI connection URLs, поля там называются Base URL и API Key.

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

Три строки в настройках Claude Code

Claude Code читает настройки из файла settings.json в папке .claude внутри твоей домашней папки. Имя папки начинается с точки, поэтому в обычном окне её не видно. Как попасть внутрь:

• Mac: в Finder нажми Cmd+Shift+G, впиши ~/.claude и нажми Enter
• Windows: в адресной строке Проводника впиши %USERPROFILE%\.claude и нажми Enter

Файла settings.json в папке может не оказаться, это нормально для свежей установки: создай пустой файл ровно с таким именем и вставь в него весь блок целиком. Файл уже есть и в нём что-то написано: не затирай его, а добавь ключ env внутрь существующих фигурных скобок и поставь запятую между соседними ключами. Формат строгий: одна лишняя или пропущенная запятая, и Claude Code файл не прочитает, а настройки не применятся.

Открой этот файл в любом редакторе и добавь блок env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "сюда-твой-ключ-от-шлюза",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Разбор по строкам, потому что в каждой есть подвох.

Про хвост /v1 отдельно: Claude Code дописывает окончание сам, и если оно уже стоит, получается двойной путь и ответа не будет. Это самая частая причина, по которой шлюз «не подхватывается». Заготовку ключа в кавычках замени своим значением.

Настройки читаются один раз при запуске. Правишь файл при открытом Claude Code: закрой и открой заново, иначе он продолжит работать по-старому. И ещё одно: значение из файла настроек перебивает то же самое, выставленное командой в окне ввода, так что искать расхождение надо в файле.

Как убедиться, что запрос пошёл через шлюз

Признак один, и он на экране. Запусти Claude Code и набери:

/status

Откроется сводка, в ней найди строку Anthropic base URL. Если в ней стоит адрес твоего шлюза, запрос идёт через шлюз. Если там адрес Anthropic или строки нет вовсе, настройки не подхватились: смотри предыдущий раздел, начиная с хвоста /v1.

Второй способ, если хочется проверить сам шлюз отдельно от Claude Code. Вставь в окно ввода команд одну строку:

curl http://localhost:20128/v1/models

Шлюз без ключа отвечает отказом, и это правильный ответ, он означает, что шлюз жив и защита работает:

{"error":{"message":"Authentication required","type":"invalid_api_key","code":"invalid_api_key"}}
http=401

Тишина вместо ответа или отказ в соединении: шлюз не запущен, вернись к окну, где он работал.

Запасная модель на случай, когда лимит кончился

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

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

"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm/glm-5.2",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "kmc/kimi-k2.6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm/glm-4.7-flash"

Слева уровень сложности, справа имя модели у шлюза. Имена берутся из панели, там же видно, какие из них бесплатны. В примере стоят GLM на тяжёлые задачи и Kimi на обычные: обе дешёвые и обе понимают длинные разговоры. Годится и DeepSeek, если ты уже с ним работал.

Есть и четвёртая строка, она нужна не всем:

"OMNIROUTE_ROTATE_ON_400": "true"

Она разрешает шлюзу перепрыгивать на следующую цель не только при отказе по лимиту, но и когда модель отвечает «не понимаю такой запрос». Полезно, когда в списке запасных стоят модели разных семейств.

Одна честная оговорка. У меня в прогоне ни одного ключа провайдера заведено не было, и шлюз перебрал семь пар «провайдер-модель» из пула в тринадцать штук: первая попросила ключ, вторая ответила, что бесплатный тариф работает только внутри её собственного приложения, остальные уткнулись в лимит. Переезд между целями работает как задумано, но если ключей нет вообще, ехать некуда. Минимум один живой ключ или один провайдер без ключа завести придётся.

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

Что ломается: шесть экранов и их тексты

Собрал по документации обоих проектов и по своему прогону.

Отдельно про 429 после переезда: это выбранный дневной бесплатный лимит уже у запасного провайдера. Лечится либо ожиданием суток, либо вторым бесплатным провайдером в списке. Если хочется другого пути к бесплатным моделям, у меня разобран бесплатный доступ через OpenRouter и подборка бесплатных замен.

Ключ: что с ним нельзя делать

Четыре правила, каждое стоит денег, если его нарушить.

Не клади ключ в файл настроек внутри проекта. У Claude Code есть второй файл настроек, .claude/settings.json в папке самого проекта, и он уезжает на GitHub вместе с кодом. Ключ из домашней папки остаётся у тебя, ключ из проекта увидят все, кто скачает твой проект.

Не оставляй шлюз открытым наружу. При старте он честно предупреждает: слушает все сетевые адреса и не требует ключа по умолчанию, то есть до входа может дотянуться любое устройство в той же сети, а пароль панели по умолчанию написан прямо на её экране входа. Счёт при этом прилетит по твоим ключам провайдеров. Лечится двумя настройками шлюза: REQUIRE_API_KEY=true или OMNIROUTE_SERVER_HOST=127.0.0.1, вторая запирает шлюз на твоём компьютере.

Смени пароль панели, это минута. В боковом меню открой Settings, подпись Manage your preferences, и найди раздел Security. Там три поля подряд: Current Password (сюда CHANGEME, если его ещё не меняли), New Password и Confirm New Password. Снизу кнопка Update Password. Получилось: сверху выскочит зелёное Password updated successfully. Поля разошлись: панель ответит Passwords do not match, и пароль останется прежним.

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

И ещё одно, про что стоит знать заранее. В официальной документации Claude Code написано прямым текстом: Anthropic не одобряет, не поддерживает и не проверяет сторонние шлюзы и не поддерживает маршрутизацию Claude Code на модели других поставщиков через шлюз. Это не запрет, шлюз работает. Но пока ключ шлюза активен, подписка claude.ai не используется, а две возможности выключаются: голосовой ввод и удалённое управление сессией с телефона. Момент переключения виден по той же команде /status: пока в строке Anthropic base URL стоит адрес шлюза, Claude Code работает по ключу шлюза, а не по подписке. Уберёшь три строки и перезапустишь: подписка снова в деле, это раздел про откат ниже.

Шлюз или экономия: это разные ходы

Шлюз не уменьшает твой расход, он не даёт работе встать. Растянуть лимит той же модели без всяких шлюзов тоже можно, и это отдельная дисциплина: короткие сессии, сжатие разговора, выбор модели под уровень задачи. Разобрал это отдельно, чтобы не мешать два хода в одной статье: https://theivansergeev.com/guide-ekonomit-limit-neyroseti/

Как снять, если не подошёл

Убери три строки из блока env в файле настроек и перезапусти Claude Code: он вернётся на обычный вход, подписка снова заработает. Сам шлюз при этом можно оставить стоять, есть он не просит, пока не запущен.

Проверка, что откат прошёл, та же самая: /status и строка Anthropic base URL, в ней должен снова стоять адрес Anthropic.

Источники

Все страницы открыты живым запросом 21 сентября 2026 года; версия, вес, время старта и тексты ошибок сняты с собственного прогона на своей машине, а не переписаны из чужих обзоров

• Сайт проекта OmniRoute - счётчик провайдеров, разбивка по способу входа, перечень именных бесплатных тарифов
• Страница проекта OmniRoute на GitHub - лицензия MIT, число зарегистрированных провайдеров, ярусы запасных целей, стратегии маршрутизации
• Документация Claude Code, раздел про шлюзы - позиция Anthropic, что отключается при активном ключе шлюза
• Документация Claude Code, подключение шлюза - имена настроек, проверка через /status, правило про файл настроек внутри проекта
• Документация Claude Code, файл настроек - где лежит settings.json, что настройки читаются при запуске
• Кадры интерфейса в документации проекта - разделы Providers и Combos на кадрах выше, лицензия репозитория MIT
• Реестр npm, пакет omniroute - версия 3.8.50, дата публикации, состав пакета
• Собственный прогон 21 сентября 2026 года на macOS: установка по часам, старт шлюза, ответ шлюза без ключа, перебор запасных целей

Памятка: что проверить, если шлюз не подхватился

Шесть точек, по которым решаются почти все случаи «настроил, а работает по-старому»

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