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

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

Конфиг

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

model = "gpt-5.6-terra"
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 немного.

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

Если не хочется править конфиги руками, есть готовые скрипты:

curl -fsSL https://zukko.pro/downloads/codex-setup-macos.sh | bash

Для Windows:

powershell -ExecutionPolicy Bypass -Command "irm https://zukko.pro/downloads/codex-setup-windows.ps1 | iex"

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

Выбор модели

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

Ориентиры по каталогу Zukko: gpt-5.6-sol — флагман, gpt-5.6-terra — сбалансированный, gpt-5.6-luna — быстрый и самый дешёвый. Ничто не мешает поставить в Codex модель Anthropic: API совместим, и claude-opus-5 там работает так же.

Ошибки

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↗ пополнение возможно картой, через СБП и криптой, а цены заметно ниже официальных: например, Opus 5 стоит $0.30 за миллион токенов против $5 за входные и $25 за выходные у Anthropic.

Проверить, сколько будет расходовать именно ваш Codex, можно на стартовом балансе: @zukkopro_bot↗ кладёт $1 при первом входе.