Codex CLI и GPT API через apiprovider.pro

Codex CLI поддерживает пользовательские model providers в ~/.codex/config.toml. Для apiprovider.pro можно задать Base URL, переменную окружения с ключом, model ID и wire API.

Сначала зарегистрируйтесь, пополните баланс и только после зачисления выберите модель. Для основной работы используйте gpt-5.6-terra; для экономичных подготовительных шагов — gpt-5.6-luna. Отдельный ключ создайте на странице API-ключей.

Подготовьте ключ

Codex читает секрет из переменной, имя которой указано в env_key. Не записывайте действующий ключ в config.toml и не передавайте его аргументом CLI.

export APIPROVIDER_API_KEY="YOUR_API_KEY"

Добавьте переменную в защищённое хранилище вашей оболочки или менеджер секретов. Не коммитьте её в репозиторий.

Настройте custom provider

Создайте или дополните пользовательский файл ~/.codex/config.toml:

model = "gpt-5.6-terra"
model_provider = "apiprovider"
model_reasoning_effort = "medium"

[model_providers.apiprovider]
name = "apiprovider.pro"
base_url = "https://api.apiprovider.pro/v1"
env_key = "APIPROVIDER_API_KEY"
wire_api = "responses"

Для подключения через российский маршрут замените только base_url:

base_url = "https://api.ru.apiprovider.pro/v1"

Codex запрещает переопределять зарезервированные ID встроенных провайдеров, поэтому используйте отдельное имя apiprovider. Поля model_provider и model_providers должны находиться в пользовательском ~/.codex/config.toml: project-local .codex/config.toml не может перенаправлять провайдера и учётные данные.

wire_api = "responses" соответствует публичному маршруту POST /v1/responses, который поддерживает apiprovider.pro. Chat Completions-запрос через curl ниже служит отдельной проверкой ключа и каталога, а не копией внутреннего запроса Codex.

Проверьте доступ до запуска Codex

curl https://api.apiprovider.pro/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIPROVIDER_API_KEY" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "user", "content": "Ответь одной строкой: API доступен."}
    ]
  }'

Если запрос успешен, запустите Codex в тестовом репозитории и выберите небольшую проверяемую задачу. Актуальную команду установки и запуска берите из официальной документации вашей версии Codex CLI.

Быстрый старт GPT API OpenAI-compatible API

Какую модель выбрать

После пополнения используйте gpt-5.6-terra как универсальную основную модель. Для экономичных анализов и подготовительных шагов можно временно переопределить model ID штатным флагом --model:

codex --model gpt-5.6-luna

Сравнивайте модели на одинаковых задачах и учитывайте прохождение тестов, число итераций, размер полезного diff и стоимость результата.

Как выбрать GPT-модель Модели GPT для кодинга

Безопасный рабочий цикл

1. Запускайте Codex в репозитории с чистым или понятным git status.
2. Сначала просите план и ограничивайте область конкретными файлами.
3. Не отключайте sandbox и approvals без отдельной оценки риска.
4. Просматривайте diff перед принятием изменений.
5. Запускайте тесты, линтер, typecheck и сборку.
6. Не разрешайте модели читать секреты, production-конфиги и лишние каталоги.
7. Фиксируйте лимит итераций и расходов.

Провайдер отвечает за модельные запросы, но права на файлы, shell и сеть контролируются настройками самого Codex.

Ошибки и диагностика

• Переменная не найдена: проверьте, что APIPROVIDER_API_KEY доступна процессу Codex.
• 401: замените или правильно передайте ключ.
• 402: пополните баланс и только затем повторите запрос.
• 404 или model not found: проверьте model ID через GET /v1/models.
• Ошибка Responses API: проверьте wire_api = "responses", Base URL с /v1 и актуальную версию Codex.
• Конфиг игнорируется: убедитесь, что provider-настройка находится в пользовательском, а не project-local файле.

Частые вопросы

Можно ли подключить Codex CLI к apiprovider.pro?

Да. Актуальный Codex CLI документирует custom model providers с base_url, env_key и wire_api.

Какой Base URL указать?

Основной — https://api.apiprovider.pro/v1, российский — https://api.ru.apiprovider.pro/v1.

Почему используется Responses API?

Codex рассчитан на Responses wire API, а apiprovider.pro публикует маршрут /v1/responses наряду с Chat Completions.

Где хранить provider-конфигурацию?

В пользовательском ~/.codex/config.toml. Project-local конфиг не должен перенаправлять провайдера или секреты.

Следующий шаг

Создайте аккаунт, пополните баланс, выпустите отдельный ключ и проверьте конфигурацию на небольшой задаче. Model ID сверяйте в документации, тариф — на странице цен.