PandaPaw: externe host voor Claude Code, Codex en PandaCode

PandaPaw verandert een Windows-, macOS- of Linux-machine die jij beheert in een PandaNpc-agenthost. De code-engine, projectbestanden, shell en tools blijven op die host; PandaNpc-clients geven je een gesynchroniseerde interface vanaf een telefoon, browser of een andere desktop.

Gebruik PandaPaw wanneer de machine die het werk doet anders is dan het apparaat dat je vasthoudt, wanneer je een host wilt die clientverbindingsonderbrekingen overleeft, of wanneer meerdere code-engines dezelfde accountgebaseerde setup en Agent Center-configuratie moeten delen.

Wat PandaPaw beheert

• Externe agentverbindingen voor Claude Code, OpenAI Codex en PandaCode.
• Achtergrondservices en automatisch starten, zodat de host na een normale herstart kan terugkeren.
• Op accounts gebaseerde machine-autorisatie zonder handmatig een langlevende Bridge ID, token of ondertekeningssleutel te kopiëren.
• Installatiehulp voor engines wanneer een ondersteunde code-engine ontbreekt.
• Agent Center-projecties die de richtlijnen, vaardigheden, geheugen en agentdefinities van elke engine in zijn eigen lay-out weergeven.
• Privé-apparaatnetwerken voor machines die zijn toegevoegd via de Connected Devices-flow.
• Administratie van updates en verwijderingen, zodat tools die vóór PandaPaw bestonden behouden blijven.

PandaPaw biedt zelf geen modelabonnement. Claude Code, Codex en PandaCode gebruiken nog steeds de providerreferenties en limieten die voor hun engine zijn geconfigureerd.

Hoe externe uitvoering werkt

Beide partijen initiëren uitgaande verbindingen, dus een normale thuis- of kantooropstelling vereist geen inkomende firewallregel, openbaar IP-adres, port forwarding op de router of een openbaar blootgestelde SSH-server. De relay transporteert berichten, status en goedkeuringen; tooluitvoering gebeurt op de host.

Als de host in slaapstand gaat, wordt uitgeschakeld of zijn uitgaande netwerkpad verliest, blijft de opgeslagen verbinding in je account staan, maar kan er geen werk worden uitgevoerd totdat de host terugkeert.

Ondersteunde hostplatforms

De PandaNpc-viewerclient heeft een bredere platformmatrix. Zie PandaNpc en PandaPaw installeren bij het kiezen van client- en hostpakketten.

Aanbevolen installatie

1. Meld je aan bij PandaNpc.
2. Open Connected Devices.
3. Kies Een apparaat toevoegen. Er wordt een eenmalige sleutel uitgegeven en het dialoogvenster toont één opdracht voor het gedetecteerde besturingssysteem.
4. Kopieer die opdracht naar de host en voer deze daar uit.
5. Laat het dialoogvenster open als je wilt dat het de nieuwe machine automatisch detecteert.

De voorbereide sleutel is eenmalig. Kopieer de volledige opdracht, houd deze privé en genereer een nieuwe als deze verloopt of al is gebruikt.

Gewone macOS/Linux-installer

Gebruik dit formulier wanneer je browserautorisatie wilt in plaats van een voorbereide sleutel:

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

Gewone Windows PowerShell-installer

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

De gewone installer voert pandapaw login uit. Keur de machine goed op de browserpagina die wordt geopend. Als de autorisatie wordt onderbroken, kunnen de binary en services nog steeds worden geïnstalleerd; voer later pandapaw login uit om de accountverbinding te voltooien.

De host verifiëren

Controleer eerst de host zelf:

pandapaw status

Open daarna PandaNpc Agent en bevestig dat de machine een groene online-indicator heeft. Start een sessie in een wegwerp- of alleen-lezen testmap en vraag:

Testprompt: Toon de huidige werkmap en vermeld de bestanden op het hoogste niveau. Wijzig niets.

Een succesvol antwoord bewijst meer dan een groen statuslampje: het verifieert de accountkoppeling, relay-connectiviteit, de geselecteerde engine, providerauthenticatie en de toewijzing van de werkmap.

Voer voor een Agent Center-project het volgende uit:

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

Dit toont of het project is gebonden en of beheerde configuratie lokaal beschikbaar is. Een stabiele Git-remote helpt PandaPaw om hetzelfde project op verschillende machines te herkennen.

Accountautorisatie en verbindingsidentiteit

pandapaw login gebruikt een browser-sessie voor apparaatautorisatie. Nadat je deze goedkeurt, ontvangt de host apparaatgebonden referenties en een Agent Center-verificatiesleutel via TLS, schrijft het zijn machineconfiguratie onder ~/.pandapaw/, registreert het de ondersteunde engineverbindingen en bindt het herkenbare Git-projecten.

Voer pandapaw login --force alleen uit wanneer je opzettelijk van account wisselt of een verlopen hostreferentie vervangt. Het opnieuw autoriseren van een gezonde machine zonder reden kan verwarrende dubbele of vervangen identiteiten opleveren.

pandapaw qr maakt nog steeds een kortlevende handmatige verbindingslink voor compatibiliteit en speciale gevallen. Het is niet de primaire flow voor een nieuwe host; Connected Devices is eenvoudiger te controleren en vereist niet dat gebruikers Bridge ID's begrijpen.

Agent Center-synchronisatie

Agent Center is in stabiele toestand gebeurtenisgestuurd:

1. Lokale wijzigingen in beheerde bestanden worden gedetecteerd en gepubliceerd naar het gebonden project.
2. Ondertekende releases arriveren via een gebeurtenisstroom.
3. Ongewijzigde manifests en content-blobs worden hergebruikt in plaats van opnieuw gedownload.
4. Een periodieke herstelcontrole vangt gebeurtenissen op die zijn gemist tijdens een tijdelijke verbindingsonderbreking.

Claude Code, Codex en PandaCode ontvangen afzonderlijke projecties omdat ze verschillende mappen en instructieformaten verwachten. PandaCode bereidt de nieuwste geverifieerde release voor voordat een nieuwe sessieprompt wordt samengesteld, zodat configuratie die bij het opstarten wordt opgehaald dezelfde sessie kan beïnvloeden.

Als Agent Center tijdelijk niet beschikbaar is, gaat de engine verder met de laatst geverifieerde lokale release. Een netwerkstoring mag ondertekende configuratie niet stilzwijgend vervangen door niet-geverifieerde inhoud.

Handige opdrachten

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

Raadpleeg de PandaPaw-versiegeschiedenis wanneer een opdracht of UI afwijkt van een oudere screenshot of tutorial.

Beveiligingsgrenzen

• Een externe operator kan alle tools en de werkmap gebruiken die de geselecteerde agentsessie toestaat. Externe toegang is niet automatisch alleen-lezen.
• Houd eenmalige apparaatopdrachten, handmatige verbindingslinks, providersleutels en accounttokens buiten logs en screenshots.
• Open geen inkomende routerpoorten alleen om PandaPaw bereikbaar te maken.
• Verwijder hosts die je niet langer bezit uit Connected Devices.
• Controleer toolgoedkeuringen en verifieer de werkmap voordat je bewerkingen of shell-opdrachten toestaat.
• Wanneer je een live verbinding deelt, verbruikt de ontvanger het enginequotum van de hosteigenaar en kan op de host handelen. Lees eerst Connection Sharing.

Problemen oplossen

`pandapaw` wordt niet gevonden na installatie

Open een nieuwe terminal zodat deze de gebruikers-PATH opnieuw laadt. De normale locaties zijn ~/.local/bin op macOS/Linux en %LOCALAPPDATA%\Programs\pandapaw op Windows. Bevestig dat het bestand bestaat voordat je de installer opnieuw uitvoert.

Installatie geslaagd, maar er verschijnt geen machine

Voer pandapaw status uit. Als de machine geen accountautorisatie heeft, voer dan pandapaw login uit. Als er een voorbereide eenmalige sleutel is gebruikt, maak dan een nieuwe sleutel in plaats van een verbruikte opdracht opnieuw te proberen.

De machine verschijnt maar blijft offline

Bevestig dat de host actief is en internettoegang heeft. Controleer lokaal de PandaPaw-status. Een bedrijfsproxy of firewall moet het uitgaande HTTPS/WebSocket-pad toestaan; een inkomende poort lost een geblokkeerde uitgaande verbinding niet op.

De host is online, maar Claude Code of Codex antwoordt niet

Het koppelen van de host authenticeert niet elke modelprovider. Open de engine lokaal of volg de loginprompt die in de externe sessie wordt getoond. Bevestig ook dat het geselecteerde model voor dat account bestaat en dat de gebruikslimiet niet is bereikt.

De sessie opent in het verkeerde project

Beëindig de test, selecteer de beoogde absolute werkmap en vraag de agent om deze te tonen voordat je tools goedkeurt. PandaPaw raadt niet welk repository je bedoelt en voegt geen bestandssysteem-sandbox toe naast het eigen machtigingsmodel van de engine.

Agent Center-wijzigingen verschijnen niet

Voer pandapaw agent status --root /path/to/project uit vanuit de juiste Git-root. Bevestig dat het project is gebonden, de host is aangemeld en het lokale bestand deel uitmaakt van een beheerde projectie. Houd de laatst geverifieerde release op zijn plaats tijdens het onderzoeken in plaats van beheerde mappen te verwijderen.

Update en verwijderen

pandapaw update --restart downloadt de huidige binary, verifieert de SHA-256-checksum, vervangt de geïnstalleerde kopie en herstart de beheerde services zodat de versie actief wordt. De bestaande accountkoppeling blijft behouden.

pandapaw uninstall gebruikt het installatiemanifest om items te verwijderen die PandaPaw heeft gemaakt. Compatibele Claude Code-, Codex-, PandaCode- of Node-installaties die al aanwezig waren, worden bewust behouden. Verwijder na het verwijderen de host uit Connected Devices als deze niet langer vertrouwd moet worden.