휴대폰으로 쓰는 Claude Code, 내 서버에서 실행

휴대폰에서 Claude Code 상태만 확인하고 싶다면 Anthropic의 방법부터 시작하세요. iOS와 Android용 Claude 앱에는 Code 탭이 있습니다. 여기서 Anthropic 인프라에서 실행되는 클라우드 세션을 시작하거나, Remote Control로 내 컴퓨터의 세션을 조작할 수 있습니다. iPhone과 iPad에서 Claude Code를 쓰는 방법 가이드에서 모든 공식 방법을 홍보 없이 비교합니다.

Maude는 더 좁은 경우를 위한 앱입니다. VPS나 책상 아래의 머신처럼 내가 소유한 서버에서 Claude Code를 실행해, 노트북을 닫아도 작업이 계속되기를 원하는 경우입니다. 게다가 tmux에 터미널을 열어 두지 않고 휴대폰에서 조작하고 싶은 경우죠. Maude는 SSH로 모든 것을 배포하고, 각 세션을 서버에서 계속 실행하며, 그 위에 네이티브 앱을 제공합니다.

할 수 있는 것

• 받은함. 모든 서버의 오류, 검토 대기 중인 세션, 내 확인이 필요한 세션을 모아 보여 줍니다. 권한 요청은 채팅을 열지 않고 받은함에서 바로 답할 수 있습니다.
• 푸시로 승인. Claude가 명령을 실행하거나 파일을 편집하려 하면 알림에 허용과 거부 버튼이 붙어 옵니다. 알림 카테고리는 각각 켜고 끌 수 있습니다.
• 모든 권한 모드. 수동(Claude의 default), 편집 자동 승인, 계획, 자동, 바이패스를 입력창의 칩에서 전환합니다. Claude Code는 root에서 --dangerously-skip-permissions를 거부하므로, 바이패스에는 서버의 root가 아닌 사용자가 필요합니다. Maude에는 그 사용자를 만들어 주는 버튼이 있습니다.
• 모델과 추론 수준. 입력창 위의 칩에서 세션마다 모델과 추론 수준을 고릅니다.
• 꼭 필요한 슬래시 명령. 진행 상황을 실시간으로 보여 주는 /compact, /goal, /clear를 지원합니다. Claude가 묻는 질문(AskUserQuestion)과 계획 승인은 버튼이 있는 카드로 표시됩니다.
• 파일, git, 터미널. 각 세션에는 변경된 파일이 표시되는 파일 트리, hunk 단위로 넘겨 볼 수 있는 diff 검토, 커밋과 푸시, 브랜치, 그리고 서버에 gh가 설치되어 있으면 풀 리퀘스트가 있습니다. 진짜 터미널도 탭 하나 거리에 있습니다.
• 첨부 파일과 worktree. 휴대폰에서 사진과 파일을 보내고, 세션을 별도의 git worktree에서 시작해 병렬 작업이 서로 간섭하지 않게 할 수 있습니다.

한 서버에서든 여러 서버에 걸쳐서든 여러 세션을 동시에 실행할 수 있습니다. 휴대폰을 잠그거나 앱을 닫아도 계속 실행됩니다. 전체 설정 방법은 Claude Code VPS 가이드에, 에이전트를 계속 실행해 두는 이유는 코딩 에이전트 24시간 실행하기에 정리했습니다.

연결 방식

서버는 주소를 입력하거나, ssh … 명령을 붙여넣거나, curl -fsSL https://maude.pilotdev.fr/setup | sh가 출력하는 QR 코드를 스캔해 추가합니다. x86-64나 ARM의 모든 Linux 배포판 또는 macOS 머신에서, 비밀번호든 키든 사용할 수 있습니다. 그다음 설치는 앱이 알아서 합니다.

1. SSH로 작은 데몬을 배포합니다. 데몬은 고정된 자체 런타임을 다운로드합니다.
2. 저희가 검증한 버전의 Claude Code를 체크섬으로 확인해 설치하고, 데몬과 Claude Code를 모두 최신 상태로 유지합니다.
3. 데몬이 Maude 릴레이로 먼저 연결하므로 서버에 인바운드 포트를 열 필요가 없습니다. 그래서 NAT 뒤, 집의 LAN, tailnet에서도 작동합니다.

릴레이를 거치는 트래픽은 서버별 키로 종단 간 암호화되며, 릴레이는 암호문만 봅니다. SSH는 대체 수단으로 남아 배포와 복구에 사용됩니다. 코드와 트랜스크립트는 내 서버에 머뭅니다. 에이전트를 무인으로 실행할 때의 보안은 Claude Code를 전체 권한으로 안전하게 실행하기를 읽어 보세요.

Claude 요금제로 로그인

Maude는 모델 사용권을 재판매하지 않습니다. 이미 결제 중인 계정으로 휴대폰에서 Claude Code에 로그인합니다. 앱이 서버에서 claude auth login을 실행하고, 휴대폰 브라우저에서 승인하면 로그인이 서버에서 완료됩니다. Anthropic Console 계정이나 API 키도 사용할 수 있습니다.

Claude Code는 Anthropic의 Pro와 Max 요금제에 포함되며, Free 요금제에는 포함되지 않습니다. 작성 시점 기준으로 Pro는 월 $20(연간 결제 시 월 $17)이고 Max는 $100부터입니다. 최신 가격은 Anthropic 요금 페이지에서 확인하세요. Maude 구독은 앱에 대한 것입니다.

Android, iPhone, iPad에서 쓰는 Claude Code

Maude는 iPhone, iPad, Android용 네이티브 앱이며 세 플랫폼의 기능이 같습니다. 태블릿에서는 채팅 옆에 세션 목록이 있는 사이드바 레이아웃이 됩니다. Android에서는 권한 알림이 중요도 높은 채널로 오기 때문에, 승인 요청이 알림 창에 조용히 묻히지 않습니다. Claude 앱도 Android와 iPad에서 쓸 수 있으므로, 플랫폼만으로는 어느 한쪽을 고를 이유가 되지 않습니다. 결정적인 질문은 Claude Code를 어디에서 실행하고 싶은가입니다.

Maude vs Remote Control

Remote Control은 내 머신에서 실행 중인 세션에 접근하는 Anthropic의 공식 방법입니다. 여러 세션을 한 번에 다루는 서버 모드와 네이티브 푸시 알림이 있습니다. 둘의 차이는 다음과 같습니다.

머신을 켜 두고 터미널을 열어 두는 것이 괜찮다면, Remote Control은 추가 비용이 없고 Anthropic이 직접 제공하므로 합리적인 기본 선택입니다. 전체 비교는 Maude vs Claude Code Remote Control에 있습니다. 서버를 아예 운영하고 싶지 않다면 Maude vs Claude Code on the web을 읽어 보세요.

다른 에이전트에게 작업 넘기기

세션이 유휴 상태일 때 Codex, OpenCode, Grok Build, Antigravity로 전환할 수 있습니다. 새 에이전트는 계획, 수정한 파일, git 상태, 최근 대화, 마지막 지시를 담은 요약을 받습니다. 다시 전환하면 Claude Code가 자신의 세션을 이어 갑니다. 다른 의견이 필요하거나 사용량 한도에 도달했을 때 유용합니다. 작동 방식은 코딩 에이전트 간에 작업 넘기기에서 설명합니다.

자주 묻는 질문

변경 사항

• 2026년 10월 1일 — 페이지 게시. 요금제, Remote Control, 모바일 권한 모드 관련 내용을 이 날짜에 Anthropic 문서와 요금 페이지로 확인했습니다.