PandaPaw: Claude Code, Codex और PandaCode के लिए रिमोट होस्ट

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

PandaPaw आपके नियंत्रण वाली Windows, macOS या Linux मशीन को PandaNpc एजेंट होस्ट में बदल देता है। कोडिंग इंजन, प्रोजेक्ट फ़ाइलें, शेल और टूल उसी होस्ट पर रहते हैं; PandaNpc क्लाइंट आपको फ़ोन, ब्राउज़र या किसी अन्य डेस्कटॉप से एक सिंक्रनाइज़ इंटरफ़ेस देते हैं।

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

PandaPaw क्या प्रबंधित करता है

  • रिमोट एजेंट कनेक्शन Claude Code, OpenAI Codex और PandaCode के लिए।
  • पृष्ठभूमि सेवाएँ और ऑटोस्टार्ट ताकि सामान्य रीबूट के बाद होस्ट वापस आ सके।
  • खाता-आधारित मशीन प्राधिकरण बिना किसी लंबे समय तक चलने वाले ब्रिज आईडी, टोकन या साइनिंग कुंजी को मैन्युअल रूप से कॉपी किए।
  • इंजन इंस्टॉलेशन सहायता जब कोई समर्थित कोडिंग इंजन गायब हो।
  • एजेंट केंद्र प्रोजेक्शन जो प्रत्येक इंजन के मार्गदर्शन, कौशल, मेमोरी और एजेंट परिभाषाओं को उसके मूल लेआउट में प्रस्तुत करते हैं।
  • निजी डिवाइस नेटवर्किंग कनेक्टेड डिवाइस प्रवाह के माध्यम से जुड़ी मशीनों के लिए।
  • अपडेट और अनइंस्टॉल लेखा-जोखा ताकि PandaPaw से पहले मौजूद टूल संरक्षित रहें।

PandaPaw स्वयं कोई मॉडल सदस्यता प्रदान नहीं करता। Claude Code, Codex और PandaCode अभी भी अपने इंजन के लिए कॉन्फ़िगर किए गए प्रदाता क्रेडेंशियल और सीमाओं का उपयोग करते हैं।

रिमोट निष्पादन कैसे काम करता है

flowchart LR Client["PandaNpc client\nweb · iOS · desktop · Chrome"] -->|outbound authenticated session| Relay["PandaNpc relay"] Host["PandaPaw host"] -->|outbound authenticated session| Relay Host --> Claude["Claude Code"] Host --> Codex["Codex"] Host --> PandaCode["PandaCode"] Claude --> Project["Local project and tools"] Codex --> Project PandaCode --> Project

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

यदि होस्ट सो जाता है, बंद हो जाता है, या अपना आउटबाउंड नेटवर्क पथ खो देता है, तो सहेजा गया कनेक्शन आपके खाते में बना रहता है, लेकिन होस्ट के लौटने तक कार्य निष्पादित नहीं कर सकता।

समर्थित होस्ट प्लेटफ़ॉर्म

होस्ट प्लेटफ़ॉर्म पैकेज टिप्पणियाँ
Windows x64 मूल निष्पादन योग्य और उपयोगकर्ता-स्तरीय सेवाएँ इंस्टॉलर को PowerShell में चलाएँ
macOS, Apple Silicon या Intel यूनिवर्सल PandaPaw एप्लिकेशन/बाइनरी वही पैकेज दोनों आर्किटेक्चर का समर्थन करता है
Linux x86_64 मूल बाइनरी और उपयोगकर्ता सेवा सामान्य glibc-आधारित वितरणों के लिए अभिप्रेत

PandaNpc व्यूइंग क्लाइंट में एक व्यापक प्लेटफ़ॉर्म मैट्रिक्स है। क्लाइंट और होस्ट पैकेज चुनते समय PandaNpc और PandaPaw इंस्टॉल करें देखें।

अनुशंसित इंस्टॉलेशन

  1. PandaNpc में साइन इन करें।
  2. कनेक्टेड डिवाइस खोलें।
  3. डिवाइस जोड़ें चुनें। एक बार उपयोग होने वाली कुंजी जारी की जाती है और डायलॉग में पहचाने गए ऑपरेटिंग सिस्टम के लिए एक कमांड दिखाई देती है।
  4. उस कमांड को होस्ट पर कॉपी करें और वहाँ चलाएँ।
  5. यदि आप चाहते हैं कि यह नई मशीन को स्वचालित रूप से पहचाने तो डायलॉग को खुला छोड़ दें।

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

सादा 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 login चलाता है। यह जो ब्राउज़र पेज खोलता है उसमें मशीन को अनुमोदित करें। यदि प्राधिकरण बाधित होता है, तो बाइनरी और सेवाएँ अभी भी इंस्टॉल की जा सकती हैं; खाता कनेक्शन पूरा करने के लिए बाद में pandapaw login चलाएँ।

होस्ट सत्यापित करें

पहले होस्ट की जाँच करें:

bash
pandapaw status

फिर PandaNpc एजेंट खोलें और पुष्टि करें कि मशीन में हरे रंग का ऑनलाइन संकेतक है। एक अस्थायी या केवल-पठनीय परीक्षण निर्देशिका में सत्र शुरू करें और पूछें:

परीक्षण संकेत: वर्तमान कार्यशील निर्देशिका प्रिंट करें और शीर्ष-स्तरीय फ़ाइलों की सूची बनाएं। कुछ भी संशोधित न करें।

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

एजेंट केंद्र प्रोजेक्ट के लिए, चलाएँ:

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

यह दिखाता है कि प्रोजेक्ट बाउंड है या नहीं और क्या प्रबंधित कॉन्फ़िगरेशन स्थानीय रूप से उपलब्ध है। एक स्थिर Git रिमोट PandaPaw को विभिन्न मशीनों पर एक ही प्रोजेक्ट की पहचान करने में मदद करता है।

खाता प्राधिकरण और कनेक्शन पहचान

pandapaw login ब्राउज़र डिवाइस-प्राधिकरण सत्र का उपयोग करता है। इसे अनुमोदित करने के बाद, होस्ट TLS पर डिवाइस-स्कोप वाले क्रेडेंशियल और एक एजेंट केंद्र सत्यापन कुंजी प्राप्त करता है, अपनी मशीन कॉन्फ़िगरेशन ~/.pandapaw/ के अंतर्गत लिखता है, समर्थित इंजन कनेक्शन पंजीकृत करता है, और पहचाने जाने योग्य Git प्रोजेक्ट्स को बाइंड करता है।

pandapaw login --force केवल तभी चलाएँ जब जानबूझकर खाता बदल रहे हों या समाप्त हो चुके होस्ट क्रेडेंशियल को बदल रहे हों। बिना किसी कारण के स्वस्थ मशीन को फिर से अधिकृत करना भ्रामक डुप्लिकेट या प्रतिस्थापित पहचान बना सकता है।

pandapaw qr अभी भी संगतता और विशेष मामलों के लिए एक अल्पकालिक मैनुअल कनेक्शन लिंक बनाता है। यह नए होस्ट के लिए प्राथमिक प्रवाह नहीं है; कनेक्टेड डिवाइस ऑडिट करना आसान है और उपयोगकर्ताओं को ब्रिज आईडी समझने की आवश्यकता नहीं होती।

एजेंट केंद्र सिंक्रनाइज़ेशन

एजेंट केंद्र स्थिर अवस्था में इवेंट-संचालित होता है:

  1. स्थानीय प्रबंधित-फ़ाइल परिवर्तनों का पता लगाया जाता है और बाउंड प्रोजेक्ट में प्रकाशित किया जाता है।
  2. हस्ताक्षरित रिलीज़ एक इवेंट स्ट्रीम के माध्यम से आती हैं।
  3. अपरिवर्तित मेनिफेस्ट और कंटेंट ब्लॉब्स को फिर से डाउनलोड करने के बजाय पुन: उपयोग किया जाता है।
  4. एक आवधिक पुनर्प्राप्ति जाँच अस्थायी डिस्कनेक्ट के दौरान छूटी घटनाओं को पकड़ लेती है।

Claude Code, Codex और PandaCode अलग-अलग प्रोजेक्शन प्राप्त करते हैं क्योंकि वे अलग-अलग निर्देशिकाओं और निर्देश प्रारूपों की अपेक्षा करते हैं। PandaCode नया सत्र संकेत तैयार करने से पहले नवीनतम सत्यापित रिलीज़ तैयार करता है, इसलिए स्टार्टअप पर खींचा गया कॉन्फ़िगरेशन उसी सत्र को प्रभावित कर सकता है।

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

उपयोगी कमांड

bash
pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall
कमांड इसके लिए उपयोग करें
pandapaw login एक इंस्टॉल की गई मशीन को अधिकृत करें जो अभी तक किसी खाते से कनेक्ट नहीं है
pandapaw status स्थापित सेवाओं, मशीन कनेक्शन और बुनियादी स्वास्थ्य की जाँच करें
pandapaw agent status --root … एक प्रोजेक्ट के लिए एजेंट केंद्र स्थिति का निरीक्षण करें
pandapaw update --restart नवीनतम PandaPaw रिलीज़ को सत्यापित, इंस्टॉल और सक्रिय करें
pandapaw uninstall PandaPaw-प्रबंधित सेवाओं और फ़ाइलों को सावधानीपूर्वक हटाएँ

जब कोई कमांड या UI किसी पुराने स्क्रीनशॉट या ट्यूटोरियल से भिन्न हो तो PandaPaw संस्करण इतिहास देखें।

सुरक्षा सीमाएँ

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

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

इंस्टॉलेशन के बाद `pandapaw` नहीं मिलता

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

इंस्टॉलेशन सफल रहा, लेकिन कोई मशीन दिखाई नहीं देती

pandapaw status चलाएँ। यदि मशीन में खाता प्राधिकरण नहीं है, तो pandapaw login चलाएँ। यदि तैयार एक-बार कुंजी का उपयोग किया गया था, तो उपभोग किए गए कमांड को दोबारा आज़माने के बजाय एक नई कुंजी बनाएं।

मशीन दिखाई देती है लेकिन ऑफ़लाइन रहती है

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

होस्ट ऑनलाइन है, लेकिन Claude Code या Codex उत्तर नहीं देगा

होस्ट को पेयर करना हर मॉडल प्रदाता को प्रमाणित नहीं करता। इंजन को स्थानीय रूप से खोलें या रिमोट सत्र में दिखाए गए लॉगिन संकेत का पालन करें। यह भी पुष्टि करें कि चयनित मॉडल उस खाते के लिए मौजूद है और उसकी उपयोग सीमा समाप्त नहीं हुई है।

सत्र गलत प्रोजेक्ट में खुलता है

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

एजेंट केंद्र परिवर्तन दिखाई नहीं देते

सही Git रूट से pandapaw agent status --root /path/to/project चलाएँ। पुष्टि करें कि प्रोजेक्ट बाउंड है, होस्ट लॉग इन है, और स्थानीय फ़ाइल प्रबंधित प्रोजेक्शन का हिस्सा है। जाँच करते समय प्रबंधित निर्देशिकाओं को हटाने के बजाय अंतिम सत्यापित रिलीज़ को यथावत रखें।

अपडेट और अनइंस्टॉल

pandapaw update --restart वर्तमान बाइनरी डाउनलोड करता है, उसकी SHA-256 चेकसम सत्यापित करता है, इंस्टॉल की गई प्रति को प्रतिस्थापित करता है, और प्रबंधित सेवाओं को पुनरारंभ करता है ताकि संस्करण सक्रिय हो जाए। मौजूदा खाता पेयरिंग संरक्षित रहती है।

pandapaw uninstall PandaPaw द्वारा बनाई गई वस्तुओं को हटाने के लिए इंस्टॉल मेनिफेस्ट का उपयोग करता है। पहले से मौजूद संगत Claude Code, Codex, PandaCode या Node इंस्टॉलेशन को जानबूझकर संरक्षित किया जाता है। अनइंस्टॉल करने के बाद, यदि होस्ट अब भरोसेमंद नहीं होना चाहिए तो उसे कनेक्टेड डिवाइस से हटा दें।