PandaPaw: Távoli gazdagép a Claude Code, Codex és PandaCode számára

A PandaPaw az Ön által vezérelt Windows, macOS vagy Linux gépet PandaNpc-ügynök-gazdagéppé alakítja. A kódolási motor, a projektfájlok, a shell és az eszközök azon a gazdagépen maradnak; a PandaNpc kliensek szinkronizált felületet biztosítanak telefonról, böngészőből vagy egy másik asztali gépről.

Használja a PandaPaw-t, ha a munkát végző gép különbözik az Ön kezében lévő eszköztől, ha olyan gazdagépet szeretne, amely túléli a klienskapcsolatok megszakadását, vagy ha több kódolási motornak ugyanazt a fiókalapú beállítást és Agent Center-konfigurációt kell megosztania.

Mit kezel a PandaPaw

• Távoli ügynökkapcsolatok a Claude Code, az OpenAI Codex és a PandaCode számára.
• Háttérszolgáltatások és automatikus indítás, hogy a gazdagép egy normál újraindítás után visszatérhessen.
• Fiókalapú géphitelesítés anélkül, hogy manuálisan kellene másolni egy hosszú élettartamú Bridge ID-t, tokent vagy aláíró kulcsot.
• Motor-telepítési segítség, ha egy támogatott kódolási motor hiányzik.
• Agent Center-vetítések, amelyek az egyes motorok útmutatásait, készségeit, memóriáját és ügynökdefinícióit natív elrendezésben jelenítik meg.
• Privát eszközhálózat a Connected Devices folyamaton keresztül csatlakoztatott gépek számára.
• Frissítési és eltávolítási nyilvántartás, hogy a PandaPaw előtt létező eszközök megmaradjanak.

A PandaPaw önmagában nem biztosít modell-előfizetést. A Claude Code, a Codex és a PandaCode továbbra is a motorjukhoz beállított szolgáltatói hitelesítő adatokat és korlátokat használja.

Hogyan működik a távoli végrehajtás

Mindkét oldal kimenő kapcsolatokat indít, így egy normál otthoni vagy irodai beállításhoz nincs szükség bejövő tűzfalszabályra, nyilvános IP-címre, router-porttovábbításra vagy nyilvánosan elérhető SSH-kiszolgálóra. A relé üzeneteket, állapotot és jóváhagyásokat továbbít; az eszközvégrehajtás a gazdagépen történik.

Ha a gazdagép alvó állapotba kerül, kikapcsol, vagy elveszíti a kimenő hálózati útvonalát, a mentett kapcsolat megmarad a fiókjában, de nem tud munkát végrehajtani, amíg a gazdagép vissza nem tér.

Támogatott gazdagép-platformok

A PandaNpc megtekintő kliens szélesebb platformmátrixszal rendelkezik. A kliens- és gazdagépcsomagok kiválasztásakor tekintse meg a PandaNpc és PandaPaw telepítése oldalt.

Ajánlott telepítés

1. Jelentkezzen be a PandaNpc-be.
2. Nyissa meg a Connected Devices oldalt.
3. Válassza az Eszköz hozzáadása lehetőséget. A rendszer egyszeri kulcsot bocsát ki, és a párbeszédablak egy parancsot mutat az észlelt operációs rendszerhez.
4. Másolja a parancsot a gazdagépre, és futtassa ott.
5. Ha azt szeretné, hogy automatikusan észlelje az új gépet, hagyja nyitva a párbeszédablakot.

Az előkészített kulcs egyszer használatos. Másolja a teljes parancsot, tartsa meg magán, és generáljon újat, ha lejárt, vagy ha már felhasználták.

Egyszerű macOS/Linux telepítő

Használja ezt a formát, ha böngészős hitelesítést szeretne egy előkészített kulcs helyett:

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

Egyszerű Windows PowerShell telepítő

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

Az egyszerű telepítő futtatja a pandapaw login parancsot. Hagyja jóvá a gépet a megnyíló böngészőoldalon. Ha a hitelesítés megszakad, a bináris és a szolgáltatások továbbra is telepíthetők; a fiókkapcsolat befejezéséhez később futtassa a pandapaw login parancsot.

A gazdagép ellenőrzése

Először ellenőrizze magát a gazdagépet:

pandapaw status

Ezután nyissa meg a PandaNpc Agent oldalt, és erősítse meg, hogy a gép zöld online jelzővel rendelkezik. Indítson egy munkamenetet egy eldobható vagy csak olvasható tesztkönyvtárban, és kérdezze meg:

Teszt prompt: Írja ki az aktuális munkakönyvtárat, és sorolja fel a legfelső szintű fájlokat. Ne módosítson semmit.

A sikeres válasz többet bizonyít egy zöld állapotjelzőnél: ellenőrzi a fiók párosítását, a relé kapcsolatát, a kiválasztott motort, a szolgáltató hitelesítését és a munkakönyvtár-hozzárendelést.

Egy Agent Center-projekt esetén futtassa:

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

Ez megmutatja, hogy a projekt kötve van-e, és hogy a felügyelt konfiguráció helyben elérhető-e. A stabil Git remote segít a PandaPaw-nak, hogy ugyanazt a projektet azonosítsa a különböző gépeken.

Fiók-hitelesítés és kapcsolati azonosság

A pandapaw login böngészős eszközhitelesítési munkamenetet használ. A jóváhagyás után a gazdagép TLS-en keresztül eszközszintű hitelesítő adatokat és egy Agent Center-ellenőrzőkulcsot kap, a gépkonfigurációt a ~/.pandapaw/ alá írja, regisztrálja a támogatott motorcsatlakozásokat, és köti a felismerhető Git-projekteket.

A pandapaw login --force parancsot csak akkor futtassa, ha szándékosan vált fiókot, vagy lejárt gazdagép-hitelesítő adatot cserél. Egy egészséges gép ok nélküli újrahitelesítése zavaró, duplikált vagy lecserélt identitásokat hozhat létre.

A pandapaw qr továbbra is rövid élettartamú manuális kapcsolati hivatkozást hoz létre a kompatibilitás és a speciális esetek érdekében. Nem ez az elsődleges folyamat egy új gazdagép esetén; a Connected Devices könnyebben ellenőrizhető, és nem igényli, hogy a felhasználók megértsék a Bridge ID-ket.

Agent Center-szinkronizáció

Az Agent Center stabil állapotban eseményvezérelt:

1. A helyi felügyelt fájlok változásait a rendszer észleli, és közzéteszi a kötött projektben.
2. Az aláírt kiadások egy eseményfolyamon keresztül érkeznek.
3. A változatlan jegyzékeket és tartalomblobokat a rendszer újra felhasználja ahelyett, hogy újra letöltené őket.
4. Egy időszakos helyreállítási ellenőrzés elkapja az ideiglenes kapcsolat megszakadása során kimaradt eseményeket.

A Claude Code, a Codex és a PandaCode külön vetítéseket kap, mert eltérő könyvtárszerkezetet és utasításformátumot várnak. A PandaCode az új munkamenet-prompt összeállítása előtt előkészíti a legújabb ellenőrzött kiadást, így az indításkor lekérdezett konfiguráció hatással lehet ugyanarra a munkamenetre.

Ha az Agent Center átmenetileg nem elérhető, a motor a legutóbbi ellenőrzött helyi kiadással folytatja. A hálózati hiba nem cserélheti le csendben az aláírt konfigurációt nem ellenőrzött tartalomra.

Hasznos parancsok

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Ha egy parancs vagy felhasználói felület eltér egy régebbi képernyőképtől vagy oktatóanyagtól, tekintse meg a PandaPaw verziótörténetét.

Biztonsági határok

• A távoli kezelő minden olyan eszközt és munkakönyvtárat használhat, amelyet a kiválasztott ügynökmunkamenet engedélyez. A távoli hozzáférés nem automatikusan csak olvasható.
• Tartsa távol a naplókból és képernyőképekből az egyszeri eszközparancsokat, a manuális kapcsolati hivatkozásokat, a szolgáltatói kulcsokat és a fióktokeneket.
• Ne nyisson meg bejövő router-portokat csak azért, hogy a PandaPaw elérhető legyen.
• Távolítsa el a Connected Devices szolgáltatásból azokat a gazdagépeket, amelyek már nem az Ön tulajdonában vannak.
• Tekintse át az eszközjóváhagyásokat, és ellenőrizze a munkakönyvtárat, mielőtt engedélyezné a szerkesztéseket vagy shell-parancsokat.
• Ha élő kapcsolatot oszt meg, a címzett a gazdagép tulajdonosának motorkvótáját használja, és eljárhat a gazdagépen. Először olvassa el a Kapcsolatmegosztás című részt.

Hibaelhárítás

A `pandapaw` nem található a telepítés után

Nyisson egy új terminált, hogy az újratöltse a felhasználói PATH-ot. A szokásos helyek: ~/.local/bin macOS/Linux rendszeren és %LOCALAPPDATA%\Programs\pandapaw Windows rendszeren. A telepítő újrafuttatása előtt győződjön meg arról, hogy a fájl létezik.

A telepítés sikeres volt, de nem jelenik meg gép

Futtassa a pandapaw status parancsot. Ha a gép nem rendelkezik fiók-hitelesítéssel, futtassa a pandapaw login parancsot. Ha előkészített egyszeri kulcsot használt, hozzon létre új kulcsot ahelyett, hogy egy már felhasznált parancsot próbálna újra.

A gép megjelenik, de offline marad

Győződjön meg arról, hogy a gazdagép ébren van és internet-hozzáféréssel rendelkezik. Ellenőrizze a PandaPaw állapotát helyben. A vállalati proxy vagy tűzfal engedélyezze a kimenő HTTPS/WebSocket útvonalat; a bejövő port nem oldja meg a blokkolt kimenő kapcsolatot.

A gazdagép online, de a Claude Code vagy a Codex nem válaszol

A gazdagép párosítása nem hitelesíti az összes modellszolgáltatót. Nyissa meg a motort helyben, vagy kövesse a távoli munkamenetben megjelenő bejelentkezési felszólítást. Győződjön meg arról is, hogy a kiválasztott modell létezik az adott fiókhoz, és hogy a használati korlátja nem merült ki.

A munkamenet a rossz projektben nyílik meg

Fejezze be a tesztet, válassza ki a kívánt abszolút munkakönyvtárat, és kérje meg az ügynököt, hogy írja ki azt az eszközök jóváhagyása előtt. A PandaPaw nem találgatja, hogy melyik repozitóriumra gondolt, és nem ad hozzá fájlrendszer-sandboxot a motor saját engedélymodelljén túl.

Az Agent Center módosításai nem jelennek meg

Futtassa a pandapaw agent status --root /path/to/project parancsot a megfelelő Git gyökérből. Győződjön meg arról, hogy a projekt kötve van, a gazdagép be van jelentkezve, és a helyi fájl egy felügyelt vetítés része. A vizsgálat során tartsa meg a legutóbbi ellenőrzött kiadást ahelyett, hogy törölné a felügyelt könyvtárakat.

Frissítés és eltávolítás

A pandapaw update --restart letölti az aktuális binárist, ellenőrzi a SHA-256 ellenőrzőösszegét, lecseréli a telepített példányt, és újraindítja a felügyelt szolgáltatásokat, hogy a verzió aktívvá váljon. A meglévő fiókpárosítás megmarad.

A pandapaw uninstall a telepítési jegyzék segítségével távolítja el a PandaPaw által létrehozott elemeket. A már meglévő, kompatibilis Claude Code, Codex, PandaCode vagy Node telepítések szándékosan megmaradnak. Az eltávolítás után távolítsa el a gazdagépet a Connected Devices szolgáltatásból, ha már nem kell megbíznia benne.