Prima di allontanarti per la prima volta dal computer

Installazione del Server, accoppiamento del telefono con un codice QR, connessione diretta contro Relay e il primo compito per l'Agente. Passo per passo.

12 minuti Aggiornato 2026-09-13

Cosa ti servirà

Un computer con macOS, Windows o Ubuntu, su cui si trova il progetto su cui vuoi lavorare.
Node.js 20 o più recente — è lì che gira l'Agente.
Le credenziali per l'API di Anthropic nella variabile ANTHROPIC_API_KEY, oppure un abbonamento Claude a cui l'Agente accede da sé.
Un telefono con l'app coden e una fotocamera.

Un server tuo non serve. Il Rendezvous e il Relay, attraverso cui telefono e computer si trovano, li teniamo noi e il Server li conosce già.

1. Installa il Server

Scarica il pacchetto per il tuo sistema dalla pagina di download. Ogni sistema ha il proprio installer e tutti fanno la stessa cosa: mettono il comando coden nel PATH, così poi lo avvii da qualsiasi posto.

macOS: Doppio clic sul .pkg e scorrere la procedura guidata. Il pacchetto è firmato e notarizzato, quindi Gatekeeper non chiede niente.
Windows: Doppio clic sul .msi e scorrere la procedura guidata. Dopo l'installazione apri una nuova finestra della riga di comando: in quella vecchia la modifica del PATH non arriva.
Ubuntu e Debian: Un doppio clic sul .deb lo apre nell'installer di sistema. Dal terminale è sudo apt install ./coden_*.deb.

$ coden --version

Quando il comando non viene trovato, apri un terminale nuovo. Il PATH non arriva in quelli già aperti.

2. Avvia il Server sul progetto

Il Server serve una directory. Quella che gli passi è esattamente quella in cui l'Agente lavorerà ed eseguirà i comandi. Niente del progetto viene salvato fuori da essa.

$ cd ~/projekty/muj-projekt
$ coden start

Senza altre opzioni il Server serve la directory in cui l'hai avviato. Un'altra si può passare con --dir:

$ coden start --dir ~/projekty/jiny-projekt

Il Server resta in primo piano e scrive cosa succede. Lascia quella finestra aperta — è l'unico posto in cui vedrai che qualcuno si è connesso.

Più progetti significa più Server, ciascuno nella sua finestra. Nell'applicazione poi passi tra di essi, e ciascuno tiene le proprie Conversazioni, i test e la cronologia.

3. Associa il telefono

In una seconda finestra di terminale, mentre il Server gira:

$ coden pair

Compare un codice QR. Nell'app tocca Associa e inquadralo con la fotocamera. Il codice vale qualche minuto e per una sola associazione — una volta usato non serve più.

Quel codice non mostrarlo a nessuno e non fotografarlo. Oltre all'identità del tuo computer porta l'accesso al Servizio. Chi ce l'ha arriva più in là di quanto vorresti.

4. Connessione diretta o tramite il Relay

Dopo l'accoppiamento il telefono si collega da sé, e nell'applicazione si vede per quale via. La differenza non devi impostarla — viene scelta la migliore tra le possibilità rimaste — ma è bene sapere cosa significa ciascuno stato:

Connessione diretta: I dati scorrono dal telefono al computer e da nessun'altra parte. Il più rapido, nessuna quota, niente passa attraverso il nostro Servizio. Funziona quando i due dispositivi sono sulla stessa rete o quando si riesce a bucare il NAT.
Tramite il Relay: I dati li passa il nostro server. Sui dati mobili e nelle reti aziendali, dove una connessione diretta non è possibile, è l'unica via. Il traffico è cifrato dal telefono al Server, quindi il contenuto non lo vediamo: lo inoltriamo soltanto.

L'applicazione prova da sé a passare alla diretta appena può, tipicamente quando torni a casa sul wi-fi. Il Relay si può disattivare nelle Impostazioni; ma allora, su una rete che non consente la connessione diretta, non ti collegherai affatto.

Rendezvous è la parte del Servizio che presenta le due parti. Senza di essa il telefono non saprebbe dove collegarsi: l'indirizzo del computer cambia, del resto. Trasportare dati attraverso di essa però non si può.

5. Affida il primo compito

Comincia con qualcosa su cui sai giudicare se l'Agente l'ha fatto bene. Per esempio:

Leggi il README e dimmi cosa gli manca perché con quello si possa avviare il progetto su un computer pulito.

Strada facendo vedrai quali file l'Agente legge e cosa esegue. Al primo comando ti chiederà il permesso — è normale ed è l'impostazione predefinita. Quando vuoi che smetta di chiedere per un certo tipo di azione, concedi un permesso permanente; si può togliere in qualsiasi momento nelle Impostazioni.

Lì lavora Claude Code, cioè lo stesso Agente che conosci dal terminale. Sa fare le stesse cose e si comporta allo stesso modo; la differenza è solo che input e output passano per il telefono e che CLAUDE.md, gli skill e le impostazioni nel progetto valgono esattamente come al computer.

6. Allontanati dal computer

Questa è la parte per cui coden esiste. Dai un compito più lungo, blocca il telefono e vai. L'Agente continua a lavorare. Quando finisce arriva una notifica; quando ti connetti arriva tutto l'output che nel frattempo ti è sfuggito.

Perché questo funzioni, il computer non deve addormentarsi: per questo c'è una guida a parte. E se non vuoi dover tornare per approvare, dai un'occhiata a il permesso di lavorare senza approvazioni.

Quando il telefono non si connette

L'app dice «il codice di associazione è scaduto»: Esegui coden pair di nuovo. Il codice dura poco apposta.
Il telefono è sotto dati mobili e la connessione non si stabilisce: Alcune reti mobili non permettono la connessione diretta. Controlla nell'app che il Relay sia consentito — senza di esso su una rete così non ti connetti.
L'app segnala una chiave che non corrisponde: Il Server ha un'identità diversa da quella che il telefono ricorda — di solito perché hai cancellato la sua directory di stato. Associa di nuovo. Continuare «lo stesso» l'app non te lo offre di proposito.
«Il Server sta servendo un altro dispositivo»: È connesso un altro telefono associato. Elencali con il comando coden clients.

Comandi utili

$ coden status    # gira? chi è connesso? da quanto?
$ coden clients   # dispositivi associati, ultima connessione
$ coden stop      # chiusura ordinata

Si è inceppato da qualche altra parte rispetto a quanto c'è qui? Scrivi a support@coden-app.com.