YOAT Lab
Cabinet PEDETTI · Formation Claude · Maîtrise
Module 1 · 3 leçons
Environnement de développement
Module 1 — Environnement de développement

Configurer son terminal

Capsule 8 min Type pratique Modalité e-learning Niveau maîtrise
Objectif opérationnel

À l'issue de cette leçon, le stagiaire dispose d'un terminal moderne opérationnel sur sa machine (zsh sur macOS, PowerShell 7 ou Windows Terminal sur Windows), de Node.js installé en version LTS, et de Claude Code prêt à recevoir ses premières commandes.

§ 01

Pourquoi un terminal moderne

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'environnement où Claude Code va passer ses heures de travail. Un bon terminal — coloration syntaxique, copier-coller fluide, onglets multiples — fait la différence entre un outil agréable et un outil qu'on évite.

Sur macOS, le terminal par défaut (zsh) est suffisant. Pas besoin d'installer autre chose. Sur Windows, deux bons choix : PowerShell 7 ou supérieur, ou Windows Terminal. Les anciens cmd.exe et PowerShell 5 sont à éviter — ils fonctionnent, mais l'ergonomie est désagréable et plusieurs commandes utilisées par Claude Code y plantent silencieusement.

À retenir

Le terminal est l'outil que vous utiliserez le plus souvent dans cette formation. Investissez quelques minutes à le configurer correctement : thème lisible, police monospace de qualité (JetBrains Mono, Fira Code, Cascadia Code). Ce sont des minutes qui s'amortissent en quelques heures d'usage.

§ 02

Vérifier l'état actuel de Node.js

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

Avant d'installer quoi que ce soit, on vérifie ce qui est déjà en place. Dans votre terminal, tapez la commande de vérification :

$ 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)

Si vous obtenez un numéro de version commençant par v18, v20 ou v22, vous êtes opérationnel. Si vous obtenez une version plus ancienne (v16 ou inférieure), procédez quand même à la mise à jour — certaines fonctionnalités récentes de Claude Code en dépendent.

§ 03

Installer Node.js selon l'OS

Deux options selon votre système d'exploitation. Aucune n'est complexe, comptez 5 à 10 minutes.

  1. Télécharger l'installeur LTS sur le site officiel. Rendez-vous sur nodejs.org. La page d'accueil détecte votre OS et propose le bon installeur en évidence. Toujours choisir la version étiquetée LTS, jamais Current (qui est la version expérimentale).

    macOSFichier .pkg à double-cliquer. Suivre l'assistant. Si vous avez Homebrew installé, alternative en une ligne : brew install node.
    WindowsFichier .msi à exécuter. Pendant l'assistant, cocher impérativement l'option « Add to PATH ». Sans elle, Node sera installé mais introuvable depuis le terminal.

  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. Fermer et rouvrir, ou redémarrer la machine si nécessaire.

  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.

§ 04

Installer Claude Code

Une fois Node disponible, Claude Code s'installe en une seule commande. Le drapeau -g installe globalement, ce qui rend la commande claude disponible partout sur votre machine, depuis n'importe quel dossier.

Erreur de permission

Selon votre configuration, npm peut demander des droits administrateur. Si vous obtenez une erreur EACCES, deux options. La rapide (macOS/Linux) : préfixer la commande par sudo. La propre (tous OS) : configurer un répertoire utilisateur pour les paquets globaux — plus sûr à terme, demande 10 minutes de mise en place. La documentation Anthropic détaille la procédure.

$ 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
§ 05

Première authentification

Première utilisation de Claude Code : on crée un dossier de test, on s'y déplace, et on lance la commande claude. L'outil ouvre votre navigateur sur une page de connexion Anthropic.

  1. Créer un dossier de test et s'y déplacer. Tout au long de la formation, vous travaillerez sur de vrais projets, mais ici on fait juste un test d'authentification.

    macOSmkdir -p ~/Projects/test-claude && cd ~/Projects/test-claude
    Windowsmkdir $env:USERPROFILE\Projects\test-claude ; cd $env:USERPROFILE\Projects\test-claude

  2. Lancer Claude Code avec la commande claude. Le navigateur s'ouvre automatiquement sur la page d'autorisation Anthropic. Vous vous connectez avec le même compte que claude.ai. Vous autorisez Claude Code à accéder à votre compte.

  3. Le terminal reprend la main. Vous voyez l'invite de Claude Code. Tester immédiatement avec un prompt simple : « Liste les fichiers de ce dossier ». Si Claude répond correctement, l'environnement est prêt pour les leçons suivantes.

Exercice — appropriation

Vérifier votre installation complète

Effectuez la procédure complète sur votre machine de travail. Notez à chaque étape : (1) la version de Node obtenue, (2) la version de Claude Code obtenue, (3) le temps total d'installation, (4) toute difficulté rencontrée (erreur de permission, PATH non mis à jour, version trop ancienne). Cet inventaire vous sera utile si vous devez réinstaller sur une autre machine, ou aider un collègue à le faire.

Cet exercice est à conserver dans votre dossier de stagiaire. Il n'est pas évalué mais il est tracé.

Sources officielles consultées

Vous avez Node.js LTS, Claude Code installé, et la commande claude répond correctement ?