PandaNpc und PandaPaw installieren

Eine Remote-Coding-Agent-Einrichtung besteht aus zwei unabhängigen Teilen:

• PandaNpc-Client — die Schnittstelle, mit der Sie Sitzungen lesen, Eingabeaufforderungen senden und Tools genehmigen. Sie läuft im Web, auf iOS, Windows, macOS und Linux.
• PandaPaw-Host — der Hintergrunddienst auf dem Computer, auf dem Claude Code, Codex oder PandaCode tatsächlich ausgeführt wird.

Installieren Sie nur den Client für den PandaNpc-Chat und die lokale Desktop-Nutzung. Installieren Sie beide Teile, wenn Sie einen Coding-Agenten erreichen möchten, der auf einem anderen Rechner läuft.

Weitere Informationen darüber, was die Windows-/macOS-/Linux-App über die unten stehenden Installationsschritte hinaus bietet, einschließlich ihrer Versionshistorie, finden Sie unter PandaNpc Desktop.

Wählen Sie aus, was Sie installieren möchten

Den kürzesten End-to-End-Pfad finden Sie im Schnellstart-Handbuch.

PandaNpc-Client installieren

Verwenden Sie die PandaNpc-Downloadseite als maßgebliche Quelle für aktuelle Installationsprogramme. Vermeiden Sie Download-Seiten von Drittanbietern, da diese alte oder modifizierte Pakete anbieten können.

Web

Öffnen Sie pandanpc.com/agent in einem aktuellen Browser. Es wird nichts installiert. Der Browserspeicher speichert den lokalen Anmeldestatus, daher kann es in privaten/Inkognito-Fenstern erforderlich sein, sich erneut anzumelden.

iOS

Folgen Sie dem App-Store-Link auf der Download-Seite und installieren Sie PandaNpc. iOS ist nützlich, um Fortschritte zu prüfen, Fragen zu beantworten und Tools zu genehmigen, während Sie nicht am Host sind. Der Codierungsprozess läuft weiterhin auf dem verbundenen Host-Computer. Informationen zum Leistungsumfang der App einschließlich ihrer Versionshistorie finden Sie unter PandaNpc für iOS.

Windows

1. Laden Sie das aktuelle Windows-Installationsprogramm herunter.
2. Führen Sie es aus und folgen Sie den Anweisungen des Installationsprogramms.
3. Starten Sie PandaNpc über das Startmenü.
4. Wenn Windows eine Herausgeber- oder Reputationswarnung anzeigt, überprüfen Sie, ob die Datei von pandanpc.com stammt, bevor Sie fortfahren.

macOS

1. Laden Sie das macOS-.dmg herunter.
2. Ziehen Sie PandaNpc in Programme.
3. Starten Sie es aus dem Ordner Programme und bestätigen Sie alle macOS-Sicherheitsabfragen.

Der macOS-Build ist universell, sodass dasselbe Paket Apple Silicon und Intel-Macs unterstützt.

Linux

Laden Sie das x86_64-AppImage herunter, machen Sie es ausführbar und führen Sie es aus:

chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Wenn das AppImage nicht startet, führen Sie es einmal über ein Terminal aus und behalten Sie die genaue Fehlerausgabe. Ältere Distributionen vermissen möglicherweise eine Laufzeitbibliothek, die von der Desktop-Shell benötigt wird.

PandaPaw auf dem Agenten-Host installieren

PandaPaw bietet derzeit Host-Installationsprogramme für Windows x64, macOS universal und Linux x86_64. Führen Sie den Befehl auf dem Computer aus, der die Projektdateien besitzt und die Werkzeuge des Agenten ausführen soll.

Der empfohlene Weg ist Verbundene Geräte: Wählen Sie Gerät hinzufügen und kopieren Sie den erzeugten Einmal-Befehl. Dieser verbindet den Host während der Installation mit Ihrem Konto.

macOS oder Linux

Einfaches Installationsprogramm mit Browser-Autorisierung:

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

Formular mit vorbereitetem Einmal-Schlüssel:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Einfaches Installationsprogramm:

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

Formular mit vorbereitetem Einmal-Schlüssel:

$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Die iwr | iex-Pipeline von PowerShell kann keine normalen Skriptargumente übergeben, daher liest das Windows-Installationsprogramm den Einmal-Schlüssel aus PANDANET_KEY.

Was das Host-Installationsprogramm ändert

Das Installationsprogramm:

1. Fügt PandaPaw zum Anwendungs-/Bin-Verzeichnis des aktuellen Benutzers hinzu und aktualisiert bei Bedarf den Benutzer-PATH.
2. Registriert die entsprechenden Hintergrunddienste für den automatischen Start.
3. Installiert unterstützte Coding-Engines, die fehlen, sofern die Plattform dies erlaubt.
4. Stellt eine private Node.js-Laufzeitumgebung bereit, wenn das System keine geeignete Version besitzt.
5. Startet die Kontoautorisierung oder löst den vorbereiteten Geräteschlüssel ein.
6. Zeichnet auf, welche Dateien es erstellt hat, damit die Deinstallation kompatible Tools, die bereits vorhanden waren, erhalten kann.

Die Installation einer Engine kauft oder authentifiziert nicht automatisch ein Modell-Abonnement. Claude Code und Codex können beim ersten Start weiterhin nach ihrem eigenen Anbieter-Login fragen.

Installation überprüfen

Öffnen Sie nach der Installation ein neues Terminal und führen Sie Folgendes aus:

pandapaw status

Öffnen Sie dann PandaNpc Agent. Der Host sollte online erscheinen. Starten Sie eine Sitzung in einem Testprojekt und bitten Sie sie, das aktuelle Arbeitsverzeichnis zu melden, ohne Dateien zu ändern. Dies überprüft die Binärdatei, den Hintergrunddienst, die Konto-Kopplung, die Relay-Verbindung, die Engine und das ausgewählte Verzeichnis – nicht nur den Download-Schritt.

Aktualisierung

Desktop-Clients benachrichtigen Sie, wenn ein Update verfügbar ist. iOS-Updates erfolgen über den App Store.

Aktualisieren Sie PandaPaw und starten Sie die verwalteten Dienste neu mit:

pandapaw update --restart

Das Update-Programm überprüft die heruntergeladene Binärdatei anhand der veröffentlichten SHA-256-Prüfsumme, bevor es die installierte Kopie ersetzt. Ihre Konto-Kopplung und die bestehende Verbindungsidentität bleiben erhalten. Das erneute Ausführen des Installationsbefehls wird ebenfalls unterstützt, wenn das Update-Programm selbst nicht verfügbar ist.

Deinstallation

• Windows-Client: Einstellungen → Apps → Installierte Apps → PandaNpc → Deinstallieren.
• macOS-Client: Beenden Sie PandaNpc und verschieben Sie es dann aus dem Ordner Programme in den Papierkorb.
• Linux-Client: Entfernen Sie das AppImage und alle von Ihnen erstellten Starter.
• PandaPaw-Host: Führen Sie pandapaw uninstall auf dem Host aus.

Das Deinstallationsmanifest von PandaPaw unterscheidet Tools, die das Installationsprogramm erstellt hat, von kompatiblen Tools, die bereits vorhanden waren. Es ist bewusst konservativ und löscht nicht eine bereits bestehende Claude-Code-, Codex-, PandaCode- oder Node-Installation.

Installationsprobleme

Der Befehl wurde abgeschlossen, aber der Host ist nicht verbunden

Führen Sie pandapaw login aus. Eine Host-Installation und eine Kontoautorisierung sind getrennte Schritte, und das Installationsprogramm kann abgeschlossen werden, auch wenn die Browser-Autorisierung aufgeschoben oder unterbrochen wurde.

Die Shell kann `pandapaw` nicht finden

Öffnen Sie ein neues Terminal. Überprüfen Sie unter macOS/Linux ~/.local/bin; unter Windows %LOCALAPPDATA%\Programs\pandapaw. Installieren Sie nicht wiederholt neu, bis Sie bestätigt haben, ob die ausführbare Datei vorhanden ist und nur PATH veraltet ist.

Eine Coding-Engine konnte nicht installiert werden

Das Host-Installationsprogramm setzt optionale Engine-Downloads nur nach besten Kräften um, sodass ein Provider-Ausfall eine funktionierende PandaPaw-Installation nicht entfernt. Installieren oder reparieren Sie diese Engine mit ihrem offiziellen Installationsprogramm, authentifizieren Sie sie normal und führen Sie dann erneut pandapaw status aus.

Das AppImage oder die Desktop-Anwendung lässt sich nicht öffnen

Bestätigen Sie, dass Sie das Paket für die richtige Architektur heruntergeladen haben, und starten Sie es dann über ein Terminal, um den ersten Fehler zu erfassen. Geben Sie diesen Fehler und Ihre OS-Version an, wenn Sie den Support kontaktieren; Screenshots eines geschlossenen Fensters reichen in der Regel nicht aus, um eine fehlende Laufzeitbibliothek zu diagnostizieren.

Für hostspezifische Verbindungsprüfungen lesen Sie den PandaPaw-Leitfaden oder die FAQ.