PandaPaw: Etäisäntä Claude Code, Codex ja PandaCode -ympäristöille

PandaPaw muuttaa hallitsemasi Windows-, macOS- tai Linux-tietokoneen PandaNpc-agenttien isännäksi. Koodausmoottori, projektitiedostot, komentotulkki ja työkalut pysyvät sillä isännällä; PandaNpc-asiakkaat tarjoavat synkronoidun käyttöliittymän puhelimesta, selaimesta tai toiselta työpöydältä.

Käytä PandaPawia, kun työn tekevä kone on eri kuin laite, jota pidät kädessäsi, kun haluat isännän kestävän asiakkaan yhteyden katkeamisen, tai kun useiden koodausmoottorien tulisi jakaa sama tiliperustainen asetus ja Agent Center -konfiguraatio.

Mitä PandaPaw hallinnoi

• Etäagenttiyhteydet Claude Code, OpenAI Codex ja PandaCode -ympäristöille.
• Taustapalvelut ja automaattinen käynnistys, jotta isäntä voi palata normaalin uudelleenkäynnistyksen jälkeen.
• Tiliperustainen konevaltuutus ilman pitkäikäisen Bridge ID:n, tunnuksen tai allekirjoitusavaimen manuaalista kopiointia.
• Moottorin asennuksen apu, kun tuettu koodausmoottori puuttuu.
• Agent Center -projektiot, jotka renderöivät kunkin moottorin ohjeet, taidot, muistin ja agenttimääritykset sen natiivissa asettelussa.
• Yksityinen laiteverkko Connected Devices -virtauksen kautta liitetyille koneille.
• Päivitys- ja poistokirjanpito, jotta ennen PandaPawia olemassa olleet työkalut säilytetään.

PandaPaw ei itsessään tarjoa mallitilausta. Claude Code, Codex ja PandaCode käyttävät edelleen toimittajan tunnistetietoja ja rajoja, jotka on määritetty niiden moottorille.

Miten etäsuoritus toimii

Molemmat osapuolet aloittavat ulospäin suuntautuvat yhteydet, joten normaali koti- tai toimistoympäristö ei vaadi saapuvaa palomuurisääntöä, julkista IP-osoitetta, reitittimen porttiohjausta tai julkisesti altistettua SSH-palvelinta. Rele välittää viestit, tilat ja hyväksynnät; työkalujen suoritus tapahtuu isännällä.

Jos isäntä nukkuu, sammuu tai menettää ulospäin suuntautuvan verkkoyhteytensä, tallennettu yhteys säilyy tililläsi, mutta se ei voi suorittaa työtä ennen kuin isäntä palaa.

Tuetut isäntäalustat

PandaNpc-katseluasiakkaalla on laajempi alustamatriisi. Katso PandaNpc:n ja PandaPaw:n asennus, kun valitset asiakas- ja isäntäpaketteja.

Suositeltu asennus

1. Kirjaudu PandaNpc:hen.
2. Avaa Connected Devices.
3. Valitse Add a device. Kertakäyttöinen avain myönnetään ja valintaikkuna näyttää yhden komennon tunnistetulle käyttöjärjestelmälle.
4. Kopioi komento isännälle ja suorita se siellä.
5. Jätä valintaikkuna auki, jos haluat sen tunnistavan uuden koneen automaattisesti.

Valmisteltu avain on kertakäyttöinen. Kopioi koko komento, pidä se yksityisenä, ja luo uusi, jos se vanhenee tai on jo käytetty.

Tavallinen macOS/Linux-asennusohjelma

Käytä tätä muotoa, kun haluat selaimen valtuutuksen valmistellun avaimen sijaan:

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

Tavallinen Windows PowerShell -asennusohjelma

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

Tavallinen asennusohjelma suorittaa pandapaw login. Hyväksy kone sen avaamalla selainsivulla. Jos valtuutus keskeytyy, binääri ja palvelut voidaan silti asentaa; suorita pandapaw login myöhemmin viimeistelläksesi tilin yhteyden.

Varmista isäntä

Tarkista ensin itse isäntä:

pandapaw status

Avaa sitten PandaNpc Agent ja varmista, että koneessa on vihreä online-merkkivalo. Aloita istunto hajautetussa tai vain luku -testihakemistossa ja kysy:

Testikehote: Tulosta nykyinen työhakemisto ja luettele ylimmän tason tiedostot. Älä muokkaa mitään.

Onnistunut vastaus todistaa enemmän kuin vihreän tilan merkkivalon: se varmistaa tilin parituksen, releyhteyden, valitun moottorin, toimittajan tunnistautumisen ja työhakemistokartoituksen.

Agent Center -projektille suorita:

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

Tämä näyttää, onko projekti sidottu ja onko hallinnoitu konfiguraatio saatavilla paikallisesti. Vakaa Git-etävarasto auttaa PandaPawia tunnistamaan saman projektin eri koneissa.

Tilin valtuutus ja yhteyden identiteetti

pandapaw login käyttää selaimen laitevaltuutusistuntoa. Kun hyväksyt sen, isäntä vastaanottaa laitekohtaiset tunnistetiedot ja Agent Center -varmennusavaimen TLS:n yli, kirjoittaa konekonfiguraationsa kohtaan ~/.pandapaw/, rekisteröi tuetut moottoriyhteydet ja sitoo tunnistettavat Git-projektit.

Suorita pandapaw login --force vain silloin, kun vaihdat tarkoituksella tiliä tai korvaat vanhentuneen isäntätunnisteen. Terveen koneen uudelleenvaltuuttaminen ilman syytä voi luoda hämmentäviä kaksois- tai korvattuja identiteettejä.

pandapaw qr luo edelleen lyhytaikaisen manuaalisen yhteyslinkin yhteensopivuutta ja erikoistapauksia varten. Se ei ole ensisijainen virtaus uudelle isännälle; Connected Devices on helpompi tarkastaa eikä vaadi käyttäjien ymmärtävän Bridge ID:tä.

Agent Center -synkronointi

Agent Center on tapahtumavetoinen vakaassa tilassa:

1. Paikalliset hallinnoitujen tiedostojen muutokset havaitaan ja julkaistaan sidottuun projektiin.
2. Allekirjoitetut julkaisut saapuvat tapahtumavirran kautta.
3. Muuttumattomat manifestit ja sisältöpalat käytetään uudelleen sen sijaan, että ne ladattaisiin uudelleen.
4. Jaksottainen palautustarkistus sieppaa tapahtumat, jotka jäivät huomaamatta tilapäisen yhteyden katkoksen aikana.

Claude Code, Codex ja PandaCode vastaanottavat erilliset projektiot, koska ne odottavat erilaisia hakemistoja ja ohjeformaatteja. PandaCode valmistelee uusimman varmennetun julkaisun ennen uuden istuntokehotteen kokoamista, joten käynnistyksessä haettu konfiguraatio voi vaikuttaa samaan istuntoon.

Jos Agent Center on tilapäisesti poissa käytöstä, moottori jatkaa viimeisimmällä varmennetulla paikallisella julkaisulla. Verkkovika ei saa hiljaa korvata allekirjoitettua konfiguraatiota vahvistamattomalla sisällöllä.

Hyödyllisiä komentoja

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

Tarkista PandaPaw-version historia, kun komento tai käyttöliittymä eroaa vanhemmasta kuvakaappauksesta tai opetusohjelmasta.

Turvallisuusrajat

• Etäkäyttäjä voi käyttää niitä työkaluja ja työhakemistoja, jotka valittu agenttiistunto sallii. Etäkäyttö ei ole automaattisesti vain luku -tilaa.
• Pidä kertakäyttöiset laitekomentot, manuaaliset yhteyslinkit, toimittaja-avaimet ja tilitunnukset poissa lokeista ja kuvakaappauksista.
• Älä avaa saapuvia reitittimen portteja vain tehdäksesi PandaPawista tavoitettavan.
• Poista isännät, joita et enää omista, Connected Devices -luettelosta.
• Tarkista työkalujen hyväksynnät ja varmista työhakemisto ennen muokkausten tai komentotulkkikomentojen sallimista.
• Kun jaat aktiivisen yhteyden, vastaanottaja kuluttaa isännän omistajan moottorikiintiötä ja voi toimia isännällä. Lue Yhteyden jakaminen ensin.

Vianmääritys

`pandapaw` ei löydy asennuksen jälkeen

Avaa uusi pääte, jotta se lataa käyttäjän PATH-muuttujan uudelleen. Normaalit sijainnit ovat ~/.local/bin macOS/Linuxissa ja %LOCALAPPDATA%\Programs\pandapaw Windowsissa. Varmista, että tiedosto on olemassa, ennen kuin suoritat asennusohjelman uudelleen.

Asennus onnistui, mutta konetta ei näy

Suorita pandapaw status. Jos koneella ei ole tilin valtuutusta, suorita pandapaw login. Jos valmisteltu kertakäyttöinen avain käytettiin, luo uusi avain sen sijaan, että yrittäisit käytettyä komentoa uudelleen.

Kone näkyy, mutta pysyy offline-tilassa

Varmista, että isäntä on hereillä ja sillä on internetyhteys. Tarkista PandaPaw-tila paikallisesti. Yritysproxy tai palomuuri on sallittava ulospäin suuntautuva HTTPS/WebSocket-polku; saapuva portti ei ratkaise estettyä ulospäin suuntautuvaa yhteyttä.

Isäntä on online, mutta Claude Code tai Codex ei vastaa

Isännän paritus ei tunnusta jokaista mallitoimittajaa. Avaa moottori paikallisesti tai seuraa etäistunnossa näkyvää kirjautumiskehotetta. Varmista myös, että valittu malli on olemassa kyseiselle tilille ja että sen käyttöraja ei ole täyttynyt.

Istunto avautuu väärässä projektissa

Lopeta testi, valitse aiottu absoluuttinen työhakemisto ja pyydä agenttia tulostamaan se ennen työkalujen hyväksymistä. PandaPaw ei arvaa, mitä repositoriota tarkoitit, eikä lisää tiedostojärjestelmähiekkalaatikkoa moottorin oman käyttöoikeusmallin lisäksi.

Agent Center -muutokset eivät näy

Suorita pandapaw agent status --root /polku/projektiin oikeasta Git-juuresta. Varmista, että projekti on sidottu, isäntä on kirjautunut sisään ja paikallinen tiedosto on osa hallinnoitua projektiota. Pidä viimeisin varmennettu julkaisu paikallaan tutkiessasi sen sijaan, että poistaisit hallinnoituja hakemistoja.

Päivitys ja poisto

pandapaw update --restart lataa nykyisen binäärin, varmistaa sen SHA-256-tarkistussumman, korvaa asennetun kopion ja käynnistää hallinnoidut palvelut uudelleen, jotta versio tulee aktiiviseksi. Olemassa oleva tiliparitys säilyy.

pandapaw uninstall käyttää asennusmanifestia poistaakseen PandaPaw:n luomat kohteet. Yhteensopivat Claude Code, Codex, PandaCode tai Node-asennukset, jotka olivat jo olemassa, säilytetään tarkoituksella. Poiston jälkeen poista isäntä Connected Devices -luettelosta, jos sitä ei enää tulisi luottaa.