Guida all'uso di Gemini CLI - Google AI nel tuo terminale

Gemini CLI è uno strumento AI open source a riga di comando fornito da Google che porta la potenza di Gemini direttamente nel tuo terminale. Offre un modo leggero per accedere a Gemini, fornendo il percorso più diretto dal prompt al modello. Configurando un proxy, puoi usare i servizi di Gemini CLI anche in ambienti con restrizioni di rete.

Perché scegliere Gemini CLI?#

• Potente Gemini 2.5 Pro: Accesso a una finestra di contesto da 1 milione di token
• Strumenti integrati: Google Search grounding, operazioni su file, comandi Shell, web scraping
• Estensibile: Supporta MCP (Model Context Protocol) per integrazioni personalizzate
• Terminal-First: Progettato per sviluppatori che lavorano sulla riga di comando
• Open Source: Licenza Apache 2.0

Installazione#

Installazione rapida#

Esegui istantaneamente con npx (nessuna installazione richiesta)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Installazione globale con npm#

npm install -g @google/gemini-cli

Installazione con Homebrew (macOS/Linux)#

brew install gemini-cli

Requisiti di sistema#

• Node.js versione 20 o superiore
• macOS, Linux o Windows

Configurazione del proxy#

Impostare le variabili d'ambiente#

Prima di usare il proxy, configura le seguenti variabili d'ambiente:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Suggerimento: Aggiungi queste variabili d'ambiente al tuo file .bashrc, .zshrc o al file di configurazione della shell, così verranno impostate automaticamente ogni volta che avvii il terminale.

Guida rapida#

Utilizzo di base#

Avviare nella directory corrente#

gemini

Includere più directory#

gemini --include-directories ../lib,../docs

Usare un modello specifico#

gemini -m gemini-2.5-flash

Modalità script non interattiva#

Ottieni una semplice risposta testuale:

gemini -p "Explain the architecture of this codebase"

Ottieni output JSON strutturato:

gemini -p "Explain the architecture of this codebase" --output-format json

Esempi rapidi#

Avviare un nuovo progetto#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Analizzare codice esistente#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Funzionalità principali#

Comprensione e generazione di codice#

• Interrogare e modificare grandi codebase
• Generare nuove applicazioni da PDF, immagini o schizzi utilizzando capacità multimodali
• Effettuare il debug dei problemi e la risoluzione dei malfunzionamenti usando il linguaggio naturale

Automazione e integrazione#

• Automatizzare attività operative come interrogare pull request o gestire rebasing complessi
• Collegare nuove funzionalità utilizzando server MCP
• Eseguire in modalità non interattiva negli script per l'automazione dei flussi di lavoro

Funzionalità avanzate#

• Ottenere informazioni in tempo reale usando Google Search integrato
• Checkpoint di conversazione per salvare e ripristinare sessioni complesse
• File di contesto personalizzati (GEMINI.md) per adattare il comportamento al tuo progetto

Comandi comuni ed esempi#

Esplorare la codebase#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Lavorare con codice esistente#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Automatizzare i flussi di lavoro#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Interazione con il sistema#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

Integrazione con GitHub#

Usa Gemini CLI GitHub Action per integrare Gemini CLI direttamente nei tuoi workflow GitHub:

• Revisioni delle Pull Request: Revisioni del codice automatiche con feedback contestuale e suggerimenti
• Triage delle issue: Etichettare e dare priorità automaticamente alle issue GitHub in base all'analisi del contenuto
• Assistenza on-demand: Menziona @gemini-cli nelle issue e nelle pull request per ricevere aiuto con il debug, spiegazioni o delega di attività
• Workflow personalizzati: Crea workflow automatici, pianificati e on-demand su misura per le esigenze del tuo team

Risoluzione dei problemi#

Se riscontri problemi durante l'utilizzo, considera quanto segue:

1. Controllare le variabili d'ambiente#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Controllare la connessione di rete#

curl -I https://crazyrouter.com/

3. Controllare i messaggi di errore#

I messaggi di errore solitamente indicano il problema. Problemi comuni includono:

• Formato della chiave API non valido
• Problemi di connettività di rete
• Configurazione del proxy non corretta

4. Formato del proxy SOCKS#

Se usi un proxy SOCKS, assicurati che il formato sia corretto:

socks5://<user>:<pass>@<proxy>:<port>

5. Segnalare bug#

Usa il comando integrato per segnalare problemi:

/bug

Versioni di rilascio#

Preview#

Nuove versioni preview vengono rilasciate ogni martedì alle 23:59 UTC:

npm install -g @google/gemini-cli@preview

Stable#

Nuove versioni stabili vengono rilasciate ogni martedì alle 20:00 UTC:

npm install -g @google/gemini-cli@latest

Nightly#

Le versioni nightly vengono rilasciate ogni giorno alle 00:00 UTC:

npm install -g @google/gemini-cli@nightly

Utilizzo dei server MCP#

Configura i server MCP in ~/.gemini/settings.json per estendere Gemini CLI con strumenti personalizzati:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Prezzi tramite Crazyrouter#

Accedi ai modelli Gemini a tariffe scontate:

Tutti i prezzi includono uno sconto del 45% rispetto alle tariffe ufficiali.

Risorse correlate#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

Hai bisogno di aiuto? Contatta il supporto o consulta la documentazione di Crazyrouter per maggiori informazioni.