Codex CLI

У Codex CLI есть механизм кастомных провайдеров — достаточно описать в config.toml провайдера с нашим base_url и указать ключ через переменную окружения.

Установка

Нужен Node.js 18 или новее:

терминал

npm install -g @openai/codex

Ключ cai-... — из раздела API-ключи. Конфигурация Codex лежит в ~/.codex/ (на Windows — %USERPROFILE%\.codex\).

Кастомный провайдер в config.toml

Создайте или дополните ~/.codex/config.toml:

~/.codex/config.toml

model = "gpt-4o"
model_provider = "cheapai"

[model_providers.cheapai]
name = "cheapai.io"
base_url = "https://api.cheapai.io/v1"
env_key = "CHEAPAI_API_KEY"
wire_api = "chat"

Поле base_url уже включает /v1 — это OpenAI-совместимый эндпоинт. В model подставьте любую модель из каталога, которая поддерживает chat-режим.

Ключ через переменную окружения

В config.toml выше указано env_key = "CHEAPAI_API_KEY" — значит, ключ Codex берёт из этой переменной:

macOS / Linux · ~/.zshrc

export CHEAPAI_API_KEY="cai-..."

Windows · PowerShell

[Environment]::SetEnvironmentVariable("CHEAPAI_API_KEY", "cai-...", "User")

Альтернатива — файл ~/.codex/auth.json с ключом; но переменная окружения проще и её сложнее случайно закоммитить.

Запуск

терминал

codex            # интерактивный режим
codex "почини падающий тест в src/auth"   # одноразовая задача

Сменить модель на один запуск: codex -m claude-3-5-sonnet (если модель есть в каталоге и поддерживает chat). Перманентно — поменяйте model в config.toml.

Дальше: Cursor, Cline, Aider… · OpenAI-совместимый API · Коды ошибок.