CC-Switch Gemini
En esta página se explica cómo aplicar proveedores relacionados con Gemini a Gemini CLI mediante CC Switch. Las interfaces y los métodos de autenticación de Gemini son diferentes de las interfaces compatibles con OpenAI, por lo que no basta con introducir una Base URL convencional de OpenAI y esperar que funcione para Gemini.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
Qué explica esta página
Solo se recomienda configurar Gemini en CC Switch si el proveedor ofrece claramente interfaces relacionadas con Gemini / Google / Vertex, o si su documentación indica explícitamente compatibilidad con Gemini CLI.
Comprobaciones previas
| Aspectos a comprobar | Cómo verificarlo | Por qué |
|---|---|---|
| Gemini CLI puede iniciarse | Primero, confirme que Gemini CLI se puede abrir en este equipo | CC Switch solo se encarga de cambiar la configuración |
| El proveedor es compatible con Gemini | Existen entradas relacionadas con Gemini / Google / Vertex en el panel de control o en los tutoriales | La interfaz compatible con OpenAI no es igual a la interfaz de Gemini |
| El tipo de clave es correcto | Confirme que la clave corresponde a Gemini o Vertex | Un tipo de clave incorrecto provocará un error de autenticación |
| El nombre del modelo proviene de la lista de Gemini | Copie el nombre del modelo de Gemini desde el panel del proveedor | No mezcle nombres de modelos de Claude u OpenAI |
Cómo rellenar los campos
| Ajuste | Cómo completarlo | Aviso para principiantes |
|---|---|---|
| Provider Name | Especifique claramente el propósito | Por ejemplo, 'Proveedor Gemini' o 'Google Gemini' |
| Target Tool / Preset | Seleccione presets relacionados con Gemini o Google / Vertex | No seleccione presets compatibles con OpenAI |
| Base URL | Copie la dirección de la interfaz correspondiente a Gemini | Si el panel solo proporciona una dirección de OpenAI, no intente introducirla por la fuerza todavía |
| API Key | Copie la clave correspondiente a Gemini / Vertex | El tipo de clave debe coincidir con la Base URL |
| Model Name | Copie la lista de modelos de Gemini | Los nombres de los modelos suelen ser distintos a los de OpenAI y Claude |
Aplicar a Gemini
- Abra CC Switch y diríjase a la sección de gestión de proveedores.
- Añada un nuevo proveedor de Gemini o seleccione uno ya configurado.
- Elija los presets relacionados con Gemini CLI como herramienta de destino.
- Introduzca la Base URL, la API Key y el nombre de modelo correspondientes para Gemini.
- Tras guardar, ejecute Apply / Switch.
- Vuelva a abrir la terminal y realice una prueba mínima con Gemini CLI.
Comprobar si funciona
Los motivos más frecuentes de error al configurar Gemini son introducir una dirección compatible con OpenAI en Gemini o utilizar un tipo de clave que no coincide con la dirección de la interfaz.
Prueba mínima de Gemini
gemini "Please reply only: CC-Switch Gemini is active"Si Gemini CLI sigue requiriendo iniciar sesión en Google, siga primero las indicaciones de la propia herramienta; CC Switch solo puede sincronizar la configuración de los proveedores compatibles y no puede eludir los requisitos de inicio de sesión de la herramienta de destino.