Installer Claude Code — Claude Code 101

L’installation de Claude Code tient en une commande. Cette leçon vous donne la bonne selon votre système, les autres méthodes possibles et les deux vérifications à faire avant votre première session. Si vous préférez une interface graphique au terminal, la fin de la leçon présente l’application de bureau, les extensions d’éditeur et la version web.

Ce qu’il vous faut

D’après la documentation, Claude Code fonctionne sur :

macOS 13.0 ou plus récent ;
Windows 10 version 1809 ou plus récent, ou Windows Server 2019 ou plus récent ;
Linux : Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ ;
une machine avec 4 Go de mémoire au moins et un processeur x64 ou ARM64 ;
une connexion internet et un shell Bash, Zsh, PowerShell ou CMD ;
depuis un pays où Anthropic est disponible.

Git est facultatif, mais vous en aurez besoin pour tout ce qui touche aux commits et aux branches.

L’installation recommandée

La méthode recommandée est l’installeur natif. Ouvrez un terminal et lancez la commande de votre système.

Sur macOS, Linux ou WSL :

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

Sous Windows, dans PowerShell (l’invite commence par PS C:\) :

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

Sous Windows, dans l’invite de commandes CMD (l’invite commence par C:\, sans PS) :

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

La commande n’affiche aucune progression pendant le téléchargement : c’est normal. Quand elle a fini, ouvrez une nouvelle fenêtre de terminal, puis vérifiez que la commande claude répond. Si votre shell dit que claude est introuvable, le dossier d’installation n’est pas encore dans votre PATH : la page de dépannage officielle explique comment l’y ajouter. Deux erreurs typiques sous Windows trahissent le mauvais shell : The token '&&' is not a valid statement separator signifie que vous êtes dans PowerShell et non dans CMD ; 'irm' is not recognized signifie l’inverse.

L’installation native se met à jour toute seule, en arrière-plan.

Les autres méthodes

Selon vos habitudes, vous pouvez aussi passer par un gestionnaire de paquets :

Méthode	Commande	Mises à jour
Homebrew	`brew install --cask claude-code`	Manuelles : `brew upgrade claude-code`
WinGet (Windows)	`winget install Anthropic.ClaudeCode`	Manuelles : `winget upgrade Anthropic.ClaudeCode`
apt, dnf, apk (Debian, Fedora, RHEL, Alpine)	Dépôts signés publiés par Anthropic	Avec les mises à jour du système
npm	`npm install -g @anthropic-ai/claude-code`	`npm install -g @anthropic-ai/claude-code@latest`

Deux précisions. Le cask Homebrew claude-code suit le canal stable, en général une semaine derrière, sans les versions qui ont eu des régressions majeures ; claude-code@latest suit le canal le plus récent. Le paquet npm demande Node.js 22 ou plus récent et installe le même binaire natif que l’installeur ; la documentation insiste : n’utilisez jamais sudo npm install -g, qui crée des problèmes de droits et de sécurité.

Le cas de Windows

Sous Windows, vous avez le choix entre une installation native et WSL (le sous-système Linux). L’installation native convient aux projets et outils Windows ; WSL 2 convient aux chaînes d’outils Linux et c’est la seule option qui permet l’exécution des commandes dans un bac à sable (sandboxing). Sur Windows natif, installez Git for Windows : Claude Code peut alors utiliser l’outil Bash ; sans lui, il se sert de PowerShell.

Vérifier l’installation

Deux commandes, dans un terminal :

claude --version
claude doctor

La première affiche un numéro de version, comme 2.1.211 (Claude Code). La seconde fait un diagnostic en lecture seule, sans ouvrir de session : santé de l’installation, erreurs dans les fichiers de réglages, résultat de la dernière mise à jour automatique.

Se connecter

Placez-vous dans le dossier d’un projet et lancez claude. À la première utilisation, Claude Code vous demande de vous connecter : suivez les instructions qui s’ouvrent dans votre navigateur. Vous pouvez utiliser un abonnement Pro, Max, Ultra, Team ou Enterprise (l’option recommandée) ou un compte Claude Console, c’est-à-dire un accès API avec des crédits prépayés ; dans ce cas, un espace de travail « Claude Code » est créé automatiquement dans la Console pour suivre les coûts au même endroit. Si la variable d’environnement ANTHROPIC_API_KEY est définie et que vous acceptez d’utiliser cette clé quand Claude Code vous le demande, la connexion par navigateur est sautée.

Les mises à jour

Une installation native vérifie les mises à jour au démarrage et pendant l’utilisation, les télécharge en arrière-plan et les applique au lancement suivant. Deux canaux existent : latest, par défaut, qui reçoit chaque nouveauté dès sa sortie, et stable, qui sert une version d’environ une semaine. Vous choisissez dans /config (Auto-update channel) ou avec le réglage autoUpdatesChannel. Pour mettre à jour tout de suite, lancez claude update.

Sans terminal : les autres surfaces

Application de bureau : téléchargez l’application Claude pour macOS, Windows ou Windows ARM64 (Linux en bêta sur Ubuntu et Debian), connectez-vous et ouvrez l’onglet Code. Claude Code y est inclus ; un abonnement payant est nécessaire.
VS Code : cherchez « Claude Code » dans la vue Extensions (Ctrl+Maj+X, ou Cmd+Maj+X sur Mac), installez-la, puis ouvrez la palette de commandes, tapez « Claude Code » et choisissez Open in New Tab. L’extension s’installe aussi dans Cursor.
JetBrains : installez le plugin Claude Code depuis la JetBrains Marketplace et redémarrez l’IDE ; le CLI doit être installé à part.
Web : ouvrez claude.ai/code, rien à installer.

D'après la leçon « Installing Claude Code » (Claude Academy, Claude Code 101) et la page Advanced setup (documentation Claude Code).

À vous de jouer

Installer et vérifier. Installez Claude Code avec l’installeur natif de votre système, ouvrez un nouveau terminal, puis lancez claude --version et claude doctor. Notez le canal de mise à jour et l’état des mises à jour automatiques indiqués par claude doctor, puis ouvrez une première session avec claude pour vous connecter.

Sources officielles : Installing Claude Code (Claude Academy) · Advanced setup · Quickstart · Overview

Points clés à retenir

Installeur natif recommandé : curl -fsSL https://claude.ai/install.sh | bash (macOS, Linux, WSL) ou irm https://claude.ai/install.ps1 | iex (PowerShell) ; il se met à jour seul
Homebrew, WinGet, apt/dnf/apk et npm (Node.js 22+, jamais avec sudo) sont possibles, avec des mises à jour manuelles
claude --version puis claude doctor pour vérifier ; ouvrez un nouveau terminal après l’installation
Connexion au premier lancement de claude, avec un abonnement Pro, Max, Ultra, Team, Enterprise ou un compte Console