Cours Vibe coding avec Claude Code · Module 4: Clone d'Instagram

Le nid-de-pie : la capture d'écran comme demande et Claude in Chrome

11 min de lecture ·
Dans cette leçon10

La galerie a une grille, une fenêtre d'aperçu, des réactions, un squelette et une recherche. Jusqu'ici, tu as tout vérifié toi-même : tu ouvrais le navigateur, tu cliquais, tu appuyais sur Escape et tu regardais. Claude voit le code et le résultat des commandes, mais il ne voit pas la page elle-même. Dans cette leçon, tu lui donnes des yeux de deux façons : une capture d'écran dans la demande, et l'extension Claude in Chrome, avec laquelle il ouvre lui-même la page et la vérifie.

Le problème : "ça a l'air différent" ne suffit pas

Dans la leçon 3_2, le croquis disait à Claude où tu allais. Quand quelque chose est déjà construit mais pas comme sur la maquette, le croquis seul ne suffit plus. Claude ne sait pas ce qu'on voit aujourd'hui à l'écran, donc il devine ce qu'il faut corriger, et souvent il corrige autre chose. Il manque une deuxième image : une capture de l'état actuel. La maquette et la capture posées côte à côte montrent la différence, et la différence est justement la tâche.

La capture à côté de la maquette

Prenons l'en-tête de la galerie. Dessine sur une feuille à quoi il doit ressembler : l'avatar à gauche, le titre à côté, et sous le titre le champ de recherche, comme le bouton sous le nom du profil sur Instagram. Enregistre la photo de la feuille sous croquis/entete.jpg, comme le croquis de la leçon 3_2. Puis fais une capture de la page actuelle, comme tu en fais tous les jours, et enregistre-la sous croquis/maintenant.png. La demande avec deux images ressemble à ceci :

Compare la maquette croquis/entete.jpg avec l'état actuel croquis/maintenant.png.
Sur la maquette, le champ de recherche est dans l'en-tête, sous le titre, et sur
la capture il est sous tout l'en-tête, sur toute la largeur. Déplace-le dans
@app/gallery/page.tsx comme sur la maquette ; sur téléphone, il peut rester
sous l'en-tête. Ne change rien d'autre. Termine par npm run build
et npm run lint.

Chaque image a un rôle dans la demande : la maquette est l'objectif, la capture est l'état d'aujourd'hui. À côté des images se trouvent les choses qu'une image ne dit pas : ce qui doit exactement changer, dans quel fichier et ce qu'il ne faut pas toucher. La phrase sur le téléphone complète ce qu'un croquis d'un seul écran ne montre pas. Sans ces phrases, Claude corrigerait tout ce qui sur la capture lui semble différent de la feuille, y compris les couleurs que tu n'avais pas dessinées.

Quand l'image, quand les mots

L'image gagne quand il faut voir la chose parce que le code ne la montre pas : la disposition, les espacements, l'ordre des éléments, l'aspect sur un écran étroit, une légende qui dépasse de la vignette. La documentation de Claude Code conseille de recourir à une image quand une description en mots serait floue ou longue. Les mots gagnent pour la logique et les données. Un compteur de likes qui saute de 42 à 44 après un clic se décrit mieux avec les étapes qui mènent au bug et le résultat attendu qu'avec une capture montrant le nombre 44. Une bonne demande contient souvent les deux.

La boucle de l'image

Une seule correction avec une image règle rarement l'affaire. Tu travailles en boucle de cinq étapes :

  1. Tu fais une capture de l'état actuel.
  2. Tu envoies la demande avec la maquette, la capture, une seule différence et un fichier.
  3. Claude fait le changement, et tu lis le diff dans Cursor.
  4. Tu vérifies la page dans le navigateur, aussi dans une fenêtre étroite.
  5. Tu fais une nouvelle capture et tu la poses à côté de la maquette.

Si une différence reste, tu reviens à la deuxième étape avec la nouvelle capture. Un tour, une différence : cinq corrections d'un coup se diluent comme une longue description. Et quand deux tours de suite ratent leur cible, n'ajoute pas un troisième rafistolage. Les bonnes pratiques de Claude Code conseillent alors /clear et une meilleure demande.

Les étapes quatre et cinq, tu peux les confier à Claude. Ces mêmes bonnes pratiques citent la capture du navigateur à côté de la maquette parmi les contrôles que Claude peut lancer lui-même, comme un build ou un linter. Il lui faut pour cela un navigateur.

Claude in Chrome

Claude in Chrome est une extension de navigateur par laquelle Claude Code pilote Chrome. Claude y ouvre des onglets, clique, saisit du texte, lit les erreurs de la console et l'état de la page, fait des captures d'écran et les enregistre sur le disque, et peut même enregistrer le déroulement sous forme de GIF. L'extension fonctionne dans Google Chrome et Microsoft Edge, ainsi que dans d'autres navigateurs basés sur Chromium, par exemple Brave et Arc ; elle ne fonctionne pas dans WSL. Il te faut l'extension du Chrome Web Store et un abonnement Claude acheté directement chez Anthropic : Pro, Max, Ultra, Team ou Enterprise (état de novembre 2026). Claude Code doit être connecté par /login : avec une clé API, le navigateur ne s'active pas.

Tu lances une session avec le navigateur dans le terminal de Cursor, avec un drapeau :

claude --chrome

La première fois, une fenêtre décrit l'intégration et les autorisations, que tu valides avec Entrée. La commande /chrome pendant la session montre l'état de la connexion (tout fonctionne quand tu vois "Status: Enabled" et "Extension: Installed"), permet de reconnecter l'extension et d'activer le navigateur en permanence avec l'option Enabled by default. Je ne te recommande pas cette option au début, car les outils du navigateur occupent alors le contexte de chaque session. Si tu n'as pas encore l'extension et que tu demandes à Claude de travailler dans le navigateur, Claude Code te proposera lui-même de l'installer. Dans l'extension Claude Code pour VS Code, @browser dans le champ de demande donne la même chose.

Demande pour Claude Code : tester la fenêtre

Lance npm run dev dans un deuxième terminal et confie à Claude le test que tu faisais jusqu'ici à la main :

Demande pour Claude Code :

Ouvre localhost:3000/gallery, clique sur la première photo et vérifie
si la fenêtre se ferme avec la touche Escape. Dis-moi quel élément a le
focus après la fermeture et si la page défile de nouveau. Ensuite, regarde
la console : les erreurs et les avertissements m'intéressent, pas tout le
journal. Ne corrige encore rien, fais seulement un rapport.

Avant la première action, Claude Code peut demander ton accord avec une fenêtre qui commence par "Claude in Chrome wants to". Pour localhost, tu peux autoriser toutes les actions sur cette page jusqu'à la fin de la session. Claude ouvre un nouvel onglet dans une fenêtre Chrome visible, donc tu le regardes travailler en direct. La demande dit quoi chercher dans la console, car la documentation avertit que le journal complet peut être très long.

Ce que Claude a trouvé

Dans notre projet, ce test a montré trois choses. Escape ferme la fenêtre et le défilement revient, donc l'effet de la leçon 3_2 fait bien le ménage. Mais après la fermeture, le focus atterrit sur <body>, c'est-à-dire au début de la page : une personne qui est arrivée à la cinquième photo avec la touche Tab recommence depuis le début après chaque aperçu. Dans la console, un avertissement attendait :

Image with src "/images/kapitan.jpg" was detected as the Largest Contentful Paint (LCP). Please add the `loading="eager"` property if this image is above the fold.

LCP (Largest Contentful Paint) est le moment où apparaît le plus grand élément visible dès l'arrivée sur la page. Depuis la leçon 3_4, la grille attend le serveur, donc le plus grand élément est l'avatar, et il se charge en différé. Le remède est loading="eager" sur l'avatar, comme pour la première rangée de vignettes dans la leçon 3_1.

Ce que Claude a écrit : le focus revient sur la vignette

Tu demandes les deux corrections en une seule demande avec un objectif pour chacune : "Après la fermeture de la fenêtre, le focus doit revenir sur la vignette qui l'a ouverte (@components/Gallery.tsx). L'avatar dans @app/gallery/page.tsx reçoit loading="eager". Ensuite, refais le test Escape et la console". Ouvre components/Gallery.tsx. Au-dessus des fonctions de la galerie sont apparus un ref et une fonction de fermeture :

const openerRef = useRef<HTMLButtonElement | null>(null);

const closeModal = () => {
  setSelectedId(null);
  openerRef.current?.focus();
};

useRef de la leçon 2_5 garde une valeur entre les rendus sans demander de redessiner le composant. Ici, il garde le bouton qui a ouvert la fenêtre. ?. n'appelle focus() que si un bouton est mémorisé. La fenêtre reçoit maintenant onClose={closeModal}, donc la croix, Escape et le clic sur le fond la ferment par le même chemin.

La vignette s'enregistre au moment du clic :

onClick={(event) => {
  openerRef.current = event.currentTarget;
  setSelectedId(photo.id);
}}

event.currentTarget est l'élément auquel le gestionnaire d'événement est attaché, c'est-à-dire le bouton de la vignette, même quand le clic est tombé sur l'image à l'intérieur. Les likes, les commentaires et la grille n'ont pas changé. Un deuxième test dans le navigateur a donné chez nous le focus sur la bonne vignette et une console sans avertissement.

La revue du capitaine : où il a le droit de cliquer

Claude in Chrome travaille dans ton navigateur et, selon la documentation, utilise ses sessions ouvertes : il entrera sur toute page où tu es connecté, y compris ta messagerie ou ta banque. C'est sa force et en même temps le risque :

  1. Seulement des ports connus. Envoie-le sur localhost et sur des sites en lesquels tu as confiance. L'aide d'Anthropic conseille de commencer par des sites de confiance et d'éviter les inconnus et ceux qui sont pleins de contenus d'inconnus. Des instructions cachées dans une page peuvent le tromper comme si c'était toi qui demandais quelque chose ; cela s'appelle le prompt injection.
  2. Un profil de navigateur séparé. Cette même aide recommande un profil à part, sans accès aux comptes sensibles : banque, santé, démarches administratives. Pour tester la galerie, un profil avec la seule extension suffit.
  3. Les autorisations par site. Tu règles les autorisations des sites dans les paramètres de l'extension. Donne l'accord pour toute la session à localhost, pas à chaque site que Claude visite.
  4. La connexion, c'est toi. Quand Claude tombe sur une page de connexion ou un CAPTCHA, il s'arrête et te demande de t'en occuper à la main. Ne mets jamais un mot de passe dans une demande.
  5. Les fenêtres alert. Une fenêtre alert bloque le navigateur et Claude cesse d'en recevoir des réponses. Ferme-la toi-même et dis-lui de continuer.
  6. Les enregistrements. Un GIF enregistre tout ce qui est visible dans la fenêtre, y compris les données des pages où tu es connecté. Regarde-le avant de l'envoyer à quelqu'un.

Étape suivante

Quand la revue est passée, demande un commit, par exemple "Galerie : le focus revient sur la vignette, avatar sans chargement différé". Puis ferme la boucle de l'image de la leçon 3_2, cette fois sans tes propres captures :

Ouvre localhost:3000/gallery, clique sur la première photo, enregistre sur
le disque une capture de la fenêtre ouverte et donne le chemin du fichier.
Compare la capture au croquis croquis/galerie.jpg et liste les différences.
Ne corrige rien.

Une partie des différences sera voulue, car les likes et les commentaires de la leçon 3_3 n'étaient pas sur le premier croquis. Choisis dans la liste une différence qui ne doit pas rester, et corrige-la avec un nouveau tour de la boucle.

Dans l'éditeur ci-dessous t'attend une grille avec une fenêtre et un interrupteur pour le retour du focus. Va jusqu'à une vignette avec la touche Tab, ouvre-la avec Entrée, ferme-la avec Escape et regarde où va le focus avec l'interrupteur et sans lui.

À retenir : la maquette dit où tu vas, la capture dit où tu es, et Claude in Chrome monte lui-même au nid-de-pie pour vérifier ; toi, tu décides au-dessus de quels ports il a le droit de regarder.

Code de cette leçon : App.jsx
// Focus après la fermeture de la fenêtre : revient-il sur la vignette ou file-t-il au début de la page ?
// C'est exactement ce que Claude in Chrome a vérifié. Va jusqu'à une vignette avec la touche Tab,
// ouvre-la avec Entrée et ferme-la avec Escape, avec l'interrupteur et sans lui.
import { useEffect, useRef, useState } from 'react';

const photos = [
  {
    id: 'coucher-plage',
    src: 'https://images.unsplash.com/photo-1507525428034-b723cf961d3e?w=600',
    alt: 'Vagues sur une plage de sable au coucher du soleil',
    caption: 'Ici, nous avons enterré le coffre',
  },
  {
    id: 'vagues-ciel',
    src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
    alt: 'Vagues turquoise sur une plage blanche vues du ciel',
    caption: 'La baie vue du nid-de-pie',
  },
  {
    id: 'voilier-nuit',
    src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
    alt: 'Petit voilier sur une mer calme sous un ciel étoilé',
    caption: 'Quart de nuit',
  },
  {
    id: 'palmiers',
    src: 'https://images.unsplash.com/photo-1519046904884-53103b34b206?w=600',
    alt: 'Palmiers et parasol de paille sur une plage blanche',
    caption: 'Île de la carte',
  },
];

// Description de l'élément qui a le focus
function describeFocus(element) {
  if (!element || element === document.body) return 'body, c’est-à-dire le début de la page';
  if (element.dataset.caption) return 'vignette « ' + element.dataset.caption + ' »';
  return element.getAttribute('aria-label') || element.tagName.toLowerCase();
}

function PhotoModal({ photo, onClose }) {
  useEffect(() => {
    const handleKeyDown = (event) => {
      if (event.key === 'Escape') onClose();
    };
    window.addEventListener('keydown', handleKeyDown);
    return () => window.removeEventListener('keydown', handleKeyDown);
  }, [onClose]);

  return (
    <div
      className="fixed inset-0 z-50 flex items-center justify-center bg-black/80 p-4"
      onClick={onClose}
    >
      <div
        role="dialog"
        aria-modal="true"
        aria-labelledby="photo-modal-title"
        className="w-full max-w-md overflow-hidden rounded-lg bg-white text-gray-900"
        onClick={(event) => event.stopPropagation()}
      >
        <div className="flex items-center justify-between p-3">
          <h2 id="photo-modal-title" className="font-semibold">{photo.caption}</h2>
          <button
            type="button"
            onClick={onClose}
            aria-label="Fermer l'aperçu"
            autoFocus
            className="rounded px-2 text-2xl leading-none"
          >
            ×
          </button>
        </div>
        <div className="relative h-56 bg-black">
          <img
            src={photo.src}
            alt={photo.alt}
            className="absolute inset-0 h-full w-full object-contain"
          />
        </div>
      </div>
    </div>
  );
}

export default function App() {
  const [selectedId, setSelectedId] = useState(null);
  const [returnFocus, setReturnFocus] = useState(false);
  const [focused, setFocused] = useState('body, c’est-à-dire le début de la page');
  const openerRef = useRef(null);
  const selected = photos.find((photo) => photo.id === selectedId) ?? null;

  // Lecture du focus à chaque passage avec la touche Tab
  useEffect(() => {
    const update = () => setFocused(describeFocus(document.activeElement));
    document.addEventListener('focusin', update);
    return () => document.removeEventListener('focusin', update);
  }, []);

  const closeModal = () => {
    setSelectedId(null);
    if (returnFocus) openerRef.current?.focus();
    // Le focus sur body ne déclenche pas focusin, donc on le vérifie un instant plus tard
    setTimeout(() => setFocused(describeFocus(document.activeElement)), 50);
  };

  return (
    <div className="min-h-screen bg-slate-100 p-4 text-slate-900">
      <h1 className="mb-3 text-2xl font-bold">Treasure Gallery</h1>

      <label className="mb-2 flex items-center gap-2 text-sm">
        <input
          type="checkbox"
          checked={returnFocus}
          onChange={(event) => setReturnFocus(event.target.checked)}
        />
        Rendre le focus à la vignette qui a ouvert la fenêtre
      </label>

      <p className="mb-3 rounded bg-white p-2 text-sm">
        Le focus est maintenant sur : <strong>{focused}</strong>
      </p>

      <ul className="grid grid-cols-2 gap-1 sm:grid-cols-4">
        {photos.map((photo) => (
          <li key={photo.id}>
            <button
              type="button"
              data-caption={photo.caption}
              onClick={(event) => {
                openerRef.current = event.currentTarget;
                setSelectedId(photo.id);
              }}
              className="relative block aspect-square w-full cursor-pointer focus-visible:outline-4 focus-visible:outline-amber-500"
            >
              <img
                src={photo.src}
                alt={photo.alt}
                className="absolute inset-0 h-full w-full object-cover"
              />
            </button>
          </li>
        ))}
      </ul>

      {selected && <PhotoModal photo={selected} onClose={closeModal} />}
    </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. 1. Tu envoies à Claude une maquette et une capture de la page actuelle. Que doit encore contenir la demande ?

  2. 2. Claude in Chrome utilise les sessions ouvertes de ton navigateur. Où l'envoies-tu ?

Voici 2 des 4 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri vertical

    Ordonne les étapes de la boucle de l'image :

  1. QuestionQuiz : Quoi ajouter à la capture
  2. Remets dans l'ordreTri : La boucle de l'image
  3. QuestionQuiz : Claude in Chrome et les sessions ouvertes
  4. QuestionQuiz : Quand une capture plutôt qu'une description
  5. QuestionQuiz : Le focus après la fermeture de la fenêtre
  6. Projet à envoyerEnvoie la Galerie du Trésor au mentor
  7. VidéoRésumé du module

Articles utiles