Sommaire du dépannage
Diagnostiquer l’erreur Antigravity avant de modifier la configuration
Antigravity ne fonctionne pas peut décrire des pannes très différentes. Certaines viennent du service cloud ou du compte, d’autres de Node.js, du PATH, d’un proxy, d’un MCP ou d’un ancien build. Le texte exact de l’erreur doit guider la réparation.
Copiez le message et notez où il apparaît. Si l’application ne démarre pas, vérifiez l’OS, l’architecture et les protections de sécurité. Si la connexion boucle, vérifiez navigateur, cookies et heure système. Si l’agent échoue, cherchez modèle, quota, réseau, MCP et contexte. Si le terminal échoue, cherchez PATH, Node.js, npx, npm et politique shell.
| Symptôme | Cause probable | Premier correctif |
|---|---|---|
| Agent execution terminated due to error | Route modèle temporaire, session, réseau instable, crash MCP ou limite de contexte. | Redémarrez l’agent, testez un petit prompt dans un workspace propre, puis désactivez MCP seulement si ce test fonctionne. |
| Model API cannot be reached | Pare-feu, proxy, DNS, région non prise en charge, session expirée ou disponibilité du service. | Confirmez la connexion, testez un autre réseau fiable et autorisez les endpoints Google AI. |
| exec: "npx": executable file not found in PATH | Antigravity n’hérite pas du même environnement que le terminal ou Node.js manque. | Installez Node.js LTS, vérifiez npx dans le terminal puis corrigez le PATH utilisateur ou système. |
| PowerShell execution policy is blocking npx | La politique Windows bloque les scripts npm. | N’utilisez qu’un changement de politique approuvé ou une invocation MCP compatible cmd. |
| L’installateur s’ouvre mais l’app ne démarre pas | Mauvaise architecture, ancien processus, OS non supporté, antivirus ou dossier corrompu. | Vérifiez les prérequis, fermez les processus et installez le bon build x64, ARM64, Apple Silicon, Intel, apt ou dnf. |
Correctifs rapides pour les pannes fréquentes
Mettez à jour d’abord si l’application s’ouvre mais se comporte mal. Antigravity dépend de services cloud ; un build ancien peut afficher l’éditeur tout en bloquant l’agent, la complétion ou la connexion. Après mise à jour, ouvrez depuis le lanceur normal et vérifiez About.
Redémarrez l’agent avant de changer les réglages. Lancez un prompt court dans un petit dossier. Si ce test échoue, regardez compte, réseau, version ou outils globaux. S’il fonctionne, le problème se trouve probablement dans le dépôt.
Contrôlez la route réseau lorsque le message parle d’API modèle, région, timeout ou trafic élevé. Une autre connexion fiable permet de distinguer une panne réseau d’une installation cassée.
Workflow de récupération Antigravity
Notez l’erreur exacte et la version
Ouvrez About si possible, notez la version et copiez le message avant toute réinstallation.
Testez un workspace propre
Ouvrez un petit dossier avec un fichier et lancez un prompt minimal pour séparer panne globale et problème de dépôt.
Réparez la bonne couche
Mettez à jour pour une version obsolète, corrigez PATH ou Node.js pour npx, et isolez les MCP pour les crashes liés au dépôt.
Correctifs par texte d’erreur
Appliquez seulement la voie qui correspond au message. Cela évite de casser une configuration qui fonctionnait.
Corriger agent execution terminated due to error
Ouvrez un dossier minimal et demandez à l’agent de lire un seul fichier. Si cela échoue aussi, rafraîchissez la connexion, redémarrez Antigravity, changez de modèle si possible et réessayez plus tard. Si seul le vrai dépôt échoue, inspectez MCP, gros fichiers, règles workspace et prompts trop chargés.
Corriger npx introuvable dans PATH
Installez Node.js LTS, ouvrez un nouveau terminal et exécutez node -v, npm -v et npx -v. Si ces commandes fonctionnent dehors mais pas dans Antigravity, lancez l’app depuis ce terminal ou ajoutez Node.js au PATH.
Corriger les blocages PowerShell
Sur Windows, npm et npx peuvent appeler des scripts bloqués par la politique PowerShell. N’exécutez pas de scripts inconnus. Utilisez une politique utilisateur approuvée ou une commande MCP compatible.
Corriger les boucles de connexion et l’API modèle
Vérifiez l’heure système, le navigateur par défaut, les cookies et la session. Si l’erreur parle de région, quota ou trafic élevé, réinstaller aide rarement.
Corriger installation et mise à jour
Choisissez le bon installateur : Windows x64 ou ARM64, macOS Apple Silicon ou Intel, dépôt Linux compatible. Fermez les processus et remplacez les raccourcis obsolètes après confirmation.
Application et version
Utilisez cette couche si l’app ne démarre pas, si About affiche un ancien build ou si l’interface signale une version non prise en charge.
Agent et modèle
Utilisez cette couche avec erreurs d’exécution, API modèle, quota, trafic élevé ou région. Un prompt propre et un second réseau clarifient la cause.
Terminal, Node.js et MCP
Utilisez cette couche quand l’erreur mentionne npx, node, npm, PATH, MCP ou politique PowerShell. Vérifiez les commandes hors IDE puis alignez l’environnement.
Éviter que Antigravity retombe en panne
Gardez IDE, Node.js, npm, npx et environnement shell alignés. Beaucoup de pannes viennent d’un Node installé dans un profil terminal mais invisible pour une application lancée par icône.
Traitez les MCP comme des dépendances. Épinglez les versions importantes, évitez d’ajouter plusieurs serveurs expérimentaux en même temps et gardez un workspace minimal pour tester l’agent de base.
Utilisez Git et des sauvegardes. Le dépannage ne devrait pas supprimer un dépôt. Avant de nettoyer caches ou installations, vérifiez que code et configuration sont récupérables.
Note de sécurité
N’exécutez pas de commandes PowerShell, curl ou shell copiées au hasard sans les comprendre. Un correctif IDE ne doit pas exposer votre code, vos tokens ou votre session.
Liens officiels et internes utiles
Utilisez ces pages pour vérifier l’installateur, la compatibilité et la mise à jour après avoir identifié la panne.
- Page officielle de téléchargement Antigravity - destination officielle des installateurs Google
- Dépannage officiel CLI Antigravity - référence officielle pour la ligne de commande
- Dernière version Antigravity - utile si le client est ancien ou non pris en charge
- Prérequis Antigravity - vérifier OS, architecture, mémoire, stockage et réseau
- Guide de mise à jour Antigravity - corriger les alertes de version obsolète