Cerca documentazione...

Inizia a digitare per cercare nella documentazione

Codex
Codex CLI

Guida di configurazione OpenAI Codex CLI

Guida passo-passo per installare e configurare Codex CLI con UnoRouter su Windows, macOS e Linux.

Panoramica

Codex CLI è l'agente di codifica da terminale di OpenAI che legge, scrive ed esegue codice nel tuo progetto tramite patch isolate e verificabili. Punta il suo provider personalizzato all'URL di base di UnoRouter e potrai pilotarlo con qualsiasi modello del catalogo, non solo con quelli di OpenAI.

Configurazione rapida

Inserisci questi valori nel client. La tua chiave si compila automaticamente quando accedi.

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

Accedi per compilare automaticamente la tua chiave API

Compatibilita

Chat CompletionsAPI ResponsesStreamingChiamata di strumenti

Configurazione passo passo

  1. 1
    Installare la CLI di Codex

    Installa la CLI di Codex globalmente con npm.

  2. 2
    Configurare il provider del modello

    Modifica `~/.codex/config.toml` per puntare Codex a UnoRouter. Imposta l'ID del tuo modello e aggiungi un provider personalizzato con l'URL di base di 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"

    Accedi per compilare automaticamente la tua chiave API

  3. 3
    Aggiungere la tua chiave API

    Scrivi la tua chiave API di UnoRouter in `~/.codex/auth.json` affinché Codex autentichi ogni richiesta.

    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 directory del tuo progetto e inizia a programmare.

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

codex

Accedi per compilare automaticamente la tua chiave API

Modelli consigliati

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

mistral-smallgemini-3-flash-previewqwen3-32bqwen3.6-27bmistral-small-latest

Cose da sapere

  • Se Codex segnala un endpoint non supportato, conferma che `wire_api` sia impostato su `responses` e che l'URL di base termini con `/v1`.
  • Un 401 significa che la chiave in `~/.codex/auth.json` è mancante o scaduta. Incolla una chiave fresca dalla tua dashboard di UnoRouter e riavvia.
Genera chiave APIModelli