Codex configuración

Esta guía conecta Codex a 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.

Tener la llave lista. Puede utilizar el instalador o configurar los mismos archivos manualmente.

2. Elija un método de configuración

Opción A: ejecutar el instalador

¿Aún no te sientes cómodo con el terminal? Comience con la guía interactiva de primera ejecución. Es sólo un ensayo visual y no cambia tu computadora.

macOS o Linux
Windows PowerShell

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, use:

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 de Modelflare y escribe la configuración del proveedor en ~/.codex.

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 de Modelflare, verifica el acceso a gpt-5.6-sol y realiza una copia de seguridad de los archivos existentes antes de cambiarlos. Cuando termine, continúe con Verificar la conexión.

Opción B: crea tú mismo cada archivo Codex

Utilice esta opción cuando no desee ejecutar el script de configuración de 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 auth.json.

Paso 1: instalar Codex CLI

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

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

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

Paso 2: crear e ingresar al directorio `.codex`

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

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

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

Paso 3: crear `config.toml`

$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
)

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

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

Paso 4: crear `auth.json`

Reemplace YOUR_MODELFLARE_API_KEY en el objeto JSON con la clave API completa que creó en la consola Modelflare. Este archivo debe seguir siendo JSON válido y utilizar el campo OPENAI_API_KEY; no agregue un bloque de comando de proveedor auth. Las versiones actuales del Codex requieren requires_openai_auth = true para esta ruta de clave API.

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

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

Paso 5: iniciar Codex

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

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

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 sesión de escritorio, IDE o CLI del Codex que ya estuviera abierta. Abra una nueva terminal, ingrese un directorio de proyecto y ejecute:

codex --model gpt-5.6-sol

Después de finalizar la configuración, también puede descargar la aplicación Codex.

Entonces pregúntale a Codex:

Reply with one sentence confirming the active model and provider.

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 haya sido eliminada ni deshabilitada.
`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 de ChatGPT	Salga por completo de todas las sesiones del Codex y vuelva a abrir la CLI.
`codex` no se encuentra	Abrir una nueva terminal. En Windows, pruebe `codex.cmd`.