AI에게 설치 맡기기

Claude Code, Codex, Cursor 에이전트, Gemini CLI처럼 PC에서 명령을 실행할 수 있는 AI 코딩 에이전트를 쓴다면, 설치 중 PC 쪽을 맡길 수 있습니다. 폰 쪽은 직접 해야 합니다. Android는 앱 설치와 이런 권한 허용을 사람만 할 수 있게 합니다.

누가 무엇을 하나

PC에서 (에이전트)	폰에서 (나)
내 운영체제용 droidline을 내려받아 PATH에 넣기	릴리스 페이지에서 droidline-agent.apk 설치
droidline serve를 실행해 두기	앱의 설정 탭에서 권한 켜기
droidline pair를 실행해 QR 코드 보여 주기	QR 코드 찍기, 또는 이 Wi-Fi에서 페어링을 눌러 6자리 코드 알려 주기
droidline doctor, droidline devices로 결과 확인	연결됐다고 나올 때까지 앱 열어 두기
내가 쓰는 언어의 SDK 설치

1. 폰 준비

설치 가이드의 3, 4단계를 하세요. 앱을 설치하고 필수 권한을 모두 켜는 단계입니다. Android 13 이상은 가이드 설명대로 "제한된 설정 허용"부터 하세요.

2. PC 쪽은 에이전트에게

아무 폴더에서 에이전트를 열고 아래 요청을 붙여 넣으세요. 마지막 줄의 언어는 쓰시는 언어로 바꾸세요.

이 PC에 Droidline을 설치해서 내 안드로이드 폰을 코드로 조작할 수 있게 해 줘.

공식 가이드 https://droidline.dev/ko/docs/install/ 를 따라 줘. AI용 요약은 https://droidline.dev/llms.txt 에 있어. 가이드에 없는 명령은 지어내지 마.

1. https://github.com/KnifeLemon/Droidline/releases/latest 에서 이 운영체제와 CPU에 맞는 최신 droidline을 내려받아 원하는 폴더에 풀고, droidline을 PATH에 넣어 줘.
2. "droidline serve"를 다른 터미널이나 백그라운드에서 실행하고 계속 켜 둬.
3. "droidline pair"를 실행해서 QR 코드를 보여 줘. 내가 Droidline 앱으로 찍을게. 6자리 코드를 알려 주면 "droidline pair <코드>"를 실행해 줘.
4. 페어링했다고 말하면 "droidline devices"와 "droidline doctor"를 실행하고 결과를 알려 줘.
5. Python용 Droidline SDK를 설치해 줘.

방화벽이나 네트워크 설정을 바꿔야 하면 먼저 나한테 물어봐.

에이전트는 3단계에서 멈추고 기다립니다. 앱의 페어링 탭으로 QR 코드를 찍거나, 이 Wi-Fi에서 페어링을 눌러 폰에 뜬 코드를 에이전트에게 알려 주세요.

3. 결과 확인

droidline devices에 폰이 온라인으로 나오면 설치가 끝난 것입니다. 첫 명령으로 설정 앱을 열어 보라고 해 보세요.

"droidline launch com.android.settings"를 실행하고 어떻게 됐는지 알려 줘.

무언가 안 되면 에이전트에게 droidline doctor를 실행하고 문제 해결을 따라 달라고 하세요. Windows 방화벽 확인 창이나 네트워크 프로필 변경은 사람이 직접 확인해야 합니다.

터미널이 없는 채팅 앱

Claude Desktop, ChatGPT 같은 채팅 앱은 MCP로만 Droidline에 붙습니다. 그리고 MCP 도구에는 페어링이 일부러 빠져 있어서, 에이전트가 새 폰을 연결하거나 폰의 권한을 바꿀 수 없습니다. 이런 앱을 쓴다면 설치 가이드와 빠른 시작으로 처음 한 번은 직접 설치하고 페어링한 다음, Droidline을 MCP 서버로 추가하세요. 그다음부터는 에이전트가 페어링된 폰을 쓸 수 있습니다.

시작하기 전에

터미널을 쓰는 에이전트는 내 PC에서 명령을 실행하고, 페어링한 뒤에는 실제 폰도 조작할 수 있습니다. 에이전트가 하려는 일을 읽고 나서 승인하고, 클라이언트의 승인 확인 기능을 켜 두세요. 시험해 보는 동안에는 테스트용 폰이나 은행 앱이 없는 폰을 쓰는 게 좋습니다.