claudekit / tools / artemis
[ MCP · Development ]

ARTEMIS

자연어 지시를 Android 자동화로 바꾸는 오픈소스 에이전트. MCP 서버로 Claude Code에 연결하면 실기기나 에뮬레이터에서 앱을 조작해 테스트를 진행하고, 스크린샷과 Logcat 로그를 받아 옵니다. 기기 조작은 ARTEMIS가 자체 LLM으로 백그라운드에서 수행합니다.

google/artemis ·updated
$ git clone https://github.com/google/artemis.git && cd artemis && ./start.sh copy

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로 검사합니다.

ARTEMIS 웹 콘솔. 화면 미러링, 에이전트 실행 로그, 프롬프트 입력창, 작업 대기열이 한 화면에 표시된다

이미지 출처: 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에 정리되어 있습니다.
§ 7

See also

same category · curated
[01]
[Tool] Claude Quickstarts · Claude API로 배포 가능한 애플리케이션을 빠르게 만들기 위한 프로젝트 모음. 고객 지원 에이전트, 금융 데이터 분석, computer use, 브라우저 자동화, Claude Managed Agents 기반 Slack, Linear, Sentry 연동 앱까지 바로 실행할 수 있는 예제를 제공합니다. 일부 퀵스타트는 Claude Code가 설정 과정을 안내합니다.
tool · claudekit.io / tools / claude-quickstarts
[02]
[Tool] Worktrunk · AI 에이전트를 병렬로 돌리기 위한 git worktree 관리 CLI. 브랜치 이름만으로 worktree를 만들고, 전환하고, 정리하며, `wt switch -c -x claude feat` 한 줄로 새 worktree에서 Claude Code를 바로 실행합니다. Claude Code 플러그인을 설치하면 `wt list`에 세션 상태가 표시되고, 에이전트가 만드는 worktree도 Worktrunk 규칙을 따릅니다.
tool · claudekit.io / tools / worktrunk
[03]
[Plugin] Superpowers · 브레인스토밍, TDD, 체계적 디버깅, 계획 수립/실행, 코드 리뷰 등 전문 개발 워크플로우를 스킬 기반으로 자동화.
tool · claudekit.io / tools / superpowers
§ 8

자주 묻는 질문

자주 묻는 질문
§ 8.1
ARTEMIS는 무엇인가요?
자연어 지시를 받아 Android 기기에서 앱을 조작하고 결과를 보고하는 자동화 에이전트입니다. 웹 콘솔, CLI, Python SDK, MCP 서버로 쓸 수 있으며, MCP 서버를 통해 Claude Code 같은 AI 코딩 도구가 실기기로 테스트를 진행할 수 있습니다.
§ 8.2
Claude Code에 어떻게 연결하나요?
저장소를 받아 `./start.sh`를 실행한 뒤, 저장소 디렉터리에서 `uv run artemis mcp --install claude`를 실행합니다. 이 명령은 `~/.claude.json`과 Claude Desktop 설정에 MCP 서버를 추가하고, 테스트 규칙 파일을 `~/.claude/rules/artemis.md`에 설치합니다.
§ 8.3
무료로 사용할 수 있나요?
Apache-2.0 라이선스 오픈소스입니다. 다만 기기 조작은 ARTEMIS가 자체적으로 호출하는 LLM이 수행하므로, `.env`에 Gemini, OpenAI, Anthropic, OpenRouter, xAI 중 하나 이상의 API 키를 넣어야 하고 그 사용량은 해당 제공사에 따로 청구됩니다.
§ 8.4
iPhone도 지원하나요?
현재는 Android 기기와 에뮬레이터만 지원합니다. iOS 기기와 시뮬레이터 지원은 README 로드맵에 계획으로 올라 있습니다.
§ 8.5
Flash와 Pro 프로필은 어떻게 다른가요?
Flash는 모델 하나가 화면을 보고 바로 동작하는 빠른 방식으로, README 기준 단계당 3-5초가 걸립니다. Pro는 Planner, Operator, Checker로 나뉜 계획과 검증 방식으로 단계당 15-40초가 걸리며, 100단계가 넘는 긴 작업과 체크포인트 검증, 보고서 작성을 지원합니다.
§ 8.6
휴대폰에 무엇이 설치되나요?
첫 작업 때 화면 구조를 읽는 Artemis Accessibility Helper라는 접근성 서비스가 설치됩니다. `.env`에서 `ARTEMIS_HELPER_AUTO_INSTALL=false`로 자동 설치를 끌 수 있고, `uv run artemis helper uninstall`로 언제든 제거할 수 있습니다.