Exercice pratique avec Gemini CLI

1. Introduction

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

Points abordés

  1. Installer et configurer Gemini CLI
  2. Explorer les outils, les commandes intégrées et la configuration des serveurs MCP dans Gemini CLI
  3. Personnaliser Gemini CLI via le fichier GEMINI.md
  4. Explorer quelques cas d'utilisation avec Gemini CLI

Prérequis

Cet atelier de programmation peut être entièrement réalisé dans Google Cloud Shell, qui est préinstallé avec Gemini CLI.

Si vous préférez travailler sur votre propre machine, une section vous explique comment installer Gemini CLI en local.

Vous aurez besoin des éléments suivants :

  • Navigateur Web Chrome
  • Un compte Gmail

Cet atelier de programmation s'adresse aux utilisateurs et aux développeurs de tous niveaux (y compris aux débutants). Les cas d'utilisation de l'atelier de programmation ont été classés en tâches pour les développeurs et tâches pour les non-développeurs. Les cas d'utilisation pour les développeurs montrent comment faire du vibe coding avec Gemini CLI et comment travailler avec un dépôt GitHub pour effectuer des tâches de développement courantes telles que l'explication/la compréhension du code, la génération de documentation, la résolution de problèmes, etc. Nous vous recommandons d'effectuer ces cas d'utilisation dans l'atelier de programmation. Une section facultative à la fin de l'atelier couvre plusieurs tâches quotidiennes qui ne sont pas axées sur le développement.

2. Avant de commencer

Créer un projet

  1. Dans la console Google Cloud, sur la page du sélecteur de projet, sélectionnez ou créez un projet Google Cloud.
  2. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
  3. Vous allez utiliser Cloud Shell, un environnement de ligne de commande exécuté dans Google Cloud et fourni avec bq. Cliquez sur "Activer Cloud Shell" en haut de la console Google Cloud.

Image du bouton "Activer Cloud Shell"

  1. Une fois connecté à Cloud Shell, vérifiez que vous êtes déjà authentifié et que le projet est défini sur votre ID de projet à l'aide de la commande suivante :
gcloud auth list
  1. Exécutez la commande suivante dans Cloud Shell pour vérifier que la commande gcloud connaît votre projet.
gcloud config list project
  1. Si votre projet n'est pas défini, utilisez la commande suivante pour le définir :
gcloud config set project <YOUR_PROJECT_ID>

3. Installation

Avant de configurer et d'exécuter Gemini CLI, créons un dossier qui servira de dossier parent pour tous les projets que nous créerons à l'intérieur. C'est un point de départ pour Gemini CLI, mais il peut aussi utiliser d'autres dossiers de votre système 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

Vous pouvez lancer directement Gemini CLI à l'aide de la commande gemini.

Veuillez passer directement à la section suivante (Configuration de Gemini CLI via settings.json).

Si vous souhaitez installer Gemini CLI en local, suivez les instructions ci-dessous. Notez que Gemini CLI est préinstallé sur Cloud Shell et Cloud Workstations.

La première étape consiste à installer Node 20 ou version ultérieure sur votre ordinateur. Une fois cette opération terminée, vous pouvez installer et exécuter Gemini CLI à l'aide de l'une des méthodes suivantes :

  1. Vous pouvez d'abord installer Gemini CLI de manière globale sur votre système. Vous aurez peut-être besoin d'un accès administrateur pour effectuer cette étape.
# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini
  1. Exécutez-le avec la commande suivante :
# option 2: run without installing Gemini CLI

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

Pour vérifier que la CLI est installée, exécutez la commande suivante :

gemini --version

En supposant que vous ayez lancé Gemini CLI par l'une des méthodes ci-dessus, il se peut qu'on vous demande de sélectionner un thème lors du premier lancement. Si c'est le cas, vous pouvez conserver le thème par défaut ou en choisir un autre.

L'authentification est un autre élément important. Il vous demandera la méthode d'authentification. Nous vous recommandons d'utiliser votre compte Google personnel pour cet atelier, et non un compte non Google ou Google Workspace.

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.

57bad75cedaaaa38.png

Cliquez sur "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 et, une fois l'authentification réussie, vous remarquerez que Gemini CLI est prêt et attend votre commande.

Voici un exemple de capture d'écran :

8fc80ad44c19f782.png

Dans ce cas, nous avons sélectionné l'option Vertex AI, mais il peut s'agir du compte personnel dans votre cas. Vous remarquerez que nous avons sélectionné le modèle Gemini 2.5 (visible en bas à droite). Vous pouvez choisir votre modèle spécifique à tout moment à l'aide de la commande /model.

4. Configuration de Gemini CLI via settings.json

Si vous choisissez Cloud Shell pour exécuter Gemini, le thème par défaut de Gemini CLI et la méthode d'authentification sont déjà sélectionnés et configurés pour vous.

Si vous avez installé Gemini CLI sur votre ordinateur et que vous l'avez lancé pour la première fois, vous avez sélectionné un thème, puis une méthode d'authentification.

Désormais, lors des exécutions suivantes de Gemini CLI, 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 Gemini CLI.

Les paramètres sont appliqués avec la priorité suivante (Cloud Shell ne met à disposition que les paramètres utilisateur) :

  1. Système : /etc/gemini-cli/settings.json (s'applique à tous les utilisateurs, remplace les paramètres utilisateur et d'espace de travail).
  2. Workspace : .gemini/settings.json (remplace les paramètres utilisateur).
  3. Utilisateur : ~/.gemini/settings.json.

Utilisateur Windows : %USERPROFILE%.gemini\settings.json (qui se développe généralement en C:\Users&lt;YourUsername>.gemini\settings.json)

Système : %ProgramData%\gemini-cli\settings.json (qui se développe généralement en C:\ProgramData\gemini-cli\settings.json)

Utilisateur Mac : ~/.gemini/settings.json (qui se développe en /Users/<YourUsername>/.gemini/settings.json)

Système : /etc/gemini-cli/settings.json

Si vous vous en souvenez, vous avez sélectionné l'option permettant d'enregistrer les paramètres dans les paramètres utilisateur lorsque vous avez choisi 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.

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal" or "cloud-shell"
    }
  },
  "ui": {
    "theme": "Default"
  }
}

5. Notre première interaction avec Gemini CLI

Commençons à utiliser Gemini CLI et saisissons notre première requête comme indiqué ci-dessous :

Give me a famous quote on Artificial Intelligence and who said that?

La réponse attendue est la suivante :

 > Give me a famous quote on Artificial Intelligence and who said that?                 
✦ "The only way to do great work is to love what you do." - Steve Jobs (While not directly about AI, it's a famous quote related to technology and innovation, which underpins AI development.)
Alternatively:
  "The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking

Pour comprendre rapidement Gemini CLI et les différentes commandes qu'il prend en charge, saisissez /help (barre oblique) pour obtenir une liste de commandes et de raccourcis clavier.

Quittons Gemini CLI pour le moment. Pour ce faire, vous pouvez utiliser la commande /quit ou saisir Ctrl-C deux fois dans la session de terminal interactive Gemini CLI. Lorsque vous quittez Gemini CLI, les statistiques de votre session s'affichent. Elles vous donnent des informations sur votre session, l'utilisation du modèle et d'autres métriques.

6. Gemini CLI : paramètres de commande

Vous pouvez fournir quelques paramètres de ligne de commande lorsque vous démarrez Gemini CLI. 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 Gemini CLI pour qu'il utilise un mode Gemini spécifique. Au moment de la mise à jour de cet atelier, voici la liste des modèles compatibles. Pour utiliser un modèle spécifique, vous pouvez le faire au moment de démarrer Gemini CLI à l'aide du paramètre -m, comme indiqué ci-dessous :

gemini -m "gemini-2.5-flash"

Vous remarquerez que 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.

Une fois dans l'application Gemini CLI, vous pouvez utiliser la commande /model pour ouvrir une boîte de dialogue qui vous permet de choisir un modèle. Un exemple d'exécution est présenté ci-dessous. En fonction de vos besoins et des conseils fournis, vous pouvez continuer à changer de modèle pour choisir celui qui convient le mieux à la tâche en fonction de sa complexité et de la nécessité de contrôler les coûts.

69154a6bf6553f35.png

Mode non interactif

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

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

N'oubliez pas qu'il n'est pas possible de poursuivre la conversation avec des questions complémentaires. Ce mode ne vous permet pas non plus d'autoriser des outils (y compris WriteFile) ni d'exécuter des commandes shell.

N'oubliez pas que si vous oubliez le paramètre -p et que vous fournissez simplement ce qui suit, Gemini CLI s'ouvrira avec le prompt et continuera à l'intérieur.

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

7. Gemini CLI : outils intégrés

Gemini CLI est fourni 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 la CLI, qui peut ainsi aller au-delà de la génération de texte et vous aider à effectuer de nombreuses tâches."

Pour obtenir la liste des outils intégrés actuels, appelez la commande /tools comme indiqué ci-dessous :

Available Gemini CLI tools:
  - Activate Skill (activate_skill)
  - Ask User (ask_user)
  - Edit (replace)
  - Enter Plan Mode (enter_plan_mode)
  - FindFiles (glob)
  - GoogleSearch (google_web_search)
  - Invoke Subagent (invoke_agent)
  - List Background Processes (list_background_processes)
  - Read Background Output (read_background_output)
  - ReadFile (read_file)
  - ReadFolder (list_directory)
  - SearchText (grep_search)
  - Shell (run_shell_command)
  - Update Topic Context (update_topic)
  - WebFetch (web_fetch)
  - WriteFile (write_file)

Une des premières choses qui devrait vous frapper est de vous demander si Gemini CLI peut simplement appeler ces outils quand il le souhaite. La réponse par défaut est non pour les opérations sensibles qui peuvent impliquer d'écrire dans le système local, de lire à partir d'un système externe, d'accéder au réseau externe, etc.

Bien qu'il existe un mode --yolo (généralement déconseillé) lorsque vous démarrez la CLI, vous constaterez que Gemini CLI vous demandera l'autorisation d'exécuter l'outil qu'il a choisi. Vous pouvez refuser, autoriser une fois ou toujours autoriser. C'est vous qui gardez le contrôle total, ce qui est normal.

Utilisons un prompt qui permettra à Gemini CLI de choisir l'un des outils intégrés à exécuter. Vous comprendrez ainsi mieux comment tout cela fonctionne.

Imaginez que vous souhaitiez obtenir des informations sur les dernières actualités financières dans le monde et les enregistrer dans un fichier du répertoire de travail local à partir duquel vous avez lancé Gemini CLI. Utilisez 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 ordinateur).

La première chose que Gemini CLI fait est d'appeler l'outil GoogleSearch pour effectuer une recherche sur le Web et récupérer les résultats, comme indiqué ci-dessous :

 Searching for Finance News: 
  I will first search for the latest finance headlines and then save them to a file.
  ✓  GoogleSearch  Searching the web for: "latest finance headlines"
   → Search results for "latest finance headlines" returned.
  Saving Finance News: I will now save the finance headlines to the file 'finance-news-today.txt'.

Une fois cette opération terminée, il est prêt à écrire le résultat dans le fichier et utilise l'outil WriteFile. Toutefois, comme il s'agit d'une opération sensible (écriture), il vous demande votre autorisation. Vous pouvez choisir le type d'autorisation (autoriser une seule fois, autoriser toujours, etc.). Pour l'instant, sélectionnez "Autoriser une seule fois".

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

✦ I have saved the latest finance news to finance-news-today.txt.
  Finance News Saved: The task is complete.

Comment vérifier si le fichier a été créé ou non ? Vous pouvez utiliser @file pour lui demander de lire le contenu. Lorsque vous saisissez @, une liste de fichiers s'affiche dans le dossier actuel, y compris le fichier qui vient d'être créé. 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 :

  ✓  ReadManyFiles  Attempting to read files from finance-news-today.txt → Read 1 file(s)
  Topic: Summarizing the financial news headlines.
✦ The latest finance headlines as of May 15, 2026, include:
  Global Markets & Economy:
   * The Dow Jones Industrial Average surpassed 50,000 for the first time, driven by strong earnings from Cisco
     Systems and a 2% rise in Nasdaq due to tech stocks.
   * Inflation concerns are growing, hinting at potential Fed interest rate hikes.
   * Kevin Warsh has been confirmed as the new Federal Reserve head.
   * A "constructive" U.S.-China summit took place in Beijing between President Trump and President Xi, with
     markets watching for impacts from proposed tariffs.
  Corporate & Tech News:
   
<REST OF THE CONTENT>

8. Gemini CLI – Mode shell

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

En mode shell, vous verrez le caractère ! au début du prompt, comme indiqué ci-dessous :

aab5d032116fa5e8.png

Vous pouvez effectuer une vérification directe à l'aide de commandes standards telles que pwd et ls, comme indiqué ci-dessous. Veuillez noter que les commandes supposent un système d'exploitation de type Linux. Si vous utilisez un autre système d'exploitation (Windows), veuillez utiliser des commandes équivalentes telles que cd, dir et type. Notez que le résultat de ces appels est inclus dans la fenêtre de contexte du modèle.

f6e6d45174a9997d.png

Vous pouvez également afficher le contenu du fichier à l'aide de la commande cat, c'est-à-dire cat finance-news-today.txt.

Exercice : voici un petit exercice à essayer. Choisissez le flux RSS de votre choix. Saisissez un prompt dans Gemini CLI pour récupérer le contenu du flux RSS et mettre en forme les résultats d'une manière spécifique. C'est un bon moyen d'automatiser une action au début de la journée. Vous pouvez même demander à Gemini CLI de déterminer s'il existe un flux RSS pour un domaine spécifique, par exemple les notes de version de Google Cloud Platform.

Voici un exemple de requête :

Get the latest release notes for Google Cloud from its RSS Feed and display the key points in a well-formatted list.

Idéalement, cette requête devrait d'abord appeler l'outil