Przejdź do głównej zawartości

Przegląd i wdrożenie z Claude Code

Bezpieczne wdrożenie zmiany z Claude Code polega na ułożeniu kilku bramek między diffem a produkcją: /code-review w sesji, kontrola claude -p w trybie headless przed pushem, automatyczny przegląd na pull requeście, wskazany właściciel przy merge’u i przećwiczony rollback przy wdrożeniu. Nie decyduje pojedynczy przegląd, tylko dowody ze wszystkich bramek razem.

Ta strona jest dla programistów i tech leadów, których sesje Claude Code otwierają więcej pull requestów, niż ktokolwiek zdąży przeczytać linia po linii. Diffy wyglądają schludnie, a błędy siedzą tam, gdzie przestałeś zaglądać: brakujące sprawdzenie uprawnień, test osłabiony tak, żeby przechodził, migracja bez backfillu. Sprawdzono na Claude Code v2.1.283.

Która strona o wdrażaniu z Claude Code odpowie na twoje pytanie?

Dział zatytułowany „Która strona o wdrażaniu z Claude Code odpowie na twoje pytanie?”
Twoje pytanieStrona
Jak sprawić, żeby Claude przeglądał każdy diff tak samo, zanim zobaczy go człowiek?Automatyczne przeglądy kodu
Jak uruchomić Claude Code w GitHub Actions lub innym CI bez wystawiania sekretów?Claude Code w CI/CD
Jak zlecić Claude’owi napisanie, przyspieszenie albo utwardzenie samego pipeline’u?Konfiguracja pipeline’u z Claude Code
Jak skonteneryzować usługę i udowodnić, że manifesty działają?Docker i Kubernetes z Claude Code
Jak wdrożyć zmianę, zabezpieczyć release bramką i wycofać zmianę, gdy coś pójdzie nie tak?Automatyzacja wdrożeń z Claude Code

Jeśli testy za tymi bramkami są słabe, zacznij od testowania i debugowania z Claude Code: bramka jest tak mocna, jak jej wyrocznia.

W jakiej kolejności zmiana z Claude Code powinna trafić na produkcję?

Dział zatytułowany „W jakiej kolejności zmiana z Claude Code powinna trafić na produkcję?”

Tanie, prywatne kontrole idą pierwsze, żeby publiczny przegląd nadal był wart czytania.

  1. Przed commitem. Uruchom /code-review na bieżącym diffie i popraw każde blokujące znalezisko; /code-review --fix nanosi poprawki za ciebie. Dodaj /security-review, gdy diff dotyka uwierzytelniania, obsługi danych wejściowych albo sekretów.

  2. Przed pushem. Zapisz ten skrypt jako .git/hooks/pre-push i nadaj mu prawo wykonania (chmod +x). Uruchamia przegląd tylko do odczytu i blokuje push, chyba że ostatnia linia to wynik pozytywny:

    #!/bin/sh
    out=$(mktemp)
    claude -p "Review the diff between origin/main and HEAD for correctness and security defects only. \
    Ignore style. End with exactly one line: VERDICT: PASS or VERDICT: FAIL." \
    --permission-mode dontAsk \
    --allowedTools "Read" "Grep" "Glob" "Bash(git diff *)" "Bash(git log *)" \
    --output-format json --max-budget-usd 1.00 > "$out" || exit 1
    jq -r '.result' "$out" | tail -n 1 | grep -qx 'VERDICT: PASS'

    dontAsk odrzuca każde narzędzie spoza listy, więc kontrola nie może edytować plików, a --max-budget-usd ogranicza koszt. Hook wymaga jq w PATH.

  3. Na pull requeście. Dodaj job przeglądu oparty na anthropics/claude-code-action@v1 (zob. automatyczne przeglądy kodu) albo włącz zarządzany Code Review (Team i Enterprise, research preview; średnio 15–25 USD za przegląd). Dla gałęzi wysokiego ryzyka claude ultrareview 123 uruchamia w chmurze wieloagentowy przegląd pull requesta 123 (w sesji: /code-review ultra). Pro i Max mają trzy darmowe uruchomienia, potem zwykle 5–25 USD za każde (dokumentacja Anthropic, sprawdzone 2026-09-26).

  4. W CI. Testy, typy i lint działają poza kontrolą Claude’a, więc agent nie może sam oznaczyć swojej pracy na zielono.

  5. Przy merge’u. Wskazany człowiek akceptuje ścieżki, które CODEOWNERS eskaluje: migracje, uwierzytelnianie, pieniądze, kontrakty publicznego API, testy i konfigurację CI.

  6. Przy wdrożeniu. Wypuszczaj zmianę za flagą albo przez canary, z rollbackiem, który choć raz przećwiczyłeś.

Skąd wiesz, że zmiana z Claude Code jest bezpieczna, bez czytania każdej linii?

Dział zatytułowany „Skąd wiesz, że zmiana z Claude Code jest bezpieczna, bez czytania każdej linii?”

Czytaj dowody z każdej bramki, a diff otwieraj tylko tam, gdzie wskazują.

DowódCo udowadniaWłaściciel
Odsetek wykrytych podrzuconych błędów dla twojego promptu lub workflow przegląduPrzegląd znajduje klasy defektów, na których ci zależyTech lead
VERDICT: PASS z hooka pre-pushBrak blokującego defektu według twoich spisanych regułAutor
Zielone CI na wypchniętej gałęzi: testy, typy, lintDotychczasowe zachowanie nadal działaCI
Akceptacja na ścieżkach eskalowanych przez CODEOWNERSCzłowiek przyjął ryzyko tam, gdzie pomyłka jest drogaWskazany właściciel kodu
Metryki canary i przećwiczony rollbackProdukcja potwierdza zmianę albo szybko ją cofnieszDyżurny inżynier

Pakiet dowodów określa, co musi zawierać pull request agenta, a code review PR-a agenta bez czytania każdej linii opisuje triaż, który z niego korzysta. Uzasadnienie znajdziesz w dowodach zamiast diffów.

Co psuje się między zatwierdzonym diffem a działającym wdrożeniem?

Dział zatytułowany „Co psuje się między zatwierdzonym diffem a działającym wdrożeniem?”
ObjawPrzyczynaJak naprawić
Zespół ignoruje komentarze z przeglądu Claude’aZa dużo uwag o stylu i drobiazgachZgłaszaj tylko poprawność i bezpieczeństwo, a kategorie „nie zgłaszaj” wpisz do CLAUDE.md
Hook pre-push przepuszcza gałąź, którą powinien zatrzymaćPrompt nie znalazł niczego, czego kazano mu szukaćPodrzuć znany błąd na gałęzi roboczej i uruchom ponownie; zaostrzaj prompt, aż hook zablokuje push
Pull request osłabia własny przeglądJob dla PR-a czyta CLAUDE.md i ustawienia .claude/ z tej gałęziObejmij CLAUDE.md, .claude/ i .github/ regułą CODEOWNERS; w innym CI dodaj --bare --setting-sources "" --strict-mcp-config (--bare uwierzytelnia wyłącznie przez ANTHROPIC_API_KEY albo apiKeyHelper)
Sekret wycieka z joba uruchamianego przez PRNiezaufany kod działał z sekretami w środowiskuZanim włączysz taki wyzwalacz, przejdź przez tożsamość agentów i sekrety
Ultrareview lub zarządzany Code Review jest niedostępnyŻaden nie działa przy Zero Data Retention; Ultrareview nie jest oferowany na Bedrock, Google Cloud ani Foundry (dokumentacja Anthropic, sprawdzone 2026-09-26)Używaj /code-review lokalnie i joba przeglądu opartego na GitHub Action
Rollback zawodzi na produkcjiMigracja usunęła dane, których potrzebuje stary kodRozbij ją według wzorca expand and contract; nigdy nie wdrażaj destrukcyjnej migracji razem z kodem, który jej wymaga

Dalej przejdź do Claude Code na produkcji. Wersję niezależną od narzędzia opisuje wdrażanie z każdym agentem; strony siostrzane: przegląd i wdrożenie z Codexem oraz przegląd i wdrożenie z Cursorem.