Schnellstart: Claude Code oder Codex remote ausführen

Aktualisiert

Diese Anleitung verbindet einen Entwicklungsrechner mit PandaNpc und stellt sicher, dass Sie Claude Code, Codex oder PandaCode von einem anderen Gerät aus ausführen können. Der Agent wird weiterhin auf Ihrem Entwicklungsrechner ausgeführt; PandaNpc bietet Ihnen eine synchronisierte Remote-Oberfläche für Nachrichten, Genehmigungen, Fragen und Sitzungsverlauf.

Die meisten sollten den Ablauf Gerät hinzufügen verwenden, da dieser einen einmaligen Installationsbefehl erzeugt, der bereits mit ihrem Konto verknüpft ist. Planen Sie etwa fünf Minuten ein, zuzüglich der Anmeldung beim Modellanbieter, die Ihre Coding-Engine erfordert.

Vorbereitung

Sie benötigen:

  • Ein PandaNpc-Konto, das in der Web-App, Desktop-App oder iOS-App geöffnet wurde.
  • Einen Host mit Windows x64, macOS oder Linux x86_64.
  • Internetzugriff vom Host und die Berechtigung, einen Hintergrunddienst auf Benutzerebene zu installieren.
  • Einen Projektordner, den Sie ändern dürfen.
  • Ein Claude-, ChatGPT/Codex- oder Custom-Model-Konto, falls Ihre gewählte Engine noch nicht authentifiziert ist.

Wenn Sie nur den integrierten Chat von PandaNpc benötigen und keinen Agenten auf einem anderen Rechner steuern möchten, ist PandaPaw nicht erforderlich. Siehe Installation für die Nur-Client-Optionen.

1. Host-Installationsbefehl erzeugen

Melden Sie sich an, öffnen Sie 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 Rechner, auf dem der Coding-Agent ausgeführt werden soll. Behandeln Sie ihn bis zur Verwendung wie ein Passwort: Ein einmaliger Schlüssel koppelt genau einen Rechner und sollte nicht in Chats, Screenshots, Issues oder Shell-Verlaufsexporten gepostet werden.

Wenn Sie die Browser-Autorisierung anstelle eines vorbereiteten Schlüssels bevorzugen, verwenden Sie im nächsten Schritt den einfachen Installer. Dieser 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:

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

Windows PowerShell

Führen Sie den vorbereiteten Befehl aus „Verbundene Geräte“ aus oder verwenden Sie:

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

Der 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. Mit dem einfachen Befehl genehmigen Sie die Browser-Autorisierungsanfrage, wenn Sie dazu aufgefordert werden.

Der Installer kann auch dann abschließen, wenn die Kontoautorisierung aufgeschoben wird. Wenn die Meldung erscheint, dass die Installation erfolgreich war, die Kontoverbindung jedoch unvollständig ist, führen Sie Folgendes aus:

bash
pandapaw login

3. Host-Dienste überprüfen

Führen Sie auf dem Host Folgendes aus:

bash
pandapaw status

Der Befehl sollte die installierten Dienste erkennen und den mit dem Konto verbundenen Rechner anzeigen. Wenn die Shell pandapaw nicht findet, öffnen Sie zuerst ein neues Terminal, damit der aktualisierte Benutzer-PATH neu geladen wird.

Bei einem Git-Projekt können Sie auch prüfen, ob das Agent Center das Projektverzeichnis erkennt:

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

Verwenden Sie einen echten absoluten Projektpfad. Die Projektbindung im Agent Center funktioniert am besten, wenn das Verzeichnis eine stabile Git-remote.origin.url hat.

4. Erste Remote-Sitzung starten

  1. Öffnen Sie PandaNpc Agent auf Ihrem Telefon, Browser oder einem anderen Desktop.
  2. Suchen Sie den neu verbundenen Rechner. Eine grüne Statusanzeige bedeutet, dass der Host derzeit erreichbar ist.
  3. Wählen Sie Claude Code, Codex oder PandaCode und wählen Sie das Projektarbeitsverzeichnis.
  4. Starten Sie eine Sitzung. Wenn die Engine Sie zur Anmeldung auffordert, schließen Sie die Autorisierung des Anbieters auf dem Host oder über den angezeigten Anmeldevorgang ab.
  5. Senden Sie einen nicht-destruktiven Testprompt, z. B.: Zeige das aktuelle Arbeitsverzeichnis und liste die Dateien der obersten Ebene auf. Bearbeite nichts.

Sie sind vollständig verbunden, wenn die Antwort das erwartete Projektverzeichnis nennt, die Dateiliste mit dem Host übereinstimmt und jede Berechtigungsfrage im Remote-Client angezeigt wird, die Sie genehmigen oder ablehnen können.

5. Wiederverbindungsverhalten bestätigen

Schließen Sie den anzeigenden Client, warten Sie ein paar Sekunden und öffnen Sie dieselbe Sitzung erneut. Der vorhandene Verlauf sollte zurückkehren und der Host sollte online bleiben. So wird der tatsächliche Remote-Pfad geprüft, nicht nur bewiesen, dass der Installer erfolgreich heruntergeladen wurde.

Versetzen Sie den Host während dieses Tests nicht in den Ruhemodus. Ein ruhender oder ausgeschalteter Host kann den Agenten nicht ausführen, auch wenn die gespeicherte Verbindung weiterhin in Ihrem Konto angezeigt wird.

Fehlerbehebung

Der Rechner erscheint nicht im Agent

Führen Sie auf dem Host pandapaw status aus. Wenn die Installation erfolgreich war, aber kein Konto verbunden ist, führen Sie pandapaw login aus. Wenn Sie einen vorbereiteten Schlüssel verwendet haben und dieser bereits eingelöst oder abgelaufen ist, erzeugen Sie in „Verbundene Geräte“ einen neuen 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 vor der Installation geöffnetes Terminal erkennt den neuen Wert nicht.

Der Rechner wird aufgelistet, ist aber offline

Stellen Sie sicher, 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 erlauben; Sie sollten keine eingehende Port-Weiterleitungsregel erstellen.

Die Verbindung funktioniert, aber die Engine fragt nach Authentifizierung

Die Kopplung mit PandaPaw und die Anmeldung beim Modellanbieter sind getrennt. Die Kopplung beweist, dass der Host zu Ihrem PandaNpc-Konto gehört; Claude Code oder Codex erfordern möglicherweise weiterhin eine eigene Abo-Anmeldung oder API-Konfiguration. Schließen Sie die normale Anmeldung der Engine ab und versuchen Sie die Sitzung dann erneut.

Der Agent öffnet den falschen Ordner

Beenden Sie diese Testsitzung und erstellen Sie eine mit dem gewünschten Arbeitsverzeichnis. Fragen Sie den Agenten, bevor Sie die Nutzung von Tools genehmigen, nach dem aktuellen Verzeichnis. Eine Remote-Verbindung fügt von sich aus keine 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 Verbindungsarchitektur.
  • Überprüfen Sie Konto und Abrechnung, um zu verstehen, welches Abo oder welcher Anbieter für jede Sitzung zahlt.
  • Fügen Sie benutzerdefinierte KI-Anbieter hinzu, wenn Sie einen OpenAI-kompatiblen Endpunkt, ein selbst gehostetes Modell oder einen separaten API key wünschen.