Solución de problemas de Gemini
Las interfaces compatibles con Gemini y OpenAI no son lo mismo. Configure según Gemini únicamente si el proveedor ofrece de forma explícita interfaces relacionadas con Gemini / Google / Vertex, o si el tutorial indica con claridad que es compatible con Gemini CLI.
¿Qué se debe verificar primero?
| Elementos a comprobar | Cómo verificar | Por qué |
|---|---|---|
| Herramienta de destino | Confirme que está solucionando problemas de Gemini CLI | El método de autenticación para Gemini CLI es diferente al de Codex y Claude Code |
| El proveedor es compatible con Gemini | Hay entradas relacionadas con Gemini / Google / Vertex en el panel o en los tutoriales | La interfaz compatible con OpenAI no es igual a la interfaz de Gemini |
| Tipo de clave | Use la clave correspondiente para Gemini o Vertex | Si el tipo de clave es incorrecto, puede recibir errores 401, 403 o que se le solicite iniciar sesión repetidamente |
| Nombre del modelo | Rellene según la lista de modelos de Gemini | No introduzca nombres de modelos de OpenAI o Claude en Gemini |
Errores comunes
| Problema | Comprobación prioritaria | Soluciones |
|---|---|---|
| Sigue solicitando iniciar sesión en Google | Autenticación propia de Gemini CLI | Primero complete la autenticación requerida según las indicaciones de Gemini CLI; la configuración del proveedor no puede reemplazar el proceso de inicio de sesión requerido por la propia herramienta. |
| 401 / 403 | Clave de Gemini o permisos | Confirme que la clave pertenezca al grupo Gemini / Google / Vertex, y que el proyecto o cuenta actual tenga permisos para el modelo correspondiente. |
| 404 / modelo no encontrado | Nombre del modelo de Gemini | Rellene según la lista de modelos de Gemini en el panel del proveedor; no introduzca nombres de modelos de OpenAI o Claude. |
| Error de conexión | Base URL de Gemini | No introduzca la Base URL normal compatible con OpenAI en Gemini; configúrela únicamente cuando el panel indique de forma explícita compatibilidad con Gemini. |
| Sin cambios tras cambiar en CC-Switch | Herramienta de destino y estado de la terminal | Confirme que el destino de la aplicación sea Gemini CLI, guarde, luego vuelva a abrir la terminal y pruebe de nuevo. |
Prueba mínima
Primero confirme que Gemini CLI pueda devolver una frase corta fija y luego continúe solucionando problemas en tareas más complejas.
Prueba mínima de Gemini
gemini "Please reply only: Gemini configuration test successful"Plantilla de reporte
Al enviar un reporte al proveedor, redacte de la siguiente forma
Tool: Gemini System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened