Vai al contenuto principale
La CLI di CometAPI legge le impostazioni da un file di configurazione TOML, dalle variabili d’ambiente e dai flag della riga di comando. Quando la stessa impostazione è disponibile da più fonti, l’ordine di priorità è: Flag CLI > file di configurazione > variabili d’ambiente > valori predefiniti

​
File di configurazione

Posizione: ~/.config/cometapi/config.toml Esegui il wizard di configurazione per creare il file di configurazione in modo interattivo: 
cometapi init
Oppure gestisci le singole impostazioni con il sottocomando config: 
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

​
Impostazioni disponibili

Chiave di configurazioneVariabile d’ambienteDescrizione
api_keyCOMETAPI_KEYAPI key (obbligatoria per tutti i comandi)
access_tokenCOMETAPI_ACCESS_TOKENAccess token per i comandi a livello di account
base_urlCOMETAPI_BASE_URLURL base dell’API (predefinito: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELModello predefinito per chat (fallback: gpt-5.4)
output_format—Formato di output predefinito: table, json, yaml, csv o markdown

​
Credenziali

La CLI utilizza due tipi di credenziali:

​
API key

Obbligatoria per tutti i comandi. La API key autentica le richieste agli endpoint dei modelli CometAPI. Crea una API key in CometAPI Console → API Keys. Impostala in uno di questi modi: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Access token

Opzionale. L’access token è obbligatorio per i comandi a livello di account: account, stats, tokens, logs e tasks. Genera un access token in CometAPI Console → Personal Settings. Impostalo in uno di questi modi: 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
Sicurezza

La CLI applica le seguenti pratiche di sicurezza:
  • Le API key e gli access token non vengono mai registrati nei log né visualizzati per intero. Nell’output diagnostico vengono mostrati solo gli ultimi 4 caratteri.
  • Il file di configurazione viene creato con permessi restrittivi (0600) — leggibile solo dal proprietario del file.
  • Le credenziali non dovrebbero mai essere salvate nel controllo di versione. Aggiungi il percorso del file di configurazione al tuo .gitignore se applicabile.
Sei responsabile di tutto l’utilizzo e di tutti gli addebiti sostenuti con le tue API key. Mantieni le tue chiavi al sicuro e ruotale se sospetti accessi non autorizzati.

​
Risoluzione dei problemi

ErroreSoluzione
API key not configuredEsegui cometapi init o imposta la variabile d’ambiente COMETAPI_KEY
Connection failedEsegui cometapi doctor per diagnosticare la connettività
Access token not configuredNecessario solo per account/stats/tokens/logs/tasks. Esegui cometapi init per aggiungerne uno