★ Mission spéciale

H apprend Claude Code

Un parcours pas à pas pour installer ton environnement, lancer ta première session, et finir avec un site perso sous le bras. Sans douleur, avec quelques badges au passage.

1 Repérer ta machine échauffement

On ouvre le capot avant de prendre la route.

Sur l'iMac : pomme 🍎 en haut à gauche → À propos de ce Mac. Note quelque part :

  • Le 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 date du temps où Sarkozy était président, c'est encore jouable mais on adaptera certaines installations. Aucun jugement.

Sur le PC : Windows + R, tape winver, Entrée. Tu vois la version (10 ou 11).

Puis Windows + Pause pour le processeur et la RAM.

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

2 Installer Visual Studio Code éditeur

Le quartier général. Tout passera par là.

  1. Va sur code.visualstudio.com
  2. Clique sur le gros bouton — le site détecte ta machine
  3. Ouvre le .zip téléchargé, glisse Visual Studio Code dans Applications.
  4. Lance l'installateur .exe. Coche "Ajouter à PATH" — ne saute pas cette case, on te dira merci plus tard.
  5. Lance VS Code. Promène-toi : barre latérale, menus, le truc en bas qui ressemble à rien — c'est là où on va tout faire.
Bon réflexe : épingle VS Code à ton Dock (Mac) ou à la barre des tâches (Windows). Tu vas le lancer souvent.

3 Ouvrir un terminal dans VS Code

Le terminal vit dans VS Code. Pas besoin d'une autre app.

Dans VS Code, en haut :

  1. Menu Terminal
  2. New Terminal (ou "Nouveau terminal")
  3. Un panneau apparaît en bas. Bienvenue chez toi.

Tu obtiens un terminal zsh. Tape ces trois lignes pour serrer la main :

echo "Salut, c'est mon terminal"
pwd
ls

Par défaut, VS Code ouvre PowerShell. Pour avoir Git Bash (plus pratique avec Claude) : flèche ▾ à côté du + en haut à droite du terminal → Git Bash. Sinon PowerShell ira.

echo "Salut, c'est mon terminal"
pwd
ls
Glossaire éclair : pwd = où tu es. ls = ce qu'il y a ici. cd dossier = entre dedans. C'est 90% de ce qu'il te faut.
Ouvrir un deuxième onglet : clique sur le + en haut à droite du terminal. Tu pourras avoir Claude qui tourne dans un onglet pendant que tu tapes des commandes dans l'autre. Le truc des grands.

4 Installer Node.js moteur

Le carburant de Claude Code. Une seule fois, ça roule pour toujours.

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

Dans ton terminal VS Code, colle ça pour installer Homebrew :

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

Suis les instructions à l'écran (ça te demandera ton mot de passe Mac). Une fois fini :

brew install node
iMac un peu daté ? Si Homebrew refuse (macOS < 12), va sur nodejs.org, télécharge la version LTS, double-clique. Ça marchera aussi.

Va sur nodejs.org, télécharge la version LTS. Lance le .msi, suivant suivant terminer.

Ferme et rouvre le terminal (important — pour qu'il prenne en compte Node). Puis vérifie :

node --version
npm --version

Tu dois voir deux numéros. Si oui, Node est là.

5 Installer Claude Code le héros

Une commande. Une seule.

npm install -g @anthropic-ai/claude-code
Mac, si ça râle "permission denied" : sudo npm install -g @anthropic-ai/claude-code — il demande ton mot de passe Mac (qui ne s'affiche pas pendant que tu tapes, c'est normal, ne panique pas).

Windows : si ça grogne, ferme le terminal, rouvre-le en admin (clic droit sur PowerShell → Exécuter en admin), réessaie.

Puis vérifie :

claude --version

6 Connecter ton compte Anthropic gratuit

On reste au niveau gratuit. C'est largement suffisant 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 à l'inscription. De quoi tester des semaines sans toucher ton portefeuille.
  4. Reviens dans ton terminal VS Code, et lance pour la première fois :
    claude
  5. Une page web s'ouvre dans ton navigateur. Tu connectes ton compte. Tu reviens dans le terminal. C'est fait.
Plus tard : Thomas pourra te connecter à son abonnement Max via son VPS — accès illimité, modèle Opus inclus. Pour l'instant, on apprend gentiment avec ton propre compte.

7 Ta première vraie conversation ★★

Le moment où ça devient bizarrement amical.

Dans le terminal VS Code, crée un petit dossier pour bricoler, puis lance Claude dedans :

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

Quand l'invite Claude s'affiche, tape :

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

Il répond. Tu peux continuer la discussion comme avec un collègue.

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

8 Lui faire écrire un fichier ★★

Claude ne fait pas que parler. Il code aussi.

Dans la même session, demande :

Crée un fichier hello.html : une page web simple
qui dit "Bonjour de la part de H".
Mets un dégradé sympa en fond, une typo moderne.

Claude va te demander la permission d'écrire le fichier. Tu acceptes (touche Entrée). Il écrit.

Ouvre le résultat dans ton navigateur :

open hello.html
start hello.html

Ta première page web, faite par toi (avec un peu d'aide).

9 Les commandes magiques ★★★

Les slash commands. Apprends-en deux ou trois, ta vie change.

Dans une session Claude, tape / et regarde la liste. Les essentielles :

  • /help — toute l'aide
  • /clear — efface la conversation (utile quand on change de sujet)
  • /compact — résume la conversation pour libérer de la mémoire
  • /init — crée un CLAUDE.md dans ton projet — Claude le lira à chaque fois (sa mémoire du projet)
  • /exit — quitter
Coup de pro : Shift+Tab change le mode (plan / auto-accept). En mode "plan", Claude réfléchit avant d'agir. Très pratique pour les choses sérieuses.

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

Les superpouvoirs cachés qui apparaissent quand on lance Claude depuis VS Code.

Comme tu utilises Claude depuis le terminal de VS Code, il détecte l'éditeur automatiquement et débloque :

  • Il voit les fichiers que tu as ouverts
  • Il te montre ses modifications en diff visuel (vert/rouge) plutôt qu'en texte plat
  • Il peut lire ta sélection de code en direct

Essaie tout de suite :

  1. Dans VS Code, ouvre ton hello.html
  2. Sélectionne quelques lignes avec ta souris
  3. Dans le terminal où Claude tourne, demande : "Explique-moi ce que fait la partie que j'ai sélectionnée."

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

L'épreuve finale. Tu fabriques quelque chose qui est à toi.

Demande à Claude :

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

Pose-moi des questions avant de coder.
Le truc clé : demande-lui de te poser des questions avant de coder. C'est comme ça qu'on obtient un résultat qui te ressemble vraiment.

Quand c'est fini, ouvre la page, regarde, demande des modifs. Itère. Tu codes, en fait.

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

Accès illimité via le VPS. Quand tu seras prêt.

Quand tu te sentiras à l'aise et que tu voudras passer en vitesse supérieure, Thomas te branchera sur son abonnement Claude Max via son VPS. Plus de limite de crédit. Modèle Opus dispo. L'arsenal complet.

Ce que ça impliquera (pour info)
  • Installation de Tailscale (réseau privé chiffré, gratuit, indolore)
  • Une clé SSH générée juste pour toi
  • Tu te connecteras en ssh h@vps-thomas à une session Claude Code partagée
  • Thomas pourra voir ce que tu fais — normal, c'est son compte. C'est même plutôt sympa : il pourra te dépanner en regardant ton terminal.

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. (Et n'hésite pas à demander dans le chat.)

Pistes bonus

Petites quêtes annexes pour aller plus loin — optimiser ta machine, ton réseau, ton téléphone. À picorer dans l'ordre que tu veux.

🏅
Badge débloqué