Termux Bridge 설치법 웹진

🎓 학습 & 참조 코스 9모듈 · 레퍼런스 · 페이지 맵 ▼

🎓

학습 코스 — 실력순 9모듈

▼

순서대로 따라가면 생초보에서 풀스택 워크센터까지 완성된다. 모듈마다 독립 페이지.

01☦ Baptism — 생초보 원클릭 설치10분 02🔘 위젯 8개 마스터15분 03🤖 Claude Code + DeepSeek Aider10분 04🖥️ RustDesk 원격제어10분 05🔌 ADB 무선 디버깅10분 06🔗 SSH/MOSH 5-Lane 터널10분 07🪟 Windows To Go 설치30분 08🎙️ TTS 음성 브릿지10분 09🩺 자가진단 + 문제해결5분

REF

이 페이지 레퍼런스

▼

위 코스와 별개로, 이 페이지 안에서 바로 찾아보는 참조 자료. 코스에 없는 내용(BOM/교재/부록/삽질사전) 위주.

01⚡ 설치 — 명령어 한 줄10분 02빠른 시작 — 생초보 → 에이전트5분 03전체 설치 — install.sh 상세30분 04위젯 8개 — 폰에서 원클릭5분 05Tab S9 생산센터 세팅20분 06WTG — PC 자동 복구 시스템60분 07문제 해결 — 삽질 사전참조 08BOM 원장 — 패키지 전수 목록참조 09교재 — 폰 하나로 AI를 쓴다39장 A부록 — 명령어 레퍼런스참조

다른 형태로 보기

▼

이 페이지가 설치 매뉴얼이라면, 아래는 같은 이야기를 영상·튜토리얼·인터랙티브·슬라이드·자동방송·비유로 푼 버전이다.

01Invitation — 60초 스토리영상 02Tutorial — 4단계로 따라하기튜토리얼 03App — 브라우저에서 체험인터랙티브 04Slides — 전체 강의 39장슬라이드 05Pipeline — slides2video 자동 방송파이프라인 06쉬운 비유 — 피자집으로 이해하는 Termux Bridge초보자

⚡ 설치 & 환경 세팅 원클릭 설치 · 위젯 · 탭 · WTG ▼

⚡ 설치 — 명령어 한 줄

▼

Termux 폰을 Claude Code + DeepSeek Aider + MCP 서버 + 위젯 8개로 바꾼다. 파이프(`|`) 없음. 복붙만 하면 된다.

✅ 설치 명령어 (Termux 터미널에서)

curl -O https://raw.githubusercontent.com/dtslib1979/termux-bridge/main/g && bash g

⚠️

삼성 키보드 주의: `.?123` 첫 페이지만 사용할 것. 파이프(`|`) 없음. `curl -O` = URL에서 `g` 파일 받음 → `&& bash g` = 실행.

🚀 빠른 시작 — 생초보 → 에이전트

▼

zero.sh 하나면 DeepSeek 에이전트 즉시 구동. Claude Code가 대신 다 해준다.

🚀 zero.sh — 생초보 → 에이전트 즉시 구동

curl -fsSL https://raw.githubusercontent.com/dtslib1979/termux-bridge/main/zero.sh | bash

Claude Code로 DeepSeek 구동

위 명령어가 하는 일:

pkg update + nodejs/git/openssh 설치
npm install -g @anthropic-ai/claude-code
DeepSeek API 키 등록
claude --model deepseek-chat 즉시 실행

💡

설치 후 에이전트한테 시킬 일: "레포 클론해줘", "SSH 키 등록해줘", "위젯 만들어줘", "RustDesk 설치해줘" — 말만 하면 된다.

📦 전체 설치 — install.sh

▼

Termux · Ubuntu · macOS 전부 지원. BOM 원장 자동 생성 + phoneparis baptism 동기화.

🔧 플래그 목록

bash install.sh # 전체 설치
bash install.sh --dry-run # 설치 없이 체크만
bash install.sh --verify # 이미 설치된 환경 검증만
bash install.sh --bom-only # BOM JSON 생성만 (설치 없음)

시스템 패키지 16종

패키지	명령어	용도
git	git	버전 관리
node	node	JS 런타임
python	python3	Python 런타임
ffmpeg	ffmpeg	오디오/비디오 처리
gh	gh	GitHub CLI
imagemagick	convert	이미지 변환/처리
jq	jq	JSON 처리
poppler	pdftotext	PDF 도구
rclone	rclone	Google Drive 동기화
rsync	rsync	파일 동기화
tree	tree	디렉토리 시각화
wget	wget	파일 다운로드
android-tools	adb	ADB 바이너리
chromium	chromium-browser	CDP 스크린샷 (Termux)
cmake	cmake	빌드 도구
ninja	ninja	빌드 도구

Python 패키지 3종

패키지	버전	용도
pillow	12.1.1	이미지 처리 (OpenCV 대체)
numpy	2.2.5	수치 연산
requests	2.32.5	HTTP 클라이언트

npm 패키지 2종

패키지	범위	용도
claude	global	Claude Code CLI
ws	local	CDP WebSocket 연결

Android 앱 (수동 설치)

앱	패키지 ID	용도
Shizuku	moe.shizuku.privileged.api	ADB급 시스템 권한 — 루트 없이

설치 불가 — 대안 사용

도구	이유	대안
opencv-python	aarch64 빌드 실패	pillow
scipy	빌드 실패	numpy
puppeteer	Android 미지원	CDP 직접 연결
playwright	Android 미지원	GitHub Actions
docker	커널 제약	불가
lighthouse	빌드 실패	GitHub Actions

📱 위젯 8개 — 폰에서 원클릭

▼

Termux:Widget으로 홈 화면에 추가. 탭만 하면 PC 접속 · 에이전트 실행 · 헬스체크.

폰 위젯 (8개)

ℹ️

Termux:Widget 설치: F-Droid에서 설치 후 홈 화면에 위젯 추가. 위젯을 탭하면 각 기능 즉시 실행.

📟 Tab S9 생산센터 세팅

▼

탭은 생산 디바이스 — 소비 앱 전부 삭제. 4대 축(Capture/Visual/Communication/Lite Dev)만 남긴다.

💡

철학: 폰(S25 Ultra) = Voice/Text/Code/Audio 생산 엔진. 탭(Tab S9) = Capture/Visual/Communication/Lite Dev 전담.

🖥️ WTG — PC 자동 복구 시스템

▼

Windows To Go 이동식 디스크를 복구 레인으로 사용. 전원 ON → WTG 부팅 → NVMe 감지 → 자동 전환.

부팅 타임라인

[0초] 전원 ON → WTG 부팅 (BIOS 1순위)
[30초] WTG Win10 자동 로그인
[1분] 01_wtg_nvme_check.bat 실행
[1분15초] NVMe 정상 → bootsequence 설정 → 15초 후 재부팅
[2분] NVMe Win11 부팅
[3분] WSL 시작 → 5-Lane 올라옴
[3분30초] 폰에서 "pc" → Claude Code 접속 가능

Startup 스크립트 배포

# WTG Startup 폴더에 배포
cp wtg/01_wtg_nvme_check.bat "/mnt/w/ProgramData/Microsoft/Windows/Start Menu/Programs/Startup/"
cp wtg/03_parksy_agent.bat "/mnt/w/ProgramData/Microsoft/Windows/Start Menu/Programs/Startup/"

# 1회 설정 재실행 유도
rm -f /mnt/w/wtg_setup_done.flag

부팅 순서 관리

WTG 1순위 설정

bcdedit /set {fwbootmgr} displayorder {c8308535-39f2-11f1-9f65-806e6f6e6963} {bootmgr} {e34d72c8-3b41-11f1-9f6a-806e6f6e6963} {0f75cbeb-3c54-11f1-9f6e-806e6f6e6963}

NVMe 1순위 (WTG 바이패스)

bcdedit /set {fwbootmgr} displayorder {bootmgr} {c8308535-39f2-11f1-9f65-806e6f6e6963}

WTG 경량화 — 서비스 27개 비활성화

PowerShell (관리자 권한)

powershell.exe -ExecutionPolicy Bypass -File install/wtg-slim-services.ps1

🔧 운영 & 자료실 삽질사전 · BOM · 교재 · 부록 ▼

🔧 문제 해결 — 삽질 사전

▼

3개월 실운영 중 만난 에러와 그 해결법. 전부 실제 로그 기반.

Termux 관련

위젯이 안 보여요

am broadcast -n com.termux.widget/.WidgetProvider -a android.intent.action.ACTION_POWER_CONNECTED

Termux:Widget 앱이 설치되어 있어야 위젯이 보인다.

proot Ubuntu 오류

proot-distro install ubuntu # 다시 설치
proot-distro login ubuntu -- apt update # 업데이트

API 키 오류

echo "DEEPSEEK_API_KEY=sk-xxxxxxxx" > ~/__d_.env

SSH 관련

SSH 접속이 계속 끊길 때 체크리스트

# 1. SSH 루프 확인 (CPU 폭주 원인)
ps aux | grep ssh

# 2. tailscaled 상태
systemctl status tailscaled

# 3. wslconfig 확인
cat /mnt/c/Users/dtsli/.wslconfig

# 4. 포트 점유 확인
lsof -i :9876

# 5. tmux 세션 목록
tmux ls

SSH 긴급 탈출법

연결이 완전히 먹통일 때: ~. — 물결표(`~`) 누르고 바로 마침표(`.`) = SSH 강제 종료

tmux 관련

tmux 화면 깨짐

증상: 점선 도배, 글자 겹침, 입력 안 됨

tmux kill-server # 모든 tmux 세션 종료
tmux new -s work # 새로 시작

git 관련

git pull이 안 될 때

git checkout -- [파일명] # 해당 파일 되돌리기
git pull # 그 다음 pull

LMK (Low Memory Killer)

🚨

S25 Ultra LMK 문제: ONNX 모델 920MB를 278MB free 공간에 로드 → LMK가 Termux를 즉시 살해. 해결: heavy inference는 WSL2로 전면 이전. 폰은 watchdog만 유지.

📋 BOM 원장 — 패키지 전수 목록

▼

install/bom.json — 검증된 패키지 원장. phoneparis baptism과 동기화되는 공식 BOM.

BOM 생성

bash install.sh --bom-only # BOM만 생성

phoneparis baptism 동기화

bash install/sync-bom.sh # BOM → phoneparis 자동 동기화

ℹ️

canonical=true인 BOM(Termux에서 생성)만 phoneparis 원장으로 사용. 비Termux 환경 BOM은 참고용.

📖 교재 — 폰 하나로 AI를 쓴다, 만든다, 움직인다

▼

Claude Code × Termux 실전 교재. 3개월 실전 경험을 39장으로 압축.

💡

이 교재를 쓰는 이유: 3개월 동안 일단 썼다. 이제 알고 쓸 타이밍이다. 실패, 삽질, 재시도가 그대로 담겨 있다.

📎 부록 — 명령어 레퍼런스

▼

새 폰 환경 원클릭 세팅

curl -fsSL https://raw.githubusercontent.com/dtslib1979/termux-bridge/main/setup.sh | bash && source ~/.bashrc

설치 후 사용법

pc # PC 접속 (autossh — 끊겨도 자동 재접속)
cm # claude-main tmux 세션으로
ct # tablet tmux 세션으로
cc # termux-bridge에서 claude 실행
cb # termux-bridge 폴더 이동

RustDesk 자가진단

bash install/doctor.sh # 진단만
bash install/doctor.sh --fix # 진단 + 자동복구

ADB Mesh 자동 복구

bash install/adb_revive.sh phone # 폰 ADB 복구
bash install/adb_revive.sh tab # 탭 ADB 복구
bash install/adb_revive.sh all # 둘 다 복구

MCP 3개 서버 시작 (WSL2)

bash ~/parksy-audio/start_wsl2_mcp.sh # 3개 동시 시작

# 개별 시작
python3 ~/parksy-audio/mcp_voice/wsl2_voice_mcp_sse.py &
python3 ~/parksy-audio/mcp_voice/wsl2_audio_mcp_sse.py &
python3 ~/parksy-audio/mcp_voice/wsl2_publish_mcp_sse.py &

# 레시피 실행
cd /tmp && python3 recipe_runner.py

# 로그 확인
tail -f ~/parksy-audio/logs/wsl2_voice.log

ds.bat — Claude Code 스킨 + DeepSeek 과금 (Windows)

설치

windows/ds.bat → C:\Users\{유저명}\AppData\Roaming\npm\에 복사

스킨은 Claude, 과금은 DeepSeek

파일 구조

termux-bridge/
├── easy/ ← 🆕 쉬운 비유 랜딩
├── CLAUDE.md ← AI 파싱 진입점
├── index.html ← 이 웹진
├── easy/ ← 비유 랜딩 페이지
├── guide/ ← 9모듈 강의
├── docs/ ← 기술 문서 (8개 카테고리)
├── install.sh ← 유니버설 인스톨러
├── widgets/ ← 위젯 스크립트
├── windows/wtg/ ← WTG 부팅 자동화
├── phone-health/ ← S25 Ultra 정기검진
└── 00_TRUTH/ ← 자동화 경계 문서

RustDesk 자가진단

bash install/doctor.sh # 진단만
bash install/doctor.sh --fix # 진단 + 자동복구

ADB Mesh 자동 복구

bash install/adb_revive.sh phone # 폰 ADB 복구
bash install/adb_revive.sh tab # 탭 ADB 복구
bash install/adb_revive.sh all # 둘 다 복구

MCP 3개 서버 시작 (WSL2)

bash ~/parksy-audio/start_wsl2_mcp.sh # 3개 동시 시작

# 개별 시작
python3 ~/parksy-audio/mcp_voice/wsl2_voice_mcp_sse.py &
python3 ~/parksy-audio/mcp_voice/wsl2_audio_mcp_sse.py &
python3 ~/parksy-audio/mcp_voice/wsl2_publish_mcp_sse.py &

# 레시피 실행
cd /tmp && python3 recipe_runner.py <recipe_name>

# 로그 확인
tail -f ~/parksy-audio/logs/wsl2_voice.log

ds.bat — Claude Code 스킨 + DeepSeek 과금 (Windows)

설치

windows/ds.bat → C:\Users\{유저명}\AppData\Roaming\npm\에 복사

스킨은 Claude, 과금은 DeepSeek

파일 구조

termux-bridge/
├── CLAUDE.md ← AI 파싱 진입점
├── README.md ← 프로젝트 개요
├── DEVLOG.md ← 개발일지 (삽질 기록 보존)
├── index.html ← 이 웹진
├── install.sh ← 유니버설 인스톨러
├── install/
│ ├── bom.json ← 검증된 패키지 원장
│ ├── doctor.sh ← RustDesk 자가진단
│ ├── adb_revive.sh ← ADB mesh 복구
│ └── tab_cleanup.sh ← 탭 정리
├── widgets/
│ ├── phone/ ← 폰 위젯 8개
│ └── tab/ ← 태블릿 위젯 13개
├── windows/wtg/ ← WTG 부팅 자동화
├── workcenter/ ← 워크센터 생산 디렉토리
├── config/ ← RustDesk 설정
├── phone-health/ ← S25 Ultra 정기검진
├── docs/ ← 기술 문서
└── 00_TRUTH/ ← 자동화 경계 문서