> ## Documentation Index > Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt > Use this file to discover all available pages before exploring further. # Local Hands per le sessioni cloud di Devin > Consenti a una sessione cloud di Devin di eseguire comandi e modificare file sul tuo computer tramite Devin Desktop o devin connect, con la tua approvazione per ogni tool call. Local Hands (accesso alla macchina locale) consente a una sessione cloud di Devin di eseguire comandi e lavorare con i file sul tuo computer. Usalo quando l'attività richiede qualcosa disponibile solo sulla tua macchina: un checkout locale con modifiche non ancora salvate in un commit, un dispositivo della tua rete, uno strumento che richiede la tua VPN o i log di una build locale. Il tuo computer non sostituisce la VM della sessione. Devin mantiene la propria VM e dispone in più di un secondo set di strumenti che vengono eseguiti sulla tua macchina. Le due macchine hanno file, directory di lavoro e ambienti separati; Devin trasferisce i dati dall'una all'altra solo tramite tool call approvate da te, come la copia di un file. > [!NOTE] > > Local Hands è in fase di rilascio graduale. Se non vedi l'impostazione **Local Hands**, la funzionalità non è ancora disponibile per la tua organizzazione. > [!NOTE] > > **Local Hands** è il nome della funzionalità; la scheda di accesso e i toast la indicano come **local machine access**. Nell'intestazione della sessione, una macchina connessa viene mostrata come **Local Hands**. Local Hands non va confuso con [Devin Connect](/it/enterprise/deployment/devin-connect), che consente a Devin di accedere a reti private. ## Come funziona **1. Devin richiede l'accesso** Quando un'attività richiede la tua macchina, Devin pubblica nella sessione una scheda **Local machine access requested**. La scheda indica il motivo e l'ora di scadenza della richiesta. In Devin Desktop mostra un pulsante **Approve**; nel browser mostra un comando `devin connect` con un codice di abbinamento. Puoi anche chiederlo direttamente, ad esempio "esegui i test sulla mia macchina locale". **2. Colleghi la tua macchina** Approva la richiesta sulla macchina che vuoi far usare a Devin: fai clic su **Approve** in Devin Desktop oppure esegui `devin connect` in un terminale. Vedi [Collegare la tua macchina](#connect-your-machine). **3. Devin usa gli strumenti locali** Gli strumenti locali di Devin diventano disponibili e nell'intestazione compare il chip **Local Hands**. Dovrai approvare ogni tool call, a meno che tu non attivi il [bypass](#bypass-local-permissions). **4. La connessione termina** La connessione termina quando revochi l'accesso, interrompi `devin connect`, chiudi la finestra di Devin Desktop che ha approvato la richiesta oppure quando la sessione si conclude. Insieme alla connessione scompaiono anche gli strumenti locali. ## Requisiti * Una sessione cloud di tua proprietà. Devin invia il codice di abbinamento all'account del proprietario della sessione, quindi chi visualizza la sessione senza esserne il proprietario non può connettere la propria macchina. Le sessioni prive di un utente che possa approvare l'accesso, come le sessioni programmate, le automazioni e le sessioni API eseguite da un utente di servizio, non possono richiedere una macchina. * La [Devin CLI](/it/cli) o [Devin Desktop](/it/desktop/introducing-devin-desktop) sulla macchina da connettere, con l'accesso effettuato tramite lo stesso Account Devin proprietario della sessione. Per la CLI, esegui `devin auth login`. * L'impostazione **Local Hands** attivata per la tua organizzazione. Vedi [Disponibilità](#availability). ## Collega la tua macchina Il modo più semplice è usare Devin Desktop: apri lì la sessione e fai clic su **Approve**. Se lavori dal browser, esegui il comando `devin connect` riportato nella scheda in un terminale sulla macchina che vuoi collegare. Ogni richiesta è monouso e scade 10 minuti dopo essere stata creata da Devin. Una nuova richiesta sostituisce quella precedente e il vecchio codice di abbinamento non funziona più. **Devin Desktop** Apri la sessione in Devin Desktop. La scheda mostra **Approve** e **Decline**. Fai clic su **Approve** per collegare la macchina su cui è in esecuzione Devin Desktop. Non servono né un codice di abbinamento né un terminale. Se preferisci la CLI, fai clic su **Use the terminal instead** per visualizzare il comando. **Terminal** Copia il comando dalla scheda ed eseguilo sulla macchina che vuoi collegare: ```bash theme={null} devin connect ``` Eseguire il comando equivale ad approvare la richiesta: non viene chiesta un'ulteriore conferma. Il comando resta in foreground, stampa ogni tool call effettuata da Devin e mantiene aperta la connessione finché la sessione non termina o non premi `Ctrl+C`. **devin --cloud** Una sessione cloud avviata con [`devin --cloud`](/it/cli/cloud) collega automaticamente la macchina del terminale quando Devin richiede l'accesso. Ogni tool call richiede comunque la tua approvazione. Se la richiesta è scaduta, fai clic su **Connect this machine** nella scheda in Devin Desktop oppure su **Request a new code** nel browser. ### Privacy della sessione Quando colleghi una macchina a una sessione di cui sei proprietario, Devin rende la sessione privata: solo tu puoi inviarle messaggi. In questo modo si impedisce ad altre persone della tua organizzazione di controllare una sessione in grado di eseguire comandi sul tuo computer. Per lasciare invariata la privacy della sessione, usa l'opzione `--public`: ```bash theme={null} devin connect --public ``` ## Cosa può fare Devin sulla tua macchina Devin può eseguire comandi della shell, leggere e cercare file, creare e modificare file e copiare file tra la tua macchina e la VM della sessione. Devin non può controllare lo schermo, la tastiera o il mouse della tua macchina. [Computer Use](/it/work-with-devin/computer-use) è disponibile solo sulla VM della sessione. ## Approvazioni Per impostazione predefinita, ogni tool call locale si ferma e ti chiede conferma. La sessione mostra lo strumento e i relativi argomenti, con tre opzioni: * **Allow once**: esegue questa chiamata. * **Allow for this session**: esegue questa chiamata e le successive chiamate allo stesso strumento senza prompt, finché la macchina non si disconnette. * **Deny**: rifiuta questa chiamata. Devin vede il rifiuto e può provare un approccio diverso. Anche le tue [regole di autorizzazione](/it/cli/reference/permissions) di Devin CLI si applicano alle tool call locali. Una regola `allow` esegue una chiamata corrispondente senza prompt, una regola `deny` la blocca e una regola `ask` richiede conferma ogni volta. Sono incluse anche le regole che la tua organizzazione imposta nelle [Impostazioni Del Team](/it/cli/enterprise/team-settings). ### Bypass delle autorizzazioni locali Per non ricevere più un prompt a ogni chiamata, fai clic su **Bypass local permissions** nella scheda di accesso o nel menu **Local Hands**. Da quel momento le tool call locali vengono eseguite senza prompt finché la macchina non si disconnette. Le richieste in sospeso vengono approvate immediatamente. Per avviare ogni connessione in modalità bypass, imposta [`local_tools_bypass_permissions`](/it/cli/reference/configuration/config-file#local_tools_bypass_permissions-user-only) nella configurazione della Devin CLI. Quando attivi o disattivi il bypass dalla sessione, la CLI aggiorna questa impostazione. > [!WARNING] > > Con il bypass attivo, Devin può eseguire comandi e modificare file sul tuo computer senza chiedere conferma. Usalo solo per sessioni e attività di cui ti fidi. ### Chiamate che richiedono sempre l'approvazione Le regole integrate fanno sì che alcune chiamate richiedano l'approvazione ogni volta, anche con il bypass attivo. Né **Allow for this session** né le tue regole `allow` possono approvarle. Queste regole riguardano file di credenziali e chiavi private, escalation dei privilegi, comandi distruttivi, interpreti di shell, archivi di segreti e scritture nei profili della shell e nella configurazione di Git. La scheda di approvazione spiega perché una chiamata richiede un'approvazione esplicita. Le tue regole `ask` e quelle della tua organizzazione si comportano allo stesso modo. ## Disconnettere o revocare l'accesso * **Revoca l'accesso**: fai clic su **Revoke access** nella scheda di accesso o nel menu **Local Hands**. Devin perde immediatamente l'accesso agli strumenti locali. * **Arresta la CLI**: premi `Ctrl+C` nel terminale in cui è in esecuzione `devin connect`. * **Chiudi Devin Desktop**: la connessione termina quando chiudi la finestra di Devin Desktop che ha approvato la richiesta o quando esci da Devin Desktop. * **Termina la sessione**: la connessione si chiude al termine della sessione. `devin connect` si riconnette automaticamente dopo una breve interruzione di rete. Se la macchina resta offline o se arresti il comando, l'indicatore mostra la macchina come disconnessa. Per riconnetterti, chiedi a Devin di richiedere di nuovo l'accesso e usa il nuovo codice. ## Disponibilità Gli amministratori dell'organizzazione gestiscono questa funzionalità tramite il toggle **Local Hands** in [**Settings > Devin**](https://app.devin.ai/settings/devin). Il toggle è attivo per impostazione predefinita per le organizzazioni che non fanno parte di un'azienda e disattivato per impostazione predefinita per quelle che ne fanno parte. Local Hands non è disponibile quando: * La sessione usa un [profilo di sicurezza](/it/product-guides/security-profiles). * Le [distribuzioni native](/it/product-guides/deployment-capabilities) sono disattivate per la tua organizzazione. * Nella sessione non c'è un utente che possa approvare l'accesso (sessioni programmate, automazioni e sessioni API di utenti di servizio). ## Risoluzione dei problemi | Sintomo | Cosa fare | | - | - | | La scheda indica che la richiesta è scaduta | Fai clic su **Request a new code** (o su **Connect this machine** in Devin Desktop) | | La scheda indica che questa richiesta è stata sostituita da una più recente | Usa il comando riportato nella scheda più recente | | Devin Desktop chiede di accedere su questa macchina | Accedi a Devin in Devin Desktop oppure esegui il comando `devin connect` in un terminale | | `devin connect` indica che gli strumenti locali richiedono un Account Devin | Esegui `devin auth login` e accedi con Devin | | Nel browser la scheda non mostra il pulsante **Approve** | Un browser non può eseguire strumenti sulla tua macchina. Esegui il comando `devin connect` in un terminale oppure apri la sessione in Devin Desktop. | | Una chiamata richiede di nuovo l'approvazione anche dopo che hai attivato il bypass | Si tratta di una delle [chiamate che richiedono sempre l'approvazione](#calls-that-always-ask) | ## Risorse correlate > **[Devin Cloud nella CLI](/it/cli/cloud)** > > Avvia e gestisci le sessioni cloud dal terminale > **[Autorizzazioni della CLI](/it/cli/reference/permissions)** > > Scrivi regole allow, ask e deny per le tool call > **[Trasferisci a Devins nel cloud](/it/work-with-devin/devin-handoff)** > > Sposta un'attività locale in una sessione cloud > **[Computer Use](/it/work-with-devin/computer-use)** > > Come Devin usa il desktop della propria VM This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.