> ## Documentation Index > Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Deixe Fuxi usar seu computador a partir da CLI > Ative o computer use na Fuxi Code CLI para que Fuxi possa abrir aplicativos, clicar, digitar e ver sua tela no macOS. Teste aplicativos nativos, depure problemas visuais e automatize ferramentas apenas com GUI sem sair do seu terminal. Computer use é uma visualização de pesquisa no macOS que requer um plano Pro ou Max. Não está disponível em planos Team ou Enterprise. Requer uma sessão interativa, portanto não está disponível em modo não interativo com a flag `-p`. Computer use permite que Fuxi abra aplicativos, controle sua tela e trabalhe em sua máquina da forma como você faria. A partir da CLI, Fuxi pode compilar um aplicativo Swift, iniciá-lo, clicar em cada botão e capturar uma tela do resultado, tudo na mesma conversa em que escreveu o código. Esta página aborda como o computer use funciona na CLI. Para o aplicativo Desktop no macOS ou Windows, consulte [computer use em Desktop](/pt/desktop#let-fuxi-use-your-computer).

O que você pode fazer com computer use

Computer use lida com tarefas que requerem uma GUI: qualquer coisa que você normalmente teria que sair do terminal e fazer manualmente. * **Construir e validar aplicativos nativos**: peça a Fuxi para construir um aplicativo de barra de menu do macOS. Fuxi escreve o Swift, compila, inicia e clica em cada controle para verificar se funciona antes de você abri-lo. * **Testes de UI de ponta a ponta**: aponte Fuxi para um aplicativo Electron local e diga "teste o fluxo de integração". Fuxi abre o aplicativo, clica na inscrição e captura cada etapa. Sem configuração do Playwright, sem teste harness. * **Depurar problemas visuais e de layout**: diga a Fuxi "o modal está sendo cortado em janelas pequenas". Fuxi redimensiona a janela, reproduz o bug, captura uma tela, corrige o CSS e verifica a correção. Fuxi vê o que você vê. * **Dirigir ferramentas apenas com GUI**: interaja com ferramentas de design, painéis de controle de hardware, o iOS Simulator ou aplicativos proprietários que não possuem CLI ou API.

Quando computer use se aplica

Fuxi tem várias maneiras de interagir com um aplicativo ou serviço. Computer use é a mais ampla e lenta, portanto Fuxi tenta a ferramenta mais precisa primeiro: * Se você tiver um [servidor MCP](/pt/mcp) para o serviço, Fuxi usa isso. * Se a tarefa for um comando shell, Fuxi usa Bash. * Se a tarefa for trabalho de navegador e você tiver [Fuxi no Chrome](/pt/chrome) configurado, Fuxi usa isso. * Se nenhum desses se aplicar, Fuxi usa computer use. O controle de tela é reservado para coisas que nada mais pode alcançar: aplicativos nativos, simuladores e ferramentas sem uma API.

Ativar computer use

Computer use está disponível como um servidor MCP integrado chamado `computer-use`. Está desativado por padrão até que você o ative. Em uma sessão interativa do Fuxi Code, execute: ```text theme={null} /mcp ``` Encontre `computer-use` na lista de servidores. Ele aparece como desativado. Selecione `computer-use` e escolha **Enable**. A configuração persiste por projeto, portanto você faz isso apenas uma vez para cada projeto onde deseja usar computer use. Na primeira vez que Fuxi tentar usar seu computador, você verá um prompt para conceder duas permissões do macOS: * **Accessibility**: permite que Fuxi clique, digite e role * **Screen Recording**: permite que Fuxi veja o que está em sua tela O prompt inclui links para abrir o painel System Settings relevante. Conceda ambos e selecione **Try again** no prompt. O macOS pode exigir que você reinicie Fuxi Code após conceder Screen Recording. Após a configuração, peça a Fuxi para fazer algo que precise da GUI: ```text theme={null} Build the app target, launch it, and click through each tab to make sure nothing crashes. Screenshot any error states you find. ```

Aprovar aplicativos por sessão

Ativar o servidor `computer-use` não concede a Fuxi acesso a todos os aplicativos em sua máquina. Na primeira vez que Fuxi precisar de um aplicativo específico em uma sessão, um prompt aparece em seu terminal mostrando: * Quais aplicativos Fuxi deseja controlar * Quaisquer permissões extras solicitadas, como acesso à área de transferência * Quantos outros aplicativos serão ocultados enquanto Fuxi trabalha Escolha **Allow for this session** ou **Deny**. As aprovações duram para a sessão atual. Você pode aprovar vários aplicativos de uma vez quando Fuxi os solicita juntos. Aplicativos com amplo alcance mostram um aviso extra no prompt para que você saiba o que aprovar concede: | Aviso | Aplica-se a | | :------------------------------------ | :------------------------------------------------------- | | Equivalente ao acesso shell | Terminal, iTerm, VS Code, Warp e outros terminais e IDEs | | Pode ler ou escrever qualquer arquivo | Finder | | Pode alterar configurações do sistema | System Settings | Esses aplicativos não são bloqueados. O aviso permite que você decida se a tarefa justifica esse nível de acesso. O nível de controle de Fuxi também varia por categoria de aplicativo: navegadores e plataformas de negociação são apenas visualização, terminais e IDEs são apenas clique, e tudo o mais obtém controle total. Consulte [permissões de aplicativo em Desktop](/pt/desktop#app-permissions) para a divisão de camada completa.

Como Fuxi trabalha em sua tela

Entender o fluxo ajuda você a antecipar o que Fuxi fará e como intervir.

Uma sessão por vez

Computer use mantém um bloqueio em toda a máquina a partir da primeira ação de computer use até que a sessão que o adquiriu saia. {/* min-version: 2.1.195 */}A partir da v2.1.195, terminar a tarefa não libera o bloqueio; apenas sair da sessão faz isso. Se outra sessão do Fuxi Code já estiver usando seu computador, novas tentativas falharão com uma mensagem informando qual sessão mantém o bloqueio. Saia dessa sessão primeiro.

Os aplicativos são ocultados enquanto Fuxi trabalha

Quando Fuxi começa a controlar sua tela, outros aplicativos visíveis são ocultados para que Fuxi interaja apenas com os aplicativos aprovados. Sua janela de terminal permanece visível e é excluída de capturas de tela, para que você possa assistir à sessão e Fuxi nunca veja sua própria saída. Quando Fuxi termina a vez, os aplicativos ocultos são restaurados automaticamente.

As capturas de tela são redimensionadas automaticamente

Fuxi Code redimensiona cada captura de tela antes de enviá-la ao modelo. Você não precisa reduzir sua resolução de exibição ou redimensionar janelas em Retina ou outras exibições de alta resolução. Um MacBook Pro de 16 polegadas em resolução Retina nativa captura em 3456×2234 e redimensiona para aproximadamente 1372×887, preservando a proporção de aspecto. Não há configuração para alterar o tamanho de destino. Se o texto ou controles na tela forem muito pequenos para Fuxi ler após o redimensionamento, aumente seu tamanho no aplicativo em vez de alterar sua resolução de exibição.

Parar a qualquer momento

Quando Fuxi adquire o bloqueio, uma notificação do macOS aparece: "Fuxi is using your computer · press Esc to stop." Pressione `Esc` em qualquer lugar para abortar a ação atual imediatamente, ou pressione `Ctrl+C` no terminal. De qualquer forma, Fuxi para, mostra seus aplicativos novamente e retorna o controle a você. A sessão mantém o [bloqueio de computer use](#one-session-at-a-time) até que saia. Uma segunda notificação aparece quando Fuxi termina.

Segurança e o limite de confiança

Ao contrário da [ferramenta Bash em sandbox](/pt/sandboxing), computer use é executado em seu desktop real com acesso aos aplicativos que você aprova. Fuxi verifica cada ação e sinaliza possível injeção de prompt do conteúdo na tela, mas o limite de confiança é diferente. Consulte o [guia de segurança do computer use](https://support.fuxi.com/en/articles/14128542) para as melhores práticas. Os guardrails integrados reduzem o risco sem exigir configuração: * **Aprovação por aplicativo**: Fuxi pode controlar apenas aplicativos que você aprovou na sessão atual. * **Avisos de sentinela**: aplicativos que concedem acesso shell, sistema de arquivos ou configurações do sistema são sinalizados antes de você aprovar. * **Terminal excluído de capturas de tela**: Fuxi nunca vê sua janela de terminal, portanto prompts na tela em sua sessão não podem alimentar o modelo. * **Escape global**: a tecla `Esc` aborta computer use de qualquer lugar, e o pressionamento de tecla é consumido para que injeção de prompt não possa usá-lo para descartar diálogos. * **Arquivo de bloqueio**: apenas uma sessão pode controlar sua máquina por vez.

Fluxos de trabalho de exemplo

Esses exemplos mostram maneiras comuns de combinar computer use com tarefas de codificação.

Validar uma compilação nativa

Após fazer alterações em um aplicativo macOS ou iOS, peça a Fuxi para compilar e verificar em uma única passagem: ```text theme={null} Build the MenuBarStats target, launch it, open the preferences window, and verify the interval slider updates the label. Screenshot the preferences window when you're done. ``` Fuxi executa `xcodebuild`, inicia o aplicativo, interage com a UI e relata o que encontra.

Reproduzir um bug de layout

Quando um bug visual aparece apenas em certos tamanhos de janela, deixe Fuxi encontrá-lo: ```text theme={null} The settings modal clips its footer on narrow windows. Resize the app window down until you can reproduce it, screenshot the clipped state, then check the CSS for the modal container. ``` Fuxi redimensiona a janela, captura o estado quebrado e lê as folhas de estilo relevantes.

Testar um fluxo do simulador

Dirija o iOS Simulator sem escrever XCTest: ```text theme={null} Open the iOS Simulator, launch the app, tap through the onboarding screens, and tell me if any screen takes more than a second to load. ``` Fuxi controla o simulador da mesma forma que você faria com um mouse.

Diferenças do aplicativo Desktop

As superfícies CLI e Desktop compartilham o mesmo mecanismo de computer use, com algumas diferenças: | Recurso | Desktop | CLI | | :--------------------------- | :------------------------------------------------------ | :------------------------------ | | Plataformas | macOS e Windows | Apenas macOS | | Ativar | Alternar em **Settings > General** (em **Desktop app**) | Ativar `computer-use` em `/mcp` | | Lista de aplicativos negados | Configurável em Settings | Ainda não disponível | | Alternância de auto-unhide | Opcional | Sempre ativado | | Integração do Dispatch | Sessões geradas por Dispatch podem usar computer use | Não aplicável |

Troubleshooting

"Computer use is in use by another Fuxi session"

Outra sessão do Fuxi Code mantém o bloqueio, que ela mantém até sair. Saia dessa sessão. Se a outra sessão travou, o bloqueio é liberado automaticamente quando Fuxi detecta que o processo não está mais em execução.

macOS permissions prompt keeps reappearing

O macOS às vezes requer uma reinicialização do processo solicitante após você conceder Screen Recording. Saia completamente do Fuxi Code e inicie uma nova sessão. Se o prompt persistir, abra **System Settings > Privacy & Security > Screen Recording** e confirme que seu aplicativo de terminal está listado e ativado.

`computer-use` doesn't appear in `/mcp`

O servidor só aparece em configurações elegíveis. Verifique se: * Você está no macOS. Computer use na CLI não está disponível no Linux ou Windows. No Windows, use [computer use em Desktop](/pt/desktop#let-fuxi-use-your-computer) em vez disso. * Você está em um plano Pro ou Max. Execute `/status` para confirmar sua assinatura. * Você está autenticado através de fuxi.ai. Computer use não está disponível com provedores de terceiros como Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Se você acessar Fuxi exclusivamente através de um provedor de terceiros, você precisa de uma conta fuxi.ai separada para usar este recurso. * Você está em uma sessão interativa. Computer use não está disponível em modo não interativo com a flag `-p`.

Veja também

* [Computer use em Desktop](/pt/desktop#let-fuxi-use-your-computer): a mesma capacidade com uma página de configurações gráfica * [Fuxi no Chrome](/pt/chrome): automação de navegador para tarefas baseadas na web * [MCP](/pt/mcp): conecte Fuxi a ferramentas e APIs estruturadas * [Sandboxing](/pt/sandboxing): como a ferramenta Bash de Fuxi isola o acesso ao sistema de arquivos e rede * [Guia de segurança do computer use](https://support.fuxi.com/en/articles/14128542): melhores práticas para uso seguro de computer use