> ## 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 para sessões em nuvem do Devin > Permita que uma sessão em nuvem do Devin execute comandos e edite arquivos no seu próprio computador pelo Devin Desktop ou pelo devin connect, com a sua aprovação para cada chamada de ferramenta. O Local Hands (acesso à máquina local) permite que uma sessão em nuvem do Devin execute comandos e trabalhe com arquivos no seu próprio computador. Use-o quando a tarefa depender de algo que só existe na sua máquina: um checkout local com alterações não comitadas, um dispositivo na sua rede, uma ferramenta que exige a sua VPN ou logs de um build local. O seu computador não substitui a VM da sessão. O Devin continua com a VM dele e ganha um segundo conjunto de ferramentas, executadas na sua máquina. As duas máquinas têm arquivos, diretórios de trabalho e ambientes separados; o Devin só transfere dados entre elas por meio de chamadas de ferramenta aprovadas por você, como uma cópia de arquivo. > [!NOTE] > > O Local Hands está sendo liberado gradualmente. Se a configuração **Local Hands** não aparecer para você, o recurso ainda não está disponível para a sua organização. > [!NOTE] > > **Local Hands** é o nome do recurso; o cartão de acesso e os toasts se referem a ele como **local machine access**. No cabeçalho da sessão, uma máquina conectada aparece como **Local Hands**. O Local Hands não é o mesmo que o [Devin Connect](/pt-BR/enterprise/deployment/devin-connect), que dá ao Devin acesso a redes privadas. ## Como funciona **1. O Devin solicita acesso** Quando uma tarefa precisa da sua máquina, o Devin publica um cartão **Local machine access requested** na sessão. O cartão informa o motivo e o horário em que a requisição expira. No Devin Desktop, ele exibe um botão **Approve**; no navegador, exibe um comando `devin connect` com um código de pareamento. Você também pode pedir isso diretamente, por exemplo: "execute os testes na minha máquina local". **2. Você conecta sua máquina** Aprove a requisição na máquina que você quer que o Devin use: clique em **Approve** no Devin Desktop ou execute `devin connect` em um terminal. Consulte [Conectar sua máquina](#connect-your-machine). **3. O Devin usa as ferramentas locais** As ferramentas locais do Devin ficam disponíveis e o cabeçalho exibe o indicador **Local Hands**. Você aprova cada chamada de ferramenta, a menos que ative o [bypass](#bypass-local-permissions). **4. A conexão é encerrada** A conexão é encerrada quando você revoga o acesso, interrompe o `devin connect` ou fecha a janela do Devin Desktop que aprovou a requisição, ou quando a sessão termina. Com isso, as ferramentas locais deixam de ficar disponíveis. ## Requisitos * Uma sessão em nuvem da qual você seja o proprietário. O Devin envia o código de pareamento para a conta do proprietário da sessão, então outras pessoas que visualizem a sessão não conseguem conectar a própria máquina. Sessões sem um usuário para aprovar o acesso, como sessões agendadas, automações e sessões de API executadas por um usuário de serviço, não podem solicitar uma máquina. * O [Devin CLI](/pt-BR/cli) ou o [Devin Desktop](/pt-BR/desktop/introducing-devin-desktop) instalado na máquina que você vai conectar, com login feito na mesma conta do Devin proprietária da sessão. No CLI, execute `devin auth login`. * A configuração **Local Hands** ativada para sua organização. Consulte [Disponibilidade](#availability). ## Conecte sua máquina A forma mais simples é pelo Devin Desktop: abra a sessão nele e clique em **Approve**. Se você trabalha pelo navegador, copie o comando `devin connect` exibido no cartão e execute-o em um terminal na máquina que deseja conectar. Cada requisição é de uso único e expira 10 minutos depois de ser criada pelo Devin. Uma nova requisição substitui a anterior, e o código de pareamento antigo deixa de funcionar. **Devin Desktop** Abra a sessão no Devin Desktop. O cartão exibe **Approve** e **Decline**. Clique em **Approve** para conectar a máquina em que o Devin Desktop está sendo executado. Você não precisa de código de pareamento nem de terminal. Se preferir a CLI, clique em **Use the terminal instead** para exibir o comando. **Terminal** Copie o comando do cartão e execute-o na máquina que deseja conectar: ```bash theme={null} devin connect ``` Executar o comando já vale como aprovação. Não há um segundo prompt. O comando permanece em primeiro plano, exibe cada chamada de ferramenta feita pelo Devin e mantém a conexão aberta até a sessão terminar ou você pressionar `Ctrl+C`. **devin --cloud** Em uma sessão em nuvem aberta com [`devin --cloud`](/pt-BR/cli/cloud), a máquina do terminal é conectada automaticamente quando o Devin solicita acesso. Cada chamada de ferramenta ainda precisa da sua aprovação. Se a requisição tiver expirado, clique em **Connect this machine** no cartão do Devin Desktop ou em **Request a new code** no navegador. ### Privacidade da sessão Quando você conecta uma máquina a uma sessão da qual é proprietário, o Devin torna a sessão privada: somente você pode enviar mensagens a ela. Isso impede que outras pessoas da sua organização conduzam uma sessão capaz de executar comandos no seu computador. Para não alterar a privacidade da sessão, passe `--public`: ```bash theme={null} devin connect --public ``` ## O que o Devin pode fazer na sua máquina O Devin pode executar comandos de shell, ler e pesquisar arquivos, criar e editar arquivos e copiar arquivos entre a sua máquina e a VM da sessão. O Devin não controla a tela, o teclado nem o mouse da sua máquina. O [Computer Use](/pt-BR/work-with-devin/computer-use) se aplica apenas à VM da sessão. ## Aprovações Por padrão, toda chamada de ferramenta local é pausada para pedir sua aprovação. A sessão exibe a ferramenta e seus argumentos com três opções: * **Allow once**: executa esta chamada. * **Allow for this session**: executa esta chamada e as chamadas seguintes da mesma ferramenta, sem prompt, até que a máquina se desconecte. * **Deny**: rejeita esta chamada. O Devin é informado da negação e pode tentar outra abordagem. Suas [regras de permissão](/pt-BR/cli/reference/permissions) do Devin CLI também se aplicam às chamadas de ferramenta locais. Uma regra `allow` executa a chamada correspondente sem prompt, uma regra `deny` a bloqueia e uma regra `ask` exibe um prompt toda vez. Isso inclui as regras que sua organização define em [Configurações da equipe](/pt-BR/cli/enterprise/team-settings). ### Ignorar permissões locais Para deixar de receber prompts a cada chamada, clique em **Bypass local permissions** no cartão de acesso ou no menu **Local Hands**. A partir daí, as chamadas de ferramenta locais são executadas sem prompt até que a máquina se desconecte. As solicitações pendentes são aprovadas imediatamente. Para que todas as conexões já iniciem no modo Bypass, defina [`local_tools_bypass_permissions`](/pt-BR/cli/reference/configuration/config-file#local_tools_bypass_permissions-user-only) na configuração do Devin CLI. Quando você ativa ou desativa o Bypass pela sessão, a CLI atualiza essa configuração. > [!WARNING] > > Com o Bypass ativado, o Devin pode executar comandos e alterar arquivos no seu computador sem pedir confirmação. Use-o apenas em sessões e tarefas de sua confiança. ### Chamadas que sempre pedem aprovação Regras nativas fazem com que algumas chamadas peçam aprovação todas as vezes, mesmo com o bypass ativado. Nem **Allow for this session** nem suas próprias regras `allow` conseguem aprová-las. Essas regras abrangem arquivos de credenciais e chaves privadas, escalonamento de privilégios, comandos destrutivos, interpretadores de shell, repositórios de segredos e gravações em perfis de shell e na configuração do Git. O cartão de aprovação informa por que a chamada exige aprovação explícita. Suas regras `ask` e as regras `ask` da sua organização funcionam da mesma forma. ## Desconectar ou revogar o acesso * **Revogar o acesso**: clique em **Revoke access** no cartão de acesso ou no menu **Local Hands**. O Devin perde o acesso às ferramentas locais imediatamente. * **Parar a CLI**: pressione `Ctrl+C` no terminal em que o `devin connect` está em execução. * **Fechar o Devin Desktop**: a conexão é encerrada quando você fecha a janela do Devin Desktop que aprovou a requisição ou sai do Devin Desktop. * **Encerrar a sessão**: a conexão é encerrada quando a sessão termina. O `devin connect` se reconecta automaticamente após uma breve queda de rede. Se a máquina continuar offline ou você interromper o comando, o indicador mostrará a máquina como desconectada. Para se conectar de novo, peça ao Devin que solicite o acesso novamente e use o novo código. ## Disponibilidade Os administradores da organização controlam este recurso pelo controle **Local Hands** em [**Settings > Devin**](https://app.devin.ai/settings/devin). Esse controle vem ativado por padrão para organizações que não fazem parte de uma empresa e desativado por padrão para organizações vinculadas a uma empresa. O Local Hands não está disponível quando: * A sessão usa um [perfil de segurança](/pt-BR/product-guides/security-profiles). * As [implantações nativas](/pt-BR/product-guides/deployment-capabilities) estão desativadas para sua organização. * A sessão não tem um usuário para aprovar o acesso (sessões agendadas, automações e sessões de API de usuário de serviço). ## Solução de problemas | Sintoma | O que fazer | | - | - | | O cartão informa que a requisição expirou | Clique em **Request a new code** (ou em **Connect this machine** no Devin Desktop) | | O cartão informa que uma requisição mais recente substituiu esta | Use o comando do cartão mais recente | | O Devin Desktop pede que você faça login nesta máquina | Faça login no Devin pelo Devin Desktop ou execute o comando `devin connect` em um terminal | | O `devin connect` informa que as ferramentas locais exigem uma conta do Devin | Execute `devin auth login` e faça login com o Devin | | O cartão não mostra o botão **Approve** no navegador | Um navegador não consegue executar ferramentas na sua máquina. Execute o comando `devin connect` em um terminal ou abra a sessão no Devin Desktop. | | Uma chamada volta a pedir aprovação mesmo depois de você ativar o bypass | Ela é uma das [chamadas que sempre pedem aprovação](#calls-that-always-ask) | ## Recursos relacionados > **[Devin Cloud na CLI](/pt-BR/cli/cloud)** > > Inicie e conduza sessões em nuvem pelo seu terminal > **[Permissões da CLI](/pt-BR/cli/reference/permissions)** > > Escreva regras allow, ask e deny para chamadas de ferramenta > **[Transferir para Devins na nuvem](/pt-BR/work-with-devin/devin-handoff)** > > Mova uma tarefa local para uma sessão em nuvem > **[Computer Use](/pt-BR/work-with-devin/computer-use)** > > Como o Devin usa o desktop da própria VM This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.