Cours 0. Installer Claude Code — Ce que vous utilisez n'est peut-être pas Claude Code

Astuce — savoir ceci suffit pour commander

Une seule vérification, c’est tout.

Ouvrez le terminal et tapez la commande suivante.

claude --version

Si un numéro de version comme 2.1.x s’affiche — c’est le vrai Claude Code. Les cours 1 à 11 de cette formation fonctionneront tous.

Si la commande est introuvable, ou si vous utilisez actuellement la fenêtre de chat intégrée à Cursor, Antigravity ou Windsurf — ce n’est pas Claude Code. Même si vous utilisez le même modèle Claude, c’est un programme différent. La conduite autonome de cette formation ne s’y exécute pas.

La phrase à retenir :

Agent ≠ Modèle. Même Opus, programmes différents, capacités différentes.

Installation en une ligne (Mac / Ubuntu / WSL) :

curl -fsSL https://claude.ai/install.sh | bash

Windows : WSL ou Docker d’abord. Voir le corps du cours ci-dessous.

Démarrage rapide

Donnez la même tâche aux deux outils et observez la différence entre le CLI et le chat IDE. Trois minutes suffisent.

Dans Claude Code (CLI) :

“Dans un dossier vide, crée hello.py. Introduis intentionnellement une erreur de syntaxe, exécute-le pour voir l’erreur, puis corrige-le seul et relance-le. Jusqu’à ce que ‘Hello’ s’affiche.”

Claude Code en CLI — crée le fichier, l’exécute directement, lit l’erreur, corrige, relance. Il ne vous demande pas votre avis à chaque étape. La boucle autonome tourne.

Mettez la même phrase dans le chat d’un IDE (fenêtre de chat de Cursor, Antigravity, Windsurf) — le code est proposé, mais vous devez cliquer pour exécuter, copier-coller l’erreur, et approuver chaque étape. La boucle passe par vous.

C’est tout ce que le Cours 0 doit enseigner. Et l’ensemble de cette formation est conçu en supposant la première approche.

Pourquoi commander ainsi

Vous avez probablement déjà essayé de créer quelque chose avec « Claude Code ». Vous avez regardé un tutoriel YouTube, discuté avec le chat, vu du code apparaître.

Mais une question mérite d’être posée. Ce que vous utilisiez — était-ce vraiment Claude Code ?

Si la question semble anodine, voici une histoire réelle de terrain.

Agent ≠ Modèle

Un utilisateur avait développé une application en vibe coding et elle avait planté. Il a demandé de l’aide. Il disait « développer avec Claude Code ». Plusieurs jours de galère. Rien ne fonctionnait comme demandé, l’IA demandait à chaque carrefour « option A, B ou C ? » — impossible d’avancer.

La cause n’était pas son jugement. Ce qu’il utilisait, c’était le chat Claude intégré à l’IDE Antigravity. Pas Claude Code CLI. Les deux utilisent le modèle Claude Opus. Le modèle est identique. Et pourtant, les résultats étaient complètement différents.

Pourquoi ? Parce que même modèle, agent différent.

• Modèle (Model) : Le cerveau — Opus, Sonnet. La capacité à lire et écrire, en elle-même.
• Agent (Agent) : Le programme qui fait tourner ce cerveau. Quel prompt système il reçoit, quels outils (lecture/écriture de fichiers, exécution de commandes) il a en main, jusqu’où il agit seul sans approbation humaine — tout cela est défini par l’agent.

Même cheval (modèle), mais être lâché dans un pré sans contrainte ou sellé avec un cavalier qui tient les rênes mène à des endroits très différents. L’agent, c’est précisément cette selle et ce harnais — le dispositif qui permet de passer les rênes (reins). (On y reviendra au Cours 5.)

Pourquoi un agent médiocre ne suffit pas — quel niveau cet agent requiert-il

Les agents ont des niveaux. Et la ligne de partage pour ce cours (cours 1 à 11) se résume à un seul critère.

Le cœur de cette formation tient en une phrase :

L’IA écrit le code, la machine valide, vous vérifiez juste « ça passe ? ».

Pour que ça fonctionne, l’IA doit elle-même exécuter les outils de validation et lire les résultats pour décider de la suite. Lancer yongol validate, lire l’erreur, corriger, relancer — si un humain doit servir d’intermédiaire à chaque fois, ce n’est plus de l’autonomie, c’est du labeur.

Boucle autonome possible :
  L'IA lance validate → lit l'erreur → corrige → relance validate → passe → suite
  (0 intervention humaine)

Intermédiaire humain à chaque étape :
  L'IA dit "exécutez validate ainsi" → l'humain copie-colle, lance →
  l'humain copie le résultat → le colle à l'IA → l'IA propose une correction → l'humain relance...

Cours 3 Hurl, Cours 4 yongol, Cours 6 tsma, Cours 8 filefunc — tous sont des outils CLI. L’IA doit les exécuter de manière autonome pour que ça ait un sens. Avec un agent qui ne peut pas tourner cette boucle, la moitié de cette formation ne fonctionne pas.

Le critère d’un « agent médiocre » n’est donc pas la marque, mais cette unique question :

Cet agent exécute-t-il yongol validate / hurl / tsma seul, lit-il le résultat et décide-t-il de la suite ? Ou dois-je copier-approuver à chaque étape ?

• Premier cas — c’est un agent sur lequel on peut passer les rênes. (Claude Code CLI en fait partie.)
• Second cas — c’est un agent médiocre. Peu importe l’intelligence du modèle, cette formation s’y bloque.

Attention : « extension IDE = forcément non » n’est pas la règle. Le mode agent de Cursor ou Windsurf, par exemple, exécute des commandes de façon autonome et tourne en boucle. À l’inverse, le mode chat simple du même produit passe par un humain à chaque étape. Jugez sur le critère ci-dessus, pas sur le nom du produit. Ce qui bloquait lors des vrais onboardings, ce n’était pas « parce que IDE », c’était parce que le mode chat utilisé ne pouvait pas exécuter la boucle CLI de façon autonome.

C’est pourquoi le Cours 0 est la porte d’entrée. Choisir le mauvais outil rend les onze cours suivants mensongers.

Le piège de YouTube

Voilà le problème. La majorité des tutoriels de vibe coding sur YouTube et dans les communautés ne distinguent pas l’agent à boucle autonome du mode chat simple — ils appellent les deux « Claude Code ».

Le débutant n’a donc aucun moyen de voir la différence. Il parle dans une fenêtre de chat en croyant « utiliser Claude Code ». Et quand ça ne marche pas comme dans le tutoriel, il s’en veut à lui-même.

Non. Le mauvais outil a été choisi. Pour être précis : YouTube a mal indiqué l’outil. Il suffit de garder en tête ce critère — « exécute-t-il le CLI de façon autonome ? » — pour ne jamais tomber dans ce piège.

Installer Claude Code

Cette formation se base sur Ubuntu (ou WSL). Les utilisateurs Mac suivront globalement les mêmes étapes.

Prérequis

1. Compte Anthropic : Créer un compte sur https://console.anthropic.com
2. Abonnement : Claude Pro (20 $/mois), Max (100 $/mois ou 200 $/mois). Max offre une limite d’utilisation plus généreuse.
3. Ubuntu / Mac / WSL ou Docker : Les utilisateurs Windows choisissent l’une des deux options ci-dessous.

Mac · Ubuntu · dans WSL — installation native (recommandée)

La méthode la plus simple, sans besoin de Node.js.

curl -fsSL https://claude.ai/install.sh | bash

Une fois l’installation terminée, vérifiez.

claude --version

Si un numéro de version comme 2.1.x s’affiche, c’est un succès.

Windows option A : WSL (recommandée)

Ouvrez Windows PowerShell en tant qu’administrateur et exécutez.

wsl --install

Cette unique ligne active WSL, télécharge le noyau Linux et installe Ubuntu. Après le redémarrage, Ubuntu s’ouvre et demande un nom d’utilisateur et un mot de passe. Entrez un nom court en minuscules.

Attention : Tout le travail à venir se fait dans le terminal Ubuntu. Installer Claude Code depuis PowerShell ou CMD provoque l’erreur « Windows is not supported ».

Exécutez ensuite la ligne d’installation native ci-dessus à l’intérieur d’Ubuntu.

Conseil WSL : Placez toujours vos projets dans le système de fichiers Linux (/home/nomutilisateur/). Les mettre côté Windows (/mnt/c/) ralentit extrêmement la lecture des fichiers.

Windows option B : Docker (si WSL est bloqué)

Si la politique d’entreprise ou des problèmes d’environnement empêchent WSL, lancez un conteneur Linux via Docker et utilisez Claude Code à l’intérieur.

# Dans le dossier projet, lance un conteneur ubuntu et monte le dossier courant
docker run -it -v "$(pwd)":/work -w /work ubuntu:24.04 bash

# Dans le conteneur
apt update && apt install -y curl
curl -fsSL https://claude.ai/install.sh | bash
claude --version

-v "$(pwd)":/work relie votre dossier projet au /work dans le conteneur. Le travail effectué à l’intérieur du conteneur reste dans votre dossier.

Méthode alternative : installation via npm

Pour ceux qui ont déjà une expérience de Node.js. Si vous débutez, utilisez l’installation native ci-dessus.

# Installer nvm puis Node.js LTS
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts

# Installer Claude Code
npm install -g @anthropic-ai/claude-code

Attention : N’utilisez pas sudo npm install -g. Cela cause des problèmes de permissions et des risques de sécurité.

Premier lancement et authentification

# Aller dans le dossier projet (le créer si nécessaire)
mkdir -p ~/projects/my-first-app
cd ~/projects/my-first-app

# Lancer Claude Code
claude

Au premier lancement, le navigateur s’ouvre et demande une connexion Anthropic. Une fois connecté, l’authentification est terminée et la connexion sera automatique par la suite.

Liste de vérification de l’installation

Ces trois éléments tous cochés — vous êtes prêt pour le Cours 1.

• claude --version affiche-t-il un numéro de version 2.1.x ?
• L’exécution de claude affiche-t-elle l’invite (fenêtre de dialogue) ?
• L’authentification via connexion navigateur est-elle terminée ?
• Dans le démarrage rapide ci-dessus, l’IA a-t-elle seule créé le fichier, exécuté et corrigé — sans demander l’approbation à chaque étape ?

Le dernier point est le plus important. Si l’IA a exécuté des commandes seule et corrigé les erreurs — vous utilisez le vrai Claude Code.

Les extensions IDE en complément seulement

Cursor, Antigravity et Windsurf ne sont pas de mauvais outils. Pour voir et modifier le code ligne par ligne, ils sont excellents. Pour un développeur, ce sont de bons outils.

Mais la conduite autonome de cette formation se fait en CLI. Utilisez les extensions IDE comme fenêtre d’inspection du code, et confiez la boucle « créer, valider, verrouiller » au CLI Claude Code. Utilisez les deux ensemble, mais distinguez bien leurs rôles.

Exercice : vérifier le vrai outil

Objectif : Confirmer que j’utilise bien le CLI Claude Code, et faire tourner une boucle autonome une fois.

Étape 1 — Vérifier l’installation

claude --version

Vérifiez que la version s’affiche en 2.1.x. Si ce n’est pas le cas, reprenez la procédure d’installation ci-dessus. Sur Windows, configurez d’abord WSL (option A) ou Docker (option B).

Étape 2 — Observer la boucle autonome

Lancez claude et, dans un dossier vide, donnez l’instruction :

Dans un dossier vide, crée hello.py. Introduis intentionnellement
une erreur de syntaxe, exécute-le pour voir l'erreur, puis corrige-le
seul et relance-le. Jusqu'à ce que "Hello" s'affiche.

Ce qu’il faut observer :

• L’IA crée-t-elle le fichier directement ? (sans que vous copiiez-colliez le code)
• L’IA exécute-t-elle directement python hello.py ?
• En cas d’erreur, l’IA la lit-elle seule et la corrige-t-elle ?
• Dans tout ce processus, votre seule intervention a-t-elle été la première phrase et (si nécessaire) les approbations d’exécution ?

Si tout est « oui » — vous avez passé le portail. Direction le Cours 1.

(Si vous utilisiez le chat IDE) Entrez la même phrase dans la fenêtre de chat IDE et observez où ça bloque. Une fois cette différence ressentie concrètement, vous n’oublierez jamais pourquoi le Cours 0 est nécessaire.

Récapitulatif

1. Agent ≠ Modèle. Même modèle Claude, programmes différents (agents), capacités complètement différentes.
2. Une bonne partie de ce que YouTube appelle « Claude Code » est en réalité un mode chat simple qui ne peut pas tourner en boucle autonome. Le critère de distinction n’est pas la marque, c’est « exécute-t-il le CLI de façon autonome ? ».
3. Cette formation est conçue sur la base du CLI. Cours 3 Hurl, Cours 4 yongol, Cours 6 tsma, Cours 8 filefunc — tous sont des outils CLI que l’IA doit exécuter de façon autonome.
4. L’installation tient en une ligne. curl -fsSL https://claude.ai/install.sh | bash. Sur Windows : WSL ou Docker d’abord.
5. Critère de passage : claude --version affiche 2.1.x et l’IA crée, exécute et corrige les fichiers seule.

Choisir le mauvais outil rend les onze cours suivants mensongers. La porte d’entrée a été fermée ici.

Aperçu du cours suivant : « Comment commander l’IA. » Maintenant que vous tenez le vrai Claude Code, vous apprendrez ce qu’un non-programmeur doit demander à l’IA, et comment le demander.

Devoirs

1. Vérifier son propre outil : Confirmer si ce que vous utilisiez en croyant utiliser « Claude Code » est bien le CLI ou le chat IDE. claude --version est la réponse.
2. Faire tourner une boucle autonome : Mener l’exercice hello.py ci-dessus jusqu’au bout et compter combien d’étapes l’IA a traitées seule sans intervention humaine.
3. (Utilisateurs Windows) Choisir son environnement : Choisir entre WSL et Docker selon votre configuration et terminer l’installation.

Articles connexes

• Pourquoi les agents de codage fonctionnent et échouent — Les conditions dans lesquelles la boucle de validation autonome de l’agent fonctionne ou s’effondre. Le fond théorique du « pourquoi la boucle CLI autonome » du Cours 0.
• Reins Engineering — L’IA bridée — La différence entre harnais (harness) et rênes (Reins), et le cadre global qui voit l’agent comme le substrat des rênes.

Pour aller plus loin (externe)

• Agent Harness Engineering — Addy Osmani. « Un modèle correct + un excellent harnais bat un excellent modèle + un mauvais harnais. » Cas où le classement des benchmarks s’inverse simplement en changeant le harnais à modèle fixé. La version définitive de Agent ≠ Modèle.
• Agents are models using tools in a loop — Simon Willison. La définition standard de l’agent. La « boucle » où le résultat d’un outil est renvoyé au modèle distingue le vrai agent du simple terme marketing.
• Which AI Coding Harness Actually Works Without You? — Paweł Józefiak. Distinction des outils de codage en trois catégories : Orchestrator (autonome), Pair Programmer (instruction par étape), Supervised IDE (refuse de décider seul). Les confondre est l’erreur centrale — exactement le « piège YouTube » du Cours 0.

Cours complet Reins Engineering

Sources

• Anthropic. “Claude Code overview.” Anthropic Documentation. link
• Anthropic. “Set up Claude Code.” Anthropic Documentation. link
• Karpathy, A. (2025). “Vibe coding” — Origine du terme désignant le codage par ressenti sans lire le code.