Kurs vibe coding z Claude Code · Moduł 3: Klon Twittera
Szczur w ładowni: debugowanie z Claude Code
W tej lekcji10
Po lekcji 2_5 wydałeś Claude krótkie polecenie: "Przy najnowszym wpisie kapitana pokaż znaczek Nowy". Claude włożył znaczek do wpisu przez children z lekcji 2_4, build i lint przeszły, a Ty zrobiłeś commit. Następnego dnia polubiłeś trzy razy swój wpis o kursie na zachód, dodałeś drugi wpis i zobaczyłeś coś dziwnego: nowy wpis ma trzy polubienia, a stary zero. W konsoli przeglądarki ani jednego błędu, w terminalu tylko GET /feed 200. Błąd, który nie krzyczy, to szczur w ładowni: słychać go tylko wtedy, gdy wiesz, gdzie nasłuchiwać.
Najpierw odtwórz
Zanim cokolwiek napiszesz do Claude, sprawdź, czy umiesz wywołać błąd na zawołanie. Zapisz kroki, które za każdym razem kończą się tak samo:
1. Otwórz /feed i dodaj wpis A.
2. Kliknij Polub przy wpisie A trzy razy.
3. Dodaj wpis B.
Oczekiwane: B ma Polub (0), A ma Polub (3).
Faktyczne: B ma Polub (3), A ma Polub (0).Te pięć linii to najcenniejsza część zgłoszenia. Mówią, co zrobić, co powinno się stać i co dzieje się naprawdę, więc Claude nie musi zgadywać. Do tego te same kroki staną się sprawdzianem: po poprawce powtórzysz je i od razu zobaczysz, czy szczur zniknął.
Jak podać Claude błąd
Zasada z lekcji 0_5 brzmi: podaj zamiast opisywać. Przy błędach masz trzy rodzaje dowodów, a wybór zależy od tego, jak błąd się objawia:
- komunikat: gdy coś krzyczy, kopiujesz dokładny tekst z terminala albo z panelu Console w narzędziach deweloperskich przeglądarki, razem z nazwą pliku i numerem linii, a nie własne streszczenie. Wynik komendy najprościej dołączyć przez wykrzyknik z lekcji 0_3, na przykład
! npm run build; - kroki odtworzenia: gdy błąd jest cichy, jak dzisiaj, dajesz kroki, wynik oczekiwany i faktyczny;
- zrzut ekranu: gdy chodzi o wygląd, zapisujesz zrzut w folderze projektu i podajesz w poleceniu jego ścieżkę. Po wszystkim usuń plik, żeby nie trafił do commita.
Uwaga na nazwę: komenda /debug w Claude Code służy do kłopotów z samym Claude Code (włącza zapis jego dziennika), a nie do błędów w Twojej aplikacji.
Polecenie dla Claude Code
Dziś prosisz o hipotezy, czyli możliwe przyczyny, a nie o naprawę. Kto naprawia przed zrozumieniem przyczyny, często łata objaw.
Polecenie dla Claude Code:
Błąd na /feed: polubienia przeskakują na nowy wpis. Kroki: 1) dodaj
wpis A, 2) kliknij Polub przy A trzy razy, 3) dodaj wpis B.
Oczekiwane: B ma Polub (0), A ma Polub (3). Faktyczne: B ma Polub (3),
A ma Polub (0). Konsola i terminal bez błędów, zrzut w pliku
zrzut-polubienia.png. Błąd pojawił się po ostatnim commicie ze
znaczkiem Nowy w @components/Feed.tsx. Podaj trzy hipotezy, od
najbardziej prawdopodobnej, i dla każdej sposób sprawdzenia bez
zmiany kodu. Niczego jeszcze nie poprawiaj.Polecenie ma klocki z lekcji 0_5: objaw, kroki, miejsce i wskazówkę, kiedy błąd się pojawił. Ostatnie zdanie zatrzymuje Claude przed łataniem, a w trybie Manual każda edycja i tak czeka na Twoją zgodę.
Co odpowiedział Claude: hipotezy
Twoja odpowiedź będzie miała inne słowa, ale podobny kształt:
1. Klucz z indeksu w Feed.tsx. Przy znaczku Nowy map dostał index
i <li key={index}>. Nowy wpis na górze przejmuje klucz 0, a React
zostawia stan LikeButton przy kluczu, nie przy wpisie.
Sprawdzenie: linia z key w Feed.tsx i diff ostatniego commita.
2. LikeButton czyta initialLikes tylko przy pierwszym renderze.
Sprawdzenie: useState(initialLikes) w LikeButton.tsx.
3. Polubienia zapisują się w localStorage pod numerem pozycji.
Sprawdzenie: wyszukaj localStorage w components/.Hipoteza druga opisuje prawdziwą cechę przycisku, ale sama błędu nie tłumaczy, bo przed znaczkiem wszystko działało. Trzecią wykluczysz w minutę: wyszukiwanie w projekcie w Cursorze pokaże localStorage tylko w Feed.tsx, przy wpisach, a nie przy polubieniach. Zostaje pierwsza.
Sprawdź jedną hipotezę
Sprawdzasz bez zmieniania kodu. Poproś Claude: "Pokaż diff ostatniego commita dla Feed.tsx" albo wpisz sam w sesji ! git show HEAD -- components/Feed.tsx, czyli ostatni commit ograniczony do jednego pliku. Szukana zmiana wygląda tak:
- {posts.map((post) => (
- <li key={post.id}>
+ {posts.map((post, index) => (
+ <li key={index}>Claude potrzebował index do znaczka i przy okazji przestawił klucz. Z lekcji 2_2 wiesz, że indeks nie nadaje się na klucz, bo zmienia się, gdy nowy wpis wskoczy na górę. Teraz widzisz skutek: key mówi Reactowi, który element jest którym między renderami. Wpis B dostaje klucz 0, który chwilę wcześniej należał do A, więc React oddaje mu przycisk A razem z jego stanem. Dokumentacja Reacta ostrzega, że indeks jako klucz często prowadzi do subtelnych i mylących błędów. Hipoteza potwierdzona.
Poprawka przyczyny
Teraz dopiero naprawa, nazwana wprost i wąska:
Hipoteza 1 potwierdzona. W @components/Feed.tsx przywróć key={post.id},
a index zostaw tylko do znaczka Nowy. Nic więcej nie zmieniaj.
Potem npm run lint i npx tsc --noEmit, pokaż wyniki.Diff ma jedną linię: <li key={post.id}>. Powtórz kroki z początku lekcji: B ma zero, A ma trzy, a znaczek Nowy wędruje na najnowszy wpis. Kroki odtworzenia zamieniły się w test, który właśnie przeszedł.
Typowy błąd agenta: naprawa przez ukrycie objawu
Gdy przyczyna nie jest oczywista, agent bywa kuszony, żeby uciszyć objaw. Przy tym błędzie Claude może zaproponować losowy klucz i meldunek "polubienia już nie przeskakują":
- <li key={index}>
+ // eslint-disable-next-line react-hooks/purity
+ <li key={Math.random()}>Meldunek jest prawdziwy, a naprawa zła. Losowy klucz zmienia się przy każdym renderze, więc React za każdym razem buduje listę od zera. Wystarczy wpisać jedną literę w pole, a wszystkie polubienia wpisów kapitana spadną do zera. Lint zgłasza tu błąd Cannot call impure function during render, a komentarz eslint-disable go wycisza. Ta sama sztuczka ma trzy inne przebrania: try/catch z pustym catch, który połyka błąd, znak ?. wstawiony tam, gdzie wartość nie powinna być pusta, i znane z lekcji 1_4 as any albo @ts-ignore. Rozpoznasz je po tym, że poprawka nie nazywa przyczyny. Zapytaj wtedy: "Jaka była przyczyna i dlaczego ta zmiana ją usuwa?".
Ręka na sterze
Debugowanie to dobry moment na trzy nawyki z lekcji 0_5, tym razem w praktyce:
- Esc, gdy Claude zbacza. Jeśli zamiast hipotez zaczyna przepisywać
LikeButtonna zapis wlocalStorage, naciśnij Esc. Claude przerwie, zachowa to, co zrobił, i poczeka na wskazówkę, a/rewindcofnie edycje, jeśli jakieś już zapisał. - Po dwóch nieudanych poprawkach
/clear. Jeśli dwie poprawki z rzędu nie pomogły, trzecia tylko dokłada się do rozmowy pełnej złych tropów. Zacznij nową rozmowę jednym poleceniem, które zbiera, czego się dowiedziałeś: objaw, kroki, wykluczone hipotezy i zakaz wyciszania lintera. - Wyższy wysiłek przy trudnym błędzie. Domyślny poziom wysiłku (effort) to
medium(stan na listopad 2026). Dokumentacja radzi podnieść go komendą/effort highalbo/effort xhigh, gdy wynik zależy od przypadków łatwych do przeoczenia, na przykład przy błędzie w kodzie, którego nie pisałeś. Gdy trudna jest tylko jedna wiadomość, dopisz do niej słowoultrathink: prosi o głębsze myślenie w tej jednej turze i nie zmienia ustawienia sesji.
Przegląd kapitana
Zanim zrobisz commit, sprawdź:
- Poprawka nazywa przyczynę. W diffie zmieniła się linia z
key, a nie przycisk, efekt czy dane wlocalStorage. - Kroki przechodzą. Powtórzone kroki odtworzenia dają wynik oczekiwany, także po dodaniu trzeciego wpisu.
- Nic nie zostało wyciszone. W diffie nie ma
eslint-disable,@ts-ignore, pustegocatchani nowych?.. - Zrzut poza repozytorium.
zrzut-polubienia.pngnie stoi na liście w Source Control.
Następny krok
Poproś o commit z opisem w rodzaju "Klucz wpisu z id: polubienia nie przeskakują na nowy wpis". Ten błąd zrobiłeś już raz, więc zasługuje na linię w regulaminie okrętu:
Dopisz do części Pułapki w @CLAUDE.md jedną linię: klucz elementu
listy tylko ze stałego id, nigdy z indeksu map. Nic więcej nie zmieniaj.Następnym razem Claude trafi w tę zasadę bez przypominania. A w lekcji 2_9 zobaczysz, jak świeży recenzent wyłapuje takie zmiany, zanim trafią do commita. W edytorze poniżej czeka oś z przełącznikiem klucza: odtwórz błąd na kluczu z indeksu, a potem powtórz kroki na kluczu z id.
Pamiętaj: szczura w ładowni łapiesz po śladach, a nie zatykając uszy, żeby go nie słyszeć.
Kod do tej lekcji: App.jsx
// Debugowanie: polubienia, które przeskakują na nowy wpis.
// Kroki odtworzenia: 1) dodaj wpis A, 2) kliknij Polub przy A trzy razy,
// 3) dodaj wpis B. Oczekiwane: B ma 0, A ma 3.
// Najpierw odtwórz błąd na kluczu z indeksu, potem przełącz na klucz z id
// i powtórz te same kroki.
import { useState } from 'react';
import LikeButton from './components/LikeButton';
export default function App() {
const [posts, setPosts] = useState([]);
const [draft, setDraft] = useState('');
const [indexKey, setIndexKey] = useState(true);
const handleSubmit = (e) => {
e.preventDefault();
if (!draft.trim()) return;
const newPost = { id: String(Date.now()), content: draft.trim() };
setPosts([newPost, ...posts]);
setDraft('');
};
return (
<div className="min-h-screen bg-gray-50 p-6 text-gray-900">
<h1 className="text-3xl font-bold">Oś kapitana</h1>
<label className="mt-4 flex items-center gap-2 text-sm">
<input type="checkbox" checked={indexKey} onChange={(e) => setIndexKey(e.target.checked)} />
Klucz z indeksu, key={'{index}'} (wersja z błędem)
</label>
<form onSubmit={handleSubmit} className="mt-4 rounded-lg border border-gray-300 bg-white p-4">
<textarea
value={draft}
onChange={(e) => setDraft(e.target.value)}
rows={2}
placeholder="Wpis A, potem wpis B"
className="w-full rounded border border-gray-300 p-2"
/>
<button type="submit" className="mt-2 rounded bg-blue-600 px-4 py-2 font-semibold text-white">
Wyślij
</button>
</form>
<ul className="mt-4 space-y-4">
{posts.map((post, index) => (
// Tu siedzi szczur: klucz mówi Reactowi, który element jest którym
<li key={indexKey ? index : post.id} className="rounded-lg border border-gray-300 bg-white p-4">
<p>{post.content}</p>
<LikeButton initialLikes={0} />
{index === 0 && (
<span className="ml-2 rounded bg-amber-100 px-2 py-1 text-xs font-bold text-amber-800">
Nowy
</span>
)}
</li>
))}
</ul>
</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. Dwa razy poprosiłeś Claude o poprawkę tego samego błędu i nadal jest źle. Co robisz?
2. Który meldunek Claude o naprawie przeskakujących polubień powinien Cię zaniepokoić?
Zadania praktyczne w grze
- Układanie w pionie
Uporządkuj kroki debugowania cichego błędu z Claude Code: