Gemini CLI

Usa Gemini CLI con una chiave gateway e l’API nativa v1beta.

Installazione e preparazione

  1. Installa Node.js 20 o successivo e il pacchetto npm ufficiale Gemini CLI qui sotto. Verifica gemini --version.
  2. Crea una chiave in routerra.ai Chiavi API per un modello Gemini nativo dai modelli. La connessione usa Gemini generateContent/streamGenerateContent, non OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Configurare il percorso Gemini nativo

  1. Imposta le tre variabili nel terminale di avvio. L’SDK aggiunge /v1beta/models/...; GOOGLE_GEMINI_BASE_URL deve quindi essere https://routerra.ai, senza /v1 né /v1beta. Sostituisci chiave e modello.
  2. Scegli Use Gemini API key; le versioni recenti possono rilevare l’autenticazione gateway. Una sessione Google o Vertex esistente può evitare questo percorso: cambiala con /auth. Per conservare le variabili, scrivi righe NAME=value in ~/.gemini/.env e riavvia. Non includere il file nei commit.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Per Windows PowerShell:

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Verificare la connessione

Prova un prompt breve con --model esplicito. Una pagina di accesso Google indica la modalità errata. /v1/v1beta o /v1beta/v1beta rivela un percorso aggiuntivo. Se il modello è rifiutato, verifica Gemini nativo anziché usare un ID OpenAI. Rimuovi valori in conflitto di GOOGLE_GENAI_USE_VERTEXAI o GOOGLE_GENAI_USE_GCA, riavvia e controlla l’utilizzo routerra.ai.