Codex

Codex — это терминальный агент OpenAI для кодинга. Он поддерживает пользовательских провайдеров моделей, поэтому его можно направить на OpenAI-совместимую поверхность ru-llm.

Настройка

Добавьте блок провайдера в ~/.codex/config.toml, указав base_url на путь /v1 шлюза:

model = "gpt-5.5"
model_provider = "ru-llm"

[model_providers.ru-llm]
name = "ru-llm"
base_url = "https://api.ru-llm.relay2.xyz/v1"
wire_api = "chat"
env_key = "RU_LLM_API_KEY"

Затем экспортируйте ключ под именем, указанным в env_key:

export RU_LLM_API_KEY="sk-ru-YOUR_KEY"

codex

Выбор модели

Задайте model в config.toml (или передайте --model в CLI) — любой ID чат-модели из каталога: например gpt-5.5, gpt-5.4, claude-opus-4-8 или gemini-3.1-pro-preview. Благодаря кросс-диалектной маршрутизации Codex может работать с моделями Claude и Gemini через того же OpenAI-провайдера:

model = "claude-opus-4-8"

Проверка

Убедитесь, что OpenAI-поверхность отвечает, перед запуском Codex:

curl https://api.ru-llm.relay2.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-ru-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Reply with the single word: ok"}]
  }'

Ответ 200 со значением ok в choices[0].message.content подтверждает доступность провайдера.

Устранение неполадок

Симптом	Причина	Решение
`404` / «unknown endpoint»	`wire_api` по умолчанию `responses`	Задайте `wire_api = "chat"` в блоке провайдера.
`401 Unauthorized`	Переменная с ключом не задана	Экспортируйте переменную из `env_key` (например, `RU_LLM_API_KEY`).
`402 Payment Required`	Нулевой баланс	Пополните в консоли → Billing.
`400` неизвестная модель	ID модели нет в каталоге	Задайте `model` равным существующему ID (`GET /v1/models`).