Accueil

Installer Claude Code sur Windows

Claude Code est un assistant IA qui vit dans votre terminal et vous aide à écrire, déboguer et comprendre du code. Avec ce guide, Claude Code fonctionnera nativement sur Windows en quelques minutes. WSL2 est aussi proposé à la fin, en tant qu’option plus avancée.

Concepts clés

Ce dont vous aurez besoin

Étape 1 : Installer Git for Windows (optionnel, recommandé)

Git for Windows est recommandé, mais optionnel. Il ajoute Git Bash, le shell que Claude Code utilise pour exécuter des commandes. Si vous l’ignorez, Claude Code utilisera PowerShell à la place : passez alors directement à l’Étape 2 et installez Git plus tard si vous le souhaitez.

C’est tout — Claude Code détectera Git Bash automatiquement à son démarrage.

Étape 2 : Installer Claude Code

Étape 3 : Se connecter à votre compte Anthropic

Option A. Utilisez votre abonnement Claude Pro ou Max

Les options basées sur une API ci-dessous se configurent dans PowerShell avec la commande setx, qui enregistre un paramètre de façon permanente. Après un setx, fermez et rouvrez PowerShell pour appliquer le changement, puis lancez claude.

Option B. Utilisez la clé API Anthropic

Si vous avez une clé API Anthropic au lieu d’un abonnement Claude :

Option C. Utilisez l’API OpenRouter (commencez gratuitement !)

OpenRouter est une passerelle API unifiée qui donne accès à plus de 500 grands modèles de langage via une seule clé API. C’est une façon économique d’utiliser Claude Code : vous ne payez qu’à l’usage et choisissez parmi des modèles de différentes gammes de prix.

Remarques :

Option D. Utilisez l’API Anthropic via Azure Foundry

Dans PowerShell, collez ce code pour définir les variables d’environnement :

# Enable Microsoft Foundry integration
setx CLAUDE_CODE_USE_FOUNDRY 1
# Azure resource name
setx ANTHROPIC_FOUNDRY_RESOURCE "xxxx-eastus2"
# Set models to your resource's deployment names
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-4-5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-4-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-4-5"
setx ANTHROPIC_FOUNDRY_API_KEY "your_api_key"

Remarque : Remplacez xxxx-eastus2 par le nom de votre Ressource Foundry (n’utilisez pas l’URL de base complète). Remplacez your_api_key par votre clé API complète depuis votre portail Azure.

Ensuite, fermez et rouvrez PowerShell, puis lancez Claude Code :

claude

Vous devriez maintenant pouvoir utiliser Claude Code avec les modèles Claude déployés sur Azure.

Étape 4 : Tester Claude Code

Vous êtes prêt ! Tapez claude dans PowerShell et posez une question générale comme « Expliquez l’informatique quantique ».

Étape 5 : Accéder à vos projets

Remarque : Claude fonctionne dans un dossier de projet et y enregistre ses paramètres. C’est son espace de travail.

Étape 6 : (Optionnel) Installer WSL2 pour l’expérience complète sous Linux

Pour la plupart des utilisateurs, la configuration native ci-dessus suffit largement. Cela dit, Claude Code fonctionne mieux sous Linux. WSL2 exécute un véritable système Linux dans Windows et ajoute le sandboxing de l’outil Bash (une fonctionnalité de sécurité) ainsi qu’une meilleure compatibilité avec les outils Linux. La configuration est plus longue et impose un redémarrage : ne le faites que si vous voulez l’expérience complète sous Linux.

a) Vérifier la virtualisation et installer WSL

Tout d’abord, vérifiez si la virtualisation est activée :

Si elle indique “Désactivée” : Vous devez activer la virtualisation dans le BIOS de votre ordinateur :

Maintenant, installez WSL :

Remarque : wsl --install nécessite Windows 10 version 2004 ou supérieure, ou Windows 11. Si la commande n’est pas reconnue, votre version de Windows est peut-être trop ancienne.

b) Configurer Ubuntu

Après le redémarrage, une fenêtre de terminal avec “Ubuntu” dans le titre devrait s’ouvrir automatiquement dans les 2 à 5 minutes. Sinon, cliquez sur le bouton Démarrer de Windows, tapez Ubuntu et cliquez sur l’application Ubuntu (icône de cercle orange).

Important : Retenez ce nom d’utilisateur et ce mot de passe — vous en aurez besoin plus tard.

c) Installer Claude Code dans WSL

Prochaines étapes

Dépannage

Première étape : Exécuter Claude Doctor

Si quelque chose ne fonctionne pas, essayez d’abord cette commande :

claude doctor

Cet outil de diagnostic intégré vérifie votre installation et signale les problèmes courants.

Commande claude introuvable (Windows natif)

“Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS”

Cette erreur signifie que la virtualisation n’est pas activée :

“wsl –install” ne fonctionne pas

La fenêtre Ubuntu ne s’ouvre pas après le redémarrage

Besoin d’aide ?

Créé par Steven Ge le 11 décembre 2025. Mis à jour en juin 2026.