Zkoušeli jste někdy vysvětlit, co je to pull request, svému netechnickému kamarádovi a sledovali, jak se mu oči zalévají jako na výrobní lince Krispy Kreme? Teď si představte, že mu říkáte, že AI dokáže nejen porozumět vašemu repozitáři, ale také za vás otevírat PR. Vítejte v roce 2025, kde je váš editor kódu tak trochu druhý pilot, tak trochu spolujezdec a – pokud ho správně nastavíte – docela slušný stážista.
Tato příručka vám ukáže, jak propojit GitHub s Claude Code a automaticky generovat pull requesty. Krok za krokem se dostaneme od „Cože?“ k „Odeslat“, s reálnými pracovními postupy a několika nástrahami, kterým je třeba se vyhnout. Propojíte GitHub, umožníte Claude Code vidět, co se děje, a zajistíte, aby otevíral a aktualizoval PR, které můžete skutečně sloučit, aniž byste měli pocit, že jste uzavřeli dohodu s algoritmickým ďáblem.
Upozornění: Uvidíte zde dvě hlavní cesty – použití integrace GitHub Actions od Claude Code a použití serverů Model Context Protocol (MCP) k poskytnutí bezpečnému a omezenému přístupu Claude k rozhraním GitHub API. Kterou byste si měli vybrat? Pokud chcete pomoc s PR typu plug-and-play přímo v GitHubu, je pro vás cesta Actions tou nejlepší volbou. Pokud chcete lokální ovládání repozitáře řízené chatem s podrobnými oprávněními, MCP je váš silný nástroj.
Co budeme vytvářet
- Bezpečné propojení GitHubu s Claude Code.
- Umožnění Claude analyzovat váš repozitář, navrhovat změny a otevírat PR.
- Automatizace recenzí, štítků, kontrolních seznamů a dokonce i navazujících commitů.
- Přidání zábran, aby nepřejmenoval celý váš monorepozitář na „final_final_v2“.
Proč na tom záleží
Protože přepínání kontextu je daň z produktivity, pro kterou nikdo nehlasoval. AI, která dokáže otevřít PR se stejnou pečlivostí, jakou byste očekávali od mladšího vývojáře (v jeho dobrý den), skutečně šetří čas. Nejde o nahrazení lidí – klid –, ale o nahrazení částí inženýrství typu „ach jo, boilerplate“.
Cesta A: Automatické generování PR pomocí Claude Code GitHub Actions
Pokud žijete celý den v GitHubu (vítejte v klubu), tato cesta vám poskytne bota, který dokáže analyzovat kód v issue a PR, navrhovat změny a dokonce otevírat nebo aktualizovat PR – přímo z vašeho repozitáře.
Co budete potřebovat
- Repozitář GitHub, který ovládáte (nebo větev, kterou můžete rozbít bez pláče).
- Přístup správce repozitáře ke konfiguraci Actions a secrets.
- Klíč Claude API, pokud ho vaše akce nebo pracovní postup potřebuje.
Krok 1: Povolte GitHub Actions ve svém repozitáři
- Přejděte do svého repozitáře → Nastavení → Actions → Obecné.
- Povolte „Povolit všechny akce a opakovaně použitelné pracovní postupy“ (nebo omezte na akce schválené vaší organizací, pokud se na vás vaši bezpečnostní pracovníci již dívají skrz prsty).
Krok 2: Přidejte pracovní postup Claude Code
Vytvořte .github/workflows/claude-pr-bot.yml se spouštěčem založeným na vašem preferovaném pracovním postupu. Zde jsou dva běžné vzory:
Možnost 1: PR řízené issue
- Když otevřete issue se speciálním štítkem (např. ai-pr), pracovní postup se spustí.
- Přečte si výzvu v issue (např. „Přidat přepínač tmavého režimu“), vytvoří novou větev, upraví soubory pomocí Claude, odešle commity a otevře PR s podrobným souhrnem.
Možnost 2: Úpravy řízené komentáři u existujícího PR
- Když komentujete @claude prosím refaktoruj nastavení modalu, pracovní postup se spustí.
- Analyzuje diff, navrhne změny a odešle aktualizace do větve PR.
Startovací pracovní postup (základní náčrt)
name: Claude PR Bot
on:
issues:
types: .
- Rychlý průvodce integrací a případy použití vám poskytne celkový pohled na to, co je rozumné automatizovat (a co ne) v reálných týmech.
- Pokud jste vizuální typ, tato prohlídka ukazuje automaticky generované AI PR v akci, od začátku do konce.
Cesta B: Propojení GitHubu s Claude Code přes MCP (pro pokročilé lokální uživatele)
Pokud chcete, aby Claude pracoval s kontextem vašeho lokálního repozitáře – soubory na vašem počítači, větvemi, se kterými žonglujete, příkazy, kterým věříte – MCP vám poskytne povolený most. Představte si to jako vrátného pro váš repozitář: rozhoduje, které dveře může Claude otevřít.
Co budete potřebovat
- Claude Desktop nebo integraci IDE, která podporuje nástroje MCP.
- Server GitHub MCP, který spouštíte lokálně, nakonfigurovaný s tokenem, který omezuje rozsahy.
- Osobní přístupový token (PAT) pouze s rozsahy, které skutečně potřebujete (např. repo:status, public_repo, pull_request write).
Krok 1: Získejte server GitHub MCP
- Existuje oficiální open-source server, který zpřístupňuje vybrané operace GitHub API (vyhledávání issue, vytváření větví, otevírání PR atd.). Je konfigurovatelný, takže povolíte pouze to, co potřebujete, což také snižuje zmatení AI a udržuje bezpečnost spokojenou. Pro širší pohled na servery MCP a příklady se podívejte do centrálního adresáře.
Krok 2: Nakonfigurujte svého klienta pro komunikaci se serverem
- Ve svém konfiguračním souboru klienta (např. konfigurační soubor JSON pro vaši aplikaci AI) zaregistrujte server GitHub MCP, předejte mu svůj token prostřednictvím proměnných prostředí a přidejte povolené repozitáře na seznam povolených.
- Profesionální tip: Uložte token do systémové klíčenky nebo do souboru dotenv, ne do konfiguračního souboru. Nestaňte se varovným příkladem na vašem příštím celopodnikovém setkání.
Krok 3: Otestujte povrch nástroje
- Požádejte Claude, aby vypsal otevřené issue, přečetl konkrétní soubor nebo vytvořil větev. Ověřte, že nemůže dělat nic, co jste výslovně nepovolili.
- Pouze poté, co zkontrolujete základní příkazy, byste měli povolit create_pull_request.
Krok 4: Nechte Claude navrhnout a otevřít PR
- Příklad výzvy: „V repozitáři org/app-frontend vytvoř novou větev feat/dark-toggle, implementuj přepínač nastavení pro tmavý režim v SettingsPanel.tsx, aktualizuj testy a otevři PR s kontrolním seznamem pro QA.“
- Server řídí: čte stav repozitáře, zapisuje změny (pokud jste nakonfigurovali lokální souborové nástroje), odešle větev, otevře PR s vaší šablonou a zveřejní souhrn.
Skutečná řeč: Zábrany, které skutečně potřebujete
- Dry run režim pouze pro čtení: Nechte Claude vytvořit sjednocený diff (git diff) před přístupem pro zápis. Sloučte, až si ho prohlédnete.
- Šablony těl PR: Zahrňte poznámky o rizicích, plány testů a kroky zavedení. Nechte bota vyplnit šablonu; nechte lidi ji zkontrolovat.
- Pravidla pro označování: Automaticky aplikujte štítky jako ai-generated a needs-tests, aby byly věci zjistitelné a čestné.
- Pojmenování větví: Vyžadujte předponu (ai/ nebo bot/) s pravidly ochrany větví. Roboti také potřebují uniformy.
Příběh z praxe: Požádal jsem AI, aby „opravila chybu ověřování“. „Opravila“ ji odstraněním ověřování. Skvělé pro produktivitu! Strašné pro doslova všechno ostatní. Udržujte úzké rozsahy, konkrétní výzvy a tvrdé CI testy.
Od nuly k PR: Realistický scénář end-to-end
Scénář: Oprava nespolehlivého debounce testu v projektu React
- Otevřete issue: „Debounce util: flake on 200ms boundary in CI.“ Označíte ji ai-pr.
- Spouštěče pracovního postupu. Vyhledá debounce.ts a související testy.
- Claude navrhne diff: upraví časovače pomocí jest.useFakeTimers, přidá okraj v assertions, aktualizuje dokumentaci.
- Bot otevře PR s: názvem, souhrnem, odůvodněním, plánem testů a hodnocením rizika.
- Zkontrolujete diff, zatlačíte zpět: „Okrajový případ, kdy delay=0.“
- Komentujete @claude handle delay=0 with immediate flush; add test. Pracovní postup se znovu spustí, odešle commit.
- CI projde. Squashujete a sloučíte. Někde nespolehlivý test křičí „strýčku“.
Jak vypadají dobré výzvy (a čemu se vyhnout)
- Skvělé: „Přidejte přepínač tmavého režimu do SettingsPanel.tsx; uložte do localStorage; aktualizujte SettingsPanel.test.tsx; dodržujte naše pravidla ESLint; upravte pouze /src/ui/ a /src/utils/; maximálně 250 řádků.“
- Meh: „Implementujte tmavý režim.“
Zajistěte bezpečnost: Rychlá kontrola bezpečnosti a shody
- Rozsahy tokenů: Používejte repo:contents write pouze v případě potřeby; pro vytvoření PR upřednostňujte pull_request write.
- Seznam povolených repozitářů: Uzamkněte bota na jeden repozitář nebo organizaci.
- Protokolování: Zajistěte, aby bot protokoloval své akce a výzvy (minus secrets). Budete chtít důkazy, když „vylepší“ váš Dockerfile.
- Ochrany větví: Vyžadujte dvě lidská schválení pro větve ai/*.
Odstraňování problémů: Když bot nechce botovat
- Nemůže odeslat větve: Zkontrolujte oprávnění Actions pro contents: write a zda má váš token přístup pro zápis do repozitáře.
- Otevírá prázdné PR: Váš kontext builder mu nepředává správné soubory. Zpřísněte logiku výběru souborů.
- Vyprší mu čas na velkých repozitářích: Omezte kontext na změněné cesty nebo manifest. AI má zažívací potíže s 10GB monorepozitáři, stejně jako my ostatní.
- Ignoruje vaši šablonu PR: Potvrďte, že šablona je v .github/pull_request_template.md nebo je propojena v nastavení vašeho repozitáře.
Kdy použít kterou cestu
- Použijte GitHub Actions, pokud chcete odlehčený způsob automatického generování PR z issue nebo komentářů, přičemž vše se děje v GitHubu.
- Použijte MCP, pokud chcete, aby Claude pracoval ve vašem místním prostředí nebo napříč více nástroji s velmi specifickými ovládacími prvky.
Stojí za zmínku: Pokud byste chtěli rychlou kontrolu pracovního postupu nebo vygenerovat solidní startovací výzvu, Sider.AI vám může pomoci navrhnout šablony PR a výzvy k zábranám a poté je iterovat se skutečnými úryvky repozitáře. Je to jako mít názorového editora, který skutečně píše kód. A nekrade vám židli od stolu. Běžné vzory, které budete chtít kopírovat
- Štítky AI PR a CODEOWNERS: Směrujte ai/* PR do recenzní skupiny, která se ráda hádá s roboty.
- Krokové commity: Požádejte Claude, aby vytvořil malé, atomické commity s jasnými zprávami namísto jednoho mega-commitu s názvem „věci“.
- Režim test-first: Nechte pracovní postup nejprve vygenerovat testy, spustit CI a poté vygenerovat implementaci. Je to pomalejší. Je to lepší.
- Práce po sloučení: Přidejte pracovní postup pro automatické otevření navazující issue pro dokumentaci, příznaky funkcí nebo vyčištění.
Rychlá konkurenční kontrola
- Někteří lidé propojují další LLM s podobnými toky GitHub. Fungují – ale schopnost Claude Code uvažovat o kódu a ochota říci „Nejsem si jistý“ vám může ušetřit hodiny hádání a kontrolování. Integrace GitHub Actions to udržuje tam, kde recenze přirozeně probíhají, a cesta MCP je flexibilní pro pokročilé uživatele.
10minutový kontrolní seznam nastavení
- Vyberte cestu: GitHub Actions (rychlejší) nebo MCP (více kontroly).
- Vytvořte svůj token s minimálními rozsahy.
- Přidejte pracovní postup nebo nakonfigurujte server MCP.
- Vytvořte těsný kontext builder: seznamy souborů, limity a pravidla.
- Přidejte ochrany větví a štítky.
- Nejprve otestujte na malé změně. Sloučte. Oslavte. Řekněte svému PM, že jste „zvýšili propustnost“.
Rychlé odkazy, které je třeba mít po ruce
- Dokumentace Claude Code GitHub Actions (vzory, spouštěče, příklady).
- Praktický průvodce integrací a osvědčenými postupy.
- Video prohlídka: AI generované PR end to end.
- Server GitHub MCP pro podrobný, povolený přístup.
- Adresář serverů MCP a příklady pro inspiraci.
Sternovo shrnutí
Automatizace PR pomocí Claude Code nenahradí váš inženýrský tým. Nahradí však nejoblíbenější práce vašeho inženýrského týmu. Začněte s úzkými rozsahy, jasnými výzvami a přísnými recenzemi. Nechte bota, ať se postará o lešení, a vy se postarejte o myšlení. Pak se vraťte k zábavným věcem – jako je konečně smazání souboru utils2.ts, kterému se vyhýbáte, protože prostě víte, že drží aplikaci pohromadě lepicí páskou a sny.
Teď jděte a udělejte si svou budoucí já o něco méně nevrlé. A pokud se bot zblázní? Víte, kde žije tlačítko Vrátit.
FAQ
Otázka 1: Může Claude Code otevírat pull requesty sám?
Ano. S GitHub Actions nebo nastavením MCP může Claude Code vytvořit větev, odeslat změny a otevřít pull request se souhrnem a kontrolním seznamem. Udržujte úzká oprávnění a vyžadujte lidskou kontrolu, aby „neoptimalizoval“ vaši bezpečnost jejím odstraněním.
Otázka 2: Jaký je nejbezpečnější způsob, jak propojit GitHub s Claude Code?
Používejte tokeny s minimálním rozsahem, seznamy povolených repozitářů a ochrany větví. Ať už se rozhodnete pro Actions nebo MCP, povolte suché běhy a vyžadujte, aby testy prošly před sloučením jakéhokoli PR generovaného AI.
Otázka 3: Jak zabráním AI PR dotýkat se celého mého monorepozitáře?
Omezte kontext pomocí seznamů povolených adresářů a manifestu souborů a omezte počet souborů na běh. Dobré výzvy také pomáhají – buďte konkrétní ohledně cest a limitů velikosti.
Otázka 4: Proč jsou mé AI pull requesty prázdné nebo nekvalitní?
Váš kontext builder může dodávat Claude špatné soubory nebo příliš málo detailů. Poskytněte jasné cíle, omezení a očekávání testů – a zvažte dvoufázový tok: nejprve vygenerujte testy, poté implementaci.
Otázka 5: Mám pro Claude Code použít GitHub Actions nebo MCP?
Pokud chcete rychlou, repozitářově nativní automatizaci pro PR a recenze, použijte GitHub Actions. Pokud potřebujete lokální ovládání, vlastní nástroje nebo podrobná oprávnění, MCP vám dává větší sílu – s o něco větším nastavením.
