Poradnik · Claude Code (CLI)

Claude Code: przegląd pull requestu według zasad zespołu z CLAUDE.md

Zasady przeglądu kodu mamy spisane, ale przy kilkunastu PR-ach dziennie i tak ktoś przepuści endpoint bez testu albo log z adresem e-mail. Chcę, żeby przed moim przeglądem agent przeszedł diff punkt po punkcie według naszej listy.

Dla kogo: programista, tech lead · Sprawdzone 08.10.2026 · Autor: Karol Krawczyk

Wymagania

  • Claude Code z planem Team (każde stanowisko ma Claude Code) albo Enterprise (nowe plany: każde stanowisko; starsze: stanowiska Chat + Claude Code lub Premium). Logowanie: claude, potem opcja Claude account with subscription.
  • Przy planach Team, Enterprise i API Anthropic nie trenuje modeli na kodzie i promptach wysłanych do Claude Code, chyba że firma sama się na to zgodzi (np. Development Partner Program).
  • Plik CLAUDE.md w repozytorium (./CLAUDE.md albo ./.claude/CLAUDE.md), wersjonowany w git, żeby cały zespół miał te same zasady. Dokumentacja zaleca poniżej 200 linii na plik.
  • Lokalna kopia repozytorium z gałęzią PR-a. Komenda /code-review (alias /review od v2.1.223) przyjmuje numer PR-a, gałąź, ścieżkę albo zakres, np. main...feature.
  • Opcjonalnie odpowiedzi po polsku domyślnie: ustawienie "language": "polish" w ~/.claude/settings.json.

Kroki

  1. Dopisz do CLAUDE.md sekcję z zasadami przeglądu, każda zasada sprawdzalna i ponumerowana, np.: ## Zasady przeglądu kodu 1. Każdy nowy endpoint API ma test integracyjny. 2. Nie logujemy adresów e-mail, numerów PESEL ani treści żądań. 3. Każde zapytanie do bazy filtruje po tenant_id. 4. Nowa zmienna środowiskowa trafia do .env.example.
  2. Pobierz gałąź PR-a i uruchom Claude Code w trybie planu, który blokuje edycję plików: claude --permission-mode plan. Komendą /context sprawdź, czy CLAUDE.md jest na liście Memory files.
  3. Wklej prompt poniżej, podmieniając nazwę gałęzi. Claude poprosi o zgodę na git diff; odczyt repozytorium jest dozwolony w każdym trybie.
  4. Osobno uruchom /code-review main...nazwa-galezi, który szuka błędów poprawności. Ta komenda też stosuje CLAUDE.md, ale nie czyta pliku REVIEW.md.
  5. Przejrzyj wyniki sam, zanim cokolwiek trafi do PR. Flaga --comment publikuje ustalenia /code-review jako komentarze inline w PR na GitHubie, więc dodawaj ją dopiero po tym przeglądzie.
  6. Jeśli chcecie przeglądu przy każdym PR na GitHubie: managed Code Review (research preview, Team i Enterprise, włącza Owner w claude.ai/admin-settings/claude-code, rozliczany osobno, średnio 15 do 25 USD za przegląd według dokumentacji) albo workflow GitHub Actions z /install-github-app.

Prompt do skopiowania

Przejrzyj zmiany z gałęzi feature/rabaty-b2b względem main (git diff main...feature/rabaty-b2b). Sprawdź je punkt po punkcie z sekcją Zasady przeglądu kodu w CLAUDE.md. Niczego nie zmieniaj w plikach i niczego nie publikuj na GitHubie. Dla każdego naruszenia podaj: plik i linię, numer zasady, krótko dlaczego to naruszenie i jak je poprawić. Opieraj się na kodzie, nie na nazwach funkcji: jeśli twierdzisz, że czegoś brakuje, wskaż, gdzie szukałeś. Osobno wypisz zasady, których nie da się sprawdzić na podstawie samego diffu. Na końcu jedno zdanie: czy według tych zasad PR nadaje się do merge.

Wynik

Lista naruszeń z plikiem, linią i numerem zasady oraz lista zasad, których nie dało się sprawdzić. Otwórz 2 lub 3 wskazane miejsca w diffie i sprawdź, czy naruszenie jest prawdziwe. Jeśli agent twierdzi, że brakuje testu, sprawdź katalog testów sam, bo test mógł powstać w innym pliku niż się spodziewa.

Wynik w narzędziu Claude Code (CLI): Przegląd PR według CLAUDE.md

Najczęstszy błąd

Zasady typu pisz czysty kod albo dbaj o bezpieczeństwo. Agent nie ma czego sprawdzić i zwraca ogólniki. Pisz zasady tak, żeby dało się je potwierdzić w diffie, i usuwaj sprzeczne punkty z CLAUDE.md.

Kiedy tego nie robić

Gdy przegląd ma być jedyną kontrolą przed merge zmian w uwierzytelnianiu, płatnościach albo migracjach danych: agent jest tu dodatkowym sitem, a decyzję podejmuje człowiek. Nie uruchamiaj go też na repozytorium, którego polityka firmy nie pozwala wysyłać do zewnętrznego modelu.

Chcesz przełożyć to na swój zespół?

Szkolimy zespoły z pracy z Copilotem, Claude Code i Codexem na ich własnych zadaniach.

← Wszystkie poradniki