Usa Gemini CLI con CometAPI

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 CometAPI Dashboard (inizia con `sk-`)

Installa Gemini CLI

npm install -g @google/gemini-cli

Oppure tramite Homebrew (macOS / Linux):

brew install gemini-cli

Verifica:

gemini --version

Imposta le variabili d'ambiente

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.

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

Errore Invalid API Key

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 di Node.js errata

Gemini CLI richiede Node.js 22+. Esegui node --version per controllare.

Disinstallare Gemini CLI

Esegui npm uninstall -g @google/gemini-cli.