Codex CLI через Modelflare — ключ API, config.toml и первый запуск

Настройте ключ, config.toml и доступ к Responses API, проверьте модель и разберите ошибки первого запроса Codex.

Codex CLI через Modelflare — ключ API, config.toml и первый запуск

Codex CLI можно подключить к Modelflare через Responses API. Для настройки понадобятся ключ Modelflare, группа с доступом к gpt-5.6-sol и два файла в домашнем каталоге. Базовый адрес для Codex — https://modelflare.dev/v1. Запросы в этой конфигурации оплачиваются с баланса Modelflare.

Если Codex работает на удалённой машине или в WSL, выполняйте проверку API из той же среды.

1. Создайте ключ для нужной модели

  1. Войдите в Modelflare, проверьте доступный баланс и при необходимости пополните его. Вход · Кошелёк · Пополнение криптовалютой
  2. В каталоге найдите gpt-5.6-sol. Для Codex в карточке модели нужен интерфейс Responses. Сверьте точный идентификатор и список доступных групп. Модели и цены
  3. Создайте обычный ключ с основной группой, в которой есть эта модель. Для примера подойдёт openai-award, если она доступна в вашем аккаунте. Сохраните ключ сразу после создания. Ключи API · Как выбрать группу

Для первого запуска удобно выделить отдельный ключ и установить ему лимит расхода в консоли. Храните ключ в пользовательском файле авторизации. При утечке отзовите его и замените в конфигурации.

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

Если Codex уже установлен, выполните codex --version и переходите к ручной настройке. Устанавливайте CLI от имени пользователя, который будет им пользоваться. При работе в WSL установите Linux-версию и храните конфигурацию в домашнем каталоге WSL.

Официальный установщик для macOS и Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

Для Windows используйте PowerShell:

irm https://chatgpt.com/codex/install.ps1 | iex
codex --version

Установщик Modelflare сохраняет предыдущие версии файлов, настраивает оба файла и ищет gpt-5.6-sol в общем каталоге GET /v1/models. Доступ группы и ограничения ключа проверяйте отдельно, как описано ниже. Установщик заменяет config.toml целиком и записывает sandbox_mode = "danger-full-access". Этот режим даёт командам Codex доступ к файловой системе с правами вашего пользователя. Если воспользовались установщиком, проверьте режим песочницы до первого запуска. Ручная настройка позволяет сохранить остальные параметры и задать workspace-write. Установщик Modelflare и настройка по платформам · Параметры песочницы Codex

3. Настройте config.toml и auth.json

В macOS и Linux пользовательский каталог Codex по умолчанию — ~/.codex, в Windows — %USERPROFILE%\.codex. Если задан CODEX_HOME, откройте файлы в этом каталоге. Сделайте локальные копии существующих файлов и защитите их так же, как оригиналы. В действующем config.toml обновите соответствующие параметры, оставьте остальные настройки и сохраните только одно определение [model_providers.modelflare].

Сохраните пример как config.toml. Строки до [model_providers.modelflare] относятся к корню TOML, поэтому при слиянии поместите их до первой секции файла.

cli_auth_credentials_store = "file"
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
  • model_provider выбирает секцию подключения, model задаёт точный ID из каталога, а base_url и wire_api направляют запросы в POST /v1/responses.
  • cli_auth_credentials_store = "file" и requires_openai_auth = true в этой конфигурации позволяют CLI использовать ключ из auth.json. Корневой model_provider нужен даже при заданном OPENAI_BASE_URL.
  • xhigh — уровень рассуждения из примера Modelflare для gpt-5.6-sol. При замене модели проверьте допустимые уровни и расход. Параметр disable_response_storage из примера относится к запросам CLI. Политику хранения данных сервиса следует смотреть отдельно.
  • workspace-write ограничивает запись рабочей областью и другими путями, разрешёнными песочницей. on-request позволяет Codex запросить разрешение для действий за её пределами.

В том же каталоге сохраните auth.json. Замените заглушку в редакторе полным ключом Modelflare.

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}

В macOS и Linux задайте файлам права 600. Команда ниже использует стандартный каталог. Если задан CODEX_HOME, подставьте фактический путь.

chmod 600 ~/.codex/config.toml ~/.codex/auth.json

В Windows сохраните оба файла в UTF-8 без BOM в каталоге профиля с доступом только для доверенных пользователей. Примеры для Windows, macOS и Linux

4. Проверьте ключ и каталог Responses

Для диагностики используйте scope=authorized. Обычный GET /v1/models возвращает общий каталог после авторизации, а этот запрос применяет фильтр доступа и оставляет модели с интерфейсом Responses. Генерация при этом не запускается. Выполните запрос на той машине и под тем пользователем, где будет работать Codex.

Bash на macOS, Linux или в WSL

(
  read -rsp "Modelflare API key: " api_key
  printf '\n' >&2
  printf 'Authorization: Bearer %s\n' "$api_key" |
    curl --silent --show-error --fail-with-body --max-time 30 \
      --header @- \
      'https://modelflare.dev/v1/models?scope=authorized&kind=text&endpoint=openai-response'
)

PowerShell в Windows

$secret = Read-Host "Modelflare API key" -AsSecureString
try {
  $apiKey = [System.Net.NetworkCredential]::new("", $secret).Password
  $models = Invoke-RestMethod -ErrorAction Stop -TimeoutSec 30 `
    -Uri 'https://modelflare.dev/v1/models?scope=authorized&kind=text&endpoint=openai-response' `
    -Headers @{ Authorization = "Bearer $apiKey" }
  $models.data.id
} finally {
  Remove-Variable secret, apiKey -ErrorAction SilentlyContinue
}

Найдите в ответе точный ID gpt-5.6-sol. Если его нет, сверьте основную группу, список разрешённых моделей в настройках ключа и отметку Responses в карточке. Доступность маршрута и достаточность баланса проверяются при самом вызове. Модели и цены · Ключи API

5. Проверьте один короткий запрос Codex

Для первого сеанса откройте небольшой проект с README, который можно отправить сервису. Запустите Codex с песочницей только для чтения.

cd ~/projects/my-app
codex --sandbox read-only

Введите «Прочитай README и в двух предложениях объясни, как запустить проект». После ответа найдите запись по времени и модели. Сверьте фактическую группу и списание. Первый ответ подтвердит, что Codex прочитал настройки, отправил запрос через Modelflare и получил результат. Запрос расходует баланс. Журнал использования

Если Codex не подключается

Признак Что проверить
CLI предлагает вход в ChatGPT Проверьте фактический CODEX_HOME, наличие auth.json, значение auth_mode и положение model_provider в корне TOML. Учитывайте параметры запуска и настройки проекта. Перезапустите Codex после правки.
401 или invalid_api_key Сверьте ключ в OPENAI_API_KEY и его статус в консоли. Проверьте, что файл читает тот же пользователь, который запускает CLI.
403 или модель отсутствует в списке Проверьте ID модели, выбранную группу, ограничения ключа и баланс. insufficient_user_quota означает, что доступных средств не хватает на запрос.
404 или в запросе виден неправильный путь base_url заканчивается на /v1, а ожидаемый полный путь — /v1/responses. В wire_api укажите responses.
Тайм-аут, ошибка DNS или TLS Сравните результат проверки каталога из той же среды. Если HTTP-ответа нет, начните с сети, прокси и доверенных сертификатов самого клиента.
429 Уменьшите суммарный поток запросов параллельных сессий. Учитывайте время ожидания из Retry-After, если этот заголовок есть.
Ошибка параметра рассуждения Проверьте допустимые значения model_reasoning_effort для выбранного ID. При смене модели также сверьте поддержку Responses и доступ для ключа.

Если каталог открывается, а Codex выдаёт ошибку, попробуйте новый сеанс в другом небольшом проекте. Если сбой остаётся, для обращения укажите версию codex --version, модель, время, HTTP-статус и X-ModelFlare-Request-Id, если он доступен. Перед отправкой уберите из вывода ключи и содержимое проекта. Коды ошибок

Можно ли выбрать другую модель? Да. Измените model, проверьте поддержку Responses и заново сопоставьте модель с группой ключа. В каталоге, проверенном 22 ноября 2026 года, Responses поддерживали также gpt-6-sol и gpt-6-luna. Модели и цены