Gemini CLI

Visão Geral

O Google Gemini CLI é uma ferramenta de linha de comando para interagir com os modelos Gemini. A TokenLab fornece um ponto de terminação compatível que permite usar o Gemini CLI com acesso a centenas de 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 TokenLab. Se você precisa de uma integração TokenLab 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

Faça login no TokenLab Dashboard
Navegue até API Keys
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-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"

Configuração permanente: Adicione ao seu arquivo de configuração do shell:

Bash
Zsh
Fish

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
source ~/.bashrc

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
source ~/.zshrc

set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"

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á:

Escolher um tema
Confirmar o aviso de segurança
Confiar no diretório de trabalho

Modelos Disponíveis

Modelo	Descrição
`gemini-2.5-pro`	O modelo Gemini mais capaz
`gemini-3.5-flash`	Rápido e eficiente para a maioria das tarefas
`gemini-3.1-flash-lite`	Modelo Gemini leve atual

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

Erro de Conexão

Verifique se GOOGLE_GEMINI_BASE_URL está definida como https://api.tokenlab.sh
Nota: Sem o sufixo /v1 para o ponto de terminação do Gemini
Verifique a conectividade de rede

Falha na Autenticação

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 TokenLab

Modelo Não Disponível

Verifique a disponibilidade dos modelos Gemini em tokenlab.sh/en/models
Tente uma variante de modelo Gemini diferente

Melhores Práticas

Use no diretório do projeto

Sempre execute o Gemini CLI a partir da raiz do seu projeto para uma melhor compreensão do contexto.

Confie em diretórios com cuidado

Confie apenas em diretórios de sua propriedade. O Gemini CLI pode ler e modificar arquivos.

Revise o código gerado

Sempre revise o código gerado por IA antes de fazer o commit no seu projeto.

Matriz de compatibilidade

Ferramentas de código

SDKs nativos

Frameworks e plataformas

Apps de chat

Visão Geral

Requisitos do Sistema

Instalação

Configuração

Passo 1: Obtenha sua Chave de API

Passo 2: Defina as Variáveis de Ambiente

Uso Básico

Modelos Disponíveis

Comandos Comuns

Verificar Configuração

Solução de Problemas

Melhores Práticas

​Visão Geral

​Requisitos do Sistema

​Instalação

​Configuração

​Passo 1: Obtenha sua Chave de API

​Passo 2: Defina as Variáveis de Ambiente

​Uso Básico

​Modelos Disponíveis

​Comandos Comuns

​Verificar Configuração

​Solução de Problemas

​Melhores Práticas

Visão Geral

Requisitos do Sistema

Instalação

Configuração

Passo 1: Obtenha sua Chave de API

Passo 2: Defina as Variáveis de Ambiente

Uso Básico

Modelos Disponíveis

Comandos Comuns

Verificar Configuração

Solução de Problemas

Melhores Práticas