개발 취재 노트

Claude Code를 안드로이드 태블릿에 붙이려는데, 음성비서 앱은 어디부터 만들까?

PC에서 쓰던 음성비서(호출어 hey_jarvis를 듣고, 문장을 claude -p로 넘겨 답을 받아 음성으로 읽어주는 Windows용 Python 프로그램)를 안드로이드 태블릿으로 옮기려는 설계 대화다. 이 글은 실제로 앱을 만들거나 태블릿에서 돌려 본 기록이 아니라, 무엇부터 만들지 정한 설계 결정 기록이다. 충전 거치한 태블릿이 상시 귀를 열어두는 것이 목표였고, Claude Code를 어디서 돌릴지와 앱이 무엇을 맡을지가 뒤섞여 있었다.

결론

앱은 귀·입(호출어·STT·TTS·화면)만 맡고, 답을 만드는 두뇌는 BrainClient 인터페이스 뒤로 뺀다. 첫 버전은 MockBrain(들은 말을 되돌려주는 대역)으로 앱부터 만든다. 두뇌가 태블릿의 Termux에 있든 PC 서버에 있든 앱 입장에서는 "텍스트 한 줄 보내고 한 줄 받기"라 귀·입 작업은 버려지지 않는다.

다음에 할 일 한 줄: 개발 PC의 JDK를 17 이상으로 올리고(현재 16) Android SDK·adb를 준비한 뒤, MockBrain으로 돌아가는 앱부터 만든다.

직접 확인할 것 (기록에 없어서 이 글이 보증하지 못하는 것)

MockBrain 앱을 만들기 전, 또는 실제 Claude를 붙이기 전에 직접 확인해야 하는 목록이다. 아래 항목의 값은 세션에 없고, 마지막 표의 Termux 값만 Termux 공식 위키(RUN_COMMAND Intent)에서 따로 확인한 것이다.

나중에 Termux로 Claude를 붙일 때

세션이 제안한 준비 순서는 Termux 설치 → Node.js 설치 → npm i -g @anthropic-ai/claude-code → claude 로그인이다. 로그인은 최초 1회 브라우저 OAuth이며, 그다음 Termux에서 claude -p 단독 실행과 응답 속도부터 확인한다. 세션은 앱↔Termux 브리지(RUN_COMMAND)를 "셋업이 상당히 까다롭다"고만 했고 값은 주지 않았다.

값은 Termux 공식 위키(RUN_COMMAND Intent)에서 확인한 내용이다. 이 세션이나 실기기에서 시험한 것이 아니다.

항목값
Termux 설정~/.termux/termux.properties에 allow-external-apps=true
앱 매니페스트<uses-permission android:name="com.termux.permission.RUN_COMMAND" />
인텐트action com.termux.RUN_COMMAND, 서비스 com.termux.app.RunCommandService, 패키지 com.termux
필수 extracom.termux.RUN_COMMAND_PATH — 실행할 파일의 절대 경로
선택 extracom.termux.RUN_COMMAND_ARGUMENTS(인자 배열), com.termux.RUN_COMMAND_WORKDIR(작업 디렉터리), com.termux.RUN_COMMAND_BACKGROUND(background 여부), com.termux.RUN_COMMAND_PENDING_INTENT(결과 수신용)
결과 회수PendingIntent의 결과 번들에서 stdout·stderr·exit code (Termux v0.109 이상). 정확한 키 이름과 예제 코드는 위키 원문 참조
권한앱 설정에서 RUN_COMMAND 권한을 사용자가 허용. targetSdk 30 이상은 매니페스트에 패키지 쿼리 선언 필요

상황

처음 계획은 태블릿이 호출어·STT·TTS만 하고 텍스트를 PC로 보내 답을 받는 구조였다. 그런데 "PC를 거치지 않고 태블릿 안에서 Claude Code까지 돌리겠다"로 바뀌었다. Claude Code는 Node.js CLI라 APK에 넣을 수 없으므로, 안드로이드용 리눅스 터미널 환경인 Termux에서 실행하고 앱이 RUN_COMMAND 인텐트로 명령을 시키는 안이 나왔다.

증상

실행 오류가 아니라 구조 혼동이었다. "termux 를 이용하면 앱 개발이 되는건 아닌셈인가?"라는 질문이 나왔고, 이어서 앱이 "termux 에 돌고 있는 claude code"로 전달하는 것인지 되물었다.

원인

듣고 말하는 앱을 만드는 일과 답변 엔진을 연결하는 일을 한 덩어리로 본 것이다. Termux는 앱 개발을 대신하지 않고 앱이 혼자 못 하는 한 가지, Claude Code 실행만 맡는다. 또 그 안에서 Claude Code는 상시 대기하지 않는다. 평소엔 설치만 돼 있고 앱이 문장을 넘길 때마다 claude -p를 새로 실행하며 끝나면 종료된다. 상시 대기는 앱의 마이크가 한다.

해결

구현이 아니라 첫 개발 범위를 정한 것이다. 두뇌를 interface로 분리하고 지금은 MockBrain, 나중에 TermuxBrain이나 HttpBrain을 끼운다.

첫 앱 범위: 마이크 상시 Foreground Service, 호출어 감지, SpeechRecognizer STT, BrainClient.ask(text), TextToSpeech, 상태(대기중/듣는중/처리중)와 인식·응답 로그 화면.

미실행 체크리스트

아래는 제안을 옮긴 Kotlin 설계 스케치이며 원본 구현 코드가 아니다. suspend와 String 반환은 이 글의 예시다.

interface BrainClient {
    suspend fun ask(text: String): String
}

class MockBrain : BrainClient {
    override suspend fun ask(text: String): String =
        "네, 들었어요. '$text'라고 하셨네요"
}

// 실제 엔진을 붙일 때 이 한 줄의 구현만 교체한다.
val brain: BrainClient = MockBrain()

취재 후기 — 귀와 입부터 만들어보자는 결정

설계 대화를 네 사람의 작업 회의로 재구성했다. 실기기 재현은 없다.

정바다
PC에서 "헤이 자비스" 하면 듣고 claude -p로 답해주는 비서 있잖아. 그걸 태블릿 혼자서 돌리고 싶어. Termux 깔면 Claude Code가 거기서 돌 테니 앱은 필요 없는 거 아냐?
박도은
Termux가 뭔데? 그걸 깔면 앱을 만든 셈이 돼?
정하늘
근거가 뭐야, 바다? Termux는 안드로이드 안에 들어가는 리눅스 터미널 앱일 뿐이라 명령을 실행만 해. 마이크를 켜두고 호출어를 듣고 말을 글자로 바꾸고 소리로 읽는 건 전부 우리가 만들 앱 몫이야.
정바다
그럼 Claude Code를 앱 안에 넣으면 되잖아. 하나로 묶이게.
정하늘
안 돼. Claude Code는 Node.js로 돌아가는 명령줄 프로그램이라 APK에 못 넣어. 그래서 그 한 조각만 Termux에 맡기는 거야.
박도은
아, 그럼 앱이 음성을 받아서 Termux에 계속 켜져 있는 Claude Code한테 넘기는 거네? 두 쪽을 다 켜두는 줄 알았어.
정하늘
반은 맞고 반은 틀려. Claude Code는 안 켜져 있어. 앱이 문장을 넘길 때마다 claude -p가 새로 뜨고, 답이 나오면 끝나. 상시로 깨어 있는 건 앱의 마이크뿐이야.
정바다
그럼 앱이 Termux한테 "이 문장 넣고 결과 줘"라고 시키는 길이 필요하네. 그게 RUN_COMMAND라는 거야? 그것부터 붙여 보자.
박도현
잠깐, 비용부터 보자. 그 연결이 이 방식에서 제일 번거롭다고 했어. 설정도 권한도 까다롭고.
정바다
그래도 태블릿 혼자 끝내려면 그게 정공법 아냐? PC 서버는 PC가 꺼지면 못 쓰잖아.
박도현
대신 PC 서버로 가면 브리지 삽질이 없어. 그리고 앱 입장에선 문장 한 줄 보내고 한 줄 받는 건 똑같아. 어디로 갈지 못 정했으면 그 자리를 비워두자.
박도은
비워둔다는 게 뭔데? 앱이 답을 못 받으면 아무것도 못 하잖아.
정하늘
가짜로 채우는 거야. 두뇌를 interface 하나로 빼고, 지금은 MockBrain이 들은 말을 그대로 되받게 해. 나중에 TermuxBrain이나 HttpBrain으로 갈아 끼우면 앱은 그대로야.
정바다
난 어차피 듣고 말하는 앱이 궁금했으니까 좋아. 가짜 두뇌 앱을 만들어서 태블릿에 올려 보면 되겠다.
박도은
근데 올리려면 APK를 빌드해야 하잖아. 내 개발 PC부터 확인해 봤는데 JDK가 16이야. adb도 Android SDK도 Gradle도 없어.
정하늘
JDK 16이면 안 돼?
박도은
안드로이드 빌드는 17 이상이 필요하대. 그러니까 코드는 바로 쓸 수 있는데, 태블릿에 올리려면 툴체인부터 깔아야 해.
박도현
그럼 바다 말대로 앱부터 가는 건 맞는데, 이건 어디로 가든 안 버려지는 쪽이야. 반대로 호출어가 안드로이드에서 실제로 도는지는 아직 아무도 몰라. 그 앱을 올려서 봐야 알아.
정하늘
맞아. 순서는 툴체인 준비, MockBrain 앱, 그다음 호출어 조사야. Claude를 어디에 둘지는 그 뒤에 정해도 돼. 두뇌 자리만 비워두면 미룬 결정이 앱 작업을 막지 않으니까.