Installer PandaNpc og PandaPaw

Opdateret

En fjernopsætning med en kodningsagent består af to uafhængige dele:

  • PandaNpc-klient — den grænseflade, du bruger til at læse sessioner, sende prompter og godkende værktøjer. Den kører på nettet, iOS, Windows, macOS og Linux.
  • PandaPaw-vært — den baggrundstjeneste på den computer, hvor Claude Code, Codex eller PandaCode rent faktisk kører.

Installér kun klienten til PandaNpc-chat og lokal skrivebordsbrug. Installér begge dele, når du vil nå en kodningsagent, der kører på en anden maskine.

Se PandaNpc Desktop for, hvad Windows/macOS/Linux-appen tilføjer ud over installationstrinene nedenfor, inklusive dens udgivelseshistorik.

Vælg, hvad du vil installere

Scenarie Klient PandaPaw-vært
Brug PandaNpc-chat i en browser Åbn webappen Ikke påkrævet
Styr en agent på denne samme skrivebord Skrivebordsapp Afhænger af den valgte lokal/fjern-tilstand
Styr en udviklingsmaskine fra en telefon eller browser Installér/åbn en klient på visningsenheden Påkrævet på udviklingsmaskinen
Kør agenter på en server uden grafisk skrivebord Web, skrivebord eller iOS et andet sted Påkrævet på serveren

Få den hurtigste ende-til-ende-vej ved at bruge Hurtig start-guiden.

Installér en PandaNpc-klient

Brug PandaNpc-downloadsiden som den autoritative kilde til aktuelle installatører. Undgå tredjepartsdownloadsider, da de kan levere gamle eller ændrede pakker.

Web

Åbn pandanpc.com/agent i en aktuel browser. Intet installeres. Browserens opbevaring gemmer den lokale loginstatus, så private/inkognitovinduer kan kræve, at du logger ind igen.

iOS

Følg App Store-linket på downloadsiden, og installér PandaNpc. iOS er nyttigt til at tjekke fremskridt, besvare spørgsmål og godkende værktøjer, mens du er væk fra værten. Kodningsprocessen kører stadig på den tilsluttede værtmaskine. Se PandaNpc til iOS for, hvad appen dækker, inklusive dens udgivelseshistorik.

Windows

  1. Download den aktuelle Windows-installatør.
  2. Kør den, og følg installatørens anvisninger.
  3. Start PandaNpc fra Start-menuen.
  4. Hvis Windows viser en udgiver- eller omdømmeadvarsel, skal du bekræfte, at filen kommer fra pandanpc.com, før du fortsætter.

macOS

  1. Download macOS-.dmg-filen.
  2. Træk PandaNpc ind i Programmer.
  3. Start den fra Programmer, og gennemfør eventuel macOS-sikkerhedsanmodning.

macOS-versionen er universel, så den samme pakke understøtter Apple Silicon og Intel-Mac'er.

Linux

Download x86_64-AppImage'en, gør den eksekverbar, og kør den:

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

Hvis AppImage'en ikke starter, så kør den fra en terminal én gang, og behold den nøjagtige fejlbesked. Ældre distributioner kan mangle et runtime-bibliotek, som skrivebordsskallet kræver.

Installér PandaPaw på agentværten

PandaPaw tilbyder i øjeblikket værtinstallatører til Windows x64, macOS universal og Linux x86_64. Kør kommandoen på den computer, der ejer projektfilerne, og som skal udføre agentens værktøjer.

Den anbefalede vej er Tilsluttede enheder: vælg Tilføj en enhed, og kopiér derefter den genererede engangskommando. Den parrer værten med din konto under installationen.

macOS eller Linux

Almindelig installatør med browserautorisation:

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

Variant med forberedt engangsnøgle:

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

Windows PowerShell

Almindelig installatør:

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

Variant med forberedt engangsnøgle:

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

PowerShells iwr | iex-pipeline kan ikke overføre normale scriptargumenter, så Windows-installatøren læser engangsnøglen fra PANDANET_KEY.

Hvad værtinstallatøren ændrer

Installatøren:

  1. Tilføjer PandaPaw til den aktuelle brugers applikations-/bin-mappe og opdaterer brugerens PATH, når det er nødvendigt.
  2. Registrerer de relevante baggrundstjenester til automatisk start.
  3. Installerer understøttede kodningsmotorer, der mangler, når platformen tillader det.
  4. Leverer en privat Node.js-runtime, når systemet ikke har en passende version.
  5. Starter kontoauthorisering eller indløser den forberedte enhedsnøgle.
  6. Registrerer, hvilke filer den har oprettet, så afinstallation kan bevare kompatible værktøjer, der allerede fandtes.

Installation af en motor køber eller autentificerer ikke automatisk et modelabonnement. Claude Code og Codex kan stadig bede om deres egen udbyderlogin første gang, de kører.

Bekræft installationen

Åbn en ny terminal efter installationen, og kør:

bash
pandapaw status

Åbn derefter PandaNpc Agent. Værten skulle gerne fremstå online. Start en session i et testprojekt, og bed den om at rapportere den aktuelle arbejdsmappe uden at ændre filer. Dette bekræfter den binære fil, baggrundstjenesten, kontoparingen, relæforbindelsen, motoren og den valgte mappe – ikke kun downloadtrinnet.

Opdatering

Skrivebordsklienter giver dig besked, når der er en opdatering tilgængelig. iOS opdateres via App Store.

Opdatér PandaPaw, og genstart dets administrerede tjenester med:

bash
pandapaw update --restart

Opdateringsprogrammet verificerer den downloadede binære fil mod den offentliggjorte SHA-256-checksum, før den erstatter den installerede kopi. Din kontoparing og eksisterende forbindelsesidentitet bevares. Det understøttes også at køre installationskommandoen igen, hvis selve opdateringsprogrammet ikke er tilgængeligt.

Afinstallation

  • Windows-klient: Indstillinger → Apps → Installerede apps → PandaNpc → Afinstallér.
  • macOS-klient: Afslut PandaNpc, og flyt den derefter fra Programmer til Papirkurven.
  • Linux-klient: Fjern AppImage'en og eventuel launcher, du har oprettet til den.
  • PandaPaw-vært: Kør pandapaw uninstall på værten.

PandaPaws afinstallationsmanifest adskiller værktøjer, som installatøren oprettede, fra kompatible værktøjer, der allerede fandtes. Det er bevidst konservativt og sletter ikke en eksisterende Claude Code-, Codex-, PandaCode- eller Node-installation.

Installationsproblemer

Kommandoen blev fuldført, men værten er ikke forbundet

Kør pandapaw login. En værtinstallation og en kontoauthorisering er separate faser, og installatøren kan fuldføres, selvom browserautorisationen blev udskudt eller afbrudt.

Skallen kan ikke finde `pandapaw`

Åbn en ny terminal. På macOS/Linux skal du tjekke ~/.local/bin; på Windows skal du tjekke %LOCALAPPDATA%\Programs\pandapaw. Installér ikke gentagne gange, før du har bekræftet, om den eksekverbare fil findes, og at kun PATH er forældet.

En kodningsmotor kunne ikke installeres

Værtinstallatøren behandler valgfrie motor-downloads som bedste indsats, så en udbyders udfald ikke fjerner en fungerende PandaPaw-installation. Installér eller reparér den pågældende motor med dens officielle installatør, autentificér den normalt, og kør derefter pandapaw status igen.

AppImage'en eller skrivebordsapplikationen åbner ikke

Bekræft, at du har downloadet pakken til den korrekte arkitektur, og start den derefter fra en terminal for at fange den første fejl. Inkludér denne fejl og din OS-version, når du kontakter support; skærmbilleder af et lukket vindue er normalt ikke nok til at diagnosticere et manglende runtime-bibliotek.

For værtsspecifikke forbindelsestjek kan du fortsætte med PandaPaw-guiden eller FAQ'en.