Claude Code est l’agent de développement d’Anthropic qui vit dans votre terminal. Il lit votre projet, modifie les fichiers, exécute des commandes et vous fait gagner un temps fou. Mais avant de pouvoir l’utiliser, il faut l’installer. Et même si la procédure est simple, quelques détails peuvent bloquer un débutant.
J’ai installé Claude Code sur Windows, Mac et Linux. Ce guide reprend exactement les étapes que je suis à chaque fois, plus les solutions aux erreurs les plus fréquentes. Comptez 10 à 15 minutes du début à la fin, premier projet inclus.
Si vous voulez d’abord comprendre ce qu’est Claude Code et ce qu’il peut faire avant de l’installer, allez voir le guide complet Claude Code. Sinon, on commence.
Prérequis : ce qu’il faut avant d’installer
Claude Code a besoin de deux choses pour fonctionner : un environnement Node.js récent et un compte Anthropic. Rien d’autre.
Node.js version 18 ou plus
Claude Code s’installe via npm, le gestionnaire de paquets de Node.js. Vous avez besoin de Node.js 18 minimum, idéalement la version 20 ou 22 (LTS).
Pour vérifier si Node est déjà installé sur votre machine, ouvrez un terminal et tapez :
node --versionSi vous voyez quelque chose comme v20.x.x, vous êtes prêt. Si vous voyez « command not found » ou une version antérieure à 18, il faut installer (ou mettre à jour) Node.js. Téléchargez la version LTS sur nodejs.org et suivez l’installateur. Cinq minutes.
Un compte Anthropic actif
Claude Code n’a pas de version gratuite à proprement parler. Vous avez besoin d’un compte avec accès à Claude :
- Claude Pro (20$/mois) : option recommandée pour démarrer. Quota suffisant pour la plupart des projets.
- Claude Max (100 ou 200$/mois) : pour usage intensif, multiplie le quota par 5 ou 20.
- Clé API Anthropic : alternative en pay-as-you-go, vous payez les tokens consommés.
Si vous n’avez pas encore de compte, créez-en un sur claude.ai. Vous pourrez vous authentifier directement depuis Claude Code lors de la première utilisation.
Un terminal qui marche
Claude Code est un outil en ligne de commande. Vous avez besoin d’un terminal :
- Windows : Windows Terminal ou PowerShell (recommandé). WSL2 si vous voulez un environnement Linux complet.
- Mac : Terminal natif (cherchez « Terminal » dans Spotlight) ou iTerm2.
- Linux : votre terminal habituel, n’importe lequel.
Installer Claude Code sur Windows
Sur Windows, deux options : installer directement dans PowerShell, ou passer par WSL2 (Windows Subsystem for Linux). Les deux fonctionnent. Je recommande WSL2 si vous comptez utiliser Claude Code intensivement, car de nombreux outils dev sont mieux supportés sous Linux.
Option 1 : Installation via PowerShell (rapide)
Étape 1 : ouvrez Windows Terminal ou PowerShell. Cherchez « Terminal » ou « PowerShell » dans le menu Démarrer.
Étape 2 : vérifiez que Node.js est installé avec node --version. Si non, téléchargez-le sur nodejs.org.
Étape 3 : installez Claude Code globalement avec npm :
npm install -g @anthropic-ai/claude-codeL’installation prend 30 secondes à 2 minutes selon votre connexion. Vous verrez quelques warnings npm (normal), tant qu’il n’y a pas de « ERR » rouge, tout va bien.
Étape 4 : vérifiez que la commande est disponible :
claude --versionSi vous voyez un numéro de version, c’est gagné. Sinon, fermez et rouvrez votre terminal (les nouveaux PATH ne sont pas toujours pris en compte immédiatement).
Option 2 : Installation via WSL2 (recommandée pour usage intensif)
WSL2 vous donne un vrai environnement Linux dans Windows. Plus stable pour les outils dev, et la plupart des tutos en ligne supposent un environnement Unix.
Étape 1 : installez WSL2. Ouvrez PowerShell en administrateur et tapez :
wsl --installCela installe WSL2 avec Ubuntu par défaut. Redémarrez votre PC quand demandé.
Étape 2 : lancez Ubuntu depuis le menu Démarrer. Créez votre utilisateur Linux à la première ouverture.
Étape 3 : installez Node.js dans WSL :
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejsÉtape 4 : installez Claude Code :
npm install -g @anthropic-ai/claude-codeVous lancez ensuite Claude Code dans Ubuntu. Vos projets Windows sont accessibles via /mnt/c/, mais pour de meilleures performances, gardez vos projets dans le système de fichiers Linux (~/projects/).
Installer Claude Code sur Mac
L’installation sur Mac est la plus simple. Deux méthodes au choix.
Option 1 : Installation via npm (la plus directe)
Étape 1 : ouvrez le Terminal (Spotlight + « Terminal » + Entrée).
Étape 2 : vérifiez Node.js avec node --version. Si non installé, téléchargez sur nodejs.org ou utilisez Homebrew (voir option 2).
Étape 3 : installez Claude Code :
npm install -g @anthropic-ai/claude-codeSi vous avez une erreur de permissions (EACCES), c’est normal sur Mac avec npm global. Deux solutions : utilisez Homebrew (voir ci-dessous), ou configurez npm pour utiliser un dossier sans privilèges. La méthode Homebrew est plus propre.
Option 2 : Installation via Homebrew (recommandée)
Homebrew gère mieux les permissions et les mises à jour. Si vous n’avez pas encore Homebrew, installez-le :
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Ensuite, installez Node.js puis Claude Code :
brew install node
npm install -g @anthropic-ai/claude-codeVérifiez avec claude --version.
Installer Claude Code sur Linux
Sur Linux, l’installation suit les mêmes principes. Adaptation selon votre distribution.
Ubuntu / Debian
# Installer Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Installer Claude Code
npm install -g @anthropic-ai/claude-code
# Verifier
claude --versionFedora / RHEL / CentOS
# Installer Node.js 20
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo -E bash -
sudo dnf install -y nodejs
# Installer Claude Code
npm install -g @anthropic-ai/claude-codeArch Linux
sudo pacman -S nodejs npm
npm install -g @anthropic-ai/claude-codeSi vous avez des erreurs de permissions sur Linux avec npm global, configurez npm pour utiliser un dossier utilisateur :
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-codeLancer votre première session
Claude Code est installé, il faut maintenant l’authentifier et tester qu’il fonctionne.
Étape 1 : authentification
Naviguez vers un dossier (n’importe lequel pour le test) et lancez Claude :
cd ~/test-claude
claudeLa toute première fois, Claude Code vous demande de vous authentifier. Suivez les instructions à l’écran : un lien s’ouvre dans votre navigateur, vous vous connectez à votre compte Anthropic, vous autorisez la connexion. Le terminal détecte automatiquement et continue.
Si vous préférez utiliser une clé API plutôt que votre compte Claude, exportez la variable d’environnement avant de lancer :
export ANTHROPIC_API_KEY="sk-ant-xxx"
claudeÉtape 2 : premier prompt
Une fois authentifié, vous voyez le prompt Claude Code. Tapez par exemple :
Crée un fichier hello.txt avec le contenu "Bonjour Claude Code"Claude vous montre l’action qu’il s’apprête à faire (créer un fichier), vous demande confirmation, puis l’exécute. Le fichier hello.txt apparaît dans votre dossier. Premier succès.
Étape 3 : commandes utiles à connaître
Quelques commandes intégrées qui vont vous servir tout de suite :
/help: liste toutes les commandes disponibles./clear: efface la conversation et repart sur du neuf./quitouCtrl+D: quitte Claude Code.Shift+Tab: cycle entre les modes (auto-accept, edit, plan)./mcp: liste les serveurs MCP connectés.
Troubleshooting : 8 erreurs courantes
Voici les erreurs les plus fréquentes et leurs solutions, dans l’ordre de probabilité.
1. « command not found: claude »
L’installation a réussi mais le terminal ne trouve pas la commande. Causes :
- PATH non rafraîchi : fermez et rouvrez votre terminal.
- npm global mal configuré : vérifiez avec
npm config get prefix. Le dossier doit être dans votre PATH. - Sur Mac avec Homebrew : ajoutez
/opt/homebrew/binà votre PATH (M1/M2) ou/usr/local/bin(Intel).
2. « error: claude code process exited with code 1 »
Erreur générique au démarrage. Causes les plus fréquentes :
- Authentification expirée : lancez
claude logoutpuisclaudepour vous reconnecter. - Quota mensuel dépassé : vous avez atteint la limite de votre plan. Attendez le reset ou passez à un plan supérieur.
- Connexion réseau bloquée : un firewall ou proxy peut bloquer les requêtes vers api.anthropic.com. Testez avec
curl https://api.anthropic.com. - Fichier de config corrompu : supprimez
~/.claude/(sauvegardez d’abord les CLAUDE.md importants) et relancez.
3. « EACCES: permission denied » lors de npm install
Problème de permissions sur Mac ou Linux. NE jamais utiliser sudo npm install -g, ça aggrave le problème. Solutions :
- Mac : utilisez Homebrew pour installer Node, ça corrige les permissions.
- Linux/Mac : configurez npm pour utiliser un dossier utilisateur (voir section Linux ci-dessus).
- nvm : installez Node via nvm, qui gère les permissions automatiquement.
4. « Node version too old »
Vous avez une version de Node antérieure à 18. Mettez à jour vers la dernière LTS. Si plusieurs versions cohabitent sur votre machine, utilisez nvm pour switcher facilement :
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code5. Authentification qui boucle
Le navigateur s’ouvre, vous validez, mais le terminal reste bloqué. Causes :
- Plusieurs fenêtres de navigateur ouvertes : fermez toutes les sessions Claude.ai et réessayez avec une seule fenêtre.
- Port local bloqué : Claude Code écoute sur un port local pour recevoir le callback. Vérifiez qu’aucun autre service ne l’utilise.
- VPN actif : désactivez votre VPN le temps de l’authentification.
6. « Cannot read properties of undefined » au lancement
Souvent lié à un problème de version Node ou à des dépendances corrompues. Solutions :
# Reinstaller proprement
npm uninstall -g @anthropic-ai/claude-code
npm cache clean --force
npm install -g @anthropic-ai/claude-code7. Claude Code lent ou freeze
Si Claude Code rame ou se bloque sur une commande :
- Timeout réseau : votre connexion vers Anthropic est lente. Testez avec un autre réseau.
- Trop de fichiers analysés : Claude Code essaie de comprendre votre projet entier. Pour les gros monorepos, ajoutez un fichier
.claudeignorequi exclutnode_modules,.next,build, etc. - Contexte saturé : tapez
/clearet repartez sur une session fraîche.
8. Sur Windows : « WSL2 is required »
Certaines fonctionnalités MCP ou hooks ne tournent pas en PowerShell natif. Si vous voulez utiliser Claude Code à fond, passez à WSL2. C’est plus stable et la communauté Claude Code y est mieux supportée.
Mettre à jour Claude Code
Anthropic publie des mises à jour fréquentes. Pour rester à jour :
npm update -g @anthropic-ai/claude-codeOu pour forcer la dernière version :
npm install -g @anthropic-ai/claude-code@latestClaude Code vous prévient lui-même quand une nouvelle version est disponible. La commande claude --version vous montre votre version installée.
Pour rester informé des nouveautés, suivez le changelog officiel sur le repo GitHub d’Anthropic.
Désinstaller Claude Code
Si vous voulez retirer Claude Code (testez quand même tout ce qu’il fait avant) :
npm uninstall -g @anthropic-ai/claude-codePour nettoyer complètement, supprimez aussi le dossier de configuration :
# Mac/Linux
rm -rf ~/.claude/
# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\"Attention : cette suppression efface vos CLAUDE.md globaux, vos skills, vos hooks et vos configs MCP. Sauvegardez ce qui est important d’abord.
Questions fréquentes
Claude Code est-il gratuit ?
Non, Claude Code n’a pas de version totalement gratuite. Vous avez besoin d’un abonnement Claude Pro (20$/mois), Claude Max (100 ou 200$/mois) ou d’une clé API à l’usage. Si vous avez déjà un abonnement Claude.ai Pro ou Max, vous y avez accès directement.
Faut-il savoir coder pour utiliser Claude Code ?
Non. Claude Code est paradoxalement très accessible aux non-développeurs. Vous décrivez ce que vous voulez en français et l’agent crée le code pour vous. La barrière la plus haute, c’est l’installation initiale (terminal). Une fois passée, l’utilisation est en langage naturel.
Quelle est la différence entre Claude Code et Claude.ai ?
Claude.ai est un chatbot dans votre navigateur, vous discutez et il vous répond avec du texte. Claude Code est un agent dans votre terminal qui agit directement sur vos fichiers. Il peut créer, modifier et supprimer des fichiers, lancer des commandes, installer des dépendances, lancer des tests. Claude.ai conseille, Claude Code exécute.
Puis-je utiliser Claude Code sans abonnement ?
Oui, mais via la clé API Anthropic en pay-as-you-go. Vous payez les tokens consommés, pas un forfait mensuel. Pour les usages occasionnels, l’API peut revenir moins cher qu’un abonnement.
Claude Code marche-t-il en français ?
Oui, parfaitement. Vous pouvez écrire vos prompts en français, Claude Code répond en français. Le code généré, lui, suit les conventions standard (variables en anglais par défaut), mais vous pouvez lui demander explicitement d’utiliser des noms français si vous préférez.
L’installation prend combien de temps ?
Si Node.js est déjà installé : 2 minutes (npm install + auth). Si vous partez de zéro : 10 à 15 minutes (Node.js + Claude Code + auth + premier test).
Puis-je installer Claude Code sur plusieurs machines ?
Oui, votre abonnement Claude couvre plusieurs machines. L’authentification se fait par appareil, mais le quota est partagé sur votre compte.
Aller plus loin avec Claude Code
Maintenant que Claude Code est installé, voici les ressources LesAstucesIA pour bien démarrer :
- Guide complet Claude Code : tout sur l’outil (CLAUDE.md, MCP, hooks, subagents, skills).
- Claude Code vs Cursor : quel outil pour quel profil.
- Générateur de prompts : créez des prompts optimisés pour Claude Code.
Si vous bloquez sur une étape de l’installation, n’hésitez pas à laisser un commentaire sur cet article ou à me contacter directement. La communauté Claude Code en français grandit, on va y arriver ensemble.
Articles similaires
Dans la catégorie Claude