Google이 공개한 오픈소스 프로젝트(
google/artemis, Apache-2.0).
왜 필요한가?
Claude Code로 Android 앱 코드를 고쳐도, 실제 기기에서 화면이 어떻게 바뀌고 팝업이 뜨는지는 사람이 직접 눌러 보며 확인해야 했습니다. 이 과정을 스크립트로 자동화하려면 화면 요소를 찾는 코드를 따로 짜야 하고, 화면이 바뀌면 그 코드도 함께 깨집니다.
ARTEMIS는 “설정에서 배터리 화면을 열고 현재 잔량을 알려 줘”처럼 자연어로 지시하면, 자체 에이전트가 화면을 보며 기기를 조작하고 결과를 구조화해 돌려줍니다. MCP 서버를 제공하므로 Claude Code가 이 에이전트에게 테스트를 맡기고, 스크린샷과 Logcat(Android 시스템 로그) 출력을 받아 다음 작업에 활용할 수 있습니다.
무엇을 할 수 있나
README에 실린 예시는 다음과 같습니다.
- 여러 앱에 걸친 작업 — 데모 영상에서는 Google Maps에서 운전 경로를 설정해 총 소요 시간을 계산한 뒤, YouTube를 열어 Coldplay 노래를 재생합니다.
- IDE에서 테스트 맡기기 — README의 Claude Code, Codex, Antigravity용 예시 프롬프트는 “최신 변경을 APK로 빌드해 연결된 기기에 설치하고, 테스트 계정으로 로그인 화면을 연 뒤, 로그인 후 예상치 못한 팝업이 있는지 확인하고 마지막 화면의 스크린샷을 돌려 줘”입니다.
- 테스트 계획부터 보고서까지 — README의 Antigravity 워크플로 예시에서는 테스트 요청을 받아 단계별 계획을 세우고, 실기기에서 실행하며 성능을 측정한 뒤, 결과 표와 원본 데이터가 담긴 보고서를 냅니다.
- 기존 테스트 코드에 연동 — Python SDK로 pytest나 CI/CD 파이프라인에서 자연어 테스트를 실행하고, 결과의 성공 여부를
assert로 검사합니다.

이미지 출처: google/artemis (Apache-2.0)
핵심 기능
-
MCP 도구 5개
Claude Code는 아래 도구로 ARTEMIS를 다룹니다.
mobile_run_task는 작업을 백그라운드 프로세스로 띄우므로, Claude Code는 작업이 끝날 때까지 기다리지 않고 상태를 조회해 결과를 확인합니다.도구 하는 일 mobile_run_task자연어 작업을 Flash 또는 Pro 프로필로 실행 mobile_manage_task작업 상태 확인, 중지, 실행 중인 작업에 지시 추가 mobile_get_device_state현재 화면의 스크린샷 또는 OCR과 XML 기반 화면 구조 조회 mobile_inspect_trace작업 기록의 동작 위치 표시, 에이전트 판단 과정 확인 mobile_diagnosePython, LLM 키, ADB, 기기 연결 상태를 점검하고 해결 순서 제시 -
Flash와 Pro 두 가지 실행 방식
Flash는 모델 하나가 화면을 보고 생각하고 바로 동작하는 방식이라 빠르고 토큰을 적게 씁니다. 대신 계획, 사전 점검, 체크포인트 검증, 최종 보고서가 없습니다. Pro는 Planner가 작업 계획을 세우고, Operator가 각 동작 전에 화면 구조와 픽셀로 대상을 확인하며 실행하고, Checker가 원래 목표 기준으로 결과를 검증합니다.
-
화면 요소를 찾는 방식
접근성 정보(화면의 버튼, 텍스트 같은 UI 요소 구조)가 있으면 그 요소 번호로 조작하고, Canvas, Compose, Flutter처럼 접근성 정보가 부족한 화면에서는 OCR과 시각 모델로 위치를 찾습니다.
-
AI 코딩 도구용 테스트 규칙
mcp_server/rules.md는 AI 코딩 도구가 ARTEMIS를 다룰 때 따를 규칙입니다. 테스트 코드를 쓰기 전에 실제 앱을 먼저 탐색해 동작 경로를 확인하고, 작업 성격에 따라 Flash와 Pro를 고르고, 동적 요소 탐색을 우선하되 좌표를 대비책으로 두며, 도구가 실패하면mobile_diagnose부터 호출하도록 안내합니다. -
여러 기기 병렬 실행
기기별로 잠금을 걸어, 서로 다른 기기와 에뮬레이터에서 작업을 동시에 돌릴 수 있습니다.
device_serial을 지정하지 않으면 사용 가능한 기기를 자동으로 고릅니다.
Claude Code에서 쓰기
저장소 디렉터리에서 아래 명령을 실행합니다. ./start.sh를 처음 실행할 때 나오는 안내에서 설치해도 됩니다.
uv run artemis mcp --install claude
이 명령은 다음 파일을 수정합니다.
~/.claude.json— Claude Code의 사용자 범위 MCP 서버 목록에artemis추가claude_desktop_config.json— Claude Desktop에도 같은 서버 추가~/.claude/rules/artemis.md— 테스트 규칙 파일 설치 (Claude Code는~/.claude/CLAUDE.md와~/.claude/rules/*.md를 모두 읽으므로 규칙을 한 곳에만 둡니다)
--install all은 지원하는 모든 IDE 설정을 함께 수정하므로, Claude Code만 쓴다면 claude를 지정하는 편이 변경 범위가 작습니다.
작업이 끝나면 데스크톱 알림이 뜨고 notifications.jsonl에 기록됩니다. Antigravity와 달리 Claude Code 대화를 자동으로 깨우지는 않으므로, Claude Code는 mobile_manage_task로 상태를 조회해 결과를 가져옵니다.
사용 방법
USB 디버깅을 켠 Android 기기나 에뮬레이터를 연결한 뒤 실행합니다.
# 1. 저장소 받기
git clone https://github.com/google/artemis.git && cd artemis
# 2. 실행 (ADB, scrcpy, FFmpeg, uv 의존성 감지와 설치, MCP 설정 안내)
./start.sh
# 3. CLI에서 바로 작업 실행
uv run artemis run "Open Settings, find Battery and tell me current level" --profile flash
./start.sh를 실행하면 브라우저에서 http://localhost:8000 웹 콘솔이 열립니다. 기기 연결 안내, 화면 미러링, 프롬프트 입력, 실행 기록 재생을 이 콘솔에서 할 수 있습니다. 웹 콘솔 서버는 uv run artemis status, uv run artemis restart, uv run artemis stop으로 관리합니다.
알아두면 좋은 점
- LLM API 키가 필요합니다 —
.env에 Gemini, OpenAI, Anthropic, OpenRouter, xAI 중 하나 이상의 키를 넣어야 합니다. 기기 조작은 ARTEMIS가 이 키로 호출하는 모델이 수행하며, Claude Code 구독과 별개로 사용량이 청구됩니다. - Android 전용 — iOS 기기와 시뮬레이터 지원은 로드맵에 있는 계획입니다. iOS도 함께 다뤄야 한다면 iOS와 Android를 같은 도구로 조작하는 Mobile MCP를 참고하세요.
- 사전 요구 사항 — Python 3.12 이상과 ADB, scrcpy, FFmpeg, uv가 필요합니다.
./start.sh가 이 도구들을 감지해 설치합니다. - 개인 휴대폰에서 쓸 때 — 첫 작업 때 Artemis Accessibility Helper가 설치되고, 설정의 접근성 항목과 “Artemis test helper is running” 알림이 생깁니다. README에 따르면 이 서비스는 기기 안에서만 동작하며 외부로 데이터를 보내지 않습니다. 자동 설치를 막으려면
.env에ARTEMIS_HELPER_AUTO_INSTALL=false를, 화면이 꺼지지 않게 하는 기본 동작을 끄려면ARTEMIS_KEEP_DEVICE_AWAKE=false를 설정합니다. - 벤치마크 수치 — README에 따르면 Google Research의 AndroidWorld 벤치마크(20개 이상 앱, 100개 이상 다단계 작업)에서 99% 이상의 완료율을 기록했습니다. 프로젝트가 직접 밝힌 수치입니다.
- 문서 — MCP 도구와 알림 방식은 MCP Server README에 정리되어 있습니다.