Installer Claude Code sur Mac distant : débutant 2026

Avant l’installation : placer l’outil dans la bonne salle de classe

Un ordinateur Windows utilisé pour afficher une fenêtre distante ressemble à un écran de salle de classe. Le bureau distant est la salle elle-même, SSH est la porte d’entrée textuelle et Claude Code joue le rôle de l’assistant placé devant le projet. Installer l’assistant sur l’écran Windows ne lui donne pas accès aux fichiers restés dans la salle macOS.

Le critère est donc le suivant : le terminal dans lequel la commande pwd affiche le dossier du projet doit être le terminal du Mac distant. Si le projet est enregistré sur ce Mac et que les commandes de développement y sont exécutées, Claude Code doit y être installé.

Trois éléments sont souvent confondus :

• Le bureau distant affiche l’interface macOS et permet d’ouvrir Terminal comme sur une machine locale.
• SSH fournit une connexion textuelle au Mac, sans afficher tout le bureau. Apple décrit cette fonction et ses limites dans son guide officiel de connexion à un Mac par SSH.
• Claude Code s’exécute dans le Shell du compte distant et travaille dans le répertoire depuis lequel il est lancé.

Avant de copier une commande, le lecteur doit également vérifier que le Mac distant dispose d’un accès réseau sortant, qu’il utilise son propre compte et que ce compte est autorisé à employer Claude Code. Les conditions d’accès au service et les systèmes pris en charge doivent être lus sur la page officielle le jour de l’installation, car ces informations ne doivent pas être figées dans un ancien tutoriel.

Première étape : préparer un espace de travail personnel

Après la connexion, il faut éviter de commencer dans un dossier système, dans le bureau d’un autre utilisateur ou dans un répertoire partagé dont les règles ne sont pas claires. Un espace personnel joue le rôle d’une table de travail : les fichiers peuvent y être créés, déplacés et supprimés sans perturber macOS ni les exercices d’un autre utilisateur.

Dans le terminal du Mac distant, vérifiez d’abord l’identité et l’emplacement :

whoami
pwd

Le premier résultat doit correspondre au compte prévu pour l’apprentissage. Le second doit afficher un emplacement personnel, par exemple un dossier situé dans le répertoire de l’utilisateur, et non un chemin système. Les commandes ci-dessus ne prouvent pas encore que le dossier est utilisable ; elles indiquent seulement qui travaille et où.

Créez ensuite un dossier isolé pour le premier essai :

mkdir -p ~/projets/claude-premier-essai
cd ~/projets/claude-premier-essai
touch verification.txt
ls -la

Le résultat attendu est la présence de verification.txt dans le dossier courant. Si mkdir ou touch renvoie une erreur de permission, il faut s’arrêter, ne pas utiliser sudo au hasard et demander la correction du compte ou du répertoire. Une commande exécutée avec les droits administrateur peut masquer un mauvais emplacement et rendre les fichiers difficiles à retrouver ensuite.

Le bureau graphique et SSH peuvent tous deux ouvrir un terminal, mais ils doivent viser le même utilisateur distant. Un fichier créé dans la session graphique ne sera pas forcément visible si SSH ouvre un autre compte. Pour le vérifier, exécutez whoami dans les deux connexions et comparez le chemin obtenu avec pwd.

Deuxième étape : choisir la voie native officielle

La voie native est la route prioritaire pour un débutant, car elle évite de transformer le premier cours en exercice de gestion de dépendances. La page officielle de Claude Code fournit la commande actuelle ; elle doit être consultée directement avant exécution, notamment si le domaine, le système pris en charge ou le mode d’installation a changé.

Lorsque la page officielle affiche la commande native, elle se présente généralement sous cette forme :

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

Cette ligne ne doit être exécutée que si elle correspond encore exactement à la documentation officielle ouverte par le lecteur. Il ne faut pas remplacer l’adresse par celle trouvée dans un forum, un commentaire vidéo ou une archive de fichiers. Le principe de sécurité est plus important que la mémorisation de la commande : une installation réussie ne justifie pas l’exécution d’un script dont l’origine n’a pas été contrôlée.

Homebrew peut constituer une solution secondaire si le cours ou l’environnement existant l’utilise déjà. Il ne faut toutefois pas empiler la méthode native, une commande npm et une installation Homebrew dans la même session. Chaque canal peut avoir son propre emplacement et son propre mécanisme de mise à jour. La documentation officielle de démarrage reste la référence pour le choix du canal.

L’installation native ne signifie pas qu’il faut préparer Node.js séparément dans tous les cas. Si un ancien guide commence par l’installation obligatoire d’une version précise de Node.js, il peut décrire une ancienne route par paquet. Le débutant doit suivre les prérequis indiqués par la page officielle du jour, sans ajouter de composant « au cas où ».

Trois contrôles avant de considérer l’installation terminée

L’absence de message d’erreur ne suffit pas. Une commande peut avoir été installée dans un dossier absent du PATH, c’est-à-dire la liste des emplacements dans lesquels le Shell recherche les programmes. Ce PATH fonctionne comme le plan de la bibliothèque : si le nom du livre n’est pas dans les rayons connus, le programme semble inexistant même s’il est présent ailleurs.

Lancez les contrôles recommandés :

claude --version
claude doctor

La première commande doit retourner une version au lieu de répondre que la commande est introuvable. La seconde sert à examiner l’environnement selon les indications de la référence officielle de la ligne de commande. Les sorties exactes peuvent changer avec les versions ; il ne faut donc pas comparer mécaniquement un numéro trouvé dans une capture d’écran ancienne.

Si le Shell affiche command not found, procédez dans cet ordre :

1. fermez et rouvrez le terminal afin de recharger l’environnement ;
2. vérifiez que la commande est lancée avec le même compte que celui ayant effectué l’installation ;
3. relancez claude doctor si la commande est reconnue ;
4. contrôlez le chemin d’installation et le PATH indiqués par la documentation officielle ;
5. recommencez uniquement la méthode officielle si l’installation est incomplète.

Si le diagnostic signale un accès réseau, examinez la connexion sortante ou le proxy avant de modifier les permissions. La documentation officielle relative aux réseaux et aux proxys explique les paramètres à considérer dans un environnement filtré. Un réseau d’école peut bloquer certaines connexions sans que Claude Code ou macOS soit mal installé.

Authentifier le compte sans exposer de secret

Une fois la commande disponible, lancez Claude Code depuis le dossier d’exercice :

cd ~/projets/claude-premier-essai
claude

Le programme peut demander une authentification dans un navigateur. Sur un Mac distant, le navigateur par défaut ne s’ouvre pas toujours sur la machine hébergée. Dans ce cas, utilisez l’adresse officielle affichée par le terminal, copiez-la dans le navigateur local Windows et poursuivez la connexion avec le compte autorisé. Il faut ensuite revenir au terminal distant et vérifier que la session est bien reconnue.

Le navigateur local ne transforme pas Claude Code en programme Windows : il ne sert qu’à réaliser l’autorisation. Le travail reste exécuté dans le terminal du Mac distant. Si l’adresse ne commence pas par le domaine officiel attendu, interrompez la procédure et consultez la documentation au lieu de transmettre des identifiants.

La question des droits du compte dépend des conditions publiées au moment de la connexion. Il ne faut pas promettre un accès avec n’importe quel compte ni présenter une formule particulière comme universelle. La page officielle consacrée à l’identité, aux permissions et au contrôle des accès doit trancher le mode d’authentification disponible.

Une clé API, un jeton de session ou un fichier de configuration sensible ne doit jamais être ajouté à un devoir, envoyé dans une conversation de classe ou commité dans un dépôt public. Pour un exercice, il est préférable d’utiliser un compte personnel autorisé, de ne pas partager la session et de supprimer les secrets de test avant toute publication.

Troisième étape : faire lire un projet jetable, puis limiter les actions

Le premier objectif n’est pas de demander à l’outil de construire une application complète. Il consiste à vérifier progressivement ce qu’il voit et ce qu’il peut faire. Un petit projet Python, une page HTML avec une feuille de style ou un exercice audio, vidéo ou design avec quelques fichiers convient mieux qu’un dépôt contenant un devoir noté ou des données personnelles.

Depuis le dossier du projet, commencez par une demande de lecture :

Lisez uniquement les fichiers de ce dossier. Expliquez leur rôle et proposez un plan de correction, sans modifier de fichier ni exécuter de commande.

Le résultat attendu est une explication liée aux fichiers réellement présents. Si Claude Code décrit un projet absent, le lecteur se trouve probablement dans le mauvais répertoire. Arrêtez alors la session et revérifiez pwd et ls -la.

La lecture, la modification et l’exécution sont trois niveaux différents. Une demande de lecture n’autorise pas automatiquement l’écriture ; une modification de fichier ne signifie pas qu’un programme peut être lancé sans validation. Avant d’accepter une action, l’étudiant doit lire le chemin concerné, comprendre la commande proposée et refuser toute suppression, installation globale ou modification de configuration qu’il ne sait pas expliquer.

Après l’analyse, autorisez une tâche très limitée :

Modifiez uniquement verification.txt pour y ajouter une phrase indiquant que le dossier est prêt. Ne touchez à aucun autre fichier et n’exécutez aucune commande.

Contrôlez ensuite la différence :

git diff -- verification.txt
cat verification.txt

Si le dossier n’est pas un dépôt Git, la différence Git ne produira pas nécessairement de résultat utile. Dans ce cas, comparez le contenu avant et après, ou créez une copie du fichier avant l’essai. Le but est de constater précisément ce qui a changé, pas de croire un message indiquant que la tâche est « terminée ».

Pour une seconde vérification, demandez une commande sans danger, par exemple l’affichage de la liste des fichiers. Refusez toute action qui touche aux dossiers personnels, aux clés SSH, aux variables secrètes ou à la configuration de l’école. La documentation officielle sur l’utilisation de Claude Code permet de vérifier la syntaxe et les modes d’interaction disponibles.

Le tableau de décision pour la suite

Après ce premier essai, le choix dépend moins de la nouveauté de l’outil que de la manière dont le projet doit être conservé et utilisé.

Avant de fermer la session, exécutez pwd, listez les fichiers et sauvegardez le projet dans un emplacement personnel ou dans un dépôt autorisé. Un fichier laissé sur le bureau distant, dans un dossier temporaire ou dans une session partagée ne constitue pas une sauvegarde. Une solution de Mac distant adaptée à l’apprentissage peut convenir pour une période courte, mais les conditions de conservation et de connexion doivent être vérifiées avant de déposer un travail important.

Les mises à jour dépendent aussi du canal utilisé. Une installation native, Homebrew et une ancienne installation par paquet ne se mettent pas forcément à jour de la même façon. Le lecteur doit consulter la procédure publiée au moment de l’opération, puis relancer le contrôle de version et le diagnostic au lieu de supprimer des fichiers à la main.

Questions fréquentes des débutants

Claude Code fonctionne-t-il sans installer Node.js au préalable ?

Pas nécessairement. La documentation officielle présente l’installation native comme la voie principale, ce qui évite de préparer séparément Node.js dans le parcours standard. Une installation par gestionnaire de paquets peut avoir d’autres prérequis. Il faut donc suivre la page officielle au moment de l’installation plutôt que recopier un ancien tutoriel indiquant automatiquement une version précise de Node.js.

Comment terminer l’autorisation dans le navigateur depuis un Mac distant ?

Lancez Claude Code dans le terminal du Mac distant, puis suivez l’adresse d’authentification affichée. Si le navigateur ne s’ouvre pas sur cette machine, copiez uniquement l’adresse officielle dans le navigateur local, connectez le compte autorisé, puis revenez au terminal. Ne transmettez jamais une clé, un jeton ou une adresse de session dans un devoir ou un dépôt public.

Que faire si Claude Code affiche une commande introuvable après l’installation ?

Commencez par fermer puis rouvrir le terminal afin de recharger le Shell. Vérifiez ensuite la version et exécutez le diagnostic officiel. Si le problème persiste, contrôlez le dossier d’installation et la variable PATH du même compte distant. Une installation dans un compte graphique et une utilisation dans un autre compte SSH expliquent souvent cette différence.

Claude Code peut-il modifier directement un projet situé sur le Mac distant ?

Oui, à condition de lancer Claude Code depuis le dossier du projet sur le Mac distant et d’accorder les permissions demandées. L’outil ne modifie pas automatiquement tous les fichiers de la machine : la lecture, l’écriture et l’exécution de commandes sont des actions distinctes. Pour une première session, faites approuver chaque modification et travaillez sur une copie jetable.

Choisir entre l’ordinateur actuel et un Mac distant

Un ordinateur Windows reste parfaitement adapté pour apprendre les bases de Python, du développement web ou de la logique de programmation. En revanche, lorsqu’un cours exige macOS, le travail local peut être bloqué par l’absence de l’environnement demandé, les restrictions d’installation de l’ordinateur scolaire et l’impossibilité pour Claude Code de voir les fichiers présents sur un Mac distant. Une machine virtuelle ajoute parfois une configuration complexe et ne reproduit pas toujours correctement le matériel ou les outils macOS.

Pour un besoin limité à un cours, à un projet de découverte ou à un essai de Claude Code, louer un Mac distant avec NodeMini peut être plus cohérent que d’acheter immédiatement une machine. Le lecteur peut examiner les modalités de connexion et de livraison d’un Mac distant, puis choisir une durée correspondant réellement à son calendrier d’apprentissage. Pour un usage intensif et permanent, avec besoin de périphériques physiques, de travail hors ligne ou de conservation longue durée, l’achat d’un Mac personnel reste à comparer honnêtement.