Если вы работаете с Claude Code, но не хотите платить за официальный API или нужна гибкость в выборе моделей, OmniRoute решает эту задачу. Это open-source AI-шлюз, который подключается между вашим терминалом и любым провайдером нейросетей. Сегодня разберу установку на реальном примере, с учётом подводных камней, которые встречаются на Windows 11 и macOS.
Ключевой запрос, по которому вы сюда попали, звучит так: omniroute claude code как установить. Отвечаю сразу - процесс несложный, но требует внимательности. Поехали.
Что потребуется перед установкой
Перед тем как ставить OmniRoute, проверьте Node.js. OmniRoute работает на нём, и для Windows 11 нужна версия 24 или новее. Подойдёт и 22, начиная с 22.22.2. Проверка простая: node --version. Если команда не найдена, ставьте Node.js с официального сайта.
Claude Code ставится отдельно. Если его нет, используйте официальную инструкцию Anthropic. Для работы с OmniRoute вход в аккаунт Anthropic не требуется - приятный бонус. После установки проверьте: claude --version. Любая версия означает, что CLI на месте.
На Windows 11 удобно работать в VS Code с терминалом PowerShell. Откройте проект, в котором планируете использовать Claude Code, и вызывайте команды прямо из редактора. Так проще замечать ошибки на лету.
Установка OmniRoute одной командой
Установка OmniRoute - одна команда: npm install -g omniroute. После этого проверьте версию: omniroute --version. Всё, шлюз на месте.
Если OmniRoute уже стоял, но давно, команда обновит его до актуальной версии. Только не забудьте закрыть окно старого процесса, иначе установка может ругаться на занятые файлы. На Windows это частая история.
Иногда npm ругается на права доступа. На macOS или Linux добавьте sudo, если видите ошибку EACCES. На Windows лучше запускать PowerShell от имени администратора, чтобы избежать лишних танцев с бубном.
Запуск сервера и вход в дашборд
Запуск: omniroute или omniroute serve. Через несколько секунд в терминале появится URL дашборда - обычно это localhost:20128. Открывайте в браузере. Первый пароль - CHANGEME, его лучше сменить в настройках безопасности.
На Windows удобно запускать шлюз в фоновом режиме с иконкой в трее: omniroute serve --tray. А чтобы он стартовал автоматически при входе в систему, выполните omniroute autostart enable. Тогда не придётся каждый раз вспоминать про терминал.
Дашборд выглядит просто и логично. Слева навигация: Providers, Security, Logs. Сразу после первого входа зайдите в Configuration, потом Security и смените пароль. Это займёт минуту, зато уберёт головную боль в будущем.
Автоматическая настройка Claude Code
Дальше самое интересное. OmniRoute умеет автоматически настраивать Claude Code. Для этого выполните omniroute setup-claude. Шлюз создаст профили, которые позволят Claude Code ходить через него.
Но тут есть нюанс. Если ваш API защищён аутентификацией, автоматическая настройка может споткнуться. Я на это наступил, когда пробовал подключить свою инсталляцию. В таком случае придётся сделать всё руками, благо процесс несложный.
Ручная настройка через дашборд и settings.json
В дашборде OmniRoute откройте Providers, выберите Claude Code или Anthropic-compatible, укажите модель и сохранитесь. Затем создайте API-ключ - он выглядит как omni_xxxxxxxxxxxxxxxxx. Храните его как зеницу ока и никогда не коммитьте в Git.
Дальше пропишите настройки в файле .claude/settings.local.json. Вставьте туда базовый URL шлюза, ключ и модель. Конкретный блок настроек зависит от версии OmniRoute, но в закрепе к видео на YouTube он есть - берите и копируйте, не надо перепечатывать вручную.
Примерно это выглядит так:
{
"apiBaseUrl": "http://localhost:20128",
"apiKey": "omni_xxxxxxxxxxxxxxxxx",
"model": "claude-3-5-sonnet"
}Обратите внимание на порт - он совпадает с дашбордом. Если у вас другой, поправьте. Не используйте https, если шлюз работает локально.
Проверка работы
Проверить работу можно двумя способами. Первый - запустить claude в терминале и попросить что-нибудь простое, например, объяснить код из файла hello.py. Второй - написать Python-скрипт, который отправляет запрос через OmniRoute и выводит ответ. Если всё сконфигурировано правильно, вы увидите ответ в редакторе или терминале.
Я предпочитаю командную строку: claude "Explain what hello.py does". Срабатывает мгновенно, и видно, какой маршрут выбрал шлюз.
Если вы работаете в VS Code, можно запустить Claude Code прямо из редактора, используя omniroute launch. Эта команда стартует CLI, уже настроенный на шлюз, без лишних ручных действий.
Важное предупреждение о бесплатных моделях
Важное предупреждение, о котором многие забывают. Бесплатные модели, которые подключаются через OmniRoute, - это не официальный Claude. Они могут быть слабее, давать другие ответы и вообще вести себя по-другому. На Reddit практикующие разработчики подтверждают: бесплатные провайдеры через OmniRoute непредсказуемы. Если вам нужна гарантированная производительность, лучше использовать официальные модели.
OmniRoute - отличный инструмент для экспериментов и экономии. Но когда дело доходит до продакшена, я бы не рисковал с бесплатными провайдерами. Всё-таки код должен быть предсказуемым, а бесплатные API иногда откровенно тупят.
Альтернатива для России: 3GPT от 3SELLER
Если вам не хочется возиться с настройкой шлюза, а нужно просто получить доступ к свежим моделям, есть более простой путь - 3GPT от 3SELLER. Это сервис, который даёт доступ к Chat GPT 6, Claude Fable 5 и другим флагманским моделям из России, без иностранных карт и VPN.
Chat GPT 6 и Claude Fable 5 за 149₽ в России, без иностранных карт - так анонсируют 3GPT от 3SELLER. ИИ роутер 3GPT позволяет получить прямой доступ из России к последним флагманским моделям нейросетей: Chat GPT 6 Astra, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для создания изображений, генерация видео и многим другим.
Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT - https://3seller.com/3gpt. Пополнить баланс можно российской картой, через СБП или криптой.
Используйте его для повседневных задач в бизнесе и в работе: создавайте продающие тексты, сайты, обрабатывайте изображения, генерируйте видео и голос.
Но кроме этого у нас есть еще фишка: готовые ИИ агенты под ваши задачи - https://3seller.com/ai/agents. Выберите готового ИИ агента, и начните с ним общение. Модель агента можно менять прямо в чате.
Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT - https://3seller.com/3gpt
Конечно, OmniRoute остаётся отличным инструментом для тех, кто любит копаться в настройках и контролировать каждый маршрут. Но если ваша задача - быстро получить результат и не думать о региональных ограничениях, 3GPT - это решение, которое уже работает.