Configuración de Gemini CLI
Gemini CLI es la herramienta de IA para terminal de Google. Es adecuada para usar Gemini en la línea de comandos para preguntas y respuestas, comprensión de código y asistencia en proyectos.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
Qué es esta herramienta y para qué se utiliza
Google GeminiHerramientas de terminalInicio de sesión con GoogleGemini API Key
Seleccione primero el método de autenticación
| Método | Para quién es adecuado | Descripción |
|---|---|---|
| Inicio de sesión con Google | Usuarios individuales y principiantes | Ejecute Gemini e inicie sesión según las indicaciones |
| Gemini API Key | Usuarios que ya tienen una clave de Google AI Studio | Introduzca la clave en GEMINI_API_KEY |
| Vertex AI | Usuarios empresariales o de proyectos en la nube | Configure según los proyectos y permisos de Google Cloud |
Cómo probar la API Key
Prueba temporal en PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" geminiPrueba temporal en Terminal
GEMINI_API_KEY="YOUR_GEMINI_API_KEY" geminiInicio de sesión interactivo
geminiCómo proceder tras una prueba exitosa
- Primero, ejecute Gemini CLI en un directorio vacío; no abra directamente proyectos importantes.
- Haga solo una pregunta corta y fija para confirmar que el modelo responda normalmente.
- Luego pídale que lea un archivo de prueba y solicite explícitamente que no modifique el archivo.
- Si desea utilizar la API Key a largo plazo, guarde el método de autenticación en su entorno local o configuración según la documentación oficial de Gemini CLI.
- Si ha cambiado de provider de IA o de CC-Switch, pruebe nuevamente tras reiniciar la terminal.
| Problema / Síntoma | Comprobación prioritaria | Solución |
|---|---|---|
| Sigue solicitando inicio de sesión de Google | ¿El método de autenticación actual es el proceso de inicio de sesión de Google? | Complete primero la autenticación según las instrucciones de Gemini CLI; no mezcle la resolución de problemas de la API Key con la del proceso de inicio de sesión |
| Key no válida | ¿La GEMINI_API_KEY proviene de Google AI Studio / Gemini? | No introduzca claves de OpenAI o Claude en Gemini |
| Modelo no disponible | ¿El nombre del modelo pertenece a la lista de Gemini? | No introduzca nombres de modelos de OpenAI o Claude en Gemini CLI |
Qué tener en cuenta en la configuración del provider de IA
Gemini CLI y un provider compatible con OpenAI no son lo mismo. Siga el tutorial del provider solo si este especifica explícitamente el método de configuración para Gemini CLI, Google Gemini o Vertex AI.
No introduzca la Base URL habitual de OpenAI en Gemini CLI. OpenAI, Claude y Gemini son tres protocolos distintos. Si el provider ofrece direcciones separadas en su panel de control, debe ingresar la que corresponde a esta herramienta.
Documentación oficial de Gemini CLI Consulte la instalación, los comandos y las opciones de configuración.
Documentación de autenticación de Gemini CLI Consulte el inicio de sesión con Google, Gemini API Key y Vertex AI.