PandaPaw: Gazdă la distanță pentru Claude Code, Codex și PandaCode

PandaPaw transformă o mașină Windows, macOS sau Linux pe care o controlezi într-o gazdă de agenți PandaNpc. Motorul de codare, fișierele proiectului, shell-ul și instrumentele rămân pe acea gazdă; clienții PandaNpc îți oferă o interfață sincronizată de pe un telefon, browser sau alt desktop.

Folosește PandaPaw când mașina care execută munca este diferită de dispozitivul pe care îl ții în mână, când dorești ca o gazdă să supraviețuiască deconectărilor clientului, sau când mai multe motoare de codare ar trebui să partajeze aceeași configurare bazată pe cont și configurația Agent Center.

Ce gestionează PandaPaw

• Conexiuni de agenți la distanță pentru Claude Code, OpenAI Codex și PandaCode.
• Servicii de fundal și pornire automată pentru ca gazda să poată reveni după o repornire normală.
• Autorizarea mașinii pe bază de cont fără a copia manual un Bridge ID, token sau cheie de semnare de lungă durată.
• Asistență pentru instalarea motorului când un motor de codare acceptat lipsește.
• Proiecții Agent Center care redau îndrumările, abilitățile, memoria și definițiile de agent ale fiecărui motor în aspectul său nativ.
• Rețea privată de dispozitive pentru mașinile conectate prin fluxul Connected Devices.
• Evidența actualizărilor și dezinstalărilor pentru ca instrumentele care existau înainte de PandaPaw să fie păstrate.

PandaPaw nu oferă un abonament de model prin el însuși. Claude Code, Codex și PandaCode folosesc în continuare acreditările furnizorului și limitele configurate pentru motorul lor.

Cum funcționează execuția la distanță

Ambele părți inițiază conexiuni de ieșire, astfel încât o configurare normală de acasă sau de birou nu necesită o regulă de firewall de intrare, adresă IP publică, redirecționare de port pe router sau un server SSH expus public. Releul transportă mesaje, stare și aprobări; execuția instrumentelor are loc pe gazdă.

Dacă gazda adoarme, se oprește sau își pierde calea de rețea de ieșire, conexiunea salvată rămâne în contul tău, dar nu poate executa lucrări până când gazda revine.

Platforme de gazdă acceptate

Clientul de vizualizare PandaNpc are o matrice de platforme mai largă. Vezi Instalarea PandaNpc și PandaPaw atunci când alegi pachetele pentru client și gazdă.

Instalare recomandată

1. Conectează-te la PandaNpc.
2. Deschide Connected Devices.
3. Alege Adaugă un dispozitiv. Se emite o cheie de unică folosință și dialogul afișează o singură comandă pentru sistemul de operare detectat.
4. Copiază acea comandă pe gazdă și rule-o acolo.
5. Lasă dialogul deschis dacă vrei să detecteze automat noua mașină.

Cheia pregătită este de unică folosință. Copiază întreaga comandă, păstreaz-o privată și generează una nouă dacă expiră sau a fost deja folosită.

Instalator simplu macOS/Linux

Folosește această formă când dorești autorizare prin browser în locul unei chei pregătite:

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

Instalator simplu PowerShell pentru Windows

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

Instalatorul simplu rulează pandapaw login. Aprobă mașina în pagina de browser pe care o deschide. Dacă autorizarea este întreruptă, binarul și serviciile pot fi totuși instalate; rulează pandapaw login mai târziu pentru a finaliza conexiunea la cont.

Verifică gazda

Mai întâi verifică gazda în sine:

pandapaw status

Apoi deschide PandaNpc Agent și confirmă că mașina are un indicator verde de conectare. Începe o sesiune într-un director de test de unică folosință sau doar în citire și întreabă:

Prompt de test: Afișează directorul de lucru curent și listează fișierele de nivel superior. Nu modifica nimic.

Un răspuns de succes demonstrează mai mult decât un indicator verde de stare: verifică asocierea contului, conectivitatea releului, motorul selectat, autentificarea furnizorului și maparea directorului de lucru.

Pentru un proiect Agent Center, rulează:

pandapaw agent status --root /absolute/path/to/project

Aceasta arată dacă proiectul este legat și dacă configurația gestionată este disponibilă local. Un remote Git stabil ajută PandaPaw să identifice același proiect pe mai multe mașini.

Autorizarea contului și identitatea conexiunii

pandapaw login folosește o sesiune de autorizare a dispozitivului în browser. După ce o aprobi, gazda primește acreditări limitate la dispozitiv și o cheie de verificare Agent Center prin TLS, scrie configurația mașinii sub ~/.pandapaw/, înregistrează conexiunile suportate de motor și leagă proiectele Git recunoscute.

Rulează pandapaw login --force doar atunci când comuți intenționat conturile sau înlocuiești o acreditare de gazdă expirată. Reautorizarea unei mașini sănătoase fără un motiv poate crea identități duplicate sau înlocuite care induc în eroare.

pandapaw qr creează în continuare un link de conexiune manual de scurtă durată pentru compatibilitate și cazuri speciale. Nu este fluxul principal pentru o gazdă nouă; Connected Devices este mai ușor de auditat și nu necesită ca utilizatorii să înțeleagă Bridge ID-urile.

Sincronizarea Agent Center

Agent Center este condus de evenimente în stare stabilă:

1. Modificările locale ale fișierelor gestionate sunt detectate și publicate către proiectul legat.
2. Lansările semnate sosesc printr-un flux de evenimente.
3. Manifestele și blocurile de conținut neschimbate sunt refolosite, nu descărcate din nou.
4. O verificare periodică de recuperare captează evenimentele ratate în timpul unei deconectări temporare.

Claude Code, Codex și PandaCode primesc proiecții separate deoarece așteaptă directoare și formate de instrucțiuni diferite. PandaCode pregătește cea mai recentă lansare verificată înainte de a asambla un nou prompt de sesiune, astfel încât configurația extrasă la pornire poate afecta acea sesiune.

Dacă Agent Center este temporar indisponibil, motorul continuă cu ultima lansare locală verificată. O defecțiune de rețea nu ar trebui să înlocuiască în tăcere configurația semnată cu conținut neverificat.

Comenzi utile

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Verifică istoricul versiunilor PandaPaw atunci când o comandă sau interfața diferă de o captură de ecran sau un tutorial mai vechi.

Limite de securitate

• Un operator de la distanță poate folosi orice instrumente și director de lucru permise de sesiunea de agent selectată. Accesul de la distanță nu este automat doar în citire.
• Păstrează comenzile de dispozitiv de unică folosință, linkurile de conexiune manuală, cheile furnizorului și token-urile de cont în afara jurnalelor și capturilor de ecran.
• Nu deschide porturi de intrare pe router doar pentru a face PandaPaw accesibil.
• Elimină din Connected Devices gazdele pe care nu le mai deții.
• Analizează aprobările instrumentelor și verifică directorul de lucru înainte de a permite editări sau comenzi shell.
• Când partajezi o conexiune activă, destinatarul consumă cota de motor a proprietarului gazdei și poate acționa asupra gazdei. Citește Partajarea conexiunii mai întâi.

Depanare

`pandapaw` nu este găsit după instalare

Deschide un nou terminal pentru a reîncărca PATH-ul utilizatorului. Locațiile obișnuite sunt ~/.local/bin pe macOS/Linux și %LOCALAPPDATA%\Programs\pandapaw pe Windows. Confirmă că fișierul există înainte de a rula din nou instalatorul.

Instalarea a reușit, dar nu apare nicio mașină

Rulează pandapaw status. Dacă mașina nu are autorizare de cont, rulează pandapaw login. Dacă a fost folosită o cheie de unică folosință pregătită, creează o cheie nouă în loc să reîncerci o comandă consumată.

Mașina apare, dar rămâne offline

Confirmă că gazda este pornită și are acces la internet. Verifică local starea PandaPaw. Un proxy sau un firewall corporativ trebuie să permită calea HTTPS/WebSocket de ieșire; un port de intrare nu rezolvă o conexiune de ieșire blocată.

Gazda este online, dar Claude Code sau Codex nu răspunde

Asocierea gazdei nu autentifică fiecare furnizor de model. Deschide motorul local sau urmează promptul de autentificare afișat în sesiunea de la distanță. Confirmă, de asemenea, că modelul selectat există pentru acel cont și că limita sa de utilizare nu este epuizată.

Sesiunea se deschide în proiectul greșit

Încheie testul, selectează directorul de lucru absolut dorit și cere agentului să îl afișeze înainte de a aproba instrumentele. PandaPaw nu ghicește ce depozit ai vrut să spui și nu adaugă un sandbox de sistem de fișiere dincolo de modelul de permisiuni al motorului.

Modificările Agent Center nu apar

Rulează pandapaw agent status --root /path/to/project din rădăcina Git corectă. Confirmă că proiectul este legat, gazda este autentificată și fișierul local face parte dintr-o proiecție gestionată. Păstrează ultima lansare verificată la locul ei în timp ce investighezi, în loc să ștergi directoarele gestionate.

Actualizare și dezinstalare

pandapaw update --restart descarcă binarul curent, verifică suma de control SHA-256, înlocuiește copia instalată și repornește serviciile gestionate pentru ca versiunea să devină activă. Asocierea existentă a contului este păstrată.

pandapaw uninstall folosește manifestul de instalare pentru a elimina elementele create de PandaPaw. Instalările compatibile Claude Code, Codex, PandaCode sau Node care existau deja sunt păstrate intenționat. După dezinstalare, elimină gazda din Connected Devices dacă nu mai trebuie să fie de încredere.