Antigravity se conecta a tu clave de API de Anthropic para enviar las solicitudes de los modelos Claude directamente a través de tu cuenta. Este artículo explica paso a paso la configuración, la selección de modelos, la facturación, los límites de uso y cómo depurar los errores de conexión más comunes.
Si has estado ejecutando flujos de trabajo de IA a mano, copiando resultados de una herramienta a otra o pagando varias suscripciones solo para acceder a distintos modelos de lenguaje, Antigravity se creó justo para ese problema. La plataforma te permite configurar tus propias credenciales de API, enviar las solicitudes directamente a la infraestructura de Anthropic y mantener el control total sobre la facturación, los límites de uso y la selección de modelos. Pero dejar bien hecha esa conexión inicial, sobre todo con el sistema de gestión de credenciales de Anthropic, hace tropezar a más usuarios de los que cabría esperar. Este artículo recorre el proceso exacto, lo que conviene vigilar y lo que se vuelve posible una vez que todo encaja.
Antigravity es una plataforma construida sobre la idea de que debes ser dueño de tus herramientas de IA. En lugar de enviar tus solicitudes a través de un intermediario que sube los costos o oculta qué modelo estás usando en realidad, Antigravity pasa tus credenciales de API directamente al proveedor. Con Anthropic, eso significa que tus solicitudes llegan directamente a los servidores de Claude, se facturan a tu cuenta de Anthropic y se cobran al precio exacto que publica Anthropic.
Esto importa por tres razones:
La contrapartida es que la responsabilidad de la configuración es tuya. Si tus credenciales son incorrectas, han caducado o tienen permisos mal definidos, nada funciona. Hacerlo bien a la primera te ahorra horas de depuración.
La mayoría de las plataformas de IA entran en una de dos categorías: o bien son dueñas del acceso a la API y te cobran un recargo, o bien te piden que traigas tus propias credenciales. Antigravity está claramente en el segundo grupo.
Cuando añades tu token de API de Anthropic a Antigravity, la plataforma lo guarda cifrado y lo inserta como cabecera Authorization en cada solicitud que inicias. Después de introducirlo, nunca volverás a ver el token en claro, Antigravity no lo muestra en los registros y tus solicitudes se contabilizan en tu cuenta personal de Anthropic como si las hubieras hecho directamente.
💡 Importante: Esto también significa que, si tu cuenta de Anthropic se queda sin créditos, las solicitudes de Antigravity fallarán con un error de autenticación, no con un error de la plataforma. Revisa siempre primero el panel de facturación de Anthropic al depurar problemas de conexión.
El modelo de credenciales propias atrae a un tipo de usuario concreto: desarrolladores, responsables técnicos de producto e investigadores que necesitan flujos de trabajo de IA reproducibles sin renunciar al control financiero. Los casos de uso habituales incluyen:
Si te identificas con alguna de estas descripciones, el proceso de configuración que sigue merece los 10 minutos que lleva.
Hay dos cosas que deben estar listas antes de abrir el panel de credenciales de Antigravity: una cuenta activa de Anthropic con un token de API generado y saber a qué nivel de modelo Claude puede acceder tu cuenta.
Anthropic emite los tokens de API desde la Anthropic Console. Los pasos son sencillos:
antigravity-prod o antigravity-test💡 Nombra tus tokens según su uso, no según la fecha. Un token llamado
antigravity-prodes más fácil de revocar o rotar quetoken-june-2024cuando necesites auditar los accesos.
El formato del token empieza por sk-ant-api03-, seguido de una larga cadena alfanumérica. Si el tuyo no empieza por sk-ant, puede que estés viendo un formato obsoleto. Genera uno nuevo desde la Console.
Anthropic utiliza un sistema de niveles de uso que afecta a los límites de uso y al acceso a los modelos:
| Nivel | Requisito de gasto mensual | Límite de velocidad (RPM) | Acceso |
|---|---|---|---|
| Free | $0 (créditos de prueba) | 5 | Modelos limitados |
| Nivel 1 | $5 cobrados | 50 | Modelos estándar |
| Nivel 2 | $100 gastados | 1.000 | Acceso completo a los modelos |
| Nivel 3 | $500 gastados | 5.000 | Acceso prioritario |
| Nivel 4 | $5.000 gastados | Personalizado | Empresarial |
Para la mayoría de los casos de uso con Antigravity, el Nivel 1 es el mínimo recomendable. El límite de 5 solicitudes por minuto del nivel gratuito hará que Antigravity ponga en cola o falle las solicitudes en cualquier flujo de trabajo real.
💡 Comprueba tu nivel antes de configurar. Ve a Anthropic Console, luego a Billing y después a Usage Limits. Tu nivel actual aparece ahí. Mejora el plan antes de conectar si todavía estás en el nivel gratuito.
Con tu token de API listo y tu nivel confirmado, la conexión real en Antigravity lleva menos de cinco minutos. La interfaz exacta varía según la versión de Antigravity, pero el flujo subyacente es el mismo.
Antigravity normalmente hace una llamada ligera de validación al endpoint /v1/models de Anthropic para confirmar que el token es válido. Si se acepta, verás un indicador de estado en verde. Si no, un mensaje de error indicará el problema.
💡 No añadas caracteres extra. Los tokens copiados desde PDF o correos a veces arrastran caracteres de formato invisibles. Pégalo primero en un editor de texto plano, verifica el formato y vuelve a copiarlo antes de pegarlo en Antigravity.
Tras ver el indicador en verde, haz una solicitud de prueba antes de construir nada sobre la conexión:
Ese último paso es importante. Una respuesta correcta en la interfaz de Antigravity no siempre significa que la solicitud se haya enviado con tu token. Confirmar en Anthropic Console que el uso se ha registrado descarta problemas de caché o de enrutamiento.
La primera solicitud real suele sorprender a quienes venían de un entorno con credenciales compartidas. Con tu propio token:
Una vez conectado, tienes acceso a todos los modelos Claude que permita tu nivel de Anthropic. Aquí es donde la configuración da sus frutos: ya no estás limitado al modelo que la plataforma tenga licenciado.
Anthropic organiza Claude en tres niveles de capacidad. Cada uno ofrece un equilibrio distinto entre velocidad y calidad:
| Modelo | Velocidad | Costo | Ideal para |
|---|---|---|---|
| Claude Opus 4.7 | Lenta | Alto | Razonamiento complejo, documentos largos |
| Claude Opus 4.6 | Lenta | Alto | Análisis de varios pasos |
| Claude 4.5 Sonnet | Media | Medio | Programación, resultados estructurados |
| Claude 4 Sonnet | Media | Medio | Escritura general, preguntas y respuestas |
| Claude 3.7 Sonnet | Media | Más bajo | Tareas cotidianas equilibradas |
| Claude 4.5 Haiku | Rápida | Bajo | Clasificación, extracción |
| Claude 3.5 Haiku | Rápida | Bajo | Tareas sencillas de gran volumen |
| Claude 3.5 Sonnet | Media | Más bajo | Redacción de contenidos |
Antigravity te permite cambiar entre estos modelos en el menú desplegable del selector de modelos. La selección se mantiene por flujo de trabajo, así que puedes tener una canalización con Opus para analizar documentos y otra con Haiku para clasificar en lote, ambas con el mismo token de API.
Esta pregunta surge constantemente, y la respuesta es siempre: empieza con Sonnet.
Claude 4.5 Sonnet ofrece una relación calidad-costo que funciona para la mayoría de las tareas de producción. Recurre a Claude Opus 4.7 cuando la tarea requiera de verdad un razonamiento profundo, no solo porque quieras el resultado "mejor". Recurre a Claude 4.5 Haiku cuando ejecutes cientos o miles de solicitudes y los resultados individuales no necesiten pulirse.
💡 Una regla práctica: Si gastas más de $5 al día en un único flujo de trabajo de Antigravity usando Opus, revisa si Sonnet daría resultados aceptables a una fracción del costo. La mayoría de las veces, sí.
Una de las mayores sorpresas para los desarrolladores que llegan a las plataformas BYOK es descubrir que la facturación y los límites de uso funcionan de forma distinta a lo esperado.
Anthropic cobra por token: los tokens de entrada y los de salida tienen precios separados, y las tarifas varían según el modelo. A mediados de 2025, los precios aproximados eran estos (consulta la página de precios de Anthropic para las cifras actuales):
Estos costos se acumulan en tu cuenta de Anthropic, no en el sistema de facturación de Antigravity. Antigravity no añade ningún recargo sobre los precios de Anthropic: pagas directamente a Anthropic.
Antigravity muestra el uso de tokens en su panel de flujos de trabajo. Cada solicitud completada muestra:
Esto permite auditar en la práctica los flujos de trabajo caros antes de que disparen la factura de Anthropic. El campo de costo estimado usa las tarifas publicadas por Anthropic, así que la cifra que veas debería coincidir con tu factura de uso de Anthropic a final de mes.
💡 Configura una alerta de presupuesto en Anthropic Console. En Billing, puedes configurar alertas para umbrales concretos en dólares: $25, $100, lo que te resulte cómodo. Antigravity no te detendrá automáticamente si superas tu límite; el sistema de alertas de Anthropic es la salvaguarda.
Incluso un token de API introducido correctamente puede causar problemas. Estos son los fallos más comunes y cómo resolverlos.
Error: 401 Unauthorized o Invalid API Key
Casi siempre significa una de estas tres cosas:
Solución: Ve a la configuración de Antigravity, elimina el token guardado y vuelve a introducirlo manualmente desde Anthropic Console. No copies del historial del portapapeles si has tenido el token guardado allí durante más de unos pocos días.
Error: 403 Forbidden o Rate limit exceeded
Un 403 significa que tu token no tiene permiso para acceder al modelo que seleccionaste. Esto suele ocurrir cuando estás en el nivel gratuito e intentas acceder a un modelo que requiere el Nivel 1 o superior.
Un error de límite de uso (429) significa que has alcanzado tu límite de solicitudes por minuto. La solución es mejorar tu nivel de Anthropic o añadir pausas entre solicitudes en la configuración de tu flujo de trabajo de Antigravity.
| Código de error | Significado | Solución |
|---|---|---|
| 401 | Token no válido o ausente | Volver a introducir el token |
| 403 | Nivel insuficiente | Mejorar la cuenta de Anthropic |
| 429 | Límite de uso alcanzado | Añadir pausas o mejorar el nivel |
| 529 | Anthropic sobrecargado | Esperar y reintentar |
| 500 | Error del servidor | Reintentar; informar si persiste |
Si tus solicitudes de Antigravity se completan pero tardan 30 segundos o más, el problema suele ser la longitud del prompt, no la conexión. Anthropic procesa los tokens de forma lineal, y una ventana de contexto de 10.000 tokens necesita tiempo real para procesarse incluso en modelos rápidos.
Soluciones para la latencia alta:
Tener el token en su sitio es solo el punto de partida. Lo que Antigravity permite en realidad es más interesante que el proceso de conexión en sí.
Con tu token de API activo, Antigravity puede ejecutar flujos de trabajo programados que llamen a Claude a intervalos. Las configuraciones automatizadas habituales incluyen:
Cada uno de estos flujos de trabajo se ejecuta con tu token de API, y los costos pasan a tu cuenta de Anthropic. El costo por token de cada flujo de trabajo es visible en el panel de Antigravity.
Más allá de la automatización, Antigravity permite construir herramientas internas que usan Claude como capa de razonamiento. Los equipos de producto las han usado para crear:
La principal ventaja es que estas herramientas no requieren que construyas tú mismo una capa de integración de API. Antigravity se encarga del enrutamiento de las solicitudes; tú solo defines el flujo de trabajo y el modelo.
💡 Mantén los datos sensibles fuera de los prompts. Incluso con tu propio token de API, los prompts enviados a través de Anthropic están sujetos a las políticas de tratamiento de datos de Anthropic. Revisa esas políticas antes de enviar información personal identificable, datos financieros o información confidencial a través de la API.
Cuando un flujo de trabajo funciona bien, la mayoría de los equipos se encuentran con la pregunta de cómo escalar sin perder visibilidad de los costos.
La forma más limpia es un token de API de Anthropic independiente por entorno:
antigravity-development con un límite de gasto configurado en Anthropic Consoleantigravity-production con monitorización y alertas configuradasantigravity-testing rotado cada mesAsí puedes seguir los costos por entorno, revocar un token sin afectar a los demás y auditar el uso por separado. En Antigravity, añades cada token al espacio de trabajo o proyecto correspondiente.
La Console de Anthropic muestra el uso desglosado por token y por modelo. Cruza estos datos cada semana con el panel de flujos de trabajo de Antigravity para detectar los casos en los que un flujo se ejecutó más de lo previsto o eligió un modelo más caro del que pretendías.
Una comprobación semanal sencilla:
Los picos inesperados suelen significar que un flujo de trabajo ejecutó más iteraciones de las previstas o que una ventana de contexto creció más de lo habitual. Ambos problemas son fáciles de corregir en cuanto los detectas.
💡 Define
max_tokensen cada solicitud a Anthropic. Antigravity lo muestra como un parámetro que puedes configurar por flujo de trabajo. Limitar la longitud de la salida evita costos descontrolados en tareas de generación abierta que a veces producen respuestas muy largas.
Si ya tienes resuelta la conexión a la API y quieres ver lo que la IA puede producir más allá del texto, las herramientas de generación de imágenes de PicassoIA merecen unos minutos de experimentación. La plataforma te da acceso a más de 90 modelos de texto a imagen, desde generadores fotorrealistas hasta estilos artísticos, todo sin necesidad de configurar credenciales ni gestionar la facturación tú mismo. Empieza con un prompt sencillo e itera a partir de ahí. Es la forma más rápida de ver lo que estos modelos pueden hacer de verdad cuando no tienes que lidiar con paneles de configuración.
Elige tu idioma
