opencodex позволяет подключать разные языковые модели к Codex, Claude Code, Claude Desktop и Grok Build. Если вам нравится интерфейс инструмента, но нужна модель другого поставщика, opencodex берёт на себя согласование форматов запросов и ответов. Он работает как локальный прокси: программа принимает обращение от вашего инструмента и передаёт его выбранному поставщику модели.
Одна рабочая среда, несколько поставщиков моделей
Codex и другие инструменты общаются с моделями через определённые API — правила, по которым программы отправляют запросы и получают ответы. По README, opencodex переводит запросы Codex в формат выбранного поставщика и ответы обратно. Перевод охватывает потоковую выдачу текста, вызовы инструментов, изображения и токены рассуждения. Потоковая выдача означает, что ответ появляется по частям; вызов инструмента — что модель может запросить действие у подключённой программы.
В README перечислены Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen и Ollama. Проект заявляет более 40 встроенных поставщиков и возможность добавить совместимый с OpenAI адрес API. Это выбор источника модели, а не обещание, что каждая модель одинаково справится с задачей или что все сочетания инструментов и поставщиков будут работать без настройки.
Интерфейс Codex, Claude Code, Claude Desktop или Grok Build при этом остаётся привычным: вы меняете модель за ним, а не переходите в отдельный чат. Настройки поставщиков, моделей и аккаунтов доступны через веб-панель локального прокси. Для читателей, которые уже работают в Claude Code, это главное отличие от поиска нового редактора или чат-приложения.
opencodex — не навык, который учит агента выполнять задачу, и не MCP-сервер, предоставляющий агенту новый источник данных. Если вам нужен доступ к файлам или сервисам через отдельное подключение, сначала разберитесь, что такое MCP и как подключить сервер. Здесь задача уже: связать существующий интерфейс для работы с ИИ с выбранной моделью.
Когда смена модели пригодится, а когда нет
Представьте, что вы ведёте проект в Claude Code и хотите попробовать другую модель, не отказываясь от привычного процесса работы. opencodex рассчитан на такой сценарий: вы добавляете поставщика и выбираете модель через панель. README не даёт оснований обещать, что новая модель сохранит качество ответов или поведение предыдущей.
Другой случай — вы пользуетесь Codex, но хотите направлять запросы к одному из перечисленных в README поставщиков. Прокси переводит форматы между Codex и поставщиком. Если вас интересует Ollama, начните также с материала про локальный запуск моделей: opencodex указан как способ подключить Ollama к поддерживаемым интерфейсам, а не как средство установки самой модели.
Третий сценарий связан с несколькими аккаунтами ChatGPT или Codex. По README, панель показывает их квоты за 5 часов, неделю и 30 дней, а новые сеансы могут направляться на подходящий аккаунт с наименьшим использованием. Существующие ветки диалога обычно сохраняют привязку к аккаунту, с которого начались, хотя при исчерпании квоты, ошибках доступа и других перечисленных в README обстоятельствах привязка может измениться.
Если вы общаетесь с моделью только в обычном чате и не пользуетесь Codex, Claude Code, Claude Desktop или Grok Build, этот прокси вам, скорее всего, не нужен. Он добавляет промежуточную программу, которую придётся запускать и настраивать; для одного чата такой шаг не решает обозначенной в README задачи.
Установка opencodex и первая настройка
Для установки через командную строку README требует Node 18 или новее. Отдельно ставить Bun для этого способа не нужно: по описанию проекта, среда Bun поставляется вместе с npm-пакетом. Установите пакет и запустите прокси командами из README:
npm install -g @bitkyc08/opencodex
ocx startПосле запуска откройте панель по адресу из README:
http://localhost:10100В панели можно добавить поставщиков, выбрать модели и управлять аккаунтами. Важно различать запуск и настройку: запуск прокси сам по себе не означает, что вы уже выбрали нужную модель. Если хотите держать процесс в фоне, README предлагает отдельную команду:
ocx serviceДля интерактивной настройки Codex в разделе README «For agents» приведена ещё одна команда. Она записывает конфигурацию и подключает Codex, но не запускает прокси:
ocx initПо README, команда записывает файл по следующему пути:
~/.opencodex/config.jsonЕсли настраиваете всё без веб-панели, учитывайте порядок действий. Команды добавления поставщика обращаются к работающему прокси и завершаются ошибкой, когда он недоступен. Проверить состояние можно командами, которые перечисляет README:
ocx status
ocx doctor
ocx healthЕсть и настольное приложение в статусе beta. README даёт ссылку на последний релиз с файлами для macOS, Windows и Linux. Для настольной версии Node и Bun не требуются; на Windows сборка, по README, пока не подписана, поэтому SmartScreen показывает предупреждение. Если предпочитаете командную строку, начинать проще с опубликованного выше npm-варианта, а не со сборки исходников или Docker Compose.
Три действия из README: что вводить и чего ждать
Первый пример — открыть локальную панель. После установки вы вводите команду запуска:
ocx startПо README, она поднимает прокси и панель на локальном порту 10100. Дальше вы сами добавляете поставщика и выбираете модель в браузере. Команда не создаёт за вас аккаунт у поставщика и не выбирает модель автоматически.
Второй пример — подключить Codex через интерактивный мастер:
ocx initРезультат, который прямо описан в README, — записанный файл конфигурации и настройка связи с Codex. Сам прокси эта команда не запускает, поэтому для дальнейшей работы его нужно запустить отдельно. Это полезное различие, если мастер завершился, а запросы ещё не проходят.
Третий пример — добавить конкретного поставщика. README показывает такую команду для OrcaRouter:
ocx provider add orcarouterПосле добавления README называет виртуальный маршрут модели:
orcarouter/autoОн относится к предложению этого поставщика по выбору модели. README не описывает команду как получение бесплатного доступа: условия и доступ к самому поставщику не следует путать с установкой opencodex. Перед вводом команды убедитесь, что прокси работает, иначе она завершится с ошибкой.
Что проверить перед подключением аккаунтов и моделей
opencodex получает запросы от Codex и других поддерживаемых интерфейсов и передаёт их выбранному поставщику модели. При использовании пула он также работает с подключёнными аккаунтами ChatGPT или Codex. Учитывайте это, прежде чем отправлять через прокси рабочий код или добавлять аккаунты: обзор опирается на README, а не на проверку исходного кода или условий сторонних поставщиков.
Сам README предупреждает, что пул аккаунтов не защищает от ограничений, блокировок и других мер поставщика. Авторы не рекомендуют заводить дополнительные аккаунты для обхода лимитов или передавать учётные данные между людьми. Если вам нужен пул, сначала проверьте действующие правила своего поставщика: автоматический выбор аккаунта не отменяет их.
На момент обзора репозиторий создан 18 июня 2026 года, последний коммит в карточке датирован 12 октября 2026 года; указаны 17 302 звезды и лицензия MIT. Основной язык проекта — TypeScript. Эти цифры показывают состояние карточки на момент обзора, а не подтверждают качество работы с вашим поставщиком. В README есть ссылка на русскую версию документации, так что для подробной настройки можно начать с неё, не переводя английский текст самостоятельно.
Если вы выбираете инструменты для ИИ-агентов, определите задачу до установки. Для смены модели внутри поддерживаемого интерфейса opencodex подходит по назначению; для новых умений агента ищите навыки для Claude и других агентов, а для подключения внешних данных — MCP.
Источник: репозиторий lidge-jun/opencodex на GitHub.