Guia do Usuário do Gemini CLI - Google AI no Seu Terminal

Gemini CLI é uma ferramenta de IA de linha de comando open-source fornecida pelo Google que traz o poder do Gemini diretamente para o seu terminal. Ela oferece uma maneira leve de acessar o Gemini, fornecendo o caminho mais direto do prompt ao modelo. Ao configurar um proxy, você pode usar os serviços do Gemini CLI mesmo em ambientes com restrições de rede.

Por Que Escolher o Gemini CLI?#

• Poderoso Gemini 2.5 Pro: Acesso a uma janela de contexto de 1 milhão de tokens
• Ferramentas Integradas: Google Search grounding, operações com arquivos, comandos Shell, web scraping
• Extensível: Suporta MCP (Model Context Protocol) para integrações personalizadas
• Terminal-First: Projetado para desenvolvedores que trabalham na linha de comando
• Open Source: Licença Apache 2.0

Instalação#

Instalação Rápida#

Execute Instantaneamente com npx (Sem Instalação Necessária)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Instalação Global com npm#

npm install -g @google/gemini-cli

Instalar com Homebrew (macOS/Linux)#

brew install gemini-cli

Requisitos do Sistema#

• Node.js versão 20 ou superior
• macOS, Linux ou Windows

Configurando o Proxy#

Definir Variáveis de Ambiente#

Antes de usar o proxy, configure as seguintes variáveis de ambiente:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Dica: Adicione essas variáveis de ambiente ao seu arquivo .bashrc, .zshrc ou ao arquivo de configuração do shell para que sejam definidas automaticamente sempre que você iniciar o terminal.

Início Rápido#

Uso Básico#

Iniciar no Diretório Atual#

gemini

Incluir Múltiplos Diretórios#

gemini --include-directories ../lib,../docs

Usar um Modelo Específico#

gemini -m gemini-2.5-flash

Modo de Script Não Interativo#

Obter uma resposta de texto simples:

gemini -p "Explain the architecture of this codebase"

Obter saída JSON estruturada:

gemini -p "Explain the architecture of this codebase" --output-format json

Exemplos Rápidos#

Iniciar um Novo Projeto#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Analisar Código Existente#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Principais Funcionalidades#

Compreensão e Geração de Código#

• Consultar e editar grandes bases de código
• Gerar novas aplicações a partir de PDFs, imagens ou esboços usando capacidades multimodais
• Depurar problemas e solucionar falhas usando linguagem natural

Automação e Integração#

• Automatizar tarefas operacionais, como consultar pull requests ou lidar com rebases complexos
• Conectar novas capacidades usando servidores MCP
• Executar de forma não interativa em scripts para automação de fluxos de trabalho

Funcionalidades Avançadas#

• Obter informações em tempo real usando Google Search integrado
• Checkpoints de conversação para salvar e restaurar sessões complexas
• Arquivos de contexto personalizados (GEMINI.md) para ajustar o comportamento ao seu projeto

Comandos Comuns e Exemplos#

Explorar a Base de Código#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Trabalhar com Código Existente#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Automatizar Fluxos de Trabalho#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Interação com o Sistema#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

Integração com GitHub#

Use a GitHub Action do Gemini CLI para integrar o Gemini CLI diretamente aos seus fluxos de trabalho do GitHub:

• Revisões de Pull Request: Revisões de código automatizadas com feedback contextual e sugestões
• Triagem de Issues: Rotular e priorizar automaticamente issues do GitHub com base na análise de conteúdo
• Ajuda Sob Demanda: Mencione @gemini-cli em issues e pull requests para obter ajuda com debugging, explicações ou delegação de tarefas
• Workflows Personalizados: Crie fluxos de trabalho automatizados, agendados e sob demanda adaptados às necessidades da sua equipe

Solução de Problemas#

Se você encontrar problemas durante o uso, considere o seguinte:

1. Verificar Variáveis de Ambiente#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Verificar Conexão de Rede#

curl -I https://crazyrouter.com/

3. Verificar Mensagens de Erro#

As mensagens de erro geralmente indicam o problema. Problemas comuns incluem:

• Formato inválido de chave de API
• Problemas de conectividade de rede
• Configuração incorreta de proxy

4. Formato de Proxy SOCKS#

Se estiver usando proxy SOCKS, certifique-se de que o formato esteja correto:

socks5://<user>:<pass>@<proxy>:<port>

5. Reportar Bugs#

Use o comando integrado para reportar problemas:

/bug

Versões de Lançamento#

Preview#

Novas versões preview são lançadas todas as terças-feiras às 23:59 UTC:

npm install -g @google/gemini-cli@preview

Stable#

Novas versões estáveis são lançadas todas as terças-feiras às 20:00 UTC:

npm install -g @google/gemini-cli@latest

Nightly#

Versões nightly são lançadas todos os dias às 00:00 UTC:

npm install -g @google/gemini-cli@nightly

Uso de Servidor MCP#

Configure servidores MCP em ~/.gemini/settings.json para estender o Gemini CLI com ferramentas personalizadas:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Preços via Crazyrouter#

Acesse modelos Gemini com tarifas com desconto:

Todos os preços incluem um desconto de 45% em comparação com as tarifas oficiais.

Recursos Relacionados#

• Página de Preços da Crazyrouter
• Repositório GitHub do Gemini CLI
• Documentação do Google AI

Precisa de ajuda? Entre em contato com o suporte ou consulte a documentação da Crazyrouter para mais informações.