Herramientas de código

Gemini CLI

Configura Google Gemini CLI para usar la API de TokenLab

Descripción general

Gemini CLI 0.60.0 documenta GOOGLE_GEMINI_BASE_URL para la autenticación mediante API-key. Utiliza el endpoint nativo de Gemini de TokenLab con un modelo actual que sea compatible con gemini_generate_content. Consulta la referencia de configuración oficial y la guía de autenticación. Esta configuración no enruta una suscripción de Google a través de TokenLab.

Instalación

Gemini CLI 0.60.0 requiere Node.js 20 o superior.

npm install -g @google/gemini-cli@0.60.0
gemini --version

Configuración

Utiliza las instrucciones de terminal de Inicio rápido para macOS, Linux, WSL o Windows PowerShell para establecer TOKENLAB_API_KEY sin incluir la clave en el historial de comandos. Inicia Gemini CLI desde esa terminal. Para un uso persistente, utiliza tu gestor de secretos local; no añadas una clave en texto plano a tu perfil de shell.

Mantén tu inicio de sesión y configuración de Google actuales. Para un inicio independiente de TokenLab, elige una raíz de configuración no utilizada, como ~/.gemini-tokenlab ($HOME en PowerShell), y crea su directorio .gemini. Copia tu archivo .gemini/settings.json existente y cualquier archivo de política necesario para tu configuración en las ubicaciones correspondientes, preservando los permisos, el sandbox y los ajustes no relacionados. Solo en esa copia, fusiona el siguiente campo de autenticación; crea un archivo de configuración si no existe. No copies cachés de OAuth ni borres tus credenciales originales. Sigue la política de autenticación gestionada en lugar de anularla.

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

Uso

El inicio que se muestra a continuación utiliza ~/.gemini-tokenlab/.gemini/settings.json. Ajusta la ruta si elegiste otra raíz. Aprueba el directorio de trabajo a través del aviso de confianza normal de Gemini; mantén las políticas de aprobación de herramientas existentes. El modelo se selecciona explícitamente para esta sesión.

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-flash

Estas variables se aplican solo a este inicio; tu cuenta guardada, el modelo predeterminado y los ajustes de permisos permanecen intactos. Inicia normalmente sin las variables para usar tu configuración anterior. No las hagas persistentes en tu perfil de shell.

Verificación

Guardar la configuración o listar los modelos no verifica una clave ni una solicitud completada. Un prompt utiliza el saldo de TokenLab. Revisa la respuesta y su registro de solicitud correspondiente antes de probar herramientas; las solicitudes auxiliares también pueden ser facturadas.

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Genera imágenes y video en el mismo agente

Gemini CLI también puede crear imágenes y videos cortos con el servidor MCP de TokenLab. Cada generación se paga con el mismo saldo de TokenLab. Fusiona esta entrada en la copia de TokenLab de la configuración, ~/.gemini-tokenlab/.gemini/settings.json. Gemini CLI lee $TOKENLAB_API_KEY desde el entorno de inicio, por lo que la clave no se escribe en el archivo:

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
      }
    }
  }
}

Inicia Gemini CLI con el comando de inicio anterior y ejecuta /mcp. El servidor tokenlab debe aparecer como conectado; confía en la carpeta de trabajo si no es así. Luego intenta:

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 devuelve un ID de tarea. El agente llama a get_task_status hasta que el video esté listo. Consulta la guía de MCP de Gemini CLI para otros ajustes.

En esta página