Le port 22 est le port SSH par défaut indiqué dans la documentation consacrée au client OpenSSH de Windows (détails sur le port SSH par défaut). Pour un étudiant qui utilise Windows, la conséquence est simple : Claude Code Desktop peut servir d’interface pour se connecter en SSH à un Mac distant, mais SSH ne montre pas le bureau du Mac. Les commandes et les outils du projet s’exécutent sur le Mac distant ; un devoir qui exige de manipuler les fenêtres de Xcode nécessite aussi un accès graphique distinct.
Ce guide s’adresse aux étudiants qui n’ont qu’un ordinateur Windows et doivent travailler sur un projet macOS.
Il convient également aux débutants qui veulent vérifier, avant de commencer leur cours, où se trouvent les fichiers et où s’exécutent les commandes.
Si le besoin se limite à voir ou à manipuler le bureau du Mac, une session SSH seule ne suffira pas.
Dernière mise à jour : 13 octobre 2026. Les conditions de connexion et les fonctions mentionnées sont vérifiées à partir de la documentation officielle de Claude Code Desktop et des exigences de Claude Desktop.
[ SECTION_01 ] Avant la connexion : identifier le Mac, le compte et le dossier du cours
Dans cette procédure, le Mac distant est l’ordinateur hébergé ailleurs, auquel le cours ou un service autorisé donne accès. Le compte SSH est le compte qui permet d’ouvrir une session sur cette machine. Le dossier du projet est le répertoire où se trouvent les fichiers du devoir. Ces trois éléments doivent être confirmés avant d’ouvrir Claude Code Desktop : l’application ne peut pas deviner quel ordinateur ni quel projet l’étudiant doit utiliser.
La documentation de Claude Code indique que Claude Code Desktop peut utiliser SSH pour travailler sur un hôte distant sous macOS ou Linux. Elle décrit également l’installation à distance de Claude Code lors de la première connexion. Les prérequis exacts peuvent évoluer ; il faut donc vérifier les conditions dans la documentation de la connexion SSH de Claude Code Desktop, plutôt que de s’appuyer sur un ancien tutoriel ou de supposer qu’une connexion fonctionnera de la même manière pour tous les comptes.
Avant de continuer, il faut disposer des éléments suivants :
- l’adresse réseau du Mac, fournie par l’administrateur ou par le service qui le met à disposition ;
- le nom du compte autorisé sur cette machine ;
- le port SSH, ainsi que l’information indiquant s’il s’agit du port habituel ou d’un port différent ;
- une méthode d’authentification autorisée, par exemple une clé SSH ;
- le chemin exact du dossier contenant le projet de cours.
Le Mac doit aussi accepter les connexions à distance. Sur une machine gérée par un établissement, l’option correspondante peut être désactivée ou réservée à certains comptes. Le guide Apple explique où consulter les réglages de connexion à distance d’un Mac : autoriser l’accès d’un ordinateur distant au Mac. Cette indication ne donne pas à l’étudiant le droit d’activer l’accès lui-même : la politique de l’établissement ou du responsable de la machine reste prioritaire.
À retenir : si l’adresse, le compte ou les droits d’accès ne sont pas confirmés, arrêtez-vous là et demandez les informations à la personne qui administre la machine. Ne tentez pas de contourner une restriction de l’école, du réseau ou du compte.
[ SECTION_02 ] SSH ou bureau distant : choisir le bon accès
Le mot « accès distant » recouvre deux usages différents. SSH ressemble à une porte qui mène à la salle des commandes : il permet d’ouvrir un terminal sur le Mac et de travailler avec les fichiers accessibles depuis cette session. Le bureau distant transmet l’affichage graphique et permet, selon la solution autorisée, d’interagir avec les fenêtres.
| Besoin du cours | SSH dans Claude Code Desktop | Accès graphique au Mac |
|---|---|---|
| Demander à Claude Code d’examiner des fichiers sur le Mac | Très adapté : la session peut viser le dossier distant | Possible, mais pas nécessaire pour une tâche en terminal |
| Lancer ou vérifier une commande disponible sur le Mac | Adapté : la commande s’exécute dans la session distante | Possible, mais l’accès graphique n’est pas le but principal |
| Cliquer dans Xcode, ouvrir un panneau ou manipuler une fenêtre | Insuffisant : SSH ne transmet pas l’image du bureau | Nécessaire si l’exercice impose l’interface graphique |
| Voir le simulateur iOS à l’écran | Insuffisant à lui seul | À vérifier selon l’accès graphique effectivement fourni |
| Modifier un projet sans mélanger fichiers locaux et distants | Adapté si le dossier sélectionné est bien celui du Mac | Adapté si les fichiers ouverts sont ceux de la machine distante |
Ces appréciations sont fonctionnelles, pas des mesures de performance. Le choix dépend du livrable demandé. Une consigne qui demande une compilation en ligne de commande n’impose pas automatiquement le contrôle du bureau ; une consigne qui demande une capture du simulateur ou une manipulation de l’interface Xcode ne peut pas être validée en prétendant qu’une session SSH affiche cet écran.
Pour accéder au bureau, il faut vérifier séparément les droits, la méthode de connexion et la disponibilité de l’affichage. Le guide Apple sur le partage de l’écran d’un autre Mac décrit une approche graphique, distincte de SSH. La disponibilité réelle dépend de la configuration de la machine distante et des règles de l’établissement.
[ SECTION_03 ] Première connexion : ajouter l’hôte SSH dans Claude Code Desktop
Dans Claude Code Desktop, ouvrez la fonction de connexion à un environnement distant, puis choisissez l’ajout d’un hôte SSH. Les noms des menus peuvent évoluer avec les versions ; suivez les intitulés affichés dans votre application et comparez-les aux indications officielles avant de saisir des informations.
Les champs correspondent aux éléments remis par l’administrateur :
- Adresse de l’hôte : l’adresse de la machine distante, comparable à son adresse postale sur le réseau.
- Port : la porte réseau utilisée pour SSH. Le port par défaut est 22 ; si l’administrateur a fourni une autre valeur, utilisez celle-ci. La documentation d’OpenSSH sous Windows décrit le port par défaut et la configuration du client.
- Nom du compte : l’identifiant autorisé sur le Mac. Ce n’est pas nécessairement le même que le nom utilisé pour ouvrir une session Windows.
- Fichier d’identité : le fichier de clé privée, si l’authentification demande une clé. Une clé privée ressemble à une clé de maison que son propriétaire garde sur lui ; l’application peut s’en servir pour prouver son identité sans en révéler le contenu.
- Configuration SSH existante : si une connexion a déjà été préparée sur l’ordinateur et que l’application propose de l’utiliser, vérifiez que l’entrée désigne bien le Mac attendu avant de la sélectionner.
Si le poste Windows ne dispose pas encore du client SSH, la documentation décrit son installation et son premier usage dans le guide OpenSSH pour Windows. Cependant, un étudiant utilisant un ordinateur administré ne doit pas installer ou activer un outil sans vérifier les règles applicables.
Une clé privée, un mot de passe ou un jeton de connexion ne doit être ni envoyé à un camarade, ni copié dans une consigne destinée à Claude, ni ajouté à un dépôt de code. Si une clé semble avoir été exposée, interrompez son usage et demandez à l’administrateur comment la remplacer.
Après avoir rempli les champs, lancez la connexion. À la première ouverture, Claude Code Desktop peut installer Claude Code sur l’hôte distant, selon la procédure et les conditions indiquées dans sa documentation officielle des sessions SSH. Si une erreur apparaît, ne modifiez pas au hasard les autorisations du Mac : vérifiez d’abord l’adresse, le compte, le port et la méthode d’authentification, puis demandez l’aide de l’administrateur si l’accès reste refusé.
[ SECTION_04 ] Session ouverte : sélectionner le projet distant
Une connexion réussie ne signifie pas encore que le bon projet est ouvert. Dans Claude Code Desktop, choisissez le dossier du cours situé sur le Mac distant. Vérifiez le chemin proposé avant d’autoriser une tâche. Un dossier local affiché sur Windows et un dossier du Mac peuvent porter le même nom : le nom seul ne permet donc pas de savoir où vous travaillez.
L’interface graphique peut rester ouverte sur l’ordinateur Windows tandis que les fichiers manipulés se trouvent sur le Mac. C’est précisément la différence entre l’écran qui affiche la conversation et la machine qui exécute le travail. Pour lever le doute, demandez une vérification sans modification : faire l’inventaire des fichiers du dossier, lire le fichier d’instructions du cours ou identifier les outils de développement disponibles. Ne commencez pas par demander une réécriture générale du projet.
Si le projet est suivi avec Git, une consultation des différences aide à contrôler ce qui a changé. La commande git diff sert à afficher les modifications entre versions ou dans l’arbre de travail ; sa documentation explique les formes de comparaison disponibles (référence de git diff). Cette vérification doit porter sur le dépôt distant sélectionné, et non sur une copie locale que l’étudiant aurait ouverte par erreur.
[ SECTION_05 ] Premier exercice : limiter la modification et vérifier le résultat
Pour une première utilisation en cours, choisissez une tâche circonscrite : corriger une faute dans un fichier, ajouter un commentaire demandé par l’enseignant ou expliquer une fonction sans la modifier. Une consigne précise permet de contrôler le résultat et évite qu’une demande vague ne transforme plusieurs parties du projet.
Une fois la proposition effectuée, le contrôle reste à la charge de l’étudiant :
- relisez le diff et repérez chaque fichier touché ;
- comparez les changements aux exigences du devoir ;
- vérifiez qu’aucun fichier de configuration, secret ou document sans rapport n’a été modifié ;
- faites exécuter une commande de vérification uniquement si elle est prévue et autorisée pour le projet ;
- conservez une version récupérable du travail selon les règles du cours.
Pour les projets Xcode, distinguez la construction en ligne de commande de la validation dans l’interface graphique. La documentation de référence des outils en ligne de commande Xcode présente les outils accessibles depuis le terminal. Une commande de construction peut donc vérifier une partie du projet, mais elle ne remplace pas une consigne qui exige d’ouvrir une fenêtre, d’examiner un aperçu visuel ou de montrer le simulateur. Une session SSH ne devient pas un bureau distant parce qu’elle peut lancer une commande liée à Xcode.
[ SECTION_06 ] Liste de contrôle avant de rendre le travail
Cochez les points applicables avant de considérer l’environnement comme prêt :
- [ ] L’administrateur ou le cours a confirmé que le compte peut se connecter au Mac par SSH.
- [ ] L’adresse, le nom de compte et le port proviennent d’une source autorisée.
- [ ] La clé privée reste sur l’ordinateur ou dans l’emplacement sécurisé prévu ; son contenu n’a pas été partagé.
- [ ] Claude Code Desktop a ouvert le dossier du projet sur le Mac distant, et non une copie locale portant le même nom.
- [ ] Une demande de lecture ou d’inventaire a confirmé les fichiers disponibles sans modifier le projet.
- [ ] Les différences Git ont été examinées après toute modification proposée.
- [ ] La méthode de validation correspond à la consigne : terminal si cela suffit, accès graphique si le cours demande Xcode ou le simulateur à l’écran.
- [ ] Les restrictions de l’école, du compte et du réseau ont été respectées.
Cette liste distingue les problèmes de connexion des problèmes de rendu. Si les fichiers et les commandes fonctionnent sur le Mac, mais que le devoir exige encore une capture ou une interaction avec l’interface Xcode, il ne faut pas multiplier les essais SSH : il faut demander si un accès graphique est autorisé et disponible.
[ SECTION_07 ] Questions fréquentes sur la connexion
La version Windows de Claude Code Desktop peut-elle se connecter à un Mac distant ?
Oui, la documentation de Claude Code Desktop décrit une connexion SSH à un hôte distant sous macOS ou Linux. Windows fournit l’interface locale ; le projet et les outils choisis pour la session sont sur l’hôte distant. Vérifiez les exigences de la version installée et l’autorisation du compte avant de préparer le travail, car un ordinateur scolaire peut bloquer certaines connexions.
Comment ajouter un hôte SSH dans Claude Code Desktop ?
Dans les réglages de connexion à distance, indiquez l’adresse de l’hôte, le port, le nom du compte et, si nécessaire, le chemin de la clé privée autorisée. Si une configuration SSH existe déjà sur le poste, l’application peut permettre de la réutiliser. Comparez ses paramètres avec les informations de l’administrateur ; ne devinez pas l’adresse et ne partagez jamais le contenu d’une clé.
Où s’exécutent les commandes après la connexion au Mac ?
Les commandes lancées dans une session dont le dossier est hébergé sur le Mac distant s’exécutent dans cet environnement. L’écran de Claude Code Desktop, lui, reste sur Windows. Avant une opération qui modifie des fichiers, vérifiez le chemin du projet et commencez par une demande de lecture sans changement : cela évite de confondre le dossier distant avec une copie locale.
Une connexion SSH permet-elle de manipuler les fenêtres de Xcode ?
Non. SSH fournit une session en ligne de commande, pas l’image du bureau du Mac. Vous ne pouvez donc pas en déduire que les fenêtres Xcode ou le simulateur sont visibles ou manipulables. Si l’exercice demande une validation graphique, demandez à l’établissement ou à l’administrateur si un accès au bureau distant est disponible et autorisé, puis configurez-le séparément.
[ SECTION_08 ] Choisir la suite selon le livrable
Si le cours demande seulement de lire du code, de modifier des fichiers et d’exécuter des commandes sur macOS, une session SSH correctement configurée peut suffire. Si le travail exige de présenter l’interface Xcode ou le simulateur, il faut ajouter un accès graphique autorisé ; SSH seul ne remplit pas cette exigence.
Lorsque Windows est l’unique ordinateur disponible et que le devoir dépend réellement d’outils macOS, continuer avec des solutions locales qui ne peuvent pas exécuter ces outils entraîne des limites concrètes : le projet peut rester au mauvais endroit, les commandes macOS ne sont pas disponibles et la validation graphique manque. Acheter un Mac n’est pas forcément justifié pour un exercice temporaire, mais un accès à distance ne convient pas non plus à chaque cours : il faut vérifier les droits, la connexion graphique exigée et les besoins matériels du projet.
Si un Mac distant est nécessaire pour une période de cours ou pour tester un projet, NOVAKVM permet d’examiner les options de Mac à distance avant de décider. La page des options Mac mini peut aussi aider à vérifier si une solution correspond au besoin ; les caractéristiques et modes d’accès doivent être confirmés sur les pages du service, et l’administrateur du cours doit valider que cet environnement est accepté.