Claude Code Xcode प्लगइन: सेटअप और MCP त्रुटियों का समाधान
Apple के प्लगइन या सीधे MCP पंजीकरण से Claude Code को Xcode से जोड़ें। स्थानीय एक्सपोर्ट कमांड और चुने गए Xcode की जाँच करें, बाहरी एजेंट को अनुमति दें और असली बिल्ड से कनेक्शन परखें। गायब टूल की समस्या सुलझाएँ और Codex जोड़ें, बिना प्लगइन के दायरे और मॉडल की बिलिंग को मिलाए।
विषय-सूची

Claude Code Swift फ़ाइलें बदल सकता है, फिर भी Xcode में बिल्ड, टेस्ट और प्रीव्यू चलाने की पहुँच नहीं हो सकती। अपने Mac पर Claude Code जोड़ने से पहले Xcode में बाहरी एजेंट की पहुँच चालू करें और प्रोजेक्ट खोलें। स्थानीय एक्सपोर्ट कमांड काम करे तो xcode@claude-plugins-official स्थापित करें; वरना Apple के दस्तावेज़ में बताया गया xcrun mcpbridge वाला तरीका अपनाएँ।
नीचे दिए गए निर्देश 2026-11-16 को उपलब्ध आधिकारिक दस्तावेज़ पर आधारित हैं। Apple की बाहरी एजेंट जोड़ने की गाइड में अनुमतियाँ और सीधे MCP कनेक्शन का तरीका बताया गया है।
स्थापना से पहले जाँचें कि Mac पर कौन-सा Xcode चुना गया है
Xcode की पूरी स्थापना और Claude Code CLI का मौजूदा संस्करण इस्तेमाल करें। मार्केटप्लेस आपके Mac के Xcode टूल से प्लगइन लेता है। मार्केटप्लेस से पैकेज स्थापित करने पर गायब Xcode अपने-आप स्थापित नहीं होता।
Bash में अपने ऐप की रिपॉज़िटरी से CLI का संस्करण और चुनी गई डेवलपर डायरेक्टरी जाँचें:
claude --version
xcode-select --print-path
डेवलपर डायरेक्टरी उसी Xcode स्थापना की होनी चाहिए जिसे आप इस्तेमाल करना चाहते हैं। /Library/Developer/CommandLineTools का परिणाम अलग से स्थापित कमांड-लाइन टूल पैकेज दिखाता है, Xcode ऐप नहीं। Apple की कमांड-लाइन टूल सेटिंग की गाइड यह अंतर समझाती है।
इसके बाद वही कमांड चलाएँ जिसका मार्केटप्लेस इस्तेमाल करता है:
xcrun agent plugin path --plugin-format claude
एक्सपोर्ट कमांड सफल होने पर प्लगइन की डायरेक्टरी का पूरा पथ दिखाती है। उस डायरेक्टरी को न हटाएँ, न दूसरी जगह ले जाएँ। मार्केटप्लेस mode: "link" इस्तेमाल करता है, जो बनाई गई फ़ाइलें उसी स्थान से लोड करता है।
आधिकारिक बदलाव सूची के अनुसार, Claude Code ने 2.1.229 में कमांड-आधारित प्लगइन स्रोतों का समर्थन जोड़ा था। उस पुराने संस्करण पर टिके रहने के बजाय मौजूदा रिलीज़ इस्तेमाल करें। Xcode के लिए एक्सपोर्ट कमांड की जाँच सफल होनी चाहिए। केवल mcpbridge उपलब्ध होने से यह न मानें कि agent plugin path भी उपलब्ध है।
यदि claude कमांड ही नहीं मिलती, तो Xcode की जाँच से पहले Claude Code की स्थापना और पहले रन की जाँच पूरी करें।
बाहरी एजेंट को अनुमति दें और प्रोजेक्ट खोलें
Xcode की Intelligence सेटिंग में बाहरी प्रक्रिया को पहुँच दें। Claude Code प्लगइन स्थापित करना और यह अनुमति देना अलग-अलग कदम हैं।
- Xcode > Settings > Intelligence खोलें।
- Model Context Protocol में Allow External Agents to Use Xcode Tools को While Xcode is Open या Always पर सेट करें।
- वह प्रोजेक्ट या वर्कस्पेस खोलें जिसका एजेंट को इस्तेमाल करना है।
इस इंटरैक्टिव काम के लिए While Xcode is Open चुनें। नीचे दी गई जाँच के दौरान प्रोजेक्ट खुला रखें। Apple के दस्तावेज़ के अनुसार, बाहरी एजेंट जुड़ने पर और उसके सक्रिय रहने के दौरान Xcode सूचना देता है।
मॉडल से अपना काम कर रहा कनेक्शन भी बनाए रखें। Claude Code के लिए पात्र Claude सदस्यता में इस्तेमाल प्लान के कोटे से होता है; Claude Console खाते में API का बिल अलग बनता है। मौजूदा कोटा पर्याप्त हो तो सदस्यता चुनें, और इस्तेमाल के हिसाब से भुगतान करना हो तो API चुनें। पहुँच खरीदने से पहले Claude Code की प्रमाणीकरण गाइड और Anthropic की क्षेत्रीय पात्रता जाँचें।
BetterToken भी इस्तेमाल के हिसाब से भुगतान वाला API विकल्प है। इसके लिए अपना खाता और कंसोल में बनाई गई कुंजी लेकर दस्तावेज़ में दी गई Claude Code सेटिंग इस्तेमाल करें। अलग से बैलेंस भरकर API इस्तेमाल करना हो तो यह विकल्प चुनें। भुगतान से पहले मॉडल की बिलिंग इकाइयाँ, भुगतान के तरीके और शुल्क जाँचें। इसमें Claude की सदस्यता शामिल नहीं है। मॉडल की मौजूदा कीमतें देखें और कंसोल में भुगतान की शर्तें पक्की करें।
प्लगइन या सीधा MCP कनेक्शन चुनें
Xcode की एक्सपोर्ट कमांड काम करे तो प्लगइन इस्तेमाल करें। केवल ब्रिज कनेक्शन चाहिए, या एक्सपोर्ट कमांड उपलब्ध नहीं है लेकिन mcpbridge काम करता है, तो सीधे MCP पंजीकरण का तरीका चुनें।
आधिकारिक मार्केटप्लेस प्रविष्टि में लेखक Apple Inc. दर्ज है। प्लगइन का स्रोत स्थानीय तौर पर xcrun agent plugin path --plugin-format claude चलाता है। इसके बजाय, सीधे कनेक्शन वाली कमांड xcrun mcpbridge को MCP सर्वर के रूप में पंजीकृत करती है।
यह पैकेजिंग का अंतर है। इससे यह साबित नहीं होता कि किसी एक तरीके से बिल्ड के परिणाम बेहतर होंगे। प्लगइन में MCP सेटिंग के साथ स्किल, यानी एजेंट के लिए निर्देश, और दूसरे घटक भी हो सकते हैं। स्किल की सूची स्थिर या दोनों तरीकों की क्षमताएँ पूरी तरह समान मानने के बजाय स्थापित पैकेज जाँचें। शुरुआत में एक ही तरीका अपनाएँ, ताकि खराबी की वजह पहचानना आसान रहे।
xcode@claude-plugins-official स्थापित करें
अपनी रिपॉज़िटरी से claude चलाकर Claude Code शुरू करें। नीचे दी गई कमांड उसके इंटरैक्टिव प्रॉम्प्ट में डालें, Bash में नहीं:
/plugin install xcode@claude-plugins-official
स्थापना के विकल्प जाँचें और पहली बार केवल इस रिपॉज़िटरी में परखने के लिए स्थानीय दायरा चुनें। दिखाई गई एक्सपोर्ट कमांड को ऊपर वाली कमांड से मिलाने के बाद ही अनुमति दें। स्थापना के सारांश में दोबारा लोड करने का निर्देश हो तो उसका पालन करें, या नया Claude Code सत्र शुरू करें।
इसके बाद उसी रिपॉज़िटरी में Bash से स्थापना जाँचें:
claude plugin list
claude plugin details xcode@claude-plugins-official
पक्का करें कि पैकेज चालू है और उसके घटकों की सूची देखें। प्लगइन कमांड संदर्भ में इस सूची का विवरण है, जिसमें स्किल और MCP सर्वर भी शामिल हैं।
Claude Code में /mcp चलाएँ और प्लगइन से मिले सर्वर को जाँचें। प्लगइन के MCP सर्वर का नाम plugin:<plugin>:<server> रूप में होता है। केवल xcode नाम की प्रविष्टि मिलना ज़रूरी नहीं है।
बाद में दायरा बदलने या पैकेज हटाने के लिए प्लगइन की स्थापना, जाँच और हटाने की गाइड इस्तेमाल करें।
xcrun mcpbridge को सीधे पंजीकृत करें
जिस रिपॉज़िटरी में Claude Code चलाना है, वहाँ Bash से Apple की यही पंजीकरण कमांड चलाएँ:
claude mcp add --transport stdio xcode -- xcrun mcpbridge
claude mcp list
claude
यह मानक इनपुट और आउटपुट के ज़रिए स्थानीय प्रक्रिया से कनेक्शन पंजीकृत करती है। इस कमांड में चुना गया सर्वर नाम xcode है। इंटरैक्टिव सत्र में बिल्ड माँगने से पहले /mcp चलाकर कनेक्शन की स्थिति जाँचें।
डिफ़ॉल्ट रूप से MCP सेटिंग का दायरा वर्तमान प्रोजेक्ट तक सीमित रहता है। Claude Code यह सेटिंग प्रोजेक्ट से जोड़कर ~/.claude.json में रखता है, हर रिपॉज़िटरी पर अपने-आप लागू नहीं करता। MCP के दायरे का दस्तावेज़ यह अंतर समझाता है।
केवल पंजीकरण हो जाना सफलता की जाँच नहीं है। पक्का करें कि सर्वर जुड़ता है और Xcode में खुले प्रोजेक्ट पर काम कर सकता है।
ऐप में बदलाव माँगने से पहले एक बिल्ड जाँचें
पहले बिना फ़ाइलें बदले बिल्ड करने को कहें। इससे कनेक्शन की समस्या और मॉडल के बदलावों से आने वाली समस्या अलग रहेंगी।
जुड़े हुए Claude Code सत्र में नीचे दिया गया प्रॉम्प्ट भेजें। यह खुले प्रोजेक्ट और सक्रिय स्कीम की पहचान, उपलब्ध सिम्युलेटर पर बिल्ड और बिना फ़ाइलें बदले परिणाम माँगता है:
Use Xcode tools to identify the open project and active scheme.
Build that scheme for an available iOS Simulator destination.
Do not edit files.
Report the build result and the first actionable error, if any.
देखें कि एजेंट ने वास्तव में Xcode टूल बुलाया और उससे बिल्ड का परिणाम मिला। Xcode को भी बाहरी एजेंट की गतिविधि दिखानी चाहिए। ऐप का बिल्ड विफल होने पर भी मिली कंपाइलर त्रुटि यह पुष्टि कर सकती है कि कनेक्शन काम करता है। ऐसे में प्लगइन दोबारा स्थापित करने के बजाय प्रोजेक्ट की त्रुटि ठीक करें।
मार्केटप्लेस में स्कीम बिल्ड, रन और टेस्ट, SwiftUI प्रीव्यू, सिम्युलेटर और डिवाइस संचालन, बिल्ड लॉग, निदान और Apple दस्तावेज़ में खोज का उल्लेख है। कौन-सी क्रियाएँ उपलब्ध हैं, यह अपनी Xcode स्थापना और जुड़े टूल की सूची से जाँचें।
उदाहरण के लिए, Apple के Xcode 27 रिलीज़ नोट्स में सिम्युलेटर बूट करने, ऐप स्थापित करके चलाने, टच इनपुट और स्क्रीनशॉट का विवरण है। इंटरफ़ेस पर क्रिया करने वाला काम सौंपने से पहले देखें कि संबंधित टूल एजेंट को उपलब्ध हैं।
बिल्ड जाँचने के बाद एजेंट से उपलब्ध टेस्ट खोजने और एक संबंधित टेस्ट या टेस्ट समूह चलाने को कहें। व्यू में बदलाव के लिए किसी मौजूदा SwiftUI प्रीव्यू को रेंडर करवाएँ और मिले प्रीव्यू को जाँचें। खुद टेस्ट का परिणाम या प्रीव्यू देखें, केवल एजेंट के सफलता बताने पर न रुकें।
पहला काम सीमित रखें। बार-बार बिल्ड और बड़े निदान आउटपुट जोड़ने से पहले एक दोहराए जा सकने वाले काम की तुलना करें। इसके लिए MCP के कॉन्टेक्स्ट खर्च की जाँच वाला तरीका इस्तेमाल करें।
पूरी स्थापना बदलने के बजाय खराबी वाले हिस्से को ठीक करें
अपने परिणाम से मेल खाने वाली जाँच चुनें। ये अलग-अलग स्थितियों के विकल्प हैं, ऐसा क्रम नहीं जिसे हर किसी को पूरा चलाना हो।
xcrun को agent या mcpbridge नहीं मिलता
पहले xcode-select --print-path जाँचें। पुराना Xcode या अलग कमांड-लाइन टूल पैकेज चुना हो तो टर्मिनल खुले Xcode से अलग टूलचेन इस्तेमाल कर सकता है।
ज़रूरी ऐप /Applications/Xcode.app में स्थापित है तो Bash में उसे चुनें:
sudo xcode-select --switch /Applications/Xcode.app
ऐप कहीं और स्थापित है तो उसका वास्तविक पथ दें। यह कमांड डिफ़ॉल्ट डेवलपर डायरेक्टरी बदलती है। इसलिए चयन जाँचें और विफल हुई कमांड फिर चलाएँ।
agent plugin path अब भी उपलब्ध नहीं है, लेकिन सीधा MCP कनेक्शन काम करता है, तो उसी कनेक्शन का इस्तेमाल करें। दोनों न चलें तो पहले ज़रूरी टूल वाला Xcode स्थापित करें या चुनें। इससे पहले Claude Code के मॉडल क्रेडेंशियल बदलना शुरू न करें।
claude mcp list में केवल xcode नाम की प्रविष्टि नहीं है
सीधे कनेक्शन के लिए कमांड उसी रिपॉज़िटरी से चलाएँ जहाँ सर्वर जोड़ा था। प्रोजेक्ट तक सीमित पंजीकरण दूसरी रिपॉज़िटरी में अपने-आप नहीं दिखेगा।
प्लगइन वाले तरीके में पहले claude plugin list और फिर Claude Code के भीतर /mcp जाँचें। केवल xcode के बजाय प्लगइन के दायरे वाला सर्वर नाम खोजें। प्लगइन स्थापित है लेकिन चालू नहीं है तो /plugin से उसे चालू करें और नया सत्र शुरू करें।
इंस्टॉलर को मार्केटप्लेस प्रविष्टि नहीं मिलती तो Claude Code के प्रॉम्प्ट से कैटलॉग अपडेट करें:
/plugin marketplace update claude-plugins-official
अपडेट के बाद स्थापना दोहराएँ। मार्केटप्लेस ही नहीं जुड़ा है तो पहले /plugin marketplace add anthropics/claude-plugins-official चलाएँ। Anthropic की प्लगइन समस्या-समाधान गाइड कैटलॉग की इन त्रुटियों और असमर्थित स्रोत प्रकारों में अंतर बताती है।
सर्वर जुड़ता है, लेकिन प्रोजेक्ट उपलब्ध नहीं है
ज़रूरी प्रोजेक्ट Xcode में खोलें और Allow External Agents to Use Xcode Tools फिर जाँचें। Xcode खुला रखें, एजेंट का नया सत्र शुरू करें और बिना फ़ाइलें बदले बिल्ड वाला प्रॉम्प्ट दोहराएँ।
सर्वर की प्रविष्टि सिर्फ़ यह बताती है कि सेटिंग मौजूद है। लौटे हुए प्रोजेक्ट विवरण और बिल्ड परिणाम से पता चलता है कि एजेंट सही प्रोजेक्ट तक पहुँचा। टूल प्रोजेक्ट से जुड़ी त्रुटि दे तो अगला कदम उसी निदान के अनुसार लें।
उसी Xcode प्रोजेक्ट से Codex जोड़ें
Codex के लिए Claude Code मार्केटप्लेस प्लगइन स्थापित किए बिना Apple का सीधा MCP तरीका इस्तेमाल कर सकते हैं। Xcode में वही अनुमति बनाए रखें और प्रोजेक्ट खुला छोड़ें।
Codex CLI स्थापित करने और प्रमाणीकरण पूरा करने के बाद Bash में ये कमांड चलाएँ:
codex mcp add xcode -- xcrun mcpbridge
codex mcp list
codex
Codex के भीतर सक्रिय सर्वर देखने के लिए /mcp इस्तेमाल करें, जैसा OpenAI के MCP दस्तावेज़ में बताया गया है। फिर बिना फ़ाइलें बदले बिल्ड वाला वही प्रॉम्प्ट भेजें और लौटे हुए परिणाम को जाँचें।
बाद में बाहरी एजेंट की पहुँच बंद करनी हो तो Xcode की Intelligence सेटिंग में लौटें। Allow External Agents to Use Xcode Tools में Never चुनें।