Использование APIMart в Codex CLI

Введение

Codex CLI — это open-source терминальный кодинг-агент OpenAI, который может читать и писать файлы, выполнять команды, исправлять баги и выполнять полные задачи кодирования прямо из командной строки. Подключившись через APIMart, вы можете свободно использовать в Codex CLI несколько моделей — включая GPT и Claude — с более гибким и конкурентным ценообразованием.

Предварительные требования

Перед началом убедитесь, что у вас есть:

Установленный Node.js Скачайте и установите с сайта Node.js (рекомендуется последняя LTS, v20 или новее), чтобы установить Codex CLI через npm
Получен API-ключ APIMart Войдите в консоль APIMart для получения API-ключа (начинается с sk-)

Совет: если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на APIMart и получите API-ключ.

Шаг 1: Установите Codex CLI

Выберите любой из следующих способов установки:

npm (рекомендуется)
Homebrew (macOS)

Глобальная установка через npm — работает на всех ОС:

npm install -g @openai/codex

При проблемах с правами добавьте sudo (macOS / Linux).

Пользователи macOS также могут установить через Homebrew:

brew install codex

Проверка установки

После установки выполните следующую команду для подтверждения:

codex --version

Если выводится номер версии, установка прошла успешно.

Шаг 2: Настройте API APIMart

Codex CLI управляет провайдерами моделей через файлы конфигурации в директории ~/.codex/. Всё, что нужно — добавить кастомного провайдера, указывающего на APIMart.

2.1 Найдите директорию конфигурации

macOS / Linux: ~/.codex/
Windows: C:\Users\<username>\.codex\

Если директории не существует, выполните codex в терминале, затем нажмите Ctrl + C для выхода — она будет создана автоматически.

2.2 Настройте API-ключ

В директории конфигурации создайте или отредактируйте файл auth.json и впишите ваш ключ APIMart:

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

Поле	Описание
`OPENAI_API_KEY`	Ваш API-ключ APIMart (начинается с `sk-`)

2.3 Настройте провайдера модели

В директории конфигурации создайте или отредактируйте файл config.toml и добавьте провайдера APIMart:

# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true

Поле	Описание
`model`	ID модели по умолчанию — выберите из списка моделей ниже
`model_provider`	Провайдер по умолчанию — должен совпадать с ID в `[model_providers.xxx]`
`name`	Отображаемое имя провайдера — можно настроить
`base_url`	OpenAI-совместимый URL APIMart — фиксированный `https://api.apimart.ai/v1`
`wire_api`	Wire-протокол — последние версии Codex требуют `responses` (Responses API)
`requires_openai_auth`	Установите `true`, чтобы аутентифицироваться с ключом из `auth.json`

После сохранения обоих файлов перезапустите Codex CLI, чтобы изменения вступили в силу.

Убедитесь, что auth.json — валидный JSON, а config.toml — валидный TOML. Не используйте полноширинные / умные кавычки, иначе конфигурация не применится.

Шаг 3: Начните работу

Проверьте конфигурацию

В любой директории проекта выполните следующую команду для подтверждения, что всё подключено:

codex "Introduce yourself in one sentence"

Если получите ответ ИИ, конфигурация работает. При экране входа или ошибках 401 / 403 см. раздел FAQ ниже.

Интерактивный режим

Выполните codex напрямую, чтобы войти в интерактивный UI — идеально для полных задач кодинга:

codex

Внутри опишите, что нужно, на естественном языке, например:

Create an Express.js server with a JSON-returning health check endpoint

Codex проанализирует ваш проект, сгенерирует код, выполнит команды и попросит подтверждения перед чувствительными операциями.

Режимы одобрения

При первом запуске Codex попросит выбрать уровень одобрения:

Режим	Описание
Read Only	Разрешено только чтение файлов — любая модификация или команда требует подтверждения
Auto	Может читать/писать файлы и выполнять команды в рабочей директории (рекомендуется)
Full Access	Выполняет любую операцию без подтверждения — используйте с осторожностью

Мы рекомендуем начинать с режима Auto. В интерактивном UI введите /approvals, чтобы изменить его в любой момент.

Переключение моделей

В интерактивном UI введите /model для быстрого переключения или измените поле model в config.toml и перезапустите.

Поддерживаемые модели

Для Codex CLI рекомендуются следующие модели серии GPT-5:

ID модели	Сильные стороны	Рекомендуемые сценарии
`gpt-5.5`	Последний флагман, лучшие навыки кода	Первый выбор для Codex, сложная инженерия
`gpt-5.4`	Флагман предыдущего поколения, очень мощный	Сложный код, проектирование архитектуры
`gpt-5.4-mini`	Лёгкая, быстрая, выгодная	Повседневный кодинг, быстрая итерация
`gpt-5.3-codex`	Модель кода, оптимизированная для Codex	Агентные задачи кодинга
`gpt-5.2`	Стабильная и сбалансированная	Рутинные задачи кодинга

Советы по выбору модели: Указанная серия GPT-5 лучше всего сочетается с Codex CLI. Для лучшего опыта предпочтите gpt-5.5; gpt-5.3-codex специально оптимизирован для агентных сценариев кодинга Codex.

Распространённые команды

Часто используемые команды и горячие клавиши Codex CLI:

Команда	Описание
`codex`	Войти в интерактивный UI
`codex "task"`	Начать с начальной инструкцией
`codex exec "task"`	Неинтерактивный режим — запуск и выход
`codex --model gpt-5.4`	Запуск с указанной моделью
`codex --version`	Показать номер версии
`/model`	Переключить модель в интерактивном UI
`/approvals`	Изменить режим одобрения в UI
`Ctrl + C`	Выйти из интерактивного UI

Часто задаваемые вопросы

Q1: После запуска появляется экран входа в ChatGPT?

Если после запуска видите «Sign in with ChatGPT» или похожее, конфигурация не вступила в силу. Шаги устранения:

Убедитесь, что и config.toml, и auth.json находятся в ~/.codex/
Проверьте, что model_provider в config.toml установлен на apimart
Проверьте, что auth.json — валидный JSON, а ключ заполнен полностью

Q2: Ошибки 401 / 403?

Код ошибки	Значение	Решение
`401 Unauthorized`	Отсутствует или недействителен API-ключ	Проверьте ключ в `auth.json` — должен начинаться с `sk-`
`403 Forbidden`	Недостаточно прав или истёкший ключ	Перейдите в консоль, чтобы проверить ключ

Также убедитесь, что base_url установлен на https://api.apimart.ai/v1, а не на официальный URL OpenAI.

Q3: Не удалось подключиться?

Проверьте сетевое подключение
Убедитесь, что base_url в config.toml корректен
Если вы за прокси, убедитесь, что он разрешает доступ к api.apimart.ai

Q4: `wire_api = "chat"` больше не поддерживается?

Последние версии Codex CLI (0.84.0 и новее) удалили протокол chat. Обновите wire_api в config.toml до responses:

wire_api = "responses"

APIMart поддерживает Responses API — после изменения просто перезапустите Codex.

Q5: Вызовы инструментов или запуски не работают?

Убедитесь, что wire_api в config.toml установлен на responses. Если всё ещё возникают проблемы совместимости, переключитесь на рекомендуемую модель серии GPT-5 (например, gpt-5.5, gpt-5.3-codex) — они надёжнее сочетаются с Codex CLI.

Q6: Использовать переменные окружения вместо auth.json?

Также можно настроить ключ через переменную окружения. Измените блок провайдера в config.toml на:

[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"

Затем установите переменную окружения APIMART_API_KEY равной вашему ключу APIMart. В этой настройке auth.json больше не требуется.

Q7: Как переключать модели?

Два способа:

В интерактивном UI: введите /model для переключения
Редактировать конфиг: измените поле model в config.toml и перезапустите Codex CLI

Q8: Как проверить использование и биллинг?

Войдите в консоль APIMart, чтобы посмотреть статистику API-вызовов, детали потребления токенов и тенденции расходов.

Поддержка и помощь

Если у вас возникнут проблемы при использовании Codex CLI:

📚 Документация APIMart
💬 Сообщество Discord
🐦 Twitter @APIMart_
📧 Техническая поддержка: zhihong@apimart.ai

Начните с APIMart

Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и испытайте мультимодельного ассистента программиста в Codex CLI!

Documentation Index

​Введение

​Предварительные требования

​Шаг 1: Установите Codex CLI

​Проверка установки

​Шаг 2: Настройте API APIMart

​2.1 Найдите директорию конфигурации

​2.2 Настройте API-ключ

​2.3 Настройте провайдера модели

​Шаг 3: Начните работу

​Проверьте конфигурацию

​Интерактивный режим

​Режимы одобрения

​Переключение моделей

​Поддерживаемые модели

​Распространённые команды

​Часто задаваемые вопросы

​Q1: После запуска появляется экран входа в ChatGPT?

​Q2: Ошибки 401 / 403?

​Q3: Не удалось подключиться?

​Q4: wire_api = "chat" больше не поддерживается?

​Q5: Вызовы инструментов или запуски не работают?

​Q6: Использовать переменные окружения вместо auth.json?

​Q7: Как переключать модели?

​Q8: Как проверить использование и биллинг?

​Поддержка и помощь

Начните с APIMart

Введение

Предварительные требования

Шаг 1: Установите Codex CLI

Проверка установки

Шаг 2: Настройте API APIMart

2.1 Найдите директорию конфигурации

2.2 Настройте API-ключ

2.3 Настройте провайдера модели

Шаг 3: Начните работу

Проверьте конфигурацию

Интерактивный режим

Режимы одобрения

Переключение моделей

Поддерживаемые модели

Распространённые команды

Часто задаваемые вопросы

Q1: После запуска появляется экран входа в ChatGPT?

Q2: Ошибки 401 / 403?

Q3: Не удалось подключиться?

Q4: `wire_api = "chat"` больше не поддерживается?

Q5: Вызовы инструментов или запуски не работают?

Q6: Использовать переменные окружения вместо auth.json?

Q7: Как переключать модели?

Q8: Как проверить использование и биллинг?

Поддержка и помощь