Codex CLI: как подключить свой API (Responses)

Что такое Codex CLI

Codex CLI — открытый терминальный кодинг-агент от OpenAI: читает проект, правит файлы, запускает команды в песочнице и показывает диффы перед применением. Вместо подписки ChatGPT его можно направить на LLMost как кастомного провайдера: Codex работает по протоколу Responses API, который LLMost поддерживает на эндпоинте /v1/responses, — оплата по факту использования с вашего баланса.

Требования

Node.js 18+ (или Homebrew на macOS)
Аккаунт LLMost с API-ключом

Установка

npm install -g @openai/codex

или на macOS:

brew install codex

Проверьте установку:

codex --version

Подключение LLMost

Создайте ключ на странице Ключи API (формат llmost_...).
Экспортируйте его в переменную окружения (например, в ~/.zshrc):
```
export LLMOST_API_KEY="llmost_ВАШ_КЛЮЧ"
```

Создайте или дополните файл ~/.codex/config.toml:

model = "~openai/gpt-latest"
model_provider = "llmost"

[model_providers.llmost]
name = "LLMost"
base_url = "https://llmost.ru/api/v1"
env_key = "LLMOST_API_KEY"
wire_api = "responses"

Перезапустите терминал и запустите codex в каталоге проекта.

Выбор модели

В поле model указывается слаг из каталога моделей LLMost. Для агентного режима модель обязана поддерживать tool calling. Хорошие варианты:

~openai/gpt-latest — родная для протокола Responses флагманская линейка OpenAI, всегда актуальная версия;
~anthropic/claude-sonnet-latest — сильная альтернатива для агентного кодинга, контекст 1 млн токенов;
~deepseek/deepseek-v4-flash-latest — бюджетный вариант для простых задач.

Алиасы, начинающиеся с ~, всегда указывают на актуальную версию модели, так что конфиг не устаревает.

Проверка

Запустите codex и дайте простую задачу, например: «Создай файл hello.txt с текстом "Привет"». Агент покажет дифф, запросит подтверждение и создаст файл. Списания видны в личном кабинете.

Чтобы проверить подключение в обход Codex, выполните запрос напрямую:

curl https://llmost.ru/api/v1/responses \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~openai/gpt-latest",
    "input": "Привет!"
  }'

Частые проблемы

Codex просит логин в ChatGPT. В config.toml не подхватился model_provider = "llmost" — проверьте, что строка стоит на верхнем уровне файла (не внутри секции), а файл лежит в ~/.codex/config.toml.

Ошибка про переменную окружения. env_key указывает на переменную, которой нет в окружении, — проверьте echo $LLMOST_API_KEY в том же терминале, где запускаете codex.

Ошибка 400 про previous_response_id или store. Responses API LLMost работает без хранения состояния (stateless) — Codex это поддерживает штатно, но если ошибка воспроизводится, обновите Codex до актуальной версии: npm update -g @openai/codex.

Ошибка 401. Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.

Ошибка 402 «Недостаточно средств». Пополните баланс LLMost в личном кабинете.

Агент отвечает текстом, но не правит файлы. Выбранная модель не поддерживает tool calling — смените её на одну из рекомендованных выше.

Ссылки

Документация: developers.openai.com/codex/cli
GitHub: openai/codex
Справочник эндпоинта: /docs/api-reference/responses
Другие приложения — в каталоге ИИ-агентов

Codex CLI + LLMost: установка и настройка