Claude Code installation : guide complet (macOS, Windows, Linux)
Sommaire
▶️ En Bref
Installer Claude Code prend 5 minutes. Trois méthodes officielles : (1) macOS via brew install --cask claude-code, (2) Windows via winget install Anthropic.ClaudeCode, (3) multi-plateforme via npm install -g @anthropic-ai/claude-code. Après installation, lancez claude dans votre projet et authentifiez-vous avec votre compte Anthropic ou une clé API.
L’installation de Claude Code est volontairement simple : une seule commande sur les trois plateformes principales, sans dépendances complexes. Ce guide couvre chaque cas, plus la résolution des erreurs les plus fréquentes.
Prérequis avant installation
Avant de lancer la commande d’installation, vérifiez :
- Node.js 18+ si vous passez par npm (vérifier avec
node --version) - Un terminal moderne : Terminal sur macOS, PowerShell 7+ sur Windows, n’importe quel shell sur Linux
- Connexion Internet stable (Claude Code communique avec les serveurs Anthropic)
- Un compte Anthropic (Claude Pro, Max ou clé API)
📝 Note importante
Sur Windows, évitez l’invite de commandes classique (cmd.exe). Utilisez PowerShell 7+ ou Windows Terminal pour une meilleure expérience (couleurs, raccourcis, copier-coller).
Installer Claude Code sur macOS
La méthode recommandée est Homebrew. Si vous ne l’avez pas, installez-le depuis brew.sh.
L’installation prend ~30 secondes. Vérifiez avec :
Vous devriez voir un numéro de version. Si la commande n’est pas trouvée, redémarrez votre terminal.
Installer sur Windows (PowerShell ou WinGet)
Méthode 1 : WinGet (recommandée)
WinGet est le gestionnaire de paquets natif de Windows 11 (et Windows 10 récents).
Méthode 2 : script PowerShell
Si vous n’avez pas WinGet, lancez cette commande dans PowerShell exécuté en admin :
Le script télécharge et installe Claude Code, puis l’ajoute au PATH automatiquement.
Installer sur Linux et WSL
Sur Linux (Ubuntu, Debian, Fedora, Arch…) ou WSL, utilisez npm :
Si vous obtenez une erreur de permission, deux options :
- Préfixer par sudo :
sudo npm install -g @anthropic-ai/claude-code(rapide mais non recommandé) - Configurer un préfixe utilisateur :
npm config set prefix ~/.npm-globalpuis ajouter~/.npm-global/binau PATH
💡 Conseil pour WSL
Sous Windows avec WSL, installez Claude Code dans WSL (Ubuntu) plutôt que sur Windows natif si vos projets sont dans WSL. Cela évite les problèmes de chemins entre systèmes.
S’authentifier (compte ou clé API)
Première fois que vous lancez claude, il vous demande une méthode d’authentification :
Option A : Compte Anthropic (Pro / Max)
Recommandée si vous avez déjà un abonnement Claude Pro ou Max. Claude Code ouvre votre navigateur, vous vous connectez à Claude.ai, et l’autorisation se fait en un clic.
Avantages : facturation simple (incluse dans l’abonnement), pas de carte de crédit à gérer.
Option B : Clé API (pay-as-you-go)
Pour les utilisateurs sans abonnement ou les usages intensifs. Récupérez une clé API sur console.anthropic.com puis :
claude
Vous payez chaque token consommé. Les tarifs détaillés sont sur notre guide tarifs.
Configuration initiale recommandée
Trois réglages à faire dès le premier lancement :
1. Choisir un modèle par défaut
La commande /model bascule entre Opus (le plus puissant), Sonnet (équilibré) et Haiku (rapide et économique). Sonnet est le défaut recommandé pour la majorité des cas.
2. Initialiser un fichier CLAUDE.md
Dans chaque projet, lancez /init. Claude analyse votre codebase et génère un fichier CLAUDE.md qui sera lu à chaque session pour contextualiser ses réponses.
3. Configurer les permissions
Claude Code demande votre validation pour chaque commande shell par défaut. Pour automatiser les commandes safe (lecture, build, tests), allowlistez-les via la commande /permissions ou settings.json.
Problèmes courants et solutions
⚠️ « claude: command not found »
L’installation a réussi mais le PATH n’est pas mis à jour. Solution : redémarrez le terminal, ou ajoutez manuellement le dossier d’installation au PATH (varie selon OS).
⚠️ Erreur réseau / proxy
Si vous êtes derrière un proxy d’entreprise, configurez les variables d’environnement HTTP_PROXY et HTTPS_PROXY avant de lancer Claude Code.
⚠️ Permission denied sur Linux/macOS
npm refuse d’installer en global. Configurez un préfixe utilisateur ou utilisez nvm pour gérer Node.js sans sudo.
FAQ
Combien de temps prend l’installation ?
Moins de 5 minutes au total : 30 secondes pour l’installation, 2 minutes pour l’authentification, 2 minutes pour la configuration initiale.
Faut-il être administrateur ?
Oui pour la première installation globale via WinGet ou Homebrew. L’usage quotidien ne nécessite pas de privilèges admin.
Comment mettre à jour Claude Code ?
La commande /upgrade dans Claude vérifie et installe la dernière version. Sinon : brew upgrade --cask claude-code (macOS), winget upgrade Anthropic.ClaudeCode (Windows), npm update -g @anthropic-ai/claude-code (Linux).
Comment désinstaller ?
Selon votre méthode d’installation : brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode, ou npm uninstall -g @anthropic-ai/claude-code.
L’installation peut-elle modifier mon système ?
Claude Code n’installe que ses propres binaires. Aucune modification système au-delà du PATH. La désinstallation est propre.
✅ Ce qu’il faut retenir
- 3 méthodes selon l’OS : Homebrew (macOS), WinGet (Windows), npm (Linux/multi)
- Installation en moins de 5 minutes au total
- Authentification : Claude Pro/Max (recommandé) ou clé API à l’usage
- Lancez
/initdans chaque projet pour générer un CLAUDE.md contextuel - Si « command not found » : redémarrer le terminal
- Mises à jour faciles via la commande
/upgrade
Pour la suite : Comment utiliser Claude Code (guide complet) et Claude Code : prix et abonnements.
%20(1).png)
Envie d’aller plus loin ?
Découvrez nos formations complètes avec accompagnement personnalisé.
Voir la formation