Como instalar Gemini CLI paso a paso

Que es Gemini CLI?

Gemini CLI (antes Antigravity) es la herramienta de línea de comandos de Google impulsada por Gemini. Soporta entrada multimodal (texto, imágenes, código), razonamiento avanzado y contexto largo. Es ideal para automatización, análisis y generación de código.

En esta guia completa te enseñaremos a instalarlo desde cero, configurarlo con diferentes proveedores de IA, asegurarlo correctamente, y sacarle el maximo partido con consejos profesionales y flujos de trabajo reales. Al final, como bonus, te explicamos como potenciarlo con las 1136 skills de SKILLSBUNDLE.

Requisitos del sistema

Antes de empezar, asegurate de que tu sistema cumple estos requisitos:

• Sistema operativo: macOS 12+, Windows 10+ (64-bit) o Ubuntu 20+ / Debian 11+ / Fedora 38+
• RAM: 8 GB minimo (16 GB recomendado para proyectos grandes)
• Disco: 500 MB para la herramienta + espacio para tus proyectos
• Node.js 18+ (si la instalacion es via npm)
• Python 3.9+ (para herramientas como Aider y Hermes Agent)
• Git (para herramientas que trabajan con repositorios)
• Conexion a internet (para descargar e instalar; para IA en la nube)
• Terminal: bash, zsh o PowerShell

Metodos de instalacion

Hay varias formas de instalar Gemini CLI. Elige la que mejor se adapte a tu sistema y preferencias:

npm (recomendado)

npm install -g @google/gemini-cli

Instalador oficial

curl -fsSL https://gemini.google.com/cli/install.sh | sh

Homebrew (macOS)

brew install gemini-cli

Verificar la instalacion

Una vez instalado, verifica que todo funciona:

gemini --version

Si ves un error, revisa la seccion de solucion de problemas al final de la guia.

Configurar autenticacion y proveedores de IA

La mayoria de herramientas de IA requieren configurar al menos un proveedor de modelos. Aqui tienes las opciones disponibles para Gemini CLI:

API Key de Google AI Studio

Consigue tu API key en makersuite.google.com/app/apikey
export GEMINI_API_KEY=AIza...
Es el método más simple para uso individual.

Cuenta de Google Cloud Vertex AI

Para equipos empresariales. Configura autenticación con gcloud auth application-default-login.

OpenRouter (alternativa)

export GEMINI_API_BASE_URL=https://openrouter.ai/api/v1
export GEMINI_API_KEY=sk-or-...
Para acceder a Gemini a través de OpenRouter con facturación consolidada.

Proveedores alternativos

No tienes por que limitarte a un solo proveedor. Aqui tienes una comparativa de los principales proveedores de IA que puedes usar:

Seguridad: mejores practicas

La seguridad es critica cuando usas herramientas de IA que tienen acceso a tu sistema. Sigue estas recomendaciones:

• API key: almacénala en variable de entorno, nunca en el código. Añade .env a .gitignore.
• Gemini CLI no almacena tus conversaciones en Google si usas API key de AI Studio (no entrenan con tus datos).
• Para datos sensibles: usa Vertex AI con VPC-SC (Service Perimeters) y Data Loss Prevention.
• Modo offline: Gemini CLI no funciona sin conexión a internet. Alternativa local: Ollama.
• Las consultas multimodales (imágenes) se envían a Google. No subas imágenes con datos sensibles.
• Revisa la política de retención de datos de Google AI Studio antes de usar con datos de producción.
• Para entornos regulados: usa Vertex AI con configuración de residencia de datos en EU/US.
• Rotación de keys: renueva tu API key periódicamente desde makersuite.google.com.

Consejos profesionales

Una vez que Gemini CLI funciona, estos consejos te ayudaran a usarlo como un experto:

• Gemini CLI soporta entrada multimodal: pasa imágenes, PDFs y código como entrada.
• Usa gemini chat para modo conversacional interactivo, o gemini -p 'pregunta' para consultas rápidas.
• El contexto largo de Gemini (hasta 2M tokens) permite procesar documentos completos.
• Modo streaming: gemini --stream para ver la respuesta en tiempo real.
• Gemini puede analizar imágenes: 'describe esta imagen y extrae el texto que contiene'.
• Para programación: gemini -p 'genera un script Python que haga X'.
• Combinación con herramientas Unix: pipes, redirección, y scripts de shell.
• Usa gemini --model gemini-2.5-flash para tareas simples (más rápido y barato) y gemini-2.5-pro para tareas complejas.

Flujos de trabajo recomendados

Estos son los casos de uso mas potentes de Gemini CLI:

• Análisis multimodal: pasa una imagen de un diagrama y pide 'explícame esta arquitectura y sugiere mejoras'
• Procesamiento de documentos: 'resume este PDF de 50 páginas en 10 puntos clave'
• Generación de código: 'crea un script Python que procese este CSV y genere un informe'
• Traducción: 'traduce este documento manteniendo el formato técnico'
• Análisis de logs: 'analiza este archivo de log y encuentra patrones de error'
• Automatización de terminal: 'crea un comando que busque archivos duplicados en este directorio'
• Investigación: 'investiga las últimas tendencias en X y crea un resumen estructurado'
• Análisis de datos: 'analiza este dataset y genera visualizaciones de las tendencias principales'

Solucion de errores comunes

command not found: gemini

npm global no está en PATH. Solución: export PATH=$PATH:$(npm config get prefix)/bin

Error: API key not valid

La API key de Google AI Studio es inválida o expiró. Solución: genera una nueva en makersuite.google.com.

Gemini no responde

Problema de conexión o cuota excedida. Solución: verifica tu conexión y revisa el límite de requests en AI Studio.

Error: 'Safety settings'

El contenido fue bloqueado por los filtros de seguridad de Google. Solución: ajusta safety_settings en la configuración.

El modelo no acepta imágenes

El modelo seleccionado no soporta entrada multimodal. Solución: usa gemini-2.5-pro que sí soporta imágenes.

Error de cuota: 429 Too Many Requests

Has excedido el límite de requests. Solución: espera un minuto o actualiza a un plan de pago en Vertex AI.

Gemini CLI no funciona offline

Gemini requiere conexión a internet. Alternativa local: instala Ollama con un modelo como gemma-2.

Contexto demasiado grande

El input supera el límite de tokens. Solución: divide el documento en partes más pequeñas.

Preguntas frecuentes

¿Puedo usar varios proveedores a la vez?

Si, la mayoria de herramientas permiten configurar multiples modelos. Puedes usar uno rapido (Haiku, GPT-4o-mini) para tareas simples y uno potente (Opus, GPT-5) para tareas complejas.

¿Funciona sin conexion a internet?

Solo si usas modelos locales con Ollama, LM Studio o llama.cpp. Los modelos en la nube requieren conexion permanente.

¿Cual es el mejor proveedor para empezar?

OpenRouter: una sola API key, 300+ modelos, facturación consolidada. Puedes probar todos los modelos sin comprometerte con uno.

¿Como protejo mis API keys?

Usa variables de entorno (export CLAVE=valor), nunca las incluyas en el codigo, anade .env a .gitignore, y usa un gestor de secrets como 1Password o Bitwarden.

¿Puedo compartir mi configuracion con el equipo?

Comparte el archivo de configuracion sin las API keys. Usa variables de entorno para los secrets y documenta que variables necesita cada miembro del equipo.

Comparativa: como se compara con otras herramientas

Cada herramienta de IA tiene sus fortalezas. La mejor eleccion depende de tu flujo de trabajo: si trabajas en terminal, busca un agente CLI; si usas IDE, busca una extension; si valoras la privacidad, busca soporte para modelos locales como Ollama.

Configuracion avanzada

La mayoria de herramientas de IA ofrecen opciones de configuracion avanzada que mejoran la productividad:

• Archivo de reglas de proyecto: define el estilo de codigo, frameworks y convenciones para que la IA los siga automaticamente.
• Variables de entorno: usa export CLAVE=valor para configurar API keys, URLs base, y opciones de red.
• Multi-modelo: configura un modelo rapido para tareas simples y uno potente para tareas complejas.
• Logs y debug: activa logging detallado para diagnosticar problemas de conexion o rendimiento.
• Modo offline: si usas modelos locales, configura la herramienta para funcionar sin conexion a internet.

Ejemplos de uso reales

Estos son prompts reales que puedes usar para empezar a trabajar inmediatamente con tu herramienta recien instalada. Copia y pega, adapta segun tu proyecto:

# 1. Prompt de ejemplo para desarrollo
"Implementa un endpoint REST para gestion de usuarios con:
- CRUD completo con validacion de datos
- Autenticacion JWT con refresh tokens
- Tests unitarios y de integracion
- Documentacion OpenAPI"

# 2. Prompt de ejemplo para debugging
"El siguiente error ocurre en produccion: TypeError: Cannot read property 'id' of undefined
en src/services/userService.ts:45
Encuentra la causa raiz, propon una solucion y escribe un test que prevenga la regresion."

# 3. Prompt de ejemplo para documentacion
"Genera documentacion tecnica completa para el proyecto incluyendo:
- README con instrucciones de instalacion y uso
- JSDoc para todas las funciones exportadas
- Diagrama de arquitectura en Mermaid
- Guia de contribucion"

# 4. Prompt de ejemplo para testing
"Crea tests unitarios para el modulo de pagos cubriendo:
- Happy path: pago exitoso con tarjeta valida
- Error: tarjeta rechazada por fondos insuficientes
- Edge case: timeout de conexion con Stripe
- Seguridad: token de tarjeta invalido"

Bonus: Potencia Gemini CLI con 1136 skills de SKILLSBUNDLE

Ahora que Gemini CLI funciona perfectamente con tu proveedor de IA favorito, es momento de llevarlo al siguiente nivel. SKILLSBUNDLE te ofrece 1136 skills profesionales listos para usar.

Los skills son archivos de instrucciones que tu herramienta carga automaticamente segun el contexto. Con SKILLSBUNDLE obtienes:

• 40 verticales: marketing, finanzas, desarrollo web, SEO, diseno, y mas
• 15 tipos de uso: creacion de contenido, analisis de datos, automatizacion
• Skills transversales: code review, testing, documentacion, seguridad
• Optimizados y probados: cada skill ha sido refinado para dar resultados consistentes

Instalar los skills es directo:

# 1. Compra SKILLSBUNDLE en skillsbundle.com
# 2. Descarga skills.zip
# 3. Descomprime y copia las skills al directorio de tu herramienta
unzip skills.zip -d ~/skillsbundle-pack
cp -r ~/skillsbundle-pack/skills/* ~/antigravity/skills/
# 4. Verifica
ls ~/antigravity/skills/ | wc -l   # Deberias ver 1136

Una vez copiados, cada vez que uses Gemini CLI con un prompt que toque una vertical, la skill correspondiente se cargara automaticamente.

Incluye 1136 skills, actualizaciones gratuitas y soporte prioritario