Antigravity CLI
Conecte Google Antigravity CLI (agy) a la API nativa de Gemini de HopBase con una clave de API de Gemini y una URL base personalizada.
Antigravity CLI (comando agy) es el agente de programación para terminal de Google. Admite iniciar sesión con una clave de API de Gemini y cambiar la URL base, y usa directamente el protocolo nativo de Gemini, así que basta con apuntar la URL base a HopBase. No interviene ninguna capa de conversión.
| Ajuste | Valor |
|---|---|
modelProvider (settings.json) | gemini |
GEMINI_API_KEY | Una clave creada en la consola |
GOOGLE_GEMINI_BASE_URL | https://api.hop-base.com |
| Endpoint que llama | POST /v1beta/models/{model}:streamGenerateContent?alt=sse |
Verificado en producción con agy 1.5.12: leer, escribir y editar archivos, ejecutar comandos de shell, llamadas a herramientas en paralelo y en secuencia, retomar la conversación con --continue, contexto largo, entrada de imágenes y una tarea de programación completa (crear un proyecto, escribir código y ejecutar las pruebas) funcionan.
Seleccione Gemini oficial directo (empresarial) al crear la clave. Tanto el modelo que elija en agy como los modelos auxiliares que agy llama en segundo plano están en este grupo; una clave sin él recibe 404.
Configurar Antigravity CLI
Instalación
En macOS, instálelo con Homebrew:
brew install --cask antigravity-cli
agy --versionEn otros sistemas, siga la página oficial de Antigravity CLI. Para usar una clave de API con una URL base personalizada se necesita la versión 1.1.13 o posterior.
Cambie el inicio de sesión a clave de API de Gemini
Edite ~/.gemini/antigravity-cli/settings.json en su directorio personal (créelo si no existe):
{
"modelProvider": "gemini"
}El valor debe ser gemini en minúsculas. Si solo define las variables de entorno y omite este ajuste, agy sigue iniciando sesión con una cuenta de Google.
Defina la clave y la URL base
export GEMINI_API_KEY=sk-your-key
export GOOGLE_GEMINI_BASE_URL=https://api.hop-base.comPara que se mantengan, añada ambas líneas a ~/.zshrc o ~/.bashrc.
Indique en GOOGLE_GEMINI_BASE_URL solo la URL raíz, sin rutas como /v1beta. agy lee las variables de entorno de la terminal desde la que se inicia; no lee archivos .env ni GOOGLE_API_KEY.
Inicie agy y elija un modelo
agy --model gemini-4-argon-medium
# o ejecute una sola instrucción
agy -p "Explain this repository" --model gemini-4-hydrogen-lowElegir un modelo
El nombre de modelo en agy es el ID de modelo de HopBase más un sufijo de nivel de razonamiento. El sufijo fija thinkingLevel en la solicitud: cuanto más alto, más tiempo razona y más tokens usa. agy models muestra la lista integrada de agy; guíese por esta tabla:
| Modelo de HopBase | Sufijos | Ejemplo |
|---|---|---|
gemini-4-argon | -low / -medium / -high | agy --model gemini-4-argon-medium |
gemini-4-carbon | -low / -medium / -high | agy --model gemini-4-carbon-high |
gemini-4-hydrogen | -low / -medium / -high | agy --model gemini-4-hydrogen-low |
gemini-4-neon | -low / -medium / -high | agy --model gemini-4-neon-medium |
gemini-3.8-flash | -low / -medium / -high | agy --model gemini-3.8-flash-medium |
Consulte los precios en Modelos.
Después de cada paso, agy hace una revisión de seguridad con gemini-3.1-flash-lite-preview o gemini-3.8-flash. Estas solicitudes también se facturan y aparecen en el registro de uso de la consola.
Limitaciones conocidas
- Respuesta completa de una vez: las respuestas no se transmiten token a token; cada una llega entera cuando termina de generarse. Con respuestas largas o niveles de razonamiento altos, agy espera un rato y luego muestra la respuesta completa. No está bloqueado.
- El nivel
-xhighaún no es compatible: use-highen lugar de un modelo-xhighde la lista de agy. - Las solicitudes interrumpidas se facturan: si pulsa Ctrl+C, la solicitud ya enviada termina en el servidor y se factura.
Próximos pasos
- Chat de Gemini: use los mismos modelos de Gemini desde su propio código
- Códigos de error y reintentos: cómo actuar ante 429, 502 y 503
- Solución de problemas: busque un mensaje de error