कभी आपने अपने गैर-तकनीकी दोस्त को यह समझाने की कोशिश की है कि पुल रिक्वेस्ट क्या होती है और उनकी आँखें इस तरह चमकने लगती हैं जैसे Krispy Kreme कन्वेयर बेल्ट? अब कल्पना कीजिए कि आप उन्हें बता रहे हैं कि एक AI न केवल आपके रेपो को समझ सकता है, बल्कि आपके लिए PR भी खोल सकता है। 2025 में आपका स्वागत है, जहाँ आपका कोड एडिटर थोड़ा-सा सह-पायलट है, थोड़ा-सा पिछली सीट पर बैठा ड्राइवर है, और—यदि आप इसे सही तरीके से सेट करते हैं—तो एक काफी अच्छा इंटर्न है।
यह गाइड आपको दिखाती है कि GitHub को Claude Code से कैसे कनेक्ट करें और पुल रिक्वेस्ट को ऑटो-जेनरेट कैसे करें। हम चरण-दर-चरण सेटअप, वास्तविक दुनिया के वर्कफ़्लो और कुछ गड्ढों से बचते हुए “Huh?” से “Ship it” तक जाएंगे। आप GitHub को वायर अप करेंगे, Claude Code को यह देखने देंगे कि क्या हो रहा है, और इसे PR खोलने और अपडेट करने देंगे जिसे आप वास्तव में एल्गोरिथम डेविल के साथ सौदा किए बिना मर्ज कर सकते हैं।
ध्यान दें: यहाँ आपको दो मुख्य रास्ते दिखाई देंगे—Claude Code के GitHub Actions इंटीग्रेशन का उपयोग करना और Model Context Protocol (MCP) सर्वर का उपयोग करना ताकि Claude को GitHub API तक सुरक्षित, सीमित पहुँच मिल सके। आपको किसे चुनना चाहिए? यदि आप GitHub में प्लग-एंड-प्ले PR सहायता चाहते हैं, तो Actions रूट आपके लिए सबसे अच्छा है। यदि आप ग्रैन्युलर परमिशन के साथ लोकल, चैट-ड्रिवन रेपो कंट्रोल चाहते हैं, तो MCP आपका पावर टूल है।
हम क्या बना रहे हैं
- GitHub को Claude Code से सुरक्षित रूप से कनेक्ट करें।
- Claude को आपके रेपो का विश्लेषण करने, परिवर्तन प्रस्तावित करने और PR खोलने दें।
- समीक्षाओं, लेबल, चेकलिस्ट और यहां तक कि फॉलो-अप कमिट को भी स्वचालित करें।
- गार्डरेल जोड़ें ताकि यह आपके पूरे मोनोरपो का नाम बदलकर “final_final_v2” न कर दे।
यह क्यों मायने रखता है
क्योंकि संदर्भ स्विचिंग वह उत्पादकता कर है जिसे किसी ने वोट नहीं दिया। AI जो जूनियर डेवलपर (उनके अच्छे दिन पर) से अपेक्षित उसी कठोरता के साथ एक PR खोल सकता है, वह वास्तव में समय बचाने वाला है। मनुष्यों को बदलने के लिए नहीं—शांत हो जाओ—लेकिन इंजीनियरिंग के “ugh, boilerplate” भागों को बदलने के लिए।
पाथ A: Claude Code GitHub Actions के साथ PRs को ऑटो-जेनरेट करें
यदि आप सारा दिन GitHub के अंदर रहते हैं (क्लब में शामिल हों), तो यह पाथ आपको एक बॉट देता है जो मुद्दों और PRs में कोड का विश्लेषण कर सकता है, परिवर्तन सुझा सकता है, और यहां तक कि PRs खोल या अपडेट भी कर सकता है—सीधे आपके रेपो से।
आपको क्या चाहिए
- एक GitHub रेपो जिसे आप नियंत्रित करते हैं (या एक शाखा जिसे आप रोए बिना तोड़ सकते हैं)।
- Actions और सीक्रेट को कॉन्फ़िगर करने के लिए रेपो एडमिन एक्सेस।
- एक Claude API की यदि आपके एक्शन या वर्कफ़्लो को इसकी आवश्यकता है।
चरण 1: अपने रेपो में GitHub Actions को सक्षम करें
- अपने रिपॉजिटरी → सेटिंग्स → Actions → सामान्य पर जाएं।
- “Allow all actions and reusable workflows” सक्षम करें (या अपनी सुरक्षा टीम द्वारा स्वीकृत Actions तक सीमित करें यदि आपके सुरक्षा लोग पहले से ही आपको देख रहे हैं)।
चरण 2: एक Claude Code वर्कफ़्लो जोड़ें
.github/workflows/claude-pr-bot.yml को अपने पसंदीदा वर्कफ़्लो के आधार पर ट्रिगर के साथ बनाएँ। यहां दो सामान्य पैटर्न दिए गए हैं:
विकल्प 1: मुद्दा-ड्रिवन PRs
- जब आप एक विशेष लेबल (जैसे, ai-pr) के साथ एक मुद्दा खोलते हैं, तो वर्कफ़्लो चलता है।
- यह मुद्दे के संकेत को पढ़ता है (जैसे, “डार्क मोड टॉगल जोड़ें”), एक नई शाखा बनाता है, Claude का उपयोग करके फ़ाइलों को संपादित करता है, कमिट को पुश करता है और एक विस्तृत सारांश के साथ एक PR खोलता है।
विकल्प 2: मौजूदा PR पर टिप्पणी-ड्रिवन संपादन
- जब आप टिप्पणी करते हैं @claude कृपया सेटिंग्स मॉडल को रिफैक्टर करें, तो वर्कफ़्लो चलता है।
- यह डिफ का विश्लेषण करता है, परिवर्तन प्रस्तावित करता है और PR शाखा में अपडेट को पुश करता है।
स्टार्टर वर्कफ़्लो (उच्च-स्तरीय स्केच)
name: Claude PR Bot
on:
issues:
types: .
- एकीकरण और उपयोग के मामलों पर एक त्वरित गाइड आपको एक विहंगम दृश्य देता है कि वास्तविक टीमों में स्वचालित करना क्या उचित है (और क्या नहीं)।
- यदि आप एक दृश्य सीखने वाले हैं, तो यह वॉकथ्रू शुरू से अंत तक एक्शन में ऑटो-जेनरेट किए गए AI PRs को दिखाता है।
पाथ B: MCP के माध्यम से GitHub को Claude Code से कनेक्ट करें (स्थानीय पावर उपयोगकर्ताओं के लिए)
यदि आप चाहते हैं कि Claude आपके स्थानीय रेपो संदर्भ के साथ काम करे—आपकी मशीन पर फ़ाइलें, शाखाएँ जिन्हें आप जोड़ रहे हैं, कमांड जिन पर आप भरोसा करते हैं—MCP आपको एक अनुमति प्राप्त ब्रिज देता है। इसे अपने रेपो के लिए एक द्वारपाल के रूप में सोचें: यह तय करता है कि Claude कौन से दरवाजे खोल सकता है।
आपको क्या चाहिए
- Claude Desktop या एक IDE इंटीग्रेशन जो MCP टूलिंग का समर्थन करता है।
- एक GitHub MCP सर्वर जिसे आप स्थानीय रूप से चलाते हैं, जो एक टोकन के साथ कॉन्फ़िगर किया गया है जो स्कोप को सीमित करता है।
- एक व्यक्तिगत एक्सेस टोकन (PAT) जिसमें केवल वही स्कोप हों जिनकी आपको वास्तव में आवश्यकता है (जैसे, repo:status, public_repo, pull_request write)।
चरण 1: एक GitHub MCP सर्वर प्राप्त करें
- एक आधिकारिक ओपन-सोर्स सर्वर है जो चयनित GitHub API ऑपरेशंस (मुद्दों को खोजें, शाखाएं बनाएं, PRs खोलें, आदि) को उजागर करता है। यह कॉन्फ़िगर करने योग्य है इसलिए आप केवल वही सक्षम करते हैं जिसकी आपको आवश्यकता है, जो AI भ्रम को भी कम करता है और सुरक्षा को खुश रखता है। MCP सर्वर और उदाहरणों के व्यापक दृष्टिकोण के लिए, केंद्रीय निर्देशिका देखें।
चरण 2: सर्वर से बात करने के लिए अपने क्लाइंट को कॉन्फ़िगर करें
- अपनी क्लाइंट कॉन्फ़िगरेशन फ़ाइल में (जैसे, आपके AI ऐप के लिए एक JSON कॉन्फ़िगरेशन), GitHub MCP सर्वर को रजिस्टर करें, इसे अपने टोकन को पर्यावरण चर के माध्यम से पास करें और अनुमत रेपो को व्हाइटलिस्ट करें।
- प्रो टिप: टोकन को अपनी सिस्टम कीचेन या डॉटएनवी फ़ाइल में डालें, अपनी कॉन्फ़िगरेशन फ़ाइल में नहीं। अपनी अगली ऑल-हैंड्स में सावधानीपूर्वक उदाहरण न बनें।
चरण 3: टूल सरफेस एरिया का परीक्षण करें
- Claude से खुले मुद्दों को सूचीबद्ध करने, एक विशिष्ट फ़ाइल को पढ़ने या एक शाखा बनाने के लिए कहें। सत्यापित करें कि यह कुछ भी नहीं कर सकता है जिसकी आपने स्पष्ट रूप से अनुमति नहीं दी है।
- बुनियादी कमांड की जांच करने के बाद ही आपको create_pull_request को सक्षम करना चाहिए।
चरण 4: Claude को एक PR प्रस्तावित करने और खोलने दें
- संकेत उदाहरण: “रेपो org/app-frontend में, एक नई शाखा feat/dark-toggle बनाएं, SettingsPanel.tsx में डार्क मोड के लिए एक सेटिंग्स टॉगल लागू करें, परीक्षण अपडेट करें, और QA के लिए एक चेकलिस्ट के साथ एक PR खोलें।”
- सर्वर व्यवस्थित करता है: रेपो स्थिति को पढ़ता है, परिवर्तनों को लिखता है (यदि आपने स्थानीय फ़ाइल टूल कॉन्फ़िगर किए हैं), एक शाखा को पुश करता है, आपके टेम्पलेट के साथ एक PR खोलता है, और एक सारांश पोस्ट करता है।
वास्तविक बात: गार्डरेल जिनकी आपको वास्तव में आवश्यकता है
- रीड-ओनली ड्राई रन: राइट एक्सेस से पहले Claude को एक एकीकृत डिफ (git diff) तैयार करने दें। देखने के बाद मर्ज करें।
- टेम्पलेटेड PR बॉडी: जोखिम नोट्स, परीक्षण योजनाएं और रोलआउट चरण शामिल करें। बॉट को टेम्पलेट पूरा करने दें; मनुष्यों से इसकी समीक्षा करवाएं।
- लेबलिंग नियम: चीजों को खोजने योग्य और ईमानदार रखने के लिए ai-generated और needs-tests जैसे लेबल को ऑटो-अप्लाई करें।
- शाखा नामकरण: शाखा सुरक्षा नियमों के साथ एक उपसर्ग (ai/ या bot/) की आवश्यकता है। रोबोट को भी वर्दी की जरूरत होती है।
उपाख्यान समय: मैंने एक AI से “ऑथ बग को ठीक करने” के लिए कहा। इसने प्रमाणीकरण को हटाकर इसे “ठीक” कर दिया। उत्पादकता के लिए बहुत अच्छा! सचमुच बाकी सब कुछ के लिए भयानक। स्कोप को संकीर्ण रखें, संकेतों को विशिष्ट रखें और CI परीक्षणों का मतलब है।
शून्य से PR तक: एक यथार्थवादी एंड-टू-एंड परिदृश्य
परिदृश्य: एक React प्रोजेक्ट में फ्लकी डिबाउंस टेस्ट को ठीक करें
- आप एक मुद्दा खोलते हैं: “डिबाउंस यूटिल: CI में 200ms सीमा पर फ्लेक।” आप इसे ai-pr टैग करते हैं।
- वर्कफ़्लो ट्रिगर। यह debounce.ts और संबंधित परीक्षणों की खोज करता है।
- Claude एक डिफ प्रस्तावित करता है: jest.useFakeTimers के साथ टाइमर को समायोजित करता है, दावों में एक मार्जिन जोड़ता है, डॉक्स अपडेट करता है।
- बॉट एक PR खोलता है: शीर्षक, सारांश, तर्क, परीक्षण योजना और जोखिम रेटिंग के साथ।
- आप डिफ की समीक्षा करते हैं, वापस पुश करते हैं: “एज केस जब delay=0।”
- आप टिप्पणी करते हैं @claude तत्काल फ्लश के साथ हैंडल delay=0; परीक्षण जोड़ें। वर्कफ़्लो फिर से चलता है, एक कमिट पुश करता है।
- CI पास करता है। आप स्क्वैश और मर्ज करते हैं। कहीं, एक फ्लकी टेस्ट “अंकल” चिल्लाता है।
अच्छे संकेत कैसे दिखते हैं (और क्या बचें)
- महान: “SettingsPanel.tsx में एक डार्क मोड टॉगल जोड़ें; localStorage में बने रहें; SettingsPanel.test.tsx अपडेट करें; हमारे ESLint नियमों का पालन करें; केवल /src/ui/ और /src/utils/ को संशोधित करें; अधिकतम 250 लाइनें।”
- मेह: “डार्क मोड लागू करें।”
इसे सुरक्षित बनाएं: सुरक्षा और अनुपालन त्वरित-जांच
- टोकन स्कोप: repo:contents write का उपयोग केवल तभी करें जब आवश्यक हो; PR बनाने के लिए pull_request write को प्राथमिकता दें।
- रिपॉजिटरी अनुमति सूची: बॉट को एक ही रेपो या org पर लॉक करें।
- लॉगिंग: सुनिश्चित करें कि बॉट अपनी कार्रवाइयों और संकेतों को लॉग करता है (माइनस सीक्रेट)। जब यह आपके Dockerfile को “सुधारता” है तो आप सबूत चाहेंगे।
- शाखा सुरक्षा: ai/* शाखाओं के लिए दो मानवीय अनुमोदन की आवश्यकता है।
समस्या निवारण: जब बॉट बॉट नहीं करेगा
- यह शाखाओं को पुश नहीं कर सकता: contents: write के लिए Actions परमिशन की जाँच करें और आपके टोकन के पास रेपो राइट एक्सेस है।
- यह खाली PRs खोलता है: आपका संदर्भ बिल्डर इसे सही फ़ाइलें नहीं सौंप रहा है। अपनी फ़ाइल चयन तर्क को सख्त करें।
- यह बड़े रेपो पर टाइम आउट हो जाता है: संदर्भ को परिवर्तित रास्तों या एक मेनिफेस्ट तक सीमित करें। AI को 10GB मोनोरपो पर अपच हो जाता है, जैसे हम में से बाकी लोगों को।
- यह आपके PR टेम्पलेट को अनदेखा करता है: पुष्टि करें कि टेम्पलेट .github/pull_request_template.md में है या आपकी रेपो सेटिंग्स में लिंक किया गया है।
किस पथ का उपयोग कब करें
- GitHub Actions का उपयोग करें यदि आप मुद्दों या टिप्पणियों से PRs को ऑटो-जेनरेट करने का एक आसान तरीका चाहते हैं, जिसमें सब कुछ GitHub में हो रहा हो।
- MCP का उपयोग करें यदि आप चाहते हैं कि Claude आपके स्थानीय वातावरण में या बहुत विशिष्ट नियंत्रणों के साथ कई टूल में काम करे।
ध्यान देने योग्य: यदि आप वर्कफ़्लो पर एक त्वरित जांच करना चाहते हैं या एक ठोस स्टार्टर संकेत उत्पन्न करना चाहते हैं, तो Sider.AI आपको PR टेम्पलेट और गार्डरेल संकेत का मसौदा तैयार करने में मदद कर सकता है, फिर वास्तविक रेपो स्निपेट के साथ उन पर पुनरावृति कर सकता है। यह एक राय वाले संपादक होने जैसा है जो वास्तव में कोड लिखता है। और आपकी डेस्क कुर्सी नहीं चुराता है। सामान्य पैटर्न जिन्हें आप कॉपी करना चाहेंगे
- AI PR लेबल और CODEOWNERS: ai/* PRs को एक समीक्षा समूह में रूट करें जो रोबोट के साथ बहस करने का आनंद लेता है।
- चरण-दर-चरण कमिट: Claude को “सामान” नामक एक मेगा-कमिट के बजाय स्पष्ट संदेशों के साथ छोटे, परमाणु कमिट बनाने के लिए कहें।
- टेस्ट-फर्स्ट मोड: वर्कफ़्लो को पहले टेस्ट उत्पन्न करने, CI चलाने, फिर कार्यान्वयन उत्पन्न करने दें। यह धीमा है। यह बेहतर है।
- पोस्ट-मर्ज कार्य: डॉक्स, फीचर फ़्लैग या क्लीनअप के लिए एक फॉलो-अप मुद्दा ऑटो-ओपन करने के लिए एक वर्कफ़्लो जोड़ें।
एक त्वरित प्रतिस्पर्धी पेट जांच
- कुछ लोग अन्य LLM को समान GitHub फ़्लो से जोड़ रहे हैं। वे काम करते हैं—लेकिन Claude Code की कोड तर्क क्षमता और “मुझे यकीन नहीं है” कहने की इच्छा आपको अनुमान लगाने और जाँच करने के घंटों बचा सकती है। GitHub Actions एकीकरण इसे वहीं रखता है जहाँ समीक्षाएँ स्वाभाविक रूप से होती हैं, और MCP रूट पावर उपयोगकर्ताओं के लिए लचीला है।
10 मिनट का सेटअप चेकलिस्ट
- एक पथ चुनें: GitHub Actions (तेज़) या MCP (अधिक नियंत्रण)।
- न्यूनतम स्कोप के साथ अपना टोकन बनाएं।
- वर्कफ़्लो जोड़ें या MCP सर्वर को कॉन्फ़िगर करें।
- एक तंग संदर्भ बिल्डर बनाएं: फ़ाइल सूची, सीमाएं और नियम।
- शाखा सुरक्षा और लेबल जोड़ें।
- पहले एक छोटे से बदलाव पर परीक्षण करें। मर्ज करें। जश्न मनाएं। अपने PM को बताएं कि आपने “थ्रूपुट स्केल किया।”
हाथ में रखने के लिए त्वरित संदर्भ
- Claude Code GitHub Actions प्रलेखन (पैटर्न, ट्रिगर, उदाहरण)।
- एकीकरण और सर्वोत्तम प्रथाओं के लिए व्यावहारिक गाइड।
- वीडियो वॉकथ्रू: AI-जेनरेटेड PRs एंड टू एंड।
- ग्रैन्युलर, अनुमति प्राप्त एक्सेस के लिए GitHub MCP सर्वर।
- प्रेरणा के लिए MCP सर्वर निर्देशिका और उदाहरण।
स्टर्न रैप-अप
Claude Code के साथ PRs को स्वचालित करने से आपकी इंजीनियरिंग टीम प्रतिस्थापित नहीं होगी। यह आपकी इंजीनियरिंग टीम के सबसे कम पसंदीदा कामों को बदल देगा। तंग स्कोप, स्पष्ट संकेत और सख्त समीक्षाओं से शुरुआत करें। बॉट को मचान संभालने दें जबकि आप सोचने का काम संभालते हैं। फिर मज़ेदार चीज़ों पर वापस जाएँ—जैसे कि अंततः उस utils2.ts फ़ाइल को हटाना जिसे आप टाल रहे हैं क्योंकि आप जानते हैं कि यह डक्ट टेप और सपनों के साथ ऐप को एक साथ पकड़े हुए है।
अब जाओ और अपने भविष्य के स्वयं को थोड़ा कम गुस्सैल बनाओ। और अगर बॉट दुष्ट हो जाता है? आप जानते हैं कि रिवर्ट बटन कहाँ रहता है।
सामान्य प्रश्न
Q1: क्या Claude Code अपने आप पुल रिक्वेस्ट खोल सकता है?
हाँ। GitHub Actions या एक MCP सेटअप के साथ, Claude Code एक शाखा बना सकता है, परिवर्तन पुश कर सकता है और एक सारांश और चेकलिस्ट के साथ एक पुल रिक्वेस्ट खोल सकता है। अनुमति सख्त रखें और मानवीय समीक्षा की आवश्यकता है ताकि यह इसे हटाकर आपकी सुरक्षा को “अनुकूलित” न करे।
Q2: GitHub को Claude Code से कनेक्ट करने का सबसे सुरक्षित तरीका क्या है?
न्यूनतम-स्कोप टोकन, रिपॉजिटरी अनुमति सूची और शाखा सुरक्षा का उपयोग करें। चाहे आप Actions या MCP के साथ जाएं, ड्राई रन सक्षम करें और किसी भी AI-जेनरेट किए गए पुल रिक्वेस्ट को मर्ज करने से पहले परीक्षणों को पास करने की आवश्यकता है।
Q3: मैं AI PRs को अपने पूरे मोनोरपो को छूने से कैसे रोकूं?
अनुमति प्राप्त निर्देशिकाओं और एक फ़ाइल मेनिफेस्ट के साथ संदर्भ को स्कोप करें और प्रति रन फ़ाइलों की संख्या को सीमित करें। अच्छे संकेत भी मदद करते हैं—रास्तों और आकार सीमा के बारे में विशिष्ट रहें।
Q4: मेरे AI पुल रिक्वेस्ट खाली या निम्न गुणवत्ता वाले क्यों हैं?
आपका संदर्भ बिल्डर Claude को गलत फ़ाइलें या बहुत कम विवरण दे रहा होगा। स्पष्ट लक्ष्य, बाधाएं और परीक्षण अपेक्षाएं प्रदान करें—और दो-पास प्रवाह पर विचार करें: पहले परीक्षण उत्पन्न करें, फिर कार्यान्वयन।
Q5: मुझे Claude Code के लिए GitHub Actions या MCP का उपयोग करना चाहिए?
यदि आप PRs और समीक्षाओं के लिए त्वरित, रेपो-देशी स्वचालन चाहते हैं, तो GitHub Actions का उपयोग करें। यदि आपको स्थानीय नियंत्रण, कस्टम टूल या बारीक अनुमति की आवश्यकता है, तो MCP आपको थोड़ा अधिक सेटअप के साथ अधिक शक्ति देता है।
