Explicación · actualizado Oct 10, 2026

Qué es Gemini CLI y para quién es en 2026

Gemini CLI es un agente de IA open source (Apache 2.0) de Google que lleva Gemini a la terminal para consultar y editar bases de código. El sitio oficial indica que los usuarios del nivel gratuito y de Google One pasaron a Antigravity CLI el 18 de junio, así que verifica tu acceso antes de empezar.

Qué es Gemini CLI

Gemini CLI es un agente de IA open source de Google que se ejecuta en tu terminal. Se publica bajo la licencia Apache 2.0, así que puedes leer el código. Escribes prompts y el agente trabaja con tus archivos y directorios locales, imágenes o PDF, y páginas web que obtiene mediante búsqueda. El proveedor es Google, y el sitio oficial es geminicli.com, donde también están los planes y la documentación.

El sitio oficial enumera como usos principales consultar bases de código grandes, editar archivos desde la terminal, ejecutar comandos de shell, buscar y obtener contenido web, y automatizar flujos de trabajo mediante MCP. Los resultados incluyen archivos editados, resultados de comandos de shell, apps generadas, y planes y listas de tareas. Se requiere una cuenta para usarlo. La documentación lo describe como una herramienta para desarrolladores que quieren trabajar desde la línea de comandos en lugar de un editor.

You type a prompt, Gemini CLI works with your files, shell and the web, and returns edited files, command results and plans YOU A prompt in the terminal local files and directories images or PDFs account required GEMINI CLI · Apache 2.0 Open-source agent queries large codebases edits files runs shell commands fetches web, MCP workflows Edited fileschanges in your project Command resultsshell output Plans and todosand generated apps vendor: Google · site: geminicli.com
De un prompt en la terminal a archivos editados, resultados de comandos y planes

Cómo funciona

Lo instalas con `npm install -g @google/gemini-cli`, o mediante npx, Homebrew o MacPorts. Eso te da un comando `gemini`. Ejecútalo en la carpeta de tu proyecto e inicia sesión con una cuenta de Google, una clave de API de AI Studio o credenciales de Google Cloud para Vertex AI. Puedes añadir un archivo GEMINI.md para darle contexto del proyecto al agente. Pasos opcionales como este mantienen corta la primera configuración. Las convenciones del proyecto pueden vivir en un archivo AGENTS.md, y las herramientas externas se conectan mediante servidores MCP.

Las herramientas integradas leen, escriben y editan archivos locales y ejecutan comandos de shell. El grounding con Google Search incorpora información actual de la web en las respuestas. La documentación describe sandboxing, carpetas de confianza, un motor de políticas y un archivo .geminiignore para controlar a qué puede acceder el agente. Los servidores MCP y las extensiones añaden más herramientas, aunque la configuración es manual, y la documentación también menciona Agent Skills y Plan Mode.

Install with npm, npx, Homebrew or MacPorts, sign in three ways, then the gemini command uses built-in tools and safety controls 1 · INSTALL2 · RUN3 · SIGN IN npm install -g npx Homebrew MacPorts `gemini` in your project Built-in tools read, write, edit files run shell commands Google Search grounding MCP servers, extensions GEMINI.md = project context Google account AI Studio API key Vertex AIGoogle Cloud credentials Controls: sandboxing · trusted folders · policy engine · .geminiignore · review edits first
Instala, ejecuta gemini en tu proyecto e inicia sesión con una de tres opciones
  • Los comandos slash y los comandos personalizados están documentados
  • La integración con IDE está documentada
  • Revisa las ediciones propuestas antes de aprobarlas

Cuánto cuesta Gemini CLI

La herramienta en sí es open source. Lo que pagas es el acceso a los modelos. La página de planes enumera Google AI Pro y Google AI Ultra para particulares, el Google Developer Program para equipos, y la facturación por uso mediante una clave de API de AI Studio o la facturación de Google Cloud para Vertex AI. Hay una opción con cuenta de Google gratuita listada a $0 al mes. Los detalles de los planes están en las páginas de precios de Gemini CLI y de precios de Google Gemini.

La página de planes no muestra precios en USD para los planes de pago, así que no podemos indicar una cifra para ninguno. Los límites más altos requieren un plan de pago de Google o facturación por API. Los límites actuales del nivel gratuito tampoco están confirmados, porque el sitio dice que los usuarios del nivel gratuito pasaron a Antigravity CLI. Para planificar costos, pide una cotización a Google o consulta los precios de Google Cloud.

Gemini CLI is open source and access is paid by plan: free Google account listed at $0 per month, the other plans show no USD price What you pay for is model accessUSD, as published on the plans page; the tool itself is open source Free account$0per month, limits unconfirmed Google AI Pronot statedindividuals Google AI Ultranot statedindividuals Developer Programnot statedteams Pay as you gocustomAPI key or Vertexbilled via Google Cloud
La herramienta es open source; la página de planes no muestra precios en USD para los planes de pago

Para quién es Gemini CLI y quién debería buscar otra opción

Gemini CLI encaja con desarrolladores que trabajan sobre todo en la terminal y con quienes ya usan Google AI, AI Studio o Vertex AI. Es para ti si quieres un agente open source que puedas inspeccionar, con varias opciones de inicio de sesión y extensión mediante MCP. Las empresas pueden usar Vertex AI, que enumera los términos de Google Cloud, un SLA y opciones de residencia regional de datos. La documentación también menciona configuración empresarial para organizaciones. Para los rivales más cercanos lee qué es Claude Code y qué es OpenAI Codex, y luego Gemini CLI vs Claude Code, Gemini vs ChatGPT, Claude vs Gemini y Gemini vs GitHub Copilot; la guía de herramientas de IA para programar cubre el panorama más amplio.

Busca otra opción si estás en el nivel gratuito o en Google One, ya que el sitio oficial dice que esos usuarios pasaron a Antigravity CLI el 18 de junio. Ten cuidado también si trabajas con código sensible con una clave de API gratuita: la página de planes dice que los datos del nivel gratuito pueden usarse para mejorar los productos, mientras que el pago por uso de AI Studio ofrece privacidad.

  • Buen ajuste: desarrolladores que trabajan primero en la terminal, usuarios de Google AI y Vertex AI
  • Verifica primero: si tu plan todavía incluye Gemini CLI
  • Planificar costos es más difícil sin precios en USD publicados

Cómo se compara

Nuestro catálogo enumera Google Gemini, GitHub Copilot y Cursor como alternativas. Google Gemini es el asistente más amplio de Google, mientras que Gemini CLI es el agente de terminal. GitHub Copilot y Cursor son otras herramientas de programación que puedes considerar si prefieres otro flujo de trabajo o te afecta el cambio a Antigravity CLI. Solo mencionamos nombres cuando nuestro catálogo los vincula.

No hemos hecho un benchmark práctico de Gemini CLI contra estas herramientas, así que la comparación se basa solo en diferencias documentadas. Las fortalezas documentadas de Gemini CLI son su licencia open source, sus múltiples vías de autenticación y su extensibilidad con MCP. Antes de cualquier cambio, compara los planes y límites actuales en las páginas de cada proveedor, ya que el acceso gratuito a Gemini CLI cambió y sus precios de pago no se publican en USD.

Primeros pasos

Instala el paquete, abre una terminal en la carpeta de tu proyecto, ejecuta `gemini` e inicia sesión. Empieza con una petición de solo lectura, como pedir un resumen de la estructura del proyecto, antes de pedir cambios. Cuando pidas una edición, solicita ver el diff antes de aplicarla. Empezar con poco facilita juzgar cómo lee el agente tu código antes de dejar que cambie algo.

Cuando el agente termine, revisa el trabajo tú mismo: ejecuta las pruebas y revisa el git diff. Un prompt como el siguiente es una primera tarea razonable en un repositorio desconocido. Por ejemplo: "Explica cómo funciona la autenticación en este repositorio, luego añade límite de velocidad al endpoint de login en src/api/login.ts y escribe una prueba para él. Muéstrame el diff antes de aplicar los cambios." Trata el resultado como un borrador que verificas, no como trabajo terminado.

Four steps: install, authenticate, optionally add GEMINI.md, then approve edits one at a time and run the tests 1Installnpm install -g@google/gemini-clior npx, Homebrew, MacPorts 2Sign in$ geminiGoogle account, API keyor Vertex AI credentials 3Add contextGEMINI.mdoptional file withproject context 4Start smallbegin with a read-only askask to see the diff firstapprove edits one at a timethen run the tests
Cuatro pasos desde la instalación hasta una primera tarea pequeña y revisada
  • Instala con npm, npx, Homebrew o MacPorts
  • Autentícate con una cuenta de Google, una clave de API o Vertex AI
  • Opcionalmente añade un archivo GEMINI.md con contexto del proyecto
  • Aprueba las ediciones una a una y ejecuta las pruebas

La herramienta de un vistazo

Lee a continuación

Preguntas frecuentes

¿Antigravity CLI reemplazó a Gemini CLI?

Para los usuarios del nivel gratuito y de Google One, sí: el sitio oficial dice que lo reemplazó el 18 de junio. Las opciones de pago siguen disponibles mediante los planes de Google AI, el Developer Program, AI Studio o Vertex AI.

¿Gemini CLI es gratis?

No para los nuevos usuarios sin plan de pago. El nivel gratuito con cuenta de Google pasó a Antigravity CLI el 18 de junio, así que Gemini CLI ahora funciona con Google AI Pro o Ultra, el Google Developer Program, una clave de API de AI Studio o Vertex AI. La página de planes no muestra precios en USD.

¿Cómo instalo Gemini CLI?

Ejecuta `npm install -g @google/gemini-cli`. El sitio también menciona npx, Homebrew y MacPorts. Debes autenticarte antes del primer uso.

¿Qué opciones de autenticación admite Gemini CLI?

Una cuenta de Google, una clave de API de AI Studio o credenciales de Google Cloud para Vertex AI.

¿Gemini CLI es open source?

Sí. El README del proyecto dice que se publica bajo Apache 2.0.

Fuentes