Installer Claude Code en 2026 : le guide complet

Installer Claude Code prend deux minutes. Le déployer dans une équipe sans y laisser des identifiants, du budget non maîtrisé et du code jamais relu, c'est un autre sujet.

La commande d'installation tient en une ligne, et la documentation d'Anthropic est claire. Ce qui coince en entreprise, ce n'est jamais l'installation : c'est le choix de la méthode, la gestion des versions sur plusieurs postes, et la question que personne ne pose avant le premier incident — qu'est-ce qui part exactement chez Anthropic quand un développeur lance l'outil sur le dépôt d'un client ?

Ce guide couvre les deux : la procédure exacte, testée, et ce que CZ Multimédia met en place quand une équipe passe de « un dev curieux » à « cinq personnes en production ».

La réponse directe

Sur macOS, Linux et WSL, une seule commande suffit :

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

Sur Windows PowerShell :

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

Puis tu ouvres un terminal dans ton projet et tu lances claude. C'est la méthode native, celle qu'Anthropic recommande, et la seule qui se met à jour toute seule en arrière-plan. Comptez 4 Go de RAM minimum et un compte Pro, Max, Team, Enterprise ou Console — le plan gratuit de Claude.ai ne donne pas accès à Claude Code.

Pour un cadrage sur ton projet : Contactez-nous

Sommaire

• De quoi as-tu besoin avant de lancer la commande ?
• Installer sur macOS, Linux et WSL
• Windows : natif ou WSL 2 ?
• npm, Homebrew, WinGet : quand les préférer
• Vérifier que l'installation est saine
• Maîtriser les mises à jour dans une équipe
• Ce que la documentation ne dit pas sur le déploiement en entreprise

De quoi as-tu besoin avant de lancer la commande ?

Trois choses : un système supporté, 4 Go de RAM, et un abonnement payant. C'est le troisième point qui surprend le plus souvent.

Les systèmes officiellement supportés sont macOS 13.0 et plus, Windows 10 version 1809 et plus (ou Windows Server 2019+), Ubuntu 20.04+, Debian 10+ et Alpine Linux 3.19+. Côté matériel, il faut un processeur x64 ou ARM64 et au moins 4 Go de mémoire vive. Le shell peut être Bash, Zsh, PowerShell ou CMD.

Le point qui bloque en entreprise : Claude Code exige un compte Pro, Max, Team, Enterprise ou Console. Le plan gratuit de Claude.ai ne suffit pas. Si ta DSI préfère passer par un fournisseur cloud existant, l'outil fonctionne aussi avec Amazon Bedrock, Google Cloud ou Microsoft Foundry — la facturation suit alors le contrat cloud plutôt qu'un abonnement Anthropic.

Installer sur macOS, Linux et WSL

L'installateur natif est la méthode à privilégier : il ne dépend pas de Node.js et il se met à jour tout seul.

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

Une fois l'installation terminée, ouvre un terminal dans le projet sur lequel tu veux travailler et lance :

claude

Claude Code démarre une session interactive dans ton terminal. Au premier lancement, il ouvre ton navigateur pour l'authentification. Si la variable d'environnement ANTHROPIC_API_KEY est déjà définie, il te demande simplement de valider cette clé au lieu d'ouvrir un navigateur.

Sur macOS et Linux, l'installateur natif gère un lanceur dans ~/.local/bin/claude, qui pointe vers les versions installées dans ~/.local/share/claude/versions/. C'est un détail utile à connaître le jour où tu dois auditer ce qui tourne réellement sur un poste.

Tu peux aussi choisir ton canal dès l'installation. Pour la version stable plutôt que la dernière :

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

Ou une version précise, ce qui est souvent ce que veut une équipe :

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

Sur Alpine et les distributions basées sur musl, il faut installer quelques dépendances d'abord (bash, curl, libgcc, libstdc++, ripgrep) puis désactiver le ripgrep embarqué en passant USE_BUILTIN_RIPGREP à 0 dans le fichier de réglages. Sans ça, la commande d'installation échoue avec un not found peu explicite.

Windows : natif ou WSL 2 ?

C'est le seul vrai arbitrage de ce guide, et il ne se joue pas sur le confort : il se joue sur le bac à sable.

Depuis PowerShell :

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

Depuis CMD :

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

Aucun droit administrateur n'est nécessaire. Si tu vois l'erreur The token '&&' is not a valid statement separator, tu es dans PowerShell alors que tu as copié la commande CMD — ton invite affiche PS C:\ en PowerShell et C:\ sans le PS en CMD.

Le tableau de décision est simple :

Sur Windows natif, installer Git for Windows est optionnel mais recommandé : il fournit Git Bash, ce qui permet à Claude Code d'utiliser l'outil Bash. Sans lui, l'outil se rabat sur PowerShell.

npm, Homebrew, WinGet : quand les préférer

Ces méthodes ont un point commun qui compte plus que leurs différences : aucune ne se met à jour toute seule.

# Homebrew (macOS)
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm (multiplateforme)
npm install -g @anthropic-ai/claude-code

Depuis la version 2.1.198, le paquet npm demande Node.js 22 ou plus. Sur une version antérieure, npm affiche un avertissement EBADENGINE sans échouer : l'installation se termine et claude fonctionne, parce que le paquet télécharge en réalité le même binaire natif que l'installateur standalone. Le binaire installé n'appelle pas Node à l'exécution.

Pour mettre à jour, chaque méthode a sa commande : brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode, ou npm install -g @anthropic-ai/claude-code@latest. Évite npm update -g, qui respecte la plage semver de l'installation initiale et risque de ne pas t'amener à la dernière version.

Homebrew propose deux casks : claude-code suit le canal stable, claude-code@latest le canal des dernières versions. Sur Debian, Fedora, RHEL et Alpine, Anthropic publie aussi des dépôts apt, dnf et apk signés — c'est la voie à privilégier pour un parc administré, parce que les mises à jour arrivent alors par le processus de mise à jour système habituel.

Vérifier que l'installation est saine

Deux commandes suffisent, et la seconde est trop peu utilisée.

claude --version

Une installation qui fonctionne affiche un numéro, du type 2.1.211 (Claude Code). Si tu obtiens command not found, c'est en général un problème de PATH ou une installation concurrente laissée par un ancien installateur.

claude doctor

claude doctor produit un diagnostic complet en lecture seule, sans démarrer de session : état de l'installation, erreurs de validation du fichier de réglages, avertissements avec correctifs suggérés, et résultat de la dernière tentative de mise à jour. C'est la première commande à lancer quand un poste se comporte différemment des autres dans une équipe — elle répond en quelques secondes à des questions qui prennent une demi-heure à investiguer à la main.

Pour les environnements où l'intégrité compte, Anthropic publie à chaque version un manifest.json contenant les sommes SHA256 de tous les binaires, signé avec sa clé GPG. L'empreinte à vérifier est 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE. Vérifier la signature du manifeste vérifie transitivement chaque binaire qu'il liste. Sur macOS, les binaires sont en plus signés par « Anthropic PBC » et notarisés par Apple.

Maîtriser les mises à jour dans une équipe

Par défaut, l'installation native se met à jour seule en arrière-plan — c'est pratique en solo et gênant à plusieurs.

Claude Code vérifie les mises à jour au démarrage puis périodiquement. Les nouvelles versions se téléchargent en arrière-plan et prennent effet au redémarrage suivant. Deux réglages permettent de reprendre la main, dans le fichier settings.json :

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

Le canal stable sert une version en général vieille d'environ une semaine, en sautant les versions qui présentent des régressions majeures. Le canal latest, par défaut, livre chaque nouveauté dès sa sortie. minimumVersion établit un plancher : ni la mise à jour automatique ni claude update n'installeront une version inférieure.

Pour appliquer une mise à jour immédiatement sans attendre la vérification suivante :

claude update

Et pour désactiver complètement la vérification automatique, par exemple sur un poste dont la version doit rester figée pendant un audit :

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

En déploiement d'entreprise, ces valeurs se posent dans les managed settings : elles s'imposent alors à toute l'organisation, sans que les réglages utilisateur ou projet puissent les surcharger. C'est le mécanisme à utiliser dès que plus de trois personnes travaillent sur le même dépôt — sinon tu te retrouves à débugger des comportements qui diffèrent d'un poste à l'autre parce que trois versions différentes tournent en parallèle.

Ce que la documentation ne dit pas sur le déploiement en entreprise

L'installation est un non-sujet. Le sujet, c'est ce que l'outil a le droit de lire, d'écrire et d'envoyer.

Trois questions reviennent systématiquement dans les projets qu'on accompagne, et aucune n'est traitée par la procédure d'installation :

Ce qui sort du poste. Claude Code envoie le contexte de travail — extraits de code, chemins de fichiers, sorties de commandes — à l'API d'Anthropic. Sur un dépôt client soumis à une clause de confidentialité, ce point doit être tranché avant le premier claude, pas après. Les offres Enterprise et le passage par Bedrock ou Vertex changent la donne sur la localisation et la rétention : c'est un arbitrage contractuel, pas technique.

Le budget. Un abonnement par siège est prévisible ; un accès Console facturé à l'usage ne l'est pas. Sur des sessions longues et des dépôts volumineux, l'écart entre deux développeurs peut être d'un facteur cinq. Le poser en amont évite la mauvaise surprise du deuxième mois.

La relecture. C'est le vrai risque, et il n'a rien de spécifique à Claude Code : du code généré vite est du code relu vite. On recommande la même règle que pour n'importe quelle contribution externe — pas de merge sans revue humaine, et des tests qui tournent avant, pas après.

Si ton sujet est plus large que l'outillage des développeurs et que tu cherches à automatiser des processus métier ou à déployer des agents IA connectés à tes outils, la réflexion est différente : on ne parle plus d'un assistant de codage mais d'une brique dans ton système d'information, avec les questions d'hébergement et de RGPD qui vont avec.

Contactez-nous si tu as un doute sur ce qui part réellement chez le fournisseur depuis tes dépôts.

Cas terrain : trois versions, un bug fantôme

Une équipe de quatre développeurs sur un projet Symfony nous appelle pour un comportement incohérent : les mêmes instructions donnaient des résultats différents selon le poste, et un script d'automatisation généré fonctionnait chez deux personnes sur quatre.

Ce qu'on a trouvé en dix minutes avec claude doctor. Trois méthodes d'installation coexistaient dans l'équipe : deux installations natives sur le canal latest, une installation Homebrew jamais mise à jour depuis six semaines, et une installation npm héritée d'un tutoriel. Trois versions différentes, donc trois jeux de fonctionnalités. Le « bug » n'existait pas : c'était un écart de version.

Ce qu'on a mis en place. Un settings.json versionné dans le dépôt, avec autoUpdatesChannel sur stable et un minimumVersion explicite. Désinstallation des variantes Homebrew et npm, réinstallation native pour tout le monde. Ajout de claude doctor dans la procédure d'onboarding, au même titre que node --version.

Le résultat. Le problème a disparu, et surtout il ne peut plus revenir sans être visible : quand un poste sort du cadre, claude doctor le dit. Le temps passé : une demi-journée, dont l'essentiel en désinstallation propre des installations concurrentes.

Checklist avant de déployer dans une équipe

FAQ

Conclusion

• La commande d'installation tient en une ligne : curl -fsSL https://claude.ai/install.sh | bash sur macOS, Linux et WSL, irm https://claude.ai/install.ps1 | iex sur Windows PowerShell.
• L'installateur natif est le bon défaut : pas de dépendance à Node.js, mises à jour automatiques, désinstallation propre.
• Sous Windows, le vrai arbitrage est le bac à sable : disponible en WSL 2 uniquement. Déterminant dès que tu travailles sur du code qui ne t'appartient pas.
• claude doctor fait gagner des heures en équipe : il répond en quelques secondes à « pourquoi ce poste se comporte-t-il différemment ? ».
• Au-delà de trois développeurs, fige les versions avec autoUpdatesChannel et minimumVersion, sinon tu débuggeras des écarts de version en croyant chasser des bugs.

Le vrai travail commence après l'installation : décider ce que l'outil a le droit de toucher, comment le budget est suivi, et qui relit le code produit. C'est exactement le cadrage qu'on fait avec les équipes qu'on accompagne — y compris quand la conclusion est que l'outil n'est pas nécessaire pour leur cas.

Contactez-nous — réponse sous 24h, sans engagement. On te dit honnêtement si ton besoin justifie un accompagnement ou si la documentation suffit.