CC-Switch Gemini
Cette page explique comment appliquer des providers compatibles Gemini au Gemini CLI via CC Switch. Les interfaces et méthodes d'authentification de Gemini diffèrent des interfaces compatibles OpenAI ; vous ne pouvez donc pas simplement renseigner l'URL de base OpenAI habituelle et supposer qu'elle fonctionnera pour Gemini.
Ce que cette page explique
Il est recommandé de configurer Gemini dans CC Switch uniquement lorsque le provider propose explicitement des interfaces liées à Gemini / Google / Vertex, ou que sa documentation mentionne clairement la prise en charge de Gemini CLI.
Vérifications préalables
| Éléments à vérifier | Comment vérifier | Pourquoi |
|---|---|---|
| Gemini CLI démarre correctement | Confirmez d'abord que Gemini CLI peut s'ouvrir sur cette machine | CC Switch ne sert qu'à basculer entre les configurations |
| Le provider prend en charge Gemini | Des entrées relatives à Gemini / Google / Vertex existent dans l'espace client ou les tutoriels | Une interface compatible OpenAI n'est pas identique à une interface Gemini |
| Le type de clé est correct | Vérifiez que la clé correspond bien à Gemini ou Vertex | Un mauvais type de clé provoquera un échec d'authentification |
| Le nom du modèle provient de la liste Gemini | Copiez le nom du modèle Gemini depuis l'espace client du provider | Ne mélangez pas avec les noms de modèles Claude ou OpenAI |
Comment renseigner les champs
| Paramètre | Méthode de saisie | Attention débutants |
|---|---|---|
| Provider Name | Indiquez clairement l'usage | Par exemple, 'Provider Gemini' ou 'Google Gemini' |
| Target Tool / Preset | Sélectionnez le préréglage lié à Gemini ou Google / Vertex | Ne sélectionnez pas les préréglages compatibles OpenAI |
| Base URL | Copiez l'adresse d'interface correspondant à Gemini | Si l'espace client ne fournit qu'une adresse OpenAI, ne la forcez pas ici |
| API Key | Copiez la clé correspondant à Gemini / Vertex | Le type de clé doit impérativement correspondre à la Base URL |
| Model Name | Copiez la liste des modèles Gemini | Les noms de modèles diffèrent généralement de ceux d'OpenAI et Claude |
Appliquer à Gemini
- Ouvrez CC Switch et accédez à la section de gestion des providers.
- Ajoutez un nouveau provider Gemini ou sélectionnez-en un déjà configuré.
- Choisissez le préréglage lié à Gemini CLI comme outil cible.
- Renseignez l'URL de base, la clé API et le nom de modèle correspondants pour Gemini.
- Après avoir sauvegardé, cliquez sur Apply / Switch.
- Rouvrez le terminal, puis effectuez un test minimal avec Gemini CLI.
Tester le fonctionnement
Les causes d'échec les plus fréquentes pour la configuration de Gemini sont l'utilisation d'une adresse compatible OpenAI pour Gemini, ou un type de clé qui ne correspond pas à l'adresse de l'interface.
gemini "Please reply only: CC-Switch Gemini is active"