Blog

Mis à jour le 18 novembre 2026 / 11 min de lecture

Installer Claude Code sur Windows et Mac : le tutoriel pas à pas

Les commandes exactes pour installer Claude Code sur Windows (PowerShell, CMD, WSL, WinGet) et sur Mac, les erreurs fréquentes et leur correction, la mise à jour et la désinstallation.

Par AY Automate

Installer Claude Code sur Windows et Mac : le tutoriel pas à pas
« L'équipe est super rapide, parfois on a dû les freiner. On a fait grandir l'entreprise sans recruter. »
Elie SalameElie Salame, COO d'Adstronaut.io

Parmi nos clients

  • Sage
  • Wonderbox
  • Neoday
  • XGrowth
  • Arcads
  • Earleads

Dès 3 000 $ par mois. Sans engagement. Garantie de remplacement de 90 jours. Installé en quelques heures.

Parler à un ingénieur

Pour installer Claude Code sur Windows, ouvrez PowerShell et lancez irm https://claude.ai/install.ps1 | iex, puis ouvrez une nouvelle fenêtre et tapez claude --version. Sur Mac, la commande est curl -fsSL https://claude.ai/install.sh | bash dans le Terminal. Dans les deux cas, il faut ensuite se connecter avec un compte payant (Pro, Max, Ultra, Team, Enterprise) ou un compte Console : le forfait gratuit de claude.ai ne donne pas accès à Claude Code.

Ce tutoriel suit la documentation officielle d'Anthropic consultée le 9 novembre 2026. Il couvre le choix de la méthode, les étapes exactes sur chaque système, les messages d'erreur les plus fréquents et leur correction, puis la mise à jour et la désinstallation. Pour l'usage au quotidien (commandes, fichier CLAUDE.md, bonnes pratiques), lisez ensuite notre guide de Claude Code en français.

De quoi avez-vous besoin avant d'installer Claude Code ?

Il vous faut un système récent, 4 Go de mémoire vive et une connexion internet. Voici la configuration minimale publiée par Anthropic :

ÉlémentWindowsMac
SystèmeWindows 10 version 1809 ou plus, Windows Server 2019 ou plusmacOS 13.0 ou plus
Processeurx64 ou ARM64 (pas de Windows 32 bits)Intel ou Apple Silicon (x64 ou ARM64)
Mémoire4 Go ou plus4 Go ou plus
TerminalPowerShell ou invite de commandes (CMD)Terminal avec Zsh ou Bash
Droits administrateurNon nécessairesNon nécessaires
Node.jsInutile avec l'installateur natifInutile avec l'installateur natif
ComptePro, Max, Ultra, Team, Enterprise ou ConsoleIdem

Le Maroc figure dans la liste des pays où Anthropic propose ses services : vous pouvez donc créer un compte et souscrire depuis le Maroc. Les forfaits sont facturés en dollars. Sur la page tarifs de Claude, le forfait Pro coûte 17 $ par mois en engagement annuel (200 $ payés d'avance) ou 20 $ en mensuel. Notre article sur le prix de Claude au Maroc détaille les autres forfaits.

Quelle méthode d'installation choisir ?

Prenez l'installateur natif si vous n'avez pas de raison particulière d'en choisir un autre. C'est la méthode recommandée par Anthropic, et elle se met à jour toute seule en arrière-plan, sans aucun réglage.

MéthodeCommandeMise à jour automatiquePour qui
Natif, PowerShellirm https://claude.ai/install.ps1 | iexOuiLa plupart des utilisateurs Windows
Natif, CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdOuiPostes où PowerShell est restreint
Natif, Mac et WSLcurl -fsSL https://claude.ai/install.sh | bashOuiMac, et Linux sous Windows (WSL)
WinGetwinget install Anthropic.ClaudeCodeNon par défautÉquipes qui gèrent tout leur parc avec WinGet
Homebrewbrew install --cask claude-codeNon par défautDéveloppeurs Mac qui centralisent leurs outils dans Homebrew
npmnpm install -g @anthropic-ai/claude-codeOui, si le dossier npm est accessible en écritureCas particuliers, demande Node.js 22 ou plus

Si vous préférez éviter le terminal, Anthropic propose aussi une application de bureau pour Mac et Windows, et une extension pour VS Code. L'extension embarque sa propre copie de l'outil : elle n'installe pas la commande claude dans votre terminal.

Comment installer Claude Code sur Windows, étape par étape ?

Sur Windows natif, l'installation prend une commande et quelques minutes. Suivez ces étapes dans l'ordre.

  1. Ouvrez PowerShell. Cherchez « PowerShell » dans le menu Démarrer et choisissez Windows PowerShell, pas l'entrée Windows PowerShell (x86), qui tourne en 32 bits et provoque une erreur. Votre invite doit commencer par PS C:\Users\VotreNom>.
  2. Lancez l'installateur :
irm https://claude.ai/install.ps1 | iex
  1. Patientez sans fermer la fenêtre. La documentation précise que la commande n'affiche aucune progression pendant le téléchargement. C'est normal.
  2. Ouvrez une nouvelle fenêtre de terminal et vérifiez :
claude --version

Une installation réussie affiche un numéro de version suivi de (Claude Code).

  1. Installez Git for Windows (conseillé). Ce n'est pas obligatoire : sans Git, Claude Code exécute ses commandes avec PowerShell. Avec Git for Windows, il utilise Git Bash, ce qui rend compatibles les scripts Bash de nombreux projets. Pendant l'installation de Git, cochez l'option qui l'ajoute au PATH.
  2. Lancez Claude Code dans votre projet : placez-vous dans le dossier (cd C:\chemin\vers\projet), tapez claude, puis suivez la connexion dans le navigateur.

Windows natif ou WSL ?

Restez sur Windows natif si vos projets et vos outils sont sous Windows. Passez par WSL 2 si vous travaillez avec des outils Linux ou si vous voulez le mode bac à sable (sandboxing), que la documentation indique comme non pris en charge sur Windows natif. Dans WSL, ouvrez votre distribution Linux et lancez la commande Linux (curl -fsSL https://claude.ai/install.sh | bash) : Claude Code s'installe et se lance alors depuis le terminal WSL, pas depuis PowerShell.

Comment installer Claude Code sur Mac ?

Sur Mac, une ligne dans le Terminal suffit.

  1. Ouvrez le Terminal (Applications, puis Utilitaires, ou recherche Spotlight avec Cmd + Espace).
  2. Collez la commande :
curl -fsSL https://claude.ai/install.sh | bash
  1. Ouvrez une nouvelle fenêtre et tapez claude --version.
  2. Si le Mac répond zsh: command not found: claude, le dossier d'installation ~/.local/bin n'est pas dans votre PATH. Ajoutez-le une fois pour toutes :
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
  1. Allez dans votre projet (cd ~/chemin/vers/projet) et tapez claude.

Avec Homebrew, la commande est brew install --cask claude-code. Ce paquet suit le canal stable, en général une semaine derrière la dernière version ; claude-code@latest suit le canal le plus récent. Pensez à lancer brew upgrade claude-code de temps en temps, car Homebrew ne met pas Claude Code à jour tout seul.

Comment se connecter au premier lancement ?

Tapez claude dans un dossier de projet : l'outil ouvre votre navigateur pour vous connecter à votre compte Claude ou à votre compte Console. Une fois la connexion validée, la session s'ouvre dans le terminal.

Deux cas particuliers. Si la variable d'environnement ANTHROPIC_API_KEY est définie et que vous acceptez de l'utiliser, Claude Code saute l'écran de connexion et facture l'usage à l'API. Les entreprises peuvent aussi passer par Amazon Bedrock, Google Cloud ou Microsoft Foundry à la place d'un compte Claude.

Pour contrôler toute votre installation sans ouvrir de session, lancez :

claude doctor

Cette commande affiche l'état de l'installation, les erreurs dans vos fichiers de réglages et l'issue de la dernière mise à jour automatique.

Quelles erreurs d'installation corriger, et comment ?

La plupart des échecs viennent d'une commande lancée dans le mauvais terminal ou d'un PATH incomplet. Ce tableau reprend les messages documentés par Anthropic et leur correction.

Message affichéCauseCorrection
'irm' is not recognizedVous êtes dans CMD, pas dans PowerShellOuvrez PowerShell, ou utilisez la commande CMD
The token '&&' is not a valid statement separatorCommande CMD lancée dans PowerShellUtilisez irm https://claude.ai/install.ps1 | iex
A parameter cannot be found that matches parameter name 'fsSL'Commande Mac/Linux lancée dans PowerShellMême correction : la commande PowerShell
Le script s'affiche au lieu de s'installerLa moitié de la commande manque (| iex oublié)Relancez la commande complète
'claude' is not recognized après l'installation%USERPROFILE%\.local\bin absent du PATHAjoutez le dossier au PATH utilisateur (voir plus bas)
running scripts is disabled on this systemPolitique d'exécution PowerShell, avec une installation npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ou installateur PowerShell
The process cannot access the fileUne autre installation tourne, ou l'antivirus analyse le fichierFermez les autres fenêtres, supprimez %USERPROFILE%\.claude\downloads, relancez
claude ouvre l'application de bureauAncienne version de Claude Desktop prioritaire dans le PATHMettez à jour Claude Desktop

Pour corriger le PATH sous Windows, vérifiez d'abord que le programme existe avec Test-Path "$env:USERPROFILE\.local\bin\claude.exe". Si la réponse est True, ajoutez le dossier au PATH de votre compte :

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Fermez puis rouvrez le terminal. Si vous travaillez dans le terminal intégré d'un éditeur, quittez et relancez l'éditeur entier, car il garde l'ancien PATH.

Sur un ordinateur d'entreprise, un logiciel de sécurité (AppLocker, règles de stratégie de groupe, agent EDR) peut bloquer l'outil. La documentation conseille alors de demander au service informatique d'autoriser claude.exe et les processus qu'il lance, dont cmd.exe et bash.exe.

Comment mettre à jour ou désinstaller Claude Code ?

L'installation native se met à jour seule, en arrière-plan, et la nouvelle version s'applique au prochain démarrage. Pour forcer la mise à jour tout de suite, tapez claude update. Avec WinGet, lancez winget upgrade Anthropic.ClaudeCode ; avec Homebrew, brew upgrade claude-code.

Une équipe qui préfère éviter les surprises peut choisir le canal stable, en général une semaine en retard sur la dernière version, avec ce réglage dans settings.json :

{
  "autoUpdatesChannel": "stable"
}

Pour désinstaller une installation native sous Windows (PowerShell) :

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Sur Mac :

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Si vous avez installé avec Homebrew, utilisez plutôt brew uninstall --cask claude-code. Si claude répond encore après la désinstallation, une seconde installation (npm, WinGet) ou un ancien alias de terminal traîne sur la machine.

Installer Claude Code dans une entreprise marocaine : trois réglages à prévoir

Avant de déployer l'outil sur les postes d'une équipe au Maroc, réglez ces trois points.

Le paiement en dollars. Les forfaits Claude sont affichés et facturés en dollars américains. Prévoyez une carte de paiement utilisable pour les achats en ligne à l'étranger, ou un forfait Team géré par l'entreprise. Nous ne donnons pas de prix en dirhams : il dépend du taux de change et des frais de votre banque au moment du paiement.

Les données personnelles dans le code. Claude Code lit les fichiers de votre projet et les envoie aux serveurs d'Anthropic pour les traiter. Si un dépôt contient des données personnelles réelles (export de clients, base de test copiée de la production), la loi 09-08 s'applique : son article 43 n'autorise le transfert de données personnelles vers un État étranger que si cet État assure un niveau de protection suffisant, et l'article 44 prévoit des dérogations, dont le consentement exprès de la personne ou une autorisation de la CNDP. La solution la plus simple reste de travailler sur des données de test anonymisées.

Les postes verrouillés. Beaucoup d'entreprises bloquent PowerShell ou les exécutables inconnus. Prévoyez le passage par le service informatique avant la formation, sinon la première heure se passe à débloquer des postes. L'installateur natif accepte un numéro de version précis, et les paramètres gérés (managed settings) permettent d'imposer un canal de mise à jour et une version minimale à tout le parc.

Former votre équipe à Claude Code

L'installation prend quelques minutes ; c'est l'usage qui demande de la méthode. AY Automate accompagne les entreprises marocaines, en français. Notre formation Claude et Claude Code au Maroc se déroule en direct sur votre propre dépôt et se termine avec la même configuration installée sur chaque poste ; le prix de l'atelier est donné pendant l'appel gratuit.

Questions fréquentes

Comment installer Claude Code sur Windows 10 ou 11 ? Ouvrez PowerShell et lancez irm https://claude.ai/install.ps1 | iex, puis vérifiez avec claude --version dans une nouvelle fenêtre. Windows 10 version 1809 ou plus récent est requis, et les droits administrateur ne sont pas nécessaires.

Faut-il installer Node.js pour Claude Code ? Non. L'installateur natif ne dépend pas de Node.js. Seule l'installation par npm (npm install -g @anthropic-ai/claude-code) demande Node.js 22 ou une version plus récente.

Claude Code est-il gratuit ? Non, l'outil s'installe gratuitement mais il faut un compte payant pour l'utiliser. Selon la documentation d'Anthropic, le forfait gratuit de claude.ai n'y donne pas accès ; le forfait Pro coûte 17 $ par mois en annuel ou 20 $ en mensuel.

Git for Windows est-il obligatoire ? Non. Sans Git for Windows, Claude Code exécute ses commandes avec PowerShell. Avec Git for Windows, il utilise Git Bash, utile pour les projets qui contiennent des scripts Bash.

Pourquoi Windows répond-il « claude n'est pas reconnu » après l'installation ? Le dossier %USERPROFILE%\.local\bin n'est pas dans votre PATH. Ajoutez-le au PATH utilisateur avec les deux commandes PowerShell données plus haut, puis rouvrez le terminal.

Peut-on utiliser Claude Code depuis le Maroc ? Oui. Le Maroc figure dans la liste des pays pris en charge publiée par Anthropic, consultée le 9 novembre 2026. La facturation se fait en dollars.

Comment mettre à jour Claude Code ? L'installation native se met à jour automatiquement. Pour forcer une mise à jour, tapez claude update ; avec WinGet ou Homebrew, utilisez winget upgrade Anthropic.ClaudeCode ou brew upgrade claude-code.


Sources : documentation Claude Code, Advanced setup et Troubleshoot installation ; tarifs Claude ; pays pris en charge par Anthropic ; loi 09-08, articles 43 et 44, sur adala.justice.gov.ma. Consultés le 9 novembre 2026.