Pourquoi ce module

C'est le pré-travail du tronc commun « Claude Code Expert » : ~1 h, en autonomie, avant le J1. Objectif unique — arriver au premier jour avec un environnement opérationnel et vérifié, pour que les 35 h de formation servent à apprendre, pas à déboguer des installations.

Le J1 commence par un prérequis non négociable : être à l'aise pour ouvrir un terminal et lancer claude dans un dossier de projet. Ce module vous y amène, quel que soit votre point de départ (Windows, macOS, Linux), avec les méthodes recommandées en 2026 — qui ont changé : l'installeur natif a remplacé npm comme voie standard.

Prérequis : aucun. Public : tous les inscrits au tronc commun. Durée ≈ 1 h (jusqu'à 1 h 30 sur Windows si WSL2 est à installer). Livrable : la checklist de fin de module, validée, à renvoyer avant le J1.

Objectifs pédagogiques

À l'issue de ce module, vous serez capable de :

Choisir votre environnement : natif (macOS/Linux), WSL2 ou natif Windows — et justifier ce choix (sandboxing, outillage Unix du cursus)
Installer Claude Code par la méthode recommandée 2026 (installeur natif) et connaître la voie npm (quand et pourquoi)
Authentifier votre installation (abonnement Claude vs clé API Console) et lancer une première session
Diagnostiquer votre installation avec claude --version et claude doctor

Plan détaillé

Pourquoi un terminal Unix (et lequel)
Windows : WSL2 ou natif — l'arbre de décision
Installer Claude Code : installeur natif (recommandé) vs npm
Premier lancement : authentification et vérification
Checklist de validation avant J1

Pourquoi un terminal Unix (et lequel)

Claude Code tourne nativement sur Windows depuis fin 2025 — PowerShell suffit. Alors pourquoi ce module recommande-t-il quand même un environnement Unix ? Deux raisons propres au cursus :

Le sandboxing OS (isolation de Claude Code au niveau système : fichiers et réseau restreints) ne fonctionne que sur macOS et Linux — donc aussi sur WSL2, mais pas sur Windows natif. Pour travailler sur des projets sensibles, c'est l'argument décisif.
Tout le cursus suppose bash : les hooks de J2 sont des scripts shell, les skills de J3 emballent des scripts Unix, le mode headless de J5 se scripte en CLI. Un environnement Windows natif vous obligerait à transposer chaque exemple.

Côté émulateur de terminal, n'importe lequel fonctionne — c'est un confort, pas un prérequis :

OS	Par défaut (suffisant)	Recommandation confort
Windows	Windows Terminal (Microsoft Store)	WezTerm — multiplexage, rendu GPU, config en fichier (c'est le terminal des captures de ce cursus)
macOS	Terminal.app	iTerm2, WezTerm ou Ghostty
Linux	celui de votre distribution	WezTerm, Ghostty

💡 Pourquoi le terminal compte. Vous passerez 35 h dedans. Une fonte lisible, un historique de défilement profond et des onglets/panneaux réduisent la friction — et la friction est le premier facteur d'abandon d'un outil CLI (cf. M11 sur l'adoption).

Windows : WSL2 ou natif — l'arbre de décision

Chargement du schéma…

Installation de WSL2 (PowerShell administrateur) :

wsl --install
# Installe WSL2 + Ubuntu par défaut. Redémarrez, créez votre utilisateur Unix,
# puis vérifiez :
wsl --version   # WSL ≥ 2.x attendu

⚠️ Piège classique : installer Claude Code côté Windows et travailler sur des fichiers WSL (ou l'inverse). Installez Claude Code dans l'environnement où vivent vos projets — pour ce cursus : dans Ubuntu/WSL2, avec vos repos dans le système de fichiers Linux (~/projects, pas /mnt/c/..., nettement plus lent).

Installer Claude Code : natif (recommandé) vs npm

Depuis 2026, l'installeur natif est la méthode recommandée sur toutes les plateformes : aucune dépendance (ni Node.js ni npm), binaire auto-mis à jour en arrière-plan, et c'est la voie qu'Anthropic teste en priorité.

# macOS, Linux et WSL2
curl -fsSL https://claude.ai/install.sh | bash

# Windows natif (PowerShell)
irm https://claude.ai/install.ps1 | iex

La voie npm reste supportée — elle installe d'ailleurs le même binaire natif :

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

Quand la préférer ? Deux cas : npm est déjà votre outillage standard d'équipe, ou vous épinglez les versions en lockstep (parc managé, CI). Deux règles absolues : jamais sudo npm install -g (problèmes de droits et risque sécurité), et si vous venez d'une vieille installation npm, migrez vers le natif en 30 secondes avec claude install.

Premier lancement : authentification et vérification

Dans un dossier de projet (un repo Git, même vide) :

claude --version   # le binaire répond ?
claude             # premier lancement → choix du thème, puis authentification

Deux modes d'authentification :

Abonnement Claude (Pro / Max / Team) — recommandé pour la formation : connexion via claude.ai, usage inclus dans l'abonnement.
Console API (clé sk-ant-…) — facturation à l'usage, pertinent pour le headless/CI (J5) et les comptes de service.

Écran d'accueil de Claude Code dans un terminal : version, modèle, dossier de travail, invite et status line — Ce que vous devez voir à la fin de ce module : l'écran d'accueil de Claude Code — version, modèle, dossier de travail, invite. Si cet écran s'affiche dans votre terminal, vous êtes prêt pour le J1.

En cas de problème, ne déboguez pas à la main — lancez d'abord le diagnostic intégré :

claude doctor   # diagnostique type d'installation, auth, config, PATH

claude doctor identifie la majorité des soucis courants (installation npm résiduelle, PATH, proxy, auth expirée) et indique le correctif. C'est le réflexe n° 1 — il vous resservira tout au long du cursus.

Deux réglages de confort, 30 secondes

Avant de refermer, dans la session :

/terminal-setup configure votre émulateur pour que Shift+Entrée insère un saut de ligne. Sans ça, écrire un prompt sur plusieurs lignes oblige à terminer chaque ligne par \ — friction permanente sur un outil qu'on utilise 35 h. À lancer une fois par émulateur de terminal.
/config ouvre les réglages, dont le thème : clair, sombre, et des variantes daltonisées (rouge/vert remplacés par des paires distinguables). Les diffs de Claude Code s'appuient beaucoup sur la couleur : si vous êtes concerné, ce réglage n'est pas cosmétique.

Checklist de validation avant J1

À dérouler dans votre terminal, et à renvoyer complétée au formateur :

Un terminal s'ouvre (Windows : Ubuntu/WSL2 sauf choix natif assumé)
git --version répond
claude --version répond
claude doctor ne signale aucune erreur bloquante
claude lance une session : écran d'accueil visible, authentification faite
Dans la session : /model affiche le sélecteur de modèles
/terminal-setup passé : Shift+Entrée fait bien un saut de ligne dans l'invite
Un dossier de travail existe pour la formation (ex. ~/projects/formation-claude)

🎯 Si un point bloque : signalez-le au formateur avant le J1 (avec la sortie de claude doctor). Quinze minutes de visio en amont valent mieux qu'une matinée de J1 perdue en dépannage collectif.

Pour aller plus loin

📖 Claude Code — Setup officiel (méthodes d'installation, plateformes supportées)
📖 Microsoft — Installer WSL
📖 WezTerm · Windows Terminal
🎯 Suite : J1 (architecture, modes, settings) — votre environnement est prêt, place au harness

Préparation : terminal, WSL2 et installation de Claude Code