Contenuto della guida
Diagnostica l’errore Antigravity prima di modificare impostazioni
Antigravity non funziona può avere molte cause. Alcune dipendono dal servizio cloud, dall’account o dalla rete; altre sono locali, come Node.js mancante, PATH errato, policy PowerShell, MCP instabile o una vecchia installazione.
Copia il messaggio esatto e guarda dove appare. Un errore di avvio punta a installer, sistema o sicurezza. Un loop di login punta a browser, cookie, orario e proxy. Un errore agente coinvolge modello, quota, MCP, contesto o rete. Un errore terminale coinvolge PATH, Node.js, npx, npm o shell.
| Sintomo | Causa probabile | Prima correzione |
|---|---|---|
| Agent execution terminated due to error | Route modello temporanea, sessione, rete instabile, crash MCP o limite di contesto. | Riavvia l’agente, prova un prompt piccolo in workspace pulito e disattiva MCP solo se quel test funziona. |
| Model API cannot be reached | Firewall, proxy, DNS, area non supportata, sessione scaduta o disponibilità servizio. | Verifica login, prova una rete affidabile diversa e consenti endpoint Google AI. |
| exec: "npx": executable file not found in PATH | Antigravity eredita un ambiente diverso dal terminale o Node.js non è installato. | Installa Node.js LTS, verifica npx nel terminale e correggi il PATH utente o sistema. |
| PowerShell execution policy is blocking npx | La policy Windows blocca gli script shim di npm. | Usa solo modifiche approvate alla policy o configura il comando MCP in modo compatibile. |
| L’installer si apre ma l’app non parte | Architettura errata, vecchio processo, OS non supportato, antivirus o cartella corrotta. | Controlla requisiti, chiudi processi e installa il build corretto x64, ARM64, Apple Silicon, Intel, apt o dnf. |
Correzioni rapide per i problemi più comuni
Aggiorna prima quando l’app si apre ma i servizi falliscono. Un build vecchio può mostrare l’editor e bloccare agente, completamento o login. Dopo l’aggiornamento, apri dal launcher normale e controlla la versione in About.
Riavvia l’agente prima di cambiare opzioni. Esegui un prompt corto in una cartella piccola. Se fallisce, controlla account, rete, versione o strumenti globali. Se funziona, il problema è probabilmente nel repository.
Controlla la rete quando il messaggio cita API modello, area, timeout o traffico elevato. Una seconda rete affidabile aiuta a distinguere installazione rotta da proxy, DNS o blocco regionale.
Flusso di ripristino Antigravity
Registra errore esatto e versione
Apri About se possibile, annota la versione e copia il messaggio prima di reinstallare.
Testa un workspace pulito
Apri una cartella piccola con un file e usa un prompt minimo per separare errore globale e problema del repository.
Ripara il livello corretto
Aggiorna per versione, correggi PATH o Node.js per npx, policy approvata per PowerShell e MCP per crash del repository.
Percorsi di correzione per messaggio d’errore
Usa solo il percorso che corrisponde al testo dell’errore. Così eviti di rompere una configurazione funzionante.
Correggere agent execution terminated due to error
Apri una cartella minima e chiedi all’agente di leggere un file piccolo. Se fallisce anche lì, rinnova login, riavvia Antigravity, cambia modello se possibile e riprova più tardi. Se fallisce solo il repository reale, controlla MCP, file grandi, regole workspace e prompt con troppo contesto.
Correggere npx non trovato nel PATH
Installa Node.js LTS, apri un nuovo terminale ed esegui node -v, npm -v e npx -v. Se funzionano fuori ma non dentro Antigravity, avvia l’app dal terminale o aggiungi Node.js al PATH.
Correggere blocchi PowerShell
Su Windows npm e npx possono chiamare script bloccati dalla policy. Non eseguire script casuali. Usa una policy utente approvata o un comando MCP compatibile.
Correggere loop di login e API modello
Controlla orario del sistema, browser predefinito, cookie e sessione. Se l’errore parla di area, quota o traffico alto, reinstallare di solito non aiuta.
Correggere installazione e aggiornamento
Scegli l’installer corretto: Windows x64 o ARM64, macOS Apple Silicon o Intel, pacchetti repository su Linux supportato. Chiudi vecchi processi e sostituisci scorciatoie obsolete dopo la verifica.
Livello app e versione
Usalo quando l’app non apre, About mostra un build vecchio o la UI indica una versione non supportata.
Livello agente e modello
Usalo con errori agente, API modello, quota, traffico alto o area. Un prompt pulito e una seconda rete chiariscono la causa.
Livello terminale, Node.js e MCP
Usalo quando l’errore cita npx, node, npm, PATH, MCP o PowerShell. Verifica fuori dall’IDE e allinea l’ambiente.
Come evitare nuove interruzioni di Antigravity
Mantieni allineati IDE, Node.js, npm, npx e ambiente shell. Molti errori nascono quando Node è installato in un profilo terminale ma l’app avviata da icona non eredita lo stesso PATH.
Tratta gli MCP come dipendenze vere. Blocca le versioni importanti, evita più server sperimentali insieme e conserva un workspace minimo per testare l’agente base.
Usa controllo versione e backup. Il troubleshooting non dovrebbe richiedere di eliminare il repository. Prima di pulire cache o rimuovere vecchie installazioni, verifica che codice e configurazione siano recuperabili.
Nota di sicurezza
Non eseguire comandi PowerShell, curl o shell copiati da pagine casuali senza capirli. Una correzione dell’IDE non deve esporre codice, token o sessione browser.
Link ufficiali e interni utili
Usa queste pagine per verificare installer, compatibilità e aggiornamento dopo aver identificato il guasto.
- Pagina ufficiale download Antigravity - destinazione ufficiale Google per gli installer
- Troubleshooting ufficiale CLI Antigravity - riferimento ufficiale per CLI e comandi
- Ultima versione Antigravity - utile se il client è vecchio o non supportato
- Requisiti Antigravity - controlla OS, architettura, memoria, spazio e rete
- Guida aggiornamento Antigravity - risolvi avvisi di versione obsoleta e vecchie scorciatoie