PandaNpc Work snelstart: verbind je eerste agent

Begin met het gebruik van PandaNpc Work, de AI-werkruimte met meerdere engines. Verbind een computer met PandaPaw, kies een agent-engine en controleer een sessie op afstand.

Bijgewerkt

Deze handleiding verbindt één computer met PandaNpc Work en controleert of je Claude Code, Codex of PandaCode vanaf een ander apparaat kunt uitvoeren. PandaNpc Work is de multi-engine AI-werkruimte waar je werk delegeert en het op al je apparaten volgt. De agent wordt nog steeds uitgevoerd op de verbonden computer; PandaPaw biedt de brug en lokale runtime, terwijl PandaNpc Work je een gesynchroniseerde interface geeft voor berichten, goedkeuringen, vragen en sessiegeschiedenis.

Deze route is het beste voor mensen die al vertrouwd zijn met Claude Code, Codex of een vergelijkbare codeeragent. De meeste mensen kunnen het beste de Een apparaat toevoegen-flow gebruiken, omdat deze een eenmalig installatiecommando genereert dat al aan hun account is gekoppeld. Reken op ongeveer vijf minuten, plus eventuele aanmelding bij de modelprovider die je codeerengine vereist. Om de Agent-interface te verkennen voordat je een computer verbindt, open je PandaNpc Agent in een browser.

Voordat je begint

Je hebt nodig:

  • Een PandaNpc-account dat is geopend in de webapp, desktopapp of iOS-app.
  • Een verbonden computer met Windows x64, macOS of Linux x86_64.
  • Internettoegang vanaf de host en toestemming om een achtergrondservice op gebruikersniveau te installeren.
  • Een projectmap die je mag wijzigen.
  • Een account voor Claude, ChatGPT/Codex of een aangepast model als je gekozen engine nog niet is geauthenticeerd.

Als je alleen een al verbonden host wilt bekijken, installeer of open dan een client op je weergaveapparaat. PandaPaw hoort op de computer waarop de agent draait. Zie Installatie voor de client- en hostrollen.

1. Genereer het installatiecommando voor de host

Open terwijl je bent aangemeld Verbonden apparaten en kies Een apparaat toevoegen. PandaNpc maakt een eenmalige apparaatsleutel aan en toont het exacte commando voor je besturingssysteem.

Kopieer dat commando naar de machine waarop de codeeragent moet draaien. Behandel het als een wachtwoord totdat het is gebruikt: een eenmalige sleutel koppelt één machine en mag niet in chat, screenshots, issues of exports van shellgeschiedenis worden geplaatst.

Als je de voorkeur geeft aan browserautorisatie in plaats van een voorbereide sleutel, gebruik dan de gewone installer in de volgende stap. Deze voert pandapaw login uit en opent de autorisatiepagina voor je.

2. Installeer PandaPaw op de host

macOS of Linux

Voer het voorbereide commando uit vanuit Verbonden apparaten, of gebruik de gewone installer:

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

Windows PowerShell

Voer het voorbereide commando uit vanuit Verbonden apparaten, of gebruik:

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

De installer voegt PandaPaw en de bijbehorende achtergrondservices toe, installeert waar mogelijk ontbrekende ondersteunde codeerengines en biedt een privé-Node.js-runtime wanneer de host er geen geschikte heeft. Met een voorbereide apparaatsleutel vindt accountkoppeling plaats tijdens de installatie. Met het gewone commando keur je het browserautorisatieverzoek goed wanneer daarom wordt gevraagd.

De installer kan voltooien, zelfs wanneer accountautorisatie is uitgesteld. Als er staat dat de installatie is geslaagd maar de accountverbinding onvolledig is, voer dan uit:

bash
pandapaw login

3. Controleer de hostservices

Voer op de host uit:

bash
pandapaw status

Het commando zou de geïnstalleerde services moeten herkennen en de met het account verbonden machine moeten tonen. Als de shell pandapaw niet kan vinden, open dan eerst een nieuwe terminal zodat deze de bijgewerkte gebruikers-PATH opnieuw laadt.

Voor een Git-project kun je ook controleren of Agent Center de projectroot herkent:

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

Gebruik een echt absoluut projectpad. Projectbinding van Agent Center werkt het beste wanneer de map een stabiele Git remote.origin.url heeft.

4. Start de eerste externe sessie

  1. Open PandaNpc Agent op je telefoon, browser of een andere desktop.
  2. Zoek de nieuw verbonden machine. Een groene statusindicator betekent dat de host momenteel bereikbaar is.
  3. Kies Claude Code, Codex of PandaCode en selecteer de werkmap van het project.
  4. Start een sessie. Als de engine je vraagt om je aan te melden, voltooi dan de autorisatie van die provider op de host of via de getoonde loginflow.
  5. Stuur een niet-destructieve testprompt zoals: Show the current working directory and list the top-level files. Do not edit anything.

Je bent volledig verbonden wanneer het antwoord de verwachte projectmap noemt, de bestandslijst overeenkomt met de host en er een toestemmingsvraag op de externe client verschijnt die je kunt goedkeuren of weigeren.

5. Bevestig het herverbindingsgedrag

Sluit de weergaveclient, wacht een paar seconden en open dezelfde sessie opnieuw. De bestaande geschiedenis zou moeten terugkeren en de host zou online moeten blijven. Dit controleert het daadwerkelijke externe pad in plaats van alleen te bewijzen dat de installer succesvol is gedownload.

Zet de host tijdens deze test niet in slaapstand. Een host in slaapstand of een uitgeschakelde host kan de agent niet uitvoeren, zelfs niet als de opgeslagen verbinding nog steeds in je account verschijnt.

Probleemoplossing

De machine verschijnt niet in Agent

Voer pandapaw status uit op de host. Als de installatie is geslaagd maar er geen account is gekoppeld, voer dan pandapaw login uit. Als je een voorbereide sleutel hebt gebruikt en deze al is ingewisseld of verlopen, genereer dan een nieuwe in Verbonden apparaten en voer het getoonde commando opnieuw uit.

`pandapaw` wordt niet herkend

Open een nieuwe terminal. Controleer op macOS/Linux of ~/.local/bin in PATH staat. Op Windows voegt de installer %LOCALAPPDATA%\Programs\pandapaw toe aan de gebruikers-PATH; een terminal die vóór de installatie is geopend, ziet de nieuwe waarde niet.

De machine staat in de lijst maar is offline

Controleer of de host is ingeschakeld, wakker is en internet kan bereiken. Controleer daarna pandapaw status. Bedrijfsfirewalls moeten uitgaand HTTPS/WebSocket-verkeer toestaan; je moet geen inkomende port-forwardingregel aanmaken.

De verbinding werkt, maar de engine vraagt om authenticatie

PandaPaw-koppeling en aanmelding bij de modelprovider staan los van elkaar. Koppeling bewijst dat de host bij je PandaNpc-account hoort; Claude Code of Codex kan nog steeds een eigen abonnementsaanmelding of API-configuratie vereisen. Voltooi de normale aanmelding van de engine en probeer de sessie daarna opnieuw.

De agent opent in de verkeerde map

Beëindig die testsessie en maak een nieuwe met de beoogde werkmap. Vraag de agent om de huidige map af te drukken voordat je toolgebruik goedkeurt. Een externe verbinding voegt op zichzelf geen bestandssysteem-sandbox toe; de toolmachtigingen van de engine en de geselecteerde werkmap blijven belangrijk.

Volgende stappen

  • Lees de volledige PandaPaw hostgids voor updates, servicecontroles en verbindingsarchitectuur.
  • Bekijk Account en facturering om te begrijpen welk abonnement of welke provider voor elke sessie betaalt.
  • Voeg aangepaste AI-providers toe wanneer je een OpenAI-compatibel endpoint, een zelfgehost model of een aparte API Key wilt.