Разделы документации

Codex CLI через Heli

Обновлено:

Codex CLI — агент OpenAI для кода в терминале. Heli подключается к нему как отдельный провайдер: оплата в рублях, ключ sk-heli-…, без зарубежной карты и VPN.

Коротко

Добавьте в ~/.codex/config.toml провайдера с base URL https://getheli.ru/v1 и wire_api = "responses", положите ключ Heli в переменную окружения и запустите codex.

1. Получите ключ Heli

Зарегистрируйтесь на getheli.ru и скопируйте ключ sk-heli-… во вкладке «Ключи» кабинета.

2. Добавьте провайдера в config.toml

toml
# ~/.codex/config.toml
model = "openai/gpt-5.3-codex"
model_provider = "heli"

[model_providers.heli]
name = "Heli"
base_url = "https://getheli.ru/v1"
env_key = "HELI_API_KEY"
wire_api = "responses"

model — слаг модели из каталога. env_key — имя переменной, из которой Codex возьмёт ключ.

3. Запустите Codex

bash
export HELI_API_KEY="sk-heli-ВАШ_КЛЮЧ"
codex

Проверка без Codex

Тот же эндпоинт, что использует Codex, можно вызвать через curl:

curl
curl https://getheli.ru/v1/responses \
  -H "Authorization: Bearer $HELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.3-codex",
    "input": "Напиши функцию на Python, которая проверяет, что строка — палиндром."
  }'

Частые вопросы

Какой API нужен Codex CLI?
Codex работает через Responses API (wire_api = "responses"). Heli отвечает на POST https://getheli.ru/v1/responses, включая стрим и вызовы инструментов, поэтому локальный прокси не нужен.
Можно ли в Codex выбрать не модель OpenAI?
Да. В поле model укажите слаг любой модели из каталога, например deepseek/deepseek-v4-flash. Codex лучше всего работает с моделями, которые хорошо вызывают инструменты.
Что будет при нулевом балансе?
Heli ответит 402 с суммой, которой не хватает, и запрос до модели не дойдёт. Пополнение — в кабинете, в рублях.

Другие инструменты — Cursor, Claude Code и n8n. Общая справка — документация Heli API.