Installer Claude Code en 2026 : le guide complet

Installer Claude Code prend deux minutes. Le deployer dans une equipe sans y laisser des identifiants, du budget non maitrise 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 methode, 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 developpeur lance l'outil sur le depot d'un client ?

Ce guide couvre les deux : la procedure exacte, testee, et ce que CZ Multimedia met en place quand une equipe passe de « un dev curieux » a « cinq personnes en production ».

La reponse 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 methode native, celle qu'Anthropic recommande, et la seule qui se met a jour toute seule en arriere-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 acces a 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 preferer
• Verifier que l'installation est saine
• Maitriser les mises a jour dans une equipe
• Ce que la documentation ne dit pas sur le deploiement en entreprise

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

Trois choses : un systeme supporte, 4 Go de RAM, et un abonnement payant. C'est le troisieme point qui surprend le plus souvent.

Les systemes officiellement supportes 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+. Cote materiel, il faut un processeur x64 ou ARM64 et au moins 4 Go de memoire vive. Le shell peut etre 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 prefere 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 plutot qu'un abonnement Anthropic.

Installer sur macOS, Linux et WSL

L'installateur natif est la methode a privilegier : il ne depend pas de Node.js et il se met a jour tout seul.

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

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

claude

Claude Code demarre 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 deja definie, il te demande simplement de valider cette cle au lieu d'ouvrir un navigateur.

Sur macOS et Linux, l'installateur natif gere un lanceur dans ~/.local/bin/claude, qui pointe vers les versions installees dans ~/.local/share/claude/versions/. C'est un detail utile a connaitre le jour ou tu dois auditer ce qui tourne reellement sur un poste.

Tu peux aussi choisir ton canal des l'installation. Pour la version stable plutot que la derniere :

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

Ou une version precise, ce qui est souvent ce que veut une equipe :

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

Sur Alpine et les distributions basees sur musl, il faut installer quelques dependances d'abord (bash, curl, libgcc, libstdc++, ripgrep) puis desactiver le ripgrep embarque en passant USE_BUILTIN_RIPGREP a 0 dans le fichier de reglages. Sans ca, la commande d'installation echoue 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 a 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 necessaire. Si tu vois l'erreur The token '&&' is not a valid statement separator, tu es dans PowerShell alors que tu as copie la commande CMD — ton invite affiche PS C:\ en PowerShell et C:\ sans le PS en CMD.

Le tableau de decision est simple :

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

npm, Homebrew, WinGet : quand les preferer

Ces methodes ont un point commun qui compte plus que leurs differences : aucune ne se met a 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 anterieure, npm affiche un avertissement EBADENGINE sans echouer : l'installation se termine et claude fonctionne, parce que le paquet telecharge en realite le meme binaire natif que l'installateur standalone. Le binaire installe n'appelle pas Node a l'execution.

Pour mettre a jour, chaque methode a sa commande : brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode, ou npm install -g @anthropic-ai/claude-code@latest. Evite npm update -g, qui respecte la plage semver de l'installation initiale et risque de ne pas t'amener a la derniere version.

Homebrew propose deux casks : claude-code suit le canal stable, claude-code@latest le canal des dernieres versions. Sur Debian, Fedora, RHEL et Alpine, Anthropic publie aussi des depots apt, dnf et apk signes — c'est la voie a privilegier pour un parc administre, parce que les mises a jour arrivent alors par le processus de mise a jour systeme habituel.

Verifier que l'installation est saine

Deux commandes suffisent, et la seconde est trop peu utilisee.

claude --version

Une installation qui fonctionne affiche un numero, du type 2.1.211 (Claude Code). Si tu obtiens command not found, c'est en general un probleme de PATH ou une installation concurrente laissee par un ancien installateur.

claude doctor

claude doctor produit un diagnostic complet en lecture seule, sans demarrer de session : etat de l'installation, erreurs de validation du fichier de reglages, avertissements avec correctifs suggeres, et resultat de la derniere tentative de mise a jour. C'est la premiere commande a lancer quand un poste se comporte differemment des autres dans une equipe — elle repond en quelques secondes a des questions qui prennent une demi-heure a investiguer a la main.

Pour les environnements ou l'integrite compte, Anthropic publie a chaque version un manifest.json contenant les sommes SHA256 de tous les binaires, signe avec sa cle GPG. L'empreinte a verifier est 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE. Verifier la signature du manifeste verifie transitivement chaque binaire qu'il liste. Sur macOS, les binaires sont en plus signes par « Anthropic PBC » et notarises par Apple.

Maitriser les mises a jour dans une equipe

Par defaut, l'installation native se met a jour seule en arriere-plan — c'est pratique en solo et genant a plusieurs.

Claude Code verifie les mises a jour au demarrage puis periodiquement. Les nouvelles versions se telechargent en arriere-plan et prennent effet au redemarrage suivant. Deux reglages permettent de reprendre la main, dans le fichier settings.json :

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

Le canal stable sert une version en general vieille d'environ une semaine, en sautant les versions qui presentent des regressions majeures. Le canal latest, par defaut, livre chaque nouveaute des sa sortie. minimumVersion etablit un plancher : ni la mise a jour automatique ni claude update n'installeront une version inferieure.

Pour appliquer une mise a jour immediatement sans attendre la verification suivante :

claude update

Et pour desactiver completement la verification automatique, par exemple sur un poste dont la version doit rester figee pendant un audit :

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

En deploiement d'entreprise, ces valeurs se posent dans les managed settings : elles s'imposent alors a toute l'organisation, sans que les reglages utilisateur ou projet puissent les surcharger. C'est le mecanisme a utiliser des que plus de trois personnes travaillent sur le meme depot — sinon tu te retrouves a debugger des comportements qui different d'un poste a l'autre parce que trois versions differentes tournent en parallele.

Ce que la documentation ne dit pas sur le deploiement en entreprise

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

Trois questions reviennent systematiquement dans les projets qu'on accompagne, et aucune n'est traitee par la procedure d'installation :

Ce qui sort du poste. Claude Code envoie le contexte de travail — extraits de code, chemins de fichiers, sorties de commandes — a l'API d'Anthropic. Sur un depot client soumis a une clause de confidentialite, ce point doit etre tranche avant le premier claude, pas apres. Les offres Enterprise et le passage par Bedrock ou Vertex changent la donne sur la localisation et la retention : c'est un arbitrage contractuel, pas technique.

Le budget. Un abonnement par siege est previsible ; un acces Console facture a l'usage ne l'est pas. Sur des sessions longues et des depots volumineux, l'ecart entre deux developpeurs peut etre d'un facteur cinq. Le poser en amont evite la mauvaise surprise du deuxieme mois.

La relecture. C'est le vrai risque, et il n'a rien de specifique a Claude Code : du code genere vite est du code relu vite. On recommande la meme regle que pour n'importe quelle contribution externe — pas de merge sans revue humaine, et des tests qui tournent avant, pas apres.

Si ton sujet est plus large que l'outillage des developpeurs et que tu cherches a automatiser des processus metier ou a deployer des agents IA connectes a tes outils, la reflexion est differente : on ne parle plus d'un assistant de codage mais d'une brique dans ton systeme d'information, avec les questions d'hebergement et de RGPD qui vont avec.

Contactez-nous si tu as un doute sur ce qui part reellement chez le fournisseur depuis tes depots.

Cas terrain : trois versions, un bug fantome

Une equipe de quatre developpeurs sur un projet Symfony nous appelle pour un comportement incoherent : les memes instructions donnaient des resultats differents selon le poste, et un script d'automatisation genere fonctionnait chez deux personnes sur quatre.

Ce qu'on a trouve en dix minutes avec claude doctor. Trois methodes d'installation coexistaient dans l'equipe : deux installations natives sur le canal latest, une installation Homebrew jamais mise a jour depuis six semaines, et une installation npm heritee d'un tutoriel. Trois versions differentes, donc trois jeux de fonctionnalites. Le « bug » n'existait pas : c'etait un ecart de version.

Ce qu'on a mis en place. Un settings.json versionne dans le depot, avec autoUpdatesChannel sur stable et un minimumVersion explicite. Desinstallation des variantes Homebrew et npm, reinstallation native pour tout le monde. Ajout de claude doctor dans la procedure d'onboarding, au meme titre que node --version.

Le resultat. Le probleme a disparu, et surtout il ne peut plus revenir sans etre visible : quand un poste sort du cadre, claude doctor le dit. Le temps passe : une demi-journee, dont l'essentiel en desinstallation propre des installations concurrentes.

Checklist avant de deployer dans une equipe

FAQ

Quelle est la commande pour installer Claude Code ?

Sur macOS, Linux et WSL : curl -fsSL https://claude.ai/install.sh | bash. Sur Windows PowerShell : irm https://claude.ai/install.ps1 | iex. C'est la methode native recommandee par Anthropic, et la seule qui se met a jour automatiquement en arriere-plan. Ensuite, claude demarre une session dans le repertoire courant.

Claude Code est-il gratuit ?

Non. Il faut un compte Pro, Max, Team, Enterprise ou Console — le plan gratuit de Claude.ai ne donne pas acces a Claude Code. L'outil fonctionne egalement avec Amazon Bedrock, Google Cloud ou Microsoft Foundry, auquel cas la facturation passe par le fournisseur cloud plutot que par un abonnement Anthropic.

Faut-il installer Node.js ?

Plus depuis l'installateur natif : le binaire ne depend pas de Node.js a l'execution. Node.js 22 ou superieur n'est requis que pour l'installation via npm install -g @anthropic-ai/claude-code. Et meme dans ce cas, npm ne fait que recuperer le meme binaire natif — le claude installe n'appelle pas Node.

Windows natif ou WSL 2 ?

Les deux fonctionnent, sans droits administrateur. La difference qui compte : le bac a sable d'execution des commandes n'est disponible qu'en WSL 2. Pour du code interne ou un prototype, le natif suffit largement. Pour du code client soumis a confidentialite, WSL 2 est le choix prudent. Sur Windows natif, installer Git for Windows permet a Claude Code d'utiliser Git Bash plutot que PowerShell.

Comment savoir si mon installation est correcte ?

claude --version doit afficher un numero de version. Pour aller plus loin, claude doctor produit un diagnostic en lecture seule : etat de l'installation, erreurs dans le fichier de reglages, resultat de la derniere mise a jour. C'est la commande a lancer en premier quand un poste se comporte differemment des autres.

Peut-on figer la version dans une equipe ?

Oui, et c'est recommande au-dela de trois personnes. Le reglage autoUpdatesChannel accepte stable, qui sert une version d'environ une semaine en sautant les regressions majeures. minimumVersion etablit un plancher que les mises a jour ne franchissent pas vers le bas. En entreprise, les managed settings imposent ces valeurs a toute l'organisation, sans surcharge possible cote utilisateur.

Claude Code, Cursor ou GitHub Copilot ?

Ils ne jouent pas le meme role : Claude Code travaille dans le terminal sur l'ensemble d'un depot, la ou Cursor et Copilot vivent dans l'editeur. On a detaille les differences et les cas d'usage dans notre comparatif Claude Code, Cursor et Copilot.

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 defaut : pas de dependance a Node.js, mises a jour automatiques, desinstallation propre.
• Sous Windows, le vrai arbitrage est le bac a sable : disponible en WSL 2 uniquement. Determinant des que tu travailles sur du code qui ne t'appartient pas.
• claude doctor fait gagner des heures en equipe : il repond en quelques secondes a « pourquoi ce poste se comporte-t-il differemment ? ».
• Au-dela de trois developpeurs, fige les versions avec autoUpdatesChannel et minimumVersion, sinon tu debuggeras des ecarts de version en croyant chasser des bugs.

Le vrai travail commence apres l'installation : decider 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 equipes qu'on accompagne — y compris quand la conclusion est que l'outil n'est pas necessaire pour leur cas.

Contactez-nous — reponse sous 24h, sans engagement. On te dit honnetement si ton besoin justifie un accompagnement ou si la documentation suffit.