Questa pagina è stata tradotta dall'API Cloud Translation.

Prova pratica dell'interfaccia a riga di comando Gemini

1. Introduzione

In questo codelab, imparerai a utilizzare Gemini CLI, un agente AI open source che porta la potenza di Gemini direttamente nel tuo terminale.

Il progetto Gemini CLI è open source e puoi visualizzare la roadmap pubblica qui.

Durante il codelab, seguirai un approccio passo passo in attività come:

Installazione dell'interfaccia a riga di comando di Gemini
Configurazione di base
Esplorare gli strumenti e i comandi integrati nell'interfaccia a riga di comando di Gemini
Personalizzazione dell'interfaccia a riga di comando di Gemini tramite il file GEMINI.md
Esplorare alcuni casi d'uso con l'interfaccia a riga di comando di Gemini

Che cosa ti serve

Browser web Chrome
Un account Gmail
Una macchina locale con Node 20+ installato.

Questo codelab è pensato per utenti e sviluppatori di tutti i livelli (inclusi i principianti).

2. Installazione

Prima di eseguire la configurazione e l'interfaccia a riga di comando Gemini, creiamo una cartella che utilizzeremo come cartella principale per tutti i progetti che potremmo creare al suo interno. Questo è un punto di partenza per l'utilizzo della CLI Gemini, anche se farà riferimento anche ad altre cartelle del sistema, che esamineremo in un secondo momento, se necessario.

Crea una cartella di esempio (gemini-cli-projects) e vai alla cartella tramite i comandi mostrati di seguito. Se preferisci utilizzare un altro nome per la cartella, fallo pure.

mkdir gemini-cli-projects

Andiamo alla cartella:

cd gemini-cli-projects

Per eseguire Gemini CLI, puoi utilizzare uno dei seguenti metodi:

Esegui il comando seguente:

npx https://github.com/google-gemini/gemini-cli

Puoi installare prima l'interfaccia a riga di comando di Gemini a livello globale sul tuo sistema. Assicurati di disporre dei diritti di amministratore per farlo.

npm install -g @google/gemini-cli

e poi eseguilo con questo comando:

gemini

Supponendo che tu abbia avviato Gemini CLI con uno dei metodi sopra indicati, dovresti visualizzare la seguente schermata che ti chiede di scegliere un tema. Procedi e seleziona quello che preferisci:

Una volta selezionato, ti verrà chiesto il metodo di autenticazione. Ti consigliamo di utilizzare il tuo Account Google personale e non account non Google o correlati a Google Workspace in questo lab. Questa licenza senza costi ti consente di accedere a Gemini 2.5 Pro e alla sua finestra contestuale da 1 milione di token. Il livello senza costi consente 60 richieste di modello al minuto e 1000 richieste al giorno senza costi.

Se raggiungi i limiti con la quota senza costi attuale assegnata agli Account Google, puoi scegliere di utilizzare la chiave API Gemini o anche Google Cloud Vertex AI, dove dovrai disporre di un ID progetto e del nome della località per quel progetto. Se prevedi di utilizzare altri metodi di autenticazione, consulta la sezione Autenticazione della documentazione.

Procedi e fai clic su Invio. Si aprirà una pagina di autenticazione di Google nel browser. Procedi con l'autenticazione con il tuo Account Google, accetta i termini e, una volta autenticato correttamente, noterai che la CLI Gemini è pronta e in attesa del tuo comando. Di seguito è riportato uno screenshot di esempio:

Digita /help (barra) e vedrai una serie di comandi e scorciatoie da tastiera come mostrato di seguito:

La nostra prima interazione con Gemini CLI

Digita il tuo primo messaggio nella casella. Dovremo fornire una query come:

Noterai che la nostra query ha generato uno strumento GoogleSearch (uno strumento integrato nell'interfaccia a riga di comando di Gemini) che è stato richiamato. Questo è un modo interessante in cui abbiamo già utilizzato uno dei potenti strumenti integrati di Gemini CLI, ovvero GoogleSearch, che basa le sue risposte sulle informazioni che ottiene dal web. Nella prossima sezione vedremo altri strumenti.

Per ora chiudiamo l'interfaccia a riga di comando di Gemini. Puoi farlo tramite il comando /quit oppure puoi eseguire Ctrl-C due volte nella sessione del terminale interattivo della CLI Gemini.

File di personalizzazione dell'interfaccia a riga di comando di Gemini : settings.json

Se ricordi quando abbiamo avviato Gemini CLI per la prima volta, ci è stato chiesto di selezionare un tema e poi un metodo di autenticazione. Nelle esecuzioni successive di Gemini CLI, non ti verrà più chiesto di selezionare un tema e un metodo di autenticazione. Ciò significa che viene salvato da qualche parte e il file che utilizza si chiama settings.json ed è il modo per personalizzare Gemini CLI.

Le impostazioni vengono applicate con la seguente precedenza:

Workspace: .gemini/settings.json (override delle impostazioni utente e di sistema).
Utente: ~/.gemini/settings.json (esegue l'override delle impostazioni di sistema).
Sistema: /etc/gemini-cli/settings.json (si applica a tutti gli utenti).

Se ricordi, al momento della selezione del tema, abbiamo chiesto di salvare le impostazioni nelle impostazioni utente. Visita la pagina ~/.gemini folder e noterai il file settings.json.

Di seguito è riportato il mio file settings.json. Se avessi selezionato un altro tema, ne vedresti il nome.

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal"
}

3. Parametri dei comandi dell'interfaccia a riga di comando di Gemini

Quando avvii Gemini CLI, puoi fornire alcuni parametri della riga di comando. Per visualizzare un elenco completo delle opzioni, puoi utilizzare --help come mostrato di seguito.

gemini --help

Dovrebbe essere visualizzata l'intera gamma di opzioni disponibili. Ti invitiamo a consultare la documentazione qui.

Diamo un'occhiata ad alcuni. Il primo consiste nel configurare l'interfaccia a riga di comando di Gemini in modo da utilizzare il modello Pro o Flash. Al momento della stesura di questo lab, questi sono gli unici due modelli supportati. Per impostazione predefinita viene utilizzato il modello Gemini 2.5 Pro, ma se vuoi utilizzare il modello Flash, puoi farlo quando avvii Gemini CLI tramite il parametro -m, come mostrato di seguito:

gemini -m "gemini-2.5-flash"

Se inizi nel modo sopra descritto, puoi controllare il modello in basso a destra del terminale Gemini CLI, come mostrato di seguito:

Modalità non interattiva

Un'opzione interessante è eseguire l'interfaccia a riga di comando di Gemini in modalità non interattiva. Ciò significa che fornisci direttamente il prompt e Gemini risponderà senza aprire il terminale interattivo di Gemini CLI. Questa opzione è molto utile se prevedi di utilizzare l'interfaccia a riga di comando di Gemini in modo automatico nell'ambito dello script o di qualsiasi altro processo di automazione. Utilizzi il parametro -p per fornire il prompt all'interfaccia a riga di comando di Gemini come mostrato di seguito:

gemini -p "What is the gcloud command to deploy to Cloud Run"

Tieni presente che non è possibile continuare la conversazione con domande di follow-up.

4. Interfaccia a riga di comando di Gemini - Strumenti integrati

La CLI Gemini include un insieme di strumenti integrati e la documentazione degli strumenti afferma che "il modello Gemini utilizza questi strumenti per interagire con il tuo ambiente locale, accedere alle informazioni ed eseguire azioni. Questi strumenti migliorano le funzionalità della CLI, consentendole di andare oltre la generazione di testo e di assistere in un'ampia gamma di attività".

Per ottenere un elenco degli strumenti integrati attuali, dobbiamo semplicemente richiamare il comando /tools come mostrato di seguito:

Una delle prime cose che dovresti chiederti è se l'interfaccia a riga di comando di Gemini può semplicemente chiamare questi strumenti quando vuole. La risposta predefinita è no, quando si tratta di operazioni sensibili che potrebbero comportare la scrittura nel sistema locale, la lettura da un sistema esterno, l'accesso alla rete esterna e così via.

Quando avvii la CLI, è disponibile un --yolomode che non utilizzeremo. La CLI Gemini ti chiederà l'autorizzazione per eseguire lo strumento che ha scelto. Puoi rifiutare l'autorizzazione, consentire l'esecuzione una sola volta o concedere l'autorizzazione generale per l'esecuzione continua. Sei e dovresti avere il pieno controllo della situazione.

Forniamo un prompt che farà scegliere a Gemini CLI uno degli strumenti integrati da eseguire e che ci darà una buona comprensione di come funziona il tutto.

Vorremmo ricevere informazioni sulle ultime notizie finanziarie in tutto il mondo e salvarle in un file nella nostra directory di lavoro locale da cui abbiamo avviato Gemini CLI. Forniamo il seguente prompt:

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

Immagina per un momento cosa dovrebbe fare. Idealmente, deve eseguire una ricerca su Google per ottenere notizie da alcune fonti di informazioni pertinenti che possono fornirgli notizie finanziarie. Dopodiché, deve creare un file denominato finance-news-today.txt (un'operazione di scrittura sul sistema locale che richiederà la tua autorizzazione) con i relativi contenuti.

Vediamo cosa succede (dovresti procedere allo stesso modo sulla tua macchina).

La prima cosa che fa è richiamare lo strumento GoogleSearch per cercare sul web.

Una volta completata la ricerca, i dati vengono recuperati come mostrato di seguito:

Una volta fatto, è pronto per scrivere nel file e utilizzerà lo strumento WriteFile, ma poiché si tratta di un'operazione sensibile (scrittura), ti chiederà l'autorizzazione. Puoi decidere il tipo di autorizzazione , ad esempio Consenti una volta, Consenti sempre e così via. Per ora selezioniamo Consenti una volta.

Le informazioni verranno scritte nel file e di seguito verrà visualizzato un messaggio di operazione riuscita:

Come facciamo a verificare se il file è stato scritto o meno? Possiamo usare @file per chiedere di leggere i contenuti. Viene visualizzato un prompt come mostrato di seguito. Mentre digitiamo @, viene visualizzato un elenco di file nella cartella corrente e viene mostrato il file appena creato. Selezionala e invia il prompt. Il mio prompt è mostrato di seguito:

read the contents of @finance-news-today.txt

In questo modo vengono richiamati gli strumenti richiesti (ReadManyFiles, ReadFile) e i contenuti vengono visualizzati come mostrato di seguito:

È anche un buon momento per imparare a lavorare direttamente con la shell dall'interfaccia a riga di comando di Gemini. Puoi passare alla modalità shell premendo ! nella casella del messaggio. Verrà attivata una modalità Shell. Puoi tornare indietro premendo di nuovo ! o il tasto ESC.

In modalità shell, vedrai ! all'inizio del prompt, come mostrato di seguito:

Posso eseguire il controllo direttamente utilizzando comandi standard come pwd e ls, come mostrato di seguito:

Oggi possiamo stampare i contenuti del file tramite il comando cat.

Esercizio: ecco un breve esercizio da provare. Scegli un feed RSS a tua scelta. Fornisci un prompt all'interfaccia a riga di comando di Gemini per recuperare i contenuti del feed RSS e formattare i risultati in un modo specifico. È un buon modo per automatizzare qualcosa all'inizio della giornata.

Suggerimento:alla fine, l'interfaccia a riga di comando di Gemini dovrebbe utilizzare lo strumento WebFetch.

5. Configurazione dei server Model Context Protocol (MCP)

Un server MCP è un'applicazione che espone strumenti e risorse alla CLI Gemini tramite il Model Context Protocol, consentendole di interagire con sistemi e origini dati esterni. I server MCP fungono da ponte tra il modello Gemini e il tuo ambiente locale o altri servizi come le API.

Un server MCP consente all'interfaccia a riga di comando di Gemini di rilevare ed eseguire strumenti, estendendo così le funzionalità dell'interfaccia a riga di comando di Gemini per eseguire azioni oltre alle funzionalità integrate, come l'interazione con database, API, script personalizzati o workflow specializzati.

La CLI Gemini supporta la configurazione dei server MCP per scoprire e utilizzare strumenti personalizzati. Se hai avviato l'interfaccia a riga di comando di Gemini, puoi controllare i server MCP configurati tramite il comando /mcp, come mostrato di seguito:

Se non hai configurato alcun server MCP, verrà avviata la documentazione del server MCP di Gemini CLI.

Puoi configurare i server MCP a livello globale nel file ~/.gemini/settings.json o nella directory principale del progetto. Crea o apri il file .gemini/settings.json. All'interno del file, devi aggiungere il blocco di configurazione mcpServers, come mostrato di seguito:

"mcpServers": {
    "server_name_1": {},
    "server_name_2": {},
    "server_name_n": {}
 }

Ogni configurazione del server supporta le seguenti proprietà ( documentazione di riferimento):

Obbligatorio (uno dei seguenti)

command (string): percorso dell'eseguibile per il trasporto Stdio
url (stringa): URL endpoint SSE (ad es. "http://localhost:8080/sse")
httpUrl (stringa): URL dell'endpoint di streaming HTTP

Facoltativo

args (string[]): argomenti della riga di comando per il trasporto Stdio
headers (oggetto): intestazioni HTTP personalizzate quando si utilizza url o httpUrl
env (oggetto): variabili di ambiente per il processo del server. I valori possono fare riferimento alle variabili di ambiente utilizzando la sintassi $VAR_NAME o ${VAR_NAME}
cwd (stringa): directory di lavoro per il trasporto Stdio
timeout (numero): timeout della richiesta in millisecondi (valore predefinito: 600.000 ms = 10 minuti)
trust (booleano): se è true, ignora tutte le conferme di chiamata dello strumento per questo server (valore predefinito: false)
includeTools (string[]): elenco dei nomi degli strumenti da includere da questo server MCP. Se specificato, da questo server saranno disponibili solo gli strumenti elencati qui (comportamento della whitelist). Se non specificato, tutti gli strumenti del server sono attivati per impostazione predefinita.
excludeTools (string[]): elenco dei nomi degli strumenti da escludere da questo server MCP. Gli strumenti elencati qui non saranno disponibili per il modello, anche se sono esposti dal server. Nota: excludeTools ha la precedenza su includeTools. Se uno strumento è presente in entrambi gli elenchi, verrà escluso.

Procediamo con la configurazione di uno dei server MCP chiave di cui potresti aver bisogno se utilizzi GitHub. Tuttavia, tieni presente che Gemini CLI richiamerà gli strumenti git presenti nel tuo sistema e potrai anche istruire Gemini CLI a utilizzarli. Quindi, tieni presente che ti aiuterà con i comandi e li eseguirà per te, ma devi configurare questi strumenti sul tuo sistema.

Server MCP GitHub

Il server MCP ufficiale di GitHub fornisce una documentazione sufficiente sugli strumenti che espone e su come configurarli. Puoi scegliere se eseguirlo in locale o in remoto, poiché Gemini CLI supporta anche i server MCP remoti.

In questo tutorial abbiamo scelto di utilizzare l'opzione Remote MCP Server in GitHub. Per farlo, devi prima disporre di un token di accesso personale (PAT) di GitHub.

Una volta ottenuto, devi aggiungere l'oggetto server MCP nel file settings.json. Di seguito è riportato il file settings.json completo sul mio sistema. Potresti avere altre impostazioni, ma l'oggetto mcpServers deve essere come indicato di seguito:

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
       "github": {
            "httpUrl": "https://api.githubcopilot.com/mcp/",
            "headers": {
                "Authorization": "GITHUB_PAT"
            },
            "timeout": 5000
       }
  }
}

Puoi riavviare Gemini CLI o eseguire un comando /mcp refresh dopo aver aggiornato settings.json con la configurazione del server GitHub MCP. Lo screenshot seguente evidenzia il server Github MCP configurato sul mio computer e i vari strumenti ora disponibili per la CLI Gemini per interagire con MCP.

Iniziamo con un prompt che richiamerà uno degli strumenti del server GitHub MCP. Digita il seguente prompt:

Tieni presente che verrà selezionato lo strumento corretto dal server GitHub MCP, ma come per altri strumenti integrati, sarà necessario fornire l'autorizzazione esplicita per richiamare lo strumento. Continua e vedi che output ottieni.

Ora devi lavorare con uno dei tuoi progetti GitHub. Fornisci le query in linguaggio naturale, ad esempio:

Descrivimi <repo-name>.
Clona <repo-name> sulla mia macchina locale.
Descrivi @<nome file> o @<nome directory>/
Quali sono i diversi componenti di questo repository?
Ho apportato le modifiche necessarie. Puoi eseguire il push delle modifiche su GitHub e utilizzare gli strumenti del server GitHub MCP per farlo.

Più avanti nel lab, faremo un esercizio per lavorare in dettaglio con il server MCP di GitHub.

Server MCP Context7

Context7 fornisce documentazione aggiornata per LLM ed editor di codice AI. Se vuoi fornire il contesto all'LLM con la documentazione più recente per il framework che preferisci, il server Context7 MCP è una buona opzione da configurare.

Assicurati che la tua biblioteca sia elencata nella home page di Context7.

Ecco il server MCP che devi aggiungere nel file settings.json.

"context7": {
      "httpUrl": "https://mcp.context7.com/mcp"
    }

Una volta configurato il server MCP e caricata correttamente la CLI Gemini, dovresti essere in grado di visualizzare gli strumenti Context7 come mostrato di seguito:

Ora puoi essere specifico nel prompt e chiedere all'interfaccia a riga di comando di Gemini di utilizzare Context7 per la documentazione più recente durante la generazione dell'applicazione o dello snippet di codice, utilizzando un framework XYZ specifico.

Ecco un esempio di prompt in cui voglio scrivere un agente utilizzando l'Agent Development Kit (ADK) di Google. Nel prompt specifico di cercare la documentazione relativa tramite il server MCP Context7.

I am working on coding an Agent using the Agent Development Kit (ADK) from Google. I would like to know how to create the LLMAgent in Python. Use Context7 for the latest documentation on ADK and specifically use /google/adk-python, /google/adk-docs and adk.wiki

Ecco l'output ricevuto:

Server MCP di Presentazioni Google

Il progetto GitHub all'indirizzo https://github.com/matteoantoci/google-slides-mcp fornisce un server MCP per interagire con l'API Google Slides. Consente di creare, leggere e modificare le presentazioni Google in modo programmatico.

I passaggi per configurare il server MCP sono indicati nel progetto. Avrai bisogno di un ambiente Node.js in cui creare il server, configurare un progetto Google Cloud e i token OAuth 2.0, quindi configurare il server MCP nel file settings.json.

Una volta configurato, puoi eseguire prompt come:

Estrai le informazioni più recenti da "web_url", riassumile in punti chiave e crea una presentazione denominata "my_presentation".

Prova anche tu!

Altri server MCP

Ecco un elenco aggiuntivo di server MCP che potrebbero interessarti:

Server Firebase MCP
Servizi multimediali Google Gen AI (Imagen, Veo, Lyria)
MCP Toolbox for Databases (lavora con i database Firestore, BigQuery e Google Cloud)
Server MCP di Google Workspace (funziona con Documenti, Fogli, Calendar e Gmail)

Le istruzioni per configurare i server MCP sopra indicati sono pubblicate in questo post del blog.

6. Casi d'uso da provare

L'interfaccia a riga di comando di Gemini può essere applicata a un'ampia gamma di casi d'uso che riguardano sia gli sviluppatori che gli utenti non sviluppatori. Di seguito sono riportati alcuni scenari che puoi provare a seconda della tua area di interesse.

In ognuno di questi casi, viene fornito il prompt. Puoi provare questa funzionalità in modalità interattiva o non interattiva dell'interfaccia a riga di comando di Gemini tramite il parametro -p al momento dell'avvio dell'interfaccia a riga di comando di Gemini.

Organizzare file/cartelle

Puoi utilizzare la CLI Gemini per organizzare i file in base ai tipi in varie cartelle, a seconda delle necessità. Vai a una cartella sul tuo computer che contiene diversi file .txt, .png, .jpg, .pdf, .mp4 e altri. Probabilmente si tratta del desktop o della cartella Download.

Vai alla cartella e avvia l'interfaccia a riga di comando di Gemini. Chiediamogli di creare prima diverse cartelle: Immagini, Documenti, Video e poi di organizzare i file nelle cartelle.

La CLI Gemini spesso ti chiede l'autorizzazione prima di eseguire i comandi, in particolare quelli che modificano il file system (come la scrittura, lo spostamento o l'eliminazione di file). Controlla sempre attentamente questi prompt prima di concedere l'autorizzazione. È la tua rete di sicurezza.

Create the following folders "Images","Documents","Videos"

Poi, inserisci il seguente prompt:

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

Di seguito sono riportati alcuni altri scenari di organizzazione (le richieste sono riportate accanto a ogni scenario):

Riepilogo:per ogni documento nella cartella "Documenti", crea un file txt nella stessa cartella denominato "summary_ORIGINAL_FILENAME.txt" che contenga un riepilogo di tre frasi dei punti principali del documento.
Categorizzazione per tipo:scansiona tutti i file PDF e DOCX in questa directory. Sposta tutti i file con la parola "fattura" nel nome o nel contenuto nella cartella "Finanziario/Fatture". Sposta i file con "ricevuta" in "Finanziario/Ricevute". Tutti gli altri file .docx vengono inseriti in "Report".
Estrazione delle informazioni chiave (e "tagging"): per ogni file PDF nella cartella "Finanziario/Fatture", leggi i contenuti. Se trovi una data, rinomina il file in modo che la includa nel formato AAAA-MM-GG, ad esempio ‘invoice_2025-07-26_original_name.pdf'.