Questa guida collega un computer a PandaNpc Work e verifica che tu possa eseguire Claude Code, Codex o PandaCode da un altro dispositivo. PandaNpc Work è lo spazio di lavoro AI multi-motore in cui deleghi il lavoro e lo segui su più dispositivi. L'agente viene comunque eseguito sul computer collegato; PandaPaw fornisce il bridge e il runtime locale, mentre PandaNpc Work ti offre un'interfaccia sincronizzata per messaggi, approvazioni, domande e cronologia delle sessioni.
Questo percorso è ideale per chi ha già familiarità con Claude Code, Codex o un agente di programmazione simile. La maggior parte delle persone dovrebbe usare il flusso Aggiungi un dispositivo perché genera un comando di installazione monouso già collegato al proprio account. Prevedi circa cinque minuti, più l'eventuale accesso al provider del modello richiesto dal tuo motore di programmazione. Per esplorare l'interfaccia Agent prima di collegare un computer, apri PandaNpc Agent in un browser.
Prima di iniziare
Ti serve:
- Un account PandaNpc aperto nella web app, nell'app desktop o nell'app iOS.
- Un computer collegato con Windows x64, macOS o Linux x86_64.
- Accesso a Internet dall'host e autorizzazione a installare un servizio in background a livello utente.
- Una cartella di progetto che ti è consentito modificare.
- Un account Claude, ChatGPT/Codex o modello personalizzato se il motore scelto non è già autenticato.
Se vuoi solo visualizzare un host già collegato, installa o apri un client sul tuo dispositivo di visualizzazione. PandaPaw va sul computer che esegue l'agente. Vedi Installazione per i ruoli di client e host.
1. Genera il comando di installazione dell'host
Mentre hai effettuato l'accesso, apri Dispositivi collegati e scegli Aggiungi un dispositivo. PandaNpc crea una chiave dispositivo monouso e mostra il comando esatto per il tuo sistema operativo.
Copia quel comando sulla macchina dove deve essere eseguito l'agente di programmazione. Trattalo come una password finché non è stato usato: una chiave monouso accoppia una sola macchina e non deve essere pubblicata in chat, screenshot, issue o esportazioni della cronologia della shell.
Se preferisci l'autorizzazione tramite browser invece di una chiave preparata, usa l'installer semplice nel passaggio successivo. Esegue pandapaw login e apre la pagina di autorizzazione per te.
2. Installa PandaPaw sull'host
macOS o Linux
Esegui il comando preparato da Dispositivi collegati, oppure usa l'installer semplice:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows PowerShell
Esegui il comando preparato da Dispositivi collegati, oppure usa:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexL'installer aggiunge PandaPaw e i suoi servizi in background, installa i motori di programmazione supportati mancanti quando possibile e fornisce un runtime Node.js privato quando l'host non ne ha uno adatto. Con una chiave dispositivo preparata, l'accoppiamento dell'account avviene durante l'installazione. Con il comando semplice, approva la richiesta di autorizzazione del browser quando richiesto.
L'installer potrebbe terminare anche quando l'autorizzazione dell'account è posticipata. Se dice che l'installazione è riuscita ma la connessione all'account è incompleta, esegui:
pandapaw login3. Verifica i servizi dell'host
Sull'host, esegui:
pandapaw statusIl comando dovrebbe riconoscere i servizi installati e mostrare la macchina collegata all'account. Se la shell non trova pandapaw, apri prima un nuovo terminale in modo che ricarichi il PATH utente aggiornato.
Per un progetto Git, puoi anche verificare se Agent Center riconosce la radice del progetto:
pandapaw agent status --root /path/to/your/projectUsa un percorso di progetto assoluto reale. Il binding del progetto di Agent Center funziona meglio quando la directory ha un remote.origin.url Git stabile.
4. Avvia la prima sessione remota
- Apri PandaNpc Agent sul tuo telefono, browser o un altro desktop.
- Trova la macchina appena collegata. Un indicatore di stato verde significa che l'host è attualmente raggiungibile.
- Scegli Claude Code, Codex o PandaCode e seleziona la directory di lavoro del progetto.
- Avvia una sessione. Se il motore ti chiede di accedere, completa l'autorizzazione di quel provider sull'host o tramite il flusso di accesso visualizzato.
- Invia un prompt di test non distruttivo come:
Show the current working directory and list the top-level files. Do not edit anything.
Sei completamente collegato quando la risposta indica la directory di progetto prevista, l'elenco dei file corrisponde all'host e qualsiasi domanda di autorizzazione appare sul client remoto per approvarla o negarla.
5. Conferma il comportamento di riconnessione
Chiudi il client di visualizzazione, attendi qualche secondo e riapri la stessa sessione. La cronologia esistente dovrebbe tornare e l'host dovrebbe rimanere online. Questo verifica il percorso remoto effettivo invece di dimostrare solo che l'installer è stato scaricato correttamente.
Non mettere l'host in sospensione durante questo test. Un host in sospensione o spento non può eseguire l'agente anche se la connessione salvata appare ancora nel tuo account.
Risoluzione dei problemi
La macchina non appare in Agent
Esegui pandapaw status sull'host. Se l'installazione è riuscita ma nessun account è collegato, esegui pandapaw login. Se hai usato una chiave preparata ed è già stata riscattata o è scaduta, generane una nuova in Dispositivi collegati e riesegui il comando visualizzato.
`pandapaw` non viene riconosciuto
Apri un nuovo terminale. Su macOS/Linux, conferma che ~/.local/bin sia in PATH. Su Windows, l'installer aggiunge %LOCALAPPDATA%\Programs\pandapaw al PATH utente; un terminale aperto prima dell'installazione non vedrà il nuovo valore.
La macchina è elencata ma offline
Conferma che l'host sia acceso, sveglio e in grado di raggiungere Internet. Poi controlla pandapaw status. I firewall aziendali devono consentire il traffico HTTPS/WebSocket in uscita; non dovresti creare una regola di port-forwarding in entrata.
La connessione funziona ma il motore chiede l'autenticazione
L'accoppiamento di PandaPaw e l'accesso al provider del modello sono separati. L'accoppiamento dimostra che l'host appartiene al tuo account PandaNpc; Claude Code o Codex potrebbero comunque richiedere il proprio accesso in abbonamento o la configurazione API. Completa il normale accesso del motore, poi riprova la sessione.
L'agente si apre nella cartella sbagliata
Termina quella sessione di test e creane una con la directory di lavoro prevista. Prima di approvare l'uso degli strumenti, chiedi all'agente di stampare la directory corrente. Una connessione remota non aggiunge di per sé una sandbox del filesystem; i permessi degli strumenti del motore e la directory di lavoro selezionata rimangono importanti.
Passaggi successivi
- Leggi la guida completa guida host PandaPaw per aggiornamenti, controlli dei servizi e architettura della connessione.
- Consulta Account e fatturazione per capire quale abbonamento o provider paga ogni sessione.
- Aggiungi provider AI personalizzati quando desideri un endpoint compatibile con OpenAI, un modello self-hosted o una API Key separata.