Cette page a été traduite par l'API Cloud Translation.

Exercice pratique avec Gemini CLI

1. Introduction

Dans cet atelier de programmation, vous allez découvrir la CLI Gemini, un agent d'IA Open Source qui apporte la puissance de Gemini directement dans votre terminal.

Le projet Gemini CLI est Open Source. Vous pouvez consulter la feuille de route publique ici.

Dans cet atelier de programmation, vous allez adopter une approche pas à pas pour des activités telles que :

Installer la CLI Gemini
Configuration de base
Explorer les outils et les commandes intégrées dans la CLI Gemini
Personnaliser la CLI Gemini via le fichier GEMINI.md
Explorer quelques cas d'utilisation avec la CLI Gemini

Prérequis

Navigateur Web Chrome
Un compte Gmail
Une machine locale sur laquelle Node 20 ou version ultérieure est installé.

Cet atelier de programmation s'adresse aux utilisateurs et aux développeurs de tous niveaux, y compris aux débutants.

2. Installation

Avant d'exécuter la configuration et la CLI Gemini, créons un dossier qui servira de dossier de base pour tous les projets que nous pourrons créer à l'intérieur. Il s'agit d'un point de départ pour que la CLI Gemini fonctionne. Toutefois, elle fera également référence à d'autres dossiers de votre système, que nous aborderons plus tard, si nécessaire.

Créez un exemple de dossier (gemini-cli-projects) et accédez-y à l'aide des commandes ci-dessous. Si vous préférez utiliser un autre nom de dossier, n'hésitez pas.

mkdir gemini-cli-projects

Accédez à ce dossier :

cd gemini-cli-projects

Pour exécuter Gemini CLI, vous pouvez utiliser l'une des méthodes suivantes :

Exécutez-le avec la commande suivante :

npx https://github.com/google-gemini/gemini-cli

Vous pouvez d'abord installer la CLI Gemini de manière globale sur votre système. Assurez-vous de disposer des droits d'administrateur pour ce faire.

npm install -g @google/gemini-cli

Exécutez-le ensuite avec la commande suivante :

gemini

En supposant que vous ayez lancé la CLI Gemini par l'une des méthodes ci-dessus, l'écran suivant devrait s'afficher et vous demander de choisir un thème. Sélectionnez-en un qui vous plaît :

Une fois que vous l'avez sélectionné, il vous demande la méthode d'authentification. Nous vous recommandons d'utiliser votre compte Google personnel et non des comptes non Google ou Google Workspace pour cet atelier. Cette licence sans frais vous donne accès à Gemini 2.5 Pro et à sa fenêtre de contexte d'un million de jetons. Le niveau sans frais permet d'effectuer 60 requêtes de modèle par minute et 1 000 requêtes par jour sans frais.

Si vous atteignez les limites du quota sans frais actuel accordé aux comptes Google, vous pouvez choisir d'utiliser la clé API Gemini ou même Google Cloud Vertex AI, pour lequel vous aurez besoin d'un ID de projet et du nom de l'emplacement de ce projet. Si vous prévoyez d'utiliser d'autres méthodes d'authentification, consultez la section Authentification de la documentation.

Cliquez sur "Enter" (Entrée). Une page d'authentification Google s'ouvre dans le navigateur. Procédez à l'authentification avec votre compte Google, acceptez les conditions d'utilisation, puis, une fois l'authentification réussie, vous remarquerez que la Gemini CLI est prête et attend votre commande. Voici un exemple de capture d'écran :

Saisissez /help (barre oblique) pour afficher différentes commandes et raccourcis clavier, comme indiqué ci-dessous :

Notre première interaction avec la CLI Gemini

Saisissez votre premier message dans la zone de texte. Nous allons lui soumettre une requête comme celle-ci :

Vous remarquerez que notre requête a entraîné l'appel d'un outil GoogleSearch (outil intégré à la CLI Gemini). C'est une façon intéressante d'utiliser l'un des puissants outils intégrés de Gemini CLI, à savoir GoogleSearch, qui ancre ses réponses sur les informations qu'il obtient sur le Web. Nous en apprendrons davantage sur les outils dans la section suivante.

Quittons la CLI Gemini pour le moment. Vous pouvez le faire soit avec la commande /quit, soit en saisissant Ctrl-C deux fois dans la session de terminal interactive de la CLI Gemini.

Fichier de personnalisation de la CLI Gemini : settings.json

Si vous vous souvenez de la première fois que vous avez lancé la CLI Gemini, vous avez été invité à sélectionner un thème, puis une méthode d'authentification. Lors des exécutions ultérieures de l'interface de ligne de commande Gemini, vous ne serez plus invité à sélectionner un thème ni une méthode d'authentification. Cela signifie qu'il est conservé quelque part. Le fichier qu'il utilise s'appelle settings.json et permet de personnaliser la CLI Gemini.

Les paramètres sont appliqués selon l'ordre de priorité suivant :

Espace de travail : .gemini/settings.json (remplace les paramètres utilisateur et système).
Utilisateur : ~/.gemini/settings.json (remplace les paramètres système).
Système : /etc/gemini-cli/settings.json (s'applique à tous les utilisateurs).

Si vous vous en souvenez, nous vous avons demandé d'enregistrer les paramètres dans les paramètres utilisateur lorsque vous avez sélectionné le thème. Accédez à ~/.gemini folder et vous verrez le fichier settings.json.

Voici mon fichier settings.json. Si vous aviez sélectionné un autre thème, son nom s'afficherait ici.

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal"
}

3. Paramètres des commandes de la CLI Gemini

Vous pouvez fournir quelques paramètres de ligne de commande lorsque vous démarrez l'interface de ligne de commande Gemini. Pour obtenir la liste complète des options, vous pouvez utiliser --help comme indiqué ci-dessous.

gemini --help

Toutes les options disponibles devraient s'afficher. Nous vous encourageons à consulter la documentation ici.

Examinons-en quelques-unes. La première consiste à configurer la CLI Gemini pour utiliser le modèle Pro ou Flash. Actuellement, au moment de la rédaction de cet atelier, seuls ces deux modèles sont compatibles. Par défaut, le modèle Gemini 2.5 Pro est utilisé. Toutefois, si vous souhaitez utiliser le modèle Flash, vous pouvez le faire au moment de démarrer la CLI Gemini à l'aide du paramètre -m, comme indiqué ci-dessous :

gemini -m "gemini-2.5-flash"

Si vous commencez de la manière décrite ci-dessus, vous pouvez vérifier le modèle en bas à droite du terminal Gemini CLI, comme indiqué ci-dessous :

Mode non interactif

Une option intéressante consiste à exécuter la CLI Gemini en mode non interactif. Cela signifie que vous lui fournissez directement la requête et qu'il y répondra sans ouvrir le terminal interactif de la CLI Gemini. Cela est très utile si vous prévoyez d'utiliser la CLI Gemini de manière automatisée dans un script ou tout autre processus d'automatisation. Vous utilisez le paramètre -p pour fournir la requête à Gemini CLI, comme indiqué ci-dessous :

gemini -p "What is the gcloud command to deploy to Cloud Run"

N'oubliez pas que vous ne pourrez pas poursuivre la conversation en posant d'autres questions.

4. CLI Gemini : outils intégrés

La CLI Gemini est fournie avec un ensemble d'outils intégrés. La documentation sur les outils indique que "le modèle Gemini utilise ces outils pour interagir avec votre environnement local, accéder à des informations et effectuer des actions. Ces outils améliorent les capacités de l'interface de ligne de commande, lui permettant d'aller au-delà de la génération de texte et d'aider à un large éventail de tâches."

Pour obtenir la liste des outils intégrés actuels, il suffit d'appeler la commande /tools comme indiqué ci-dessous :

L'une des premières choses que vous devriez vous demander est si la CLI Gemini peut simplement appeler ces outils quand elle le souhaite. La réponse par défaut est non pour les opérations sensibles qui peuvent impliquer l'écriture dans le système local, la lecture à partir d'un système externe, l'accès au réseau externe, etc.

Bien qu'un --yolomode soit disponible lorsque vous démarrez la CLI, que nous n'utiliserons pas, vous constaterez que la CLI Gemini vous demandera l'autorisation d'exécuter l'outil qu'elle a choisi. Vous pouvez refuser l'autorisation, l'autoriser à s'exécuter une seule fois ou lui accorder une autorisation globale pour qu'elle s'exécute en permanence. Vous avez et devriez avoir le contrôle total.

Donnons une requête qui permettra à la CLI Gemini de choisir l'un des outils intégrés à exécuter. Cela nous permettra de bien comprendre comment tout cela fonctionne.

Nous aimerions obtenir des informations sur les dernières actualités financières dans le monde et les enregistrer dans un fichier de notre répertoire de travail local à partir duquel nous avons lancé l'interface de ligne de commande Gemini. Nous fournissons le prompt suivant :

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

Imaginez un instant ce qu'il devrait faire. Idéalement, il devrait effectuer une recherche Google pour obtenir des informations financières auprès de sources d'informations pertinentes. Il doit ensuite créer un fichier nommé finance-news-today.txt (une opération d'écriture sur votre système local qui nécessitera votre autorisation) avec son contenu.

Voyons ce qui se passe (vous devriez faire de même sur votre machine).

La première chose qu'il fait est d'appeler l'outil GoogleSearch pour effectuer une recherche sur le Web.

Une fois la recherche terminée, les données sont récupérées comme indiqué ci-dessous :

Une fois cela fait, il est prêt à écrire dans le fichier et utilisera l'outil WriteFile, mais comme il s'agit d'une opération sensible (write), il vous demandera votre autorisation. Vous pouvez choisir le type d'autorisation (autoriser une fois, autoriser toujours, etc.). Pour l'instant, nous sélectionnons "Autoriser une fois".

Les informations sont ensuite écrites dans le fichier et un message de confirmation s'affiche :

Comment vérifier si le fichier est écrit ou non ? Nous pouvons utiliser @file pour lui demander de lire le contenu. Nous fournissons une invite comme indiqué ci-dessous. Lorsque nous saisissons @, une liste des fichiers du dossier actuel s'affiche, y compris le fichier que nous venons de créer. Sélectionnez-le et envoyez la requête. Voici ma requête :

read the contents of @finance-news-today.txt

Les outils requis (ReadManyFiles, ReadFile) sont alors appelés et le contenu s'affiche comme suit :

C'est également le bon moment pour apprendre à travailler directement avec le Shell depuis la CLI Gemini. Vous pouvez passer en mode shell en appuyant sur ! dans la zone de message. Le mode Shell est alors activé. Pour revenir en arrière, appuyez à nouveau sur ! ou sur la touche ESC.

En mode shell, ! s'affiche au début de l'invite, comme indiqué ci-dessous :

Je peux vérifier directement à l'aide de commandes standards telles que pwd et ls, comme indiqué ci-dessous :

Nous pouvons imprimer le contenu du fichier à l'aide de la commande cat.

Exercice : voici un petit exercice à essayer. Choisissez le flux RSS de votre choix. Donnez une requête à la CLI Gemini pour qu'elle récupère le contenu du flux RSS et le mette en forme d'une manière spécifique. C'est un bon moyen d'automatiser une action au début de la journée.

Conseil : Vous devriez finir par faire en sorte que la CLI Gemini utilise l'outil WebFetch.

5. Configurer des serveurs MCP (Model Context Protocol)

Un serveur MCP est une application qui expose des outils et des ressources à la CLI Gemini via le protocole MCP (Model Context Protocol), ce qui lui permet d'interagir avec des systèmes et des sources de données externes. Les serveurs MCP servent de passerelle entre le modèle Gemini et votre environnement local ou d'autres services tels que les API.

Un serveur MCP permet à la CLI Gemini de découvrir et d'exécuter des outils, ce qui étend ses capacités à effectuer des actions au-delà de ses fonctionnalités intégrées, comme interagir avec des bases de données, des API, des scripts personnalisés ou des workflows spécialisés.

La CLI Gemini permet de configurer des serveurs MCP pour découvrir et utiliser des outils personnalisés. Si la CLI Gemini est lancée, vous pouvez vérifier les serveurs MCP configurés à l'aide de la commande /mcp, comme indiqué ci-dessous :

Si vous n'avez configuré aucun serveur MCP, la documentation sur les serveurs MCP de l'interface de ligne de commande Gemini s'ouvrira.

Vous pouvez configurer les serveurs MCP au niveau global dans le fichier ~/.gemini/settings.json ou dans le répertoire racine de votre projet. Créez ou ouvrez le fichier .gemini/settings.json. Dans le fichier, vous devrez ajouter le bloc de configuration mcpServers, comme indiqué ci-dessous :

"mcpServers": {
    "server_name_1": {},
    "server_name_2": {},
    "server_name_n": {}
 }

Chaque configuration de serveur accepte les propriétés suivantes ( documentation de référence) :

Obligatoire (l'un des éléments suivants)

command (string) : chemin d'accès à l'exécutable pour le transport Stdio
url (string) : URL du point de terminaison SSE (par exemple, "http://localhost:8080/sse")
httpUrl (string) : URL du point de terminaison de streaming HTTP

Facultatif

args (string[]) : arguments de ligne de commande pour le transport Stdio
headers (objet) : en-têtes HTTP personnalisés lorsque vous utilisez url ou httpUrl
env (objet) : variables d'environnement pour le processus du serveur. Les valeurs peuvent faire référence à des variables d'environnement à l'aide de la syntaxe $VAR_NAME ou ${VAR_NAME}.
cwd (string) : répertoire de travail pour le transport Stdio
timeout (nombre) : délai avant expiration de la requête en millisecondes (par défaut : 600 000 ms = 10 minutes)
trust (booléen) : si la valeur est "true", ignore toutes les confirmations d'appel d'outil pour ce serveur (par défaut : "false").
includeTools (string[]) : liste des noms d'outils à inclure à partir de ce serveur MCP. Si cette option est spécifiée, seuls les outils listés ici seront disponibles à partir de ce serveur (comportement de liste blanche). Si aucune n'est spécifiée, tous les outils du serveur sont activés par défaut.
excludeTools (string[]) : liste des noms d'outils à exclure de ce serveur MCP. Les outils listés ici ne seront pas disponibles pour le modèle, même s'ils sont exposés par le serveur. Remarque : excludeTools est prioritaire sur includeTools. Si un outil figure dans les deux listes, il sera exclu.

Nous allons configurer l'un des principaux serveurs MCP dont vous pourriez avoir besoin si vous travaillez avec GitHub. Notez toutefois que la CLI Gemini invoquera les outils Git dont vous disposez sur votre système. Vous pouvez également demander à la CLI Gemini de les utiliser à la place. Sachez qu'il vous aidera avec les commandes et les exécutera pour vous, mais vous devez avoir configuré ces outils sur votre système.

Serveur MCP GitHub

Le serveur MCP officiel de GitHub fournit une documentation suffisante sur les outils qu'il expose et sur la façon de les configurer. Vous pouvez choisir de l'exécuter localement ou à distance, car la CLI Gemini est également compatible avec les serveurs MCP distants.

Dans ce tutoriel, nous avons choisi d'utiliser l'option de serveur MCP à distance dans GitHub. Pour ce faire, vous devez d'abord obtenir un jeton d'accès personnel (PAT) depuis GitHub.

Une fois que vous l'avez, vous devez ajouter l'objet serveur MCP dans le fichier settings.json. Le fichier settings.json complet de mon système est affiché ci-dessous. Vous pouvez avoir des paramètres supplémentaires, mais l'objet mcpServers doit être celui indiqué ci-dessous :

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
       "github": {
            "httpUrl": "https://api.githubcopilot.com/mcp/",
            "headers": {
                "Authorization": "GITHUB_PAT"
            },
            "timeout": 5000
       }
  }
}

Vous pouvez redémarrer Gemini CLI ou exécuter la commande /mcp refresh une fois que vous avez mis à jour settings.json avec la configuration du serveur MCP GitHub. La capture d'écran ci-dessous met en évidence le serveur MCP GitHub configuré sur ma machine et les différents outils désormais disponibles pour la CLI Gemini afin de fonctionner avec MCP.

Commençons par une requête qui invoquera l'un des outils du serveur MCP GitHub. Saisissez la requête suivante :

Notez qu'il sélectionnera l'outil approprié à partir du serveur MCP GitHub, mais comme pour les autres outils intégrés, vous devrez également accorder une autorisation explicite pour l'appeler. Exécutez le code et observez le résultat.

Vous devez maintenant travailler avec l'un de vos projets GitHub. Posez vos questions en langage naturel, par exemple :

Décris-moi <repo-name>.
Clonez <repo-name> sur mon ordinateur local.
Décris @<nom de fichier> ou @<nom de répertoire>/
Quels sont les différents composants de ce dépôt ?
J'ai apporté les modifications nécessaires. Peux-tu transférer les modifications vers GitHub et utiliser les outils du serveur GitHub MCP pour ce faire ?

Nous vous proposons un exercice pour travailler en détail avec le serveur MCP GitHub plus loin dans l'atelier.

Serveur MCP Context7

Context7 fournit une documentation à jour pour les LLM et les éditeurs de code d'IA. Si vous souhaitez fournir le contexte au LLM avec la documentation la plus récente pour le framework de votre choix, le serveur MCP Context7 est un bon choix à configurer.

Assurez-vous que votre bibliothèque figure bien sur la page d'accueil de Context7.

Voici le serveur MCP que vous devez ajouter au fichier settings.json.

"context7": {
      "httpUrl": "https://mcp.context7.com/mcp"
    }

Une fois le serveur MCP configuré et la CLI Gemini chargée avec succès, vous devriez pouvoir afficher les outils Context7 comme indiqué ci-dessous :

Vous pouvez désormais être plus précis dans votre requête et demander à la CLI Gemini d'utiliser Context7 pour obtenir la documentation la plus récente lors de la génération de votre application ou de votre extrait de code à l'aide d'un framework XYZ spécifique.

Voici un exemple de requête dans laquelle je souhaite écrire un agent à l'aide de l'Agent Development Kit (ADK) de Google. Dans ma requête, je précise de rechercher la documentation correspondante via le serveur MCP Context7.

I am working on coding an Agent using the Agent Development Kit (ADK) from Google. I would like to know how to create the LLMAgent in Python. Use Context7 for the latest documentation on ADK and specifically use /google/adk-python, /google/adk-docs and adk.wiki

Voici le résultat reçu :

Serveur MCP Google Slides

Le projet GitHub https://github.com/matteoantoci/google-slides-mcp fournit un serveur MCP pour interagir avec l'API Google Slides. Elle vous permet de créer, de lire et de modifier des présentations Google Slides par programmation.

Les étapes de configuration du serveur MCP sont indiquées dans le projet. Vous aurez besoin d'un environnement Node.js pour créer le serveur, configurer un projet Google Cloud et des jetons OAuth 2.0, puis configurer le serveur MCP dans le fichier settings.json.

Une fois la configuration terminée, vous pouvez exécuter des requêtes telles que :

Extrais les dernières informations de "web_url", résume-les en points clés et crée une présentation nommée "my_presentation".

Faites le test !

Autres serveurs MCP

Voici une liste supplémentaire de serveurs MCP qui pourraient vous intéresser :

Serveur MCP Firebase
Services Google d'IA générative pour les contenus multimédias (Imagen, Veo, Lyria)
Boîte à outils MCP pour les bases de données (fonctionne avec Firestore, BigQuery et les bases de données Google Cloud)
Serveur MCP Google Workspace (fonctionne avec Docs, Sheets, Agenda et Gmail)

Les instructions pour configurer les serveurs MCP ci-dessus sont publiées dans cet article de blog.

6. Cas d'utilisation à tester

La CLI Gemini peut être appliquée à un large éventail de cas d'utilisation, aussi bien pour les développeurs que pour les non-développeurs. Vous trouverez ci-dessous quelques scénarios. En fonction de votre domaine d'intérêt, vous pouvez en essayer un, plusieurs ou tous.

Dans chacun de ces cas, la requête est fournie. Vous pouvez essayer ce paramètre en mode interactif ou non interactif dans la CLI Gemini à l'aide du paramètre -p au moment du lancement de la CLI Gemini.

Organiser les fichiers/dossiers

Vous pouvez utiliser la Gemini CLI pour organiser les fichiers par type dans différents dossiers, selon vos besoins. Accédez à un dossier sur votre ordinateur contenant plusieurs fichiers .txt, .png, .jpg, .pdf, .mp4, etc. Il s'agit probablement de votre bureau ou de votre dossier "Téléchargements".

Accédez à ce dossier et démarrez la CLI Gemini. Nous allons d'abord lui demander de créer plusieurs dossiers pour nous : "Images", "Documents" et "Vidéos". Ensuite, nous lui demanderons d'organiser les fichiers dans ces dossiers.

L'interface de ligne de commande Gemini vous demandera souvent votre autorisation avant d'exécuter des commandes, en particulier celles qui modifient votre système de fichiers (comme l'écriture, le déplacement ou la suppression de fichiers). Examinez toujours attentivement ces invites avant d'accorder l'autorisation. Il s'agit de votre filet de sécurité.

Create the following folders "Images","Documents","Videos"

Saisissez ensuite la requête suivante :

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

Voici quelques autres scénarios d'organisation (les requêtes sont indiquées à côté de chaque scénario) :

Résumés : pour chaque document du dossier "Documents", créez un fichier txt dans le même dossier, nommé "summary_NOM_DE_FICHIER_ORIGINAL.txt", qui contient un résumé en trois phrases des principaux points du document.
Catégorisation par type : analysez tous les fichiers PDF et DOCX de ce répertoire. Déplacez tous les fichiers dont le nom ou le contenu incluent le terme "facture" dans le dossier "Finances/Factures". Déplacez les fichiers avec le mot "reçu" dans le dossier "Finances/Reçus". Tous les autres fichiers .docx sont placés dans "Rapports".
Extraction d'informations clés (et "taggage") : pour chaque fichier PDF du dossier "Financial/Invoices" (Finances/Factures), lisez son contenu. Si vous trouvez une date, renommez le fichier pour l'inclure au format AAAA-MM-JJ, par exemple : ‘invoice_2025-07-26_original_name.pdf'.