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

Claude Code crée le projet Next.js

13 min de lecture ·
Dans cette leçon12

Le moteur tourne il est temps de mettre le navire à l'eau. Dans cette leçon, Claude Code va créer le projet du site du jeu « Kraken's Call », et toi, tu liras dans Cursor tout ce qui est apparu et tu exigeras la preuve que le projet se construit.

Problème : l'assistant pose douze questions

Un nouveau projet Next.js est créé par l'assistant create-next-app. Lancé sans options, il pose des questions l'une après l'autre : sur le nom, sur les réglages recommandés, et, si tu choisis tes propres réglages, sur dix autres points, de TypeScript aux fichiers pour les agents. Chacune attend une réponse au clavier. La deuxième ressemble à ceci :

? Would you like to use the recommended Next.js defaults? › - Use arrow-keys. Return to submit.
❯   Yes, use recommended defaults
    TypeScript, ESLint, No React Compiler, Tailwind CSS, No src/ directory, App Router, Cache Components, AGENTS.md, Agent feedback
    No, customize settings

Les réglages recommandés sont presque bons, mais ils activent deux choses que nous ne voulons pas dans ce cours : Cache Components et Agent feedback. Au lieu de cliquer à travers l'assistant, tu donneras toutes les réponses d'avance à Claude, et il les transformera en options. Avec les options, l'assistant ne pose pas une seule question, et tu sais d'avance ce qui sera créé.

Ce qu'est Next.js

Next.js est un framework pour construire des applications web avec React. Il fournit tout prêt ce que React seul oblige à assembler à la main : des pages sous forme de fichiers, le rendu côté serveur et un serveur de développement. La documentation de React (react.dev) le cite en premier parmi les frameworks recommandés pour les nouvelles applications.

Next.js a deux façons de ranger les pages. L'App Router garde les pages dans le dossier app/ et il est recommandé pour les nouveaux projets. Le Pages Router les garde dans le dossier pages/ : c'est l'ancienne méthode, toujours prise en charge. Dans le cours, nous utilisons l'App Router.

Demande pour Claude Code

Crée dans Documents un nouveau dossier vide projets, séparé de navire_pirate, car l'assistant crée dans le nouveau projet son propre dépôt Git. Ouvre-le dans Cursor (File, Open Folder), lance claude dans le terminal et passe la session en Manual.

Demande pour Claude Code :

Crée dans ce dossier un nouveau projet Next.js nommé krakens-call avec
npx create-next-app@latest, de façon que l'assistant ne pose aucune
question : TypeScript, ESLint, Tailwind CSS, App Router, sans dossier
src/, avec le fichier AGENTS.md, sans Cache Components, sans agent
feedback, npm comme gestionnaire de paquets. Avant de lancer la
commande, montre-la et explique chaque option. À la fin, lance
npm run build dans le nouveau projet et montre le résultat.

La demande contient un but, la liste complète des exigences, la demande d'explication avant le lancement et une vérification à la fin. La dernière phrase est la plus importante : « c'est prêt » de la part de l'agent est un compte rendu, et le résultat du build est une preuve.

Ce que Claude a proposé : la commande avec ses options

Claude expliquera les options et demandera ton accord pour une commande semblable à celle-ci :

npx create-next-app@latest krakens-call --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npm

Lis-la option par option avant de cliquer sur Yes :

  • krakens-call est le nom du projet et du dossier qui sera créé ;
  • --ts active TypeScript, --eslint le linter ESLint et --tailwind Tailwind CSS ;
  • --app choisit l'App Router, et --no-src-dir garde le code dans app/, sans dossier src/ en plus ;
  • --no-cache-components désactive Cache Components ;
  • --agents-md ajoute le fichier AGENTS.md avec des instructions pour les agents ;
  • --no-agent-feedback désactive la préparation par les agents d'avis anonymes sur Next.js ;
  • --use-npm installe les paquets avec npm.

Le préfixe --no- inverse l'option par défaut, et la documentation de l'assistant le montre avec l'exemple --no-ts. Il n'y a pas d'option pour le bundler, car Turbopack, le bundler de Next.js, est utilisé par défaut. Agent feedback est de toute façon désactivé quand on passe des options, mais nous l'écrivons explicitement, pour que la commande dise tout toute seule.

Pourquoi sans Cache Components

Cache Components est un nouveau modèle de cache dans Next.js : la page est préparée d'avance par défaut, et tout ce qui dépend d'une requête précise doit être enveloppé dans <Suspense> ou marqué pour être mémorisé. Depuis la version 16.4, l'assistant active ce modèle dans les réglages recommandés (état en novembre 2026).

Les exemples des lieux suivants sont écrits dans le modèle sans Cache Components. La page d'un seul post dans le clone de Twitter lit par exemple le numéro dans l'adresse tout en haut du composant, comme cette simple page de navire. params désigne les paramètres de l'adresse, et PageProps est un type que Next.js prépare pour chaque page :

export default async function ShipPage({ params }: PageProps<"/navires/[id]">) {
  const { id } = await params;
  return <h1>Navire {id}</h1>;
}

Dans un projet avec Cache Components, npm run build s'interrompt sur cette page avec le message « Next.js encountered uncached or runtime data during prerendering ». Sans Cache Components, la même page se construit sans erreur comme page dynamique. L'équipe Next.js annonce que, dans la version 17, ce modèle deviendra le modèle par défaut, donc nous y reviendrons le moment venu. Aujourd'hui, nous le désactivons en connaissance de cause.

Ce qu'a affiché l'assistant

Après ton accord, l'assistant travaille environ une minute. Au début, il affiche les options que tu n'as pas données et les valeurs qu'il a retenues pour elles :

Using defaults for unprovided options:

  --no-react-compiler     No React Compiler (use --react-compiler for React Compiler)
  --import-alias          "@/*"

React Compiler reste désactivé, et l'alias d'import @/* te permettra d'écrire dans les imports @/app/... au lieu de chemins pleins de points. Ensuite, l'assistant installe les paquets, crée le dépôt Git et fait un premier commit « Initial commit from Create Next App ». Tu reconnais la fin à la ligne Success! Created krakens-call. Les avertissements de npm sur un paquet obsolète et sur des vulnérabilités sont une information, pas une erreur. N'accepte pas npm audit fix --force : npm lui-même écrit que cette commande introduit des changements qui cassent la compatibilité.

Où Claude travaille maintenant

Le projet est né dans le sous-dossier krakens-call, et la session de Claude travaille toujours un dossier plus haut, dans projets. Les prochaines demandes doivent aller dans le projet, donc déplace le port d'attache : ferme la session avec la commande /exit, ouvre dans Cursor le dossier krakens-call (File, Open Folder) et lance claude dans un nouveau terminal. Si tu préfères rester dans le même terminal, tape après /exit :

cd krakens-call && claude

cd amène le terminal dans le dossier du projet, et && de la leçon 0_3 ne lance claude que si le déplacement a réussi. Vérifie le dossier de travail au-dessus du champ de saisie : le chemin doit se terminer par krakens-call.

Ce qui est apparu : on lit dans Cursor

L'arborescence à gauche montre ce projet. J'omets le dossier node_modules/, le dossier .next/ qui apparaît après le premier build, et les images dans public/ :

krakens-call/
├── app/
│   ├── favicon.ico
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx
├── public/
├── .gitignore
├── AGENTS.md
├── README.md
├── eslint.config.mjs
├── next-env.d.ts
├── next.config.ts
├── package-lock.json
├── package.json
└── tsconfig.json

Le dossier app/ est l'App Router : chaque fichier page.tsx à l'intérieur est une page distincte. public/ contient les fichiers accessibles directement à l'adresse du site, par exemple des images. Remarque aussi ce qui manque : un fichier CLAUDE.md, un fichier tailwind.config et un fichier postcss.config.mjs. Tailwind 4 se règle dans le CSS, nous le verrons dans la leçon suivante.

Ouvre app/page.tsx. C'est la page d'accueil, c'est-à-dire l'adresse /. Le composant Home renvoie ce qui s'affiche dans le navigateur, et en abrégé, il ressemble à ceci :

export default function Home() {
  return (
    <div className="flex flex-col flex-1 items-center justify-center bg-zinc-50 font-sans dark:bg-black">
      <main className="flex flex-1 w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
        {/* logo Next.js, titre et liens */}
      </main>
    </div>
  );
}

export default function dit à Next.js que cette fonction est une page. Les longues suites dans className sont des classes Tailwind, exactement celles que Claude écrira pour toi ; tu apprendras à les lire dans la leçon suivante. Dans le fichier complet, il y a aussi le titre « To get started, edit the page.tsx file. ».

app/layout.tsx est le cadre commun de toutes les pages, la coque dans laquelle passent les ponts successifs. Tu y verras l'objet metadata, décrit par le type Metadata, et la fonction RootLayout, qui reçoit children, décrit par le type LayoutProps :

export const metadata: Metadata = {
  title: "Create Next App",
  description: "Generated by create next app",
};

export default function RootLayout({ children }: LayoutProps<"/">) {
  return (
    <html
      lang="en"
      className={`${geistSans.variable} ${geistMono.variable} h-full antialiased`}
    >
      <body className="min-h-full flex flex-col">{children}</body>
    </html>
  );
}

metadata est le titre et la description de la page, visibles entre autres sur l'onglet du navigateur. children est le contenu de la page courante, que le layout place dans <body>, et geistSans et geistMono sont les polices Geist chargées en haut du fichier.

Voici maintenant le fichier qui confirme que les options ont fonctionné. Ouvre next.config.ts, c'est-à-dire la configuration de Next.js :

import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  /* config options here */
  turbopack: {
    rules: {
      "*.css": {
        loaders: ["@tailwindcss/turbopack"],
        as: "*.css",
      },
    },
  },
};

export default nextConfig;

La seule option définie est une règle de Turbopack qui fait passer les fichiers CSS par Tailwind. Il n'y a pas ici la ligne cacheComponents: true ni partialPrefetching: true, qu'ajoutent les réglages recommandés, ni de bloc experimental avec agentFeedback. L'absence de ces lignes prouve que les deux options --no- ont fonctionné.

Enfin AGENTS.md, le fichier d'instructions pour les agents tels que Claude Code. L'assistant y a écrit un bloc avec le titre « This is NOT the Next.js you know ». Le bloc prévient l'agent que cette version de Next.js diffère de ce que le modèle a pu apprendre, et lui ordonne de lire la documentation du dossier node_modules/next/dist/docs/ avant d'écrire du code. Claude Code lit AGENTS.md quand le projet n'a pas de fichier CLAUDE.md, donc cette consigne arrive dans chaque session de ce dossier. Le bloc reprend aussi le fonctionnement de next dev, donc ne le supprime pas. Les règles propres à ton projet, tu les ajouteras plus tard dans ce lieu.

La preuve plutôt que la parole : npm run build

La dernière phrase de la demande ordonnait à Claude de construire le projet. Dans le résultat, tu cherches des lignes comme celles-ci :

▲ Next.js 16.4.6 (Turbopack)
✓ Compiled successfully in 1562ms
  Running TypeScript ...
  Finished TypeScript in 803ms ...
✓ Generating static pages using 5 workers (4/4) in 220ms

Route (app)
┌ ○ /
└ ○ /_not-found

○  (Static)  prerendered as static content

« Compiled successfully » veut dire que le code s'est compilé, et les lignes sur TypeScript, que les types concordent. Le tableau Route énumère les pages : / est la page d'accueil, /_not-found est la page d'erreur 404 ajoutée par Next.js, et le rond indique une page préparée d'avance. Le build ne lance cependant pas le linter, donc les erreurs détectées par ESLint y passent inaperçues. Le lint est une commande à part, npm run lint, qui, quand le code est propre, n'affiche rien d'autre que son nom. Désormais, tu demandes les deux vérifications après chaque changement important.

Le site dans le navigateur et le Fast Refresh

Le serveur de développement, tu le lances toi-même, dans un deuxième terminal de Cursor (Control+Shift+` sur Mac, Ctrl+Shift+` sous Windows et Linux). Conseil du capitaine : c'est plus commode ainsi, car le serveur tourne tant que tu ne l'arrêtes pas, et tu veux avoir ses messages sous les yeux. Dans le dossier krakens-call, tape npm run dev et attends ce résultat :

▲ Next.js 16.4.6 (Turbopack)
- Local:         http://localhost:3000
- Network:       http://192.168.1.10:3000
✓ Ready in 170ms

Ouvre dans le navigateur l'adresse de la ligne Local : tu verras la page de démarrage de Next.js. L'adresse Network ne fonctionne que dans ton réseau domestique.

Voici maintenant le premier changement dans le projet, dans la session de Claude :

Demande pour Claude Code :

Dans @app/page.tsx, remplace le texte du titre h1 par « Ohé, les
pirates ! » et ne change rien d'autre.

Quand Claude a enregistré le fichier, regarde le navigateur : le titre change tout seul, sans actualisation. Dans Next.js, cette fonction s'appelle Fast Refresh, couramment hot reload. Dans Cursor, ouvre Source Control : dans la liste des changements, il n'y a que app/page.tsx, et le diff montre l'ancien et le nouveau titre. Si un autre fichier a changé, Claude a fait plus que ce que tu avais demandé.

L'assistant a déjà fait le premier commit, donc celui-ci sera la deuxième entrée du journal de bord. Écris à Claude « Fais un commit avec une description de ce changement » et lis les commandes avant d'accepter, comme dans la leçon 0_6.

La revue du capitaine

Avant de considérer le navire comme mis à l'eau, vérifie quatre choses :

  1. next.config.ts ne contient pas cacheComponents: true. S'il en contient, l'assistant a reçu d'autres options que celles que tu avais demandées.
  2. Le dossier de travail de la session se termine par krakens-call, et non par projets.
  3. Le résultat du build, tu l'as vu de tes propres yeux, et pas seulement dans le résumé de Claude.
  4. package.json ne contient que les paquets de l'assistant : rien n'a été installé en plus sans que tu l'aies demandé.

Erreurs typiques de l'agent dans cette tâche : il lance l'assistant avec --yes, qui prend les réglages enregistrés auparavant ou les réglages recommandés, et dans ceux-ci Cache Components est activé ; ou il crée le projet dans le mauvais dossier, par exemple à l'intérieur de navire_pirate. Tu attrapes les deux dans la demande d'accord, si tu lis la commande et le dossier avant de cliquer sur Yes.

Étape suivante

Le projet est debout, le site fonctionne, et le journal de bord a deux entrées. Dans la leçon suivante, Claude construira la première section du site Kraken's Call avec Tailwind CSS, et toi, tu apprendras à lire ses classes. Dans l'éditeur ci-dessous, tu verras une page simple et un layout dans le style de l'App Router.

Retiens : un bon ordre au départ du voyage épargne des semaines de réparation de coque.

Code de cette leçon : page.tsx
// Next.js 16 App Router - Structure de page de base

export default function Home() {
  return (
    <main className="min-h-screen p-24">
      <div className="max-w-5xl mx-auto">
        <h1 className="text-4xl font-bold mb-8">
          Bienvenue dans Next.js 16 !
        </h1>

        <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
          <div className="border border-gray-300 p-6 rounded-lg">
            <h2 className="text-2xl font-semibold mb-4">
              App Router
            </h2>
            <p className="text-gray-600">
              Ceci est une page dans le dossier app/. Chaque fichier page.tsx est une page distincte.
            </p>
          </div>

          <div className="border border-gray-300 p-6 rounded-lg">
            <h2 className="text-2xl font-semibold mb-4">
              Server Components
            </h2>
            <p className="text-gray-600">
              Par défaut, tous les composants de l'App Router sont des Server Components.
            </p>
          </div>

          <div className="border border-gray-300 p-6 rounded-lg">
            <h2 className="text-2xl font-semibold mb-4">
              TypeScript
            </h2>
            <p className="text-gray-600">
              Next.js intègre le support de TypeScript out-of-the-box.
            </p>
          </div>

          <div className="border border-gray-300 p-6 rounded-lg">
            <h2 className="text-2xl font-semibold mb-4">
              Tailwind CSS
            </h2>
            <p className="text-gray-600">
              Stylisation via des classes utilitaires directement dans le JSX.
            </p>
          </div>
        </div>
      </div>
    </main>
  );
}

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. Dans quel dossier se trouvent les pages avec l'App Router de Next.js ?

  2. 2. Quelle commande démarre le serveur de développement dans Next.js ?

  3. 3. Qu'est-ce que Next.js ?

  4. 4. Qu'est-ce que le fichier app/page.tsx dans le App Router de Next.js ?

  5. 5. De quoi le fichier app/layout.tsx est-il responsable ?

  6. 6. Que signifie le Fast Refresh (couramment appelé hot reload) dans Next.js ?

  7. 7. Quel routeur Next.js est recommandé pour les nouveaux projets ?

Tâches pratiques dans le jeu

  • Éditeur de code

    Demande à l'IA de Cursor comment créer un projet Next.js et écris dans le fichier commands.sh la commande npx que tu reçois.

  • Tri vertical

    Range dans le bon ordre les étapes qui te font voir dans le navigateur, sans actualiser, un changement fait par Claude :

  • Clique dans l'ordre

    Construis la commande qui démarre le serveur de développement :

  • Tri vertical

    Range dans le bon ordre les étapes de création d'un projet avec Claude Code, de la demande à la preuve :

  • Tri horizontal

    Range dans le bon ordre la commande qui amène le terminal dans le nouveau projet et y lance Claude Code (de gauche à droite) :

  • Clique dans l'ordre

    Construis la commande avec laquelle Claude vérifie que le projet se construit :

  • Tri horizontal

    Ordonne les parties de l'adresse locale de l'application Next.js (de gauche à droite) :

  1. QuestionQuiz : App Router de Next.js
  2. QuestionQuiz : Serveur de développement
  3. Exercice de codePratique : Créer un projet Next.js
  4. Remets dans l'ordreOrdre : le Fast Refresh en pratique
  5. Clique dans l'ordreOrdre : la commande pour démarrer le serveur
  6. QuestionQuiz : qu'est-ce que Next.js
  7. Remets dans l'ordreOrdre : de la demande à la preuve
  8. QuestionQuiz : le fichier page.tsx
  9. Remets dans l'ordreOrdre : la session dans le dossier du projet
  10. QuestionQuiz : la mise en page de l'application
  11. Clique dans l'ordreOrdre : la commande de vérification du build
  12. QuestionQuiz : le Fast Refresh
  13. Remets dans l'ordreOrdre : l'adresse locale de l'application
  14. QuestionQuiz : App Router vs Pages Router

Articles utiles