Gemini CLI

En bref : Gemini CLI est l’agent IA open source de Google pour le terminal. Il lit et modifie votre code, lance des commandes, cherche sur le web avec Google Search et se branche à des serveurs MCP. Il est gratuit sous licence Apache 2.0. Connecté avec un compte Google personnel, il donne droit à 1 000 requêtes par jour sans payer, d’après la documentation officielle.

À prendre si

• vous travaillez dans le terminal et voulez un agent de code gratuit pour commencer ;
• vous avez déjà un compte Google, un abonnement Google AI Pro ou Ultra, ou une licence Gemini Code Assist ;
• vous voulez un outil open source que vous pouvez lire et adapter ;
• vous automatisez des tâches dans des scripts ou dans GitHub Actions.

À laisser si

• vous voulez choisir des modèles d’autres éditeurs que Google ;
• vous préférez une interface graphique à la ligne de commande ;
• votre compte Google est géré par une organisation qui bloque Gemini Code Assist pour les particuliers.

Qu’est-ce que Gemini CLI ?

Le dépôt GitHub officiel présente Gemini CLI comme un agent IA open source qui amène Gemini directement dans le terminal, avec le chemin le plus court entre votre demande et le modèle. Vous lancez la commande gemini dans un dossier de projet, vous décrivez ce que vous voulez, et l’agent lit les fichiers, propose des modifications, exécute des commandes et vous montre chaque action.

C’est l’équivalent chez Google de Claude Code ou de Codex, avec une différence nette : le logiciel est entièrement open source et un compte Google suffit pour obtenir un quota quotidien gratuit. Gemini CLI est aussi préinstallé dans Cloud Shell et Cloud Workstations de Google Cloud.

Fonctionnalités clés

• Comprendre et écrire du code : interroger et modifier de grosses bases de code, générer une application à partir d’un PDF, d’une image ou d’un croquis, déboguer en langage naturel.
• Outils intégrés : opérations sur les fichiers, commandes shell, récupération de pages web et recherche Google pour des informations à jour.
• MCP : des serveurs MCP déclarés dans ~/.gemini/settings.json ajoutent des outils, par exemple GitHub, Slack, une base de données ou la génération de médias avec Imagen, Veo ou Lyria.
• Fichiers GEMINI.md : un contexte persistant pour adapter le comportement de l’agent à chaque projet.
• Points de sauvegarde : une fois activés, la commande /restore remet les fichiers et la conversation dans l’état d’avant une modification.
• Mode non interactif : gemini -p pour les scripts, avec une sortie JSON ou un flux d’événements JSON pour suivre les longues tâches.
• Extensions et commandes personnalisées pour partager vos propres commandes réutilisables.
• GitHub Action : revue automatique des pull requests, tri des issues et réponses à la mention @gemini-cli.

Intégration à l’éditeur

La documentation décrit deux voies. L’extension « Gemini CLI Companion » pour VS Code et les éditeurs compatibles donne à l’agent les 10 fichiers récemment ouverts, la position du curseur et le texte sélectionné (jusqu’à 16 Ko). Elle affiche aussi les modifications proposées dans le comparateur natif de l’éditeur, où vous les acceptez ou les refusez. La seconde voie passe par l’Agent Client Protocol (ACP), utilisé pour les intégrations avec JetBrains et Zed. Dans le terminal, la commande /ide install installe l’extension, puis /ide enable active la connexion.

Sécurité : bac à sable et dossiers de confiance

Selon le guide officiel du bac à sable, l’isolation sépare les opérations à risque, comme les commandes shell ou les modifications de fichiers, du reste de votre système. Elle s’active avec l’option -s, la variable GEMINI_SANDBOX ou le fichier de réglages. Sur macOS, Gemini CLI utilise Seatbelt avec plusieurs profils, du plus permissif au plus strict. Sur toutes les plateformes, il peut tourner dans un conteneur Docker ou Podman qui ne voit que le dossier du projet.

La fonction Trusted Folders, désactivée par défaut, demande d’approuver un dossier avant de charger sa configuration. Dans un dossier non approuvé, Gemini CLI ignore les réglages et les fichiers .env du projet, ne connecte pas les serveurs MCP et demande une validation avant chaque outil.

Forces

• Logiciel gratuit et open source sous Apache 2.0.
• Quota gratuit généreux avec un simple compte Google : 1 000 requêtes par jour.
• Fenêtre de contexte de 1 million de tokens avec Gemini 3, utile pour les gros dépôts.
• Recherche Google intégrée pour ancrer les réponses dans des informations récentes.
• Versions stables chaque semaine, plus des canaux preview et nightly pour tester les nouveautés.

Limites

• Seuls les modèles Gemini sont pris en charge.
• Avec une clé API gratuite, le quota tombe à 250 requêtes par jour, sur le modèle Flash uniquement.
• Les requêtes sont aussi limitées par minute et dépendent de la disponibilité du service en cas de forte demande.
• Google AI Plus et les forfaits Workspace AI Standard, Plus et Expanded ne donnent pas de quota supplémentaire.
• Utiliser l’accès OAuth de Gemini CLI depuis un outil tiers enfreint les conditions de Google et peut entraîner la suspension du compte.

Prix

Le logiciel est gratuit. La page officielle sur les quotas et les prix détaille les limites par mode de connexion :

• Compte Google personnel (Gemini Code Assist pour les particuliers) : 1 000 requêtes par jour et par utilisateur, sur la famille Gemini choisie par l’outil.
• Google AI Pro : 1 500 requêtes par jour. Google AI Ultra : 2 000 requêtes par jour.
• Clé API Gemini gratuite : 250 requêtes par jour, modèle Flash uniquement. En formule payante, le quota et le coût dépendent du palier, du modèle et des tokens.
• Vertex AI : mode Express gratuit pendant 90 jours avant d’activer la facturation, puis paiement à l’usage.
• Google Workspace : Code Assist Standard à 1 500 requêtes par jour, Code Assist Enterprise et Workspace AI Ultra à 2 000.

La documentation recommande le paiement à l’usage avec une clé API ou Vertex AI pour ne jamais être bloqué par une limite quotidienne. La commande /stats model affiche votre consommation et vos limites.

France et données

Gemini CLI demande d’être dans une région où Gemini Code Assist est disponible, et une connexion internet. D’après la page sur les conditions et la confidentialité, ce sont les conditions du service utilisé qui s’appliquent : Gemini Code Assist pour un compte Google, l’API Gemini gratuite ou payante pour une clé API, Google Cloud pour Vertex AI. Les statistiques d’usage suivent la politique de confidentialité de Google. Les points de sauvegarde, eux, restent sur votre machine.

Comment installer Gemini CLI

1. Vérifiez les prérequis : Node.js 20 ou plus récent, avec Bash, Zsh ou PowerShell.
2. Installez Gemini CLI avec npm, Homebrew ou MacPorts (commandes ci-dessous), ou lancez-le sans installation avec npx.
3. Placez-vous dans le dossier de votre projet et tapez gemini.
4. Choisissez Sign in with Google et terminez la connexion dans le navigateur, ou définissez une clé API Gemini.
5. Décrivez votre première tâche, par exemple un résumé de l’architecture du code.

npm install -g @google/gemini-cli

Homebrew (macOS et Linux) :

brew install gemini-cli

Sans installation :

npx @google/gemini-cli

Avec une clé API :

export GEMINI_API_KEY="YOUR_API_KEY"
gemini

Le guide d’installation officiel détaille aussi l’installation avec Anaconda et l’exécution dans un conteneur.

Gemini CLI face aux autres agents

Face à Claude Code et Codex, Gemini CLI se distingue par son quota gratuit et son code ouvert. Kilo Code et OpenCode laissent choisir parmi des centaines de modèles, quand Gemini CLI reste centré sur Gemini. Pour piloter un agent de terminal depuis le téléphone, Codync reconnaît Gemini parmi ses agents, et Happy fait de même pour Claude, Codex et Grok. Pour des agents généralistes qui travaillent hors du code, voyez Grok Bot ou Browser Use.

Questions

Gemini CLI est-il gratuit ? Oui. Le logiciel est gratuit sous Apache 2.0, et un compte Google personnel donne 1 000 requêtes par jour sans frais.

Faut-il une clé API ? Non. La connexion avec un compte Google suffit. Une clé API Gemini ou Vertex AI sert à choisir précisément le modèle ou à payer à l’usage.

Quelle différence entre le compte Google et la clé API gratuite ? Le compte Google donne 1 000 requêtes par jour sur la famille Gemini. La clé API gratuite donne 250 requêtes par jour, sur Flash uniquement.

Mon abonnement Google AI Pro augmente-t-il le quota ? Oui. Google AI Pro passe à 1 500 requêtes par jour et Google AI Ultra à 2 000. Google AI Plus n’est pas pris en charge.

Gemini CLI fonctionne-t-il sous Windows ? Oui, sur Windows 11 24H2 ou plus récent, avec PowerShell.

Peut-on l’utiliser dans un script ? Oui. L’option -p lance une demande sans interface, avec une sortie texte, JSON ou en flux d’événements.

Comment annuler une modification de l’agent ? Activez les points de sauvegarde dans settings.json, puis utilisez /restore pour revenir à l’état d’avant la modification.