Быстрый старт
Это руководство проведёт вас от новой установки до первого запроса из используемого инструмента программирования. Шаги 1 и 2 общие для всех, а шаг 3 содержит отдельные инструкции для каждого инструмента. На странице поддержки клиентов перечислены инструменты и способы их подключения.
Автономный бинарный файл (без npm)
Заголовок раздела «Автономный бинарный файл (без npm)»Можно также использовать архив с бинарным файлом ocx и рантаймом Bun без npm.
Распакуйте его, оставив каталог gui/dist рядом с бинарным файлом, и выполните ./ocx start.
1. Запустите мастер настройки
Заголовок раздела «1. Запустите мастер настройки»ocx initocx init проведёт вас по следующим шагам:
- Выбор провайдера — выберите один из 107 встроенных пресетов реестра или
custom, чтобы ввести базовый URL и адаптер вручную. - API-ключ — вставьте ключ или сошлитесь на переменную окружения вида
${ANTHROPIC_API_KEY}. - Модель по умолчанию — для провайдеров с ключом, локальных и
customпримите значение из пресета или введите id модели. - Порт прокси — по умолчанию
10100. - Внедрить в Codex? — при обычной loopback-настройке opencodex добавляет корневой
openai_base_urlв$CODEX_HOME/config.toml(по умолчанию~/.codex/config.toml), чтобы встроенный провайдерopenaiв Codex указывал на прокси. При привязке к удалённым/LAN-адресам вместо этого используется отдельная запись провайдера с заголовком API-аутентификации. - Установить shim автозапуска? — если включено, при запуске
codexсначала выполняетсяocx ensure.
Результат сохраняется в $OPENCODEX_HOME/config.json (по умолчанию ~/.opencodex/config.json).
2. Запустите прокси
Заголовок раздела «2. Запустите прокси»ocx start # defaults to port 10100ocx start --port 8080При запуске opencodex:
- записывает свой PID в
~/.opencodex/ocx.pid(и отказывается запускаться повторно), - обнаруживает живые модели там, где провайдер это поддерживает, и синхронизирует нативные и маршрутизируемые записи в каталог моделей Codex,
- слушает
http://localhost:<port>/v1.
Если запрошенный порт занят, ocx start останавливается и сообщает, какой процесс его удерживает:
если там отвечает opencodex, сначала выполните ocx stop; либо запустите прокси на свободном порту
через ocx start --port <port>. Команда не переходит на другой порт сама — раньше из-за этого два
прокси продолжали работать одновременно, а Codex перенаправлялся на более новый.
Проверьте:
ocx statusocx gui # open the dashboard on the live port3. Подключите свой инструмент
Заголовок раздела «3. Подключите свой инструмент»Выберите инструкции для своего инструмента. Можно подключить несколько инструментов: они используют общие провайдеры и модели.
Если на шаге 1 вы приняли приглашение Codex, теперь он прозрачно взаимодействует с opencodex. Если вы отклонили приглашение или настройка завершилась из-за существующей конфигурации, включите переключатель Codex на странице Connect панели перед запуском Codex; в разделе Интеграция Codex описаны изменения и их отмена.
codex "Refactor this function for readability"Чтобы обратиться к конкретной маршрутизируемой модели, используйте форму provider/model,
которую показывает селектор модели в Codex:
codex -m "anthropic/claude-opus-5" "Explain this stack trace"codex -m "ollama-cloud/glm-5.2" "Write a SQL migration"Claude Code
Заголовок раздела «Claude Code»При установленном CLI claude:
ocx claudeocx claude запускает прокси, если он не работает, и запускает Claude Code с окружением, направленным на opencodex. Дополнительные аргументы передаются дальше. Значения уровней по умолчанию, другие способы запуска и отключение описаны в Claude Code.
Claude Desktop
Заголовок раздела «Claude Desktop»ocx claude desktopПри новой установке команда настраивает профиль шлюза для всего приложения. Если установка уже использует режим first-party, он сохраняется; выполните ocx claude desktop apply --gateway, чтобы явно переключить режим. Режим first-party сохраняет подключение Desktop к claude.ai и маршрутизирует только вкладку Code; см. раздел о режимах Claude Desktop в Claude Code.
После смены режима полностью закройте и снова откройте Claude Desktop.
Grok Build
Заголовок раздела «Grok Build»При локальном прослушивании, если существует ~/.grok, команда ocx start регистрирует видимые модели в ~/.grok/config.toml. Выберите модель ocx-* в Grok Build. Удалённые конфигурации и управляемый блок описаны в Grok Build.
После добавления провайдеров или моделей выполните ocx ensure или перезапустите прокси, чтобы Grok Build их увидел.
Другие инструменты
Заголовок раздела «Другие инструменты»Инструменты с управляемой интеграцией (OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code и другие) подключаются на странице Connect панели или командой:
ocx integration client enable --client <id>Файлы конфигурации инструментов и время вступления изменений в силу описаны в разделе Интеграции. Любой другой инструмент с поддержкой пользовательского адреса может использовать совместимый с OpenAI базовый URL http://localhost:10100/v1 или базовый URL Anthropic http://localhost:10100.
Выбор моделей подагентов (опционально)
Заголовок раздела «Выбор моделей подагентов (опционально)»В свежей конфигурации в селекторе подагентов Codex представлены пять нативных моделей: gpt-5.5,
gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna и gpt-6-astra. Откройте ocx gui, чтобы
заменить или переупорядочить до пяти нативных или маршрутизируемых моделей. В панели управления
также можно задать одну предпочитаемую модель подагента и уровень рассуждений. Раздел
Поверхность подагентов поможет выбрать v1/base/v2 и понять, когда
применяются guidance, нативные значения по умолчанию и fallback.
Вход в аккаунт вместо вставки ключа
Заголовок раздела «Вход в аккаунт вместо вставки ключа»Некоторые провайдеры поддерживают полноценный вход в аккаунт (OAuth с автообновлением):
ocx login xai # or: anthropic, kimi, kiro, google-antigravity, cursorocx logout xaiСамому OpenAI ключ не нужен — провайдер по умолчанию напрямую пересылает ваши существующие
учётные данные codex login (см. Провайдеры).
Остановка и восстановление
Заголовок раздела «Остановка и восстановление»ocx stop # stop the proxy and restore native Codexocx restore # restore native Codex without stopping (alias: ocx eject)ocx restore back # route Codex through the still-running proxy again- Как это работает — что происходит с каждым запросом.
- Провайдеры — все способы аутентификации.
- Конфигурация — полный справочник по
config.json.