Installer Claude Code sur Windows : le pas à pas

Ce qu’il faut savoir avant de commencer

Installer Claude Code sur Windows prend quelques minutes quand on sait où regarder. Les blocages viennent presque toujours de trois endroits : le mauvais terminal, le PATH, et l’abonnement. Ce pas à pas suit la documentation officielle d’installation, que j’ai consultée le 16 octobre 2026, avec les explications que j’aurais aimé avoir la première fois.

Si vous ne savez pas encore ce qu’est Claude Code, lisez d’abord mon guide du débutant.

Prérequis

Votre version de Windows

Claude Code demande Windows 10 version 1809 ou plus récente, ou Windows 11. Pour vérifier, appuyez sur Windows + R, tapez winver et validez : une fenêtre affiche votre version. Il faut aussi au moins 4 Go de RAM et une connexion internet.

Un compte qui inclut Claude Code

C’est le point le plus souvent oublié : l’offre gratuite de Claude n’inclut pas Claude Code. Il vous faut un abonnement Pro, Max, Team ou Enterprise, ou un compte Console (paiement à l’usage via l’API). Vous pouvez installer l’outil sans abonnement, mais vous ne pourrez pas l’utiliser. Les prix et la façon de payer depuis le Maroc sont dans cet article dédié.

Pas besoin d’être administrateur

La documentation le précise : l’installation sur Windows ne demande pas de droits administrateur. Si un tutoriel vous dit de lancer PowerShell « en tant qu’administrateur », ce n’est pas nécessaire.

Choisir entre Windows natif et WSL

Vous avez deux façons de faire tourner Claude Code sur Windows :

Pour débuter, je conseille Windows natif. WSL est très bien, mais il ajoute une couche à comprendre (un Linux dans votre Windows, avec ses propres dossiers). Vous pourrez y passer plus tard.

Étape 1 : installer Git for Windows (conseillé)

Git for Windows installe Git, qui garde l’historique de votre code, et Git Bash, un terminal de type Linux. Si Git Bash est présent, Claude Code l’utilise pour exécuter ses commandes ; sinon, il utilise PowerShell. Les deux fonctionnent, mais la plupart des exemples que vous trouverez en ligne sont écrits pour Bash.

Téléchargez l’installateur, gardez les options par défaut, et terminez l’installation.

Étape 2 : ouvrir le bon terminal

Ouvrez le menu Démarrer, tapez PowerShell et lancez Windows PowerShell. Vérifiez que vous êtes au bon endroit : l’invite commence par PS, par exemple PS C:\Users\Karim>.

Si l’invite ne commence pas par PS, vous êtes dans l’invite de commandes (CMD). Ce n’est pas grave, mais la commande d’installation est différente (voir plus bas).

Étape 3 : lancer l’installation

Dans PowerShell, copiez cette ligne et validez avec Entrée :

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

Si vous êtes dans CMD, utilisez plutôt :

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

L’installation n’affiche pas de barre de progression pendant le téléchargement : c’est normal, attendez que l’invite revienne.

Une alternative existe si vous utilisez déjà le gestionnaire de paquets de Windows :

winget install Anthropic.ClaudeCode

Attention : installé avec WinGet, Claude Code ne se met pas à jour tout seul. Il faudra lancer winget upgrade Anthropic.ClaudeCode de temps en temps. L’installation par script, elle, se met à jour automatiquement en arrière-plan.

Étape 4 : vérifier l’installation

Fermez votre terminal et ouvrez-en un nouveau : c’est indispensable pour que Windows prenne en compte le nouveau programme. Puis tapez :

claude --version

Un numéro de version doit s’afficher. Pour un diagnostic plus complet, sans démarrer de session :

claude doctor

Étape 5 : connecter votre compte

Placez-vous dans un dossier de travail, puis lancez Claude Code :

mkdir C:\projets\essai
cd C:\projets\essai
claude

Au premier lancement, Claude Code ouvre votre navigateur pour vous connecter à votre compte Claude. Connectez-vous avec le compte qui a l’abonnement, autorisez l’accès, puis revenez dans le terminal.

Étape 6 : votre premier prompt

Vous êtes maintenant dans Claude Code. Écrivez, en français :

Explique-moi en trois phrases ce que contient ce dossier, puis crée un fichier bonjour.txt qui contient « Salam depuis Claude Code ».

Claude Code vous dira que le dossier est vide, puis vous demandera l’autorisation de créer le fichier. Acceptez. Vérifiez dans l’explorateur Windows que bonjour.txt est bien là. Votre installation fonctionne.

Dépannage : les erreurs courantes

« claude n’est pas reconnu en tant que commande »

Dans la grande majorité des cas, vous avez oublié de rouvrir le terminal après l’installation. Fermez toutes les fenêtres PowerShell et réessayez. Si l’erreur persiste, le dossier d’installation n’est pas dans votre PATH : la page Troubleshoot installation explique comment le corriger selon votre cas.

« The token '&&' is not a valid statement separator »

Vous avez collé la commande prévue pour CMD dans PowerShell. Utilisez la commande irm … | iex.

« 'irm' n’est pas reconnu »

C’est l’inverse : vous êtes dans CMD avec la commande PowerShell. Utilisez la commande curl … install.cmd, ou ouvrez PowerShell.

Claude Code ne trouve pas Git Bash

Si Git for Windows est installé dans un dossier inhabituel, indiquez son chemin dans le fichier de réglages de Claude Code (settings.json), comme le montre la documentation :

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

La connexion échoue ou boucle

Vérifiez que vous vous connectez avec le compte qui a l’abonnement payant, et pas un autre compte Google. Sur un réseau d’entreprise ou d’école, un proxy peut bloquer la connexion : essayez depuis un autre réseau pour vérifier.

Mettre à jour et désinstaller

Les mises à jour

Si vous avez installé Claude Code avec le script (irm … | iex), il se met à jour tout seul : il vérifie au démarrage et pendant son fonctionnement s’il existe une nouvelle version, la télécharge en arrière-plan, et l’applique au lancement suivant. Pour forcer une mise à jour tout de suite :

claude update

Avec WinGet, rappelez-vous que c’est à vous de lancer winget upgrade Anthropic.ClaudeCode.

Désinstaller proprement

Pour une installation par script, la documentation indique de supprimer le programme et ses fichiers de version, dans PowerShell :

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

Avec WinGet : winget uninstall Anthropic.ClaudeCode. Vos réglages, eux, restent dans le dossier .claude de votre profil utilisateur : ne le supprimez que si vous voulez vraiment repartir de zéro, car il contient aussi votre historique de sessions et vos configurations.

Bien démarrer après l’installation

Trois habitudes à prendre dès le premier projet, qui vous éviteront beaucoup de soucis :

1. Un dossier par projet, et toujours lancer claude depuis ce dossier : Claude Code travaille dans le dossier où vous l’ouvrez.

2. git init dans chaque nouveau projet, puis un commit à chaque étape qui fonctionne. Si une modification tourne mal, vous revenez en arrière en une commande.

3. Un fichier CLAUDE.md à la racine du projet, pour écrire les règles que Claude Code doit suivre (langue, commandes, dossiers à ne pas toucher). La commande /init en génère un premier jet.

Et sur Mac ou Linux ?

C’est encore plus simple : ouvrez le Terminal et lancez la commande d’installation officielle.

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

Puis, comme sur Windows, ouvrez un nouveau terminal et tapez claude --version.

Sans rien installer : le lab dans le navigateur

Certains n’ont pas d’ordinateur où ils peuvent installer des logiciels (PC du travail verrouillé, machine partagée), ou ne veulent pas prendre tout de suite un abonnement. C’est pour ce cas que j’ai prévu une option « Accès lab » avec mon cours Claude Code en autonomie : un espace personnel dans le navigateur avec VS Code, un terminal et Claude Code déjà configurés, avec des crédits IA inclus. Vous ouvrez la page, et vous codez.

En résumé

• Windows 10 (1809+) ou 11, 4 Go de RAM, et un compte Claude payant ou un compte API.

• Installez Git for Windows, puis lancez irm https://claude.ai/install.ps1 | iex dans PowerShell.

• Rouvrez le terminal, vérifiez avec claude --version, lancez claude et connectez-vous.

• En cas d’erreur, vérifiez d’abord le terminal utilisé (PowerShell ou CMD), puis le PATH.

Commandes vérifiées dans la documentation officielle de Claude Code le 16 octobre 2026. Si une commande a changé, la documentation fait foi.