Avant d'installer Gemini CLI, il faut installer un logiciel dont il dépend : Node.js. Ce guide explique pourquoi, sans vous faire encore installer Gemini CLI lui-même, ce sera l'objet du prochain guide.

Ce qu'est Node.js, en une phrase utile

JavaScript est un langage de programmation créé au départ uniquement pour fonctionner dans un navigateur web. Node.js permet d'exécuter ce même langage en dehors d'un navigateur, directement sur votre ordinateur, depuis un terminal. C'est ce qui rend possible des outils comme Gemini CLI : ils sont écrits en JavaScript, et Node.js est le moteur qui les fait tourner sur votre machine.

npm arrive installé automatiquement avec Node.js. C'est un gestionnaire de paquets : un outil qui télécharge et installe des programmes ou des bibliothèques écrits par d'autres personnes, à partir d'un simple nom. C'est avec npm que vous installerez Gemini CLI au prochain guide.

Vérifiez d'abord si Node.js est déjà installé

Il est possible que Node.js soit déjà présent sur votre ordinateur, par exemple si vous avez déjà suivi un autre tutoriel de développement. Ouvrez un terminal, comme appris au guide précédent, et tapez :

Si un numéro de version s'affiche, Node.js est déjà installé. Passez au paragraphe suivant pour vérifier qu'il s'agit d'une version suffisamment récente. Si le terminal répond que la commande est introuvable, passez directement à l'installation.

Quelle version est nécessaire

Gemini CLI a besoin d'une version relativement récente de Node.js pour fonctionner correctement. La documentation officielle du projet recommande Node.js 20 ou une version plus récente. Si votre commande affiche un numéro qui commence par un chiffre inférieur à 20, comme v16 ou v18, mieux vaut mettre à jour Node.js avant de continuer, pour éviter des erreurs difficiles à diagnostiquer plus tard.

Installer Node.js

Téléchargez Node.js uniquement depuis son site officiel, nodejs.org. Le site propose en général deux versions en avant : une version « LTS » (Long Term Support, support à long terme), plus stable et recommandée pour la plupart des usages, et une version plus récente avec les toutes dernières fonctionnalités. Pour ce parcours, choisissez la version LTS : elle est amplement suffisante et plus stable dans la durée.

Sous Windows et macOS, l'installateur téléchargé se lance comme n'importe quel autre programme, avec des écrans à valider les uns après les autres, sans réglage particulier à changer. Sous Linux, la méthode dépend de votre distribution ; le site officiel de Node.js documente les commandes adaptées à chacune, généralement via un gestionnaire de versions ou le gestionnaire de paquets du système.

Vérifier après l'installation

Une fois l'installation terminée, fermez complètement votre terminal et rouvrez-en un nouveau. C'est une étape qu'on oublie facilement, mais elle est nécessaire : un terminal déjà ouvert avant l'installation ne sait pas encore que la commande node existe désormais. Vérifiez ensuite les deux commandes suivantes.

Les numéros exacts affichés chez vous seront probablement différents, selon la version téléchargée au moment où vous suivez ce guide. Ce qui compte, c'est que les deux commandes répondent sans erreur : cela confirme que Node.js et npm sont tous les deux correctement installés et accessibles depuis votre terminal.

Si la commande n'est pas reconnue

Un message comme « node n'est pas reconnu en tant que commande » ou « command not found: node » signifie presque toujours que le terminal a été ouvert avant l'installation, ou que celle-ci ne s'est pas terminée correctement. Fermez et rouvrez le terminal une nouvelle fois. Si le problème persiste, relancez l'installateur téléchargé depuis nodejs.org.

Cette installation n'affecte pas votre navigateur

Une confusion possible : Node.js n'a rien à voir avec le JavaScript qui s'exécute déjà dans votre navigateur web quand vous visitez un site. Ce sont deux exécutions séparées du même langage, l'une gérée par votre navigateur pour afficher des pages web, l'autre gérée par Node.js pour exécuter des outils en ligne de commande comme Gemini CLI. Installer Node.js ne change rien à votre façon de naviguer sur Internet.

Vérifiez que vous avez compris

Vous avez installé Node.js, mais vous continuez à utiliser la même fenêtre de terminal qui était déjà ouverte avant l'installation. La commande node --version a de bonnes chances d'échouer : pourquoi ?

Parce qu'un terminal déjà ouvert au moment de l'installation ne recharge pas automatiquement la liste des commandes disponibles sur votre système. Il faut fermer cette fenêtre et en ouvrir une nouvelle pour que la commande node soit reconnue.

Chapitre terminé