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?
- Passo 1: Instale o Node.js no seu sistema.
- Passo 2: Abra o terminal (PowerShell, Terminal ou Shell de sua
preferência). - Passo 3: Execute o comando de instalação oficial do Gemini CLI
a partir do repositório da Google no GitHub. - Passo 4: Ao abrir o Gemini pela primeira vez, selecione o modo
de autenticação e faça login com sua conta do Google.
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 index.html , style.css e script.js 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
- Instalou o Node.js corretamente
- Fez login com uma conta Google no CLI
- Executou comandos no terminal com sucesso
- Gerou arquivos e testou em seu navegador
- Organizou pastas para cada projeto individualmente
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.
Continue explorando
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.
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.