Codex CLI

Configura un provider Responses e una chiave API nella shell per Codex CLI.

Installazione e preparazione

  1. Installa Node.js e poi la CLI ufficiale Codex con il comando seguente. Esegui codex --version in un nuovo terminale.
  2. Crea una chiave in routerra.ai → Chiavi API. Scegli dai modelli un ID esatto con supporto Responses e strumenti; un modello limitato a Chat Completions non funziona con questa configurazione.
npm install -g @openai/codex
codex --version

Definire il provider TOML

  1. Modifica ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) e unisci il TOML senza duplicare tabelle del provider. model_provider deve corrispondere a routerra; env_key contiene il nome della variabile, non il segreto. Sostituisci YOUR_MODEL_ID.
  2. Imposta ROUTERRA_API_KEY nella stessa shell che avvia codex. Dura solo per quella shell; salvala nel profilo se necessario. Questo provider usa la propria chiave anziché l’accesso ChatGPT. Riavvia Codex dopo le modifiche 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"

Avviare con la chiave del provider

Una variabile mancante indica che Codex non ha ereditato ROUTERRA_API_KEY; avvialo da quel terminale. Con 404 su /responses, controlla URL e protocollo: un solo /v1 e wire_api = "responses". Se funziona il testo ma non l’elenco file, scegli un modello con strumenti. Verifica la richiesta nell’utilizzo routerra.ai; il solo avvio della CLI non conferma il percorso.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Per Windows PowerShell:

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex