Dépannage de Gemini
Les interfaces compatibles Gemini et OpenAI ne sont pas la même chose. Ne configurez selon Gemini que si le fournisseur propose explicitement des interfaces liées à Gemini / Google / Vertex, ou si le tutoriel indique clairement la prise en charge de Gemini CLI.
Que faut-il vérifier en premier ?
| Éléments à vérifier | Comment vérifier | Pourquoi |
|---|---|---|
| Outil cible | Confirmez que vous dépannez Gemini CLI | La méthode d'authentification pour Gemini CLI est différente de celle de Codex et de Claude Code |
| Le fournisseur prend en charge Gemini | Il existe des entrées relatives à Gemini / Google / Vertex dans l'interface d'administration ou les tutoriels | L'interface compatible OpenAI n'est pas identique à l'interface Gemini |
| Type de clé | Utilisez la clé correspondante pour Gemini ou Vertex | Si le type de clé est incorrect, vous risquez d'obtenir une erreur 401, 403 ou d'être invité à vous reconnecter sans cesse |
| Nom du modèle | Remplissez selon la liste des modèles Gemini | Ne saisissez pas de noms de modèles OpenAI ou Claude dans Gemini |
Erreurs courantes
| Symptôme | Vérification prioritaire | Solutions |
|---|---|---|
| Demande toujours de se connecter à Google | Propre authentification de Gemini CLI | Effectuez d'abord l'authentification requise indiquée par Gemini CLI ; la configuration du fournisseur ne peut pas remplacer le processus de connexion requis par l'outil cible lui-même. |
| 401 / 403 | Clé Gemini ou autorisations | Vérifiez que la clé appartient au groupe Gemini / Google / Vertex et que le projet ou le compte actuel dispose des autorisations pour le modèle correspondant. |
| 404 / modèle introuvable | Nom du modèle Gemini | Remplissez selon la liste des modèles Gemini dans l'interface du fournisseur ; ne saisissez pas de noms de modèles OpenAI ou Claude. |
| Échec de connexion | URL de base Gemini | Ne saisissez pas l'URL de base habituelle compatible OpenAI dans Gemini ; configurez-la uniquement lorsque l'interface d'administration indique explicitement la prise en charge de Gemini. |
| Aucun changement après avoir basculé CC-Switch | Outil cible et état du terminal | Confirmez que la cible d'application est Gemini CLI, enregistrez, puis rouvrez le terminal et faites un nouveau test. |
Test minimal
Vérifiez d'abord que Gemini CLI peut renvoyer une phrase courte prédéfinie avant de continuer le dépannage de tâches plus complexes.
Test minimal de Gemini
gemini "Please reply only: Gemini configuration test successful"Modèle de retour d'information
Pour faire un retour au fournisseur, écrivez ainsi
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