Интеграции

Codex CLI

Запускайте Codex CLI на моделях GPT за полцены: добавьте Half Off Dev как провайдера модели в config.toml, задайте ключ и выберите модель.

Codex CLI позволяет регистрировать дополнительных провайдеров моделей в ~/.codex/config.toml. Добавьте Half Off Dev как одного из них, и Codex будет отправлять вызовы OpenAI Responses API сюда, где модели GPT стоят вдвое дешевле. Остальные настройки Codex не меняются. Сначала создайте API-ключ.

Регистрация провайдера#

Добавьте в ~/.codex/config.toml:

~/.codex/config.toml

model = "gpt-6.1-sol"
model_provider = "halfoff"

[model_providers.halfoff]
name = "Half Off Dev"
base_url = "https://halfoff.dev/v1"
env_key = "HALFOFF_API_KEY"
wire_api = "responses"

Сам ключ в файл не записывается. Codex читает его из переменной окружения, имя которой указано в env_key:

Shell

export HALFOFF_API_KEY="ho-..."
codex

Старые конфигурации

Свежие версии Codex отклоняют wire_api = "chat". Если конфигурация взята из старого руководства, замените значение на "responses".

Или импортируйте из панели#

В разделе API-ключи выберите Use in tools → Codex CLI, чтобы получить эту конфигурацию с подставленным ключом. Import with CC Switch добавляет Half Off Dev как провайдера в десктопное приложение CC Switch с предустановленными моделями (CC Switch должен быть установлен). Новый ключ уже в окне; для существующего вставьте ключ целиком, потому что Half Off Dev хранит только хеш.

Модели#

Responses API здесь обслуживает модели GPT, поэтому используйте id вида gpt-*. model в config.toml задаёт модель по умолчанию; codex -m <model> переопределяет её на одну сессию. Все id есть в списке моделей.

Кеширование промптов#

Каждая сессия Codex отправляет prompt_cache_key. Half Off Dev использует его, чтобы все шаги сессии оставались на канале, где хранится кеш, и повторяющийся контекст оплачивался по тарифу кешированного ввода. См. Кеширование промптов.

Исправление ошибок#

Что вы видите	Что делать
`401` `Missing API key`	Ключ не доходит до Half Off Dev. Экспортируйте `HALFOFF_API_KEY` в оболочке, из которой запускается `codex`, и убедитесь, что `env_key` содержит именно это имя.
`401` `Invalid or revoked API key`	Ключ введён с ошибкой, обрезан или отозван. Вставьте его заново или создайте новый.
`404` `not served in responses format`	По Responses API обслуживаются только модели GPT. Укажите в `model` id вида `gpt-*`.
`404` `Unknown endpoint /responses`	В `base_url` нет `/v1`. Задайте `https://halfoff.dev/v1`.
Codex отклоняет `wire_api = "chat"`	Используйте `wire_api = "responses"`.
`402`	Баланс исчерпан или ключ достиг лимита расходов. См. Биллинг.

Остальные статусы описаны в разделе Ошибки.