Ouvrir VS Code directement sur son VPS en un double-clic (Windows & 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 seul 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 automatiquement à la connexion.
J'ai quatre VPS. Chaque fois que je voulais travailler sur l'un d'eux dans VS Code, je devais ouvrir la palette de commandes, taper "Connect to host", choisir le bon serveur, puis naviguer dans le bon dossier. Trente secondes perdues, à chaque fois.
Un fichier sur le Bureau a réglé ça définitivement. Voici exactement comment faire, sur Windows et sur Mac.
1. Ce dont vous avez besoin avant de commencer
Deux choses uniquement : VS Code installé avec l'extension Remote SSH (celle de Microsoft, gratuite), et un fichier ~/.ssh/config qui liste vos serveurs avec leurs alias et clés SSH.
Si votre ~/.ssh/config ressemble à ça, vous êtes prêt :
L'alias monserveur est ce que vous utiliserez dans le fichier de raccourci. VS Code gère la clé SSH automatiquement à partir de ce config.
2. La solution Windows : un fichier .bat
Créez un fichier texte sur le Bureau, nommez-le Mon VPS.bat (l'extension .bat est importante), et mettez-y exactement ceci :
Remplacez monserveur par l'alias défini dans votre SSH config, 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 ça ne marche pas : vérifiez que la commande code est bien dans votre PATH Windows. Ouvrez un terminal et tapez code --version. Si ça retourne une erreur, allez dans VS Code, ouvrez 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 : 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". Ça crée le lien symbolique dans /usr/local/bin/code. Si le problème persiste, ajoutez directement 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 ici : un fichier par VPS. Sur le Bureau, ça 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 où est votre code. Une fois identifié, copiez le chemin complet dans votre fichier .bat ou .command. Vous ne retapez plus jamais ce chemin.
6. Le bonus inattendu : Claude Code s'ouvre automatiquement
Si vous avez installé l'extension Claude Code directement sur le VPS distant (pas seulement en local sur votre poste), VS Code la détecte à la connexion et l'active automatiquement.
Résultat : double-clic sur le .bat ou .command, VS Code s'ouvre, SSH connecté, bon dossier chargé, et une session Claude Code est déjà prête à l'emploi dans la barre latérale. Zéro friction, zéro clic supplémentaire.
Sur mes serveurs qui font tourner des agents IA, c'est devenu le moyen standard de travailler.
Pourquoi ça 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 étiez en local.
7. Synthèse : Windows vs Mac en un coup d'oeil
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. Juste VS Code et son extension Remote SSH.
Vous automatisez votre stack technique ?
Dans mes sociétés, on construit des systèmes qui travaillent sans qu'on soit là. Si vous voulez aller plus loin sur l'automatisation et les agents IA pour votre business, discutons-en.
Réserver un appel →Questions fréquentes
C'est quoi un fichier .bat sur Windows ?
Un fichier .bat est 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 ?
Un fichier .command est 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 via 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 ou /home/rod/agents. Une fois identifié, vous ne retapez plus jamais ce chemin.
Est-ce que ça marche si j'ai 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 et disponible dans le marketplace. Sans elle, la commande code --remote ne fonctionnera pas.
Pourquoi VS Code ouvre parfois une session Claude Code automatiquement ?
Si l'extension Claude Code est installée sur le VPS distant (pas seulement en local), VS Code la détecte à la connexion et l'active automatiquement. C'est un bonus très utile quand on travaille sur des serveurs où des agents IA tournent.
La connexion SSH fonctionne-t-elle avec des clés SSH 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 défini dans ce config, qui gère la clé de façon transparente.
Est-ce que cette astuce fonctionne aussi pour des serveurs d'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.