Перейти к основному содержанию
Используйте это руководство, чтобы запускать Codex CLI с CometAPI в качестве provider моделей. Официальные ссылки:
Доступность моделей часто меняется. В примерах ниже используется your-model-id — замените его на актуальный ID модели, подходящей для написания кода, со страницы CometAPI Models page.

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

ТребованиеПодробности
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) или Windows 11 через WSL2
Node.js22+ (рекомендуется LTS)
GitРекомендуется 2.23+
Ключ CometAPIПолучите его в CometAPI Dashboard (начинается с sk-)

Установка Codex CLI

npm i -g @openai/codex
Или через Homebrew:
brew install --cask codex
Проверьте установку:
codex --version

Настройка CometAPI

Есть два способа направить Codex на CometAPI. Выберите тот, который лучше подходит вашему рабочему процессу.
Самый простой вариант — перенаправить встроенный provider OpenAI на CometAPI одной строкой. Определять пользовательский provider не нужно.Создайте ~/.codex/config.toml:
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Сохраните API-ключ

Создайте ~/.codex/auth.json:
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Замените sk-your-cometapi-key на ваш реальный ключ CometAPI.
Этот файл обязателен. Без корректной записи OPENAI_API_KEY в auth.json Codex завершится с ошибкой API key auth is missing a key.

Запуск Codex

cd your-project
codex
При первом запуске Codex предложит выбрать тему и подтвердить настройки безопасности.

Переопределение model для одной сессии

Переключитесь на другую model для одного запуска без редактирования config.toml:
codex --model your-model-id

Альтернатива: переменная окружения

Вместо auth.json можно экспортировать ключ напрямую:
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
Это задаст ключ только для текущей сессии терминала. Для постоянного использования добавьте строку export в ~/.zshrc или ~/.bashrc.

Устранение неполадок

СимптомРешение
API key auth is missing a keyУбедитесь, что ~/.codex/auth.json содержит "OPENAI_API_KEY": "sk-..."
Неожиданно появляется запрос на входУдалите устаревший ~/.codex/auth.json и создайте его заново с вашим ключом CometAPI
Модель не найденаПроверьте страницу Models page на наличие доступных в данный момент моделей
Тайм-аут соединенияУбедитесь, что openai_base_url или base_url в config.toml имеют значение https://api.cometapi.com/v1
Проблемы в WindowsCodex требует WSL2 в Windows — нативные CMD/PowerShell не поддерживаются