문서 · 가이드
시작하기
Moshpit은 SSH로 접속하는 워크스테이션이나 서버에서 Claude Code, Codex, Gemini CLI 같은 코딩 에이전트를 운영하는 개발자를 위한 iPhone 및 iPad(iOS 18 이상)용 SSH·Mosh 터미널입니다. tmux와 herdr 패널을 네이티브로 렌더링하고, 모든 호스트에서 응답을 기다리는 에이전트를 맨 위에 모아 보여 주며, 에이전트가 질문하면 종단간 암호화 푸시를 잠금 화면으로 보냅니다. Moshpit 자체는 에이전트를 호스팅하거나 실행하지 않습니다.
1. Moshpit 설치
Section titled “1. Moshpit 설치”App Store에서 설치하거나(일회성 구매, 구독 및 계정 없음), github.com/Cluas/moshpit에서 소스 코드로 직접 빌드하세요.
2. 호스트 추가
Section titled “2. 호스트 추가”- 홈 화면에서 연결 추가를 탭합니다.
- 호스트에 서버 주소(예:
dev.example.com또는192.0.2.10), 사용자 이름에 로그인 계정(예:dev)을 입력하세요. SSH 포트가 다르지 않다면 포트는22그대로 둡니다. - 인증 방식에서 암호, SSH 키, PEM 붙여넣기 중 하나를 선택하세요.
- SSH 키를 선택하면 휴대폰에서 새 키를 생성하거나 가져온 키를 고를 수 있습니다. 공개 키를 복사해 호스트의
~/.ssh/authorized_keys에 추가하세요. - 암호 또는 PEM 붙여넣기를 선택하면 바로 로그인할 수 있습니다.
- SSH 키를 선택하면 휴대폰에서 새 키를 생성하거나 가져온 키를 고를 수 있습니다. 공개 키를 복사해 호스트의
- 멀티플렉서에서 해당 호스트에서 사용하는 tmux 또는 herdr를 고르거나, 일반 셸이라면 없음을 선택하세요. 호스트에
mosh-server가 설치되어 있다면 Mosh 사용을 켜세요. - 저장을 탭합니다.
3. 세션 열기
Section titled “3. 세션 열기”- 홈 화면에서 방금 추가한 호스트 카드를 탭합니다.
- 첫 연결 시 Moshpit이 서버의 SHA256 지문과 함께 새 호스트 창을 띄웁니다. 서버의 지문과 일치하는지 확인한 뒤 신뢰를 탭하세요.
- tmux 또는 herdr를 선택했다면 기존 세션이나 작업 공간을 고르거나 새 세션(또는 새 작업 공간)을 탭하세요. Moshpit은 사용자 모르게 세션을 생성하지 않습니다.
- 에이전트 상태와 푸시 알림을 위해 호스트를 설정할지 묻는 창이 뜨면 확인을 눌러 스크립트를 설치하거나, 건너뛴 뒤 나중에 설정의 호스트 설정에서 진행할 수 있습니다.