Aller au contenu
Floskool

Chapitre 2 · Installer et se connecter

Installer Claude Code sur Mac

Leçon gratuite 7 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Installer Claude Code sur Mac, pas à pas

Tu es sur Mac et tu as choisi la porte terminal. Bonne nouvelle : sur Mac, il n'y a qu'un seul terminal à connaître et une seule commande à coller. Tu es sur Windows ? Reviens à la leçon 4.

Les commandes ci-dessous sont celles de la documentation officielle au moment où cette formation est écrite. Si une commande ne marche plus, vérifie la page officielle : https://code.claude.com/docs/en/setup (rubrique d'installation). C'est toujours elle qui fait foi.

Pourquoi c'est plus simple que tu ne le penses

Thomas est graphiste indépendant. Il n'avait jamais ouvert l'application Terminal de son Mac. En pratique, il a ouvert une fenêtre, collé une ligne, attendu, puis tapé une deuxième ligne pour vérifier. C'est tout. Le terminal n'est qu'une fenêtre où l'on écrit au lieu de cliquer.

Étape 1 : ouvre le Terminal

  1. Appuie sur Cmd+Espace pour ouvrir la recherche Spotlight.
  2. Tape Terminal, puis Entrée.
  3. Une fenêtre s'ouvre avec une ligne qui se termine souvent par % ou $ : c'est là que tu tapes.

Étape 2 : colle la commande d'installation

Colle cette commande et appuie sur Entrée :

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

Patiente. D'après la documentation, l'installation n'affiche aucune progression pendant le téléchargement.

Étape 3 : vérifie l'installation

  1. Quand c'est fini, ferme la fenêtre du Terminal.
  2. Ouvre une nouvelle fenêtre.
  3. Tape :
claude --version

Un numéro de version suivi de (Claude Code) s'affiche : c'est installé. Note-le dans avancement.md.

La documentation propose aussi claude doctor pour un diagnostic complet de ton installation, sans ouvrir de session.

Cette installation, dite « native », se met à jour toute seule en arrière-plan d'après la documentation. Tu n'as rien à faire.

L'autre méthode : Homebrew

Si tu utilises déjà Homebrew (un gestionnaire de logiciels pour Mac), la documentation donne cette commande :

brew install --cask claude-code

Attention : d'après la documentation, une installation Homebrew ne se met pas à jour toute seule. Il faut lancer brew upgrade claude-code de temps en temps. Si tu ne connais pas Homebrew, reste sur la commande de l'étape 2.

Si le Mac dit que claude est introuvable

Message typique : command not found: claude. D'après la page de dépannage officielle (https://code.claude.com/docs/en/troubleshoot-install), le programme est installé dans ~/.local/bin, et ce dossier n'est pas encore dans ton PATH (la liste des dossiers où le terminal cherche les programmes).

  1. Ferme le Terminal et ouvre-en un nouveau, puis réessaie claude --version.
  2. Toujours rien ? La documentation donne ces deux commandes pour le terminal par défaut du Mac (zsh) :
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
  1. Réessaie claude --version dans une nouvelle fenêtre.

Le signe ~ désigne ton dossier personnel (/Users/[ton nom]).

Un prompt de secours si tu bloques

À coller dans le chat claude.ai, avec ton message d'erreur (sans mot de passe) :

Contexte : j'installe Claude Code sur Mac (macOS [version]) avec la commande officielle dans le Terminal. Je ne sais pas coder.
Objectif : comprendre ce message et le corriger : [colle le message complet].
Contraintes : mots simples, une étape à la fois. Ne me donne que des commandes que tu sais exactes ; sinon, renvoie-moi vers https://code.claude.com/docs/en/troubleshoot-install.
Format attendu : la cause en 2 lignes, puis les étapes numérotées.
Validation : dis-moi comment vérifier que c'est réglé (claude --version dans une nouvelle fenêtre).

Les erreurs à éviter

  • Taper claude --version dans la même fenêtre juste après l'installation. Ouvre une nouvelle fenêtre.
  • Ajouter sudo (une commande qui donne les droits administrateur) devant la commande d'installation. La documentation ne le demande pas.
  • Copier une commande d'un autre système (celle de Windows ne marche pas sur Mac).

À toi de jouer

  1. Installe Claude Code avec la commande de l'étape 2.
  2. Ouvre une nouvelle fenêtre et tape claude --version.
  3. Note le numéro dans avancement.md, puis passe à la leçon 6.