# Gemini CLI vs Claude Code : comparatif honnête 2026

URL: https://agentvera.dev/fr/blog/gemini-cli-vs-claude-code/ · Publié: 2026-10-23

Gemini CLI vs Claude Code : installation, authentification après le changement Antigravity de juin 2026, GEMINI.md, MCP, sandbox, comparatif et usage conjoint.

**En bref:**

- Depuis le 18 juin 2026, Gemini CLI ne sert plus les utilisateurs du niveau gratuit et de Google One, déplacés vers Antigravity CLI (agy).
- Gemini CLI continue de fonctionner avec des clés d’API Gemini payantes, Vertex AI et les licences Gemini Code Assist Standard ou Enterprise, et est open source sous Apache 2.0.
- Ses options de sandbox (Seatbelt, Docker ou Podman, gVisor, LXC) sont sa force, tandis que Claude Code ajoute le mode plan, les hooks, les skills et les sous-agents.

**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](/fr/blog/claude-code-vs-codex/ "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.

```bash
# 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 :

```bash
# 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 :

| Méthode | Ce que vous définissez | État après le 18 juin 2026 |
| --- | --- | --- |
| Sign in with Google | Connexion par navigateur ; une licence Code Assist payante exige aussi `GOOGLE_CLOUD_PROJECT` | Fonctionne pour Code Assist Standard et Enterprise ; les comptes personnels et Google One ont migré vers Antigravity |
| Clé d’API Gemini | `GEMINI_API_KEY` depuis Google AI Studio | Les clés payantes continuent de fonctionner |
| Vertex AI | `GOOGLE_CLOUD_PROJECT` et `GOOGLE_CLOUD_LOCATION`, plus ADC (`gcloud auth application-default login`), un compte de service ou `GOOGLE_API_KEY` | Continue de fonctionner |

```bash
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 :

```json
{
  "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](/fr/blog/claude-md-agents-md/ "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).

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

Ou ajoutez-en un depuis la ligne de commande :

```bash
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](/fr/blog/what-is-mcp-server/ "Qu’est-ce qu’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).

```bash
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](/fr/blog/ai-coding-agent-security/ "Sécurité des agents de code IA") détaille les menaces.

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

| | Gemini CLI | Claude Code |
| --- | --- | --- |
| Éditeur, modèles | Google, modèles Gemini | Anthropic, modèles Claude |
| Code source | Open source, Apache 2.0 | Propriétaire |
| Installation | `npm install -g @google/gemini-cli`, `brew install gemini-cli` | `curl -fsSL https://claude.ai/install.sh \| bash`, Homebrew, WinGet |
| Qui peut l’utiliser maintenant | Clés d’API Gemini payantes, Vertex AI, Code Assist Standard/Enterprise | Forfaits Claude payants ou API Anthropic |
| Fichier d’instructions | `GEMINI.md` (configurable avec `context.fileName`) | `CLAUDE.md` |
| MCP | `mcpServers` dans settings.json, `gemini mcp add` | `.mcp.json`, `claude mcp add` |
| Sandbox | Seatbelt, Docker/Podman, Windows, gVisor, LXC | Sandbox optionnel pour l’outil Bash |
| Modes de validation | `default`, `auto_edit`, `plan`, YOLO par option | Défaut, accepter les modifications, plan, contournement |
| Annuler | Points de contrôle avec `/restore` | Points de contrôle avec rewind |
| Sans interface | `gemini -p`, sortie JSON et stream-JSON | `claude -p`, sortie JSON et stream-JSON |
| Extras | Extensions, recherche web intégrée | Hooks, skills, sous-agents, plugins |

## 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](/fr/agents/gemini-cli/ "Gemini CLI dans AgentVera"), [Antigravity CLI](/fr/agents/antigravity/ "Antigravity dans AgentVera") et [Claude Code](/fr/agents/claude-code/ "Claude Code dans AgentVera") figurent tous dans la boîte de dialogue « New agent » ; une CLI non encore installée s’affiche comme Not installed.

| Besoin | Dans AgentVera |
| --- | --- |
| Connexion | Gemini CLI utilise sa propre connexion Google ou `GEMINI_API_KEY` ; AgentVera ne la remplace pas |
| Choisir un modèle | Laissez vide pour le défaut de Gemini CLI, ou choisissez-en un, transmis avec `--model` |
| Permissions | Ask, Auto ou Full access par agent ; pour Gemini CLI, Auto est `--approval-mode auto_edit` et Full access est `--approval-mode yolo` |
| Conserver les sessions | Chaque agent Gemini démarre avec son propre `--session-id` et rouvre avec `--resume` |
| Vérifier le travail | [Revue de code automatique](/fr/features/code-review/ "Revue de code automatique") à la fin d’un tour |
| Enchaîner les agents | [Flows](/fr/features/flows/ "Flows") : Gemini CLI peut être source ou cible (Pro et Team) |

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](/fr/download/ "Télécharger 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.

## Questions fréquentes

**Qu’est-ce que Gemini CLI ?** Gemini CLI est l’agent IA open source (Apache 2.0) de Google pour le terminal. Il exécute des modèles Gemini, lit et modifie des fichiers, lance des commandes shell, cherche sur le web, se connecte à des serveurs MCP et lit les instructions du projet dans GEMINI.md. On le lance avec la commande `gemini`.

**Gemini CLI est-il toujours gratuit ?** Pas pour les comptes personnels. L’avis de Google indique qu’à partir du 18 juin 2026, les utilisateurs du niveau gratuit et de Google One (y compris Google AI Pro et Ultra) ont été déplacés vers Antigravity CLI. Gemini CLI continue de fonctionner avec des clés d’API Gemini payantes, Vertex AI et les licences Gemini Code Assist Standard ou Enterprise.

**Comment installer Gemini CLI ?** Lancez `npm install -g @google/gemini-cli`, ou essayez-le sans installation avec `npx @google/gemini-cli`. Sur macOS et Linux, il est aussi disponible avec `brew install gemini-cli`. Lancez ensuite `gemini` et choisissez comment vous connecter.

**Gemini CLI lit-il CLAUDE.md ou AGENTS.md ?** Par défaut, il lit GEMINI.md. Vous pouvez lui faire lire d’autres fichiers avec le réglage `context.fileName` de settings.json, par exemple `["AGENTS.md", "GEMINI.md"]` : un seul AGENTS.md peut ainsi servir Gemini CLI, Claude Code et d’autres agents.

**Faut-il utiliser Gemini CLI ou Claude Code ?** Si votre organisation paie déjà Gemini via Google Cloud, Gemini CLI s’intègre bien et ses options de sandbox sont solides. Si vous avez un abonnement Claude et voulez le mode plan, les hooks, les skills et les sous-agents, Claude Code convient mieux. Beaucoup d’équipes utilisent les deux et laissent l’un relire l’autre.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/