PandaNpc en PandaPaw installeren

Bijgewerkt

Een opstelling met een externe code-agent heeft twee onafhankelijke onderdelen:

  • PandaNpc-client — de interface waarmee je sessies leest, prompts verstuurt en tools goedkeurt. Het draait op het web, iOS, Windows, macOS en Linux.
  • PandaPaw-host — de achtergrondservice op de computer waar Claude Code, Codex of PandaCode daadwerkelijk wordt uitgevoerd.

Installeer alleen de client voor PandaNpc-chat en lokaal desktopgebruik. Installeer beide onderdelen als je een code-agent wilt bereiken die op een andere machine draait.

Zie PandaNpc Desktop voor wat de Windows/macOS/Linux-app toevoegt naast de onderstaande installatiestappen, inclusief de releasegeschiedenis.

Kies wat je installeert

Scenario Client PandaPaw-host
PandaNpc-chat in een browser gebruiken Open de webapp Niet vereist
Een agent op dezelfde desktop bedienen Desktop-app Afhankelijk van de gekozen lokale/externe modus
Een ontwikkelmachine bedienen vanaf een telefoon of browser Installeer/open een client op het bekijkapparaat Vereist op de ontwikkelmachine
Agents draaien op een server zonder grafische desktop Web, desktop of iOS elders Vereist op de server

Voor het kortste end-to-end traject gebruik je de Snelstartgids.

Een PandaNpc-client installeren

Gebruik de PandaNpc-downloadpagina als bron van waarheid voor actuele installatieprogramma's. Vermijd downloadwebsites van derden, omdat ze oude of aangepaste pakketten kunnen aanbieden.

Web

Open pandanpc.com/agent in een actuele browser. Er wordt niets geïnstalleerd. Browseropslag bewaart de lokale aanmeldstatus, dus privé-/incognitovensters kunnen je opnieuw laten aanmelden.

iOS

Volg de App Store-link op de downloadpagina en installeer PandaNpc. iOS is handig om de voortgang te controleren, vragen te beantwoorden en tools goed te keuren terwijl je niet bij de host bent. Het programmeerproces draait nog steeds op de verbonden hostmachine. Zie PandaNpc voor iOS voor wat de app dekt, inclusief de releasegeschiedenis.

Windows

  1. Download de actuele Windows-installatieprogramma.
  2. Voer het uit en volg de aanwijzingen van het installatieprogramma.
  3. Start PandaNpc vanuit het Startmenu.
  4. Als Windows een uitgevers- of reputatiewaarschuwing toont, controleer dan of het bestand afkomstig is van pandanpc.com voordat je doorgaat.

macOS

  1. Download de macOS .dmg.
  2. Sleep PandaNpc naar Programma's.
  3. Start het vanuit Programma's en doorloop eventuele macOS-beveiligingsprompts.

De macOS-build is universeel, dus hetzelfde pakket ondersteunt Apple Silicon en Intel-Macs.

Linux

Download de x86_64 AppImage, maak het uitvoerbaar en voer het uit:

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

Als de AppImage niet start, voer het dan eenmalig uit vanuit een terminal en bewaar de exacte foutuitvoer. Oudere distributies missen mogelijk een runtimebibliotheek die vereist is voor de desktop-shell.

PandaPaw installeren op de agenthost

PandaPaw biedt momenteel host-installatieprogramma's voor Windows x64, macOS universeel en Linux x86_64. Voer de opdracht uit op de computer die de projectbestanden bevat en de tools van de agent moet uitvoeren.

De aanbevolen route is Connected Devices: kies Apparaat toevoegen en kopieer de gegenereerde eenmalige opdracht. Deze koppelt de host tijdens de installatie aan je account.

macOS of Linux

Gewone installatie met browserautorisatie:

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

Voorbereide vorm met eenmalige sleutel:

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

Windows PowerShell

Gewoon installatieprogramma:

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

Voorbereide vorm met eenmalige sleutel:

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

De iwr | iex-pipeline van PowerShell kan geen normale scriptargumenten doorgeven, dus leest het Windows-installatieprogramma de eenmalige sleutel uit PANDANET_KEY.

Wat het host-installatieprogramma wijzigt

Het installatieprogramma:

  1. Voegt PandaPaw toe aan de application/bin-directory van de huidige gebruiker en werkt de PATH van de gebruiker bij wanneer nodig.
  2. Registreert de juiste achtergrondservices om automatisch te starten.
  3. Installeert ondersteunde code-engines die ontbreken wanneer het platform dit toestaat.
  4. Levert een privé Node.js-runtime wanneer het systeem geen geschikte versie heeft.
  5. Start accountautorisatie of wisselt de voorbereide apparaatsleutel in.
  6. Legt vast welke bestanden het heeft gemaakt, zodat verwijderen compatibele tools die al aanwezig waren, kan behouden.

Het installeren van een engine koopt of authenticeert niet automatisch een modelabonnement. Claude Code en Codex kunnen de eerste keer dat ze worden uitgevoerd nog steeds om hun eigen providerlogin vragen.

Verifieer de installatie

Open na de installatie een nieuwe terminal en voer uit:

bash
pandapaw status

Open daarna PandaNpc Agent. De host zou online moeten verschijnen. Start een sessie in een testproject en vraag om de huidige werkdirectory te rapporteren zonder bestanden te wijzigen. Dit verifieert het binaire bestand, de achtergrondservice, accountkoppeling, relayverbinding, engine en de geselecteerde directory—niet alleen de downloadstap.

Updaten

Desktopclients melden je wanneer er een update beschikbaar is. iOS-updates verlopen via de App Store.

Update PandaPaw en herstart de beheerde services met:

bash
pandapaw update --restart

De updater verifieert het gedownloade binaire bestand aan de hand van de gepubliceerde SHA-256-controlesom voordat de geïnstalleerde kopie wordt vervangen. Je accountkoppeling en bestaande verbindingsidentiteit blijven behouden. Het opnieuw uitvoeren van de installatieopdracht wordt ook ondersteund wanneer de updater zelf niet beschikbaar is.

Verwijderen

  • Windows-client: Instellingen → Apps → Geïnstalleerde apps → PandaNpc → Verwijderen.
  • macOS-client: sluit PandaNpc af en verplaats het daarna van Programma's naar de Prullenmand.
  • Linux-client: verwijder de AppImage en een eventuele launcher die je ervoor hebt gemaakt.
  • PandaPaw-host: voer pandapaw uninstall uit op de host.

Het verwijderingsmanifest van PandaPaw onderscheidt tools die het installatieprogramma heeft gemaakt van compatibele tools die al bestonden. Het is bewust conservatief in plaats van een bestaande Claude Code-, Codex-, PandaCode- of Node-installatie te verwijderen.

Installatieproblemen

De opdracht is voltooid maar de host is niet verbonden

Voer pandapaw login uit. Een hostinstallatie en een accountautorisatie zijn afzonderlijke fasen, en het installatieprogramma kan worden voltooid, zelfs als browserautorisatie is uitgesteld of onderbroken.

De shell kan `pandapaw` niet vinden

Open een nieuwe terminal. Controleer op macOS/Linux ~/.local/bin; op Windows controleer je %LOCALAPPDATA%\Programs\pandapaw. Herhaal de installatie niet voordat je hebt bevestigd of het uitvoerbare bestand bestaat en alleen PATH verouderd is.

Een code-engine is niet geïnstalleerd

Het host-installatieprogramma behandelt optionele engine-downloads als best effort, zodat een storing bij één provider een werkende PandaPaw-installatie niet beschadigt. Installeer of repareer die engine met de officiële installer, authenticeer deze normaal en voer daarna opnieuw pandapaw status uit.

De AppImage of desktopapplicatie wil niet openen

Bevestig dat je het pakket voor de juiste architectuur hebt gedownload en start het daarna vanuit een terminal om de eerste fout vast te leggen. Vermeld die fout en je OS-versie bij contact met ondersteuning; screenshots van een gesloten venster zijn meestal niet genoeg om een ontbrekende runtimebibliotheek te diagnosticeren.

Ga voor hostspecifieke verbindingscontroles verder met de PandaPaw-gids of de FAQ.