Node.js et npm sont vérifiés depuis le guide précédent. Il ne reste plus qu'une commande à taper pour installer Gemini CLI, mais il vaut la peine de comprendre ce qu'elle fait exactement avant de l'exécuter.

Installation globale, ou essai temporaire avec npx

npm propose deux façons d'utiliser un paquet comme Gemini CLI. Une installation globale place la commande gemini à disposition dans n'importe quel terminal que vous ouvrirez ensuite sur cet ordinateur, quel que soit le dossier courant. C'est la méthode recommandée pour un usage régulier, celle que ce guide vous fait suivre.

Il existe une alternative, npx, qui télécharge et exécute temporairement un paquet sans l'installer durablement. Elle est utile pour un test ponctuel, mais elle retélécharge l'outil à chaque nouvelle utilisation et ne conserve rien entre les sessions : ce n'est pas la méthode adaptée pour suivre le reste de ce parcours.

La commande d'installation

Ouvrez un terminal, peu importe le dossier courant pour cette étape précise : une installation globale ne dépend pas de l'endroit où vous vous trouvez.

L'option -g signifie « global » : c'est elle qui déclenche une installation disponible partout, plutôt qu'un paquet limité à un seul projet. @google/gemini-cli est le nom exact du paquet officiel publié par Google ; c'est ce nom précis qu'il faut utiliser, sans le modifier.

N'utilisez pas sudo sous Windows

Certains tutoriels destinés à macOS ou Linux ajoutent sudo avant une commande npm globale, pour obtenir des droits d'administrateur temporaires. Cette pratique n'a pas d'équivalent direct sous Windows et n'est pas nécessaire ici : PowerShell dans un compte utilisateur standard suffit largement pour cette installation. Si une erreur de permission apparaît malgré tout, essayez d'ouvrir votre terminal en tant qu'administrateur plutôt que de chercher un équivalent de sudo.

Vérifier que l'installation a fonctionné

Une fois l'installation terminée, vérifiez la présence de la commande, exactement comme vous l'avez fait pour Git ou pour Node.js.

Un numéro de version qui s'affiche confirme que Gemini CLI est correctement installé et accessible. Le vôtre sera probablement différent, l'outil étant mis à jour régulièrement.

Si la commande gemini reste introuvable

Comme pour toute nouvelle installation de commande, fermez et rouvrez complètement votre terminal avant de conclure à un problème : c'est la cause la plus fréquente. Si le message persiste après cela, vérifiez à nouveau que npm --version répond correctement : une installation globale npm dépend directement d'une installation Node.js fonctionnelle, revue au guide précédent.

Une autre cause possible, plus rare, concerne le dossier où npm installe ses paquets globaux, qui peut ne pas être inclus dans le PATH de votre système sur certaines configurations personnalisées. Si le problème persiste malgré un terminal fraîchement rouvert, réinstaller Node.js depuis nodejs.org avec les réglages par défaut résout la grande majorité de ces cas.

Ce qui vous attend

Gemini CLI est installé, mais vous ne l'avez pas encore lancé une seule fois : la commande gemini --version ne fait que vérifier sa présence, sans ouvrir de session. Le prochain guide vous fait lancer Gemini CLI pour de vrai, et choisir une méthode de connexion adaptée à votre compte.

Vérifiez que vous avez compris

Vous avez lancé npm install -g @google/gemini-cli dans votre dossier Téléchargements. Une fois l'installation terminée, devrez-vous rester dans ce dossier précis pour utiliser la commande gemini plus tard ?

Non. Une installation globale, grâce à l'option -g, rend la commande disponible depuis n'importe quel dossier courant, sur n'importe quel terminal ouvert ensuite sur cet ordinateur. Le dossier depuis lequel vous avez lancé l'installation n'a aucune importance particulière.

Chapitre terminé