Utiliser Gemini CLI : le guide pas à pas

Pour utiliser Gemini CLI, installez-le avec npm ou Homebrew, lancez gemini dans un dossier de projet, choisissez votre méthode de connexion, puis décrivez ce que vous voulez en langage courant. Gemini lit vos fichiers, propose des modifications et des commandes shell, et par défaut demande avant d’exécuter chacune d’elles.

Avant de commencer, une mise en garde importante. Depuis le 18 juin 2026, Gemini CLI ne sert plus les utilisateurs du niveau gratuit et de Google One. Google les a basculés vers Antigravity CLI. Gemini CLI continue de fonctionner avec une clé Gemini API payante, Vertex AI ou une licence Gemini Code Assist Standard ou Enterprise. Ce guide couvre l’installation, la connexion, GEMINI.md, les réglages, MCP, les modes d’approbation, les commandes slash, le checkpointing et la reprise de sessions. Tout ce qui suit s’appuie sur la documentation officielle de Gemini CLI publiée par Google, telle qu’elle était en octobre 2026.

Ce qu’est Gemini CLI

Gemini CLI est l’agent de code open source de Google pour le terminal. Il fait tourner les modèles Gemini, lit et modifie les fichiers du dossier depuis lequel vous le lancez, exécute des commandes shell, cherche sur le web, se connecte à des serveurs MCP et prend ses instructions de projet dans GEMINI.md. C’est un agent de code et non un outil d’autocomplétion : vous lui confiez une tâche et il la traite étape par étape. Pour une comparaison avec d’autres agents, voyez Gemini CLI vs Claude Code et Codex vs Gemini CLI.

Étape 1 : installer Gemini CLI

Gemini CLI a besoin de Node.js. Choisissez l’installation qui convient à votre environnement :

Il existe trois canaux de publication sur npm : @latest (stable, hebdomadaire), @preview (hebdomadaire, en avance sur le stable) et @nightly. La plupart des gens devraient rester sur le stable. Pour mettre à jour plus tard, lancez gemini update ou réinstallez avec votre gestionnaire de paquets. Vérifiez l’installation :

gemini --version

Étape 2 : choisir sa méthode de connexion

Placez-vous dans un projet et lancez-le :

cd mon-projet
gemini

Au premier lancement, Gemini CLI vous demande comment vous authentifier. Trois options sont possibles :

• Sign in with Google : ouvre le navigateur. Depuis le changement de juin 2026, cette option s’adresse aux organisations qui ont une licence Gemini Code Assist Standard ou Enterprise ; définissez GOOGLE_CLOUD_PROJECT avec l’ID de votre projet Google Cloud avant de lancer.
• Clé Gemini API : créez une clé dans Google AI Studio et définissez GEMINI_API_KEY. Avec une clé payante, l’usage est facturé au token.
• Vertex AI : pour les équipes sur Google Cloud. Définissez GOOGLE_API_KEY et GOOGLE_GENAI_USE_VERTEXAI=true, ou utilisez vos identifiants Cloud.

export GEMINI_API_KEY="votre-cle"
gemini

Vous pouvez changer de méthode plus tard avec /auth. Si vous utilisiez Gemini CLI avec un compte personnel gratuit, l’avis de Google vous oriente vers Antigravity CLI ; Gemini CLI vs Claude Code détaille ce changement. Avant de lancer de longues sessions sur une clé, consultez les tarifs de la Gemini API pour connaître les prix actuels.

Étape 3 : votre première tâche

Commencez par quelque chose de petit mais réel :

Explique comment le module de paiement est structuré, puis ajoute une
validation des entrées à l’endpoint de remboursement et lance les tests.

Gemini lit les fichiers dont il a besoin, vous montre chaque modification et chaque commande, et attend votre accord. Quelques raccourcis sont utiles dès le premier jour :

• @chemin/fichier ajoute un fichier (ou tout un dossier) à votre prompt.
• !git status exécute directement une commande shell. Un ! seul active ou désactive le mode shell.
• gemini -p "résume README.md" exécute un seul prompt sans l’interface interactive et affiche la réponse. Ajoutez --output-format json si un script doit lire le résultat.
• /copy copie la dernière réponse dans le presse-papiers.

Étape 4 : écrire un GEMINI.md

GEMINI.md est un fichier Markdown d’instructions que Gemini CLI charge et envoie avec chaque prompt : comment builder et tester, le style de code, ce qu’il ne faut pas toucher. Lancez /init et Gemini en génère une première version à partir de votre projet. Gardez-le court et concret :

# Projet : billing-service

## Commandes
- Installation : npm ci
- Tests : npm test (à lancer avant de dire qu’une tâche est finie)

## Style
- TypeScript, indentation de 2 espaces, égalité stricte uniquement.
- Les nouveaux endpoints vont dans src/routes et ont besoin d’un test.

## À ne pas faire
- Ne pas modifier les fichiers de src/generated.

Gemini CLI charge les fichiers de contexte par couches et les assemble :

1. Global : ~/.gemini/GEMINI.md, vos réglages personnels pour tous les projets.
2. Espace de travail : les fichiers GEMINI.md du dossier du projet et de ses dossiers parents.
3. À la demande : quand un outil touche un fichier dans un sous-dossier, Gemini récupère aussi les GEMINI.md de ce dossier et de ses parents.

Vous pouvez découper un long fichier avec des imports, par exemple une ligne @./docs/style-guide.md. Pour voir ce que le modèle reçoit réellement, lancez /memory show ; /memory list indique quels fichiers ont été chargés. Si vous modifiez un fichier en cours de session, rechargez-le avec /memory reload.

Si votre dépôt a déjà un AGENTS.md, inutile de le dupliquer. Réglez context.fileName sur ["AGENTS.md", "GEMINI.md"]. CLAUDE.md vs AGENTS.md explique comment garder un seul jeu de règles pour plusieurs agents.

Étape 5 : settings.json

Gemini CLI lit ses réglages dans des fichiers JSON :

• ~/.gemini/settings.json pour vos réglages utilisateur ;
• .gemini/settings.json dans un projet pour les réglages de l’espace de travail.

Lancez /settings pour modifier la plupart des options dans un éditeur intégré au CLI plutôt que d’éditer le JSON à la main. Un petit exemple :

{
  "general": {
    "defaultApprovalMode": "auto_edit",
    "checkpointing": { "enabled": true }
  },
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Le modèle peut être choisi pour une exécution avec -m / --model. Les alias auto (par défaut), pro, flash et flash-lite permettent de choisir selon la vitesse et la profondeur sans retenir les noms exacts des modèles ; /model le change en cours de session.

Étape 6 : modes d’approbation et sandbox

Gemini CLI demande avant d’exécuter des outils, sauf si vous lui dites le contraire. L’option --approval-mode règle ce comportement :

L’ancienne option --yolo existe encore mais est dépréciée au profit de --approval-mode=yolo. Vous pouvez faire de auto_edit ou plan le mode par défaut dans les réglages ; yolo ne s’active qu’en ligne de commande.

Le sandbox est désactivé par défaut. Lancez avec --sandbox (ou -s) pour exécuter les outils dans un environnement isolé : Seatbelt sur macOS, ou un conteneur Docker ou Podman. Si vous comptez utiliser auto_edit ou yolo régulièrement, activez d’abord le sandbox. La sécurité des agents de code IA explique pourquoi les approbations seules ne suffisent pas.

Étape 7 : connecter des serveurs MCP

Les serveurs MCP donnent à Gemini des outils supplémentaires : recherche dans la documentation, navigateur, GitHub, votre base de données. Ajoutez-en un depuis le shell :

gemini mcp add github npx -y @modelcontextprotocol/server-github

Pour un serveur HTTP, ajoutez --transport http et une URL au lieu d’une commande. --env CLE=valeur transmet des variables d’environnement, et --scope user rend le serveur disponible dans tous vos projets plutôt que dans celui-ci seulement. gemini mcp list affiche ce qui est configuré et gemini mcp remove <nom> supprime un serveur.

En coulisses, tout cela est écrit dans la section mcpServers de settings.json, que vous pouvez donc aussi modifier directement. Dans une session, /mcp liste les serveurs et leurs outils, /mcp auth connecte les serveurs qui utilisent OAuth, et /mcp reload les redémarre. Le sujet est nouveau pour vous ? Lisez qu’est-ce qu’un serveur MCP. Chaque serveur ajoute des descriptions d’outils à la fenêtre de contexte, alors ne gardez que ceux dont vous vous servez.

Étape 8 : les commandes slash à connaître

Vous pouvez aussi écrire vos propres commandes. Un fichier .toml dans ~/.gemini/commands/ devient une commande slash personnelle, et un fichier dans .gemini/commands/ à l’intérieur d’un projet est partagé avec tous ceux qui utilisent le dépôt. /commands list les affiche.

Étape 9 : checkpointing et retour arrière

Le checkpointing est le filet de sécurité de Gemini CLI, et il est désactivé par défaut. Activez-le dans settings.json :

{
  "general": {
    "checkpointing": { "enabled": true }
  }
}

Dès lors, chaque fois que vous approuvez un outil qui modifie des fichiers, Gemini enregistre d’abord un instantané de votre projet dans un dépôt git fantôme séparé, sous ~/.gemini/history/. Votre propre historique git n’est pas touché. Lancez /restore pour voir la liste des checkpoints, et /restore <id> pour ramener vos fichiers et la conversation à ce point. Gemini vous propose ensuite à nouveau l’appel d’outil d’origine : vous pouvez le relancer, le modifier ou l’ignorer.

Même sans checkpointing, /rewind (ou deux fois Échap) permet de revenir à un prompt précédent et de choisir d’annuler la conversation, les modifications de code ou les deux.

Étape 10 : reprendre des sessions

Gemini CLI enregistre vos sessions par projet :

• gemini --resume latest (ou -r latest) reprend la session la plus récente.
• gemini --list-sessions affiche les sessions enregistrées avec un numéro ; gemini --resume 3 ouvre l’une d’elles.
• Dans une session, /resume permet de parcourir, enregistrer et rouvrir des conversations.

Vous pouvez aussi passer tout de suite un nouveau prompt : gemini -r latest "vérifie les erreurs de type".

Conseils pour de meilleurs résultats

• Commitez avant les grosses tâches. Les checkpoints sont utiles ; un commit git est encore mieux et fonctionne avec tous les outils.
• Dites comment vérifier. « Lance npm test et corrige les échecs » donne de meilleurs résultats que « fais que ça marche ».
• Utilisez le mode plan pour les gros changements. Laissez Gemini explorer et proposer un plan avant de modifier quoi que ce soit.
• Désignez les fichiers avec @. C’est plus rapide que d’attendre que Gemini les trouve, et le contexte reste ciblé.
• Compressez ou effacez entre deux tâches. /compress garde un résumé ; /clear repart de zéro. Les deux économisent des tokens.
• Un agent par worktree. Si vous lancez plusieurs agents, donnez à chacun son propre git worktree pour qu’ils ne s’écrasent pas mutuellement.

Quand un seul terminal ne suffit plus

Gemini CLI est souvent l’un des agents qu’utilise une équipe parmi d’autres. Dès que vous voulez Gemini sur une tâche et Codex ou Claude Code sur une autre, ou un agent qui vérifie le travail d’un autre, un seul terminal devient vite encombré.

AgentVera est une application de bureau pour macOS, Windows et Linux qui exécute Gemini CLI (et d’autres agents CLI) dans de vrais terminaux, côte à côte. Chaque agent Gemini utilise sa propre connexion Google ou sa GEMINI_API_KEY ; le terminal vous demande laquelle au premier lancement. Les détails sont sur la page Gemini CLI dans AgentVera.

• Workspace : une grille d’agents par projet, de 1×1 à 5×4. Chaque agent Gemini démarre avec sa propre session et la retrouve après un redémarrage.
• Permissions par agent : dans la boîte New agent, choisissez Ask, Auto ou Full access.
• Instructions : Gemini CLI n’a pas d’option pour des instructions supplémentaires, donc le champ Role and instructions d’AgentVera ne lui parvient pas. Mettez plutôt vos règles dans GEMINI.md ou AGENTS.md.
• MCP manager : les serveurs configurés dans AgentVera se branchent sur Gemini au lancement, fusionnés par nom avec vos propres réglages Gemini.
• Flows : transmettez le résultat d’un agent au suivant, par exemple Gemini écrit et un autre agent relit.
• Code review : faites relire automatiquement les changements d’un agent à la fin de son tour.
• Worktrees : créez-en un depuis le panneau Git et lancez-y un agent.

La grille, les worktrees, la code review et le MCP manager sont dans l’offre gratuite ; les flows sont dans Pro et Team. Téléchargez AgentVera et essayez-le sur votre propre dépôt. Si vous avez un compte Google gratuit, AgentVera prend aussi en charge Antigravity.

En résumé

Installez Gemini CLI, lancez gemini et choisissez une connexion qui fonctionne toujours après juin 2026 : une clé API payante, Vertex AI ou une licence Code Assist. Lancez /init et gardez votre GEMINI.md court, réglez vos valeurs par défaut avec /settings, et n’ajoutez des serveurs MCP que lorsque vous en avez besoin. Restez dans le mode d’approbation par défaut tant que vous n’avez pas confiance dans votre configuration, activez le checkpointing pour que /restore puisse annuler des modifications, et utilisez --resume latest pour reprendre là où vous en étiez. Pour comparer avec l’agent d’OpenAI, lisez comment utiliser Codex CLI.