Installer Claude Code (macOS, Windows, Linux) et le configurer

Avant de confier des tâches à Claude Code, il faut l'installer, connecter votre compte et poser quelques réglages. Cette leçon suit l'ordre réel d'une première installation, système par système, et se termine par les réglages qui évitent les frictions dès la deuxième session.

Avant d'installer : les prérequis

Claude Code est un outil en ligne de commande qui tourne sur une machine récente, sans matériel particulier :

• Systèmes : macOS 13 ou plus récent, Windows 10 (version 1809) ou Windows Server 2019 et au-delà, Ubuntu 20.04+, Debian 10+, Alpine 3.19+ ;
• Machine : 4 Go de mémoire vive au minimum, processeur x64 ou ARM64 ;
• Réseau : une connexion internet permanente (le modèle tourne côté Anthropic, pas sur votre poste) ;
• Terminal : Bash, Zsh, PowerShell ou CMD.

Il faut aussi un compte qui donne accès à Claude Code : abonnement Pro, Max, Team ou Enterprise, ou compte Console facturé à l'usage via une clé API. L'offre gratuite de claude.ai ne suffit pas. Autrement dit, l'installation est gratuite, l'usage ne l'est pas.

Installer Claude Code : la commande selon votre système

La méthode recommandée est l'installateur natif : une seule commande, et des mises à jour automatiques ensuite.

macOS, Linux et WSL

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

Windows (PowerShell)

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

Windows (invite de commandes CMD)

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

Deux erreurs trahissent un mauvais terminal sous Windows : un message sur le jeton && signifie que vous êtes dans PowerShell et non dans CMD ; « irm n'est pas reconnu » signifie l'inverse. L'invite de PowerShell commence par PS.

Alternatives : Homebrew, WinGet, npm

La cask Homebrew claude-code suit le canal « stable » (une version d'environ une semaine, sans les régressions majeures) ; claude-code@latest suit chaque publication.

Windows : natif ou WSL ?

Claude Code fonctionne désormais nativement sous Windows, sans droits administrateur. Le choix dépend surtout de l'endroit où vivent vos projets :

• Windows natif : pour des projets et outils Windows. Git for Windows est facultatif mais utile : il fournit Git Bash, que Claude Code utilise pour exécuter ses commandes shell. Sans lui, c'est PowerShell qui sert d'outil d'exécution.
• WSL 2 : pour une chaîne d'outils Linux, et c'est la seule option sous Windows qui prend en charge le sandboxing (exécution isolée des commandes). On installe et on lance alors claude dans le terminal WSL, avec la commande Linux.

Vérifier l'installation

Ouvrez un nouveau terminal (pour qu'il relise le PATH), puis :

# Affiche le numéro de version si l'installation a réussi
claude --version
 
# Diagnostic complet, sans ouvrir de session
claude doctor

claude doctor contrôle l'installation, valide vos fichiers de réglages et signale les problèmes avec une piste de correction. Si claude reste introuvable, le dossier d'installation n'est pas dans votre PATH : c'est la panne la plus fréquente, et la documentation officielle détaille la correction pour chaque système.

Authentifier votre compte

Placez-vous dans le dossier du projet et lancez simplement claude. Au premier démarrage, l'outil ouvre votre navigateur pour relier la session du terminal à votre compte. Si la variable d'environnement ANTHROPIC_API_KEY est définie, Claude Code vous propose plutôt d'utiliser cette clé.

L'authentification se fait une fois : un jeton est conservé localement. Ne le partagez jamais et ne versionnez aucune clé dans un dépôt.

Premier test

Une fois connecté, demandez par exemple à l'assistant de résumer le README ou de décrire l'arborescence du projet. Une réponse cohérente confirme que tout fonctionne, de l'authentification à la lecture des fichiers.

Mettre à jour (et désinstaller)

L'installation native se met à jour en arrière-plan ; la nouvelle version s'applique au démarrage suivant. Pour forcer la mise à jour :

claude update

Si vous préférez des versions éprouvées, le réglage autoUpdatesChannel accepte "stable" au lieu de "latest" (valeur par défaut). Pour désinstaller, supprimez le binaire selon votre méthode d'installation ; les réglages et l'historique vivent à part, dans ~/.claude et ~/.claude.json.

Configurer vos réglages

Claude Code lit des fichiers settings.json qui ajustent son comportement : permissions, variables d'environnement, canal de mise à jour. On distingue deux portées principales.

• Réglages de projet (.claude/settings.json) : versionnés avec le dépôt, ils s'appliquent à toute l'équipe et garantissent un comportement cohérent.
• Réglages personnels (~/.claude/settings.json) : locaux à votre machine, ils restent privés.

Un fichier de réglages ressemble à ceci :

{
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(npm run build)"]
  },
  "env": {
    "NODE_ENV": "development"
  }
}

Ici, on autorise explicitement deux commandes fréquentes pour éviter de les confirmer à chaque exécution, et on fixe une variable d'environnement. Commencez minimal : ajoutez des règles au fil des besoins réels. Un modèle de permissions prêt à l'emploi est disponible dans nos ressources.

Préparer votre premier projet

Avant de lancer une vraie tâche, deux gestes paient immédiatement. D'abord, ajoutez un fichier CLAUDE.md à la racine : il donne le contexte durable du projet. C'est l'objet de la leçon sur le fichier CLAUDE.md. Ensuite, assurez-vous que votre dépôt Git est propre, sans modifications en attente, pour relire facilement les diffs produits par l'assistant.

Anatomie d'une bonne session de départ

Une session productive suit souvent ce schéma : vous décrivez l'objectif, l'assistant explore le code, propose un plan, puis applique les changements par étapes que vous validez. Plus le contexte initial est clair, moins l'assistant fait d'hypothèses hasardeuses.

En résumé

Une commande suffit pour installer Claude Code sur macOS, Linux ou Windows ; claude --version et claude doctor confirment que tout va bien, et la première session vous connecte à votre compte. La prochaine étape consiste à comprendre comment l'assistant gère sa mémoire de travail : rendez-vous dans la leçon sur le contexte et la fenêtre de contexte, ou gardez sous la main notre aide-mémoire des commandes.

Pour situer cette compétence dans un parcours plus large, explorez les autres cours disponibles ou visez la certification Certified Architect.