Skip to main content
Il riquadro iOS Simulator è in beta pubblica in Claude Code Desktop su macOS. È disponibile nei piani Pro, Max, Team ed Enterprise, tranne nelle organizzazioni Enterprise che hanno una configurazione HIPAA abilitata.
Il riquadro iOS Simulator mostra la tua app in esecuzione nell’iOS Simulator di Apple accanto alla tua conversazione in Claude Code Desktop. Quando Claude compila, installa, avvia o verifica la tua app in un simulatore, il riquadro si apre automaticamente e trasmette lo schermo del dispositivo in diretta. Usalo per osservare Claude mentre esegue e testa la tua app, oppure per navigare tu stesso nell’app mentre Claude continua a lavorare. Il riquadro del simulatore controlla il simulatore direttamente, quindi non ha bisogno di computer use e non prende mai il controllo dello schermo o nasconde le altre finestre. Dalla CLI, Claude raggiunge l’iOS Simulator attraverso computer use, che controlla il simulatore sullo schermo nello stesso modo in cui lo faresti con un mouse.

​
Requisiti

Il riquadro del simulatore utilizza gli strumenti del simulatore di Apple, che l’app desktop non include. Prima di avviare una sessione, assicurati di avere:
In questa pagina, “dispositivo” si riferisce a un iPhone o iPad simulato, uno degli stessi dispositivi simulatore che gestisci in Xcode in Window → Devices and Simulators, non a hardware fisico.
Il riquadro del simulatore è disponibile solo nelle sessioni locali. Nelle sessioni cloud e SSH, Claude viene eseguito su una macchina che non può raggiungere i simulatori sul tuo Mac.

​
Esegui la tua app nel simulatore

Non hai bisogno di un comando o di un’impostazione per aprire il riquadro del simulatore. Claude lo apre quando esegue la tua app in un simulatore.
1

Apri il tuo progetto iOS

In Claude Code Desktop, apri la scheda Code e avvia una sessione con la cartella del progetto della tua app come cartella del progetto. Qualsiasi progetto che compila un’app per l’iOS Simulator funziona.
2

Chiedi a Claude di eseguire o testare l'app

Esprimi l’attività intorno all’esecuzione o alla verifica dell’app. Ad esempio:
3

Guarda l'app nel riquadro del simulatore

Quando l’app viene avviata in un simulatore, il riquadro iOS Simulator si apre accanto alla conversazione. La prima volta che Claude utilizza un dispositivo, l’app desktop ti chiede di consentirlo; vedi Concedi a Claude l’accesso a un dispositivo. Claude installa l’app, la naviga, e legge lo schermo per verificare i propri cambiamenti mentre tu osservi.
Il riquadro del simulatore si apre ogni volta che Claude avvia l’app in un simulatore, in qualsiasi momento della sessione. Quando la tua richiesta riguarda la visualizzazione dell’app, ad esempio “il nuovo schermo sembra giusto?”, Claude avvia un simulatore prima di iniziare il lavoro. Dopo che Claude corregge un bug o cambia uno schermo, chiedigli di verificare il cambiamento: riavviare l’app riaprirà il riquadro se non è aperto. Il riquadro del simulatore mostra il dispositivo in cui l’app è effettivamente stata avviata. Per testare su un dispositivo specifico, nominalo nella tua richiesta, ad esempio “eseguilo sul simulatore iPhone SE”, e Claude indirizza quel dispositivo quando compila e avvia. Un dispositivo che Claude avvia appare anche nell’app Simulator di Apple, e Claude può installare l’app su un dispositivo che hai già avviato. Puoi anche aprire il riquadro del simulatore tu stesso. Una volta che la sessione ha un simulatore collegato o ha modificato file Swift, il menu Views nella barra degli strumenti della sessione mostra una voce iOS Simulator. Se il riquadro non sta ancora mostrando un dispositivo, fai clic su Attach simulator, oppure scegli un dispositivo specifico dal menu dei dispositivi accanto ad esso; scegliere un dispositivo spento lo avvia. Se Xcode o i suoi simulatori mancano, il riquadro mostra invece i passaggi di configurazione e li spunta man mano che li completi.

​
Controlla il simulatore tu stesso

Il riquadro del simulatore è interattivo, non solo un visualizzatore. Mentre Claude lavora, o tra i compiti, puoi:
  • Toccare e scorrere facendo clic e trascinando sullo schermo del dispositivo
  • Premere i pulsanti hardware con le stesse scorciatoie da tastiera dell’app Simulator di Apple: Cmd+Shift+H per Home, Cmd+L per bloccare, Cmd+Up Arrow e Cmd+Down Arrow per il volume
  • Ruotare il dispositivo di un quarto di giro in senso orario con il pulsante di rotazione o Cmd+Right Arrow
  • Cambiare quale dispositivo il riquadro mostra dal menu dei dispositivi, che elenca la versione del sistema operativo di ogni simulatore e se è avviato
  • Salvare uno screenshot con Cmd+S o una registrazione dello schermo con Cmd+R, utilizzando i pulsanti di acquisizione del riquadro o le scorciatoie da tastiera; i file vengono salvati sul tuo Desktop
  • Interrompere lo streaming di un dispositivo senza spegnerlo facendo clic su Detach simulator, che riporta il riquadro allo stato Attach simulator
La riga sotto il nome del dispositivo regola il flusso video dal simulatore. Abbassa Frame rate o Resolution se il riquadro affatica il tuo Mac, cambia Encoding tra H.264 e JPEG, oppure seleziona FPS per visualizzare la frequenza dei fotogrammi che il riquadro sta ricevendo. Queste impostazioni cambiano il modo in cui il riquadro visualizza il dispositivo, non il modo in cui l’app viene eseguita. Tu e Claude controllate lo stesso dispositivo, quindi i tuoi tocchi cambiano lo stato dell’app che Claude vede. Per fare in modo che Claude verifichi uno schermo specifico, navigaci toccando, quindi chiedi. Mentre Claude controlla il dispositivo, il riquadro mostra un badge Claude is using this device sopra lo schermo; aspetta che il badge scompaia prima di toccare, in modo che il risultato rifletta l’app piuttosto che il tuo input.

​
Come le sessioni gestiscono i dispositivi

Ogni dispositivo appartiene alla sessione che lo ha avviato, quindi le sessioni parallele non condividono un dispositivo: quello che vedi nel riquadro di una sessione riflette il lavoro di quella sessione, non di un’altra. Cambiare sessioni nella barra laterale cambia la visualizzazione del simulatore insieme alla conversazione, e tornare indietro riprende lo stesso dispositivo da dove era rimasto. Se Claude lavora con più di un dispositivo, ognuno apre il proprio riquadro, fino a 4 per sessione. Claude Code Desktop spegne i simulatori che ha avviato una volta che non sono più in uso: quando esci dall’app, quando archivi la sessione, o 10 minuti dopo aver scollegato un dispositivo dal suo riquadro. I dispositivi che avvii tu stesso, sia dal riquadro che dall’app Simulator di Apple, non vengono mai spenti automaticamente. Per spegnere il dispositivo collegato subito, usa il pulsante di spegnimento nel riquadro.

​
Concedi a Claude l’accesso a un dispositivo

Claude chiede il tuo consenso prima di controllare un dispositivo, mentre compilare l’app o aprire un URL su di esso segue la modalità di autorizzazione della tua sessione. Tu o la tua organizzazione potete anche disattivare completamente l’accesso di Claude.

​
Consenti un dispositivo la prima volta

La prima volta che Claude utilizza un simulatore, l’app desktop ti chiede di consentirlo. Il consenso copre il controllo di quel dispositivo e l’acquisizione di screenshot, e lo dai una volta per dispositivo piuttosto che una volta per sessione. Gli screenshot di Claude del dispositivo vengono inviati ad Anthropic e conservati secondo le tue normali impostazioni di conservazione della conversazione, quindi non accedere ad account reali su un dispositivo che Claude utilizza. Dopo aver consentito un dispositivo, le azioni di Claude su di esso, come toccare, digitare, avviare l’app e acquisire screenshot, vengono eseguite senza ulteriori prompt. Hanno la stessa fiducia di quando fai clic nel riquadro, e toccano solo il dispositivo simulato, quindi il riquadro non ha bisogno delle autorizzazioni macOS Accessibility e Screen Recording che il computer use richiede. Se rifiuti, il dispositivo viene comunque avviato e il riquadro funziona ancora per i tuoi tocchi; solo l’accesso di Claude rimane disattivato. Per cambiare idea in seguito, fai clic su Let Claude use it nel riquadro.

​
Azioni che seguono la tua modalità di autorizzazione

Due azioni seguono la modalità di autorizzazione della tua sessione invece del consenso una tantum:
  • Aprire un URL sul dispositivo, ad esempio per testare un deep link o caricare una pagina nel Safari del dispositivo, perché un URL può portare dati fuori dal dispositivo.
  • Compilare l’app, perché xcodebuild esegue gli script di compilazione del tuo progetto sul tuo Mac. Controllare una compilazione già in corso non genera un prompt.

​
Disattiva l’accesso al simulatore

Puoi disattivare l’accesso al simulatore di Claude nelle impostazioni dell’app desktop. Le organizzazioni hanno due modi per disattivarlo per tutti:
  • L’impostazione gestita disableMobileSimulatorTools blocca gli strumenti del simulatore di Claude. Il riquadro del simulatore rimane utilizzabile per i tuoi tocchi, e l’impostazione non può essere ignorata dall’interno dell’app.
  • La chiave della politica requireCoworkFullVmSandbox, che esegue gli strumenti di Claude all’interno di una macchina virtuale isolata invece che sul tuo Mac, disabilita il riquadro del simulatore e gli strumenti del simulatore di Claude interamente, quindi il riquadro non può collegare un dispositivo mentre è impostato.
Claude ti avvisa quando uno di questi si applica.

​
Limitazioni

Claude controlla solo dispositivi simulati e non può controllare un iPhone o iPad fisico. Per testare su uno, esegui l’app su di esso da Xcode tu stesso, quindi descrivi quello che vedi o allega uno screenshot alla conversazione affinché Claude possa lavorarci.

​
Troubleshooting

​
Il riquadro del simulatore non si apre quando Claude esegue l’app

Claude potrebbe non aver riconosciuto che volevi eseguire o testare l’app, oppure gli strumenti del simulatore potrebbero mancare. Controlla quanto segue:
  • Dichiara l’obiettivo esplicitamente, ad esempio “esegui l’app nell’iOS Simulator e naviga attraverso il flusso di iscrizione”.
  • Conferma che Xcode e i simulatori iOS siano installati e che la tua versione di Xcode soddisfi i requisiti.
  • Se la tua organizzazione gestisce Claude Code, gli strumenti del simulatore potrebbero essere disabilitati dalla politica.
  • Se sei in un’organizzazione Enterprise che ha una configurazione HIPAA abilitata, il riquadro del simulatore non è disponibile per te.
  • Il riquadro del simulatore richiede Claude Desktop v1.24012.0 o successivo. Apri Claude → Check for Updates, quindi riavvia l’app.

​
Il riquadro del simulatore dice che non sono stati trovati simulatori

Se xcode-select punta a Xcode 27, il riquadro può segnalare che non sono stati trovati simulatori anche se i dispositivi esistono; vedi Il riquadro del simulatore non funziona con Xcode 27. Altrimenti, Xcode è installato ma non ha simulatori iOS da elencare. Il riquadro del simulatore mostra i passaggi di configurazione da seguire e li spunta man mano che ognuno si completa. Per installare il pezzo mancante manualmente, scarica il runtime del simulatore iOS dalle impostazioni di Xcode, oppure esegui xcodebuild -downloadPlatform iOS.

​
Il riquadro del simulatore non funziona con Xcode 27

Il riquadro non funziona ancora con Xcode 27, che sostituisce l’app Simulator con Device Hub. Con Xcode 27 selezionato, il collegamento di un dispositivo non riesce, oppure il riquadro segnala che non sono stati trovati simulatori anche se i dispositivi esistono. Il riquadro utilizza qualunque Xcode xcode-select punti. Se Xcode 27 è la tua unica installazione, installa prima Xcode 26.x insieme ad esso. Quindi seleziona l’installazione 26.x dal suo percorso. Ad esempio, se è installato come /Applications/Xcode-26.4.app:
Esegui xcode-select -p per controllare quale installazione è selezionata.

​
Vedi anche