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

> Clean Markdown view of GeekNews topic #27375. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=27375](https://news.hada.io/topic?id=27375)
- GeekNews Markdown: [https://news.hada.io/topic/27375.md](https://news.hada.io/topic/27375.md)
- Type: show
- Author: [obutora](https://news.hada.io/@obutora)
- Published: 2026-03-10T19:32:39+09:00
- Updated: 2026-03-10T19:32:39+09:00
- Original source: [play.google.com](https://play.google.com/store/apps/details?id=com.obuto.sshterm)
- Points: 1
- Comments: 0

## Topic Body

#### 요약  
- Claude Code 공식 "리모트 컨트롤"은 편리하지만, **채팅 UI만 제공**되어 자유로운 터미널 조작이 불가능  
- SSH + tmux 조합이면 **요금제 무관, 세션 영속, 터미널 그 자체**를 얻을 수 있음. 단, Android SSH 앱은 한국어/일본어 등 CJK 입력이 제대로 안 됨  
- 직접 만들었음. SFTP 파일 탐색기, 커스텀 명령어, 접속 시 자동 실행 등 **필요한 기능을 모두 넣은** SSH 앱  
  
#### 배경: 공식 리모트 컨트롤의 한계  
  
Claude Code에 [리모트 컨트롤 기능](https://code.claude.com/docs/ja/remote-control)이 추가됐습니다. `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  
  
- [App Store](https://apps.apple.com/us/app/ssh-term-x/id6759213045)  
- [Google Play](https://play.google.com/store/apps/details?id=com.obuto.sshterm)  
  
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 실행까지 한 번에  
  
복수 명령어를 스텝으로 조합하는 것도 가능.  
  
##### 접속 시 / 재접속 시 자동 명령어 실행  
  
접속 프로필에 **접속 후 실행할 명령어**를 설정할 수 있습니다. 예를 들어:  
  
1. `wsl` → WSL 기동  
2. `cd ~/projects/my-app` → 작업 디렉토리로 이동  
3. `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 지원                                                   |  
  
#### 실제 사용 흐름  
  
1. 집의 Mini PC에 Claude Code를 상시 대기  
2. 외출 중 스마트폰으로 SSH 접속 (초기 명령어로 WSL → 작업 디렉토리 → tmux 접속까지 자동)  
3. 자연어로 "이 기능을 추가해줘"라고 지시  
4. Claude Code 처리 중에는 앱을 백그라운드로  
5. 잠시 후 돌아와서 결과 확인  
6. 파일 탐색기로 생성된 코드를 프리뷰, 필요하면 다운로드  
7. 문제없으면 다음 지시  
  
네트워크가 끊겨도 재접속 명령어로 자동 복귀. **지하철 안에서 자연어만으로 프로젝트가 진행됩니다.**  
  
---  
  
iOS / Android 모두 출시 완료:  
- [App Store](https://apps.apple.com/us/app/ssh-term-x/id6759213045)  
- [Google Play](https://play.google.com/store/apps/details?id=com.obuto.sshterm)  
  
피드백 환영합니다.

## Comments



_No public comments on this page._