Começando com o Gemini CLI do Google

O Gemini CLI do Google traz assistência de IA diretamente para o seu terminal—onde os desenvolvedores já passam a maior parte do tempo. Se você se sente confortável com ferramentas de linha de comando e quer integrar IA ao seu fluxo de trabalho existente, esta ferramenta de código aberto oferece uma alternativa atraente aos assistentes de codificação baseados em GUI.

Este guia cobre tudo que você precisa para começar a usar o Gemini CLI: instalação, autenticação, comandos básicos e fluxos de trabalho práticos que se encaixam naturalmente no seu processo de desenvolvimento.

O que é o Gemini CLI?

O Gemini CLI é o agente de IA de terminal de código aberto do Google que conecta você diretamente ao Gemini 2.5 Pro (com fallback para Flash). Diferente das ferramentas de IA baseadas em navegador, ele roda diretamente no seu terminal junto com git, npm e outros utilitários de linha de comando que você já usa.

Principais recursos que o diferenciam:

• Janela de contexto de 1M tokens: Trabalhe com bases de código inteiras sem perder contexto
• Entrada multimodal: Processe imagens, PDFs e esboços junto com código
• Suporte MCP: Estenda funcionalidades através de servidores Model Context Protocol
• Integração com Google Search: Fundamente respostas com dados web em tempo real
• Plano gratuito: 60 requisições/minuto, 1.000 requisições/dia com uma conta pessoal do Google

Pré-requisitos e Instalação

Requisitos do Sistema

Antes de instalar o Gemini CLI, certifique-se de ter:

• Node.js versão 18 ou superior
• npm (vem com o Node.js)
• Uma aplicação de terminal
• Conexão com a internet para autenticação

Instalando o Gemini CLI

Você tem duas opções de instalação:

Opção 1: Executar diretamente com npx

npx @google/gemini-cli

Opção 2: Instalação global (recomendada)

npm install -g @google/gemini-cli
gemini

A instalação global fornece um comando gemini permanente acessível de qualquer diretório.

Autenticação e Configuração

Quando você executar gemini pela primeira vez, passará por um processo de configuração rápido:

1. Escolha um tema: Selecione seu esquema de cores preferido para a interface CLI
2. Selecione o método de autenticação:
   • Conta Pessoal do Google (recomendada para começar)
   • Conta Google Workspace
   • Chave de API

Autenticação com Conta Google

A maneira mais simples de começar é com uma conta pessoal do Google:

1. Execute gemini no seu terminal
2. Escolha “Personal Google Account” quando solicitado
3. Siga o fluxo de autenticação no navegador
4. Retorne ao seu terminal

Isso lhe dá acesso imediato aos limites do plano gratuito.

Autenticação com Chave de API

Para automação ou limites maiores:

1. Gere uma chave no Google AI Studio
2. Configure-a como variável de ambiente:

export GEMINI_API_KEY="sua-chave-de-api-aqui"

Solucionando Problemas de Autenticação Workspace

Contas Google Workspace requerem configuração adicional:

1. Crie um Projeto Google Cloud
2. Habilite a API Generative Language
3. Configure o ID do projeto:

export GOOGLE_CLOUD_PROJECT="seu-id-do-projeto"

Comandos Essenciais e Uso

Tipos de Comandos

O Gemini CLI usa três padrões de comandos:

Comandos slash (/) - Controlam o CLI

• /help - Mostra comandos disponíveis
• /auth - Altera método de autenticação
• /clear - Limpa a tela
• /exit - Sai do CLI

Comandos de arquivo (@) - Incluem conteúdo de arquivo

• @file.js - Inclui um único arquivo
• @src/ - Inclui todos os arquivos em um diretório

Comandos shell (!) - Executam comandos de terminal

• !ls -la - Executa um único comando
• ! - Alterna modo shell

Exemplos de Fluxo de Trabalho Básico

Explorando uma base de código:

cd meu-projeto
gemini
> Explique a arquitetura deste projeto

Corrigindo um bug:

gemini
> @src/api.js tem um TypeError na linha 42. Analise e corrija

Gerando testes:

gemini
> Escreva testes unitários para @utils/validation.js usando Jest

Comandos One-Shot

Para tarefas rápidas sem entrar no modo interativo:

# Gerar documentação
gemini -p "Crie um README baseado em @package.json"

# Corrigir erros de linting
gemini -p "Corrija erros ESLint em @src/"

# Analisar mudanças recentes
gemini -p "Resuma os últimos 5 commits git"

Casos de Uso Práticos

1. Compreensão e Navegação de Código

O Gemini CLI se destaca em ajudar você a entender bases de código desconhecidas:

> Mapeie como a autenticação flui através desta aplicação
> Quais arquivos implementam a lógica de processamento de pagamento?
> Explique como @services/auth.js interage com o banco de dados

2. Refatoração Automatizada

A grande janela de contexto permite refatoração complexa através de múltiplos arquivos:

> Refatore todos os endpoints da API para usar async/await em vez de callbacks
> Atualize todas as importações para usar módulos ES6

3. Desenvolvimento Orientado a Testes

Crie um loop de feedback para correções orientadas a testes:

> Corrija testes que falharam neste projeto. Execute npm test após cada mudança e continue até que todos passem

4. Geração de Documentação

Gere ou atualize documentação baseada no código real:

> Crie documentação de API para todos os endpoints em @routes/
> Atualize CHANGELOG.md baseado nos commits recentes

Configuração com GEMINI.md

Personalize o comportamento do Gemini CLI criando um arquivo GEMINI.md na raiz do seu projeto:

# Configuração do Projeto

## Padrões de Codificação
- Use TypeScript com modo strict
- Siga a configuração ESLint
- Prefira padrões de programação funcional

## Notas de Arquitetura
- Rotas da API estão em /routes
- Lógica de negócio fica em /services
- Modelos de banco de dados estão em /models

## Documentação Externa
https://docs.ourframework.com/latest

O CLI automaticamente lê esses arquivos para entender o contexto do seu projeto.

Comparando com Outros CLIs de IA

Como o Gemini CLI se compara às alternativas:

• vs Claude MCP: Janela de contexto maior (1M vs 200K tokens), suporte multimodal
• vs GitHub Copilot CLI: Plano gratuito disponível, funciona fora do VS Code
• vs Cursor: Fluxo de trabalho baseado em terminal, sem dependência de IDE

O principal diferencial é a janela de contexto massiva do Gemini—ideal para grandes bases de código ou tarefas complexas de refatoração.

Conclusão

O Gemini CLI se integra naturalmente aos fluxos de trabalho baseados em terminal, fornecendo assistência de IA sem mudança de contexto. Sua natureza de código aberto e plano gratuito generoso o tornam acessível para desenvolvedores individuais, oferecendo caminhos para escalar para equipes e automação.

Agora que você tem o Gemini CLI funcionando, tente essas tarefas para explorar suas capacidades:

1. Navegue para um projeto existente e peça uma visão geral da arquitetura
2. Use entrada multimodal: esboce um componente de UI e peça ao Gemini para implementá-lo
3. Configure servidores MCP para funcionalidade estendida
4. Crie arquivos GEMINI.md específicos do projeto para melhor contexto

FAQs

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.