Kurs vibe coding z Claude Code · Moduł 2: Projekt Next.js z Claude Code
Node.js i npm: silnik projektu
W tej lekcji10
Witaj w drugiej lokacji! W pierwszej Claude Code napisał dla Ciebie jeden plik HTML. Teraz zaczynamy prawdziwy projekt: stronę gry "Kraken's Call" w Next.js. Zanim Claude założy go w następnej lekcji, okręt potrzebuje silnika.
Czego się nauczysz
- sprawdzić, czy masz Node.js i npm, i ocenić, czy ich wersje wystarczą dla Next.js;
- rozumieć komendy npm, o które Claude będzie prosił w tym kursie, zanim klikniesz Yes;
- czytać plik
package.jsoni mówić, co uruchomi każdy skrypt; - rozpoznać prośbę o zgodę, przy której trzeba się zatrzymać.
Problem: kod bez silnika stoi w porcie
Claude Code zainstalowany natywnie nie potrzebuje Node.js: to osobny program, który działa sam. Projekt Next.js już tak. Strona, którą Claude napisze w plikach .tsx, nie otworzy się w przeglądarce sama: ktoś musi ją zbudować i uruchomić serwer. Tym kimś jest Node.js. Bez niego Claude zapisze pliki, ale każda komenda, która ma je uruchomić, skończy się komunikatem command not found.
Silnik i kwatermistrz
Node.js to środowisko, które uruchamia JavaScript poza przeglądarką, na Twoim komputerze. Na naszym okręcie to silnik: dzięki niemu działa serwer deweloperski, sprawdzanie typów TypeScriptu i narzędzia, które budują stronę.
npm (Node Package Manager) to menedżer pakietów, czyli kwatermistrz z ładownią. Pakiet, nazywany też paczką, to gotowa biblioteka albo narzędzie napisane przez kogoś innego, na przykład react, next albo tailwindcss. npm pobiera paczki z publicznego rejestru, układa je w projekcie i pilnuje ich wersji. Instaluje się razem z Node.js: jeden instalator, dwa narzędzia.
Instalujesz sam, raz
W lekcji 0_3 poznałeś Node.js w pigułce. Jeśli komenda node --version odpowiedziała Ci wtedy command not found, czas na instalację:
- Wejdź na https://nodejs.org i przejdź do strony pobierania.
- Zostaw wybraną wersję z etykietą LTS (Long Term Support), czyli z długim wsparciem. Stan na listopad 2026: najnowsza LTS to linia 26, a wersja z etykietą Alpha służy tylko do testów.
- Niżej, wśród gotowych instalatorów, pobierz plik dla swojego systemu:
.msina Windowsie,.pkgna macOS. Na Linuksie wybierz swój system na tej samej stronie i postępuj według instrukcji, które się pojawią. - Uruchom instalator i przejdź przez kolejne ekrany z ustawieniami domyślnymi.
Rada kapitana: programy systemowe, takie jak Node.js, instalujesz sam z oficjalnej strony, a nie zlecasz ich Claude. Instalator prosi o hasło administratora, a decyzja o uprawnieniach administratora, czyli o sudo z lekcji 0_3, należy do Ciebie, nie do agenta. Po instalacji zamknij terminal w Cursorze i otwórz nowy, żeby zobaczył nowe komendy.
Sprawdzian: niech Claude obejrzy maszynownię
Otwórz w Cursorze folder piracki_statek z poprzedniej lokacji, w terminalu uruchom claude i sprawdź wskaźnik trybu. Na razie zostajemy przy Manual, żeby widzieć każdą komendę.
Polecenie dla Claude Code:
Sprawdź, jakie mam wersje Node.js i npm, i powiedz, czy wystarczą do
projektu Next.js 16, który założymy w następnej lekcji. Zanim uruchomisz
komendę, napisz jednym zdaniem, co ona zrobi. Niczego nie instaluj.Polecenie ma cel (sprawdzić wersje), ograniczenie ("niczego nie instaluj") i opis tego, co chcesz dostać na końcu, czyli ocenę. Te klocki znasz z lekcji 0_5. Claude odpowie, że uruchomi dwie komendy:
node -v
npm -v-v to skrót od --version, więc node -v i node --version robią dokładnie to samo. Jeśli Claude poprosi o zgodę, czytaj spokojnie: obie komendy tylko wypisują numer wersji i niczego na dysku nie zmieniają. Ten sam sprawdzian zrobisz sam, bez udziału Claude, wpisując w sesji ! node -v.
Wynik wygląda mniej więcej tak, pierwsza linia to Node.js, druga npm:
v26.13.1
11.20.0Tak odpowiedział świeżo zainstalowany Node.js z linii LTS razem z dołączonym do niego npm; u Ciebie liczby mogą być wyższe. Liczy się minimum: Next.js 16 wymaga Node.js co najmniej 20.9. Claude porówna to za Ciebie, ale zasadę warto znać, bo stara wersja z dawnego projektu potrafi czekać na dysku latami.
Komendy npm, które zobaczysz w prośbach o zgodę
Od następnej lekcji komendy npm uruchamia Claude, a Ty je zatwierdzasz. Zatwierdzasz tylko to, co rozumiesz, więc poznaj cztery najczęstsze. Pierwsza instaluje paczki, których potrzebuje projekt:
npm installnpm czyta listę zależności z pliku package.json, pobiera paczki z rejestru i układa je w folderze node_modules. Bez nazwy paczki instaluje tylko to, co już jest na liście, i niczego nowego do projektu nie dopisuje. Z nazwą, na przykład npm install zod, dopisuje nową paczkę, i taką prośbę czytasz uważniej.
Druga uruchamia serwer deweloperski, na którym oglądasz stronę w trakcie pracy:
npm run devnpm run uruchamia skrypt o podanej nazwie z pliku package.json, tu skrypt dev. W projekcie Next.js startuje on serwer, który pokazuje stronę pod adresem http://localhost:3000 i odświeża ją po każdej zmianie pliku. Serwer działa, dopóki nie zatrzymasz go klawiszami Ctrl+C, a strona nie trafia przy tym do internetu.
Trzecia buduje wersję produkcyjną, czyli taką, którą później wdrożysz:
npm run buildBuild kompiluje cały projekt i sprawdza typy TypeScriptu. Jeśli w kodzie jest błąd, komenda kończy się czerwonym komunikatem, a jeśli przechodzi, masz twardy dowód, że projekt się składa. Dlatego w tym kursie npm run build będzie sprawdzianem, o który prosisz Claude po zmianach. Build niczego nie wdraża: gotowa wersja zostaje na Twoim dysku.
Czwarta to npx, młodszy brat npm, który uruchamia narzędzie bez instalowania go na stałe:
npx create-next-app@latest krakens-callnpx pobiera narzędzie create-next-app, uruchamia je raz i nie zostawia go w systemie. @latest oznacza najnowszą wersję, a krakens-call to nazwa projektu. Tą komendą, z kilkoma dodatkowymi flagami, Claude założy projekt w następnej lekcji.
package.json: karta okrętu
Każdy projekt JavaScript ma plik package.json. To karta okrętu: nazwa, skrypty i lista zależności. W następnej lekcji otworzysz go w Cursorze, a tak wygląda w świeżym projekcie Next.js założonym w listopadzie 2026:
{
"name": "krakens-call",
"version": "0.1.0",
"private": true,
"scripts": {
"dev": "next dev",
"build": "next build",
"start": "next start",
"lint": "eslint"
},
"dependencies": {
"next": "16.4.6",
"react": "19.3.0",
"react-dom": "19.3.0"
},
"devDependencies": {
"@tailwindcss/turbopack": "4.3.3",
"@types/node": "^20",
"@types/react": "^19",
"@types/react-dom": "^19",
"eslint": "^9",
"eslint-config-next": "16.4.6",
"tailwindcss": "4.3.3",
"typescript": "^5"
}
}Sekcja scripts to rozkazy z nazwami: npm run dev uruchamia next dev, npm run build uruchamia next build, npm run start uruchamia zbudowaną wersję, a npm run lint uruchamia eslint, czyli program, który szuka błędów i ryzykownych wzorców w kodzie. Gdy Claude poprosi o zgodę na npm run z jakąś nazwą, zajrzyj do scripts: tam przeczytasz, co naprawdę się wykona.
dependencies to paczki potrzebne aplikacji do działania, czyli Next.js i React. devDependencies to narzędzia potrzebne tylko przy pracy nad kodem: TypeScript, Tailwind, ESLint. Numery wersji u Ciebie mogą być nowsze, a sama budowa pliku zostaje ta sama.
node_modules i package-lock.json: ładownia i spis ładunku
Po npm install w projekcie pojawia się folder node_modules z pobranymi paczkami. Bywa ogromny, ma setki megabajtów, a każdy odtworzy go jedną komendą, więc nie trafia do Gita. Projekt z create-next-app ma to już załatwione, bo jego plik .gitignore zawiera taką linię:
/node_modulesUkośnik na początku oznacza folder w głównym katalogu projektu. Dzięki tej linii Git pomija ładownię, a w panelu Source Control w Cursorze nie zobaczysz tysięcy plików cudzych paczek.
Obok package.json leży package-lock.json, czyli dokładny spis ładunku: konkretne wersje wszystkich paczek, także tych, których potrzebują inne paczki. Ten plik commitujesz, bo dzięki niemu każdy, kto pobierze projekt, dostanie po npm install dokładnie te same wersje. Nie czytasz go linia po linii, ale gdy Claude coś doinstaluje, w Source Control zobaczysz zmiany w obu plikach.
Przegląd kapitana: prośby o zgodę na npm
Zanim klikniesz Yes przy komendzie npm, sprawdź trzy rzeczy:
- Czy ta paczka była w poleceniu?
npm installz nazwą dopisuje nową zależność. Jeśli o nią nie prosiłeś, zapytaj Claude, po co mu ona i czy da się bez niej. - Czy w komendzie jest
-galbosudo? Flaga-ginstaluje paczkę globalnie, dla całego systemu, a nie dla projektu. Taka instalacja wychodzi poza okręt, więc zanim się zgodzisz, zapytaj, dlaczego jest potrzebna. - Co zmieniło się w plikach? Po instalacji otwórz Source Control i przeczytaj zmiany w
package.json: nowa linia wdependenciesalbodevDependenciesmusi odpowiadać temu, o co prosiłeś.
Typowy błąd agenta: doinstalowuje bibliotekę "na zapas" albo podaje komendę z pamięci, ze starszej wersji narzędzia. Najłatwiej wyłapać go w punkcie 3. Paczka, której nie umiesz uzasadnić, to sygnał, żeby zatrzymać Claude klawiszem Esc i dopytać.
Następny krok
Masz silnik i wiesz, co robią rozkazy dla maszynowni. W następnej lekcji wydasz Claude Code polecenie, które założy cały projekt Next.js, i przeczytasz w Cursorze każdy plik, który powstanie.
Pamiętaj: silnik montujesz sam, ale każdy rozkaz dla maszynowni czytasz przed podpisem.
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Czym jest Node.js?
2. Która komenda instaluje wszystkie zależności z package.json?
3. Czym jest npm?
4. Co zawiera plik package.json?
5. Do czego służy komenda npx?
6. Dlaczego nie commitujemy folderu node_modules do Git?
Zadania praktyczne w grze
- Edytor kodu
Sprawdź w terminalu wersję Node.js i wpisz w pliku commands.sh komendę, której użyłeś.
- Klikanie w kolejności
Zbuduj komendę sprawdzającą wersję Node.js:
- Układanie w pionie
Uporządkuj typowe kroki uruchamiania pobranego projektu npm:
- Układanie w poziomie
Ułóż części komendy tworzącej nowy projekt Next.js (od lewej do prawej):
Zadania po tej lekcji
- PytanieQuiz: Co to jest Node.js?
- PytanieQuiz: Komendy npm
- Zadanie z kodemPraktyka: Sprawdź wersję Node.js
- Kliknij w kolejnościSortowanie: Komenda sprawdzania wersji Node.js
- PytanieQuiz: Czym jest npm?
- PytanieQuiz: Plik package.json
- Ułóż w kolejnościSortowanie: Komendy pracy z projektem
- PytanieQuiz: Komenda npx
- Ułóż w kolejnościSortowanie: Komenda tworzenia projektu Next.js
- PytanieQuiz: Folder node_modules