I
IA Outils
Connexion S'inscrire
← Retour à Guides
S
Samuel Admin 23 avr. 2026
Publié dans Guides

Claude Code sur Windows : installation, limites, WSL et solutions en 2026

Le guide concret pour utiliser Claude Code sur Windows sans perdre des heures entre WSL, app desktop, PowerShell et bugs de shell.

Windows Guides
IA OUTILS — Windows

Claude Code Windows

WSL, desktop, PowerShell

Si tu cherches Claude Code sur Windows, tu tombes vite sur deux problèmes: les conseils se contredisent, et beaucoup de guides parlent d'anciennes versions.

Voici la version simple:

  • si tu veux le setup le plus stable pour coder, utilise WSL avec ton repo dedans
  • si tu veux une expérience plus visuelle, teste aussi l'app desktop quand ton workflow s'y prête
  • si tu dépends d'outils purement Windows, reste prudent avec le terminal natif et teste chaque commande critique

L'objectif de ce guide n'est pas de répéter la doc. L'objectif est de te donner le setup qui évite les blocages réels.

Claude Code fonctionne-t-il vraiment sur Windows ?

Oui, mais pas de la même façon selon ton environnement.

Il faut distinguer trois cas:

  1. WSL
  2. Windows natif avec PowerShell
  3. app desktop

En pratique, WSL reste le choix le plus robuste dès que tu bosses sur Node, Python, Git, Docker ou une stack web classique.

Option 1: WSL, le setup recommandé

Si ton but est de coder vite avec le moins de friction, c'est le bon choix.

Pourquoi WSL reste le meilleur compromis

  • les commandes shell sont cohérentes
  • Git, Node, Python et Docker sont plus prévisibles
  • les exemples de docs et d'outils marchent plus souvent sans adaptation
  • Claude Code raisonne mieux dans un environnement proche de Linux

Setup conseillé

  1. Installer WSL 2
  2. Installer Ubuntu
  3. Cloner ton repo dans le système de fichiers Linux
  4. Installer Node, Git et tes dépendances dans WSL
  5. Lancer Claude Code depuis ce workspace

Le détail à ne pas rater: évite de travailler sur un repo stocké côté Windows puis monté dans WSL si tu veux de bonnes performances. Mets le repo directement dans le home Linux.

Option 2: Windows natif avec PowerShell

Cette option peut marcher, mais elle est plus fragile.

Elle devient acceptable si:

  • tu dois piloter des outils Windows uniquement
  • tu touches à des APIs ou interfaces spécifiques à Windows
  • ton équipe a déjà un workflow PowerShell bien propre

Les problèmes les plus fréquents

  • commandes Bash qui gèlent ou se comportent bizarrement
  • différences de chemins entre C:\ et les chemins Unix
  • pipes, regex et quoting qui cassent
  • outils Node ou Python qui supposent un shell Unix

Si tu restes en natif Windows, fais simple:

  • privilégie PowerShell 7
  • garde des commandes courtes
  • documente dans ton CLAUDE.md que l'environnement est Windows
  • demande à l'agent de proposer d'abord la commande avant de l'exécuter pour les opérations sensibles

Option 3: app desktop

L'app desktop est utile si tu veux:

  • monitorer les sessions plus facilement
  • naviguer dans un environnement plus visuel
  • combiner travail local et sessions suivies

Mais l'app ne remplace pas la logique de ton environnement. Si ton repo, ton shell ou tes dépendances sont mal posés, l'app ne corrigera pas ça.

Mon setup recommandé pour un développeur solo

Si tu fais du web, du SaaS ou des automations

  • Windows 11
  • WSL 2
  • repo dans Ubuntu
  • VS Code connecté au dossier WSL
  • Claude Code lancé dans ce workspace

Si tu fais de l'automatisation Windows native

  • PowerShell 7
  • repo local Windows
  • commandes prudentes
  • garde-fous explicites dans CLAUDE.md

Les erreurs qui font perdre du temps

1. Installer WSL mais laisser le repo sur le disque Windows

Tu gardes les inconvénients des deux mondes: perfs moyennes, chemins hybrides, surprises de permissions.

2. Ne rien écrire dans CLAUDE.md

Ajoute au minimum:

Tu travailles dans un environnement Windows avec WSL.
Privilégie les commandes compatibles avec le shell courant.
Explique les commandes risquées avant exécution.
Utilise des chemins cohérents avec l'environnement actif.

3. Mélanger Bash, CMD et PowerShell sans le dire

Plus ton environnement est ambigu, plus l'agent prend de mauvaises décisions.

Quand choisir Claude Code sur Windows plutôt qu'un autre outil ?

Claude Code devient très intéressant si tu veux:

  • déléguer des tâches multi-étapes
  • faire de la vraie exploration de codebase
  • enchaîner lecture, édition, tests et refactor

Si tu veux surtout de l'autocomplétion IDE, regarde aussi Cursor IDE Pro.

Si tu veux comparer les deux approches, lis aussi:

Checklist rapide

  • WSL 2 installé
  • repo stocké côté Linux
  • Node, Git et dépendances installés dans WSL
  • CLAUDE.md adapté à Windows ou WSL
  • tests et commandes sensibles validés une première fois à la main

FAQ

Claude Code sur Windows sans WSL, bonne idée ?

Seulement si tu as une raison concrète de rester en natif.

Claude Code est-il plus stable dans WSL ?

Oui, dans la majorité des workflows développeur.

L'app desktop remplace-t-elle WSL ?

Non. Elle améliore l'expérience, mais ne remplace pas un environnement propre.

Verdict

Si tu veux Claude Code sur Windows sans te battre contre ton setup, pars sur WSL 2. C'est aujourd'hui le chemin le plus simple, le plus stable et le plus proche d'un workflow production-ready.