Installer Claude Code sur macOS : le guide pas à pas

Tu veux utiliser Claude Code sur ton Mac mais tu ne sais pas par où commencer ? Ce guide te montre exactement comment installer et configurer Claude Code sur macOS, étape par étape. Que tu aies un MacBook Air M1, un Mac Studio ou un iMac Intel, tu trouveras ici toutes les instructions pour être opérationnel en moins de 10 minutes. Nous couvrons les prérequis système, les différentes méthodes d'installation, la configuration initiale et les solutions aux problèmes les plus fréquents.

Quels sont les prérequis pour installer Claude Code sur macOS ?

Pour installer Claude Code sur macOS, tu as besoin de macOS 10.15 (Catalina) minimum, 4 Go de RAM, 500 Mo d'espace disque et un compte Anthropic actif. Ces exigences sont volontairement légères pour permettre au plus grand nombre d'accéder à l'outil.

Voici le détail des prérequis techniques :

  • Système d'exploitation : macOS 10.15 (Catalina) ou plus récent. Les versions Monterey, Ventura et Sonoma sont pleinement compatibles.
  • Processeur : Compatible avec les puces Intel et Apple Silicon (M1, M2, M3). Aucune différence de fonctionnalité entre les deux architectures.
  • Mémoire vive : 4 Go minimum, 8 Go recommandés pour une expérience fluide avec plusieurs projets ouverts.
  • Espace disque : 500 Mo pour l'application, plus 1 à 2 Go pour les dépendances et les projets.
  • Connexion internet : Nécessaire pour l'installation initiale et l'utilisation (Claude Code fonctionne en ligne).

Côté compte utilisateur, tu dois disposer d'un compte Anthropic. La création est gratuite sur le site officiel d'Anthropic. Tu peux commencer avec le plan gratuit qui offre un quota mensuel suffisant pour débuter. Les plans payants (Pro à 20 $/mois, Team à 30 $/mois par utilisateur) débloquent des quotas plus élevés selon la documentation officielle d'Anthropic.

Vérifie ta version de macOS en cliquant sur le logo Apple en haut à gauche, puis "À propos de ce Mac". Si tu es sur une version antérieure à Catalina, tu devras mettre à jour ton système avant de continuer.

Comment télécharger et installer Claude Code sur Mac ?

L'installation de Claude Code sur macOS se fait en téléchargeant le fichier .dmg depuis le site officiel d'Anthropic, puis en glissant l'application dans le dossier Applications. Le processus complet prend environ 5 minutes.

Suis ces étapes précises :

  1. Accède au site officiel : Rends-toi sur claude.ai et connecte-toi avec ton compte Anthropic.

  2. Télécharge Claude Code : Dans le menu principal, clique sur "Downloads" puis sélectionne "Claude Code for macOS". Le téléchargement du fichier .dmg (environ 150 Mo) démarre automatiquement.

  3. Ouvre le fichier .dmg : Une fois le téléchargement terminé, double-clique sur le fichier "ClaudeCode-macOS.dmg" dans ton dossier Téléchargements.

  4. Installe l'application : Une fenêtre s'ouvre avec l'icône de Claude Code et un raccourci vers le dossier Applications. Glisse l'icône Claude Code sur le dossier Applications.

  5. Lance Claude Code : Ouvre ton dossier Applications (Cmd + Shift + A dans le Finder) et double-clique sur Claude Code.

  6. Autorise l'application : Au premier lancement, macOS affiche un message de sécurité. Clique sur "Ouvrir" pour confirmer. Si le bouton "Ouvrir" n'apparaît pas, va dans Préférences Système > Confidentialité et sécurité, puis clique sur "Ouvrir quand même" à côté du message concernant Claude Code.

  7. Connecte-toi : L'application te demande de t'authentifier avec ton compte Anthropic. Entre ton email et ton mot de passe.

L'installation est maintenant terminée. Claude Code apparaît dans ton dock et tu peux l'épingler pour un accès rapide en faisant un clic droit sur l'icône puis "Options" > "Garder dans le Dock".

Pour les utilisateurs avancés qui préfèrent la ligne de commande, une installation via Homebrew est également disponible avec la commande brew install --cask claude-code, mais la méthode .dmg reste la plus simple pour débuter.

Comment configurer Claude Code après l'installation ?

La configuration initiale de Claude Code consiste à choisir ton modèle préféré (Claude 3.5 Sonnet recommandé), définir ton dossier de projets et ajuster les paramètres de génération de code. Cette étape prend 2 à 3 minutes et améliore significativement ton expérience.

Voici les réglages essentiels à effectuer :

Choix du modèle

Clique sur l'icône d'engrenage en haut à droite, puis "Modèle". Tu as accès à plusieurs versions de Claude :

  • Claude 3.5 Sonnet : Le meilleur compromis pour le code. Rapide, précis, excellent pour les débutants. C'est le choix par défaut et celui que nous recommandons.
  • Claude 3 Opus : Plus puissant mais plus lent et consomme plus de crédits. Réserve-le aux projets complexes.
  • Claude 3 Haiku : Très rapide, idéal pour les questions simples et les modifications légères.

Pour débuter, reste sur Claude 3.5 Sonnet. Tu pourras changer à tout moment selon tes besoins.

Dossier de projets

Dans les paramètres, section "Projets", définis où Claude Code va créer et sauvegarder tes projets. Par défaut, il utilise ~/Documents/ClaudeCode. Tu peux le changer vers n'importe quel dossier de ton Mac.

Conseil pratique : crée un dossier dédié comme ~/Projets-Claude pour garder une organisation claire, surtout si tu utilises déjà d'autres outils de développement.

Paramètres de génération

Dans "Préférences" > "Génération de code", tu peux ajuster :

  • Niveau de détail des commentaires : "Moyen" est parfait pour apprendre. "Élevé" ajoute plus d'explications dans le code généré.
  • Style de code : Choisis entre "Moderne" (recommandé) ou "Classique" selon tes préférences.
  • Vérification automatique : Active cette option pour que Claude vérifie le code avant de te le présenter.

Raccourcis clavier

Dans "Préférences" > "Raccourcis", personnalise les touches rapides. Les plus utiles :

  • Cmd + N : Nouveau projet
  • Cmd + Shift + P : Ouvrir la palette de commandes
  • Cmd + K : Lancer une génération de code

Une fois ces réglages effectués, sauvegarde avec le bouton "Appliquer" en bas de la fenêtre de préférences.

Quelles sont les erreurs d'installation courantes et comment les résoudre ?

Les trois erreurs les plus fréquentes lors de l'installation de Claude Code sur macOS sont le blocage par Gatekeeper, les problèmes de permissions et les conflits avec d'autres outils de développement. Voici comment les identifier et les corriger.

Erreur "L'application ne peut pas être ouverte"

Ce message apparaît quand Gatekeeper bloque Claude Code. Solution :

  1. Va dans Préférences Système > Confidentialité et sécurité
  2. Descends jusqu'à voir le message concernant Claude Code
  3. Clique sur "Ouvrir quand même"
  4. Confirme avec ton mot de passe administrateur
  5. Relance Claude Code

Si le problème persiste, ouvre le Terminal et tape :

xattr -cr /Applications/ClaudeCode.app

Cette commande supprime les attributs de quarantaine qui bloquent parfois les applications téléchargées.

Erreur de connexion au serveur

Si Claude Code ne parvient pas à se connecter après l'authentification :

  • Vérifie ta connexion internet (ouvre un navigateur et teste)
  • Désactive temporairement ton VPN si tu en utilises un
  • Vérifie que ton pare-feu ne bloque pas Claude Code (Préférences Système > Sécurité > Pare-feu > Options du pare-feu)
  • Redémarre l'application

Si l'erreur persiste, le problème vient peut-être des serveurs d'Anthropic. Consulte status.anthropic.com pour vérifier l'état des services.

Problème de permissions sur le dossier de projets

Si Claude Code affiche "Impossible d'écrire dans le dossier de projets" :

  1. Ouvre le Finder et navigue vers le dossier concerné
  2. Fais un clic droit > "Lire les informations"
  3. Déverrouille les permissions en cliquant sur le cadenas en bas
  4. Change "Lecture seule" en "Lecture et écriture" pour ton utilisateur
  5. Clique sur l'engrenage > "Appliquer aux éléments inclus"

Conflit avec d'autres éditeurs de code

Si tu as déjà installé VS Code, Cursor ou d'autres IDE, ils peuvent parfois entrer en conflit avec Claude Code. La solution : désigne Claude Code comme éditeur par défaut pour les fichiers de code dans Préférences Système > Extensions > Éditeur de texte par défaut.

Pour les utilisateurs de Cursor qui hésitent entre les deux outils, notre article Cursor vs Claude Code compare en détail les forces et faiblesses de chaque solution.

Comment vérifier que l'installation fonctionne correctement ?

Pour tester ton installation de Claude Code, crée un premier projet simple qui affiche "Hello World" dans une page web. Ce test prend 2 minutes et confirme que tous les composants fonctionnent.

Voici le test complet à effectuer :

  1. Lance Claude Code depuis ton dossier Applications

  2. Crée un nouveau projet : Clique sur "Nouveau projet" ou tape Cmd + N

  3. Donne un nom : Appelle-le "test-installation"

  4. Demande à Claude : Dans la barre de chat, écris exactement : "Crée une page HTML simple qui affiche 'Hello World' en grand au centre de l'écran avec un fond bleu clair"

  5. Vérifie la génération : Claude Code doit générer un fichier index.html en quelques secondes. Tu vois le code apparaître dans l'éditeur à droite.

  6. Prévisualise le résultat : Clique sur le bouton "Aperçu" en haut à droite. Une fenêtre s'ouvre avec ta page web.

  7. Teste les modifications : Demande à Claude "Change la couleur de fond en vert menthe". Le code doit se mettre à jour automatiquement.

Si toutes ces étapes fonctionnent, ton installation est parfaite. Tu es prêt à créer tes premiers vrais projets avec Claude Code.

Pour aller plus loin dans l'utilisation de l'outil, consulte notre tutoriel complet Claude Code pour débutants qui couvre les fonctionnalités avancées et les meilleures pratiques.

Comment mettre à jour Claude Code sur macOS ?

Claude Code se met à jour automatiquement au démarrage, mais tu peux forcer une mise à jour manuelle depuis le menu Aide > Rechercher les mises à jour. Les mises à jour apportent régulièrement de nouvelles fonctionnalités et corrections de bugs.

Le processus de mise à jour automatique :

  • À chaque lancement, Claude Code vérifie si une nouvelle version existe
  • Si c'est le cas, une notification apparaît en haut à droite
  • Clique sur "Mettre à jour" pour télécharger la nouvelle version
  • L'application redémarre automatiquement après l'installation
  • Tes projets et paramètres sont conservés

Pour une mise à jour manuelle :

  1. Ouvre Claude Code
  2. Va dans le menu "Aide" en haut de l'écran
  3. Clique sur "Rechercher les mises à jour"
  4. Si une version plus récente existe, clique sur "Télécharger et installer"
  5. Attends la fin du téléchargement (généralement 1 à 2 minutes)
  6. Laisse l'application redémarrer

Les mises à jour majeures (changement de version, comme 1.0 vers 2.0) peuvent nécessiter un redémarrage complet de ton Mac. Claude Code t'en informe avant de procéder.

Fréquence des mises à jour : Anthropic publie des mises à jour mineures toutes les 2 à 3 semaines et des versions majeures tous les 2 à 3 mois. Tu peux consulter les notes de version complètes sur le site officiel d'Anthropic pour voir les nouveautés de chaque mise à jour.

Conseil : active les mises à jour automatiques dans Préférences > Général > "Installer automatiquement les mises à jour" pour toujours bénéficier des dernières améliorations sans y penser.

Conclusion

Installer Claude Code sur macOS est un processus simple qui prend moins de 10 minutes. Une fois l'application configurée, tu disposes d'un assistant IA puissant pour créer des sites web, des applications et des scripts sans connaissances préalables en programmation. La mise à jour automatique garantit que tu bénéficies toujours des dernières améliorations.

Si tu rencontres un problème non couvert dans ce guide, la documentation officielle d'Anthropic et la communauté Claude Code sur Discord sont des ressources précieuses pour obtenir de l'aide rapidement.