# Gemini CLI

Agent en terminal. Fiche relevée le 3 octobre 2026 sur les pages officielles. Page : https://quelleia.com/outils/gemini-cli/

## En bref

Gemini CLI est l'agent open source de Google qui travaille dans le terminal avec les modèles Gemini. Il lit et modifie le code, lance des commandes et cherche sur le web par Google Search. Depuis le 18 juin 2026, il ne sert plus les comptes gratuits ni les abonnés Google AI Pro et Ultra, que Google renvoie vers Antigravity CLI. Il reste utilisable avec une clé d'API payante ou une licence Gemini Code Assist Standard ou Enterprise prise par une organisation.

- Éditeur : Google
- Prix : gratuit, à l'usage
- Licence : open source (Apache-2.0)
- Systèmes : macOS, Windows, Linux, navigateur
- Formes : ligne de commande, extension d'éditeur, serveur ou conteneur
- Site officiel : https://geminicli.com

## Installer

### Tous systèmes (Node.js 20 ou plus)

```
npm install -g @google/gemini-cli
```

### macOS, Linux (Homebrew)

```
brew install gemini-cli
```
La formule Homebrew est marquée obsolète depuis le 18 juin 2026. Elle reste en version 0.46.0 quand npm en est à 0.62.0, et sa désactivation est prévue le 18 décembre 2026.

### macOS (MacPorts)

```
sudo port install gemini-cli
```

### Anaconda (environnements restreints)

```
conda create -y -n gemini_env -c conda-forge nodejs
```
```
conda activate gemini_env
```
```
npm install -g @google/gemini-cli
```

### Tous systèmes, sans installation (npx)

```
npx @google/gemini-cli
```

### Docker ou Podman (bac à sable)

```
docker run --rm -it us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.42.0-nightly.20260428.g59b2dea0e
```

### Google Cloud Shell et Cloud Workstations

Gemini CLI y est préinstallé.

### Démarrer

Créer une clé d'API dans Google AI Studio et la placer dans la variable `GEMINI_API_KEY` (sous Windows PowerShell : `$env:GEMINI_API_KEY="YOUR_GEMINI_API_KEY"`). Lancer ensuite `gemini` dans le dossier du projet. La connexion par compte Google reste proposée au démarrage, mais depuis le 18 juin 2026 elle ne fonctionne plus qu'avec une licence Gemini Code Assist d'organisation.
```
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
```
```
gemini
```

### Choisir le modèle

La commande `/model` propose un mode Auto, où l'outil choisit entre un modèle Pro et un modèle Flash selon la tâche, ou un choix manuel. L'option `--model` fixe le modèle au lancement. Ce choix ne s'applique pas aux sous-agents.
```
/model
```

Source : https://geminicli.com/docs/get-started/installation/ (lue le 3 octobre 2026).

## Ce qu'il sait faire

- **Fichiers GEMINI.md** : Des fichiers de consignes, globaux ou par projet, donnent au modèle le contexte et les règles du projet. (https://geminicli.com/docs/cli/gemini-md.md)
- **Plan Mode** : Ce mode en lecture seule sert à explorer le projet et à arrêter un plan avant de toucher au code. (https://geminicli.com/docs/cli/plan-mode.md)
- **Points de restauration** : Avant chaque écriture de fichier par l'agent, l'outil prend un instantané du projet : on peut ainsi revenir en arrière. (https://geminicli.com/docs/cli/checkpointing.md)
- **Sous-agents** : Des agents spécialisés, lancés par l'agent principal, traitent une tâche précise (analyse de code, recherche de documentation) sans encombrer son contexte. (https://geminicli.com/docs/core/subagents.md)
- **Serveurs MCP** : Des serveurs MCP ajoutent des outils et des sources de données externes. MCP est le protocole standard qui sert à les brancher à un agent. (https://geminicli.com/docs/tools/mcp-server.md)
- **Extensions, skills et hooks** : Une extension regroupe dans un paquet à partager des consignes, des serveurs MCP, des commandes, des hooks, des sous-agents et des skills (procédures réutilisables). Les hooks lancent des scripts à des moments précis de la boucle de l'agent. (https://geminicli.com/docs/extensions.md)
- **Recherche Google** : L'outil `google_web_search` cherche sur le web des informations récentes ou une documentation que le modèle ne connaît pas. (https://geminicli.com/docs/tools/web-search.md)
- **Mode sans interface** : Avec `-p`, ou hors d'un terminal interactif, Gemini CLI rend du texte ou du JSON, pour les scripts et l'automatisation. (https://geminicli.com/docs/cli/headless.md)

Les façons de l'utiliser :

- Ligne de commande : commande `gemini`, paquet npm « @google/gemini-cli » (https://geminicli.com/docs/get-started/installation/)
- Extension d'éditeur : extension compagnon « Gemini CLI Companion » pour VS Code et les éditeurs compatibles ; agent ACP (le protocole qui relie un agent à un éditeur) pour JetBrains et Zed (https://geminicli.com/docs/ide-integration/)
- Serveur ou conteneur : image de conteneur officielle (bac à sable) pour Docker ou Podman (https://geminicli.com/docs/get-started/installation/)

Systèmes :

- macOS : macOS 15 ou plus (configuration recommandée)
- Windows : Windows 11 24H2 ou plus, en natif sous PowerShell
- Linux : Ubuntu 20.04 ou plus (configuration recommandée)
- Navigateur : préinstallé dans Google Cloud Shell

## Sur téléphone

Au 3 octobre 2026, l'éditeur ne documente ni application mobile ni pilotage depuis un téléphone.

## Prix et licence

Le logiciel est gratuit et open source. Depuis le 18 juin 2026, l'usage gratuit et les abonnements Google AI Pro et Ultra n'y donnent plus accès ; Google les oriente vers Antigravity CLI. Restent la clé d'API payante, facturée à l'usage (Gemini API ou Gemini Enterprise Agent Platform), et les licences Gemini Code Assist Standard ou Enterprise prises par une organisation. (relevé le 3 octobre 2026, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli)

Licence : Open source, licence Apache-2.0. (https://github.com/google-gemini/gemini-cli/blob/main/LICENSE)

## Modèles

Officiellement, seulement les modèles Gemini de Google. La documentation décrit trois voies d'accès : une clé Gemini API créée dans Google AI Studio, Vertex AI ou la connexion Google avec une licence Gemini Code Assist. Vertex AI passe par des identifiants Google Cloud, un compte de service ou une clé Google Cloud. En option expérimentale, un petit modèle Gemma 3 de 1 milliard de paramètres, lancé en local, peut aiguiller les requêtes entre Flash et Pro. Il ne remplace pas le modèle principal.

- Clé d'API personnelle : oui
- Modèles locaux : non établi
- Proposés par Gemini CLI (relevé du 5 octobre 2026) : [Gemini 3 Pro](https://quelleia.com/modeles/gemini-3-pro/), [Gemini 3 Flash](https://quelleia.com/modeles/gemini-3-flash/)

## Résultats mesurés

Comparaison avec les autres outils : https://quelleia.com/outils/harnais/

- Terminal-Bench 2.0 · Gemini 3.1 Pro : 59,4 % (3e sur 3 outils)
- Terminal-Bench 2.0 · Gemini 3 Flash : 47,4 % (3e sur 3 outils)
- Terminal-Bench 2.0 · Gemini 2.5 Pro (Jun 2025) : 19,6 % (3e sur 4 outils)
- Terminal-Bench 2.0 · Gemini 2.5 Flash (Jun 2025) : 15,4 % (4e sur 4 outils)
- Terminal-Bench 2.0 · Gemini 2.5 Flash (Sep 2025) : 15,4 % (4e sur 4 outils)
- WeirdML v3 · Gemini 3.8 Flash : 7,4 %

## Sources

- https://geminicli.com/docs/get-started.md
- https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli
- https://geminicli.com/plans/
- https://geminicli.com/docs/get-started/installation/
- https://www.npmjs.com/package/@google/gemini-cli
- https://formulae.brew.sh/formula/gemini-cli
- https://ports.macports.org/port/gemini-cli/
- https://marketplace.visualstudio.com/items?itemName=google.gemini-cli-vscode-ide-companion
- https://geminicli.com/docs/get-started/authentication.md
- https://geminicli.com/docs/cli/model.md
- https://geminicli.com/docs/cli/gemini-md.md
- https://geminicli.com/docs/cli/plan-mode.md
- https://geminicli.com/docs/cli/checkpointing.md
- https://geminicli.com/docs/core/subagents.md
- https://geminicli.com/docs/tools/mcp-server.md
- https://geminicli.com/docs/extensions.md
- https://geminicli.com/docs/tools/web-search.md
- https://geminicli.com/docs/cli/headless.md
- https://github.com/google-gemini/gemini-cli
- https://github.com/google-gemini/gemini-cli/blob/main/LICENSE
- https://geminicli.com/docs/ide-integration/

Non vérifié :

- Aucune application mobile ni aucun pilotage à distance n'est documenté.
- Aucune page de Gemini CLI ne précise le pays de l'éditeur.
- Nous n'avons pas relevé les tarifs de la Gemini API, de Vertex AI et des licences Gemini Code Assist sur les pages de Google.
- La page « Quotas and pricing » de la documentation décrit encore l'offre gratuite et Google AI Pro et Ultra. Elle n'est pas à jour : la page Plans et l'annonce de Google font foi.
- Le lien entre « Gemini Enterprise Agent Platform », citée dans l'annonce de Google, et Vertex AI, citée dans la documentation de l'outil, n'est pas établi.
- La page de `/model` cite encore Gemini 3 en préversion et Gemini 2.5 comme choix Auto.
