# Gemini CLI vs Claude Code: comparação honesta de 2026

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

Gemini CLI vs Claude Code: o que é o Gemini CLI, instalação, login após a mudança do Antigravity, GEMINI.md, MCP, sandbox, tabela comparativa e como usar os dois.

**Resumo:**

- Desde 18 de junho de 2026, o Gemini CLI não atende mais usuários do nível gratuito e do Google One, que foram transferidos para o Antigravity CLI (agy).
- O Gemini CLI continua funcionando com chaves pagas da Gemini API, Vertex AI e licenças Gemini Code Assist Standard ou Enterprise, e é de código aberto sob Apache 2.0.
- As opções de sandbox (Seatbelt, Docker ou Podman, gVisor, LXC) são o ponto forte dele, enquanto o Claude Code traz modo plan, hooks, skills e subagentes.

**Gemini CLI vs Claude Code é o agente de terminal do Google contra o da Anthropic.** O Gemini CLI é um agente de IA de código aberto (Apache 2.0) que roda modelos Gemini no seu terminal: ele lê e edita arquivos, executa comandos de shell, pesquisa na web, conecta-se a servidores MCP e recebe instruções do projeto pelo `GEMINI.md`. O Claude Code faz o mesmo trabalho com modelos Claude e o `CLAUDE.md`. A maior novidade não é um recurso: **desde 18 de junho de 2026, o Gemini CLI não atende mais contas pessoais gratuitas.** Usuários do nível gratuito e do Google One foram transferidos para o Antigravity CLI, e o Gemini CLI agora é para chaves de API pagas, Vertex AI e licenças empresariais do Code Assist.

Este post explica o que é o Gemini CLI hoje, como instalar e fazer login, como funcionam o GEMINI.md, o MCP e o sandbox, e como ele se compara ao Claude Code. Nada de pontuações de benchmark; elas mudam a cada lançamento de modelo. Para a outra grande comparação, veja [Claude Code vs Codex](/pt/blog/claude-code-vs-codex/ "Claude Code vs Codex").

## O que é o Gemini CLI?

O Gemini CLI é o agente de código de linha de comando do Google. Você roda `gemini` em uma pasta de projeto e conversa com ele. Ferramentas embutidas permitem ler e escrever arquivos, executar comandos de shell, buscar páginas web e pesquisar no Google. Ele funciona de forma interativa ou headless com `-p`, então você pode chamá-lo a partir de scripts e do 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
```

O código-fonte está no GitHub sob Apache 2.0. Versões estáveis saem toda semana, com canais preview e nightly para quem quer as mudanças antes.

## A mudança de junho de 2026: Antigravity CLI

O Google anunciou que o Gemini CLI está sendo substituído pelo **Antigravity CLI** para usuários consumidores. Segundo o blog de desenvolvedores do Google e o README do Gemini CLI:

- A partir de **18 de junho de 2026**, o Gemini CLI parou de atender solicitações de usuários do Google AI Pro e Ultra e do Gemini Code Assist gratuito para indivíduos. O README diz assim: “Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI.”
- O acesso continua igual para organizações no **Gemini Code Assist Standard ou Enterprise**, para o Code Assist para GitHub via Google Cloud e para **chaves pagas da Gemini API**.
- O README também diz que o Gemini CLI não foi otimizado para os modelos mais novos do Google e aponta o Antigravity para eles.

O Antigravity CLI roda como `agy`. Ele detecta configurações existentes do Gemini CLI, lê `GEMINI.md` e `AGENTS.md`, mantém agent skills, hooks e subagentes, e converte extensões do Gemini CLI em plugins do Antigravity com `agy plugin import gemini`. O Google diz que não haverá paridade de recursos um a um, então confira o guia de migração antes de mudar uma equipe inteira.

Se você usava o Gemini CLI porque era gratuito, esta é a parte que importa. O resto deste post vale para o Gemini CLI com chave paga ou licença empresarial, e boa parte se aplica também ao Antigravity.

## Instalação

O Gemini CLI é um pacote 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
```

Os canais de lançamento são tags do npm: `@latest` (estável, semanal), `@preview` (semanal) e `@nightly`.

## Opções de autenticação

Na primeira vez que você inicia o `gemini`, ele pergunta como autenticar. As opções documentadas:

| Método | O que você configura | Situação após 18 de junho de 2026 |
| --- | --- | --- |
| Login com Google | Login pelo navegador; uma licença paga do Code Assist também precisa de `GOOGLE_CLOUD_PROJECT` | Funciona para Code Assist Standard e Enterprise; contas pessoais e do Google One foram para o Antigravity |
| Chave da Gemini API | `GEMINI_API_KEY` do Google AI Studio | Chaves pagas continuam funcionando |
| Vertex AI | `GOOGLE_CLOUD_PROJECT` e `GOOGLE_CLOUD_LOCATION`, mais ADC (`gcloud auth application-default login`), uma conta de serviço ou `GOOGLE_API_KEY` | Continua funcionando |

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

Contas do Workspace e de organizações precisam de um projeto no Google Cloud. A página de cotas do Google já listou números diários de solicitações por tipo de autenticação; alguns desses valores são anteriores à mudança de junho, então confira a página atual e o seu console do Cloud em vez de confiar em um número de post de blog.

## GEMINI.md: instruções do projeto

O `GEMINI.md` é a resposta do Gemini CLI ao `CLAUDE.md`. Ele carrega em camadas:

1. **Global:** `~/.gemini/GEMINI.md` para regras que você quer em todo lugar.
2. **Workspace:** arquivos `GEMINI.md` nos diretórios do seu workspace e nos diretórios pais.
3. **Sob demanda:** quando uma ferramenta toca um caminho, o Gemini CLI também carrega arquivos `GEMINI.md` próximos a esse caminho.

Você pode dividir um arquivo longo e importar partes com `@file.md`. Dentro de uma sessão, `/memory show` mostra o contexto combinado e `/memory reload` relê os arquivos.

Para compartilhar um único arquivo com outros agentes, mude o nome do arquivo que ele procura em `~/.gemini/settings.json` ou no `.gemini/settings.json` do projeto:

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

O Claude Code lê o `CLAUDE.md` e pode importar o `AGENTS.md` com `@AGENTS.md`. Com as duas configurações no lugar, um único `AGENTS.md` comanda os dois agentes. [Como escrever CLAUDE.md e AGENTS.md](/pt/blog/claude-md-agents-md/ "Como escrever CLAUDE.md e AGENTS.md") cobre o que colocar nele.

## MCP no Gemini CLI

O Gemini CLI se conecta a servidores MCP declarados em `mcpServers` no `settings.json`. Um servidor pode ser um comando local (`command`, `args`, `env`, `cwd`) ou remoto (`url` para SSE, `httpUrl` para HTTP streamable).

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

Ou adicione um pela linha de comando:

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

`-s` escolhe o escopo (`project` por padrão, ou `user`) e `-t` o transporte (`stdio`, `sse` ou `http`). Em uma sessão, `/mcp` lista os servidores e suas ferramentas, e `/mcp auth` cuida do OAuth para servidores que precisam dele. O lado do Claude Code é quase igual: `claude mcp add`, com servidores do projeto em `.mcp.json`. Novo no protocolo? Comece por [o que é um servidor MCP](/pt/blog/what-is-mcp-server/ "O que é um servidor MCP").

## Sandbox e aprovações

É aqui que o Gemini CLI é mais forte. O sandbox vem desligado por padrão, e você o liga com `--sandbox` (`-s`), com a variável de ambiente `GEMINI_SANDBOX` ou com `"sandbox": true` em `tools` nas configurações.

- **macOS:** Seatbelt (`sandbox-exec`), com o perfil `permissive-open` por padrão; outros perfis via `SEATBELT_PROFILE`.
- **Contêineres:** Docker ou Podman, usando a imagem `ghcr.io/google/gemini-cli`.
- **Outros:** um sandbox nativo do Windows, gVisor (`runsc`) e LXC (experimental).

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

Os modos de aprovação são separados do sandbox. `default` pergunta antes de edições e comandos, `auto_edit` aplica edições de arquivos sem perguntar e `plan` é somente leitura. O **YOLO** (aprovar tudo) só está disponível pela linha de comando com `--yolo` ou `--approval-mode=yolo`. Ative o checkpointing nas configurações e o `/restore` consegue voltar os arquivos para um snapshot feito antes de uma ferramenta rodar.

O Claude Code tem modos de permissão (perguntar, aceitar edições, plan, bypass) e um sandbox opcional para a ferramenta Bash. O Gemini CLI oferece mais backends de sandbox para escolher. Seja qual for o que você usa, a regra segura é a mesma: nunca dê acesso total a um agente fora de um contêiner ou de uma worktree descartável. [Segurança de agentes de código com IA](/pt/blog/ai-coding-agent-security/ "Segurança de agentes de código com IA") entra nas ameaças.

## Gemini CLI vs Claude Code em resumo

| | Gemini CLI | Claude Code |
| --- | --- | --- |
| Fornecedor, modelos | Google, modelos Gemini | Anthropic, modelos Claude |
| Código-fonte | Código aberto, Apache 2.0 | Proprietário |
| Instalação | `npm install -g @google/gemini-cli`, `brew install gemini-cli` | `curl -fsSL https://claude.ai/install.sh \| bash`, Homebrew, WinGet |
| Quem pode usar agora | Chaves pagas da Gemini API, Vertex AI, Code Assist Standard/Enterprise | Planos pagos do Claude ou Anthropic API |
| Arquivo de instruções | `GEMINI.md` (configurável com `context.fileName`) | `CLAUDE.md` |
| MCP | `mcpServers` no settings.json, `gemini mcp add` | `.mcp.json`, `claude mcp add` |
| Sandbox | Seatbelt, Docker/Podman, Windows, gVisor, LXC | Sandbox opcional para a ferramenta Bash |
| Modos de aprovação | `default`, `auto_edit`, `plan`, YOLO por flag | Padrão, aceitar edições, plan, bypass |
| Desfazer | Checkpointing com `/restore` | Checkpoints com rewind |
| Headless | `gemini -p`, saída JSON e stream-JSON | `claude -p`, saída JSON e stream-JSON |
| Extras | Extensões, pesquisa na web embutida | Hooks, skills, subagentes, plugins |

## Quando usar cada um

**Use o Gemini CLI quando:**

- A sua empresa já compra Gemini via Google Cloud ou tem Code Assist Standard ou Enterprise.
- Você quer um backend de sandbox de verdade (Docker, gVisor, perfis do Seatbelt) integrado ao agente.
- Você quer ler ou alterar o código-fonte do agente; ele é de código aberto.
- Você precisa de grounding com a Pesquisa Google embutido.

**Use o Claude Code quando:**

- Você tem uma assinatura do Claude e quer o agente ajustado para os modelos Claude.
- Você depende de modo plan, hooks, skills ou subagentes.
- Você quer rodá-lo no terminal, em uma extensão de IDE, no app desktop e na web com a mesma configuração.

**Considere o Antigravity CLI** se você era usuário pessoal ou do Google One do Gemini CLI. É para lá que o Google manda você agora.

## Usando os dois

Rodar dois agentes de dois fornecedores é comum pelos mesmos motivos de qualquer dupla: uma segunda opinião sobre mudanças importantes, uma segunda cota de uso quando a primeira acaba e a escolha do modelo que combina com a tarefa. O setup que funciona:

1. **Um único arquivo de regras.** Coloque as regras compartilhadas no `AGENTS.md`, configure o `context.fileName` do Gemini para incluí-lo e importe-o a partir do `CLAUDE.md`.
2. **Pastas separadas.** Dê a cada agente sua própria git worktree e branch para que nunca editem o mesmo arquivo.
3. **Configuração MCP separada.** Cada ferramenta mantém suas próprias configurações de MCP; adicione os mesmos servidores às duas ou registre-os uma vez no AgentVera, que os repassa para ambas.
4. **Um revisor.** Deixe um agente revisar a branch do outro antes de você fazer o merge.

## Gemini CLI, Antigravity e Claude Code no AgentVera

O AgentVera é um app desktop para macOS, Windows e Linux que roda agentes de código de terminal em terminais reais, em uma grade por projeto, com os logins que você já tem. [Gemini CLI](/pt/agents/gemini-cli/ "Gemini CLI no AgentVera"), [Antigravity CLI](/pt/agents/antigravity/ "Antigravity no AgentVera") e [Claude Code](/pt/agents/claude-code/ "Claude Code no AgentVera") estão todos na caixa de diálogo “New agent”; uma CLI que ainda não está instalada aparece como “Not installed”.

| Necessidade | No AgentVera |
| --- | --- |
| Login | O Gemini CLI usa o próprio login do Google ou `GEMINI_API_KEY`; o AgentVera não o substitui |
| Escolher um modelo | Deixe vazio para usar o padrão do Gemini CLI, ou escolha um e ele é passado com `--model` |
| Permissões | Ask, Auto ou Full access por agente; no Gemini CLI, Auto é `--approval-mode auto_edit` e Full access é `--approval-mode yolo` |
| Manter sessões | Cada agente Gemini começa com seu próprio `--session-id` e reabre com `--resume` |
| Conferir o trabalho | [Revisão automática de código](/pt/features/code-review/ "Revisão automática de código") quando um turno termina |
| Encadear agentes | [Flows](/pt/features/flows/ "Flows"): o Gemini CLI pode ser a origem ou o destino (Pro e Team) |

Seja claro sobre os limites também. Os servidores MCP e o navegador do AgentVera chegam ao Gemini CLI: eles são anexados a cada inicialização e mesclados por nome com os seus próprios `mcpServers`. O Gemini CLI não tem flag de instruções extras, então o campo “Role and instructions” não chega até ele; use `AGENTS.md` ou `GEMINI.md`. E o Full access nunca pergunta, então reserve-o para agentes em uma worktree ou contêiner.

A grade, as worktrees e a revisão de código estão no plano gratuito. [Baixe o AgentVera](/pt/download/ "Baixar o AgentVera"), abra um agente Gemini CLI ou Antigravity ao lado do Claude Code em duas worktrees e compare-os no seu próprio repositório.

## A resposta curta

O Gemini CLI é um agente de terminal capaz e de código aberto, com uma ampla escolha de backends de sandbox, mas desde junho de 2026 é uma ferramenta para chaves de API pagas e clientes do Google Cloud. O Claude Code é a escolha mais forte se você está em um plano do Claude e quer hooks, skills e subagentes. Se você estava no nível gratuito do Gemini CLI, dê uma olhada no Antigravity CLI. E, se puder, mantenha um único `AGENTS.md` e rode dois agentes.

## Perguntas frequentes

**O que é o Gemini CLI?** O Gemini CLI é o agente de IA de código aberto (Apache 2.0) do Google para o terminal. Ele roda modelos Gemini, lê e edita arquivos, executa comandos de shell, pesquisa na web, conecta-se a servidores MCP e lê instruções do projeto no GEMINI.md. Você o inicia com o comando `gemini`.

**O Gemini CLI ainda é gratuito?** Não para contas pessoais. O aviso do Google diz que, a partir de 18 de junho de 2026, usuários do nível gratuito e do Google One (incluindo Google AI Pro e Ultra) foram transferidos para o Antigravity CLI. O Gemini CLI continua funcionando com chaves pagas da Gemini API, Vertex AI e licenças Gemini Code Assist Standard ou Enterprise.

**Como instalo o Gemini CLI?** Rode `npm install -g @google/gemini-cli` ou experimente sem instalar com `npx @google/gemini-cli`. No macOS e no Linux, ele também está disponível com `brew install gemini-cli`. Depois rode `gemini` e escolha como fazer login.

**O Gemini CLI lê CLAUDE.md ou AGENTS.md?** Por padrão, ele lê o GEMINI.md. Você pode fazê-lo ler outros arquivos com a configuração `context.fileName` no settings.json, por exemplo `["AGENTS.md", "GEMINI.md"]`, para que um único AGENTS.md sirva ao Gemini CLI, ao Claude Code e a outros agentes.

**Devo usar o Gemini CLI ou o Claude Code?** Se a sua organização já paga pelo Gemini via Google Cloud, o Gemini CLI se encaixa bem e as opções de sandbox dele são fortes. Se você tem uma assinatura do Claude e quer modo plan, hooks, skills e subagentes, o Claude Code é a melhor escolha. Muitas equipes usam os dois e deixam um revisar o outro.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/