Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa questa guida per eseguire Codex CLI con CometAPI come provider di model. Riferimenti ufficiali:
Codex deve avere entrambi i file configurati: ~/.codex/config.toml e ~/.codex/auth.json. Non utilizzare una configurazione con solo base URL per questa integrazione.

​
Prerequisiti

RequisitoDettagli
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), oppure Windows 11 tramite WSL2
Node.js22+ (LTS consigliata)
Git2.23+ consigliato
Chiave CometAPIOttienine una da CometAPI Dashboard (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

Crea o modifica ~/.codex/config.toml con questa configurazione del provider: 
model_provider = "cometapi"
model = "gpt-5.5"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
requires_openai_auth = true
Le chiavi model_provider e model devono rimanere al livello superiore del file. La sezione [model_providers.cometapi] definisce l’endpoint CometAPI.
Se gestisci le impostazioni di Codex tramite un repository di dotfiles, mantieni la copia nei dotfiles sincronizzata con ~/.codex/config.toml. Codex legge il file da ~/.codex/config.toml.

​
Salva la tua chiave API

Crea ~/.codex/auth.json: 
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Sostituisci sk-your-cometapi-key con la tua chiave CometAPI effettiva.
Questo file è obbligatorio. auth_mode deve essere apikey, e OPENAI_API_KEY deve contenere la tua chiave CometAPI.

​
Avvia Codex

cd your-project
codex
Al primo avvio, Codex ti chiede di scegliere un tema e confermare le impostazioni di sicurezza.

​
Risoluzione dei problemi

SintomoSoluzione
API key auth is missing a keyCorreggi ~/.codex/auth.json. Deve contenere "auth_mode": "apikey" e "OPENAI_API_KEY": "sk-..."
La richiesta di accesso appare inaspettatamenteRicrea ~/.codex/auth.json con auth_mode impostato su apikey, quindi riavvia Codex
Codex usa ancora il provider OpenAI predefinitoCorreggi ~/.codex/config.toml. model_provider deve essere cometapi
Le richieste non raggiungono CometAPICorreggi ~/.codex/config.toml. [model_providers.cometapi] deve includere requires_openai_auth = true
Timeout di connessione o endpoint erratoCorreggi ~/.codex/config.toml. base_url deve essere https://api.cometapi.com/v1
Model non trovatoControlla la pagina Models per i model disponibili
Problemi su WindowsCodex richiede WSL2 su Windows — CMD/PowerShell nativo non è supportato