Curso
A inicios de 2026, cada vez más desarrolladores ejecutan herramientas de IA directamente en el terminal en lugar de usar plugins del IDE. Dos herramientas concentran la mayor atención: Gemini CLI de Google y Claude Code de Anthropic.
Ambas funcionan en el terminal, usan lenguaje natural y pueden planificar y ejecutar tareas sin intervención constante. Pero difieren en cómo trabajan, en coste y en el tipo de proyectos para los que encajan mejor.
He usado ambas en proyectos reales durante varios meses. Cada una destaca en unas áreas y flojea en otras. En este artículo, vemos cómo funciona cada una, dónde encaja y qué tener en cuenta al elegir entre ellas.
¿Qué son Gemini CLI y Claude Code?
Qué es cada herramienta y cómo encaja en el flujo de trabajo de desarrollo.
Gemini CLI
Gemini CLI es el agente de IA de Google para el terminal, de código abierto, lanzado en junio de 2025 bajo licencia Apache 2.0. Por defecto usa Gemini 3 Flash, con Gemini 3.1 Pro disponible para tareas más exigentes.
Se instala globalmente con npm, aunque también admite Homebrew y npx . Viene preinstalado en Google Cloud Shell y Google Colab. La autenticación puede hacerse con una cuenta personal de Google, una clave de API o Google Cloud Vertex AI para entornos empresariales.
npm install -g @google/gemini-cli
Su shell PTY es lo que realmente la diferencia de la mayoría de agentes CLI. Muchos agentes se bloquean ante prompts interactivos. Gemini CLI lanza un terminal virtual en segundo plano, toma instantáneas del estado y muestra la salida integrada en la conversación. Así puedes ejecutar herramientas como vim, htop o instaladores interactivos sin romper la sesión.
Desde la versión v0.34.0 (marzo de 2026), Gemini CLI también activa por defecto el Plan Mode, un modo de solo lectura en el que el agente lee tu código y propone cambios antes de editar. Usa archivos GEMINI.md como contexto de proyecto, cargados a nivel global, raíz y subdirectorios.
Claude Code
Claude Code es el agente de código de Anthropic, lanzado como vista previa de investigación en febrero de 2025 y con disponibilidad general en mayo de 2025. Se ejecuta sobre la familia de modelos Claude 4.6, con Sonnet 4.6 como predeterminado para usuarios Pro y Opus 4.6 disponible en planes Max.
La instalación en macOS y Linux usa un instalador directo:
curl -fsSL https://claude.ai/install.sh | bash
En Windows puedes usar un instalador de PowerShell o WinGet.
Mientras que Gemini CLI está pensada para la velocidad y la flexibilidad —ideal para prototipado rápido y flujos en Google Cloud—, Claude Code ejecuta tareas de forma más autónoma. Lee tu sistema de archivos local, ejecuta comandos en tu terminal y gestiona flujos de trabajo con git. Llama a la API de Anthropic para procesar, pero tu código permanece en tu máquina durante la sesión.
En diciembre de 2025, la v2.0 añadió soporte multiagente. La función Agent Teams, aún en vista previa experimental, permite que varias sesiones de Claude Code se ejecuten en paralelo con una lista de tareas compartida. Se activa definiendo CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 en tu entorno (disponible en planes Team y Enterprise).
Claude Code usa archivos CLAUDE.md para el contexto del proyecto y un sistema de permisos donde las operaciones de solo lectura se ejecutan automáticamente y las modificaciones de archivos requieren tu confirmación.
Gemini CLI vs. Claude Code: diferencias clave
Las principales diferencias en modelo, precio, contexto y tooling se resumen a continuación.
|
Función |
Gemini CLI |
Claude Code |
|
Licencia |
Código abierto (Apache 2.0) |
Propietaria |
|
Modelo por defecto |
Gemini 3 Flash |
Claude Sonnet 4.6 |
|
Ventana de contexto |
1 M de tokens |
1 M de tokens (Max/Team/Enterprise automática; Pro a tarifa estándar) |
|
Tokens máximos de salida |
64 K |
128 K (Opus 4.6, plan Max); 64 K (Sonnet 4.6, plan Pro) |
|
Capa gratuita |
1.000 solicitudes/día (solo modelos Flash) |
Ninguna (requiere plan Pro, 20 $ al mes) |
|
Plan Mode |
Activado por defecto; solo lectura, redirige a Pro para planificar |
Conmutador con Shift+Tab; usa Haiku Explore Subagent |
|
Multiagente |
Subagentes de investigación integrados |
Agent Teams con lista de tareas compartida |
|
Puntos de control/rollback |
|
Esc+Esc o |
|
Sandbox |
gVisor, LXC, Seatbelt de macOS |
Sistema de permisos (Allow/Ask/Deny) |
|
Archivo de contexto |
|
|
|
Soporte IDE |
Alimenta Gemini Code Assist en VS Code |
Extensión para VS Code, plugin JetBrains (beta) |
|
Código abierto |
Sí |
No |
La diferencia en ventana de contexto prácticamente ha desaparecido. Ambas admiten ya 1 M de tokens, tras la GA de Claude con precios estándar en marzo de 2026. En Claude Code, la ventana de 1 M se incluye automáticamente para usuarios Max, Team y Enterprise con Opus 4.6. Los usuarios Pro pueden acceder pagando por token. Los modelos de ejecución siguen siendo distintos: Gemini CLI transmite el estado del terminal vía PTY, mientras que Claude Code te pide confirmación antes de cada cambio; es más lento, pero facilita seguir el hilo en tareas complejas. La parte open source también pesa: la licencia Apache 2.0 de Gemini CLI permite a las empresas leer, bifurcar y contribuir al código. Claude Code es propietario.
Gemini CLI vs. Claude Code en flujos de desarrollo
El rendimiento por tarea importa más que la lista de funciones. Así maneja cada uno los escenarios más habituales para desarrolladores.

Modelos de ejecución comparados. Imagen del autor.
Escritura de código nuevo
Para crear el esqueleto de un proyecto o escribir un script aislado, Gemini CLI responde más rápido. Su latencia es baja y el apoyo en Google Search le permite traer documentación actual durante la sesión, por lo que el código generado suele ajustarse mejor a versiones recientes de librerías.
Claude Code planifica antes de escribir, así que arranca más lento. El código que produce tiende a ser más limpio y coherente con el resto del proyecto. En una comparación de Composio, Claude Code completó una herramienta CLI en 1 h 17 min frente a 2 h 2 min de Gemini CLI, con menos reintentos. Para scripts simples, Gemini CLI es más veloz.
Refactorización de código existente
Aquí es donde la ventana de 1 M de contexto más ayuda a Gemini CLI. Puede cargar un código pequeño o mediano de una pasada, lo que le permite seguir funciones y variables entre archivos. Para refactors sencillos, funciona razonablemente bien.
La diferencia aparece en trabajos complejos. La comunidad señala problemas de fiabilidad: errores de llamadas de herramientas, reintentos por formato y, en ocasiones, archivos sobrescritos. Suele requerir que estés encima para redirigirlo si se atasca. Claude Code adopta un enfoque más estructurado, rastrea dependencias entre archivos y aplica diffs en lugar de reescribir archivos. La función Agent Teams también puede repartir refactors grandes entre agentes.
Para cambios que tocan más de unos pocos archivos, Claude Code suele ser más fiable, aunque depende del proyecto y del tamaño del código.
Depuración y trazado de errores
Ambas pueden leer un stack trace y proponer una corrección. La diferencia está en lo que pasa cuando el primer intento no funciona.
Gemini CLI identifica bien errores iniciales y lectura de logs. Útil para diagnósticos rápidos. En bugs complejos puede quedarse ciclando por los mismos enfoques. Muchos desarrolladores acaban interviniendo para reconducirla.
Claude Code tiende a analizar el nuevo fallo tras cada intento y ajustar el enfoque en lugar de repetirse. No es inmune a atascarse, pero en mi experiencia sale de los bucles con más fiabilidad en depuración multietapa.
Ejecución de scripts y automatización
Ambas admiten modos sin cabeza para CI/CD. Gemini CLI usa -p "prompt" con --output-format json para salida estructurada, y tiene integración nativa con GitHub Actions. Claude Code usa -p o --print para modo sin cabeza y un Agent SDK en Python y TypeScript. También tiene una GitHub App para revisar PRs y generar código desde issues.
La shell PTY de Gemini CLI gestiona mejor los scripts interactivos, incluidos los que piden input a mitad de ejecución o prompts de autenticación. En esos casos, las aprobaciones de Claude Code ralentizan a menos que configures excepciones explícitas.
Calidad de código y razonamiento
A principios de 2026, ambos ejecutan modelos con puntuaciones muy cercanas en los principales benchmarks.
En SWE-bench Verified, Claude Opus 4.6 ronda el 80,8% y Gemini 3.1 Pro el 80,6%. La brecha se ha estrechado. Aun así, SWE-bench Verified tiene problemas conocidos de contaminación y sus mantenedores recomiendan SWE-bench Pro como medida más fiable. También conviene notar que la puntuación de Claude Code refleja en parte la ingeniería del agente de Anthropic —uso de herramientas y lógica de reintentos—, no solo el rendimiento bruto del modelo.
En la práctica, la diferencia aparece en cómo escribe código cada uno. Gemini CLI genera más rápido, útil para prototipos o pruebas rápidas. Claude Code suele ceñirse mejor a las convenciones del proyecto, aunque tarde más. La comunidad comenta que Gemini puede ser más verboso y sobrecomentado, especialmente con Flash.
Ninguna está a salvo de alucinaciones, y no hay benchmark estándar para agentes CLI. Ambas tienen comando de retroceso: en Gemini CLI, /rewind (Esc+Esc) navega por el historial y puede revertir cambios en archivos; en Claude Code, Esc+Esc o /rewind hace lo mismo. Gemini CLI además cuenta con /restore para volver a un checkpoint de archivo concreto, aunque hay que activar antes el checkpointing. El Plan Mode, como ya vimos, reduce el riesgo al mostrar los cambios propuestos antes de ejecutar.
Experiencia CLI y usabilidad
Ambas han trabajado la experiencia en terminal, pero con concesiones distintas. Si usas scripts interactivos o ejecutas muchos comandos en medio de la sesión, notarás las diferencias enseguida.
Gemini CLI
La interfaz de Gemini CLI prioriza la velocidad. Incluye más de 40 comandos de barra, como /plan, /memory, /skills, /restore y /theme. La sintaxis @ te permite referenciar archivos, imágenes, PDFs y audio en el prompt. El sistema de Extensions agrupa servidores MCP, archivos de contexto y comandos en paquetes instalables, que veremos más adelante en Integraciones.
Cuando se ejecuta el Plan Mode, escribe los cambios propuestos en un archivo markdown que puedes revisar o editar antes de ejecutar. Puedes aprobar, pedir cambios o cancelar con Esc. Shift+Tab alterna entre Default, Auto-Edit y Plan, o puedes escribir /plan para entrar directamente.
Como vimos, la shell PTY evita cuelgues del terminal con scripts que bloquean entrada. Los contras: 5‑10 segundos de arranque, un pequeño retardo tras las respuestas y salidas en cajas grandes que a algunos desarrolladores les cuesta escanear rápido.
Claude Code
La salida de Claude Code usa una estructura en árbol con líneas cortas y listas, ideal para ventanas pequeñas. Sus comandos principales son: /compact, /context, /model, /cost, /rewind, /doctor y /fast. Shift+Tab alterna entre modos: Normal, Auto-Accept, Plan y Auto.
El modo Plan funciona de forma similar al de Gemini CLI: Claude escanea tu código y escribe un plan en markdown antes de tocar nada. Puedes abrirlo y editarlo con Ctrl+G (en tu editor por defecto) antes de aprobar, útil para quitar pasos o añadir restricciones. También puedes escribir /plan para entrar directamente o fijarlo por defecto en .claude/settings.json con permissions.defaultMode: "plan".
La queja más común es la fatiga de aprobaciones. Claude Code se detiene para pedir permiso antes de ejecutar bash o escribir archivos, lo que corta el ritmo en tareas repetitivas. La opción --dangerously-skip-permissions lo desactiva por completo, pero Anthropic desaconseja usarla fuera de entornos aislados.
Desde marzo de 2026 hay una opción intermedia: auto mode, disponible en vista previa de investigación para planes Team. En lugar de pedir aprobación en cada paso o saltarse comprobaciones, un clasificador revisa cada llamada de herramienta y bloquea acciones de riesgo (borrados masivos, exfiltración) dejando pasar las seguras. Se activa con claude --enable-auto-mode y se accede con Shift+Tab. Reduce interrupciones sin eliminar salvaguardas, aunque a veces puede bloquear acciones inocuas.
Integración y ecosistema
Ambas admiten MCP y GitHub Actions, pero sus ecosistemas miran en direcciones distintas.
Gemini CLI
Gemini CLI se integra muy bien con servicios de Google Cloud. Como ya comentamos, viene preinstalado en Google Cloud Shell y admite cuentas de Google Workspace. También funciona con BigQuery y Cloud Run mediante extensiones MCP. El mismo sistema de Extensions incluye paquetes de Figma, Stripe, Elastic, Postman y Snyk, con más de 90 disponibles a finales de 2025.
La extensión de Cloud Run puede compilar, contenerizar y desplegar apps web desde el terminal. También acepta imágenes, PDFs y audio como entradas junto al texto. La integración con GitHub Actions usa google-github-actions/run-gemini-cli. Gemini CLI además tiene su propio SDK para crear scripts sin cabeza e integraciones, añadido en la v0.30.0.
Claude Code
Claude Code se conecta sobre todo con herramientas locales de desarrollo y servicios de terceros. A través de MCP, funciona con Jira, Asana, Slack, bases de datos y APIs externas. Tiene plugins para VS Code y JetBrains, una interfaz web en claude.ai/code y una integración con GitHub Actions mediante anthropics/claude-code-action@v1.
El Agent SDK (Python y TypeScript) te permite invocar Claude Code desde tus scripts. La integración con Slack permite mencionar a @claude-code en un hilo.
Una limitación: Claude Code solo funciona con modelos de Anthropic. No puedes traer tu propio modelo. Al ser open source, Gemini CLI ya ha sido bifurcada; Qwen Code CLI es el ejemplo más destacado.
Comparativa de precios y capa gratuita
El precio es donde más se diferencian claramente.
|
Nivel |
Gemini CLI |
Claude Code |
|
Gratis |
1.000 solicitudes/día (solo modelos Flash) |
Ninguno (requiere plan Pro) |
|
Pago inicial |
Google AI Pro ~20 $ al mes |
Claude Pro 20 $ al mes |
|
Uso intensivo |
Google AI Ultra ~250 $ al mes |
Claude Max 5x 100 $ al mes |
|
Power user |
API: 2 $/M entrada, 12 $/M salida (Gemini 3.1 Pro) |
Claude Max 20x 200 $ al mes |
|
Equipo |
Google Workspace / Vertex AI |
Team Premium 150 $/usuario/mes |
La capa gratuita de Gemini CLI ofrece 1.000 solicitudes al día con una cuenta personal de Google, sin tarjeta y sin límites horarios por ahora. Desde finales de marzo de 2026, los usuarios gratuitos están limitados a modelos Flash; los Pro quedan tras suscripción.
Claude Code no tiene capa gratuita. El mínimo son 20 $ al mes (plan Pro), que da acceso a Sonnet 4.6 con límites que los usuarios intensivos pueden agotar en pocos días. Muchos acaban en Max (100 a 200 $ al mes). Un caso seguido reportó que 10.000 millones de tokens en 8 meses en Max costaron unos 800 $, frente a unos 15.000 $ a tarifas de API, aunque el coste real varía según uso.
Verifica las tarifas actuales en la página de precios de Claude y en la página de precios de Gemini antes de decidir.
Casos de uso: Gemini CLI vs. Claude Code
La herramienta adecuada depende de en qué estés trabajando.

Elige la herramienta adecuada para ti. Imagen del autor.
Gemini CLI encaja mejor si necesitas empezar gratis, trabajas con servicios de Google Cloud o Workspace, quieres una herramienta open source que puedas leer o bifurcar, usas entradas multimodales como imágenes o PDFs, o ejecutas scripts interactivos que requieren input a mitad del proceso. También es la opción más rápida si te importa menos la consistencia que la velocidad.
Claude Code tiene más sentido si trabajas con un código grande que requiere refactorización multiarchivo, necesitas que la salida respete el estilo del proyecto, quieres ejecutar varios agentes en tareas separadas o prefieres revisar cada cambio antes de aplicarlo. También es mejor si usas IDEs de JetBrains o necesitas construir automatizaciones con el Agent SDK.
Algunos desarrolladores usan ambas: Gemini CLI para exploración y planificación rápida, y Claude Code cuando la tarea exige precisión y consistencia.
Limitaciones de Gemini CLI vs. Claude Code
Ninguna está libre de concesiones. Esto es lo que debes vigilar en cada una.
Limitaciones de Gemini CLI
- Errores de llamadas de herramientas y bucles de reintentos en tareas complejas multiarchivo, frecuentes en pruebas de la comunidad
- En una comparación, Gemini CLI consumió 432 K tokens de entrada frente a 261 K de Claude Code para la misma tarea, menos eficiente en tokens pese a sus tarifas más bajas
- El modelo Flash (capa gratuita) rinde notablemente peor que Pro en razonamiento complejo
- Los datos de la capa gratuita pueden usarse para mejorar modelos, relevante para equipos con requisitos estrictos de privacidad
- La salida tiende a ser más verbosa y con exceso de comentarios frente a Claude Code
Limitaciones de Claude Code
- Sin capa gratuita; mínimo 20 $ al mes con límites que usuarios intensivos pueden superar en pocos días
- Prompts de aprobación antes de cada comando o escritura de archivo: la queja más común (auto mode, añadido en marzo de 2026, lo mitiga parcialmente para planes Team)
- En sesiones largas el agente puede perder el hilo del contexto inicial
- Limitado a modelos de Anthropic, sin opción de usar otro proveedor
- Usuarios de Windows reportaron fallos de color y estabilidad a inicios de 2026
¿Cuál es mejor: Gemini CLI o Claude Code?
Tras trabajar con ambas, la respuesta depende de tus prioridades. Ninguna es la opción obvia en todos los casos.
Si estás empezando, quieres una opción gratuita o trabajas mucho con Google Cloud, Gemini CLI es más fácil de adoptar. Maneja bien prototipos y tareas ligeras, y su capa gratuita te permite probar sin coste.
Si trabajas sobre un código existente con múltiples archivos, necesitas que la salida encaje con el estilo del proyecto o acometes refactors complejos, Claude Code suele aguantar mejor. Que la suscripción compense depende del uso que le des.
Muchos desarrolladores en 2026 usan ambas en lugar de casarse con una: Gemini CLI para explorar y tareas rápidas, y Claude Code cuando el trabajo requiere más consistencia.
Conclusión
Gemini CLI ofrece capa gratuita, código abierto y mejor encaje con flujos de Google Cloud. Claude Code aporta más consistencia en bases de código complejas, mejor razonamiento multiarchivo y un modelo de permisos más estructurado.
La elección correcta depende de tu trabajo y de cuánto estés dispuesto a pagar. La mayoría que usa ambas adopta este patrón: Gemini CLI para tareas rápidas; Claude Code cuando hace falta precisión.
Si quieres ver cómo se compara Claude Code con otra herramienta, nuestro artículo Claude Code vs. Codex lo cubre con más detalle.
Además, aquí tienes recursos recomendados:
- Nuestro curso Introduction to Claude Models te enseña a usar la API de Anthropic.
- Nuestro artículo Claude Code vs. Antigravity compara Claude Code con otra herramienta de IA para programar que merece la pena conocer.
- Nuestra guía Top 15 Vibe Coding Tools to Build Faster in 2026 cubre el panorama más amplio de herramientas de IA para programar.
Soy ingeniero de datos y creador de comunidades. Trabajo con canalizaciones de datos, nube y herramientas de IA, al tiempo que escribo tutoriales prácticos y de gran impacto para DataCamp y programadores emergentes.
Gemini CLI vs. Claude Code: preguntas frecuentes
¿Cuál es la principal diferencia entre Gemini CLI y Claude Code?
Gemini CLI es open source con capa gratuita, más rápida para tareas sencillas y muy adecuada para flujos en Google Cloud. Claude Code es propietario y requiere suscripción, pero maneja con más fiabilidad trabajos complejos multiarchivo y tareas de razonamiento.
¿Cuál es mejor para tareas de programación?
Depende de la tarea. Gemini CLI es más rápida para scripts, prototipos y trabajo exploratorio, y no cuesta nada empezar. Claude Code es más consistente en refactors complejos multiarchivo y produce una salida más limpia, especialmente con Opus 4.6. En la gama alta las puntuaciones de benchmarks son parecidas, así que el tipo de tarea importa más que un ranking general.
¿Se pueden usar ambas juntas?
Sí, y muchos desarrolladores lo hacen. Un patrón habitual es usar Gemini CLI para explorar el código y planificar el trabajo, y luego pasar el plan a Claude Code para ejecutarlo. Algunos configuran Gemini CLI para leer archivos CLAUDE.md y así compartir el mismo contexto entre ambas.
¿Cuál es mejor para principiantes?
Gemini CLI es más fácil para empezar. Es gratis, no requiere clave de API para los modelos Flash base y se inicia con una cuenta estándar de Google. Claude Code exige suscripción y algo más de configuración inicial. Para quien es nuevo en herramientas de IA en terminal, Gemini CLI tiene menos fricción.
¿Cuál es más rápida?
Gemini CLI responde más rápido en interacciones de un turno. Su modelo Flash está pensado para velocidad. Claude Code tarda más al principio porque planifica antes de escribir. En tareas con varios pasos, Claude Code a menudo termina antes en conjunto porque necesita menos reintentos.



