Diese Anleitung verbindet einen Computer mit PandaNpc Work und überprüft, dass Sie Claude Code, Codex oder PandaCode von einem anderen Gerät aus ausführen können. PandaNpc Work ist der Multi-Engine-KI-Arbeitsbereich, in dem Sie Arbeit delegieren und sie geräteübergreifend verfolgen. Der Agent wird weiterhin auf dem verbundenen Computer ausgeführt; PandaPaw stellt die Brücke und die lokale Laufzeitumgebung bereit, während PandaNpc Work Ihnen eine synchronisierte Oberfläche für Nachrichten, Genehmigungen, Fragen und Sitzungsverlauf bietet.
Dieser Weg eignet sich am besten für Personen, die bereits mit Claude Code, Codex oder einem ähnlichen Coding-Agenten vertraut sind. Die meisten Personen sollten den Gerät hinzufügen-Ablauf verwenden, da er einen einmaligen Installationsbefehl generiert, der bereits mit ihrem Konto verknüpft ist. Planen Sie etwa fünf Minuten ein, plus jede Anmeldung beim Modellanbieter, die Ihre Coding-Engine erfordert. Um die Agent-Oberfläche zu erkunden, bevor Sie einen Computer verbinden, öffnen Sie PandaNpc Agent in einem Browser.
Bevor Sie beginnen
Sie benötigen:
- Ein PandaNpc-Konto, das in der Web-App, Desktop-App oder iOS-App geöffnet ist.
- Ein verbundener Computer mit Windows x64, macOS oder Linux x86_64.
- Internetzugang vom Host und Berechtigung zum Installieren eines benutzerspezifischen Hintergrunddienstes.
- Ein Projektordner, den Sie ändern dürfen.
- Ein Claude-, ChatGPT/Codex- oder Custom-Model-Konto, wenn Ihre gewählte Engine nicht bereits authentifiziert ist.
Wenn Sie nur einen bereits verbundenen Host anzeigen möchten, installieren Sie einen Client auf Ihrem Anzeigegerät oder öffnen Sie ihn. PandaPaw gehört auf den Computer, auf dem der Agent ausgeführt wird. Siehe Installation für die Client- und Host-Rollen.
1. Host-Installationsbefehl generieren
Öffnen Sie im angemeldeten Zustand Verbundene Geräte und wählen Sie Gerät hinzufügen. PandaNpc erstellt einen einmaligen Geräteschlüssel und zeigt den genauen Befehl für Ihr Betriebssystem an.
Kopieren Sie diesen Befehl auf den Computer, auf dem der Coding-Agent ausgeführt werden soll. Behandeln Sie ihn wie ein Passwort, bis er verwendet wurde: Ein einmaliger Schlüssel koppelt einen Computer und sollte nicht in Chats, Screenshots, Issues oder Shell-Verlaufsexporten veröffentlicht werden.
Wenn Sie die Browser-Autorisierung anstelle eines vorbereiteten Schlüssels bevorzugen, verwenden Sie den einfachen Installer im nächsten Schritt. Er führt pandapaw login aus und öffnet die Autorisierungsseite für Sie.
2. PandaPaw auf dem Host installieren
macOS oder Linux
Führen Sie den vorbereiteten Befehl aus „Verbundene Geräte“ aus, oder verwenden Sie den einfachen Installer:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows PowerShell
Führen Sie den vorbereiteten Befehl aus „Verbundene Geräte“ aus, oder verwenden Sie:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexDer Installer fügt PandaPaw und seine Hintergrunddienste hinzu, installiert fehlende unterstützte Coding-Engines, wenn möglich, und stellt eine private Node.js-Laufzeitumgebung bereit, wenn der Host keine geeignete besitzt. Mit einem vorbereiteten Geräteschlüssel erfolgt die Kontokopplung während der Installation. Beim einfachen Befehl genehmigen Sie die Browser-Autorisierungsanfrage, wenn Sie dazu aufgefordert werden.
Der Installer kann auch dann abgeschlossen werden, wenn die Kontoautorisierung aufgeschoben wird. Wenn er meldet, dass die Installation erfolgreich war, aber die Kontoverbindung unvollständig ist, führen Sie Folgendes aus:
pandapaw login3. Host-Dienste überprüfen
Führen Sie auf dem Host Folgendes aus:
pandapaw statusDer Befehl sollte die installierten Dienste erkennen und den mit dem Konto verbundenen Computer anzeigen. Wenn die Shell pandapaw nicht finden kann, öffnen Sie zuerst ein neues Terminal, damit sie den aktualisierten Benutzer-PATH neu lädt.
Bei einem Git-Projekt können Sie auch prüfen, ob Agent Center das Projektstammverzeichnis erkennt:
pandapaw agent status --root /path/to/your/projectVerwenden Sie einen echten absoluten Projektpfad. Die Projektbindung von Agent Center funktioniert am besten, wenn das Verzeichnis eine stabile Git-remote.origin.url hat.
4. Erste Remote-Sitzung starten
- Öffnen Sie PandaNpc Agent auf Ihrem Telefon, in Ihrem Browser oder auf einem anderen Desktop.
- Finden Sie den neu verbundenen Computer. Eine grüne Statusanzeige bedeutet, dass der Host derzeit erreichbar ist.
- Wählen Sie Claude Code, Codex oder PandaCode und wählen Sie das Arbeitsverzeichnis des Projekts aus.
- Starten Sie eine Sitzung. Wenn die Engine Sie zur Anmeldung auffordert, schließen Sie die Autorisierung dieses Anbieters auf dem Host oder über den angezeigten Anmeldeablauf ab.
- Senden Sie einen nicht destruktiven Test-Prompt wie:
Show the current working directory and list the top-level files. Do not edit anything.
Sie sind vollständig verbunden, wenn die Antwort das erwartete Projektverzeichnis nennt, die Dateiliste mit dem Host übereinstimmt und eine Berechtigungsfrage auf dem Remote-Client erscheint, damit Sie sie genehmigen oder ablehnen können.
5. Wiederverbindungsverhalten bestätigen
Schließen Sie den anzeigenden Client, warten Sie einige Sekunden und öffnen Sie dieselbe Sitzung erneut. Der vorhandene Verlauf sollte zurückkehren und der Host sollte online bleiben. Dies prüft den tatsächlichen Remote-Pfad, anstatt nur zu belegen, dass der Installer erfolgreich heruntergeladen wurde.
Versetzten Sie den Host während dieses Tests nicht in den Ruhezustand. Ein ruhender oder ausgeschalteter Host kann den Agenten nicht ausführen, obwohl die gespeicherte Verbindung weiterhin in Ihrem Konto angezeigt wird.
Fehlerbehebung
Der Computer wird nicht in Agent angezeigt
Führen Sie pandapaw status auf dem Host aus. Wenn die Installation erfolgreich war, aber kein Konto verknüpft ist, führen Sie pandapaw login aus. Wenn Sie einen vorbereiteten Schlüssel verwendet haben und dieser bereits eingelöst oder abgelaufen ist, generieren Sie einen neuen unter „Verbundene Geräte“ und führen Sie den angezeigten Befehl erneut aus.
`pandapaw` wird nicht erkannt
Öffnen Sie ein neues Terminal. Bestätigen Sie unter macOS/Linux, dass ~/.local/bin in PATH enthalten ist. Unter Windows fügt der Installer %LOCALAPPDATA%\Programs\pandapaw zum Benutzer-PATH hinzu; ein Terminal, das vor der Installation geöffnet wurde, sieht den neuen Wert nicht.
Der Computer wird aufgeführt, ist aber offline
Bestätigen Sie, dass der Host eingeschaltet, wach und in der Lage ist, das Internet zu erreichen. Prüfen Sie dann pandapaw status. Unternehmensfirewalls müssen ausgehenden HTTPS-/WebSocket-Datenverkehr zulassen; Sie sollten keine eingehende Portweiterleitungsregel erstellen.
Die Verbindung funktioniert, aber die Engine fragt nach Authentifizierung
Die PandaPaw-Kopplung und die Anmeldung beim Modellanbieter sind getrennt. Die Kopplung belegt, dass der Host zu Ihrem PandaNpc-Konto gehört; Claude Code oder Codex kann weiterhin eine eigene Abonnement-Anmeldung oder API-Konfiguration erfordern. Schließen Sie die normale Anmeldung der Engine ab und versuchen Sie dann die Sitzung erneut.
Der Agent öffnet im falschen Ordner
Beenden Sie diese Testsitzung und erstellen Sie eine mit dem vorgesehenen Arbeitsverzeichnis. Bevor Sie die Tool-Nutzung genehmigen, bitten Sie den Agenten, das aktuelle Verzeichnis auszugeben. Eine Remote-Verbindung fügt nicht von sich aus eine Dateisystem-Sandbox hinzu; die Tool-Berechtigungen der Engine und das ausgewählte Arbeitsverzeichnis bleiben wichtig.
Nächste Schritte
- Lesen Sie den vollständigen PandaPaw-Host-Leitfaden für Updates, Dienstprüfungen und die Verbindungsarchitektur.
- Lesen Sie Konto und Abrechnung, um zu verstehen, welches Abonnement oder welcher Anbieter für jede Sitzung bezahlt.
- Fügen Sie benutzerdefinierte KI-Anbieter hinzu, wenn Sie einen OpenAI-kompatiblen Endpunkt, ein selbst gehostetes Modell oder einen separaten API Key möchten.