Pornire rapidă PandaNpc Work: Conectează-ți primul agent

Începe să folosești PandaNpc Work, spațiul de lucru AI multi-motor. Conectează un computer cu PandaPaw, alege un motor de agent și verifică o sesiune la distanță.

Actualizat

Acest ghid conectează un computer la PandaNpc Work și verifică dacă poți rula Claude Code, Codex sau PandaCode de pe alt dispozitiv. PandaNpc Work este spațiul de lucru AI multi-motor în care delegi sarcini și le urmărești pe mai multe dispozitive. Agentul rulează în continuare pe computerul conectat; PandaPaw oferă puntea și runtime-ul local, în timp ce PandaNpc Work îți oferă o interfață sincronizată pentru mesaje, aprobări, întrebări și istoricul sesiunilor.

Această cale este potrivită pentru persoanele care sunt deja familiarizate cu Claude Code, Codex sau un agent de programare similar. Majoritatea oamenilor ar trebui să folosească fluxul Adaugă un dispozitiv, deoarece generează o comandă de instalare unică deja asociată contului lor. Acordă aproximativ cinci minute, plus orice autentificare la furnizorul de modele necesară de motorul tău de programare. Pentru a explora interfața Agent înainte de a conecta un computer, deschide PandaNpc Agent într-un browser.

Înainte de a începe

Ai nevoie de:

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

Dacă vrei doar să vizualizezi o gazdă deja conectată, instalează sau deschide un client pe dispozitivul tău de vizualizare. PandaPaw aparține computerului care rulează agentul. Vezi Instalare pentru rolurile de client și gazdă.

1. Generează comanda de instalare pentru gazdă

În timp ce ești autentificat, deschide Dispozitive conectate și alege Adaugă un dispozitiv. PandaNpc creează o cheie de dispozitiv unică și afișează comanda exactă pentru sistemul tău de operare.

Copiază acea comandă pe mașina unde ar trebui să ruleze agentul de programare. Trateaz-o ca pe o parolă până când a fost folosită: o cheie unică asociază o singură mașină și nu trebuie postată în chat, capturi de ecran, probleme sau exporturi de istoric shell.

Dacă preferi autorizarea prin browser în locul unei chei pregătite, folosește instalatorul simplu din pasul următor. Acesta rulează pandapaw login și deschide pagina de autorizare pentru tine.

2. Instalează PandaPaw pe gazdă

macOS sau Linux

Rulează comanda pregătită din Dispozitive conectate sau folosește instalatorul simplu:

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

Windows PowerShell

Rulează comanda pregătită din Dispozitive conectate sau folosește:

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

Instalatorul adaugă PandaPaw și serviciile sale de fundal, instalează motoarele de programare acceptate lipsă atunci când este posibil și oferă un runtime Node.js privat atunci când gazda nu are unul adecvat. Cu o cheie de dispozitiv pregătită, asocierea contului are loc în timpul instalării. Cu comanda simplă, aprobă cererea de autorizare prin browser când ți se solicită.

Instalatorul se poate termina chiar dacă autorizarea contului este amânată. Dacă spune că instalarea a reușit, dar conexiunea contului este incompletă, rulează:

bash
pandapaw login

3. Verifică serviciile gazdă

Pe gazdă, rulează:

bash
pandapaw status

Comanda ar trebui să recunoască serviciile instalate și să afișeze mașina conectată la cont. Dacă shell-ul nu poate găsi pandapaw, deschide mai întâi un terminal nou pentru a reîncărca PATH-ul utilizatorului actualizat.

Pentru un proiect Git, poți verifica și dacă Centrul de agenți recunoaște rădăcina proiectului:

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

Folosește o cale absolută reală către proiect. Asocierea proiectului în Centrul de agenți funcționează cel mai bine când directorul are un remote.origin.url Git stabil.

4. Începe prima sesiune la distanță

  1. Deschide PandaNpc Agent pe telefon, browser sau alt desktop.
  2. Găsește mașina nou conectată. Un indicator de stare verde înseamnă că gazda este accesibilă în prezent.
  3. Alege Claude Code, Codex sau PandaCode și selectează directorul de lucru al proiectului.
  4. Începe o sesiune. Dacă motorul îți cere să te autentifici, finalizează autorizarea acelui furnizor pe gazdă sau prin fluxul de autentificare afișat.
  5. Trimite un prompt de test non-distructiv, cum ar fi: Show the current working directory and list the top-level files. Do not edit anything.

Ești pe deplin conectat atunci când răspunsul numește directorul de proiect așteptat, lista de fișiere corespunde gazdei și orice întrebare de permisiune apare pe clientul de la distanță pentru ca tu să o aprobi sau să o refuzi.

5. Confirmă comportamentul de reconectare

Închide clientul de vizualizare, așteaptă câteva secunde și redeschide aceeași sesiune. Istoricul existent ar trebui să revină, iar gazda ar trebui să rămână online. Aceasta verifică calea reală de la distanță, în loc să dovedească doar că instalatorul s-a descărcat cu succes.

Nu adormi gazda în timpul acestui test. O gazdă adormită sau oprită nu poate rula agentul, chiar dacă conexiunea salvată apare în continuare în contul tău.

Depanare

Mașina nu apare în Agent

Rulează pandapaw status pe gazdă. Dacă instalarea a reușit, dar niciun cont nu este atașat, rulează pandapaw login. Dacă ai folosit o cheie pregătită și aceasta a fost deja revendicată sau a expirat, generează una nouă în Dispozitive conectate și rulează din nou comanda afișată.

`pandapaw` nu este recunoscut

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

Mașina este listată, dar offline

Confirmă că gazda este pornită, trează și poate accesa internetul. Apoi verifică pandapaw status. Firewall-urile corporative trebuie să permită traficul HTTPS/WebSocket de ieșire; nu ar trebui să creezi o regulă de redirecționare a porturilor de intrare.

Conexiunea funcționează, dar motorul cere autentificare

Asocierea PandaPaw și autentificarea la furnizorul de modele sunt separate. Asocierea demonstrează că gazda aparține contului tău PandaNpc; Claude Code sau Codex pot necesita în continuare propria autentificare prin abonament sau configurare API. Finalizează autentificarea normală a motorului, apoi reîncearcă sesiunea.

Agentul se deschide în folderul greșit

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

Pași următori