Installer
Claude Code
Claude Code est le moteur d'exécution de toute l'architecture : l'agent qui lit, écrit et opère directement sur ta machine. Ce module pose la fondation. On l'installe ensemble, proprement, avec le raisonnement derrière chaque étape, pas juste les commandes.
Ce qu'il te faut
- Une machine macOS, Windows ou Linux.
- Un compte Claude (Pro ou Max), ou une clé API Anthropic.
- Un accès terminal et 15 minutes de concentration.
Ouvre ton terminal
Le terminal est l'interface en ligne de commande de ta machine. C'est là que vit Claude Code.
- macOS : application Terminal (via Spotlight).
- Windows : PowerShell (menu Démarrer).
On passe par la ligne de commande, pas par une interface graphique, pour une raison : un agent qui opère en CLI est scriptable, reproductible et automatisable. C'est ce qui permettra plus tard de déclencher toute la chaîne avec une seule commande.
Installe Node.js (LTS)
Claude Code est distribué comme paquet Node. Récupère la version LTS sur nodejs.org et installe-la.
Vérifie la version installée :
node --version v20.11.0 # v18 minimum requis
On prend la LTS (Long Term Support), pas la « Current ». La LTS est stabilisée et maintenue : sur un outil de production, tu veux de la stabilité, pas les dernières features instables. Node fournit le runtime npm qui sert à installer Claude Code à l'étape suivante.
Installe Claude Code
Installation globale, une commande :
npm install -g @anthropic-ai/claude-code
Vérifie :
claude --version
2.x.x (Claude Code)
Le flag -g installe le paquet en global : la commande claude devient disponible depuis n'importe quel dossier, pas seulement le projet courant. C'est exactement ce qu'on veut pour un outil qu'on lancera sur des dizaines de projets différents.
Lance et authentifie
Place-toi dans un dossier de travail et démarre l'agent :
mkdir factory-test cd factory-test claude
Au premier lancement, Claude Code ouvre le navigateur pour l'authentification. Connecte-toi avec ton compte Claude, valide, reviens au terminal.
Deux modes d'accès : compte Claude (OAuth, ton abonnement Pro/Max) ou clé API (facturation à l'usage). Pour démarrer et apprendre, le compte est le plus simple et le plus prévisible côté coût. La clé API devient pertinente quand tu industrialises et que tu veux piloter la consommation finement.
Premier run
Dans l'agent, donne une instruction en français :
> Liste les fichiers de ce dossier et explique sa structure.
Retiens la nuance fondatrice du parcours : Claude Code n'est pas un chat. C'est un agent → il a accès au système de fichiers, lit ton dossier, exécute des commandes et modifie des fichiers. C'est cette capacité à agir, pas juste répondre, qui rend toute l'architecture possible.
Si ça coince
- « commande introuvable » : ferme et rouvre le terminal (rechargement du PATH), réessaie.
- Node trop ancien : réinstalle la LTS depuis nodejs.org.
- Erreur de permission (macOS/Linux) : préfixe la commande d'installation par sudo.
- Bloqué : capture l'erreur et poste-la dans le canal de la cohorte, on traite.
Module 1 validé
Claude Code tourne sur ta machine : la fondation est posée. Au Module 2, on installe les agents spécialisés et on configure l'environnement de production.
Continuer le parcours