Guía de configuración de OpenAI Codex CLI

Visión general

Codex CLI es el agente de codificación de terminal de OpenAI. Lee, escribe y ejecuta código mediante parches revisables en un sandbox. Apunta su proveedor personalizado a la URL base de UnoRouter para usar cualquier modelo del catálogo.

Configuración rápida

Pega estos valores en el cliente. Tu clave se rellena sola si has iniciado sesión.

URL base: https://api.unorouter.com/v1
Clave API: YOUR_API_KEY

Compatibilidad

Configuración paso a paso

1. 1
   Instalar la CLI de Codex

   Instala Codex CLI de forma global con npm.

   bash

   npm install -g @openai/codex

   Inicia sesión para autocompletar tu clave API

2. 2
   Configurar el proveedor de modelos

   Edita `~/.codex/config.toml`. Indica el id de tu modelo y añade un proveedor personalizado con la URL base de UnoRouter usando la wire API responses.

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   model_provider = "unorouter"
   
   [model_providers.unorouter]
   name = "UnoRouter"
   base_url = "https://api.unorouter.com/v1"
   wire_api = "responses"

   Inicia sesión para autocompletar tu clave API

3. 3
   Agregar tu clave API

   Escribe tu clave API de UnoRouter en `~/.codex/auth.json`.

   json

   // ~/.codex/auth.json
   {
     "OPENAI_API_KEY": "YOUR_API_KEY"
   }

   Inicia sesión para autocompletar tu clave API

4. 4
   Iniciar Codex

   Ejecuta `codex` en el directorio de tu proyecto.

   bash

   codex

   Inicia sesión para autocompletar tu clave API

$env:OPENAI_BASE_URL="https://api.unorouter.com/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

Modelos recomendados

Modelos gratuitos que funcionan aquí. Pega cualquier id de modelo en el cliente.

Aspectos a tener en cuenta

• !Si aparece un error de endpoint no compatible, confirma que `wire_api` sea `responses` y que la URL base termine en `/v1`.
• !Un 401 significa que la clave de `~/.codex/auth.json` falta o está caducada. Pega una clave nueva desde tu panel de UnoRouter.
• !Si Codex ignora tu proveedor, revisa el nombre de la tabla en `config.toml`. Los IDs de proveedor admiten guiones bajos, no guiones (`model_providers.my_provider`, nunca `my-provider`). `openai` está reservado y no se puede sobrescribir.