Guide de configuration

Guide de configuration du fournisseur

Consultez les étapes de configuration et le dépannage par outil.

Guide de configuration du fournisseur/Configuration de Gemini CLI

Configuration de Gemini CLI

Gemini CLI est l'outil d'IA pour terminal de Google. Il est idéal pour utiliser Gemini en ligne de commande pour les questions-réponses, la compréhension de code et l'assistance sur vos projets.

Présentation et cas d'usage de cet outil

Google GeminiOutils de terminalConnexion GoogleGemini API Key

Choisir d'abord la méthode d'authentification

MéthodePublic cibleDescription
Connexion GoogleUtilisateurs individuels et débutantsLancez Gemini et connectez-vous selon les instructions
Gemini API KeyUtilisateurs disposant déjà d'une clé Google AI StudioDéfinissez la clé dans GEMINI_API_KEY
Vertex AIUtilisateurs en entreprise ou sur projet CloudConfigurez selon les projets et autorisations Google Cloud

Comment tester la clé API

Test temporaire dans PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" gemini

Que faire après un test réussi

  1. Lancez d'abord Gemini CLI dans un répertoire vide ; n'ouvrez pas directement des projets importants.
  2. Posez une seule question courte et simple pour confirmer que le modèle répond normalement.
  3. Faites-lui ensuite lire un fichier de test en lui demandant explicitement de ne pas le modifier.
  4. Si vous souhaitez utiliser la clé API sur le long terme, enregistrez la méthode d'authentification dans votre environnement local ou votre configuration conformément à la documentation officielle de Gemini CLI.
  5. Si vous avez changé de fournisseur d'IA ou utilisé CC-Switch, testez à nouveau après avoir rouvert le terminal.
SymptômeVérification prioritaireRésolution
Demande toujours la connexion GoogleLa méthode d'authentification actuelle suit-elle la procédure de connexion Google ?Complétez d'abord l'authentification en suivant les invites de Gemini CLI ; ne mélangez pas le dépannage de la clé API et celui de la connexion Google
Clé invalideLa variable GEMINI_API_KEY provient-elle bien de Google AI Studio / Gemini ?Ne renseignez pas de clés OpenAI ou Claude dans Gemini
Modèle indisponibleLe nom du modèle fait-il partie de la liste Gemini ?N'entrez pas de noms de modèles OpenAI / Claude dans Gemini CLI

Points d'attention lors de la configuration d'un fournisseur d'IA

Gemini CLI et un fournisseur compatible OpenAI ne fonctionnent pas de la même manière. Ne suivez les tutoriels d'un fournisseur que s'il indique explicitement la méthode de configuration pour Gemini CLI, Google Gemini ou Vertex AI.

Ne saisissez pas une URL de base OpenAI standard dans Gemini CLI. OpenAI, Claude et Gemini reposent sur trois protocoles différents. Si le fournisseur propose des adresses distinctes dans son interface, vous devez impérativement renseigner celle qui correspond à cet outil.
Documentation officielle de Gemini CLI Consulter les points d'entrée d'installation, de commandes et de configuration.
Documentation d'authentification de Gemini CLI Consulter les détails pour la connexion Google, Gemini API Key et Vertex AI.