Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 Claude Code v2.1.85 ou posterior e uma sessão interativa, portanto não está disponível em modo não interativo com a flag -p.
Computer use permite que Claude abra aplicativos, controle sua tela e trabalhe em sua máquina da forma como você faria. A partir da CLI, Claude 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, consulte computer use em Desktop.

​
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 Claude para construir um aplicativo de barra de menu do macOS. Claude 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 Claude para um aplicativo Electron local e diga “teste o fluxo de integração”. Claude 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 Claude “o modal está sendo cortado em janelas pequenas”. Claude redimensiona a janela, reproduz o bug, captura uma tela, corrige o CSS e verifica a correção. Claude 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

Claude tem várias maneiras de interagir com um aplicativo ou serviço. Computer use é a mais ampla e lenta, portanto Claude tenta a ferramenta mais precisa primeiro:
  • Se você tiver um servidor MCP para o serviço, Claude usa isso.
  • Se a tarefa for um comando shell, Claude usa Bash.
  • Se a tarefa for trabalho de navegador e você tiver Claude no Chrome configurado, Claude usa isso.
  • Se nenhum desses se aplicar, Claude 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.
1

Abra o menu MCP

Em uma sessão interativa do Claude Code, execute:
/mcp
Encontre computer-use na lista de servidores. Ele aparece como desativado.
2

Ativar o servidor

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.
3

Conceder permissões do macOS

Na primeira vez que Claude tentar usar seu computador, você verá um prompt para conceder duas permissões do macOS:
  • Accessibility: permite que Claude clique, digite e role
  • Screen Recording: permite que Claude 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 Claude Code após conceder Screen Recording.
Após a configuração, peça a Claude para fazer algo que precise da GUI: 
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 Claude acesso a todos os aplicativos em sua máquina. Na primeira vez que Claude precisar de um aplicativo específico em uma sessão, um prompt aparece em seu terminal mostrando:
  • Quais aplicativos Claude deseja controlar
  • Quaisquer permissões extras solicitadas, como acesso à área de transferência
  • Quantos outros aplicativos serão ocultados enquanto Claude 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 Claude os solicita juntos. Aplicativos com amplo alcance mostram um aviso extra no prompt para que você saiba o que aprovar concede:
AvisoAplica-se a
Equivalente ao acesso shellTerminal, iTerm, VS Code, Warp e outros terminais e IDEs
Pode ler ou escrever qualquer arquivoFinder
Pode alterar configurações do sistemaSystem 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 Claude 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 para a divisão de camada completa.

​
Como Claude trabalha em sua tela

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

​
Uma sessão por vez

Computer use mantém um bloqueio em toda a máquina enquanto ativo. Se outra sessão do Claude Code já estiver usando seu computador, novas tentativas falharão com uma mensagem informando qual sessão mantém o bloqueio. Termine ou saia dessa sessão primeiro.

​
Os aplicativos são ocultados enquanto Claude trabalha

Quando Claude começa a controlar sua tela, outros aplicativos visíveis são ocultados para que Claude 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 Claude nunca veja sua própria saída. Quando Claude termina a vez, os aplicativos ocultos são restaurados automaticamente.

​
Parar a qualquer momento

Quando Claude adquire o bloqueio, uma notificação do macOS aparece: “Claude 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, Claude libera o bloqueio, mostra seus aplicativos e retorna o controle a você. Uma segunda notificação aparece quando Claude termina.

​
Segurança e o limite de confiança

Ao contrário da ferramenta Bash em sandbox, computer use é executado em seu desktop real com acesso aos aplicativos que você aprova. Claude 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 para as melhores práticas.
Os guardrails integrados reduzem o risco sem exigir configuração:
  • Aprovação por aplicativo: Claude 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: Claude 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 Claude para compilar e verificar em uma única passagem: 
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.
Claude 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 Claude encontrá-lo: 
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.
Claude 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: 
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.
Claude 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. Alguns controles específicos do Desktop ainda não estão na CLI:
RecursoDesktopCLI
AtivarAlternar em Settings > General (em Desktop app)Ativar computer-use em /mcp
Lista de aplicativos negadosConfigurável em SettingsAinda não disponível
Alternância de auto-unhideOpcionalSempre ativado
Integração do DispatchSessões geradas por Dispatch podem usar computer useNão aplicável

​
Troubleshooting

​
”Computer use is in use by another Claude session”

Outra sessão do Claude Code mantém o bloqueio. Termine a tarefa nessa sessão ou saia dela. Se a outra sessão travou, o bloqueio é liberado automaticamente quando Claude detecta que o processo não está mais em execução.

​
O prompt de permissões do macOS continua reaparecendo

O macOS às vezes requer uma reinicialização do processo solicitante após você conceder Screen Recording. Saia completamente do Claude 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 não aparece em /mcp

O servidor só aparece em configurações elegíveis. Verifique se:
  • Você está no macOS. Computer use não está disponível no Linux ou Windows.
  • Você está executando Claude Code v2.1.85 ou posterior. Execute claude --version para verificar.
  • Você está em um plano Pro ou Max. Execute /status para confirmar sua assinatura.
  • Você está autenticado através de claude.ai. Computer use não está disponível com provedores de terceiros como Amazon Bedrock, Google Cloud Vertex AI ou Microsoft Foundry. Se você acessar Claude exclusivamente através de um provedor de terceiros, você precisa de uma conta claude.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