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.
Notieren Sie vor einer Supportanfrage die genaue Meldung, den Zeitpunkt, Betriebssystem und App-Build aus dem Info-Dialog, das Ergebnis in einem sauberen Arbeitsbereich sowie kürzliche Änderungen an Node.js, PATH, Proxy oder MCP-Tools. Reproduzieren Sie den Fehler mit einem kleinen lokalen Projekt und einer kurzen Eingabe. Entfernen Sie persönliche Pfade, E-Mail-Adressen, Zugriffstoken, Cookies, API-Schlüssel und privaten Quellcode aus Protokollen. Veröffentlichen Sie kein vollständiges Diagnosearchiv. So lässt sich ein Problem der App, dem Konto, Netzwerk, Terminal oder Arbeitsbereich zuordnen, ohne riskante Neuinstallationen zu wiederholen.
| 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
Öffnet sich die App, verhält sich aber unerwartet, prüfen Sie zuerst Info und Googles offizielle Downloadseite. Schließen Sie alle Prozesse, nutzen Sie nur den dort veröffentlichten Installer, starten Sie Antigravity über die normale Systemverknüpfung und prüfen Sie den Build. Wird weiterhin eine alte Version angezeigt, suchen Sie nach alten Verknüpfungen oder doppelten Installationen.
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
Öffnet sich die App, notieren Sie den Build unter Info und kopieren Sie die genaue Meldung vor einer Neuinstallation.
Sauberen Workspace testen
Testen Sie eine kurze Eingabe in einem leeren Ordner; funktioniert sie, prüfen Sie Tools und Regeln des ursprünglichen Projekts.
Die passende Schicht reparieren
Aktualisieren Sie nur bei Build-Problemen; korrigieren Sie PATH, Shell-Richtlinie oder den betroffenen MCP-Befehl.
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: gezielte Checkliste
Bei diesem genauen Fehler trennen Sie Modellrouting von lokalen Tool-Abstürzen. Testen Sie zuerst einen Einzeiler in einem sauberen Ordner. Funktioniert das, aktivieren Sie MCP-Server einzeln, reduzieren Kontext und prüfen, ob Shell, npx oder Browser-Aktion terminiert. Bei der genauen Meldung 'agent execution terminated due to error' notieren Sie vor dem erneuten Versuch den fehlgeschlagenen Schritt: Modellantwort, Terminalbefehl, Browseraktion oder MCP-Tool. Scheitert immer dasselbe lokale Tool, spricht das fuer die Konfiguration; wechselnde Fehler vor dem Tool-Start eher fuer Anmeldung, Routing, Kontingent oder Netzwerk.
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
Vergleichen Sie Info mit Googles Seite, schließen Sie alle Prozesse und prüfen Sie nach dem Neustart das Verknüpfungsziel.
Agent- und Modellschicht
Testen Sie eine saubere Eingabe und ein vertrauenswürdiges Netzwerk, um Projekt-, Konto-, Netzwerk- und Dienstfehler zu trennen.
Terminal-, Node.js- und MCP-Schicht
Prüfen Sie node, npx, PATH, Shell-Richtlinie und den betroffenen MCP-Befehl in einem externen Terminal.
Wiederkehrende Antigravity-Ausfälle vermeiden
Starten Sie die App nach Änderungen an Node.js oder PATH neu und vergleichen Sie node und npx in beiden Terminals.
Sichern Sie Projekteinstellungen vor dem Löschen von Caches; testen Sie MCP einzeln und führen Sie nur verstandene Befehle aus.
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
- Antigravity Systemanforderungen - OS, Architektur, RAM, Speicher und Netzwerk prüfen
- Antigravity Update-Anleitung - Warnungen zu alten Versionen und veralteten Shortcuts beheben