On a installé Claude Code sur à peu près tout ce qui nous passe sous la main : nos Mac, un PC Windows, et surtout le serveur Linux qui fait tourner nos sites, nos workflows n8n et notre plateforme GMB Club. Sur ce serveur, Claude Code travaille tous les jours : il publie nos articles, corrige nos pages, surveille nos services.
L’installation prend deux minutes quand on connaît la bonne commande, et une heure quand on tombe sur un tutoriel de 2025 qui parle encore de Node.js et de sudo npm. Voici la méthode à jour au 18 septembre 2026, pour chaque système, avec les pièges qu’on a rencontrés.
Avant de commencer : ce qu’il vous faut
- Un abonnement payant. C’est le point qui surprend le plus. Le plan gratuit de claude.ai n’inclut pas Claude Code, la documentation d’Anthropic l’écrit noir sur blanc. Il faut un abonnement Pro, Max, Team ou Enterprise, ou un compte API (Console). Les prix sont détaillés dans notre article Claude Code : combien ça coûte vraiment.
- Un système récent : macOS 13 ou plus, Windows 10 version 1809 ou plus, Ubuntu 20.04 ou plus, Debian 10 ou plus.
- 4 Go de RAM au minimum, sur un processeur x64 ou ARM.
- Pas besoin de Node.js avec l’installeur officiel. C’est la différence principale avec les anciens tutoriels : Claude Code est désormais un programme autonome.
Installer Claude Code sur Mac et Linux
Ouvrez un terminal et collez la commande de l’installeur officiel :
curl -fsSL https://claude.ai/install.sh | bashC’est tout. L’installeur télécharge le programme, le place dans ~/.local/bin/claude et active les mises à jour automatiques. La même commande fonctionne sous WSL, le Linux intégré à Windows.
Si vous préférez une version plus éprouvée, il existe un canal « stable » qui a environ une semaine de retard sur la dernière version :
curl -fsSL https://claude.ai/install.sh | bash -s stableSur un serveur, c’est ce qu’on recommande : on préfère une version qui a tourné une semaine chez tout le monde plutôt que la toute dernière.
Installer Claude Code sur Windows
Depuis 2026, Claude Code tourne nativement sous Windows, sans passer par WSL. Ouvrez PowerShell (pas l’invite de commandes) et lancez :
irm https://claude.ai/install.ps1 | iexSi vous êtes dans l’invite de commandes classique (CMD), la commande est différente :
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdPas besoin d’être administrateur. Deux choses à savoir sous Windows :
- Git pour Windows est optionnel mais recommandé. S’il est installé, Claude Code utilise Git Bash pour exécuter ses commandes. Sinon, il se rabat sur PowerShell. Si Git est installé à un endroit inhabituel, indiquez le chemin de
bash.exedans la variableCLAUDE_CODE_GIT_BASH_PATH. - Le bac à sable (sandboxing) n’existe pas sous Windows natif. Il existe sous WSL 2. Si vous voulez laisser Claude Code travailler plus librement sur votre machine, WSL 2 est plus sûr.
Homebrew, WinGet, npm : les autres méthodes
| Méthode | Commande | Mises à jour automatiques |
|---|---|---|
| Installeur officiel | voir plus haut | Oui |
| Homebrew (Mac) | brew install --cask claude-code |
Non, à faire avec Homebrew |
| WinGet (Windows) | winget install Anthropic.ClaudeCode |
Non, à faire avec WinGet |
| npm | npm install -g @anthropic-ai/claude-code |
Non, à relancer à la main |
| Paquets Linux (apt, dnf, apk) | dépôt signé d’Anthropic | Avec le gestionnaire de paquets |
Une précision sur npm, parce que c’est la méthode qu’on trouve encore dans la moitié des tutoriels. Elle fonctionne toujours et installe le même programme, mais depuis la version 2.1.198 de juillet 2026 elle demande Node.js 22 ou plus. Et surtout : ne lancez jamais sudo npm install. Ça crée des problèmes de droits qui empêchent ensuite les mises à jour. Si vous n’avez pas une raison précise d’utiliser npm, prenez l’installeur officiel.
Premier lancement et connexion
Placez-vous dans le dossier d’un projet et lancez simplement :
cd mon-projet
claudeAu premier lancement, Claude Code ouvre votre navigateur pour vous connecter à votre compte Claude. Une fois connecté, vous pouvez lui parler en français comme dans le chat, sauf que cette fois il peut lire vos fichiers, les modifier et lancer des commandes.
Un conseil qu’on donne à tous nos clients : lancez tout de suite la commande /init. Claude Code parcourt le projet et écrit un fichier CLAUDE.md qui résume son fonctionnement. Ce fichier est relu à chaque session. C’est ce qui fait la différence entre un assistant qui redécouvre votre projet à chaque fois et un assistant qui le connaît. Le nôtre contient toutes les règles de notre serveur, y compris les erreurs à ne jamais refaire.
Vérifier, mettre à jour, désinstaller
Pour vérifier que tout va bien :
claude --version
claude doctorclaude doctor affiche un diagnostic complet de l’installation, en lecture seule. C’est la première chose à lancer quand quelque chose ne marche pas.
Pour mettre à jour à la main (l’installeur officiel le fait déjà tout seul en arrière-plan) :
claude updatePour désinstaller une installation faite avec l’installeur officiel sur Mac ou Linux, il suffit de supprimer ~/.local/bin/claude et le dossier ~/.local/share/claude. Vos réglages sont dans ~/.claude et ~/.claude.json : supprimez-les aussi si vous voulez repartir de zéro.
Claude Code dans VS Code et JetBrains
Si vous préférez travailler dans un éditeur plutôt que dans un terminal, il existe une extension officielle pour VS Code (qui fonctionne aussi dans Cursor), à chercher sous le nom anthropic.claude-code, et un plugin pour les éditeurs JetBrains. Il existe aussi une application de bureau pour Mac et Windows, et une version web sur claude.ai. Le fonctionnement est le même partout : c’est le même Claude Code, avec la même connexion.
Chez nous, on utilise surtout le terminal, parce que la majorité de notre travail se fait sur un serveur distant. Mais pour quelqu’un qui débute, l’extension VS Code est plus confortable : on voit les modifications proposées avant de les accepter.
Les pièges qu’on a rencontrés
1. La clé API oubliée qui fait payer deux fois
Si une variable ANTHROPIC_API_KEY traîne dans votre environnement, Claude Code l’utilise à la place de votre abonnement, et tout votre usage est facturé au tarif de l’API. On s’est fait avoir une fois après avoir testé un script. La solution : unset ANTHROPIC_API_KEY avant de lancer Claude Code, ou retirer la variable de votre fichier de profil.
2. « Killed » pendant l’installation sur un petit serveur
Sur un serveur Linux à court de mémoire, l’installeur peut être arrêté brutalement avec un simple message « Killed ». Libérez de la mémoire ou ajoutez de la mémoire d’échange (swap), puis relancez.
3. La mauvaise commande dans le mauvais terminal sous Windows
Si vous collez la commande irm dans l’invite de commandes, ou la commande avec && dans PowerShell, ça échoue. Vérifiez dans quel terminal vous êtes avant de chercher plus loin.
4. Le serveur qui ne se met plus à jour
En préparant cet article, on a découvert que le Claude Code de notre propre serveur était resté en version 2.1.197, sortie fin juin, alors que la version actuelle est la 2.1.276. Les mises à jour automatiques ne se faisaient plus. Lancez claude --version de temps en temps sur vos machines, surtout celles sur lesquelles vous ne vous connectez pas tous les jours.
Et maintenant ?
Une fois installé, le plus intéressant commence : apprendre à bien lui parler, lui donner vos outils et lui écrire des consignes réutilisables. On a tout rassemblé dans notre guide complet de Claude Code en français, et on détaille les skills, qui sont la fonctionnalité qui nous a fait gagner le plus de temps. Si vous hésitez encore avec les alternatives, notre comparatif Codex ou Claude Code est fait à partir de nos propres tests.
Questions fréquentes
Claude Code est-il gratuit ?
Non. Le plan gratuit de claude.ai n’inclut pas Claude Code. Il faut au minimum l’abonnement Pro, à 20 dollars par mois hors taxes, ou un compte API facturé à l’usage.
Faut-il installer Node.js pour utiliser Claude Code ?
Non, pas avec l’installeur officiel, qui installe un programme autonome. Node.js 22 ou plus n’est nécessaire que si vous choisissez d’installer Claude Code avec npm.
Peut-on installer Claude Code sur Windows sans WSL ?
Oui. Claude Code fonctionne nativement sous Windows 10 et 11, installé depuis PowerShell. WSL 2 reste utile si vous voulez le bac à sable, qui n’existe pas sous Windows natif.
Comment savoir si Claude Code est bien installé ?
Lancez claude --version pour voir la version, puis claude doctor pour un diagnostic complet de l’installation et des réglages.
Claude Code se met-il à jour tout seul ?
Oui si vous l’avez installé avec l’installeur officiel. Avec Homebrew, WinGet ou npm, il faut lancer la mise à jour vous-même.
Alexandre Damais, cofondateur d’A2Z Automation. Procédures vérifiées dans la documentation officielle d’Anthropic le 18 septembre 2026, et testées sur nos propres machines.
