하가 (SSH Term)님의 프로필

앱을 닫아도 에이전트가 계속 도는 SSH 앱을 만들고 있습니다

안녕하세요. 일본에서 SSH Term이라는 SSH 앱을 혼자 만들고 있습니다.

처음에는 안드로이드 SSH 앱에서 일본어 입력이 안 돼서 만든 앱이었는데, 한국에서도 꾸준히 써 주시는 분들이 있어서 한글 쪽도 계속 손보고 있습니다. 이번 메이커로그에서는 최근에 크게 바뀐 것과, 만들면서 고민한 것을 정리해 봅니다.

한 줄 소개

휴대폰에서 Claude Code, Codex, Oh My Pi 같은 코딩 에이전트를 SSH로 다루는 터미널입니다. 한글이 깨지지 않고, 구독 없이 1회 구매입니다.

이번에 바뀐 것

1. 앱을 닫아도 에이전트가 계속 실행

연결 설정에서 「호스트에서 셸 유지」를 켜면, 터미널 탭의 셸이 SSH 연결이 아니라 호스트에 남습니다. 지하철에서 지시를 던지고 앱을 닫아도, 화면을 꺼도, 에이전트는 호스트에서 계속 일합니다. tmux를 따로 쓰지 않아도 됩니다.

2. Mosh 없이도 끊기지 않음

Wi-Fi와 모바일 데이터가 바뀌거나 터널에서 연결이 끊겨도 셸은 호스트에 그대로 있습니다. 다시 연결되면 탭이 자동으로 다시 붙고, 그 사이에 놓친 출력까지 이어서 보여 줍니다.

3. 에이전트 목록과 알림

저장한 호스트에서 돌고 있는 agent를 작업 중 · 입력 대기 · 승인 필요 상태로 한눈에 봅니다
호스트를 한 번 준비해 두면, PC 터미널에서 평소대로 시작한 claude · codex · omp도 휴대폰에서 이어서 볼 수 있습니다
앱을 닫아 두어도 승인 대기 · 입력 대기 · 턴 완료를 ntfy 앱으로 알려 줍니다

4. 한국어 쪽

입력 모드의 이름을 한국어 환경에서는 「한글 입력 모드」로 바꿨습니다
한국어 글꼴을 Noto Sans KR, Nanum Gothic Coding, IBM Plex Sans KR 중에서 고를 수 있습니다

만들면서 고민한 것: 왜 Mosh도 tmux도 아닌가

휴대폰으로 서버에 붙어 있으면 끊기는 게 일상입니다. 보통은 Mosh나 tmux로 해결합니다. 둘 다 좋은 도구지만, 휴대폰에서 에이전트를 다루는 용도로는 걸리는 점이 있었습니다.

Mosh는 서버에 Mosh를 설치하고 UDP 포트를 열어야 합니다. 회사 서버나 클라우드의 방화벽에서는 이게 어려운 경우가 많습니다
tmux는 확실하지만, 휴대폰에서 매번 Ctrl+B D로 떼고 다시 붙이는 습관이 필요합니다. 잊고 앱을 닫으면 그만입니다

그래서 호스트에 stagent라는 작은 도우미 프로그램을 두는 쪽을 택했습니다.

처음 쓸 때 앱이 GitHub 공개 릴리스에서 내려받고, 앱에 고정된 sha256과 대조한 뒤 ~/.ssh-term/agent에 설치합니다
서버에 Mosh를 설치하거나 UDP 포트를 열 필요가 없습니다. 평소의 SSH 연결 하나로 됩니다
Linux / macOS / Windows 호스트에서 동작합니다 (Windows는 기본 셸이 cmd 또는 PowerShell일 때)
필요 없어지면 앱에서 서버의 stagent를 지울 수 있습니다

한글 이야기

Claude Code에서 한글이 깨지는 원인을 따라가 보니, 터미널에는 "조합 중"이라는 상태가 없고 조합은 전부 클라이언트 몫이라는 게 핵심이었습니다. 그래서 SSH Term은 조합이 끝난 글자만 서버에 보냅니다. 긴 지시는 한글 입력 모드에서 다 쓰고 한 번에 보낼 수 있습니다.

자세한 원인과 내 환경을 확인하는 방법은 velog에 정리했습니다 → https://velog.io/@hagakun/claude-code-hangul-ime

피드백을 받고 있습니다

특히 이 두 가지를 알려 주시면 큰 도움이 됩니다.

한글이 깨지는 키보드나 환경 (키보드 앱 이름, 접속하는 서버 OS)
Mosh가 꼭 필요한 이유 — 위 방식으로는 안 되는 환경이 있다면 다음에 무엇을 만들지 정할 때 참고합니다

링크

구독 없음 · 계정 불필요 · 텔레메트리 없음. 1회 구매입니다.

하가 (SSH Term)님의 포스트