Документация / API Codex

Codex CLI: настройка ключа API и пользовательского провайдера

Это руководство поможет подключить локальный Codex CLI к AI Prime Tech. Вам потребуются учетная запись шлюза, активный ключ в нужной группе Codex и модель, доступная для этого ключа. Начните с обзора API Codex если вы еще выбираете тип доступа.

1. Проверьте ключ и группу

Создайте ключ в панели управления. Предоплаченный доступ к GPT использует группу Codex группе. Если предлагается доступ к Codex на ограниченный срок, используйте группу и условия, указанные для этого тарифа; доступ к Claude предоставляется отдельно. Проверьте список моделей для ключа, который будете использовать.

Задайте ключ в текущем терминале. Замените заполнитель локально; не сохраняйте ключ в репозитории.

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash или zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

Если терминал или редактор, запущенный до настройки окружения, не видит переменную, перезапустите его. Эти примеры задают ее для текущего процесса и его дочерних процессов.

2. Настройте провайдера

Добавьте эту конфигурацию в свой пользовательский ~/.codex/config.toml. В Windows соответствующий путь — %USERPROFILE%\.codex\config.toml. Учетные данные провайдера должны храниться в пользовательской конфигурации, а не в файле репозитория .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

Используйте идентификатор провайдера, например aiprimetech и обеспечьте соответствие model_provider его таблице. Текущая версия Codex использует протокол Responses. Базовый URL — это корневой адрес шлюза /v1 ; Codex добавляет путь запроса. Эта конфигурация использует транспорт HTTP/SSE.

3. Проверьте подключение

Выполните codex doctor для проверки конфигурации CLI. Запустите codex, затем используйте /status для проверки провайдера и модели. Попросите дать короткий ответ, прежде чем разрешать выполнение более масштабной задачи в репозитории. Убедитесь, что запрос появился на странице использования AI Prime Tech.

Вы можете проверить список моделей ключа независимо от Codex:

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

Если полученный каталог содержит вашу модель, но запрос завершается ошибкой, проверьте саму ошибку и текущую доступность группы. Наличие идентификатора в списке само по себе не означает успешной проверки выполнения запроса к модели.

Создайте отдельный профиль CLI при необходимости

Чтобы выбирать этого провайдера только для определенных сеансов CLI, поместите приведенную выше конфигурацию в ~/.codex/aiprimetech.config.toml и запустите:

codex --profile aiprimetech

В Codex 0.134.0 и более поздних версиях профили CLI используют отдельные файлы. Старые примеры [profiles.aiprimetech] не соответствуют текущему формату профилей. Расширение IDE использует пользовательскую конфигурацию; после его перезапуска проверьте активного провайдера, а не полагайтесь на то, что переключение профиля CLI применилось и к нему.

Выберите модель

Используйте gpt-6.1-sol как отправную точку для программирования, gpt-6-astra для сложных задач или gpt-6-luna для узконаправленной работы. gpt-6-sol — отдельный ID для существующих рабочих процессов Sol. См. сведения о модели и как их сравнить.

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

Симптом Проверьте
Отсутствует переменная окружения Задайте AIPRIMETECH_API_KEY в процессе, который запускает Codex.
Ошибка аутентификации 401 Убедитесь, что ключ активен, скопирован полностью и выдан этим шлюзом.
403 или недоступная модель Проверьте группу ключа, доступ по тарифу и точный ID модели.
404 или ответ HTML Используйте https://aiprimetech.io/v1; удалите дубликат /v1 или добавленный в конце /responses.
wire_api отклонён Используйте responses; старые chat примеры конфигурации провайдера устарели.
Ошибка баланса, тарифа или ограничения частоты запросов Прочитайте сообщение об ошибке, проверьте свой аккаунт и сократите число параллельных задач перед повторной попыткой.
Соединение обрывается во время ответа Попробуйте один короткий запрос, проверьте подключение к сети и прокси и сохраните ID запроса для службы поддержки.

Claude и облачные функции Codex

Чтобы использовать Claude через преобразование запросов Responses на шлюзе, следуйте руководству Claude с Codex с совместимым ключом группы Claude. Пример GPT выше предназначен для доступа через группу Codex.

Доступ через шлюз не предоставляет прав на использование рабочего пространства ChatGPT или доступа к облачному Codex. См. сравнение способов входа для уточнения границ возможностей продукта.

Ссылки