Installa PandaNpc e PandaPaw

Aggiornato

Una configurazione di agente di codifica remota ha due parti indipendenti:

  • Client PandaNpc — l'interfaccia che usi per leggere le sessioni, inviare prompt e approvare gli strumenti. È disponibile sul web, iOS, Windows, macOS e Linux.
  • Host PandaPaw — il servizio in background sul computer dove Claude Code, Codex o PandaCode vengono effettivamente eseguiti.

Installa solo il client per la chat PandaNpc e per l'uso desktop locale. Installa entrambe le parti quando vuoi raggiungere un agente di codifica in esecuzione su un'altra macchina.

Vedi PandaNpc Desktop per cosa aggiunge l'app Windows/macOS/Linux rispetto ai passaggi di installazione seguenti, inclusa la cronologia delle versioni.

Scegli cosa installare

Scenario Client Host PandaPaw
Usa la chat PandaNpc in un browser Apri l'app web Non richiesto
Controlla un agente su questo stesso desktop App desktop Dipende dalla modalità locale/remota selezionata
Controlla una macchina di sviluppo da telefono o browser Installa/apri un client sul dispositivo di visualizzazione Richiesto sulla macchina di sviluppo
Esegui agenti su un server senza desktop grafico Web, desktop o iOS altrove Richiesto sul server

Per il percorso end-to-end più breve, usa la Guida rapida.

Installa un client PandaNpc

Usa la pagina di download di PandaNpc come fonte autorevole per gli installer attuali. Evita siti di download di terze parti perché potrebbero offrire pacchetti vecchi o modificati.

Web

Apri pandanpc.com/agent in un browser aggiornato. Non viene installato nulla. L'archiviazione del browser mantiene lo stato di accesso locale, quindi le finestre private/navigazione in incognito potrebbero richiederti di accedere di nuovo.

iOS

Segui il link App Store nella pagina di download e installa PandaNpc. iOS è utile per controllare i progressi, rispondere a domande e approvare strumenti quando sei lontano dall'host. Il processo di codifica continua a essere eseguito sulla macchina host connessa. Vedi PandaNpc per iOS per cosa copre l'app, inclusa la cronologia delle versioni.

Windows

  1. Scarica l'installer Windows corrente.
  2. Eseguilo e segui le istruzioni dell'installer.
  3. Avvia PandaNpc dal menu Start.
  4. Se Windows mostra un avviso sull'editore o sulla reputazione, verifica che il file provenga da pandanpc.com prima di continuare.

macOS

  1. Scarica il file .dmg per macOS.
  2. Trascina PandaNpc in Applicazioni.
  3. Avvialo da Applicazioni e completa qualsiasi richiesta di sicurezza di macOS.

La build macOS è universale, quindi lo stesso pacchetto supporta Apple Silicon e Mac Intel.

Linux

Scarica l'AppImage x86_64, rendilo eseguibile ed eseguilo:

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

Se l'AppImage non si avvia, eseguilo da un terminale una volta e conserva l'output esatto dell'errore. Le distribuzioni più vecchie potrebbero non avere una libreria runtime richiesta dalla shell desktop.

Installa PandaPaw sull'host dell'agente

PandaPaw attualmente fornisce installer host per Windows x64, macOS universale e Linux x86_64. Esegui il comando sul computer che possiede i file di progetto e che dovrebbe eseguire gli strumenti dell'agente.

Il percorso consigliato è Dispositivi connessi: scegli Aggiungi un dispositivo, poi copia il comando monouso generato. Associa l'host al tuo account durante l'installazione.

macOS o Linux

Installer semplice con autorizzazione tramite browser:

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

Versione con chiave monouso preparata:

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

Windows PowerShell

Installer semplice:

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

Versione con chiave monouso preparata:

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

La pipeline iwr | iex di PowerShell non può passare argomenti di script normali, quindi l'installer Windows legge la chiave monouso da PANDANET_KEY.

Cosa modifica l'installer host

L'installer:

  1. Aggiunge PandaPaw alla directory application/bin dell'utente corrente e aggiorna il PATH dell'utente quando necessario.
  2. Registra i servizi in background appropriati per l'avvio automatico.
  3. Installa i motori di codifica supportati che mancano quando la piattaforma lo consente.
  4. Fornisce un runtime Node.js privato quando il sistema non ha una versione adatta.
  5. Avvia l'autorizzazione dell'account o riscatta la chiave del dispositivo preparata.
  6. Registra i file che ha creato, così la disinstallazione può preservare gli strumenti compatibili già presenti.

L'installazione di un motore non acquista automaticamente né autentica un abbonamento al modello. Claude Code e Codex possono comunque richiedere il proprio accesso al provider la prima volta che vengono eseguiti.

Verifica l'installazione

Apri un nuovo terminale dopo l'installazione ed esegui:

bash
pandapaw status

Poi apri PandaNpc Agent. L'host dovrebbe apparire online. Avvia una sessione in un progetto di test e chiedile di riportare la directory di lavoro corrente senza modificare file. Questo verifica il binario, il servizio in background, l'associazione dell'account, la connessione relay, il motore e la directory selezionata—non solo il passaggio di download.

Aggiornamento

I client desktop ti notificano quando è disponibile un aggiornamento. iOS si aggiorna tramite l'App Store.

Aggiorna PandaPaw e riavvia i suoi servizi gestiti con:

bash
pandapaw update --restart

L'aggiornatore verifica il binario scaricato rispetto al checksum SHA-256 pubblicato prima di sostituire la copia installata. L'associazione dell'account e l'identità di connessione esistente vengono preservate. È anche possibile eseguire nuovamente il comando di installazione quando l'aggiornatore stesso non è disponibile.

Disinstallazione

  • Client Windows: Impostazioni → App → App installate → PandaNpc → Disinstalla.
  • Client macOS: esci da PandaNpc, poi spostalo da Applicazioni al Cestino.
  • Client Linux: rimuovi l'AppImage e qualsiasi launcher che hai creato per esso.
  • Host PandaPaw: esegui pandapaw uninstall sull'host.

Il manifest di disinstallazione di PandaPaw distingue gli strumenti creati dall'installer dagli strumenti compatibili già esistenti. È intenzionalmente prudente, piuttosto che eliminare un'installazione preesistente di Claude Code, Codex, PandaCode o Node.

Problemi di installazione

Il comando è terminato ma l'host non è connesso

Esegui pandapaw login. L'installazione dell'host e l'autorizzazione dell'account sono fasi separate e l'installer può completarsi anche se l'autorizzazione del browser è stata rinviata o interrotta.

La shell non riesce a trovare `pandapaw`

Apri un nuovo terminale. Su macOS/Linux, controlla ~/.local/bin; su Windows, controlla %LOCALAPPDATA%\Programs\pandapaw. Non reinstallare ripetutamente finché non hai confermato se l'eseguibile esiste e se solo PATH è obsoleto.

Un motore di codifica non è riuscito a installarsi

L'installer host tratta i download facoltativi del motore come un tentativo, così un'interruzione di un provider non rimuove un'installazione PandaPaw funzionante. Installa o ripara quel motore usando il suo installer ufficiale, autenticalo normalmente, poi esegui di nuovo pandapaw status.

L'AppImage o l'applicazione desktop non si aprono

Conferma di aver scaricato il pacchetto per l'architettura corretta, poi avvialo da un terminale per catturare il primo errore. Includi quell'errore e la versione del tuo sistema operativo quando contatti il supporto; gli screenshot di una finestra chiusa di solito non bastano per diagnosticare una libreria runtime mancante.

Per controlli di connessione specifici dell'host, continua con la guida PandaPaw o le FAQ.