Buscar documentación...

Empieza a escribir para buscar documentación

Codex
Codex CLI

Guía de configuración de OpenAI Codex CLI

Guía paso a paso para instalar y configurar Codex CLI con UnoRouter en Windows, macOS y Linux.

Vision general

Codex CLI es el agente de codificación de OpenAI basado en terminal que lee, escribe y ejecuta código en tu proyecto mediante parches aislados y revisables. Apunta su proveedor personalizado a la URL base de UnoRouter y podrás manejarlo con cualquier modelo del catálogo, no solo con los de OpenAI.

Configuracion rapida

Coloca estos valores en el cliente. Tu clave se rellena automaticamente cuando inicias sesion.

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

Inicia sesión para autocompletar tu clave API

Compatibilidad

Chat CompletionsAPI ResponsesStreamingLlamada a herramientas

Configuracion paso a paso

  1. 1
    Instalar la CLI de Codex

    Instala la CLI de Codex 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` para apuntar Codex a UnoRouter. Define tu identificador de modelo y agrega un proveedor personalizado con la URL base de UnoRouter usando la wire API responses.

    toml
    # ~/.codex/config.toml
    model = "YOUR_MODEL_ID"
    
    [model_providers.custom]
    base_url = "https://api.unorouter.ai/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` para que Codex autentique cada solicitud.

    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 y empieza a programar.

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

codex

Inicia sesión para autocompletar tu clave API

Modelos recomendados

Modelos gratuitos que funcionan bien aqui. Pega cualquier id de modelo en el cliente.

qwen3.5-397b-a17bmistral-tiny-latestglm-4.5-flashdeepseek-r1-distill-qwen-32bllama-3.2-1b

Aspectos a tener en cuenta

  • Si Codex informa de un endpoint no compatible, confirma que `wire_api` está en `responses` y que la URL base termina en `/v1`.
  • Un 401 significa que la clave en `~/.codex/auth.json` falta o está caducada. Pega una clave nueva desde tu panel de UnoRouter y vuelve a ejecutar.
Generar clave APIModelos