DTSLIB · Termux-Bridge

폰 하나로 AI 코딩 에이전트
Aider + DeepSeek 설치 매뉴얼

Galaxy(안드로이드) + Termux 기준 · 코딩 지식 0 출발 · 버튼 눌러 복사 → 터미널에 붙여넣기만 하면 됩니다.

오늘의 도착지
root@localhost:~/work# aider --model deepseek/deepseek-chat Aider v0.86.2 · Model: deepseek/deepseek-chat > 구구단 출력하는 gugudan.py 만들어줘 파일을 생성하고 커밋했습니다. Tokens: 2.4k sent · Cost: $0.00075

시작 전, 단 하나의 규칙 — "지금 어디에 있는가"

~ $겉 = Termux
1·2·8단계만 여기서
root@localhost:~#속 = Ubuntu
설치는 전부 여기서

이 매뉴얼의 모든 에러는 딱 하나의 원인에서 나옵니다: 겉(~ $)에서 설치 명령을 치는 것. 각 단계의 색깔 배지가 현재 있어야 할 위치입니다. 프롬프트가 배지와 다르면 명령을 치지 마세요.

1

우분투 컨테이너 설치

겉 ~ $

안드로이드는 리눅스와 부품 규격(libc)이 달라 AI 도구가 조립 중에 터집니다. 규격이 맞는 우분투 방을 폰 안에 하나 만듭니다. 와이파이에서 진행하세요.

pkg update -y && pkg upgrade -y
pkg install -y proot-distro
proot-distro install ubuntu

에러 없이 프롬프트(~ $)로 돌아오면 통과.

2

우분투 방으로 입장

겉 → 속

이제 겉에서 속으로 들어갑니다. 이후 3~7단계는 전부 속에서 진행합니다.

proot-distro login ubuntu

프롬프트가 root@localhost:~# 로 바뀌면 통과. 안 바뀌면 절대 다음 단계 금지.

3

기본 도구 설치

속 root@

다운로드 도구(curl)와 편집기 등 최소 장비를 갖춥니다.

apt update && apt install -y curl git nano

root@localhost:~# 프롬프트로 돌아오면 통과.

4

Aider 공식 설치 (핵심)

속 root@

공식 스크립트가 자기 전용 파이썬까지 통째로 들고 와서 격리 설치합니다. 시스템 파이썬 버전이 뭐든 안 깨지는, 현재 가장 안정적인 표준 루트입니다. 다운로드가 커서 몇 분 걸립니다 — 끝까지 기다리세요.

curl -LsSf https://aider.chat/install.sh | sh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
aider --version

마지막 줄에서 aider 0.86.x 처럼 버전이 찍히면 통과.

5

DeepSeek 열쇠 등록

속 root@

platform.deepseek.com → API Keys에서 발급받은 sk-로 시작하는 영문+숫자 키를 아래 칸에 붙여넣으면, 복사 버튼이 완성된 명령을 만들어 줍니다.

sed -i '/DEEPSEEK_API_KEY/d' ~/.bashrc
echo 'export DEEPSEEK_API_KEY="sk-여기에_내_키"' >> ~/.bashrc
source ~/.bashrc
echo $DEEPSEEK_API_KEY

마지막 줄에서 내 키가 영문으로 출력되면 통과. 한글이 섞여 나오면 키 자리를 교체 안 한 것 — 위 칸에 다시 붙여넣고 재복사.

6

한국어 응답 설정

속 root@

에이전트가 항상 한국어로 답하도록 설정 파일에 박아둡니다. 한 번이면 영구 적용.

cat >> ~/.aider.conf.yml << 'EOF'
chat-language: Korean
EOF

아무 출력 없이 프롬프트로 돌아오면 정상 (원래 조용히 저장됩니다).

7

발사 — 첫 실습

속 root@

작업방(work)을 만들고 에이전트를 켭니다. 켜지면 > 프롬프트에 한국어로 그냥 시키면 됩니다.

mkdir -p ~/work && cd ~/work
aider --model deepseek/deepseek-chat
# > 프롬프트에 이렇게 쳐보세요
구구단 출력하는 gugudan.py 만들어줘

파일 생성 + 자동 커밋 메시지가 뜨고, 하단에 Tokens / Cost 줄이 찍히면 완주. 종료는 /exit.

8

다음부터는 한 줄 진입

겉 ~ $

우분투에서 exit 로 겉으로 나온 뒤, 아래를 한 번만 실행하면 앞으로는 Termux 켜고 aider-go 한 줄로 바로 에이전트 앞까지 갑니다.

echo "alias aider-go='proot-distro login ubuntu -- bash -lc \"cd ~/work && aider --model deepseek/deepseek-chat\"'" >> ~/.bashrc
source ~/.bashrc

aider-go 입력 → 에이전트 화면이 바로 뜨면 통과.

🚑 응급실 — 실전에서 진짜 터졌던 에러 3종

이 매뉴얼 제작 중 실기기(Galaxy S21)에서 실제 발생한 사고와 처방입니다.

Failed to build 'numpy' / pkgutil ImpImporter
AttributeError: module 'pkgutil' has no attribute 'ImpImporter' 진단: 겉(~ $)에서 pip를 친 것. 안드로이드 규격 때문에 부품을 현장 제작하다 터집니다.
처방: 2단계로 돌아가 우분투에 입장한 뒤, 4단계 공식 스크립트로 설치.
Cannot import 'setuptools.build_meta'
BackendUnavailable: Cannot import 'setuptools.build_meta' 진단: 우분투 안이라도 시스템 파이썬(3.14 등)에 직접 pip 설치를 시도한 경우.
처방: venv/pip 방식을 버리고 4단계 공식 스크립트 사용 — 전용 파이썬을 데려오므로 버전 싸움 자체가 사라집니다. 기존 잔해는 rm -rf ~/aider-env 로 청소.
키를 넣었는데 "DEEPSEEK_API_KEY: Not set"
export DEEPSEEK_API_KEY="sk-\354\227\254..." 진단: 예시 문구(한글)를 교체하지 않고 그대로 복붙 → 가짜 키 등록.
처방: 5단계에서 내 키를 입력칸에 넣고 다시 복사·실행. 명령 첫 줄의 sed가 가짜 키를 자동 청소합니다.
키를 새로 갈아끼우고 싶을 때 (교체 공식)
키가 노출됐거나 재발급했다면, 속(root@)에서 5단계 명령을 새 키로 다시 실행하면 끝 — 첫 줄이 옛 키를 지우고 새 키를 등록합니다.

보안 철칙: API 키는 채팅·스크린샷·코드에 절대 노출 금지. 노출 즉시 platform.deepseek.com에서 폐기 후 재발급.