Codex CLI

Configure un proveedor Responses y una clave API de shell para Codex CLI.

Instalación y preparación

  1. Instale Node.js y después la CLI oficial de Codex con el comando de abajo. Ejecute codex --version en un terminal nuevo.
  2. Cree una clave en routerra.ai → Claves API. Elija en Modelos un ID exacto compatible con Responses y herramientas; un modelo exclusivo de Chat Completions no sirve para esta configuración.
npm install -g @openai/codex
codex --version

Definir el proveedor TOML

  1. Edite ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) y combine el TOML sin duplicar tablas del proveedor. model_provider debe coincidir con routerra; env_key contiene el nombre de la variable, no el secreto. Sustituya YOUR_MODEL_ID.
  2. Defina ROUTERRA_API_KEY en el mismo shell que inicia codex. Solo dura esa sesión; guárdela en el perfil si necesita persistencia. Este proveedor usa su propia clave en vez del inicio de sesión de ChatGPT. Reinicie Codex tras editar TOML.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

Iniciar con la clave del proveedor

Si falta la variable, Codex no heredó ROUTERRA_API_KEY; inícielo desde ese terminal. Un 404 en /responses requiere revisar URL y protocolo: un solo /v1 y wire_api = "responses". Si funciona el texto pero no listar archivos, elija un modelo con herramientas. Compruebe la solicitud en el uso de routerra.ai; arrancar la CLI no verifica la ruta.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Para Windows PowerShell:

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex