Codex CLI

Налаштуйте OpenAI Codex CLI з CometAPI: вкажіть openai_base_url або власного provider у config.toml, збережіть свій API key в auth.json і почніть писати код із актуальною model.

Скористайтеся цим посібником, щоб запускати Codex CLI з CometAPI як provider моделей.

Офіційні посилання:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

Доступність моделей часто змінюється. У прикладах нижче використовується your-model-id — замініть його на актуальний ID моделі, придатної для написання коду, зі сторінки Models у CometAPI.

​

Передумови

Вимога	Деталі
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), або Windows 11 через WSL2
Node.js	22+ (рекомендовано 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. Оберіть той, який найкраще підходить для вашого робочого процесу.

Просто: openai_base_url

Найпростіший варіант — перенаправити вбудований provider OpenAI на CometAPI одним рядком. Визначати власний provider не потрібно.

Створіть ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Іменований provider

Визначте іменований provider cometapi. Це зручно, якщо ви хочете перемикатися між кількома provider за допомогою --profile або model_provider.

Створіть ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key вказує Codex, яка змінна середовища містить ваш API key. Codex зчитує значення OPENAI_API_KEY під час виконання — це не ваш фактичний ключ.

​

Збережіть свій 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
Проблеми у Windows	Codex потребує WSL2 у Windows — нативні CMD/PowerShell не підтримуються