Installer Claude Code : Mac, Windows, Linux, VS Code

Pour installer Claude Code, ouvrez un terminal et lancez la commande d'installation native de votre système : curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, ou irm https://claude.ai/install.ps1 | iex dans PowerShell sur Windows. Une fois le terminal rouvert, claude --version confirme l'installation, et claude lance la connexion à votre compte. Il faut un abonnement Pro, Max, Team ou Enterprise, ou un compte Console : le plan gratuit n'inclut pas Claude Code.

Ce tutoriel couvre l'installation pas à pas sur Mac, Windows (natif et WSL) et Linux, l'extension VS Code, le plugin JetBrains, les premières commandes, le déploiement sur les postes d'une équipe et les erreurs d'installation les plus courantes. Les commandes et prérequis ci-dessous sont recoupés avec la documentation officielle de Claude Code, consultée le 4 octobre 2026. Elle évolue vite : en cas de doute, c'est elle qui fait foi.

1. Prérequis : système, compte et abonnement

Avant de lancer la moindre commande, trois choses à vérifier : que votre machine est prise en charge, que vous avez un compte éligible, et que vous êtes dans un pays couvert par Anthropic.

Quel abonnement choisir pour démarrer

Tout abonnement payant donne accès à Claude Code. Un compte Console, facturé à l'usage via l'API, convient aussi. Pour une équipe, le choix entre Pro, Max, Team et Enterprise dépend surtout du volume d'usage et de la gestion centralisée des accès : notre comparatif des abonnements Claude Pro, Max, Team et Enterprise détaille les différences.

Node.js n'est plus nécessaire

Les anciens tutoriels demandent d'installer Node.js puis npm install -g. Ce n'est plus le chemin recommandé : l'installation native ne dépend pas de Node.js. Le paquet npm existe toujours (il demande Node.js 22 ou plus), mais il installe le même binaire natif.

2. Installer Claude Code sur Mac

Sur macOS 13 ou plus récent, ouvrez l'application Terminal et collez :

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

Fermez puis rouvrez le terminal et vérifiez :

claude --version

Un numéro de version s'affiche si tout est en ordre. Si votre shell répond que claude est introuvable, le dossier d'installation n'est pas encore dans votre PATH (voir la section dépannage).

L'alternative Homebrew

Si vous gérez déjà vos outils avec Homebrew, la commande est brew install --cask claude-code. Ce cask suit le canal stable, en général environ une semaine derrière la dernière version. Le cask claude-code@latest reçoit les nouvelles versions dès leur sortie. Point d'attention : une installation Homebrew ne se met pas à jour toute seule, il faut lancer brew upgrade claude-code de temps en temps.

3. Installer Claude Code sur Linux

Sur Ubuntu, Debian ou toute distribution compatible, la commande est la même que sur Mac :

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

Elle place le lanceur dans ~/.local/bin/claude et les versions dans ~/.local/share/claude/versions/. Les mises à jour se font ensuite en arrière-plan.

Paquets apt, dnf et apk

Pour les environnements où l'on préfère le gestionnaire de paquets système, Anthropic publie des dépôts signés pour apt (Debian, Ubuntu), dnf (Fedora, RHEL) et apk (Alpine), avec un canal stable et un canal latest. Les étapes exactes (ajout de la clé de signature, vérification de son empreinte, déclaration du dépôt) sont détaillées dans la section Linux de la documentation : mieux vaut les suivre à la lettre que les recopier de mémoire. Ces installations ne se mettent pas à jour via Claude Code, mais par le processus de mise à jour normal du système.

Cas particulier d'Alpine

Alpine n'embarque ni bash ni curl par défaut, et il faut aussi libgcc, libstdc++ et ripgrep à l'exécution. La documentation indique de les installer avec apk, puis de régler la variable USE_BUILTIN_RIPGREP à 0 dans le fichier settings.json.

4. Installer Claude Code sur Windows : natif ou WSL

Sur Windows, deux voies fonctionnent. Le choix dépend de l'endroit où vivent vos projets et de ce que vous attendez de l'outil.

Windows natif : PowerShell ou CMD

Dans PowerShell (l'invite commence par PS C:\) :

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

Dans CMD (invite sans PS) :

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

Pas besoin de lancer le terminal en administrateur. Si PowerShell répond The token '&&' is not a valid statement separator, vous avez collé la commande CMD dans PowerShell. Si CMD répond que irm n'est pas reconnu, c'est l'inverse. Une troisième voie existe : winget install Anthropic.ClaudeCode, sans mise à jour automatique.

Git for Windows est recommandé mais pas obligatoire. Avec lui, Claude Code utilise Git Bash pour son outil Bash. Sans lui, il exécute ses commandes via PowerShell. Si Git Bash est installé mais introuvable, la variable CLAUDE_CODE_GIT_BASH_PATH du fichier settings.json permet d'indiquer le chemin de bash.exe. Le programme d'installation est disponible sur git-scm.com.

WSL : installer et lancer dans le terminal Linux

Ouvrez votre distribution WSL (Ubuntu par exemple) et lancez la commande Linux de la section précédente. Point souvent mal compris : on installe et on lance claude depuis le terminal WSL, pas depuis PowerShell ni CMD. Les projets doivent de préférence se trouver dans le système de fichiers Linux de WSL.

5. Extension VS Code et plugin JetBrains

La question « Claude Code VS Code » recouvre deux usages : lancer claude dans le terminal intégré de VS Code, ou utiliser l'extension, qui ajoute une interface graphique. La documentation présente l'extension comme la méthode recommandée dans VS Code.

Extension VS Code (et Cursor)

Il faut VS Code 1.94.0 ou plus récent et un compte éligible (aucune clé d'API requise). Dans VS Code, ouvrez la vue Extensions (Cmd+Shift+X sur Mac, Ctrl+Shift+X sous Windows et Linux), cherchez « Claude Code » et cliquez sur Installer. L'identifiant de l'extension est anthropic.claude-code. Elle s'installe aussi dans Cursor et dans d'autres forks de VS Code.

Une fois installée, l'icône Spark en haut à droite de l'éditeur (visible quand un fichier est ouvert) ouvre le panneau Claude. L'extension apporte :

• Des diffs en ligne : chaque modification proposée s'affiche dans l'éditeur avant acceptation.
• Des @-mentions : Option+K (Mac) ou Alt+K (Windows et Linux) insère une référence au fichier et aux lignes sélectionnées.
• La revue de plan : on relit et on corrige le plan de l'agent avant qu'il touche au code.
• Plusieurs conversations en onglets ou en fenêtres séparées.

Plugin JetBrains

Pour IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand ou Android Studio, il faut deux éléments : le CLI claude installé comme ci-dessus, puis le plugin Claude Code (bêta) depuis la JetBrains Marketplace, suivi d'un redémarrage de l'IDE. Le plugin ne contient pas le CLI. Lancez ensuite claude dans le terminal intégré de l'IDE, ou utilisez la commande /ide depuis un terminal externe pour le connecter. Le raccourci Cmd+Esc (Mac) ou Ctrl+Esc ouvre Claude Code depuis l'éditeur.

6. Premier lancement, connexion et premières commandes

Placez-vous dans le dossier d'un projet, puis lancez :

cd mon-projet
claude

Au premier lancement, Claude Code ouvre votre navigateur pour la connexion à votre compte. Si la variable d'environnement ANTHROPIC_API_KEY est définie, il vous demande une seule fois d'approuver la clé au lieu d'ouvrir le navigateur. Pour les connexions par compte d'entreprise ou par fournisseur tiers, la page Authentication de la documentation liste toutes les options.

Quelques commandes pour bien démarrer

• claude --version : affiche la version installée.
• claude doctor : diagnostic en lecture seule de l'installation et des réglages, sans lancer de session.
• claude update : applique une mise à jour tout de suite.
• /help : liste les commandes disponibles dans la session.
• /init : génère un premier fichier CLAUDE.md décrivant votre projet.
• /config : ouvre les réglages, dont le canal de mise à jour.
• /ide : connecte la session à un IDE JetBrains ouvert.

La toute première demande à faire est la plus banale : « explique-moi la structure de ce dépôt ». Elle ne modifie rien, elle vérifie que l'outil lit bien votre code, et elle montre comment il raisonne. Ensuite seulement, passez à une petite tâche réelle (un bug connu, un test manquant) en gardant Git comme filet de sécurité.

Le fichier CLAUDE.md généré par /init n'est qu'un point de départ. Pour qu'il serve vraiment une équipe, lisez notre guide sur le fichier CLAUDE.md pour une équipe de développement. Pour la vue d'ensemble de l'outil et de ses usages, notre guide Claude Code sert de point d'entrée.

7. Déployer Claude Code sur les postes d'une équipe

Installer l'outil sur un poste prend deux minutes. L'installer proprement sur vingt postes, avec les mêmes réglages et sans mises à jour imprévues, demande de décider quelques points à l'avance.

Deux pièges reviennent dans les entreprises. D'abord, les répertoires personnels sur stockage réseau (NFS par exemple) : un exécutable supprimé ou tronqué pendant qu'une session tourne sur une autre machine fait planter cette session. La documentation recommande d'installer en local et de couper les mises à jour automatiques dans ce cas. Ensuite, le modèle récent qui exige une version de Claude Code plus récente que celle du canal stable : il faut alors passer sur le canal latest.

Le déploiement technique n'est que la moitié du sujet. La conduite du changement (qui relit le code produit par l'agent, quelles permissions par défaut, quel contexte partagé) est traitée dans notre article sur le déploiement de Claude Code dans une équipe de développement. Pour la question des données qui quittent le poste, voir la sécurité des données avec Claude Code en entreprise.

8. Problèmes fréquents et comment les corriger

La commande claude est introuvable

C'est le cas le plus courant. Rouvrez d'abord un terminal : le PATH n'est relu que dans une nouvelle fenêtre. Sur Mac et Linux, le lanceur se trouve dans ~/.local/bin/claude ; vérifiez que ~/.local/bin figure dans votre PATH. Si le problème persiste, la page officielle de dépannage associe chaque message d'erreur à sa correction.

Erreur au téléchargement du script

Un message du type syntax error near unexpected token '<' ou une erreur 403 indique en général que le script n'a pas été récupéré (réseau d'entreprise, proxy, accès filtré). Vérifiez que votre poste peut joindre claude.ai. Dans un environnement filtré, passez par Homebrew, WinGet, un gestionnaire de paquets système ou le paquet npm.

Erreurs de permission avec npm

Si vous avez choisi la voie npm, n'utilisez jamais sudo npm install -g : la documentation le déconseille expressément pour des raisons de permissions et de sécurité. Préférez l'installation native, ou corrigez le dossier global de npm. Pour mettre à jour une installation npm, utilisez npm install -g @anthropic-ai/claude-code@latest plutôt que npm update -g.

Deux installations qui se télescopent

Si claude répond avec une ancienne version après une mise à jour, une seconde installation (npm puis native, par exemple) ou un alias hérité d'un ancien installateur masque la bonne. claude doctor signale ce genre de conflit, et la documentation décrit la marche à suivre pour désinstaller proprement chaque méthode.

Questions fréquentes sur l'installation de Claude Code