Codex без подписки ChatGPT: подключение своего провайдера

Codex — консольный агент OpenAI, и по умолчанию он ходит в их API. Но провайдер задаётся конфигом, а значит вместо OpenAI можно подставить любой совместимый адрес. Для тех, у кого нет возможности оплатить подписку, это единственный рабочий путь.

Конфиг

Codex читает ~/.codex/config.toml:

model = "gpt-5.6-sol"
model_provider = "zukko"
model_reasoning_effort = "high"

[model_providers.zukko]
name = "zukko"
base_url = "https://api.zukko.pro/v1"
wire_api = "responses"
requires_openai_auth = true

Ключ кладётся отдельно, в ~/.codex/auth.json:

{ "OPENAI_API_KEY": "fetch_ваш_ключ" }

Разберём неочевидные поля.

wire_api = "responses" — Codex общается через Responses API, а не через классический chat/completions. Провайдер должен его поддерживать; если поставить другое значение, запросы будут уходить не туда.

base_url с суффиксом /v1 — обязателен для OpenAI-совместимого режима. Его отсутствие даёт 404 на каждый вызов.

model_reasoning_effort управляет тем, сколько модель думает перед ответом. Выше — качественнее и дороже. На простых задачах смысла в high немного.

Автоматическая настройка

Если не хочется править конфиги руками, есть готовые скрипты. Для macOS — codex-setup-macos.command↗: скачайте и запустите двойным кликом или из терминала:

curl -fsSLO https://zukko.pro/downloads/codex-setup-macos.command
chmod +x codex-setup-macos.command
open codex-setup-macos.command

Для Windows — codex-setup-windows.vbs↗: скачайте файл и запустите его двойным кликом.

Скрипт создаёт оба файла и просит ключ. Если вы не любите запускать скрипты из интернета — это здравая осторожность, настройте руками по конфигу выше, там всего два файла.

Выбор модели

В поле model можно поставить любую модель из каталога провайдера. Codex — агент, он делает много вызовов подряд и подгружает контекст, поэтому в первую очередь смотрите на цену входных токенов.

Ориентиры по каталогу Zukko: gpt-5.6-sol — флагман ($0.30/$0.30 за миллион), gpt-5.6-luna — дешевле ($0.10/$0.10); какая подходит вам, проверьте на своих задачах. Ничто не мешает поставить в Codex модель Anthropic: API совместим, и claude-opus-5-5 там работает так же. Актуальный список моделей — GET https://api.zukko.pro/v1/models.

Ошибки

404 на каждом запросе. Нет /v1 в base_url либо неверный wire_api.

401 unauthorized. Ключ не подхватился: проверьте, что он лежит именно в ~/.codex/auth.json и поле называется OPENAI_API_KEY — Codex ищет его по этому имени независимо от провайдера.

402. Пустой баланс.

Модель не найдена. Сверьте название с каталогом: curl https://api.zukko.pro/v1/models -H "Authorization: Bearer fetch_ваш_ключ".

Сколько это стоит

Оплата идёт за использованные токены, без абонплаты. У Zukko↗ пополнение возможно картой, через СБП и криптой, а цены заметно ниже официальных: например, Claude Opus 5.5 стоит $0.30/$0.30 за миллион токенов против официальных $4 за входные и $20 за выходные у Anthropic. Оговорка для агентов с большим контекстом: у вендоров чтение из кэша промптов стоит ~10% цены входа, а у нас кэшированные токены идут по обычной цене, поэтому реальная разница меньше, чем «в лоб».

Проверить, сколько будет расходовать именно ваш Codex, можно на небольшой сумме: пополнение — от $1. Стартового баланса нет, но за подписку на канал @zukkopro↗ один раз начисляется $0.50 (привязка Telegram в кабинете).