Kurs vibe coding z Claude Code · Moduł 4: Klon Instagrama

Bocianie gniazdo: zrzut ekranu jako polecenie i Claude in Chrome

8 min czytania ·
W tej lekcji10

Galeria ma siatkę, okno podglądu, reakcje, szkielet i wyszukiwarkę. Wszystko to sprawdzałeś do tej pory sam: otwierałeś przeglądarkę, klikałeś, naciskałeś Escape i patrzyłeś. Claude widzi kod i wyniki komend, ale samej strony nie widzi. W tej lekcji dasz mu oczy na dwa sposoby: zrzutem ekranu w poleceniu i rozszerzeniem Claude in Chrome, z którym sam otworzy stronę i ją sprawdzi.

Problem: "wygląda inaczej" to za mało

W lekcji 3_2 szkic mówił Claude, dokąd płyniesz. Gdy coś już stoi, ale nie tak jak na makiecie, sam szkic nie wystarczy. Claude nie wie, co dziś widać na ekranie, więc zgaduje, co poprawić, i często poprawia nie to. Brakuje drugiego obrazu: zrzutu obecnego stanu. Makieta i zrzut położone obok siebie pokazują różnicę, a różnica jest właśnie zadaniem.

Zrzut obok makiety

Weźmy nagłówek galerii. Narysuj na kartce, jak ma wyglądać: awatar po lewej, obok tytuł, a pod tytułem pole wyszukiwania, tak jak przycisk pod nazwą profilu na Instagramie. Zdjęcie kartki zapisz jako szkice/naglowek.jpg, tak jak szkic w lekcji 3_2. Potem zrób zrzut obecnej strony, tak jak robisz zrzuty na co dzień, i zapisz go jako szkice/teraz.png. Polecenie z dwoma obrazami wygląda tak:

Porównaj makietę szkice/naglowek.jpg z obecnym stanem szkice/teraz.png.
Na makiecie pole wyszukiwania stoi w nagłówku, pod tytułem, a na zrzucie
pod całym nagłówkiem, na pełną szerokość. Przenieś je w
@app/gallery/page.tsx tak jak na makiecie; na telefonie może zostać pod
nagłówkiem. Nic poza tym nie zmieniaj. Na koniec npm run build
i npm run lint.

Każdy obraz ma w poleceniu swoją rolę: makieta to cel, zrzut to stan dzisiejszy. Obok obrazów stoją rzeczy, których obraz nie powie: co dokładnie ma się zmienić, w którym pliku i czego nie ruszać. Zdanie o telefonie dopowiada to, czego szkic jednego ekranu nie pokaże. Bez tych zdań Claude poprawiłby wszystko, co na zrzucie wydało mu się inne niż na kartce, łącznie z kolorami, których wcale nie rysowałeś.

Kiedy obraz, a kiedy słowa

Obraz wygrywa tam, gdzie rzecz trzeba zobaczyć, bo w kodzie jej nie widać: układ, odstępy, kolejność elementów, wygląd na wąskim ekranie, podpis, który wyjeżdża poza kafelek. Dokumentacja Claude Code radzi sięgać po obraz, gdy opis słowami byłby niejasny albo długi. Słowa wygrywają przy logice i danych. Licznik polubień, który po kliknięciu skacze z 42 na 44, lepiej opiszesz krokami, które prowadzą do błędu, i wynikiem, jakiego oczekujesz, niż zrzutem z liczbą 44. Dobre polecenie często ma jedno i drugie.

Pętla obrazu

Jedna poprawka z obrazem rzadko kończy sprawę. Pracujesz w pętli o pięciu krokach:

  1. Robisz zrzut obecnego stanu.
  2. Wysyłasz polecenie z makietą, zrzutem, jedną różnicą i plikiem.
  3. Claude wprowadza zmianę, a Ty czytasz diff w Cursorze.
  4. Sprawdzasz stronę w przeglądarce, także w wąskim oknie.
  5. Robisz nowy zrzut i kładziesz go obok makiety.

Jeśli różnica została, wracasz do drugiego kroku z nowym zrzutem. Jedna runda to jedna różnica: pięć poprawek naraz rozmywa się tak samo jak długi opis. A gdy dwie rundy z rzędu chybiają, nie dokładaj trzeciej łatki. Dobre praktyki Claude Code radzą wtedy /clear i lepsze polecenie.

Kroki czwarty i piąty możesz oddać Claude. Te same dobre praktyki wymieniają zrzut przeglądarki obok makiety wśród sprawdzianów, które Claude potrafi uruchomić sam, jak build czy linter. Potrzebuje do tego jednak przeglądarki.

Claude in Chrome

Claude in Chrome to rozszerzenie przeglądarki, przez które Claude Code steruje Chrome'em. Claude otwiera w nim karty, klika, wpisuje tekst, czyta błędy z konsoli i stan strony, robi zrzuty ekranu i zapisuje je na dysku, a nawet nagrywa przebieg jako GIF. Rozszerzenie działa w Google Chrome i Microsoft Edge, a także w innych przeglądarkach opartych na Chromium, na przykład Brave i Arc; nie działa w WSL. Potrzebujesz rozszerzenia z Chrome Web Store i planu Claude kupionego bezpośrednio od Anthropic: Pro, Max, Ultra, Team albo Enterprise (stan na listopad 2026). Claude Code musi być zalogowany przez /login: przy kluczu API przeglądarka się nie włączy.

Sesję z przeglądarką uruchamiasz w terminalu Cursora flagą:

claude --chrome

Za pierwszym razem pojawi się okno z opisem integracji i uprawnień, które zatwierdzasz Enterem. Komenda /chrome w trakcie sesji pokazuje stan połączenia (działa, gdy widzisz "Status: Enabled" i "Extension: Installed"), pozwala połączyć rozszerzenie ponownie i włączyć przeglądarkę na stałe opcją Enabled by default. Tej opcji nie polecam na początek, bo narzędzia przeglądarki zajmują wtedy kontekst każdej sesji. Jeśli nie masz jeszcze rozszerzenia, a poprosisz Claude o pracę w przeglądarce, Claude Code sam zaproponuje instalację. W rozszerzeniu Claude Code dla VS Code to samo daje @browser w polu polecenia.

Polecenie dla Claude Code: test okna

Uruchom w drugim terminalu npm run dev i oddaj Claude test, który dotąd robiłeś ręcznie:

Polecenie dla Claude Code:

Otwórz localhost:3000/gallery, kliknij pierwsze zdjęcie i sprawdź,
czy okno zamyka się klawiszem Escape. Powiedz, który element ma fokus
po zamknięciu i czy strona znów się przewija. Potem zajrzyj do konsoli:
interesują mnie błędy i ostrzeżenia, nie cały log. Niczego jeszcze nie
poprawiaj, tylko zdaj raport.

Przed pierwszą akcją Claude Code może zapytać o zgodę okienkiem, które zaczyna się od "Claude in Chrome wants to". Dla localhost możesz pozwolić na wszystkie akcje na tej stronie do końca sesji. Claude otwiera nową kartę w widocznym oknie Chrome'a, więc patrzysz mu na ręce na żywo. Polecenie mówi, czego szukać w konsoli, bo dokumentacja ostrzega, że pełny log bywa bardzo długi.

Co znalazł Claude

W naszym projekcie ten test pokazał trzy rzeczy. Escape zamyka okno, a przewijanie wraca, więc efekt z lekcji 3_2 sprząta poprawnie. Po zamknięciu fokus ląduje jednak na <body>, czyli na początku strony: osoba, która doszła klawiszem Tab do piątego zdjęcia, po każdym podglądzie zaczyna od nowa. W konsoli czekało jedno ostrzeżenie:

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) to chwila, w której pojawia się największy element widoczny od razu po wejściu. Od lekcji 3_4 siatka czeka na serwer, więc największy jest awatar, a ten ładuje się leniwie. Lekarstwo to loading="eager" przy awatarze, tak jak przy pierwszym rzędzie miniatur w lekcji 3_1.

Co napisał Claude: fokus wraca na kafelek

O obie poprawki prosisz jednym poleceniem z celem dla każdej: "Po zamknięciu okna fokus ma wrócić na kafelek, który je otworzył (@components/Gallery.tsx). Awatar w @app/gallery/page.tsx dostaje loading="eager". Potem powtórz test Escape i konsoli". Otwórz components/Gallery.tsx. Nad funkcjami galerii pojawił się ref i funkcja zamykania:

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

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

useRef z lekcji 2_5 trzyma wartość między renderami i nie każe rysować komponentu od nowa. Tu trzyma przycisk, który otworzył okno. ?. wywołuje focus() tylko wtedy, gdy jakiś przycisk jest zapamiętany. Okno dostaje teraz onClose={closeModal}, więc krzyżyk, Escape i kliknięcie w tło zamykają je tą samą drogą.

Kafelek zapisuje się w chwili kliknięcia:

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

event.currentTarget to element, do którego przypięto obsługę zdarzenia, czyli przycisk kafelka, nawet gdy kliknięcie trafiło w obraz w środku. Polubienia, komentarze i siatka się nie zmieniły. Drugi test w przeglądarce dał u nas fokus na właściwym kafelku i konsolę bez ostrzeżeń.

Przegląd kapitana: gdzie wolno mu klikać

Claude in Chrome działa w Twojej przeglądarce i według dokumentacji korzysta z jej zalogowanych sesji: wejdzie na każdą stronę, na której jesteś zalogowany, także do poczty czy banku. To jego siła i zarazem ryzyko:

  1. Tylko znane porty. Wysyłaj go na localhost i na strony, którym ufasz. Pomoc Anthropic radzi zaczynać od zaufanych stron i omijać nieznane oraz pełne treści od obcych ludzi. Instrukcje ukryte na stronie mogą go oszukać, jakbyś to Ty o coś prosił; nazywa się to prompt injection.
  2. Osobny profil przeglądarki. Ta sama pomoc zaleca osobny profil bez dostępu do kont wrażliwych: banku, zdrowia, spraw urzędowych. Do testów galerii wystarczy profil z samym rozszerzeniem.
  3. Zgody dla stron. Uprawnienia do stron ustawiasz w ustawieniach rozszerzenia. Zgodę na całą sesję dawaj localhost, a nie każdej stronie, którą Claude odwiedza.
  4. Logowanie robisz sam. Gdy Claude trafi na stronę logowania albo CAPTCHA, zatrzymuje się i prosi, żebyś zajął się nią ręcznie. Hasła nigdy nie wpisuj do polecenia.
  5. Okienka alert. Okno alert blokuje przeglądarkę i Claude przestaje dostawać od niej odpowiedzi. Zamknij je sam i powiedz mu, żeby kontynuował.
  6. Nagrania. GIF zapisuje wszystko, co widać w oknie, także dane z zalogowanych stron. Obejrzyj go, zanim komuś wyślesz.

Następny krok

Gdy przegląd przejdzie, poproś o commit, na przykład "Galeria: fokus wraca na kafelek, awatar bez leniwego ładowania". Potem zamknij pętlę obrazu z lekcji 3_2, tym razem bez własnych zrzutów:

Otwórz localhost:3000/gallery, kliknij pierwsze zdjęcie, zapisz zrzut
otwartego okna na dysku i podaj ścieżkę pliku. Porównaj zrzut ze
szkicem szkice/galeria.jpg i wypisz różnice. Niczego nie poprawiaj.

Część różnic będzie zamierzona, bo polubień i komentarzy z lekcji 3_3 nie było na pierwszym szkicu. Wybierz z listy jedną różnicę, która nie powinna zostać, i popraw ją kolejną rundą pętli.

W edytorze poniżej czeka siatka z oknem i przełącznikiem zwracania fokusu. Przejdź do kafelka klawiszem Tab, otwórz go Enterem, zamknij Escape i zobacz, gdzie ląduje fokus z przełącznikiem i bez niego.

Zapamiętaj: makieta mówi, dokąd płyniesz, zrzut mówi, gdzie jesteś, a Claude in Chrome sam wspina się do bocianiego gniazda, żeby to sprawdzić; Ty decydujesz, nad którymi portami wolno mu się rozglądać.

Kod do tej lekcji: App.jsx
// Fokus po zamknięciu okna: wraca na kafelek czy ucieka na początek strony?
// To właśnie sprawdzał Claude in Chrome. Przejdź do kafelka klawiszem Tab,
// otwórz go Enterem i zamknij Escape, z przełącznikiem i bez niego.
import { useEffect, useRef, useState } from 'react';

const photos = [
  {
    id: 'zachod-na-plazy',
    src: 'https://images.unsplash.com/photo-1507525428034-b723cf961d3e?w=600',
    alt: 'Fale na piaszczystej plaży o zachodzie słońca',
    caption: 'Tu zakopaliśmy skrzynię',
  },
  {
    id: 'fale-z-gory',
    src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
    alt: 'Turkusowe fale przy białej plaży widziane z lotu ptaka',
    caption: 'Zatoka z bocianiego gniazda',
  },
  {
    id: 'zaglowka-noca',
    src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
    alt: 'Mała żaglówka na spokojnym morzu pod rozgwieżdżonym niebem',
    caption: 'Nocna wachta',
  },
  {
    id: 'palmy',
    src: 'https://images.unsplash.com/photo-1519046904884-53103b34b206?w=600',
    alt: 'Palmy i słomkowy parasol na białej plaży',
    caption: 'Wyspa z mapy',
  },
];

// Opis elementu, który ma teraz fokus
function describeFocus(element) {
  if (!element || element === document.body) return 'body, czyli początek strony';
  if (element.dataset.caption) return 'kafelek "' + 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="Zamknij podgląd"
            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, czyli początek strony');
  const openerRef = useRef(null);
  const selected = photos.find((photo) => photo.id === selectedId) ?? null;

  // Odczyt fokusu przy każdym przejściu klawiszem 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();
    // Fokus na body nie wywołuje focusin, więc sprawdzamy go po chwili
    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)}
        />
        Zwracaj fokus na kafelek, który otworzył okno
      </label>

      <p className="mb-3 rounded bg-white p-2 text-sm">
        Fokus jest teraz na: <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>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Wysyłasz Claude makietę i zrzut obecnej strony. Co jeszcze powinno stać w poleceniu?

  2. 2. Claude in Chrome korzysta z zalogowanych sesji Twojej przeglądarki. Gdzie go wysyłasz?

To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Układanie w pionie

    Uporządkuj kroki pętli obrazu:

  1. PytanieQuiz: Co dopisać do zrzutu
  2. Ułóż w kolejnościSortowanie: Pętla obrazu
  3. PytanieQuiz: Claude in Chrome i zalogowane sesje
  4. PytanieQuiz: Kiedy zrzut zamiast opisu
  5. PytanieQuiz: Fokus po zamknięciu okna
  6. Projekt do wysłaniaWyślij Treasure Gallery do mentora
  7. WideoPodsumowanie modułu

Przydatne artykuły