Codex CLI

Configura OpenAI Codex CLI con CometAPI: imposta openai_base_url o un provider personalizzato in config.toml, salva la tua API key in auth.json e inizia a programmare con un modello attuale.

Usa questa guida per eseguire Codex CLI con CometAPI come provider di modelli.

Riferimenti ufficiali:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

La disponibilità dei modelli cambia frequentemente. Gli esempi qui sotto usano your-model-id — sostituiscilo con un ID di modello attuale adatto alla programmazione dalla pagina Models di CometAPI.

​

Prerequisiti

Requisito	Dettagli
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) oppure Windows 11 tramite WSL2
Node.js	22+ (LTS consigliato)
Git	2.23+ consigliato
Chiave CometAPI	Ottienine una dalla Dashboard CometAPI (inizia con sk-)

​

Installa Codex CLI

npm i -g @openai/codex

Oppure tramite Homebrew:

brew install --cask codex

Verifica l’installazione:

codex --version

​

Configura CometAPI

Ci sono due modi per indirizzare Codex verso CometAPI. Scegli quello più adatto al tuo flusso di lavoro.

Semplice: openai_base_url

L’opzione più semplice: reindirizza il provider OpenAI integrato verso CometAPI con una sola riga. Non è necessario definire un provider personalizzato.

Crea ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Provider con nome

Definisci un provider cometapi con nome. Utile se vuoi passare da un provider all’altro usando --profile o model_provider.

Crea ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key indica a Codex quale variabile d’ambiente contiene la tua API key. Codex legge il valore di OPENAI_API_KEY in fase di esecuzione: questa non è la tua chiave reale.

​

Salva la tua API key

Crea ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

Sostituisci sk-your-cometapi-key con la tua vera chiave CometAPI.

Questo file è obbligatorio. Senza una voce OPENAI_API_KEY valida in auth.json, Codex termina con API key auth is missing a key.

​

Avvia Codex

cd your-project
codex

Al primo avvio, Codex ti chiederà di scegliere un tema e confermare le impostazioni di sicurezza.

​

Sostituisci il modello per sessione

Passa a un modello diverso per una singola esecuzione senza modificare config.toml:

codex --model your-model-id

​

Alternativa: variabile d’ambiente

Invece di auth.json, esporta direttamente la chiave:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Questo imposta la chiave solo per la sessione corrente del terminale. Per renderla persistente, aggiungi la riga export a ~/.zshrc o ~/.bashrc.

​

Risoluzione dei problemi

Sintomo	Soluzione
API key auth is missing a key	Assicurati che ~/.codex/auth.json contenga "OPENAI_API_KEY": "sk-..."
Compare inaspettatamente la richiesta di login	Elimina il vecchio ~/.codex/auth.json e ricrealo con la tua chiave CometAPI
Modello non trovato	Controlla la pagina Models per i modelli attualmente disponibili
Timeout di connessione	Verifica che openai_base_url o base_url sia https://api.cometapi.com/v1 in config.toml
Problemi su Windows	Codex richiede WSL2 su Windows: CMD/PowerShell nativi non sono supportati