Cours Vibe coding avec Claude Code · Module 13: Clone de Twitch
Le coffre fermé : un conteneur Next.js avec Claude Code
Dans cette leçon9
Le clone fonctionne chez toi. Le bosco clone le dépôt sur son portable, installe les dépendances et lance le build, et au bout d'un moment il voit une erreur que tu n'as jamais vue : il a une autre version de Node.js et un autre système. Le serveur sur lequel le clone doit un jour tourner en aura encore d'autres. Chaque différence de ce genre est un récif que le navire ne heurte qu'en arrivant dans un port étranger. Il te faut un coffre qui arrive partout dans le même état. Dans le monde des développeurs, il s'appelle un conteneur.
Trois mots pour commencer. Une image est la cargaison emballée : le système, Node.js, les dépendances et l'application construite. Un conteneur est une image lancée, isolée du reste de l'ordinateur. Le Dockerfile est la recette selon laquelle Docker construit l'image étape par étape. Docker, tu l'installes toi-même, en suivant la page docs.docker.com/get-docker. La documentation de Next.js conseille, sur Mac et Windows, de travailler au quotidien avec npm run dev, parce que c'est plus rapide, et de garder le conteneur pour la production : le coffre, tu l'emballes pour le voyage, pas pour travailler à la table des cartes.
Ce que tu vas apprendre
- commander un conteneur à Claude Code en partant de la documentation actuelle, et non de la mémoire de l'agent ;
- lire un Dockerfile à plusieurs étapes et dire ce qui arrive dans l'image finale ;
- garder le fichier
.envhors du dépôt et hors de l'image ; - verrouiller une commande Docker destructrice avec une règle
denyet savoir où s'arrête sa protection ; - dire où le mode
bypassPermissionsa du sens, et où jamais.
Demande pour Claude Code
L'agent connaît Docker par des textes vieux de plusieurs années, et les exemples du web vieillissent plus vite que les images Node.js. C'est pourquoi la première phrase de la demande lui fait lire une source à jour, et la deuxième lui fait choisir et justifier le mode de build. L'étape touche quatre fichiers : tu commences donc par un plan, comme dans la leçon 1_6. Les commandes Docker, tu les lanceras toi-même, pour une raison que tu découvriras plus bas.
Demande pour Claude Code :
/plan Conteneurise l'application. Lis d'abord la page
https://nextjs.org/docs/app/getting-started/deploying (section Docker)
et l'exemple with-docker vers lequel elle renvoie, puis écris quel mode
de sortie du build tu choisis et pourquoi. Ensuite : un Dockerfile à
plusieurs étapes (dépendances, build, lancement) sur l'image du
Node.js LTS actuel, un .dockerignore et un compose.yaml. Lis les
variables d'environnement dans le fichier .env, qui n'est ni dans le
dépôt ni dans l'image.
Ce sera fini quand : npm run build crée .next/standalone/server.js.
Ne lance pas les commandes docker, je le ferai moi-même.Dans le plan, vérifie une chose : le mode de sortie du build. Si Claude ne le mentionne pas ou le choisit sans justification, réponds "No, keep planning" et pose-lui la question directement.
Ce que Claude a écrit : le mode standalone
La première modification est la plus petite et la plus importante. Ouvre next.config.ts dans Cursor, et tu verras une nouvelle ligne au début de la configuration :
// next.config.ts
const nextConfig: NextConfig = {
output: "standalone",
// reste de la configuration inchangé
};Avec cette option, npm run build rassemble dans le dossier .next/standalone seulement les fichiers nécessaires pour lancer l'application, plus un petit serveur server.js. Chez nous, le dossier pesait 41 Mo, et le node_modules complet 517 Mo. L'option ne change ni l'apparence de la page ni le fonctionnement de npm run dev. Sans elle, le build passe aussi, mais le dossier .next/standalone n'existe tout simplement pas : nous l'avons vérifié, et le Dockerfile plus bas n'aurait alors rien à copier.
Ce que Claude a écrit : le Dockerfile étape par étape
Ouvre Dockerfile. Chaque FROM commence une nouvelle étape (stage), et le mot après AS lui donne un nom. L'image finale, c'est seulement la dernière étape ; les précédentes sont comme l'atelier du port, qui reste à terre. Les deux premières étapes :
FROM node:26-slim AS base
WORKDIR /app
FROM base AS deps
COPY package.json package-lock.json ./
RUN npm cibase choisit l'image Node.js et le dossier de travail /app, et les étapes suivantes héritent des deux. Le tag 26-slim est le Node.js LTS actuel (état en novembre 2026) dans une variante allégée. L'exemple de Next.js choisit slim plutôt qu'alpine, parce que slim a la bibliothèque standard du système Linux et supporte mieux les paquets npm qui ont des parties natives. deps copie seulement les deux fichiers qui listent les dépendances et lance npm ci, c'est-à-dire l'installation exactement selon package-lock.json. Quand tu modifies un composant et pas les dépendances, Docker reprend cette étape dans son cache et ne réinstalle pas tout.
La troisième étape construit l'application :
FROM base AS builder
COPY /app/node_modules ./node_modules
COPY . .
RUN npm run buildCOPY --from=deps reprend node_modules de l'étape précédente, et COPY . . tout le code du projet. C'est l'étape la plus lourde : elle a les dépendances complètes, le code source et le résultat du build. Rien n'en arrive dans l'image finale, sauf ce que désigne la dernière étape, que voici :
FROM base AS runner
ENV NODE_ENV=production
ENV PORT=3000
ENV HOSTNAME=0.0.0.0
COPY /app/public ./public
COPY /app/.next/standalone ./
COPY /app/.next/static ./.next/static
EXPOSE 3000
CMD ["node", "server.js"]runner ne reçoit que le résultat du build. Le server.js du mode standalone lit le port dans la variable PORT, et l'adresse dans HOSTNAME. La valeur 0.0.0.0 signifie "écoute sur toutes les adresses du conteneur", comme dans l'exemple de Next.js. EXPOSE ne fait que décrire le port, il n'ouvre rien. Les lignes les plus faciles à manquer sont celles de public et de .next/static, car le dossier standalone ne les contient pas. Nous avons lancé server.js sans elles : la page a répondu 200, mais le fichier CSS et la vidéo de la traversée ont reçu 404.
Ce que Claude a écrit : .dockerignore et compose.yaml
COPY . . copie tout le dossier du projet, c'est-à-dire le contexte de build, sauf ce qu'exclut .dockerignore. Ouvre ce fichier et lis-le depuis le haut :
node_modules
.next
.git
.env
.env*.localnode_modules et .next sont de toute façon recréés dans le conteneur, et .git est un historique dont l'image n'a pas besoin. Les deux dernières lignes sont les plus importantes. L'exemple de Next.js prévient qu'en mode standalone, un fichier de variables présent dans le contexte arrive dans .next/standalone, et de là dans l'image, où quiconque télécharge l'image pourra le lire.
Passons à compose.yaml. Docker Compose est un outil qui, en une seule commande, construit l'image et lance le conteneur avec les ports et les variables décrits dans le fichier :
services:
app:
build: .
ports:
- "3000:3000"
env_file: .envbuild: . construit l'image à partir du Dockerfile de ce dossier. "3000:3000" relie le port 3000 de ton ordinateur au port 3000 du conteneur. env_file charge les variables de .env seulement au démarrage du conteneur : les valeurs ne sont donc ni dans le dépôt (la ligne .env* du .gitignore de create-next-app), ni dans l'image. Le clone n'a pas encore de secrets, alors crée un .env vide ; sans lui, docker compose config nous a répondu env file ... not found. L'ancien nom docker-compose.yml fonctionne aussi, mais la documentation de Docker désigne compose.yaml comme le nom par défaut.
Le fichier n'a pas la clé version que tu vois dans les vieux tutoriels. La documentation de Compose dit qu'elle est obsolète et seulement informative. Sur un fichier avec version: '3.8', la commande docker compose config a affiché chez nous un avertissement : l'attribut est obsolète et sera ignoré (is obsolete, it will be ignored).
La serrure du coffre : une règle deny pour Docker
Docker a des commandes qui nettoient trop. Selon la documentation, docker system prune -a supprime tous les conteneurs, réseaux et images inutilisés ainsi que le cache de build. Elle demande une confirmation, mais l'option -f saute la question. Si ton ordinateur garde des images d'autres projets, elles ont disparu après un tel nettoyage. La règle deny, tu la connais depuis la leçon 8_4, où elle a verrouillé .env. Demande à Claude une règle pour Docker dans .claude/settings.json, avec les règles pour .env de cette leçon-là :
{
"permissions": {
"deny": ["Bash(docker system prune *)", "Read(./.env)", "Read(./.env.*)"]
}
}L'espace avant l'astérisque fait que la règle attrape docker system prune avec n'importe quelles options. La documentation de Claude Code dit que les règles deny bloquent dans tous les modes, y compris auto et bypassPermissions. Vérifie-le avec la demande "Lance docker system prune -a" : Claude Code ne lancera pas la commande, et Claude verra un refus dû à la règle. Si tu demandes de façon plus générale, par exemple "nettoie les images inutilisées", Claude peut choisir docker image prune -a, que cette règle ne connaît pas. Le nettoyage reste donc ta décision, dans ton propre terminal.
La serrure a pourtant ses limites. La documentation des permissions dit clairement qu'une règle Bash compare le texte de la commande, et qu'elle n'est donc pas une frontière de sécurité : la même commande écrite autrement, par exemple dans sh -c '...' ou avec le chemin complet du programme, échappe à la règle. Avec Read(./.env), c'est pareil. Tu sais depuis la leçon 8_4 qu'elle ne couvre pas les commandes qui lisent le fichier sans le nommer. Chez nous, docker compose config a affiché en clair la valeur de .env, alors que la règle était en place. Le résultat d'une commande lancée par Claude arrive dans la conversation, et c'est pour cela que tu lances Docker toi-même. Seul le sandbox (/sandbox), qui limite les commandes au niveau du système, apporte une vraie isolation.
Où bypassPermissions a du sens
Le mode bypassPermissions de la leçon 0_4 approuve presque tout sans demander. La documentation de Claude Code le réserve exclusivement aux environnements isolés : des conteneurs et des machines virtuelles où Claude ne peut pas nuire à ton ordinateur. Attention à la confusion : le conteneur de l'application que tu viens de construire n'est pas cet endroit, car Claude Code n'y travaille pas. Il s'agit d'un conteneur dans lequel tourne Claude Code lui-même, par exemple un dev container, c'est-à-dire un environnement de développement décrit par le fichier .devcontainer/devcontainer.json. La documentation de Claude Code propose une configuration toute prête pour cela. Même là, Claude modifie les fichiers du projet que tu vois sur ton disque et va partout où le réseau du conteneur le laisse aller, et les règles deny continuent de s'appliquer. Sur ton propre ordinateur, hors d'un tel conteneur, tu n'actives jamais bypassPermissions.
La revue du capitaine
- Les secrets hors du coffre.
.envfigure dans.dockerignore, etgit statusne le montre pas. - Une cargaison légère. L'étape
runnern'a niCOPY --from=depsniCOPY . ., mais elle apublicet.next/static. - Un Node.js à jour. Le tag de l'image est le LTS actuel indiqué sur nodejs.org, et non la version d'un tutoriel vieux de plusieurs années que l'agent aime écrire de mémoire.
- Un Compose sans lest. Pas de clé
versionni de mots de passe sousenvironment.
L'erreur typique d'un agent, ce sont des identifiants écrits directement dans le fichier Compose, par exemple DATABASE_URL=postgresql://capitaine:secret@db:5432/deck sous environment, ou un output: "standalone" oublié, à cause duquel l'étape runner n'a rien à copier. La vérification, tu la fais dans ton propre terminal dans Cursor : npm run build et ls .next/standalone/server.js, puis docker compose config, qui ne doit afficher aucun avertissement, et docker compose up --build. Quand le conteneur est lancé, ouvre localhost:3000 : la page doit avoir ses styles, et /channel/captain-redbeard doit jouer la traversée. Tu arrêtes le conteneur avec la commande docker compose down.
Étape suivante
Quand la revue passe, demande un commit "Conteneur : standalone, Dockerfile, compose et règle deny". Puis une petite étape, que l'exemple de Next.js fait pour la sécurité : l'application dans le conteneur ne devrait pas tourner en tant que root, c'est-à-dire administrateur du système.
Demande pour Claude Code :
Lance l'application dans l'étape runner en tant qu'utilisateur node,
comme l'exemple with-docker de la documentation de Next.js. Montre
le diff du Dockerfile.Dans le diff, cherche trois choses de l'exemple : la ligne USER node avant CMD, l'option --chown=node:node lors de la copie des fichiers dans runner, et un dossier .next qui appartient à cet utilisateur, car le serveur y écrit le cache des pages. L'image node a déjà cet utilisateur, donc personne n'a à le créer. Quand le processus n'est pas root, une faille dans l'application donne moins de pouvoir sur le conteneur. Dans l'éditeur ci-dessous t'attend la revue du capitaine en miniature : la version de l'agent du fichier Compose et du .dockerignore, où le vérificateur signalera version, le mot de passe dans le fichier et l'absence de .env.
Retiens ceci : un bon coffre a une serrure, et un bon capitaine sait quelles clés il confie à l'agent et lesquelles il garde sur lui.
Code de cette leçon : App.tsx
// La revue du capitaine en miniature : vérificateur du fichier Compose et du .dockerignore
import { useState } from 'react';
interface Finding {
ok: boolean;
title: string;
detail: string;
}
const AGENT_COMPOSE = [
"version: '3.8'",
'services:',
' app:',
' build: .',
' ports:',
' - "3000:3000"',
' environment:',
' - DATABASE_URL=postgresql://capitaine:secret@db:5432/deck',
].join('\n');
const AGENT_IGNORE = ['node_modules', '.next', '.git'].join('\n');
const GOOD_COMPOSE = [
'services:',
' app:',
' build: .',
' ports:',
' - "3000:3000"',
' env_file: .env',
].join('\n');
const GOOD_IGNORE = ['node_modules', '.next', '.git', '.env', '.env*.local'].join('\n');
// Identifiants dans l'adresse (utilisateur:motdepasse@) ou variable au nom de secret avec une valeur écrite
const CREDENTIALS_IN_URL = /:\/\/[^\s:/@]+:[^\s@]+@/;
const SECRET_VALUE = /(PASSWORD|SECRET|TOKEN|API_KEY)\s*[:=]\s*\S+/i;
function lines(text: string): string[] {
return text.split('\n').map((line) => line.trim());
}
export function reviewCrate(compose: string, dockerignore: string): Finding[] {
const findings: Finding[] = [];
const hasVersion = /^\s*version\s*:/m.test(compose);
findings.push({
ok: !hasVersion,
title: 'La clé version',
detail: hasVersion
? "Obsolète : Compose l'ignore et affiche un avertissement. Supprime cette ligne."
: 'Pas de clé version, comme le recommande la documentation de Compose.',
});
const leaked = compose.split('\n').find((line) => CREDENTIALS_IN_URL.test(line) || SECRET_VALUE.test(line));
findings.push({
ok: !leaked,
title: 'Mots de passe dans le fichier',
detail: leaked
? 'Cette ligne part avec le dépôt chez quiconque le clone : ' + leaked.trim() + '. Déplace la valeur dans .env.'
: 'Le fichier ne contient ni mots de passe ni jetons.',
});
const usesEnvFile = /^\s*env_file\s*:/m.test(compose);
findings.push({
ok: usesEnvFile,
title: 'Variables depuis .env',
detail: usesEnvFile
? "env_file charge les variables au démarrage du conteneur : les valeurs ne sont donc ni dans le dépôt ni dans l'image."
: "Pas d'env_file : il faut fournir les variables autrement, et la tentation est de les écrire directement dans le fichier.",
});
const ignored = lines(dockerignore);
const ignoresEnv = ignored.includes('.env') || ignored.includes('.env*');
findings.push({
ok: ignoresEnv,
title: '.env dans .dockerignore',
detail: ignoresEnv
? "COPY . . ignorera .env, donc le fichier n'arrivera pas dans l'image."
: "COPY . . copiera .env depuis le contexte, et le mode standalone le fera passer dans l'image.",
});
const port = compose.match(/-\s*"(\d+):(\d+)"/);
findings.push({
ok: Boolean(port),
title: 'Port',
detail: port
? 'Le port ' + port[1] + ' de ton ordinateur mène au port ' + port[2] + ' du conteneur.'
: 'Pas de mapping de port entre guillemets, par exemple "3000:3000".',
});
return findings;
}
export default function App() {
const [compose, setCompose] = useState(AGENT_COMPOSE);
const [dockerignore, setDockerignore] = useState(AGENT_IGNORE);
const findings = reviewCrate(compose, dockerignore);
const problems = findings.filter((f) => !f.ok).length;
return (
<div className="min-h-screen space-y-4 bg-zinc-950 p-4 text-zinc-100">
<h1 className="text-xl font-bold">La revue du capitaine : le coffre</h1>
<div className="flex flex-wrap gap-2">
<button
type="button"
onClick={() => {
setCompose(AGENT_COMPOSE);
setDockerignore(AGENT_IGNORE);
}}
className="rounded bg-zinc-700 px-3 py-2 text-sm"
>
Version de l'agent
</button>
<button
type="button"
onClick={() => {
setCompose(GOOD_COMPOSE);
setDockerignore(GOOD_IGNORE);
}}
className="rounded bg-purple-600 px-3 py-2 text-sm font-semibold"
>
Version après la revue
</button>
</div>
<div className="grid gap-3 sm:grid-cols-2">
<label className="block text-sm">
compose.yaml
<textarea
value={compose}
onChange={(e) => setCompose(e.target.value)}
rows={9}
spellCheck={false}
className="mt-1 block w-full rounded bg-zinc-900 p-2 font-mono text-xs"
/>
</label>
<label className="block text-sm">
.dockerignore
<textarea
value={dockerignore}
onChange={(e) => setDockerignore(e.target.value)}
rows={9}
spellCheck={false}
className="mt-1 block w-full rounded bg-zinc-900 p-2 font-mono text-xs"
/>
</label>
</div>
<p role="status" className={problems ? 'font-semibold text-amber-400' : 'font-semibold text-emerald-400'}>
{problems ? 'À corriger : ' + problems : 'Le coffre est prêt pour le voyage'}
</p>
<ul className="space-y-2 text-sm">
{findings.map((f) => (
<li key={f.title} className="rounded border border-zinc-800 p-2">
<strong className={f.ok ? 'text-emerald-400' : 'text-red-400'}>{f.ok ? 'OK' : 'Corrige'}</strong> {f.title}
<p className="text-zinc-400">{f.detail}</p>
</li>
))}
</ul>
</div>
);
}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. Pourquoi conteneurise-t-on une application Next.js avec Docker ?
2. Quelle étape du Dockerfile de la leçon a le node_modules complet et le code source, et laquelle ne reçoit que le résultat du build ?
Tâches pratiques dans le jeu
- Tri vertical
Ordonne les étapes du Dockerfile depuis le début du fichier :
- Tri horizontal
Ordonne le mapping de port dans compose.yaml (une ligne) : "3000:3000"