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 endpoint compatível que permite usar o Gemini CLI com acesso a mais de 300 modelos.

​
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 endpoint 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.