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