Installera PandaNpc och PandaPaw

Uppdaterad

En fjärrstyrd kodningsagent-setup har två oberoende delar:

  • PandaNpc-klient — gränssnittet du använder för att läsa sessioner, skicka meddelanden och godkänna verktyg. Den körs på webben, iOS, Windows, macOS och Linux.
  • PandaPaw-värd — bakgrundstjänsten på datorn där Claude Code, Codex eller PandaCode faktiskt körs.

Installera endast klienten för PandaNpc-chatt och lokalt skrivbordsbruk. Installera båda delarna när du vill nå en kodningsagent som körs på en annan dator.

Se PandaNpc-skrivbord för vad Windows/macOS/Linux-appen lägger till utöver installationsstegen nedan, inklusive dess versionshistorik.

Välj vad du vill installera

Scenario Klient PandaPaw-värd
Använda PandaNpc-chatt i en webbläsare Öppna webbappen Krävs inte
Styra en agent på samma skrivbord Skrivbordsapp Beror på valt lokalt/fjärrläge
Styra en utvecklingsmaskin från en telefon eller webbläsare Installera/öppna en klient på visningsenheten Krävs på utvecklingsmaskinen
Köra agenter på en server utan grafiskt skrivbord Webb, skrivbord eller iOS på annan plats Krävs på servern

För den snabbaste vägen från början till slut, använd Snabbstartsguiden.

Installera en PandaNpc-klient

Använd PandaNpcs nedladdningssida som källa för aktuella installationsprogram. Undvik tredjepartsnedladdningssajter eftersom de kan erbjuda gamla eller modifierade paket.

Webb

Öppna pandanpc.com/agent i en aktuell webbläsare. Ingenting installeras. Webbläsarens lagring behåller det lokala inloggningstillståndet, så privata/inkognitofönster kan kräva att du loggar in igen.

iOS

Följ App Store-länken på nedladdningssidan och installera PandaNpc. iOS är användbart för att kontrollera framsteg, svara på frågor och godkänna verktyg när du är borta från värden. Kodningsprocessen körs fortfarande på den anslutna värdmaskinen. Se PandaNpc för iOS för vad appen täcker, inklusive dess versionshistorik.

Windows

  1. Ladda ner det aktuella Windows-installationsprogrammet.
  2. Kör det och följ installationsprogrammets anvisningar.
  3. Starta PandaNpc från Start-menyn.
  4. Om Windows visar en varning om utgivare eller rykte, kontrollera att filen kom från pandanpc.com innan du fortsätter.

macOS

  1. Ladda ner macOS .dmg.
  2. Dra PandaNpc till Program.
  3. Starta den från Program och slutför eventuell macOS-säkerhetsvarning.

macOS-versionen är universell, så samma paket stödjer Apple Silicon och Intel-Macar.

Linux

Ladda ner x86_64 AppImage, gör den körbar och kör den:

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

Om AppImage inte startar, kör den från en terminal en gång och spara den exakta felutskriften. Äldre distributioner kan sakna ett runtime-bibliotek som krävs av skrivbordsskalet.

Installera PandaPaw på agentvärden

PandaPaw tillhandahåller för närvarande värdinstallationsprogram för Windows x64, macOS universal och Linux x86_64. Kör kommandot på datorn som äger projektfilerna och som ska utföra agentens verktyg.

Den rekommenderade vägen är Anslutna enheter: välj Lägg till en enhet och kopiera sedan det genererade engångskommandot. Det parar ihop värden med ditt konto under installationen.

macOS eller Linux

Enkelt installationsprogram med webbläsarauthorisering:

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

Förberedd engångsnyckelform:

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

Windows PowerShell

Enkelt installationsprogram:

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

Förberedd engångsnyckelform:

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

PowerShells iwr | iex-pipeline kan inte skicka vanliga skriptargument, så Windows-installationsprogrammet läser engångsnyckeln från PANDANET_KEY.

Vad värdinstallationsprogrammet ändrar

Installationsprogrammet:

  1. Lägger till PandaPaw i den aktuella användarens applikations-/bin-katalog och uppdaterar användarens PATH vid behov.
  2. Registrerar lämpliga bakgrundstjänster så att de startar automatiskt.
  3. Installerar kodningsmotorer som stöds och saknas när plattformen tillåter det.
  4. Tillhandahåller en privat Node.js-runtime när systemet inte har en lämplig version.
  5. Startar kontoauthorisering eller löser in den förberedda enhetsnyckeln.
  6. Registrerar vilka filer det skapade så att avinstallationen kan bevara kompatibla verktyg som redan fanns.

Att installera en motor köper inte automatiskt eller autentiserar en modellprenumeration. Claude Code och Codex kan fortfarande be om sin egen leverantörsinloggning första gången de körs.

Verifiera installationen

Öppna en ny terminal efter installationen och kör:

bash
pandapaw status

Öppna sedan PandaNpc Agent. Värden bör visas online. Starta en session i ett testprojekt och be den rapportera den aktuella arbetskatalogen utan att ändra filer. Detta verifierar binären, bakgrundstjänsten, kontoparningen, reläanslutningen, motorn och den valda katalogen—inte bara nedladdningssteget.

Uppdatera

Skrivbordsklienter meddelar dig när en uppdatering är tillgänglig. iOS uppdateras via App Store.

Uppdatera PandaPaw och starta om dess hanterade tjänster med:

bash
pandapaw update --restart

Uppdateringsprogrammet verifierar den nedladdade binären mot den publicerade SHA-256-kontrollsumman innan den installerade kopian ersätts. Din kontoparning och befintliga anslutningsidentitet bevaras. Att köra installationskommandot igen stöds också när själva uppdateringsprogrammet inte är tillgängligt.

Avinstallera

  • Windows-klient: Inställningar → Appar → Installerade appar → PandaNpc → Avinstallera.
  • macOS-klient: avsluta PandaNpc och flytta den sedan från Program till papperskorgen.
  • Linux-klient: ta bort AppImage och eventuell startprogram du skapat för den.
  • PandaPaw-värd: kör pandapaw uninstall på värden.

PandaPaws avinstallationsmanifest skiljer mellan verktyg som installationsprogrammet skapade och kompatibla verktyg som redan fanns. Det är medvetet konservativt snarare än att radera en befintlig installation av Claude Code, Codex, PandaCode eller Node.

Installationsproblem

Kommandot avslutades men värden är inte ansluten

Kör pandapaw login. En värdinstallation och en kontoauthorisering är separata steg, och installationsprogrammet kan slutföras även om webbläsarauthoriseringen skjutits upp eller avbrutits.

Skalet hittar inte `pandapaw`

Öppna en ny terminal. På macOS/Linux, kontrollera ~/.local/bin; på Windows, kontrollera %LOCALAPPDATA%\Programs\pandapaw. Installera inte om upprepade gånger innan du har bekräftat om den körbara filen finns och endast PATH är föråldrad.

En kodningsmotor kunde inte installeras

Värdinstallationsprogrammet behandlar valfria motorhämtningar som bästa möjliga ansträngning, så ett avbrott hos en leverantör tar inte bort en fungerande PandaPaw-installation. Installera eller reparera motorn med dess officiella installationsprogram, autentisera den normalt och kör sedan pandapaw status igen.

AppImage eller skrivbordsprogrammet öppnas inte

Bekräfta att du har laddat ner paketet för rätt arkitektur och starta det sedan från en terminal för att fånga det första felet. Inkludera felet och din OS-version när du kontaktar supporten; skärmbilder av ett stängt fönster räcker vanligtvis inte för att diagnostisera ett saknat runtime-bibliotek.

För värdspecifika anslutningskontroller, fortsätt med PandaPaw-guiden eller FAQ.