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

Codex CLI можно подключить к Modelflare через Responses API. Для настройки понадобятся ключ Modelflare, группа с доступом к gpt-5.6-sol и два файла в домашнем каталоге. Базовый адрес для Codex — https://modelflare.dev/v1. Запросы в этой конфигурации оплачиваются с баланса Modelflare.
Если Codex работает на удалённой машине или в WSL, выполняйте проверку API из той же среды.
1. Создайте ключ для нужной модели
- Войдите в Modelflare, проверьте доступный баланс и при необходимости пополните его. Вход · Кошелёк · Пополнение криптовалютой
- В каталоге найдите
gpt-5.6-sol. Для Codex в карточке модели нужен интерфейс Responses. Сверьте точный идентификатор и список доступных групп. Модели и цены - Создайте обычный ключ с основной группой, в которой есть эта модель. Для примера подойдёт
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. Модели и цены