Installer Claude Code sur Windows, Mac et Linux

Pour installer Claude Code, lancez dans un terminal la commande officielle d'Anthropic : curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, ou irm https://claude.ai/install.ps1 | iex dans PowerShell sous Windows. Vérifiez ensuite avec claude --version, puis tapez claude pour vous connecter. Il faut un abonnement Claude payant ou un compte Console : le plan gratuit n'inclut pas Claude Code.
Claude Code s'installe en une commande sur Windows, macOS et Linux, mais les détails changent d'un système à l'autre : PowerShell ou CMD, WSL, Homebrew, dépôts Linux, PATH à corriger. Ce guide donne les commandes officielles relevées le 18 novembre 2026, la façon de vérifier que tout fonctionne, les erreurs les plus courantes et, pour finir, le branchement sur un modèle local avec Ollama.
#Comment installer Claude Code ? Prérequis et commandes officielles
Claude Code s'installe avec une seule commande officielle : curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, ou irm https://claude.ai/install.ps1 | iex dans PowerShell sous Windows. Ce script natif est la méthode recommandée par Anthropic, car il se met à jour seul en arrière-plan.
Claude Code est l'agent de programmation d'Anthropic : un programme qui s'utilise dans le terminal, lit le code d'un projet, modifie des fichiers et lance des commandes après votre accord. Le programme s'installe sur votre machine, mais le modèle d'IA tourne sur les serveurs d'Anthropic : selon la documentation officielle consultée le 18 novembre 2026, une connexion Internet est obligatoire.
| Système | Méthode | Commande | Mise à jour automatique |
|---|---|---|---|
| macOS, Linux, WSL | Script natif (recommandé) | curl -fsSL https://claude.ai/install.sh | bash | Oui, en arrière-plan |
| Windows (PowerShell) | Script natif (recommandé) | irm https://claude.ai/install.ps1 | iex | Oui, en arrière-plan |
| Windows (CMD) | Script natif | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | Oui, en arrière-plan |
| macOS | Homebrew | brew install --cask claude-code | Non par défaut : brew upgrade claude-code |
| Windows | WinGet | winget install Anthropic.ClaudeCode | Non par défaut : winget upgrade Anthropic.ClaudeCode |
| Debian, Ubuntu, Fedora, RHEL, Alpine | Dépôts apt, dnf, apk signés | Voir la documentation officielle | Non : mise à jour système |
| Tous (Node.js 22 ou plus) | npm | npm install -g @anthropic-ai/claude-code@latest | Selon les droits du dossier npm |
#Configuration requise
L'IA locale sur ton Mac, à fond : mémoire unifiée, MLX vs GGUF, le bon modèle pour ta puce, Ollama et LM Studio réglés pour Apple Silicon.
- Espace en ligne à vie
- PDF + fichiers
- Remboursé 30 j
- Système
- macOS 13.0 ou plus, Windows 10 1809 ou plus (ou Windows Server 2019), Ubuntu 20.04 ou plus, Debian 10 ou plus, Alpine Linux 3.19 ou plus.
- Matériel
- 4 Go de RAM au minimum et un processeur x64 ou ARM64. Aucune carte graphique n'est nécessaire, puisque le modèle Claude tourne à distance.
- Compte
- Un abonnement Claude Pro, Max, Ultra, Team ou Enterprise, ou un compte Claude Console payé à l'usage. Le plan gratuit de claude.ai n'inclut pas Claude Code.
- Pays
- Claude Code n'est accessible que depuis les pays pris en charge par Anthropic ; la France en fait partie.
Côté prix, la page officielle d'Anthropic consultée le 18 novembre 2026 affiche l'offre Pro à 20 dollars par mois en facturation mensuelle, et précise que Claude Code est inclus dans tous les plans payants, avec les mêmes limites d'usage que le reste de l'abonnement. Le détail des offres et des alternatives gratuites est traité dans le guide dédié au prix de Claude Code.
#Installer Claude Code sur Windows : PowerShell, CMD ou WSL
Sous Windows, Claude Code s'installe depuis PowerShell avec irm https://claude.ai/install.ps1 | iex, sans droits d'administrateur. Une alternative consiste à l'installer dans WSL 2, le sous-système Linux de Windows, avec la commande Linux : c'est le seul mode Windows où le bac à sable de commandes est pris en charge.
- 01Ouvrir PowerShellOuvrez le menu Démarrer, tapez PowerShell et lancez-le normalement, sans « Exécuter en tant qu'administrateur ». L'invite commence par PS C:\Users\VotreNom>, ce qui confirme que vous êtes dans PowerShell et non dans l'invite de commandes CMD.
- 02Lancer le script d'installationCollez la commande irm https://claude.ai/install.ps1 | iex puis validez avec Entrée. Le script télécharge Claude Code sans afficher de barre de progression : attendez le retour de l'invite avant de faire autre chose.
- 03Ouvrir un nouveau terminalFermez la fenêtre PowerShell et ouvrez-en une nouvelle, pour que le dossier d'installation soit pris en compte. Le programme est placé dans %USERPROFILE%\.local\bin\claude.exe.
- 04Vérifier la versionTapez claude --version. Une installation réussie affiche un numéro de version suivi de (Claude Code). Si Windows répond que claude n'est pas reconnu, appliquez la correction du PATH décrite plus bas.
- 05Installer Git for Windows (conseillé)Git for Windows est facultatif mais recommandé par Anthropic : il fournit Git Bash, que Claude Code utilise pour exécuter ses commandes. Sans lui, Claude Code passe par PowerShell. Une installation dans WSL n'en a pas besoin.
#Installer Claude Code sur Mac : script natif ou Homebrew
Sur Mac, Claude Code s'installe en ouvrant l'application Terminal et en lançant curl -fsSL https://claude.ai/install.sh | bash. Il faut macOS 13.0 ou plus ; les Mac Apple Silicon (ARM64) comme les Mac Intel (x64) sont pris en charge. Homebrew est une alternative, mais sans mise à jour automatique.
Homebrew propose deux paquets Claude Code. Le paquet claude-code suit le canal stable, qui a en général environ une semaine de retard et écarte les versions présentant des régressions majeures. Le paquet claude-code@latest reçoit chaque version dès sa sortie. Par défaut, la mise à jour Homebrew se fait à la main avec brew upgrade claude-code, ou brew upgrade claude-code@latest pour le second paquet. Pour que Claude Code lance lui-même cette mise à jour Homebrew ou WinGet, la documentation d'Anthropic indique de régler la variable d'environnement CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE sur 1.
Le script natif place le lanceur dans ~/.local/bin/claude. Si le Terminal répond « command not found: claude », ce dossier n'est pas encore dans le PATH de votre shell : la correction est donnée dans la section consacrée aux erreurs.
#Installer Claude Code sur Linux : script, apt, dnf ou Alpine
Sur Linux, Claude Code s'installe avec le même script que sur Mac : curl -fsSL https://claude.ai/install.sh | bash, sans sudo. Anthropic publie aussi des dépôts signés apt (Debian, Ubuntu), dnf (Fedora, RHEL) et apk (Alpine) pour les machines où les logiciels doivent passer par le gestionnaire de paquets.
Alpine Linux et les autres distributions basées sur musl n'incluent ni bash ni curl par défaut. Sans eux, le script d'installation échoue avec une erreur « not found ». Installez d'abord ces deux paquets, puis relancez la commande d'installation.
Les dépôts apt, dnf et apk proposent chacun un canal stable et un canal latest. Leur configuration demande plusieurs commandes, dont la vérification de l'empreinte de la clé de signature d'Anthropic : suivez-les directement sur la page d'installation avancée de la documentation officielle, liée en fin de guide. Ces installations se mettent à jour avec le système, par exemple sudo apt update && sudo apt upgrade claude-code.
#Comment vérifier que Claude Code est bien installé ?
Pour vérifier l'installation de Claude Code, ouvrez un nouveau terminal et tapez claude --version : un numéro de version doit s'afficher. Le 18 novembre 2026, la version la plus récente en tête du journal des versions officiel est la 2.1.327, alors que le canal stable distribue la 2.1.311 selon le registre npm. Un numéro plus ancien n'est donc pas forcément une erreur : le paquet Homebrew claude-code et les dépôts Linux configurés par défaut suivent ce canal stable. La commande claude doctor donne ensuite un diagnostic complet.
La commande claude doctor affiche, sans ouvrir de session, l'état de l'installation, les erreurs dans les fichiers de réglages et les avertissements avec une correction suggérée. C'est le premier réflexe quand Claude Code se comporte bizarrement après une installation ou une mise à jour.
- 01Se placer dans un projetDans le terminal, allez dans le dossier du projet sur lequel vous voulez travailler avec la commande cd suivie du chemin du dossier. Claude Code travaille sur les fichiers du dossier où il est lancé.
- 02Lancer Claude CodeTapez claude. Au premier lancement, Claude Code ouvre le navigateur pour vous connecter avec votre compte Claude (Pro, Max, Ultra, Team, Enterprise) ou votre compte Console. Si le navigateur affiche un code au lieu de revenir au terminal, collez ce code dans le terminal.
- 03Poser une première questionUne fois connecté, l'invite de Claude Code affiche la version, le modèle et le dossier de travail. Demandez par exemple « que fait ce projet ? ». Les identifiants restent enregistrés : la connexion n'est plus demandée aux lancements suivants.
- 04Préparer le projetTapez /init pour que Claude Code analyse le code et génère un fichier CLAUDE.md de départ, avec les commandes de compilation, de test et les conventions du projet. Tapez /help pour la liste des commandes et /config pour les réglages.
#Mettre à jour ou désinstaller Claude Code
Une installation native de Claude Code se met à jour seule au démarrage et en arrière-plan ; la commande claude update applique tout de suite la dernière version. Pour une installation native sur macOS, Linux ou WSL, la désinstallation consiste à supprimer le lanceur et le dossier des versions.
#Claude Code introuvable ou installation bloquée : les erreurs courantes
L'erreur la plus fréquente après l'installation de Claude Code est « command not found: claude » ou « 'claude' n'est pas reconnu » : le programme est bien installé, mais son dossier, ~/.local/bin sur Mac et Linux ou %USERPROFILE%\.local\bin sous Windows, n'est pas dans le PATH. L'installateur le signale dans ses « Setup notes » sans corriger le PATH lui-même.
| Message affiché | Cause | Correctif |
|---|---|---|
| command not found: claude / 'claude' is not recognized | Dossier d'installation absent du PATH | Ajouter ~/.local/bin (ou %USERPROFILE%\.local\bin) au PATH, puis ouvrir un nouveau terminal |
| The token '&&' is not a valid statement separator | Commande CMD collée dans PowerShell | Utiliser la commande PowerShell |
| 'irm' is not recognized as an internal or external command | Commande PowerShell collée dans CMD | Utiliser la commande CMD |
| curl: (22) The requested URL returned error: 403 | Proxy ou filtre réseau, ou pays non pris en charge | Vérifier le réseau ou le proxy de l'entreprise |
| App unavailable in region | Pays non pris en charge par Anthropic | Claude Code n'est pas proposé dans ce pays |
| not found sur Alpine | bash ou curl absents | apk add bash curl |
La correction pour zsh vaut sur macOS, dont zsh est le shell par défaut. Sous Linux avec bash, la même ligne export s'ajoute au fichier ~/.bashrc ; sur Mac avec bash, elle va dans ~/.bash_profile, car le Terminal de macOS lance bash comme shell de connexion, qui ignore ~/.bashrc. Un terminal ouvert avant la correction garde l'ancien PATH, et un terminal intégré à un éditeur comme VS Code hérite du PATH de l'éditeur : fermez puis rouvrez la fenêtre, ou l'éditeur, avant de retester claude --version.
#Comment connecter Claude Code à VS Code ?
Pour utiliser Claude Code dans VS Code, installez l'extension officielle Claude Code d'Anthropic : ouvrez la vue Extensions avec Cmd+Shift+X sur Mac ou Ctrl+Shift+X sous Windows et Linux, cherchez « Claude Code » et cliquez sur Installer. Il faut VS Code 1.94.0 ou plus et un compte Claude payant ou un compte Console.
L'extension VS Code de Claude Code embarque sa propre copie du programme pour son panneau de discussion, mais ne l'ajoute pas au PATH. Pour taper claude dans le terminal intégré de VS Code, l'installation autonome décrite plus haut reste nécessaire. L'extension s'installe aussi dans Cursor et dans les autres éditeurs dérivés de VS Code, via le registre Open VSX.
#Brancher Claude Code sur un modèle local avec Ollama
Claude Code peut fonctionner avec un modèle local grâce à Ollama, qui expose une API compatible avec celle d'Anthropic. Une fois Claude Code et Ollama installés, la commande ollama launch claude lance Claude Code relié à Ollama. La documentation d'Ollama recommande un modèle local réglé sur un contexte de 64k tokens ou plus.
La documentation d'Ollama décrit aussi un réglage manuel par variables d'environnement, qui pointe Claude Code vers le serveur local d'Ollama sur le port 11434. L'exemple officiel utilise le modèle qwen3.5, dont l'étiquette par défaut dans la bibliothèque Ollama correspond à la version 9B, de 6,6 à 7,6 Go ; un modèle doit gérer l'appel d'outils pour que Claude Code puisse lire et modifier des fichiers.
Claude Code est-il gratuit ?+
Faut-il Node.js pour installer Claude Code ?+
Faut-il les droits administrateur pour installer Claude Code sous Windows ?+
Comment installer un plugin sur Claude Code ?+
Comment bien configurer Claude Code après l'installation ?+
Claude Code fonctionne-t-il hors connexion ?+
Comment mettre à jour Claude Code ?+
#Sources et vérification du 18 novembre 2026
Les commandes, prérequis, versions et prix de ce guide ont été relevés le 18 novembre 2026 dans la documentation officielle de Claude Code, la page de prix d'Anthropic, le journal des versions du dépôt GitHub d'Anthropic et la documentation d'Ollama ; les commandes et les prix évoluent souvent, vérifiez-les avant une installation en entreprise.
- Source : installation avancée de Claude Code (Anthropic)
- Source : démarrage rapide de Claude Code (Anthropic)
- Source : dépannage de l'installation (Anthropic)
- Source : extension VS Code (Anthropic)
- Source : prix des offres Claude (Anthropic)
- Source : journal des versions de Claude Code (GitHub, Anthropic)
- Source : Claude Code avec Ollama (documentation Ollama)
Un retour, une erreur, une précision ? Faites-nous signe, ça améliore le guide pour tout le monde.