Використання Codex із CometAPI

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

Передумови

Вимога	Деталі
OS	macOS, Linux, нативний PowerShell у Windows або Windows із WSL
Git	Рекомендовано 2.23+
Codex	Установіть застосунок Codex або Codex CLI зі швидкого старту Codex
CometAPI API key	Отримайте ключ у панелі керування CometAPI
Model ID	Використовуйте model ID зі сторінки Models

Виберіть шлях налаштування

Ми пропонуємо два варіанти, щоб допомогти вам швидко налаштувати Codex.

Варіант 1: Налаштувати Codex вручну (рекомендовано)

Відредагуйте файл ~/.codex/config.toml на рівні користувача безпосередньо. Це найнадійніший шлях, особливо для користувачів Windows і WSL.

Варіант 2: Налаштування через скрипт

Запустіть скрипт налаштування як скорочений шлях. Він записує ту саму конфігурацію provider і зберігає CometAPI API key для Codex.

Налаштуйте Codex вручну

Codex зчитує персональні стандартні налаштування провайдера з файлу рівня користувача ~/.codex/config.toml. Налаштовуйте провайдера CometAPI саме там, а не у файлі проєкту .codex/config.toml. Codex ігнорує налаштування provider і provider-auth у файлах конфігурації проєкту. Рекомендоване налаштування використовує іменований провайдер cometapi та автентифікацію на основі команди. Це відокремлює CometAPI від вбудованого провайдера OpenAI, не потребує успадкування змінних середовища оболонки та не замінює ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

Збережіть свій API key CometAPI у локальному файлі ключа:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Додайте цю конфігурацію до ~/.codex/config.toml:

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

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

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

Збережіть свій API key CometAPI у домашньому каталозі Codex у Windows:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Додайте цю конфігурацію до $HOME\.codex\config.toml:

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

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

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Нативний Codex у Windows використовує $HOME\.codex, зазвичай C:\Users\<user>\.codex. WSL використовує ~/.codex дистрибутива Linux. Редагуйте каталог, який відповідає середовищу, у якому працює агент Codex.

Використовуйте автентифікацію через змінну середовища

Якщо ви хочете зберігати API key CometAPI у змінній середовища, використовуйте env_key замість блоку [model_providers.cometapi.auth]. Використовуйте цю конфігурацію провайдера лише тоді, коли COMETAPI_KEY доступний у середовищі, з якого запускається Codex:

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

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

Не поєднуйте env_key з [model_providers.cometapi.auth]. Codex підтримує один метод автентифікації для кожного користувацького провайдера.

Запустіть скрипт налаштування

Скрипт налаштування є необов’язковим. Він записує ту саму конфігурацію провайдера cometapi до ~/.codex/config.toml, зберігає ваш API-ключ CometAPI у ~/.codex/cometapi_key, створює резервні копії перед змінами файлів і перевіряє конфігурацію за допомогою codex exec, коли доступний Codex CLI. Для macOS, Linux або WSL запустіть інтерактивний інсталятор:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

Для неінтерактивного налаштування явно передайте API-ключ:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Для Windows native PowerShell запустіть інтерактивний інсталятор:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

Для неінтерактивного налаштування у Windows явно передайте API-ключ:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

За замовчуванням скрипт не замінює ~/.codex/auth.json і не видаляє вхід через ChatGPT. Використовуйте --force-auth-json або -ForceAuthJson, лише якщо хочете, щоб скрипт керував входом до Codex за API-ключем через auth.json.

Виберіть або змініть model ID

Використовуйте model ID зі сторінки Models page. У разі ручного налаштування змініть значення model у ~/.codex/config.toml. Для macOS, Linux або WSL передайте --model під час запуску скрипта налаштування:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Для Windows native PowerShell передайте -Model під час запуску скрипта налаштування:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

Скрипт використовує CODEX_HOME, якщо його задано. Інакше він записує у ~/.codex поточного середовища.

Перевірте налаштування

Щоб перевірити налаштування за допомогою Codex CLI, виконайте цю команду лише для читання з будь-якого локального проєкту:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Якщо Codex CLI недоступний у PATH, відкрийте застосунок Codex і надішліть короткий Prompt із локального проєкту.

Усунення несправностей

Codex досі використовує стандартного провайдера OpenAI

Переконайтеся, що model_provider = "cometapi" є у файлі користувацького рівня ~/.codex/config.toml.

API key змінився

Оновіть ~/.codex/cometapi_key або повторно запустіть скрипт налаштування з оновленим значенням $COMETAPI_KEY.

Скрипт PowerShell завершується помилкою під час попередніх перевірок

Використайте ручні кроки для Windows native PowerShell, а потім виконайте команду перевірки.

Налаштування shell через pipe не запитує API key

Використайте --key "$COMETAPI_KEY", встановіть COMETAPI_KEY або запустіть інтерактивну команду sh -c "$(curl ...)".

З’єднання завершується за тайм-аутом або використовує неправильний base URL

Переконайтеся, що base_url має значення https://api.cometapi.com/v1 у ~/.codex/config.toml.

Модель не знайдено

Перевірте сторінку Models, щоб побачити доступні model IDs.

Налаштування Windows впливає на неправильне середовище

Редагуйте $HOME\.codex для режиму Windows native або редагуйте ~/.codex всередині WSL для режиму агента WSL.

Вхід через ChatGPT змінився

Не використовуйте --force-auth-json або -ForceAuthJson, якщо вам не потрібен режим входу через API key.

Огляд

AI агенти для програмування

AI-агенти

AI чат-клієнти

Переклад і мова

Платформи автоматизації

Спостережуваність та оцінювання

AI фреймворки

Використання Codex із CometAPI

Передумови

Виберіть шлях налаштування

Варіант 1: Налаштувати Codex вручну (рекомендовано)

Варіант 2: Налаштування через скрипт

Налаштуйте Codex вручну

Використовуйте автентифікацію через змінну середовища

Запустіть скрипт налаштування

Виберіть або змініть model ID

Перевірте налаштування

Усунення несправностей

​Передумови

​Виберіть шлях налаштування

Варіант 1: Налаштувати Codex вручну (рекомендовано)

Варіант 2: Налаштування через скрипт

​Налаштуйте Codex вручну

​Використовуйте автентифікацію через змінну середовища

​Запустіть скрипт налаштування

​Виберіть або змініть model ID

​Перевірте налаштування

​Усунення несправностей

Передумови

Виберіть шлях налаштування

Налаштуйте Codex вручну

Використовуйте автентифікацію через змінну середовища

Запустіть скрипт налаштування

Виберіть або змініть model ID

Перевірте налаштування

Усунення несправностей