Android에서 opencode 실행하기: 휴대폰을 AI 코딩 스테이션으로 변신시키는 무료 런처

opencode는 사용자의 기기(machine)를 위한 터미널 기반의 AI 코딩 에이전트입니다. 그런데 만약 '사용자의 기기'가 주머니 속의 휴대폰이라면 어떨까요?

OpenCode Android는 opencode를 Termux 내부에 네이티브하게 설치하는 무료 MIT 라이선스 안드로이드 런처입니다 (루팅 불필요, proot 사용하지 않음). 이 런처는 로컬 서버를 실행하고, 채팅 UI를 네이티브 앱 형태로 제공합니다. 여기에는 안내 설정(guided setup), 원터치 시작, 백그라운드 업데이트 확인 및 알림 기능 등이 포함됩니다.

기능 소개 (What it does)

• 안내 설정 마법사(Guided setup wizard) — Termux를 감지하고, 단일 붙여넣기 명령어로 외부 명령어 브릿지를 활성화하며, 종속성(glibc runtime 포함)을 설치하고, autoupdate=false로 opencode를 구성하여 업데이트가 사용자의 통제 하에 있도록 합니다.
• 원터치 채팅 (One-tap chat) — opencode serve를 127.0.0.1:4096에서 시작하고, opencode 자체의 웹 UI를 WebView에 엽니다. 상태 확인(health check) 및 실시간 상태 점으로 서버가 작동 중인지 보여줍니다.
• 실제 진행 상황을 보여주는 백그라운드 업그레이드 (Background upgrades with real progress) — 앱이 진행 표시자(progress markers)를 읽고 실시간 진행률 막대를 보여주는 동안, 업데이트는 Termux 내부에서 눈에 보이게 실행되며 이후 서버를 자동으로 재시작합니다.
• 알림 (Notifications) — 일일 확인을 통해 새로운 opencode 버전이나 새로운 런처 버전이 사용 가능할 때 알려줍니다 (버전별로 한 번만 알림, 중복 제거).
• 셀프 업데이트 (Self-update) — 이 런처는 GitHub 릴리스에서 명시적인 터치(explicit tap)를 통해 스스로 업데이트됩니다.

요구 사항 (Requirements)

• arm64(aarch64) 장치에서 Android 8.0 이상.
• F-Droid 또는 GitHub에서 설치한 Termux (Play 스토어 빌드는 사용 중단되었으며 작동하지 않습니다).
• 루팅 불필요. 휴대폰이 앱에 대한 루팅을 제공하더라도 거부하세요. 모든 기능은 루팅 없이 작동합니다.

작동 원리

이 앱은 에이전트를 번들로 포함하지 않습니다. 대신 공식 RUN_COMMAND 인텐트 채널을 통해 Termux를 구동합니다(위자드가 보여주는 한 줄 명령어를 붙여넣어 allow-external-apps=true를 한 번 활성화해야 합니다). 설치와 업그레이드는 Termux 내부에서 눈에 보이게 실행되며, 런처는 진행 상황만 표시하고 브라우저가 작동하는 방식과 동일하게 로컬 서버와 통신합니다.

설치 방법

1. GitHub Releases에서 APK를 다운로드합니다.
2. 앱을 열고 위자드를 따릅니다(약 2분 소요).
3. 에이전트와 채팅을 시작합니다.

이 기능의 존재 이유

대부분의 코딩 에이전트용 모바일 클라이언트는 원격 제어 장치입니다: 다른 곳 어딘가에 실행되는 서버에 연결합니다. 하지만 이것은 정반대이며, 모든 것이 휴대폰에서 실행됩니다. opencode 자체를 활용하여(적절하게) 구축되었으며, 전체 흐름이 가능한 한 적은 탭으로 작동하도록 설계되었습니다.

소스 코드 및 이슈: https://github.com/Dajeovv/opencode-android (MIT)

피드백을 환영합니다.