Usar Gemini CLI con CometAPI

Usa esta guía para ejecutar Gemini CLI con CometAPI como endpoint de API. Referencias oficiales:

La disponibilidad de los modelos cambia con el tiempo. Consulta la página de modelos de CometAPI para ver los modelos Gemini disponibles.

Requisitos previos

Requisito	Detalles
Node.js	22+ (se recomienda LTS)
OS	macOS, Linux o Windows
Clave de CometAPI	Desde tu CometAPI Dashboard (empieza con `sk-`)

Install Gemini CLI

npm install -g @google/gemini-cli

O mediante Homebrew (macOS / Linux):

brew install gemini-cli

Verifica:

gemini --version

Set environment variables

export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

Reemplaza sk-your-cometapi-key por tu clave real de CometAPI.

Start Gemini CLI

cd your-project
gemini

En el primer inicio, se te pedirá que elijas un tema, confirmes el aviso de seguridad y confíes en el directorio de trabajo.

Para evitar volver a exportarlas en cada sesión, añádelas a la configuración de tu shell:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

Reinicia tu terminal para que los cambios surtan efecto.

Error de API Key no válida

Verifica que GEMINI_API_KEY esté configurada correctamente. Ejecuta echo $GEMINI_API_KEY para comprobarlo.

fetch failed

Las restricciones de red pueden bloquear la conexión. Prueba un proxy de todo el sistema.

Versión incorrecta de Node.js

Gemini CLI requiere Node.js 22+. Ejecuta node --version para comprobarlo.

Desinstalar Gemini CLI

Ejecuta npm uninstall -g @google/gemini-cli.