Cómo usar Google Antigravity en VS Code paso a paso
Aprende a instalar Google Antigravity en VS Code, iniciar sesión, abrir el panel del agente, entregar contexto, ejecutar una primera tarea, revisar planes y cambios línea por línea, controlar permisos y solucionar los errores más frecuentes sin abandonar tu editor habitual.
¿Cómo instalar y usar Google Antigravity en VS Code?
Abre Visual Studio Code, entra en Extensiones con Ctrl+Shift+X en Windows o Linux —o Cmd+Shift+X en macOS—, busca Google Antigravity y comprueba que el publicador sea Google. Pulsa Install, abre el icono de Antigravity en la barra de actividad e inicia sesión con tu cuenta de Google.
Actualiza VS Code
La extensión requiere la versión 1.90 o una posterior.
Instala la extensión oficial
Busca Google Antigravity y verifica que esté publicada por Google.
Inicia sesión
Completa la autenticación en el navegador y vuelve al editor.
Abre tu proyecto
Carga una carpeta o workspace con Git y sin cambios pendientes.
Describe una tarea
Indica objetivo, alcance, restricciones y pruebas esperadas.
Revisa antes de aceptar
Comprueba el plan, comandos, diffs, tests y comportamiento final.
Durante el primer inicio, la extensión instala automáticamente el servicio local agy que utiliza como backend. No necesitas instalar previamente Antigravity CLI para completar este flujo.
La extensión no es lo mismo que Antigravity 2.0, IDE o CLI
Todas estas superficies comparten el ecosistema de agentes de Google, pero resuelven necesidades distintas. Esta guía se concentra en la extensión que añade Antigravity a una instalación existente de Visual Studio Code.
| Superficie | Cómo se utiliza | Cuándo elegirla |
|---|---|---|
| Extensión para VS Code | Panel agentic dentro de tu VS Code actual. | Quieres conservar extensiones, tema y flujo del editor. |
| Antigravity IDE | Entorno de desarrollo completo creado alrededor del agente. | Prefieres una experiencia integrada de Google desde el inicio. |
| Antigravity 2.0 | Aplicación independiente para organizar y supervisar agentes. | Quieres dirigir Projects y trabajo agentic desde un centro de comando. |
| Antigravity CLI | Interfaz de terminal mediante el comando agy. | Trabajas principalmente en consola, scripts o sesiones remotas. |
Instalación y workflow dentro de Visual Studio Code
Para Projects, Local Mode y New Worktree de la aplicación independiente, utiliza la guía general. Para comandos agy, instalación manual y trabajo terminal-first, consulta las páginas dedicadas a la CLI.
Qué necesitas para utilizar Antigravity en VS Code
La instalación es ligera, pero conviene verificar la versión del editor, la cuenta y el estado de tu proyecto antes de permitir que un agente ejecute comandos o modifique archivos.
| Requisito | Mínimo o condición | Cómo comprobarlo |
|---|---|---|
| Visual Studio Code | Versión 1.90 o posterior | Abre Help/About o Code/About según el sistema. |
| Sistema operativo | Windows, macOS o Linux | Los tres están admitidos oficialmente. |
| Cuenta individual | Cuenta personal de Google con cualquier plan compatible | El nivel gratuito también permite iniciar sesión. |
| Cuenta empresarial | Gemini Enterprise habilitado por la organización | El administrador asigna licencia, proyecto y región. |
| Proyecto local | Carpeta o workspace accesible desde VS Code | Recomendado: repositorio Git con estado limpio. |
Antigravity utiliza la cuota vinculada a la cuenta con la que inicias sesión. Si tu uso es frecuente, revisa la diferencia entre la capacidad base, Google AI Pro y Ultra antes de atribuir una interrupción a la extensión.
Cómo instalar Google Antigravity en Visual Studio Code
Abre Visual Studio Code
Actualiza el editor si estás utilizando una versión anterior a 1.90.
Entra en Extensiones
Usa Ctrl+Shift+X en Windows/Linux o Cmd+Shift+X en macOS.
Busca Google Antigravity
Escribe el nombre completo para evitar extensiones con nombres parecidos.
Verifica el publicador
La ficha oficial aparece publicada por Google en VS Code Marketplace.
Pulsa Install
Espera a que VS Code termine de descargar y activar la extensión.
Abre el icono de Antigravity
Lo encontrarás en la Activity Bar del editor.
Completa el primer inicio
La extensión instala automáticamente su servicio backend local agy.
Antigravity for Visual Studio Code
La dirección de Marketplace utiliza el identificador Google.google-antigravity. Abre esa ficha si la búsqueda interna devuelve varios resultados.
Cómo iniciar sesión en Antigravity desde VS Code
La autenticación está unificada con Antigravity 2.0 y la CLI. La cuenta elegida determina los modelos, límites de cuota y políticas de datos que se aplicarán a las conversaciones iniciadas en el editor.
Selecciona Sign In
Hazlo desde el panel que se abre al pulsar el icono de Antigravity.
Continúa en el navegador
Elige la cuenta personal o corporativa correcta y autoriza el acceso.
Regresa a VS Code
La sesión se conecta automáticamente con tus derechos y límites.
Confirma el nivel activo
Verifica que la cuenta coincida con el plan que pretendes utilizar.
Para una cuenta empresarial, selecciona la opción de Gemini Enterprise y utiliza la identidad, proyecto de Google Cloud y región definidos por tu organización. Si no aparece una licencia, el administrador debe revisar la asignación antes de reinstalar la extensión.
Qué añade Antigravity a la interfaz de VS Code
La extensión no se limita a colocar un chat genérico. Integra el agente con el workspace abierto para planificar, utilizar herramientas, ejecutar procesos y mostrar evidencia revisable junto al código.
| Elemento | Función | Qué debes revisar |
|---|---|---|
| Icono en Activity Bar | Abre el espacio principal de Antigravity. | Cuenta conectada y workspace activo. |
| Panel lateral | Conversaciones, prompts y seguimiento de la tarea. | Objetivo, contexto, modelo y modo seleccionados. |
| Implementation Plan | Explica el enfoque antes de cambios amplios. | Alcance, archivos, riesgos y verificaciones. |
| Inline diffs | Muestran adiciones y eliminaciones dentro del editor. | Cada hunk antes de aceptarlo o rechazarlo. |
| Artifacts | Presentan planes, reportes, checklists y evidencia. | Que la evidencia corresponda al resultado solicitado. |
| Agent Manager | Permite supervisar agentes y subagentes. | Estado, tareas, permisos y resultados producidos. |
Cómo ejecutar tu primera tarea con Antigravity en VS Code
Para aprender el flujo sin arriesgar un proyecto importante, empieza con una modificación pequeña, recuperable y fácil de probar. Evita utilizar producción, credenciales reales o migraciones destructivas en la primera sesión.
Abre una carpeta con Git
Ejecuta tu revisión habitual y confirma que no haya cambios ajenos.
Selecciona el archivo relevante
Abre el código o marca el fragmento relacionado con la tarea.
Abre una conversación nueva
Separa objetivos importantes para mantener contexto y revisión claros.
Entrega una instrucción verificable
Describe el resultado, archivos permitidos, restricciones y pruebas.
Pide un plan antes de editar
Revisa el enfoque cuando la tarea afecte varias partes del proyecto.
Aprueba solo lo necesario
Evalúa comandos, archivos externos, URLs y herramientas solicitadas.
Comprueba el diff
Acepta o rechaza cada bloque según el objetivo acordado.
Verifica fuera del chat
Ejecuta tests, build, lint y una prueba manual cuando corresponda.
Objetivo:
Corrige la validación del formulario de contacto.
Contexto:
- El frontend está en src/contact/
- El endpoint ya funciona
- No cambies estilos ni dependencias
Criterios de aceptación:
- El correo inválido muestra un mensaje claro
- El botón no envía dos veces
- Los tests actuales siguen pasando
Antes de modificar archivos:
explica la causa y propón un plan breve.Cómo darle contexto al agente sin enviar todo el proyecto
Antigravity conoce el workspace, los archivos abiertos y la selección actual. Aun así, no conviene confiar en que deducirá por sí solo el alcance correcto. Un prompt útil combina contexto visible con límites explícitos.
Si una conversación empieza a mezclar bugs, refactors y nuevas funcionalidades, abre otra. Separar tareas mejora la trazabilidad de los planes, permisos, diffs y artifacts.
Cómo revisar y aceptar los cambios del agente
Los inline diffs permiten comparar cada propuesta con el archivo actual. Puedes aceptar o rechazar un bloque, resolver el archivo completo o comentar sobre el diff para pedir una corrección antes de integrarlo.
Lee el plan
Confirma que la solución aborda la causa y no amplía el alcance.
Abre Review Changes
Recorre todos los archivos modificados durante la conversación.
Evalúa cada hunk
Busca código ajeno, datos sensibles, cambios silenciosos y duplicación.
Comenta cuando algo no encaje
Pide una revisión concreta sobre el propio diff en vez de aceptarlo.
Acepta solo lo aprobado
Utiliza Accept All únicamente después de revisar el archivo completo.
Comprueba Git
El diff final del repositorio debe coincidir con el resultado acordado.
Atajos útiles de Antigravity en VS Code
| Acción | Windows y Linux | macOS |
|---|---|---|
| Abrir Extensiones de VS Code | Ctrl+Shift+X |
Cmd+Shift+X |
| Mostrar u ocultar el panel del agente | Ctrl+L |
Cmd+L |
| Crear una conversación | Ctrl+Shift+L |
Cmd+Shift+L |
| Aceptar un hunk | Alt+Enter |
Revisa el comando mostrado por la extensión. |
Si un atajo entra en conflicto con otra extensión o con tu keymap, ábrelo desde Keyboard Shortcuts y busca Antigravity para reasignarlo. La etiqueta visible en VS Code es la referencia más fiable para tu sistema y versión concreta.
Configura permisos conservadores antes de delegar
El agente puede ejecutar terminal, modificar archivos y conectarse con herramientas externas. En Agent Settings, la extensión permite decidir si los comandos requieren revisión y limitar el acceso a recursos fuera del workspace.
| Ajuste | Comportamiento | Recomendación |
|---|---|---|
| Request Review | Solicita aprobación para comandos salvo excepciones permitidas. | Úsalo mientras aprendes y en repositorios sensibles. |
| Allow list | Autoriza acciones específicas sin repetir la confirmación. | Incluye solo comandos seguros, frecuentes y bien acotados. |
| Deny list | Bloquea acciones o comandos definidos. | Protege operaciones destructivas o fuera del flujo. |
| Acceso fuera del workspace | Amplía la lectura o escritura a otras rutas. | Déjalo desactivado salvo una necesidad concreta. |
| Ejecución automática | Reduce confirmaciones y aumenta autonomía. | Actívala solo con repositorio recuperable y reglas revisadas. |
El workspace no debe equivaler a todo tu equipo
Abre únicamente las carpetas necesarias para la tarea. No añadas tu directorio personal, copias de producción ni ubicaciones con claves solo para evitar una solicitud de permiso.
Agentes y subagentes dentro de VS Code
Antigravity puede dividir trabajos complejos entre subagentes especializados. La ficha oficial menciona perfiles de investigación, navegador y clonación del agente principal, además de subagentes personalizados. Cada uno devuelve un resumen estructurado al agente que coordina la tarea.
| Tipo | Uso habitual | Qué revisar |
|---|---|---|
| Research | Explorar repositorios, dependencias y arquitectura. | Fuentes, rutas revisadas y conclusiones. |
| Browser | Probar interfaces mediante una sesión de Chrome. | URLs, interacciones, capturas y grabaciones. |
| Self | Paralelizar investigación o generación de código. | Solapamientos, contradicciones y consumo. |
| Custom | Aplicar un rol, procedimiento o especialidad propia. | Instrucciones, herramientas y permisos asignados. |
No uses paralelismo por defecto. Un bug pequeño suele necesitar un solo agente. Reserva subagentes para tareas con ramas realmente independientes y comprueba que el resultado consolidado no introduzca cambios duplicados.
Conectar MCP con Antigravity en VS Code
Model Context Protocol permite que el agente utilice herramientas y
fuentes externas, como GitHub, PostgreSQL, Slack o Jira. Los servidores
se administran desde la configuración de Antigravity o mediante archivos
mcp_config.json.
| Alcance | Ruta | Cuándo usarlo |
|---|---|---|
| Global | ~/.gemini/config/mcp_config.json |
El mismo servidor estará disponible en varios proyectos. |
| Proyecto | .agents/mcp_config.json |
Configuración específica y versionable para el repositorio. |
Concede a cada servidor únicamente las herramientas necesarias. Mantén contraseñas y tokens fuera del repositorio, revisa los comandos del servidor y evita exponer un acceso de escritura cuando la tarea solo requiere consultar información.
¿Antigravity para VS Code es gratis?
La extensión puede utilizarse con una cuenta personal compatible, incluido el nivel gratuito. La cuenta determina la cuota de agentes y los modelos disponibles; instalar la extensión no crea una cuota separada de Antigravity 2.0 o la CLI.
Usar Antigravity en VS Code con Gemini Enterprise
La extensión de VS Code es una superficie compatible con Gemini Enterprise. El acceso corporativo puede aplicar identidad centralizada, IAM, proyecto y región de Google Cloud, cuotas administradas y controles como VPC Service Controls.
Abre Sign In
Inicia el flujo desde el panel de Antigravity en VS Code.
Elige Gemini Enterprise
Utiliza la identidad corporativa asignada por la organización.
Selecciona proyecto y región
Confirma los recursos habilitados por el administrador.
Verifica las políticas
Revisa IAM, privacidad, red, registros y límites antes de trabajar.
Si la opción empresarial o la licencia no aparece, no intentes resolverlo creando otra cuenta personal. Comprueba con el administrador que tu identidad tenga una licencia compatible y acceso al proyecto correcto.
Errores frecuentes de Antigravity en VS Code
| Problema | Causa probable | Qué revisar |
|---|---|---|
| No puedo instalar la extensión | VS Code es anterior a la versión 1.90. | Actualiza el editor y vuelve a abrir Marketplace. |
| No aparece el icono | La extensión está deshabilitada o la Activity Bar está oculta. | Comprueba Enable y reinicia la ventana de VS Code. |
| Sign In vuelve al editor sin sesión | Cuenta incorrecta, callback bloqueado o navegador restringido. | Repite el flujo con la cuenta correcta y permite abrir VS Code. |
| El backend agy no inicia | La descarga inicial fue interrumpida o bloqueada. | Revisa red, proxy, antivirus y logs antes de reinstalar. |
| El agente no ve un archivo | La carpeta no pertenece al workspace abierto. | Abre la carpeta correcta; no amplíes acceso a todo el sistema. |
| Solicita muchas aprobaciones | La tarea requiere acciones fuera de las reglas actuales. | Autoriza solo patrones seguros y repetitivos, no un permiso global. |
| No permite iniciar otra tarea | La cuota de la cuenta puede haberse agotado. | Revisa uso y renovación antes de reinstalar la extensión. |
| El atajo no funciona | Existe un conflicto de keybindings. | Busca Antigravity en Keyboard Shortcuts y reasigna el comando. |
| El diff contiene cambios inesperados | La instrucción no limitó alcance o el workspace era demasiado amplio. | Rechaza el cambio, reduce contexto y pide un plan nuevo. |
Lista de control para trabajar de forma segura
Extensión oficial
El publicador es Google y el identificador coincide con Marketplace.
Cuenta correcta
El plan, la cuota y la política de datos son los esperados.
Workspace acotado
Solo incluye carpetas necesarias para completar la tarea.
Git recuperable
El estado inicial está limpio o los cambios previos están identificados.
Objetivo medible
La instrucción contiene límites y criterios de aceptación.
Permisos mínimos
Cada comando, archivo externo y herramienta tiene una justificación.
Diff revisado
No aceptaste archivos o bloques fuera del alcance.
Evidencia comprobada
Tests, build y prueba manual respaldan el resultado final.
Fuentes oficiales sobre Antigravity para VS Code
Los requisitos, pasos de instalación, autenticación y capacidades de esta guía fueron contrastados con Google Antigravity Docs y la ficha oficial publicada en Visual Studio Marketplace.
Siguiente guía: Antigravity Agent Manager
FAQ sobre Google Antigravity en VS Code
Sí. Google ofrece una extensión oficial para VS Code en Windows, macOS y Linux. Permite conversar con agentes, revisar planes y diffs, ejecutar tareas de varios pasos y utilizar herramientas sin salir del editor.
Abre Extensiones, busca Google Antigravity, verifica que el publicador sea Google y pulsa Install. Después abre su icono en la Activity Bar e inicia sesión desde el navegador.
La documentación oficial exige Visual Studio Code 1.90 o posterior. Si la instalación no está disponible, comprueba y actualiza primero la versión del editor.
No. La extensión instala automáticamente el servicio local agy durante el primer inicio. Antigravity CLI es una superficie independiente para quienes quieren trabajar directamente desde la terminal.
Puede utilizarse con una cuenta personal compatible, incluido el nivel gratuito. Los modelos, la capacidad y la renovación de la cuota dependen del plan asociado a esa cuenta.
Sí. El agente puede editar archivos, ejecutar terminal y usar herramientas. Debes limitar el workspace, configurar revisión de comandos y comprobar los diffs antes de aceptar cambios.
La extensión añade Antigravity a una instalación existente de Visual Studio Code. Antigravity IDE es un entorno independiente creado por Google con la experiencia agentic integrada en el propio editor.
Sí. La extensión es compatible con Gemini Enterprise y puede utilizar identidad corporativa, proyectos y regiones de Google Cloud, IAM y controles de gobierno definidos por la organización.
Instala la extensión y completa una tarea pequeña y verificable
Empieza con un repositorio recuperable, permisos conservadores y una mejora cuyo resultado puedas probar. La velocidad importa menos que entender el plan, revisar el diff y comprobar que el código hace exactamente lo pedido.
Instalar Antigravity para VS Code →