Gemini CLI - CometAPI Documentation

Usa questa guida per eseguire Gemini CLI con CometAPI come endpoint API. Riferimenti ufficiali:

La disponibilità dei modelli cambia nel tempo. Controlla la pagina Modelli di CometAPI per i modelli Gemini disponibili.

Prerequisiti

Requisito	Dettagli
Node.js	22+ (LTS consigliata)
OS	macOS, Linux o Windows
Chiave CometAPI	Dal tuo Dashboard CometAPI (inizia con `sk-`)

Install Gemini CLI

npm install -g @google/gemini-cli

Oppure tramite Homebrew (macOS / Linux):

brew install gemini-cli

Verifica:

gemini --version

Set environment variables

export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

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

Start Gemini CLI

cd your-project
gemini

Al primo avvio, ti verrà chiesto di scegliere un tema, confermare l’avviso di sicurezza e autorizzare la directory di lavoro.

Per evitare di riesportarle a ogni sessione, aggiungi queste righe alla configurazione della shell:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

Riavvia il terminale affinché le modifiche abbiano effetto.

Sintomo	Soluzione
`Invalid API Key` error	Verifica che `GEMINI_API_KEY` sia impostata correttamente. Esegui `echo $GEMINI_API_KEY` per controllare
`fetch failed`	Le restrizioni di rete potrebbero bloccare la connessione. Prova un proxy a livello di sistema
Versione Node.js errata	Gemini CLI richiede Node.js 22+. Esegui `node --version` per controllare
Disinstallazione	`npm uninstall -g @google/gemini-cli`