Справочник CLI

CLI opencodex — это ocx. Он диспетчеризует по первому имени команды, при этом документированные alias вроде setup/init, restore/eject и models/model приводят к одной и той же операции. Неизвестные команды и некорректные формы вызова считаются ошибками.

Запускайте ocx help (или ocx --help / ocx -h) для верхнеуровневой справки. Для команды, зарегистрированной в таблице help, используйте ocx help <command>, ocx <command> --help или ocx <command> -h. Команды help и version — read-only: они не запускают, не останавливают, не устанавливают, не удаляют и не переписывают состояние Codex или opencodex.

Семейства команд

• Lifecycle — настройка, жизненный цикл прокси и службы, health, диагностика, синхронизация каталога, дашборд и обновления.
• Providers, accounts, and models — конфигурация провайдеров, аутентификация, credential pool’ы, квоты, custom model’и, видимость, selected model’и и context cap’ы.
• Agents, routing, and integrations — multi-agent controls, combo, observability, admission key, client integration’ы, runtime setting’и и валидированная конфигурация.

Поведение в headless-режиме

Management-команды делают round-trip через management API живого прокси, используя записанный runtime port и проверку identity, а не поддерживая второй путь конфигурации. Остановленный или недоступный прокси представляется как HTTP 503 и приводит к ненулевому коду выхода CLI. Команды, явно документированные как offline-операции с конфигурацией, вместо этого могут валидировать и редактировать файл конфигурации без живого прокси.

Там, где это недвусмысленно, list или status являются действием по умолчанию. Для структурированных снимков используйте --json, а для потокового лога запросов — ocx observe logs --follow --jsonl. Theme, language, navigation и прочее чисто визуальное browser-state CLI не покрывает; настройка Cloudflare Tunnel тоже вне этого набора команд.

Коды выхода и подтверждение

Успешные команды завершаются с кодом 0. Некорректное использование, неизвестные команды или ресурсы, неудачные API-операции и недоступность обязательных служб приводят к ненулевому коду. Команда ocx health специально возвращает 0 только когда прокси здоров, и 1 во всех остальных случаях, поэтому её можно использовать как service probe. Сценарии должны проверять код выхода, а не разбирать человекочитаемый вывод.

Разрушающие операции удаления, импорта, расходования кредитов и обновления, которые документируют подтверждение, в неинтерактивном использовании требуют --yes. Этот флаг — явное согласие; отсутствие флага не должно молча подтверждать действие.

Version и внутренние dispatch-target’ы

ocx --version, ocx -v и ocx version печатают одну строку с версией, пригодную для сценариев, и завершаются.

Две точки диспетчеризации намеренно исключены из обычной справки: __refresh-version [preview] обновляет кэш уведомлений об обновлении в отдельном процессе, а __gui-update-worker <job-id> [latest|preview] [restart] исполняет update job дашборда. Это внутренние детали реализации, а не стабильные пользовательские команды. Дашборд записывает PID worker’а, умеет восстанавливать активную job, если её worker умер, считает старые активные записи без PID устаревшими через десять минут и защищает живой worker от конкурентных обновлений.