Инструменты · OpenAI Codex

Codex CLI
на моделях CheApi

Настройте config.toml один раз — и Codex будет работать через CheApi с оплатой в рублях. Без подписки ChatGPT, VPN и зарубежных карт.

~/.codex/config.tomlготово
model = "gpt-6.1-sol"
model_provider = "cheapi"

[model_providers.cheapi]
name = "CheApi"
base_url = "https://cheapi.ru/v1"
wire_api = "responses"
env_key = "CHEAPI_API_KEY"

Шаг за шагом

Подключение за пять минут

Инструкция для свежей установки Codex CLI на macOS, Linux или Windows (WSL). Если Codex уже установлен, переходите к шагу 3.

  1. 01

    Установите Codex CLI

    bash
    # macOS / Linux
    npm install -g @openai/codex
    
    # проверка установки
    codex --version

    Нужен Node.js 20+. Альтернативно можно установить через Homebrew: brew install codex.

  2. 02

    Создайте API-ключ

    В кабинете откройте «Ключи» → «Создать ключ». Скопируйте значение целиком: после закрытия окна оно больше не показывается. Ключ выглядит как che_sk_….

    Открыть ключи
  3. 03

    Отредактируйте config.toml

    Создайте файл ~/.codex/config.toml (или добавьте секции в существующий). Важное отличие от стандартной настройки — провайдер и base_url.

    ~/.codex/config.toml
    model = "gpt-6.1-sol"
    model_provider = "cheapi"
    
    [model_providers.cheapi]
    name = "CheApi"
    base_url = "https://cheapi.ru/v1"
    wire_api = "responses"
    env_key = "CHEAPI_API_KEY"

    model — любая модель из каталога. Можно менять перед запуском.

    wire_api — responses для современного Codex. Если клиент старый, используйте chat.

    env_key — имя переменной окружения с ключом, а не сам ключ. Так секрет не попадает в файл.

  4. 04

    Экспортируйте ключ

    bash
    # добавьте в ~/.zshrc или ~/.bashrc
    export CHEAPI_API_KEY="che_sk_ваш_ключ"
    
    # примените изменения
    source ~/.zshrc

    В Windows PowerShell: $env:CHEAPI_API_KEY="che_sk_…". Чтобы переменная сохранялась, добавьте её в профиль PowerShell.

  5. 05

    Запустите Codex

    bash
    cd ~/projects/my-app
    codex
    
    # или одной командой с задачей
    codex "объясни структуру проекта и предложи план рефакторинга"

    При первом запуске Codex может предложить вход через ChatGPT — выберите API-ключ или пропустите этот шаг. В терминале должна появиться строка с моделью и балансом.

Расширение Codex для VS Code

Тот же ключ, тот же каталог моделей

Установите расширение Codex из маркетплейса. Оно читает ~/.codex/config.toml, поэтому достаточно выполнить шаги выше. Если хочется задать настройки в самом VS Code, добавьте их в settings.json:

.vscode/settings.json
{
  "codex.apiKey": "che_sk_ваш_ключ",
  "codex.baseUrl": "https://cheapi.ru/v1",
  "codex.model": "gpt-6.1-sol"
}

Ключи в settings.json хранятся в открытом виде. На общих машинах лучше использовать переменную окружения.

Какую модель выбрать для Codex

МодельКогда использовать1 млн токенов
GPT 6.1 SolУниверсальный выбор: код, агенты, инструменты45,67 ₽
GPT 6.1 TerraЕжедневная рутина и тесты17,13 ₽
GPT 6 AstraСложная архитектура и инциденты128,45 ₽
Claude Sonnet 5.5Если промпты отлажены под Claude125,60 ₽

Цены при пополнении на 600 ₽. Полный каталог — здесь.

Если что-то не работает

401 Unauthorized

Переменная CHEAPI_API_KEY не видна процессу. Проверьте `echo $CHEAPI_API_KEY` в том же терминале и перезапустите shell. Ключ должен начинаться с che_sk_.

model_not_found

ID модели написан с ошибкой. Сверьтесь с GET /v1/models или страницей каталога. Алиасы и версии с датой тоже поддерживаются.

402 Insufficient balance

Баланс закончился. Пополните его в кабинете — ключ перевыпускать не нужно, доступ восстановится сразу.

Codex зависает на стриме

Проверьте, что base_url заканчивается на /v1 и wire_api совпадает с версией клиента. Для старых версий используйте chat вместо responses.

Слишком дорого

Уменьшите контекст: Codex отправляет историю и файлы целиком. Переключитесь на gpt-6.1-terra или deepseek-flash для рутины, а флагманские модели оставьте для сложных задач.

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

Нужна ли подписка ChatGPT Plus или Codex?
Нет. Codex CLI работает с API-ключом, а не с подпиской. Вы платите только за токены, которые израсходовали. Новым аккаунтам CheApi начисляем 5 млн базовых токенов для тестов.
Почему указан wire_api = responses, а не chat?
Современный Codex CLI использует Responses API. CheApi поддерживает его через /v1/responses и передаёт запросы upstream без изменения формата. Если ваш клиент умеет только chat, поставьте wire_api = chat и тот же base_url.
Codex пишет 401 Unauthorized
Проверьте, что переменная CHEAPI_API_KEY экспортирована в том же терминале, где запускается codex, и что ключ начинается с che_sk_. Если ключ отозван в кабинете, создайте новый. Быстрая проверка: curl https://cheapi.ru/v1/models -H "Authorization: Bearer $CHEAPI_API_KEY".
Можно ли использовать несколько моделей?
Да. Меняйте model в config.toml или передавайте --model при запуске. Для сложных задач берите gpt-6.1-sol или claude-opus-5-5, для рутины — gpt-6.1-terra, для больших объёмов — deepseek-flash.
Где посмотреть расход токенов Codex?
В кабинете CheApi, раздел «История». Там видны модель, входные и выходные токены, кеш, стоимость и задержка каждого запроса. Фильтр по endpoint помогает отделить Codex от других интеграций.