Claude Code — przykład użycia na małym zadaniu
Wybierzmy prosty problem: lista zadań wyświetla pusty element, gdy repozytorium nie zawiera jeszcze żadnych zadań. Chcemy pokazać czytelną wiadomość i zachować dotychczasowe zachowanie dla jednej lub wielu pozycji. Przykład zakłada minimalną funkcję JavaScript; w rzeczywistym projekcie nazwy plików, framework i sposób renderowania mogą wyglądać inaczej.
To scenariusz demonstracyjny na neutralnym, fikcyjnym repozytorium. Nie sugeruje, że Claude Code wykonał tę zmianę w konkretnym projekcie. Ma pomóc odtworzyć proces i samodzielnie ocenić rezultat.
Claude Code to agent AI działający w kontekście projektu: może analizować pliki i proponować pracę na kodzie, jeśli przyznasz mu odpowiedni dostęp. W tym przykładzie używamy go jako asystenta programisty do małej poprawki, a nie jako autonomicznego wykonawcy całego produktu.
To przykład użycia Claude Code dla osoby, która zna podstawy terminala, ale chce lepiej rozumieć pracę w repozytorium. Sam czat ChatGPT może pomóc ułożyć plan, jednak narzędzie pracujące w katalogu projektu ma dostęp do kontekstu plików zgodnie z konfiguracją i zatwierdzonymi uprawnieniami.
Krok 1: przygotuj bezpieczne repozytorium
Do ćwiczenia użyj kopii projektu albo małego repozytorium demonstracyjnego. Zanim uruchomisz agent programistyczny, sprawdź bieżący folder, gałąź Git i istniejące zmiany. Jeśli w katalogu są niezapisane poprawki, zachowaj je. Nie zaczynaj od repozytorium produkcyjnego ani danych klienta.
Claude Code może pracować na plikach i uruchamiać polecenia zgodnie z konfiguracją oraz przyznanymi uprawnieniami. Przeczytaj, co zatwierdzasz, i nie uruchamiaj komend, których działania nie rozumiesz. Funkcje i ustawienia dostępne w narzędziu sprawdź w bieżącej dokumentacji.
Przed pracą w terminalu sprawdź katalog projektu, aktywną gałąź i stan Git. Przeczytaj README oraz instrukcje projektu, na przykład CLAUDE.md, jeśli repozytorium go zawiera. Nie wklejaj tokenów, kluczy API ani haseł do polecenia. Ogranicz agentowi dostęp do plików i komend do tego, co jest potrzebne dla zadania.
Claude Code jest agentem AI do pracy z kodem i plikami projektu; nie jest zwykłym czatem bez dostępu do środowiska. To, czy działa przez terminal, IDE lub inną aplikację, zależy od wybranego sposobu pracy i aktualnej konfiguracji.
Repozytorium to katalog projektu wraz z plikami i historią zmian Git. Przed uruchomieniem Claude Code przejdź w terminalu do kopii roboczej, sprawdź status Git i upewnij się, że ważne zmiany są zapisane. Nie zaczynaj ćwiczenia na jedynej kopii produkcyjnego projektu.
Jeżeli projekt wymaga poleceń instalacyjnych, na przykład npm install, sprawdź wcześniej co zostanie pobrane i z jakiego źródła. Nie wklejaj tokenów API ani haseł do czatu, plików promptu lub repozytorium.
Krok 2: poproś Claude Code o analizę i plan
Przy zadaniu obejmującym kilka kroków zacznij od rozpoznania projektu, nie od natychmiastowej edycji. Wskaż rezultat, ograniczenia i format planu. Poproś Claude Code, aby najpierw opisał powiązane pliki oraz kontrole, które zamierza wykonać.
Plan powinien być mały i możliwy do sprawdzenia
Przed akceptacją planu sprawdź, czy Claude Code rozpoznaje istniejący komponent, testy i konwencje projektu. Przy tym ćwiczeniu plan nie powinien zakładać przebudowy całej listy ani dodawania zależności. Wystarczy znaleźć renderowanie listy, dodać pusty stan w odpowiednim miejscu i uzupełnić kontrolę przypadku bez zadań.
Jeżeli projekt ma już komponent empty state, wzorzec tekstów lub bibliotekę komponentów, wykorzystaj je. Jeśli agent nie potrafi wskazać miejsca w repozytorium, poproś o wyjaśnienie na podstawie konkretnych plików, zanim pozwolisz na edycję.
- Jaki rezultat zobaczy użytkownik?
- Które pliki zmienią się i dlaczego?
- Co musi pozostać bez zmian?
- Jakie testy lub ręczne kroki sprawdzą rezultat?
Krok 3: zatwierdź zakres, a potem poproś o zmianę
Po przeczytaniu planu zdecyduj, czy pasuje do zadania. Jeśli tak, zleć ograniczoną implementację. Jeśli projekt ma już wzorzec pustego stanu lub testy komponentu, poproś o ich wykorzystanie zamiast dodawania nowej architektury.
Przykładowa zmiana poniżej pokazuje samą ideę. To poglądowy diff do ćwiczenia, nie kod wygenerowany ani sprawdzony przez Claude Code. Może wymagać dostosowania do frameworka, dostępności i sposobu sanitacji treści w repozytorium.
Przekaż kontekst projektu przed edycją
Claude Code widzi kontekst dostępny w aktualnym katalogu i ustawieniach. W promptcie opisz, czym jest lista zadań, gdzie znajduje się logika jej wyświetlania i jakie są ograniczenia. Jeśli agent nie zna nazw plików, pozwól mu najpierw przeszukać repozytorium i poprosić o wskazanie właściwego miejsca.
Do powtarzalnych zasad zespołu można użyć instrukcji projektu, na przykład CLAUDE.md, jeśli zespół taką utrzymuje. Taki plik może opisywać komendy testowe, konwencje i granice zmian. Najpierw sprawdź jego treść; nie kopiuj do niego sekretów ani poleceń, których skutków nie znasz.
Plik CLAUDE.md może przechowywać krótką konfigurację instrukcji projektu: komendy uruchamiania, konwencje kodu i ważne ograniczenia. Nie wpisuj tam sekretów. Poproś agenta AI, aby najpierw przeczytał instrukcje, wskazał pliki, których dotyczy zadanie, i powiedział, czego jeszcze nie wie.
Krok 4: przejrzyj diff Claude Code
Po implementacji przeczytaj każdą zmianę i porównaj ją z uzgodnionym planem. Sprawdź, czy agent nie zmienił stylów, API ani plików poza zakresem. Poproś o wyjaśnienie nowej logiki, jeśli nie rozumiesz jej skutków. Diff ma pokazywać małą, uzasadnioną zmianę, którą potrafisz opisać własnymi słowami.
Nie zakładaj, że poprawnie zakończone polecenie oznacza poprawny rezultat. Claude Code może pominąć przypadek brzegowy albo źle odczytać konwencję projektu. Wygenerowany kod jest propozycją do przeglądu.
Prompt po zaakceptowaniu planu
Gdy plan pasuje do repozytorium, można zlecić implementację i poprosić o podsumowanie zmian. Jasny zakres ułatwia późniejszy code review i zmniejsza ryzyko, że agent zacznie rozwiązywać inne problemy po drodze.
Krok 5: sprawdź przypadki i testy
Uruchom adekwatne testy istniejące w repozytorium i sprawdź zachowanie aplikacji. Jeśli projekt nie ma testu dla tej funkcji, wykonaj krótką kontrolę ręczną. Poniższe przypadki są listą do przeprowadzenia, a nie deklaracją, że testy zostały już uruchomione.
Jeśli repozytorium zawiera testy jednostkowe, uruchom komendę wskazaną w dokumentacji projektu i sprawdź jej wynik. Brak błędu w terminalu nie zastępuje przeglądu zmienionego kodu. Przy prostym interfejsie sprawdź też zachowanie ręcznie w przeglądarce.
- Pusta tablica pokazuje dokładnie jeden komunikat pustego stanu.
- Jedno zadanie wyświetla się tak jak przed zmianą.
- Kilka zadań zachowuje dotychczasową kolejność i treść.
- Nie pojawiają się błędy w konsoli ani niezamierzone zmiany w innych widokach.
Gdy Claude Code zmieni za dużo albo wynik nie działa
Zapisz konkretną różnicę między oczekiwanym i rzeczywistym zachowaniem. Zamiast prosić o „napraw wszystko”, wskaż plik, przypadek i ograniczenie. Poproś najpierw o wyjaśnienie przyczyny, a następnie o najmniejszą poprawkę. Po każdej iteracji ponownie obejrzyj diff i uruchom te same kontrole.
Jeśli nie rozumiesz zmiany, zatrzymaj się i wróć do ostatniego znanego stanu. Nie zatwierdzaj kodu tylko dlatego, że build przechodzi. Poprawny build nie dowodzi jeszcze, że interfejs jest czytelny, dostępny i zgodny z celem.
Debugowanie zacznij od konkretnego komunikatu błędu, pliku i kroku, który go wywołuje. Poproś Claude Code o diagnozę i jeden mały krok naprawy; zanim zatwierdzisz komendę z terminala, przeczytaj ją. Taki workflow utrzymuje zakres zmian pod kontrolą.
Czego ten przykład nie dowodzi
Jedno ćwiczenie nie dowodzi, że Claude Code bezpiecznie obsłuży każde repozytorium ani zastąpi code review. Nie jest też kursem programowania od podstaw. Przy złożonym systemie, danych klientów, logowaniu, płatnościach lub uprawnieniach potrzebne są kompetencje, testy i procedury odpowiednie do ryzyka.
Jeżeli dopiero zaczynasz, poproś o objaśnienie różnic w kodzie i pracuj na kopii. Jeśli zespół chce użyć narzędzia w firmie, wcześniej ustal uprawnienia, dozwolone dane, przegląd zmian i odpowiedzialność za wdrożenie.
Czy Claude Code sam zatwierdzi zmianę lub wykona commit?
Nie traktuj zakończenia pracy agenta jako zgody na wdrożenie. Zależnie od uprawnień i konfiguracji Claude Code może pracować z plikami lub poleceniami, ale człowiek powinien przeczytać diff, zrozumieć konsekwencje i zdecydować, czy użyć zmian. Commit w Git jest zapisem w historii projektu, a nie zastępstwem code review.
W ćwiczeniu demonstracyjnym zatrzymaj się po przeglądzie i kontroli. Nie prosimy Claude Code o samodzielne wdrożenie zmiany, push ani dostęp do produkcji. W prawdziwym repozytorium workflow zespołu określa, kto zatwierdza commit i pull request.