Installer Claude Code : le guide complet (Windows, macOS, Linux)

Qu'est-ce que Claude Code et pourquoi l'installer ?

Claude Code est l'agent de codage en ligne de commande développé par Anthropic. Contrairement à une extension d'IDE classique, il s'agit d'un outil CLI (Command Line Interface) qui vit directement dans votre terminal et qui comprend l'ensemble de votre codebase. Il peut lire vos fichiers, écrire et modifier du code, exécuter des commandes shell, lancer vos tests et même créer des commits Git, le tout en langage naturel et en français.

Apprendre à install Claude Code est la première étape pour intégrer un assistant agentique à votre flux de travail quotidien. La procédure d'installation est volontairement légère : un gestionnaire de paquets, une seule commande, et l'outil est prêt. Ce guide couvre la claude code installation complète sur les trois systèmes d'exploitation majeurs, du prérequis Node.js jusqu'aux premiers pas avec une clé API ou un abonnement.

Les prérequis avant l'installation

Avant de vous lancer dans le download Claude Code, assurez-vous que votre machine remplit quelques conditions simples. La méthode d'installation principale repose sur npm, le gestionnaire de paquets de Node.js.

Node.js 18 ou plus récent

Claude Code requiert Node.js version 18 ou supérieure. Node.js embarque npm, que vous utiliserez pour l'installation globale. Vérifiez votre version actuelle avec la commande suivante :

node --version
npm --version

Si Node n'est pas installé ou si votre version est antérieure à la 18, téléchargez la dernière version LTS depuis le site officiel nodejs.org. Sur macOS et Linux, beaucoup de développeurs préfèrent passer par un gestionnaire de versions comme nvm, qui évite les problèmes de permissions :

# Installer nvm puis Node LTS
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
nvm use --lts

Un terminal et un compte Anthropic

Vous aurez besoin d'un terminal (PowerShell ou Windows Terminal sous Windows, Terminal sous macOS, n'importe quel shell sous Linux) et d'un compte Anthropic. Deux options d'authentification existent : un abonnement Claude (Pro ou Max), ou une clé API facturée à l'usage via la Console Anthropic. Nous y reviendrons en détail.

Installer Claude Code via npm

La méthode recommandée et la plus universelle consiste à installer le paquet officiel de manière globale avec npm. Ouvrez votre terminal et lancez :

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

Le drapeau -g installe l'outil globalement, ce qui rend la commande claude accessible depuis n'importe quel dossier. L'opération télécharge le paquet et ses dépendances ; comptez quelques dizaines de secondes selon votre connexion.

Règle d'or : n'utilisez jamais sudo pour cette commande. Une installation globale avec sudo crée des problèmes de permissions difficiles à débloquer ensuite. Si npm renvoie une erreur de permission, c'est généralement le signe que Node a été installé via le système plutôt que via nvm. La solution propre consiste à reconfigurer le répertoire global de npm ou à utiliser nvm.

Claude Code sous Windows

La claude code windows est désormais prise en charge nativement. Ouvrez PowerShell ou Windows Terminal et exécutez exactement la même commande npm que ci-dessus :

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

Si vous travaillez déjà dans un environnement Linux sous Windows via WSL2 (Windows Subsystem for Linux), vous pouvez aussi installer Claude Code à l'intérieur de votre distribution WSL : dans ce cas, suivez les instructions Linux. Pour beaucoup de développeurs qui manipulent des projets Node, Python ou Docker, WSL2 reste l'environnement le plus confortable, mais ce n'est plus une obligation.

Claude Code sur macOS et Linux

Sur macOS et Linux, la commande npm est identique. Si vous gérez Node avec nvm, l'installation se passe sans aucun problème de droits. Vous pouvez aussi, sur ces deux systèmes, utiliser le script d'installation natif fourni par Anthropic, qui ne dépend pas de npm :

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

Cette méthode installe un binaire autonome. Elle est pratique si vous ne souhaitez pas gérer Node uniquement pour Claude Code. La méthode npm reste cependant la plus répandue et la plus simple à maintenir à jour pour les développeurs qui ont déjà un environnement JavaScript.

Vérifier que l'installation a réussi

Une fois la claude code install terminée, validez immédiatement que tout fonctionne. La première vérification consiste à afficher le numéro de version :

claude --version

Si un numéro de version s'affiche, la commande claude est bien dans votre PATH et l'installation est opérationnelle. Pour aller plus loin, Claude Code embarque un outil de diagnostic intégré qui contrôle votre environnement, vos permissions et votre configuration :

claude doctor

La commande claude doctor est votre meilleure alliée en cas de souci : elle signale une version de Node trop ancienne, un problème de PATH ou une installation incomplète. Si la commande claude est introuvable après l'installation, fermez puis rouvrez votre terminal pour recharger les variables d'environnement, ou vérifiez que le répertoire global de npm figure bien dans votre PATH avec npm config get prefix.

Authentification : abonnement ou clé API

Claude Code ne sert à rien sans authentification, car il s'appuie sur les modèles Claude d'Anthropic. Vous avez le choix entre deux approches selon votre usage.

Option 1 : se connecter avec un abonnement Claude

Si vous possédez un abonnement Claude Pro ou Max, c'est la voie la plus simple et la plus prévisible côté budget, puisque l'usage est inclus dans votre forfait mensuel. Lancez Claude Code, puis utilisez la commande de connexion :

claude
# Une fois dans l'interface :
/login

La commande /login ouvre votre navigateur pour autoriser la session via votre compte Claude. Au tout premier lancement, Claude Code vous guide d'ailleurs automatiquement vers cette étape de connexion.

Option 2 : utiliser une clé API Anthropic

Pour un usage facturé à la consommation (pay-as-you-go), créez une clé API depuis la Console Anthropic (console.anthropic.com). Définissez ensuite la variable d'environnement ANTHROPIC_API_KEY dans votre shell. Sur macOS et Linux :

export ANTHROPIC_API_KEY="votre-cle-api-ici"

Pour rendre la variable permanente, ajoutez cette ligne à votre fichier ~/.bashrc ou ~/.zshrc. Sous Windows, en PowerShell :

$env:ANTHROPIC_API_KEY = "votre-cle-api-ici"
# Pour la rendre permanente :
setx ANTHROPIC_API_KEY "votre-cle-api-ici"

Ne committez jamais votre clé API dans un dépôt Git et ne la partagez avec personne. Traitez-la comme un mot de passe.

Premiers pas avec Claude Code

Tout est prêt. Placez-vous dans le dossier d'un projet existant et démarrez l'agent :

cd mon-projet
claude

Claude Code analyse le contexte de votre dépôt et vous présente une invite. Vous pouvez alors dialoguer en français : demandez-lui d'expliquer un fichier, de corriger un bug, d'écrire une fonction ou de lancer vos tests. Quelques commandes utiles pour débuter :

• /help — afficher la liste des commandes disponibles.
• /login ou /logout — gérer votre session.
• /clear — réinitialiser le contexte de la conversation.
• /init — générer un fichier CLAUDE.md documentant votre codebase pour mieux guider l'agent.
• /config — ouvrir les paramètres.

Un réflexe précieux dès le départ : créez un fichier CLAUDE.md à la racine de votre projet via /init. Ce fichier sert de mémoire et d'instructions permanentes pour l'agent (conventions de code, commandes de build, contraintes), ce qui améliore nettement la pertinence de ses réponses.

Maintenir Claude Code à jour

Anthropic publie des mises à jour fréquentes. Si vous avez installé via npm, mettez l'outil à jour avec :

npm update -g @anthropic-ai/claude-code

Si vous avez utilisé le script d'installation natif, Claude Code se met généralement à jour automatiquement. La commande claude doctor vous indiquera également si une nouvelle version est disponible. Garder l'outil à jour vous donne accès aux derniers modèles Claude et aux dernières fonctionnalités d'agent.

Résoudre les problèmes courants

Si l'installation échoue, voici les pistes les plus fréquentes. Une erreur de permission sous macOS ou Linux indique presque toujours un Node installé au niveau système : la solution est de réinstaller Node via nvm. Sous Windows, si claude n'est pas reconnu, rouvrez un nouveau terminal pour recharger le PATH. Pour tout autre symptôme, lancez claude doctor : ce diagnostic identifie la cause dans la grande majorité des cas et vous indique la marche à suivre.

Vous savez désormais comment install Claude Code de A à Z, sur n'importe quel système. En moins de cinq minutes, vous avez transformé votre terminal en environnement de développement assisté par l'IA. Il ne reste plus qu'à coder.