Быстрый старт Codex — документация Modelflare

В этом руководстве Codex подключается к Modelflare и выполняет свой первый запрос. Используйте вариант А для автоматической настройки. Используйте вариант B, чтобы сначала установить Codex, а затем создайте каждый необходимый файл самостоятельно.

1. Создайте ключ API

Войдите в консоль Modelflare, откройте API Keys и создайте ключ, который будет иметь доступ к gpt-5.6-sol. Выберите любую доступную группу не по умолчанию, в которой указана модель; нет единой необходимой группы.

Держите ключ наготове. Вы можете использовать установщик или настроить те же файлы вручную.

2. Выберите способ настройки

Вариант А: запустить установщик

Ещё не освоились с терминалом? Сначала откройте интерактивную репетицию. Это только визуальная тренировка, компьютер не изменится.

macOS или Linux

Запустите эту команду от имени обычного пользователя:

curl -fsSL https://modelflare.dev/install/codex.sh | sh

Если вы уже вошли в систему как root на VPS или контейнере, используйте:

curl -fsSL https://modelflare.dev/install/codex.sh | MODELFLARE_ALLOW_ROOT=1 sh

Не добавляйте sudo на обычный персональный компьютер. Сценарий устанавливает или обновляет Codex, создает резервные копии существующих файлов, запрашивает ваш ключ API Modelflare и записывает конфигурацию провайдера в ~/.codex.

Windows PowerShell

Откройте PowerShell как обычный пользователь Windows и запустите:

irm https://modelflare.dev/install/codex.ps1 | iex

Программа установки запрашивает язык и ваш ключ API Modelflare, проверяет доступ к gpt-5.6-sol и создает резервные копии существующих файлов перед их изменением. По завершении продолжайте Проверка соединения.

Опция B: создайте каждый файл Codex самостоятельно.

Используйте эту опцию, если вы не хотите запускать сценарий установки Modelflare. Следуйте инструкциям по порядку и на каждом этапе используйте командный блок для вашей операционной системы.

Вариант B создает два файла в каталоге .codex вашего уровня пользователя: config.toml и auth.json.

Шаг 1: установите Codex CLI

Windows PowerShell

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

Linux

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

macOS

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

Шаг 2: создайте и войдите в каталог .codex.

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"

Linux

mkdir -p ~/.codex
cd ~/.codex

macOS

mkdir -p ~/.codex
cd ~/.codex

Шаг 3: создайте config.toml

Windows PowerShell

$config = @'
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

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "config.toml"),
  $config,
  $utf8NoBom
)

Linux

cat > config.toml << 'EOF'
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

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml

macOS

cat > config.toml << 'EOF'
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

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
chmod 600 config.toml

Шаг 4: создайте auth.json

Замените YOUR_MODELFLARE_API_KEY внутри JSON-объекта полным ключом API, созданным в консоли Modelflare. Файл должен оставаться корректным JSON и использовать поле OPENAI_API_KEY; не добавляйте командный блок auth в provider. Текущим версиям Codex для этого пути API Key требуется requires_openai_auth = true.

Windows PowerShell

$authJson = @'
${CODEX_MANUAL_AUTH_JSON}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "auth.json"),
  $authJson,
  $utf8NoBom
)

Linux

cat > auth.json << 'EOF'
${CODEX_MANUAL_AUTH_JSON}
EOF
chmod 600 auth.json

macOS

cat > auth.json << 'EOF'
${CODEX_MANUAL_AUTH_JSON}
EOF
chmod 600 auth.json

Шаг 5: запустите Codex

Windows PowerShell

Set-Location $HOME
New-Item -ItemType Directory -Force "my-codex-project" | Out-Null
Set-Location "my-codex-project"
codex --model gpt-5.6-sol

Linux

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

macOS

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

3. Проверьте соединение

Если вы использовали установщик, полностью закройте любой сеанс CLI, IDE или рабочего стола Codex, который уже был открыт. Откройте новый терминал, введите каталог проекта и запустите:

codex --model gpt-5.6-sol

После завершения настройки также можно скачать Codex App.

Тогда спросите Codex:

Ответьте одним предложением, подтверждающим активную модель и поставщика.

Нормальный ответ означает, что настройка завершена.

Распространенные проблемы

Симптом	Что делать
401	Скопируйте ключ API повторно и убедитесь, что он не был удален или отключен.
model_not_found	Отредактируйте ключ API и выберите группу, которая может получить доступ к gpt-5.6-sol.
ChatGPT появляется логин	Полностью закройте каждый сеанс Codex и снова откройте CLI.
codex не найден	Откройте новый терминал. В Windows попробуйте codex.cmd.