Résumé rapide : L'installation de Claude Code sur Windows nécessite la configuration de WSL2 (Windows Subsystem for Linux), l'installation d'Ubuntu et l'exécution d'un script d'installation simple. Ce processus permet aux utilisateurs de Windows d'accéder à l'assistant de codage IA d'Anthropic via leur terminal. Des binaires natifs pour Windows sont disponibles, cependant WSL2 reste la meilleure pratique pour l'installation sous Windows.
Claude Code est un assistant de codage basé sur l'IA qui fonctionne directement dans le terminal, aidant les développeurs à créer des fonctionnalités, à corriger des bugs et à automatiser les tâches de développement. Mais il y a un hic pour les utilisateurs de Windows.
Claude Code est disponible sous forme d'exécutable natif pour Windows et peut être installé via npm ou un téléchargement binaire direct sans WSL2. Cependant, il nécessite le Sous-système Windows pour Linux (WSL2), et la méthode d'installation officielle repose toujours sur WSL2.
Voici comment le faire fonctionner sur Windows 11 ou Windows 10.
Configuration requise
Avant de commencer l'installation, vérifiez que votre machine Windows répond aux exigences suivantes :
- Windows 10 1809+ ou Windows Server 2019+
- Windows 11 (toute version)
- Au moins 4 Go de RAM disponible
- Privilèges d'administrateur sur le système
- Connexion Internet pour télécharger WSL2 et Ubuntu
L'installation nécessite de l'espace disque pour WSL2, Ubuntu et Claude Code.
Étape 1 : Activer le Sous-système Windows pour Linux
WSL2 fournit un environnement Linux directement dans Windows. C'est la base qui permet à Claude Code de fonctionner.
Ouvrez PowerShell en tant qu'administrateur. Faites un clic droit sur le bouton Démarrer et sélectionnez « Windows PowerShell (Admin) » ou « Terminal (Admin) » sur Windows 11.
Exécutez cette commande :
wsl –install
Cette commande active les fonctionnalités Windows nécessaires et installe Ubuntu comme distribution Linux par défaut. Le système vous demandera probablement de redémarrer.
Après le redémarrage, WSL2 termine la configuration automatiquement. Ubuntu se lance et vous demande un nom d'utilisateur et un mot de passe. Ces identifiants sont uniquement pour l'environnement Linux – ils n'ont pas besoin de correspondre à vos identifiants Windows.
Étape 2 : Vérifier l'installation de WSL2
Une fois le système redémarré et Ubuntu ayant terminé sa configuration initiale, vérifiez que WSL2 fonctionne correctement.
Ouvrez le terminal Ubuntu (recherchez « Ubuntu » dans le menu Démarrer) et exécutez :
wsl –version
Cela affiche les informations sur la version de WSL. Recherchez « WSL version: 2.x.x » dans la sortie.
Si la commande affiche WSL1 à la place, mettez à niveau vers WSL2 avec :
wsl –set-default-version 2
Étape 3 : Installer Claude Code
Passons maintenant à l'installation de Claude Code. La documentation officielle fournit un script d'installation en une seule ligne.
Dans le terminal Ubuntu, exécutez :
curl -fsSL claude.ai/install.sh | bash
Le script télécharge le binaire Claude Code, configure les autorisations nécessaires et l'ajoute au PATH du système. La durée d'installation varie en fonction de la vitesse Internet et des spécifications du système.
Selon la documentation officielle de Claude Code, l'installeur détecte automatiquement l'architecture du système et télécharge la version binaire appropriée.
Problèmes d'installation courants
Certains utilisateurs de Windows signalent un message « command not found: claude » après l'installation. Cela se produit généralement parce que la variable PATH n'a pas été rafraîchie.
Fermez et rouvrez le terminal Ubuntu, puis réessayez. Si le problème persiste, cette configuration du PATH peut aider en tant que solution de contournement non officielle :
echo ‘export PATH=”$HOME/.claude/bin:$PATH”’ >> ~/.bashrc
source ~/.bashrc
Étape 4 : Authentifier Claude Code
Claude Code nécessite une authentification avec un compte Anthropic avant utilisation.
Exécutez cette commande :
claude
Le terminal affiche une URL et demande l'authentification. Le processus varie légèrement pour les utilisateurs individuels par rapport aux comptes d'équipe :
| Type de compte | Méthode d'authentification | Ce qui est requis |
|---|---|---|
| Individuel | Clé API personnelle | Compte Anthropic avec accès API |
| Équipe/Organisation | Jeton d'organisation | Jeton d'authentification fourni par l'administrateur |
Ouvrez l'URL fournie dans un navigateur, connectez-vous à votre compte Anthropic et autorisez Claude Code. Le terminal confirmera l'authentification réussie.
Travailler avec des projets Windows dans WSL2
C'est là que les choses deviennent délicates. Les systèmes de fichiers Windows et les systèmes de fichiers WSL2 sont séparés.
Les fichiers Windows sont accessibles depuis WSL2 à `/mnt/c/` (pour le lecteur C:), `/mnt/d/` (pour le lecteur D:), et ainsi de suite. Mais il y a un coût en termes de performance. Les discussions communautaires indiquent des différences de performance entre les répertoires montés depuis Windows et les répertoires natifs WSL2.
Pour des performances optimales, copiez les fichiers de projet dans le répertoire personnel de WSL2 :
cp -r /mnt/c/Users/VotreNom/Projects/votre-projet ~/projects/votre-projet
Le compromis ? L'intégration avec l'IDE devient plus complexe. Visual Studio Code gère cela bien avec son extension Remote-WSL, mais d'autres IDE peuvent rencontrer des difficultés.
Tester l'installation
Vérifiez que Claude Code fonctionne correctement avec un test simple.
Accédez à un répertoire de projet (ou créez un dossier de test) :
mkdir ~/claude-test
cd ~/claude-test
claude “crée un simple script Python hello world”
Claude Code devrait répondre, créer le fichier et afficher le code. Cela confirme la réussite de l'installation.
Arrêtez de surpayer, réclamez d'abord les crédits IA disponibles
L'installation de Claude Code sur Windows est généralement rapide. Le coût réel apparaît plus tard lorsque les développeurs commencent à tester les prompts, à exécuter des scripts et à intégrer le modèle dans des applications. Cette phase d'expérimentation peut générer beaucoup d'appels API, et de nombreuses équipes ne réalisent le coût qu'après avoir commencé à construire.
Avant de dépenser de l'argent pour l'utilisation, il est utile de vérifier si vous avez droit à des crédits IA ou à des programmes partenaires. Get AI Perks rassemble ces opportunités en un seul endroit, listant les crédits et les réductions des fournisseurs d'IA, des plateformes cloud et des outils de développement, ainsi que des instructions simples sur la façon de les réclamer.
Avant de lancer votre premier projet Claude Code, consultez Get AI Perks et réclamez les crédits IA qui peuvent couvrir vos coûts de développement.
Questions fréquemment posées
Claude Code peut-il s'exécuter nativement sur Windows sans WSL2 ?
Oui, mais WSL2 reste la meilleure méthode d'installation pour Windows.
Claude Code fonctionne-t-il avec le Terminal Windows ?
Oui. Le Terminal Windows peut ouvrir des onglets Ubuntu, permettant d'accéder à Claude Code sans passer à une fenêtre Ubuntu distincte. Dans le Terminal Windows, cliquez sur la flèche déroulante et sélectionnez Ubuntu dans la liste des profils.
Mes outils de développement Windows existants fonctionneront-ils avec Claude Code ?
Cela dépend de l'outil. Visual Studio Code s'intègre bien grâce à l'extension Remote-WSL. Les IDE JetBrains et d'autres outils peuvent nécessiter une configuration supplémentaire. La documentation officielle mentionne VS Code et JetBrains comme plates-formes prises en charge.
Comment mettre à jour Claude Code sur Windows ?
Claude Code se met à jour automatiquement par défaut. Pour mettre à jour manuellement, exécutez `claude update` dans le terminal Ubuntu. La fonctionnalité de mise à jour automatique peut être désactivée via les fichiers de configuration si nécessaire pour les environnements d'entreprise.
Quelle est la différence entre Claude Code et l'API Claude ?
Claude Code est un assistant de codage basé sur terminal qui exécute des commandes et modifie des fichiers. L'API Claude offre un accès programmatique au modèle de langage de Claude pour construire des applications personnalisées. Ils servent des objectifs différents et nécessitent des processus de configuration différents.
Puis-je utiliser Claude Code avec des projets .NET sur Windows ?
Oui, mais avec des réserves. Les discussions communautaires indiquent que la prise en charge du SDK .NET dans WSL2 fonctionne, mais nécessite l'installation de la version Linux du SDK .NET dans Ubuntu. Le .NET installé sur Windows ne sera pas accessible depuis WSL2.
Combien coûte Claude Code ?
Le prix dépend de l'utilisation et du type de compte. Consultez le site Web officiel d'Anthropic pour connaître les niveaux de prix actuels et les plans d'équipe, car les coûts varient en fonction de la consommation de l'API et des exigences de l'organisation.
Prochaines étapes après l'installation
Avec Claude Code installé, commencez à explorer ses capacités. La documentation de démarrage rapide recommande de commencer par des tâches simples comme l'explication de code avant de passer à des opérations plus complexes.
Essayez ces commandes pour vous familiariser :
- claude “explique cette fonction” – Obtenir des explications de code
- claude commit – Générer des messages de commit Git
- claude -c – Continuer la conversation la plus récente
La documentation officielle fournit des guides détaillés pour l'intégration IDE, l'installation de plugins et les options de configuration avancées. Pour les équipes, les paramètres gérés par serveur et le suivi analytique offrent un contrôle supplémentaire sur les déploiements de Claude Code.
La configuration de WSL2 peut sembler être des étapes supplémentaires par rapport aux applications natives Windows, mais c'est actuellement la seule voie pour exécuter Claude Code sur Windows. La bonne nouvelle ? Une fois configuré, il fonctionne sans problème et s'intègre à la plupart des flux de travail de développement.
