Gyors útmutató: Claude Code vagy Codex futtatása távolról

Frissítve

Ez az útmutató összekapcsol egy fejlesztőgépet a PandaNpc-vel, és ellenőrzi, hogy futtathatod-e a Claude Code, Codex vagy PandaCode alkalmazásokat egy másik eszközről. Az ágens továbbra is a fejlesztőgépeden fut; a PandaNpc szinkronizált távoli felületet biztosít az üzenetekhez, jóváhagyásokhoz, kérdésekhez és a munkamenet-előzményekhez.

Az emberek többsége az Eszköz hozzáadása folyamatot használja, mert az egy egyszeri telepítési parancsot generál, amely már hozzá van kapcsolva a fiókjukhoz. Hagyj körülbelül öt percet, plusz a modellszolgáltatónál történő bejelentkezést, amelyet a kódolómotor igényel.

Kezdés előtt

Szükséged lesz:

  • Egy PandaNpc-fiók, amely meg van nyitva a webalkalmazásban, asztali alkalmazásban vagy iOS-alkalmazásban.
  • Egy gazdagép, amely Windows x64, macOS vagy Linux x86_64 rendszert futtat.
  • Internet-hozzáférés a gazdagépről, és 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 egyedi modell fiók, ha a választott motor még nincs hitelesítve.

Ha csak a PandaNpc beépített chatjére van szükséged, és nem szeretnéd egy másik gépen lévő ágenst vezérelni, akkor a PandaPaw nem szükséges. A csak kliensként használható opciókért lásd a Telepítés részt.

1. A gazdagép telepítési parancsának előállítása

Bejelentkezve nyisd meg a Csatlakoztatott eszközök oldalt, és válaszd az Eszköz hozzáadása lehetőséget. A PandaNpc egy egyszeri eszközkulcsot hoz létre, és megmutatja a pontos parancsot az operációs rendszeredhez.

Másold ezt a parancsot arra a gépre, ahol a kódoló ágens futni fog. Úgy kezeld, mint egy jelszót, amíg fel nem használtad: az egyszeri kulcs egy gépet párosít, és nem szabad csevegésben, képernyőképeken, hibabejelentésekben vagy shell-előzmények exportjaiban közzétenni.

Ha a böngészős hitelesítést részesíted előnyben az előkészített kulcs helyett, használd a következő lépésben az egyszerű telepítőt. Ez futtatja a pandapaw login parancsot, és megnyitja a hitelesítési oldalt.

2. A PandaPaw telepítése a gazdagépre

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:

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

Windows PowerShell

Futtasd az előkészített parancsot a Csatlakoztatott eszközök oldalról, vagy használd:

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

A telepítő hozzáadja a PandaPaw-t és annak háttérszolgáltatásait, lehetőség szerint telepíti a hiányzó támogatott kódolómotorokat, és privát Node.js futási környezetet biztosít, ha a gazdagépen nincs megfelelő. Előkészített eszközkulccsal a fiókpárosítás a telepítés során történik. Az egyszerű paranccsal erősítsd meg a böngészős hitelesítési kérelmet, amikor felkérnek rá.

A telepítő akkor is befejeződhet, ha a fiókhitelesítés elhalasztódik. Ha azt írja, hogy a telepítés sikeres, de a fiókkapcsolat hiányos, futtasd ezt:

bash
pandapaw login

3. A gazdagép szolgáltatásainak ellenőrzése

A gazdagépen futtasd:

bash
pandapaw status

A parancsnak fel kell ismernie a telepített szolgáltatásokat, és meg kell mutatnia a fiókhoz kapcsolt gépet. Ha a shell nem találja a pandapaw parancsot, először nyiss egy új terminált, hogy az újratöltse a frissített felhasználói PATH-ot.

Egy Git-projektnél azt is ellenőrizheted, hogy az Agent Center felismeri-e a projekt gyökerét:

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

Használj valódi abszolút projektútvonalat. Az Agent Center projektkötése akkor működik a legjobban, ha a könyvtárnak stabil Git remote.origin.url címe van.

4. Az első távoli munkamenet indítása

  1. Nyisd meg a PandaNpc Agent weboldalt a telefonodon, böngésződben vagy egy másik asztali gépen.
  2. Keresd meg az újonnan csatlakoztatott gépet. A zöld állapotjelző azt jelenti, hogy a gazdagép jelenleg elérhető.
  3. Válaszd a Claude Code, Codex vagy PandaCode lehetőséget, és válaszd ki a projekt munkakönyvtárát.
  4. Indíts egy munkamenetet. Ha a motor bejelentkezést kér, végezd el a szolgáltató hitelesítését a gazdagépen vagy a megjelenített bejelentkezési folyamaton keresztül.
  5. Küldj egy nem destruktív teszt-utasítást, például: Mutasd meg az aktuális munkakönyvtárat, és sorold fel a legfelső szintű fájlokat. Ne szerkessz semmit.

Teljesen csatlakoztatva akkor vagy, ha a válasz a várt projektkönyvtárat nevezi meg, a fájllista egyezik a gazdagép állapotával, és minden engedélykérés megjelenik a távoli kliensen, hogy jóváhagyd vagy elutasítsd.

5. Az újracsatlakozás viselkedésének megerősítése

Zárd be a megtekintő klienst, várj néhány másodpercet, és nyisd meg újra ugyanazt a munkamenetet. A meglévő előzményeknek vissza kell térniük, és a gazdagépnek online kell maradnia. Ez a tényleges távoli kapcsolatot ellenőrzi, nem csak azt, hogy a telepítő sikeresen letöltődött.

Ne helyezd a gazdagépet alvó állapotba a teszt során. Az alvó vagy kikapcsolt gazdagép nem tudja futtatni az ágenst, 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 Agentben

Futtasd a pandapaw status parancsot a gazdagépen. 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 fel lett használva vagy lejárt, hozz létre egy újat a Csatlakoztatott eszközök között, és futtasd újra a megjelenített parancsot.

`pandapaw` nem ismert fel

Nyiss egy új terminált. macOS/Linux rendszeren ellenőrizd, hogy a ~/.local/bin benne van-e a PATH-ban. Windows rendszeren a telepítő hozzáadja a %LOCALAPPDATA%\Programs\pandapaw útvonalat 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 megjelenik, de offline

Győződj meg róla, hogy a gazdagép 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; ne hozz létre bejövő port-átirányítási szabályt.

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önböző dolgok. A párosítás igazolja, hogy a gazdagép a PandaNpc-fiókodhoz tartozik; a Claude Code vagy a Codex továbbra is saját előfizetéses bejelentkezést vagy API-konfigurációt igényelhet. Végezd el a motor szokásos bejelentkezését, majd próbáld újra a munkamenetet.

Az ágens a rossz mappában nyílik meg

Befejezd a teszt-munkamenetet, és hozz létre egy újat a kívánt munkakönyvtárral. Az eszközhasználat jóváhagyása előtt kérd meg az ágenst, hogy írja ki az aktuális könyvtárat. A távoli kapcsolat önmagában nem ad fájlrendszeri 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 gazdagép-útmutatót a frissítésekért, 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 az egyes munkamenetekért.
  • Vegyél fel egyedi AI-szolgáltatókat, ha OpenAI-kompatibilis végpontra, saját hosztolt modellre vagy külön API-kulcsra van szükséged.