Gemini CLI: instalar e usar no terminal (free tier)
Install + primeiros passos no terminal — distinto da integração IDE e do comparativo vs Claude Code.
Por que isso é importante
Gemini CLI: instale, autentique e teste no repo — free tier tem cotas; revise diffs.
Leitura relacionada: Gemini CLI no Cursor/VS Code · Gemini CLI vs Claude Code · Claude Code guia · Guerra das IDEs.
O que é o Gemini CLI?
O Gemini CLI é uma interface de linha de comando que permite utilizar diretamente a API do Gemini 2.5 Pro em seu terminal. Diferentemente de ambientes como VSCode ou extensões tradicionais, ele não depende de IDEs ou interfaces gráficas. É leve e rápido; o free tier exige conta Google e está sujeito a cotas.
Por que testar no terminal?
Ele entrega a mesma inteligência por trás do Gemini 2.5 Pro, com acesso via terminal a uma API com limite gratuito extremamente generoso comparado a outras soluções de mercado, como o Cursor ou mesmo o Claude Code.
O que está incluso no acesso gratuito?
O free tier (conta Google pessoal) costuma citar janela grande de contexto e faixas como ~60 req/min e ~1000/dia — números oficiais mudam. Trate como ordem de grandeza e confira a doc Google na data.
Atenção
Para ativar esse acesso gratuito, é necessário autenticar-se com uma conta pessoal do Google ao utilizar o CLI pela primeira vez.
Como instalar o Gemini CLI?
Primeiros comandos no terminal
Após a instalação, basta digitar gemini no terminal dentro da pasta do seu projeto. A partir dali você pode começar a pedir geração de código, resumo de funções, debugging e muito mais.
Dica
Crie pastas específicas para cada projeto antes de rodar seus prompts. Isso organiza melhor os arquivos gerados como HTML, CSS e JS.
Exemplo de uso prático
Digite algo como: Crie um dashboard de finanças em JS com HTML e CSS em arquivos separados . O Gemini gerará automaticamente os arquivos como <code>index.html</code> , <code>style.css</code> e <code>script.js</code> na sua pasta atual.
Atenção
Os prompts são processados em inglês, então adapte seus comandos se estiver enfrentando erros ou respostas inesperadas.
Vantagens do CLI em relação às IDEs
Gemini CLI
Prós
- Leve e rápido
- Não exige ambiente visual
- Free tier (cotas variáveis)
Contras
- Sem visualização gráfica
- Curva de aprendizado inicial
Cursor/IDE tradicionais
Prós
- Visualização otimizada
- Integração com projetos
Contras
- Requisitos de máquina mais elevados
- Planos mais limitados
Ferramentas Necessárias
Conclusão
Se você quer experimentar agente no terminal sem assinar IDE, o Gemini CLI é um ponto de partida sólido: install simples e free tier com cotas. Não é a opção “definitiva” — meça qualidade e limite na sua conta.
Checklist de Implementação
Perguntas frequentes
Como instalar o Gemini CLI?
Com Node.js 20+: `npm install -g @google/gemini-cli` (ou Homebrew). Rode `gemini`, autentique com conta Google e confira a doc oficial no GitHub google-gemini/gemini-cli — cotas mudam.
Gemini CLI é grátis de verdade?
Há free tier generoso em várias contas pessoais, mas não é ilimitado. Limites (ex.: RPM/RPD) e modelos mudam — confira a política Google na data.
Substitui Cursor ou Claude Code?
Não automaticamente. Este guia é install/primeiros passos no terminal. Integração IDE = outro spoke; comparativo Gemini vs Claude = outro spoke.
Preciso de API key?
Login Google costuma bastar no free tier. API key / Vertex é opção se as cotas da conta não atenderem — veja auth na doc oficial.