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

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.

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.

# 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:

# 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:

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:

{
  "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 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).

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

Ou adicione um pela linha de comando:

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.

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).

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 entra nas ameaças.

Gemini CLI vs Claude Code em resumo

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, Antigravity CLI e Claude Code estão todos na caixa de diálogo “New agent”; uma CLI que ainda não está instalada aparece como “Not installed”.

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, 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.