Kurs vibe coding z Claude Code · Moduł 1: Claude Code i Cursor

Anatomia dobrego polecenia: cel, miejsce, ograniczenia, sprawdzian

7 min czytania ·
W tej lekcji12

Witaj ponownie! Na stronie stoi już sekcja "Nasza załoga", a Ty wiesz, co Claude widzi i czego nie wie. Dziś zajmiemy się samym rozkazem: z jakich części składa się polecenie, które Claude wykona dobrze za pierwszym razem, i co robić, gdy rozmowa idzie w złą stronę.

Problem: poprawianie zgadywanki trwa dłużej niż dobry rozkaz

"Popraw stronę" to dla Claude zagadka. Nie wie, co ma się zmienić, w którym pliku, czego nie ruszać ani kiedy skończyć, więc zgaduje. Czasem trafi, częściej zrobi coś po swojemu, a Ty spędzisz trzy rundy na poprawkach. Dokumentacja Claude Code zwraca uwagę na jeszcze jedną rzecz: Claude czyta prośbę ostrożnie i buduje najmniejszą rzecz, która ją spełnia, bo nie widzi, jak dużego efektu się spodziewasz. Jeśli chcesz więcej, musisz to powiedzieć. Dwie minuty nad poleceniem oszczędzają kwadrans poprawek.

Cztery klocki dobrego polecenia

W lekcji 0_1 poznałeś trzy części polecenia: cel, miejsce i ograniczenia. Dziś dochodzi czwarta, która zamyka rozkaz:

KlocekPytanie, na które odpowiadaPrzykład
Celco ma powstać i po co?karty załogi mają wyglądać jak stare pergaminy
Miejscew którym pliku i w której jego części?@pirate.html, tylko reguła CSS kart
Ograniczeniaczego nie ruszać i czego nie używać?bez nowych plików i bibliotek, nagłówek zostaje
Sprawdzianpo czym poznamy, że gotowe, i jak Claude ma to udowodnić?pokaż zmienioną regułę i wynik ls

Przepis kapitana: pisz klocki w tej kolejności. Cel na początku, bo od niego zależy cała reszta. Miejsce i ograniczenia potem, bo zawężają drogę. Sprawdzian na końcu, bo mówi, kiedy rejs jest skończony. Właśnie sprawdzian początkujący pomijają najczęściej, a jest najcenniejszy: dokumentacja radzi dać Claude coś, co da się uruchomić i co zwraca jasny wynik, i zawsze prosić o dowód, czyli komendę i jej wynik. Meldunek "zrobione" bez dowodu mówi niewiele, o czym przekonałeś się w lekcji 0_4.

Miejsce wskazuj znakiem @

Zamiast pisać "w pliku z piracką stroną", wpisz w poleceniu znak @ i ścieżkę pliku. Po wpisaniu @ Claude Code podpowie pasujące pliki, a Tab albo Enter wstawi zaznaczoną ścieżkę. Przykładowe pytanie z takim wskazaniem:

Wyjaśnij, co robią reguły CSS w @pirate.html

Zapis @pirate.html dołącza treść pliku do rozmowy, więc Claude nie musi go szukać ani zgadywać, o który plik chodzi. Sam plik się przez to nie zmienia: to tylko wskazanie. W jednym poleceniu możesz wskazać kilka plików, a @ z nazwą folderu dołącza listę jego plików, bez ich treści.

Podaj zamiast opisywać

Ta sama zasada działa szerzej: jeśli masz to, czego Claude potrzebuje, podaj mu to, zamiast opisywać słowami. Masz trzy sposoby:

  • plik: @ i ścieżka, jak wyżej;
  • zrzut ekranu: Claude nie widzi przeglądarki, ale zrozumie obraz. Najprościej zapisz zrzut w folderze projektu i podaj w poleceniu jego ścieżkę, na przykład "Spójrz na zrzut karty.png: karty nachodzą na siebie. Popraw to w @pirate.html";
  • wynik komendy: komenda z wykrzyknikiem z lekcji 0_3, na przykład ! ls, dopisuje do rozmowy komendę i jej wynik, a Claude od razu go skomentuje.

Gdy sam nie wiesz, czego chcesz

Czasem masz tylko mglisty pomysł. Wtedy nie wymyślaj polecenia na siłę, tylko poproś Claude o wywiad. Claude zada Ci pytania o sprawy, których jeszcze nie przemyślałeś, a odpowiedzi spisze w specyfikacji, czyli pliku, który opisuje, co ma powstać i po czym poznać, że jest gotowe. Na przykład:

Chcę dodać do pirate.html minigrę "Znajdź skarb", ale jeszcze jej nie
przemyślałem. Przeprowadź ze mną wywiad, aż będziesz w stanie napisać
specyfikację, a potem zapisz ją w pliku SPEC.md.

Claude będzie pytać, często z gotowymi odpowiedziami do wyboru: ile pól ma plansza, co się dzieje po trafieniu, czego gra na pewno nie robi. Sam wywiad niczego nie buduje, a w trybie Manual Claude zapyta o zgodę dopiero przed zapisaniem SPEC.md. Gdy plik powstanie, wpisz /clear: ta komenda zaczyna nową rozmowę, a stara zostaje do wznowienia. Budowę zacznij w świeżej rozmowie od polecenia z @SPEC.md. Czysty kontekst i spisana definicja "gotowe" działają lepiej niż długa rozmowa pełna pomysłów, które po drodze odrzuciłeś.

Małe kroki i ręka na sterze

Duże zadanie dziel na kroki i wydawaj je po jednym. Potem patrz, jak Claude pracuje:

  • obserwuj pierwszą minutę: wtedy najłatwiej zauważyć, że Claude płynie w złą stronę;
  • Esc, gdy zbacza: przerywa pracę, zachowuje to, co już zrobione, i czeka na Twoją wskazówkę;
  • po dwóch nieudanych poprawkach /clear: jeśli dwa razy poprawiałeś to samo i nadal jest źle, trzecia poprawka tylko dokłada się do rozmowy, w której są już dwie nieudane próby. Lepiej zacząć od nowa jednym poleceniem, które zbiera wszystko, czego się po drodze dowiedziałeś.

Czego już nie robić

Stare poradniki pełne są sztuczek, które dziś nie pomagają. Oficjalne dobre praktyki Claude Code mówią o nich wprost:

Stara radaDlaczego już nie
WIELKIE LITERY i słowo WAŻNEobecne modele wykonują zwykłe zdanie, a nadmiar nacisku sprawia, że Claude stosuje regułę przesadnie
"think hard", "be thorough"to zwykły tekst, a nie przełącznik; tym, jak głęboko Claude myśli, steruje osobne ustawienie wysiłku (effort), które poznasz w dalszych lokacjach
"nie bądź leniwy", "nie przestawaj"takie zdania częściej powodują nadgorliwość, niż pomagają; zamiast nich daj Claude sprawdzian do zaliczenia

Rada kapitana: pisz spokojnie i konkretnie, jak do doświadczonego bosmana.

Styl odpowiedzi do nauki

Uczysz się czytać kod, więc przyda Ci się, żeby Claude tłumaczył swoje decyzje. Służy do tego styl odpowiedzi Explanatory, który włączysz komendą w sesji:

/output-style explanatory

Od następnej wiadomości Claude dopisuje w rozmowie krótkie bloki Insight z objaśnieniem, dlaczego napisał kod tak, a nie inaczej. Objaśnienia trafiają tylko do rozmowy, a nie do Twoich plików jako komentarze. Wybór zapisuje się w lokalnych ustawieniach projektu, więc obowiązuje też w kolejnych sesjach w tym folderze. Do zwykłego stylu wrócisz komendą /output-style default. Jest też styl Learning, w którym Claude dodatkowo zostawia Ci kilka linii kodu do napisania samemu; to opcja na później, bo ten kurs ćwiczy przede wszystkim dowodzenie i czytanie.

Przed i po: sekcja "Nasza załoga"

Tak wygląda polecenie, które zostawia Claude za dużo do zgadywania:

Popraw sekcję załogi, żeby była ładniejsza.

Poza ogólnym tematem brakuje tu wszystkich klocków. "Ładniejsza" może oznaczać nowe kolory, obrazki, animacje albo zupełnie inny układ, a Claude może przy okazji założyć nowy plik ze stylami albo zmienić nagłówek. Ta sama prośba ułożona z czterech klocków wygląda tak:

Polecenie dla Claude Code:

Cel: karty w sekcji "Nasza załoga" mają wyglądać jak stare pergaminy:
kremowe tło, brązowa ramka i zaokrąglone rogi.
Miejsce: @pirate.html, tylko reguła CSS .crew-card w znaczniku <style>.
Ograniczenia: nie zmieniaj treści kart ani nagłówka "Ahoj Piraci!",
nie twórz nowych plików i nie dodawaj bibliotek.
Sprawdzian: na koniec pokaż zmienioną regułę i wynik komendy ls, żebym
widział, że w folderze nadal jest tylko pirate.html.

Etykiety "Cel:", "Miejsce:" i pozostałe pomagają na początku nauki. Gdy klocki wejdą Ci w nawyk, napiszesz to samo zwykłymi zdaniami.

Co napisał Claude

Otwórz pirate.html w Cursorze i znajdź w znaczniku <style> regułę kart. Twoje kolory mogą się różnić odcieniem, ale budowa będzie podobna:

.crew-card {
  border: 3px solid #8b5a2b;
  border-radius: 12px;
  background-color: #f5e6c8;
  padding: 12px;
  margin: 12px 0;
}

Kropka przed crew-card oznacza klasę: reguła dotyczy każdego elementu z class="crew-card", czyli wszystkich trzech kart. border ustawia ramkę: grubość, rodzaj linii i kolor, tu brązowy. border-radius zaokrągla rogi, a background-color nadaje kremowe tło. Reguła nie zmienia treści kart ani nagłówka h1: dotyczy tylko wyglądu elementów z klasą crew-card.

Przegląd kapitana

  1. Jeden plik: zmienił się tylko pirate.html, a wynik ls od Claude to potwierdza. Przeczytaj ten wynik sam, zamiast wierzyć podsumowaniu.
  2. Ograniczenia: nagłówek nadal jest czerwony, a imiona i opisy w kartach są takie jak przedtem.
  3. Sprawdzian: Claude pokazał regułę i wynik komendy. Jeśli tego nie zrobił, poproś o to.
  4. Typowy błąd: agent "przy okazji" poprawia inne miejsca, na przykład czcionkę całej strony albo kolor nagłówka. W trybie Manual zauważysz to w propozycji zmiany, zanim się zgodzisz; odpowiedz wtedy No i doprecyzuj polecenie.

Na koniec otwórz stronę w przeglądarce: karty powinny mieć kremowe tło i zaokrąglone rogi.

Następny krok

Strona rośnie, więc masz coraz więcej do stracenia. W lekcji 0_6 rozepniesz siatkę bezpieczeństwa: poznasz granice /rewind i zaczniesz prowadzić dziennik pokładowy w Gicie.

Pamiętaj: dobry rozkaz mówi, dokąd płyniemy, którędy, czego unikać i po czym poznamy port.

Kod do tej lekcji: polecenie.md
# Polecenie przed i po

## Przed: Claude musi zgadywać

Popraw sekcję załogi, żeby była ładniejsza.

Brakuje celu (co znaczy "ładniejsza"?), miejsca (który plik i która
reguła?), ograniczeń (czego nie ruszać?) i sprawdzianu (po czym poznać,
że gotowe?).

## Po: cztery klocki w kolejności z przepisu kapitana

Cel: karty w sekcji "Nasza załoga" mają wyglądać jak stare pergaminy:
kremowe tło, brązowa ramka i zaokrąglone rogi.
Miejsce: @pirate.html, tylko reguła CSS .crew-card w znaczniku <style>.
Ograniczenia: nie zmieniaj treści kart ani nagłówka "Ahoj Piraci!",
nie twórz nowych plików i nie dodawaj bibliotek.
Sprawdzian: na koniec pokaż zmienioną regułę i wynik komendy ls, żebym
widział, że w folderze nadal jest tylko pirate.html.

## Twoja kolej

Napisz poniżej własne polecenie z czterech klocków, na przykład o stopce
strony z napisem "Czarna Perła".

Cel:
Miejsce:
Ograniczenia:
Sprawdzian:

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. Polecenie brzmi: "W @pirate.html dodaj pod sekcją załogi stopkę z napisem Czarna Perła. Nie zmieniaj innych sekcji i nie twórz nowych plików." Którego klocka brakuje?

  2. 2. Co robi zapis @pirate.html w poleceniu dla Claude Code?

  3. 3. Polecenie A: "Popraw sekcję załogi, żeby była ładniejsza." Polecenie B: "Karty w sekcji Nasza załoga mają wyglądać jak pergaminy. Zmień tylko regułę .crew-card w @pirate.html, nie ruszaj treści kart ani nagłówka, nie twórz plików. Na koniec pokaż regułę i wynik ls." Które jest lepsze i dlaczego?

  4. 4. Dwa razy poprawiałeś Claude w tej samej sprawie i nadal jest źle. Co robisz?

  5. 5. Co zmienia komenda /output-style explanatory?

Zadania praktyczne w grze

  • Układanie w pionie

    Nie wiesz jeszcze, czego chcesz. Ułóż kroki od pomysłu do budowy:

  1. PytanieQuiz: Brakujący klocek polecenia
  2. PytanieQuiz: Znak @ w poleceniu
  3. Ułóż w kolejnościSortowanie: Od pomysłu do specyfikacji
  4. PytanieQuiz: Które polecenie jest lepsze
  5. PytanieQuiz: Druga nieudana poprawka
  6. PytanieQuiz: Styl odpowiedzi Explanatory

Przydatne artykuły