Snelstart: Claude Code of Codex op afstand uitvoeren

Bijgewerkt

Deze handleiding verbindt één ontwikkelmachine met PandaNpc en controleert dat je Claude Code, Codex of PandaCode vanaf een ander apparaat kunt uitvoeren. De agent draait nog steeds op je ontwikkelmachine; PandaNpc geeft je een gesynchroniseerde externe interface voor berichten, goedkeuringen, vragen en sessiegeschiedenis.

De meeste mensen moeten de Apparaat toevoegen-flow gebruiken, omdat deze een eenmalige installatieopdracht genereert die al aan hun account is gekoppeld. Reken op ongeveer vijf minuten, plus eventuele aanmelding bij de modelprovider die je codeerengine vereist.

Voordat je begint

Je hebt nodig:

  • Een PandaNpc-account geopend in de webapp, desktop-app of iOS-app.
  • Een host 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 geverifieerd.

Als je alleen de ingebouwde chat van PandaNpc nodig hebt en geen agent op een andere machine wilt bedienen, is PandaPaw niet vereist. Zie Installatie voor de opties die alleen voor de client zijn.

1. Genereer de host-installatieopdracht

Open, terwijl je bent aangemeld, Verbonden apparaten en kies Apparaat toevoegen. PandaNpc maakt een eenmalige apparaatsleutel en toont de exacte opdracht voor jouw besturingssysteem.

Kopieer die opdracht naar de machine waar de codeeragent moet draaien. Behandel het als een wachtwoord totdat het is gebruikt: een eenmalige sleutel koppelt één machine en mag niet worden geplaatst in chat, screenshots, issues of shellgeschiedenis-exporten.

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. PandaPaw installeren op de host

macOS of Linux

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

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

Windows PowerShell

Voer de voorbereide opdracht 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 indien mogelijk ontbrekende ondersteunde codeerengines en biedt een privé Node.js-runtime wanneer de host geen geschikte heeft. Met een voorbereide apparaatsleutel vindt accountkoppeling plaats tijdens de installatie. Bij de gewone opdracht keur je het browserautorisatieverzoek goed wanneer dat wordt gevraagd.

De installer kan worden afgerond, zelfs als accountautorisatie wordt 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

De opdracht moet de geïnstalleerde services herkennen en de aan het account gekoppelde machine 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 projectmap herkent:

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

Gebruik een echt absoluut projectpad. Agent Center-projectbinding 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 projectwerkmap.
  4. Start een sessie. Als de engine vraagt om in te loggen, voltooi dan de autorisatie van die provider op de host of via de weergegeven aanmeldingsflow.
  5. Stuur een niet-destructieve testprompt, bijvoorbeeld: 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 eventuele toestemmingsvragen op de externe client verschijnen om goed te keuren of te weigeren.

5. Bevestig het gedrag bij opnieuw verbinden

Sluit de client waarmee je kijkt, wacht een paar seconden en open dezelfde sessie opnieuw. De bestaande geschiedenis moet terugkeren en de host moet online blijven. Hiermee controleer je het daadwerkelijke externe pad in plaats van alleen aan te tonen dat de installer succesvol is gedownload.

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

Problemen oplossen

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 gebruikt of verlopen, genereer dan een nieuwe in Verbonden apparaten en voer de weergegeven opdracht opnieuw uit.

`pandapaw` wordt niet herkend

Open een nieuwe terminal. Controleer op macOS/Linux dat ~/.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 wordt vermeld maar is offline

Bevestig dat de host is ingeschakeld, niet slaapt en toegang heeft tot internet. Controleer vervolgens pandapaw status. Bedrijfsfirewalls moeten uitgaand HTTPS/WebSocket-verkeer toestaan; je moet geen binnenkomende port-forwardingregel maken.

De verbinding werkt, maar de engine vraagt om authenticatie

PandaPaw-koppeling en modelprovider-login zijn gescheiden. Koppeling bewijst dat de host bij je PandaNpc-account hoort; Claude Code of Codex vereist mogelijk nog steeds een eigen abonnementslogin of API-configuratie. Voltooi de normale aanmelding van de engine en probeer de sessie opnieuw.

De agent opent in de verkeerde map

Beëindig die testsessie en maak een sessie met de beoogde werkmap. Vraag de agent om de huidige map weer te geven 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