Skúšali ste už niekedy vysvetliť, čo je to pull request, svojmu kamarátovi, ktorý nie je z technického prostredia, a sledovali ste, ako sa mu oči zakalia ako na páse v Krispy Kreme? Teraz si predstavte, že mu poviete, že AI dokáže nielen porozumieť vášmu repozitáru, ale aj za vás otvoriť PR. Vitajte v roku 2025, kde je váš editor kódu tak trochu druhý pilot, tak trochu spolujazdec a – ak ho správne nastavíte – celkom slušný stážista.
Tento návod vám ukáže, ako pripojiť GitHub ku Claude Code a automaticky generovať pull requesty. Prejdeme od „Čože?“ k „Odoslať!“ pomocou podrobných nastavení, reálnych pracovných postupov a niekoľkých nástrah, ktorým sa treba vyhnúť. Prepojíte GitHub, umožníte Claude Code vidieť, čo sa deje, a prinútite ho otvárať a aktualizovať PR, ktoré môžete skutočne zlúčiť bez toho, aby ste mali pocit, že ste uzavreli dohodu s algoritmickým diablom.
Upozornenie: Uvidíte tu dve hlavné cesty – použitie integrácie GitHub Actions pre Claude Code a použitie serverov Model Context Protocol (MCP) na poskytnutie Claude bezpečný a rozsahovo obmedzený prístup k GitHub API. Ktorú by ste si mali vybrať? Ak chcete pomoc typu plug-and-play priamo v GitHub, cesta cez Actions je vaša najlepšia voľba. Ak chcete lokálne, chatom riadené ovládanie repozitára s podrobnými povoleniami, MCP je váš výkonný nástroj.
Čo budujeme
- Bezpečné pripojenie GitHub ku Claude Code.
- Nechajte Claude analyzovať váš repozitár, navrhovať zmeny a otvárať PR.
- Automatizujte recenzie, štítky, kontrolné zoznamy a dokonca aj následné commity.
- Pridajte zábrany, aby nepomenoval celý váš monorepo na „final_final_v2“.
Prečo na tom záleží
Pretože prepínanie kontextu je daň z produktivity, za ktorú nikto nehlasoval. AI, ktorá dokáže otvoriť PR s rovnakou dôslednosťou, akú by ste očakávali od mladšieho vývojára (v jeho dobrý deň), skutočne šetrí čas. Nie na nahradenie ľudí – upokojte sa – ale na nahradenie častí inžinierstva typu „fuj, štandardné postupy“.
Cesta A: Automatické generovanie PR pomocou GitHub Actions pre Claude Code
Ak žijete vnútri GitHub celý deň (pridajte sa do klubu), táto cesta vám poskytne bota, ktorý dokáže analyzovať kód v issue a PR, navrhovať zmeny a dokonca otvárať alebo aktualizovať PR – priamo z vášho repozitára.
Čo budete potrebovať
- Repozitár GitHub, ktorý kontrolujete (alebo vetvu, ktorú môžete pokaziť bez plaču).
- Administrátorský prístup k repozitáru na konfiguráciu Actions a tajomstiev.
- API kľúč Claude, ak ho vaša akcia alebo pracovný postup potrebuje.
Krok 1: Povolenie GitHub Actions vo vašom repozitári
- Prejdite do svojho repozitára → Nastavenia → Actions → Všeobecné.
- Povoľte „Povoliť všetky akcie a opakovane použiteľné pracovné postupy“ (alebo obmedzte na schválené akcie vašej organizácie, ak sa na vás už vaši bezpečnostní pracovníci pozerajú podozrievavo).
Krok 2: Pridanie pracovného postupu pre Claude Code
Vytvorte .github/workflows/claude-pr-bot.yml s triggerom na základe preferovaného pracovného postupu. Tu sú dva bežné vzory:
Možnosť 1: PR riadené issue
- Keď otvoríte issue so špeciálnym štítkom (napr. ai-pr), spustí sa pracovný postup.
- Prečíta výzvu issue (napr. „Pridať prepínač tmavého režimu“), vytvorí novú vetvu, upraví súbory pomocou Claude, odošle commity a otvorí PR s podrobným súhrnom.
Možnosť 2: Úpravy riadené komentármi v existujúcom PR
- Keď napíšete komentár @claude prosím refaktoruj modálne okno nastavení, spustí sa pracovný postup.
- Analyzuje rozdiel, navrhne zmeny a odošle aktualizácie do vetvy PR.
Štartovací pracovný postup (všeobecný náčrt)
name: Claude PR Bot
on:
issues:
types: .
- Rýchly sprievodca integráciou a prípadmi použitia vám poskytne prehľad o tom, čo je rozumné automatizovať (a čo nie) v reálnych tímoch.
- Ak ste vizuálny typ, táto prehliadka zobrazuje automaticky generované AI PR v akcii, od začiatku do konca.
Cesta B: Pripojenie GitHub ku Claude Code cez MCP (pre lokálnych skúsených používateľov)
Ak chcete, aby Claude pracoval s vaším lokálnym kontextom repozitára – súbormi na vašom stroji, vetvami, s ktorými žonglujete, príkazmi, ktorým dôverujete – MCP vám poskytne most s povoleniami. Predstavte si ho ako vrátnika pre váš repozitár: rozhoduje, ktoré dvere môže Claude otvoriť.
Čo budete potrebovať
- Claude Desktop alebo integráciu IDE, ktorá podporuje nástroje MCP.
- Server GitHub MCP, ktorý spúšťate lokálne, nakonfigurovaný s tokenom, ktorý obmedzuje rozsahy.
- Osobný prístupový token (PAT) iba s rozsahmi, ktoré skutočne potrebujete (napr. repo:status, public_repo, pull_request write).
Krok 1: Získanie servera GitHub MCP
- Existuje oficiálny open-source server, ktorý sprístupňuje vybrané operácie GitHub API (vyhľadávanie issue, vytváranie vetiev, otváranie PR atď.). Je konfigurovateľný, takže povolíte iba to, čo potrebujete, čo tiež znižuje zmätok AI a udržuje bezpečnosť v pohode. Pre širší prehľad o serveroch MCP a príkladoch si pozrite centrálny adresár.
Krok 2: Konfigurácia klienta na komunikáciu so serverom
- V konfiguračnom súbore klienta (napr. konfiguračný súbor JSON pre vašu AI aplikáciu) zaregistrujte server GitHub MCP, odovzdajte mu svoj token prostredníctvom premenných prostredia a pridajte na zoznam povolených repozitárov povolené repozitáre.
- Profesionálny tip: Uložte token do systémového kľúčenky alebo súboru dotenv, nie do konfiguračného súboru. Nestaňte sa varovným príkladom na vašej nasledujúcej celofiremnej schôdzi.
Krok 3: Otestovanie povrchu nástroja
- Požiadajte Claude, aby vypísal otvorené issue, prečítal konkrétny súbor alebo vytvoril vetvu. Overte, či nemôže urobiť nič, čo ste výslovne nepovolili.
- Až po kontrole základných príkazov by ste mali povoliť create_pull_request.
Krok 4: Nechajte Claude navrhnúť a otvoriť PR
- Príklad výzvy: „V repozitári org/app-frontend vytvorte novú vetvu feat/dark-toggle, implementujte prepínač nastavení pre tmavý režim v SettingsPanel.tsx, aktualizujte testy a otvorte PR s kontrolným zoznamom pre QA.“
- Server zosúlaďuje: prečíta stav repozitára, zapíše zmeny (ak ste nakonfigurovali lokálne nástroje pre súbory), odošle vetvu, otvorí PR s vašou šablónou a zverejní súhrn.
Na rovinu: Zábrany, ktoré skutočne potrebujete
- Skúšobné spustenia iba na čítanie: Nechajte Claude vytvoriť zjednotený rozdiel (git diff) pred prístupom na zápis. Zlúčte po tom, čo ste si ho prezreli.
- Šablónové telá PR: Zahrňte poznámky o riziku, plány testovania a kroky zavedenia. Prinúťte bota vyplniť šablónu; prinúťte ľudí, aby ju skontrolovali.
- Pravidlá označovania: Automaticky aplikujte štítky ako ai-generated a needs-tests, aby boli veci zistiteľné a čestné.
- Pomenovanie vetiev: Vyžadujte predponu (ai/ alebo bot/) s pravidlami ochrany vetiev. Aj roboty potrebujú uniformy.
Príbeh zo života: Požiadal som AI, aby „opravila chybu autentifikácie“. „Opravila“ ju odstránením autentifikácie. Skvelé pre produktivitu! Hrozné pre doslova všetko ostatné. Udržujte úzke rozsahy, konkrétne výzvy a význam testov CI.
Od nuly k PR: Realistický scenár od začiatku do konca
Scenár: Oprava nestabilného testu debounce v projekte React
- Otvoríte issue: „Debounce util: nestabilita na hranici 200 ms v CI.“ Označíte ju štítkom ai-pr.
- Spustia sa pracovné postupy. Vyhľadá debounce.ts a súvisiace testy.
- Claude navrhne rozdiel: upraví časovače pomocou jest.useFakeTimers, pridá okraj v assertion, aktualizuje dokumentáciu.
- Bot otvorí PR s: názvom, súhrnom, zdôvodnením, plánom testovania a hodnotením rizika.
- Skontrolujete rozdiel, vrátite sa: „Okrajový prípad, keď delay=0.“
- Napíšete komentár @claude spracuj delay=0 s okamžitým vyprázdnením; pridaj test. Pracovný postup sa znova spustí, odošle commit.
- CI prejde. Všetko spojíte a zlúčite. Niekde plače nestabilný test „strýčko“.
Ako vyzerajú dobré výzvy (a čomu sa vyhnúť)
- Skvelé: „Pridaj prepínač tmavého režimu do SettingsPanel.tsx; uložiť do localStorage; aktualizovať SettingsPanel.test.tsx; dodržiavať naše pravidlá ESLint; upravovať iba /src/ui/ a /src/utils/; maximálne 250 riadkov.“
- Priemerné: „Implementovať tmavý režim.“
Zaistite bezpečnosť: Rýchla kontrola bezpečnosti a zhody
- Rozsahy tokenov: Používajte repo:contents write iba vtedy, ak je to potrebné; uprednostňujte pull_request write pre vytvorenie PR.
- Zoznam povolených repozitárov: Uzamknite bota na jeden repozitár alebo organizáciu.
- Zaznamenávanie: Zabezpečte, aby bot zaznamenával svoje akcie a výzvy (mínus tajomstvá). Budete chcieť dôkazy, keď „vylepší“ váš Dockerfile.
- Ochrana vetiev: Vyžadujte dve ľudské schválenia pre vetvy ai/*.
Riešenie problémov: Keď bot nechce botovať
- Nemôže odosielať vetvy: Skontrolujte povolenia Actions pre contents: write a či má váš token prístup na zápis do repozitára.
- Otvorí prázdne PR: Váš nástroj na vytváranie kontextu mu neposkytuje správne súbory. Sprísnite logiku výberu súborov.
- Časový limit vyprší na veľkých repozitároch: Obmedzte kontext na zmenené cesty alebo manifest. AI má tráviace ťažkosti na 10 GB monorepo, rovnako ako my ostatní.
- Ignoruje vašu šablónu PR: Potvrďte, že šablóna je v .github/pull_request_template.md alebo je prepojená v nastaveniach vášho repozitára.
Kedy použiť ktorú cestu
- Použite GitHub Actions, ak chcete jednoduchý spôsob automatického generovania PR z issue alebo komentárov, pričom sa všetko deje v GitHub.
- Použite MCP, ak chcete, aby Claude pracoval vo vašom lokálnom prostredí alebo naprieč viacerými nástrojmi s veľmi špecifickými ovládacími prvkami.
Stojí za zmienku: Ak by ste chceli rýchlu kontrolu pracovného postupu alebo vygenerovať solídnu štartovaciu výzvu, Sider.AI vám môže pomôcť navrhnúť šablóny PR a výzvy na ochranu a potom ich iterovať pomocou skutočných útržkov repozitára. Je to ako mať zaujatého editora, ktorý skutočne píše kód. A nekradne vám stoličku pri stole. Bežné vzory, ktoré budete chcieť skopírovať
- Štítky AI PR a CODEOWNERS: Smerujte PR ai/* do recenznej skupiny, ktorá sa rada háda s robotmi.
- Commity krok za krokom: Požiadajte Claude, aby vytvoril malé, atomické commity s jasnými správami namiesto jedného mega-commitu s názvom „veci“.
- Režim testovania ako prvý: Nechajte pracovný postup najprv vygenerovať testy, spustiť CI a potom vygenerovať implementáciu. Je to pomalšie. Je to lepšie.
- Práce po zlúčení: Pridajte pracovný postup na automatické otvorenie následnej issue pre dokumentáciu, prepínače funkcií alebo vyčistenie.
Rýchla konkurenčná kontrola
- Niektorí ľudia prepájajú iné LLM s podobnými tokmi GitHub. Fungujú – ale kódové odôvodnenie Claude Code a ochota povedať „Nie som si istý“ vám môžu ušetriť hodiny hádania a kontroly. Integrácia GitHub Actions ho udržuje tam, kde sa prirodzene dejú recenzie, a cesta MCP je flexibilná pre skúsených používateľov.
10-minútový kontrolný zoznam nastavenia
- Vyberte si cestu: GitHub Actions (rýchlejšie) alebo MCP (viac kontroly).
- Vytvorte si token s minimálnymi rozsahmi.
- Pridajte pracovný postup alebo nakonfigurujte server MCP.
- Vytvorte si nástroj na vytváranie úzkeho kontextu: zoznamy súborov, limity a pravidlá.
- Pridajte ochranu vetiev a štítky.
- Najprv otestujte na malej zmene. Zlúčte. Oslavujte. Povedzte svojmu PM, že ste „zvýšili priepustnosť“.
Rýchle referencie, ktoré by ste mali mať po ruke
- Dokumentácia GitHub Actions pre Claude Code (vzory, triggery, príklady).
- Praktický sprievodca integráciou a osvedčenými postupmi.
- Video prehliadka: AI generované PR od začiatku do konca.
- Server GitHub MCP pre podrobný prístup s povoleniami.
- Adresár serverov MCP a príklady pre inšpiráciu.
Sternov záver
Automatizácia PR pomocou Claude Code nenahradí váš inžiniersky tím. Nahradí najmenej obľúbené práce vášho inžinierskeho tímu. Začnite s úzkymi rozsahmi, jasnými výzvami a prísnymi recenziami. Nechajte bota, aby sa postaral o lešenie, zatiaľ čo vy sa postaráte o premýšľanie. Potom sa vráťte k zábavným veciam – ako je konečné odstránenie súboru utils2.ts, ktorému sa vyhýbate, pretože viete, že drží aplikáciu pohromade lepiacou páskou a snami.
Teraz choďte a urobte zo svojho budúceho ja o niečo menej mrzuté. A ak sa bot zblázni? Viete, kde sa nachádza tlačidlo Vrátiť.
FAQ
Otázka č. 1: Môže Claude Code otvárať pull requesty sám?
Áno. Pomocou GitHub Actions alebo nastavenia MCP môže Claude Code vytvoriť vetvu, odoslať zmeny a otvoriť pull request so súhrnom a kontrolným zoznamom. Udržujte prísne povolenia a vyžadujte ľudskú kontrolu, aby „neoptimalizoval“ vašu bezpečnosť jej odstránením.
Otázka č. 2: Aký je najbezpečnejší spôsob pripojenia GitHub ku Claude Code?
Používajte tokeny s minimálnym rozsahom, zoznamy povolených repozitárov a ochranu vetiev. Či už sa rozhodnete pre Actions alebo MCP, povoľte skúšobné spustenia a vyžadujte, aby testy prešli pred zlúčením akéhokoľvek pull requestu generovaného AI.
Otázka č. 3: Ako zabránim AI PR, aby sa dotýkali celého môjho monorepo?
Obmedzte kontext pomocou zoznamu povolených adresárov a manifestu súborov a obmedzte počet súborov na spustenie. Pomáhajú aj dobré výzvy – buďte konkrétni ohľadom ciest a obmedzení veľkosti.
Otázka č. 4: Prečo sú moje AI pull requesty prázdne alebo nízkej kvality?
Váš nástroj na vytváranie kontextu môže poskytovať Claude nesprávne súbory alebo príliš málo detailov. Poskytnite jasné ciele, obmedzenia a očakávania testov – a zvážte dvojfázový tok: najprv vygenerujte testy, potom implementáciu.
Otázka č. 5: Mám použiť GitHub Actions alebo MCP pre Claude Code?
Ak chcete rýchlu, repozitárom natívnu automatizáciu pre PR a recenzie, použite GitHub Actions. Ak potrebujete lokálne ovládanie, vlastné nástroje alebo podrobné povolenia, MCP vám poskytne viac energie – s trochou viac nastavenia.
