Installer et configurer Gemini CLI en trente minutes
Gemini CLI, l'agent IA de Google, vit dans le terminal : un écran sombre, des commandes à coller, et aucun moyen de savoir si ce que vous voyez est normal ou le début d'un problème. Si vous n'avez jamais ouvert un terminal, ce n'est pas la difficulté technique qui bloque : c'est d'avancer à l'aveugle, sans savoir ce que votre écran devrait afficher à chaque étape, ni quoi faire quand il affiche autre chose.
Cette masterclass vous donne la méthode en cinq phases pour installer et configurer Gemini CLI en trente minutes : vérifier le moteur, installer l'agent, connecter votre compte Google, vous placer dans le bon dossier, régler le modèle. À chaque phase, vous savez quelle commande lancer, ce que vous devriez voir si tout va bien, et vous n'avancez que lorsque la phase en cours a réussi.
Ce que cet exercice ne peut pas casser
Gemini CLI se connecte avec un simple compte Google : mille requêtes par jour, gratuites, sans carte bancaire. Et la méthode interdit le saut dans le vide : aucune commande ne se lance sans qu'on vous ait expliqué ce qu'elle fait, chaque phase se vérifie avant la suivante, et une commande qui échoue ne casse rien, elle affiche un message que vous lisez avant de corriger.
Ce que vous saurez faire à la fin
- Installer Gemini CLI sur votre machine, Mac, Linux ou Windows, sans rien connaître au terminal.
- Vérifier le résultat de chaque phase avant de passer à la suivante, au lieu de découvrir le problème à la fin.
- Lancer l'agent depuis le bon dossier de projet, et comprendre pourquoi ce dossier change tout.
- Choisir entre les modèles disponibles, ou laisser le mode automatique décider pour vous.
- Niveau membre· le prompt prêt à coller qui vous accompagne pendant toute l'installation : il explique chaque commande avant que vous la tapiez et vous débloque quand l'écran n'affiche pas ce qui était prévu.
- Niveau Pro· on fait l'installation ensemble, en direct sur votre machine, et je débloque chaque phase qui coince.
Une phase à la fois : chacune se vérifie avant la suivante, et la validation finale prouve que l'agent lit vos fichiers.
Cinq phases, et jamais deux à la fois
Une installation rate rarement parce qu'elle est difficile. Elle rate parce qu'on enchaîne les commandes sans vérifier, et qu'au premier écran inattendu on ne sait plus où on en est. La méthode prend le contre-pied : une phase à la fois, un résultat attendu décrit à l'avance, et l'interdiction d'avancer tant que la phase en cours n'a pas réussi. Cinq phases, dans l'ordre, puis une validation qui prouve que tout fonctionne.
1Vérifiez le moteur : Nodedoute : « c'est quoi, ce Node ? »
Gemini CLI a besoin d'un moteur pour tourner : Node. Avant d'installer quoi que ce soit, vous lancez la commande qui affiche sa version, en sachant à l'avance quel numéro prouve que c'est bon. Si Node manque ou est trop ancien, vous l'installez d'abord, avec la commande adaptée à votre système : Mac, Linux ou Windows. Le moteur d'abord, l'agent ensuite.
2Installez l'agentdoute : « et si une erreur apparaît ? »
L'installation de Gemini CLI tient en une commande, suivie d'une seconde qui confirme qu'il est bien là. C'est cette confirmation qui compte : vous ne cochez la phase que lorsque vous l'avez vue. Si une erreur apparaît, ne corrigez rien à l'aveugle : notez le message exact, c'est lui qui dit quoi faire, pas une intuition.
3Connectez votre compte Googledoute : « ça va me coûter quelque chose ? »
Au premier lancement, l'agent vous propose de vous connecter : choisissez la connexion par compte Google, puis vérifiez que la session est bien ouverte. Et respirez : c'est gratuit, mille requêtes par jour, sans carte bancaire. Largement de quoi travailler tous les jours sans jamais sortir un moyen de paiement.
4Placez-vous dans le bon dossierdoute : « quelle importance, le dossier ? »
C'est la phase la plus importante, celle où tout le monde trébuche. L'agent ne voit que le dossier où vous le lancez : lancé au mauvais endroit, il répond dans le vide ; lancé dans votre dossier de projet, il s'appuie sur vos fichiers réels. Avant de relancer l'agent, vous vous placez donc dans votre dossier de projet avec la commande de déplacement. Une habitude de trois secondes qui change tout.
5Réglez le modèle, si besoindoute : « lequel choisir ? »
Gemini CLI propose plusieurs modèles : un rapide et économique, un puissant pour le raisonnement, et un mode automatique qui choisit pour vous. Phase optionnelle : le mode automatique suffit pour débuter. Retenez seulement que le réglage existe, et que vous pourrez changer plus tard si un besoin précis apparaît.
6Validez : faites lire vos fichiersdoute : « comment être sûr que c'est fini ? »
La validation n'est pas un écran de confirmation, c'est une preuve d'usage : une commande finale qui montre que l'agent lit bien les fichiers de votre dossier et comprend votre projet. Si elle réussit, l'installation est réussie : moteur, agent, compte, dossier, tout est en place. Vous le voyez, vous ne le supposez pas.
À vous de jouer : votre feuille de route en cinq phases
Prenez une feuille et votre machine. Trente minutes, une seule règle : on ne passe à la phase suivante que lorsque la précédente a donné le résultat attendu.
Le résultat, en 30 secondes
Avec le prompt, vous ne déroulez plus la feuille seul : une IA vous accompagne phase par phase, toujours dans le même format.
Phase 1 : le moteur. Ce qu'on vérifie : que Node est présent et assez récent pour faire tourner l'agent. La commande, dans un bloc de code, prête à copier. « Ce que vous devriez voir : un numéro de version qui s'affiche. » « Si ça ne marche pas : dites-moi le message exact, et selon votre système je vous donne la commande d'installation. » Et l'agent attend votre confirmation avant de passer à la phase 2.
Le prompt prêt à coller
# RÔLE Tu es un accompagnateur technique spécialisé dans l'installation d'agents IA en terminal, patient et pédagogue, qui s'adresse à une personne qui n'a jamais ouvert un terminal de sa vie. Ton exigence : zéro jargon non expliqué, zéro étape sautée. Tu ne t'appuies QUE sur ce que je te donne. Ce que tu ne sais pas de ma machine ou de mon projet, tu me le demandes, tu ne l'inventes jamais. Si un risque existe (commande destructrice, mauvais dossier), tu m'avertis avant. # CONTEXTE J'installe Gemini CLI, l'agent IA de Google en terminal, sur ma machine. Je veux suivre une méthode en cinq phases : vérifier le moteur (Node), installer l'agent, me connecter à mon compte Google, me placer dans le bon dossier de travail, puis régler le modèle. Je suis grand débutant en ligne de commande. Ma situation (si je la connais) : [collez ici votre système d'exploitation (Mac, Linux, Windows), ce que vous avez déjà installé, votre dossier de projet et son chemin, ce que vous voulez que l'agent fasse en premier. Laissez vide si vous ne savez pas.]
Le prompt vous accompagne pendant toute l'installation : il explique chaque commande avant que vous la tapiez, vous dit ce que l'écran devrait afficher si tout va bien, et passe en mode interview si vous partez de zéro, une question à la fois jusqu'à la validation. Laissez votre email, je vous l'envoie et vous installez ce soir.
Vérifiez que c'est à vous
Gemini CLI est installé, votre compte Google est connecté, mais quand vous demandez à l'agent de parler de votre projet, il affirme ne voir aucun fichier. Quelle est la cause la plus probable ?
D'abord avec vos mots, sans regarder les options :
Expliquez-le pour l'ancrer
Expliquez en une phrase, à un confrère qui n'a jamais ouvert un terminal : pourquoi le dossier depuis lequel on lance l'agent est-il la phase la plus importante de l'installation ? Si vous savez le dire simplement, c'est acquis.
Ce que vous savez faire maintenant
- Installer Gemini CLI en cinq phases vérifiées, du moteur Node à la connexion gratuite par compte Google.
- Lancer l'agent depuis le bon dossier de projet, parce qu'il ne voit que le dossier où on le lance.
- Valider une installation par l'usage : faire lire vos fichiers à l'agent et obtenir une description juste de votre projet.
L'agent ne voit que le dossier où vous le lancez.
Faites-le avec moi
On fait l'installation ensemble, en direct sur votre machine : vous ne restez jamais bloqué devant un message d'erreur, et vous repartez avec Gemini CLI qui lit vos fichiers.