Gemini CLI

Configura Gemini CLI con CometAPI: installa tramite npm o Homebrew, configura GEMINI_API_KEY e GOOGLE_GEMINI_BASE_URL e inizia a usare i modelli Gemini nel tuo terminale.

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

Riferimenti ufficiali:

• Gemini CLI GitHub
• Gemini CLI Authentication

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

​

Prerequisiti

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

​

Configurazione

1. Install Gemini CLI

   npm install -g @google/gemini-cli
   

   Oppure tramite Homebrew (macOS / Linux):

   brew install gemini-cli
   

   Verifica:

   gemini --version
   
2. 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 effettiva chiave CometAPI.

3. 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.

​

Rendere permanenti le variabili d’ambiente

Per evitare di riesportarle a ogni sessione, aggiungi questo alla configurazione della tua 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.

​

Risoluzione dei problemi

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