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

​
Передумови

ВимогаДеталі
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), або Windows 11 через WSL2
Node.js22+ (рекомендовано LTS)
Gitрекомендовано 2.23+
CometAPI keyОтримайте його в 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 key

Створіть ~/.codex/auth.json: 
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Замініть sk-your-cometapi-key на ваш справжній CometAPI key.
Цей файл є обов’язковим. Без дійсного запису 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 key
Model не знайденоПеревірте сторінку Models, щоб побачити моделі, доступні наразі
Тайм-аут з’єднанняПереконайтеся, що openai_base_url або base_url у config.toml має значення https://api.cometapi.com/v1
Проблеми у WindowsCodex потребує WSL2 у Windows — нативні CMD/PowerShell не підтримуються