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
- 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.
- 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.
- Wklej prompt poniżej, podmieniając nazwę gałęzi. Claude poprosi o zgodę na git diff; odczyt repozytorium jest dozwolony w każdym trybie.
- 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.
- 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.
- 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.

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.
Źródła
- Claude Code Docs: How Claude remembers your project (CLAUDE.md)
- Claude Code Docs: Code Review
- Claude Code Docs: Commands
- Claude Code Docs: Choose a permission mode
- Claude Code Docs: Settings reference (language)
- Claude Code Docs: GitHub Actions
- Claude Code Docs: Data usage
- Claude Help Center: Use Claude Code with your Team or Enterprise plan
Stan na 08.10.2026. Interfejs i plany licencji zmieniają się często, przed szkoleniem zespołu sprawdź je u siebie.
Chcesz przećwiczyć to z trenerem na własnych plikach? Zobacz: Kurs Claude Code i Codex dla programistów.
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.