Gemini CLI
Configure Gemini CLI con la API nativa de Gemini de RunAPI, verifique las solicitudes y restaure la configuración anterior.
Descripción general
Gemini CLI es un agente de terminal. Esta guía cambia su proveedor de modelos a la API nativa de Gemini de RunAPI; añadir herramientas de RunAPI mediante MCP es un paso independiente.
Antes de comenzar
Siga la guía oficial de instalación. Cree una clave API estándar dedicada con la guía de autenticación y copie un ID de modelo Gemini nativo del catálogo de modelos. Nunca incluya la clave en un commit.
npm install -g @google/gemini-cli
Configurar RunAPI
Empiece con estas variables en su shell actual. La URL base es la raíz HTTPS de la API, sin /v1beta; el SDK añade POST
/v1beta/models/{model}:streamGenerateContent?alt=sse. HTTP solo se permite para localhost.
export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID
Para un uso permanente, guarde las mismas tres variables en ~/.gemini/.env, fuera de sus repositorios. Restrinja el acceso con chmod 600
~/.gemini/.env. Gemini CLI busca .env desde el directorio actual hacia sus directorios superiores y después comprueba ~/.gemini/.env y ~/.env; revise los archivos en conflicto.
Combine estas dos opciones en ~/.gemini/settings.json sin reemplazar las demás. Use gemini-api-key para la autenticación con clave API; no reutilice una sesión guardada de Google. Por defecto la clave se envía en x-goog-api-key.
{
"security": {
"auth": {"selectedType": "gemini-api-key"}
},
"model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}
Elegir un modelo
Use GEMINI_MODEL, --model YOUR_RUNAPI_MODEL_ID o /model en una sesión interactiva. Evite auto, pro y flash: estos alias pueden resolverse a IDs de modelos de Google no disponibles en RunAPI. La selección interna, la clasificación y la detección de bucles también pueden solicitar modelos auxiliares flash o flash-lite; compruebe su disponibilidad por separado.
Verificar
Ejecute esto en un repositorio de confianza. Compruebe el modelo con /about o /stats en una sesión interactiva y confirme una solicitud streamGenerateContent correspondiente en los registros de uso de RunAPI. Una respuesta correcta de la CLI no demuestra por sí sola qué endpoint la recibió.
gemini --version
gemini -p "Describe this repository in one sentence."
Agregar herramientas de RunAPI
MCP añade herramientas, no un proveedor de modelos. Este comando registra el servidor local; siga Local MCP para su autenticación y verificación independientes.
gemini mcp add runapi npx -y @runapi.ai/mcp
Solución de problemas
Si las solicitudes siguen llegando a Google, revise los archivos .env en conflicto, security.auth.selectedType, las sesiones guardadas y las variables de autenticación de Google/Vertex. Si aparece Invalid auth method
selected, seleccione gemini-api-key en lugar de gateway en la configuración y reinicie.
Ante 401, compruebe la clave y cualquier modificación de GEMINI_API_KEY_AUTH_MECHANISM; por defecto se usa x-goog-api-key. Para 404, quite /v1beta de la URL base y copie de nuevo un ID de modelo compatible con Gemini nativo. Si un modelo auxiliar no está disponible, compruebe el ID solicitado; elegir el modelo principal no garantiza todas las funciones de la CLI.
RunAPI no ofrece countTokens ni embedContent. Gemini CLI puede recurrir a una estimación local de tokens si falla countTokens; las estimaciones pueden diferir de los registros de uso. Use HTTPS salvo para localhost y no desactive la verificación de certificados.
Eliminar RunAPI
Quite las tres variables de la shell y los archivos .env guardados, restaure security.auth.selectedType y el modelo anteriores, y revoque la clave dedicada en RunAPI. Elimine el servidor MCP añadido por separado solo si ya no necesita sus herramientas.
unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL
Próximos pasos
Continúe con el inicio rápido de la API LLM, Gemini generateContent, streamGenerateContent, el catálogo de modelos o Local MCP.