Rychlý start: Spusťte Claude Code nebo Codex vzdáleně

Aktualizováno

Tento průvodce připojí jeden vývojový počítač k PandaNpc a ověří, že můžete spouštět Claude Code, Codex nebo PandaCode z jiného zařízení. Agent stále běží na vašem vývojovém počítači; PandaNpc vám poskytuje synchronizované vzdálené rozhraní pro zprávy, schvalování, dotazy a historii relací.

Většina lidí by měla použít postup Přidat zařízení, protože vygeneruje jednorázový instalační příkaz propojený s jejich účtem. Počítejte s přibližně pěti minutami plus přihlášením k poskytovateli modelu, které váš kódovací engine vyžaduje.

Než začnete

Budete potřebovat:

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

Pokud potřebujete pouze vestavěný chat PandaNpc a nechcete ovládat agenta na jiném počítači, PandaPaw není nutné. Viz Instalace pro možnosti pouze s klientskou částí.

1. Vygenerování instalačního příkazu pro hostitele

Po přihlášení otevřete Propojená 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. Chovejte se k němu jako k heslu, dokud není použit: jednorázový klíč spáruje jeden počítač a neměl by být zveřejňován v chatu, na snímcích obrazovky, v hlášeních problémů 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ý instalační program. Spustí příkaz pandapaw login a otevře vám autorizační stránku.

2. Instalace PandaPaw na hostiteli

macOS nebo Linux

Spusťte připravený příkaz z Propojených zařízení, nebo použijte prostý instalační program:

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

Windows PowerShell

Spusťte připravený příkaz z Propojených zařízení, nebo použijte:

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

Instalační program přidá PandaPaw a jeho služby na pozadí, nainstaluje chybějící podporované kódovací enginy, pokud je to možné, a poskytne soukromé běhové prostředí Node.js, pokud hostitel nemá vhodné. S připraveným klíčem zařízení proběhne propojení účtu během instalace. Při použití prostého příkazu schvalte po zobrazení výzvy autorizační požadavek v prohlížeči.

Instalační program může skončit i v případě, že je autorizace účtu odložena. Pokud hlásí úspěšnou instalaci, ale propojení účtu je neúplné, spusťte:

bash
pandapaw login

3. Ověření služeb hostitele

Na hostiteli spusťte:

bash
pandapaw status

Příkaz by měl rozpoznat nainstalované služby a zobrazit počítač propojený s účtem. Pokud shell nemůže najít pandapaw, otevřete nejprve nový terminál, aby se znovu načetla aktualizovaná hodnota PATH uživatele.

Pro projekt 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. Vazba projektu v Agent Center funguje nejlépe, když má adresář stabilní remote.origin.url v Gitu.

4. Spuštění první vzdálené relace

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

Jste plně připojeni, když odpověď obsahuje očekávaný adresář projektu, seznam souborů odpovídá hostiteli a na vzdáleném klientovi se zobrazí dotaz na oprávnění, který můžete schválit nebo zamítnout.

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

Zavřete klientskou aplikaci, 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 se ověří skutečná vzdálená cesta, ne pouze to, že se instalační program úspěšně stáhl.

Během tohoto testu hostitele neuspávejte. Hostitel v režimu 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 aplikaci Agent

Spusťte na hostiteli 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 ten byl již použit nebo vypršel, vygenerujte nový v Propojených zařízeních a znovu spusťte zobrazený příkaz.

`pandapaw` není rozpoznán

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

Počítač je v seznamu, ale je offline

Ověřte, že je hostitel zapnutý, nespí a je schopný připojení k internetu. Poté zkontrolujte pandapaw status. Firewally ve firmá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 žádá o autentizaci

Propojení PandaPaw a přihlášení k poskytovateli modelu jsou oddělené. Propojení dokazuje, ž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ře ve špatné složce

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

Další kroky

  • Přečtěte si kompletního průvodce hostitelem PandaPaw pro aktualizace, kontroly služeb a architekturu připojení.
  • Projděte si Účet a fakturaci, abyste porozuměli, které předplatné nebo poskytovatel platí za každou relaci.
  • Přidejte vlastní poskytovatele AI, pokud chcete endpoint kompatibilní s OpenAI, samostatně hostovaný model nebo samostatný API key.