Show GN: SSH Term – 스마트폰에서 Claude Code를 제대로 쓰기 위해 만든 SSH 앱

(play.google.com)

1P by obutora 4시간전 | ★ favorite | 댓글과 토론

요약

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 모두 출시 완료:

피드백 환영합니다.