Gemini CLI

Configura Gemini CLI con CometAPI: instálalo mediante npm o Homebrew, configura GEMINI_API_KEY y GOOGLE_GEMINI_BASE_URL, y comienza a usar modelos Gemini en tu terminal.

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

Referencias oficiales:

• Gemini CLI GitHub
• Gemini CLI Authentication

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

​

Requisitos previos

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

​

Configuración

1. Instalar Gemini CLI

   npm install -g @google/gemini-cli
   

   O mediante Homebrew (macOS / Linux):

   brew install gemini-cli
   

   Verifica:

   gemini --version
   
2. Configurar variables de entorno

   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.

3. Iniciar 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.

​

Mantener las variables de entorno

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.

​

Solución de problemas

Síntoma	Solución
Error Invalid API Key	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 con un proxy de sistema
Versión incorrecta de Node.js	Gemini CLI requiere Node.js 22+. Ejecuta node --version para comprobarlo
Desinstalar	npm uninstall -g @google/gemini-cli