Inicio rápido de Codex

Esta guía conecta Codex con Modelflare y ejecuta su primera solicitud. Utilice la opción A para la configuración automatizada. Utilice la opción B para instalar Codex primero y luego cree usted mismo cada archivo requerido.

1. Crear una clave API

Inicie sesión en la consola Modelflare, abra Claves API y cree una clave que pueda acceder a gpt-5.6-sol. Elija cualquier grupo disponible no predeterminado que incluya el modelo; no existe un único grupo requerido.

Mantenga la clave API a mano. Puede utilizar el instalador o configurar los mismos archivos manualmente.

2. Elija un método de configuración

Opción A: ejecutar el instalador

macOS o Linux

Ejecute este comando como su usuario normal:

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

Cuando ya haya iniciado sesión como root en un VPS o contenedor, utilice:

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

No agregue sudo en una computadora personal normal. El script instala o actualiza Codex, realiza una copia de seguridad de los archivos existentes, solicita su clave API Modelflare y escribe la configuración del proveedor en ~/.codex.

Windows PowerShell

Abra PowerShell como su usuario normal de Windows y ejecute:

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

El instalador solicita un idioma y su clave API Modelflare, verifica el acceso a gpt-5.6-sol y realiza una copia de seguridad de los archivos existentes antes de cambiarlos. Cuando finalice, continúe con Verificar la conexión.

Opción B: cree cada archivo Codex usted mismo

Utilice esta opción cuando no desee ejecutar el script de instalación Modelflare. Siga los pasos en orden y utilice el bloque de comandos de su sistema operativo en cada paso.

La opción B crea dos archivos en su directorio .codex de nivel de usuario: config.toml y modelflare_api_key.

Paso 1: instale la CLI Codex

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

Paso 2: cree e ingrese al directorio .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

Paso 3: crear config.toml

Windows PowerShell

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

[model_providers.modelflare.auth]
command = "powershell.exe"
args = ["-NoProfile", "-NonInteractive", "-Command", "Get-Content -LiteralPath (Join-Path (Join-Path $HOME '.codex') 'modelflare_api_key') -Raw"]
'@
$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'
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"

[model_providers.modelflare.auth]
command = "sh"
args = ["-lc", "cat ~/.codex/modelflare_api_key"]
EOF
chmod 600 config.toml

macOS

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

[model_providers.modelflare.auth]
command = "sh"
args = ["-lc", "cat ~/.codex/modelflare_api_key"]
EOF
chmod 600 config.toml

Paso 4: crear modelflare_api_key

Antes de ejecutar el comando para su sistema, reemplace YOUR_MODELFLARE_API_KEY con la clave API completa que creó en la consola Modelflare. El archivo debe contener solo la clave en sí; no mantenga el marcador de posición ni agregue comillas, comillas invertidas ni espacios.

Windows PowerShell

$apiKey = @'
YOUR_MODELFLARE_API_KEY
'@
$apiKey = $apiKey.Trim()
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "modelflare_api_key"),
  $apiKey,
  $utf8NoBom
)
$apiKey = $null

Linux

cat > modelflare_api_key << 'EOF'
YOUR_MODELFLARE_API_KEY
EOF
chmod 600 modelflare_api_key

macOS

cat > modelflare_api_key << 'EOF'
YOUR_MODELFLARE_API_KEY
EOF
chmod 600 modelflare_api_key

Paso 5: iniciar 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. Verificar la conexión

Si utilizó el instalador, cierre completamente cualquier CLI, IDE o sesión de escritorio Codex que ya estuviera abierta. Abra una nueva terminal, ingrese un directorio de proyecto y ejecute:

codex --model gpt-5.6-sol

Entonces pregunta Codex:

Responda con una frase confirmando el modelo y proveedor activos.

Una respuesta normal significa que la configuración está completa.

Problemas comunes

Síntoma	Qué hacer
401	Vuelva a copiar la clave API y confirme que no se haya eliminado ni deshabilitado.
model_not_found	Edite la clave API y elija un grupo que pueda acceder a gpt-5.6-sol.
Aparece el inicio de sesión ChatGPT	Salga por completo de cada sesión de Codex y vuelva a abrir la CLI.
codex no se encuentra	Abra una nueva terminal. En Windows, pruebe con codex.cmd.