Ouvrir VS Code directement sur son VPS en un double-clic (Windows et Mac)
Un seul fichier sur le Bureau suffit pour ouvrir VS Code connecté en SSH sur n'importe quel VPS, dans le bon dossier, sans taper un caractère. Sur Windows : un fichier .bat. Sur Mac : un fichier .command. Double-clic, c'est fait. L'astuce utilise la commande code --remote de VS Code, disponible dès que l'extension Remote SSH est installée. Bonus : si Claude Code est installé sur le VPS, il s'ouvre à la connexion.
Tout mon système tourne sur un serveur distant : mes agents, mes scripts, mes documents de travail. Rien sur mon poste. 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. Trente secondes perdues, à chaque fois.
Un fichier sur le Bureau a réglé cela définitivement. Voici exactement comment faire, sur Windows et sur Mac.
1. Ce dont vous avez besoin avant de commencer
Deux choses : VS Code avec l'extension Remote SSH (celle de Microsoft, gratuite), et un fichier ~/.ssh/config qui liste vos serveurs avec leurs alias et leurs clés SSH.
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.
2. La solution Windows : un fichier .bat
Créez un fichier texte sur le Bureau, nommez-le Mon VPS.bat (l'extension .bat compte), et mettez-y exactement ceci :
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. En cas d'erreur, ouvrez VS Code, la palette de commandes (Ctrl+Maj+P), et cherchez « Install 'code' command in PATH ».
3. La solution Mac : un fichier .command
Sur Mac, l'équivalent du .bat s'appelle un fichier .command. Créez un fichier texte sur le Bureau, nommez-le Mon VPS.command, et mettez-y :
Ensuite, rendez-le 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 : ouvrez VS Code, palette de commandes (Cmd+Maj+P), cherchez « Install 'code' command in PATH ». Cela crée le lien dans /usr/local/bin/code. Si le problème persiste, mettez le chemin complet dans le .command : /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code --remote ...
4. Plusieurs VPS : un fichier par serveur
Pas de magie : un fichier par VPS. Sur le Bureau, cela donne quelque chose comme :
VPS - app.monsite.fr.batVPS - pilotage.monsite.fr.batVPS - jeanclaude.ai.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
Si vous ne connaissez pas le chemin exact de votre code sur le serveur, connectez-vous une première fois en SSH classique depuis un terminal :
Puis explorez avec ls et pwd pour trouver votre code. Une fois le chemin identifié, copiez-le dans votre fichier .bat ou .command. Vous ne le retapez plus jamais.
6. Le bonus : Claude Code s'ouvre à la connexion
Si vous avez installé l'extension Claude Code sur le VPS distant (pas seulement sur votre poste), VS Code la détecte à la connexion et l'active.
Résultat : double-clic sur le .bat ou le .command, VS Code s'ouvre, SSH connecté, bon dossier chargé, et une session Claude Code est prête dans la barre latérale. Zéro friction, zéro clic supplémentaire.
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, le Mac aussi en déplacement.
Pourquoi cela marche : VS Code Remote SSH copie et exécute un serveur VS Code léger sur le VPS. Toutes 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 : zéro dépendance, zéro outil tiers, zéro configuration avancée. VS Code et son extension Remote SSH.
Ce VPS est devenu le poste de travail unique où tourne mon équipe d'agents IA, une aventure que je raconte dans mon livre Recommencer à décider : 98 pages d'histoire vraie, que j'offre aux dirigeants qui me les demandent.
Vous voulez voir ces chiffres chaque matin sans les chercher ?
Le Diagnostic Pilotage, 1 500 € HT, vous laisse un outil en service sous sept jours.
Découvrir le Diagnostic Pilotage →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, exécute la commande et se referme.
Comment trouver le bon chemin sur mon 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 que VS Code Remote SSH soit installé ?
Oui. L'extension Remote SSH de Microsoft doit être installée dans VS Code. Elle est gratuite. Sans elle, la commande code --remote ne fonctionne pas.
Pourquoi VS Code ouvre-t-il parfois une session Claude Code automatiquement ?
Si l'extension Claude Code est installée sur le VPS distant (pas seulement sur votre poste), VS Code la détecte à la connexion et l'active. C'est un bonus utile quand on travaille sur un serveur où des agents IA tournent.
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 simplement l'alias, qui gère la clé de façon transparente.
Cette astuce fonctionne-t-elle pour un hébergement mutualisé ?
Uniquement si l'hébergeur autorise SSH. Les VPS et serveurs dédiés l'autorisent toujours. L'hébergement mutualisé standard, souvent non. Si vous avez un accès SSH, cette astuce fonctionne.