PhoneBox: 안 쓰는 안드로이드 폰을 AI 코딩 책상 패널로
서랍 속 안드로이드 폰을 꽂으면 Claude Code 권한 요청에 허용·거부를 누르는 책상 패널이 돼요
- 누가
- ersinkoc이 만든 MIT 오픈소스예요. 책상에서 코딩 에이전트를 돌리며 남는 안드로이드 폰이 있는 사람이 대상이에요.
- 언제
- 2026년 11월 7일 v0.5.0으로 처음 나왔고, 최신 릴리스는 11월 18일의 v0.9.20이에요.
- 어디서
- Windows·Linux·macOS의 데스크톱 에이전트와 Android 5 이상 폰. USB나 페어링한 Wi-Fi로 잇고 클라우드는 거치지 않아요.
이게 불편했어요
에이전트에게 일을 맡기고 다른 창에서 작업하다 보면, 터미널이 권한을 묻고 멈춰 있는 걸 한참 뒤에야 알게 돼요. 한도가 얼마나 남았는지, 지금 어느 세션이 돌고 있는지 보려고 창을 다시 찾아 들어가야 했어요. 그러는 동안 서랍에는 안 쓰는 안드로이드 폰이 놓여 있고요.
그래서 이렇게 풀어요
PhoneBox는 그 폰을 PC 옆에 세워 두는 패널로 바꿔요. 폰에는 전체 화면 앱을, PC에는 작은 에이전트 프로그램을 깔면 USB나 페어링한 Wi-Fi로 이어져요. 패널은 브라우저 편집기에서 위젯 123개와 템플릿 30개로 꾸미고, Claude Code 권한 요청은 켜 두면 폰에서 Allow나 Deny로 답할 수 있어요. 명령과 연동 자격 증명은 PC에 남고, 폰은 정해 둔 동작을 ID로만 요청해요.




이걸로 만든 사람들
Android 7.1.1인 OPPO A71로 시험 빌드를 돌려 보고 터치와 패널 표시가 된다고 스크린샷과 함께 알렸어요. 이 시험을 거쳐 0.9.11부터 Android 7.0 이상에 설치돼요.
I love your idea bro and i want to use it myself but majority of the old phones in normal homes run either Android 8 or below
안에서는 이렇게 돌아가요
- 1
PhoneBox agent → PhoneBox Android app
adb reverse tcp:8765 tcp:8765폰을 USB로 꽂으면 폰의 127.0.0.1:8765가 PC 에이전트에 닿게 규칙을 걸고, 폰을 깨워 패널을 열어요.agent/PhoneBox.Agent/AdbReverse.cs - 2
Claude Code → PhoneBox agent
~/.claude/sessions/{pid}.json에이전트가 2초마다 Claude Code의 상태 파일과 ~/.codex/sessions의 기록을 읽기 전용으로 읽어 세션 목록을 만들어요.agent/PhoneBox.Agent/SessionMonitor.cs - 3
Claude Code → PhoneBox agent
POST /api/hooks/claude/permission~/.claude/settings.json에 넣은 PermissionRequest 훅이 권한 요청을 에이전트로 보내요.agent/PhoneBox.Agent/ClaudeHook.cs - 4
PhoneBox agent → PhoneBox Android app
GET /api/state, /api/approvals폰의 패널이 상태와 기다리는 권한 요청을 받아 프로젝트, 도구, 명령이나 파일을 카드로 보여 줘요.agent/PhoneBox.Agent/Program.cs - 5
나 → PhoneBox Android app
Allow 또는 Deny를 탭폰 앱은 WebView로 패널을 그리고, 패널만 에이전트에 닿을 수 있게 요청을 걸러요.android/app/src/main/java/net/oxog/phonebox/deskpanel/MainActivity.kt - 6
PhoneBox Android app → PhoneBox agent
POST /api/approvals/{id}누른 답이 에이전트의 대기 중인 요청에 전해져요.agent/PhoneBox.Agent/Program.cs - 7
PhoneBox agent → Allow / Deny
hookSpecificOutput: allow / deny훅의 출력으로 답이 돌아가요. 답이 없으면 출력도 없어서 Claude Code가 터미널에서 평소처럼 물어요.agent/PhoneBox.Agent/ClaudeHook.cs
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- Claude Code나 Codex를 돌려 두고 다른 창에서 일하는 사람
- 한도와 리셋 시각을 터미널을 열지 않고 보고 싶을 때
- 안 쓰는 안드로이드 폰을 단축키·음량·OBS 조작판으로 쓰고 싶을 때
- 계정이나 클라우드 없이 내 PC와 폰끼리만 잇고 싶을 때
이건 안 돼요
- iOS 버전은 없고, 폰 앱은 앱 스토어가 아니라 이 저장소의 릴리스에서만 받아요.
- Windows 에이전트는 아직 서명이 없어 SmartScreen이나 백신이 경고하거나 막을 수 있어요(README 기준).
- Claude 한도는 문서화되지 않은 엔드포인트로 읽어서 바뀔 수 있다고 가이드에 적혀 있어요.
- Windows ARM과 musl Linux(Alpine 등)는 릴리스 빌드가 없어요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요