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

Instalacja Claude Code i pierwsze polecenie

9 min czytania ·
W tej lekcji12

Ahoj! Okręt już stoi w porcie: Cursor działa. Brakuje tylko załogi. W tej lekcji zaciągniesz Claude Code na pokład, wydasz pierwszy rozkaz i sprawdzisz w Cursorze, co naprawdę trafiło do ładowni.

Problem: rozkaz bez kontroli to hazard

Agent, który sam pisze pliki, jest potężny, ale na pierwszym rejsie chcesz widzieć każdy jego ruch, zanim go zatwierdzisz. Dlatego dziś idziemy powoli: najpierw instalacja, potem tryb, w którym Claude pyta o zgodę przed każdą zmianą, a dopiero na końcu pierwsze polecenie i nauka cofania.

Krok 1: port, czyli folder projektu

Claude Code pracuje w folderze, w którym go uruchomisz: widzi pliki tego folderu i jego podfolderów, a do plików spoza niego sięga tylko za Twoją zgodą. Ten folder wyznacza więc granice jego pracy.

Utwórz na komputerze pusty folder piracki_statek, na przykład w Dokumentach, zwykłym menedżerem plików. Potem w Cursorze wybierz File, Open Folder i wskaż ten folder. Explorer po lewej pokaże pusty projekt. Otwórz terminal skrótem z poprzedniej lekcji: Control+` na Macu, Ctrl+` na Windowsie i Linuksie.

Krok 2: instalacja Claude Code

Zalecaną metodą jest instalator natywny, który sam aktualizuje Claude Code w tle. Na macOS, Linuksie i w WSL (Linux uruchomiony w Windowsie) wpisz w terminalu Cursora:

curl -fsSL https://claude.ai/install.sh | bash

Ta komenda pobiera oficjalny skrypt instalacyjny z claude.ai i od razu go uruchamia. Tak instaluj programy tylko z adresu producenta, któremu ufasz: w lekcji 0_3 zobaczysz, dlaczego podobne komendy z nieznanych adresów są czerwoną flagą. Instalator nie pokazuje postępu, więc poczekaj, aż skończy.

Na Windowsie sprawdź najpierw, w której powłoce jesteś: PowerShell pokazuje na początku linii litery PS przed ścieżką, a CMD samą ścieżkę. W PowerShell wpisz:

irm https://claude.ai/install.ps1 | iex

Tutaj irm pobiera skrypt, a iex go uruchamia. W CMD użyj zamiast tego komendy curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Na Windowsie zalecany jest też Git for Windows: daje Claude narzędzie Bash, a bez niego Claude Code korzysta z PowerShell. W WSL Git for Windows nie jest potrzebny.

Gdy instalator skończy, otwórz nowy terminal, na przykład skrótem Control+Shift+` na Macu albo Ctrl+Shift+` na Windowsie i Linuksie, i sprawdź instalację:

claude --version

Działająca instalacja wypisuje numer wersji, a po nim napis (Claude Code). Jeśli terminal odpowiada, że nie zna komendy claude (command not found albo is not recognized), katalog instalacji nie trafił jeszcze do PATH, czyli listy miejsc, w których terminal szuka programów. Zamknij terminal i otwórz nowy. Jeśli to nie pomoże, instalator na końcu swojej pracy wypisuje gotową poprawkę w sekcji Setup notes.

Krok 3: pierwsza sesja i logowanie

W terminalu Cursora, w folderze piracki_statek, wpisz claude i naciśnij Enter. Przy pierwszym uruchomieniu Claude Code poprosi o logowanie: otworzy się przeglądarka, w której logujesz się kontem Claude z płatnym planem albo kontem Claude Console. Dane logowania zostają zapisane, więc kolejne sesje startują bez tego kroku. Claude Code może też zapytać, czy ufasz temu folderowi: to Twój pusty port, więc potwierdź.

Nad polem polecenia zobaczysz wersję, nazwę modelu i katalog roboczy. Sprawdź katalog: ścieżka musi kończyć się na piracki_statek. Jeśli widzisz inny folder, wyjdź z sesji komendą /exit i otwórz w Cursorze właściwy folder. Komenda /help wypisze listę dostępnych komend.

Krok 4: tryb Manual na pierwszy rejs

Tryb uprawnień decyduje, co Claude może zrobić bez pytania. Sesja w terminalu startuje w trybie auto: Claude zapisuje pliki i uruchamia komendy sam, a osobny model w tle ocenia jego akcje i blokuje te ryzykowne. To wygodne, ale na pierwszym rejsie chcesz widzieć każdy ruch załogi.

Naciśnij Shift+Tab. Z trybu auto pierwsze naciśnięcie przełącza sesję na Manual, co pokaże wskaźnik trybu. Kolejne naciśnięcia przechodzą przez acceptEdits (pliki zapisywane bez pytania) i plan (samo planowanie), więc jeśli przeskoczysz, naciskaj dalej, aż znów zobaczysz Manual. W tym trybie Claude pyta Cię przed każdą zmianą pliku i przed komendami, które coś zmieniają.

Wybór dotyczy bieżącej sesji: nowa sesja znów wystartuje w trybie auto, więc na początku każdej sprawdź wskaźnik. Rada kapitana: zostań przy Manual przez pierwsze lokacje, a na auto przejdź, gdy czytanie zmian wejdzie Ci w krew.

Krok 5: najpierw pytanie, potem rozkaz

Zacznij od pytania, które niczego nie zmienia: wpisz w sesji "Co jest w tym folderze?". Claude przejrzy folder i odpowie, że jest pusty. Pytanie tylko czyta, a polecenie zmienia pliki, dlatego o zgodę Claude zapyta dopiero przy poleceniu.

Teraz rozkaz z poprzedniej lekcji. Ma cel, miejsce i ograniczenia, więc Claude nie musi niczego zgadywać:

Polecenie dla Claude Code:

Stwórz w tym folderze plik pirate.html: strona z nagłówkiem "Ahoj Piraci!"
w kolorze czerwonym i jednym akapitem powitania. Style wpisz w znaczniku
<style> w tym samym pliku. Nie twórz innych plików.

W trybie Manual Claude zatrzyma się przed zapisaniem pliku, pokaże, co zamierza zrobić, i zapyta o zgodę. Przeczytaj propozycję, strzałkami wskaż Yes i naciśnij Enter. Opcje, które pozwalają na więcej niż ten jeden raz, na przykład do końca sesji, na razie pomijaj. Gdy plik powstanie, pojawi się w Explorerze.

Co napisał Claude

Kliknij pirate.html w Explorerze, żeby otworzyć go w edytorze. Twój plik może różnić się szczegółami, na przykład treścią akapitu, ale budowa będzie podobna. Czytaj od góry. Pierwsza część to szkielet dokumentu:

<!DOCTYPE html>
<html lang="pl">
<head>
  <meta charset="UTF-8">
  <title>Ahoj Piraci!</title>

<!DOCTYPE html> mówi przeglądarce, że to dokument HTML. lang="pl" oznacza stronę po polsku, <head> zawiera informacje dla przeglądarki, a <meta charset="UTF-8"> sprawia, że polskie litery wyświetlą się poprawnie. <title> to napis na karcie przeglądarki, a nie na samej stronie.

Dalej, wciąż w <head>, stoi znacznik <style> z regułą CSS. CSS to język, który opisuje wygląd strony. Reguła składa się z selektora, czyli tego, do czego się odnosi, i właściwości w nawiasach klamrowych:

  <style>
    h1 {
      color: red;
    }
  </style>
</head>

Selektor h1 wybiera nagłówki pierwszego stopnia, a color: red nadaje ich tekstowi czerwony kolor. Reguła nie zmienia akapitu ani tła strony: dotyczy tylko nagłówków h1. Zamykający </head> kończy część przeznaczoną dla przeglądarki.

Ostatnia część to <body>, czyli treść, którą naprawdę widać na stronie, z nagłówkiem i akapitem z Twojego polecenia:

<body>
  <h1>Ahoj Piraci!</h1>
  <p>Witaj na pokładzie! Tu zaczyna się nasza przygoda.</p>
</body>
</html>

<h1> to nagłówek z dokładnie tym tekstem, o który prosiłeś, a <p> to akapit. Zamykające </body> i </html> kończą dokument. Żeby zobaczyć stronę, kliknij dwukrotnie pirate.html w zwykłym menedżerze plików: otworzy się w przeglądarce.

Przegląd kapitana

Zanim popłyniesz dalej, sprawdź w Cursorze cztery rzeczy:

  1. Plik leży w piracki_statek, a nie w innym folderze.
  2. Powstał jeden plik, tak jak prosiłeś. Typowy błąd agenta to robienie więcej, niż kazano: dodatkowy style.css, README albo sekcje, o które nie prosiłeś. Zauważysz to w Explorerze i w treści pliku.
  3. Nagłówek ma dokładnie tekst "Ahoj Piraci!".
  4. Kolor siedzi w regule CSS w <style>, a strona w przeglądarce ma czerwony nagłówek.

Jeśli coś się nie zgadza, nie łataj tego ręcznie: napisz Claude, co poprawić, albo cofnij zmianę, jak za chwilę.

Druga prośba i zmiana w pliku

Poproś o małą zmianę, żeby zobaczyć, jak wygląda poprawka istniejącego pliku:

Polecenie dla Claude Code:

W pirate.html zmień kolor nagłówka h1 na granatowy (navy).
Resztę pliku zostaw bez zmian.

Zanim zapisze zmianę, Claude znów pokaże, co zamierza zrobić, i zapyta o zgodę. Zgódź się i obejrzyj plik w Cursorze. W regule nagłówka zmieniła się jedna wartość:

h1 {
  color: navy;
}

Zamiast red stoi teraz navy, a reszta pliku jest taka sama jak wcześniej. Tak czytasz każdą poprawkę: szukasz tego, co się zmieniło, i sprawdzasz, czy nic poza tym nie zostało ruszone.

Esc i /rewind: hamulec i kotwica

Dwa narzędzia dają Ci pełną kontrolę nad załogą:

  • Esc przerywa Claude w trakcie pracy. To, co już zrobił, zostaje, a Claude czeka na Twoją wskazówkę. Esc naciśnięty przy prośbie o zgodę działa jak odpowiedź No.
  • /rewind (albo dwa razy Esc przy pustym polu polecenia) otwiera menu cofania. Claude Code przed każdym Twoim poleceniem zapamiętuje stan plików, które zmienia, więc możesz wrócić do chwili sprzed dowolnego polecenia.

W menu wybierasz polecenie, do którego chcesz wrócić, a potem jedną z opcji: Restore code and conversation (kod i rozmowa), Restore conversation (tylko rozmowa), Restore code (tylko kod) albo Never mind (nic nie rób). Są tam też opcje streszczania rozmowy, ale dziś ich nie potrzebujesz.

Ćwiczenie: wpisz /rewind, wybierz polecenie ze zmianą koloru i opcję Restore code. Otwórz pirate.html w Cursorze: nagłówek znów jest czerwony, a rozmowa została. Zastrzeżenie na przyszłość: /rewind cofa zmiany zrobione narzędziami Claude do edycji plików, ale nie cofnie skutków każdej komendy terminala. Dlatego w lekcji 0_3 nauczysz się czytać komendy, zanim się na nie zgodzisz.

Rozszerzenie Claude Code dla Cursora (opcja)

Claude Code ma oficjalne rozszerzenie dla VS Code, które instaluje się też w Cursorze: na stronie code.claude.com/docs/en/vs-code jest link Install for Cursor. Rozszerzenie dodaje do edytora graficzny panel rozmowy z własną kopią Claude Code, ale nie instaluje komendy claude w terminalu: do tego potrzebujesz instalacji z kroku 2. Dokumentacja opisuje, że w terminalu VS Code uruchomione claude samo łączy się z rozszerzeniem; o terminalu Cursora tego nie mówi. Rada kapitana: kurs pracuje w terminalu, bo tak samo wygląda to w każdym edytorze, a rozszerzenie możesz dodać później.

Następny krok

Gdy skończysz, wyjdź z sesji komendą /exit albo naciśnij dwa razy Ctrl+D. Następnym razem, w tym samym folderze, wrócisz do rozmowy komendą:

claude -c

Opcja -c (od continue) wznawia najnowszą rozmowę w bieżącym folderze, więc Claude pamięta, co ustaliliście. Samo claude zaczyna rozmowę od nowa, ale pliki projektu oczywiście zostają. Kolejna prośba niech będzie znowu mała, na przykład: "Dodaj pod akapitem przycisk z napisem Dołącz do załogi. Nie zmieniaj nagłówka." W lekcji 0_3 nauczysz się czytać komendy, które Claude uruchamia w terminalu.

Pamiętaj: Ty wydajesz rozkaz, Claude Code pisze, a Cursor pokazuje, co naprawdę trafiło do ładowni.

Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
  <meta charset="UTF-8">
  <title>Ahoj Piraci!</title>
  <style>
    h1 {
      color: red;
    }
  </style>
</head>
<body>
  <!-- Tak może wyglądać pirate.html po pierwszym poleceniu z lekcji. -->
  <!-- Twój plik od Claude Code może różnić się szczegółami, np. treścią akapitu. -->
  <h1>Ahoj Piraci!</h1>
  <p>Witaj na pokładzie! Tu zaczyna się nasza przygoda.</p>
</body>
</html>

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. Co pokazuje komenda claude --version?

  2. 2. Którym skrótem przełączysz tryb uprawnień sesji, na przykład z auto na Manual?

  3. 3. Claude Code zmienił plik, a wynik Ci się nie podoba. Jak wrócisz do stanu sprzed polecenia?

  4. 4. Kiedy warto przełączyć sesję z trybu auto na Manual?

  5. 5. Która prośba o poprawkę pirate.html jest najlepsza?

  6. 6. Gdzie Claude Code tworzy i zmienia pliki?

  7. 7. Claude zaczął robić coś innego, niż chciałeś. Którym klawiszem przerwiesz jego pracę?

Zadania praktyczne w grze

  • Edytor kodu

    Użyj Cursora żeby stworzyć prosty plik HTML

  • Układanie w pionie

    Ułóż kroki pierwszej sesji Claude Code w odpowiedniej kolejności:

  • Układanie w poziomie

    Złóż komendę instalacji Claude Code na macOS, Linuksie i w WSL:

  • Układanie w pionie

    Ułóż kroki jednej zmiany w trybie Manual:

  1. PytanieQuiz: Sprawdzenie instalacji
  2. Zadanie z kodemPraktyka: Stwórz plik pirate.html
  3. Ułóż w kolejnościSortowanie: Pierwsza sesja Claude Code
  4. PytanieQuiz: Zmiana trybu uprawnień
  5. PytanieQuiz: Cofnięcie zmiany
  6. Ułóż w kolejnościŁączenie: Instalacja Claude Code
  7. PytanieQuiz: Kiedy tryb Manual
  8. PytanieQuiz: Polecenie poprawki
  9. PytanieQuiz: Gdzie pracuje Claude Code
  10. Ułóż w kolejnościSortowanie: Zmiana w trybie Manual
  11. PytanieQuiz: Przerwanie pracy Claude

Przydatne artykuły