PandaPaw: Ekstern vert for Claude Code, Codex og PandaCode

PandaPaw gjør en Windows-, macOS- eller Linux-maskin du kontrollerer om til en PandaNpc-agentvert. Kodingsmotoren, prosjektfilene, skall og verktøy forblir på den verten; PandaNpc-klienter gir deg et synkronisert grensesnitt fra en telefon, nettleser eller en annen stasjonær enhet.

Bruk PandaPaw når maskinen som utfører arbeidet er forskjellig fra enheten du holder i hånden, når du vil at en vert skal overleve frakoblinger fra klienter, eller når flere kodingsmotorer skal dele samme kontobaserte oppsett og Agent Center-konfigurasjon.

Hva PandaPaw administrerer

• Eksterne agentforbindelser for Claude Code, OpenAI Codex og PandaCode.
• Bakgrunnstjenester og automatisk start slik at verten kan komme tilbake etter en vanlig omstart.
• Kontobasert maskinautorisasjon uten manuell kopiering av en langvarig Bridge-ID, token eller signeringsnøkkel.
• Installasjonshjelp for motorer når en støttet kodingsmotor mangler.
• Agent Center-projeksjoner som gjengir hver motors veiledning, ferdigheter, minne og agentdefinisjoner i dens opprinnelige layout.
• Privat enhetsnettverk for maskiner som er koblet til gjennom Connected Devices-flyten.
• Regnskap for oppdatering og avinstallering slik at verktøy som fantes før PandaPaw blir bevart.

PandaPaw gir ikke et modellabonnement i seg selv. Claude Code, Codex og PandaCode bruker fortsatt leverandørens legitimasjon og begrensninger som er konfigurert for motoren.

Slik fungerer ekstern kjøring

Begge sider initierer utgående forbindelser, så et vanlig hjemme- eller kontoroppsett krever ikke en innkommende brannmurregel, offentlig IP-adresse, portvideresending i ruteren eller en offentlig eksponert SSH-server. Reléet transporterer meldinger, status og godkjenninger; verktøykjøring skjer på verten.

Hvis verten går i dvale, slås av eller mister sin utgående nettverksvei, forblir den lagrede forbindelsen i kontoen din, men kan ikke utføre arbeid før verten kommer tilbake.

Støttede vertsplattformer

PandaNpc-visningsklienten har en bredere plattformmatrise. Se Installere PandaNpc og PandaPaw når du velger klient- og vertspakker.

Anbefalt installasjon

1. Logg på PandaNpc.
2. Åpne Connected Devices.
3. Velg Legg til en enhet. Det utstedes en engangsnøkkel, og dialogen viser én kommando for det oppdagede operativsystemet.
4. Kopier kommandoen til verten og kjør den der.
5. La dialogen stå åpen hvis du vil at den skal oppdage den nye maskinen automatisk.

Den forberedte nøkkelen er til engangsbruk. Kopier hele kommandoen, hold den privat, og generer en ny hvis den utløper eller allerede er brukt.

Ren macOS/Linux-installasjonsprogram

Bruk denne formen når du vil ha nettleserautorisasjon i stedet for en forberedt nøkkel:

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

Ren Windows PowerShell-installasjonsprogram

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

Det rene installasjonsprogrammet kjører pandapaw login. Godkjenn maskinen i nettlesersiden som åpnes. Hvis autorisasjonen avbrytes, kan binærfilen og tjenestene fortsatt installeres; kjør pandapaw login senere for å fullføre kontotilkoblingen.

Bekreft verten

Sjekk først selve verten:

pandapaw status

Åpne deretter PandaNpc Agent og bekreft at maskinen har en grønn online-indikator. Start en økt i et midlertidig eller skrivebeskyttet testmappe og spør:

Testspørsmål: Skriv ut gjeldende arbeidskatalog og liste toppnivåfilene. Ikke endre noe.

Et vellykket svar beviser mer enn en grønn statuslampe: det verifiserer kontoparing, reléforbindelse, den valgte motoren, leverandørautentisering og arbeidskatalogtilordningen.

For et Agent Center-prosjekt kjører du:

pandapaw agent status --root /absolute/path/to/project

Dette viser om prosjektet er bundet og om administrert konfigurasjon er tilgjengelig lokalt. En stabil Git-fjernkontroll hjelper PandaPaw med å identifisere det samme prosjektet på tvers av maskiner.

Kontoautorisasjon og forbindelsesidentitet

pandapaw login bruker en enhetsautorisasjonssesjon i nettleseren. Når du godkjenner den, mottar verten enhetsspesifikke legitimasjoner og en Agent Center-verifiseringsnøkkel over TLS, skriver maskinkonfigurasjonen under ~/.pandapaw/, registrerer de støttede motorforbindelsene og binder gjenkjennelige Git-prosjekter.

Kjør pandapaw login --force bare når du bevisst bytter konto eller erstatter en utløpt vertslegitimasjon. Å reautorisere en frisk maskin uten grunn kan skape forvirrende duplikat- eller erstattede identiteter.

pandapaw qr oppretter fortsatt en kortvarig manuell forbindelseslenke for kompatibilitet og spesielle tilfeller. Det er ikke hovedflyten for en ny vert; Connected Devices er lettere å revidere og krever ikke at brukerne forstår Bridge-ID-er.

Agent Center-synkronisering

Agent Center er hendelsesdrevet i stabil tilstand:

1. Lokale endringer i administrerte filer oppdages og publiseres til det bundne prosjektet.
2. Signerte utgivelser kommer gjennom en hendelsesstrøm.
3. Uendrede manifest og innholdsblobber gjenbrukes i stedet for å lastes ned på nytt.
4. En periodisk gjenopprettingssjekk fanger opp hendelser som er gått glipp av under en midlertidig frakobling.

Claude Code, Codex og PandaCode mottar separate projeksjoner fordi de forventer forskjellige kataloger og instruksjonsformater. PandaCode forbereder den nyeste verifiserte utgivelsen før den setter sammen en ny sesjonsspørring, så konfigurasjon som hentes ved oppstart kan påvirke den samme økten.

Hvis Agent Center midlertidig er utilgjengelig, fortsetter motoren med den siste verifiserte lokale utgivelsen. En nettverksfeil bør ikke stille erstatte signert konfigurasjon med uverifisert innhold.

Nyttige kommandoer

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Sjekk PandaPaw-versjonshistorikken når en kommando eller et brukergrensesnitt avviker fra et eldre skjermbilde eller en eldre veiledning.

Sikkerhetsgrenser

• En ekstern operatør kan bruke de verktøyene og den arbeidskatalogen den valgte agentsesjonen tillater. Ekstern tilgang er ikke automatisk skrivebeskyttet.
• Hold engangsenhetskommandoer, manuelle forbindelseslenker, leverandørnøkler og kontotokener utenfor logger og skjermbilder.
• Ikke åpne innkommende ruterporter bare for å gjøre PandaPaw tilgjengelig.
• Fjern vertene du ikke lenger eier fra Connected Devices.
• Gjennomgå verktøygodkjenninger og bekreft arbeidskatalogen før du tillater redigeringer eller skallkommandoer.
• Når du deler en aktiv forbindelse, bruker mottakeren verteierens motorkvote og kan handle på verten. Les Del forbindelser først.

Feilsøking

`pandapaw` blir ikke funnet etter installasjon

Åpne en ny terminal slik at den laster inn brukerens PATH på nytt. De vanlige plasseringene er ~/.local/bin på macOS/Linux og %LOCALAPPDATA%\Programs\pandapaw på Windows. Bekreft at filen finnes før du kjører installasjonsprogrammet på nytt.

Installasjonen lyktes, men ingen maskin vises

Kjør pandapaw status. Hvis maskinen ikke har kontoautorisasjon, kjører du pandapaw login. Hvis en forberedt engangsnøkkel ble brukt, oppretter du en ny nøkkel i stedet for å prøve en brukt kommando på nytt.

Maskinen vises, men forblir frakoblet

Bekreft at verten er våken og har internettilgang. Sjekk PandaPaw-statusen lokalt. En bedriftsproxy eller brannmur må tillate den utgående HTTPS/WebSocket-banen; en innkommende port løser ikke en blokkert utgående forbindelse.

Verten er online, men Claude Code eller Codex svarer ikke

Paring av verten autentiserer ikke alle modellleverandører. Åpne motoren lokalt eller følg påloggingsspørsmålet som vises i den eksterne økten. Bekreft også at den valgte modellen finnes for den kontoen, og at bruksgrensen ikke er oppbrukt.

Økten åpnes i feil prosjekt

Avslutt testen, velg den tiltenkte absolutte arbeidskatalogen, og be agenten skrive den ut før du godkjenner verktøy. PandaPaw gjetter ikke hvilket repository du mente, og legger ikke til en filsystem-sandkasse utover motorens egen tillatelsesmodell.

Agent Center-endringer vises ikke

Kjør pandapaw agent status --root /path/to/project fra riktig Git-rot. Bekreft at prosjektet er bundet, at verten er logget på, og at den lokale filen er en del av en administrert projeksjon. Behold den siste verifiserte utgivelsen mens du undersøker, i stedet for å slette administrerte kataloger.

Oppdatering og avinstallering

pandapaw update --restart laster ned gjeldende binærfil, verifiserer SHA-256-sjekksummen, erstatter den installerte kopien og starter de administrerte tjenestene på nytt slik at versjonen blir aktiv. Eksisterende kontoparing bevares.

pandapaw uninstall bruker installasjonsmanifestet for å fjerne elementer som PandaPaw opprettet. Kompatible Claude Code-, Codex-, PandaCode- eller Node-installasjoner som allerede fantes, beholdes med hensikt. Etter avinstallering fjerner du verten fra Connected Devices hvis den ikke lenger skal være klarert.