Installere PandaNpc og PandaPaw

Oppdatert

Et oppsett for ekstern kodeagent har to uavhengige deler:

  • PandaNpc-klienten — grensesnittet du bruker for å lese økter, sende ledetekster og godkjenne verktøy. Den kjører på nettet, iOS, Windows, macOS og Linux.
  • PandaPaw-verten — bakgrunnstjenesten på datamaskinen der Claude Code, Codex eller PandaCode faktisk kjører.

Installer kun klienten for PandaNpc-chat og lokal desktop-bruk. Installer begge deler når du vil nå en kodeagent som kjører på en annen maskin.

Se PandaNpc Desktop for hva Windows/macOS/Linux-appen tilbyr utover installasjonstrinnene nedenfor, inkludert utgivelseshistorikken.

Velg hva du skal installere

Scenario Klient PandaPaw-vert
Bruk PandaNpc-chat i en nettleser Åpne nettappen Ikke nødvendig
Kontroller en agent på denne samme datamaskinen Desktop-app Avhenger av valgt lokal/fjern-modus
Kontroller en utviklingsmaskin fra en telefon eller nettleser Installer/åpne en klient på enheten du bruker Nødvendig på utviklingsmaskinen
Kjør agenter på en server uten grafisk skrivebord Nett, desktop eller iOS et annet sted Nødvendig på serveren

For den raskeste veien fra start til mål, bruk hurtigstartguiden.

Installere en PandaNpc-klient

Bruk PandaNpc-nedlastingssiden som den autoritative kilden for gjeldende installasjonsprogrammer. Unngå tredjeparts nedlastingssider, da de kan tilby gamle eller modifiserte pakker.

Nett

Åpne pandanpc.com/agent i en oppdatert nettleser. Ingenting installeres. Nettleserlagring beholder den lokale påloggingsstatusen, så private/inkognitovinduer kan kreve at du logger på igjen.

iOS

Følg App Store-lenken på nedlastingssiden og installer PandaNpc. iOS er nyttig for å sjekke fremdrift, svare på spørsmål og godkjenne verktøy mens du er borte fra verten. Kodeprosessen kjører fortsatt på den tilkoblede vertsmaskinen. Se PandaNpc for iOS for hva appen dekker, inkludert utgivelseshistorikken.

Windows

  1. Last ned gjeldende Windows-installasjonsprogram.
  2. Kjør det og følg instruksjonene i installasjonsprogrammet.
  3. Start PandaNpc fra Start-menyen.
  4. Hvis Windows viser en advarsel om utgiver eller omdømme, bekreft at filen kommer fra pandanpc.com før du fortsetter.

macOS

  1. Last ned macOS .dmg-filen.
  2. Dra PandaNpc inn i Programmer.
  3. Start den fra Programmer og bekreft eventuelle macOS-sikkerhetsdialoger.

macOS-bygget er universelt, så den samme pakken støtter Apple Silicon og Intel-Mac-er.

Linux

Last ned x86_64 AppImage, gjør den kjørbar og kjør den:

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

Hvis AppImage ikke starter, kjør den fra en terminal én gang og behold den eksakte feilmeldingen. Eldre distribusjoner kan mangle et kjøretidsbibliotek som skrivebordsskallet krever.

Installere PandaPaw på agentverten

PandaPaw tilbyr for tiden vertsinstallasjonsprogrammer for Windows x64, macOS universell og Linux x86_64. Kjør kommandoen på datamaskinen som eier prosjektfilene og som skal utføre agentens verktøy.

Anbefalt vei er Tilkoblede enheter: velg Legg til en enhet, og kopier den genererte engangskommandoen. Den kobler verten til kontoen din under installasjonen.

macOS eller Linux

Vanlig installasjonsprogram med nettleserautorisasjon:

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

Klargjort engangsnøkkel-skjema:

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

Windows PowerShell

Vanlig installasjonsprogram:

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

Klargjort engangsnøkkel-skjema:

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

PowerShells iwr | iex-rørledning kan ikke overføre vanlige skriptargumenter, så Windows-installasjonsprogrammet leser engangsnøkkelen fra PANDANET_KEY.

Hva vertsinstallasjonsprogrammet endrer

Installasjonsprogrammet:

  1. Legger til PandaPaw i gjeldende brukers applikasjons-/bin-katalog og oppdaterer brukerens PATH ved behov.
  2. Registrerer de aktuelle bakgrunnstjenestene slik at de starter automatisk.
  3. Installerer støttede kodemotorer som mangler, når plattformen tillater det.
  4. Leverer en privat Node.js-kjøretid hvis systemet ikke har en passende versjon.
  5. Starter kontoautorisasjon eller løser inn den klargjorte enhetsnøkkelen.
  6. Registrerer hvilke filer det opprettet, slik at avinstallering kan bevare kompatible verktøy som allerede fantes.

Installasjon av en motor kjøper eller autentiserer ikke automatisk et modellabonnement. Claude Code og Codex kan fortsatt be om sin egen leverandørpålogging første gang de kjøres.

Bekreft installasjonen

Åpne en ny terminal etter installasjonen og kjør:

bash
pandapaw status

Åpne deretter PandaNpc Agent. Vertsmaskinen skal vises som online. Start en økt i et testprosjekt og be den rapportere gjeldende arbeidskatalog uten å endre filer. Dette bekrefter binærfilen, bakgrunnstjenesten, kontoparingen, relékoblingen, motoren og den valgte katalogen – ikke bare nedlastingssteget.

Oppdatering

Desktop-klientene varsler deg når en oppdatering er tilgjengelig. iOS oppdateres gjennom App Store.

Oppdater PandaPaw og start de administrerte tjenestene på nytt med:

bash
pandapaw update --restart

Oppdateringsprogrammet verifiserer den nedlastede binærfilen mot den publiserte SHA-256-sjekksummen før den erstatter den installerte kopien. Kontoparingen og eksisterende tilkoblingsidentitet bevares. Å kjøre installasjonskommandoen på nytt støttes også hvis selve oppdateringsprogrammet ikke er tilgjengelig.

Avinstallering

  • Windows-klient: Innstillinger → Apper → Installerte apper → PandaNpc → Avinstaller.
  • macOS-klient: avslutt PandaNpc, og flytt den deretter fra Programmer til Papirkurven.
  • Linux-klient: fjern AppImage-filen og eventuelle oppstartssnarveier du har opprettet for den.
  • PandaPaw-vert: kjør pandapaw uninstall på verten.

PandaPaws avinstallasjonsmanifest skiller mellom verktøy som installasjonsprogrammet opprettet, og kompatible verktøy som allerede fantes. Det er bevisst konservativt og sletter ikke en eksisterende Claude Code-, Codex-, PandaCode- eller Node-installasjon.

Installasjonsproblemer

Kommandoen ble fullført, men verten er ikke tilkoblet

Kjør pandapaw login. En vertsinstallasjon og en kontoautorisasjon er separate faser, og installasjonsprogrammet kan fullføres selv om nettleserautorisasjonen ble utsatt eller avbrutt.

Skallet finner ikke `pandapaw`

Åpne en ny terminal. På macOS/Linux sjekker du ~/.local/bin; på Windows sjekker du %LOCALAPPDATA%\Programs\pandapaw. Ikke installer om gjentatte ganger før du har bekreftet om den kjørbare filen finnes, og at kun PATH er utdatert.

En kodemotor mislyktes i å installere

Vertsinstallasjonsprogrammet behandler valgfrie nedlastinger av motorer som beste innsats, slik at et leverandøravbrudd ikke fjerner en fungerende PandaPaw-installasjon. Installer eller reparer motoren med den offisielle installasjonsprogrammet, autentiser den på vanlig måte, og kjør deretter pandapaw status igjen.

AppImage- eller desktop-applikasjonen vil ikke åpnes

Bekreft at du lastet ned pakken for riktig arkitektur, og start den fra en terminal for å fange opp den første feilmeldingen. Inkluder feilmeldingen og OS-versjonen din når du kontakter støtte; skjermbilder av et lukket vindu er vanligvis ikke nok til å diagnostisere et manglende kjøretidsbibliotek.

For vertsspesifikke tilkoblingskontroller, fortsett med PandaPaw-guiden eller FAQ.