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.
Antes de pedir ayuda, anota el mensaje exacto, cuándo aparece, el sistema operativo y la versión de Acerca de, si ocurre en un espacio limpio y los cambios recientes en Node.js, PATH, proxy o herramientas MCP. Reprodúcelo en un proyecto pequeño con una instrucción breve. Elimina rutas personales, correos, tokens, cookies, claves API y código privado antes de compartir registros. No publiques un archivo de diagnóstico completo. Así se puede dirigir un informe de Antigravity no funciona a la app, la cuenta, la red, la terminal o el espacio de trabajo sin repetir reinstalaciones arriesgadas.
| 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
Si la app se abre pero funciona de forma extraña, consulta Acerca de y la página oficial de descargas de Google antes de cambiar ajustes. Cierra todos los procesos, usa solo el instalador publicado allí, vuelve a abrir Antigravity con el acceso directo habitual y comprueba la versión. Si sigue apareciendo una versión antigua, revisa accesos obsoletos o instalaciones duplicadas.
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
Si la app se abre, anota la versión en Acerca de y copia el error exacto antes de reinstalar.
Prueba un workspace limpio
Prueba una instrucción breve en una carpeta limpia; si funciona, revisa las herramientas o reglas del proyecto original.
Repara la capa correcta
Actualiza solo ante fallos de versión; corrige PATH, la política del shell o el comando MCP señalado.
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.
Agent execution terminated due to error: checklist enfocada
Cuando aparece este error exacto, separa el enrutamiento del modelo de los fallos de herramientas locales. Prueba primero un prompt de una línea en una carpeta limpia. Si funciona, reactiva MCP de uno en uno, reduce contexto y localiza si termina en shell, npx o navegador. Para el mensaje exacto 'agent execution terminated due to error', anota que paso fallo antes de reintentar: respuesta del modelo, comando de terminal, accion del navegador o herramienta MCP. Si siempre falla la misma herramienta local, revisa la configuracion; si falla antes de iniciar herramientas, suele apuntar a sesion, red, cuota o enrutamiento.
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
Compara Acerca de con la página de Google, cierra los procesos y revisa el destino del acceso directo al volver a abrir.
Capa de agente y modelo
Prueba una instrucción limpia y otra red de confianza para separar fallos del proyecto, cuenta, conexión o servicio.
Capa de terminal, Node.js y MCP
Comprueba node, npx, PATH, la política del shell y el comando MCP indicado desde una terminal externa.
Cómo evitar que Antigravity vuelva a fallar
Después de cambiar Node.js o PATH, reinicia toda la app y compara node y npx con tu terminal habitual.
Haz una copia de seguridad antes de borrar cachés; prueba MCP uno por uno y ejecuta solo comandos que entiendas.
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
- 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