Instalace PandaNpc a PandaPaw

Aktualizováno

Vzdálené nastavení kódovacího agenta se skládá ze dvou nezávislých částí:

  • PandaNpc klient — rozhraní, které používáte pro čtení relací, odesílání výzev a schvalování nástrojů. Funguje na webu, iOS, Windows, macOS a Linuxu.
  • PandaPaw hostitel — služba na pozadí na počítači, kde skutečně běží Claude Code, Codex nebo PandaCode.

Nainstalujte pouze klienta pro chat PandaNpc a místní použití na desktopu. Obě části nainstalujte, když chcete dosáhnout na kódovacího agenta běžícího na jiném počítači.

Viz PandaNpc Desktop pro informace o tom, co aplikace pro Windows/macOS/Linux přidává nad rámec níže uvedených kroků instalace, včetně historie verzí.

Vyberte, co nainstalovat

Scénář Klient PandaPaw hostitel
Použití chatu PandaNpc v prohlížeči Otevřete webovou aplikaci Není vyžadováno
Ovládání agenta na tomto stejném počítači Desktopová aplikace Závisí na zvoleném místním/vzdáleném režimu
Ovládání vývojového počítače z telefonu nebo prohlížeče Nainstalujte/otevřete klienta na zobrazovacím zařízení Vyžadováno na vývojovém počítači
Spouštění agentů na serveru bez grafického rozhraní Web, desktop nebo iOS jinde Vyžadováno na serveru

Pro nejkratší cestu od začátku do konce použijte Průvodce rychlým startem.

Instalace klienta PandaNpc

Jako zdroj pravdy pro aktuální instalační soubory použijte stránku pro stažení PandaNpc. Vyhněte se stránkám třetích stran, protože mohou nabízet staré nebo upravené balíčky.

Web

Otevřete pandanpc.com/agent v aktuálním prohlížeči. Nic se neinstaluje. Úložiště prohlížeče uchovává místní stav přihlášení, takže v soukromých/anonymních oknech se možná budete muset přihlásit znovu.

iOS

Postupujte podle odkazu na App Store na stránce pro stažení a nainstalujte PandaNpc. iOS je užitečný pro kontrolu průběhu, odpovídání na otázky a schvalování nástrojů, když nejste u hostitele. Proces kódování stále běží na připojeném hostitelském počítači. Viz PandaNpc pro iOS pro informace o tom, co aplikace pokrývá, včetně historie verzí.

Windows

  1. Stáhněte aktuální instalační program pro Windows.
  2. Spusťte jej a postupujte podle pokynů instalačního programu.
  3. Spusťte PandaNpc z nabídky Start.
  4. Pokud systém Windows zobrazí varování o vydavateli nebo reputaci, před pokračováním ověřte, že soubor pochází z pandanpc.com.

macOS

  1. Stáhněte soubor .dmg pro macOS.
  2. Přetáhněte PandaNpc do Programů.
  3. Spusťte jej z Programů a dokončete případnou bezpečnostní výzvu systému macOS.

Sestavení pro macOS je univerzální, takže stejný balíček podporuje Apple Silicon i Intel Macy.

Linux

Stáhněte si x86_64 AppImage, udělejte jej spustitelným a spusťte jej:

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

Pokud se AppImage nespustí, spusťte jej jednou z terminálu a uchovejte přesný výstup chyby. Starším distribucím může chybět runtime knihovna požadovaná desktopovým prostředím.

Instalace PandaPaw na hostitelském počítači agenta

PandaPaw v současnosti poskytuje hostitelské instalátory pro Windows x64, univerzální macOS a Linux x86_64. Spusťte příkaz na počítači, který vlastní soubory projektu a má spouštět nástroje agenta.

Doporučený postup je Připojená zařízení: zvolte Přidat zařízení a poté zkopírujte vygenerovaný jednorázový příkaz. Během instalace propojí hostitele s vaším účtem.

macOS nebo Linux

Prostý instalátor:

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

Varianta s připraveným jednorázovým klíčem:

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

Windows PowerShell

Prostý instalátor:

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

Varianta s připraveným jednorázovým klíčem:

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

Kanál PowerShellu iwr | iex nemůže předávat běžné argumenty skriptu, takže instalační program pro Windows čte jednorázový klíč z PANDANET_KEY.

Co instalační program hostitele mění

Instalátor:

  1. Přidá PandaPaw do adresáře application/bin aktuálního uživatele a v případě potřeby aktualizuje uživatelský PATH.
  2. Zaregistruje příslušné služby na pozadí, aby se spouštěly automaticky.
  3. Nainstaluje podporované kódovací enginy, které chybí, pokud to platforma umožňuje.
  4. Dodá soukromé běhové prostředí Node.js, pokud systém nemá vhodnou verzi.
  5. Spustí autorizaci účtu nebo uplatní připravený klíč zařízení.
  6. Zaznamená, které soubory vytvořil, aby odinstalace mohla zachovat kompatibilní nástroje, které již byly přítomny.

Instalace enginu automaticky nekoupí ani neověří předplatné modelu. Claude Code a Codex se při prvním spuštění stále mohou ptát na vlastní přihlášení k poskytovateli.

Ověření instalace

Po instalaci otevřete nový terminál a spusťte:

bash
pandapaw status

Poté otevřete PandaNpc Agent. Hostitel by se měl zobrazit jako online. Spusťte relaci v testovacím projektu a požádejte ji, aby ohlásila aktuální pracovní adresář, aniž by měnila soubory. Tím se ověří binární soubor, služba na pozadí, propojení účtu, reléové připojení, engine a vybraný adresář – nejen krok stažení.

Aktualizace

Desktopoví klienti vás upozorní, když je k dispozici aktualizace. iOS se aktualizuje přes App Store.

Aktualizujte PandaPaw a restartujte jeho spravované služby příkazem:

bash
pandapaw update --restart

Aktualizátor ověří stažený binární soubor proti zveřejněnému kontrolnímu součtu SHA-256 před nahrazením nainstalované kopie. Vaše propojení účtu a stávající identita připojení zůstanou zachovány. Opětovné spuštění instalačního příkazu je také podporováno, pokud samotný aktualizátor není k dispozici.

Odinstalace

  • Klient pro Windows: Nastavení → Aplikace → Nainstalované aplikace → PandaNpc → Odinstalovat.
  • Klient pro macOS: ukončete PandaNpc a poté jej přesuňte z Programů do Koše.
  • Klient pro Linux: odeberte AppImage a případný spouštěč, který jste pro něj vytvořili.
  • PandaPaw hostitel: spusťte pandapaw uninstall na hostiteli.

Manifest odinstalace PandaPaw rozlišuje nástroje vytvořené instalátorem od kompatibilních nástrojů, které již existovaly. Je záměrně konzervativní, aby nesmazal stávající instalaci Claude Code, Codex, PandaCode nebo Node.

Problémy s instalací

Příkaz skončil, ale hostitel není připojen

Spusťte pandapaw login. Instalace hostitele a autorizace účtu jsou samostatné fáze a instalátor může dokončit svou práci, i když byla autorizace v prohlížeči odložena nebo přerušena.

Shell nemůže najít `pandapaw`

Otevřete nový terminál. Na macOS/Linuxu zkontrolujte ~/.local/bin; na Windows zkontrolujte %LOCALAPPDATA%\Programs\pandapaw. Neopakujte instalaci, dokud nepotvrdíte, zda spustitelný soubor existuje a zda je zastaralý pouze PATH.

Instalace kódovacího enginu se nezdařila

Hostitelský instalátor přistupuje k volitelnému stahování enginů na principu nejlepšího úsilí, takže výpadek jednoho poskytovatele neodstraní fungující instalaci PandaPaw. Nainstalujte nebo opravte tento engine pomocí jeho oficiálního instalátoru, normálně jej autorizujte a poté spusťte znovu pandapaw status.

AppImage nebo desktopová aplikace se neotevře

Ověřte, že jste stáhli balíček pro správnou architekturu, a poté jej spusťte z terminálu, abyste zachytili první chybu. Při kontaktování podpory uveďte tuto chybu a verzi vašeho operačního systému; snímky obrazovky zavřeného okna obvykle nestačí k diagnostice chybějící runtime knihovny.

Pro kontrolu připojení specifických pro hostitele pokračujte průvodcem PandaPaw nebo FAQ.