Hurtigstart: Kjør Claude Code eller Codex eksternt

Oppdatert

Denne veiledningen kobler én utviklingsmaskin til PandaNpc og bekrefter at du kan kjøre Claude Code, Codex eller PandaCode fra en annen enhet. Agenten kjører fortsatt på utviklingsmaskinen din; PandaNpc gir deg et synkronisert eksternt grensesnitt for meldinger, godkjenninger, spørsmål og øktlogg.

De fleste bør bruke Legg til en enhet-flyten, fordi den genererer en engangsinstalleringskommando som allerede er knyttet til kontoen din. Sett av omtrent fem minutter, pluss eventuell pålogging hos modellleverandøren som kodemotoren din krever.

Før du begynner

Du trenger:

  • En PandaNpc-konto åpnet i webappen, skrivebordsappen eller iOS-appen.
  • En vert som kjører Windows x64, macOS eller Linux x86_64.
  • Internettilgang fra verten og tillatelse til å installere en bakgrunnstjeneste på brukernivå.
  • En prosjektmappe du har lov til å endre.
  • En Claude-, ChatGPT/Codex- eller egendefinert modellkonto hvis den valgte motoren ikke allerede er autentisert.

Hvis du bare trenger PandaNpcs innebygde chat og ikke vil styre en agent på en annen maskin, er ikke PandaPaw nødvendig. Se Installasjon for alternativer som kun er for klient.

1. Generer vertens installasjonskommando

Mens du er innlogget, åpner du Tilkoblede enheter og velger Legg til en enhet. PandaNpc oppretter en engangsenhetsnøkkel og viser den nøyaktige kommandoen for operativsystemet ditt.

Kopier kommandoen til maskinen der kodingsagenten skal kjøre. Behandle den som et passord til den er brukt: en engangsnøkkel kobler én maskin og bør ikke deles i chat, skjermbilder, issues eller eksportert skallhistorikk.

Hvis du foretrekker autorisasjon i nettleseren i stedet for en forberedt nøkkel, bruk den vanlige installatøren i neste trinn. Den kjører pandapaw login og åpner autorisasjonssiden for deg.

2. Installer PandaPaw på verten

macOS eller Linux

Kjør den forberedte kommandoen fra Tilkoblede enheter, eller bruk den vanlige installatøren:

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

Windows PowerShell

Kjør den forberedte kommandoen fra Tilkoblede enheter, eller bruk:

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

Installasjonsprogrammet legger til PandaPaw og bakgrunnstjenestene, installerer manglende støttede kodemotorer når det er mulig, og gir en privat Node.js-kjøretid når verten ikke har en passende. Med en forberedt enhetsnøkkel skjer kontoparingen under installasjonen. Med den vanlige kommandoen godkjenner du nettleserautorisasjonsforespørselen når du blir bedt om det.

Installasjonen kan fullføres selv om kontogodkjenningen utsettes. Hvis den sier at installasjonen var vellykket, men kontotilkoblingen er ufullstendig, kjører du:

bash
pandapaw login

3. Bekreft vertstjenestene

På verten kjører du:

bash
pandapaw status

Kommandoen skal kjenne igjen de installerte tjenestene og vise maskinen som er koblet til kontoen. Hvis skallet ikke finner pandapaw, åpner du en ny terminal først, slik at den laster inn den oppdaterte bruker-PATH-en.

For et Git-prosjekt kan du også sjekke om Agent Center kjenner igjen prosjektroten:

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

Bruk en ekte absolutt prosjektsti. Agent Centers prosjekttilknytning fungerer best når mappen har en stabil Git remote.origin.url.

4. Start den første eksterne økten

  1. Åpne PandaNpc Agent på telefonen, i nettleseren eller på et annet skrivebord.
  2. Finn den nykoblede maskinen. En grønn statusindikator betyr at verten er tilgjengelig for øyeblikket.
  3. Velg Claude Code, Codex eller PandaCode og velg prosjektets arbeidskatalog.
  4. Start en økt. Hvis motoren ber deg logge inn, fullfør leverandørens autorisasjon på verten eller gjennom den viste påloggingsflyten.
  5. Send en ikke-destruktiv testmelding som for eksempel: Vis gjeldende arbeidskatalog og list toppnivåfilene. Ikke endre noe.

Du er fullt tilkoblet når svaret nevner den forventede prosjektkatalogen, fillisten samsvarer med verten, og eventuelle tillatelsesspørsmål vises på den eksterne klienten for at du skal godkjenne eller avslå.

5. Bekreft tilkoblingsatferd ved gjenåpning

Lukk visningsklienten, vent noen sekunder, og åpne den samme økten igjen. Den eksisterende loggen skal komme tilbake, og verten skal forbli online. Dette sjekker den faktiske eksterne banen i stedet for bare å bekrefte at installatøren ble lastet ned.

Ikke sett verten i dvale under denne testen. En vert som sover eller er slått av, kan ikke kjøre agenten selv om den lagrede tilkoblingen fortsatt vises på kontoen din.

Feilsøking

Maskinen vises ikke i Agent

Kjør pandapaw status på verten. Hvis installasjonen var vellykket, men ingen konto er tilknyttet, kjører du pandapaw login. Hvis du brukte en forberedt nøkkel og den allerede er brukt eller utløpt, genererer du en ny i Tilkoblede enheter og kjører den viste kommandoen på nytt.

`pandapaw` blir ikke gjenkjent

Åpne en ny terminal. På macOS/Linux bekrefter du at ~/.local/bin er i PATH. På Windows legger installatøren til %LOCALAPPDATA%\Programs\pandapaw i brukerens PATH; en terminal som ble åpnet før installasjonen, vil ikke se den nye verdien.

Maskinen er oppført, men er offline

Bekreft at verten er slått på, våken og kan nå internett. Sjekk deretter pandapaw status. Brannmurer i bedrifter må tillate utgående HTTPS/WebSocket-trafikk; du bør ikke opprette en innkommende portvideresendingsregel.

Tilkoblingen fungerer, men motoren ber om autentisering

PandaPaw-paring og pålogging hos modellleverandøren er separate ting. Paring beviser at verten tilhører PandaNpc-kontoen din; Claude Code eller Codex kan fortsatt kreve egen abonnementspålogging eller API-konfigurasjon. Fullfør motorens vanlige pålogging, og prøv økten på nytt.

Agenten åpner i feil mappe

Avslutt den testøkten og opprett en med den tiltenkte arbeidskatalogen. Før du godkjenner verktøybruk, be agenten om å skrive ut gjeldende katalog. En ekstern tilkobling legger ikke til en filsystem-sandkasse av seg selv; motorens verktøytillatelser og valgte arbeidskatalog er fortsatt viktige.

Neste steg