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 : le login Google gratuit a été coupé sur la CLI, la bonne méthode passe désormais par une clé API, et le free tier est plus limité qu'annoncé. 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.
• Contourner le login Google déprécié et le piège Remote-SSH.
• Comprendre les quotas du free tier et quand activer la facturation.

Prérequis

• Node.js 20+ (vérifiez avec node --version). Gemini CLI 0.47 exige au moins la version 20.0.0.
• 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 (au moment d'écrire ces lignes, 0.47.0). Si la commande n'est pas trouvée, le dossier global npm n'est pas dans votre PATH.

Étape 2 - Comprendre les méthodes d'authentification

Gemini CLI propose trois voies, mais toutes ne se valent pas en 2026.

Méthode	État 2026	Pour qui
Login compte Google (Code Assist individuel)	déprécié sur la CLI	à éviter ici
Clé API Gemini (AI Studio)	recommandé	usage individuel, lab
Vertex AI	OK	entreprise sur Google Cloud

Glissez pour voir

Le login Google gratuit ne marche plus sur la CLI

Si vous lancez gemini et choisissez « Login with Google », vous tombez sur :

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.

Google a retiré ce mode de connexion pour les particuliers sur la CLI et pousse vers son nouvel IDE Antigravity. La clé API reste la voie fiable pour Gemini CLI : c'est celle qu'on utilise ci-dessous.

É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é

Le free tier sert le modèle gemini-3.5-flash mais avec une limite basse : nous avons observé un plafond de 5 requêtes par minute (limit: 5) plus un quota journalier. Suffisant pour découvrir ; vite atteint dès qu'un agent enchaîne les appels. Pour un usage soutenu, voyez l'étape facturation plus bas.

É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	mode Code Assist déprécié + callback Remote-SSH injoignable	passer à la clé API (étape 3-4)
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	plafond 5 req/min du free tier	espacer les appels, ou passer en payant

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 le 5 req/min devient bloquant, 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+).
• Le login Google gratuit est déprécié sur la CLI : utilisez une clé API.
• Fournissez la clé via GEMINI_API_KEY ou un fichier .gemini/.env (gitignoré).
• Le free tier est limité à 5 req/min sur gemini-3.5-flash ; activez la facturation du projet pour un usage soutenu.
• En Remote-SSH, la clé API évite l'échec du callback navigateur.

Prochaines étapes

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 →