Vai esat kādreiz mēģinājis paskaidrot, kas ir pull request, savam draugam, kurš nav saistīts ar tehnoloģijām, un vērojis, kā viņa acis kļūst stiklainas kā Krispy Kreme konveijera lentei? Tagad iedomājieties, ka sakāt viņam, ka AI var ne tikai saprast jūsu repo, bet arī atvērt PR jums. Laipni lūdzam 2025. gadā, kur jūsu kodu redaktors ir nedaudz kā otrais pilots, nedaudz kā sēdētājs aizmugurējā sēdeklī un, ja to pareizi iestatāt, diezgan pieklājīgs praktikants.
Šī rokasgrāmata parāda, kā savienot GitHub ar Claude Code un automātiski ģenerēt pull requests. Mēs no "Ha?" nonāksim līdz "Ship it" ar soli pa solim iestatīšanu, reālās pasaules darbplūsmām un dažiem grāvjiem, no kuriem jāizvairās. Jūs savienosiet GitHub, ļausiet Claude Code redzēt, kas notiek, un panāksiet, lai tas atvērtu un atjauninātu PR, ko jūs patiešām varat apvienot, nejūtoties tā, it kā jūs būtu noslēdzis darījumu ar algoritmisko velnu.
Uzmanību: šeit jūs redzēsiet divus galvenos ceļus - Claude Code GitHub Actions integrācijas izmantošanu un Model Context Protocol (MCP) serveru izmantošanu, lai nodrošinātu Claude drošu, ierobežotu piekļuvi GitHub API. Kuru izvēlēties? Ja vēlaties plug-and-play PR palīdzību tieši GitHub, tad Actions maršruts ir jūsu labākā izvēle. Ja vēlaties lokālu, tērzēšanas vadītu repo kontroli ar detalizētām atļaujām, MCP ir jūsu spēcīgais rīks.
Ko mēs veidojam
- Droši savienojiet GitHub ar Claude Code.
- Ļaujiet Claude analizēt jūsu repo, ierosināt izmaiņas un atvērt PR.
- Automatizējiet pārskatus, iezīmes, kontrolsarakstus un pat turpmākos commit.
- Pievienojiet aizsargmargas, lai tas nepārdēvētu visu jūsu monorepo par "final_final_v2".
Kāpēc tas ir svarīgi
Tāpēc, ka konteksta maiņa ir produktivitātes nodoklis, par kuru neviens nav balsojis. AI, kas var atvērt PR ar tādu pašu rūpību, kādu jūs sagaidītu no jaunākā izstrādātāja (viņa labajā dienā), ir reāls laika ietaupījums. Nevis, lai aizstātu cilvēkus (nomierinieties), bet gan, lai aizstātu inženierijas daļas "ugh, boilerplate".
A ceļš: Automātiski ģenerējiet PR ar Claude Code GitHub Actions
Ja jūs visu dienu dzīvojat GitHub (pievienojieties klubam), šis ceļš sniedz jums botu, kas var analizēt kodu jautājumos un PR, ieteikt izmaiņas un pat atvērt vai atjaunināt PR tieši no jūsu repo.
Kas jums būs nepieciešams
- GitHub repo, ko jūs kontrolējat (vai filiāle, kuru jūs varat salauzt bez raudāšanas).
- Repo administratora piekļuve, lai konfigurētu Actions un noslēpumus.
- Claude API atslēga, ja jūsu action vai darbplūsmai tā ir nepieciešama.
1. solis: Iespējojiet GitHub Actions savā repo
- Dodieties uz savu repozitoriju → Settings → Actions → General.
- Iespējojiet "Allow all actions and reusable workflows" (vai ierobežojiet savas organizācijas apstiprinātās darbības, ja jūsu drošības darbinieki jau skatās uz jums ar aizdomām).
2. solis: Pievienojiet Claude Code darbplūsmu
Izveidojiet .github/workflows/claude-pr-bot.yml ar trigeri, pamatojoties uz vēlamo darbplūsmu. Šeit ir divi izplatīti modeļi:
1. iespēja: Uz jautājumiem balstīti PR
- Kad jūs atverat jautājumu ar īpašu iezīmi (piemēram, ai-pr), darbplūsma tiek palaista.
- Tā nolasa jautājuma uzvedni (piemēram, "Pievienot tumšā režīma pārslēgu"), izveido jaunu filiāli, rediģē failus, izmantojot Claude, spiež commit un atver PR ar detalizētu kopsavilkumu.
2. iespēja: Uz komentāriem balstīti labojumi esošā PR
- Kad jūs komentējat @claude please refactor the settings modal, darbplūsma tiek palaista.
- Tā analizē diff, ierosina izmaiņas un spiež atjauninājumus uz PR filiāli.
Sākuma darbplūsma (augsta līmeņa skice)
name: Claude PR Bot
on:
issues:
types: .
- Īsa rokasgrāmata par integrāciju un lietošanas gadījumiem sniedz jums visaptverošu skatījumu uz to, ko ir saprātīgi automatizēt (un kas nav) reālās komandās.
- Ja jūs esat vizuālais apmācāmais, šī pamācība parāda automātiski ģenerētus AI PR darbībā no sākuma līdz beigām.
B ceļš: Savienojiet GitHub ar Claude Code, izmantojot MCP (lokāliem pieredzējušiem lietotājiem)
Ja vēlaties, lai Claude strādātu ar jūsu vietējo repo kontekstu - failiem jūsu datorā, filiālēm, ko jūs žonglējat, komandām, kurām jūs uzticaties - MCP sniedz jums atļauju tiltu. Padomājiet par to kā par durvju sargu jūsu repo: tas izlemj, kuras durvis Claude var atvērt.
Kas jums būs nepieciešams
- Claude Desktop vai IDE integrācija, kas atbalsta MCP rīkus.
- GitHub MCP serveris, ko jūs palaižat lokāli, konfigurēts ar token, kas ierobežo darbības jomas.
- Personīgās piekļuves token (PAT) tikai ar tām darbības jomām, kas jums patiešām ir nepieciešamas (piemēram, repo:status, public_repo, pull_request write).
1. solis: Paņemiet GitHub MCP serveri
- Ir oficiāls atvērtā koda serveris, kas atklāj atlasītas GitHub API darbības (meklēt jautājumus, izveidot filiāles, atvērt PR utt.). Tas ir konfigurējams, lai jūs iespējotu tikai to, kas jums ir nepieciešams, kas arī samazina AI apjukumu un saglabā drošību laimīgu. Lai iegūtu plašāku skatījumu uz MCP serveriem un piemēriem, pārbaudiet centrālo direktoriju.
2. solis: Konfigurējiet savu klientu, lai sazinātos ar serveri
- Savā klienta konfigurācijas failā (piemēram, JSON konfigurācija jūsu AI lietotnei) reģistrējiet GitHub MCP serveri, nododiet tam savu token, izmantojot vides mainīgos, un baltajā sarakstā iekļaujiet atļautos repo.
- Pro padoms: Ievietojiet token savā sistēmas atslēgu saišķī vai dotenv failā, nevis konfigurācijas failā. Nekļūstiet par brīdinājuma piemēru savā nākamajā vispārējā sanāksmē.
3. solis: Pārbaudiet rīka virsmas laukumu
- Palūdziet Claude uzskaitīt atvērtos jautājumus, izlasīt konkrētu failu vai izveidot filiāli. Pārbaudiet, vai tas nevar darīt neko tādu, ko jūs neesat nepārprotami atļāvis.
- Tikai pēc tam, kad esat pārbaudījis pamatkomandas, jums vajadzētu iespējot create_pull_request.
4. solis: Ļaujiet Claude ierosināt un atvērt PR
- Uzvednes piemērs: "Repo org/app-frontend izveidojiet jaunu filiāli feat/dark-toggle, ieviesiet tumšā režīma pārslēgu SettingsPanel.tsx, atjauniniet testus un atveriet PR ar kontrolsarakstu QA."
- Serveris organizē: nolasa repo stāvokli, ieraksta izmaiņas (ja esat konfigurējis vietējos failu rīkus), spiež filiāli, atver PR ar jūsu veidni un ievieto kopsavilkumu.
Reāla saruna: Aizsargmargas, kas jums patiešām ir nepieciešamas
- Tikai lasāmi sausie braucieni: Ļaujiet Claude izveidot vienotu diff (git diff) pirms rakstīšanas piekļuves. Apvienojiet pēc tam, kad esat to apskatījis.
- Veidņu PR pamatteksti: Iekļaujiet riska piezīmes, testu plānus un ieviešanas soļus. Lieciet botam aizpildīt veidni; lieciet cilvēkiem to pārskatīt.
- Marķēšanas noteikumi: Automātiski piemērojiet iezīmes, piemēram, ai-generated un needs-tests, lai lietas būtu atklājamas un godīgas.
- Filiāļu nosaukumu piešķiršana: Pieprasiet prefiksu (ai/ vai bot/) ar filiāļu aizsardzības noteikumiem. Robotiem arī vajadzīgi formastērpi.
Laiks anekdotei: Es palūdzu AI "izlabot autentifikācijas kļūdu". Tas to "izlaboja", noņemot autentifikāciju. Lieliski produktivitātei! Briesmīgi burtiski visam citam. Saglabājiet šauras darbības jomas, precīzas uzvednes un CI testus.
No nulles līdz PR: Reālistisks pilns scenārijs
Scenārijs: Izlabojiet nestabilu debounce testu React projektā
- Jūs atverat jautājumu: "Debounce util: flake on 200ms boundary in CI." Jūs to atzīmējat ar ai-pr.
- Darbplūsmas trigeri. Tas meklē debounce.ts un saistītos testus.
- Claude ierosina diff: pielāgo taimerus ar jest.useFakeTimers, pievieno robežu apgalvojumos, atjaunina dokumentus.
- Bots atver PR ar: nosaukumu, kopsavilkumu, pamatojumu, testa plānu un riska novērtējumu.
- Jūs pārskatāt diff, atspiediet atpakaļ: "Edge case when delay=0."
- Jūs komentējat @claude handle delay=0 with immediate flush; add test. Darbplūsma tiek palaista atkārtoti, spiež commit.
- CI iziet. Jūs saspiežat un apvienojat. Kaut kur nestabils tests kliedz "onkulīt".
Kā izskatās labas uzvednes (un no kā izvairīties)
- Lieliski: "Pievienot tumšā režīma pārslēgu SettingsPanel.tsx; saglabāt localStorage; atjaunināt SettingsPanel.test.tsx; ievērot mūsu ESLint noteikumus; modificēt tikai /src/ui/ un /src/utils/; maks. 250 rindas."
- Meh: "Ieviest tumšo režīmu."
Padariet to drošu: Drošības un atbilstības ātrā pārbaude
- Token darbības jomas: Izmantojiet repo:contents write tikai tad, ja nepieciešams; PR izveidei dodiet priekšroku pull_request write.
- Repozitoriju baltā saraksta: Bloķējiet botu vienam repo vai organizācijai.
- Reģistrēšana: Nodrošiniet, lai bots reģistrētu savas darbības un uzvednes (mīnus noslēpumus). Jūs vēlēsieties pierādījumus, kad tas "uzlabos" jūsu Dockerfile.
- Filiāļu aizsardzība: Pieprasiet divus cilvēku apstiprinājumus ai/* filiālēm.
Problēmu novēršana: Kad bots nebūs bots
- Tas nevar spiest filiāles: Pārbaudiet Actions atļaujas contents: write un to, vai jūsu token ir repo write piekļuve.
- Tas atver tukšus PR: Jūsu konteksta veidotājs nedod tam pareizos failus. Pievelciet failu atlases loģiku.
- Tas pārtrauc darbu lielos repo: Ierobežojiet kontekstu ar mainītiem ceļiem vai manifestu. AI saņem gremošanas traucējumus 10 GB monorepo, tāpat kā pārējie no mums.
- Tas ignorē jūsu PR veidni: Apstipriniet, ka veidne ir .github/pull_request_template.md vai saistīta jūsu repo iestatījumos.
Kad kuru ceļu izmantot
- Izmantojiet GitHub Actions, ja vēlaties vieglu veidu, kā automātiski ģenerēt PR no jautājumiem vai komentāriem, ar visu, kas notiek GitHub.
- Izmantojiet MCP, ja vēlaties, lai Claude darbotos jūsu vietējā vidē vai starp vairākiem rīkiem ar ļoti specifiskiem vadības elementiem.
Vērts atzīmēt: Ja vēlaties ātri pārbaudīt darbplūsmu vai ģenerēt stabilu sākuma uzvedni, Sider.AI var palīdzēt jums izveidot PR veidnes un aizsargmargas, un pēc tam atkārtot tās ar reāliem repo fragmentiem. Tas ir kā having an opinionated editor who actually writes code. And doesn’t steal your desk chair. Izplatīti modeļi, ko vēlēsities kopēt
- AI PR iezīmes un CODEOWNERS: Novirziet ai/* PR uz pārskatīšanas grupu, kurai patīk strīdēties ar robotiem.
- Soli pa solim commit: Palūdziet Claude izveidot mazus, atomārus commit ar skaidriem ziņojumiem, nevis vienu mega-commit ar nosaukumu "stuff".
- Testēšanas pirmais režīms: Lieciet darbplūsmai vispirms ģenerēt testus, palaist CI, pēc tam ģenerēt ieviešanu. Tas ir lēnāk. Tas ir labāk.
- Pēc apvienošanas darbi: Pievienojiet darbplūsmu, lai automātiski atvērtu turpmāku jautājumu par dokumentiem, funkciju karodziņiem vai tīrīšanu.
Ātra konkurences pārbaude
- Daži cilvēki pievieno citus LLM līdzīgām GitHub plūsmām. Tie darbojas, bet Claude Code kodu spriešanas un vēlme teikt "Es neesmu pārliecināts" var ietaupīt jums stundas, kad jāmin un jāpārbauda. GitHub Actions integrācija saglabā to tieši tur, kur dabiski notiek pārskati, un MCP maršruts ir elastīgs pieredzējušiem lietotājiem.
10 minūšu iestatīšanas kontrolsaraksts
- Izvēlieties ceļu: GitHub Actions (ātrāk) vai MCP (vairāk kontroles).
- Izveidojiet savu token ar minimālām darbības jomām.
- Pievienojiet darbplūsmu vai konfigurējiet MCP serveri.
- Izveidojiet stingru konteksta veidotāju: failu sarakstus, ierobežojumus un noteikumus.
- Pievienojiet filiāļu aizsardzību un iezīmes.
- Vispirms pārbaudiet ar nelielu izmaiņu. Apvienojiet. Svinēt. Pasakiet savam PM, ka jūs "palielinājāt caurlaidspēju".
Ātrās atsauces, kas jātur pa rokai
- Claude Code GitHub Actions dokumentācija (modeļi, trigeri, piemēri).
- Praktiska rokasgrāmata integrācijai un labākajai praksei.
- Video pamācība: AI ģenerēti PR no sākuma līdz beigām.
- GitHub MCP serveris detalizētai, atļautai piekļuvei.
- MCP serveru direktorijs un piemēri iedvesmai.
Stern kopsavilkums
PR automatizācija ar Claude Code neaizstās jūsu inženieru komandu. Tas aizstās jūsu inženieru komandas vismazāk iecienītos darbus. Sāciet ar šaurām darbības jomām, skaidrām uzvednēm un stingriem pārskatiem. Ļaujiet botam apstrādāt sastatnes, kamēr jūs apstrādājat domāšanu. Pēc tam atgriezieties pie jautrajām lietām - piemēram, beidzot izdzēsiet to utils2.ts failu, no kura jūs esat izvairījies, jo jūs vienkārši zināt, ka tas notur lietotni kopā ar līmlenti un sapņiem.
Tagad dodieties padarīt savu nākotnes sevi nedaudz mazāk drūmu. Un, ja bots kļūst negodīgs? Jūs zināt, kur atrodas poga Atcelt.
FAQ
Q1:Vai Claude Code var atvērt pull requests pats?
Jā. Izmantojot GitHub Actions vai MCP iestatījumu, Claude Code var izveidot filiāli, spiest izmaiņas un atvērt pull request ar kopsavilkumu un kontrolsarakstu. Saglabājiet ciešas atļaujas un pieprasiet cilvēku pārskatu, lai tas "neoptimizētu" jūsu drošību, to noņemot.
Q2:Kāds ir drošākais veids, kā savienot GitHub ar Claude Code?
Izmantojiet minimālas darbības jomas token, repozitoriju baltos sarakstus un filiāļu aizsardzību. Neatkarīgi no tā, vai izmantojat Actions vai MCP, iespējojiet sausos braucienus un pieprasiet, lai testi tiktu nokārtoti pirms jebkura AI ģenerēta pull request apvienošanas.
Q3:Kā es varu apturēt AI PR no manas visa monorepo aizskaršanas?
Ierobežojiet kontekstu ar atļautiem direktorijiem un failu manifestu un ierobežojiet failu skaitu vienā palaišanas reizē. Labas uzvednes arī palīdz - esiet konkrēts par ceļiem un izmēru ierobežojumiem.
Q4:Kāpēc mani AI pull requests ir tukši vai zemas kvalitātes?
Jūsu konteksta veidotājs var nodot Claude nepareizus failus vai pārāk maz informācijas. Nodrošiniet skaidrus mērķus, ierobežojumus un testu cerības - un apsveriet divu caurlaižu plūsmu: vispirms ģenerējiet testus, pēc tam ieviešanu.
Q5:Vai man vajadzētu izmantot GitHub Actions vai MCP Claude Code?
Ja vēlaties ātru, repo-native automatizāciju PR un pārskatīšanai, izmantojiet GitHub Actions. Ja jums ir nepieciešama vietējā kontrole, pielāgoti rīki vai smalki noregulētas atļaujas, MCP sniedz jums vairāk jaudas - ar nedaudz vairāk iestatīšanas.
