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. Ce guide vous accompagne dans la configuration complète : une installation native rapide via PowerShell, puis WSL2 pour l’expérience complète sous Linux.

Concepts clés

Ce dont vous aurez besoin

Étape 1 : Installer Claude Code en natif sur Windows (fonctionne mais non recommandé)

Remarque : L’installation native sur Windows présente certaines limitations :

Continuez avec les étapes ci-dessous pour installer WSL2 et bénéficier de l’expérience complète.

Étape 2 : Vérifier la virtualisation et installer WSL

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

Si elle indique “Activée” : Parfait ! Continuez ci-dessous.

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

Maintenant, installez WSL :

Vérifiez si WSL et Ubuntu sont déjà installés :

Pour installer WSL et Ubuntu :

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.

Étape 3 : Configurer Ubuntu

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 4 : Installer Claude Code dans WSL

Étape 5 : Se connecter à votre compte Anthropic

Option A. Utilisez votre abonnement Claude Pro ou Max

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, car vous ne payez que pour l’utilisation et pouvez choisir parmi des modèles de différentes gammes de prix.

Remarques :

Option D. Utilisez l’API Anthropic via Azure Foundry

Avant de démarrer Claude Code, dans le 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_DEFAULT_HAIKU_MODEL=claude-haiku-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 6 : Tester Claude Code

Vous êtes prêt ! Tapez claude dans le terminal Ubuntu et posez une question générale comme “Explain quantum computing.”

Étape 7 : Accéder à vos projets

Windows natif (PowerShell) :

WSL (Ubuntu) :

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

Étape 8 : Mettre à jour Claude Code

Claude Code se met à jour automatiquement, mais vous pouvez le mettre à jour manuellement à tout moment :

WSL (Ubuntu) :

sudo claude update

Windows natif (PowerShell — exécuter en tant qu’administrateur) :

claude update

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

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

Commandes Claude Code introuvables (WSL)

Besoin d’aide ?

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