Guide

Utiliser Claude Code sous Windows sans WSL

Pendant longtemps, WSL était la solution habituelle pour utiliser Claude Code sous Windows. Aujourd’hui, il existe des alternatives. Pour travailler avec des agents, l’une d’elles est particulièrement pratique : l’agent tourne sur une machine Linux que vous pilotez depuis Windows via SSH.

Trois options sous Windows

Nativement sous Windows. Claude Code fonctionne désormais directement sous Windows. Vous l’installez dans PowerShell avec :

irm https://claude.ai/install.ps1 | iex

Git pour Windows est facultatif. L’agent travaille alors toutefois sur votre ordinateur Windows avec vos droits, et le bac à sable de Claude Code n’est pas disponible sous Windows natif.

Avec WSL. Claude Code tourne dans un environnement Linux sur votre ordinateur. Cela fonctionne bien, mais demande de la configuration et de l’espace disque. Et l’agent ne travaille que tant que votre ordinateur est allumé.

Sur une machine Linux via SSH. L’agent tourne sur un serveur, et vous vous y connectez depuis Windows. Il est séparé de vos fichiers Windows et continue de travailler quand vous éteignez votre ordinateur. Pour travailler avec des agents, nous recommandons cette approche, et c’est l’objet de la suite de ce guide.

Créer une clé SSH

Windows intègre un client OpenSSH. Ouvrez PowerShell ou Terminal Windows et vérifiez avec ssh -V qu’il est installé. Sinon, ajoutez « Client OpenSSH » dans les Paramètres Windows, sous « Fonctionnalités facultatives ».

Créez ensuite une clé et confirmez l’emplacement proposé :

ssh-keygen -t ed25519

Pour afficher la partie publique de la clé :

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

Déposez ce texte sur le serveur, par exemple dans le fichier ~/.ssh/authorized_keys ou dans l’espace client de votre fournisseur.

Enregistrer la connexion dans la configuration SSH

Pour ne pas avoir à saisir l’adresse et l’utilisateur à chaque fois, créez un fichier config dans le dossier .ssh de votre répertoire utilisateur, sans extension, et saisissez :

Host meinserver
  HostName 203.0.113.10
  User dev

Remplacez l’adresse et l’utilisateur par vos propres valeurs. Désormais, il suffit de taper :

ssh meinserver

VS Code avec Remote-SSH

Si vous préférez travailler dans un éditeur, installez dans VS Code l’extension « Remote - SSH » de Microsoft. Ouvrez la palette de commandes avec Ctrl+Maj+P et choisissez « Remote-SSH: Connect to Host... ». VS Code lit votre configuration SSH ; vous choisissez meinserver et travaillez ensuite directement sur le serveur, avec ses fichiers et son terminal.

Claude Code sur la machine Linux

Installez Claude Code sur le serveur :

curl -fsSL https://claude.ai/install.sh | bash

Lancez-le ensuite avec claude et connectez-vous avec votre compte Claude ou une clé d’API. Pour que l’agent continue de tourner quand vous éteignez Windows ou que la connexion coupe, lancez-le dans une session tmux. Le guide Claude Code continue de tourner, portable fermé explique comment faire.

Conclusion

Pour utiliser Claude Code sous Windows, vous n’avez pas besoin de WSL. Avec le SSH intégré, Terminal Windows et VS Code, vous travaillez confortablement avec un agent sur une machine Linux, proprement séparée de votre ordinateur. Si vous préférez vous épargner la configuration du serveur : la euhost Box est exactement ce type de machine, prête à l’emploi et hébergée en Allemagne.