как настроить собственный API в Codex CLI

Краткая настройка

Команда установки

npm install -g @openai/codex

Файл конфигурации

~/.codex/config.toml

model_provider

qionggeme

base_url

https://qionggeme.com/v1

env_key

QIONGGEME_API_KEY

Это имя переменной окружения, а не API Key открытым текстом.

wire_api

responses

Для текущего пользовательского provider официальный Codex использует Responses.

Порядок настройки

1. 1

   Установите Codex CLI

   Установите официальный npm-пакет глобально:

   npm install -g @openai/codex

   После установки команда codex запускает клиент командной строки.

2. 2

   Запишите настройки в ~/.codex/config.toml

   Создайте или отредактируйте ~/.codex/config.toml и добавьте:

   model_provider = "qionggeme"
   model = "gpt-5.3-codex-spark"
   
   [model_providers.qionggeme]
   name = "穷哥么"
   base_url = "https://qionggeme.com/v1"
   env_key = "QIONGGEME_API_KEY"
   wire_api = "responses"

   Значение env_key — имя переменной, которую будет читать Codex, а не сам API Key. Не добавляйте поле api_key.

3. 3

   Задайте API Key в macOS / Linux

   В терминале, из которого запускается Codex, задайте переменную окружения:

   export QIONGGEME_API_KEY="ваш API Key 穷哥么"

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

4. 4

   Задайте API Key в Windows PowerShell

   В PowerShell выполните:

   $env:QIONGGEME_API_KEY="ваш API Key 穷哥么"

   Переменная действует в текущей сессии PowerShell. Запускайте codex в том же окне. После изменения переменной или TOML завершите старую сессию Codex и запустите новую.

5. 5

   Перезапустите сессию Codex и проверьте подключение

   После изменения файла или переменной завершите работающий Codex и снова выполните codex. Если пример модели недоступен текущему токену, выберите Codex-совместимый ID из списка консоли; страница цен служит ориентиром по основным моделям. Меняется только значение model в верхней части TOML.

Пример конфигурации

model_provider = "qionggeme"
model = "gpt-5.3-codex-spark"

[model_providers.qionggeme]
name = "穷哥么"
base_url = "https://qionggeme.com/v1"
env_key = "QIONGGEME_API_KEY"
wire_api = "responses"

# macOS / Linux
export QIONGGEME_API_KEY="ваш API Key 穷哥么"

# Windows PowerShell
$env:QIONGGEME_API_KEY="ваш API Key 穷哥么"

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

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