Перейти к содержанию

Настройка Codex

Codex обращается к Nexus по протоколу OpenAI Responses. Штатное подключение Codex оставьте в ~/.codex/config.toml, а Nexus вынесите в отдельный файл профиля.

Общий порядок — на странице подключения клиентов.

Профиль

Создайте ~/.codex/nexus.config.toml:

model = "MODEL_FROM_V1_MODELS"
model_provider = "nexus"

[model_providers.nexus]
name = "Nexus"
base_url = "https://api.nexus-hub.tech/v1"
env_key = "NEXUS_API_KEY"
wire_api = "responses"

Задайте ключ и запустите этот профиль:

export NEXUS_API_KEY="ваш_ключ_nexus"
codex --profile nexus

В model указывайте только id из GET /v1/models для вашего ключа. Codex отправляет POST /v1/responses. Не храните ключ в toml. Не меняйте wire_api с responses на Chat Completions: это другой маршрут.

Проектный файл .codex/config.toml не переопределяет model_provider и model_providers. Профиль Nexus держите в ~/.codex/nexus.config.toml.

Окно контекста

У каждой модели, которая сейчас доступна в Nexus, объявлено окно 1 050 000 токенов. model_context_window ставьте в это значение для id из GET /v1/models. model_auto_compact_token_limit ставьте ниже этого окна, чтобы Codex не сжимал переписку слишком рано. То же число указано на странице Модели и цены.

model = "MODEL_FROM_V1_MODELS"
model_provider = "nexus"
model_context_window = 1050000
model_auto_compact_token_limit = 945000

[model_providers.nexus]
name = "Nexus"
base_url = "https://api.nexus-hub.tech/v1"
env_key = "NEXUS_API_KEY"
wire_api = "responses"

Один сеанс без правки файла:

codex --profile nexus -m MODEL_FROM_V1_MODELS \
  -c model_context_window=1050000 \
  -c model_auto_compact_token_limit=945000

Если в списке ключа набранного id нет, возьмите id, который список возвращает. Окно остаётся 1 050 000 токенов.

Проверка

Запустите codex --profile nexus и отправьте короткий запрос.

Если не работает

  • 401 или invalid_key: проверьте NEXUS_API_KEY. Не кладите ключ в config.toml.
  • model_not_found или model_not_allowed: снова запросите GET /v1/models.
  • unsupported_model: id не разрешён на Responses. Возьмите другой id. Не переключайте wire_api на Chat Completions.
  • Профиль не применился: файл должен называться nexus.config.toml и лежать в ~/.codex, запуск — codex --profile nexus.
  • Для поддержки сохраните x-request-id. Не отправляйте ключ или полный prompt.

Официальная справка: Codex config reference и Config basics.