- Open source y gratuito: publicado en GitHub bajo licencia Apache 2.0 con un tier gratuito de 60 RPM y 1M tokens de contexto, el más generoso del mercado entre los agentes de coding para terminal.
- Contexto de 1 millón de tokens: mayor ventana de contexto que cualquier otro agente de coding en terminal, lo que permite cargar repositorios enteros sin fragmentar ni resumir archivos.
- Google Search grounding nativo: el único agente de coding con integración nativa de Google Search, lo que le permite responder con información actualizada y citar fuentes verificadas sin alucinaciones.
- Soporte MCP: compatible con el Model Context Protocol para conectar herramientas externas, bases de datos y APIs, igual que Claude Code y otros agentes modernos.
- Motor Gemini 3.1 Pro / 3.5 Flash: utiliza los modelos más capaces de Google, con capacidad de edición multiarchivo, ejecución de comandos shell e integración nativa con Git.
¿Qué es Gemini CLI y por que Google lo creo?
Gemini CLI es la respuesta de Google al auge de los agentes de coding para la terminal. Disponible en github.com/google-gemini/gemini-cli bajo licencia Apache 2.0, es una herramienta de línea de comandos que convierte a los modelos de Gemini AI en un agente autónomo capaz de entender el contexto completo de un repositorio, proponer cambios en múltiples archivos y ejecutar comandos directamente en el sistema.
A diferencia de los asistentes de código integrados en IDEs cómo GitHub Copilot o Gemini Code Assist, Gemini CLI opera a nivel de sistema operativo. Tiene acceso al sistema de archivos, puede ejecutar scripts, instalar dependencias, realizar commits en Git y buscar en la web con Google Search. Su arquitectura sigue el patrón de los agentes de coding modernos: un bucle de razonamiento, uso de herramientas y un contexto amplio que le permite actuar de forma autónoma sobre el proyecto.
Google lanzo Gemini CLI en 2025 cómo competidor directo de Claude Code de Anthropic y Codex CLI de OpenAI. Su principal apuesta diferencial es el tier gratuito más generoso del mercado entre los agentes de coding para terminal, combinado con la integración nativa de Google Search para grounding de respuestas. La documentación oficial y el código fuente están disponibles en ai.google.dev.
Como instalar y configurar Gemini CLI
Gemini CLI se distribuye cómo paquete npm. Requiere Node.js 18 o superior y una cuenta de Google o clave de API de Gemini.
Instalar el paquete npm
Instala Gemini CLI globalmente con npm. Requiere Node.js 18 o superior.
npm install -g @google/gemini-cli
Después de la instalación, verifica que funciona con gemini --version.
Autenticación y clave de API
Dos opciones para autenticarse: cuenta de Google (tier gratuito) o clave de API de Gemini para mayor control.
# Opcion A: autenticacion con cuenta Google
gemini auth
# Opcion B: clave de API (obtenida en AI Studio)
export GEMINI_API_KEY="tu_clave_de_api"
gemini --api-key $GEMINI_API_KEYObtención de la clave de API de Gemini
Si prefieres usar una clave de API en lugar de autenticación OAuth, puedes obtenerla en Google AI Studio de forma gratuita. El proceso es directo:
- Accede a Google AI Studio con tu cuenta de Google.
- Ve a Get API Key en el menu lateral.
- Crea un nuevo proyecto o selecciona uno existente.
- Genera la clave y copiarla en una variable de entorno o en el archivo de configuración de Gemini CLI.
La clave de API del tier gratuito permite hasta 60 solicitudes por minuto (RPM) sin coste. Para uso intensivo o en producción, se puede activar la facturación en Google Cloud y acceder a limites más altos.
Primera ejecución
Una vez instalado y autenticado, puedes ejecutar Gemini CLI desde cualquier directorio del proyecto:
# Modo interactivo (conversacion continua)
cd mi-proyecto/
gemini
# Tarea de un solo comando
gemini "Analiza este repositorio y sugiere cómo mejorar la estructura de carpetas"
# Con especificacion del modelo
gemini --model gemini-3.1-pro "Refactoriza el archivo src/auth.js"En el modo interactivo, Gemini CLI lee automáticamente los archivos del directorio actual y los incluye en el contexto. Puede editar archivos directamente, ejecutar comandos y solicitar confirmación antes de operaciones destructivas.
Capacidades clave de Gemini CLI
Gemini CLI combina la ventana de contexto más grande del mercado con herramientas nativas de Google Search, edición multiarchivo y soporte MCP.
1M tokens de contexto
La ventana de contexto más grande de cualquier agente de coding para terminal. Permite cargar repositorios completos de tamaño moderado sin necesidad de fragmentar ni resumir archivos. Especialmente útil en proyectos monorepo o con mucha interdependencia entre módulos.
Google Search grounding
Único agente de coding con busqueda web nativa de Google. Puede consultar documentación actualizada, buscar soluciones a errores en Stack Overflow o verificar información factual directamente desde el flujo de trabajo, sin cambiar de herramienta.
Soporte MCP
Compatible con el Model Context Protocol para conectar herramientas externas, bases de datos, APIs y servicios personalizados. Permite extender las capacidades del agente sin modificar el código fuente de Gemini CLI.
Edición multiarchivo
Puede analizar, crear y modificar múltiples archivos en una sola sesión. Entiende las relaciones entre módulos, imports y dependencias, lo que le permite realizar refactorizaciones coherentes que afectan a varios archivos a la vez.
Ejecución de comandos
Ejecuta comandos shell directamente en el sistema: instalar dependencias, correr tests, ejecutar scripts de build o cualquier comando de la terminal. Siempre solicita confirmación antes de operaciones potencialmente destructivas.
Integración Git
Puede revisar el historial de Git, entender cambios recientes y crear commits con mensajes descriptivos. Útil para tareas de code review, generación de changelogs y gestión del flujo de trabajo de desarrollo.
Google Search grounding: la ventaja diferencial
La integración nativa con Google Search es la característica que más distingue a Gemini CLI del resto de agentes de coding para terminal. Cuando el agente necesita información que no está en el contexto del repositorio, puede buscar directamente en Google sin necesidad de configuración adicional:
- Consultar la documentación actualizada de una libreria antes de usarla.
- Buscar soluciones a mensajes de error específicos en Stack Overflow o GitHub Issues.
- Verificar la compatibilidad de versiones entre dependencias.
- Obtener ejemplos de código recientes para patrones de implementación modernos.
Esta capacidad reduce significativamente el riesgo de que el agente use APIs obsoletas o recomiende soluciones que ya han sido deprecadas. Es especialmente valiosa en ecosistemas que evolucionan rápido cómo el de JavaScript/Node.js o los modelos de IA.
Extensibilidad con MCP
Gemini CLI implementa el Model Context Protocol (MCP), el estándar abierto para conectar agentes de IA con herramientas externas. Con MCP puedes conectar Gemini CLI a:
- Bases de datos (PostgreSQL, MySQL, SQLite) para analizar esquemas y datos.
- APIs REST externas para obtener o enviar información durante la sesión.
- Servicios de terceros cómo Jira, GitHub o Slack para automatizar flujos de trabajo.
- Herramientas propietarias con servidores MCP personalizados.
La configuración de servidores MCP se realiza en el archivo .gemini/config.json
del directorio de usuario o del proyecto, siguiendo el mismo esquema que otros agentes compatibles.
Gemini CLI vs Claude Code vs Codex CLI
Los tres principales agentes de coding para terminal comparados en las dimensiones que más importan a los desarrolladores.
| Dimensión | Gemini CLI | Claude Code | Codex CLI |
|---|---|---|---|
| Desarrollador | Anthropic | OpenAI | |
| Licencia | Open source (Apache 2.0) | Propietario | Propietario |
| Instalación | npm install -g @google/gemini-cli |
npm install -g @anthropic-ai/claude-code |
npm install -g @openai/codex |
| Contexto máximo | 1M tokens | 1M tokens | 400K tokens |
| Motor LLM | Gemini 3.1 Pro / 3.5 Flash | Claude Opus 4.7 / Sonnet 4.6 | GPT-5.4 / o3 |
| Google Search nativo | Si | Via herramienta | Via herramienta |
| Soporte MCP | Si | Si | Parcial |
| Edición multiarchivo | Si | Si | Si |
| Ejecución de comandos | Si | Si | Si |
| Tier gratuito | 60 RPM, 1M contexto | No (solo API de pago) | Limitado |
| Precio aproximado | Gratis / API Gemini | API Anthropic / Plan Max | API OpenAI |
Cuando elegir Gemini CLI
Gemini CLI es la mejor opción cuando:
- Necesitas el tier gratuito más generoso del mercado para experimentar sin coste.
- Tu proyecto requiere que el agente busque información actualizada en la web de forma nativa.
- Trabajas con repositorios muy grandes que se benefician de los 1M tokens de contexto.
- Prefieres herramientas open source para auditar el código o contribuir al proyecto.
- Ya usas el ecosistema de Google y quieres integración con Google Cloud o Vertex AI.
Cuando Claude Code puede ser mejor opción
Claude Code puede ser más adecuado cuando el proyecto requiere capacidades avanzadas de razonamiento complejo, cuando el equipo ya usa Claude cómo modelo principal o cuando se necesita un ecosistema de hooks y skills más maduro. Ambas herramientas comparten la ventana de 1M tokens y soporte MCP, por lo que en muchos casos la elección depende del modelo de lenguaje preferido del equipo.
Casos de uso: que puedes hacer con Gemini CLI
Desarrollo y refactorización de código
El caso de uso más comun es la asistencia en el desarrollo diario. Gemini CLI puede entender la arquitectura completa de un proyecto y proponer cambios coherentes en múltiples archivos:
- Refactorización: solicitar la extracción de lógica repetida en funciones reutilizables, migrar de una libreria a otra o adaptar el código a nuevas versiones de lenguajes.
- Generación de tests: crear tests unitarios e integración para funciones existentes, incluyendo casos limite y mocks de dependencias externas.
- Code review automatizado: analizar pull requests o ramas antes de su aprobación, identificando bugs potenciales, problemas de seguridad o violaciones de estilo.
- Migraciones: actualizar dependencias, adaptar el código a nuevas versiones de frameworks o migrar entre paradigmas (callbacks a async/await, por ejemplo).
Investigación y documentación
La integración con Google Search convierte a Gemini CLI en una herramienta de investigación técnica poderosa. Puede combinar el conocimiento del repositorio con información actualizada de la web para generar documentación rica y precisa:
- Generar documentación de API a partir del código fuente, enriquecida con ejemplos buscados en la web.
- Crear guías de integración que incluyan información actualizada de librerias de terceros.
- Producir changelogs automáticos analizando el historial de Git y las notas de las versiones.
- Investigar soluciones a problemas complejos combinando el contexto del proyecto con busquedas web.
Automatización de flujos de trabajo
Más allá del coding, Gemini CLI puede automatizar tareas repetitivas que normalmente requieren intervención manual:
- CI/CD: configurar pipelines de integración continua, revisar logs de error y proponer correcciones.
- Gestión de dependencias: identificar vulnerabilidades en dependencias, proponer actualizaciones y verificar compatibilidades.
- Monitoreo de código: analizar periodicamente el repositorio en busca de deuda técnica, código duplicado o patrones problematicos.
- Integración con herramientas via MCP: conectar con Jira para crear tickets automáticamente, con GitHub para gestionar issues o con bases de datos para analizar datos.
Preguntas frecuentes sobre Gemini CLI
¿Qué es Gemini CLI exactamente?
Gemini CLI es un agente de programación de código abierto desarrollado por Google, disponible en GitHub bajo licencia Apache 2.0. Funciona directamente en la terminal y utiliza los modelos Gemini 3.1 Pro o 3.5 Flash para analizar repositorios completos, editar múltiples archivos, ejecutar comandos shell, buscar en la web con Google Search y automatizar tareas de desarrollo. Es el competidor directo de Claude Code y Codex CLI, con la ventaja de ser open source y tener un tier gratuito muy generoso.
¿Cómo se instala Gemini CLI?
Gemini CLI se instala con npm de forma global. Requiere Node.js 18 o superior:
npm install -g @google/gemini-cli
Una vez instalado, puedes autenticarte con gemini auth usando una cuenta de Google
(tier gratuito) o configurar una clave de API obtenida en Google AI Studio para mayor control.
Verifica la instalación con gemini --version.
¿Cuántos tokens de contexto tiene Gemini CLI?
Gemini CLI aprovecha la ventana de contexto de 1 millón de tokens de los modelos Gemini 3.1 Pro y 3.5 Flash. Esto lo convierte en el agente de coding para terminal con el mayor contexto del mercado, empatando con Claude Code (1M) y por encima de Codex CLI (400K). Permite cargar repositorios completos de tamaño moderado sin necesidad de fragmentar ni resumir archivos, lo que es especialmente útil en proyectos monorepo o con alta interdependencia entre módulos.
¿Qué diferencia hay entre Gemini CLI y Claude Code?
Ambos son agentes de coding para la terminal con ventanas de contexto de 1M tokens y soporte MCP, pero hay diferencias importantes. Gemini CLI es open source (Apache 2.0) y tiene integración nativa con Google Search para buscar información actualizada sin configuración adicional. Claude Code es propietario pero destaca por sus capacidades de razonamiento complejo y un ecosistema de hooks y skills más maduro. Gemini CLI ofrece el tier gratuito más generoso (60 RPM sin coste), mientras que Claude Code requiere API de pago o plan Max de Claude.ai.
Es Gemini CLI completamente gratuito?
Gemini CLI tiene un tier gratuito muy generoso: hasta 60 solicitudes por minuto (RPM) con acceso a los modelos Gemini, incluyendo 1M tokens de contexto, sin necesidad de introducir datos de facturación. Este tier es suficiente para uso personal y proyectos de tamaño moderado. Para uso intensivo en producción, equipos grandes o acceso prioritario a los modelos más potentes, está disponible la API de pago de Gemini con precios por token a traves de la Gemini API.
Gemini CLI soporta MCP (Model Context Protocol)?
Si, Gemini CLI es compatible con el Model Context Protocol (MCP), el estándar
abierto impulsado por Anthropic y adoptado por los principales agentes de IA. Con MCP puedes
conectar Gemini CLI a bases de datos, APIs REST, servicios de terceros cómo Jira o GitHub, y
herramientas propietarias con servidores MCP personalizados. La configuración se realiza en el
archivo .gemini/config.json del directorio del proyecto o del usuario, sin necesidad
de modificar el código fuente del agente.
Explora la API de Gemini para tus proyectos
Si Gemini CLI te ha parecido interesante, la Gemini API te permite integrar los mismos modelos directamente en tus aplicaciones. SDKs para Python, JavaScript, Go y más.
Ver Gemini API