Pika-aloitus: Suorita Claude Code tai Codex etänä

Päivitetty

Tämä opas yhdistää yhden kehityskoneen PandaNpc-palveluun ja varmistaa, että voit suorittaa Claude Coden, Codexin tai PandaCoden toiselta laitteelta. Agentti suoritetaan edelleen kehityskoneellasi; PandaNpc tarjoaa synkronoidun etäkäyttöliittymän viesteille, hyväksynnöille, kysymyksille ja istuntohistorialle.

Useimpien kannattaa käyttää Lisää laite -toimintoa, koska se luo kertakäyttöisen asennuskomennon, joka on jo liitetty heidän tiliinsä. Varaa noin viisi minuuttia sekä mahdollinen mallintarjoajan kirjautuminen, jonka koodausmoottorisi vaatii.

Ennen aloittamista

Tarvitset:

  • PandaNpc-tili avattuna verkkosovelluksessa, työpöytäsovelluksessa tai iOS-sovelluksessa.
  • Isäntäkone, jossa on Windows x64, macOS tai Linux x86_64.
  • Internet-yhteys isäntäkoneelta ja lupa asentaa käyttäjäkohtainen taustapalvelu.
  • Projektikansio, jota sinulla on lupa muokata.
  • Claude-, ChatGPT/Codex- tai mukautetun mallin tili, jos valitsemasi moottori ei ole jo todennettu.

Jos tarvitset vain PandaNpcin sisäänrakennettua chatia etkä halua ohjata agenttia toisella koneella, PandaPaw'ta ei tarvita. Katso Asennus saadaksesi lisätietoja vain asiakasohjelman vaihtoehdoista.

1. Luo isäntäkoneen asennuskomento

Ollessasi kirjautuneena avaa Yhdistetyt laitteet ja valitse Lisää laite. PandaNpc luo kertakäyttöisen laiteavaimen ja näyttää tarkan komennon käyttöjärjestelmällesi.

Kopioi kyseinen komento koneelle, jolla koodausagentin tulisi toimia. Käsittele sitä kuin salasanaa, kunnes se on käytetty: kertakäyttöinen avain yhdistää yhden koneen, eikä sitä saa julkaista chatissa, kuvakaappauksissa, ongelmaraporteissa tai shell-historian vienneissä.

Jos haluat mieluummin selaimen kautta tapahtuvan valtuutuksen valmiin avaimen sijaan, käytä seuraavan vaiheen tavallista asennusohjelmaa. Se suorittaa pandapaw login -komennon ja avaa valtuutussivun puolestasi.

2. Asenna PandaPaw isäntäkoneeseen

macOS tai Linux

Suorita valmis komento Yhdistetyt laitteet -näkymästä tai käytä tavallista asennusohjelmaa:

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

Windows PowerShell

Suorita valmis komento Yhdistetyt laitteet -näkymästä tai käytä:

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

Asennusohjelma lisää PandaPaw-ohjelmiston ja sen taustapalvelut, asentaa puuttuvat tuetut koodausmoottorit mahdollisuuksien mukaan ja tarjoaa yksityisen Node.js-ajoympäristön, jos isäntäkoneessa ei ole sopivaa. Valmista laiteavainta käytettäessä tilin yhdistäminen tapahtuu asennuksen aikana. Tavallisella komennolla hyväksy selaimen valtuutuspyyntö, kun sitä pyydetään.

Asennusohjelma voi päättyä, vaikka tilin valtuutus olisi lykätty. Jos se ilmoittaa asennuksen onnistuneen, mutta tilin yhteys on puutteellinen, suorita:

bash
pandapaw login

3. Tarkista isäntäkoneen palvelut

Suorita isäntäkoneella:

bash
pandapaw status

Komennon pitäisi tunnistaa asennetut palvelut ja näyttää tiliin yhdistetty kone. Jos komentotulkki ei löydä pandapaw-komentoa, avaa ensin uusi terminaali, jotta se lataa päivitetyn käyttäjän PATH-muuttujan.

Git-projektissa voit myös tarkistaa, tunnistaako Agent Center projektin juurihakemiston:

bash
pandapaw agent status --root /path/to/your/project

Käytä todellista absoluuttista projektipolkua. Agent Centerin projektisidonta toimii parhaiten, kun hakemistossa on vakaa Git-remote.origin.url.

4. Aloita ensimmäinen etäistunto

  1. Avaa PandaNpc Agent puhelimellasi, selaimella tai toisella työpöytäkoneella.
  2. Etsi äskettäin yhdistetty kone. Vihreä tilailmaisin tarkoittaa, että isäntäkone on parhaillaan tavoitettavissa.
  3. Valitse Claude Code, Codex tai PandaCode ja valitse projektin työhakemisto.
  4. Aloita istunto. Jos moottori pyytää sinua kirjautumaan sisään, suorita kyseisen palveluntarjoajan valtuutus isäntäkoneella tai näytettävän kirjautumisprosessin kautta.
  5. Lähetä tuhoamaton testikehote, esimerkiksi: Näytä nykyinen työhakemisto ja listaa ylimmän tason tiedostot. Älä muokkaa mitään.

Olet täysin yhdistetty, kun vastaus nimeää odotetun projektihakemiston, tiedostolista vastaa isäntäkonetta ja mahdollinen lupakysymys näkyy etäasiakkaassa, jotta voit hyväksyä tai hylätä sen.

5. Varmista uudelleenmuodostamisen toiminta

Sulje katseluasiakas, odota muutama sekunti ja avaa sama istunto uudelleen. Aiemman historian pitäisi palata ja isäntäkoneen pysyä verkossa. Tämä tarkistaa todellisen etäpolun sen sijaan, että se vain osoittaisi asennusohjelman ladatun onnistuneesti.

Älä laita isäntäkonetta lepotilaan tämän testin aikana. Lepotilassa tai sammutettu isäntäkone ei voi suorittaa agenttia, vaikka tallennettu yhteys näkyy edelleen tililläsi.

Vianmääritys

Kone ei näy Agentissa

Suorita pandapaw status isäntäkoneella. Jos asennus onnistui mutta tiliä ei ole liitetty, suorita pandapaw login. Jos käytit valmista avainta ja se on jo lunastettu tai vanhentunut, luo uusi Yhdistetyt laitteet -näkymässä ja suorita näytetty komento uudelleen.

`pandapaw`-komentoa ei tunnisteta

Avaa uusi terminaali. macOS/Linuxissa varmista, että ~/.local/bin on PATH-muuttujassa. Windowsissa asennusohjelma lisää %LOCALAPPDATA%\Programs\pandapaw-hakemiston käyttäjän PATH-muuttujaan; ennen asennusta avattu terminaali ei näe uutta arvoa.

Kone on listattu, mutta se on offline-tilassa

Varmista, että isäntäkone on päällä, hereillä ja voi muodostaa yhteyden internetiin. Tarkista sitten pandapaw status. Yrityksen palomuurien on sallittava lähtevä HTTPS/WebSocket-liikenne; sinun ei pidä luoda saapuvaa porttiohjaussääntöä.

Yhteys toimii, mutta moottori pyytää tunnistautumista

PandaPaw'n yhdistäminen ja mallintarjoajan kirjautuminen ovat erillisiä asioita. Yhdistäminen varmistaa, että isäntäkone kuuluu PandaNpc-tiliisi; Claude Code tai Codex voi silti vaatia oman tilauksen kirjautumisen tai API-määrityksen. Suorita moottorin normaali kirjautuminen ja yritä istuntoa uudelleen.

Agentti avautuu väärässä kansiossa

Lopeta kyseinen testiistunto ja luo uusi aiotulla työhakemistolla. Ennen työkalujen käytön hyväksymistä pyydä agenttia tulostamaan nykyinen hakemisto. Etäyhteys ei itsessään lisää tiedostojärjestelmän hiekkalaatikkoa; moottorin työkaluoikeudet ja valittu työhakemisto ovat edelleen tärkeitä.

Seuraavat vaiheet