Gemini CLI : installation et authentification

Gemini CLI est l'agent de codage de Google dans le terminal : il lit votre dépôt, écrit du code, lance des commandes et appelle des outils. Ce guide vous fait l'installer puis l'authentifier proprement en 2026, en évitant les pièges qui font perdre une heure : la voie de connexion dépend de votre palier depuis la bascule du 18 juin 2026 vers Antigravity, la clé API reste ouverte à tous mais plafonne à 250 requêtes par jour sur Flash, et la version 0.60 refuse de démarrer hors d'un répertoire approuvé. Public visé : développeurs à l'aise avec le terminal et npm. À la fin, gemini répond à un prompt depuis votre machine.

Ce que vous allez apprendre

• Installer Gemini CLI avec npm (et vérifier la version).
• Créer une clé API Gemini et la fournir à la CLI.
• Choisir votre voie de connexion selon votre palier, et contourner le piège Remote-SSH.
• Comprendre les quotas réels et quand activer la facturation.
• Débloquer le refus de démarrage hors répertoire approuvé, apparu en 0.60.

Prérequis

• Node.js 20+ (vérifiez avec node --version). Le prérequis est resté >=20 de la 0.47.0 à la 0.60.0, vérifié sur le paquet npm.
• Un compte Google (pour générer une clé API).
• Optionnel : être à l'aise avec les variables d'environnement.

Étape 1 - Installer Gemini CLI

Trois méthodes selon votre besoin. La plus courante est l'installation globale avec npm.

npm (global)

npm install -g @google/gemini-cli

npx (sans installer)

npx @google/gemini-cli

Homebrew

brew install gemini-cli

Vérifiez ensuite que le binaire répond :

gemini --version

La sortie doit afficher un numéro de version. La stable au 20 septembre 2026 est 0.60.0, publiée le 15 septembre ; la 0.47.0 date du 18 juin. Si la commande n'est pas trouvée, le dossier global npm n'est pas dans votre PATH.

Étape 2 - Quelle voie d'authentification selon votre palier

Gemini CLI propose plusieurs voies, et celle qui vous concerne dépend de votre palier, pas de votre préférence. La documentation de Google énonce ce point à deux endroits distincts, jamais côte à côte, ce qui explique les conseils contradictoires que l'on croise ailleurs, y compris dans des guides récents.

Méthode	État au 20 septembre 2026	Pour qui
Compte Google, palier gratuit ou Google One	remplacé par Antigravity CLI le 18 juin 2026	ne passe plus par Gemini CLI
Compte Google, paliers payants (Code Assist, AI Pro, AI Ultra, Workspace)	voie recommandée par Google	usage individuel et entreprise abonnés
Clé API Gemini (AI Studio)	ouverte à tous, 250 requêtes par jour, Flash uniquement	lab, essai, usage ponctuel
Vertex AI	OK	entreprise sur Google Cloud

Glissez pour voir

La page d'authentification officielle recommande la connexion par compte Google pour la plupart des utilisateurs, tout en affichant en tête l'avis qui en exclut les paliers gratuit et Google One. Les deux affirmations sont exactes et ne portent simplement pas sur les mêmes comptes. Lire l'une sans l'autre conduit à l'erreur, dans un sens comme dans l'autre.

Ce que vous verrez si votre palier a basculé

Sur un compte sans abonnement, lancer gemini et choisir « Login with Google » donne :

Failed to sign in. This client is no longer supported for Gemini Code Assist
for individuals. To continue using Gemini, please migrate to the Antigravity
suite of products.

Le message nomme précisément l'offre concernée, Gemini Code Assist for individuals, c'est-à-dire le palier gratuit. Un abonné AI Pro ou AI Ultra ne rencontre pas ce refus, et la clé API reste ouverte à tous. C'est cette dernière que la suite du guide met en place, parce qu'elle fonctionne quel que soit votre palier.

Étape 3 - Créer une clé API Gemini

1. Ouvrez AI Studio : rendez-vous sur aistudio.google.com/apikey.

2. Créez la clé : cliquez sur « Create API key ». Pour rester sur le free tier, créez-la dans un projet neuf (sans facturation liée).

3. Copiez la clé : elle ressemble à AIzaSy.... Gardez-la secrète, ne la commitez jamais dans Git.

Le free tier est plus serré qu'annoncé

La documentation de Google publie un seul chiffre pour cette voie : 250 requêtes par jour, sur Flash uniquement. Elle ne publie aucune limite par minute, quel que soit le palier.

Cette limite par minute existe pourtant, et le serveur la nomme lui-même quand il refuse : sur une clé gratuite, le 429 renvoyé portait limit: 5, soit 5 requêtes par minute. C'est une valeur observée, pas une règle publiée, et elle peut différer selon le modèle et le moment. La bonne pratique est donc de lire la valeur dans le message d'erreur plutôt que de retenir un chiffre.

Étape 4 - Fournir la clé à la CLI

Deux options. La plus simple pour un test, la variable d'environnement :

export GEMINI_API_KEY="VOTRE_CLE_AIza..."
gemini -p "Réponds uniquement par le mot : pong"

La sortie doit afficher pong. Pour rendre la clé persistante par projet sans l'exporter à chaque session, créez un fichier .gemini/.env à la racine du projet, que la CLI charge automatiquement :

mkdir -p .gemini
printf 'GEMINI_API_KEY=VOTRE_CLE_AIza...\n' > .gemini/.env

Toujours ignorer le secret dans Git

Ajoutez .gemini/.env à votre .gitignore avant tout commit. Une clé API poussée sur un dépôt public est révoquée par Google et exploitée en minutes.

Étape 5 - Premier lancement et validation

Lancez la CLI en mode interactif depuis votre projet :

gemini

Tapez une demande simple, par exemple liste les fichiers de ce dossier. La CLI doit répondre en utilisant ses outils intégrés. Pour un test non-interactif (utile en script), utilisez -p :

gemini -m flash -p "Dis bonjour en une ligne"

-m flash force le modèle Flash (compatible free tier). Sans -m, la CLI choisit un modèle par défaut.

Dépannage

Symptôme	Cause	Solution
command not found: gemini	dossier npm global hors PATH	ajouter le préfixe npm au PATH, ou relancer le shell
Boucle de login Google infinie	callback Remote-SSH injoignable	passer à la clé API (étape 3-4)
no longer supported for Gemini Code Assist for individuals	compte au palier gratuit, basculé vers Antigravity le 18 juin 2026	utiliser une clé API, ou un palier payant
429 ... prepayment credits are depleted	projet en mode payant sans crédit	clé sur un projet free tier, ou activer la facturation
429 ... free_tier_requests, limit: 5	limite par minute, non documentée : le nombre est dans le message	espacer les appels, ou passer en payant
not running in a trusted directory	nouveau en 0.60 : le répertoire n'est pas approuvé	--skip-trust, ou GEMINI_CLI_TRUST_WORKSPACE=true

Glissez pour voir

Piège Remote-SSH

En VS Code Remote-SSH, le login navigateur de Gemini CLI échoue : le callback s'ouvre sur un localhost de la machine distante que votre navigateur local n'atteint pas. La clé API (sans navigateur) règle le problème d'un coup.

Activer la facturation (usage soutenu)

Quand la limite par minute devient bloquante, ajoutez la facturation sur le projet de votre clé (pas un autre) : dans la console Google Cloud, ouvrez ce projet, section Facturation, liez un moyen de paiement. La même clé passe alors en tier payant (débit par requête bien plus élevé), sans la régénérer. Le modèle Flash coûte des centimes ; posez une alerte de budget pour dormir tranquille.

À retenir

• Installez avec npm install -g @google/gemini-cli (Node 20+, inchangé de la 0.47.0 à la 0.60.0).
• La voie de connexion dépend de votre palier. Palier gratuit ou Google One : la CLI a été remplacée par Antigravity le 18 juin 2026. Paliers payants : le compte Google reste la voie recommandée par Google. La clé API fonctionne dans tous les cas.
• Fournissez la clé via GEMINI_API_KEY ou un fichier .gemini/.env (gitignoré).
• La clé gratuite plafonne à 250 requêtes par jour sur Flash, seul chiffre publié. La limite par minute n'est pas documentée : lisez-la dans le 429, qui la nomme.
• Depuis la 0.60, la CLI refuse de démarrer hors d'un répertoire approuvé. En usage non interactif, passez --skip-trust.
• En Remote-SSH, la clé API évite l'échec du callback navigateur.

Prochaines étapes

Prise en main du REPL La suite logique : premier prompt, commandes /, fichiers @ et mode shell !.

Le vibe coding, c'est quoi Le concept derrière les agents de code, et ses garde-fous.

Claude Code : le hub complet Comparer l'approche de l'agent CLI d'Anthropic.

Formation IA complète LLM, RAG, agents, MCP : le parcours de A à Z.

Documentation officielle Gemini CLI Le dépôt et les références à jour de Google.

×

📖 Voir la documentation →