iOS 시뮬레이터와 Android 에뮬레이터

AI 에이전트가 모바일 앱을
실제 시뮬레이터에서 테스트합니다

새 화면은 에이전트가 만들었지만, 정작 에이전트는 그 화면이 실행되는 모습을 본 적이 없습니다. AgentsRoom에서는 에이전트가 컴퓨터에서 iOS 시뮬레이터나 Android 에뮬레이터를 시작하고, 빌드를 설치하고, 화면을 탭하며 확인한 뒤, 다 됐다고 말하기 전에 스크린샷을 보내 줍니다.

AgentsRoom-Device MCP 서버는 Claude Code, Codex, Cursor를 비롯한 에이전트 CLI에 기기 도구 모음을 제공합니다. 기기 시작, .app이나 .apk 설치, 앱 실행, 딥 링크나 Expo dev client URL 열기, 탭, 스와이프, 입력, 홈이나 뒤로 누르기, 화면 읽기, 스크린샷 찍기, 로그 읽기까지 할 수 있습니다. AgentsRoom에서 기기를 실시간으로 지켜보고 언제든 제어를 가져올 수 있습니다.

AgentsRoom-Device

에이전트

iOS에서 가입 화면 확인

기기 도구

  • device_boot
  • device_install_app
  • device_tap
  • device_screenshot
iPhone 17
에이전트가 제어 중제어 가져오기

코딩 에이전트는 React Native 화면, SwiftUI 뷰, Kotlin 액티비티를 몇 분 만에 작성합니다. 하지만 제대로 동작하는지 확인하는 일은 여전히 당신 몫입니다. 빌드하고, 시뮬레이터를 열고, 흐름을 따라 탭하고, 키보드에 가려진 버튼을 발견하고, 스크린샷을 대화창에 다시 붙여 넣어야 합니다.

웹 앱이라면 에이전트가 이미 브라우저에서 자기 작업을 테스트합니다. 모바일 앱에는 매일 쓰는 도구 안에 그런 수단이 없었습니다. iOS 시뮬레이터 MCP나 Android 에뮬레이터 MCP를 CLI마다 하나씩 찾아서 설치하고 설정해야 했습니다.

AgentsRoom이 그 빈자리를 채웁니다. 기기 접근 권한을 준 에이전트는 어떤 CLI를 쓰든 기기 도구를 받습니다. 에이전트는 컴퓨터에 이미 있는 시뮬레이터와 에뮬레이터를 제어하고, 당신은 에이전트가 하는 모든 일을 실시간으로 봅니다.

에이전트가 기기에서 할 수 있는 일

모바일 화면을 확인하려고 손으로 하던 단계를, 그 화면을 만든 에이전트가 직접 합니다.

시작, 설치, 실행

에이전트는 컴퓨터의 시뮬레이터와 에뮬레이터 목록을 확인하고, 하나를 시작해 준비될 때까지 기다린 뒤, 시뮬레이터용 .app이나 .apk를 설치하고 번들 ID 또는 패키지 이름으로 앱을 실행합니다.

딥 링크와 Expo

딥 링크나 Expo dev client URL을 엽니다. Android에서는 Metro에 필요한 포트를 포워딩할 수 있어서, 에뮬레이터가 컴퓨터에서 실행 중인 번들러에 연결됩니다.

탭, 스와이프, 입력

화면의 요소를 읽고, 참조나 위치로 요소를 탭하고, 스와이프하고, 텍스트를 입력하고, 홈, 뒤로, Enter, 볼륨 키를 누릅니다. 화면을 바꾸는 동작이 끝날 때마다 스크린샷이 돌아옵니다.

AgentsRoom의 실시간 화면

테스트 > 기기에서 기기를 최대 초당 30프레임으로 실시간 표시합니다. 모든 시뮬레이터와 에뮬레이터를 찾는 검색, 시작과 중지, 홈, 뒤로, 그리고 스크린샷을 복사하는 버튼이 있습니다.

탭 한 번으로 제어를 넘겨받기

실시간 화면을 탭하거나, 드래그하거나, 입력하면 제어가 당신에게 넘어옵니다. 에이전트는 기다리고, 배너가 그 사실을 알려 줍니다. 제어 돌려주기를 누르면 기기가 에이전트에게 돌아가고, 2분 동안 아무 동작이 없으면 저절로 돌아갑니다.

기본은 꺼짐, 에이전트별로 설정

기기 접근 권한이 있는 에이전트만 도구를 받고, 권한은 동작할 때마다 다시 확인됩니다. 한 기기는 한 번에 한 에이전트만 제어합니다. 최근 작업은 목록으로 남지만, 입력한 텍스트는 절대 남지 않습니다.

작동 방식

당신은 체크 한 번이면 되고, 확인은 에이전트가 합니다.

  1. 1

    에이전트에게 기기 접근 권한 주기

    에이전트를 편집하고, 기능 섹션을 열어 “기기 접근 (iOS 시뮬레이터, Android 에뮬레이터)” 항목을 체크합니다. 새 에이전트의 기본값으로 만들 수도 있습니다. 모든 프로젝트에 적용하려면 설정에서, 한 프로젝트에만 적용하려면 그 프로젝트의 설정에서 하면 됩니다.

  2. 2

    기기에서 확인해 달라고 요청하기

    에이전트에게 시뮬레이터용으로 앱을 빌드하고(Expo라면 npx expo run:ios 또는 npx expo run:android) 화면을 확인해 달라고 요청합니다. 에이전트는 device_list를 호출하고, 실행 중인 기기가 없으면 하나를 시작한 뒤, 빌드를 설치하고 앱을 실행합니다.

  3. 3

    에이전트가 화면을 하나씩 살펴봅니다

    에이전트는 테스터처럼 화면을 읽고, 탭하고, 입력하고, 스와이프합니다. 무언가 실패하면 앱 로그를 읽고 코드를 고친 뒤 다시 시도하고, 결과 스크린샷을 보내 줍니다.

  4. 4

    지켜보거나 제어 넘겨받기

    오른쪽 패널에서 테스트 > 기기를 열면 기기의 실시간 화면과 어떤 에이전트가 제어 중인지 볼 수 있습니다. 화면을 탭하면 제어를 가져오고, 다 끝나면 제어 돌려주기를 누르세요.

컴퓨터에 필요한 것

iOS: Xcode가 설치된 Mac(Command Line Tools만으로는 부족합니다)과 iOS 시뮬레이터 런타임이 하나 이상 필요합니다. 기기 시작, 설치, 링크, 스크린샷, 로그는 어떤 Mac에서든 동작합니다. 화면 터치, 입력, 실시간 화면에는 Apple Silicon Mac과 serve-sim이 필요합니다. serve-sim은 npm install -g serve-sim으로 한 번만 설치하면 되는 오픈 소스 도구입니다.

Android: Android Studio의 Android SDK와 Android Emulator 패키지, 그리고 Device Manager에서 만든 가상 기기가 하나 이상 필요합니다. macOS, Windows, Linux에서 동작합니다. Windows에서는 하드웨어 가상화(Windows Hypervisor Platform)가, Linux에서는 /dev/kvm 접근 권한이 필요합니다.

빠진 것이 있으면 AgentsRoom이 기기 탭과 에이전트의 답변에서 무엇을 어떻게 설치해야 하는지 알려 줍니다. 당신 모르게 내려받는 것은 아무것도 없습니다.

제한 사항

  • 시뮬레이터와 에뮬레이터만 지원합니다. 실제 iPhone과 Android 휴대폰, watchOS, tvOS, visionOS는 지원하지 않습니다.
  • iOS 시뮬레이터는 Mac에만 있습니다. Windows와 Linux에서는 에이전트가 Android 에뮬레이터를 제어합니다.
  • Xcode 27에서는 시뮬레이터 창이 화면에 계속 보여야 하며, 화면을 터치하려면 AgentsRoom에 손쉬운 사용 권한이 필요합니다.
  • Android 에뮬레이터에서는 에이전트가 일반 ASCII 텍스트만 입력합니다. iOS 시뮬레이터에서는 모든 문자와 모든 키보드 배열을 쓸 수 있습니다.
  • Android 실시간 화면은 AgentsRoom에서 시작한 에뮬레이터에서 동작합니다. Android Studio에서 시작한 에뮬레이터도 에이전트의 모든 동작을 받지만, 테스트 > 기기에서 시작하기 전까지는 실시간 화면이 나오지 않습니다.
  • 에이전트 하나가 AgentsRoom으로 동시에 시작할 수 있는 기기는 최대 2대입니다. 에뮬레이터 하나가 메모리를 2~4GB 쓰기 때문입니다. 에이전트는 기기를 종료할 수 없습니다. AgentsRoom이 시작한 기기는 앱을 종료하면 함께 중지되고, 당신이 직접 시작한 기기는 절대 건드리지 않습니다.
  • 기기 접근을 끄면 에이전트의 다음 동작부터 적용됩니다. 이미 실행 중인 에이전트에 켜면, 그 에이전트를 다시 시작한 뒤에 적용됩니다.

자주 묻는 질문

다른 질문하기
Claude Code가 시뮬레이터에서 iOS 앱을 스스로 테스트할 수 있나요?
네. AgentsRoom에서 Claude Code 에이전트의 기기 접근을 체크하세요. 그러면 에이전트가 AgentsRoom-Device MCP 서버의 기기 도구를 받아 iOS 시뮬레이터를 시작하고, 시뮬레이터용으로 빌드한 .app을 설치해 실행하고, 화면을 탭하며 확인한 뒤 스크린샷을 보내 줍니다. 터치와 입력에는 Apple Silicon Mac과 serve-sim이 필요합니다.
Codex와 Cursor용 iOS 시뮬레이터 MCP나 Android 에뮬레이터 MCP도 있나요?
네, 같은 것입니다. AgentsRoom은 MCP 도구를 받는 모든 에이전트 CLI에 AgentsRoom-Device 서버를 제공합니다. Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Antigravity 등입니다. CLI마다 설정할 필요는 없습니다. 기기 접근을 체크하면 AgentsRoom이 그 CLI가 읽는 설정에 서버를 써 넣습니다. Aider에는 MCP 클라이언트가 없고, 2026년 11월에 추가된 Hermes Agent, Goose, Qwen Code, Kiro, Rovo Dev는 아직 AgentsRoom의 도구를 받지 않습니다.
Expo와 React Native에서도 되나요?
네. npx expo run:ios 또는 npx expo run:android로 빌드하거나 Expo dev client를 쓰면 됩니다. 에이전트가 빌드를 설치한 다음 device_open_url로 dev client URL을 엽니다. Android에서는 reversePorts 덕분에 에뮬레이터가 컴퓨터의 Metro(포트 8081)에 연결됩니다. 시뮬레이터용 .app이나 .apk로 설치되는 앱이라면 네이티브든 크로스 플랫폼이든 똑같이 동작합니다. 에이전트가 제어하는 것은 프레임워크가 아니라 기기이기 때문입니다.
에이전트가 시뮬레이터에서 하는 일을 지켜볼 수 있나요?
네. 오른쪽 패널에서 테스트 > 기기를 여세요. 기기가 실시간으로 표시되고, 제어 중인 에이전트의 이름과 최근 작업도 보입니다. 화면을 클릭하면 탭, 드래그하면 스와이프, 포커스를 받은 뒤에는 입력이 됩니다. 그 순간 제어가 당신에게 넘어오고 에이전트는 기다리며, 제어 돌려주기를 누르면 다시 에이전트에게 돌아갑니다. 2분 동안 아무 동작이 없으면 제어는 에이전트에게 돌아갑니다.
Windows나 Linux에서도 되나요?
Android 에뮬레이터는 됩니다. macOS와 마찬가지로 Windows와 Linux에서도 Android Studio의 Android SDK만 있으면 됩니다. iOS 시뮬레이터는 Mac에만 있으므로, Windows와 Linux에서는 에이전트의 기기 목록이 이를 숨기지 않고 알려 줍니다.
에이전트가 실제 iPhone이나 Android 휴대폰을 쓸 수 있나요?
아니요. AgentsRoom은 컴퓨터의 시뮬레이터와 에뮬레이터만 제어합니다. 실제 휴대폰, watchOS, tvOS, visionOS는 지원하지 않습니다.
두 에이전트가 같은 시뮬레이터를 쓰려고 하면 어떻게 되나요?
한 기기는 한 번에 한 에이전트만 제어합니다. 두 번째 에이전트는 최대 90초 기다린 뒤, 어떤 에이전트가 기기를 쓰고 있는지 안내받고 다른 기기를 고를 수 있습니다. 우선순위는 언제나 당신입니다. 당신이 제어를 가져오면 에이전트들은 당신을 기다립니다.
에이전트에게 기기 제어를 맡겨도 안전한가요?
접근 권한은 기본적으로 꺼져 있고, 에이전트별로 부여하며, 동작할 때마다 다시 확인됩니다. 그래서 체크를 해제하면 에이전트는 다음 호출에서 멈춥니다. 에이전트는 기기를 종료할 수 없습니다. 테스트 > 기기에는 기기별 최근 작업이 나오지만, 입력한 텍스트는 나오지 않습니다. 또한 AgentsRoom이 시작하는 serve-sim 보조 프로세스는 무작위 토큰으로 보호되므로, 네트워크의 다른 프로그램이 이를 통해 시뮬레이터를 제어할 수 없습니다.
QA 에이전트가 개발 에이전트를 대신해 모바일 앱을 테스트할 수 있나요?
네. 기기 접근 권한이 있는 개발 에이전트가 run_qa_test로 QA 에이전트에게 테스트를 넘기면, QA 에이전트가 그 권한을 이어받아 시뮬레이터나 에뮬레이터를 직접 제어합니다. 테스트용으로 더 저렴한 모델을 지정해 두었다면 그 모델로 실행됩니다. 개발 에이전트는 자기 대화 안에서 판정을 돌려받습니다.
휴대폰에서 에이전트의 스크린샷을 볼 수 있나요?
네. AgentsRoom 모바일 앱에서는 프로젝트 메뉴에서 기기 스크린샷을 열 수 있습니다. 프로젝트의 각 에이전트가 각 기기에서 마지막으로 찍은 스크린샷이 에이전트 이름, 시각과 함께 표시됩니다.

더 알아보기

함께 보면 좋은 기능

에이전트가 자기 화면을 직접 확인하게 하세요.

에이전트가 제어하는 시뮬레이터와 에뮬레이터는 macOS, Windows, Linux용 AgentsRoom에 들어 있습니다. iOS 시뮬레이터에는 Mac이 필요합니다.

AgentsRoom 다운로드무료

컴패니언 앱: 이동 중에도 에이전트를 모니터링

Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.

버그와 요청을 공개 백로그로 바로 보내세요.