Denne guide forbinder én udviklingsmaskine til PandaNpc og bekræfter, at du kan køre Claude Code, Codex eller PandaCode fra en anden enhed. Agenten kører stadig på din udviklingsmaskine; PandaNpc giver dig en synkroniseret fjerninterface til beskeder, godkendelser, spørgsmål og sessionshistorik.
De fleste bør bruge Tilføj en enhed-flowet, fordi det genererer en engangsinstallationskommando, der allerede er knyttet til deres konto. Afsæt cirka fem minutter, plus eventuel modeludbyder-login, som din kodningsmotor kræver.
Før du begynder
Du skal bruge:
- En PandaNpc-konto åbnet i webappen, desktop-appen eller iOS-appen.
- En værtsmaskine, der kører Windows x64, macOS eller Linux x86_64.
- Internetadgang fra værtsmaskinen og tilladelse til at installere en baggrundstjeneste på brugerniveau.
- En projektmappe, du har tilladelse til at ændre.
- En Claude-, ChatGPT/Codex- eller brugerdefineret model-konto, hvis din valgte motor ikke allerede er autentificeret.
Hvis du kun har brug for PandaNpcs indbyggede chat og ikke ønsker at styre en agent på en anden maskine, er PandaPaw ikke nødvendig. Se Installation for muligheder, der kun er for klienten.
1. Generer værtsinstallationskommandoen
Mens du er logget ind, skal du åbne Tilsluttede enheder og vælge Tilføj en enhed. PandaNpc opretter en engangs-enhedsnøgle og viser den nøjagtige kommando til dit operativsystem.
Kopér den kommando til den maskine, hvor kodningsagenten skal køre. Behandl den som en adgangskode, indtil den er brugt: en engangsnøgle parrer én maskine og bør ikke postes i chat, skærmbilleder, issues eller shell-historik-eksporter.
Hvis du foretrækker browserautorisation frem for en forberedt nøgle, skal du bruge den almindelige installer i næste trin. Den kører pandapaw login og åbner autorisationssiden for dig.
2. Installér PandaPaw på værtsmaskinen
macOS eller Linux
Kør den forberedte kommando fra Tilsluttede enheder, eller brug den almindelige installer:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows PowerShell
Kør den forberedte kommando fra Tilsluttede enheder, eller brug:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexInstalleren tilføjer PandaPaw og dets baggrundstjenester, installerer manglende understøttede kodningsmotorer, når det er muligt, og leverer en privat Node.js-runtime, når værtsmaskinen ikke har en egnet. Med en forberedt enhedsnøgle sker kontoparingen under installationen. Med den almindelige kommando skal du godkende browserautorisationsanmodningen, når du bliver bedt om det.
Installeren kan blive færdig, selvom kontogodkendelsen er udskudt. Hvis den siger, at installationen lykkedes, men kontoforbindelsen er ufuldstændig, skal du køre:
pandapaw login3. Bekræft værtsmaskinens tjenester
På værtsmaskinen skal du køre:
pandapaw statusKommandoen skal genkende de installerede tjenester og vise den kontotilknyttede maskine. Hvis skallen ikke kan finde pandapaw, skal du først åbne en ny terminal, så den genindlæser den opdaterede bruger-PATH.
For et Git-projekt kan du også kontrollere, om Agent Center genkender projektets rodmappe:
pandapaw agent status --root /path/to/your/projectBrug en faktisk absolut projektsti. Agent Center-projektbinding fungerer bedst, når mappen har en stabil Git-remote.origin.url.
4. Start den første eksterne session
- Åbn PandaNpc Agent på din telefon, browser eller en anden desktop.
- Find den nyligt tilsluttede maskine. En grøn statusindikator betyder, at værtsmaskinen er tilgængelig lige nu.
- Vælg Claude Code, Codex eller PandaCode, og vælg projektets arbejdsmappe.
- Start en session. Hvis motoren beder dig logge ind, skal du fuldføre den pågældende udbyders autorisation på værtsmaskinen eller via det viste login-flow.
- Send en ikke-destruktiv testprompt som f.eks.:
Vis den aktuelle arbejdsmappe, og oplist topniveau-filerne. Rediger ikke noget.
Du er fuldt forbundet, når svaret navngiver den forventede projektmappe, fillisten matcher værtsmaskinen, og eventuelle tilladelsesspørgsmål vises på den eksterne klient, så du kan godkende eller afvise.
5. Bekræft genforbindelsesadfærd
Luk visningsklienten, vent et par sekunder, og åbn den samme session igen. Den eksisterende historik skal vende tilbage, og værtsmaskinen skal forblive online. Dette kontrollerer den faktiske eksterne sti i stedet for kun at bevise, at installeren blev downloadet korrekt.
Læg ikke værtsmaskinen i dvale under denne test. En sovende eller slukket værtsmaskine kan ikke køre agenten, selvom den gemte forbindelse stadig vises på din konto.
Fejlfinding
Maskinen vises ikke i Agent
Kør pandapaw status på værtsmaskinen. Hvis installationen lykkedes, men ingen konto er tilknyttet, skal du køre pandapaw login. Hvis du brugte en forberedt nøgle, og den allerede er brugt eller udløbet, skal du generere en ny i Tilsluttede enheder og køre den viste kommando igen.
`pandapaw` genkendes ikke
Åbn en ny terminal. På macOS/Linux skal du bekræfte, at ~/.local/bin er i PATH. På Windows tilføjer installeren %LOCALAPPDATA%\Programs\pandapaw til brugerens PATH; en terminal, der blev åbnet før installationen, vil ikke se den nye værdi.
Maskinen er angivet, men offline
Bekræft, at værtsmaskinen er tændt, vågen og i stand til at nå internettet. Kontrollér derefter pandapaw status. Virksomhedsbrandvægge skal tillade udgående HTTPS/WebSocket-trafik; du bør ikke oprette en indgående portvideresendelsesregel.
Forbindelsen virker, men motoren beder om godkendelse
PandaPaw-parring og modeludbyder-login er adskilt. Parring beviser, at værtsmaskinen tilhører din PandaNpc-konto; Claude Code eller Codex kan stadig kræve sit eget abonnementslogin eller API-konfiguration. Fuldfør motorens normale login, og prøv sessionen igen.
Agenten åbner i den forkerte mappe
Afslut den testsession, og opret en med den tilsigtede arbejdsmappe. Før du godkender værktøjsbrug, skal du bede agenten om at udskrive den aktuelle mappe. En ekstern forbindelse tilføjer ikke en filsandkasse i sig selv; motorens værktøjstilladelser og valgte arbejdsmappe forbliver vigtige.
Næste trin
- Læs den fulde PandaPaw-værtsguide for opdateringer, servicekontroller og forbindelsesarkitektur.
- Gennemgå Konto og fakturering for at forstå, hvilket abonnement eller hvilken udbyder der betaler for hver session.
- Tilføj brugerdefinerede AI-udbydere, når du ønsker et OpenAI-kompatibelt endpoint, en selvhostet model eller en separat API Key.