Show GN: SSH Term – 스마트폰에서 Claude Code를 제대로 쓰기 위해 만든 SSH 앱
(play.google.com)요약
- Claude Code 공식 "리모트 컨트롤"은 편리하지만, 채팅 UI만 제공되어 자유로운 터미널 조작이 불가능
- SSH + tmux 조합이면 요금제 무관, 세션 영속, 터미널 그 자체를 얻을 수 있음. 단, Android SSH 앱은 한국어/일본어 등 CJK 입력이 제대로 안 됨
- 직접 만들었음. SFTP 파일 탐색기, 커스텀 명령어, 접속 시 자동 실행 등 필요한 기능을 모두 넣은 SSH 앱
배경: 공식 리모트 컨트롤의 한계
Claude Code에 리모트 컨트롤 기능이 추가됐습니다. claude remote-control을 실행하면 QR 코드가 표시되고, 스마트폰의 Claude 앱에서 세션에 접속할 수 있습니다.
편리하긴 하지만, 몇 가지 제약이 있습니다:
- 채팅 UI만 제공 – Claude Code와의 대화만 볼 수 있고, 터미널 자체를 조작할 수 없음
-
git log,ls같은 직접적인 터미널 명령어 실행 불가 - 생성된 파일을 트리 뷰로 확인하거나, 구문 강조 표시로 읽거나, 다운로드할 수 없음
SSH + tmux vs 리모트 컨트롤
| 리모트 컨트롤 | SSH + tmux (SSH Term) | |
|---|---|---|
| 네트워크 끊김 시 | 약 10분 후 세션 종료 | tmux로 세션 영속. 몇 시간이 지나도 복귀 가능 |
| 터미널 닫으면 | 세션 종료 | tmux가 세션 유지. 재접속하면 OK |
| 조작 범위 | Claude Code 채팅만 | 터미널 그 자체 (무엇이든 가능) |
| 파일 확인 | Claude Code 경유로만 | SFTP 파일 탐색기 + 구문 강조 + 다운로드 |
| 복수 세션 | 세션명 파악이 어려움 | 탭으로 복수 동시 관리 |
| 셋업 | claude remote-control 한 줄 |
SSH 서버 설정 + tmux 도입 필요 |
만든 이유
Mini PC에 SSH로 접속해서 Claude Code에 지시를 내리려 했는데, Android의 기존 SSH 앱들은 CJK 입력(한국어, 일본어 등)이 제대로 안 됐습니다. 키보드가 아예 안 뜨거나, 입력한 문자가 정상적으로 전송되지 않거나. 여러 앱을 시도했지만 전멸.
직접 만들기로 했습니다.
SSH Term
iOS/Android 양쪽 모두 출시 완료. CLI 기반 AI 코딩 에이전트를 스마트폰에서 조작하는 것에 특화한 터미널 클라이언트입니다. 물론 일반 SSH 클라이언트로도 사용 가능합니다.
주요 기능
IME 모드 – CJK 입력 지원
Android에서 한국어/일본어/중국어 입력이 제대로 되는 SSH 앱은 놀라울 정도로 적습니다. SSH Term은 IME 모드를 탑재하여, 전환만 하면 CJK 텍스트를 터미널에 그대로 전송할 수 있습니다.
SFTP 파일 탐색기 + 구문 강조 + 다운로드
Claude Code가 생성한 코드를 cat으로 터미널에 흘려보내며 스마트폰 화면에서 읽는 건 현실적이지 않습니다.
SSH Term에는 SFTP 파일 탐색기가 내장되어 있습니다:
- 40개 이상 언어의 구문 강조 (Dart, Python, JS/TS, Go, Rust, Shell 등)
- 파일 다운로드 – 생성된 결과물을 단말기에 저장
- 북마크 – 자주 확인하는 디렉토리에 원탭 이동
- iPad에서는 2페인 표시로 파일 목록과 프리뷰를 동시에 확인 가능
커스텀 텍스트 명령어
입력 어시스트 툴바에 자주 쓰는 명령어를 버튼으로 등록할 수 있습니다:
-
git status\n→ 원탭으로 실행 -
tmux attach -t main\n→ tmux 세션에 바로 접속 -
cd ~/projects/my-app && claude\n→ 디렉토리 이동부터 Claude Code 실행까지 한 번에
복수 명령어를 스텝으로 조합하는 것도 가능.
접속 시 / 재접속 시 자동 명령어 실행
접속 프로필에 접속 후 실행할 명령어를 설정할 수 있습니다. 예를 들어:
-
wsl→ WSL 기동 -
cd ~/projects/my-app→ 작업 디렉토리로 이동 -
tmux new -s main→ tmux 세션 시작
재접속 시 명령어를 별도로 설정할 수 있어서, 네트워크가 끊겼다 복구되면 tmux attach -t main으로 자동 복귀합니다. 지하철에서 터널을 지나도 몇 초 후 원래 세션으로 돌아옵니다.
백그라운드 접속 유지
앱을 전환해도 SSH 접속이 유지됩니다. Claude Code가 처리 중일 때 다른 앱을 사용하다 돌아오면 결과를 바로 확인 가능. 생체 인증/PIN 잠금 기능도 탑재.
기타
-
복수 탭 – 하나는 Claude Code, 다른 하나는
tail -f로 로그 모니터링 -
앱 내 키 생성 – Ed25519(권장), RSA 2048/4096. 공개키를 클립보드에 복사해서 바로
authorized_keys에 등록 - 8종 테마 – Dracula, Nord, Tokyo Night, Monokai, Solarized Dark, Gruvbox, Catppuccin Mocha, One Dark
- 10종+ 모노스페이스 폰트 – Fira Code, JetBrains Mono 등. Nerd Font도 지원 (Starship, Powerlevel10k 아이콘 표시 가능)
- 입력 어시스트 툴바 – Ctrl+C, Tab, Escape, 화살표 키, F1~F12 등을 원탭 입력
기능 요약
| 카테고리 | 기능 |
|---|---|
| 입력 | IME 모드 (CJK 입력), 입력 어시스트 툴바, 커스텀 텍스트 명령어 |
| 파일 | SFTP 파일 탐색기, 구문 강조 (40개 언어+), 파일 다운로드, 북마크 |
| 접속 | 자동 재접속, 백그라운드 유지, 접속 시 명령어, 재접속 시 명령어, 화면 잠금 |
| 세션 | 복수 탭, tmux 단축키 |
| 인증 | 패스워드, 공개키 (Ed25519/RSA), 키보드 인터랙티브, 앱 내 키 생성 |
| 외관 | 8종 테마, 10종+ 폰트, Nerd Font 지원 |
실제 사용 흐름
- 집의 Mini PC에 Claude Code를 상시 대기
- 외출 중 스마트폰으로 SSH 접속 (초기 명령어로 WSL → 작업 디렉토리 → tmux 접속까지 자동)
- 자연어로 "이 기능을 추가해줘"라고 지시
- Claude Code 처리 중에는 앱을 백그라운드로
- 잠시 후 돌아와서 결과 확인
- 파일 탐색기로 생성된 코드를 프리뷰, 필요하면 다운로드
- 문제없으면 다음 지시
네트워크가 끊겨도 재접속 명령어로 자동 복귀. 지하철 안에서 자연어만으로 프로젝트가 진행됩니다.
iOS / Android 모두 출시 완료:
피드백 환영합니다.