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 : (Optionnel) Ouvrir Claude Code dans VS Code

Passez cette étape si vous n’avez pas encore VS Code — vous pourrez l’installer plus tard avec Premiers Pas avec VS Code puis revenir ici.

Maintenant que Claude Code est installé, vous pouvez l’utiliser dans VS Code, et pas seulement dans le terminal. C’est souvent la façon la plus simple de travailler, car vous pouvez lire des fichiers, modifier du code et demander de l’aide sans quitter votre éditeur.

Voyez la barre latérale (sidebar) de Claude Code comme une fenêtre de discussion à l’intérieur de VS Code. Elle vous permet de poser des questions, de faire expliquer du code et d’obtenir de l’aide tout en travaillant sur le même écran.

Comment ouvrir la barre latérale de Claude Code

Si vous ne voyez pas l’icône Claude Code, essayez ceci :

Si elle n’apparaît toujours pas, fermez VS Code puis rouvrez-le. Parfois, l’extension a besoin d’un redémarrage avant que la barre latérale s’affiche.

À quoi sert la barre latérale

La barre latérale de Claude Code vous permet de :

C’est pratique, car vous pouvez garder votre code ouvert dans l’éditeur et demander de l’aide à Claude dans la même fenêtre.

Test rapide

Une fois la barre latérale ouverte :

Si Claude répond, vous êtes prêt à l’utiliser. La première fois, la barre latérale peut plutôt vous demander de vous connecter : suivez ses instructions, ou connectez votre compte à l’Étape 4 ci-dessous puis réessayez.

Astuce : si la barre latérale est toujours absente, vérifiez que l’extension Claude Code est installée et que VS Code a bien été redémarré.

Étape 4 : 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 (paiement à l’usage)

OpenRouter est une passerelle API unifiée qui donne accès à plus de 500 grands modèles de langage via une seule clé API. Cela peut être 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 Microsoft Foundry (Azure)

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-8"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-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 5 : Tester Claude Code

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

Étape 6 : 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 7 : (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, certaines fonctionnalités ne marchent que 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é » : 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.