YOAT Lab
03 · Module 1 — Environnement

Configurer son terminal

Première leçon technique. À la fin, vous aurez un terminal moderne,
Node.js installé, et Claude Code prêt à recevoir vos commandes.

8 minutesmacOS / Windows / LinuxNode.js LTS + Claude Code
§01 · Pourquoi un terminal moderne

L'environnement où Claude Code va passer ses heures

Claude Code est une application en ligne de commande. Elle a besoin d'un terminal pour s'exécuter, et de Node.js pour fonctionner. Le choix du terminal n'est pas qu'un détail technique : c'est l'outil que vous utiliserez le plus souvent dans cette formation.

Investissement qui s'amortit vite

Quelques minutes pour configurer correctement le terminal — thème lisible, police monospace de qualité (JetBrains Mono, Fira Code, Cascadia Code) — s'amortissent en quelques heures d'usage.

§02 · Choix selon l'OS

Le bon terminal par système

macOS

Terminal natif (zsh)

Suffisant. Pas besoin d'installer autre chose. iTerm2 en alternative si vous voulez plus de confort.

Windows

PowerShell 7+ ou Windows Terminal

À installer depuis le Microsoft Store. Les anciens cmd.exe et PowerShell 5 sont à éviter — plusieurs commandes de Claude Code y plantent silencieusement.

Linux

Terminal natif (bash ou zsh)

GNOME Terminal, Konsole, Alacritty — tout convient. Bash et zsh sont équivalents pour cet usage.

§03 · Vérifier l'état actuel

Avant d'installer, on vérifie

Claude Code est distribué via npm, le gestionnaire de paquets de Node.js. Il faut donc Node.js — version récente en LTS (Long Term Support), typiquement 20.x ou supérieure en 2026.

# Dans votre terminal :
$ node --version

# Cas 1 — Node est installé
v20.18.0     # vous pouvez sauter l'étape d'installation

# Cas 2 — Node n'est pas installé
command not found: node     # il faut installer (étape suivante)
§04 · Démo — l'installation de bout en bout

Du terminal vide à Claude qui répond

1

Vérifier l'état

Tester node --version et which brew. Si node manque, on l'installe.

2

Installer Node.js

brew install node (macOS). Pour Windows, télécharger depuis nodejs.org. Tester avec node --version.

3

Installer Claude Code

npm install -g @anthropic-ai/claude-code. Vérifier avec claude --version.

4

Premier lancement

Tape claude : le navigateur s'ouvre pour l'authentification OAuth. Une fois validée, retour au terminal.

— iTerm2 — bash — 120×40 eric@MacBookPro ~/ projets $ node --version zsh: command not found: node eric@MacBookPro ~/ projets $ which brew /opt/homebrew/bin/brew eric@MacBookPro ~/ projets $ brew install node ==> Downloading https://ghcr.io/v2/homebrew/core/node/manifests/22.4.0 ==> Pouring node--22.4.0.arm64_sonoma.bottle.tar.gz 🍺 /opt/homebrew/Cellar/node/22.4.0: 2,037 files, 56.5MB eric@MacBookPro ~/ projets $ node --version v22.4.0 eric@MacBookPro ~/ projets $ npm --version 10.8.1 eric@MacBookPro ~/ projets $ npm install -g @anthropic-ai/claude-code added 87 packages in 8s eric@MacBookPro ~/ projets $ claude --version claude-code 1.4.2 eric@MacBookPro ~/ projets $ claude ✻ Welcome to Claude Code! Authentication required. Opening browser for OAuth... → https://console.anthropic.com/oauth/code?key=eGZk... ✓ Authenticated as eric@yoat-lab.fr (Pro plan) Ready. Type your message or `/help` for commands.
§05 · Installation Node.js

Trois étapes simples

1.
Télécharger l'installeur LTS sur nodejs.org. La page détecte automatiquement votre OS. Toujours choisir la version étiquetée LTS, jamais Current. Sur Windows, cocher impérativement « Add to PATH » pendant l'assistant.
2.
Redémarrer le terminal après l'installation. C'est essentiel : les changements de PATH ne sont pris en compte qu'au prochain démarrage d'une session terminal.
3.
Vérifier l'installation. Retaper node --version. Le numéro de version doit s'afficher. Si la commande renvoie encore une erreur, le PATH n'a pas été mis à jour — relancer une nouvelle fenêtre de terminal.
§06 · Installation Claude Code

Une seule commande

Une fois Node disponible, Claude Code s'installe en une seule commande. Le drapeau -g (global) rend la commande claude disponible partout sur votre machine.

$ npm install -g @anthropic-ai/claude-code

# L'installation prend quelques minutes
# Téléchargement, compilation, mise en place du PATH

# Vérification :
$ claude --version
claude-code 1.x.x
Erreur de permission EACCES

Selon votre configuration, npm peut demander des droits administrateur. Rapide : préfixer par sudo (macOS/Linux). Propre : configurer un répertoire utilisateur pour les paquets globaux (10 minutes, plus sûr à terme).

§07 · Première authentification

Se connecter à votre compte Anthropic

1.
Créer un dossier de test et s'y déplacer. Sur macOS : mkdir -p ~/Projects/test-claude && cd ~/Projects/test-claude. Sur Windows : mkdir $env:USERPROFILE\Projects\test-claude ; cd $env:USERPROFILE\Projects\test-claude
2.
Lancer la commande claude. Le navigateur s'ouvre automatiquement sur la page d'autorisation Anthropic. Connectez-vous avec le même compte que claude.ai. Autorisez l'accès.
3.
Le terminal reprend la main. Vous voyez l'invite de Claude Code. Tester immédiatement : « Liste les fichiers de ce dossier ». Si Claude répond correctement, l'environnement est prêt.
Fin · Leçon 03 acquise

Cap sur la leçon 04

Vous avez un terminal moderne, Node.js LTS, Claude Code installé et authentifié. La leçon suivante vous montre comment initialiser un vrai projet avec un fichier CLAUDE.md de démarrage.

Leçon suivante → 04 · Initialiser un projet Claude Code
Quiz · Validation des acquis

Quiz · Configurer son terminal

8 questions · une seule bonne réponse par question · vous pouvez recommencer autant de fois que nécessaire.

1 / 8
Question à choix multiple

Pourquoi Claude Code a-t-il besoin de Node.js ?

Score : 0 / 8
Cliquez sur lecture pour démarrer.
§00 · Intro 0:00 / 8:00 Voix activée