개발 취재 노트
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)에서 따로 확인한 것이다.
- 호출어 감지: 세션은 openWakeWord
.tflite모델을 TensorFlow Lite로 구동하고 16kHz 마이크 오디오를 상시 처리하는 안을 냈다. 안드로이드에서 실제로 도는지, 어떤 라이브러리로 붙이는지는 미확인이다. SpeechRecognizer상시 사용: 세션은 "온디바이스 인식을 켜면 오프라인도 가능"이라 했지만 시험한 적은 없다. 인식이 끝날 때마다 세션을 다시 시작해야 하는지, 기기에 한국어 온디바이스 모델이 있는지 확인해야 한다.- 권한:
RECORD_AUDIO,FOREGROUND_SERVICE,FOREGROUND_SERVICE_MICROPHONE,POST_NOTIFICATIONS, Android 14 이상에서microphone타입 foreground service 선언, 배터리 최적화 예외가 필요하다고 제안됐다. - 빌드 버전: 확인된 것은 개발 PC의 JDK가 16이라 17 이상이 필요하다는 것, adb·SDK·Android Studio·Gradle이 없다는 것뿐이다. AGP·Gradle·minSdk 값은 정해진 바 없다.
- 태블릿 발열·속도:
claude -p는 호출마다 Node 프로세스를 새로 띄워 PC보다 확연히 느릴 수 있다고 경고됐다. 실측은 없다.
나중에 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 |
| 필수 extra | com.termux.RUN_COMMAND_PATH — 실행할 파일의 절대 경로 |
| 선택 extra | com.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, 상태(대기중/듣는중/처리중)와 인식·응답 로그 화면.
미실행 체크리스트
- [ ] 개발 PC 준비:
java -version이 17 이상이 되도록 JDK 설치, Android SDK, SDK Platform Tools 설치 후adb version확인. Gradle·Android Studio 준비. - [ ] Kotlin 안드로이드 프로젝트를 Python 프로그램과 별도로 생성.
- [ ]
BrainClient와MockBrain연결, 입력·대역 응답을 화면 로그로 확인. - [ ]
SpeechRecognizer결과 →ask→TextToSpeech, 상태 로그. 인식이 끝날 때마다 다시 시작해야 하는지는 미확인이라 이 글에 코드가 없다. - [ ] Foreground Service + 위 권한 + 호출어 감지. 여기서 막힐 수 있다: 안드로이드에서 호출어 모델을 어떤 라이브러리로 붙일지 아직 후보조차 정해지지 않았다. 앞 단계의
MockBrain앱을 먼저 끝내 두고 이 항목은 따로 조사한다("직접 확인할 것" 참고). - [ ] APK 빌드, adb 설치, 호출어 → 인식 → 대역 응답 → 음성 재생 순서로 확인.
아래는 제안을 옮긴 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()
취재 후기 — 귀와 입부터 만들어보자는 결정
설계 대화를 네 사람의 작업 회의로 재구성했다. 실기기 재현은 없다.
claude -p로 답해주는 비서 있잖아. 그걸 태블릿 혼자서 돌리고 싶어. Termux 깔면 Claude Code가 거기서 돌 테니 앱은 필요 없는 거 아냐? claude -p가 새로 뜨고, 답이 나오면 끝나. 상시로 깨어 있는 건 앱의 마이크뿐이야. RUN_COMMAND라는 거야? 그것부터 붙여 보자. interface 하나로 빼고, 지금은 MockBrain이 들은 말을 그대로 되받게 해. 나중에 TermuxBrain이나 HttpBrain으로 갈아 끼우면 앱은 그대로야. MockBrain 앱, 그다음 호출어 조사야. Claude를 어디에 둘지는 그 뒤에 정해도 돼. 두뇌 자리만 비워두면 미룬 결정이 앱 작업을 막지 않으니까.