phone-harness의 개요
phone-harness는 코딩 에이전트가 사람처럼 휴대폰을 쓰게 합니다. 에이전트가 open_app, tap_text, type_text, screen 같은 미리 불러온 보조 함수로 짧은 Python 스크립트를 쓰면 CLI가 실행합니다. iPhone은 Mac의 iPhone 미러링 창을 통해 조작하며, Apple의 Vision OCR로 화면을 읽고 합성 입력 이벤트로 제어합니다. Android는 adb로 조작하고 텍스트는 접근성 트리에서 가져옵니다. 휴대폰에는 아무것도 설치하지 않으며 탈옥도 필요 없습니다.
같은 보조 함수로 이 회사의 유료 서비스인 Phone Harness Cloud의 휴대폰도 조작합니다. adb로 연결하는 Android 에뮬레이터와 HTTPS로 연결하는 전용 실제 iPhone이며, 브라우저에서 실시간 화면을 볼 수 있습니다. 호스팅 MCP 서버는 클라우드 휴대폰만 지원하며, Hermes Agent와 OpenClaw용 플러그인도 있습니다. 에이전트는 직접 만든 보조 함수를 업데이트 후에도 남는 작업 폴더에 저장할 수 있습니다.
CLI는 MIT 라이선스이며, 회사는 Y Combinator의 투자를 받았다고 밝힙니다. 저장소는 2026년 8월에 만들어졌고 버전 0.3.3은 2026년 11월 2일에 나왔습니다.
phone-harness, 쓸 만한 가치가 있습니까?
phone-harness는 좁은 문제를 잘 풉니다. 에이전트용 휴대폰 도구 대부분은 Xcode, 테스트 빌드, 기기 내 앱이 필요하지만, 이 도구는 macOS의 iPhone 미러링으로 주머니 속 iPhone을 그대로 조작합니다. 이 지름길의 대가는 OCR로 화면을 읽는다는 점입니다. 아이콘이 아닌 텍스트만 보므로 이름표 없는 버튼에는 스크린샷과 이미지를 이해하는 모델이 필 요하고, 멀티터치, 카메라, Face ID는 지원하지 않습니다. Android는 adb 입력과 접근성 트리가 있어 기반이 더 탄탄합니다.
필요한 접근 권한은 분명히 알아 두십시오. Mac에서는 이 도구를 실행하는 터미널이나 에이전트 앱에 손쉬운 사용과 화면 기록 권한이 있어야 하며, 그러면 그 앱은 휴대폰뿐 아니라 화면 전체를 읽고 어느 창에든 키 입력을 보낼 수 있습니다. Android에서는 USB 디버깅이나 무선 디버깅으로 컴퓨터가 기기를 완전히 제어합니다. 그다음 에이전트는 스스로 쓴 Python을 실행하며, 구매나 메시지 전송 전에 승인 단계가 없습니다. README 데모에서는 에이전트가 Waymo 차량을 호출합니다. 반면 pinky는 위험한 탭을 사용자가 승인할 때까지 보류합니다.
조치가 필요한 부분은 텔레메트리입니다. DO_NOT_TRACK=1이나 phone-harness config set telemetry false를 설정하지 않으면 CLI 호출마다 스크립트(최대 20,000자)와 출력의 마지막 20,000자를 담은 이벤트가 PostHog로 전송되는데, 이 출력은 휴대폰 화면에서 읽은 텍스트인 경우가 많습니다. 클라우드에 로그인하면 이 이벤트는 계정과 연결됩니다. 설치 안내서는 한 단락에서 이 스위치를 언급하지만 README에는 없습니다.
코드는 작아서 기여자 다섯 명이 쓴 약 8,600줄의 Python인데 별은 5,328개이며, 저장소는 README 곳곳에서 홍보하는 유료 클라우드의 입구 역할도 합니다. 클라우드 요금은 분명합니다. Android 에뮬레이터는 분당 5¢ 또는 월 $20에 1,000분, 실제 iPhone은 월 $80부터 정액이며 $20 보증금으로 예약합니다. 앱 테스트에는 agent-device가 더 완전한 도구이고, phone-harness는 내 휴대폰을 조작하기 위한 도구입니다.
제 역할을 하는 곳
iOS 18 iPhone을 쓰는 Mac 사용 개발자
Claude Code가 매일 아침 휴대폰의 앱 상태 화면을 확인하게 하고 싶음
uv로 설치하고 스킬을 등록한 뒤 iPhone 미러링을 페어링하고 터미널에 손쉬운 사용과 화면 기록 권한을 주고, 텔레메트리를 끈 다음 에이전트가 open_app과 screen을 쓰는 짧은 스크립트를 실행하게 합니다. 본인 기기라면 무료입니다.
기기 테스트 환경이 없는 5인 스타트업의 QA 엔지니어
깨끗한 휴대폰에서 Android 앱 가입 절차를 에이전트가 따라가게 하고 싶음
phone-harness cloud start로 새 Android 에뮬레이터를 기본 15분 동안 씁니다. 에이전트가 adb로 조작하고 사용자는 실시간 화면을 봅니다. 분당 5¢이므로 15분 실행은 시작 크레딧 $5에서 75¢가 나갑니다.
전용 전화번호가 있는 실제 iPhone이 필요한 그로스 팀
SMS 코드가 필요한 앱 절차를 에이전트가 마치게 하고 싶음
cloud reserve 명령과 환불 가능한 $20 보증금으로 eSIM이 있는 클라우드 iPhone을 예약합니다. 이후에는 정가 기준 월 $100 정액이 청구되며, 어떤 OS에서든 HTTPS로 조작합니다.
도입 전 확인할 점
- 설정
- Python 3.12로 uv tool install phone-harness를 실행한 뒤 phone-harness skill의 출력을 에이전트에 등록합니다. iPhone에는 macOS 15 이상, iOS 18 이상과 페어링한 iPhone 미러링, macOS 권한 두 가지가 필요합니다. Android에는 adb와 USB 또는 무선 디버깅이 필요합니다. phone-harness doctor가 빠진 첫 단계를 알려 줍니다.
- 연동
- Claude Code, Codex 등을 위한 에이전트 스킬, 클라우드 휴대폰 전용 호스팅 MCP 서버(mcp.phone-harness.com), Hermes Agent와 OpenClaw 플러그인, 클라우드 휴대폰용 HTTP API가 있습니다.
- 데이터와 개인정보
- 로컬 조작은 내 컴퓨터에서 끝나지만, 기본으로 켜진 PostHog 텔레메트리가 각 스크립트와 최대 20,000자의 출력을 보내며 로그인 후에는 클라우드 계정과 연결합니다. DO_NOT_TRACK=1로 끌 수 있습니다. Hermes에서는 기본적으로 꺼져 있습니다. 저장한 클라우드 Android는 앱과 로그인 상태를 사업자 쪽에 유지합니다.
- 대규모 사용 시 비용
- 로컬 사용은 무료입니다. Cloud Android Basic은 휴대폰 1분당 5¢, Plus는 월 $20에 1,000분이며 이후 4¢입니다. 실제 iPhone은 정가 월 $80(eSIM 포함 $100), 연간 결제 시 월 $64이며, 대규모는 별도 견적입니다.
- 해지와 환불
- 클라우드 예약은 CLI에서 취소할 수 있고, 휴대폰이 인도되기 전까지 보증금은 결제한 카드로 돌아갑니다. 인도 후에는 보증금이 첫 청구서에서 차감되어 환불되지 않습니다. 구독 환불 조건은 별도 페이지에 있으며 저희는 확인하지 않았습니다.
- 제한
- iPhone 잠금을 풀면 미러링이 멈춥니다. PIN으로 잠긴 Android는 사용자가 직접 풀어야 합니다. DRM 동영상은 검게 나 옵니다. 계정당 시간당 미결제 예약은 5건까지입니다. MCP 서버는 로컬 휴대폰에 닿지 않습니다.
좋은 점
- Xcode, 탈옥, 기기 내 앱 없이 개인 iPhone 조작
- iPhone, Android, 클라우드 휴대폰에 같은 보조 함수
- 에이전트가 자체 함수 라이브러리를 업데이트 후에도 유지
- 분 단위와 정액으로 명확한 클라우드 요금
아쉬운 점
- 기본으로 켜진 텔레메트리가 스크립트와 화면 텍스트를 PostHog로 전송
- Mac 권한으로 에이전트 앱이 화면 전체를 제어
- OCR은 텍스트만 인식, 아이콘, 멀티터치, Face ID 불가
- 구매나 메시지 전에 승인 단계 없음
추천 대상
자신의 iPhone이나 Android, 또는 빌린 클라우드 휴대폰에서 에이전트에게 심부름이나 점검을 맡기고 싶고, 먼저 텔레메트리를 끌 개발자에게 맞습니다.
phone-harness 대안
phone-harness: 자주 묻는 질문
- phone-harness, 쓸 만한 가치가 있습니까?
- phone-harness는 저희가 다룬 어떤 도구보다 수월하게 에이전트를 내 iPhone에 연결하지만, 기본적으로 스크립트와 화면 텍스트를 분석 서비스로 보내므로 개인 휴대폰에 쓰기 전에 텔레메트리를 꺼야 합니다. 평점은 5점 만점에 3.4점입니다.
- phone-harness의 가격은 얼마입니까?
- CLI는 MIT로 무료입니다. 클라우드는 Android가 휴대폰 1분당 5¢이고 시작 크레딧 $5 제공, 또는 Plus가 월 $20에 1,000분입니다. 실제 iPhone은 월 $80부터입니다(작성 시점 기준 첫 휴대폰은 $50).
- phone-harness의 단점은 무엇입니까?
- 기본으로 켜진 텔레메트리가 스크립트와 화면 텍스트를 PostHog로 전송; Mac 권한으로 에이전트 앱이 화면 전체를 제어; OCR은 텍스트만 인식, 아이콘, 멀티터치, Face ID 불가; 구매나 메시지 전에 승인 단계 없음.
- phone-harness에 적합한 사람은 누구입니까?
- 자신의 iPhone이나 Android, 또는 빌린 클라우드 휴대폰에서 에이전트에게 심부름이나 점검을 맡기고 싶고, 먼저 텔레메트리를 끌 개발자에게 맞습니다.
- 팀이나 프로덕션 환경에서 phone-harness의 비용은 얼마입니까?
- 로컬 사용은 무료입니다. Cloud Android Basic은 휴대폰 1분당 5¢, Plus는 월 $20에 1,000분이며 이후 4¢입니다. 실제 iPhone은 정가 월 $80(eSIM 포함 $100), 연간 결제 시 월 $64이며, 대규모는 별도 견적입니다.
- phone-harness에 회사 데이터를 맡겨도 안전합니까?
- 로컬 조작은 내 컴퓨터에서 끝나지만, 기본으로 켜진 PostHog 텔레메트리가 각 스크립트와 최대 20,000자의 출력을 보내며 로그인 후에는 클라우드 계정과 연결합니다. DO_NOT_TRACK=1로 끌 수 있습니다. Hermes에서는 기본적으로 꺼져 있습니다. 저장한 클라우드 Android는 앱과 로그인 상태를 사업자 쪽에 유지합니다.
- phone-harness은 어떻게 해지하며 환불받을 수 있습니까?
- 클라우드 예약은 CLI에서 취소할 수 있고, 휴대폰이 인도되기 전까지 보증금은 결제한 카드로 돌아갑니다. 인도 후에는 보증금이 첫 청구서에서 차감되어 환불되지 않습니다. 구독 환불 조건은 별도 페이지에 있으며 저희는 확인하지 않았습니다.
- phone-harness의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 agent-device, Pinky 및 Droidline입니다.
답변 확인일: 2026년 11월 20일.