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

Используйте это руководство, чтобы запускать Codex с CometAPI в качестве провайдера моделей. Официальные материалы:

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

Требование	Подробности
OS	macOS, Linux, Windows native PowerShell или 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, не требует наследования переменных окружения из shell и не заменяет ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

Сохраните ваш API-ключ 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-ключ 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-ключ 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 поддерживает один метод аутентификации для каждого пользовательского провайдера.

Запустите скрипт настройки

Скрипт настройки необязателен. Он записывает ту же конфигурацию provider 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. При ручной настройке измените значение 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.

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

Проверьте доступные model ID на странице Models.

Настройка 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

Проверьте настройку

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