Saltar para o conteúdo principal

​
Visão Geral

O Google Gemini CLI é uma ferramenta de linha de comando para interagir com os modelos Gemini. A LemonData fornece um ponto de terminação compatível que permite usar o Gemini CLI com acesso a mais de 300 modelos.
Essa integração deve ser tratada como experimental: o Gemini CLI atualmente não documenta um fluxo estável com Base URL personalizada no estilo LemonData. Se você precisa de uma integração LemonData oficialmente suportada no terminal, prefira Codex CLI, Claude Code ou OpenCode.

​
Requisitos do Sistema

  • Node.js: Versão 20.0+
  • SO: Windows 10/11, macOS 10.15+, Ubuntu 20.04+, ou Debian 10+

​
Instalação

npm install -g @google/gemini-cli
Verifique a instalação: 
gemini --version

​
Configuração

​
Passo 1: Obtenha sua Chave de API

  1. Faça login no LemonData Dashboard
  2. Navegue até API Keys
  3. Crie e copie sua chave de API (formato: sk-...)

​
Passo 2: Defina as Variáveis de Ambiente

Temporário (sessão atual): 
export GEMINI_API_KEY="sk-your-lemondata-key"
export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"
Configuração permanente: Adicione ao seu arquivo de configuração do shell: 
echo 'export GEMINI_API_KEY="sk-your-lemondata-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"' >> ~/.bashrc
source ~/.bashrc
Reinicie seu terminal após a configuração para que as alterações entrem em vigor.
Limitação conhecida: Em alguns casos, o Gemini CLI pode não respeitar a GOOGLE_GEMINI_BASE_URL se houver uma sessão do Google em cache. Se você tiver problemas de conexão, tente limpar o cache do CLI ou iniciar uma nova sessão de terminal.

​
Uso Básico

Inicie o Gemini CLI a partir do diretório do seu projeto: 
cd your-project
gemini
Na primeira execução, você irá:
  1. Escolher um tema
  2. Confirmar o aviso de segurança
  3. Confiar no diretório de trabalho

​
Modelos Disponíveis

ModeloDescrição
gemini-2.5-proO modelo Gemini mais capaz
gemini-2.5-flashRápido e eficiente para a maioria das tarefas
gemini-2.0-flashGeração anterior, estável

​
Comandos Comuns

Faça uma pergunta: 
> What is the best way to structure a React app?
Analise código: 
> Explain the code in src/main.ts
Gere código: 
> Create a Python function to parse JSON files
Revise alterações: 
> Review the recent git changes and suggest improvements

​
Verificar Configuração

# Verificar variáveis de ambiente
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# Testar conexão
gemini

​
Solução de Problemas

  • Verifique se GOOGLE_GEMINI_BASE_URL está definida como https://api.lemondata.cc
  • Nota: Sem o sufixo /v1 para o ponto de terminação do Gemini
  • Verifique a conectividade de rede
  • Verifique se a variável de ambiente GEMINI_API_KEY está definida
  • Verifique se a chave começa com sk-
  • Certifique-se de que a chave está ativa no dashboard da LemonData
  • Verifique a disponibilidade dos modelos Gemini em lemondata.cc/en/models
  • Tente uma variante de modelo Gemini diferente

​
Melhores Práticas

Sempre execute o Gemini CLI a partir da raiz do seu projeto para uma melhor compreensão do contexto.
Confie apenas em diretórios de sua propriedade. O Gemini CLI pode ler e modificar arquivos.
Sempre revise o código gerado por IA antes de fazer o commit no seu projeto.