Aller au contenu
Mastering Claude

Accueil / Une installation structurée

Une installation structurée10 minApplication

Installer, se connecter et premier lancement

L'installateur natif de Claude Code se met à jour tout seul, la connexion se fait par un abonnement Pro, Max, Team, Enterprise ou Console plutôt que par une clé API oubliée dans l'environnement, et claude doctor rend un diagnostic en lecture seule avant toute correction.

Quatre commandes installent Claude Code selon le système d'exploitation, mais une seule se met à jour toute seule. Sur macOS, Linux et WSL, la commande native est curl -fsSL https://claude.ai/install.sh | bash. Sur PowerShell, c'est irm https://claude.ai/install.ps1 | iex. La documentation d'Anthropic, relevée le 2 septembre 2026, précise que les installations natives se mettent à jour automatiquement en arrière-plan pour rester sur la dernière version.

Trois autres méthodes, sans mise à jour automatique

Homebrew installe Claude Code par brew install --cask claude-code, avec deux canaux possibles selon le cask choisi, la version stable ou la dernière en date, mais aucun des deux ne se met à jour tout seul. WinGet, sur Windows, propose winget install Anthropic.ClaudeCode, même constat. npm installe la version globale par npm install -g @anthropic-ai/claude-code, et le paquet exige depuis la version 2.1.198 de Claude Code Node.js 22 ou plus récent, sans que ce soit bloquant sur une version plus ancienne : npm affiche alors un avertissement EBADENGINE pendant l'installation, mais celle ci se termine et claude fonctionne quand même, le paquet téléchargeant un binaire natif qui n'utilise pas Node.js à l'exécution. Ces trois méthodes conviennent quand un gestionnaire de paquets existe déjà sur le poste et doit rester la seule source de vérité sur ce qui y est installé, au prix d'une mise à jour à relancer soi-même.

Se connecter par l'abonnement, pas par une clé oubliée

Claude Code exige un compte Pro, Max, Team, Enterprise ou Console, le forfait gratuit de Claude.ai n'ouvre pas cet accès, selon la même documentation, qui ajoute une alternative distincte de l'abonnement, un fournisseur d'API tiers comme Amazon Bedrock, Google Cloud Agent Platform ou Microsoft Foundry. Une clé ANTHROPIC_API_KEY déjà présente dans l'environnement du poste n'est ni ignorée ni utilisée en silence : Claude Code demande une seule fois de l'approuver, au lieu d'ouvrir un navigateur pour la connexion par abonnement. Lancez le premier appel depuis le dossier du projet que vous voulez que Claude lise, l'invite de connexion apparaît à ce moment-là, avant la première réponse.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows, PowerShell
irm https://claude.ai/install.ps1 | iex

# Diagnostic en lecture seule, sans ouvrir de session
claude doctor

Le premier réflexe après l'installation

La commande claude doctor, ou son alias /checkup depuis l'intérieur d'une conversation, vérifie l'état de l'installation, les doublons, les problèmes de PATH, les fichiers de réglages illisibles, et propose une correction seulement après avoir rapporté ce qu'elle a trouvé. Depuis le terminal, elle reste en lecture seule et ne démarre aucune session. C'est le point de départ le plus fiable pour juger d'une installation avant de construire quoi que ce soit dessus, plutôt que de deviner à partir d'un message d'erreur isolé. La carte du module situe ce premier élément, le moteur installé et connecté, avant les six autres.

Figure 1

Quatre méthodes d'installation, côte à côte

Méthode d'installationMise à jourPortéePréalable
Installateur natif (curl / irm)Automatique, en arrière-planCompte utilisateur courant du posteAucun gestionnaire de paquets requis
Homebrew (macOS)Manuelle, par brew upgradeDépend du cask choisi, stable ou latestHomebrew déjà installé sur le poste
WinGet (Windows)Manuelle, par winget upgradeCompte Windows courantWinGet déjà installé sur le poste
npm globalManuelle, par npm update -gPortée du gestionnaire Node du posteNode.js 22 ou plus récent depuis la version 2.1.198, non bloquant, avertissement EBADENGINE sinon
Le tableau croise chaque méthode d'installation avec sa mise à jour, sa portée et son préalable, pour montrer que seule la méthode native se met à jour sans commande relancée à la main.
Calibrez vous-même

Un administrateur installe Claude Code sur un poste avec la commande curl fournie par la documentation, puis lance claude pour la première fois depuis le dossier de son projet. L'invite de connexion lui propose plusieurs options, et il choisit son compte Pro existant.

Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.

Ce qu’il faut retenir
  • L'installateur natif se met à jour tout seul en arrière-plan, alors que Homebrew, WinGet et npm exigent chacun une commande de mise à jour relancée à la main.
  • Un compte Claude Code exige un abonnement Pro, Max, Team, Enterprise ou Console, le forfait gratuit de Claude.ai n'ouvre pas cet accès.
  • Une clé ANTHROPIC_API_KEY déjà présente dans l'environnement n'est pas ignorée ni utilisée en silence, elle déclenche une demande d'approbation unique à la place de l'ouverture du navigateur.
  • La commande claude doctor pose un diagnostic en lecture seule sans ouvrir de session, et son alias /checkup déclenche le même contrôle depuis l'intérieur d'une conversation.
  • Depuis la version 2.1.198, npm demande Node.js 22 ou plus récent sans que ce soit bloquant : sur une version plus ancienne, l'installation se termine quand même derrière un avertissement EBADENGINE.
À faire maintenant

Lancez claude doctor dans votre terminal maintenant et notez les trois premières lignes qu'il affiche, avant de corriger quoi que ce soit : c'est votre point de départ mesuré pour le reste de la carte.

Vérifier à la source

Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.