Gemini CLI vs Claude Code : comparatif honnête 2026

Gemini CLI vs Claude Code, c’est l’agent de terminal de Google face à celui d’Anthropic. Gemini CLI est un agent IA open source (Apache 2.0) qui exécute des modèles Gemini dans votre terminal : il lit et modifie des fichiers, lance des commandes shell, cherche sur le web, se connecte à des serveurs MCP et prend ses instructions de projet dans GEMINI.md. Claude Code fait le même travail avec des modèles Claude et CLAUDE.md. La grande nouvelle n’est pas une fonction : depuis le 18 juin 2026, Gemini CLI ne sert plus les comptes personnels gratuits. Les utilisateurs du niveau gratuit et de Google One ont été déplacés vers Antigravity CLI, et Gemini CLI s’adresse désormais aux clés d’API payantes, à Vertex AI et aux licences professionnelles Code Assist.

Cet article explique ce qu’est Gemini CLI aujourd’hui, comment l’installer et se connecter, comment fonctionnent GEMINI.md, MCP et le sandbox, et comment il se compare à Claude Code. Pas de scores de benchmark : ils changent à chaque nouveau modèle. Pour l’autre grand comparatif, voir Claude Code vs Codex.

Qu’est-ce que Gemini CLI ?

Gemini CLI est l’agent de code en ligne de commande de Google. Vous lancez gemini dans un dossier de projet et vous lui parlez. Des outils intégrés lui permettent de lire et d’écrire des fichiers, de lancer des commandes shell, de récupérer des pages web et de chercher sur Google. Il fonctionne en mode interactif ou sans interface avec -p, donc vous pouvez l’appeler depuis des scripts et la CI.

# interactive
gemini

# one-shot, with JSON output for scripts
gemini -p "summarize the changes in the last commit" --output-format json

# pick a model and add another directory to the context
gemini -m gemini-2.5-flash --include-directories ../shared

Le code source est sur GitHub sous Apache 2.0. Les versions stables sortent chaque semaine, avec des canaux preview et nightly pour ceux qui veulent les changements plus tôt.

Le changement de juin 2026 : Antigravity CLI

Google a annoncé que Gemini CLI est remplacé par Antigravity CLI pour les utilisateurs grand public. D’après le blog développeurs de Google et le README de Gemini CLI :

• À partir du 18 juin 2026, Gemini CLI a cessé de traiter les requêtes des utilisateurs Google AI Pro et Ultra et de Gemini Code Assist for individuals gratuit. Le README le formule ainsi : « Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI. »
• L’accès reste inchangé pour les organisations sur Gemini Code Assist Standard ou Enterprise, pour Code Assist for GitHub via Google Cloud, et pour les clés d’API Gemini payantes.
• Le README précise aussi que Gemini CLI n’a pas été optimisé pour les tout derniers modèles de Google et renvoie vers Antigravity pour ceux-ci.

Antigravity CLI s’exécute sous le nom agy. Il détecte les installations Gemini CLI existantes, lit GEMINI.md et AGENTS.md, conserve les skills d’agent, les hooks et les sous-agents, et convertit les extensions Gemini CLI en plugins Antigravity avec agy plugin import gemini. Google indique qu’il n’y aura pas de parité fonctionnelle un pour un : consultez donc le guide de migration avant de basculer une équipe.

Si vous utilisiez Gemini CLI parce qu’il était gratuit, c’est la partie qui compte. Le reste de cet article s’applique à Gemini CLI avec une clé payante ou une licence professionnelle, et beaucoup s’applique aussi à Antigravity.

Installation

Gemini CLI est un paquet Node.js :

# try it without installing
npx @google/gemini-cli

# install globally
npm install -g @google/gemini-cli

# or with Homebrew
brew install gemini-cli

Les canaux de publication sont des tags npm : @latest (stable, hebdomadaire), @preview (hebdomadaire) et @nightly.

Options d’authentification

Au premier lancement de gemini, il demande comment s’authentifier. Les options documentées :

export GEMINI_API_KEY="your-key"
gemini

Les comptes Workspace et d’organisation nécessitent un projet Google Cloud. La page de quotas de Google a listé des nombres de requêtes quotidiennes par type d’authentification ; certains chiffres datent d’avant le changement de juin, donc vérifiez la page actuelle et votre console Cloud plutôt qu’un chiffre donné dans un article de blog.

GEMINI.md : les instructions du projet

GEMINI.md est la réponse de Gemini CLI à CLAUDE.md. Il se charge par couches :

1. Global : ~/.gemini/GEMINI.md pour les règles que vous voulez partout.
2. Espace de travail : des fichiers GEMINI.md dans les répertoires de votre espace de travail et leurs parents.
3. Au moment voulu : quand un outil touche un chemin, Gemini CLI récupère aussi les fichiers GEMINI.md proches de ce chemin.

Vous pouvez découper un long fichier et importer des morceaux avec @file.md. Dans une session, /memory show affiche le contexte combiné et /memory reload relit les fichiers.

Pour partager un fichier avec d’autres agents, changez le nom de fichier recherché dans ~/.gemini/settings.json ou dans le .gemini/settings.json du projet :

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

Claude Code lit CLAUDE.md et peut importer AGENTS.md avec @AGENTS.md. Avec les deux réglages en place, un seul AGENTS.md pilote les deux agents. Comment écrire CLAUDE.md et AGENTS.md explique quoi y mettre.

MCP dans Gemini CLI

Gemini CLI se connecte aux serveurs MCP déclarés sous mcpServers dans settings.json. Un serveur peut être une commande locale (command, args, env, cwd) ou distant (url pour SSE, httpUrl pour le HTTP streamable).

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
    }
  }
}

Ou ajoutez-en un depuis la ligne de commande :

gemini mcp add -s user -t http docs https://example.com/mcp

-s choisit la portée (project par défaut, ou user) et -t le transport (stdio, sse ou http). Dans une session, /mcp liste les serveurs et leurs outils, et /mcp auth gère OAuth pour les serveurs qui en ont besoin. Côté Claude Code, c’est presque identique : claude mcp add, avec les serveurs de projet dans .mcp.json. Nouveau sur le protocole ? Commencez par ce qu’est un serveur MCP.

Sandbox et validations

C’est là que Gemini CLI est le plus fort. Le sandbox est désactivé par défaut et vous l’activez avec --sandbox (-s), la variable d’environnement GEMINI_SANDBOX, ou "sandbox": true sous tools dans les réglages.

• macOS : Seatbelt (sandbox-exec), avec le profil permissive-open par défaut ; d’autres profils via SEATBELT_PROFILE.
• Conteneurs : Docker ou Podman, avec l’image ghcr.io/google/gemini-cli.
• Autres : un sandbox Windows natif, gVisor (runsc) et LXC (expérimental).

gemini --sandbox
GEMINI_SANDBOX=docker gemini

Les modes de validation sont distincts du sandbox. default demande avant les modifications et les commandes, auto_edit applique les modifications de fichiers sans demander, et plan est en lecture seule. YOLO (tout approuver) n’est disponible qu’en ligne de commande avec --yolo ou --approval-mode=yolo. Activez les points de contrôle dans les réglages et /restore peut ramener les fichiers à un instantané pris avant l’exécution d’un outil.

Claude Code a des modes de permission (demander, accepter les modifications, plan, contournement) et un sandbox optionnel pour son outil Bash. Gemini CLI offre plus de backends de sandbox au choix. Quel que soit votre choix, la règle de sécurité est la même : ne donnez jamais un accès complet à un agent en dehors d’un conteneur ou d’un worktree jetable. La sécurité des agents de code IA détaille les menaces.

Gemini CLI vs Claude Code en un coup d’œil

Quand utiliser lequel

Utilisez Gemini CLI quand :

• Votre entreprise achète déjà Gemini via Google Cloud ou a Code Assist Standard ou Enterprise.
• Vous voulez un vrai backend de sandbox (Docker, gVisor, profils Seatbelt) intégré à l’agent.
• Vous voulez lire ou modifier le code source de l’agent ; il est open source.
• Vous avez besoin de l’ancrage dans Google Search intégré.

Utilisez Claude Code quand :

• Vous avez un abonnement Claude et voulez un agent réglé pour les modèles Claude.
• Vous comptez sur le mode plan, les hooks, les skills ou les sous-agents.
• Vous voulez l’exécuter dans le terminal, une extension d’IDE, l’application de bureau et le web avec la même configuration.

Envisagez Antigravity CLI si vous étiez un utilisateur personnel ou Google One de Gemini CLI. C’est là que Google vous envoie désormais.

Utiliser les deux

Faire tourner deux agents de deux éditeurs est courant, pour les mêmes raisons que pour toute paire : un deuxième avis sur les changements importants, un deuxième quota d’usage quand l’un s’épuise, et le choix du modèle adapté à la tâche. La configuration qui fonctionne :

1. Un seul fichier de règles. Mettez les règles communes dans AGENTS.md, réglez le context.fileName de Gemini pour l’inclure et importez-le depuis CLAUDE.md.
2. Des dossiers séparés. Donnez à chaque agent son propre worktree git et sa branche pour qu’ils ne modifient jamais le même fichier.
3. Une configuration MCP séparée. Chaque outil garde ses propres réglages MCP ; ajoutez les mêmes serveurs aux deux, ou déclarez-les une fois dans AgentVera, qui les transmet aux deux.
4. Un seul relecteur. Laissez un agent relire la branche de l’autre avant de fusionner.

Gemini CLI, Antigravity et Claude Code dans AgentVera

AgentVera est une application de bureau pour macOS, Windows et Linux qui lance des agents de code en terminal dans de vrais terminaux, en grille par projet, avec vos connexions existantes. Gemini CLI, Antigravity CLI et Claude Code figurent tous dans la boîte de dialogue « New agent » ; une CLI non encore installée s’affiche comme Not installed.

Soyons aussi clairs sur les limites. Les serveurs MCP d’AgentVera et son navigateur atteignent bien Gemini CLI : ils s’attachent à chaque lancement et fusionnent par nom avec vos propres mcpServers. Gemini CLI n’a pas d’option pour des instructions supplémentaires, donc le champ « Role and instructions » ne l’atteint pas ; utilisez AGENTS.md ou GEMINI.md. Et Full access ne demande jamais rien : réservez-le aux agents dans un worktree ou un conteneur.

La grille, les worktrees et la revue de code sont dans l’offre gratuite. Téléchargez AgentVera, ouvrez un agent Gemini CLI ou Antigravity à côté de Claude Code dans deux worktrees, et comparez-les sur votre propre dépôt.

La réponse courte

Gemini CLI est un agent de terminal open source capable, avec un large choix de backends de sandbox, mais depuis juin 2026 c’est un outil pour les clés d’API payantes et les clients Google Cloud. Claude Code est le meilleur choix si vous avez un forfait Claude et voulez des hooks, des skills et des sous-agents. Si vous étiez sur le niveau gratuit de Gemini CLI, regardez Antigravity CLI. Et si vous le pouvez, gardez un seul AGENTS.md et lancez deux agents.