Etäohjelmointiagentin asennus koostuu kahdesta itsenäisestä osasta:
- PandaNpc-asiakassovellus — käyttöliittymä, jolla luet istuntoja, lähetät kehotteita ja hyväksyt työkaluja. Se toimii verkossa, iOS:llä, Windowsissa, macOS:ssä ja Linuxissa.
- PandaPaw-isäntä — taustapalvelu tietokoneessa, jossa Claude Code, Codex tai PandaCode varsinaisesti suorittaa koodia.
Asenna vain asiakassovellus PandaNpc-chattiä ja paikallista työpöytäkäyttöä varten. Asenna molemmat osat, kun haluat tavoittaa toisella koneella toimivan ohjelmointiagentin.
Katso PandaNpc Desktop, mitä Windows-/macOS-/Linux-sovellus tuo lisää alla olevien asennusvaiheiden lisäksi, mukaan lukien julkaisuhistoriansa.
Valitse, mitä asennat
| skenaario | Asiakassovellus | PandaPaw-isäntä |
|---|---|---|
| Käytä PandaNpc-chattiä selaimessa | Avaa verkkosovellus | Ei vaadita |
| Hallitse agenttia tällä samalla työpöydällä | Työpöytäsovellus | Riippuu valitusta paikallis-/etätilasta |
| Hallitse kehityskonetta puhelimesta tai selaimesta | Asenna/avaa asiakassovellus katselulaitteeseen | Vaaditaan kehityskoneessa |
| Suorita agentteja palvelimella ilman graafista työpöytää | Verkko, työpöytä tai iOS muualla | Vaaditaan palvelimella |
Nopeinta koko polkua varten käytä Pika-aloitusopasta.
PandaNpc-asiakassovelluksen asentaminen
Käytä PandaNpc-lataussivua luotettavana lähteenä nykyisille asennustiedostoille. Vältä kolmannen osapuolen lataussivustoja, koska ne voivat tarjota vanhoja tai muokattuja paketteja.
Verkko
Avaa pandanpc.com/agent nykyisessä selaimessa. Mitään ei asenneta. Selaimen tallennustila säilyttää paikallisen kirjautumistilan, joten yksityiset/incognito-ikkunat voivat vaatia kirjautumisen uudelleen.
iOS
Seuraa App Store -linkkiä lataussivulla ja asenna PandaNpc. iOS on hyödyllinen edistymisen tarkistamiseen, kysymyksiin vastaamiseen ja työkalujen hyväksymiseen poissa isäntäkoneelta. Ohjelmointiprosessi toimii silti yhdistetyllä isäntäkoneella. Katso PandaNpc for iOS, mitä sovellus kattaa, mukaan lukien julkaisuhistoriansa.
Windows
- Lataa nykyinen Windows-asennustiedosto.
- Suorita se ja seuraa asennusohjeita.
- Käynnistä PandaNpc Käynnistä-valikosta.
- Jos Windows näyttää julkaisija- tai maineVaroituksen, varmista ennen jatkamista, että tiedosto on peräisin osoitteesta
pandanpc.com.
macOS
- Lataa macOS
.dmg-tiedosto. - Vedä PandaNpc Applications-kansioon.
- Käynnistä se Applications-kansiosta ja suorita kaikki macOS:n tietoturvakehotteet.
macOS-versio on universaali, joten sama paketti tukee Apple Silicon- ja Intel-Maceja.
Linux
Lataa x86_64 AppImage, tee siitä suoritettava ja suorita se:
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImageJos AppImage ei käynnisty, suorita se kerran terminaalista ja säilytä tarkka virheilmoitus. Vanhemmista jakeluista saattaa puuttua työpöytäkuoren vaatima ajonaikainen kirjasto.
PandaPaw'n asentaminen agentti-isäntään
PandaPaw tarjoaa tällä hetkellä isäntäasentimia Windows x64:lle, macOS universalille ja Linux x86_64:lle. Suorita komento tietokoneessa, joka omistaa projektitiedostot ja jonka tulee suorittaa agentin työkalut.
Suositeltu reitti on Connected Devices: valitse Add a device ja kopioi sitten luotu kertakäyttöinen komento. Se yhdistää isännän tiliisi asennuksen aikana.
macOS tai Linux
Tavallinen asennusohjelma selaimen valtuutuksella:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shValmisteltu kertakäyttöisen avaimen muoto:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxxWindows PowerShell
Tavallinen asennusohjelma:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexValmisteltu kertakäyttöisen avaimen muoto:
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexPowerShellin iwr | iex-putki ei voi välittää tavallisia skriptin argumentteja, joten Windows-asennusohjelma lukee kertakäyttöisen avaimen muuttujasta PANDANET_KEY.
Mitä isäntäasennus muuttaa
Asennusohjelma:
- Lisää PandaPaw'n nykyisen käyttäjän sovellus-/bin-kansioon ja päivittää käyttäjän
PATH-muuttujan tarvittaessa. - Rekisteröi asianmukaiset taustapalvelut käynnistymään automaattisesti.
- Asentaa tuetut ohjelmointimoottorit, jotka puuttuvat, kun alusta sallii sen.
- Toimittaa yksityisen Node.js-ajoympäristön, jos järjestelmässä ei ole sopivaa versiota.
- Käynnistää tilin valtuutuksen tai lunastaa valmistellun laiteavaimen.
- Tallentaa, mitkä tiedostot se loi, jotta poisto voi säilyttää jo olemassa olleet yhteensopivat työkalut.
Moottorin asentaminen ei automaattisesti osta tai todentaa mallitilausta. Claude Code ja Codex voivat silti pyytää omaa palveluntarjoajan kirjautumista ensimmäisellä käyttökerralla.
Asennuksen varmistaminen
Avaa uusi terminaali asennuksen jälkeen ja suorita:
pandapaw statusAvaa sitten PandaNpc Agent. Isännän pitäisi näkyä verkossa. Aloita istunto testiprojektissa ja pyydä sitä raportoimaan nykyinen työhakemisto muuttamatta tiedostoja. Tämä varmistaa binäärin, taustapalvelun, tilin yhdistämisen, yhdyskäytäväyhteyden, moottorin ja valitun hakemiston — ei vain latausvaihetta.
Päivittäminen
Työpöytäasiakassovellukset ilmoittavat, kun päivitys on saatavilla. iOS päivittyy App Storen kautta.
Päivitä PandaPaw ja käynnistä sen hallinnoimat palvelut uudelleen:
pandapaw update --restartPäivitysohjelma varmistaa ladatun binäärin julkaistua SHA-256-tarkistussummaa vasten ennen asennetun kopion korvaamista. Tilisi yhdistäminen ja olemassa oleva yhteysidentiteetti säilyvät. Asennuskomennon uudelleen suorittaminen on myös tuettu, jos itse päivitysohjelma ei ole käytettävissä.
Poistaminen
- Windows-asiakassovellus: Settings → Apps → Installed apps → PandaNpc → Uninstall.
- macOS-asiakassovellus: lopeta PandaNpc ja siirrä se sitten Applications-kansiosta roskakoriin.
- Linux-asiakassovellus: poista AppImage ja mahdollinen sen luomasi käynnistin.
- PandaPaw-isäntä: suorita
pandapaw uninstallisäntäkoneessa.
PandaPaw'n poistolista erottaa asentajan luomat työkalut jo olemassa olleista yhteensopivista työkaluista. Se on tarkoituksella varovainen eikä poista aiemmin asennettua Claude Code-, Codex-, PandaCode- tai Node-asennusta.
Asennusongelmat
Komento päättyi, mutta isäntä ei ole yhteydessä
Suorita pandapaw login. Isännän asennus ja tilin valtuutus ovat erillisiä vaiheita, ja asennusohjelma voi päättyä, vaikka selaimen valtuutus olisi lykätty tai keskeytynyt.
Kuori ei löydä `pandapaw`-komentoa
Avaa uusi terminaali. macOS/Linuxissa tarkista ~/.local/bin; Windowsissa tarkista %LOCALAPPDATA%\Programs\pandapaw. Älä asenna uudelleen toistuvasti ennen kuin olet varmistanut, onko suoritettava tiedosto olemassa ja onko vain PATH vanhentunut.
Ohjelmointimoottorin asennus epäonnistui
Isäntäasennusohjelma käsittelee valinnaiset moottorilataukset parhaan yrityksen periaatteella, joten yhden palveluntarjoajan katkos ei poista toimivaa PandaPaw-asennusta. Asenna tai korjaa kyseinen moottori sen virallisella asennusohjelmalla, todentaa se normaalisti ja suorita sitten pandapaw status uudelleen.
AppImage tai työpöytäsovellus ei aukea
Varmista, että latasit paketin oikealle arkkitehtuurille, ja käynnistä se sitten terminaalista ensimmäisen virheen tallentamiseksi. Liitä virhe ja käyttöjärjestelmäsi versio tukeen ottaessasi yhteyttä; kuvakaappaukset suljetusta ikkunasta eivät yleensä riitä puuttuvan ajonaikaisen kirjaston diagnosointiin.
Isäntäkohtaisia yhteystarkistuksia varten jatka PandaPaw-oppaan tai UKK:n parissa.