Skip to content

quickstart.md

Latest commit

 

History

History
112 lines (83 loc) · 6.24 KB

quickstart.md

File metadata and controls

112 lines (83 loc) · 6.24 KB
Raw
title Быстрый старт
description Настройте первого провайдера и направьте OpenAI Codex через opencodex тремя командами.

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

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

ocx init

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

  1. Выбор провайдера — выберите один из 71 встроенного пресета реестра или custom, чтобы ввести базовый URL и адаптер вручную.
  2. API-ключ — вставьте ключ или сошлитесь на переменную окружения вида ${ANTHROPIC_API_KEY}.
  3. Модель по умолчанию — для провайдеров с ключом, локальных и custom примите значение из пресета или введите id модели.
  4. Порт прокси — по умолчанию 10100.
  5. Внедрить в Codex? — при обычной loopback-настройке opencodex добавляет корневой openai_base_url в $CODEX_HOME/config.toml (по умолчанию ~/.codex/config.toml), чтобы встроенный провайдер openai в Codex указывал на прокси. При привязке к удалённым/LAN-адресам вместо этого используется отдельная запись провайдера с заголовком API-аутентификации.
  6. Установить shim автозапуска? — если включено, при запуске codex сначала выполняется ocx ensure.

Результат сохраняется в $OPENCODEX_HOME/config.json (по умолчанию ~/.opencodex/config.json).

:::note[Записи rollout GPT-5.6] Текущий стабильный релиз добавляет GPT-5.6 Sol/Terra/Luna для passthrough ChatGPT, OpenAI по API-ключу, OpenRouter и экспериментального адаптера Cursor. Они работают только тогда, когда у соответствующего вышестоящего аккаунта есть доступ. Пресеты OpenAI по API-ключу и OpenRouter заявляют используемое контекстное окно в 372 000 токенов; Cursor сохраняет собственные метаданные адаптера. :::

2. Запустите прокси

ocx start            # defaults to port 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       # open the dashboard on the live port

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, чтобы заменить или переупорядочить до пяти нативных или маршрутизируемых моделей. В панели управления также можно задать одну предпочитаемую модель подагента и уровень рассуждений. Раздел Поверхность подагентов поможет выбрать v1/base/v2 и понять, когда применяются guidance, нативные значения по умолчанию и fallback.

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

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

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

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

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

ocx stop          # stop the proxy and restore native Codex
ocx restore       # restore native Codex without stopping (alias: ocx eject)
ocx restore back  # route Codex through the still-running proxy again

Далее