Agents IA

Installer Claude Code sur Windows, macOS et Linux

Pour installer Claude Code, une seule commande suffit : le script officiel sur macOS, Linux et WSL, un script PowerShell ou CMD sous Windows. Il faut ensuite un abonnement Claude payant ou un compte Claude Console pour se connecter. Voici chaque étape, des prérequis au premier lancement dans un projet, avec les commandes à copier et les erreurs documentées par Anthropic.

Partager

Sommaire
Logo officiel de Claude : une étoile orange aux rayons irréguliers suivie du mot Claude écrit en noir, centrés sur un fond crème uni.
© Anthropic
Sommaire

En bref

  • Dernière version : Claude Code 2.1.329, publiée le 19 novembre 2026.
  • macOS, Linux et WSL : curl -fsSL https://claude.ai/install.sh | bash. Windows : irm https://claude.ai/install.ps1 | iex dans PowerShell.
  • Il faut un abonnement Pro, Max, Ultra, Team ou Enterprise, ou un compte Claude Console : l’offre gratuite de claude.ai n’inclut pas Claude Code.
  • L’installation native se met à jour seule ; Homebrew, WinGet, apt, dnf et apk se mettent à jour à la main.
  • En cas de souci, claude doctor affiche un diagnostic de l’installation sans ouvrir de session.

Ce qu’il faut avant d’installer Claude Code

Claude Code est l’agent de code d’Anthropic qui travaille dans votre terminal : il lit le dépôt, modifie les fichiers et lance des commandes à votre demande. La documentation officielle fixe ces prérequis :

  • système : macOS 13.0 ou plus récent, Windows 10 1809 ou plus récent, Windows Server 2019 ou plus récent, Ubuntu 20.04 ou plus, Debian 10 ou plus, Alpine Linux 3.19 ou plus ;
  • matériel : 4 Go de mémoire vive au moins, processeur x64 ou ARM64 ;
  • réseau : une connexion Internet, depuis un pays pris en charge par Anthropic ;
  • shell : Bash, Zsh, PowerShell ou CMD.

Côté compte, il faut un abonnement Pro, Max, Ultra, Team ou Enterprise, ou un compte Claude Console, qui donne accès à l’API avec des crédits prépayés. L’offre gratuite de claude.ai ne donne pas accès à Claude Code. Il est aussi possible de passer par un fournisseur d’API tiers : Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft Foundry.

Node.js n’est pas nécessaire avec l’installateur natif, qui télécharge un binaire autonome. Git est facultatif, mais utile pour travailler dans un dépôt versionné.

Installer Claude Code sur macOS et Linux

La méthode recommandée par Anthropic est l’installation native. Ouvrez un terminal et lancez :

Terminal
curl -fsSL https://claude.ai/install.sh | bash

La commande n’affiche aucune progression pendant le téléchargement : c’est normal. Une fois terminée, ouvrez une nouvelle fenêtre de terminal et vérifiez :

Terminal
claude --version

La commande doit afficher un numéro de version suivi de (Claude Code). Le lanceur est placé dans ~/.local/bin/claude et les versions téléchargées dans ~/.local/share/claude/versions/.

Avec Homebrew, deux paquets existent. claude-code suit le canal stable, en général une semaine derrière la dernière publication, sans les versions qui ont connu de grosses régressions. claude-code@latest reçoit chaque version dès sa sortie.

Terminal
brew install --cask claude-code

Avec apt, dnf ou apk

Anthropic publie des dépôts signés pour apt, dnf et apk, chacun avec un canal stable et un canal latest. Pour Debian et Ubuntu, la documentation donne cette séquence sur le canal stable :

Terminal
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

La commande gpg doit afficher une seule empreinte, 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Si curl ou gpg manquent sur une installation neuve, ajoutez-les d’abord avec sudo apt install curl gnupg.

Pour Fedora et RHEL, déclarez le dépôt puis installez le paquet. À la première installation, dnf demande de confirmer l’empreinte de la clé : elle doit être la même que ci-dessus.

Terminal
sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Sur Alpine et les autres distributions basées sur musl, le script d’installation a besoin de bash et curl, absents par défaut, et Claude Code lui-même de bash ou zsh. Installez-les avant de lancer le script :

Terminal
apk add bash curl

Pour passer ensuite par le dépôt apk, sur le canal stable, ajoutez la clé et le dépôt, puis installez le paquet :

Terminal
wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add bash claude-code

Les autres options, comme l’installation d’une version précise ou la vérification de la signature des binaires, figurent dans la documentation d’installation de Claude Code.

Avec npm

L’installation par npm reste possible, mais le README du dépôt la présente désormais comme dépréciée. Elle demande Node.js 22 ou plus récent :

Terminal
npm install -g @anthropic-ai/claude-code@latest

N’utilisez jamais sudo npm install -g : Claude Code se met à jour sans sudo, et une installation qui en a besoin ne peut pas se mettre à jour seule.

Claude Code sur Windows : natif ou WSL ?

Claude Code fonctionne directement sous Windows ou dans WSL. Le choix dépend de l’endroit où se trouvent vos projets et de l’isolation des commandes (sandbox), que seul WSL 2 prend en charge :

Option Prérequis Sandbox Pour qui
Windows natif Aucun, Git for Windows facultatif Non Projets et outils Windows
WSL 2 WSL 2 activé Oui Outils Linux, commandes isolées
WSL 1 WSL 1 activé Non Si WSL 2 est indisponible

En natif, pas besoin de droits d’administrateur. Dans PowerShell, l’invite commence par PS C:\ :

powershell
irm https://claude.ai/install.ps1 | iex

Dans l’invite de commandes CMD, sans le PS devant :

cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Avec l’une ou l’autre de ces commandes, le binaire est placé dans %USERPROFILE%\.local\bin\claude.exe. WinGet fonctionne aussi, avec winget install Anthropic.ClaudeCode, mais ne se met pas à jour seul.

Anthropic recommande d’installer Git for Windows. Il fournit Git Bash, que Claude Code utilise pour son outil Bash. Sans lui, Claude Code exécute les commandes avec PowerShell. Si Git Bash est installé mais introuvable, indiquez son chemin dans votre fichier de réglages settings.json, rangé dans le dossier .claude de votre profil utilisateur :

settings.json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Pour WSL, ouvrez votre distribution et lancez la commande Linux install.sh vue plus haut. Claude Code s’installe et se lance alors dans le terminal WSL, pas depuis PowerShell ou CMD. Git for Windows est inutile dans ce cas.

Première connexion : compte Claude ou clé API

Lancez claude. Au premier démarrage, une fenêtre de navigateur s’ouvre pour vous connecter. Si elle ne s’ouvre pas, appuyez sur c pour copier l’adresse de connexion, puis collez-la dans le navigateur.

Si le navigateur affiche un code au lieu de revenir au terminal, collez-le à l’invite Paste code here if prompted. Le terminal affiche ensuite Login successful : appuyez sur Entrée pour continuer.

Les identifiants sont enregistrés : vous n’aurez plus à vous connecter. Trois cas se présentent :

  • abonnement Claude : connectez-vous avec votre compte claude.ai, l’option recommandée par Anthropic ; avec Team ou Enterprise, utilisez le compte auquel l’administrateur de l’équipe vous a invité ;
  • Claude Console : accès à l’API avec des crédits prépayés ; à la première connexion, un espace de travail « Claude Code » est créé dans la Console pour suivre les coûts ;
  • clé API : si la variable ANTHROPIC_API_KEY est définie et que vous acceptez la clé quand Claude Code vous le demande, l’écran de connexion est sauté.

Depuis le shell, claude auth login permet de se connecter avant la première session. Dans une session, /login change de compte et /logout vous déconnecte.

Pour garder un compte personnel et un compte professionnel, donnez à chacun son dossier de configuration avec CLAUDE_CONFIG_DIR. La documentation propose cet alias pour Bash ou Zsh :

Terminal
alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Premier lancement de Claude Code dans un projet

Placez-vous dans le dossier du projet, puis lancez Claude Code :

Terminal
cd ~/code/mon-projet
claude

L’invite s’affiche sous un en-tête qui rappelle la version, le modèle actif et le dossier de travail. Claude Code lit les fichiers du projet au fil des besoins : inutile de lui fournir le contexte à la main. Commencez par une question sans risque, comme l’exemple de la documentation, what does this project do?.

Capture de la démonstration officielle de Claude Code dans un terminal macOS : en-tête avec la version, le modèle et le dossier de travail, puis une demande d’audit de la couverture de tests en cours de traitement.
© Anthropic

Demandez ensuite une petite modification. Avant d’agir, Claude Code peut demander votre accord : choisissez Yes pour valider. Le mode de permission de la session fixe ce qu’il fait sans demander, et Shift+Tab passe d’un mode à l’autre.

Quelques commandes reviennent souvent :

Commande Effet
claude "tâche" Ouvre une session avec une première demande
claude -p "question" Répond une fois, puis rend la main
claude -c Reprend la dernière conversation du dossier
claude -r Reprend une conversation précédente
/help Liste les commandes, dans la session
/exit Quitte la session

Si vous utilisez aussi l’agent d’OpenAI, notre tutoriel pour installer Codex CLI suit le même parcours.

Mettre à jour Claude Code

L’installation native vérifie les mises à jour au démarrage, puis régulièrement. Elle les télécharge en arrière-plan, et la nouvelle version s’applique au lancement suivant. Pour mettre à jour tout de suite :

Terminal
claude update

Homebrew, WinGet, apt, dnf et apk se mettent à jour à la main. Une installation npm se met à jour seule, à condition d’avoir été faite sans sudo :

Installation Mise à jour automatique Commande
Native (script) Oui claude update pour forcer
Homebrew Non brew upgrade claude-code ou brew upgrade claude-code@latest
WinGet Non winget upgrade Anthropic.ClaudeCode
apt Non sudo apt update && sudo apt upgrade claude-code
dnf Non sudo dnf upgrade claude-code
apk Non apk update && apk upgrade claude-code
npm Oui, si installé sans sudo npm install -g @anthropic-ai/claude-code@latest

Le réglage autoUpdatesChannel choisit le canal de l’installation native : "latest" par défaut, ou "stable", une version d’environ une semaine qui écarte les publications ayant connu de grosses régressions. Un modèle tout juste sorti peut exiger une version plus récente que celle du canal stable : passez alors sur latest.

~/.claude/settings.json
{
  "autoUpdatesChannel": "stable"
}

Pour couper les mises à jour en arrière-plan, ajoutez "DISABLE_AUTOUPDATER": "1" dans la clé env du même fichier ; claude update reste alors disponible. Une fois l’outil à jour, notre article sur Claude Fable 5.2 dans Claude Code explique comment choisir le modèle.

Désinstaller Claude Code

Pour une installation native sur macOS, Linux ou WSL, supprimez le lanceur et les versions :

Terminal
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Sous Windows, dans PowerShell :

powershell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Avec un gestionnaire de paquets, utilisez sa commande :

Installation Désinstallation
Homebrew brew uninstall --cask claude-code (ou claude-code@latest)
WinGet winget uninstall Anthropic.ClaudeCode
apt sudo apt remove claude-code, puis supprimer /etc/apt/sources.list.d/claude-code.list et /etc/apt/keyrings/claude-code.asc
dnf sudo dnf remove claude-code, puis supprimer /etc/yum.repos.d/claude-code.repo
apk apk del claude-code, puis retirer le dépôt de /etc/apk/repositories et la clé /etc/apk/keys/claude-code.rsa.pub
npm npm uninstall -g @anthropic-ai/claude-code

La configuration reste dans ~/.claude et ~/.claude.json. Les effacer supprime vos réglages, les outils autorisés, les serveurs MCP configurés et l’historique des sessions. L’extension VS Code, le module JetBrains et l’application de bureau écrivent aussi dans ~/.claude/ : désinstallez-les d’abord si vous voulez tout retirer.

Sur macOS, Linux ou WSL :

Terminal
rm -rf ~/.claude
rm ~/.claude.json

Sous Windows, dans PowerShell :

powershell
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

Que faire si l’installation échoue ?

La page de dépannage de l’installation associe chaque message d’erreur à sa solution. En voici quelques-uns que vous pouvez rencontrer :

Message Cause Solution
command not found: claude ou 'claude' is not recognized Le dossier d’installation n’est pas dans le PATH Ajouter ~/.local/bin ou %USERPROFILE%\.local\bin au PATH
syntax error near unexpected token '<' Le téléchargement a renvoyé une page HTML au lieu du script Vérifier le réseau, ou passer par une autre méthode d’installation
curl: (22) The requested URL returned error: 403 Proxy ou filtre réseau, ou pays non pris en charge Tester l’accès à downloads.claude.ai, régler le proxy
'irm' is not recognized ou The token '&&' is not a valid statement separator Commande CMD lancée dans PowerShell, ou l’inverse Prendre la commande qui correspond au shell
Killed pendant l’installation sous Linux Mémoire insuffisante Libérer de la mémoire ou ajouter de l’espace d’échange (swap)
App unavailable in region Claude Code n’est pas disponible dans ce pays Consulter la liste des pays pris en charge

Pour corriger le PATH sur Linux avec Bash, ajoutez le dossier puis rechargez la configuration ; avec Zsh, le shell par défaut de macOS, remplacez ~/.bashrc par ~/.zshrc :

Terminal
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Sous Windows, ajoutez le dossier au PATH de l’utilisateur dans PowerShell, puis ouvrez un nouveau terminal :

powershell
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Derrière un proxy d’entreprise, réglez HTTP_PROXY et HTTPS_PROXY avant de relancer l’installation. Pour vérifier que le serveur de téléchargement répond, cette commande doit renvoyer un statut 200 :

Terminal
curl -sI https://downloads.claude.ai/claude-code-releases/latest

Enfin, claude doctor affiche l’état de l’installation, les erreurs des fichiers de réglages et le résultat de la dernière mise à jour, avec des pistes de correction.

Limites et points de vigilance

Un abonnement payant et des quotas

L’installation est libre, l’usage ne l’est pas. Au 20 novembre 2026, l’offre Pro coûte 20 dollars par mois (17 dollars en paiement annuel), Max 100 dollars et Ultra 200 dollars. Sur les offres d’équipe, l’usage de chaque membre se recharge sur une fenêtre glissante de cinq heures et sur une fenêtre hebdomadaire, et il est partagé avec le chat Claude. Avec un compte Claude Console, vous payez au jeton : selon Anthropic, le coût moyen en entreprise tourne autour de 13 dollars par développeur et par jour d’activité.

Des commandes sans isolation par défaut

Le sandbox, qui isole les commandes lancées par Claude Code, est désactivé par défaut, même sous macOS, Linux ou WSL 2. Activez-le avec /sandbox dans une session, ou avec sandbox.enabled dans ~/.claude/settings.json. Il ne couvre que les commandes du shell : les outils de fichiers, les serveurs MCP et les hooks tournent en dehors. Sous Windows natif, il n’existe pas du tout : Claude Code y lance les commandes sans isolation.

Un outil qui change très vite

Du 1er au 19 novembre 2026, douze versions ont été publiées sur npm, de la 2.1.317 à la 2.1.329. Anthropic propose elle-même un canal stable qui écarte les versions ayant connu de grosses régressions : il en était à la 2.1.311. Le dépôt anthropics/claude-code compte 16 422 tickets ouverts sur GitHub, contre 27 821 pour celui de Codex. Sur un poste de travail partagé ou en CI, le canal stable limite les mauvaises surprises.

L’outil lui-même pèse aussi sur la facture. Dans l’étude indépendante FrontierHarness Eval v1.1, publiée par Runta le 17 novembre 2026 sur des modèles ouverts, Claude Code 2.1.308 arrive 21ᵉ sur 22 outils pour le coût par tâche réussie, à 1,55 dollar, contre 0,937 dollar pour Codex CLI. Runta précise toutefois que le modèle explique l’essentiel des écarts de coût, bien plus que l’outil.

Pour qui, pour quoi

Claude Code s’adresse d’abord aux développeurs qui ont déjà un abonnement Claude payant : l’installation native prend une commande, sans Node.js, et se met à jour seule. Sous Windows, préférez WSL 2 si vous voulez isoler les commandes de l’agent. Sans abonnement, un compte Claude Console facturé au jeton fonctionne aussi, mais la moyenne de 13 dollars par jour d’activité citée par Anthropic dépasse vite le prix mensuel de Pro. Si vous hésitez avec l’agent d’OpenAI, notre comparatif entre Codex et Claude Code détaille les différences.

Questions fréquentes

Comment installer Claude Code sans npm ?

Utilisez l’installateur natif, recommandé par Anthropic : curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, irm https://claude.ai/install.ps1 | iex dans PowerShell. Homebrew, WinGet et les dépôts apt, dnf et apk sont d’autres options, et aucune ne demande Node.js. Sur un serveur Linux, les dépôts ont un avantage : les mises à jour de Claude Code arrivent avec celles du reste du système.

Claude Code fonctionne-t-il sous Windows sans WSL ?

Oui. Claude Code s’installe nativement sous Windows 10 1809 ou plus récent, depuis PowerShell ou CMD sans droits d’administrateur, ou avec WinGet. Avec Git for Windows, il utilise Git Bash pour ses commandes, sinon PowerShell. L’isolation des commandes (sandbox) demande en revanche WSL 2.

Claude Code est-il inclus dans l’offre gratuite de Claude ?

Non, l’offre gratuite de claude.ai n’inclut pas Claude Code. Il faut un abonnement Pro, Max, Ultra, Team ou Enterprise, ou un compte Claude Console, qui donne accès à l’API avec des crédits prépayés.

Où trouver la documentation officielle de Claude Code ?

La documentation de Claude Code est publiée sur code.claude.com/docs, avec une version en français. Le suivi des problèmes et le journal des modifications se trouvent sur le dépôt GitHub anthropics/claude-code. Dans le terminal, /help liste les commandes disponibles. Nos autres articles sur ces outils sont réunis dans la rubrique agents IA.

Partager cet article