Skip to main content
Usa questa guida per eseguire Codex con CometAPI come provider di modelli. Riferimenti ufficiali:

​
Prerequisiti

​
Scegli un percorso di configurazione

Forniamo due opzioni per aiutarti a configurare Codex rapidamente.

Opzione 1: Configura Codex manualmente (consigliato)

Modifica direttamente il file ~/.codex/config.toml a livello utente. Questo è il percorso più affidabile, soprattutto per gli utenti Windows e WSL.

Opzione 2: Configura tramite script

Esegui lo script di configurazione come scorciatoia. Scrive la stessa configurazione del provider e memorizza la chiave API CometAPI per Codex.

​
Configurare Codex manualmente

Codex legge i provider personali predefiniti dal file ~/.codex/config.toml a livello utente. Configura lì il provider CometAPI, non in un file .codex/config.toml del progetto. Codex ignora le impostazioni provider e provider-auth nei file di configurazione del progetto. La configurazione consigliata usa un provider nominato cometapi e un’autenticazione basata su comando. Questo mantiene CometAPI separato dal provider OpenAI integrato, non richiede l’ereditarietà delle variabili d’ambiente della shell e non sostituisce ~/.codex/auth.json.
Memorizza la tua chiave API CometAPI in un file di chiavi locale:
Aggiungi questa configurazione a ~/.codex/config.toml:
Codex nativo su Windows usa $HOME\.codex, di solito C:\Users\<user>\.codex. WSL usa ~/.codex della distribuzione Linux. Modifica la directory che corrisponde all’ambiente in cui viene eseguito l’agente Codex.

​
Usare l’autenticazione tramite variabile d’ambiente

Se preferisci mantenere la chiave API CometAPI in una variabile d’ambiente, usa env_key invece del blocco [model_providers.cometapi.auth]. Usa questa configurazione del provider solo quando COMETAPI_KEY è disponibile nell’ambiente che avvia Codex:
Non combinare env_key con [model_providers.cometapi.auth]. Codex supporta un solo metodo di autenticazione per provider personalizzato.

​
Esegui lo script di configurazione

Lo script di configurazione è facoltativo. Scrive la stessa configurazione del provider cometapi in ~/.codex/config.toml, memorizza la tua chiave API CometAPI in ~/.codex/cometapi_key, crea backup prima delle modifiche ai file e verifica la configurazione con codex exec quando la CLI di Codex è disponibile. Per macOS, Linux o WSL, esegui l’installer interattivo:
Per una configurazione non interattiva, passa esplicitamente la chiave API:
Per PowerShell nativo su Windows, esegui l’installer interattivo:
Per una configurazione non interattiva su Windows, passa esplicitamente la chiave API:
Per impostazione predefinita, lo script non sostituisce ~/.codex/auth.json e non rimuove un accesso ChatGPT. Usa --force-auth-json o -ForceAuthJson solo se vuoi che lo script gestisca l’accesso con chiave API di Codex tramite auth.json.

​
Scegli o cambia un model ID

Usa un model ID dalla pagina Models. Nella configurazione manuale, modifica il valore di model in ~/.codex/config.toml. Per macOS, Linux o WSL, passa --model quando esegui lo script di configurazione:
Per PowerShell nativo su Windows, passa -Model quando esegui lo script di configurazione:
Lo script usa CODEX_HOME quando è impostato. In caso contrario scrive nel ~/.codex dell’ambiente corrente.

​
Verifica la configurazione

Per verificare la configurazione con la CLI di Codex, esegui questo comando in sola lettura da qualsiasi progetto locale:
Se la CLI di Codex non è disponibile in PATH, apri l’app Codex e invia un breve Prompt da un progetto locale.

​
Risoluzione dei problemi

Verifica che model_provider = "cometapi" sia presente nel file ~/.codex/config.toml a livello utente.
Aggiorna ~/.codex/cometapi_key, oppure esegui di nuovo lo script di configurazione con il valore $COMETAPI_KEY aggiornato.
Usa i passaggi manuali di PowerShell nativo di Windows, quindi esegui il comando di verifica.
Usa --key "$COMETAPI_KEY", imposta COMETAPI_KEY, oppure esegui il comando interattivo sh -c "$(curl ...)".
Verifica che base_url sia https://api.cometapi.com/v1 in ~/.codex/config.toml.
Controlla la pagina Models per i model ID disponibili.
Modifica $HOME\.codex per la modalità nativa di Windows, oppure modifica ~/.codex all’interno di WSL per la modalità agente WSL.
Non usare --force-auth-json o -ForceAuthJson a meno che tu non voglia la modalità di accesso con chiave API.