Guia Prático: Como Instalar e Configurar o Gemini CLI (Google) no Terminal
紫喵API服务 的 AI API 使用建议
紫喵API服务 面向需要 OpenAI 兼容接口、Claude/Gemini/GPT 多模型切换、包月额度管理和图像模型调用的用户。阅读本文后，可以结合本站的模型清单、独立使用文档和个人面板，把教程内容直接落到实际调用流程中。
Este guia prático ajudará você a configurar o Gemini CLI, o agente de IA de código aberto do Google, para executar modelos de linguagem diretamente no seu terminal, permitindo automações complexas e consultas rápidas.
O Gemini CLI é uma ferramenta desenvolvida pelo ecossistema Google Gemini para facilitar a integração de modelos como o Gemini 1.5 Flash e Pro em fluxos de trabalho de desenvolvedores. Diferente do Grok (da xAI), que foca intensamente na integração com a plataforma X, o Gemini CLI é voltado para produtividade bruta e integração com infraestrutura de nuvem via Google Cloud e AI Studio.
Passo 1: Instalação do Gemini CLI
Atualmente, a forma mais comum de instalar o Gemini CLI é via Node.js (npm). No entanto, fique atento: versões mais recentes estão migrando para uma base em Go, conhecida internamente em alguns repositórios como Antigravity CLI.
Para a versão estável atual, utilize:
npm install -g @google-gemini/gemini-cli
Passo 2: Configuração de Autenticação (API Key vs OAuth)
Com as mudanças recentes de política (março de 2026), o Google implementou restrições severas ao uso de OAuth para usuários gratuitos. Para garantir estabilidade e evitar erros de "Capacidade Insuficiente", recomenda-se o uso de uma API Key própria.
- Acesse o Google AI Studio.
- Gere uma API Key para o seu projeto.
- No seu terminal, configure a variável de ambiente:
export GOOGLE_API_KEY="SUA_CHAVE_AQUI"
Passo 3: Executando Comandos Básicos
Você pode interagir com o modelo de forma direta ou passando arquivos como contexto. Para uma pergunta simples:
gemini "Explique como funciona o algoritmo Raft em 2 frases."
Para processar um arquivo local:
cat script.js | gemini -p "Refatore este código para torná-lo mais performático"
Passo 4: Automação e Uso de Modelos Específicos
Após as atualizações de serviço, usuários da camada gratuita estão limitados ao modelo Gemini Flash. Usuários Pro ou Enterprise podem alternar entre modelos usando flags:
# Usando o modelo Pro (requer assinatura paga)
gemini --model gemini-1.5-pro "Analise os logs do sistema"
# Modo headless para scripts (ignora confirmações interativas)
gemini -y -p "Gerar documentação para o diretório atual"
Comparativo: Gemini CLI vs xAI Grok
Ao escolher sua ferramenta de terminal, considere as seguintes diferenças:
| Recurso | Google Gemini CLI | xAI Grok (API) |
|---|---|---|
| Provedor | Google Cloud / xAI | xAI (Elon Musk) |
| Acesso Gratuito | Sim (apenas modelo Flash) | Geralmente requer assinatura X Premium+ |
| Foco | Integração Cloud e Workspace | Dados em tempo real (X) e sarcasmo |
| CLI Nativa | Extremamente rica em ferramentas | Focada em SDKs (Python/JS) |
Perguntas Frequentes (FAQ)
1. Erro 429: "No capacity available for model"
Este erro ocorre devido à alta demanda. Como o Google agora prioriza o tráfego com base no tipo de licença, a melhor solução é migrar do login OAuth padrão para uma API Key paga (Pay-as-you-go) no AI Studio ou Vertex AI.
2. Posso usar o Gemini CLI com softwares de terceiros?
A detecção de abuso do Google tornou-se mais rigorosa. O uso de OAuth com ferramentas não oficiais (como wrappers de terceiros) pode resultar no bloqueio temporário da conta. Sempre utilize a CLI oficial ou integre via API Key.
3. Por que não consigo acessar o modelo Gemini Pro gratuitamente?
Desde 25 de março de 2026, o acesso gratuito via CLI foi restrito aos modelos Flash. Para acessar o Pro ou Ultra, é necessário ter uma assinatura ativa do Google One AI Premium ou um plano Enterprise no Google Cloud.
4. O Gemini CLI suporta automação via Cron?
Sim. Para isso, use sempre a flag -y para evitar prompts interativos e certifique-se de que a variável GOOGLE_API_KEY esteja exportada no ambiente do seu script shell.
在本站快速上手 Claude / GPT / Gemini / Grok
本文涉及的能力可以直接在本站的中转 API 上调用，兼容 OpenAI / Anthropic 官方 SDK：
无需科学上网，国内可直连，5 分钟完成接入。