Быстрый старт

Это руководство проведёт вас от чистой установки до запуска Codex с моделью не от OpenAI.

1. Запустите мастер настройки

ocx init

ocx init проведёт вас по следующим шагам:

Выбор провайдера — выберите один из 50 встроенных пресетов реестра или 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. Запустите прокси

ocx start            # порт по умолчанию 10100
ocx start --port 8080

При запуске opencodex:

записывает свой PID в ~/.opencodex/ocx.pid (и отказывается запускаться повторно),
запрашивает актуальные модели у провайдеров, которые это поддерживают, и синхронизирует нативные и маршрутизируемые записи в каталог моделей Codex,
слушает http://localhost:<port>/v1.

Если запрошенный порт занят, ocx start выбирает свободный порт, записывает его в runtime-port.json и обновляет настройки Codex, чтобы тот использовал актуальный адрес.

Проверьте:

ocx status
ocx gui       # открыть панель управления на актуальном порту

3. Используйте Codex

Теперь Codex прозрачно общается с opencodex:

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"

Выбор моделей подагентов (опционально)

В свежей конфигурации в селекторе подагентов Codex представлены пять нативных моделей: gpt-5.5, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna и gpt-5.4-mini. Откройте ocx gui, чтобы заменить или переупорядочить до пяти нативных или маршрутизируемых моделей. В панели управления также можно задать предпочитаемую модель подагента и уровень рассуждений; opencodex добавляет это указание в v1-запросы совместной работы.

Вход в аккаунт вместо вставки ключа

Некоторые провайдеры поддерживают полноценный вход в аккаунт (OAuth с автообновлением):

ocx login xai          # или: anthropic, kimi, kiro, google-antigravity, cursor
ocx logout xai

Самому OpenAI ключ не нужен — провайдер по умолчанию напрямую пересылает ваши существующие учётные данные codex login (см. Провайдеры).

Остановка и восстановление

ocx stop          # остановить прокси и восстановить нативный Codex
ocx restore       # восстановить нативный Codex без остановки (псевдоним: ocx eject)
ocx restore back  # снова направить Codex через всё ещё работающий прокси

Как это работает — что происходит с каждым запросом.
Провайдеры — все способы аутентификации.
Конфигурация — полный справочник по config.json.