Ouvrir VS Code directement sur son VPS en un double-clic (Windows et Mac)
Pour ouvrir VS Code directement sur votre VPS en un double-clic, créez sur le Bureau un fichier .bat sous Windows ou .command sous Mac contenant la commande code --remote ssh-remote+alias, suivie du dossier visé. L'extension Remote SSH de VS Code fait le reste : connexion, bon dossier, aucune saisie.
Tout mon système tourne sur un serveur distant : mes agents, mes scripts, mes documents de travail. Rien sur mon poste. Mes agents y travaillent jour et nuit, construits avec les briques de Claude, agents, skills et MCP. Chaque fois que je voulais travailler dessus dans VS Code, je devais ouvrir la palette de commandes, taper « Connect to host », choisir le bon serveur, puis naviguer jusqu'au bon dossier. Du temps perdu, tous les jours.
Un fichier sur le Bureau a réglé cela définitivement, sur Windows comme sur Mac.
Sur Windows, le fichier porte l'extension .bat ; sur Mac, .command. Dans les deux cas, l'astuce repose sur la commande code --remote de VS Code et sur l'extension Remote SSH de Microsoft. Bonus : l'extension Claude Code, installée depuis la fenêtre connectée au serveur, y reste disponible à chaque connexion, sur les fichiers du serveur.
1. De quoi a-t-on besoin pour connecter VS Code à un VPS ?
Deux choses : VS Code avec l'extension Remote SSH de Microsoft, et un fichier ~/.ssh/config qui liste vos serveurs avec leurs alias et leurs clés SSH. Côté machine distante, il faut un service SSH actif.
D'après la documentation Visual Studio Code, Remote Development using SSH, l'extension installe sur la machine distante un « VS Code Server » et y exécute les commandes et la plupart des extensions : aucun code n'a besoin d'être sur votre poste. Si votre ~/.ssh/config ressemble à ceci, vous êtes prêt :
L'alias monserveur est ce que vous utiliserez dans le fichier de raccourci. VS Code gère la clé SSH à partir de cette configuration. Celle qui figure ci-dessus est réservée aux exemples : remplacez-la par l'adresse de votre serveur.
2. Comment ouvrir VS Code sur son VPS depuis Windows ?
Sous Windows, créez sur le Bureau un fichier texte nommé par exemple Mon VPS.bat, avec deux lignes : @echo off, puis la commande code --remote suivie de l'alias SSH et du dossier du serveur. Un double-clic sur ce fichier ouvre VS Code, connecté, dans le bon dossier.
Nommez-le Mon VPS.bat (l'extension .bat compte), et mettez-y exactement ceci :
La syntaxe vient de la documentation Visual Studio Code, Command Line Interface (CLI) : l'option --remote prend la forme ssh-remote+serveur suivie du chemin sur la machine distante. Remplacez monserveur par l'alias défini dans votre configuration SSH, et /chemin/vers/mon/dossier par le chemin absolu sur le serveur (par exemple /var/www/monprojet).
Double-clic : VS Code s'ouvre, se connecte en SSH, charge le bon dossier.
Si cela ne marche pas : vérifiez que la commande code est dans votre PATH Windows. Ouvrez un terminal et tapez code --version. L'installateur Windows de VS Code ajoute normalement la commande au PATH ; sinon, la documentation Visual Studio Code, Command Line Interface (CLI) indique l'emplacement à ajouter à la variable Path, par défaut AppData\Local\Programs\Microsoft VS Code\bin dans votre dossier utilisateur. Réinstaller VS Code règle aussi le problème.
3. Comment ouvrir VS Code sur son VPS depuis un Mac ?
Sur Mac, l'équivalent du .bat est un fichier .command : un petit script qui commence par #!/bin/bash, suivi de la même commande code --remote, avec l'alias SSH et le dossier. Rendez-le exécutable une seule fois dans le Terminal, puis lancez-le d'un double-clic depuis le Finder.
Créez un fichier texte sur le Bureau, nommez-le Mon VPS.command, et mettez-y :
Ensuite, rendez-le exécutable. Comme l'explique Apple, Intro to shell scripts in Terminal on Mac, un script commence par les caractères #! suivis du shell à utiliser, et l'outil chmod le rend exécutable. Ouvrez le Terminal et tapez :
Double-clic depuis le Finder : le Terminal s'ouvre brièvement, lance la commande, VS Code se connecte au bon serveur dans le bon dossier.
Si code n'est pas trouvé sur Mac : selon la documentation Visual Studio Code, Installing Visual Studio Code on macOS, ouvrez VS Code, la palette de commandes (Cmd+Maj+P), et lancez « Shell Command: Install 'code' command in PATH », puis redémarrez le Terminal. Si le problème persiste, mettez le chemin complet dans le .command : /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code --remote ...
4. Comment gérer plusieurs VPS avec cette méthode ?
Pas de magie : un fichier par VPS. Sur le Bureau, cela donne quelque chose comme :
VPS - production.batVPS - preproduction.batVPS - sauvegardes.bat
Chaque fichier pointe vers son propre alias SSH et son propre dossier. Aucune saisie, aucune navigation.
5. Comment trouver le bon chemin sur son VPS ?
Connectez-vous une première fois en SSH classique depuis un terminal, avec la commande ssh suivie de votre alias. Explorez ensuite les dossiers avec ls et pwd jusqu'à trouver celui qui contient votre code. Copiez ce chemin absolu dans votre fichier .bat ou .command : vous ne le retaperez plus.
Puis pwd vous affiche le chemin complet du dossier où vous êtes, et ls son contenu. C'est la seule fois où vous aurez à naviguer à la main.
6. Peut-on utiliser Claude Code directement sur le serveur ?
Installez l'extension Claude Code depuis la fenêtre connectée au VPS, pas seulement sur votre poste ; elle est décrite dans Anthropic, Use Claude Code in VS Code. La documentation Visual Studio Code, Remote Development using SSH précise qu'une extension installée depuis la vue Extensions se place automatiquement au bon endroit, et que la plupart s'exécutent sur la machine distante.
Résultat : double-clic sur le .bat ou le .command, VS Code s'ouvre, SSH connecté, bon dossier chargé, et Claude Code à portée de clic dans la barre latérale, qui travaille directement sur les fichiers du serveur. Pour que ces sessions restent précises, gardez en tête quand relancer Claude avant que sa fenêtre de contexte sature.
Sur le serveur qui fait tourner mes agents, c'est devenu ma façon standard de travailler : mon poste Windows n'est qu'un terminal d'accès, et le Mac quand je suis en déplacement.
Pourquoi cela marche : VS Code Remote SSH installe un serveur VS Code sur le VPS. Les extensions installées côté serveur, dont Claude Code, se lancent dans cet environnement distant, comme si vous y étiez.
7. Synthèse : Windows et Mac en un coup d'œil
Windows : fichier .bat, une ligne code --remote ssh-remote+HOST /PATH, double-clic direct.
Mac : fichier .command, même ligne précédée de #!/bin/bash, chmod +x une seule fois, puis double-clic depuis le Finder.
Dans les deux cas, rien de plus à installer : VS Code et son extension Remote SSH suffisent. C'est le genre de petites automatisations qui, mises bout à bout, changent une semaine de dirigeant : j'en parle dans IA et automatisation : ce qu'un dirigeant de PME doit savoir en 2026.
Ce sont ces agents, et la façon dont ils ont changé mes journées, que je raconte dans mon livre Recommencer à décider : 98 pages d'histoire vraie, que j'offre aux dirigeants qui me les demandent.
Une décision à prendre, et personne à qui en parler ?
Coaching et consulting de dirigeants : un appel de 15 minutes, sans frais, pour voir si je peux vous être utile.
Réserver un appel découverte →Questions fréquentes
C'est quoi un fichier .bat sur Windows ?
Un script texte Windows. Double-cliquer dessus exécute les commandes qu'il contient dans l'invite de commande. Ici, une seule ligne suffit pour lancer VS Code en mode Remote SSH sur le bon serveur et dans le bon dossier.
C'est quoi un fichier .command sur Mac ?
L'équivalent Mac du .bat Windows : un script shell qu'on rend exécutable avec chmod +x et qu'on peut double-cliquer depuis le Finder. Il ouvre un terminal et exécute la commande.
Comment trouver le bon chemin sur votre VPS ?
Connectez-vous une première fois en SSH en ligne de commande, puis tapez ls pour lister les dossiers. Le chemin à utiliser est celui du dossier où se trouve votre code, par exemple /var/www/monprojet. Une fois identifié, vous ne le retapez plus.
Est-ce que cela marche avec plusieurs VPS ?
Oui, un fichier par VPS. Chacun pointe vers un hôte et un dossier différents. Vous pouvez avoir autant de fichiers que de serveurs, tous sur le Bureau.
Faut-il installer l'extension Remote SSH de VS Code ?
Oui. L'extension Remote SSH de Microsoft doit être installée dans VS Code. Sans elle, la commande code --remote ne fonctionne pas.
Peut-on utiliser Claude Code sur le VPS depuis VS Code ?
Oui. Installez l'extension Claude Code depuis la fenêtre connectée au VPS : VS Code la place au bon endroit et, comme la plupart des extensions, elle s'exécute côté serveur. Elle est alors disponible à chaque connexion, sur les fichiers du serveur.
La connexion SSH fonctionne-t-elle avec des clés différentes par serveur ?
Oui, à condition de configurer ~/.ssh/config correctement. Chaque entrée Host peut avoir sa propre IdentityFile. Le fichier .bat ou .command appelle l'alias, et la configuration SSH fournit la bonne clé.
Cette astuce fonctionne-t-elle pour un hébergement mutualisé ?
Uniquement si l'hébergeur autorise SSH. Les VPS et serveurs dédiés en donnent en général, l'hébergement mutualisé pas toujours.