> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Local Hands pour les sessions Devin dans le cloud > Permettez à une session Devin dans le cloud d’exécuter des commandes et de modifier des fichiers sur votre propre ordinateur via Devin Desktop ou devin connect, en approuvant chaque appel d’outil. Local Hands (accès à la machine locale) permet à une session Devin dans le cloud d’exécuter des commandes et de manipuler des fichiers sur votre propre ordinateur. Utilisez cette fonctionnalité lorsque la tâche nécessite une ressource qui n’existe que sur votre machine : une copie locale du dépôt contenant des modifications non validées, un appareil de votre réseau, un outil qui passe par votre VPN ou les logs d’un build local. Votre ordinateur ne remplace pas la VM de la session. Devin conserve sa VM et dispose en plus d’un second ensemble d’outils qui s’exécutent sur votre machine. Les deux machines ont chacune leurs propres fichiers, répertoires de travail et environnements ; Devin ne transfère des données de l’une à l’autre qu’au moyen d’appels d’outils que vous approuvez, comme une copie de fichier. > [!NOTE] > > Local Hands est en cours de déploiement progressif. Si le paramètre **Local Hands** n’apparaît pas, la fonctionnalité n’est pas encore disponible pour votre organisation. > [!NOTE] > > **Local Hands** est le nom de la fonctionnalité ; la carte d’accès et les notifications éphémères la désignent sous le nom **local machine access**. Dans l’en-tête de la session, une machine connectée apparaît sous le nom **Local Hands**. Ne confondez pas Local Hands avec [Devin Connect](/fr/enterprise/deployment/devin-connect), qui permet à Devin d’accéder à des réseaux privés. ## Fonctionnement **1. Devin demande l'accès** Lorsqu'une tâche nécessite votre machine, Devin publie une carte **Local machine access requested** dans la session. Cette carte indique le motif de la demande et son heure d'expiration. Dans Devin Desktop, elle affiche un bouton **Approve** ; dans le navigateur, elle affiche une commande `devin connect` accompagnée d'un code d'association. Vous pouvez aussi en faire la demande directement, par exemple « exécute les tests sur ma machine locale ». **2. Vous connectez votre machine** Approuvez la requête sur la machine que Devin doit utiliser : cliquez sur **Approve** dans Devin Desktop, ou exécutez `devin connect` dans un terminal. Consultez [Connecter votre machine](#connect-your-machine). **3. Devin utilise les outils locaux** Les outils locaux de Devin deviennent disponibles et l'en-tête affiche le badge **Local Hands**. Vous devez approuver chaque appel d'outil, sauf si vous activez le [contournement](#bypass-local-permissions). **4. La connexion prend fin** La connexion prend fin lorsque vous révoquez l'accès, arrêtez `devin connect` ou fermez la fenêtre Devin Desktop ayant approuvé la requête, ou encore lorsque la session se termine. Les outils locaux disparaissent en même temps. ## Prérequis * Une session Devin dans le cloud dont vous êtes propriétaire. Devin envoie le code d'association au compte du propriétaire de la session : une autre personne qui consulte la session ne peut donc pas connecter sa machine. Les sessions sans utilisateur pour approuver l'accès, comme les sessions planifiées, les automatisations et les sessions API exécutées par un utilisateur de service, ne peuvent pas demander de machine. * La [Devin CLI](/fr/cli) ou [Devin Desktop](/fr/desktop/introducing-devin-desktop) installé sur la machine à connecter et connecté au compte Devin propriétaire de la session. Pour la CLI, exécutez `devin auth login`. * Le paramètre **Local Hands** activé pour votre organisation. Consultez [Disponibilité](#availability). ## Connecter votre machine La méthode la plus simple consiste à utiliser Devin Desktop : ouvrez-y la session et cliquez sur **Approve**. Si vous travaillez depuis un navigateur, exécutez la commande `devin connect` affichée sur la carte dans un terminal de la machine que vous souhaitez connecter. Une requête est single-use et expire 10 minutes après sa création par Devin. Toute nouvelle requête remplace la précédente, et l’ancien code d’association n’est alors plus valide. **Devin Desktop** Ouvrez la session dans Devin Desktop. La carte affiche **Approve** et **Decline**. Cliquez sur **Approve** pour connecter la machine sur laquelle s’exécute Devin Desktop. Aucun code d’association ni terminal n’est nécessaire. Si vous préférez la CLI, cliquez sur **Use the terminal instead** pour afficher la commande. **Terminal** Copiez la commande depuis la carte et exécutez-la sur la machine que vous souhaitez connecter : ```bash theme={null} devin connect ``` L’exécution de la commande vaut approbation : aucune confirmation supplémentaire n’est demandée. La commande reste au premier plan, affiche chaque appel d’outil effectué par Devin et maintient la connexion ouverte jusqu’à la fin de la session ou jusqu’à ce que vous appuyiez sur `Ctrl+C`. **devin --cloud** Une session Devin dans le cloud ouverte avec [`devin --cloud`](/fr/cli/cloud) connecte automatiquement la machine du terminal lorsque Devin demande l’accès. Chaque appel d’outil reste toutefois soumis à votre approbation. Si la requête a expiré, cliquez sur **Connect this machine** sur la carte dans Devin Desktop, ou sur **Request a new code** dans le navigateur. ### Confidentialité de la session Lorsque vous connectez une machine à une session dont vous êtes propriétaire, Devin rend la session privée : vous seul pouvez lui envoyer des messages. Cela empêche les autres membres de votre organisation de piloter une session capable d'exécuter des commandes sur votre ordinateur. Pour conserver le paramètre de confidentialité actuel de la session, utilisez `--public` : ```bash theme={null} devin connect --public ``` ## Ce que Devin peut faire sur votre machine Devin peut exécuter des commandes shell, lire des fichiers et y effectuer des recherches, créer et modifier des fichiers, et copier des fichiers entre votre machine et la VM de la session. Devin ne peut en aucun cas contrôler l'écran, le clavier ni la souris de votre machine. [Computer Use](/fr/work-with-devin/computer-use) s'applique uniquement à la VM de la session. ## Approbations Par défaut, chaque appel d’outil local est mis en pause et vous demande confirmation. La session affiche l’outil et ses arguments, avec trois options : * **Allow once** : exécuter cet appel. * **Allow for this session** : exécuter cet appel, ainsi que les appels suivants du même outil, sans demande de confirmation jusqu’à la déconnexion de la machine. * **Deny** : rejeter cet appel. Devin est informé du refus et peut essayer une autre approche. Vos [règles d’autorisation](/fr/cli/reference/permissions) Devin CLI s’appliquent également aux appels d’outils locaux. Une règle `allow` exécute un appel correspondant sans demande de confirmation, une règle `deny` le bloque et une règle `ask` impose une demande de confirmation à chaque fois. Cela inclut les règles définies par votre organisation dans les [Paramètres d’équipe](/fr/cli/enterprise/team-settings). ### Contourner les autorisations locales Pour ne plus avoir de demande de confirmation à chaque appel, cliquez sur **Bypass local permissions** sur la carte d’accès ou dans le menu **Local Hands**. Les appels d’outils locaux s’exécutent alors sans prompt jusqu’à la déconnexion de la machine. Les demandes en attente sont approuvées immédiatement. Pour que chaque connexion démarre en mode contournement, définissez [`local_tools_bypass_permissions`](/fr/cli/reference/configuration/config-file#local_tools_bypass_permissions-user-only) dans votre configuration Devin CLI. Lorsque vous activez ou désactivez le contournement depuis la session, la CLI met à jour ce paramètre. > [!WARNING] > > Lorsque le contournement est activé, Devin peut exécuter des commandes et modifier des fichiers sur votre ordinateur sans vous demander votre accord. Ne l’utilisez que pour des sessions et des tâches auxquelles vous faites confiance. ### Appels qui demandent toujours une approbation Des règles intégrées imposent une demande d’approbation systématique pour certains appels, même lorsque le mode Contournement est activé. Ni **Allow for this session** ni vos propres règles `allow` ne permettent de les approuver. Elles concernent les fichiers d’identifiants et les clés privées, l’escalade de privilèges, les commandes destructrices, les interpréteurs de shell, les coffres de secrets, ainsi que les écritures dans les profils de shell et la configuration Git. La carte d’approbation indique pourquoi un appel nécessite une approbation explicite. Vos règles `ask` et celles de votre organisation fonctionnent de la même manière. ## Se déconnecter ou révoquer l'accès * **Révoquer l'accès** : cliquez sur **Revoke access** sur la carte d'accès ou dans le menu **Local Hands**. Devin perd immédiatement l'accès aux outils locaux. * **Arrêter la CLI** : appuyez sur `Ctrl+C` dans le terminal où s'exécute `devin connect`. * **Fermer Devin Desktop** : la connexion prend fin lorsque vous fermez la fenêtre Devin Desktop qui a approuvé la requête, ou lorsque vous quittez Devin Desktop. * **Mettre fin à la session** : la connexion est fermée à la fin de la session. `devin connect` se reconnecte automatiquement après une brève coupure réseau. Si la machine reste hors ligne ou si vous arrêtez la commande, le badge indique que la machine est déconnectée. Pour vous reconnecter, demandez à Devin de solliciter à nouveau l'accès, puis utilisez le nouveau code. ## Disponibilité Les administrateurs de l’organisation contrôlent cette fonctionnalité via l’option **Local Hands** dans [**Settings > Devin**](https://app.devin.ai/settings/devin). Cette option est activée par défaut pour les organisations qui ne font pas partie d’une Enterprise, et désactivée par défaut pour celles qui appartiennent à une Enterprise. Local Hands n’est pas disponible dans les cas suivants : * La session utilise un [profil de sécurité](/fr/product-guides/security-profiles). * Les [déploiements natifs](/fr/product-guides/deployment-capabilities) sont désactivés pour votre organisation. * Aucun utilisateur n’est associé à la session pour approuver l’accès (sessions planifiées, automatisations et sessions API exécutées avec un service-user). ## Dépannage | Symptôme | Que faire | | - | - | | La carte indique que la requête a expiré | Cliquez sur **Request a new code** (ou sur **Connect this machine** dans Devin Desktop) | | La carte indique qu'une requête plus récente a remplacé celle-ci | Utilisez la commande affichée sur la carte la plus récente | | Devin Desktop vous demande de vous connecter sur cette machine | Connectez-vous à Devin dans Devin Desktop ou exécutez la commande `devin connect` dans un terminal | | `devin connect` indique que les outils locaux nécessitent un compte Devin | Exécutez `devin auth login` et connectez-vous avec Devin | | La carte n'affiche pas de bouton **Approve** dans le navigateur | Un navigateur ne peut pas exécuter d'outils sur votre machine. Exécutez la commande `devin connect` dans un terminal ou ouvrez la session dans Devin Desktop. | | Un appel demande de nouveau une approbation alors que le mode Contournement est activé | Il fait partie des [appels qui demandent toujours une approbation](#calls-that-always-ask) | ## Ressources associées > **[Devin Cloud dans la CLI](/fr/cli/cloud)** > > Lancez et pilotez des sessions Devin dans le cloud depuis votre terminal > **[Autorisations de la CLI](/fr/cli/reference/permissions)** > > Rédigez des règles allow, ask et deny pour les appels d’outils > **[Passer le relais aux Devins dans le cloud](/fr/work-with-devin/devin-handoff)** > > Transférez une tâche locale vers une session Devin dans le cloud > **[Computer Use](/fr/work-with-devin/computer-use)** > > Comment Devin utilise le bureau de sa propre VM This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.