PandaPaw: Remote-Host für Claude Code, Codex und PandaCode

PandaPaw verwandelt einen Windows-, macOS- oder Linux-Rechner, den Sie kontrollieren, in einen PandaNpc-Agenten-Host. Die Coding-Engine, Projektdateien, Shell und Tools bleiben auf diesem Host; PandaNpc-Clients bieten Ihnen eine synchronisierte Oberfläche von einem Telefon, Browser oder einem anderen Desktop.

Verwenden Sie PandaPaw, wenn sich die Maschine, die die Arbeit erledigt, von dem Gerät unterscheidet, das Sie in der Hand halten, wenn Sie einen Host möchten, der Client-Trennungen übersteht, oder wenn mehrere Coding-Engines dieselbe konto-basierte Einrichtung und Agent-Center-Konfiguration nutzen sollen.

Was PandaPaw verwaltet

• Remote-Agent-Verbindungen für Claude Code, OpenAI Codex und PandaCode.
• Hintergrunddienste und Autostart, damit der Host nach einem normalen Neustart zurückkehren kann.
• Kontobasierte Maschinenautorisierung ohne manuelles Kopieren einer langlebigen Bridge-ID, eines Tokens oder Signaturschlüssels.
• Unterstützung bei der Engine-Installation, wenn eine unterstützte Coding-Engine fehlt.
• Agent-Center-Projektionen, die die Anleitung, Fähigkeiten, den Speicher und die Agent-Definitionen jeder Engine in ihrem nativen Layout darstellen.
• Privates Geräte-Netzwerk für Maschinen, die über den Connected-Devices-Ablauf hinzugefügt wurden.
• Buchhaltung für Updates und Deinstallation, damit Werkzeuge, die vor PandaPaw existierten, erhalten bleiben.

PandaPaw bietet selbst kein Modell-Abonnement an. Claude Code, Codex und PandaCode verwenden weiterhin die für ihre Engine konfigurierten Anbieter-Anmeldedaten und -Limits.

Wie die Remote-Ausführung funktioniert

Beide Seiten initiieren ausgehende Verbindungen, sodass eine normale Heim- oder Bürokonfiguration keine eingehende Firewall-Regel, öffentliche IP-Adresse, Router-Portweiterleitung oder einen öffentlich zugänglichen SSH-Server erfordert. Das Relay überträgt Nachrichten, Status und Genehmigungen; die Werkzeugausführung erfolgt auf dem Host.

Wenn der Host in den Ruhemodus wechselt, ausgeschaltet wird oder seinen ausgehenden Netzwerkpfad verliert, bleibt die gespeicherte Verbindung in Ihrem Konto, kann aber keine Arbeit ausführen, bis der Host zurückkehrt.

Unterstützte Host-Plattformen

Der PandaNpc-Viewing-Client hat eine breitere Plattform-Matrix. Siehe PandaNpc und PandaPaw installieren bei der Auswahl von Client- und Host-Paketen.

Empfohlene Installation

1. Melden Sie sich bei PandaNpc an.
2. Öffnen Sie Connected Devices.
3. Wählen Sie Gerät hinzufügen. Es wird ein einmaliger Schlüssel ausgestellt und der Dialog zeigt einen Befehl für das erkannte Betriebssystem.
4. Kopieren Sie diesen Befehl auf den Host und führen Sie ihn dort aus.
5. Lassen Sie den Dialog geöffnet, wenn er die neue Maschine automatisch erkennen soll.

Der vorbereitete Schlüssel ist nur einmal verwendbar. Kopieren Sie den gesamten Befehl, halten Sie ihn geheim, und erzeugen Sie einen neuen, wenn er abläuft oder bereits eingelöst wurde.

Einfacher macOS/Linux-Installer

Verwenden Sie diese Form, wenn Sie eine Browser-Autorisierung anstelle eines vorbereiteten Schlüssels wünschen:

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

Einfacher Windows-PowerShell-Installer

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

Der einfache Installer führt pandapaw login aus. Bestätigen Sie die Maschine auf der Browser-Seite, die sich öffnet. Wenn die Autorisierung unterbrochen wird, können die Binärdatei und die Dienste trotzdem installiert werden; führen Sie später pandapaw login aus, um die Kontoverbindung abzuschließen.

Host überprüfen

Überprüfen Sie zuerst den Host selbst:

pandapaw status

Öffnen Sie dann den PandaNpc-Agenten und bestätigen Sie, dass die Maschine eine grüne Online-Anzeige hat. Starten Sie eine Sitzung in einem Wegwerf- oder schreibgeschützten Testverzeichnis und fragen Sie:

Testaufforderung: Geben Sie das aktuelle Arbeitsverzeichnis aus und listen Sie die Dateien der obersten Ebene auf. Ändern Sie nichts.

Eine erfolgreiche Antwort beweist mehr als eine grüne Statusleuchte: Sie verifiziert die Konto-Paarung, die Relay-Konnektivität, die ausgewählte Engine, die Anbieter-Authentifizierung und die Arbeitsverzeichnis-Zuordnung.

Führen Sie für ein Agent-Center-Projekt Folgendes aus:

pandapaw agent status --root /absolute/path/to/project

Dies zeigt, ob das Projekt gebunden ist und ob die verwaltete Konfiguration lokal verfügbar ist. Ein stabiler Git-Remote hilft PandaPaw, dasselbe Projekt über mehrere Maschinen hinweg zu identifizieren.

Konto-Autorisierung und Verbindungsidentität

pandapaw login verwendet eine Browser-Geräteautorisierungssitzung. Nachdem Sie diese bestätigt haben, erhält der Host gerätebezogene Anmeldedaten und einen Agent-Center-Verifizierungsschlüssel über TLS, schreibt seine Maschinenkonfiguration unter ~/.pandapaw/, registriert die unterstützten Engine-Verbindungen und bindet erkennbare Git-Projekte.

Führen Sie pandapaw login --force nur aus, wenn Sie absichtlich das Konto wechseln oder eine abgelaufene Host-Anmeldedaten ersetzen. Das erneute Autorisieren einer gesunden Maschine ohne Grund kann verwirrende doppelte oder ersetzte Identitäten erzeugen.

pandapaw qr erstellt weiterhin einen kurzlebigen manuellen Verbindungslink für Kompatibilitäts- und Sonderfälle. Es ist nicht der primäre Ablauf für einen neuen Host; Connected Devices ist einfacher zu überwachen und erfordert nicht, dass Benutzer Bridge-IDs verstehen.

Agent-Center-Synchronisierung

Das Agent Center ist im stationären Zustand ereignisgesteuert:

1. Lokale Änderungen an verwalteten Dateien werden erkannt und an das gebundene Projekt veröffentlicht.
2. Signierte Releases treffen über einen Ereignisstrom ein.
3. Unveränderte Manifeste und Inhaltsblobs werden wiederverwendet, anstatt erneut heruntergeladen zu werden.
4. Ein regelmäßiger Wiederherstellungscheck fängt Ereignisse ab, die während einer vorübergehenden Trennung verpasst wurden.

Claude Code, Codex und PandaCode erhalten getrennte Projektionen, da sie unterschiedliche Verzeichnisse und Anweisungsformate erwarten. PandaCode bereitet das neueste verifizierte Release vor, bevor es eine neue Sitzungsaufforderung zusammenstellt, sodass beim Start abgerufene Konfiguration dieselbe Sitzung beeinflussen kann.

Wenn das Agent Center vorübergehend nicht verfügbar ist, arbeitet die Engine mit dem letzten verifizierten lokalen Release weiter. Ein Netzwerkfehler sollte signierte Konfiguration nicht stillschweigend durch unverifizierte Inhalte ersetzen.

Nützliche Befehle

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Überprüfen Sie die PandaPaw-Versionshistorie, wenn sich ein Befehl oder eine Benutzeroberfläche von einem älteren Screenshot oder Tutorial unterscheidet.

Sicherheitsgrenzen

• Ein Remote-Bediener kann alle Werkzeuge und das Arbeitsverzeichnis nutzen, die die ausgewählte Agent-Sitzung erlaubt. Remote-Zugriff ist nicht automatisch schreibgeschützt.
• Halten Sie einmalige Gerätebefehle, manuelle Verbindungslinks, Anbieterschlüssel und Kontotokens von Protokollen und Screenshots fern.
• Öffnen Sie keine eingehenden Router-Ports, nur um PandaPaw erreichbar zu machen.
• Entfernen Sie Hosts, die Sie nicht mehr besitzen, aus Connected Devices.
• Überprüfen Sie Werkzeugfreigaben und verifizieren Sie das Arbeitsverzeichnis, bevor Sie Bearbeitungen oder Shell-Befehle zulassen.
• Wenn Sie eine Live-Verbindung teilen, verbraucht der Empfänger das Engine-Kontingent des Host-Besitzers und kann auf dem Host handeln. Lesen Sie zuerst Verbindung teilen.

Fehlerbehebung

`pandapaw` wird nach der Installation nicht gefunden

Öffnen Sie ein neues Terminal, damit es den Benutzer-PATH neu lädt. Die üblichen Speicherorte sind ~/.local/bin unter macOS/Linux und %LOCALAPPDATA%\Programs\pandapaw unter Windows. Bestätigen Sie, dass die Datei existiert, bevor Sie das Installationsprogramm erneut ausführen.

Installation erfolgreich, aber keine Maschine erscheint

Führen Sie pandapaw status aus. Wenn die Maschine keine Konto-Autorisierung hat, führen Sie pandapaw login aus. Wenn ein vorbereiteter einmaliger Schlüssel verwendet wurde, erzeugen Sie einen neuen Schlüssel, anstatt einen verbrauchten Befehl erneut zu versuchen.

Die Maschine erscheint, bleibt aber offline

Bestätigen Sie, dass der Host wach ist und Internetzugang hat. Überprüfen Sie den PandaPaw-Status lokal. Ein Unternehmens-Proxy oder eine Firewall muss den ausgehenden HTTPS/WebSocket-Pfad erlauben; ein eingehender Port löst keine blockierte ausgehende Verbindung.

Der Host ist online, aber Claude Code oder Codex antwortet nicht

Die Kopplung des Hosts authentifiziert nicht jeden Modellanbieter. Öffnen Sie die Engine lokal oder folgen Sie der im Remote-Sitzungsfenster angezeigten Login-Aufforderung. Bestätigen Sie außerdem, dass das ausgewählte Modell für dieses Konto vorhanden ist und sein Nutzungslimit nicht ausgeschöpft ist.

Die Sitzung öffnet sich im falschen Projekt

Beenden Sie den Test, wählen Sie das gewünschte absolute Arbeitsverzeichnis und bitten Sie den Agenten, es auszugeben, bevor Sie Werkzeuge freigeben. PandaPaw rät nicht, welches Repository Sie gemeint haben, und fügt keine Dateisystem-Sandbox hinzu, die über das eigene Berechtigungsmodell der Engine hinausgeht.

Agent-Center-Änderungen erscheinen nicht

Führen Sie pandapaw agent status --root /path/to/project aus dem korrekten Git-Root aus. Bestätigen Sie, dass das Projekt gebunden ist, der Host angemeldet ist und die lokale Datei Teil einer verwalteten Projektion ist. Behalten Sie das letzte verifizierte Release während der Untersuchung bei, anstatt verwaltete Verzeichnisse zu löschen.

Aktualisierung und Deinstallation

pandapaw update --restart lädt die aktuelle Binärdatei herunter, verifiziert ihre SHA-256-Prüfsumme, ersetzt die installierte Kopie und startet die verwalteten Dienste neu, sodass die Version aktiv wird. Die bestehende Konto-Paarung bleibt erhalten.

pandapaw uninstall verwendet das Installationsmanifest, um von PandaPaw erstellte Elemente zu entfernen. Kompatible Claude-Code-, Codex-, PandaCode- oder Node-Installationen, die bereits vorhanden waren, werden absichtlich erhalten. Entfernen Sie den Host nach der Deinstallation aus Connected Devices, wenn er nicht mehr vertrauenswürdig sein soll.