Débutant 14 minIDE

Installer Claude Code sur Windows, Mac et Linux

Un ordinateur portable ouvert éclaire un bureau sombre d’une lumière verte.
Réponse directe

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.

Par Mohamed Meguedmi·Màj 2026-11-20·Testé sur Windows 11

#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.

Méthodes d'installation de Claude Code selon le système (documentation Anthropic, 18 novembre 2026)
SystèmeMéthodeCommandeMise à jour automatique
macOS, Linux, WSLScript natif (recommandé)curl -fsSL https://claude.ai/install.sh | bashOui, en arrière-plan
Windows (PowerShell)Script natif (recommandé)irm https://claude.ai/install.ps1 | iexOui, en arrière-plan
Windows (CMD)Script natifcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdOui, en arrière-plan
macOSHomebrewbrew install --cask claude-codeNon par défaut : brew upgrade claude-code
WindowsWinGetwinget install Anthropic.ClaudeCodeNon par défaut : winget upgrade Anthropic.ClaudeCode
Debian, Ubuntu, Fedora, RHEL, AlpineDépôts apt, dnf, apk signésVoir la documentation officielleNon : mise à jour système
Tous (Node.js 22 ou plus)npmnpm install -g @anthropic-ai/claude-code@latestSelon les droits du dossier npm

#Configuration requise

Le kit Mac

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.

  1. 01
    Ouvrir PowerShell
    Ouvrez 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.
  2. 02
    Lancer le script d'installation
    Collez 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.
  3. 03
    Ouvrir un nouveau terminal
    Fermez 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.
  4. 04
    Vérifier la version
    Tapez 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.
  5. 05
    Installer 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.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows (WinGet)
winget install Anthropic.ClaudeCode
→
WSL 2 ou Windows natif ?
Choisissez Windows natif pour des projets et outils Windows. Choisissez WSL 2 si vos projets utilisent des outils Linux ou si vous voulez le bac à sable de commandes, que la documentation d'Anthropic ne prend pas en charge sous Windows natif ni sous WSL 1. Dans WSL, installez et lancez claude depuis le terminal WSL, pas depuis PowerShell.

#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.

macOS (Terminal, script natif)
curl -fsSL https://claude.ai/install.sh | bash
macOS (Homebrew)
brew install --cask claude-code

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.

Linux (Ubuntu, Debian, Fedora…)
curl -fsSL https://claude.ai/install.sh | bash

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.

Linux (Alpine)
apk add bash curl

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.

!
Installation par npm : jamais avec sudo
La méthode npm exige Node.js 22 ou plus. La documentation d'Anthropic déconseille formellement sudo npm install -g, source de problèmes de droits et de risques de sécurité, et précise qu'une installation qui a besoin de sudo ne peut pas se mettre à jour seule. Le script natif évite ce problème.
macOS, Linux, Windows (npm, Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

#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.

macOS, Linux, Windows
claude --version
claude doctor

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.

  1. 01
    Se placer dans un projet
    Dans 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é.
  2. 02
    Lancer Claude Code
    Tapez 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.
  3. 03
    Poser une première question
    Une 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.
  4. 04
    Préparer le projet
    Tapez /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.

macOS, Linux, WSL (désinstallation native)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

#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.

Erreurs d'installation de Claude Code et correctifs (guide de dépannage Anthropic, 18 novembre 2026)
Message affichéCauseCorrectif
command not found: claude / 'claude' is not recognizedDossier d'installation absent du PATHAjouter ~/.local/bin (ou %USERPROFILE%\.local\bin) au PATH, puis ouvrir un nouveau terminal
The token '&&' is not a valid statement separatorCommande CMD collée dans PowerShellUtiliser la commande PowerShell
'irm' is not recognized as an internal or external commandCommande PowerShell collée dans CMDUtiliser la commande CMD
curl: (22) The requested URL returned error: 403Proxy ou filtre réseau, ou pays non pris en chargeVérifier le réseau ou le proxy de l'entreprise
App unavailable in regionPays non pris en charge par AnthropicClaude Code n'est pas proposé dans ce pays
not found sur Alpinebash ou curl absentsapk add bash curl
macOS (zsh) : ajouter ~/.local/bin au PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows (PowerShell) : ajouter le dossier au PATH utilisateur
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

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.

i
Sans terminal : l'application de bureau
La documentation d'Anthropic propose aussi l'application de bureau Claude pour utiliser Claude Code sans terminal, sur macOS, Windows et Linux (version bêta sur Linux). Elle demande la même connexion à un compte Claude payant.

#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.

macOS, Linux, Windows (Ollama installé)
ollama launch claude

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.

macOS, Linux (Bash ou Zsh)
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
!
Configuration non prise en charge par Anthropic
La documentation de Claude Code indique qu'Anthropic ne prend pas en charge l'utilisation de Claude Code avec des modèles autres que Claude via une passerelle. Le branchement sur Ollama fonctionne selon la documentation d'Ollama, mais un problème relève d'Ollama, pas du support d'Anthropic. La qualité dépend fortement du modèle local et de la mémoire disponible.
Questions fréquentes
Claude Code est-il gratuit ?+
Le programme Claude Code s'installe gratuitement, mais son utilisation avec les modèles Claude demande un abonnement payant (Pro, Max, Ultra, Team, Enterprise) ou un compte Console payé à l'usage. Selon la documentation d'Anthropic consultée le 18 novembre 2026, le plan gratuit de claude.ai n'inclut pas Claude Code. Le branchement sur un modèle local via Ollama remplace les modèles Claude par un modèle de votre machine, hors du support d'Anthropic.
Faut-il Node.js pour installer Claude Code ?+
Non, Node.js n'est plus nécessaire pour installer Claude Code avec le script natif, Homebrew, WinGet ou les dépôts Linux. Seule la méthode npm demande Node.js 22 ou plus, et la documentation précise que le programme installé est un binaire natif qui n'utilise pas Node.js à l'exécution. Le script natif reste la méthode recommandée.
Faut-il les droits administrateur pour installer Claude Code sous Windows ?+
Non. La documentation d'Anthropic indique que la commande d'installation de Claude Code se lance depuis PowerShell ou CMD sans exécuter le terminal en tant qu'administrateur. Le programme s'installe dans le dossier utilisateur, sous %USERPROFILE%\.local\bin.
Comment installer un plugin sur Claude Code ?+
Dans une session Claude Code, la commande /plugin ouvre un panneau qui liste les plugins des catalogues configurés, et /plugin install suivi du nom et du catalogue, par exemple commit-commands@claude-plugins-official, ouvre la fiche du plugin avant installation. La documentation d'Anthropic rappelle qu'un plugin peut exécuter des hooks et des serveurs MCP : lisez sa fiche avant de l'installer.
Comment bien configurer Claude Code après l'installation ?+
Après l'installation de Claude Code, lancez /init dans votre projet pour générer un fichier CLAUDE.md qui décrit les commandes de compilation, de test et les conventions. Les réglages se modifient avec /config ou dans le fichier ~/.claude/settings.json. La commande claude doctor signale les fichiers de réglages invalides et les problèmes d'installation.
Claude Code fonctionne-t-il hors connexion ?+
Non. La documentation d'Anthropic indique qu'une connexion Internet est obligatoire pour utiliser Claude Code, car les modèles Claude tournent sur les serveurs d'Anthropic. Avec Ollama et un modèle local, les requêtes au modèle restent sur la machine, mais la documentation d'Anthropic ne décrit pas de fonctionnement entièrement hors ligne : considérez ce point comme non garanti.
Comment mettre à jour Claude Code ?+
Une installation native de Claude Code se met à jour seule, au démarrage et en arrière-plan, et claude update force la mise à jour immédiate. Par défaut, les installations Homebrew, WinGet, apt, dnf et apk ne se mettent pas à jour seules : utilisez brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode ou la mise à jour du système Linux. Pour Homebrew et WinGet, la variable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 confie cette mise à 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.

Ce guide vous a aidé ?

Un retour, une erreur, une précision ? Faites-nous signe, ça améliore le guide pour tout le monde.