DEV Community

Cover image for Claude Controla Seu Mac Agora: Aprenda Como Usar
Lucas
Lucas

Posted on • Originally published at apidog.com

Claude Controla Seu Mac Agora: Aprenda Como Usar

TL;DR

O Claude Code agora pode controlar seu Mac: abre aplicativos, navega por interfaces de usuário, executa testes e tira screenshots dos resultados, tudo direto do terminal. Para usar, ative com /mcp no Claude Code, ligue o servidor computer-use e conceda as permissões de Acessibilidade e Gravação de Tela nas Configurações do Sistema. Disponível para assinantes Pro e Max no macOS.

Experimente o Apidog hoje

Claude agora pode usar seu computador

A Anthropic anunciou o recurso de uso do computador pelo Claude Code em 23 de março de 2026. Claude não apenas escreve código, mas agora executa e testa o que criou diretamente no ambiente nativo do seu Mac, automatizando desde a compilação até a interação com a interface do usuário e a captura de evidências.

Antes, era necessário compilar e testar código manualmente. Agora, Claude faz tudo: compila, executa, navega na UI, tira screenshots de estados de erro e corrige problemas detectados sem sair do terminal.

Resumo prático:

  • Antes: "escreva este app para mim."
  • Agora: "construa este app e garanta que ele funcione."

💡 Se você desenvolve com APIs, Claude pode testar fluxos em ferramentas GUI sem CLI/API. Use o Apidog para criar suítes de testes automatizados e validar estes fluxos programaticamente após a verificação do Claude.

O que você pode fazer com ele

Construir e validar aplicativos nativos de ponta a ponta

Use prompts objetivos para gerar e validar apps completos. Exemplo prático:

Construa o alvo MenuBarStats, inicie-o, abra a janela de preferências,
e verifique se o controle deslizante de intervalo atualiza o rótulo. Tire um
screenshot da janela de preferências quando terminar.
Enter fullscreen mode Exit fullscreen mode

Claude executa xcodebuild, inicia o binário, interage com a UI, captura screenshots e corrige falhas detectadas. Resultado: builds validados automaticamente.

Teste de UI sem um framework de teste

Descreva fluxos de UI em texto simples e Claude executa sem setup de Playwright, Selenium ou XCTest:

Abra o aplicativo, clique nas telas de integração e me diga se alguma
tela leva mais de um segundo para carregar.
Enter fullscreen mode Exit fullscreen mode

Claude navega, clica, captura telas e reporta transições lentas — direto, sem harness de teste, para apps Electron, nativos e iOS Simulator.

Depurar bugs visuais e de layout

Automatize a reprodução de bugs de layout:

O modal de configurações corta o rodapé em janelas estreitas. Redimensione a
janela do aplicativo até conseguir reproduzir, tire um screenshot do estado
cortado, então verifique o CSS do container do modal.
Enter fullscreen mode Exit fullscreen mode

Claude redimensiona, captura o estado quebrado, revisa e corrige o CSS.

Operar ferramentas apenas com GUI

Automatize tarefas em ferramentas sem CLI/API, como software de design ou iOS Simulator. Descreva o fluxo e Claude executa via interface gráfica.

Um gif mostrando o Claude interagindo com um aplicativo Mac, redimensionando janelas e clicando em botões.

Como ativá-lo

O recurso vem desativado por padrão e precisa ser habilitado por projeto.

Pré-requisitos:

  • macOS
  • Claude Code v2.1.85 ou superior (claude --version)
  • Plano Pro ou Max
  • Autenticação via claude.ai
  • Sessão interativa (não utilize -p)

Passo 1: Abrir o menu MCP

No terminal, execute:

/mcp
Enter fullscreen mode Exit fullscreen mode

Encontre computer-use na lista de servidores. Ele aparecerá como desativado.

Passo 2: Ativar o servidor

Selecione computer-use e clique em Ativar. Isso é persistente por projeto.

Passo 3: Conceder permissões do macOS

Na primeira execução, aceite os dois prompts:

  • Acessibilidade: permite clique, digitação e rolagem.
  • Gravação de Tela: permite capturar a tela.

Dê ambas as permissões. Após conceder gravação de tela, reinicie o Claude Code se necessário.

Teste inicial:

Construa o alvo do aplicativo, inicie-o e clique em cada aba para confirmar
que nada falha. Tire screenshots de quaisquer estados de erro que encontrar.
Enter fullscreen mode Exit fullscreen mode

Como Claude funciona na sua tela

Uma sessão por vez

A funcionalidade mantém bloqueio na máquina. Só uma sessão do Claude pode controlar o computador. Se outra sessão estiver ativa, finalize-a antes de prosseguir.

Aplicativos se ocultam enquanto Claude trabalha

Quando Claude está ativo, outros apps são ocultados. O terminal permanece visível (e é excluído dos screenshots). Ao finalizar, os apps ocultos são restaurados.

Parar a qualquer momento

Enquanto Claude controla a máquina, aparece o aviso: “Claude está usando seu computador – pressione Esc para parar.” Pressione Esc ou Ctrl+C para interromper imediatamente e recuperar o controle.


Aprovação por aplicativo

Ativar computer-use não dá acesso global. Ao acessar cada app pela primeira vez, um prompt mostra:

  • Quais apps Claude quer controlar
  • Permissões extras solicitadas
  • Quantos apps serão ocultados

Escolha Permitir para esta sessão ou Negar. A aprovação é válida apenas para a sessão atual.

Avisos extras para apps críticos:

Aviso Aplicativos
Equivalente ao acesso shell Terminal, iTerm2, VS Code, Warp, IDEs
Pode ler ou escrever qualquer arquivo Finder
Pode alterar as configurações do sistema Configurações do Sistema

Esses avisos indicam o nível de acesso, mas não bloqueiam a execução.

Níveis de controle de aplicativos

Nível de controle Tipos de aplicativos
Somente visualização Navegadores, plataformas de trading
Somente clique Terminais, IDEs
Controle total Todos os outros aplicativos

Navegadores são só leitura para proteger dados sensíveis. Para automação completa do navegador, utilize o Claude no Chrome.


Como Claude decide quando usar o computador

Claude prioriza ferramentas programáticas:

  1. Servidor MCP (se configurado)
  2. Bash para comandos shell
  3. Claude no Chrome para tarefas de navegador
  4. Uso do computador apenas quando não há API/CLI

O controle da tela é reservado para apps nativos, simuladores e GUIs sem interface programática.

Modelo de segurança

O uso do computador executa ações diretamente na sua máquina, diferentemente do sandbox Bash. Medidas de segurança incluem:

  • Aprovação por aplicativo: controle granular por sessão.
  • Alertas sentinela: destaque para apps críticos.
  • Terminal excluído de screenshots.
  • Escape global: Esc aborta imediatamente.
  • Bloqueio por sessão: nenhuma concorrência.
  • Detecção de injeção de prompt.

Recomendação: Não use com dados sensíveis até se sentir confortável. Prefira ambientes de teste.

Exemplos de fluxos de trabalho

Validação de aplicativo Swift de ponta a ponta

Construa o alvo MenuBarStats, inicie-o, abra a janela de preferências,
e verifique se o controle deslizante de intervalo atualiza o rótulo. Tire um
screenshot da janela de preferências quando terminar.
Enter fullscreen mode Exit fullscreen mode

Claude irá:

  • Executar xcodebuild
  • Iniciar o binário
  • Abrir preferências
  • Mover o slider e verificar o rótulo
  • Tirar screenshot
  • Reportar falhas

Reproduzindo um bug de layout

O modal de configurações corta o rodapé em janelas estreitas. Redimensione a
janela do aplicativo até conseguir reproduzir, tire um screenshot do estado
cortado, então verifique o CSS do container do modal.
Enter fullscreen mode Exit fullscreen mode

Claude redimensiona e corrige o CSS automaticamente.

Teste no iOS Simulator sem XCTest

Abra o iOS Simulator, inicie o aplicativo, toque nas telas de integração,
e me diga se alguma tela leva mais de um segundo para carregar.
Enter fullscreen mode Exit fullscreen mode

Automação instantânea, sem configuração de XCTest.

Fluxo de integração de aplicativo Electron

Inicie o aplicativo de desktop no modo de desenvolvimento, complete o fluxo de
cadastro usando test@example.com, e tire um screenshot de cada passo. Sinalize
qualquer passo onde o botão não é clicável ou a UI mostra um erro.
Enter fullscreen mode Exit fullscreen mode

Claude automatiza todo o fluxo, reportando telas e falhas.

Usando o computador com testes de API

Combine o uso do computador pelo Claude Code com o Apidog para validação full-stack:

  1. Claude gera e executa o backend local.
  2. Claude automatiza a UI para acionar ações e validar respostas.
  3. Capture as requisições no Apidog e crie testes automatizados.
  4. Use os testes do Apidog em CI para evitar regressões.

Assim, você cobre tanto a validação ponta-a-ponta legível quanto os testes programáticos automatizados.

Diferenças entre CLI e aplicativo de Desktop

CLI e Desktop compartilham o mesmo motor, mas algumas opções são exclusivas de cada plataforma:

Recurso Desktop CLI
Habilitar Configurações > Desktop > Geral /mcp > ativar computer-use
Lista de aplicativos negados Configurável em Configurações Não disponível
Alternar desocultar automático Opcional Sempre ligado
Integração de Despacho Sim Não aplicável

Para fluxos de trabalho de desenvolvimento, a CLI normalmente cobre tudo.

Solução de problemas

“Uso do computador está sendo usado por outra sessão do Claude”

Apenas uma sessão pode controlar a máquina. Saia da sessão travada. O bloqueio é liberado automaticamente se o processo finalizar.

O prompt de permissões do macOS continua reaparecendo

Reinicie o Claude Code após conceder permissão de Gravação de Tela. Verifique em Configurações do Sistema > Privacidade e Segurança > Gravação de Tela se o terminal está ativado.

computer-use não aparece em /mcp

Confirme:

  • Está usando macOS
  • claude --version ≥ 2.1.85
  • Plano Pro ou Max (/status)
  • Autenticado via claude.ai
  • Sessão interativa

Claude não consegue ver o aplicativo após aprovação

Apenas clique em Permitir para esta sessão no prompt. Se negou acidentalmente, reinicie a sessão.

FAQ

Qual versão do Claude Code é necessária?

v2.1.85 ou superior. Verifique com claude --version. Atualize com:

npm install -g @anthropic-ai/claude-code
Enter fullscreen mode Exit fullscreen mode

Funciona no Windows ou Linux?

Não. Exclusivo para macOS por enquanto.

Posso usar o computador via Amazon Bedrock ou Google Vertex AI?

Não. Precisa autenticação via claude.ai Pro ou Max.

Está disponível nos planos Team ou Enterprise?

Não. Somente nos planos Pro e Max.

O que acontece se não conceder Gravação de Tela?

Claude pode clicar/digitar se tiver Acessibilidade, mas não verifica visualmente. A maioria dos fluxos exige ambas.

Claude pode acessar aplicativos não aprovados?

Não. O controle é por aprovação de sessão.

Como revogar completamente o acesso ao uso do computador?

Desative computer-use em /mcp e remova permissões em Ajustes do Sistema > Privacidade e Segurança.

É seguro usar com dados sensíveis?

Recomendado NÃO usar com dados confidenciais. Prefira ambientes de teste e leia o guia de segurança do uso do computador.

Várias sessões podem usar o computador ao mesmo tempo?

Não. O bloqueio é exclusivo por máquina.

Qual a diferença para Playwright ou Selenium?

Playwright/Selenium exigem scripts e setup. O uso do computador executa interações por linguagem natural, sem configuração. Playwright é mais confiável para produção, mas Claude agiliza testes exploratórios e fluxos não automatizáveis por código.

Top comments (0)