Accueil

Installer Claude Code sur Windows avec WSL

Claude Code est un assistant de codage IA puissant, mais les utilisateurs Windows font face à un défi : de nombreux outils de développement fonctionnent mieux sur Linux. La solution ? WSL (Windows Subsystem for Linux) vous permet d’exécuter un environnement Linux complet dans Windows, comme si vous aviez deux ordinateurs en un. Ce guide vous accompagne dans la configuration complète pour que vous puissiez commencer à coder avec Claude en environ 20 minutes.

Concepts Clés

Ce Dont Vous Aurez Besoin

Étape 1 : Vérifier si la Virtualisation est Activée

Avant d’installer WSL, vous devez vérifier que la virtualisation est activée sur votre ordinateur. Cela est nécessaire pour que WSL fonctionne.

Si elle indique “Activée” : Parfait ! Passez à l’Étape 2.

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

Étape 2 : Ouvrir PowerShell en tant qu’Administrateur

Une fenêtre bleue avec du texte blanc s’ouvrira - c’est PowerShell en cours d’exécution en tant qu’administrateur.

Étape 3 : Installer WSL

D’abord, vérifiez si WSL et Ubuntu sont déjà installés :

Pour installer WSL et Ubuntu :

Pourquoi le redémarrage est nécessaire : Le redémarrage permet à Windows d’activer les fonctionnalités WSL et Virtual Machine Platform qui viennent d’être installées.

Remarque : Si vous obtenez une erreur indiquant que la commande n’est pas reconnue, votre version de Windows est peut-être trop ancienne. Assurez-vous d’avoir Windows 10 version 2004 ou supérieure, ou Windows 11. Exécutez Windows Update pour obtenir la dernière version.

Étape 4 : Configurer Ubuntu (Première Fois Uniquement)

Après le redémarrage de votre ordinateur, une fenêtre de terminal avec “Ubuntu” dans le titre devrait s’ouvrir automatiquement dans les 2 à 5 minutes.

Si la fenêtre Ubuntu ne s’est PAS ouverte automatiquement :

Maintenant, complétez la configuration initiale :

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

Étape 5 : Mettre à Jour Ubuntu

Étape 6 : Installer Node.js

Claude Code nécessite Node.js version 18 ou supérieure. Suivez ces étapes :

Étape 7 : Installer Claude Code

Étape 8 : Configurer Votre Connexion API Anthropic

Option A. Utiliser votre abonnement Claude Pro ou Max

Option B. Utiliser une clé API Anthropic

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

Option C. Utiliser l’API Anthropic via Azure Foundry

Avant de démarrer Claude Code, dans la fenêtre du terminal Ubuntu, collez ce code pour définir les variables d’environnement :

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name
export ANTHROPIC_FOUNDRY_RESOURCE=xxxx-eastus2
# Set models to your resource's deployment names
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5
export 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, démarrez Claude Code :

claude

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

Étape 9 : Tester Claude Code

Vous êtes prêt ! Pour voir si cela fonctionne, posez une question générale comme “Expliquez l’informatique quantique.”

Étape 10 : Accéder à Vos Projets Windows

Remarque : Claude fonctionne dans un dossier de projet. Il enregistre les paramètres dans ce dossier. C’est l’espace de travail de Claude.

Prochaines Étapes

Dépannage

Comment ouvrir le terminal Ubuntu après l’avoir fermé

“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

“sudo: apt: command not found”

L’installation de Node.js échoue

Les commandes Claude Code sont introuvables

Besoin d’Aide ?

Créé par Steven Ge le 11 décembre 2025.