Mission spéciale

H apprend Claude Code

Un parcours pas à pas pour installer ton environnement, lancer ta première session Claude Code et débloquer tes badges. Choisis ta machine et c'est parti.

🏅 Tes badges

1 Repérer ta machine échauffement

Avant tout : qu'est-ce qu'on a sous le capot ?

Sur l'iMac, clique sur la pomme 🍎 en haut à gauche → À propos de ce Mac. Note :

  • Le nom du modèle (ex: iMac 2017)
  • La version de macOS (ex: Sonoma 14.5)
  • Le processeur (Intel ou Apple Silicon — M1/M2/M3)
Pourquoi ? Si l'iMac est trop ancien (macOS < 11 Big Sur), on devra installer une version plus ancienne de Node. Pas grave, on s'adapte.

Sur le PC : touche Windows + R, tape winver, Entrée.

  • Version Windows (10 ou 11)
  • Build number

Puis Windows + Pause → infos sur le processeur et la RAM.

Idéal : Windows 10 (build 19041+) ou Windows 11. Sinon, on parle.

2 Installer Visual Studio Code éditeur

On installe d'abord l'éditeur — c'est notre quartier général pour tout le reste.

  1. Va sur code.visualstudio.com
  2. Clique sur le gros bouton de téléchargement (il détecte ta machine automatiquement)
  3. Ouvre le fichier .zip téléchargé, puis glisse Visual Studio Code dans le dossier Applications.
  4. Lance l'installateur .exe. Coche bien la case "Ajouter à PATH" pendant l'install (c'est très important pour la suite).
  5. Lance VS Code. Tu verras une interface sombre avec une barre d'icônes à gauche. Fais un petit tour, clique partout pour voir.
Bon réflexe : sur Mac, fais glisser l'icône VS Code dans ton Dock pour la retrouver facilement. Sur Windows, épingle-la à la barre des tâches.

3 Ouvrir un terminal dans VS Code ★

Le terminal vit directement dans VS Code — pas besoin d'app séparée.

Dans VS Code, en haut de l'écran :

  1. Clique sur le menu Terminal
  2. Puis New Terminal (ou "Nouveau terminal")
  3. Un panneau s'ouvre en bas de VS Code — c'est ton terminal. Pas besoin d'autre chose.

Sur Mac, c'est un terminal zsh (ou bash) qui s'ouvre. Tape ces 3 commandes pour t'échauffer :

echo "Bonjour H, c'est ton terminal"
pwd
ls

Sur Windows, VS Code ouvre par défaut un terminal PowerShell. Pour avoir bash (recommandé pour Claude Code) :

  1. Dans la barre de droite du terminal, clique sur la petite flèche ▾ à côté du +
  2. Choisis Git Bash si disponible, sinon reste sur PowerShell

Tape ces 3 commandes pour t'échauffer :

echo "Bonjour H, c'est ton terminal"
pwd
ls
Mini-glossaire : pwd = où tu es. ls = ce qu'il y a ici. cd dossier = entre dans le dossier. Tu vas en utiliser plein, c'est normal.
Ouvrir un autre onglet terminal : dans le panneau terminal, clique sur le + en haut à droite. Tu peux avoir plusieurs onglets ouverts en parallèle — pratique quand Claude tourne dans un et que tu veux taper des commandes dans un autre.

4 Installer Node.js moteur

Claude Code est une appli Node. On installe Node.js LTS.

Méthode recommandée : Homebrew (gestionnaire de paquets Mac).

1. Installer Homebrew :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Installer Node :

brew install node
iMac ancien ? Si Homebrew refuse (macOS < 12), télécharge Node directement sur nodejs.org — choisis la version LTS.

Télécharge l'installateur LTS sur nodejs.org. Lance le .msi, suivant suivant terminer.

Vérifie que ça marche dans le terminal :

node --version
npm --version

Tu dois voir deux numéros (ex: v20.11.0 et 10.2.4).

5 Installer Claude Code le héros

Le moment où ça devient sérieux.

Dans le terminal, installe Claude Code via npm :

npm install -g @anthropic-ai/claude-code
Mac : si tu vois "permission denied", essaie : sudo npm install -g @anthropic-ai/claude-code (il demande ton mot de passe Mac).

Windows : si npm râle, ouvre PowerShell en admin et réessaie.

Vérifie :

claude --version

6 Connecter ton compte Anthropic gratuit

On reste en mode gratuit pour découvrir.

  1. Va sur console.anthropic.com
  2. Crée un compte (email + mot de passe ou Google)
  3. Tu reçois 5 $ de crédit gratuit à la création (largement de quoi tester pendant des semaines)
  4. Dans le terminal, lance pour la première fois : 
    claude
  5. Il va t'ouvrir une page web pour te connecter. Tu connectes, tu reviens dans le terminal. C'est fait.
Plus tard : Thomas peut te faire profiter de son abonnement Max via son VPS. Pour l'instant, on reste sur ton compte à toi — c'est plus simple pour apprendre.

7 Première conversation ★★

Ta première interaction avec Claude Code.

Crée un dossier pour bricoler, puis lance Claude :

mkdir ~/mon-premier-projet
cd ~/mon-premier-projet
claude

Quand le prompt s'affiche, demande lui simplement :

Bonjour Claude, présente-toi en 3 lignes et dis-moi ce que tu peux faire pour moi.

Claude répond. Tu peux continuer la conversation à l'infini.

Pour quitter : tape /exit ou appuie deux fois sur Ctrl + C.

8 Lui faire créer un fichier ★★

Claude ne fait pas que parler — il écrit du code.

Dans la même session Claude, demande :

Crée un fichier hello.html avec une page web simple qui dit "Bonjour de la part de H".
Mets du style sympa avec un dégradé en fond.

Claude va te demander la permission d'écrire le fichier. Tu acceptes. Il écrit.

Vérifie le résultat — ouvre hello.html dans ton navigateur :

open hello.html
start hello.html

9 Les commandes magiques ★★★

Les slash commands qui te font gagner du temps.

Dans une session Claude, tape / et regarde la liste qui s'affiche. Les plus utiles :

  • /help — toute l'aide
  • /clear — nettoie la conversation (mémoire à zéro)
  • /compact — résume la conversation pour libérer du contexte
  • /init — crée un fichier CLAUDE.md qui décrit ton projet (Claude le lira à chaque fois)
  • /exit — quitter
Astuce de pro : tape Shift + Tab pour changer de mode (plan / auto-accept). Très pratique.

10 L'intégration Claude ↔ VS Code ★★★

Tu utilises déjà le terminal de VS Code — découvre les superpouvoirs cachés.

Comme tu lances Claude depuis le terminal de VS Code, il détecte automatiquement l'éditeur et active des superpouvoirs :

  • Il voit les fichiers que tu as ouverts dans l'éditeur
  • Il te montre ses modifications dans des diffs visuels (vert/rouge) au lieu de juste du texte
  • Il peut lire ta sélection de code en direct

Essaie tout de suite :

  1. Ouvre ton fichier hello.html dans VS Code (clique dessus dans l'explorateur de gauche)
  2. Surligne quelques lignes de code avec ta souris
  3. Dans le terminal VS Code où Claude tourne, demande : "Explique-moi ce que fait la partie que j'ai sélectionnée"
  4. Claude lit ta sélection et répond
Astuce : tu peux ouvrir plusieurs onglets terminal côte à côte. Dans un onglet Claude tourne, dans l'autre tu testes tes commandes. Productivité ×2.

11 Mini-projet : ta page perso ★★★★

L'épreuve finale : tu fabriques un truc à toi.

Demande à Claude de t'aider à construire une page web personnelle. Par exemple :

Aide-moi à construire une page web "À propos de H" avec :
- mon prénom en grand
- 3 trucs que j'aime (laisse-moi te dire lesquels)
- mes coordonnées (mais on bidonne pour l'exemple)
- un design qui claque, fond sombre, typo moderne

Pose-moi des questions avant de coder.
Le truc important : dis à Claude de te poser des questions avant de coder. C'est comme ça qu'on obtient un résultat qui correspond à ce qu'on veut.

Quand c'est fini, ouvre la page dans ton navigateur et admire.

12 Bonus : passer sur le compte de Thomas ★★★★★

Quand tu seras à l'aise — accès illimité via le VPS.

Quand tu te sentiras prêt à passer en mode pro, Thomas te configurera un accès à son abonnement Claude Max via son VPS. Plus de limite de crédit, modèle Opus disponible, tout l'arsenal.

Ce que ça impliquera (pour info)
  • Installation de Tailscale sur ta machine (réseau privé sécurisé)
  • Une clé SSH générée pour toi
  • Accès en ssh h@vps-thomas à une session Claude Code partagée
  • Thomas pourra voir ce que tu fais, c'est normal — c'est son compte

Pour l'instant : reste sur ton compte gratuit, apprends, casse des trucs, recommence. Ce badge se débloque quand tu te sens prêt.

🎖️ Mission accomplie

Tous les badges débloqués. Tu es officiellement opérationnel sur Claude Code.
Maintenant : sors et construis des trucs.

🏅
Badge débloqué