Claude Code sur Mac : installation, Terminal et bonnes pratiques

Claude Code sur Mac est plus simple à prendre en main quand vous commencez dans un dossier de test, avec le Terminal que vous utilisez déjà et des permissions réduites. L’objectif n’est pas de transformer l’assistant en administrateur de votre Mac. Il est de lui donner le contexte minimal pour comprendre un projet, proposer une petite modification et vous laisser vérifier le résultat.

Les modalités d’installation, les versions de macOS compatibles et les prérequis peuvent changer. Suivez donc les instructions d’Anthropic correspondant à la version de Claude Code utilisée. Ce guide vous aide à préparer le poste et à vérifier une installation ; il ne remplace pas la documentation officielle par une commande figée.

Ce que vous allez apprendre

Vous allez identifier vos outils locaux, ouvrir un projet sûr, faire une première tâche de lecture, contrôler un petit diff et résoudre les problèmes classiques de chemins ou de permissions. Vous saurez aussi distinguer une permission macOS normale d’une demande trop large pour une tâche de code.

Prérequis

Prévoyez un Mac à jour, un compte utilisateur standard, le Terminal et un dossier de projet non sensible. Vérifiez le gestionnaire de versions et les dépendances réellement attendues par votre dépôt. Si vous utilisez Homebrew ou un autre outil de paquets, ne le considérez pas comme obligatoire : utilisez la procédure officiellement documentée pour votre environnement.

Dans Terminal, les contrôles suivants donnent un point de départ :

sw_vers
git --version
node --version

Vérification : gardez les résultats pour comparer aux exigences officielles. Une version présente ne garantit pas à elle seule la compatibilité de Claude Code ni celle de votre projet.

1. Préparer un dossier de travail isolé

Choisissez un dossier de démonstration ou un petit dépôt dont vous connaissez le contenu. Ne commencez pas dans Documents, Bureau ou un répertoire qui agrège des fichiers personnels, sauvegardes et clés. L’isolation réduit les risques de lecture accidentelle et facilite la revue des fichiers que l’outil peut manipuler.

Dans le dossier choisi, inspectez le dépôt avant toute action :

git status --short

Cette commande montre les changements locaux. Si une modification ne vous appartient pas, ne demandez pas à l’assistant de la supprimer ou de la reformater. Identifiez plutôt son origine ou changez de dossier pour votre essai.

Vérification : vous pouvez nommer les fichiers autorisés à la tâche, les fichiers interdits et la personne qui validera une éventuelle écriture.

2. Installer Claude Code depuis la documentation

Lisez la page d’installation d’Anthropic avant d’exécuter une commande. Vérifiez ce qu’elle installe, où l’outil sera disponible et quelles variables d’environnement sont éventuellement requises. Une installation peut ajuster un chemin d’exécution ou télécharger un composant ; vous devez pouvoir expliquer ces effets avant de continuer.

Ne téléchargez pas d’archive depuis un lien inconnu et n’exécutez pas de script avec des privilèges élevés pour résoudre une erreur rapide. Pour les outils de développement, une demande de mot de passe administrateur mérite une explication précise. Si l’installation a besoin d’un composant comme Node.js, installez-le depuis la source recommandée et vérifiez sa version après l’opération.

Vérification : utilisez la commande d’aide ou de version indiquée par la documentation officielle. Elle doit fonctionner depuis un nouveau terminal sans afficher de secret ni modifier le projet.

3. Commencer en lecture seule

Pour la première session, demandez une tâche qui ne change pas les fichiers : expliquer l’arborescence, trouver les commandes de test, résumer les règles du dépôt ou signaler les dépendances d’une page. Cela vous permet d’évaluer si le contexte est compris avant d’autoriser une modification.

Ne donnez pas de clé API, de fichier .env réel, d’export de base ou de configuration d’hébergement. Si l’assistant a besoin de comprendre une variable, fournissez son nom et une valeur fictive. Un secret affiché dans un terminal ou une conversation doit être traité comme divulgué : il faut le faire tourner selon la procédure du fournisseur.

Vérification : le résultat de lecture cite les fichiers réellement consultés et n’invente pas de configuration ou de dépendance absente.

4. Autoriser un petit changement et le tester

Choisissez un changement réversible : compléter une documentation, améliorer un test ou corriger une chaîne de texte. Définissez le fichier réservé et la commande de vérification. Après l’écriture, lisez le diff :

git diff --check
git diff

Vérifiez les imports, les chemins et les fins de ligne. Sur macOS, les projets peuvent venir d’environnements Linux ou Windows ; ne convertissez pas les fichiers en masse pour faire disparaître un avertissement. Suivez la configuration Git et les conventions du dépôt.

Ensuite, exécutez seulement les tests autorisés. Une commande de build ou de test peut écrire des caches ; dans un dépôt partagé, elle doit avoir un propriétaire unique. Un résultat vert est une preuve limitée : vérifiez aussi le comportement correspondant à la tâche.

Vérification : le diff ne touche que les fichiers prévus et la commande exécutée est notée avec son résultat. Si un contrôle n’a pas été exécuté, indiquez-le au lieu de l’inférer.

5. Comprendre les permissions macOS

macOS peut demander une autorisation pour accéder à certains dossiers, à l’automatisation ou à des fonctions système. Examinez la demande : quel programme la réclame, quel dossier ou service est concerné, et est-ce nécessaire au scénario de test ? Une tâche de lecture de code dans un dépôt ne justifie pas un accès général aux fichiers personnels.

Utilisez un compte standard quand c’est possible. Ne désactivez pas les protections du système ni ne donnez un accès complet au disque pour contourner un problème d’outillage. Réduisez le périmètre, placez le projet dans un dossier approprié ou demandez une procédure validée par votre équipe.

Problèmes fréquents et solutions

La commande n’est pas trouvée dans Terminal

Vérifiez la procédure d’installation, le PATH et le terminal lancé. Ouvrez un nouveau terminal seulement si l’outil documente qu’un changement d’environnement doit être rechargé. Ne modifiez pas plusieurs fichiers de profil sans comprendre lequel est réellement utilisé.

Un script échoue avec une permission refusée

Contrôlez le dossier courant, les droits du fichier et la documentation du projet. Ne passez pas immédiatement à sudo : cherchez une solution qui laisse l’utilisateur standard propriétaire de son espace de travail.

Le dépôt affiche un énorme diff après un essai

Arrêtez l’essai, examinez les types de fichiers modifiés et vérifiez les conventions de fin de ligne ou de formatage. Ne nettoyez pas les changements d’un autre contributeur ; signalez la collision au propriétaire du dépôt.

FAQ

Claude Code requiert-il un accès administrateur sur Mac ?

Suivez les prérequis officiels de la version utilisée. Une tâche courante de lecture ou d’édition d’un projet ne justifie pas automatiquement des privilèges administrateur.

Dois-je utiliser Homebrew ?

Non. Utilisez uniquement l’outil d’installation prévu pour votre environnement et vérifiez la provenance de chaque paquet.

Puis-je travailler dans iCloud Drive ?

Pour un premier pilote, préférez un dossier de développement isolé. La synchronisation peut ajouter des fichiers ou des conflits qui compliquent la revue.

Comment protéger les variables d’environnement ?

Conservez les valeurs réelles hors Git et hors conversation. Versionnez seulement un exemple avec des valeurs fictives si le projet le permet.

Que vérifier avant une vraie feature ?

Le périmètre, les propriétaires de fichiers, les règles du dépôt, les tests nécessaires, les permissions et la procédure de retour arrière.

Conclusion

Claude Code sur Mac apporte une aide utile quand votre environnement reste limité et compréhensible. Commencez avec le Terminal, un dépôt non sensible et une tâche de lecture, puis avancez par petits diffs contrôlés. Les permissions, secrets et déploiements restent des décisions humaines.

Sources et limites

• Anthropic — Claude Code setup : installation et prérequis à relire selon version.
• Apple — Use Terminal on Mac : documentation du Terminal macOS.
• Apple — Control access to files and folders : permissions de fichiers macOS.

La compatibilité et les écrans de permission varient selon macOS, le matériel et les versions installées. Ce guide ne recommande pas de contourner les protections système.