Contenido de la guía
Diagnostica el error antes de cambiar la configuración
Antigravity no funciona puede significar cosas muy distintas. Un error puede venir del servicio de modelos, de una cuenta sin sesión válida, de una red bloqueada, de Node.js ausente, de un MCP roto o de una instalación vieja. Por eso el texto exacto del error importa más que la primera solución que aparece en un foro.
Copia el mensaje visible y mira dónde aparece. Si la app no abre, revisa instalador, sistema operativo y antivirus. Si el login vuelve al inicio, revisa navegador, cookies, hora del sistema y proxy. Si falla el agente, mira modelo, cuota, MCP, contexto y red. Si falla el terminal, revisa PATH, Node.js, npx, npm y política de shell.
| Síntoma | Causa probable | Primera acción |
|---|---|---|
| Agent execution terminated due to error | Ruta de modelo temporal, sesión, red inestable, MCP que se cae o límite de contexto. | Reinicia el agente, prueba un prompt pequeño en un workspace limpio y desactiva MCP solo si ese prompt sí funciona. |
| Model API cannot be reached | Firewall, proxy, DNS, ubicación no soportada, sesión expirada o disponibilidad del servicio. | Confirma la sesión, prueba otra red confiable, permite endpoints de Google AI y espera antes de tocar el proyecto. |
| exec: "npx": executable file not found in PATH | Antigravity heredó un entorno distinto al terminal o Node.js no está instalado. | Instala Node.js LTS, verifica npx en el terminal y corrige el PATH de usuario o sistema. |
| PowerShell execution policy is blocking npx | La política de Windows bloquea scripts shim de npm. | Usa Node.js confiable y cambia solo la política aprobada por tu organización o ejecuta el comando MCP por una ruta compatible. |
| El instalador abre pero la app no inicia | Arquitectura incorrecta, proceso viejo, sistema no soportado, antivirus o carpeta dañada. | Revisa requisitos, cierra procesos y usa el build correcto para x64, ARM64, Apple Silicon, Intel, apt o dnf. |
Soluciones rápidas para los fallos más comunes
Actualiza primero cuando la app abre pero se comporta de forma extraña. Antigravity depende de funciones cloud, así que una versión vieja puede abrir el editor y aun así fallar en agente, autocompletado o login. Después de actualizar, abre desde el lanzador normal y verifica la versión en About.
Reinicia el agente antes de cambiar opciones. Si la interfaz responde, usa la paleta de comandos. Si no responde, cierra todos los procesos de Antigravity y prueba un prompt corto en una carpeta pequeña. Esa prueba separa un fallo global de un problema de repositorio.
Revisa la red cuando el mensaje habla de API de modelo, ubicación, timeout o tráfico alto. Desactiva rutas VPN inestables, confirma proxy y prueba una red distinta solo para diagnóstico. Si otra red funciona, la instalación probablemente está bien.
Flujo de recuperación paso a paso
Registra el error exacto y la versión
Abre About si la app inicia, anota la versión y copia el mensaje exacto antes de reinstalar.
Prueba un workspace limpio
Abre una carpeta pequeña con un archivo y ejecuta un prompt mínimo. Si falla, mira cuenta, red, versión o herramientas globales. Si funciona, revisa el repositorio original.
Repara la capa correcta
Actualiza por versión, corrige PATH o Node.js para npx, ajusta una política aprobada para PowerShell y desactiva MCP sospechosos si el fallo es del repositorio.
Rutas de reparación según el texto del error
Aplica solo la ruta que coincide con el mensaje. Así evitas romper una configuración que en realidad funcionaba.
Arreglar agent execution terminated due to error
Abre una carpeta pequeña y pide al agente que lea un archivo simple. Si falla también, refresca sesión, reinicia Antigravity, cambia de modelo si existe y espera si parece una caída. Si solo falla tu repositorio real, revisa MCP, archivos enormes, reglas del workspace y prompts con demasiado contexto.
Arreglar npx executable file not found in PATH
Instala Node.js LTS, abre un terminal nuevo y ejecuta node -v, npm -v y npx -v. Si funcionan fuera pero fallan dentro de Antigravity, inicia la app desde ese terminal o añade Node.js al PATH y reinicia completamente.
Arreglar bloqueos de PowerShell
En Windows, npm y npx pueden usar scripts que PowerShell bloquea. No ejecutes scripts aleatorios de internet. Cambia solo una política de usuario aprobada o ajusta el comando MCP para usar una invocación compatible con cmd.
Arreglar bucles de login y API de modelo
Comprueba hora del sistema, navegador predeterminado, cookies y sesión. Cierra sesión y vuelve a entrar. Si el error menciona ubicación, cuota o tráfico alto, reinstalar normalmente no ayuda.
Arreglar instalación y actualización
Elige el instalador correcto: Windows x64 o ARM64, macOS Apple Silicon o Intel, y paquetes de repositorio en Linux compatible. Cierra procesos antiguos y elimina accesos directos obsoletos solo después de confirmar que la nueva versión abre.
Capa de app y versión
Úsala cuando la app no abre, About muestra un build viejo o la interfaz dice que la versión no está soportada. Cierra procesos, actualiza y reemplaza accesos directos obsoletos solo cuando el build nuevo funcione.
Capa de agente y modelo
Úsala con errores de ejecución del agente, API de modelo, cuota, tráfico alto o ubicación. Un prompt limpio y una segunda red ayudan a separar fallo local, cuenta, workspace o servicio.
Capa de terminal, Node.js y MCP
Úsala cuando el error menciona npx, node, npm, ejecutable no encontrado, PATH, MCP o política de PowerShell. Verifica comandos fuera y luego alinea el entorno de Antigravity.
Cómo evitar que Antigravity vuelva a fallar
Mantén alineados el IDE, Node.js, npm, npx y tu entorno de shell. Muchos fallos aparecen cuando Node se instala en un perfil de terminal pero Antigravity se abre desde un icono que no hereda el mismo PATH.
Trata los MCP como dependencias reales. Fija versiones cuando necesites estabilidad, evita añadir muchos servidores experimentales a la vez y conserva un workspace mínimo para probar si el agente base funciona.
Usa control de versiones y copia de seguridad. La solución de problemas no debería exigir borrar tu repositorio. Si limpias caché o retiras una instalación antigua, confirma primero que el código y la configuración importante son recuperables.
Nota de seguridad
No ejecutes comandos PowerShell, curl o shell copiados de páginas aleatorias sin entenderlos. Un arreglo del IDE no debe dar acceso a scripts desconocidos a tu código, tokens o sesión del navegador.
Enlaces útiles oficiales e internos
Usa estas páginas para verificar instalador, compatibilidad y actualización después de identificar el fallo.
- Página oficial de descarga de Antigravity - destino oficial de instaladores de Google
- Solución oficial de CLI de Antigravity - referencia oficial para comandos y CLI
- Última versión de Antigravity - úsala si el cliente está antiguo o no soportado
- Requisitos de Antigravity - comprueba sistema, arquitectura, memoria, almacenamiento y red
- Guía para actualizar Antigravity - corrige avisos de versión antigua y accesos directos obsoletos