Claude Code w terminalu: pierwsze polecenia i pierwszy projekt

• Uruchamiaj Claude’a z folderu konkretnego projektu.
• Polecenia claude … wpisuj w powłoce, czyli programie wykonującym polecenia terminala; komendy /… wpisuj w otwartej sesji Claude Code.
• Polecam zacząć od jednego pliku i jednego zadania.
• Przeczytaj proponowaną zmianę, a później sprawdź działanie strony.

Przykład zakłada Ubuntu 24.04 i powłokę Bash. Dokumentacja wymienia obsługę Ubuntu od wersji 20.04, przynajmniej 4 GB pamięci operacyjnej (RAM) oraz wymagane połączenie z internetem w wymaganiach systemowych.

Przygotuj:

• zainstalowany Claude Code, przeglądarkę i edytor zwykłego tekstu;
• folder, w którym możesz zapisywać pliki;
• dostęp do Claude Code: na przykład konto Pro lub Max albo konto Claude Console, zgodnie z warunkami rozpoczęcia pracy.

Po uruchomieniu narzędzia terminal pokazuje pole rozmowy z Claude’em. Wtedy wpisujesz prośby i komendy zaczynające się od ukośnika. Polecenia uruchamiające program opisuje lista poleceń CLI, czyli interfejsu obsługi tekstem.

Działanie /help, /permissions i /exit potwierdza opis komend sesji. Na początek polecam rozmowę interaktywną, w której po odpowiedzi możesz doprecyzować zadanie.

Pracę podzielimy na przygotowanie pliku, zlecenie zmiany i sprawdzenie efektu:

flowchart TD
    A[Folder projektu] --> B[Plik strony]
    B --> C[Prośba do Claude’a]
    C --> D[Przegląd zmiany]
    D --> E[Zgoda, jeśli wymagana]
    E --> F[Sprawdzenie w przeglądarce]

1. Utwórz folder i sprawdź instalację

Otwórz terminal w miejscu, gdzie chcesz przechowywać projekt, i wykonuj polecenia po kolei:

mkdir licznik-nauki
cd licznik-nauki
pwd
claude --version

mkdir tworzy folder, cd do niego przechodzi, a pwd wypisuje bieżącą ścieżkę. Powinna kończyć się na licznik-nauki. Jeśli folder już istnieje, zatrzymaj się i wybierz inną nazwę, żeby rozpocząć od pustego projektu.

Ostatnie polecenie powinno pokazać numer wersji z dopiskiem (Claude Code), zgodnie z instrukcją sprawdzenia instalacji.

2. Przygotuj stronę do rozbudowy

HTML to język znaczników opisujący strukturę strony: nagłówki, akapity i inne elementy. Sposób przygotowania dokumentu wyjaśnia wprowadzenie do HTML w MDN.

Otwórz edytor tekstu i utwórz w folderze projektu plik index.html:

<!doctype html>
<html lang="pl">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Licznik nauki</title>
</head>
<body>
  <h1>Licznik sesji nauki</h1>
  <p>Ukończone sesje: <span id="licznik">0</span></p>
  <button id="dodaj" type="button">Dodaj sesję</button>
</body>
</html>

Zapisz plik jako zwykły tekst. Na tym etapie strona ma pokazywać zero i przycisk, który jeszcze niczego nie zmienia. Obsługę kliknięć zlecimy Claude’owi.

3. Uruchom sesję i poznaj plik

W terminalu, nadal w folderze licznik-nauki, uruchom:

claude --permission-mode default

Opcja --permission-mode wybiera tryb uprawnień, zgodnie z listą opcji CLI. Uprawnienia określają, na jakie działania pozwalasz narzędziu. Wartość default odpowiada trybowi oznaczonemu w interfejsie jako Manual; jej działanie opisuje dokumentacja trybów uprawnień.

Polecam ten tryb do pierwszego ćwiczenia. Jeśli to pierwsze uruchomienie, wykonaj instrukcje logowania, także w przeglądarce. Po zalogowaniu zobaczysz pole rozmowy oraz informacje o folderze roboczym, co opisuje instrukcja rozpoczęcia sesji.

Jeśli pojawi się pytanie o zaufanie do folderu, sprawdź, czy dotyczy utworzonego przez ciebie licznik-nauki, i zaakceptuj je.

Wpisz /help, a następnie wyślij pierwszą prośbę, czyli prompt:

Przeczytaj index.html. Wyjaśnij po polsku, co zawiera ten plik
i dlaczego przycisk jeszcze nie zwiększa licznika.
Na razie nie zmieniaj plików.

Oczekiwany wynik to omówienie nagłówka, licznika i przycisku. Claude Code odczytuje pliki projektu według potrzeb, więc nie musisz wklejać ich zawartości do rozmowy, zgodnie z opisem pierwszego pytania.

4. Zleć jedną konkretną zmianę

JavaScript to język programowania, którego użyjemy do reagowania na kliknięcia. Wyślij:

Rozbuduj index.html o JavaScript zapisany w tym samym pliku.
Kliknięcie „Dodaj sesję” ma zwiększać licznik o 1.
Dodaj przycisk „Wyzeruj”, który ustawia licznik na 0.
Po odświeżeniu strony licznik ma zaczynać od 0.
Nie instaluj dodatkowych narzędzi i nie twórz innych plików.
Po zmianie wyjaśnij, co dodałeś i jak to sprawdzić.

Przeczytaj proponowaną zmianę w kodzie. Jeżeli pojawi się pytanie o zgodę, zatwierdź tylko zrozumiałą edycję dotyczącą tego zadania. W trybie Manual odczyt plików w folderze roboczym nie wymaga zgody, natomiast modyfikacje podlegają regułom uprawnień opisanym w systemie zatwierdzania działań.

Edycja zmienia zapisany plik index.html. Polecam sprawdzić, czy Claude nie dodał instalacji narzędzi albo funkcji niezwiązanych z licznikiem.

5. Sprawdź wynik w przeglądarce

Otwórz folder projektu w menedżerze plików i wybierz otwarcie index.html w przeglądarce. Takie otwieranie lokalnego dokumentu opisuje poradnik pracy z plikami MDN.

Wykonaj krótki test:

1. Po otwarciu strony sprawdź, czy widzisz 0.
2. Kliknij „Dodaj sesję” dwukrotnie. Oczekiwany wynik: 2.
3. Kliknij „Wyzeruj”. Oczekiwany wynik: 0.
4. Dodaj sesję i odśwież stronę. Zgodnie z zadaniem licznik powinien wrócić do 0.

Jeżeli któryś punkt nie działa, wróć do rozmowy i podaj konkretny objaw:

Po dwóch kliknięciach „Dodaj sesję” nadal widzę 0.
Sprawdź obsługę tego przycisku w index.html i popraw błąd.

Polecam też poprosić o wyjaśnienie dodanego kodu linia po linii. Dzięki temu kolejne zadanie oprzesz na rozumieniu pliku.

6. Zakończ pracę i wróć do rozmowy

W sesji wpisz /exit, aby wyjść z programu. Aby później kontynuować rozmowę, uruchom z tego samego folderu:

claude -c --permission-mode default

Opcja -c kontynuuje ostatnią rozmowę w bieżącym katalogu, zgodnie z dokumentacją kontynuowania sesji. Następne zadanie możesz zawęzić do wyglądu przycisków albo dodania komunikatu po ukończeniu sesji.

Terminal zgłasza claude: command not found. Otwórz nowy terminal. Jeśli komunikat pozostaje, sprawdź instalację oraz PATH, listę folderów, w których powłoka szuka programów, według instrukcji naprawy instalacji i PATH.

Claude opisuje inny projekt. Sprawdź folder pokazany w sesji. Wyjdź przez /exit, przejdź do właściwego katalogu i uruchom narzędzie ponownie.

Zamiast strony widzisz kod albo plik otwiera się w edytorze. Wybierz przeglądarkę jako program do otwarcia pliku. Sprawdź też nazwę: ma być index.html, bez dodatkowego .txt; rolę rozszerzenia opisuje poradnik nazw plików MDN.

Claude proponuje znacznie więcej zmian. Poproś: „Wprowadź wyłącznie obsługę licznika w index.html”. Polecam rozdzielać zmianę działania i zmianę wyglądu na osobne zadania.

Jak uruchomić Claude Code w istniejącym projekcie?

Przejdź w terminalu do jego folderu i wpisz claude. To sposób pracy opisany w instrukcji otwierania projektu. Polecam najpierw poprosić o wyjaśnienie zawartości, a dopiero potem o edycję.

Czy Claude Code działa bez internetu?

Nie w opisanym tutaj sposobie pracy: połączenie z internetem jest jednym z wymagań Claude Code. Sam licznik z tego ćwiczenia sprawdzisz jako lokalny plik strony.

Jak przerwać działanie Claude Code?

Podczas trwającej operacji użyj Ctrl+C, który ją przerywa według listy skrótów klawiaturowych. Do zakończenia sesji użyj /exit.

Polecam teraz zapisać wersję projektu w Git, narzędziu przechowującym historię zmian w plikach.