# Gemini CLI vs Claude Code: comparación sincera 2026

URL: https://agentvera.dev/es/blog/gemini-cli-vs-claude-code/ · Publicado: 2026-10-23

Gemini CLI vs Claude Code: qué es Gemini CLI, instalación, autenticación tras el cambio a Antigravity de junio de 2026, GEMINI.md, MCP, sandbox y cómo usar ambos.

**En resumen:**

- Desde el 18 de junio de 2026, Gemini CLI ya no atiende a los usuarios del nivel gratuito ni de Google One, que pasaron a Antigravity CLI (agy).
- Gemini CLI sigue funcionando con claves de pago de la API de Gemini, Vertex AI y licencias Gemini Code Assist Standard o Enterprise, y es de código abierto bajo Apache 2.0.
- Sus opciones de sandbox (Seatbelt, Docker o Podman, gVisor, LXC) son su punto fuerte, mientras que Claude Code añade plan mode, hooks, skills y subagentes.

**Gemini CLI vs Claude Code es el agente de terminal de Google frente al de Anthropic.** Gemini CLI es un agente de IA de código abierto (Apache 2.0) que ejecuta modelos Gemini en tu terminal: lee y edita archivos, ejecuta comandos de shell, busca en la web, se conecta a servidores MCP y toma las instrucciones del proyecto de `GEMINI.md`. Claude Code hace el mismo trabajo con modelos Claude y `CLAUDE.md`. La mayor novedad no es una función: **desde el 18 de junio de 2026, Gemini CLI ya no atiende a las cuentas personales gratuitas.** Los usuarios del nivel gratuito y de Google One pasaron a Antigravity CLI, y Gemini CLI es ahora para claves de API de pago, Vertex AI y licencias empresariales de Code Assist.

Este artículo explica qué es hoy Gemini CLI, cómo instalarlo e iniciar sesión, cómo funcionan GEMINI.md, MCP y el sandbox, y cómo se compara con Claude Code. Sin puntuaciones de benchmarks; cambian con cada versión de modelo. Para la otra gran comparación, consulta [Claude Code vs Codex](/es/blog/claude-code-vs-codex/ "Claude Code vs Codex").

## ¿Qué es Gemini CLI?

Gemini CLI es el agente de programación de línea de comandos de Google. Ejecutas `gemini` en la carpeta de un proyecto y hablas con él. Sus herramientas integradas le permiten leer y escribir archivos, ejecutar comandos de shell, descargar páginas web y buscar en Google. Funciona de forma interactiva o sin interfaz con `-p`, así que puedes llamarlo desde scripts y CI.

```bash
# interactive
gemini

# one-shot, with JSON output for scripts
gemini -p "summarize the changes in the last commit" --output-format json

# pick a model and add another directory to the context
gemini -m gemini-2.5-flash --include-directories ../shared
```

El código fuente está en GitHub bajo Apache 2.0. Las versiones estables salen cada semana, con canales preview y nightly para quien quiera los cambios antes.

## El cambio de junio de 2026: Antigravity CLI

Google anunció que Gemini CLI se sustituye por **Antigravity CLI** para los usuarios particulares. Según el blog para desarrolladores de Google y el README de Gemini CLI:

- Desde el **18 de junio de 2026**, Gemini CLI dejó de atender las solicitudes de los usuarios de Google AI Pro y Ultra y de Gemini Code Assist for individuals sin coste. El README lo resume así: «Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI.»
- El acceso no cambia para las organizaciones con **Gemini Code Assist Standard o Enterprise**, para Code Assist for GitHub a través de Google Cloud y para las **claves de pago de la API de Gemini**.
- El README también dice que Gemini CLI no está optimizado para los modelos más recientes de Google y remite a Antigravity para ellos.

Antigravity CLI se ejecuta como `agy`. Detecta configuraciones existentes de Gemini CLI, lee `GEMINI.md` y `AGENTS.md`, conserva las agent skills, los hooks y los subagentes, y convierte las extensiones de Gemini CLI en plugins de Antigravity con `agy plugin import gemini`. Google dice que no habrá paridad de funciones uno a uno, así que consulta la guía de migración antes de cambiar a un equipo.

Si usabas Gemini CLI porque era gratis, esta es la parte que importa. El resto del artículo se aplica a Gemini CLI con una clave de pago o una licencia empresarial, y buena parte sirve también para Antigravity.

## Instalación

Gemini CLI es un paquete de Node.js:

```bash
# try it without installing
npx @google/gemini-cli

# install globally
npm install -g @google/gemini-cli

# or with Homebrew
brew install gemini-cli
```

Los canales de versiones son etiquetas de npm: `@latest` (estable, semanal), `@preview` (semanal) y `@nightly`.

## Opciones de autenticación

Cuando inicias `gemini` por primera vez, te pregunta cómo autenticarte. Las opciones documentadas:

| Método | Qué configuras | Estado tras el 18 de junio de 2026 |
| --- | --- | --- |
| Sign in with Google | Inicio de sesión en el navegador; una licencia de pago de Code Assist también necesita `GOOGLE_CLOUD_PROJECT` | Funciona para Code Assist Standard y Enterprise; las cuentas personales y de Google One pasaron a Antigravity |
| Clave de la API de Gemini | `GEMINI_API_KEY` de Google AI Studio | Las claves de pago siguen funcionando |
| Vertex AI | `GOOGLE_CLOUD_PROJECT` y `GOOGLE_CLOUD_LOCATION`, más ADC (`gcloud auth application-default login`), una cuenta de servicio o `GOOGLE_API_KEY` | Sigue funcionando |

```bash
export GEMINI_API_KEY="your-key"
gemini
```

Las cuentas de Workspace y de organización necesitan un proyecto de Google Cloud. La página de cuotas de Google ha listado números de solicitudes diarias por tipo de autenticación; algunas de esas cifras son anteriores al cambio de junio, así que consulta la página actual y tu consola de Cloud en lugar de fiarte de un número en un artículo.

## GEMINI.md: instrucciones del proyecto

`GEMINI.md` es la respuesta de Gemini CLI a `CLAUDE.md`. Se carga por capas:

1. **Global:** `~/.gemini/GEMINI.md` para las reglas que quieres en todas partes.
2. **Espacio de trabajo:** archivos `GEMINI.md` en los directorios de tu espacio de trabajo y en sus padres.
3. **Justo a tiempo:** cuando una herramienta toca una ruta, Gemini CLI también recoge los archivos `GEMINI.md` cercanos a esa ruta.

Puedes dividir un archivo largo e importar partes con `@file.md`. Dentro de una sesión, `/memory show` imprime el contexto combinado y `/memory reload` vuelve a leer los archivos.

Para compartir un solo archivo con otros agentes, cambia el nombre de archivo que busca en `~/.gemini/settings.json` o en el `.gemini/settings.json` del proyecto:

```json
{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}
```

Claude Code lee `CLAUDE.md` y puede importar `AGENTS.md` con `@AGENTS.md`. Con ambos ajustes, un solo `AGENTS.md` dirige a los dos agentes. [Cómo escribir CLAUDE.md y AGENTS.md](/es/blog/claude-md-agents-md/ "Cómo escribir CLAUDE.md y AGENTS.md") explica qué poner en él.

## MCP en Gemini CLI

Gemini CLI se conecta a los servidores MCP declarados bajo `mcpServers` en `settings.json`. Un servidor puede ser un comando local (`command`, `args`, `env`, `cwd`) o uno remoto (`url` para SSE, `httpUrl` para HTTP en streaming).

```json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
    }
  }
}
```

O añade uno desde la línea de comandos:

```bash
gemini mcp add -s user -t http docs https://example.com/mcp
```

`-s` elige el ámbito (`project` por defecto, o `user`) y `-t` el transporte (`stdio`, `sse` o `http`). En una sesión, `/mcp` lista los servidores y sus herramientas, y `/mcp auth` gestiona OAuth para los servidores que lo necesitan. El lado de Claude Code es casi igual: `claude mcp add`, con los servidores de proyecto en `.mcp.json`. ¿Nuevo en el protocolo? Empieza por [qué es un servidor MCP](/es/blog/what-is-mcp-server/ "¿Qué es un servidor MCP?").

## Sandbox y aprobaciones

Aquí es donde Gemini CLI es más fuerte. El sandbox está desactivado por defecto y se activa con `--sandbox` (`-s`), la variable de entorno `GEMINI_SANDBOX` o `"sandbox": true` bajo `tools` en los ajustes.

- **macOS:** Seatbelt (`sandbox-exec`), con el perfil `permissive-open` por defecto; otros perfiles mediante `SEATBELT_PROFILE`.
- **Contenedores:** Docker o Podman, con la imagen `ghcr.io/google/gemini-cli`.
- **Otros:** un sandbox nativo de Windows, gVisor (`runsc`) y LXC (experimental).

```bash
gemini --sandbox
GEMINI_SANDBOX=docker gemini
```

Los modos de aprobación son independientes del sandbox. `default` pregunta antes de editar y de ejecutar comandos, `auto_edit` aplica las ediciones de archivos sin preguntar y `plan` es de solo lectura. **YOLO** (aprobarlo todo) solo está disponible desde la línea de comandos con `--yolo` o `--approval-mode=yolo`. Activa el checkpointing en los ajustes y `/restore` puede devolver los archivos a una instantánea tomada antes de que se ejecutara una herramienta.

Claude Code tiene modos de permisos (preguntar, aceptar ediciones, plan, bypass) y un sandbox opcional para su herramienta Bash. Gemini CLI te ofrece más backends de sandbox entre los que elegir. Uses el que uses, la regla segura es la misma: nunca des a un agente acceso total fuera de un contenedor o de un worktree desechable. [Seguridad de los agentes de programación con IA](/es/blog/ai-coding-agent-security/ "Seguridad de los agentes de programación con IA") profundiza en las amenazas.

## Gemini CLI vs Claude Code de un vistazo

| | Gemini CLI | Claude Code |
| --- | --- | --- |
| Proveedor, modelos | Google, modelos Gemini | Anthropic, modelos Claude |
| Código | Código abierto, Apache 2.0 | Propietario |
| Instalación | `npm install -g @google/gemini-cli`, `brew install gemini-cli` | `curl -fsSL https://claude.ai/install.sh \| bash`, Homebrew, WinGet |
| Quién puede usarlo ahora | Claves de pago de la API de Gemini, Vertex AI, Code Assist Standard/Enterprise | Planes de pago de Claude o la API de Anthropic |
| Archivo de instrucciones | `GEMINI.md` (configurable con `context.fileName`) | `CLAUDE.md` |
| MCP | `mcpServers` en settings.json, `gemini mcp add` | `.mcp.json`, `claude mcp add` |
| Sandbox | Seatbelt, Docker/Podman, Windows, gVisor, LXC | Sandbox opcional para la herramienta Bash |
| Modos de aprobación | `default`, `auto_edit`, `plan`, YOLO con flag | Default, accept edits, plan, bypass |
| Deshacer | Checkpointing con `/restore` | Checkpoints con rewind |
| Sin interfaz | `gemini -p`, salida JSON y stream-JSON | `claude -p`, salida JSON y stream-JSON |
| Extras | Extensiones, búsqueda web integrada | Hooks, skills, subagentes, plugins |

## Cuándo usar cada uno

**Usa Gemini CLI cuando:**

- Tu empresa ya compra Gemini a través de Google Cloud o tiene Code Assist Standard o Enterprise.
- Quieres un backend de sandbox real (Docker, gVisor, perfiles de Seatbelt) integrado en el agente.
- Quieres leer o cambiar el código del agente; es de código abierto.
- Necesitas el grounding con Google Search integrado.

**Usa Claude Code cuando:**

- Tienes una suscripción a Claude y quieres el agente ajustado a los modelos Claude.
- Dependes de plan mode, hooks, skills o subagentes.
- Quieres ejecutarlo en la terminal, en una extensión de IDE, en la app de escritorio y en la web con la misma configuración.

**Considera Antigravity CLI** si eras un usuario particular o de Google One de Gemini CLI. Es adonde Google te envía ahora.

## Usar ambos

Ejecutar dos agentes de dos proveedores es habitual por las mismas razones que con cualquier pareja: una segunda opinión sobre los cambios importantes, un segundo pool de uso cuando se agota uno y elegir el modelo que mejor encaja con la tarea. La configuración que funciona:

1. **Un solo archivo de reglas.** Pon las reglas compartidas en `AGENTS.md`, haz que el `context.fileName` de Gemini lo incluya e impórtalo desde `CLAUDE.md`.
2. **Carpetas separadas.** Da a cada agente su propio git worktree y su propia rama para que nunca editen el mismo archivo.
3. **Configuración de MCP separada.** Cada herramienta guarda sus propios ajustes de MCP; añade los mismos servidores a ambas, o regístralos una sola vez en AgentVera, que se los pasa a las dos.
4. **Un solo revisor.** Deja que un agente revise la rama del otro antes de fusionar.

## Gemini CLI, Antigravity y Claude Code en AgentVera

AgentVera es una app de escritorio para macOS, Windows y Linux que ejecuta agentes de programación de terminal en terminales reales, en una cuadrícula por proyecto, con tus inicios de sesión existentes. [Gemini CLI](/es/agents/gemini-cli/ "Gemini CLI en AgentVera"), [Antigravity CLI](/es/agents/antigravity/ "Antigravity en AgentVera") y [Claude Code](/es/agents/claude-code/ "Claude Code en AgentVera") están todos en el diálogo "New agent"; un CLI que aún no está instalado aparece como Not installed.

| Necesidad | En AgentVera |
| --- | --- |
| Iniciar sesión | Gemini CLI usa su propio login de Google o `GEMINI_API_KEY`; AgentVera no lo sustituye |
| Elegir modelo | Déjalo vacío para el valor por defecto de Gemini CLI, o elige uno y se pasa con `--model` |
| Permisos | Ask, Auto o Full access por agente; para Gemini CLI, Auto es `--approval-mode auto_edit` y Full access es `--approval-mode yolo` |
| Conservar sesiones | Cada agente de Gemini empieza con su propio `--session-id` y se reabre con `--resume` |
| Comprobar el trabajo | [Revisión de código automática](/es/features/code-review/ "Revisión de código automática") cuando termina un turno |
| Encadenar agentes | [Flows](/es/features/flows/ "Flows"): Gemini CLI puede ser el origen o el destino (Pro y Team) |

Conviene ser claro también con los límites. Los servidores MCP de AgentVera y su navegador sí llegan a Gemini CLI: se conectan en cada lanzamiento y se fusionan por nombre con tus propios `mcpServers`. Gemini CLI no tiene un flag de instrucciones adicionales, así que el campo "Role and instructions" no le llega; usa `AGENTS.md` o `GEMINI.md`. Y Full access nunca pregunta, así que resérvalo para agentes en un worktree o un contenedor.

La cuadrícula, los worktrees y la revisión de código están en el plan gratuito. [Descarga AgentVera](/es/download/ "Descargar AgentVera"), abre un agente de Gemini CLI o Antigravity junto a Claude Code en dos worktrees y compáralos en tu propio repositorio.

## La respuesta corta

Gemini CLI es un agente de terminal capaz y de código abierto con una amplia variedad de backends de sandbox, pero desde junio de 2026 es una herramienta para claves de API de pago y clientes de Google Cloud. Claude Code es la opción más sólida si estás en un plan de Claude y quieres hooks, skills y subagentes. Si estabas en el nivel gratuito de Gemini CLI, mira Antigravity CLI. Y si puedes, mantén un solo `AGENTS.md` y ejecuta dos agentes.

## Preguntas frecuentes

**¿Qué es Gemini CLI?** Gemini CLI es el agente de IA de código abierto (Apache 2.0) de Google para la terminal. Ejecuta modelos Gemini, lee y edita archivos, ejecuta comandos de shell, busca en la web, se conecta a servidores MCP y lee las instrucciones del proyecto desde GEMINI.md. Se inicia con el comando `gemini`.

**¿Sigue siendo gratis Gemini CLI?** No para las cuentas personales. El aviso de Google dice que desde el 18 de junio de 2026 los usuarios del nivel gratuito y de Google One (incluidos Google AI Pro y Ultra) pasaron a Antigravity CLI. Gemini CLI sigue funcionando con claves de pago de la API de Gemini, Vertex AI y licencias Gemini Code Assist Standard o Enterprise.

**¿Cómo instalo Gemini CLI?** Ejecuta `npm install -g @google/gemini-cli`, o pruébalo sin instalar con `npx @google/gemini-cli`. En macOS y Linux también está disponible con `brew install gemini-cli`. Después ejecuta `gemini` y elige cómo iniciar sesión.

**¿Lee Gemini CLI CLAUDE.md o AGENTS.md?** Por defecto lee GEMINI.md. Puedes hacer que lea otros archivos con el ajuste `context.fileName` de settings.json, por ejemplo `["AGENTS.md", "GEMINI.md"]`, de modo que un solo AGENTS.md pueda servir a Gemini CLI, Claude Code y otros agentes.

**¿Debo usar Gemini CLI o Claude Code?** Si tu organización ya paga Gemini a través de Google Cloud, Gemini CLI encaja bien y sus opciones de sandbox son sólidas. Si tienes una suscripción a Claude y quieres plan mode, hooks, skills y subagentes, Claude Code es mejor opción. Muchos equipos usan ambos y dejan que uno revise al otro.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/