Cómo usar Claude Code en Antigravity IDE: guía paso a paso (aunque no programes)

Qué es Antigravity IDE y por qué usarlo

Antigravity IDE es el editor de código de Google. Es gratuito, está basado en Visual Studio Code (así que se ve y se maneja igual) y trae de serie su propio agente de IA. Lo importante para nosotros: acepta las mismas extensiones que VS Code, y entre ellas está Claude Code. Es decir, puedes tener a Claude trabajando en tus carpetas dentro de un programa que se instala en un minuto y no cuesta nada.

¿Y por qué no usar el agente de Google que ya viene dentro? Puedes, y de hecho conviven bien. Pero si ya pagas Claude Pro o Max, Claude Code va incluido en tu plan, conoce tus skills y tu CLAUDE.md, y es el mismo Claude que usas en el chat. La regla práctica: un agente por tarea. No lances los dos sobre la misma carpeta a la vez.

Qué necesitas

• Antigravity IDE, gratuito para Windows, Mac y Linux: descargar Antigravity IDE. Pide iniciar sesión con una cuenta de Google.
• Una cuenta de Claude con plan Pro o Max (el gratuito no incluye Claude Code). No hacen falta claves de API ni configurar nada a mano.
• Una carpeta con lo que quieras que Claude trabaje: documentos, hojas de cálculo, fotos, un proyecto. Empieza con una copia si son archivos importantes.

Instalar Claude Code en Antigravity IDE

1. Abre Antigravity IDE y, en el menú File › Open Folder, elige la carpeta con la que vas a trabajar.
2. Pulsa Ctrl + Mayús + X (o el icono de bloques de la barra izquierda) para abrir Extensiones.
3. Busca Claude Code e instala la extensión de Anthropic. Es la misma que en VS Code.
4. Aparece un icono con el asterisco de Claude en la barra izquierda. Púlsalo y haz clic en Iniciar sesión: se abre el navegador, entras con tu cuenta Pro o Max y vuelves al editor.
5. Listo. Ya tienes el panel de Claude Code con un cuadro de texto abajo. Todo lo que escribas ahí se ejecuta sobre la carpeta abierta.

El panel, en un vistazo

• Cuadro de texto: donde pides las cosas. Escribe @ para señalar un archivo concreto y / para ver los comandos.
• Modelo y esfuerzo: la pastilla junto al cuadro (por ejemplo, "Opus 5 · Extra high") elige el modelo y cuánto razona. Para tareas normales, el modelo por defecto va bien.
• Selector de modo (el icono del rayo): decide cuánto permiso le das. Lo vemos ahora.
• Historial (icono del reloj): tus sesiones anteriores en esta carpeta. Cada carpeta tiene el suyo.

Los tres modos: Preguntar, Auto y Plan

Claude Code siempre te enseña lo que va a hacer, pero puedes elegir cuánto te pregunta. Se cambia con el selector junto al cuadro de texto o pulsando Mayús + Tab.

Hay un cuarto modo, sin permisos, que solo existe en la terminal y acepta todo. No lo uses: para eso está Auto, que mantiene las preguntas que importan.

Tres tareas para empezar hoy

Las tres son reales, se hacen en menos de diez minutos y dejan un resultado que puedes ver. Cada una lleva el prompt listo para pegar (cambia lo que va entre corchetes), el modo recomendado, qué comprobar y qué pedir después. Empieza siempre en modo Preguntar y sobre una copia.

1. Ordenar la carpeta de Descargas

Antes: 300 archivos mezclados, nombres como documento(3).pdf o IMG_4521.jpg. Después: carpetas por tipo y nombres que dicen qué es cada cosa. Abre tu carpeta de Descargas en Antigravity (mejor una copia) y pega:

Ordena esta carpeta sin borrar nada.
1) Primero enséñame una tabla con cada archivo, su tipo y a qué carpeta lo moverías.
2) Cuando te diga OK, crea las carpetas Documentos, Imágenes, Hojas de cálculo,
   Instaladores y Otros, y mueve cada archivo a la suya.
3) Renombra los documentos y hojas con el formato AAAA-MM-DD_que-es.pdf usando
   la fecha del archivo y un nombre corto sacado de su contenido.
4) Si ves duplicados, no los borres: ponlos en una carpeta Duplicados y avísame.

Modo: Preguntar la primera vez; Auto cuando ya sepas cómo trabaja. Comprueba: abre dos o tres archivos renombrados y confirma que el nombre coincide con el contenido. Después pide: «Haz lo mismo cada vez que te lo pida con la palabra ordena» y guárdalo como skill, o «Genera un índice.txt con la lista de lo que hay en cada carpeta».

2. Pasar facturas en PDF a una hoja de Excel

Antes: una carpeta con las facturas del trimestre. Después: un Excel con una fila por factura, totales y las que no cuadran marcadas. Crea una carpeta con 5 o 10 facturas y pega:

Lee todas las facturas PDF de esta carpeta y crea facturas.xlsx con estas columnas:
fecha, proveedor, número de factura, base imponible, IVA, total y nombre del archivo.
- Formato de moneda en las columnas de importes y una fila final de totales con fórmula.
- Comprueba que base + IVA = total; si no cuadra, pinta la fila en amarillo.
- Si en alguna factura no encuentras un dato, deja la celda vacía y dime cuál.
- Ordena por fecha, de la más antigua a la más reciente.

Modo: Preguntar (solo crea un archivo nuevo, no toca las facturas). Comprueba: elige dos facturas al azar y compara con el PDF: es el hábito que evita sustos. Después pide: «Añade una hoja con el gasto por proveedor y un gráfico de barras», o «Haz una hoja por mes». Cuando el resultado te convenza, esta tarea se deja automática con n8n y Claude: cada factura que llegue al correo entra sola en la hoja.

3. Crear una página web de una sola hoja

Antes: una carpeta vacía. Después: tu web abierta en el navegador, lista para enseñar o publicar. Crea la carpeta mi-web, ábrela en Antigravity y pega:

Crea una página web de una sola hoja para [clases de guitarra en Sevilla].
Público: [adultos que empiezan de cero]. Objetivo: que me escriban por WhatsApp.
Secciones, en este orden: cabecera con nombre y una frase, qué ofrezco (3 bloques),
cómo funciona (3 pasos), precios (2 opciones), 3 opiniones, preguntas frecuentes
y un botón grande de WhatsApp al [+34 600 000 000].
Solo HTML y CSS en archivos separados. Diseño limpio, colores [azul y blanco],
letra legible, que se vea bien en el móvil. Textos reales en español, nada de
"lorem ipsum". Al terminar, dime cómo abrirla.

Modo: Preguntar o Auto (la carpeta está vacía, no hay riesgo). Comprueba: ábrela en el navegador y también en el móvil (o estrecha la ventana). Después pide: «La cabecera más grande y con una foto de fondo», «Cambia los precios a 25 €/hora y 80 €/mes», «Añade una sección de horarios». Es la tarea que mejor enseña cómo trabaja Claude Code: pides, ves, corriges. Para publicarla gratis, arrastra la carpeta a Netlify Drop o Cloudflare Pages y tendrás una dirección en un minuto.

El archivo CLAUDE.md: tus reglas fijas

Claude Code lee al empezar un archivo llamado CLAUDE.md en la raíz de la carpeta. Ahí van las cosas que no quieres repetir en cada sesión: en qué idioma responde, qué carpetas no debe tocar, cómo quieres los nombres de archivo, qué formato usar. Tres líneas cambian mucho el resultado. Descarga una de nuestras plantillas de CLAUDE.md, guárdala en la carpeta y edita lo que va entre corchetes.

Cómo trabajar bien con Claude Code

• Una tarea por mensaje. "Ordena la carpeta y luego haz el Excel" funciona peor que dos peticiones seguidas.
• Revisa los cambios. Antigravity resalta lo que Claude modifica; mira el diff antes de aceptar. En modo Auto, revisa al final.
• Copias o Git. Hasta que le cojas el ritmo, trabaja sobre copias. Si quieres un paso más, pide a Claude que "inicialice Git y haga un commit antes de empezar": así siempre puedes volver atrás.
• Escribe /clear al cambiar de tarea. Una conversación larga con temas mezclados empeora los resultados y gasta más.
• Guarda lo que repites como skill: el informe semanal, el formato de tus facturas, la estructura de tus webs.

Antigravity IDE y Claude Code: cuándo usar cada uno

Antigravity IDE trae su propio agente (con modelos de Google) y un gestor de agentes para lanzar varias tareas a la vez. Claude Code vive en su panel, con tu plan de Anthropic. No compiten: puedes usar el de Google para explorar un proyecto y Claude para el trabajo fino, o al revés. Lo único que debes evitar es que los dos editen los mismos archivos al mismo tiempo. Si dudas, elige uno por carpeta y mantente en él.

Errores habituales

• "No aparece el panel de Claude": no has abierto una carpeta. File › Open Folder y vuelve a pulsar el icono.
• "Me pide iniciar sesión otra vez": la sesión caduca de vez en cuando. Pulsa Iniciar sesión; los archivos y el historial siguen ahí.
• Claude toca archivos que no debía: estás en modo Auto con una carpeta demasiado grande. Vuelve a Preguntar y añade al CLAUDE.md las carpetas prohibidas.
• Respuestas lentas o cortadas: la conversación es muy larga. /compact la resume; /clear empieza de cero.
• Un cambio salió mal: dile "deshaz el último cambio" o, si usas Git, "vuelve al último commit".