PandaNpc Work – Rychlý start: Připojte svého prvního agenta

Začněte používat PandaNpc Work, AI pracovní prostor s více enginy. Připojte počítač s PandaPaw, zvolte engine agenta a ověřte vzdálenou relaci.

Aktualizováno

Tento průvodce připojí jeden počítač k PandaNpc Work a ověří, že můžete spouštět Claude Code, Codex nebo PandaCode z jiného zařízení. PandaNpc Work je víceengine AI pracovní prostor, kde delegujete práci a sledujete ji napříč zařízeními. Agent stále běží na připojeném počítači; PandaPaw poskytuje propojení a lokální runtime, zatímco PandaNpc Work vám dává synchronizované rozhraní pro zprávy, schválení, otázky a historii relací.

Tato cesta je nejlepší pro lidi, kteří už jsou zvyklí na Claude Code, Codex nebo podobného kódovacího agenta. Většina lidí by měla použít postup Přidat zařízení, protože vygeneruje jednorázový instalační příkaz již propojený s jejich účtem. Počítejte asi s pěti minutami plus případným přihlášením k poskytovateli modelu, které váš kódovací engine vyžaduje. Chcete-li prozkoumat rozhraní Agent před připojením počítače, otevřete PandaNpc Agent v prohlížeči.

Než začnete

Budete potřebovat:

  • Účet PandaNpc otevřený ve webové aplikaci, desktopové aplikaci nebo iOS aplikaci.
  • Připojený počítač s Windows x64, macOS nebo Linux x86_64.
  • Přístup k internetu z hostitele a oprávnění nainstalovat uživatelskou službu běžící na pozadí.
  • Složku projektu, kterou smíte upravovat.
  • Účet Claude, ChatGPT/Codex nebo vlastního modelu, pokud váš zvolený engine ještě není autentizovaný.

Pokud chcete pouze zobrazit již připojeného hostitele, nainstalujte nebo otevřete klienta na zařízení, ze kterého chcete zobrazovat. PandaPaw patří na počítač, kde běží agent. Viz Instalace pro role klienta a hostitele.

1. Vygenerujte instalační příkaz pro hostitele

Během přihlášení otevřete Připojená zařízení a zvolte Přidat zařízení. PandaNpc vytvoří jednorázový klíč zařízení a zobrazí přesný příkaz pro váš operační systém.

Zkopírujte tento příkaz na počítač, kde má kódovací agent běžet. Zacházejte s ním jako s heslem, dokud nebude použit: jednorázový klíč spáruje jeden počítač a neměl by být zveřejňován v chatu, na screenshotech, v issues ani v exportech historie shellu.

Pokud dáváte přednost autorizaci v prohlížeči místo připraveného klíče, použijte v dalším kroku prostý instalátor. Spustí pandapaw login a otevře za vás autorizační stránku.

2. Nainstalujte PandaPaw na hostitele

macOS nebo Linux

Spusťte připravený příkaz ze stránky Připojená zařízení, nebo použijte prostý instalátor:

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

Windows PowerShell

Spusťte připravený příkaz ze stránky Připojená zařízení, nebo použijte:

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

Instalátor přidá PandaPaw a jeho služby běžící na pozadí, nainstaluje chybějící podporované kódovací enginy, pokud je to možné, a poskytne soukromý runtime Node.js, když hostitel nemá vhodný. S připraveným klíčem zařízení proběhne párování účtu během instalace. U prostého příkazu schvalte po výzvě autorizační požadavek v prohlížeči.

Instalátor může dokončit i v případě, že je autorizace účtu odložena. Pokud hlásí, že instalace proběhla úspěšně, ale připojení účtu je neúplné, spusťte:

bash
pandapaw login

3. Ověřte služby hostitele

Na hostiteli spusťte:

bash
pandapaw status

Příkaz by měl rozpoznat nainstalované služby a zobrazit počítač připojený k účtu. Pokud shell nemůže najít pandapaw, otevřete nejprve nový terminál, aby znovu načetl aktualizovanou uživatelskou PATH.

U projektu Git můžete také zkontrolovat, zda Agent Center rozpoznává kořen projektu:

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

Použijte skutečnou absolutní cestu k projektu. Propojení projektu v Agent Center funguje nejlépe, když má adresář stabilní Git remote.origin.url.

4. Spusťte první vzdálenou relaci

  1. Otevřete PandaNpc Agent na telefonu, v prohlížeči nebo na jiném desktopu.
  2. Najděte nově připojený počítač. Zelený indikátor stavu znamená, že je hostitel právě dostupný.
  3. Zvolte Claude Code, Codex nebo PandaCode a vyberte pracovní adresář projektu.
  4. Spusťte relaci. Pokud vás engine požádá o přihlášení, dokončete autorizaci u daného poskytovatele na hostiteli nebo prostřednictvím zobrazeného přihlašovacího postupu.
  5. Pošlete nedestruktivní testovací prompt, například: Show the current working directory and list the top-level files. Do not edit anything.

Jste plně připojeni, když odpověď uvádí očekávaný adresář projektu, seznam souborů odpovídá hostiteli a případná otázka na oprávnění se objeví ve vzdáleném klientovi, abyste ji mohli schválit nebo zamítnout.

5. Ověřte chování při opětovném připojení

Zavřete klientskou aplikaci pro zobrazení, počkejte několik sekund a znovu otevřete stejnou relaci. Stávající historie by se měla vrátit a hostitel by měl zůstat online. Tím zkontrolujete skutečnou vzdálenou cestu, místo abyste pouze ověřili, že se instalátor úspěšně stáhl.

Během tohoto testu neuvádějte hostitele do režimu spánku. Hostitel ve spánku nebo vypnutý nemůže spouštět agenta, i když se uložené připojení stále zobrazuje ve vašem účtu.

Řešení problémů

Počítač se nezobrazuje v Agent

Na hostiteli spusťte pandapaw status. Pokud instalace proběhla úspěšně, ale není připojen žádný účet, spusťte pandapaw login. Pokud jste použili připravený klíč a byl již uplatněn nebo vypršel, vygenerujte nový v Připojená zařízení a znovu spusťte zobrazený příkaz.

`pandapaw` není rozpoznán

Otevřete nový terminál. V macOS/Linuxu ověřte, že ~/.local/bin je v PATH. Ve Windows instalátor přidá %LOCALAPPDATA%\Programs\pandapaw do uživatelské PATH; terminál otevřený před instalací novou hodnotu neuvidí.

Počítač je uveden, ale je offline

Ověřte, že je hostitel zapnutý, probuzený a může se připojit k internetu. Poté zkontrolujte pandapaw status. Firewally v podnicích musí povolit odchozí provoz HTTPS/WebSocket; neměli byste vytvářet pravidlo pro přesměrování příchozích portů.

Připojení funguje, ale engine vyžaduje autentizaci

Párování PandaPaw a přihlášení k poskytovateli modelu jsou oddělené. Párování prokazuje, že hostitel patří k vašemu účtu PandaNpc; Claude Code nebo Codex může stále vyžadovat vlastní přihlášení k předplatnému nebo konfiguraci API. Dokončete běžné přihlášení enginu a poté relaci zkuste znovu.

Agent se otevírá ve špatné složce

Ukončete tuto testovací relaci a vytvořte novou s zamýšleným pracovním adresářem. Před schválením použití nástroje požádejte agenta, aby vypsal aktuální adresář. Vzdálené připojení samo o sobě nepřidává sandbox souborového systému; oprávnění nástrojů enginu a zvolený pracovní adresář zůstávají důležité.

Další kroky

  • Přečtěte si úplného průvodce hostitelem PandaPaw pro aktualizace, kontroly služeb a architekturu připojení.
  • Projděte si Účet a fakturace a zjistěte, které předplatné nebo poskytovatel platí za každou relaci.
  • Přidejte vlastní poskytovatele AI, když chcete koncový bod kompatibilní s OpenAI, vlastní hostovaný model nebo samostatný API Key.