Explicação · atualizado Oct 10, 2026

O que é o Gemini CLI e para quem ele serve em 2026

O Gemini CLI é um agente de IA de código aberto (Apache 2.0) do Google que leva o Gemini ao terminal para consultar e editar bases de código. O site oficial diz que usuários do nível sem pagamento e do Google One foram movidos para o Antigravity CLI em 18 de junho, então confira seu acesso antes de começar.

O que é o Gemini CLI

O Gemini CLI é um agente de IA de código aberto do Google que roda no seu terminal. Ele é lançado sob a licença Apache 2.0, então você pode ler o código. Você digita prompts, e o agente trabalha com seus arquivos e diretórios locais, imagens ou PDFs e páginas da web que ele busca por meio de pesquisa. O fornecedor é o Google, e o site oficial é geminicli.com, onde também ficam os planos e a documentação.

O site oficial lista como principais usos consultar grandes bases de código, editar arquivos pelo terminal, executar comandos de shell, pesquisar e buscar conteúdo da web e automatizar fluxos de trabalho via MCP. Os resultados incluem arquivos editados, resultados de comandos de shell, apps gerados, planos e listas de tarefas. É necessário ter uma conta para usá-lo. A documentação o descreve como uma ferramenta para desenvolvedores que preferem trabalhar pela linha de comando em vez de um 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 um prompt no terminal até arquivos editados, resultados de comandos e planos

Como funciona

Você o instala com `npm install -g @google/gemini-cli`, ou por npx, Homebrew ou MacPorts. Isso dá a você o comando `gemini`. Execute-o na pasta do projeto e faça login com uma conta do Google, uma chave de API do AI Studio ou credenciais do Google Cloud para o Vertex AI. Você pode adicionar um arquivo GEMINI.md para dar contexto do projeto ao agente. Etapas opcionais como essa mantêm a primeira configuração curta. As convenções do projeto podem ficar em um arquivo AGENTS.md, e as ferramentas externas se conectam por servidores MCP.

As ferramentas integradas leem, escrevem e editam arquivos locais e executam comandos de shell. A fundamentação com a Pesquisa Google traz informações atuais da web para as respostas. A documentação descreve sandbox, pastas confiáveis, um mecanismo de políticas e um arquivo .geminiignore para controlar no que o agente pode mexer. Servidores MCP e extensões acrescentam mais ferramentas, embora a configuração seja manual, e a documentação também lista Agent Skills e o 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
Instale, execute gemini no seu projeto e faça login por uma de três opções
  • Comandos de barra e comandos personalizados estão documentados
  • A integração com IDEs está documentada
  • Revise as edições propostas antes de aprová-las

Quanto custa o Gemini CLI

A ferramenta em si é de código aberto. O que você paga é o acesso aos modelos. A página de planos lista Google AI Pro e Google AI Ultra para pessoas físicas, o Google Developer Program para equipes e cobrança por uso por meio de uma chave de API do AI Studio ou da cobrança do Google Cloud para o Vertex AI. Uma opção com conta Google grátis aparece listada a $0 por mês. Os detalhes dos planos estão nas páginas de preços do Gemini CLI e de preços do Google Gemini.

A página de planos não mostra preços em USD para os planos pagos, então não podemos informar um valor para nenhum deles. Limites maiores exigem um plano pago do Google ou cobrança pela API. Os limites atuais do nível grátis também não estão confirmados, porque o site diz que os usuários do nível sem pagamento foram movidos para o Antigravity CLI. Para planejar custos, peça uma cotação ao Google ou consulte os preços do 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
A ferramenta é de código aberto; a página de planos não mostra preço em USD para os planos pagos

Para quem é o Gemini CLI e quem deve procurar outra opção

O Gemini CLI serve para desenvolvedores que vivem no terminal e para quem já usa Google AI, AI Studio ou Vertex AI. Combina com você se quer um agente de código aberto que possa inspecionar, com várias opções de login e extensão via MCP. Empresas podem usar o Vertex AI, que lista termos do Google Cloud, um SLA e opções regionais de residência de dados. A documentação também menciona configuração empresarial para organizações. Para os rivais mais próximos, leia o que é o Claude Code e o que é o OpenAI Codex, depois Gemini CLI vs Claude Code, Gemini vs ChatGPT, Claude vs Gemini e Gemini vs GitHub Copilot; o guia de ferramentas de programação com IA cobre o cenário mais amplo.

Procure outra opção se você está no nível sem pagamento ou no Google One, já que o site oficial diz que esses usuários foram movidos para o Antigravity CLI em 18 de junho. Faça uma pausa também se trabalha com código sensível em uma chave de API grátis: a página de planos diz que os dados do nível grátis podem ser usados para melhorar produtos, enquanto o pagamento por uso do AI Studio oferece privacidade.

  • Boa opção: desenvolvedores que priorizam o terminal, usuários de Google AI e Vertex AI
  • Verifique antes: se o seu plano ainda inclui o Gemini CLI
  • O planejamento de custos é mais difícil sem preços em USD publicados

Como ele se compara

Nosso catálogo lista Google Gemini, GitHub Copilot e Cursor como alternativas. O Google Gemini é o assistente mais amplo do Google, enquanto o Gemini CLI é o agente de terminal. GitHub Copilot e Cursor são outras ferramentas de programação para comparar se você prefere outro fluxo de trabalho ou foi afetado pela mudança para o Antigravity CLI. Listamos nomes apenas onde o catálogo os vincula.

Não fizemos um benchmark prático do Gemini CLI contra essas ferramentas, então a comparação se baseia apenas em diferenças documentadas. Os pontos fortes documentados do Gemini CLI são a licença de código aberto, os vários caminhos de autenticação e a extensibilidade via MCP. Antes de qualquer troca, compare planos e limites atuais nas páginas de cada fornecedor, pois o acesso ao nível grátis do Gemini CLI mudou e os preços pagos não são publicados em USD.

Primeiros passos

Instale o pacote, abra um terminal na pasta do projeto, execute `gemini` e faça login. Comece com um pedido somente de leitura, como pedir uma visão geral da estrutura do projeto, antes de pedir mudanças. Quando pedir uma edição, peça para ver o diff antes de ele ser aplicado. Começar pequeno facilita avaliar como o agente lê o seu código antes de deixá-lo alterar qualquer coisa.

Quando o agente terminar, confira o trabalho você mesmo: execute os testes e revise o git diff. Um prompt como o abaixo é uma primeira tarefa razoável em um repositório desconhecido. Por exemplo: "Explique como funciona a autenticação neste repositório, depois adicione limitação de taxa ao endpoint de login em src/api/login.ts e escreva um teste para ela. Mostre o diff antes de aplicar as mudanças." Trate o resultado como um rascunho que você verifica, não como trabalho concluído.

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
Quatro passos da instalação até uma primeira tarefa pequena e revisada
  • Instale com npm, npx, Homebrew ou MacPorts
  • Autentique com uma conta do Google, chave de API ou Vertex AI
  • Se quiser, adicione um arquivo GEMINI.md com o contexto do projeto
  • Aprove as edições uma a uma e execute os testes

A ferramenta em resumo

Gemini CLI

Desktop

Ainda sem avaliações de usuários

Agente de IA de terminal de código aberto do Google que leva o Gemini à linha de comando; o site informa que usuários sem plano pago e do Google One foram movidos para o Antigravity CLI.

O plano gratuito termina em: Verify current availability

Listed Ainda não avaliada

Verificado geminicli.com (abre o site de Gemini CLI em uma nova aba)

Preços Preço nos EUA não confirmado

Leia a seguir

Perguntas frequentes

O Gemini CLI foi substituído pelo Antigravity CLI?

Para usuários do nível sem pagamento e do Google One, sim: o site oficial diz que a substituição ocorreu em 18 de junho. As opções pagas continuam por meio dos planos Google AI, do Developer Program, do AI Studio ou do Vertex AI.

O Gemini CLI é grátis?

Não para novos usuários sem pagamento. O nível grátis com conta Google foi movido para o Antigravity CLI em 18 de junho, então o Gemini CLI agora funciona pelo Google AI Pro ou Ultra, pelo Google Developer Program, por uma chave de API do AI Studio ou pelo Vertex AI. A página de planos não mostra preços em USD.

Como instalo o Gemini CLI?

Execute `npm install -g @google/gemini-cli`. O site também lista npx, Homebrew e MacPorts. Você precisa se autenticar antes do primeiro uso.

Quais opções de autenticação o Gemini CLI aceita?

Uma conta do Google, uma chave de API do AI Studio ou credenciais do Google Cloud para o Vertex AI.

O Gemini CLI é de código aberto?

Sim. O README do projeto diz que ele é lançado sob a licença Apache 2.0.

Fontes