Cours Vibe coding avec Claude Code · Module 2: Un projet Next.js avec Claude Code

Node.js et npm : le moteur du projet

10 min de lecture ·
Dans cette leçon10

Bienvenue dans le deuxième lieu ! Dans le premier, Claude Code a écrit pour toi un seul fichier HTML. Maintenant, on commence un vrai projet : le site du jeu « Kraken's Call » en Next.js. Avant que Claude le crée dans la leçon suivante, le navire a besoin d'un moteur.

Ce que tu vas apprendre

  • vérifier que tu as Node.js et npm, et juger si leurs versions suffisent pour Next.js ;
  • comprendre les commandes npm que Claude demandera dans ce cours, avant de cliquer sur Yes ;
  • lire le fichier package.json et dire ce que lancera chaque script ;
  • reconnaître une demande d'accord devant laquelle il faut s'arrêter.

Problème : un code sans moteur reste au port

Claude Code installé en natif n'a pas besoin de Node.js : c'est un programme à part, qui fonctionne tout seul. Un projet Next.js, lui, en a besoin. La page que Claude écrira dans des fichiers .tsx ne s'ouvrira pas toute seule dans le navigateur : quelqu'un doit la construire et démarrer un serveur. Ce quelqu'un, c'est Node.js. Sans lui, Claude enregistrera les fichiers, mais chaque commande censée les lancer se terminera par le message command not found.

Le moteur et le quartier-maître

Node.js est l'environnement qui exécute JavaScript en dehors du navigateur, sur ton ordinateur. Sur notre navire, c'est le moteur : grâce à lui tournent le serveur de développement, la vérification des types de TypeScript et les outils qui construisent le site.

npm (Node Package Manager) est le gestionnaire de paquets, c'est-à-dire le quartier-maître et sa cale. Un paquet est une bibliothèque ou un outil tout prêt, écrit par quelqu'un d'autre, par exemple react, next ou tailwindcss. npm télécharge les paquets depuis un registre public, les range dans le projet et surveille leurs versions. Il s'installe avec Node.js : un seul installateur, deux outils.

Tu l'installes toi-même, une seule fois

Dans la leçon 0_3, tu as rencontré Node.js en bref. Si la commande node --version t'a répondu command not found, il est temps d'installer :

  1. Va sur https://nodejs.org et ouvre la page de téléchargement.
  2. Garde la version portant l'étiquette LTS (Long Term Support), c'est-à-dire à support long. État en novembre 2026 : la dernière LTS est la ligne 26, et la version étiquetée Alpha ne sert qu'aux tests.
  3. Plus bas, parmi les installateurs prêts à l'emploi, télécharge le fichier pour ton système : .msi sous Windows, .pkg sous macOS. Sous Linux, choisis ton système sur la même page et suis les instructions qui s'affichent.
  4. Lance l'installateur et passe les écrans suivants avec les réglages par défaut.

Conseil du capitaine : les programmes système comme Node.js, tu les installes toi-même depuis le site officiel, tu ne les confies pas à Claude. L'installateur demande le mot de passe administrateur, et la décision sur les droits d'administrateur, c'est-à-dire sur sudo de la leçon 0_3, t'appartient, pas à l'agent. Après l'installation, ferme le terminal dans Cursor et ouvres-en un nouveau, pour qu'il voie les nouvelles commandes.

Vérification : Claude inspecte la salle des machines

Ouvre dans Cursor le dossier navire_pirate du lieu précédent, lance claude dans le terminal et regarde l'indicateur de mode. Pour l'instant, on reste en Manual, pour voir chaque commande.

Demande pour Claude Code :

Vérifie quelles versions de Node.js et de npm j'ai, et dis-moi si elles
suffisent pour le projet Next.js 16 que nous créerons dans la leçon
suivante. Avant de lancer une commande, écris en une phrase ce qu'elle
va faire. N'installe rien.

La demande a un but (vérifier les versions), une contrainte (« n'installe rien ») et une description de ce que tu veux recevoir à la fin, c'est-à-dire un jugement. Ces briques, tu les connais depuis la leçon 0_5. Claude répondra qu'il va lancer deux commandes :

node -v
npm -v

-v est l'abréviation de --version, donc node -v et node --version font exactement la même chose. Si Claude demande ton accord, lis calmement : les deux commandes affichent seulement un numéro de version et ne changent rien sur le disque. Tu peux faire la même vérification seul, sans Claude, en tapant ! node -v dans la session.

Le résultat ressemble à ceci, la première ligne est Node.js, la seconde npm :

v26.13.1
11.20.0

C'est ce qu'a répondu un Node.js tout juste installé, de la ligne LTS, avec le npm livré avec lui ; chez toi, les nombres peuvent être plus élevés. Ce qui compte, c'est le minimum : Next.js 16 demande au moins Node.js 20.9. Claude comparera pour toi, mais la règle vaut la peine d'être connue, car une vieille version d'un ancien projet peut attendre des années sur un disque.

Les commandes npm que tu verras dans les demandes d'accord

À partir de la leçon suivante, c'est Claude qui lance les commandes npm et toi qui les approuves. Tu n'approuves que ce que tu comprends, alors découvre les quatre plus fréquentes. La première installe les paquets dont le projet a besoin :

npm install

npm lit la liste des dépendances dans le fichier package.json, télécharge les paquets depuis le registre et les range dans le dossier node_modules. Sans nom de paquet, il installe seulement ce qui figure déjà sur la liste et n'ajoute rien de nouveau au projet. Avec un nom, par exemple npm install zod, il ajoute un nouveau paquet, et cette demande-là, tu la lis plus attentivement.

La deuxième démarre le serveur de développement, sur lequel tu regardes le site pendant le travail :

npm run dev

npm run lance le script portant le nom indiqué dans le fichier package.json, ici le script dev. Dans un projet Next.js, il démarre un serveur qui affiche le site à l'adresse http://localhost:3000 et le rafraîchit à chaque modification d'un fichier. Le serveur tourne tant que tu ne l'arrêtes pas avec Ctrl+C, et le site n'est pas publié sur internet pour autant.

La troisième construit la version de production, celle que tu déploieras plus tard :

npm run build

Le build compile tout le projet et vérifie les types de TypeScript. S'il y a une erreur dans le code, la commande se termine par un message rouge, et si elle réussit, tu as la preuve solide que le projet s'assemble. C'est pourquoi, dans ce cours, npm run build sera la vérification que tu demandes à Claude après les changements. Le build ne déploie rien : la version prête reste sur ton disque.

La quatrième est npx, le petit frère de npm, qui lance un outil sans l'installer durablement :

npx create-next-app@latest krakens-call

npx télécharge l'outil create-next-app, le lance une fois et ne le laisse pas dans le système. @latest désigne la dernière version, et krakens-call est le nom du projet. C'est avec cette commande, accompagnée de quelques options, que Claude créera le projet dans la leçon suivante.

package.json : la fiche du navire

Chaque projet JavaScript a un fichier package.json. C'est la fiche du navire : le nom, les scripts et la liste des dépendances. Dans la leçon suivante, tu l'ouvriras dans Cursor, et voici à quoi il ressemble dans un projet Next.js tout neuf créé en novembre 2026 :

{
  "name": "krakens-call",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "eslint"
  },
  "dependencies": {
    "next": "16.4.6",
    "react": "19.3.0",
    "react-dom": "19.3.0"
  },
  "devDependencies": {
    "@tailwindcss/turbopack": "4.3.3",
    "@types/node": "^20",
    "@types/react": "^19",
    "@types/react-dom": "^19",
    "eslint": "^9",
    "eslint-config-next": "16.4.6",
    "tailwindcss": "4.3.3",
    "typescript": "^5"
  }
}

La section scripts contient les ordres nommés : npm run dev lance next dev, npm run build lance next build, npm run start lance la version construite, et npm run lint lance eslint, c'est-à-dire un programme qui cherche dans le code les erreurs et les motifs risqués. Quand Claude demandera ton accord pour un npm run suivi d'un nom, regarde dans scripts : tu y liras ce qui sera vraiment exécuté.

dependencies contient les paquets dont l'application a besoin pour fonctionner, c'est-à-dire Next.js et React. devDependencies contient les outils nécessaires seulement pendant le travail sur le code : TypeScript, Tailwind, ESLint. Chez toi, les numéros de version peuvent être plus récents, mais la structure du fichier reste la même.

node_modules et package-lock.json : la cale et l'inventaire

Après npm install, un dossier node_modules apparaît dans le projet, avec les paquets téléchargés. Il peut être énorme, des centaines de mégaoctets, et chacun le recrée avec une seule commande, donc il n'entre pas dans Git. Un projet créé par create-next-app a déjà réglé cela, car son fichier .gitignore contient cette ligne :

/node_modules

La barre oblique au début désigne un dossier à la racine du projet. Grâce à cette ligne, Git ignore la cale, et dans le panneau Source Control de Cursor, tu ne verras pas des milliers de fichiers de paquets étrangers.

À côté de package.json se trouve package-lock.json, l'inventaire exact de la cargaison : les versions précises de tous les paquets, y compris de ceux dont d'autres paquets ont besoin. Ce fichier, tu le commites, car grâce à lui, toute personne qui télécharge le projet obtient après npm install exactement les mêmes versions. Tu ne le lis pas ligne par ligne, mais quand Claude installera quelque chose, tu verras des changements dans les deux fichiers dans Source Control.

La revue du capitaine : les demandes d'accord npm

Avant de cliquer sur Yes devant une commande npm, vérifie trois choses :

  1. Ce paquet figurait-il dans la demande ? npm install avec un nom ajoute une nouvelle dépendance. Si tu ne l'avais pas demandée, demande à Claude pourquoi il en a besoin et si on peut s'en passer.
  2. Y a-t-il -g ou sudo dans la commande ? L'option -g installe le paquet globalement, pour tout le système, et non pour le projet. Une telle installation sort du navire, donc avant d'accepter, demande pourquoi elle est nécessaire.
  3. Qu'est-ce qui a changé dans les fichiers ? Après l'installation, ouvre Source Control et lis les changements dans package.json : une nouvelle ligne dans dependencies ou devDependencies doit correspondre à ce que tu avais demandé.

L'erreur typique de l'agent : il installe une bibliothèque « au cas où », ou il donne une commande tirée de sa mémoire, d'une version plus ancienne de l'outil. C'est au point 3 que tu l'attrapes le plus facilement. Un paquet que tu ne sais pas justifier est un signal pour arrêter Claude avec la touche Esc et poser des questions.

Étape suivante

Tu as le moteur, et tu sais ce que font les ordres pour la salle des machines. Dans la leçon suivante, tu donneras à Claude Code la demande qui crée tout le projet Next.js, et tu liras dans Cursor chaque fichier qui apparaîtra.

Retiens : le moteur, tu le montes toi-même, mais chaque ordre pour la salle des machines, tu le lis avant de signer.

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. Qu'est-ce que Node.js ?

  2. 2. Quelle commande installe toutes les dépendances depuis package.json ?

  3. 3. Qu'est-ce que npm ?

  4. 4. Que contient le fichier package.json ?

  5. 5. À quoi sert la commande npx ?

  6. 6. Pourquoi n'ajoute-t-on pas le dossier node_modules à Git ?

Tâches pratiques dans le jeu

  • Éditeur de code

    Vérifie la version de Node.js dans le terminal et écris dans le fichier commands.sh la commande que tu as utilisée.

  • Clique dans l'ordre

    Construis la commande qui vérifie la version de Node.js :

  • Tri vertical

    Ordonne les étapes habituelles pour lancer un projet npm téléchargé :

  • Tri horizontal

    Ordonne les parties de la commande qui crée un nouveau projet Next.js (de gauche à droite) :

  1. QuestionQuiz : Qu'est-ce que Node.js ?
  2. QuestionQuiz : Commandes npm
  3. Exercice de codePratique : Vérifier la version de Node.js
  4. Clique dans l'ordreOrdre : la commande de version de Node.js
  5. QuestionQuiz : qu'est-ce que npm
  6. QuestionQuiz : le fichier package.json
  7. Remets dans l'ordreOrdre : les commandes du projet
  8. QuestionQuiz : la commande npx
  9. Remets dans l'ordreOrdre : la commande de création d'un projet Next.js
  10. QuestionQuiz : le dossier node_modules

Articles utiles