Cours Vibe coding avec Claude Code · Module 10: Clone de TikTok
Sons et enregistreur : deux sessions Claude Code en même temps dans des worktrees
Dans cette leçon12
Le feed joue mais l'équipage en veut plus : filmer quinze secondes d'aventure et y glisser un chant de marin. Ce sont deux fonctions : une bibliothèque de sons, où tu choisis le chant, et un enregistreur qui allume la caméra. Elles ne dépendent pas l'une de l'autre et ne partagent aucun fichier, elles peuvent donc naître en même temps, dans deux sessions Claude Code, comme deux chaloupes mises à l'eau depuis le même navire.
Ce que tu vas apprendre
- reconnaître quand deux fonctions peuvent se construire en parallèle, et quand il vaut mieux procéder l'une après l'autre ;
- lancer deux sessions
claude -wet regarder dans Cursor les deux dossiers séparés ; - lire l'enregistreur : la caméra après un clic, une limite qui fonctionne vraiment, la caméra coupée à la sortie ;
- fusionner les deux branches dans
mainet ranger derrière les chaloupes.
Les worktrees en un paragraphe
Un worktree Git est un dossier de travail séparé, avec ses propres fichiers et sa propre branche, qui partage le même historique que le dossier principal. Selon la documentation de Claude Code, claude -w <nom> (le nom complet de l'option est --worktree) crée un tel dossier dans .claude/worktrees/<nom>/ sur une nouvelle branche worktree-<nom> et y lance une session. Deux sessions dans deux worktrees modifient deux copies distinctes des fichiers : elles ne s'écrasent donc pas mutuellement. Elles ne se rencontrent qu'à la fusion des branches.
Quand ne pas travailler en parallèle
L'isolation s'arrête à la fusion. Si les deux sessions modifient le même passage du même fichier, Git ne devine pas quelle version est la bonne. Chez nous, deux branches qui avaient ajouté des fonctions différentes à la fin de lib/format.ts ont fini la fusion ainsi :
Auto-merging lib/format.ts
CONFLICT (content): Merge conflict in lib/format.ts
Automatic merge failed; fix conflicts and then commit the result.C'est pourquoi tu ne lances en parallèle que des tâches qui touchent des fichiers différents, et tu fais les tâches dépendantes l'une après l'autre. L'éditeur de clips de la leçon 9_3 a besoin d'un enregistrement prêt, venant de l'enregistreur : il attend donc. La documentation rappelle aussi que plusieurs sessions à la fois consomment bien plus de tokens qu'une seule.
Avant d'appareiller
Commence par une liste propre dans Source Control et un commit avec le feed. Puis trois points :
- Le dossier des worktrees hors de Git. La documentation conseille d'ajouter
.claude/worktrees/au.gitignore, pour que les copies du projet ne traînent pas dans le dossier principal comme des fichiers non suivis. Demande-le à Claude et fais un commit. - D'abord un push. Quand le projet a un dépôt distant, par exemple sur GitHub, un nouveau worktree part de la branche par défaut de ce dépôt, et non de ton dernier commit local. Chez nous, un worktree créé avant le push n'avait pas le dernier commit de
main. Envoie doncmain(push) avant d'appareiller. Un projet sans dépôt distant part de ton commit actuel. - Les secrets. Un worktree est un checkout tout neuf : il n'a pas les fichiers du
.gitignore, comme.env.local. Treasure Reels n'en a pas encore. Quand il en aura, tu les ajouteras à un fichier.worktreeincludedans le dossier du projet, et Claude les copiera dans chaque nouveau worktree.
Deux sessions
Dans Cursor, ouvre un second terminal avec le bouton + du panneau de terminal. Dans le premier terminal, lance la session des sons :
claude -w sonsDans le second terminal, pareil avec un autre nom : claude -w enregistreur. Le nom après -w est le nom du dossier et la fin de la branche : choisis-en donc un court et descriptif. Un worktree tout neuf n'a pas non plus de dossier node_modules : chez nous, ls node_modules a répondu No such file or directory. Voilà pourquoi les deux demandes commencent par l'installation des dépendances.
Demande pour Claude Code (session sons) :
Tu travailles dans un worktree séparé sur la bibliothèque de sons de
Treasure Reels. D'abord, installe les dépendances (npm install). Ensuite :
un type SoundDetails dans types/sound.ts qui étend Sound de
@types/video.ts (ne le copie pas), les données dans lib/sounds.ts
(fichiers de public/sounds), une page app/sons/page.tsx avec une
recherche par titre et les onglets "Tendances" et "Tous", une écoute
sur la carte : un seul son joue à la fois. Ne touche pas à
app/layout.tsx, app/page.tsx ni à components/ForYouFeed.tsx. Pour finir,
lint, types, tests et build, puis un commit.La demande de l'enregistreur va dans le second terminal. Elle est plus longue, car l'enregistreur a plus d'endroits où quelque chose peut rester allumé pour toujours ou ne jamais s'arrêter.
Demande pour Claude Code (session enregistreur) :
Tu travailles dans un worktree séparé sur l'enregistreur de Treasure
Reels. D'abord, installe les dépendances (npm install). Fais
components/VideoRecorder.tsx et la page app/enregistrer/page.tsx : la
caméra et le micro seulement après un clic sur "Activer la caméra",
aperçu en direct, enregistrement via MediaRecorder avec une limite
maxSeconds (15 par défaut) qui l'arrête toute seule, une barre de
temps, un message en cas de refus d'accès, la caméra coupée quand on
quitte la page, le résultat via onComplete(blob, { durationSec,
mimeType }) avec la vraie durée de l'enregistrement. Choisis le format
avec MediaRecorder.isTypeSupported. Ne touche pas à app/layout.tsx,
app/page.tsx ni à types/video.ts. Ajoute un test avec une fausse
caméra : l'enregistrement se termine tout seul à la limite. Pour finir,
lint, types, tests et build, puis un commit.Les phrases "ne touche pas" tracent la frontière entre les chaloupes : les fichiers communs restent intacts, et tu ajouteras les liens vers les nouvelles pages après la fusion. Chez nous, les deux sessions ont travaillé en même temps, chacune quelques minutes. Toutes deux ont signalé le même souci : dans un worktree neuf, npx tsc --noEmit signale l'erreur Cannot find name 'LayoutProps', parce que les types des routes se trouvent dans le dossier .next, que le checkout n'a pas. Ils disparaissent après npx next typegen ou après le premier build.
Dans Cursor : deux dossiers
Déplie .claude/worktrees/ dans l'arborescence de fichiers. Tu y trouves sons et enregistreur, chacun avec une copie complète du projet. Une modification dans l'un n'apparaît ni dans l'autre ni dans le dossier principal, jusqu'à la fusion. Ouvre .claude/worktrees/sons/types/sound.ts :
import type { Sound } from "@/types/video";
export interface SoundDetails extends Sound {
src: string; // "/sounds/hymne.m4a"
uses: number; // nombre de vidéos enregistrées avec ce son
trending: boolean; // apparaît dans l'onglet "Tendances"
}extends reprend tous les champs de Sound de la leçon 9_1 et en ajoute trois, si bien que le son n'a qu'une seule définition dans tout le projet. L'écoute fonctionne comme le feed : un effet sur playingId lit l'<audio> choisi, et tous les autres sont mis en pause. Claude a aussi réutilisé ce qui avait été dit à propos des références : la fonction ref de la carte renvoie une fonction de nettoyage qui retire le son de la table quand la carte disparaît de la liste.
Ce que Claude a écrit : le format d'enregistrement
Passons à .claude/worktrees/enregistreur/components/VideoRecorder.tsx. Les navigateurs n'enregistrent pas tous dans les mêmes formats : une petite fonction choisit donc le format :
const MIME_CANDIDATES = [
"video/webm;codecs=vp9,opus",
"video/webm;codecs=vp8,opus",
"video/webm",
"video/mp4;codecs=avc1,mp4a.40.2",
"video/mp4",
];
export function pickMimeType(): string | undefined {
if (typeof MediaRecorder === "undefined" || typeof MediaRecorder.isTypeSupported !== "function") {
return undefined;
}
return MIME_CANDIDATES.find((type) => MediaRecorder.isTypeSupported(type));
}MediaRecorder est l'outil intégré au navigateur qui enregistre le flux de la caméra dans un fichier. Selon MDN, isTypeSupported indique si le navigateur sait enregistrer dans un format donné, et le constructeur avec un format qu'il ne connaît pas lance une NotSupportedError. Quand aucun candidat ne convient, la fonction renvoie undefined et le navigateur choisit le format. Le vrai format de l'enregistrement est ensuite donné par la propriété recorder.mimeType, et c'est lui qui arrive dans les métadonnées.
Ce que Claude a écrit : la caméra après un clic
La demande d'accès à la caméra se trouve dans le gestionnaire du bouton, jamais dans le rendu lui-même, comme le micro dans la location 9. Voici son cœur, en abrégé :
try {
const media = await navigator.mediaDevices.getUserMedia({
video: { facingMode: "user" },
audio: true,
});
setStream(media);
} catch (err) {
setError(cameraErrorMessage(err));
}cameraErrorMessage transforme le nom de l'erreur en phrase en français. MDN en décrit trois fréquentes : NotAllowedError en cas de refus, NotFoundError quand il n'y a pas de caméra, et NotReadableError quand une autre application occupe la caméra. La caméra est libérée par le même schéma que le micro de la location 9 : un effet clé sur le flux, dont le nettoyage appelle stop() sur chaque piste. Un effet supplémentaire, à la sortie de la page, coupe un enregistrement en cours sans rendre de résultat.
Ce que Claude a écrit : une limite qui fonctionne
Le chronomètre de l'enregistrement compte le temps depuis un départ mémorisé et appelle lui-même l'arrêt :
timerRef.current = setInterval(() => {
const ms = Date.now() - startedAt;
setElapsed(Math.min(ms / 1000, maxSeconds));
if (ms >= maxSeconds * 1000) stopRecording();
}, 100);La fonction passée à setInterval mémorise les variables du moment où elle a été créée. Celle-ci ne lit que l'heure de départ et la limite, qui ne changent pas : rien n'y vieillit donc. stopRecording nettoie d'abord l'intervalle, puis arrête l'enregistrement, mais seulement s'il est encore en cours :
const recorder = recorderRef.current;
if (recorder && recorder.state !== "inactive") recorder.stop();Cette condition n'est pas décorative. Selon MDN, stop() sur un enregistrement inactif lance une InvalidStateError, et le clic sur Arrêter et la limite peuvent arriver au même instant. Après stop() arrive l'événement stop, dans lequel Claude assemble le résultat :
recorder.onstop = () => {
const durationSec = (Date.now() - startedAt) / 1000;
const mimeType = recorder.mimeType || preferred || "";
const blob = new Blob(chunks, mimeType ? { type: mimeType } : undefined);
onCompleteRef.current(blob, { durationSec, mimeType });
};durationSec est le temps mesuré entre le départ et l'arrêt, et non un nombre tiré des réglages : l'éditeur de la leçon 9_3 recevra donc la vraie durée du clip.
La revue du capitaine
- Un ancien état dans l'intervalle. L'erreur typique de l'agent est une condition
if (isRecording && ...)dans l'intervalle.isRecordingy a la valeur du moment du départ, doncfalse, et l'enregistrement ne se termine jamais tout seul. Chez nous, cette version a passé le lint,tscet le build, et un test avec une fausse horloge l'a fait échouer avec la ligneexpected "vi.fn()" to be called once, but got 0 times. Cherche dans l'intervalle les variables d'état. - La caméra éteinte. Cherche dans le fichier
getTracks,clearIntervaletrevokeObjectURL(la page crée une adresse d'aperçu de l'enregistrement). L'absence de l'un d'eux est une fuite : le voyant de la caméra reste allumé après la sortie de la page, ou la mémoire grossit à chaque enregistrement. - Le refus. Clique sur "Activer la caméra" et refuse l'accès. Chez nous, le navigateur avec la caméra bloquée a affiché le message "Accès à la caméra et au micro refusé.", et non un écran vide.
- Le périmètre. La liste des fichiers du commit de chaque session. Chez nous, la session des sons avait ajouté
formatDurationaulib/format.tscommun. Cette fois l'enregistreur n'a pas touché ce fichier, la fusion est donc passée, mais c'est exactement le genre de modification qui finit en conflit.
Fusion et rangement
Reviens au dossier principal : un troisième terminal, un claude ordinaire, et la demande "Fusionne dans main les branches worktree-sons et worktree-enregistreur, l'une après l'autre, puis lint, tests et build". Chez nous, la première branche est entrée en Fast-forward, parce que main n'avait pas bougé depuis son départ, et la seconde a reçu un commit de fusion avec la ligne Merge made by the 'ort' strategy..
Reste le rangement. Tant que les worktrees sont dans le projet, les outils du dossier principal les voient : chez nous, npm run lint a signalé 7056 problems (364 errors, 6692 warnings) venant des dossiers .next des worktrees, et Vitest a lancé 12 fichiers de tests au lieu de 5, car il comptait les copies des deux worktrees. Quitte les deux sessions avec /exit. Selon la documentation, quand le worktree a des modifications ou de nouveaux commits, Claude demande s'il faut le garder ou le supprimer. La suppression efface le dossier et la branche avec le travail : tu ne la choisis donc qu'après la fusion. Si tu préfères garder les worktrees plus longtemps, demande à Claude d'ajouter .claude/worktrees/** aux chemins ignorés dans eslint.config.mjs et dans vitest.config.mts.
Étape suivante
Les liens vers /sons et /enregistrer dans la navigation sont une modification du app/layout.tsx commun : tu la fais donc après la fusion, dans une seule session. Si Claude change autre chose que la navigation, /rewind de la leçon 0_6 annule tout le tour. Puis un commit, par exemple "Sons et enregistreur".
Dans l'éditeur ci-dessous t'attend l'enregistreur avec une fausse caméra et un voyant. Règle la limite à 5 secondes, active l'erreur de l'agent avec l'ancien état et regarde l'enregistrement dépasser la limite. Ensuite quitte la page avec la seconde erreur et regarde le voyant.
À retenir : deux chaloupes vont plus vite qu'une seule uniquement si chacune rame vers une autre crique, et celui qui n'éteint pas le fanal le laisse briller toute la nuit.
Code de cette leçon : App.jsx
// Enregistreur en miniature : fausse caméra, vraie limite et voyant de la caméra
import { useEffect, useRef, useState } from 'react';
const TYPES = ['video/mp4;codecs=avc1.64003E,mp4a.40.2', 'video/webm;codecs=vp8,opus', 'video/webm'];
function supported(type) {
return typeof MediaRecorder !== 'undefined' && MediaRecorder.isTypeSupported(type);
}
function Recorder({ maxSeconds, deny, bugInterval, bugTracks, onLamp, onComplete }) {
const [stream, setStream] = useState(null);
const [error, setError] = useState('');
const [recording, setRecording] = useState(false);
const [elapsed, setElapsed] = useState(0);
const recorderRef = useRef(null);
const timerRef = useRef(null);
const startedAtRef = useRef(0);
function enableCamera() {
setError('');
if (deny) {
setError('Accès à la caméra refusé. Autorise la caméra dans les réglages du navigateur.');
return;
}
// faux flux : stop() éteint le voyant de la caméra ; leaky est l'erreur de l'agent activée
setStream({ stop: () => onLamp(false), leaky: bugTracks });
onLamp(true);
}
// Nettoyage : la caméra s'éteint quand le flux disparaît ou que l'enregistreur quitte l'écran
useEffect(() => {
if (!stream) return;
return () => {
clearInterval(timerRef.current);
if (!stream.leaky) stream.stop();
};
}, [stream]);
function stop() {
const recorder = recorderRef.current;
if (!recorder || recorder.state === 'inactive') return;
recorder.state = 'inactive';
clearInterval(timerRef.current);
setRecording(false);
const durationSec = (Date.now() - startedAtRef.current) / 1000;
const mimeType = TYPES.find(supported) || 'pas de MediaRecorder dans ce navigateur';
onComplete({ durationSec, mimeType });
}
function start() {
recorderRef.current = { state: 'recording' };
startedAtRef.current = Date.now();
setElapsed(0);
setRecording(true);
timerRef.current = setInterval(() => {
const seconds = (Date.now() - startedAtRef.current) / 1000;
setElapsed(seconds);
if (bugInterval) {
// erreur de l'agent : `recording` date du démarrage, donc false
if (recording && seconds >= maxSeconds) stop();
} else if (seconds >= maxSeconds) {
stop();
}
}, 100);
}
return (
<div className="space-y-3">
<div className="relative flex h-56 items-center justify-center rounded-xl bg-gradient-to-br from-slate-800 to-indigo-900">
<span className="text-lg">{stream ? 'Aperçu de la caméra' : 'Caméra éteinte'}</span>
{recording && <span className="absolute top-3 left-3 rounded-full bg-red-600 px-3 py-1 text-xs">● REC</span>}
</div>
{!stream && (
<button type="button" onClick={enableCamera} className="rounded bg-sky-600 px-4 py-2">Activer la caméra</button>
)}
{error && <p role="alert" className="text-red-400">{error}</p>}
{stream && (
<div className="space-y-2">
<div className="h-2 w-full overflow-hidden rounded bg-gray-700">
<div className="h-full bg-red-500" style={{ width: `${Math.min(100, (elapsed / maxSeconds) * 100)}%` }} />
</div>
<p className="text-sm">{elapsed.toFixed(1)} s / {maxSeconds} s</p>
<button
type="button"
onClick={recording ? stop : start}
className="rounded bg-red-600 px-4 py-2"
>
{recording ? 'Arrêter' : 'Enregistrer'}
</button>
</div>
)}
</div>
);
}
export default function App() {
const [page, setPage] = useState('enregistrer');
const [lamp, setLamp] = useState(false);
const [maxSeconds, setMaxSeconds] = useState(5);
const [deny, setDeny] = useState(false);
const [bugInterval, setBugInterval] = useState(false);
const [bugTracks, setBugTracks] = useState(false);
const [results, setResults] = useState([]);
return (
<div className="min-h-screen bg-gray-950 p-4 text-white">
<div className="mb-4 flex flex-wrap items-center gap-3">
<button type="button" onClick={() => setPage(page === 'enregistrer' ? 'feed' : 'enregistrer')} className="rounded bg-gray-700 px-4 py-2">
{page === 'enregistrer' ? "Quitter la page d'enregistrement" : "Revenir à l'enregistrement"}
</button>
<span className={lamp ? 'text-green-400' : 'text-gray-400'}>Voyant de la caméra : {lamp ? 'allumé' : 'éteint'}</span>
</div>
<div className="grid gap-4 md:grid-cols-2">
<div>
{page === 'enregistrer' ? (
<Recorder
maxSeconds={maxSeconds}
deny={deny}
bugInterval={bugInterval}
bugTracks={bugTracks}
onLamp={setLamp}
onComplete={(r) => setResults((prev) => [r, ...prev])}
/>
) : (
<p className="rounded-xl bg-gray-800 p-6">Feed For You. L'enregistreur a disparu de l'écran.</p>
)}
</div>
<div className="space-y-2 text-sm">
<label className="flex items-center gap-2">
Limite :
<select value={maxSeconds} onChange={(e) => setMaxSeconds(Number(e.target.value))} className="rounded bg-gray-800 px-2 py-1">
<option value={5}>5 s</option>
<option value={15}>15 s</option>
</select>
</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={deny} onChange={(e) => setDeny(e.target.checked)} /> Refuser l'accès à la caméra</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={bugInterval} onChange={(e) => setBugInterval(e.target.checked)} /> Erreur de l'agent : ancien état dans l'intervalle</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={bugTracks} onChange={(e) => setBugTracks(e.target.checked)} /> Erreur de l'agent : pas de stop() sur les pistes (coche avant d'activer la caméra)</label>
<p className="pt-2 font-bold">Formats dans ton navigateur (isTypeSupported) :</p>
<ul>
{TYPES.map((t) => <li key={t}>{t} : {supported(t) ? 'oui' : 'non'}</li>)}
</ul>
<p className="pt-2 font-bold">Enregistrements :</p>
<ul>
{results.map((r, i) => <li key={i}>{r.durationSec.toFixed(1)} s, {r.mimeType}</li>)}
</ul>
</div>
</div>
</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. Que fait la commande claude -w sons ?
2. Comment le type SoundDetails utilise-t-il le type Sound de la leçon 9_1 ?
Voici 2 des 5 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri vertical
Mets dans l'ordre le travail en parallèle sur les sons et l'enregistreur (à partir de la première étape) :
- Tri horizontal
Compose la commande qui lance une deuxième session Claude Code dans un worktree séparé nommé enregistreur :
- Éditeur de code
Découverte des sons
- Clique dans l'ordre
Construis la condition qui arrête l'enregistrement à la limite (clique dans l'ordre) :
- Clique dans l'ordre
Construis l'expression qui choisit le premier format pris en charge par le navigateur (clique dans l'ordre) :
- Tri horizontal
Compose le début de l'appel qui, après un clic, demande la caméra et le micro :
- Tri vertical
Mets dans l'ordre les étapes de l'enregistrement dans VideoRecorder (à partir de la première) :
- Éditeur de code
Interface d'enregistrement vidéo
- Clique dans l'ordre
Construis la création du Blob à partir des morceaux enregistrés (clique dans l'ordre) :
- Tri horizontal
Compose la ligne qui arrête l'enregistrement seulement s'il est encore en cours :
Exercices après cette leçon
- QuestionCe que fait claude -w
- QuestionSoundDetails et Sound
- Remets dans l'ordreLe travail en parallèle pas à pas
- Remets dans l'ordreDeuxième session dans un worktree
- Exercice de codePratique : page des sons
- Clique dans l'ordreCondition de limite d'enregistrement
- Clique dans l'ordreChoix du format d'enregistrement
- QuestionQuand ne pas travailler en parallèle
- Remets dans l'ordreLa demande d'accès à la caméra
- QuestionAncien état dans l'intervalle
- Remets dans l'ordreLe cycle d'enregistrement
- Exercice de codePratique : enregistreur vidéo
- QuestionPush avant le worktree
- Clique dans l'ordreLe Blob de l'enregistrement
- Remets dans l'ordreUn stop() sûr