--- title: Gemini CLI | RunAPI description: Configure Gemini CLI con la API nativa de Gemini de RunAPI, verifique las solicitudes y restaure la configuración anterior. url: https://runapi.ai/es/docs/resources/tool-integrations/gemini-cli.md canonical: https://runapi.ai/es/docs/resources/tool-integrations/gemini-cli locale: es --- > Versión HTML: https://runapi.ai/es/docs/resources/tool-integrations/gemini-cli > Índice del sitio para agentes: https://runapi.ai/llms.txt # Gemini CLI ## 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][1]. Cree una clave API estándar dedicada con la [guía de autenticación](https://runapi.ai/es/docs/guides/authentication.md) y copie un ID de modelo Gemini nativo del [catálogo de modelos](https://runapi.ai/es/models). Nunca incluya la clave en un commit. [1]: https://geminicli.com/docs/get-started/installation/ ```shell 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. ```shell 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`. ```json { "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ó. ```shell 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](https://runapi.ai/es/docs/resources/mcp/local.md) para su autenticación y verificación independientes. ```shell 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. ```shell unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL ``` ## Próximos pasos Continúe con el [inicio rápido de la API LLM](https://runapi.ai/es/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/es/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/es/docs/api/gemini/stream-generate-content.md), el [catálogo de modelos](https://runapi.ai/es/models) o [Local MCP](https://runapi.ai/es/docs/resources/mcp/local.md). --- ## Más de RunAPI - [Inicio](https://runapi.ai/es/.md) - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models) - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [x402](https://runapi.ai/es/x402.md) - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Índice del sitio para agentes](https://runapi.ai/llms.txt) Contacto: contact@runapi.ai ## Datos estructurados ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "TechArticle", "headline": "Gemini CLI", "description": "Configure Gemini CLI con la API nativa de Gemini de RunAPI, verifique las solicitudes y restaure la configuración anterior.", "url": "https://runapi.ai/es/docs/resources/tool-integrations/gemini-cli", "mainEntityOfPage": "https://runapi.ai/es/docs/resources/tool-integrations/gemini-cli" } ] ```