O Gemini CLI é uma ferramenta inovadora desenvolvida pelo Google que traz o poder do modelo de inteligência artificial Gemini diretamente para o terminal de comandos. Lançado em junho de 2025, ele faz parte de uma categoria crescente de agentes de IA para terminal, que inclui ferramentas como Claude Code (da Anthropic) e OpenAI Codex (CLI). O Gemini CLI é projetado para auxiliar desenvolvedores em uma ampla gama de tarefas, desde a resolução de bugs e criação de novos recursos até a geração de conteúdo, pesquisa aprofundada e gerenciamento de tarefas, tudo diretamente na linha de comando. Sua combinação de recursos avançados, acesso gratuito generoso e natureza open-source o torna uma ferramenta significativa para desenvolvedores em todo o mundo.
O que é Gemini CLI?
O Gemini CLI é um agente de IA open-source que permite aos usuários interagir com o modelo Gemini diretamente pelo terminal. Ele utiliza um loop de "razão e ação" (ReAct), que combina raciocínio com a execução de ações usando ferramentas integradas e servidores locais ou remotos do Model Context Protocol (MCP). Embora seja particularmente eficaz em tarefas de programação, como corrigir bugs, criar novos recursos e melhorar a cobertura de testes, sua versatilidade se estende a outras áreas, como geração de conteúdo, resolução de problemas, pesquisa profunda e gerenciamento de tarefas.
Principais Características do Gemini CLI
| Característica | Descrição |
|---|---|
| Acesso ao Gemini 2.5 Pro | Oferece uma janela de contexto de 1 milhão de tokens, permitindo lidar com grandes volumes de dados e código. |
| Suporte a Grandes Bases de Código | Capaz de consultar e editar grandes repositórios de código além do limite de contexto de 1 milhão de tokens. |
| Capacidades Multimodais | Pode gerar aplicativos a partir de PDFs ou esboços, utilizando recursos multimodais. |
| Automação de Tarefas | Automatiza tarefas complexas, como consultar pull requests, realizar rebases complexos e gerar relatórios. |
| Integração com Ferramentas | Inclui ferramentas como edit, glob, grep, ls, shell, memoryTool, read-file, write-file, read-many-files, web-fetch e web-search. |
| Tier Gratuito Generoso | Oferece até 60 requisições por minuto e 1.000 requisições por dia com uma conta pessoal do Google, acessando o Gemini 2.5 Pro. |
| Opções Pagas | Permite o uso de chaves de API para limites mais altos, sem que os dados sejam usados para melhorar os modelos do Google. |
Como Começar a Usar o Gemini CLI
Para começar a usar o Gemini CLI, siga os passos abaixo:
1. Instalar o Node.js
Certifique-se de ter o Node.js versão 18 ou superior instalado. Você pode baixá-lo em Node.js. Para verificar a instalação, execute:
node -v
Isso deve retornar uma versão como v22.17.0. Você também pode instalar via gerenciador de versões como o nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 22
2. Instalar o Gemini CLI
Você pode executar o Gemini CLI diretamente com:
npx https://github.com/google-gemini/gemini-cli
Ou instalá-lo globalmente com:
npm install -g @google/gemini-cli
Em seguida, execute-o com:
gemini
3. Autenticação
Autentique-se usando uma conta Google para acesso gratuito (até 60 requisições por minuto e 1.000 requisições por dia) ou use uma chave de API para limites mais altos. Para gerar uma chave de API, visite Google AI Studio. Configure a chave com:
export GEMINI_API_KEY="SUA_CHAVE_API"
Ou adicione-a a um arquivo .env. Use o comando /auth para alternar entre métodos de autenticação.
Usando o Gemini CLI
Uma vez configurado, o Gemini CLI pode ser usado de várias maneiras, tanto em projetos novos quanto existentes.
Iniciando um Novo Projeto
Navegue até o diretório do seu projeto e execute gemini. Por exemplo:
cd new-project/
gemini
> Escreva um bot do Discord que responda perguntas usando um arquivo FAQ.md que eu fornecerei
Trabalhando com Projetos Existentes
Clone um repositório, navegue até ele e execute gemini. Por exemplo:
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Dê-me um resumo de todas as alterações feitas ontem
Exemplos Práticos
Aqui estão alguns exemplos de como usar o Gemini CLI:
| Tarefa | Prompt de Exemplo |
|---|---|
| Explorar a Base de Código | > Descreva os principais componentes da arquitetura deste sistema. |
| Corrigir Bugs | > Analise a base de código e sugira um plano de correção em 3 etapas. Quais arquivos/funções devo modificar? |
| Gerar Testes | > Escreva um teste de unidade pytest para esta alteração em test_shared.py. |
| Criar Documentação | > Escreva um resumo em markdown do bug, correção e cobertura de testes. Formate como uma entrada de changelog sob 'v0.2.0'. |
| Automatizar Tarefas | > Crie um deck de slides mostrando o histórico do git dos últimos 7 dias, agrupado por recurso e membro da equipe. |
Ferramentas Disponíveis
O Gemini CLI inclui ferramentas como:
- ReadFile, WriteFile, Edit: Para manipulação de arquivos.
- FindFiles, ReadFolder, ReadManyFiles: Para navegação em diretórios.
- Shell: Para executar comandos no terminal.
- GoogleSearch/Search, WebFetch: Para pesquisas na web e obtenção de dados.
- SaveMemory: Para salvar contexto entre interações.
Comparação com Outros Agentes de IA para Terminal
O Gemini CLI é o terceiro grande lançamento de uma ferramenta de agente de IA para terminal, seguindo o Claude Code (fevereiro de 2025) e o OpenAI Codex (CLI) (abril de 2025). A tabela abaixo compara essas ferramentas:
| Ferramenta | Open-Source | Tier Gratuito | Contexto de Tokens | Integração com Ecossistema |
|------------|-------------|