Gemini CLI

Use Gemini CLI con clave de pasarela y la API nativa v1beta.

Instalación y preparación

  1. Instale Node.js 20 o posterior y el paquete npm oficial Gemini CLI de abajo. Compruebe gemini --version.
  2. Cree una clave en routerra.ai Claves API para un modelo Gemini nativo de Modelos. La conexión usa Gemini generateContent/streamGenerateContent, no OpenAI Chat Completions.
npm install -g @google/gemini-cli
gemini --version

Configurar la ruta Gemini nativa

  1. Defina las tres variables en el terminal de inicio. El SDK añade /v1beta/models/...; GOOGLE_GEMINI_BASE_URL debe ser https://routerra.ai, sin /v1 ni /v1beta. Sustituya clave y modelo.
  2. Elija Use Gemini API key; las versiones nuevas pueden detectar autenticación de pasarela. Una sesión Google o Vertex existente puede evitar esta ruta: cámbiela con /auth. Para conservar variables, escriba líneas NAME=value en ~/.gemini/.env y reinicie. No incluya ese archivo en Git.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Para Windows PowerShell:

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Comprobar la conexión

Pruebe una consulta corta con --model explícito. Una página de acceso Google indica modo incorrecto. /v1/v1beta o /v1beta/v1beta revela una ruta extra. Si se rechaza el modelo, compruebe Gemini nativo en vez de usar un ID OpenAI. Elimine valores conflictivos de GOOGLE_GENAI_USE_VERTEXAI o GOOGLE_GENAI_USE_GCA, reinicie y compruebe el uso en routerra.ai.