Guide

시작하기

MTerm의 특징과 시작 방법 — 호스트 추가부터 터미널 기본 사용법까지

MTerm 시작하기

MTerm은 iPad와 iPhone을 위해 처음부터 설계된 SSH 클라이언트로, Claude Code, Cursor, Aider 같은 AI 터미널 도구를 사용하는 개발자를 위해 만들어졌어요. 다른 SSH 앱들이 모바일을 부차적으로 취급하는 반면, MTerm은 태블릿을 진정한 개발 머신으로 만들어줘요.

왜 MTerm인가요?

App Store에 SSH 클라이언트는 많이 있어요. MTerm이 특별한 이유를 소개할게요:

네이티브 화면 분할

tmux 없이도 화면을 최대 네 개의 터미널로 분할할 수 있어요. 각 Pane은 독립적인 세션을 실행하며, 터미널, 파일 에디터, 파일 브라우저, Prompt 패널을 자유롭게 조합할 수 있어요. 테두리를 드래그해서 크기를 조절하세요. 그냥 작동해요.

정확한 CJK 문자 렌더링

일본어, 중국어, 한국어 문자가 정확한 2셀 너비로 렌더링돼요. 사소해 보일 수 있지만, 이것을 잘못 처리하는 SSH 클라이언트를 써본 적이 있다면 — 커서가 어긋나고, 텍스트가 겹치고, 출력이 깨지는 문제를 알 거예요. MTerm은 렌더링 엔진을 이를 위해 완전히 다시 작성했기 때문에 정확하게 처리해요.

tmux Mouse Mode 통합

MTerm은 tmux의 Mouse Mode가 활성화되어 있는지 자동으로 감지하고 터치 제스처를 직접 전달해요 — 탭으로 Pane을 전환하고, 스크롤로 히스토리를 탐색할 수 있어요. 별도의 설정이 필요 없어요. set -g mouse on을 감지하고 알아서 처리해줘요.

Mosh 지원

불안정한 Wi-Fi가 있는 카페에서 작업하나요? 기지국을 오가는 기차에서? Mosh는 네트워크 변경 시에도 세션을 유지해줘요. MTerm은 Mosh 프로토콜을 네이티브로 구현하고 있어서, Wi-Fi에서 셀룰러로 전환해도 키 입력 하나 놓치지 않고 연결이 유지돼요.

내장 파일 브라우저 & 에디터

SFTP를 통해 원격 파일 시스템을 탐색하고, 이미지를 미리보기하고, 구문 강조가 된 코드를 편집할 수 있어요 — 모두 앱을 떠나지 않고요. 에디터는 VSCode Dark+ 색상 테마로 11개 언어를 지원해요.

IDE 모드

터미널, 파일 브라우저, 에디터를 하나의 화면에 결합할 수 있어요. 한 Pane에서 코드를 편집하고, 다른 Pane에서 실행하고, 세 번째 Pane에서 파일을 탐색하세요. AI가 아직 작업 중일 때 생성된 코드를 검토해야 하는 Claude Code 워크플로우에서 특히 강력해요.

Command Palette

Cmd+Shift+P를 누르면 모든 액션에 즉시 접근할 수 있어요 — Pane 분할, 설정 열기, 테마 변경, Focus Mode 전환 등. VS Code에 익숙하다면 바로 편하게 사용할 수 있을 거예요.

Webhook 알림

Claude Code가 작업을 완료하거나, CI/CD 파이프라인이 끝나거나, 서버가 알림을 보낼 때 트리거되는 푸시 알림을 설정하세요. 앱을 완전히 떠나도 뭔가 주의가 필요할 때 알림을 받을 수 있어요.

iCloud 동기화

호스트 구성, 연결 설정, 환경설정이 모든 기기에 자동으로 동기화돼요. iPad에서 호스트를 설정하면 iPhone에서도 바로 사용할 수 있어요.

SSH 호스트 추가하기

1단계: 호스트 생성

홈 화면에서 호스트 추가 버튼을 탭하세요. 연결 정보를 입력해주세요:

필드설명
Hostname서버의 IP 주소 또는 도메인 이름 (예: 192.168.1.100 또는 dev.example.com)
PortSSH 포트 번호. 서버가 다르게 설정되어 있지 않다면 거의 항상 22
Username원격 서버에서의 로그인 사용자 이름
인증 방법비밀번호 또는 SSH Key (Key 인증을 강력히 권장해요)

2단계: SSH Key 인증 설정

MTerm은 다음 Key 형식을 지원해요:

  • Ed25519 — 권장. 최신 방식이며 빠르고 안전해요. 새 Key를 생성한다면 이것을 사용하세요.
  • RSA PKCS#1 — -----BEGIN RSA PRIVATE KEY-----로 시작하는 전통적인 형식. 호환성이 넓어요.
  • RSA OpenSSH — -----BEGIN OPENSSH PRIVATE KEY-----로 시작하는 최신 OpenSSH 형식. 역시 완전히 지원돼요.

모든 개인 키는 기기의 하드웨어 보안으로 보호되는 iOS Keychain에 안전하게 저장돼요. 키는 절대 기기를 떠나지 않으며 iCloud 백업에 포함되지 않아요.

키를 가져오려면 직접 붙여넣거나, 파일에서 가져오거나, 클립보드를 사용할 수 있어요.

3단계: 고급 연결 옵션

MTerm은 더 복잡한 설정을 위한 여러 고급 구성을 지원해요:

  • Jump Host (Bastion 서버): 대상 머신에 직접 접근할 수 없을 때 중간 서버를 통해 연결해요. MTerm이 Jump Host를 통한 RSA-SHA256 인증을 포함한 멀티홉 SSH 체인을 처리해줘요.
  • Port Forwarding: 로컬 포트 포워드(원격 서비스를 로컬처럼 접근) 또는 리모트 포트 포워드(로컬 서비스를 원격 네트워크에 노출)를 설정할 수 있어요. 포워드는 호스트별로 저장되며 자동으로 재연결돼요.
  • 커스텀 아이콘: 각 호스트에 고유한 아이콘을 지정해서 프로덕션 서버, 스테이징 환경, 개발 머신을 한눈에 구별할 수 있어요.
  • iCloud 동기화: 호스트 구성이 모든 기기에 자동으로 공유돼요. iPad에서 호스트를 추가하고 iPhone에서 연결하세요.

터미널 기본 사용법

호스트를 탭하면 SSH 연결이 설정돼요. 연결되면 터미널 화면이 열리고 바로 작업을 시작할 수 있어요.

스크롤

터치와 트랙패드 스크롤 모두 완전히 지원돼요. 화면에서 한 손가락으로 스와이프하거나 Magic Keyboard 트랙패드에서 두 손가락을 사용하세요. 스크롤 버퍼는 최대 5,000줄의 히스토리를 저장해요 (기본값은 1,000줄이며 설정에서 변경 가능).

텍스트 복사

터미널 어디서든 길게 눌러 방사형 메뉴를 열 수 있어요 — 손가락에서 방사형으로 펼쳐지는 원형 컨텍스트 메뉴로, 복사, 붙여넣기, 전체 선택 등의 액션에 빠르게 접근할 수 있어요. 원하는 텍스트를 선택한 후 복사 액션을 탭하세요.

텍스트 붙여넣기

소프트 키 바의 붙여넣기 버튼, 방사형 메뉴, 또는 외장 키보드의 표준 Cmd+V 단축키를 사용하세요.

키보드

MTerm에는 화면 키보드 위에 수정자 키(Ctrl, Alt, Escape)와 방향키가 있는 커스터마이즈 가능한 소프트 키 바가 포함되어 있어요. Magic Keyboard 같은 외장 키보드를 연결하면 25개 이상의 키보드 단축키를 사용할 수 있어요. 전체 목록은 키보드 & 입력 가이드를 참조하세요.

다음 단계

이제 연결되었으니, MTerm을 최대한 활용하기 위해 다음 가이드를 살펴보세요:

Next
화면 분할 & 탭