त्वरित आरंभ: Claude Code या Codex को दूरस्थ रूप से चलाएँ

अपडेट किया गया

यह मार्गदर्शिका एक विकास मशीन को PandaNpc से जोड़ती है और सत्यापित करती है कि आप दूसरे डिवाइस से Claude Code, Codex, या PandaCode चला सकते हैं। एजेंट अभी भी आपकी विकास मशीन पर निष्पादित होता है; PandaNpc आपको संदेशों, अनुमोदनों, प्रश्नों और सत्र इतिहास के लिए एक समकालिक दूरस्थ इंटरफ़ेस प्रदान करता है।

अधिकांश लोगों को डिवाइस जोड़ें प्रवाह का उपयोग करना चाहिए क्योंकि यह आपके खाते से पहले से जुड़ा एक एक-बार का इंस्टॉल कमांड उत्पन्न करता है। लगभग पाँच मिनट दें, साथ ही आपके कोडिंग इंजन के लिए आवश्यक कोई भी मॉडल-प्रदाता साइन-इन।

शुरू करने से पहले

आपको आवश्यकता होगी:

  • वेब ऐप, डेस्कटॉप ऐप, या iOS ऐप में खोला गया PandaNpc खाता।
  • Windows x64, macOS, या Linux x86_64 चलाने वाला एक होस्ट।
  • होस्ट से इंटरनेट एक्सेस और उपयोगकर्ता-स्तरीय पृष्ठभूमि सेवा स्थापित करने की अनुमति।
  • एक प्रोजेक्ट फ़ोल्डर जिसे आप संशोधित कर सकते हैं।
  • एक Claude, ChatGPT/Codex, या कस्टम-मॉडल खाता यदि आपका चुना हुआ इंजन पहले से प्रमाणित नहीं है।

यदि आपको केवल PandaNpc की अंतर्निहित चैट की आवश्यकता है और आप किसी अन्य मशीन पर एजेंट को नियंत्रित नहीं करना चाहते हैं, तो PandaPaw की आवश्यकता नहीं है। केवल-क्लाइंट विकल्पों के लिए स्थापना देखें।

1. होस्ट इंस्टॉल कमांड बनाएं

साइन इन करते समय, कनेक्टेड डिवाइस खोलें और डिवाइस जोड़ें चुनें। PandaNpc एक-बार की डिवाइस कुंजी बनाता है और आपके ऑपरेटिंग सिस्टम के लिए सटीक कमांड दिखाता है।

उस कमांड को उस मशीन पर कॉपी करें जहाँ कोडिंग एजेंट चलना चाहिए। इसे उपयोग होने तक पासवर्ड की तरह समझें: एक-बार की कुंजी एक मशीन को जोड़ती है और इसे चैट, स्क्रीनशॉट, मुद्दों, या शेल-इतिहास निर्यात में पोस्ट नहीं किया जाना चाहिए।

यदि आप तैयार कुंजी के बजाय ब्राउज़र प्राधिकरण पसंद करते हैं, तो अगले चरण में सादा इंस्टॉलर का उपयोग करें। यह pandapaw login चलाता है और आपके लिए प्राधिकरण पृष्ठ खोलता है।

2. होस्ट पर PandaPaw स्थापित करें

macOS या Linux

कनेक्टेड डिवाइस से तैयार कमांड चलाएं, या सादा इंस्टॉलर का उपयोग करें:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows PowerShell

कनेक्टेड डिवाइस से तैयार कमांड चलाएं, या उपयोग करें:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

इंस्टॉलर PandaPaw और उसकी पृष्ठभूमि सेवाओं को जोड़ता है, जब संभव हो तो गायब समर्थित कोडिंग इंजन स्थापित करता है, और जब होस्ट के पास उपयुक्त नहीं होता है तो एक निजी Node.js रनटाइम प्रदान करता है। तैयार डिवाइस कुंजी के साथ, खाता युग्मन स्थापना के दौरान होता है। सादा कमांड के साथ, संकेत मिलने पर ब्राउज़र प्राधिकरण अनुरोध को स्वीकृत करें।

इंस्टॉलर तब भी समाप्त हो सकता है जब खाता प्राधिकरण स्थगित हो। यदि यह कहता है कि स्थापना सफल रही लेकिन खाता कनेक्शन अधूरा है, तो चलाएं:

bash
pandapaw login

3. होस्ट सेवाओं की पुष्टि करें

होस्ट पर, चलाएं:

bash
pandapaw status

कमांड को स्थापित सेवाओं को पहचानना चाहिए और खाते से जुड़ी मशीन दिखानी चाहिए। यदि शेल pandapaw नहीं ढूंढ पाता है, तो पहले एक नया टर्मिनल खोलें ताकि वह अपडेटेड उपयोगकर्ता PATH को पुनः लोड कर सके।

Git प्रोजेक्ट के लिए, आप यह भी जांच सकते हैं कि Agent Center प्रोजेक्ट रूट को पहचानता है या नहीं:

bash
pandapaw agent status --root /path/to/your/project

एक वास्तविक निरपेक्ष प्रोजेक्ट पथ का उपयोग करें। Agent Center प्रोजेक्ट बाइंडिंग सबसे अच्छा तब काम करती है जब निर्देशिका में एक स्थिर Git remote.origin.url हो।

4. पहला दूरस्थ सत्र शुरू करें

  1. PandaNpc Agent को अपने फ़ोन, ब्राउज़र, या किसी अन्य डेस्कटॉप पर खोलें।
  2. नई कनेक्टेड मशीन खोजें। एक हरा स्थिति संकेतक का अर्थ है कि होस्ट वर्तमान में पहुंच योग्य है।
  3. Claude Code, Codex, या PandaCode चुनें और प्रोजेक्ट कार्यशील निर्देशिका चुनें।
  4. एक सत्र शुरू करें। यदि इंजन आपको साइन इन करने के लिए कहता है, तो होस्ट पर या प्रदर्शित लॉगिन प्रवाह के माध्यम से उस प्रदाता का प्राधिकरण पूरा करें।
  5. एक गैर-विनाशकारी परीक्षण संकेत भेजें जैसे: Show the current working directory and list the top-level files. Do not edit anything.

आप पूरी तरह से कनेक्टेड हैं जब उत्तर अपेक्षित प्रोजेक्ट निर्देशिका का नाम देता है, फ़ाइल सूची होस्ट से मेल खाती है, और कोई भी अनुमति प्रश्न आपके अनुमोदन या अस्वीकृति के लिए दूरस्थ क्लाइंट पर दिखाई देता है।

5. पुनः कनेक्शन व्यवहार की पुष्टि करें

देखने वाले क्लाइंट को बंद करें, कुछ सेकंड प्रतीक्षा करें, और उसी सत्र को फिर से खोलें। मौजूदा इतिहास वापस आना चाहिए और होस्ट ऑनलाइन रहना चाहिए। यह केवल यह साबित करने के बजाय कि इंस्टॉलर सफलतापूर्वक डाउनलोड हुआ, वास्तविक दूरस्थ पथ की जाँच करता है।

इस परीक्षण के दौरान होस्ट को स्लीप में न डालें। स्लीप या बंद होस्ट एजेंट नहीं चला सकता, भले ही सहेजा गया कनेक्शन आपके खाते में दिखाई दे।

समस्या निवारण

मशीन Agent में दिखाई नहीं देती

होस्ट पर pandapaw status चलाएँ। यदि स्थापना सफल रही लेकिन कोई खाता संलग्न नहीं है, तो pandapaw login चलाएँ। यदि आपने तैयार कुंजी का उपयोग किया और वह पहले ही भुना या समाप्त हो चुकी थी, तो कनेक्टेड डिवाइस में एक नई कुंजी बनाएं और प्रदर्शित कमांड फिर से चलाएँ।

`pandapaw` पहचाना नहीं गया

एक नया टर्मिनल खोलें। macOS/Linux पर, पुष्टि करें कि ~/.local/bin PATH में है। Windows पर, इंस्टॉलर उपयोगकर्ता PATH में %LOCALAPPDATA%\Programs\pandapaw जोड़ता है; स्थापना से पहले खोला गया टर्मिनल नया मान नहीं देखेगा।

मशीन सूचीबद्ध है लेकिन ऑफ़लाइन है

पुष्टि करें कि होस्ट चालू है, जागृत है, और इंटरनेट तक पहुंचने में सक्षम है। फिर pandapaw status जाँचें। कॉर्पोरेट फ़ायरवॉल को आउटबाउंड HTTPS/WebSocket ट्रैफ़िक की अनुमति देनी चाहिए; आपको इनबाउंड पोर्ट-फ़ॉरवर्डिंग नियम नहीं बनाना चाहिए।

कनेक्शन काम करता है लेकिन इंजन प्रमाणीकरण मांगता है

PandaPaw युग्मन और मॉडल-प्रदाता लॉगिन अलग हैं। युग्मन साबित करता है कि होस्ट आपके PandaNpc खाते से संबंधित है; Claude Code या Codex को अभी भी अपने स्वयं के सब्सक्रिप्शन लॉगिन या API कॉन्फ़िगरेशन की आवश्यकता हो सकती है। इंजन का सामान्य साइन-इन पूरा करें, फिर सत्र पुनः प्रयास करें।

एजेंट गलत फ़ोल्डर में खुलता है

उस परीक्षण सत्र को समाप्त करें और इच्छित कार्यशील निर्देशिका के साथ एक सत्र बनाएं। टूल उपयोग स्वीकृत करने से पहले, एजेंट से वर्तमान निर्देशिका मुद्रित करने के लिए कहें। एक दूरस्थ कनेक्शन अपने आप में फ़ाइलसिस्टम सैंडबॉक्स नहीं जोड़ता; इंजन की टूल अनुमतियाँ और चयनित कार्यशील निर्देशिका महत्वपूर्ण रहती हैं।

अगले कदम

  • अपडेट, सेवा जाँच और कनेक्शन आर्किटेक्चर के लिए पूर्ण PandaPaw होस्ट गाइड पढ़ें।
  • यह समझने के लिए खाता और बिलिंग की समीक्षा करें कि प्रत्येक सत्र के लिए कौन सा सब्सक्रिप्शन या प्रदाता भुगतान करता है।
  • जब आप एक OpenAI-संगत एंडपॉइंट, एक सेल्फ-होस्टेड मॉडल, या एक अलग API कुंजी चाहते हैं तो कस्टम AI प्रदाता जोड़ें।