Source: https://aiprimetech.io/ru/docs/guides/codex-cli/

[Документация](/ru/docs/) / [API Codex](/ru/codex-api/)

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

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

## 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. См. [сведения о модели](/ru/openai-api/) и [как их сравнить](/ru/blog/gpt-6-models-for-codex/). 

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

  | Симптом  | Проверьте    

  | Отсутствует переменная окружения  | Задайте 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](/ru/learn/use-claude-api-with-codex/) с совместимым ключом группы Claude. Пример GPT выше предназначен для доступа через группу Codex. 

Доступ через шлюз не предоставляет прав на использование рабочего пространства ChatGPT или доступа к облачному Codex. См. [сравнение способов входа](/ru/blog/codex-api-key-vs-chatgpt-subscription/) для уточнения границ возможностей продукта. 

## Ссылки  
- [OpenAI: использование учётных данных провайдера через шлюз](https://learn.chatgpt.com/docs/enterprise/connect-to-a-gateway) 
- [OpenAI: справочник по конфигурации](https://learn.chatgpt.com/docs/config-file/config-reference) 
- [OpenAI: расширенная конфигурация и профили](https://learn.chatgpt.com/docs/config-file/config-advanced)