Guida di configurazione OpenAI Codex CLI

Panoramica

Codex CLI è l'agente di coding da terminale di OpenAI. Legge, scrive ed esegue codice tramite patch isolate e revisionabili. Punta il suo provider personalizzato sull'URL base di UnoRouter per usare qualsiasi modello del catalogo.

Configurazione rapida

Incolla questi valori nel client. La chiave si compila da sola quando hai effettuato l'accesso.

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

Compatibilità

Configurazione passo passo

1. 1
   Installare la CLI di Codex

   Installa Codex CLI a livello globale con npm.

   bash

   npm install -g @openai/codex

   Accedi per compilare automaticamente la tua chiave API

2. 2
   Configurare il provider del modello

   Modifica `~/.codex/config.toml`. Imposta l'id del modello e aggiungi un provider personalizzato con l'URL base di 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"

   Accedi per compilare automaticamente la tua chiave API

3. 3
   Aggiungere la tua chiave API

   Scrivi la tua chiave API UnoRouter in `~/.codex/auth.json`.

   json

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

   Accedi per compilare automaticamente la tua chiave API

4. 4
   Avviare Codex

   Esegui `codex` nella cartella del progetto.

   bash

   codex

   Accedi per compilare automaticamente la tua chiave API

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

codex

Modelli consigliati

Modelli gratuiti che funzionano qui. Incolla un qualsiasi id di modello nel client.

Cose da sapere

• !In caso di errore di endpoint non supportato, verifica che `wire_api` sia `responses` e che l'URL base termini con `/v1`.
• !Un 401 indica che la chiave in `~/.codex/auth.json` manca o è scaduta. Incolla una chiave nuova dalla dashboard UnoRouter.
• !Se Codex ignora il tuo provider, controlla il nome della tabella in `config.toml`. Gli ID provider ammettono underscore, non trattini (`model_providers.my_provider`, mai `my-provider`). `openai` è riservato e non può essere sovrascritto.