4.1 KiB
Configuration Linux
Prérequis
Tu as besoin de Node.js v18 ou supérieur et de npm.
Étape 1 : installer Node.js
Option A : via la page de téléchargement nodejs.org avec fnm (recommandé)
fnm (Fast Node Manager) est officiellement recommandé par Node.js. Il est rapide, léger, et te permet de changer facilement de version Node si besoin plus tard.
-
Ouvre ton navigateur et va sur nodejs.org/en/download.
-
Tu verras une ligne de menus déroulants indiquant : "Get Node.js® vXX.XX.X (LTS) for __ using __ with __". Règle les menus comme suit :
Menu Sélection Version vXX.XX.X (LTS) — garde la version LTS par défaut, ne la change pas OS Linux Package Manager fnm (dans "Recommended (Official)") Package Format npm — garde la valeur par défaut -
La page affichera les commandes exactes à lancer. Ouvre ton terminal et copie-colle-les. Elles ressembleront à ceci :
# Step 1 — Install fnm curl -fsSL https://fnm.vercel.app/install | bash # Step 2 — Restart your terminal or reload your shell profile source ~/.bashrc # or: source ~/.zshrc (if you use zsh) # Step 3 — Install Node.js fnm install 24 # The page will show the exact version numberLe numéro de version peut différer de celui ci-dessus — utilise toujours ce que le site affiche.
-
Ferme et rouvre ton terminal (ou lance la commande
sourceci-dessus) pour quefnm,nodeetnpmsoient disponibles.
Pourquoi fnm ? Il est dans la catégorie "Recommended (Official)" sur la page de téléchargement Node.js. Comme nvm, il installe Node dans ton répertoire personnel, donc tu n'as jamais besoin de
sudopour les installations npm globales — mais fnm est nettement plus rapide (écrit en Rust) et fonctionne de la même façon sur Windows, macOS et Linux.
Option B : utiliser le gestionnaire de paquets de ta distribution
C'est plus rapide, mais cela peut installer une ancienne version de Node.js. Vérifie la version après installation — si elle est inférieure à v18, utilise plutôt l'option A.
Ubuntu / Debian :
sudo apt update
sudo apt install -y nodejs npm
# Check the version
node --version # Must be v18 or higher
Fedora :
sudo dnf install -y nodejs npm
Arch Linux :
sudo pacman -S nodejs npm
Option C : NodeSource (dernière LTS via apt, sans nvm)
Pour les utilisateurs Ubuntu/Debian qui veulent la dernière LTS sans utiliser nvm :
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
Étape 2 : vérifier Node.js
node --version
npm --version
Les deux doivent afficher des numéros de version. node --version doit afficher v18.x ou supérieur.
Étape 3 : installer Claude Code
npm install -g @anthropic-ai/claude-code
Erreur de permission ?
- Si tu as utilisé fnm ou nvm : cela ne devrait pas arriver. Vérifie qu'il est actif (
which nodedoit pointer vers un chemin dans ton répertoire personnel, pas/usr/...).- Si tu as utilisé une installation système : utilise soit
sudo npm install -g @anthropic-ai/claude-code, soit corrige les permissions du répertoire global npm :mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc
Étape 4 : vérifier Claude Code
claude --version
Tu devrais voir la version de Claude Code s'afficher. Retourne maintenant à README.md pour configurer l'authentification.
Notes
- WSL (Windows Subsystem for Linux) : ce guide fonctionne aussi dans WSL. Suis simplement ces étapes depuis ton terminal WSL.
- Problèmes de PATH : si
claudeest introuvable après installation, assure-toi que le bin global npm est dans ton PATH. Lancenpm config get prefix— le sous-répertoirebin/de ce chemin doit être dans ton PATH.