PandaNpc és PandaPaw telepítése

Frissítve

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.

Csak a klienst telepítse a PandaNpc chat és a helyi asztali használathoz. Mindkét részt telepítse, ha egy másik gépen futó kódolási ügynökhöz szeretne csatlakozni.

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
PandaNpc chat használata böngészőben Nyissa meg a webalkalmazást Nem szükséges
Ügynök irányítása ugyanazon az asztalon Asztali alkalmazás A kiválasztott helyi/távoli módtól függ
Fejlesztőgép irányítása telefonról vagy böngészőből Telepítsen/nyisson meg egy klienst a megjelenítő eszközön Szükséges a fejlesztőgépen
Ügynökök futtatása grafikus asztallal nem rendelkező szerveren Web, asztali vagy iOS máshol Szükséges 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

  1. Töltse le a jelenlegi Windows-telepítőt.
  2. Futtassa, és kövesse a telepítő utasításait.
  3. Indítsa el a PandaNpc-t a Start menüből.
  4. 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.com oldalról származik, mielőtt folytatná.

macOS

  1. Töltse le a macOS .dmg fájlt.
  2. Húzza a PandaNpc-t az Alkalmazások mappába.
  3. 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:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Ha 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:

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

Előkészített egyszeri kulcsos forma:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Egyszerű telepítő:

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

Előkészített egyszeri kulcsos forma:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

A 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ő:

  1. 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ó PATH változóját.
  2. Regisztrálja a megfelelő háttérszolgáltatásokat az automatikus indításhoz.
  3. Telepíti a hiányzó, támogatott kódolási motorokat, ha a platform lehetővé teszi.
  4. Saját Node.js futási környezetet biztosít, ha a rendszer nem rendelkezik megfelelő verzióval.
  5. Elindítja a fiókhitelesítést, vagy beváltja az előkészített eszközkulcsot.
  6. 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:

bash
pandapaw status

Ezutá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.

Frissítse a PandaPaw-t, és indítsa újra a felügyelt szolgáltatásait ezzel:

bash
pandapaw update --restart

A 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 uninstall parancsot 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.