Guía de Usuario de Gemini CLI - Google AI en Tu Terminal

Gemini CLI es una herramienta de IA de línea de comandos de código abierto proporcionada por Google que lleva el poder de Gemini directamente a tu terminal. Ofrece una forma ligera de acceder a Gemini, proporcionando el camino más directo desde el prompt hasta el modelo. Configurando un proxy, puedes usar los servicios de Gemini CLI incluso en entornos con restricciones de red.

¿Por qué elegir Gemini CLI?#

• Potente Gemini 2.5 Pro: Acceso a una ventana de contexto de 1 millón de tokens
• Herramientas integradas: Google Search grounding, operaciones con archivos, comandos de Shell, web scraping
• Extensible: Compatible con MCP (Model Context Protocol) para integraciones personalizadas
• Orientado al terminal: Diseñado para desarrolladores que trabajan en la línea de comandos
• Código abierto: Licencia Apache 2.0

Instalación#

Instalación rápida#

Ejecútalo al instante con npx (sin instalación requerida)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Instalación global con npm#

npm install -g @google/gemini-cli

Instalación con Homebrew (macOS/Linux)#

brew install gemini-cli

Requisitos del sistema#

• Node.js versión 20 o superior
• macOS, Linux o Windows

Configuración del Proxy#

Establecer variables de entorno#

Antes de usar el proxy, configura las siguientes variables de entorno:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Consejo: Agrega estas variables de entorno a tu archivo .bashrc, .zshrc o al archivo de configuración de tu shell para que se establezcan automáticamente cada vez que inicies el terminal.

Inicio rápido#

Uso básico#

Iniciar en el directorio actual#

gemini

Incluir múltiples directorios#

gemini --include-directories ../lib,../docs

Usar un modelo específico#

gemini -m gemini-2.5-flash

Modo de script no interactivo#

Obtén una respuesta de texto simple:

gemini -p "Explain the architecture of this codebase"

Obtén salida JSON estructurada:

gemini -p "Explain the architecture of this codebase" --output-format json

Ejemplos rápidos#

Iniciar un nuevo proyecto#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Analizar código existente#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Funciones principales#

Comprensión y generación de código#

• Consultar y editar grandes bases de código
• Generar nuevas aplicaciones a partir de PDFs, imágenes o bocetos usando capacidades multimodales
• Depurar problemas y solucionarlos utilizando lenguaje natural

Automatización e integración#

• Automatizar tareas operativas como consultar pull requests o manejar rebases complejos
• Conectar nuevas capacidades usando servidores MCP
• Ejecutar de forma no interactiva en scripts para la automatización de flujos de trabajo

Funciones avanzadas#

• Obtener información en tiempo real usando Google Search incorporado
• Puntos de comprobación de conversación para guardar y restaurar sesiones complejas
• Archivos de contexto personalizados (GEMINI.md) para adaptar el comportamiento a tu proyecto

Comandos y ejemplos comunes#

Explorar la base de código#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Trabajar con código existente#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Automatizar flujos de trabajo#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Interacción con el sistema#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

Integración con GitHub#

Usa Gemini CLI GitHub Action para integrar Gemini CLI directamente en tus flujos de trabajo de GitHub:

• Revisiones de Pull Request: Revisiones de código automatizadas con comentarios y sugerencias contextuales
• Priorización de issues: Etiquetado y priorización automática de issues de GitHub basados en el análisis de contenido
• Ayuda bajo demanda: Menciona @gemini-cli en issues y pull requests para obtener ayuda con depuración, explicaciones o delegación de tareas
• Flujos de trabajo personalizados: Crea flujos de trabajo automatizados, programados y bajo demanda adaptados a las necesidades de tu equipo

Solución de problemas#

Si encuentras problemas durante el uso, ten en cuenta lo siguiente:

1. Verificar las variables de entorno#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Verificar la conexión de red#

curl -I https://crazyrouter.com/

3. Revisar los mensajes de error#

Los mensajes de error normalmente indican el problema. Los problemas comunes incluyen:

• Formato de clave de API inválido
• Problemas de conectividad de red
• Configuración de proxy incorrecta

4. Formato del proxy SOCKS#

Si usas un proxy SOCKS, asegúrate de que el formato sea correcto:

socks5://<user>:<pass>@<proxy>:<port>

5. Reportar errores#

Usa el comando integrado para reportar problemas:

/bug

Versiones de lanzamiento#

Preview#

Las nuevas versiones preview se lanzan todos los martes a las 23:59 UTC:

npm install -g @google/gemini-cli@preview

Stable#

Las nuevas versiones estables se lanzan todos los martes a las 20:00 UTC:

npm install -g @google/gemini-cli@latest

Nightly#

Las versiones nightly se lanzan todos los días a las 00:00 UTC:

npm install -g @google/gemini-cli@nightly

Uso del servidor MCP#

Configura servidores MCP en ~/.gemini/settings.json para ampliar Gemini CLI con herramientas personalizadas:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Precios a través de Crazyrouter#

Accede a los modelos Gemini con tarifas con descuento:

Todos los precios incluyen un 45% de descuento en comparación con las tarifas oficiales.

Recursos relacionados#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

¿Necesitas ayuda? Contacta con soporte o consulta la documentación de Crazyrouter para más información.