Cómo instalar Google Antigravity en Windows, macOS y Linux (2026)

Respuesta rápida: Antigravity se instala desde la página oficial antigravity.google/download. Hay tres piezas: la app de escritorio (un IDE con agentes), el CLI agy para la terminal y extensiones para editores como VS Code. El plan individual cuesta 0 USD al mes, con límites semanales básicos. Te basta una cuenta personal de Google para entrar.

Pieza	Windows	macOS	Linux
App de escritorio	Instalador .exe (x64 o ARM64)	Antigravity.dmg → arrastrar a Aplicaciones	tar -xzf Antigravity.tar.gz y ./Antigravity
CLI agy (PowerShell)	irm https://antigravity.google/cli/install.ps1 | iex	—	—
CLI agy (bash)	—	curl -fsSL https://antigravity.google/cli/install.sh | bash	el mismo comando
Verificación	agy --version	agy --version	agy --version

Los comandos de la tabla vienen de la página Getting started de la documentación oficial (consultada el 26 de octubre de 2026). Si Google los cambia, gana la documentación oficial: revisa el enlace en las fuentes antes de copiar.

Esta guía es para quien quiere probar el agente de Google en su propia computadora sin perderse entre nombres. Si vienes de Gemini CLI, primero lee qué cambió en la guía práctica de Gemini CLI. Si dudas entre herramientas, compara con Cómo instalar Codex en Windows y macOS y Cómo instalar Claude Code y Claude Cowork. Cuando termines, el siguiente paso es el curso gratuito Instala tu primer agente.

Qué es Antigravity y qué pieza necesitas

Antigravity es la plataforma de agentes de código de Google. Un agente lee tu proyecto, propone cambios, edita archivos y ejecuta comandos con tu permiso. No es un chat: trabaja dentro de una carpeta real.

La confusión más común es pensar que hay una sola descarga. En realidad hay varias superficies y puedes usar una sola:

Superficie	Para quién	Qué haces ahí
App de escritorio (IDE)	Quien empieza o prefiere ventanas	Abres una carpeta, eliges modo y le pides tareas al agente
CLI agy	Quien ya usa la terminal	Lanzas el agente dentro del repositorio, sin editor
Extensiones de editor	Quien ya vive en VS Code, JetBrains, Visual Studio, Zed o Xcode	Usas el agente sin cambiar de editor
SDK de Python	Quien programa sus propios agentes	pip install google-antigravity en un entorno virtual

Recomendación práctica: si nunca has usado un agente de código, empieza por la app de escritorio. Si ya usas la terminal a diario, instala solo el CLI. No instales las cuatro piezas el primer día.

Requisitos antes de instalar

La documentación oficial pide estos mínimos:

• macOS: macOS 12 (Monterey) o posterior, en Apple Silicon o Intel de 64 bits.
• Windows: Windows 10 de 64 bits o Windows 11.
• Linux: glibc 2.28 o superior y glibcxx 3.4.25 o superior. En la práctica: Ubuntu 20 o posterior, Debian 10 o posterior, Fedora 36 o posterior, RHEL 8 o posterior.
• Extensión de VS Code: VS Code 1.90 o posterior.
• SDK: Python 3.10 o posterior.

Además necesitas una cuenta personal de Google o credenciales de Gemini Enterprise, conexión estable a internet y una carpeta de prueba. Te sugerimos crear una carpeta vacía llamada prueba-antigravity para la primera sesión. Así el agente no toca un proyecto importante mientras aprendes.

Para saber si tu Linux cumple el requisito de glibc, ejecuta ldd --version en la terminal. La primera línea muestra la versión. Si es menor que 2.28, la app no arrancará; usa una distribución más nueva o una máquina virtual.

Cuánto cuesta: plan gratis y planes de pago

Según la página oficial de precios (consultada el 26 de octubre de 2026):

Plan	Precio publicado	Qué añade
Individuals	0 USD/mes	Varios modelos de agente, autocompletado Tab ilimitado, command requests ilimitados y límites semanales básicos
Google AI Pro	No figura en la página de Antigravity	Límites más altos y un fondo flexible de créditos de IA
Google AI Ultra	No figura en la página de Antigravity	Límites aún más altos y acceso prioritario a los modelos Gemini más nuevos
Business (Google Cloud)	Desde 30 USD por usuario al mes, o pago por uso	Controles de administración y topes de gasto

La página no publica las cifras exactas de los límites semanales del plan gratis. No asumas un número de tareas por semana: si llegas al límite, el producto te lo indicará. Para aprender y hacer pruebas pequeñas, el plan gratis basta.

Paso 1: instala la app de escritorio

Descarga siempre desde antigravity.google/download. No uses instaladores de foros ni espejos.

En Windows

1. Abre la página de descarga y elige el instalador de tu procesador: x64 para la mayoría de laptops Intel y AMD, ARM64 para equipos Snapdragon.
2. Ejecuta el archivo .exe y sigue el asistente.
3. Abre Antigravity desde el menú Inicio.

¿No sabes qué procesador tienes? Abre Configuración → Sistema → Información y mira «Tipo de sistema».

En macOS

1. Descarga la versión Apple Silicon (M1, M2, M3 o posterior) o Intel.
2. Abre Antigravity.dmg y arrastra Antigravity a la carpeta Aplicaciones. Si actualizas, elige Reemplazar.
3. Abre la app desde Launchpad o Spotlight.

Para saber qué chip tienes: menú Apple → Acerca de esta Mac → Chip o Procesador.

En Linux

1. Descarga el archivo comprimido de tu arquitectura (x64 o ARM64).
2. Descomprime y ejecuta:

tar -xzf Antigravity.tar.gz
./Antigravity

Si el sistema dice Permission denied, da permiso de ejecución con chmod +x Antigravity y repite.

Paso 2: inicia sesión y crea tu primer proyecto

Al abrir la app, inicia sesión con tu cuenta de Google. Después, según la guía oficial:

1. Pulsa el icono New Project.
2. Agrega una o más carpetas locales o repositorios Git. Usa tu carpeta prueba-antigravity.
3. Pulsa Create.
4. Elige un modo: Local mode trabaja directamente en tu carpeta; New worktree mode crea una copia de trabajo separada con Git, para que los cambios del agente no se mezclen con los tuyos.

Si tu carpeta no es un repositorio Git, usa Local mode. Si ya usas Git, New worktree mode es más seguro: puedes revisar y descartar cambios sin tocar tu rama principal.

Primera tarea de ejemplo (propuesta, no probada por nosotros en tu equipo): pide «Crea un archivo README.md que explique en tres líneas para qué sirve esta carpeta». Revisa el archivo que crea. Si aparece, la instalación funciona.

Paso 3 (opcional): instala el CLI agy

El CLI sirve para usar el agente desde la terminal, sin abrir la app. Los comandos oficiales son:

macOS y Linux:

curl -fsSL https://antigravity.google/cli/install.sh | bash

El binario queda en ~/.local/bin/agy.

Windows (PowerShell):

irm https://antigravity.google/cli/install.ps1 | iex

Windows (CMD):

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

En Windows el binario queda en C:\Users\<tu-usuario>\AppData\Local\agy\bin.

Cierra y vuelve a abrir la terminal. Luego verifica:

agy --version

Si imprime un número de versión, el CLI quedó instalado. Entra a tu carpeta de prueba con cd prueba-antigravity y ejecuta agy. En el primer arranque elige un esquema de color, un modo de dibujo (Alt-Screen o Inline) y si confías en la carpeta. Solo marca como confiable una carpeta que conoces.

Para entender cómo se relaciona el CLI con la herramienta anterior de Google, revisa la guía práctica de Gemini CLI, que explica la migración.

Paso 4 (opcional): extensión para tu editor

Si prefieres no cambiar de editor, instala la extensión de Antigravity desde el marketplace de tu editor. La documentación lista VS Code 1.90+, IDEs de JetBrains 2026.2.1+, Visual Studio 2026 (17.8+), Zed 0.140.0+ y Xcode 27 beta 6+. Inicia sesión cuando el panel de Antigravity lo pida.

Errores comunes y cómo resolverlos

Síntoma	Causa probable	Qué hacer
agy no se reconoce como comando	La terminal se abrió antes de instalar o la ruta no está en PATH	Cierra y abre la terminal. En macOS/Linux confirma que ~/.local/bin está en tu PATH
'irm' is not recognized en Windows	Estás en CMD, no en PowerShell	Usa el comando de CMD de la tabla o abre PowerShell
The token '&&' is not a valid statement separator	Estás en PowerShell con el comando de CMD	Usa el comando de PowerShell
La app no abre en Linux	glibc anterior a 2.28	Revisa con ldd --version y actualiza la distribución
macOS dice que la app está dañada o no verificada	Descarga incompleta o de una fuente no oficial	Borra el archivo y descarga de nuevo desde antigravity.google/download
Aviso de límite alcanzado	Límites semanales del plan gratis	Espera al siguiente periodo o evalúa un plan de pago
Elegiste el instalador equivocado (x64 vs ARM64)	Arquitectura distinta	Revisa el tipo de procesador y descarga la versión correcta

Checklist de seguridad antes de usarlo en un proyecto real

• Prueba primero en una carpeta vacía o en un repositorio de juguete.
• Usa New worktree mode en repositorios Git para revisar los cambios antes de aceptarlos.
• No marques como confiable una carpeta con secretos (.env, llaves SSH, credenciales de nube).
• Lee cada comando que el agente quiera ejecutar antes de aprobarlo.
• Haz commit de tu trabajo antes de pedir cambios grandes. Si algo sale mal, vuelves atrás con Git.

Antigravity frente a otros agentes de código

No hay un ganador universal. Antigravity encaja bien si ya usas cuentas de Google y quieres un IDE con agentes y plan gratis. Codex encaja si ya pagas ChatGPT; Claude Code, si ya pagas Claude. Para una comparación de agentes en terminal, revisa Claude Code vs Codex y la guía práctica de OpenCode, una alternativa de código abierto. El punto de partida del sitio es el hub Construir agentes.

Preguntas frecuentes

¿Antigravity es gratis? Sí, el plan Individuals cuesta 0 USD al mes según la página oficial de precios. Incluye límites semanales básicos cuyo número exacto no se publica en esa página.

¿Necesito saber programar? Para instalarlo, no. Para usarlo bien, ayuda entender qué es una carpeta de proyecto y cómo revisar cambios. El curso Instala tu primer agente cubre esas bases.

¿Puedo usarlo en Windows sin WSL? Sí. La app y el CLI tienen instaladores nativos para Windows 10 de 64 bits y Windows 11.

¿Cuál es la diferencia entre Antigravity y Gemini CLI? Gemini CLI fue el agente de terminal anterior de Google; el CLI agy es la herramienta de terminal de Antigravity. La guía de Gemini CLI explica la transición.

¿Cómo actualizo Antigravity en macOS? Descarga la versión nueva, abre el .dmg y arrástrala a Aplicaciones eligiendo Reemplazar, como indica la guía oficial.

¿Puedo usar el SDK sin la app? Sí. El SDK de Python se instala aparte con pip install google-antigravity y usa una API key de Gemini en la variable GEMINI_API_KEY.

¿Qué hago después de instalarlo? Sigue el curso gratuito Instala tu primer agente: define una tarea pequeña, pruébala y revisa los cambios antes de aceptarlos.