Saltar al contenido

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.

AjusteValor
modelProvider (settings.json)gemini
GEMINI_API_KEYUna clave creada en la consola
GOOGLE_GEMINI_BASE_URLhttps://api.hop-base.com
Endpoint que llamaPOST /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.

La clave debe incluir el grupo de Gemini.

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 --version

En 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.com

Para 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-low

Elegir 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 HopBaseSufijosEjemplo
gemini-4-argon-low / -medium / -highagy --model gemini-4-argon-medium
gemini-4-carbon-low / -medium / -highagy --model gemini-4-carbon-high
gemini-4-hydrogen-low / -medium / -highagy --model gemini-4-hydrogen-low
gemini-4-neon-low / -medium / -highagy --model gemini-4-neon-medium
gemini-3.8-flash-low / -medium / -highagy --model gemini-3.8-flash-medium

Consulte los precios en Modelos.

agy llama a modelos auxiliares en segundo plano.

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 -xhigh aún no es compatible: use -high en lugar de un modelo -xhigh de 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