Instalarea PandaNpc și PandaPaw

Actualizat

O configurare de agent de codificare la distanță are două părți independente:

  • Client PandaNpc — interfața pe care o folosești pentru a citi sesiunile, a trimite solicitări și a aproba uneltele. Rulează pe web, iOS, Windows, macOS și Linux.
  • Gazdă PandaPaw — serviciul de fundal pe computerul unde Claude Code, Codex sau PandaCode execută efectiv.

Instalați doar clientul pentru chat PandaNpc și utilizarea desktop locală. Instalați ambele părți atunci când doriți să accesați un agent de codificare care rulează pe alt computer.

Vezi PandaNpc Desktop pentru ce adaugă aplicația Windows/macOS/Linux față de pașii de instalare de mai jos, inclusiv istoricul versiunilor.

Alege ce să instalezi

Scenariu Client Gazdă PandaPaw
Folosești chatul PandaNpc într-un browser Deschide aplicația web Nu este necesară
Controlezi un agent pe același desktop Aplicație desktop Depinde de modul local/distant selectat
Controlezi un computer de dezvoltare de pe telefon sau browser Instalezi/deschizi un client pe dispozitivul de vizualizare Necesară pe computerul de dezvoltare
Rulezi agenți pe un server fără desktop grafic Web, desktop sau iOS de altă parte Necesară pe server

Pentru cel mai scurt traseu end-to-end, folosește Ghidul de pornire rapidă.

Instalează un client PandaNpc

Folosește pagina de descărcare PandaNpc ca sursă de adevăr pentru instalatorii actuali. Evită site-urile de descărcare terțe, deoarece pot oferi pachete vechi sau modificate.

Web

Deschide pandanpc.com/agent într-un browser actual. Nu se instalează nimic. Stocarea browserului păstrează starea locală de autentificare, așa că ferestrele private/incognito pot necesita să te autentifici din nou.

iOS

Urmărește linkul App Store de pe pagina de descărcare și instalează PandaNpc. iOS este util pentru a verifica progresul, a răspunde la întrebări și a aproba unelte cât timp ești departe de gazdă. Procesul de codificare rulează în continuare pe mașina gazdă conectată. Vezi PandaNpc pentru iOS pentru ce acoperă aplicația, inclusiv istoricul versiunilor.

Windows

  1. Descarcă instalatorul Windows actual.
  2. Rulează-l și urmează instrucțiunile instalatorului.
  3. Pornește PandaNpc din meniul Start.
  4. Dacă Windows afișează un avertisment de editor sau de reputație, verifică că fișierul provine de la pandanpc.com înainte de a continua.

macOS

  1. Descarcă .dmg pentru macOS.
  2. Trage PandaNpc în Applications.
  3. Pornește-l din Applications și finalizează orice solicitare de securitate macOS.

Versiunea macOS este universală, astfel încât același pachet suportă Apple Silicon și Mac-urile Intel.

Linux

Descarcă AppImage x86_64, fă-l executabil și rulează-l:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Dacă AppImage nu pornește, rulează-l o dată din terminal și păstrează exact rezultatul erorii. Distribuțiile mai vechi pot să nu aibă o bibliotecă de rulare necesară pentru shell-ul desktop.

Instalează PandaPaw pe gazda agentului

PandaPaw oferă în prezent instalatori de gazdă pentru Windows x64, macOS universal și Linux x86_64. Rulează comanda pe computerul care deține fișierele proiectului și care ar trebui să execute uneltele agentului.

Traseul recomandat este Dispozitive conectate: alege Adaugă un dispozitiv, apoi copiază comanda unică generată. Aceasta asociază gazda cu contul tău în timpul instalării.

macOS sau Linux

Instalator simplu cu autorizare în browser:

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

Formular cu cheie unică pregătită:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Instalator simplu:

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

Formular cu cheie unică pregătită:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Pipeline-ul iwr | iex din PowerShell nu poate transmite argumente normale de script, așa că instalatorul Windows citește cheia unică din PANDANET_KEY.

Ce modifică instalatorul gazdei

Instalatorul:

  1. Adaugă PandaPaw în directorul application/bin al utilizatorului curent și actualizează PATH-ul utilizatorului când este necesar.
  2. Înregistrează serviciile de fundal corespunzătoare pentru a porni automat.
  3. Instalează motoarele de codificare suportate care lipsesc, atunci când platforma permite acest lucru.
  4. Furnizează un runtime Node.js privat când sistemul nu are o versiune potrivită.
  5. Pornește autorizarea contului sau răscumpără cheia de dispozitiv pregătită.
  6. Înregistrează ce fișiere a creat, astfel încât dezinstalarea să poată păstra uneltele compatibile care existau deja.

Instalarea unui motor nu cumpără automat și nu autentifică un abonament de model. Claude Code și Codex pot solicita în continuare propria autentificare de furnizor la prima rulare.

Verifică instalarea

Deschide un terminal nou după instalare și rulează:

bash
pandapaw status

Apoi deschide PandaNpc Agent. Gazda ar trebui să apară online. Începe o sesiune într-un proiect de test și cere-i să raporteze directorul de lucru curent fără să modifice fișiere. Aceasta verifică binarul, serviciul de fundal, asocierea contului, conexiunea de releu, motorul și directorul selectat—nu doar pasul de descărcare.

Actualizare

Clienții desktop te anunță când este disponibilă o actualizare. iOS se actualizează prin App Store.

Actualizează PandaPaw și repornește serviciile sale gestionate cu:

bash
pandapaw update --restart

Actualizatorul verifică binarul descărcat față de suma de control SHA-256 publicată înainte de a înlocui copia instalată. Asocierea contului tău și identitatea conexiunii existente sunt păstrate. Repornirea comenzii de instalare este, de asemenea, suportată atunci când actualizatorul în sine nu este disponibil.

Dezinstalare

  • Client Windows: Setări → Aplicații → Aplicații instalate → PandaNpc → Dezinstalare.
  • Client macOS: închide PandaNpc, apoi mută-l din Applications în Coș.
  • Client Linux: elimină AppImage și orice lansator creat pentru el.
  • Gazdă PandaPaw: rulează pandapaw uninstall pe gazdă.

Manifestul de dezinstalare al PandaPaw distinge uneltele create de instalator de uneltele compatibile care existau deja. Este în mod intenționat conservator, mai degrabă decât să șteargă o instalare preexistentă Claude Code, Codex, PandaCode sau Node.

Probleme de instalare

Comanda s-a terminat, dar gazda nu este conectată

Rulează pandapaw login. Instalarea gazdei și autorizarea contului sunt etape separate, iar instalatorul se poate finaliza chiar dacă autorizarea în browser a fost amânată sau întreruptă.

Shell-ul nu poate găsi `pandapaw`

Deschide un terminal nou. Pe macOS/Linux, verifică ~/.local/bin; pe Windows, verifică %LOCALAPPDATA%\Programs\pandapaw. Nu reinstala în mod repetat până nu ai confirmat dacă executabilul există și doar PATH este învechit.

Un motor de codificare nu s-a instalat

Instalatorul gazdei tratează descărcările opționale de motoare ca fiind best effort, astfel încât o întrerupere a unui furnizor să nu elimine o instalare PandaPaw funcțională. Instalează sau repară acel motor folosind instalatorul său oficial, autentifică-l normal, apoi rulează din nou pandapaw status.

AppImage sau aplicația desktop nu se deschide

Confirmă că ai descărcat pachetul pentru arhitectura corectă, apoi pornește-l dintr-un terminal pentru a captura prima eroare. Include acea eroare și versiunea sistemului tău de operare când contactezi suportul; capturile de ecran ale unei ferestre închise nu sunt de obicei suficiente pentru a diagnostica o bibliotecă de rulare lipsă.

Pentru verificări ale conexiunii specifice gazdei, continuă cu Ghidul PandaPaw sau cu Întrebările frecvente.