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

Настройка Codex

Пример конфигурации

Создайте отдельный профиль ~/.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"

В model указывайте только значение из ответа GET /v1/models для вашего ключа.

Запустите codex --profile nexus. Codex будет отправлять запросы в POST /v1/responses.

Работа с расширенным контекстом (1M токенов)

Для моделей с поддержкой длинного контекста (например, gpt-5.6-sol) можно настроить расширенный лимит контекста и порог автоматического сжатия истории в профиле ~/.codex/nexus.config.toml:

model = "gpt-5.6-sol"
model_provider = "nexus"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

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

Параметр model_context_window = 1000000 задаёт бюджет контекста в 1 000 000 токенов, а model_auto_compact_token_limit = 900000 предотвращает преждевременное сжатие истории клиентом Codex до достижения ~900 000 токенов.

Для разового запуска через CLI без изменения файла конфигурации:

codex --profile nexus -m gpt-5.6-sol \
  -c model_context_window=1000000 \
  -c model_auto_compact_token_limit=900000

Диагностика

  • 401 или invalid_key: проверьте NEXUS_API_KEY и не храните его в config.toml.
  • model_not_found или model_not_allowed: снова запросите GET /v1/models.
  • Ошибка формата: не заменяйте responses на Chat Completions — это другой маршрут.
  • Для поддержки сохраните x-request-id из ответа, но не отправляйте ключ или полный prompt.

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