Desktop iOS Simulator 패널
기준일: 2026-07-26
공식 기준: Test iOS apps in the simulator
개요
iOS Simulator 패널은 Claude Code Desktop(macOS) public beta입니다. Pro, Max, Team에서 사용 가능하고 Enterprise에서는 불가합니다.
대화 옆에 Apple iOS Simulator 화면을 보여 줍니다. Claude가 시뮬레이터에서 앱을 빌드·설치·실행·검사하면 패널이 자동으로 열리고 기기 화면을 라이브 스트리밍합니다. Claude 작업을 지켜보거나, Claude가 작업하는 동안 직접 탭할 수 있습니다.
패널은 시뮬레이터를 직접 제어하므로 computer use가 필요 없고 다른 창을 가리거나 화면을 가로채지 않습니다. CLI에서는 대신 computer use로 시뮬레이터를 마우스처럼 제어합니다.
이 페이지에서 “device”는 Xcode Window → Devices and Simulators의 가상 iPhone/iPad를 말하며, 실기기가 아닙니다.
핵심 개념
| 항목 | 내용 |
|---|---|
| 플랫폼 | macOS Desktop only |
| 플랜 | Pro / Max / Team (Enterprise 제외) |
| 세션 | 로컬 세션만 (cloud·SSH 세션 불가) |
| 디바이스 소유 | 세션별 격리 (병렬 세션이 공유하지 않음) |
| 패널 상한 | 세션당 최대 4개 디바이스 패널 |
| 동의 | 디바이스 최초 사용 시 1회 (세션마다 아님) |
상세
요구 사항
- Claude Desktop v1.24012.0 이상
- Mac (Apple iOS Simulator는 macOS 전용)
- Xcode + iOS 플랫폼 (시뮬레이터 목록이 비면 아래 트러블슈팅)
클라우드·SSH 세션의 Claude는 Mac 시뮬레이터에 도달할 수 없습니다.
시뮬레이터에서 앱 실행
별도 명령·설정 없이, Claude가 시뮬레이터에서 앱을 돌릴 때 패널이 열립니다.
- Code 탭에서 iOS 시뮬레이터용 앱 프로젝트를 project folder로 세션 시작
- 실행·검증 중심 요청 예:
Build the app and run it in the simulator to check the onboarding flow.
- 앱이 시뮬레이터에 뜨면 iOS Simulator 패널이 대화 옆에 열림. 디바이스 첫 사용 시 허용 요청. Claude가 설치·탭·화면 읽기로 변경을 검증하는 동안 시청
“새 화면이 맞나?”처럼 화면 확인이 목표면 Claude가 작업 전에 시뮬레이터를 시작합니다. 버그 수정 후 재실행하면 패널이 닫혀 있어도 다시 열립니다.
특정 기기가 필요하면 요청에 이름을 넣습니다. 예: “run it on the iPhone SE simulator”. Claude가 부팅한 디바이스는 Apple Simulator 앱에도 보이며, 이미 부팅된 디바이스에 설치할 수도 있습니다.
세션에 시뮬레이터가 붙었거나 Swift 파일을 편집한 뒤 Views 메뉴에 iOS Simulator가 생깁니다. 기기가 없으면 Attach simulator 또는 옆 디바이스 메뉴에서 선택(종료된 기기는 부팅). Xcode/시뮬레이터가 없으면 패널이 설정 단계를 체크리스트로 안내합니다.
직접 제어
패널은 뷰어만이 아닙니다.
- 클릭·드래그로 탭·스와이프
- 하드웨어 단축키: Cmd+Shift+H Home, Cmd+L lock, Cmd+Up/Down volume
- 회전: 버튼 또는 Cmd+Right Arrow
- 디바이스 메뉴로 OS 버전·부팅 여부 확인 후 전환
- 스크린샷 Cmd+S, 화면 녹화 Cmd+R → Desktop 저장
- Detach simulator: 스트림만 끊고 종료하지 않음
기기 이름 아래 행에서 스트림 Frame rate / Resolution / Encoding(H.264|JPEG) / FPS 를 조정합니다. 앱 실행이 아니라 표시만 바뀝니다.
당신과 Claude가 같은 기기를 쓰므로 탭이 Claude가 보는 상태를 바꿉니다. Claude가 운전 중이면 Claude is using this device 배지가 뜹니다. 배지가 사라질 때까지 탭을 보류하세요.
세션과 디바이스
디바이스는 띄운 세션 소유입니다. 병렬 세션이 공유하지 않습니다. 사이드바 세션 전환 시 시뮬레이터 뷰도 전환되고, 돌아오면 이어서 봅니다. 세션당 패널 최대 4개.
Claude가 부팅한 시뮬레이터는 앱 종료, 세션 아카이브, 또는 detach 후 10분 뒤 자동 종료됩니다. 사용자가 부팅한 디바이스는 자동 종료하지 않습니다. 즉시 종료는 패널 shutdown 버튼.
디바이스 접근 허용
Claude는 디바이스를 제어하기 전에 동의를 요청합니다. 빌드·URL 열기는 세션 permission mode를 따릅니다.
첫 허용
최초 사용 시 해당 디바이스 제어·스크린샷 동의를 디바이스당 1회 요청합니다. Claude 스크린샷은 Anthropic으로 전송되고 일반 대화 보존 설정을 따르므로, Claude가 쓰는 디바이스에 실계정 로그인하지 마세요.
허용 후 탭·입력·실행·스크린샷은 추가 프롬프트 없이 진행됩니다. 시뮬레이션 기기만 만지므로 computer use에 필요한 macOS Accessibility·Screen Recording 권한은 필요 없습니다.
거절해도 부팅·본인 탭은 가능하고 Claude 접근만 꺼집니다. 나중에 패널 Let Claude use it.
permission mode를 따르는 동작
- 디바이스에서 URL 열기 (딥링크·Safari 등 — 데이터가 기기 밖으로 나갈 수 있음)
- 앱 빌드 (
xcodebuild가 Mac에서 프로젝트 빌드 스크립트 실행). 진행 중인 빌드 상태 확인은 프롬프트 없음
시뮬레이터 접근 끄기
데스크톱 설정에서 Claude 시뮬레이터 접근을 끌 수 있습니다. 조직:
disableMobileSimulatorToolsmanaged setting: Claude 시뮬레이터 도구 차단. 본인 탭 패널은 유지. 앱 안에서 재정의 불가requireCoworkFullVmSandbox정책: 도구를 격리 VM에서 실행 → 시뮬레이터 패널·도구 전부 비활성
제한
Claude는 시뮬레이터만 제어하고 실 iPhone/iPad는 제어하지 않습니다. 실기기 테스트는 Xcode에서 직접 실행한 뒤 설명·스크린샷을 대화에 붙이세요.
트러블슈팅
패널이 안 열릴 때
- “iOS Simulator에서 실행하고 signup 플로우를 탭해 달라”처럼 목표를 명시
- Simulator 앱을 단독 실행해 Xcode·시뮬레이터 설치 확인
- 조직 정책으로 도구 비활성 여부 확인
- Desktop v1.24012.0+ 및 Claude → Check for Updates 후 재시작
no simulators were found
Xcode는 있으나 iOS 시뮬레이터가 없음. 패널 설정 단계 체크리스트를 따르거나 Xcode 설정에서 iOS simulator runtime 설치, 또는 xcodebuild -downloadPlatform iOS.
체크리스트
- macOS Desktop v1.24012.0+, Pro/Max/Team이다
- Xcode + iOS 플랫폼 시뮬레이터가 있다
- 로컬 세션이다 (cloud/SSH 아님)
- 디바이스 최초 허용을 했고 실계정 로그인을 피했다
- Claude 운전 중 배지 동안 입력을 겹치지 않는다
다음 단계
기준일
- 문서 작성·동기화 기준일: 2026-07-26
- 원문: https://code.claude.com/docs/en/desktop-ios-simulator