Ferramentas de código
Gemini CLI
Configure o Google Gemini CLI para usar a API do TokenLab
Visão geral
O Gemini CLI 0.60.0 documenta a GOOGLE_GEMINI_BASE_URL para autenticação via API-key. Use o endpoint nativo do Gemini do TokenLab com um modelo atual que suporte gemini_generate_content. Consulte a referência oficial de configuração e o guia de autenticação. Esta configuração não roteia uma assinatura do Google através do TokenLab.
Instalação
O Gemini CLI 0.60.0 requer Node.js 20 ou superior.
npm install -g @google/gemini-cli@0.60.0
gemini --versionConfiguração
Use as instruções do terminal Início Rápido para macOS, Linux, WSL ou Windows PowerShell para definir a TOKENLAB_API_KEY sem colocar a chave no histórico de comandos. Inicie o Gemini CLI a partir desse terminal. Para uso persistente, utilize seu gerenciador de segredos local; não adicione uma chave em texto simples ao seu perfil de shell.
Mantenha seu login e configuração atuais do Google. Para uma inicialização separada do TokenLab, escolha uma raiz de configuração não utilizada, como ~/.gemini-tokenlab ($HOME no PowerShell), e crie seu diretório .gemini. Copie seu arquivo .gemini/settings.json existente e quaisquer arquivos de política necessários para sua configuração nos locais correspondentes, preservando permissões, sandbox e configurações não relacionadas. Apenas nessa cópia, mescle o seguinte campo de autenticação; crie um arquivo de configurações se nenhum existir. Não copie caches de OAuth nem limpe suas credenciais originais. Siga a política de autenticação gerenciada em vez de substituí-la.
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}Uso
A inicialização abaixo usa ~/.gemini-tokenlab/.gemini/settings.json. Ajuste o caminho se você escolheu outra raiz. Aprove o diretório de trabalho através do prompt de confiança normal do Gemini; mantenha as políticas de aprovação de ferramentas existentes. O modelo é selecionado explicitamente para esta sessão.
GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.8-flashEstas variáveis aplicam-se apenas a esta inicialização; sua conta salva, modelo padrão e configurações de permissão permanecem inalterados. Inicie normalmente sem as variáveis para usar sua configuração anterior. Não as torne persistentes em seu perfil de shell.
Verificação
Salvar configurações ou listar modelos não verifica uma chave ou uma solicitação concluída. Um prompt utiliza o saldo do TokenLab. Verifique a resposta e seu registro de solicitação correspondente antes de testar ferramentas; solicitações auxiliares também podem ser cobradas.
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Gere imagens e vídeos no mesmo agente
O Gemini CLI também pode criar imagens e vídeos curtos com o servidor MCP do TokenLab. Cada geração é paga a partir do mesmo saldo do TokenLab. Mescle esta entrada na cópia do TokenLab das configurações, ~/.gemini-tokenlab/.gemini/settings.json. O Gemini CLI lê $TOKENLAB_API_KEY do ambiente de inicialização, portanto, a chave não é gravada no arquivo:
{
"mcpServers": {
"tokenlab": {
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
}
}
}
}Inicie o Gemini CLI com o comando de inicialização acima e execute /mcp. O servidor tokenlab deve aparecer como conectado; confie na pasta de trabalho caso não apareça. Em seguida, tente:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video retorna um ID de tarefa. O agente chama get_task_status até que o vídeo esteja pronto. Consulte o guia do MCP do Gemini CLI para outras configurações.