Ez az útmutató egy számítógépet csatlakoztat a PandaNpc Work-höz, és ellenőrzi, hogy futtathatod-e a Claude Code-ot, a Codex-et vagy a PandaCode-ot egy másik eszközről. A PandaNpc Work a többmotoros AI munkaterület, ahol delegálhatod a munkát, és nyomon követheted azt az eszközök között. Az ügynök továbbra is a csatlakoztatott számítógépen fut; a PandaPaw biztosítja a hidat és a helyi futtatókörnyezetet, míg a PandaNpc Work szinkronizált felületet nyújt az üzenetekhez, jóváhagyásokhoz, kérdésekhez és a munkamenet-előzményekhez.
Ez az útvonal azoknak a legjobb, akik már otthonosan mozognak a Claude Code, a Codex vagy egy hasonló kódolási ügynök használatában. A legtöbb embernek az Eszköz hozzáadása folyamatot érdemes használnia, mert az egy egyszeri telepítési parancsot generál, amely már össze van kapcsolva a fiókjukkal. Szánj rá körülbelül öt percet, plusz a kódolási motorod által igényelt modellszolgáltatói bejelentkezést. Ha még a számítógép csatlakoztatása előtt szeretnéd felfedezni az Ügynök felületet, nyisd meg a PandaNpc Agent oldalt egy böngészőben.
Mielőtt elkezded
A következőkre lesz szükséged:
- Egy PandaNpc-fiók, amely meg van nyitva a webes alkalmazásban, az asztali alkalmazásban vagy az iOS-alkalmazásban.
- Egy csatlakoztatott számítógép, amely Windows x64-et, macOS-t vagy Linux x86_64-et futtat.
- Internet-hozzáférés a hosztról, valamint engedély egy felhasználói szintű háttérszolgáltatás telepítéséhez.
- Egy projektmappa, amelyet módosíthatsz.
- Egy Claude-, ChatGPT/Codex- vagy egyéni modellfiók, ha a választott motor még nincs hitelesítve.
Ha csak egy már csatlakoztatott hosztot szeretnél megtekinteni, telepíts vagy nyiss meg egy klienst a megtekintő eszközödön. A PandaPaw a számítógépre való, amely az ügynököt futtatja. A kliens és hoszt szerepekről lásd a Telepítés oldalt.
1. A hoszt telepítési parancsának létrehozása
Bejelentkezve nyisd meg a Csatlakoztatott eszközök oldalt, és válaszd az Eszköz hozzáadása lehetőséget. A PandaNpc létrehoz egy egyszeri eszközkulcsot, és megmutatja a pontos parancsot az operációs rendszeredhez.
Másold át ezt a parancsot arra a gépre, ahol a kódolási ügynöknek futnia kell. Kezeld úgy, mint egy jelszót, amíg fel nem használták: az egyszeri kulcs egy gépet párosít, és nem szabad közzétenni csevegésben, képernyőképeken, hibajegyekben vagy shell-előzmények exportjaiban.
Ha a böngészős engedélyezést részesíted előnyben az előkészített kulcs helyett, használd az egyszerű telepítőt a következő lépésben. Az futtatja a pandapaw login parancsot, és megnyitja neked az engedélyezési oldalt.
2. A PandaPaw telepítése a hosztra
macOS vagy Linux
Futtasd az előkészített parancsot a Csatlakoztatott eszközök oldalról, vagy használd az egyszerű telepítőt:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows PowerShell
Futtasd az előkészített parancsot a Csatlakoztatott eszközök oldalról, vagy használd:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexA telepítő hozzáadja a PandaPaw-t és háttérszolgáltatásait, telepíti a hiányzó támogatott kódolási motorokat, amikor lehetséges, és egy privát Node.js futtatókörnyezetet biztosít, ha a hoszt nem rendelkezik megfelelővel. Előkészített eszközkulcs esetén a fiókpárosítás a telepítés során történik. Az egyszerű parancs használatakor fogadd el a böngészős engedélyezési kérést, amikor a rendszer kéri.
A telepítő akkor is befejeződhet, ha a fiókengedélyezés elhalasztásra kerül. Ha azt írja, hogy a telepítés sikeres volt, de a fiókkapcsolat hiányos, futtasd:
pandapaw login3. A hoszt szolgáltatásainak ellenőrzése
A hoszton futtasd:
pandapaw statusA parancsnak fel kell ismernie a telepített szolgáltatásokat, és meg kell jelenítenie a fiókhoz kapcsolt gépet. Ha a shell nem találja a pandapaw parancsot, először nyiss egy új terminált, hogy újratöltse a frissített felhasználói PATH-ot.
Git-projekt esetén azt is ellenőrizheted, hogy az Ügynök Központ felismeri-e a projekt gyökerét:
pandapaw agent status --root /path/to/your/projectValós abszolút projektútvonalat használj. Az Ügynök Központ projekt-hozzárendelése akkor működik a legjobban, ha a könyvtárnak stabil Git remote.origin.url-je van.
4. Az első távoli munkamenet indítása
- Nyisd meg a PandaNpc Agent oldalt a telefonodon, böngészőben vagy egy másik asztali gépen.
- Keresd meg az újonnan csatlakoztatott gépet. A zöld állapotjelző azt jelenti, hogy a hoszt jelenleg elérhető.
- Válaszd a Claude Code-ot, a Codex-et vagy a PandaCode-ot, és jelöld ki a projekt munkakönyvtárát.
- Indíts egy munkamenetet. Ha a motor bejelentkezést kér, fejezd be a szolgáltató engedélyezését a hoszton vagy a megjelenített bejelentkezési folyamaton keresztül.
- Küldj egy nem destruktív tesztkérdést, például:
Show the current working directory and list the top-level files. Do not edit anything.
Akkor vagy teljesen csatlakozva, amikor a válasz megnevezi a várt projektkönyvtárat, a fájllista megegyezik a hoszton lévővel, és bármilyen engedélykérdés megjelenik a távoli kliensen, hogy jóváhagyd vagy elutasítsd.
5. Az újracsatlakozási viselkedés megerősítése
Zárd be a megtekintő klienst, várj néhány másodpercet, majd nyisd meg újra ugyanazt a munkamenetet. A meglévő előzményeknek vissza kell térniük, és a hosztnak online kell maradnia. Ez a tényleges távoli útvonalat ellenőrzi, ahelyett hogy csak azt bizonyítaná, hogy a telepítő sikeresen letöltődött.
Ne altasd el a hosztot a teszt során. Az alvó vagy kikapcsolt hoszt nem tudja futtatni az ügynököt, még akkor sem, ha a mentett kapcsolat továbbra is megjelenik a fiókodban.
Hibaelhárítás
A gép nem jelenik meg az Ügynökben
Futtasd a pandapaw status parancsot a hoszton. Ha a telepítés sikeres volt, de nincs fiók csatolva, futtasd a pandapaw login parancsot. Ha előkészített kulcsot használtál, és az már beváltásra került vagy lejárt, generálj egy újat a Csatlakoztatott eszközök oldalon, és futtasd újra a megjelenített parancsot.
A `pandapaw` nem ismerhető fel
Nyiss egy új terminált. macOS/Linux esetén ellenőrizd, hogy a ~/.local/bin szerepel-e a PATH-ban. Windows esetén a telepítő hozzáadja a %LOCALAPPDATA%\Programs\pandapaw-t a felhasználói PATH-hoz; a telepítés előtt megnyitott terminál nem fogja látni az új értéket.
A gép listázva van, de offline
Győződj meg róla, hogy a hoszt be van kapcsolva, ébren van, és eléri az internetet. Ezután ellenőrizd a pandapaw status parancsot. A vállalati tűzfalaknak engedélyezniük kell a kimenő HTTPS/WebSocket forgalmat; nem szabad bejövő porttovábbítási szabályt létrehozni.
A kapcsolat működik, de a motor hitelesítést kér
A PandaPaw párosítás és a modellszolgáltatói bejelentkezés különálló. A párosítás bizonyítja, hogy a hoszt a te PandaNpc-fiókodhoz tartozik; a Claude Code-nak vagy a Codex-nek továbbra is szüksége lehet a saját előfizetéses bejelentkezésére vagy API-konfigurációjára. Fejezd be a motor szokásos bejelentkezését, majd próbáld újra a munkamenetet.
Az ügynök rossz mappában nyílik meg
Fejezd be azt a teszt-munkamenetet, és hozz létre egy újat a kívánt munkakönyvtárral. Mielőtt jóváhagynád az eszközhasználatot, kérd meg az ügynököt, hogy írja ki az aktuális könyvtárat. A távoli kapcsolat önmagában nem ad hozzá fájlrendszer-sandboxot; a motor eszközengedélyei és a kiválasztott munkakönyvtár továbbra is fontosak.
Következő lépések
- Olvasd el a teljes PandaPaw hoszt útmutatót a frissítésekért, a szolgáltatásellenőrzésekért és a kapcsolati architektúráért.
- Tekintsd át a Fiók és számlázás oldalt, hogy megértsd, melyik előfizetés vagy szolgáltató fizet minden munkamenetért.
- Adj hozzá egyéni AI-szolgáltatókat, ha OpenAI-kompatibilis végpontot, saját üzemeltetésű modellt vagy külön API-kulcsot szeretnél.