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.
Prima di chiedere aiuto, annota il messaggio esatto, quando appare, sistema operativo e build in Informazioni, se il problema si ripete in uno spazio pulito e le modifiche recenti a Node.js, PATH, proxy o strumenti MCP. Riproducilo in un piccolo progetto locale con un prompt breve. Prima di condividere i log rimuovi percorsi personali, e-mail, token, cookie, chiavi API e codice privato. Non pubblicare un archivio completo di diagnostica. Questi dati aiutano a distinguere un problema dell’app, dell’account, della rete, del terminale o dello spazio di lavoro senza ripetere reinstallazioni rischiose.
| 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
Se l’app si apre ma si comporta in modo anomalo, controlla Informazioni e la pagina ufficiale di download Google prima di cambiare impostazioni. Chiudi tutti i processi, usa solo l’installer pubblicato lì, riapri Antigravity dal collegamento di sistema e verifica la build. Se compare ancora una versione vecchia, cerca collegamenti obsoleti o installazioni doppie.
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
Se l’app si apre, annota la build in Informazioni e copia l’errore esatto prima di reinstallare.
Testa un workspace pulito
Prova un prompt breve in una cartella pulita; se funziona, controlla strumenti e regole del progetto originale.
Ripara il livello corretto
Aggiorna solo per problemi di build; correggi PATH, policy della shell o il comando MCP indicato.
Percorsi di correzione per messaggio d’errore
Usa solo il percorso che corrisponde al testo dell’errore. Così eviti di rompere una configurazione funzionante.
Agent execution terminated due to error: checklist mirata
Quando appare questo errore esatto, separa routing del modello e crash degli strumenti locali. Prova prima un prompt di una riga in una cartella pulita. Se funziona, riattiva i server MCP uno alla volta, riduci il contesto e individua se termina shell, npx o browser action. Per il messaggio esatto 'agent execution terminated due to error', annota il passaggio che fallisce prima di riprovare: risposta del modello, comando terminale, azione browser o strumento MCP. Se fallisce sempre lo stesso strumento locale, controlla la configurazione; se l'errore avviene prima degli strumenti, verifica accesso, rete, quota e routing.
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
Confronta Informazioni con la pagina Google, chiudi i processi e controlla il collegamento dopo il riavvio.
Livello agente e modello
Prova un prompt pulito e un’altra rete affidabile per distinguere problemi di progetto, account, rete o servizio.
Livello terminale, Node.js e MCP
Controlla node, npx, PATH, policy della shell e il comando MCP indicato da un terminale esterno.
Come evitare nuove interruzioni di Antigravity
Dopo aver cambiato Node.js o PATH, riavvia l’intera app e confronta node e npx con il terminale normale.
Esegui un backup prima di cancellare cache; prova MCP uno alla volta ed esegui solo comandi che comprendi.
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
- Requisiti Antigravity - controlla OS, architettura, memoria, spazio e rete
- Guida aggiornamento Antigravity - risolvi avvisi di versione obsoleta e vecchie scorciatoie