Blog JSystems - uwalniamy wiedzę!

Szukaj

Claude Code

Jak używać Claude Code do code review pull requesta

W skrócie

  • Chcesz, żeby Claude Code przejrzał pull requesta i wskazał błędy, zanim zrobi to człowiek, ale nie wiesz, od czego zacząć.
  • Claude Code widzi kod, historię gita i diff, więc potrafi zrobić rzetelne review lokalnie, w trybie wsadowym albo automatycznie w GitHub Actions - tylko trzeba mu podać właściwy zakres zmian.
  • Rozwiązanie: użyj wbudowanej komendy /code-review w sesji, trybu wsadowego z gh pr diff | claude -p, albo akcji anthropics/claude-code-action reagującej na wzmiankę @claude w PR.

Code review to jedno z zadań, w których Claude Code, oficjalne narzędzie CLI od Anthropic, sprawdza się bardzo dobrze. Ma dostęp do całego repozytorium, potrafi wyciągnąć diff pull requesta, prześledzić powiązane pliki i zwrócić konkretne uwagi z numerami linii. Możesz go użyć na trzy sposoby: interaktywnie w terminalu, jednorazowo w trybie wsadowym, oraz automatycznie na każdym pull requeście. Pokazujemy wszystkie trzy.

Jak to wygląda w praktyce

Typowa sytuacja: masz otwartego pull requesta z kilkunastoma zmienionymi plikami i chcesz szybkiej, merytorycznej opinii, zanim zajmie się nim recenzent. Ręczne wklejanie fragmentów kodu do czatu jest żmudne i łatwo pominąć plik. Bez podania diffa Claude Code nie wie, które zmiany są przedmiotem review, więc odpowiada zbyt ogólnie. Chcesz, żeby ocenił dokładnie to, co zmienia PR - i nic poza tym.

Dlaczego Claude Code tak działa

Claude Code nie zgaduje, co jest przedmiotem review - opiera się na tym, co mu wskażesz. W repozytorium git naturalnym punktem odniesienia jest diff między gałęzią pull requesta a gałęzią docelową. Gdy podasz ten diff (albo poprosisz o jego pobranie), agent skupia analizę wyłącznie na zmienionych liniach i ich kontekście, zamiast czytać cały projekt. Dlatego kluczem do dobrego review jest precyzyjne określenie zakresu: konkretny PR, konkretny zakres commitów albo git diff względem gałęzi bazowej.

Warto też wiedzieć, że gdy pracujesz na gałęzi z otwartym pull requestem, Claude Code pokazuje w stopce klikalny link do PR z kolorowym stanem review (zielony - zaakceptowany, żółty - oczekujący, czerwony - wymaga zmian). To ułatwia pilnowanie statusu bez wychodzenia z terminala.

Jak to rozwiązać krok po kroku

  1. Najprościej: w sesji na gałęzi pull requesta uruchom wbudowaną komendę /code-review. To bundlowany skill Claude Code, który przegląda bieżące zmiany pod kątem błędów i podpowiada poprawki. Wynik dostajesz od razu w terminalu.
  2. Alternatywnie poproś opisowo: Przejrzyj diff tego pull requesta pod kątem błędów logicznych, brakującej obsługi wyjątków i literówek. Podaj plik i numer linii dla każdej uwagi. Claude Code sam wyciągnie diff, jeśli jesteś w repozytorium.
  3. Do jednorazowego review z linii poleceń użyj trybu wsadowego z gh (GitHub CLI): gh pr diff 123 | claude -p "Jesteś recenzentem. Wskaż błędy w tym diffie, plik i linia w osobnej linijce." --output-format json. To wygodne w skryptach i CI.
  4. Możesz doprecyzować rolę recenzenta flagą --append-system-prompt, na przykład Jesteś inżynierem bezpieczeństwa, szukaj podatności. Wtedy review skupia się na tym, na czym Ci zależy.
  5. Aby review działało automatycznie na każdym PR, dodaj do repozytorium workflow GitHub Actions z akcją anthropics/claude-code-action@v1 i sekretem ANTHROPIC_API_KEY. Skonfiguruj ją tak, by reagowała na wzmiankę @claude w komentarzu pull requesta - wtedy Claude odpowie recenzją w wątku PR.
  6. Zawęź uprawnienia akcji w polu claude_args (na przykład tylko odczyt i narzędzia GitHub), żeby automatyczny recenzent nie miał praw większych, niż potrzebuje.
  7. Uwaga na koszt: pełne review dużego PR to sporo tokenów. W CI ograniczaj zakres do zmienionych plików i uruchamiaj recenzję na wybranych zdarzeniach, a nie przy każdym commicie.

Jak sprawdzić, że zadziałało

Sprawdź, że uwagi odnoszą się do rzeczywiście zmienionych linii - każda powinna mieć plik i numer linii, który znajdziesz w diffie. Jeśli używasz GitHub Actions, po dodaniu komentarza @claude w pull requeście w ciągu chwili powinien pojawić się komentarz-recenzja od bota, a w zakładce Actions zobaczysz zielony przebieg workflow. Przy trybie wsadowym potwierdź, że wynik w formacie JSON zawiera treść recenzji, a nie pusty obiekt.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI, prowadzi Łukasz Matuszewski (JSystems)

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5

Najczęściej zadawane pytania

Czy Claude Code ma gotową komendę do code review?
Tak, w sesji dostępna jest wbudowana komenda /code-review, czyli bundlowany skill, który przegląda bieżące zmiany w repozytorium pod kątem błędów i proponuje poprawki. Nie musisz nic instalować ani konfigurować, wystarczy uruchomić ją na gałęzi z pull requestem.
Jak zrobić review pull requesta z linii poleceń bez otwierania sesji?
Użyj trybu wsadowego w połączeniu z GitHub CLI: gh pr diff NUMER przekazujesz potokiem do claude -p z odpowiednim promptem, na przykład z flagą --output-format json. Claude Code oceni wtedy dokładnie diff danego pull requesta i zwróci recenzję, którą łatwo wpiąć w skrypt lub CI.
Jak ustawić automatyczne review na każdym pull requeście?
Dodaj do repozytorium workflow GitHub Actions z akcją anthropics/claude-code-action oraz sekretem ANTHROPIC_API_KEY i skonfiguruj ją tak, by reagowała na wzmiankę @claude w komentarzu PR. Wtedy Claude odpowiada recenzją bezpośrednio w wątku pull requesta, bez uruchamiania czegokolwiek lokalnie.
Czy automatyczny recenzent w CI jest bezpieczny dla repozytorium?
Jest bezpieczny, jeśli ograniczysz mu uprawnienia. W konfiguracji akcji, w polu claude_args, przyznaj tylko potrzebne narzędzia, na przykład odczyt i wybrane narzędzia GitHub, zamiast pełnego dostępu. Dzięki temu automatyczny recenzent nie ma praw większych, niż wymaga tego samo przeglądanie kodu.

Komentarze (0)

Musisz być zalogowany by móc dodać komentarz. Zaloguj się przez Google

Brak komentarzy...