# Migrazione da Gemini CLI ad Antigravity CLI: una guida > Installazione di agy, migrazione di configurazione, plugin e variabili d’ambiente; controlli, errori comuni e restrizioni regionali. Source: https://ailoot.ai/blog/it/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/it/gemini-cli-to-antigravity-cli-migration/ Language: it Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-12922abf784da78ea6ce644974f9a7930f46e55db9f927643de3a5fad891a402 Il 19 maggio 2026, Google ha annunciato che il 18 giugno chiuderà il vecchio Gemini CLI per tutti i piani Free, Pro e Ultra. Due settimane dopo la pubblicazione di questa guida, il comando `gemini` smetterà di elaborare le richieste. Migrare da Gemini CLI ad Antigravity CLI con il comando `agy` è l’unico modo per continuare a usare gli strumenti Google. `agy` è sviluppato in Go e si avvia decine di volte più velocemente. Se hai qualcosa in esecuzione su Gemini CLI—script CI, processi cron notturni, l’estensione IDE Gemini Code Assist—questa guida spiega come migrare in una sera senza rompere nulla.
La connessione ai modelli e l’utilizzo dell’API sono trattati nella [documentazione Ailoot](https://ailoot.ai/docs/).
## Che cosa smetterà esattamente di funzionare il 18 giugno 2026?
Punto chiave Il 18 giugno 2026, Gemini CLI e l’estensione Gemini Code Assist per VS Code smetteranno di elaborare richieste per tre categorie di utenti: il piano Free, Google AI Pro e Google AI Ultra. Le nuove installazioni di Gemini Code Assist su GitHub non saranno più disponibili; quelle esistenti verranno disabilitate «nelle settimane successive». L’accesso API a pagamento tramite Gemini Enterprise Agent Platform e le licenze Code Assist Standard/Enterprise continueranno a funzionare senza cambiamenti.
Non si tratta della «chiusura completa del progetto», ma dell’interruzione dei tre piani più popolari. Chi è interessato: | Piano | Cosa offriva | Cosa succederà il 18 giugno 2026 | |----|----|----| | Piano gratuito | Accesso a Gemini Code Assist + CLI con limiti | Completamente disabilitato | | Google AI Pro (circa \$19.99/mese) | Limiti più elevati per CLI e Code Assist | Completamente disabilitato | | Google AI Ultra (da \$100/mese dopo I/O 2026) | I limiti più elevati | Completamente disabilitato | | Gemini Code Assist per GitHub | Revisioni automatiche delle PR nei repository di Google | Nessuna nuova installazione; quelle esistenti verranno disabilitate nelle settimane successive | | Gemini Code Assist Standard / Enterprise (licenze aziendali) | Tramite un account Google Workspace aziendale | Continuerà senza cambiamenti | | API a pagamento tramite Google Cloud (chiave API Gemini a pagamento) | Richieste addebitate al progetto | Continuerà senza cambiamenti | Dal blog ufficiale Google Developers:

Il 18 giugno 2026, le estensioni IDE Gemini CLI e Gemini Code Assist smetteranno di elaborare richieste per gli utenti dei piani Google AI Pro, Ultra e Free.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Se usavi il piano Free, come la maggior parte degli sviluppatori individuali, e stai pensando «ma ho un account a pagamento», controlla esattamente come viene fatturata la tua chiave API. AI Pro non è fatturazione Cloud: è un abbonamento personale a Google AI e verrà disabilitato. La fatturazione Cloud con un progetto a pagamento non verrà disabilitata. ## Perché Google sta chiudendo Gemini CLI?
Punto chiave Gemini CLI era un esperimento separato in TypeScript/Node.js nel repository GitHub di Google. Google ha deciso di unificare tutti i suoi strumenti agent sotto un’unica piattaforma—Google Antigravity—con quattro interfacce: Antigravity 2.0 (applicazione desktop), Antigravity CLI (terminale), Antigravity SDK (wrapper Python) e Antigravity IDE (fork di VS Code). Antigravity CLI è stato riscritto da Node.js a Go: si avvia in millisecondi invece che in centinaia di millisecondi e usa decine di megabyte di memoria invece che centinaia.
Il vecchio `gemini` si avviava in «centinaia di millisecondi» perché Node.js doveva inizializzarsi. Il nuovo `agy` è compilato come singolo binario statico Go e si avvia in «millisecondi». Per CI e script che chiamano la CLI centinaia di volte per esecuzione, la differenza è notevole. Cosa dice Google sulla velocità e sul motivo:

Antigravity CLI è sviluppato in Go, è più veloce e supporta flussi di lavoro asincroni in background.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Tutte le funzionalità principali di Gemini CLI sono state trasferite: - **Agent Skills** — la cartella `.gemini/skills/` ora si trova in `.agents/skills/`. - **Hooks** — gli stessi eventi (`PreToolUse`, `PostToolUse`, ecc.); la sintassi è cambiata pochissimo. - **Subagents** — funzionano come prima e la loro configurazione viene migrata automaticamente. - **Estensioni** — rinominate plugin Antigravity e importate con un solo comando. Cosa non è migrato senza problemi: i server MCP e i vecchi script che accedono direttamente a `.gemini/config.json`. Secondo la discussione su GitHub, alcuni utenti segnalano che le configurazioni MCP si interrompono e devono essere riscritte manualmente. Più avanti c’è una sezione dedicata. Google non sta chiudendo il progetto open source Gemini CLI:

Il repository rimarrà disponibile su GitHub con licenza Apache 2.0 e continueremo a lavorare al progetto come open source.

— Google Developers Blog (Discussione #27274)
Questo significa che puoi farne un fork e continuare a usarlo con la tua chiave API Gemini. Ma ora è una configurazione a pagamento tramite fatturazione Cloud; l’accordo gratuito Code Assist è terminato. ## Come installare Antigravity CLI: comandi per macOS, Linux e Windows
Punto chiave L’installer Google rileva automaticamente sistema operativo e architettura, scarica il binario e lo inserisce in `~/.local/bin` (Linux/macOS) o `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). I comandi differiscono tra i tre sistemi operativi: su macOS e Linux, una riga di comando con `curl`; su Windows, PowerShell `irm` o l’opzione CMD. Dopo l’installazione, aggiungi il percorso a `PATH` se l’installer non l’ha fatto, apri un nuovo terminale ed esegui `agy doctor`—verifica che il binario sia stato trovato e possa raggiungere Google.
Prima di iniziare, fai un rapido controllo: quale piano usi? Se hai un progetto Cloud a pagamento senza scadenza il 18 giugno, la migrazione è utile ma non urgente. Se usi Free/Pro/Ultra e hai qualcosa in esecuzione nella CLI, passa ora, mentre i piani sono ancora attivi, così puoi confrontare il comportamento sulla stessa attività. ### macOS e Linux Una riga di comando con `curl`: ```bash curl -fsSL https://antigravity.google/cli/install.sh | bash ``` Lo script rileva la piattaforma, scarica il binario `agy`, ne verifica il checksum e lo inserisce in `~/.local/bin`. Se questa cartella non è in `PATH`, aggiungila: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Verifica che il binario sia visibile: ```bash which agy agy --version ``` ### Windows (PowerShell) ```powershell irm https://antigravity.google/cli/install.ps1 | iex ``` Il binario verrà installato in `C:\Users\[your_name]\AppData\Local\agy\bin`. L’installer aggiornerà automaticamente PATH, ma apri una nuova finestra di PowerShell per ricaricare le variabili. ### Windows (CMD) Se PowerShell è bloccato dai criteri aziendali: ```cmd curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd ``` ### Verificare l’installazione Dopo l’installazione su qualsiasi sistema operativo, esegui: ```bash agy doctor ``` Il comando controlla la versione del binario, se esiste una configurazione, l’autenticazione e l’accesso di rete a `antigravity.google`. Se non riesce a raggiungere Google, il problema riguarda la tua regione o il proxy. ### Autenticazione La prima volta che esegui `agy` senza argomenti, si avvia una procedura guidata di configurazione: 1. Scegli un tema per l’interfaccia. 2. Scegli un metodo di autenticazione: Google OAuth (per gli account personali) o una chiave API. 3. Facoltativamente, importa subito la configurazione da `.gemini/`. Se scegli OAuth, si aprirà un browser che ti reindirizzerà a `accounts.google.com`; dovrai acconsentire alla condivisione dei dati. Dopodiché, la CLI funzionerà. ## Come migrare configurazione e plugin da .gemini a .agents
Punto chiave Antigravity CLI cerca la configurazione in `.agents/` accanto al progetto e in `~/.agents/` a livello globale—proprio come Gemini CLI la cercava in `.gemini/`. La migrazione si esegue con un solo comando, `agy plugin import gemini`: passa in rassegna `.gemini/extensions/`, le migra come plugin Antigravity e aggiorna il formato di configurazione. Sposta manualmente la cartella delle skill: `mv .gemini/skills/ .agents/skills/`. In seguito, `agy doctor` e `agy inspect` mostreranno cosa è stato rilevato, cosa no e dove ci sono duplicati.
Passo dopo passo: 1. ### agy plugin import gemini Esegui il comando da qualsiasi cartella. Migrerà i plugin globali da `~/.gemini/` a `~/.agents/`. Per i plugin dell’area di lavoro (accanto al progetto), esegui il comando nella cartella del progetto. 2. ### mv .gemini/skills/ .agents/skills/ Sposta le skill rinominando manualmente la cartella. Il formato dei file al suo interno è lo stesso; non serve riscrivere il markdown. 3. ### agy inspect Mostra quali plugin, skill, hook e subagent sono attivi. Confronta l’elenco con quello che avevi in Gemini CLI—non dovrebbe mancare nulla. 4. ### agy config --edit Apre la configurazione nell’editor predefinito (`$EDITOR`). Se qualcosa non è stato rilevato automaticamente, modificalo manualmente. 5. ### agy doctor Controllo finale: binario, autenticazione, plugin e rete. Se tutti e quattro sono a posto, la migrazione della configurazione è completa. Lascerei la vecchia cartella `.gemini/` al suo posto come backup per un mese, nel caso fosse sfuggito qualcosa. Dopo aver usato Antigravity per una settimana e aver verificato che ci sia tutto, puoi eliminarla. Se usi [AGENTS.md come configurazione universale per tutti gli strumenti AI](https://ailoot.ai/blog/it/agents-md-guide-template/), non devi toccarlo. Antigravity CLI legge `AGENTS.md` dalla stessa cartella di Claude Code o Codex. ## Quali variabili d’ambiente bisogna cambiare?
Punto chiave Se hai script CI/CD, GitHub Actions, file `.env` locali o dotfile che passano `GEMINI_API_KEY` o altre variabili, devi rinominarle. Il prefisso `GEMINI_` è diventato `AV_` (per Antigravity). Antigravity CLI NON leggerà le vecchie variabili.
Tabella completa delle sostituzioni: | Variabile precedente (Gemini CLI) | Nuova variabile (Antigravity CLI) | Valore predefinito | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Endpoint ufficiale Google | Se hai GitHub Actions che trasmettono secret, apri `Settings -> Secrets -> Actions` e rinomina le chiavi. I valori restano gli stessi (la chiave API Google non è cambiata durante la migrazione). Controlla tutti i posti in cui potrebbe comparire `GEMINI_`: ```bash # Trova le occorrenze nel progetto grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null # Nei dotfile grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null ``` Dopo averle sostituite, riavvia il terminale e verificane la presenza senza stampare il segreto. Non attivare il tracciamento della shell e non copiare i valori delle chiavi nei log. La sola presenza non dimostra l’autorizzazione: esamina separatamente `agy doctor`: ```bash if [ -n "${AV_API_KEY:-}" ]; then printf 'AV_API_KEY presente\n' else printf 'AV_API_KEY assente o vuota\n' fi agy doctor # dovrebbe mostrare “authorized” ``` ## Cosa si rompe più spesso durante la transizione e come risolvere
Punto chiave Secondo la discussione su GitHub, i problemi più comuni riguardano i server MCP definiti in `~/.gemini/config.json`, che non vengono rilevati automaticamente: la configurazione va riscritta nel formato Antigravity. Gli hook personalizzati che usano vecchie variabili d’ambiente falliscono in modo silenzioso, quindi i test non passano senza un errore chiaro. Gli script che accedono direttamente a `.gemini/` (anziché tramite la CLI) devono passare a `.agents/`. Il comando `@[file]` per caricare un file nel contesto aveva dei bug nelle prime versioni di Antigravity CLI; il problema è stato corretto nelle build recenti, ma se hai una versione più vecchia, aggiornala.
Elenco dei problemi iniziali: 1. **Server MCP.** Se usavi `mcp_servers` in `.gemini/config.json`, potrebbero non essere rilevati dopo `agy plugin import gemini`. Controlla con `agy inspect`—ci sarà una sezione `mcp`. Se è vuota o contiene errori, riscrivila manualmente con `agy config --edit`. Il formato è descritto nella documentazione ufficiale Antigravity (cerca la sezione MCP). 2. **Hook personalizzati.** Se avevi uno script bash in `.gemini/hooks/` che leggeva `$GEMINI_API_KEY`, smetterà di funzionare. Cerca questi casi: bash ``` grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null ``` Sostituisci le variabili. 3. **CI/CD.** In GitHub Actions o GitLab CI, modifica i passaggi che usano il comando `gemini` in modo che usino `agy`. Il nome del binario nell’installer potrebbe differire, quindi crea un’astrazione usando la variabile `$CLI_CMD`. 4. **Estensione IDE.** L’estensione Gemini Code Assist per VS Code verrà disabilitata insieme alla CLI. Il sostituto è [Antigravity IDE](https://antigravity.google) (un fork separato di VS Code) oppure AGENTS.md in un altro editor AI. 5. **Caricamento con `@[file]`.** Nelle prime build di Antigravity CLI, il comando `@src/file.ts` per caricare un file nel contesto aveva dei bug. Aggiorna all’ultima versione: `agy update`. Se qualcosa di critico si interrompe e non è possibile risolverlo entro un’ora, una soluzione temporanea per il piano Free è restare su Gemini CLI fino al 18 giugno, preparando nel frattempo la migrazione su un ramo separato del repository. Limite di tempo: 14 giorni. ## Vale la pena restare con gli strumenti Google dopo il 18 giugno?
Punto chiave Antigravity CLI si avvia più rapidamente, funziona con Gemini 3.5 Flash, supporta agenti paralleli e attività asincrone in background tramite `agy --background`. Ma ci sono due possibili problemi: restrizioni di accesso regionali e un ecosistema immaturo (meno plugin e server MCP rispetto a Claude Code). Non migrerei ad Antigravity come strumento principale. Lo userei come canale di riserva per attività parallele in background, mantenendo il lavoro di sviluppo principale in Claude Code. Se usavi Gemini CLI con il piano Free, il 18 giugno è un momento opportuno per ripensare l’intero insieme di strumenti.
Antigravity 2.0 può essere considerato un’opzione di riserva nei casi in cui il tuo strumento principale (Claude Code o Codex) non sia adatto. Per un’analisi dettagliata dei suoi pregi e difetti, consulta la [guida a Google Antigravity 2.0](https://ailoot.ai/blog/it/google-antigravity/). Breve riepilogo di cosa fare a seconda della situazione: | Se... | Cosa fare entro il 18 giugno | |----|----| | Usavi Gemini CLI Free per esperimenti | Migra ad Antigravity CLI con un account che possa accedere al servizio OPPURE passa a Claude/Codex, in base al tuo budget | | Usavi Gemini Code Assist nel tuo IDE | Passa ad Antigravity IDE oppure torna a VS Code + Claude Code | | Eseguivi processi cron notturni tramite Gemini API con il piano Free | Riscrivili urgentemente per l’API Cloud a pagamento (che non verrà disabilitata) OPPURE spostali sull’API Claude | | Lavori tramite Cloud aziendale (Standard/Enterprise) | Non fare nulla; la chiusura non ti riguarda | | Stavi pensando di provare Gemini CLI solo perché «è gratis» | Non iniziare; passa direttamente a [Claude Code](https://ailoot.ai/blog/it/claude-code/) o [Codex](https://ailoot.ai/blog/it/codex-vs-claude-code-choice/) | ## Checklist di migrazione in 15 minuti
Punto chiave Se vuoi seguire il percorso più rapido senza leggere l’intera guida, ecco la sequenza breve. Su un terminale appena aperto, senza script Gemini attivi, l’intera migrazione richiede 10–20 minuti.
1. ### Installa Antigravity CLI `curl -fsSL https://antigravity.google/cli/install.sh | bash` (macOS/Linux) oppure `irm https://antigravity.google/cli/install.ps1 | iex` (Windows PowerShell). 2. ### Avvia agy e autentica Senza argomenti: `agy`. Scegli OAuth o una chiave API. 3. ### Importa i plugin da .gemini `agy plugin import gemini`—migra globalmente le estensioni. Eseguilo di nuovo nella cartella del progetto per i plugin dell’area di lavoro. 4. ### Sposta le skill `mv .gemini/skills/ .agents/skills/`. I contenuti dei file rimangono invariati. 5. ### Sostituisci le variabili d’ambiente In `~/.zshrc`/`~/.bashrc` e nei file `.env`: `GEMINI_API_KEY → AV_API_KEY`, `GEMINI_PROJECT_ID → AV_PROJECT_ID`, `GEMINI_REGION → AV_REGION`. Riavvia il terminale. 6. ### Verifica l’installazione `agy doctor`—tutti e quattro gli elementi (binario, autenticazione, plugin, rete) dovrebbero essere a posto. 7. ### Esegui un’attività di prova `agy "write a README for the project in the current folder"`—controlla che il risultato sia simile a quello prodotto da Gemini CLI. 8. ### Aggiorna GitHub Actions / GitLab CI Cambia il nome del comando e i secret da `GEMINI_*` a `AV_*`. 9. ### Conserva .gemini/ come backup Puoi eliminarla 1–2 settimane dopo aver verificato che tutto funzioni. Infine: il 18 giugno non significa che «tutti i tuoi progetti si bloccheranno». Significa che il canale gratuito verrà disabilitato. L’accesso all’API Cloud a pagamento rimane, il repository Gemini CLI rimane e sono possibili i fork. Se usavi il piano Free, devi decidere prima del 18 giugno; altrimenti, il prossimo `gemini "qualcosa"` restituirà un errore di autorizzazione.
### Fonti - [Google Developers Blog - Un aggiornamento importante: passaggio da Gemini CLI ad Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Guida introduttiva](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - Repository GitHub](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Le principali novità per sviluppatori di Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Continua a lavorare con l’AI su [Ailoot](https://ailoot.ai/).
## Domande frequenti ### Come verifico la variabile rinominata della chiave API senza esporla? Controlla se `${AV_API_KEY:-}` non è vuota e stampa soltanto un messaggio di presenza o assenza. Non mostrare il valore della chiave e non eseguire il controllo con il tracciamento della shell attivo. Usa separatamente `agy doctor` per esaminare l’autenticazione. ### Un’importazione della configurazione riuscita dimostra che la migrazione è completa? No. Confronta plugin, skill, hook e subagent attivi con la vecchia configurazione, controlla le impostazioni MCP ed esegui una piccola attività. Conserva la vecchia configurazione `.gemini/` fino alla verifica del flusso e del risultato previsti. ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.