AI 칼럼

코딩@donghyeok99운영진

PhoneBox: 안 쓰는 안드로이드 폰을 AI 코딩 책상 패널로

서랍 속 안드로이드 폰을 꽂으면 Claude Code 권한 요청에 허용·거부를 누르는 책상 패널이 돼요

노트북의 Claude Code가 npm test 권한을 묻자 USB로 이어진 폰에 카드가 뜨고, 허용을 누르면 터미널이 이어서 실행돼요.
노트북의 Claude Code가 npm test 권한을 묻자 USB로 이어진 폰에 카드가 뜨고, 허용을 누르면 터미널이 이어서 실행돼요.
누가
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로만 요청해요.

알림, Claude Code 권한 요청, 페이지 자동 전환을 보여 주는 둘러보기(데모 데이터)
알림, Claude Code 권한 요청, 페이지 자동 전환을 보여 주는 둘러보기(데모 데이터)
폰 세 대에 띄운 자동화·홈·플래너 페이지
폰 세 대에 띄운 자동화·홈·플래너 페이지
코딩 세션과 GitHub 활동을 모은 AI 세션 페이지
코딩 세션과 GitHub 활동을 모은 AI 세션 페이지
브라우저에서 위젯을 끌어 놓는 레이아웃 편집기
브라우저에서 위젯을 끌어 놓는 레이아웃 편집기

이걸로 만든 사람들

GitHub@anandyakshit2026-11-15

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
좋아요 0 · 댓글 15 (2026-11-18 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 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. 2

    Claude Code → PhoneBox agent

    ~/.claude/sessions/{pid}.json에이전트가 2초마다 Claude Code의 상태 파일과 ~/.codex/sessions의 기록을 읽기 전용으로 읽어 세션 목록을 만들어요.agent/PhoneBox.Agent/SessionMonitor.cs
  3. 3

    Claude Code → PhoneBox agent

    POST /api/hooks/claude/permission~/.claude/settings.json에 넣은 PermissionRequest 훅이 권한 요청을 에이전트로 보내요.agent/PhoneBox.Agent/ClaudeHook.cs
  4. 4

    PhoneBox agent → PhoneBox Android app

    GET /api/state, /api/approvals폰의 패널이 상태와 기다리는 권한 요청을 받아 프로젝트, 도구, 명령이나 파일을 카드로 보여 줘요.agent/PhoneBox.Agent/Program.cs
  5. 5

    나 → PhoneBox Android app

    Allow 또는 Deny를 탭폰 앱은 WebView로 패널을 그리고, 패널만 에이전트에 닿을 수 있게 요청을 걸러요.android/app/src/main/java/net/oxog/phonebox/deskpanel/MainActivity.kt
  6. 6

    PhoneBox Android app → PhoneBox agent

    POST /api/approvals/{id}누른 답이 에이전트의 대기 중인 요청에 전해져요.agent/PhoneBox.Agent/Program.cs
  7. 7

    PhoneBox agent → Allow / Deny

    hookSpecificOutput: allow / deny훅의 출력으로 답이 돌아가요. 답이 없으면 출력도 없어서 Claude Code가 터미널에서 평소처럼 물어요.agent/PhoneBox.Agent/ClaudeHook.cs

넣으면 이렇게 나와요

Claude Code가 명령 실행 권한을 물어요폰에 프로젝트, 도구, 명령과 Allow / Deny가 떠요
정해 둔 시간 안에 폰에서 답하지 않아요훅이 결정을 내지 않아 터미널에서 평소처럼 물어요
curl -X POST http://127.0.0.1:8765/api/goto/music폰이 music 페이지로 넘어가요

나한테 맞을까요

이럴 때 좋아요

  • Claude Code나 Codex를 돌려 두고 다른 창에서 일하는 사람
  • 한도와 리셋 시각을 터미널을 열지 않고 보고 싶을 때
  • 안 쓰는 안드로이드 폰을 단축키·음량·OBS 조작판으로 쓰고 싶을 때
  • 계정이나 클라우드 없이 내 PC와 폰끼리만 잇고 싶을 때

이건 안 돼요

  • iOS 버전은 없고, 폰 앱은 앱 스토어가 아니라 이 저장소의 릴리스에서만 받아요.
  • Windows 에이전트는 아직 서명이 없어 SmartScreen이나 백신이 경고하거나 막을 수 있어요(README 기준).
  • Claude 한도는 문서화되지 않은 엔드포인트로 읽어서 바뀔 수 있다고 가이드에 적혀 있어요.
  • Windows ARM과 musl Linux(Alpine 등)는 릴리스 빌드가 없어요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기