Vai al contenuto principale

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 è un’anteprima di ricerca su macOS che richiede un piano Pro o Max. Non è disponibile nei piani Team o Enterprise. Richiede Claude Code v2.1.85 o successivo e una sessione interattiva, quindi non è disponibile in modalità non interattiva con il flag -p.
Computer use consente a Claude di aprire app, controllare il tuo schermo e lavorare sulla tua macchina come faresti tu. Dalla CLI, Claude può compilare un’app Swift, avviarla, fare clic su ogni pulsante e acquisire uno screenshot del risultato, il tutto nella stessa conversazione in cui ha scritto il codice. Questa pagina spiega come funziona computer use nella CLI. Per l’app Desktop, vedi computer use in Desktop.

​
Cosa puoi fare con computer use

Computer use gestisce attività che richiedono una GUI: qualsiasi cosa che normalmente dovresti lasciare il terminale e fare manualmente.
  • Compila e convalida app native: chiedi a Claude di compilare un’app menu bar di macOS. Claude scrive lo Swift, lo compila, avvia l’app e fa clic su ogni controllo per verificare che funzioni prima che tu la apra.
  • Test UI end-to-end: punta Claude a un’app Electron locale e dì “testa il flusso di onboarding.” Claude apre l’app, fa clic attraverso l’iscrizione e acquisisce uno screenshot di ogni passaggio. Nessuna configurazione Playwright, nessun test harness.
  • Esegui il debug di problemi visivi e di layout: dì a Claude “il modale si taglia su finestre piccole.” Claude ridimensiona la finestra, riproduce il bug, acquisisce uno screenshot, corregge il CSS e verifica la correzione. Claude vede quello che vedi tu.
  • Guida strumenti solo GUI: interagisci con strumenti di progettazione, pannelli di controllo hardware, iOS Simulator o app proprietarie che non hanno CLI o API.

​
Quando si applica computer use

Claude ha diversi modi per interagire con un’app o un servizio. Computer use è il più ampio e lento, quindi Claude prova prima lo strumento più preciso:
  • Se hai un server MCP per il servizio, Claude lo usa.
  • Se l’attività è un comando shell, Claude usa Bash.
  • Se l’attività è lavoro nel browser e hai Claude in Chrome configurato, Claude lo usa.
  • Se nessuno di questi si applica, Claude usa computer use.
Il controllo dello schermo è riservato a cose che nient’altro può raggiungere: app native, simulatori e strumenti senza API.

​
Abilita computer use

Computer use è disponibile come server MCP integrato chiamato computer-use. È disabilitato per impostazione predefinita finché non lo abiliti.
1

Apri il menu MCP

In una sessione interattiva di Claude Code, esegui:
/mcp
Trova computer-use nell’elenco dei server. Viene mostrato come disabilitato.
2

Abilita il server

Seleziona computer-use e scegli Enable. L’impostazione persiste per progetto, quindi lo fai una sola volta per ogni progetto in cui desideri computer use.
3

Concedi le autorizzazioni di macOS

La prima volta che Claude tenta di usare il tuo computer, vedrai un prompt per concedere due autorizzazioni di macOS:
  • Accessibility: consente a Claude di fare clic, digitare e scorrere
  • Screen Recording: consente a Claude di vedere cosa c’è sullo schermo
Il prompt include link per aprire il riquadro Impostazioni di sistema pertinente. Concedi entrambi, quindi seleziona Try again nel prompt. macOS potrebbe richiedere il riavvio di Claude Code dopo aver concesso Screen Recording.
Dopo la configurazione, chiedi a Claude di fare qualcosa che necessita della GUI: 
Build the app target, launch it, and click through each tab to make
sure nothing crashes. Screenshot any error states you find.

​
Approva app per sessione

L’abilitazione del server computer-use non concede a Claude l’accesso a ogni app sulla tua macchina. La prima volta che Claude ha bisogno di un’app specifica in una sessione, nel tuo terminale appare un prompt che mostra:
  • Quali app Claude vuole controllare
  • Eventuali autorizzazioni aggiuntive richieste, come l’accesso agli appunti
  • Quante altre app saranno nascoste mentre Claude lavora
Scegli Allow for this session o Deny. Le approvazioni durano per la sessione corrente. Puoi approvare più app contemporaneamente quando Claude le richiede insieme. Le app con ampia portata mostrano un avviso aggiuntivo nel prompt in modo che tu sappia cosa concedere:
AvvisoSi applica a
Equivalente all’accesso shellTerminal, iTerm, VS Code, Warp e altri terminali e IDE
Può leggere o scrivere qualsiasi fileFinder
Può modificare le impostazioni di sistemaSystem Settings
Queste app non sono bloccate. L’avviso ti consente di decidere se l’attività giustifica quel livello di accesso. Il livello di controllo di Claude varia anche per categoria di app: i browser e le piattaforme di trading sono di sola visualizzazione, i terminali e gli IDE sono di sola clic e tutto il resto ottiene il controllo completo. Vedi app permissions in Desktop per la suddivisione completa dei livelli.

​
Come Claude lavora sul tuo schermo

Comprendere il flusso ti aiuta ad anticipare cosa farà Claude e come intervenire.

​
Una sessione alla volta

Computer use mantiene un blocco a livello di macchina mentre è attivo. Se un’altra sessione di Claude Code sta già usando il tuo computer, i nuovi tentativi falliscono con un messaggio che ti dice quale sessione tiene il blocco. Termina o esci da quella sessione per primo.

​
Le app sono nascoste mentre Claude lavora

Quando Claude inizia a controllare il tuo schermo, altre app visibili vengono nascoste in modo che Claude interagisca solo con le app approvate. La finestra del tuo terminale rimane visibile ed è esclusa dagli screenshot, quindi puoi guardare la sessione e Claude non vede mai il suo stesso output. Quando Claude termina il turno, le app nascoste vengono ripristinate automaticamente.

​
Ferma in qualsiasi momento

Quando Claude acquisisce il blocco, appare una notifica di macOS: “Claude is using your computer · press Esc to stop.” Premi Esc ovunque per interrompere immediatamente l’azione corrente, oppure premi Ctrl+C nel terminale. In entrambi i casi, Claude rilascia il blocco, mostra di nuovo le tue app e ti restituisce il controllo. Una seconda notifica appare quando Claude ha finito.

​
Sicurezza e il confine di fiducia

A differenza dello strumento Bash in sandbox, computer use viene eseguito sul tuo desktop effettivo con accesso alle app che approvi. Claude controlla ogni azione e segnala potenziali iniezioni di prompt dal contenuto sullo schermo, ma il confine di fiducia è diverso. Vedi la guida alla sicurezza di computer use per le best practice.
I guardrail integrati riducono il rischio senza richiedere configurazione:
  • Approvazione per app: Claude può controllare solo le app che hai approvato nella sessione corrente.
  • Avvisi sentinel: le app che concedono accesso shell, filesystem o impostazioni di sistema sono contrassegnate prima che tu le approvi.
  • Terminale escluso dagli screenshot: Claude non vede mai la finestra del tuo terminale, quindi i prompt sullo schermo nella tua sessione non possono retroalimentare il modello.
  • Escape globale: il tasto Esc interrompe computer use da qualsiasi luogo e la pressione del tasto viene consumata in modo che l’iniezione di prompt non possa usarla per chiudere i dialoghi.
  • File di blocco: solo una sessione può controllare la tua macchina alla volta.

​
Flussi di lavoro di esempio

Questi esempi mostrano modi comuni per combinare computer use con attività di codifica.

​
Convalida una build nativa

Dopo aver apportato modifiche a un’app macOS o iOS, chiedi a Claude di compilare e verificare in un unico passaggio: 
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 esegue xcodebuild, avvia l’app, interagisce con l’interfaccia utente e segnala quello che trova.

​
Riproduci un bug di layout

Quando un bug visivo appare solo a determinate dimensioni di finestra, lascia che Claude lo trovi: 
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 ridimensiona la finestra, cattura lo stato rotto e legge i fogli di stile pertinenti.

​
Testa un flusso di simulatore

Guida iOS Simulator senza scrivere 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 controlla il simulatore nello stesso modo in cui lo faresti tu con un mouse.

​
Differenze dall’app Desktop

Le superfici CLI e Desktop condividono lo stesso motore di computer use. Alcuni controlli specifici di Desktop non sono ancora nella CLI:
FunzionalitàDesktopCLI
AbilitaAttiva/disattiva in Settings > General (sotto Desktop app)Abilita computer-use in /mcp
Elenco app negateConfigurabile in ImpostazioniNon ancora disponibile
Attiva/disattiva auto-unhideFacoltativoSempre attivo
Integrazione DispatchLe sessioni generate da Dispatch possono usare computer useNon applicabile

​
Troubleshooting

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

Un’altra sessione di Claude Code tiene il blocco. Termina l’attività in quella sessione o esci da essa. Se l’altra sessione si è bloccata, il blocco viene rilasciato automaticamente quando Claude rileva che il processo non è più in esecuzione.

​
Il prompt delle autorizzazioni di macOS continua a riapparire

macOS a volte richiede un riavvio del processo richiedente dopo aver concesso Screen Recording. Esci completamente da Claude Code e avvia una nuova sessione. Se il prompt persiste, apri System Settings > Privacy & Security > Screen Recording e conferma che la tua app terminale è elencata e abilitata.

​
computer-use non appare in /mcp

Il server appare solo su configurazioni idonee. Verifica che:
  • Sei su macOS. Computer use non è disponibile su Linux o Windows.
  • Stai eseguendo Claude Code v2.1.85 o successivo. Esegui claude --version per verificare.
  • Sei su un piano Pro o Max. Esegui /status per confermare il tuo abbonamento.
  • Sei autenticato tramite claude.ai. Computer use non è disponibile con provider di terze parti come Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry. Se accedi a Claude esclusivamente tramite un provider di terze parti, hai bisogno di un account claude.ai separato per usare questa funzionalità.
  • Sei in una sessione interattiva. Computer use non è disponibile in modalità non interattiva con il flag -p.

​
Vedi anche