> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Executar no seu dispositivo

> Permita que o agente na nuvem execute sessões no seu próprio computador: autorize um computador, escolha um dispositivo para iniciar uma sessão, confirme o acesso a locais sensíveis, veja o registro de execução e saiba o que fazer em desconexões e na remoção de dispositivos.

**Executar no seu dispositivo** significa que o agente na nuvem controla remotamente um dos seus computadores. Ele lê e grava arquivos e executa comandos nesse computador, usando o ambiente e os arquivos locais, com o mesmo resultado de uma execução local. No app, essa opção se chama **Run on your device**.

## Escolher o seu dispositivo ou o servidor na nuvem

Cada sessão define onde será executada quando você a inicia. Não é possível alterar isso depois.

| | Seu dispositivo | Servidor na nuvem |
| - | - | - |
| Onde as ações acontecem | O computador que você escolher | Seu [servidor na nuvem](https://docs.aihubmix.com/pt/cloud/environments/cloud-host.md) |
| Ambiente e arquivos usados | O ambiente e as pastas de projeto nesse computador | A cópia do projeto e o ambiente do projeto no servidor na nuvem |
| Projetos disponíveis | Projetos locais nesse computador ou sessões fora de qualquer projeto | Projetos na nuvem ou sessões fora de qualquer projeto |
| Agentes compatíveis | Por enquanto, apenas Claude Code | Todos |
| Requisitos | O computador está online e **Allow execution** está ativado | Assinatura Plus |
| O computador desliga ou fica offline | A tarefa atual é pausada e continua após a reconexão | Não é afetado |

Para tarefas que precisam continuar em execução depois que você fecha o laptop, escolha o servidor na nuvem.

## Permitir que um computador execute sessões

**1. Entrar no aplicativo para desktop nesse computador**

Instale o aplicativo para desktop e entre com a mesma conta. Consulte [Baixar e entrar](https://docs.aihubmix.com/pt/cloud/getting-started/install-and-sign-in.md). Depois que você entra, o computador é adicionado automaticamente ao seu espaço de trabalho. O aplicativo web não adiciona um dispositivo.

**2. Abrir os detalhes da máquina**

Acesse **Settings › Workspace › Machines** e clique no computador. A lista mostra o sistema operacional, a versão do cliente e o status online de cada máquina.

**3. Ativar Allow execution**

Ative **Allow execution** (desativado por padrão para computadores) e revise na caixa de confirmação o que está sendo liberado. Depois de ativado, vale para todas as sessões futuras executadas neste computador.

**4. Ajustar a autorização conforme necessário**

Defina o escopo de acesso, os locais sensíveis e o limite de permissões. Depois de salvar, as alterações se aplicam imediatamente às novas sessões.

![Lista de máquinas](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/machines.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=7e1df978d48ba5be7f5a7a9edeb30f68)

Settings › Workspace › Machines

Nos detalhes da máquina, você pode ajustar:

* **Access scope**: apenas pastas de projeto, pastas selecionadas ou o computador inteiro (padrão).
* **Sensitive locations**: por exemplo SSH, Keychain e configurações do sistema. Escolha Ask each time (padrão), Block access ou Allow access.
* **Permission limit**: as permissões da sessão não podem ultrapassar esse limite. Escolha No limit (padrão), Approve for me ou Ask for approval.
* **Allowed secrets**: quais segredos do espaço de trabalho podem ser usados neste computador. Todos, por padrão.
* **Environment variable overrides**: variáveis de ambiente a substituir ao executar neste computador. Não coloque segredos em texto simples aqui.

Liberar a autorização exige sua confirmação. Restringir não exige. Quando você desativa **Allow execution**, as sessões que usam este computador são pausadas. Os comandos são executados com as permissões da sua conta neste computador.

> [!NOTE]
>
> A autorização de execução só pode ser alterada no aplicativo para desktop desse computador. Outros dispositivos e o aplicativo web podem apenas visualizá-la.

## Escolher um dispositivo para iniciar uma sessão

**1. Abrir o menu de ambiente de execução**

Acima da caixa de entrada da nova sessão, clique no botão de ambiente de execução ao lado do projeto.

**2. Escolher um dispositivo**

Em **Run on your device**, escolha um computador. Cada dispositivo mostra abaixo o escopo de acesso e o limite de permissões.

**3. Enviar a tarefa**

Escreva sua tarefa e envie. Depois que a sessão começa, ela permanece neste computador.

* Projetos locais usam por padrão o computador onde o projeto está. Todo o resto usa por padrão o servidor na nuvem.
* Um dispositivo não pode ser selecionado se estiver offline, se Allow execution estiver desativado, se o projeto não estiver nesse dispositivo ou se o agente atual não for o Claude Code. O menu informa o motivo.
* Depois que você escolhe um dispositivo, permissões acima do limite de permissões dele não podem ser selecionadas.
* Para trocar para outro computador ou para o servidor na nuvem, inicie uma nova sessão.

Na primeira vez que uma sessão é executada em um computador, se Allow execution ainda não estiver ativado ou se o projeto não tiver uma pasta correspondente nesse computador, o cliente desse computador mostra um aviso. Clique em **Open Machines & access** para ativar Allow execution, ou clique em **Allow** e escolha a pasta do projeto (a pasta não é sincronizada com a nuvem). Sessões fora de qualquer projeto usam a própria pasta temporária.

## Confirmar o acesso a locais sensíveis

Quando os locais sensíveis estão definidos como Ask each time, o cliente no dispositivo em execução mostra o motivo e o caminho antes que o agente acesse um local como a configuração do SSH.

* **Allow once**: permite apenas desta vez, sem alterar a autorização da máquina.
* **Deny**: não permite. Se você não responder por algum tempo, a solicitação é tratada como negada.
* **Respond later**: oculta o aviso por enquanto, e a sessão fica marcada na barra lateral como precisando da sua atenção.

## Ver o registro de execução

Na parte inferior do menu de ambiente de execução, clique em **Execution log** para ver as ações desta sessão. Nos detalhes da máquina, clique em **View execution log** para ver as ações de todas as sessões neste computador. Cada linha do registro mostra o que o agente fez, sobre o que agiu e o resultado.

No cliente do dispositivo em execução, você também pode interromper processos, desconectar ou reconectar imediatamente. Em outros lugares, só é possível visualizar.

## O que acontece quando o computador se desconecta

Quando o computador desliga, entra em suspensão, fica offline ou fecha o cliente, a tarefa atual é pausada. Quando a conexão volta, ela continua automaticamente de onde parou, e as ações já concluídas não são repetidas. Você também pode clicar em **Reconnect**. Em outros dispositivos e no aplicativo web, a sessão fica marcada como dispositivo offline.

Uma sessão não é transferida automaticamente para o servidor na nuvem quando o dispositivo fica offline. Para problemas de conexão, consulte [Perguntas frequentes e solução de problemas](https://docs.aihubmix.com/pt/cloud/reference/troubleshooting.md).

## Remover um dispositivo

Na parte inferior dos detalhes da máquina, clique em **Remove device** e confirme.

> [!WARNING]
>
> Após a remoção, o dispositivo é desconectado imediatamente e as sessões que o usam são interrompidas. Para usar este computador novamente mais tarde, entre nele de novo.

O servidor na nuvem não pode ser removido. O computador que você está usando no momento não pode ser removido aqui; saia da sua conta para removê-lo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.