Inhalt der Fehlerbehebung
Antigravity-Fehler vor jeder Änderung diagnostizieren
Antigravity funktioniert nicht kann sehr unterschiedliche Ursachen haben. Einige Fehler liegen bei Modellservice, Konto oder Netzwerk; andere entstehen lokal durch fehlendes Node.js, falschen PATH, PowerShell-Richtlinien, MCP-Server oder eine alte Installation.
Kopieren Sie zuerst die genaue Meldung und prüfen Sie, wo sie erscheint. Startprobleme deuten auf Installer, Betriebssystem oder Sicherheitssoftware. Login-Schleifen betreffen Browser, Cookies, Uhrzeit oder Proxy. Agent-Fehler betreffen Modell, Kontingent, MCP, Kontext oder Netzwerk. Terminalfehler betreffen PATH, Node.js, npx, npm oder Shell-Richtlinien.
| Symptom | Wahrscheinliche Ursache | Erster Fix |
|---|---|---|
| Agent execution terminated due to error | Temporäre Modellroute, Session, instabiles Netzwerk, MCP-Absturz oder Kontextlimit. | Agent neu starten, kleinen Prompt in sauberem Workspace testen und MCP nur deaktivieren, wenn dieser Test funktioniert. |
| Model API cannot be reached | Firewall, Proxy, DNS, nicht unterstützter Standort, abgelaufene Anmeldung oder Serviceverfügbarkeit. | Login prüfen, vertrauenswürdiges zweites Netzwerk testen und Google-AI-Endpunkte zulassen. |
| exec: "npx": executable file not found in PATH | Antigravity erbt nicht dieselbe Umgebung wie das Terminal oder Node.js fehlt. | Node.js LTS installieren, npx im Terminal prüfen und User- oder System-PATH korrigieren. |
| PowerShell execution policy is blocking npx | Windows blockiert npm-Shim-Skripte. | Nur genehmigte Richtlinienänderungen verwenden oder den MCP-Befehl cmd-kompatibel ausführen. |
| Installer öffnet, App startet aber nicht | Falsche Architektur, alter Prozess, nicht unterstütztes OS, Sicherheitssoftware oder beschädigter Ordner. | Systemanforderungen prüfen, Prozesse schließen und passenden x64-, ARM64-, Apple-Silicon-, Intel-, apt- oder dnf-Build installieren. |
Schnelle Lösungen für häufige Ausfälle
Aktualisieren Sie zuerst, wenn die App öffnet, sich aber ungewöhnlich verhält. Ein alter Build kann den Editor anzeigen und trotzdem Agent, Completion oder Login blockieren. Öffnen Sie nach dem Update About und prüfen Sie die Version.
Starten Sie den Agent neu, bevor Sie Einstellungen ändern. Testen Sie einen kurzen Prompt in einem kleinen Ordner. Scheitert auch das, prüfen Sie Konto, Netzwerk, Version oder globale Tools. Funktioniert es, liegt das Problem wahrscheinlich im Repository.
Prüfen Sie die Netzwerkroute bei Meldungen zu Model API, Standort, Timeout oder hohem Traffic. Ein zweites vertrauenswürdiges Netzwerk zeigt, ob Installation oder Netzwerkpolitik verantwortlich ist.
Antigravity Wiederherstellung Schritt für Schritt
Exakte Fehlermeldung und Version notieren
Öffnen Sie About, wenn möglich, notieren Sie die Version und kopieren Sie die Meldung vor jeder Neuinstallation.
Sauberen Workspace testen
Öffnen Sie einen kleinen Ordner mit einer Datei und starten Sie einen Minimalprompt, um globalen Fehler und Repository-Fehler zu trennen.
Die passende Schicht reparieren
Update bei Versionsproblem, PATH oder Node.js bei npx, genehmigte Policy bei PowerShell und MCP-Isolation bei Repository-Crash.
Fix-Pfade nach Fehlermeldung
Nutzen Sie nur den Pfad, der zur Meldung passt. So beschädigen Sie keine funktionierende Konfiguration.
Agent execution terminated due to error beheben
Öffnen Sie einen Minimalordner und lassen Sie den Agent eine kleine Datei lesen. Scheitert das, Anmeldung erneuern, Antigravity neu starten, ggf. Modell wechseln und später erneut versuchen. Scheitert nur ein echtes Repository, prüfen Sie MCP, große Dateien, Workspace-Regeln und zu viel Kontext.
npx nicht im PATH beheben
Installieren Sie Node.js LTS, öffnen Sie ein neues Terminal und führen Sie node -v, npm -v und npx -v aus. Funktioniert das extern, aber nicht in Antigravity, starten Sie die App aus dem Terminal oder ergänzen Sie Node.js im PATH.
PowerShell-Blockaden beheben
Auf Windows können npm und npx von PowerShell blockierte Skripte aufrufen. Führen Sie keine unbekannten Skripte aus. Nutzen Sie eine genehmigte User-Richtlinie oder eine kompatible MCP-Invocation.
Login-Schleifen und Model API beheben
Prüfen Sie Systemzeit, Standardbrowser, Cookies und Session. Bei Standort-, Quota- oder Traffic-Meldungen hilft Neuinstallation meist nicht.
Installation und Update beheben
Wählen Sie den richtigen Installer: Windows x64 oder ARM64, macOS Apple Silicon oder Intel, Linux-Repository. Schließen Sie alte Prozesse und ersetzen Sie alte Verknüpfungen nach erfolgreichem Start.
App- und Versionsschicht
Nutzen Sie diese Schicht, wenn die App nicht startet, About einen alten Build zeigt oder die UI eine nicht unterstützte Version meldet.
Agent- und Modellschicht
Nutzen Sie diese Schicht bei Agent-, Model-API-, Quota-, Traffic- oder Standortmeldungen. Ein sauberer Prompt und zweites Netzwerk klären die Ursache.
Terminal-, Node.js- und MCP-Schicht
Nutzen Sie diese Schicht bei npx, node, npm, PATH, MCP oder PowerShell-Richtlinie. Prüfen Sie Befehle extern und gleichen Sie die Umgebung an.
Wiederkehrende Antigravity-Ausfälle vermeiden
Halten Sie IDE, Node.js, npm, npx und Shell-Umgebung konsistent. Viele Fehler entstehen, wenn Node in einem Terminalprofil installiert ist, aber die Desktop-App diesen PATH nicht erbt.
Behandeln Sie MCP-Server wie echte Abhängigkeiten. Pinnen Sie Versionen, fügen Sie nicht mehrere experimentelle Server gleichzeitig hinzu und behalten Sie einen Minimal-Workspace für Basistests.
Nutzen Sie Versionskontrolle und Backups. Fehlerbehebung sollte niemals das Löschen eines Repositories erfordern. Sichern Sie Code und wichtige Konfiguration, bevor Sie Caches oder alte Installationen entfernen.
Sicherheitshinweis
Führen Sie keine kopierten PowerShell-, curl- oder Shell-Befehle von unbekannten Seiten aus, ohne sie zu verstehen. Ein IDE-Fix sollte keinen Zugriff auf Code, Tokens oder Browser-Session riskieren.
Nützliche offizielle und interne Links
Diese Seiten helfen nach der Diagnose bei Installer, Kompatibilität und Update-Pfad.
- Offizielle Antigravity Downloadseite - offizielles Google-Ziel für Installer
- Offizielle Antigravity CLI-Fehlerbehebung - offizielle Referenz für CLI und Befehle
- Neueste Antigravity Version - für veraltete oder nicht unterstützte Clients
- Antigravity Systemanforderungen - OS, Architektur, RAM, Speicher und Netzwerk prüfen
- Antigravity Update-Anleitung - Warnungen zu alten Versionen und veralteten Shortcuts beheben