A távoli kódolási ügynök beállítása két független részből áll:
- PandaNpc kliens — az a felület, amellyel a munkameneteket olvashatja, utasításokat küldhet, és jóváhagyhatja az eszközöket. Weben, iOS, Windows, macOS és Linux rendszeren fut.
- PandaPaw gazdagép — a háttérszolgáltatás azon a számítógépen, ahol a Claude Code, Codex vagy PandaCode ténylegesen fut.
Telepítse a klienst a megtekintő eszközön. Távoli kódoláshoz győződjön meg arról, hogy az ágenst futtató számítógéphez csatlakoztatott gazdagép tartozik; nem szükséges másik gazdagép-telepítés egy olyan eszközön, amelyet csak megtekintésre használ.
A Windows/macOS/Linux alkalmazás által az alábbi telepítő lépéseken túl nyújtott lehetőségekért, beleértve a kiadási előzményeket, tekintse meg a PandaNpc Desktop oldalt.
Válassza ki, mit telepítsen
| Forgatókönyv | Kliens | PandaPaw gazdagép |
|---|---|---|
| Már csatlakoztatott ágens megtekintése böngészőben | Nyissa meg a webalkalmazást | Már telepítve a távoli számítógépen |
| Ágens vezérlése ugyanazon az asztalon | Asztali alkalmazás | A kiválasztott helyi/távoli módtól függ |
| Fejlesztői gép vezérlése telefonról vagy böngészőből | Kliens telepítése/megnyitása a megtekintő eszközön | Kötelező a fejlesztői gépen |
| Ágensek futtatása grafikus asztal nélküli szerveren | Web, asztali vagy iOS máshol | Kötelező a szerveren |
A legrövidebb végpontok közötti úthoz használja a Gyorsindítási útmutatót.
PandaNpc kliens telepítése
A PandaNpc letöltési oldal a mérvadó forrás a jelenlegi telepítőkhöz. Kerülje a harmadik féltől származó letöltőoldalakat, mert régi vagy módosított csomagokat kínálhatnak.
Web
Nyissa meg a pandanpc.com/agent oldalt egy naprakész böngészőben. Semmi sem települ. A böngésző tárolója őrzi a helyi bejelentkezési állapotot, ezért privát/inkognitó ablakokban előfordulhat, hogy újra be kell jelentkeznie.
iOS
Kövesse az App Store hivatkozást a letöltési oldalon, és telepítse a PandaNpc-t. Az iOS hasznos a folyamat ellenőrzésére, kérdések megválaszolására és az eszközök jóváhagyására, amikor távol van a gazdagéptől. A kódolási folyamat továbbra is a csatlakoztatott gazdagépen fut. Az alkalmazás által lefedett funkciókért, beleértve a kiadási előzményeket, tekintse meg a PandaNpc for iOS oldalt.
Windows
- Töltse le a jelenlegi Windows-telepítőt.
- Futtassa, és kövesse a telepítő utasításait.
- Indítsa el a PandaNpc-t a Start menüből.
- Ha a Windows közzétevői vagy hírnévfigyelmeztetést jelenít meg, győződjön meg arról, hogy a fájl a
pandanpc.comoldalról származik, mielőtt folytatná.
macOS
- Töltse le a macOS
.dmgfájlt. - Húzza a PandaNpc-t az Alkalmazások mappába.
- Indítsa el az Alkalmazások mappából, és fejezze be a macOS biztonsági kérését.
A macOS build univerzális, így ugyanaz a csomag támogatja az Apple Silicon és Intel Mac gépeket.
Linux
Töltse le az x86_64 AppImage fájlt, tegye futtathatóvá, és futtassa:
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImageHa az AppImage nem indul el, futtassa egyszer terminálból, és őrizze meg a pontos hibaüzenetet. A régebbi disztribúciókból hiányozhat a desktop shell által igényelt futásidejű könyvtár.
PandaPaw telepítése az ügynök gazdagépére
A PandaPaw jelenleg Windows x64, macOS univerzális és Linux x86_64 rendszerre kínál gazdagép-telepítőket. Futtassa a parancsot azon a számítógépen, amely a projektfájlokat tartalmazza, és amelynek végre kell hajtania az ügynök eszközeit.
Az ajánlott útvonal a Csatlakoztatott eszközök: válassza az Eszköz hozzáadása lehetőséget, majd másolja ki a generált egyszeri parancsot. Ez a telepítés során párosítja a gazdagépet a fiókjával.
macOS vagy Linux
Egyszerű telepítő böngészős hitelesítéssel:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shElőkészített egyszeri kulcsos forma:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxxWindows PowerShell
Egyszerű telepítő:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexElőkészített egyszeri kulcsos forma:
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexA PowerShell iwr | iex folyamata nem tud normál szkriptargumentumokat átadni, ezért a Windows-telepítő az egyszeri kulcsot a PANDANET_KEY környezeti változóból olvassa be.
Mit változtat a gazdagép-telepítő
A telepítő:
- Hozzáadja a PandaPaw-t az aktuális felhasználó alkalmazás/bin könyvtárához, és szükség esetén frissíti a felhasználó
PATHváltozóját. - Regisztrálja a megfelelő háttérszolgáltatásokat az automatikus indításhoz.
- Telepíti a hiányzó, támogatott kódolási motorokat, ha a platform lehetővé teszi.
- Saját Node.js futási környezetet biztosít, ha a rendszer nem rendelkezik megfelelő verzióval.
- Elindítja a fiókhitelesítést, vagy beváltja az előkészített eszközkulcsot.
- Nyilvántartja, hogy mely fájlokat hozta létre, hogy az eltávolítás megőrizhesse a már meglévő kompatibilis eszközöket.
Egy motor telepítése nem vásárolja meg és nem hitelesíti automatikusan a modell-előfizetést. A Claude Code és a Codex továbbra is kérheti a saját szolgáltatói bejelentkezést az első futtatáskor.
A telepítés ellenőrzése
A telepítés után nyisson új terminált, és futtassa:
pandapaw statusEzután nyissa meg a PandaNpc Agent oldalt. A gazdagépnek online állapotban kell megjelennie. Indítson munkamenetet egy tesztprojektben, és kérje meg, hogy jelentse az aktuális munkakönyvtárat a fájlok módosítása nélkül. Ez ellenőrzi a binárist, a háttérszolgáltatást, a fiókpárosítást, a relékapcsolatot, a motort és a kiválasztott könyvtárat – nem csak a letöltési lépést.
Frissítés
Az asztali kliensek értesítik, ha frissítés érhető el. Az iOS az App Store-on keresztül frissül.
A frissítés előtt fejezze be az aktív munkát, majd indítsa újra: a felügyelt szolgáltatások újraindítása megszakíthatja a futó ágens munkameneteit. Ezután futtassa:
pandapaw update --restartA frissítő a letöltött binárist a közzétett SHA-256 ellenőrzőösszeghez hasonlítja, mielőtt lecserélné a telepített példányt. A fiókpárosítás és a meglévő kapcsolati azonosság megmarad. A telepítőparancs újrafuttatása is támogatott, ha maga a frissítő nem érhető el.
Eltávolítás
- Windows-kliens: Gépház → Alkalmazások → Telepített alkalmazások → PandaNpc → Eltávolítás.
- macOS-kliens: lépjen ki a PandaNpc-ből, majd húzza az Alkalmazások mappából a Kukába.
- Linux-kliens: távolítsa el az AppImage fájlt és a hozzá létrehozott indítókat.
- PandaPaw gazdagép: futtassa a
pandapaw uninstallparancsot a gazdagépen.
A PandaPaw eltávolítási manifestje megkülönbözteti a telepítő által létrehozott eszközöket a már meglévő, kompatibilis eszközöktől. Szándékosan konzervatív, nem törli a korábban telepített Claude Code, Codex, PandaCode vagy Node telepítést.
Telepítési problémák
A parancs befejeződött, de a gazdagép nem csatlakozik
Futtassa a pandapaw login parancsot. A gazdagép-telepítés és a fiókhitelesítés külön szakaszok, és a telepítő akkor is befejeződhet, ha a böngészős hitelesítést elhalasztották vagy megszakították.
A shell nem találja a `pandapaw`-t
Nyisson új terminált. macOS/Linux rendszeren ellenőrizze a ~/.local/bin mappát; Windows rendszeren a %LOCALAPPDATA%\Programs\pandapaw mappát. Ne telepítse újra ismételten, amíg meg nem erősítette, hogy a futtatható fájl létezik, és csak a PATH elavult.
Egy kódolási motor telepítése nem sikerült
A gazdagép-telepítő az opcionális motorletöltéseket a lehető legjobb módon kezeli, így egy szolgáltatókiesés nem távolítja el a működő PandaPaw-telepítést. Telepítse vagy javítsa meg az adott motort a hivatalos telepítőjével, hitelesítse a szokásos módon, majd futtassa újra a pandapaw status parancsot.
Az AppImage vagy az asztali alkalmazás nem nyílik meg
Győződjön meg arról, hogy a megfelelő architektúrához készült csomagot töltötte le, majd indítsa el terminálból, hogy megkapja az első hibát. Mellékelje ezt a hibát és az operációs rendszere verzióját, amikor felveszi a kapcsolatot az ügyfélszolgálattal; a bezárt ablakról készült képernyőképek általában nem elegendőek egy hiányzó futásidejű könyvtár diagnosztizálásához.
A gazdagép-specifikus kapcsolati ellenőrzésekhez folytassa a PandaPaw útmutatóval vagy a GYIK oldallal.