Chapitre 2 · Installer et se connecter
Installer Claude Code sur Mac
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementInstaller 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
- Appuie sur
Cmd+Espacepour ouvrir la recherche Spotlight. - Tape
Terminal, puis Entrée. - 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
- Quand c'est fini, ferme la fenêtre du Terminal.
- Ouvre une nouvelle fenêtre.
- 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).
- Ferme le Terminal et ouvre-en un nouveau, puis réessaie
claude --version. - 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
- Réessaie
claude --versiondans 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 --versiondans 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
- Installe Claude Code avec la commande de l'étape 2.
- Ouvre une nouvelle fenêtre et tape
claude --version. - Note le numéro dans
avancement.md, puis passe à la leçon 6.