moshterm

~ claude code

휴대전화에서 Claude Code 사용하기

휴대전화에서 Claude Code를 쓰려면 컴퓨터의 tmux에서 Claude Code를 실행하고, 같은 컴퓨터에 moshterm Companion을 설치한 뒤 iPhone, iPad, Android의 moshterm으로 연결하세요. 권한 요청이 실행하려는 명령과 함께 잠금 화면에 도착합니다. 승인하거나 거부할 수 있고, 세션을 채팅처럼 읽을 수도 있습니다. 모두 무료입니다.

App Store 출시 예정 Google Play에서 다운로드

무료, 계정 없음. moshterm Pro는 실시간 미리보기를 추가합니다.

설정

Claude Code를 실행하는 컴퓨터(macOS, Linux, WSL)에서:

# moshterm-hook 설치 후 실행curl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh
# ~/.claude/settings.json에 moshterm 훅 추가. 기존 훅은 그대로moshterm-hook install

평소처럼 tmux 세션 안에서 Claude Code를 시작합니다.

# 에이전트용 세션tmux new -s api
# 그 세션 안에서claude

이제 휴대전화에서 연결하면 됩니다. 첫 연결 때 앱이 Companion과 페어링하므로 복사할 것이 없습니다. Companion이 아직 없다면 앱이 설치를 제안합니다.

잠금 화면에서 승인

Claude Code가 권한을 요청하며 멈추면, Companion이 대상 명령이나 파일과 함께 그 요청을 휴대전화로 보냅니다. 거부는 알림에서 바로 할 수 있습니다. 승인할 때는 먼저 잠금 해제를 요구합니다.

답변은 Claude Code의 대화 상자에 직접 입력되지만, 그 전에 Companion이 tmux 창의 대화 상자가 내가 본 것과 같은지 확인합니다. 바뀌었다면 아무것도 입력하지 않고 휴대전화에 알려 줍니다. Claude Code가 tmux 창 안에 있지 않으면 요청에 터미널에서 답변이 표시되고 해당 세션으로 이동합니다.

채팅 화면과 Inbox

채팅 화면(Chat View)은 컴퓨터에 있는 Claude Code의 트랜스크립트를 읽어 세션을 대화로 보여 줍니다. 내 프롬프트, 답변, 한 줄로 접힌 도구 호출이 표시됩니다. 채팅 화면에서 보낸 프롬프트는 같은 창으로 갑니다. 닫으면 터미널은 그대로입니다.

Inbox는 페어링한 모든 컴퓨터의 Claude Code 세션을 응답 필요, 작업 중, 완료로 나눠 보여 줍니다. iPhone에서는 작업 중인 세션이 실시간 현황으로 잠금 화면에도 표시됩니다.

무엇이 어디서 실행되나요

Claude Code는 책상 앞에서 쓸 때와 똑같이 내 로그인으로 내 컴퓨터에서 실행됩니다. moshterm은 터미널과 알림을 맡습니다. 입력하고 보는 내용은 휴대전화와 컴퓨터 사이를 직접 오가며, moshterm 서버를 거치지 않습니다.

자주 묻는 질문

Claude Code의 권한 요청을 휴대전화에서 승인할 수 있나요?

네. moshterm Companion을 설치하고 Claude Code를 tmux 창에서 실행하면 모든 권한 요청이 휴대전화로 옵니다. 알림이나 Inbox에서 승인하거나 거부하면, Companion이 요청이 바뀌지 않았는지 확인한 뒤 Claude Code에 답을 입력합니다.

Claude Code가 휴대전화에서 실행되나요?

아니요. 평소처럼 내 컴퓨터에서 실행됩니다. moshterm은 Mosh, Eternal Terminal, SSH로 그 컴퓨터에 연결합니다.

무료인가요?

네. 승인, Inbox, 채팅 화면, 알림은 횟수 제한 없이 무료이며 계정도 필요 없습니다. moshterm Pro는 개발 서버와 시뮬레이터의 실시간 미리보기만 추가합니다.