Веб-дашборд

opencodex включает локальный веб-дашборд (Vite/React-приложение в каталоге gui/), который раздаёт сам прокси. Это кратчайший путь к управлению провайдерами, аккаунтами Codex/ChatGPT, моделями каталога, сайдкарами, настройками подагентов и трафиком запросов.

Как открыть

ocx gui

Команда открывает http://localhost:<port> в браузере, при необходимости сначала автоматически запуская прокси. При разработке dev-сервер GUI можно запускать отдельно поверх работающего прокси:

ocx start
bun run dev:gui

Возможности

Раздел	Что делает
Сводка Dashboard	Мультиагентный режим, состояние онлайн, версия, время работы, число провайдеров, сумма токенов за 30 дней, активные провайдеры и доступные нативные/маршрутизируемые модели.
Sub-agent delegation	Выбор нативной или маршрутизируемой модели для инструкции и необязательного уровня рассуждений для v1-промптов делегирования. Это не маршрутизатор для каждого порождения; см. ниже.
Сайдкары	Выбор модели и уровня рассуждений для веб-поиска, а также модели описания изображений. Изменения применяются со следующего запроса.
Maintenance	Пересинхронизация каталога моделей Codex, просмотр предупреждений об обходе через проектную локальную конфигурацию, проверка последнего или предварительного выпуска и запуск обновления с необязательным перезапуском прокси.
Безопасность запуска	Показывает, сохранит ли внедрённая маршрутизация Codex работоспособность после перезагрузки, отдельно отображая службу, launcher shim и точные команды исправления.
Трей Windows	Устанавливает пользовательский значок входа для запуска, остановки, перезапуска, панели и состояния прокси одним щелчком. Трей не является службой перезапуска.
Автозапуск Codex	Разрешает уже установленному launcher shim Codex выполнять `ocx ensure`. Переключатель не устанавливает shim или фоновую службу.
Providers	Добавление, редактирование, включение/отключение и удаление провайдеров; управление пулами OAuth-аккаунтов и пулами API-ключей там, где они поддерживаются.
Add provider	Поиск по пресетам из реестра: вход по аккаунту, сервисы с API-ключом, локальные серверы или пользовательская конечная точка.
Codex Auth	Добавление аккаунтов пула ChatGPT/Codex, выбор аккаунта для следующей сессии, обновление квот 5 ч / недельных / 30-дневных, настройка автопереключения по квоте и failover при временных сбоях.
Subagents	Выделение до пяти «голых» нативных или маршрутизируемых моделей с пространством имён в списке переопределений `spawn_agent`.
Models	Включение и отключение нативных GPT и маршрутизируемых моделей, настройка списков разрешённых провайдеров и лимитов контекста, выбор v1/base/v2 и настройка лимита потоков v2.
Logs	Автообновляемый список недавних запросов: токены, запрошенный уровень рассуждений, фактическая модель, провайдер, статус, id запроса, длительность и подробности ошибок.
Usage / Debug	Просмотр покрытия и трендов расхода токенов либо включение опциональной диагностики транспорта провайдеров и извлечения данных об использовании.
Stop	Корректная остановка прокси и установленного фонового сервиса, восстановление нативного Codex и выход (`POST /api/stop`).

Значения стоимости в Logs и Usage — это эквиваленты стоимости по прайс-листу API, рассчитанные на основе сообщённых токенов. Они не являются счётом и не подтверждают фактическое списание; расходы могут покрываться подпиской или кредитами провайдера.

Селектор делегирования и маршрутизация порождений

Селектор Sub-agent delegation в дашборде сохраняет injectionModel и, при желании, injectionEffort. В ходах v1 opencodex внедряет инструкцию, сообщающую родительскому агенту, какие именно модель и уровень рассуждений передать в spawn_agent. Выбор модели включает эту инструкцию при любом уровне рассуждений родителя; очистка модели очищает и сохранённый уровень.

Селектор предлагает включённые нативные и маршрутизируемые модели, а также глобальную шкалу уровней рассуждений Codex. API валидирует выбранный уровень глобально; Codex дополнительно валидирует уровень порождения по целевой записи каталога.

Codex Auth и пулы аккаунтов

Страница Codex Auth управляет нативным маршрутом ChatGPT/Codex:

Ручной выбор аккаунта меняет следующую новую сессию Codex; уже привязанный поток при таком ручном переключении сохраняет текущий аккаунт.
Привязка потока предотвращает метание между аккаунтами на каждом запросе. При включённом автопереключении по квоте долгоживущий поток периодически переоценивается и может перепривязаться, когда его релевантное использование достигает порога и существует подходящий аккаунт со строго меньшим использованием.
Новые сессии могут выбирать подходящий аккаунт с наименьшим использованием. Платные тарифы оцениваются по самому загруженному из известных окон — 5-часового, недельного или 30-дневного; тарифы Go/Free используют только 30-дневное окно.
Refresh quotas немедленно перечитывает использование аккаунтов, чтобы маршрутизация и карточки аккаунтов опирались на одни и те же значения.
Логи запросов пула используют непрозрачные метки вида p3fa91c и никогда — email аккаунтов.

Как дашборд взаимодействует с прокси

GUI — это тонкий клиент поверх JSON-API управления прокси. Полезные эндпоинты:

Эндпоинт	Назначение
`GET` / `PUT /api/settings`	Чтение настроек или переключение автозапуска Codex.
`GET /api/startup-health`	Чтение безопасной диагностики маршрутизации, службы, shim и устойчивости к перезагрузке.
`GET` / `POST /api/windows-tray`	Чтение или изменение установки и видимости трея Windows; POST поддерживает `install`, `start`, `stop`, `uninstall`.
`POST /api/sync`	Пересборка общего каталога моделей и инвалидация кэша моделей Codex.
`GET /api/update/check` · `POST /api/update/run` · `GET /api/update/status`	Проверка, запуск и мониторинг задач самообновления.
`GET` / `PUT /api/sidecar-settings`	Чтение или настройка моделей сайдкаров поиска/vision.
`GET` / `PUT /api/injection-model`	Чтение или настройка модели v1-инструкции делегирования и необязательного уровня.
`GET` / `PUT /api/v2`	Чтение или настройка режима поверхности, фиче-флага Codex и лимита потоков v2.
`GET /api/providers` · `POST /api/providers` · `PATCH /api/providers?name=...` · `DELETE /api/providers?name=...`	Список, добавление/замена, включение/отключение или удаление провайдеров.
`GET /api/models` · `PUT /api/disabled-models`	Список строк нативных/маршрутизируемых моделей и обновление общего набора отключённых моделей.
`GET /api/key-providers` · `GET /api/oauth/providers`	Чтение каталогов провайдеров с API-ключом и OAuth.
`POST /api/oauth/login` · `GET /api/oauth/status`	Запуск OAuth-процесса провайдера и опрос его завершения.
`GET /api/codex-auth/accounts?refresh=1`	Список основного и пуловых аккаунтов с принудительным обновлением квот и состояниями `hasCredential` / terminal `needsReauth` основного аккаунта.
`PUT /api/codex-auth/active` · `PUT /api/codex-auth/auto-switch` · `PUT /api/codex-auth/failover`	Выбор аккаунта следующей сессии и настройка маршрутизации пула.
`POST /api/codex-auth/login` · `GET /api/codex-auth/login-status`	Добавление аккаунта пула через вход в браузере.
`GET /api/logs?tail=50&provider=...&status=5xx`	Чтение метаданных недавних запросов с необязательными фильтрами tail, провайдера и точного/классового статуса.
`GET` / `PUT /api/subagent-models`	Чтение или настройка пяти выделенных моделей переопределения `spawn_agent`.
`POST /api/stop`	Остановка прокси/сервиса, восстановление нативного Codex и выход.