Avvio rapido: esegui Claude Code o Codex in remoto

Aggiornato

Questa guida collega una macchina di sviluppo a PandaNpc e verifica che puoi eseguire Claude Code, Codex o PandaCode da un altro dispositivo. L'agente viene comunque eseguito sulla tua macchina di sviluppo; PandaNpc ti offre un'interfaccia remota sincronizzata per messaggi, approvazioni, domande e cronologia delle sessioni.

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 di modelli richiesto dal tuo motore di codifica.

Prima di iniziare

Ti serve:

  • Un account PandaNpc aperto nell'app web, nell'app desktop o nell'app iOS.
  • Un host con Windows x64, macOS o Linux x86_64.
  • Accesso a Internet dall'host e permesso di installare un servizio in background a livello utente.
  • Una cartella di progetto che hai il permesso di modificare.
  • Un account Claude, ChatGPT/Codex o modello personalizzato se il motore scelto non è già autenticato.

Se hai bisogno solo della chat integrata di PandaNpc e non vuoi controllare un agente su un'altra macchina, PandaPaw non è necessario. Vedi Installazione per le opzioni solo client.

1. Genera il comando di installazione per l'host

Dopo aver effettuato l'accesso, apri Dispositivi connessi 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 in cui deve essere eseguito l'agente di codifica. Trattalo come una password finché non è stato usato: una chiave monouso associa una singola macchina e non deve essere pubblicata in chat, screenshot, issue o esportazioni della cronologia di 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 connessi, oppure usa l'installer semplice:

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

Windows PowerShell

Esegui il comando preparato da Dispositivi connessi, oppure usa:

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

L'installer aggiunge PandaPaw e i suoi servizi in background, installa i motori di codifica 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'associazione dell'account avviene durante l'installazione. Con il comando semplice, approva la richiesta di autorizzazione del browser quando viene richiesto.

L'installer potrebbe terminare anche se l'autorizzazione dell'account è stata rimandata. Se dice che l'installazione è riuscita ma la connessione dell'account è incompleta, esegui:

bash
pandapaw login

3. Verifica i servizi dell'host

Sull'host, esegui:

bash
pandapaw status

Il comando dovrebbe riconoscere i servizi installati e mostrare la macchina connessa all'account. Se la shell non trova pandapaw, apri prima un nuovo terminale per ricaricare il PATH utente aggiornato.

Per un progetto Git, puoi anche verificare se Agent Center riconosce la radice del progetto:

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

Usa un percorso assoluto reale del progetto. L'associazione del progetto in Agent Center funziona al meglio quando la directory ha un remote.origin.url Git stabile.

4. Avvia la prima sessione remota

  1. Apri PandaNpc Agent sul telefono, sul browser o su un altro desktop.
  2. Trova la macchina appena connessa. Un indicatore di stato verde significa che l'host è attualmente raggiungibile.
  3. Scegli Claude Code, Codex o PandaCode e seleziona la directory di lavoro del progetto.
  4. Avvia una sessione. Se il motore ti chiede di accedere, completa l'autorizzazione del provider sull'host o tramite il flusso di accesso mostrato.
  5. Invia un prompt di prova non distruttivo, ad esempio: Mostra la directory di lavoro corrente ed elenca i file di primo livello. Non modificare nulla.

Sei completamente connesso quando la risposta indica la directory di progetto prevista, l'elenco dei file corrisponde a quello dell'host e qualsiasi richiesta di autorizzazione appare sul client remoto per essere approvata o respinta.

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 utilizzata o è scaduta, generane una nuova in Dispositivi connessi e riesegui il comando mostrato.

`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 forwarding delle porte in entrata.

La connessione funziona ma il motore richiede l'autenticazione

L'associazione di PandaPaw e l'accesso al provider di modelli sono separati. L'associazione 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 l'accesso normale 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 desiderata. 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; le autorizzazioni degli strumenti del motore e la directory di lavoro selezionata rimangono importanti.

Passaggi successivi