PandaPaw: Fjernvært for Claude Code, Codex og PandaCode

PandaPaw gør den Windows-, macOS- eller Linux-maskine, du kontrollerer, til en PandaNpc-agentvært. Kodningsmotoren, projektfilerne, skallen og værktøjerne bliver på den vært; PandaNpc-klienter giver dig en synkroniseret grænseflade fra en telefon, browser eller et andet skrivebord.

Brug PandaPaw, når maskinen, der udfører arbejdet, er forskellig fra den enhed, du holder i hånden, når du vil have en vært, der kan overleve klientafbrydelser, eller når flere kodningsmotorer skal dele den samme kontobaserede opsætning og Agent Center-konfiguration.

Hvad PandaPaw administrerer

• Fjernagentforbindelser for Claude Code, OpenAI Codex og PandaCode.
• Baggrundstjenester og automatisk start, så værten kan vende tilbage efter en normal genstart.
• Kontobaseret maskinautorisation uden manuel kopiering af en langlivet Bridge ID, token eller signeringsnøgle.
• Motorinstallationshjælp, når en understøttet kodningsmotor mangler.
• Agent Center-projektioner, der gengiver hver motors vejledning, færdigheder, hukommelse og agentdefinitioner i dens oprindelige layout.
• Privat enhedsnetværk for maskiner, der er tilsluttet via Connected Devices-flowet.
• Regnskab for opdatering og afinstallation, så værktøjer, der eksisterede før PandaPaw, bevares.

PandaPaw leverer ikke i sig selv et modelabonnement. Claude Code, Codex og PandaCode bruger stadig udbyderens legitimationsoplysninger og grænser, der er konfigureret for deres motor.

Sådan fungerer fjernudførelse

Begge sider opretter udgående forbindelser, så en normal hjemme- eller kontoropsætning ikke kræver en indgående firewall-regel, offentlig IP-adresse, portvideresendelse på routeren eller en offentligt eksponeret SSH-server. Relæet transporterer beskeder, status og godkendelser; værktøjsudførelse sker på værten.

Hvis værten går i dvale, slukkes eller mister sin udgående netværksvej, forbliver den gemte forbindelse på din konto, men kan ikke udføre arbejde, før værten vender tilbage.

Understøttede værtsplatforme

PandaNpc-visningsklienten har en bredere platformmatrice. Se Installer PandaNpc og PandaPaw, når du vælger klient- og værtspakker.

Anbefalet installation

1. Log ind på PandaNpc.
2. Åbn Connected Devices.
3. Vælg Tilføj en enhed. Der udstedes en engangsnøgle, og dialogen viser én kommando til det registrerede operativsystem.
4. Kopiér kommandoen til værten, og kør den der.
5. Lad dialogen være åben, hvis du vil have den til automatisk at registrere den nye maskine.

Den forberedte nøgle er til engangsbrug. Kopiér hele kommandoen, hold den privat, og generér en ny, hvis den udløber eller allerede er blevet brugt.

Almindelig macOS/Linux-installationsprogram

Brug denne formular, når du ønsker browserautorisation i stedet for en forberedt nøgle:

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

Almindelig Windows PowerShell-installationsprogram

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

Det almindelige installationsprogram kører pandapaw login. Godkend maskinen i den browserside, det åbner. Hvis autorisationen afbrydes, kan den binære fil og tjenesterne stadig installeres; kør pandapaw login senere for at fuldføre kontoforbindelsen.

Bekræft værten

Kontrollér først selve værten:

pandapaw status

Åbn derefter PandaNpc Agent, og bekræft, at maskinen har en grøn online-indikator. Start en session i en engangs- eller skrivebeskyttet testmappe, og spørg:

Testprompt: Udskriv den aktuelle arbejdsmappe, og list filerne på øverste niveau. Ændr ikke noget.

Et vellykket svar beviser mere end en grøn statuslampe: det bekræfter kontoparring, relæforbindelse, den valgte motor, udbydergodkendelse og arbejdsmappens tilknytning.

For et Agent Center-projekt skal du køre:

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

Dette viser, om projektet er bundet, og om administreret konfiguration er tilgængelig lokalt. En stabil Git-fjernreference hjælper PandaPaw med at identificere det samme projekt på tværs af maskiner.

Kontobaseret autorisation og forbindelsesidentitet

pandapaw login bruger en browserbaseret enhedsauthorisationssession. Når du godkender den, modtager værten enhedsspecifikke legitimationsoplysninger og en Agent Center-verifikationsnøgle over TLS, skriver sin maskinkonfiguration under ~/.pandapaw/, registrerer de understøttede motorforbindelser og binder genkendelige Git-projekter.

Kør kun pandapaw login --force, når du bevidst skifter konto eller erstatter en udløbet værtslegitimation. At genautorisere en sund maskine uden grund kan skabe forvirrende dubletter eller erstattede identiteter.

pandapaw qr opretter stadig et kortvarigt manuelt forbindelseslink til kompatibilitet og specielle tilfælde. Det er ikke den primære metode til en ny vært; Connected Devices er nemmere at revidere og kræver ikke, at brugerne forstår Bridge ID'er.

Agent Center-synkronisering

Agent Center er hændelsesdrevet i stabil tilstand:

1. Lokale ændringer i administrerede filer registreres og publiceres til det bundne projekt.
2. Signerede udgivelser ankommer via en hændelsesstrøm.
3. Uændrede manifester og indholdsblobs genbruges i stedet for at blive downloadet igen.
4. En periodisk gendannelseskontrol fanger hændelser, der blev overset under en midlertidig afbrydelse.

Claude Code, Codex og PandaCode modtager separate projektioner, fordi de forventer forskellige mapper og instruktionsformater. PandaCode forbereder den seneste verificerede udgivelse, før den samler en ny session-prompt, så konfiguration, der hentes ved start, kan påvirke den samme session.

Hvis Agent Center midlertidigt ikke er tilgængeligt, fortsætter motoren med den seneste verificerede lokale udgivelse. En netværksfejl bør ikke stille og roligt erstatte signeret konfiguration med ikke-verificeret indhold.

Nyttige kommandoer

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

Se PandaPaw-versionshistorikken, når en kommando eller brugergrænseflade adskiller sig fra et ældre skærmbillede eller en ældre vejledning.

Sikkerhedsgrænser

• En fjernoperatør kan bruge de værktøjer og den arbejdsmappe, som den valgte agentsession tillader. Fjernadgang er ikke automatisk skrivebeskyttet.
• Hold engangsenhedskommandoer, manuelle forbindelseslinks, udbydernøgler og kontotokens ude af logfiler og skærmbilleder.
• Åbn ikke indgående routerporte blot for at gøre PandaPaw tilgængelig.
• Fjern værter, du ikke længere ejer, fra Connected Devices.
• Gennemgå værktøjsgodkendelser, og bekræft arbejdsmappen, før du tillader redigeringer eller shell-kommandoer.
• Når du deler en live forbindelse, bruger modtageren værtsejerens motorkvote og kan handle på værten. Læs Forbindelsesdeling først.

Fejlfinding

`pandapaw` findes ikke efter installation

Åbn en ny terminal, så den genindlæser brugerens PATH. De normale placeringer er ~/.local/bin på macOS/Linux og %LOCALAPPDATA%\Programs\pandapaw på Windows. Bekræft, at filen findes, før du kører installationsprogrammet igen.

Installationen lykkedes, men der vises ingen maskine

Kør pandapaw status. Hvis maskinen ikke har nogen kontobaseret autorisation, skal du køre pandapaw login. Hvis der blev brugt en forberedt engangsnøgle, skal du oprette en ny nøgle i stedet for at prøve en allerede brugt kommando igen.

Maskinen vises, men forbliver offline

Bekræft, at værten er vågen og har internetadgang. Tjek PandaPaw-status lokalt. En virksomhedsproxy eller firewall skal tillade den udgående HTTPS/WebSocket-sti; en indgående port løser ikke en blokeret udgående forbindelse.

Værten er online, men Claude Code eller Codex svarer ikke

Parring af værten autentificerer ikke alle modeludbydere. Åbn motoren lokalt, eller følg loginprompten, der vises i den fjernsession. Bekræft også, at den valgte model findes for den pågældende konto, og at dens brugsgrænse ikke er opbrugt.

Sessionen åbner i det forkerte projekt

Afslut testen, vælg den tilsigtede absolutte arbejdsmappe, og bed agenten om at udskrive den, før du godkender værktøjer. PandaPaw gætter ikke på, hvilket repository du mente, og tilføjer ikke en filsystem-sandkasse ud over motorens egen tilladelsesmodel.

Agent Center-ændringer vises ikke

Kør pandapaw agent status --root /path/to/project fra den korrekte Git-rod. Bekræft, at projektet er bundet, værten er logget ind, og at den lokale fil er en del af en administreret projektion. Behold den seneste verificerede udgivelse, mens du undersøger, i stedet for at slette administrerede mapper.

Opdatering og afinstallation

pandapaw update --restart downloader den aktuelle binære fil, verificerer dens SHA-256-checksum, erstatter den installerede kopi og genstarter de administrerede tjenester, så versionen bliver aktiv. Eksisterende kontoparring bevares.

pandapaw uninstall bruger installationsmanifestet til at fjerne elementer, som PandaPaw har oprettet. Kompatible Claude Code-, Codex-, PandaCode- eller Node-installationer, der allerede var til stede, bevares med vilje. Efter afinstallation skal du fjerne værten fra Connected Devices, hvis den ikke længere skal være tillid til.