Cours Vibe coding avec Claude Code · Module 1: Claude Code et Cursor

Installer Claude Code et donner la première demande

11 min de lecture ·
Dans cette leçon12

Ohé ! Le navire est déjà au port : Cursor fonctionne. Il ne manque que l'équipage. Dans cette leçon, tu vas enrôler Claude Code, donner un premier ordre et vérifier dans Cursor ce qui est vraiment arrivé dans la cale.

Problème : un ordre sans contrôle est un pari

Un agent qui écrit des fichiers tout seul est puissant, mais pour le premier voyage tu veux voir chacun de ses gestes avant de l'approuver. C'est pourquoi nous avançons doucement aujourd'hui : d'abord l'installation, puis un mode où Claude demande ton accord avant chaque changement, et seulement à la fin la première demande et l'apprentissage du retour en arrière.

Étape 1 : le port, c'est-à-dire le dossier du projet

Claude Code travaille dans le dossier où tu le lances : il voit les fichiers de ce dossier et de ses sous-dossiers, et n'atteint les fichiers extérieurs qu'avec ton accord. Ce dossier fixe donc les limites de son travail.

Crée sur ton ordinateur un dossier vide navire_pirate, par exemple dans Documents, avec le gestionnaire de fichiers habituel. Ensuite, dans Cursor, choisis File, Open Folder et désigne ce dossier. L'Explorer à gauche affiche un projet vide. Ouvre le terminal avec le raccourci de la leçon précédente : Control+` sur Mac, Ctrl+` sous Windows et Linux.

Étape 2 : installer Claude Code

La méthode recommandée est l'installateur natif, qui met à jour Claude Code tout seul en arrière-plan. Sous macOS, Linux et dans WSL (Linux lancé dans Windows), tape dans le terminal de Cursor :

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

Cette commande télécharge le script d'installation officiel depuis claude.ai et le lance aussitôt. N'installe ainsi des programmes que depuis l'adresse d'un éditeur en qui tu as confiance : dans la leçon 0_3, tu verras pourquoi des commandes similaires venant d'adresses inconnues sont un drapeau rouge. L'installateur n'affiche pas de progression, alors attends qu'il termine.

Sous Windows, vérifie d'abord dans quel shell tu es : PowerShell affiche les lettres PS avant le chemin au début de la ligne, et CMD affiche seulement le chemin. Dans PowerShell, tape :

irm https://claude.ai/install.ps1 | iex

Ici, irm télécharge le script et iex l'exécute. Dans CMD, utilise plutôt la commande curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Sous Windows, Git for Windows est aussi recommandé : il donne à Claude l'outil Bash, et sans lui Claude Code utilise PowerShell. Dans WSL, Git for Windows n'est pas nécessaire.

Quand l'installateur a terminé, ouvre un nouveau terminal, par exemple avec Control+Shift+` sur Mac ou Ctrl+Shift+` sous Windows et Linux, et vérifie l'installation :

claude --version

Une installation qui fonctionne affiche un numéro de version suivi de (Claude Code). Si le terminal répond qu'il ne connaît pas la commande claude (command not found ou is not recognized), le dossier d'installation n'est pas encore dans le PATH, c'est-à-dire la liste des endroits où le terminal cherche les programmes. Ferme le terminal et ouvre-en un nouveau. Si cela ne suffit pas, l'installateur affiche à la fin de son travail un correctif prêt à l'emploi dans la section Setup notes.

Étape 3 : première session et connexion

Dans le terminal de Cursor, dans le dossier navire_pirate, tape claude et appuie sur Entrée. Au premier lancement, Claude Code te demande de te connecter : un navigateur s'ouvre, où tu te connectes avec un compte Claude disposant d'un abonnement payant ou avec un compte Claude Console. Les identifiants sont enregistrés, donc les sessions suivantes démarrent sans cette étape. Claude Code peut aussi demander si tu fais confiance à ce dossier : c'est ton port vide, alors confirme.

Au-dessus du champ de saisie, tu verras la version, le nom du modèle et le dossier de travail. Vérifie le dossier : le chemin doit se terminer par navire_pirate. Si tu vois un autre dossier, quitte la session avec la commande /exit et ouvre le bon dossier dans Cursor. La commande /help affiche la liste des commandes disponibles.

Étape 4 : le mode Manual pour le premier voyage

Le mode de permissions décide de ce que Claude peut faire sans demander. Une session dans le terminal démarre en mode auto : Claude écrit les fichiers et lance les commandes seul, tandis qu'un autre modèle en arrière-plan évalue ses actions et bloque les plus risquées. C'est pratique, mais pour le premier voyage, tu veux voir chaque geste de l'équipage.

Appuie sur Maj+Tab (Shift+Tab). Depuis le mode auto, la première pression bascule la session en Manual, ce que montre l'indicateur de mode. Les pressions suivantes passent par acceptEdits (fichiers enregistrés sans demander) et plan (planification seule), donc si tu dépasses, continue d'appuyer jusqu'à revoir Manual. Dans ce mode, Claude te demande avant chaque modification de fichier et avant les commandes qui changent quelque chose.

Le choix vaut pour la session en cours : une nouvelle session redémarrera en mode auto, donc vérifie l'indicateur au début de chacune. Conseil du capitaine : reste en Manual pendant les premiers lieux, et passe en auto quand lire les changements te sera devenu naturel.

Étape 5 : d'abord une question, ensuite un ordre

Commence par une question qui ne change rien : tape dans la session « Qu'y a-t-il dans ce dossier ? ». Claude parcourt le dossier et répond qu'il est vide. Une question ne fait que lire, alors qu'une demande modifie des fichiers, c'est pourquoi Claude ne demandera ton accord que pour la demande.

Passons maintenant à l'ordre de la leçon précédente. Il a un objectif, un lieu et des contraintes, donc Claude n'a rien à deviner :

Demande pour Claude Code :

Crée dans ce dossier un fichier pirate.html : une page avec un titre
"Ahoj Piraci!" en rouge et un seul paragraphe de bienvenue. Écris les
styles dans la balise <style> du même fichier. Ne crée aucun autre fichier.

En mode Manual, Claude s'arrête avant d'enregistrer le fichier, montre ce qu'il compte faire et demande ton accord. Lis la proposition, choisis Yes avec les flèches et appuie sur Entrée. Les options qui autorisent plus que cette seule fois, par exemple jusqu'à la fin de la session, ignore-les pour l'instant. Quand le fichier est créé, il apparaît dans l'Explorer.

Ce que Claude a écrit

Clique sur pirate.html dans l'Explorer pour l'ouvrir dans l'éditeur. Ton fichier peut différer par des détails, par exemple le texte du paragraphe, mais sa construction sera semblable. Lis de haut en bas. La première partie est le squelette du document :

<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
  <title>Ahoj Piraci!</title>

<!DOCTYPE html> dit au navigateur qu'il s'agit d'un document HTML. lang="fr" déclare la page en français, <head> contient des informations pour le navigateur, et <meta charset="UTF-8"> fait en sorte que les lettres accentuées s'affichent correctement. <title> est le texte de l'onglet du navigateur, pas celui de la page elle-même.

Plus loin, toujours dans <head>, se trouve la balise <style> avec une règle CSS. Le CSS est le langage qui décrit l'apparence de la page. Une règle se compose d'un sélecteur, c'est-à-dire ce à quoi elle s'applique, et de propriétés entre accolades :

  <style>
    h1 {
      color: red;
    }
  </style>
</head>

Le sélecteur h1 choisit les titres de premier niveau, et color: red donne à leur texte la couleur rouge. La règle ne change ni le paragraphe ni le fond de la page : elle ne concerne que les titres h1. La balise fermante </head> termine la partie destinée au navigateur.

La dernière partie est <body>, le contenu qu'on voit vraiment sur la page, avec le titre et le paragraphe de ta demande :

<body>
  <h1>Ahoj Piraci!</h1>
  <p>Bienvenue à bord ! Ici commence notre aventure.</p>
</body>
</html>

<h1> est le titre avec exactement le texte que tu as demandé, et <p> est le paragraphe. Les balises fermantes </body> et </html> terminent le document. Pour voir la page, double-clique sur pirate.html dans le gestionnaire de fichiers habituel : elle s'ouvre dans le navigateur.

La revue du capitaine

Avant de naviguer plus loin, vérifie quatre choses dans Cursor :

  1. Le fichier se trouve dans navire_pirate, et pas dans un autre dossier.
  2. Un seul fichier a été créé, comme tu l'as demandé. Une erreur typique d'un agent est d'en faire plus qu'on ne lui a dit : un style.css en plus, un README ou des sections que tu n'as pas demandées. Tu le remarques dans l'Explorer et dans le contenu du fichier.
  3. Le titre a exactement le texte « Ahoj Piraci! ».
  4. La couleur est dans la règle CSS de <style>, et la page dans le navigateur a un titre rouge.

Si quelque chose ne va pas, ne le rafistole pas à la main : écris à Claude ce qu'il faut corriger, ou annule le changement, comme dans un instant.

Deuxième demande et modification du fichier

Demande un petit changement pour voir à quoi ressemble la correction d'un fichier existant :

Demande pour Claude Code :

Dans pirate.html, change la couleur du titre h1 en bleu marine (navy).
Laisse le reste du fichier inchangé.

Avant d'enregistrer la modification, Claude te montre de nouveau ce qu'il compte faire et demande ton accord. Accepte et regarde le fichier dans Cursor. Dans la règle du titre, une seule valeur a changé :

h1 {
  color: navy;
}

À la place de red il y a maintenant navy, et le reste du fichier est identique à avant. C'est ainsi que tu lis chaque correction : tu cherches ce qui a changé, et tu vérifies que rien d'autre n'a été touché.

Esc et /rewind : le frein et l'ancre

Deux outils te donnent un contrôle total sur l'équipage :

  • Esc interrompt Claude pendant son travail. Ce qu'il a déjà fait reste, et Claude attend ta consigne. Esc appuyé pendant une demande d'accord agit comme une réponse No.
  • /rewind (ou deux fois Esc quand le champ de saisie est vide) ouvre le menu de retour en arrière. Avant chacune de tes demandes, Claude Code mémorise l'état des fichiers qu'il modifie, donc tu peux revenir au moment précédant n'importe quelle demande.

Dans le menu, tu choisis la demande à laquelle revenir, puis une des options : Restore code and conversation (code et conversation), Restore conversation (seulement la conversation), Restore code (seulement le code) ou Never mind (ne rien faire). Il y a aussi des options de résumé de la conversation, mais tu n'en as pas besoin aujourd'hui.

Exercice : tape /rewind, choisis la demande du changement de couleur et l'option Restore code. Ouvre pirate.html dans Cursor : le titre est de nouveau rouge, et la conversation est restée. Une réserve pour la suite : /rewind annule les changements faits avec les outils d'édition de fichiers de Claude, mais pas les effets de toutes les commandes du terminal. C'est pourquoi, dans la leçon 0_3, tu apprendras à lire les commandes avant de les accepter.

L'extension Claude Code pour Cursor (facultatif)

Claude Code a une extension officielle pour VS Code, qui s'installe aussi dans Cursor : sur la page code.claude.com/docs/en/vs-code, il y a un lien Install for Cursor. L'extension ajoute à l'éditeur un panneau de conversation graphique avec sa propre copie de Claude Code, mais elle n'installe pas la commande claude dans le terminal : pour cela, il te faut l'installation de l'étape 2. La documentation précise que, dans le terminal de VS Code, un claude lancé se connecte tout seul à l'extension ; elle ne le dit pas pour le terminal de Cursor. Conseil du capitaine : le cours travaille dans le terminal, car c'est pareil dans tous les éditeurs, et tu pourras ajouter l'extension plus tard.

Étape suivante

Quand tu as fini, quitte la session avec la commande /exit ou appuie deux fois sur Ctrl+D. La prochaine fois, dans le même dossier, tu reprendras la conversation avec la commande :

claude -c

L'option -c (de continue) reprend la conversation la plus récente dans le dossier courant, donc Claude se souvient de ce que vous aviez décidé. claude seul démarre une nouvelle conversation, mais les fichiers du projet restent, bien sûr. Que la demande suivante soit de nouveau petite, par exemple : « Ajoute sous le paragraphe un bouton avec le texte Rejoindre l'équipage. Ne change pas le titre. » Dans la leçon 0_3, tu apprendras à lire les commandes que Claude lance dans le terminal.

Retiens : tu donnes l'ordre, Claude Code écrit, et Cursor montre ce qui est vraiment arrivé dans la cale.

Code de cette leçon : index.html
<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
  <title>Ahoj Piraci!</title>
  <style>
    h1 {
      color: red;
    }
  </style>
</head>
<body>
  <!-- Voici à quoi peut ressembler pirate.html après la première demande de la leçon. -->
  <!-- Ton fichier créé par Claude Code peut différer par des détails, par ex. le texte du paragraphe. -->
  <h1>Ahoj Piraci!</h1>
  <p>Bienvenue à bord ! Ici commence notre aventure.</p>
</body>
</html>

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Que montre la commande claude --version ?

  2. 2. Avec quel raccourci changes-tu le mode de permissions de la session, par exemple de auto à Manual ?

  3. 3. Claude Code a modifié un fichier et le résultat ne te plaît pas. Comment reviens-tu à l'état d'avant la demande ?

  4. 4. Quand vaut-il la peine de passer la session du mode auto au mode Manual ?

  5. 5. Quelle demande de correction de pirate.html est la meilleure ?

  6. 6. Où Claude Code crée-t-il et modifie-t-il des fichiers ?

  7. 7. Claude a commencé à faire autre chose que ce que tu voulais. Quelle touche interrompt son travail ?

Tâches pratiques dans le jeu

  • Éditeur de code

    Utilise Cursor pour créer un fichier HTML simple

  • Tri vertical

    Ordonne les étapes de la première session de Claude Code :

  • Tri horizontal

    Assemble la commande d'installation de Claude Code sous macOS, Linux et dans WSL :

  • Tri vertical

    Ordonne les étapes d'un changement en mode Manual :

  1. QuestionQuiz : Vérifier l'installation
  2. Exercice de codePratique : crée le fichier pirate.html
  3. Remets dans l'ordreTri : La première session de Claude Code
  4. QuestionQuiz : Changer de mode de permissions
  5. QuestionQuiz : Annuler un changement
  6. Remets dans l'ordreAssemblage : Installer Claude Code
  7. QuestionQuiz : Quand utiliser le mode Manual
  8. QuestionQuiz : La demande de correction
  9. QuestionQuiz : Où travaille Claude Code
  10. Remets dans l'ordreTri : Un changement en mode Manual
  11. QuestionQuiz : Interrompre le travail de Claude

Articles utiles