Snabbstart: Kör Claude Code eller Codex på distans

Uppdaterad

Den här guiden ansluter en utvecklingsmaskin till PandaNpc och verifierar att du kan köra Claude Code, Codex eller PandaCode från en annan enhet. Agenten körs fortfarande på din utvecklingsmaskin; PandaNpc ger dig ett synkroniserat fjärrgränssnitt för meddelanden, godkännanden, frågor och sessionshistorik.

De flesta bör använda flödet Lägg till en enhet eftersom det genererar ett engångsinstallationskommando som redan är kopplat till deras konto. Avsätt cirka fem minuter, plus eventuell inloggning hos modellleverantören som din kodningsmotor kräver.

Innan du börjar

Du behöver:

  • Ett PandaNpc-konto öppnat i webbappen, skrivbordsappen eller iOS-appen.
  • En värd som kör Windows x64, macOS eller Linux x86_64.
  • Internetåtkomst från värden och behörighet att installera en bakgrundstjänst på användarnivå.
  • En projektmapp som du har tillåtelse att ändra.
  • Ett Claude-, ChatGPT/Codex- eller anpassat modellkonto om din valda motor inte redan är autentiserad.

Om du bara behöver PandaNpc:s inbyggda chatt och inte vill styra en agent på en annan maskin, krävs inte PandaPaw. Se Installation för alternativ som endast omfattar klienten.

1. Generera värdens installationskommando

Medan du är inloggad öppnar du Anslutna enheter och väljer Lägg till en enhet. PandaNpc skapar en engångsnyckel för enheten och visar exakt kommando för ditt operativsystem.

Kopiera kommandot till maskinen där kodningsagenten ska köras. Behandla det som ett lösenord tills det har använts: en engångsnyckel kopplar ihop en maskin och ska inte publiceras i chatt, skärmbilder, ärenden eller exporterad skalhistorik.

Om du föredrar webbläsarauktorisering i stället för en förberedd nyckel, använd det vanliga installationsprogrammet i nästa steg. Det kör pandapaw login och öppnar auktoriseringssidan åt dig.

2. Installera PandaPaw på värden

macOS eller Linux

Kör det förberedda kommandot från Anslutna enheter, eller använd det vanliga installationsprogrammet:

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

Windows PowerShell

Kör det förberedda kommandot från Anslutna enheter, eller använd:

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

Installationsprogrammet lägger till PandaPaw och dess bakgrundstjänster, installerar saknade kodningsmotorer som stöds när det är möjligt, och tillhandahåller en privat Node.js-runtime när värden inte har en lämplig sådan. Med en förberedd enhetsnyckel sker kontoparningen under installationen. Med det vanliga kommandot godkänner du webbläsarens auktoriseringsbegäran när du uppmanas.

Installationsprogrammet kan avslutas även om kontoauktoriseringen skjuts upp. Om det säger att installationen lyckades men kontakten med kontot är ofullständig, kör du:

bash
pandapaw login

3. Verifiera värdens tjänster

På värden kör du:

bash
pandapaw status

Kommandot bör känna igen de installerade tjänsterna och visa maskinen som är ansluten till kontot. Om skalet inte hittar pandapaw, öppna en ny terminal först så att den läser in den uppdaterade användarens PATH.

För ett Git-projekt kan du också kontrollera om Agent Center känner igen projektroten:

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

Använd en riktig absolut projektsökväg. Agent Centers projektbindning fungerar bäst när katalogen har en stabil Git remote.origin.url.

4. Starta den första fjärrsessionen

  1. Öppna PandaNpc Agent på din telefon, webbläsare eller en annan dator.
  2. Hitta den nyligen anslutna maskinen. En grön statusindikator betyder att värden för närvarande är nåbar.
  3. Välj Claude Code, Codex eller PandaCode och välj projektets arbetskatalog.
  4. Starta en session. Om motorn ber dig logga in, slutför leverantörens auktorisering på värden eller via det visade inloggningsflödet.
  5. Skicka en icke-destruktiv testuppmaning, till exempel: Visa den aktuella arbetskatalogen och lista filerna på den översta nivån. Ändra ingenting.

Du är fullt ansluten när svaret anger den förväntade projektkatalogen, fillistan matchar värden och eventuella behörighetsfrågor visas på fjärrklienten för dig att godkänna eller neka.

5. Bekräfta återanslutningsbeteendet

Stäng visningsklienten, vänta några sekunder och öppna samma session igen. Den befintliga historiken bör återkomma och värden bör förbli online. Detta kontrollerar den faktiska fjärrsökvägen i stället för att bara bevisa att installationsprogrammet laddades ner korrekt.

Lägg inte värden i vila under detta test. En värd som sover eller är avstängd kan inte köra agenten, även om den sparade anslutningen fortfarande visas på ditt konto.

Felsökning

Maskinen visas inte i Agent

Kör pandapaw status på värden. Om installationen lyckades men inget konto är kopplat, kör pandapaw login. Om du använde en förberedd nyckel och den redan har använts eller gått ut, generera en ny under Anslutna enheter och kör det visade kommandot igen.

`pandapaw` känns inte igen

Öppna en ny terminal. På macOS/Linux bekräftar du att ~/.local/bin finns i PATH. På Windows lägger installationsprogrammet till %LOCALAPPDATA%\Programs\pandapaw i användarens PATH; en terminal som öppnades före installationen ser inte det nya värdet.

Maskinen visas men är offline

Bekräfta att värden är påslagen, vaken och kan nå internet. Kontrollera sedan pandapaw status. Företagsbrandväggar måste tillåta utgående HTTPS/WebSocket-trafik; du bör inte skapa en regel för inkommande portvidarebefordran.

Anslutningen fungerar men motorn begär autentisering

PandaPaw-parning och inloggning hos modellleverantören är separata. Parningen bevisar att värden tillhör ditt PandaNpc-konto; Claude Code eller Codex kan fortfarande kräva egen prenumerationsinloggning eller API-konfiguration. Slutför motorns normala inloggning och försök sedan igen.

Agenten öppnas i fel mapp

Avsluta den testsessionen och skapa en med den avsedda arbetskatalogen. Innan du godkänner verktygsanvändning, be agenten att skriva ut den aktuella katalogen. En fjärranslutning lägger inte till en filsystemsandlåda i sig; motorns verktygsbehörigheter och valda arbetskatalog förblir viktiga.

Nästa steg

  • Läs den fullständiga PandaPaw-värdguiden för uppdateringar, tjänstkontroller och anslutningsarkitektur.
  • Gå igenom Konto och fakturering för att förstå vilken prenumeration eller leverantör som betalar för varje session.
  • Lägg till anpassade AI-leverantörer när du vill ha en OpenAI-kompatibel slutpunkt, en självhostad modell eller en separat API-nyckel.