Claude Code sur macOS
Transforme ton Mac en machine de développement ultime. Apprends à maîtriser Homebrew, Gatekeeper et les puces Apple Silicon.
Si tu assistes à une conférence informatique, tu remarqueras un détail frappant : la majorité des développeurs travaillent sur un Mac. Pourquoi un tel engouement ?
1. Pourquoi macOS est le roi du développement ?
Contrairement à Windows, macOS est construit sur des fondations UNIX. C'est un cousin très proche de Linux, le système d'exploitation qui fait tourner 90 % des serveurs web dans le monde.
Résultat : quand tu développes un site sur ton Mac, l'environnement est quasiment identique à celui du serveur qui hébergera ton site. De plus, presque tous les outils modernes (comme Claude Code) sont créés et testés d'abord sur macOS.
2. Les concepts clés du Mac
Si tu débutes sur Mac, voici les cinq concepts que tu dois connaître avant d'installer Claude Code.
Le Terminal (zsh)
C'est l'écran noir. Sur Windows, on utilise souvent PowerShell. Sur macOS, le terminal par défaut s'appelle Zsh (Z shell). Il est très puissant et comprend nativement les commandes Linux.
Homebrew
Imagine un App Store invisible. Homebrew est un programme qui permet d'installer d'autres programmes de développement simplement en tapant leur nom dans le terminal. C'est l'outil indispensable de tout développeur Mac.
Apple Silicon vs Intel
Depuis 2020, Apple a remplacé les processeurs Intel par ses propres puces (M1, M2, M3...). Ces puces (appelées Apple Silicon ou ARM) sont incroyablement rapides, mais elles parlent une langue différente des puces Intel. Heureusement, Claude Code et Node.js sont totalement compatibles avec les deux.
Gatekeeper et les permissions
macOS est très sécurisé. Gatekeeper est le vigile qui bloque les applications téléchargées sur internet. Si le terminal te demande ton mot de passe (ou ton empreinte Touch ID) lors d'une installation, c'est normal : macOS veut s'assurer que tu autorises l'action.
Les chemins de fichiers
Sur Windows, tes fichiers sont dans C:\Utilisateurs\Nom\Documents. Sur Mac, c'est /Users/Nom/Documents. Note que les barres penchent dans l'autre sens (slash au lieu d'antislash) et qu'il n'y a pas de lettre de lecteur (C:).
3. Installation pas-à-pas
Maintenant que tu connais les bases, installons les outils nécessaires.
Ouvre l'application Terminal sur ton Mac (tu peux la trouver via la recherche Spotlight : Cmd + Espace, puis tape "Terminal").
Commence par installer Homebrew, puis Node.js (le moteur qui fait tourner Claude Code) :
Une fois Node.js installé, tu peux installer Claude Code :
4. Scénarios réels
Scénario 1 : Initialiser un projet dans tes Documents
Tu veux créer un nouveau site web. Dans ton terminal, tu te déplaces dans tes documents :cd ~/Documents (le petit tilde ~ est un raccourci magique pour dire "Mon dossier personnel").
Puis tu lances claude et tu dis : "Crée un dossier 'mon-site' et place un fichier index.html avec un Hello World".
Scénario 2 : Autoriser une commande système
Si Claude Code te propose d'installer un module en utilisant sudo npm install..., Gatekeeper interviendra. Le mot "sudo" signifie "Super User DO" (fais-le en tant qu'administrateur). Le terminal te demandera ton mot de passe Mac (les lettres ne s'afficheront pas quand tu taperas, c'est normal de sécurité UNIX). Valide avec Entrée.
5. Les erreurs les plus fréquentes
Erreur EACCES (Permission Denied) : C'est l'erreur la plus courante. Elle signifie que Claude Code ou npm essaie de modifier un fichier qui appartient au système. Solution : demande à Claude de relancer la commande avec sudo devant.
Variables d'environnement introuvables : Si Claude te dit qu'il ne trouve pas ta clé API (ANTHROPIC_API_KEY), c'est parce que tu as fermé ton terminal. Sur Mac, pour la sauvegarder définitivement, tu dois la mettre dans un fichier caché nommé .zshrc. Demande simplement à Claude : "Aide-moi à sauvegarder ma clé API dans mon fichier .zshrc".
6. Checklist de démarrage sur Mac
- J'ai installé Homebrew.
- J'ai installé Node.js via Homebrew.
- J'ai installé Claude Code via npm.
- J'ai configuré ma clé API dans mon fichier
.zshrc. - Je sais comment me déplacer dans le terminal (
cd ~/Documents/mon-projet).
7. FAQ
Ton Mac est maintenant une station de travail redoutable. Mais que se passe-t-il si tu utilises l'autre grand système d'exploitation adoré des développeurs ? Découvre-le dans le prochain chapitre : Claude Code sur Linux.