Перейти к основному содержимому

Codex App + CLI

Codex App и CLI используют общую локальную конфигурацию Provider и подключаются к PopGo API через wire API Responses.

Перед настройкой​

  • На этой странице используются только заполнители. Реальный Key копируйте со страницы PopGo API keys, модель со страницы models and pricing.
  • Настройка в один клик подходит для уже установленного ПО с зарегистрированным обработчиком протокола. Разрешите браузеру открыть внешнее приложение.
  • При ручной настройке сначала сохраните минимальный Provider. Включайте streaming, tools или маршрутизацию нескольких моделей после первого успешного запроса.

Официальный источник и проверка​

Codex App + CLI 0.144.4 проверен 2026-07-14 по официальному источнику. Официальный источник. Проверены официальная структура пользовательского Provider и локальная конфигурация, общая для App и CLI.

Настройка одним действием​

Войдите на страницу ключей PopGo API и откройте меню действий нужной строки Key. Публичная документация не создаёт и не показывает ссылок, содержащих Key. Выберите CC Switch, затем Codex. После импорта убедитесь, что Base URL заканчивается на /v1; App и CLI читают одну локальную конфигурацию.

Ручная настройка​

Задайте POPGO_API_KEY в терминале и добавьте блок Provider ниже в файл Codex; отдельная настройка App и CLI не требуется.

export POPGO_API_KEY="YOUR_API_KEY"
$env:POPGO_API_KEY = "YOUR_API_KEY"
model = "YOUR_MODEL"
model_provider = "popgo"

[model_providers.popgo]
name = "PopGo"
base_url = "https://api.popgo.site/v1"
env_key = "POPGO_API_KEY"
wire_api = "responses"
  • Файл конфигурации обычно находится в .codex/config.toml в каталоге пользователя: %USERPROFILE%\.codex\config.toml в Windows и ~/.codex/config.toml в macOS/Linux.
  • Key читается из POPGO_API_KEY. Не записывайте настоящий Key в config.toml или публичный скриншот.

Установка и настройка на разных ОС​

  1. Проверьте node --version и npm --version, затем установите CLI официальным способом Codex.
  2. Файл конфигурации обычно находится в %USERPROFILE%\.codex\config.toml в Windows или ~/.codex/config.toml в macOS/Linux.
  3. Задайте POPGO_API_KEY в том же терминале, который запускает Codex. Не записывайте настоящий Key в файл:
$env:POPGO_API_KEY = "YOUR_API_KEY"

В model укажите актуальный ID модели. model_provider должен совпадать с именем блока Provider, env_key должен быть POPGO_API_KEY, а wire_api — responses. После изменения перезапустите App или CLI.

Проверка успеха​

Запустите CLI из настроенного терминала или заново откройте App, затем отправьте запрос с YOUR_MODEL.

Типичные ошибки и восстановление​

  • Если Key не найден, проверьте точное имя POPGO_API_KEY, затем перезапустите CLI или заново откройте App.
  • При 401 вставьте YOUR_API_KEY заново и удалите пробелы по краям.
  • При 404 проверьте уровень Base URL и отсутствие повторного /v1 со стороны клиента.