Installer Gemini CLI sur Ubuntu 22.04 24.04 26.04 : Guide Node.js npm & Dépannage

Prérequis

Avant de commencer l'installation de l'interface CLI Gemini sur Ubuntu, préparez les éléments suivants :

-[x] Version d'Ubuntu : 20.04 LTS ou plus récente (22.04, 24.04 et 26.04 sont entièrement prises en charge). -[x] Accès administratif : Privilèges sudo pour la gestion des paquets. -[x] Connexion Internet : Requise pour télécharger Node.js, les paquets npm et pour l'authentification. -[x] Compte Google : Nécessaire pour la connexion OAuth afin d'accéder aux modèles Gemini. -[x] Matériel recommandé : Au moins 4 Go de RAM et 2 cœurs de CPU pour des performances fluides durant les sessions interactives.

Connaissances de base supposées : Vous savez ouvrir un terminal et exécuter des commandes apt et bash de base.

Étape 1 : Mettre à jour les paquets système

Commencez par actualiser votre liste de paquets et mettre à niveau les paquets existants pour éviter les conflits de dépendances :

sudo apt update && sudo apt upgrade -y

Cette étape garantit que vous disposez des dernières mises à jour de sécurité et informations des dépôts.

Étape 2 : Installer Node.js 20 ou supérieur

L'interface CLI Gemini nécessite Node.js version 20 ou supérieure. Les dépôts par défaut d'Ubuntu incluent souvent des versions plus anciennes (par exemple, Node 18 sur Ubuntu 24.04).

Méthode recommandée : Dépôt NodeSource

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Alternative : Utilisation de nvm (Node Version Manager)

Pour une gestion plus facile des versions :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20

Vérifiez l'installation :

node --version
npm --version

Vous devriez voir une sortie similaire à v20.x.x pour Node.js et une version npm correspondante.

Étape 3 : Installer l'interface CLI Gemini

Installation globale (recommandée pour un usage quotidien)

npm install -g @google/gemini-cli

Cela rend la commande gemini disponible sur l'ensemble du système.

Test rapide sans installation permanente

Si vous souhaitez l'essayer d'abord :

npx @google/gemini-cli

Installation au niveau utilisateur (évite les problèmes de permissions)

Si vous rencontrez des erreurs de permissions avec l'installation globale :

mkdir -p ~/.local/bin
npm config set prefix '~/.local'
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @google/gemini-cli

Étape 4 : Vérifier l'installation

Vérifiez que l'interface CLI Gemini est correctement installée :

gemini --version

La sortie attendue montre la version actuelle de l'interface CLI Gemini.

Étape 5 : Lancer et s'authentifier

Exécutez l'interface CLI pour la première fois :

gemini

L'outil vous invitera à vous connecter avec Google. Une fenêtre de navigateur s'ouvre automatiquement. Complétez le flux OAuth et retournez au terminal.

Après une authentification réussie, l'interface interactive de l'interface CLI Gemini se charge. Utilisez /help pour voir les commandes disponibles.

Bonnes pratiques : Naviguez vers votre répertoire de projet avant de lancer :

cd ~/my-project
gemini

Problèmes courants & dépannage

'gemini : commande introuvable' : Redémarrez votre terminal ou exécutez source ~/.bashrc. Vérifiez votre PATH avec echo $PATH.
Permission refusée pendant npm install : Utilisez plutôt la méthode d'installation au niveau utilisateur ci-dessus au lieu de sudo npm.
Erreur de version Node.js : Réexécutez l'installation NodeSource ou changez de version avec nvm. Confirmez avec node --version.
Échec de l'authentification : Désactivez les bloqueurs de fenêtres pop-up du navigateur, assurez-vous que les cookies sont activés et réessayez. Videz le cache npm si nécessaire : npm cache clean --force.
Délai d'attente réseau ou erreurs de téléchargement (ex. : ripgrep pré-compilé) : Assurez-vous d'avoir une connexion internet stable. Réessayez l'installation ou utilisez npx comme solution de contournement.
Outils de compilation manquants : Installez les dépendances de développement :

sudo apt install -y build-essential python3

Problèmes spécifiques à WSL : Exécutez les commandes dans un terminal Ubuntu standard plutôt que dans WSL si des erreurs de compilation surviennent.

Pour plus d'aide, consultez le dépôt GitHub officiel : https://github.com/google-gemini/gemini-cli.

Prochaines étapes

Explorez les commandes principales : Tapez /help, /model ou /settings dans l'interface en ligne de commande.
Utilisez dans vos projets : Demandez à Gemini d'expliquer du code, de refactoriser des fonctions ou de générer de nouveaux fichiers à l'aide d'invitations en langage naturel.
Personnalisez : Modifiez les fichiers de configuration dans ~/.config/gemini-cli/ pour les thèmes, modèles par défaut et extensions.
Mettez à jour régulièrement : Exécutez npm update -g @google/gemini-cli pour obtenir les dernières améliorations.
Intégrez des outils : Expérimentez avec les extensions intégrées et les serveurs MCP pour des flux de travail agentiques avancés comme l'intégration git.

Vous êtes maintenant prêt à utiliser Gemini CLI comme un puissant assistant de codage IA directement dans votre terminal Ubuntu. Commencez par des invitations simples dans un dossier de projet et développez progressivement des tâches agentiques plus complexes.

Bon codage avec Gemini !