Pornire rapidă: Rulați Claude Code sau Codex de la distanță

Actualizat

Acest ghid conectează un computer de dezvoltare la PandaNpc și verifică că puteți rula Claude Code, Codex sau PandaCode de pe alt dispozitiv. Agentul se execută tot pe computerul dvs. de dezvoltare; PandaNpc vă oferă o interfață remote sincronizată pentru mesaje, aprobări, întrebări și istoricul sesiunii.

Majoritatea utilizatorilor ar trebui să folosească fluxul Add a device, deoarece generează o comandă de instalare unică, deja conectată la contul lor. Acordați aproximativ cinci minute, plus autentificarea la furnizorul de model de care are nevoie motorul de codare.

Înainte de a începe

Aveți nevoie de:

  • Un cont PandaNpc deschis în aplicația web, aplicația de desktop sau aplicația iOS.
  • Un host care rulează Windows x64, macOS sau Linux x86_64.
  • Acces la internet de pe host și permisiunea de a instala un serviciu de fundal la nivel de utilizator.
  • Un folder de proiect pe care aveți voie să îl modificați.
  • Un cont Claude, ChatGPT/Codex sau un model personalizat, dacă motorul ales nu este deja autentificat.

Dacă aveți nevoie doar de chat-ul integrat PandaNpc și nu doriți să controlați un agent pe alt computer, PandaPaw nu este necesar. Consultați Installation pentru opțiunile doar-client.

1. Generați comanda de instalare pentru host

În timp ce sunteți autentificat, deschideți Connected Devices și alegeți Add a device. PandaNpc creează o cheie unică de dispozitiv și afișează comanda exactă pentru sistemul dvs. de operare.

Copiați acea comandă pe computerul unde ar trebui să ruleze agentul de codare. Tratați-o ca pe o parolă până când este folosită: o cheie unică asociază un singur computer și nu trebuie postată în chat, capturi de ecran, issue-uri sau exporturi de istoric shell.

Dacă preferați autorizarea prin browser în locul unei chei pregătite, folosiți installer-ul simplu din pasul următor. Acesta rulează pandapaw login și deschide pagina de autorizare pentru dvs.

2. Instalați PandaPaw pe host

macOS sau Linux

Rulați comanda pregătită din Connected Devices sau folosiți installer-ul simplu:

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

Windows PowerShell

Rulați comanda pregătită din Connected Devices sau folosiți:

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

Installer-ul adaugă PandaPaw și serviciile sale de fundal, instalează motoarele de codare lipsă acceptate, dacă este posibil, și oferă un runtime Node.js privat atunci când host-ul nu are unul potrivit. Cu o cheie de dispozitiv pregătită, asocierea contului are loc în timpul instalării. Cu comanda simplă, aprobați cererea de autorizare din browser când vi se solicită.

Installer-ul se poate finaliza chiar dacă autorizarea contului este amânată. Dacă spune că instalarea a reușit, dar conexiunea contului este incompletă, rulați:

bash
pandapaw login

3. Verificați serviciile host

Pe host, rulați:

bash
pandapaw status

Comanda ar trebui să recunoască serviciile instalate și să afișeze computerul conectat la cont. Dacă shell-ul nu găsește pandapaw, deschideți mai întâi un terminal nou, astfel încât să reîncarce PATH-ul de utilizator actualizat.

Pentru un proiect Git, puteți verifica, de asemenea, dacă Agent Center recunoaște rădăcina proiectului:

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

Folosiți o cale absolută reală de proiect. Legarea proiectului în Agent Center funcționează cel mai bine atunci când directorul are un remote.origin.url Git stabil.

4. Începeți prima sesiune remote

  1. Deschideți PandaNpc Agent pe telefon, browser sau alt desktop.
  2. Găsiți computerul nou conectat. Un indicator de status verde înseamnă că host-ul este accesibil în prezent.
  3. Alegeți Claude Code, Codex sau PandaCode și selectați directorul de lucru al proiectului.
  4. Începeți o sesiune. Dacă motorul vă cere să vă autentificați, finalizați autorizarea respectivului furnizor pe host sau prin fluxul de autentificare afișat.
  5. Trimiteți un prompt de test non-distructiv, cum ar fi: Show the current working directory and list the top-level files. Do not edit anything.

Sunteți complet conectat când răspunsul numește directorul de proiect așteptat, lista de fișiere se potrivește cu host-ul și orice întrebare de permisiune apare pe clientul remote pentru a o aproba sau respinge.

5. Confirmați comportamentul de reconectare

Închideți clientul de vizualizare, așteptați câteva secunde și redeschideți aceeași sesiune. Istoricul existent ar trebui să revină, iar host-ul ar trebui să rămână online. Aceasta verifică calea remote reală, nu doar că installer-ul a fost descărcat cu succes.

Nu puneți host-ul în repaus în timpul acestui test. Un host adormit sau oprit nu poate rula agentul, chiar dacă conexiunea salvată apare încă în contul dvs.

Depanare

Computerul nu apare în Agent

Rulați pandapaw status pe host. Dacă instalarea a reușit dar niciun cont nu este atașat, rulați pandapaw login. Dacă ați folosit o cheie pregătită și aceasta a fost deja folosită sau a expirat, generați una nouă în Connected Devices și rulați din nou comanda afișată.

`pandapaw` nu este recunoscut

Deschideți un terminal nou. Pe macOS/Linux, confirmați că ~/.local/bin este în PATH. Pe Windows, installer-ul adaugă %LOCALAPPDATA%\Programs\pandapaw la PATH-ul de utilizator; un terminal deschis înainte de instalare nu va vedea noua valoare.

Computerul este listat dar offline

Confirmați că host-ul este pornit, trezit și poate accesa internetul. Apoi verificați pandapaw status. Firewall-urile corporative trebuie să permită traficul HTTPS/WebSocket de ieșire; nu ar trebui să creați o regulă de redirecționare a porturilor de intrare.

Conexiunea funcționează dar motorul cere autentificare

Asocierea PandaPaw și autentificarea la furnizorul de model sunt separate. Asocierea dovedește că host-ul aparține contului dvs. PandaNpc; Claude Code sau Codex poate necesita totuși propria autentificare de abonament sau configurare API. Finalizați autentificarea normală a motorului, apoi reîncercați sesiunea.

Agentul se deschide în folderul greșit

Încheiați acea sesiune de test și creați una cu directorul de lucru dorit. Înainte de a aproba utilizarea instrumentelor, cereți agentului să afișeze directorul curent. O conexiune remote nu adaugă un sandbox de fișiere prin ea însăși; permisiunile instrumentelor motorului și directorul de lucru selectat rămân importante.

Pași următori

  • Citiți ghidul complet PandaPaw host guide pentru actualizări, verificări de servicii și arhitectura conexiunii.
  • Revizuiți Account and billing pentru a înțelege ce abonament sau furnizor plătește pentru fiecare sesiune.
  • Adăugați custom AI providers când doriți un endpoint compatibil OpenAI, un model auto-găzduit sau o cheie API separată.