📱

Remote Control — 모바일에서 Claude Code

Claude Code

claude remote-control로 스마트폰/브라우저에서 접속

Claude Code에는 remote-control 기능이 내장되어 있어, 로컬 PC에서 실행 중인 세션을 스마트폰이나 다른 기기의 브라우저에서 그대로 이어서 사용할 수 있습니다. SSH 터널링이나 별도 서버 설정 없이, QR코드 스캔 또는 claude.ai/code 접속만으로 연결됩니다.

방법 1: Remote Control (공식 내장 기능)

Claude Code v2.1.51+에 내장된 기능으로, SSH 설정 없이 모바일에서 바로 접속할 수 있습니다.

기존 세션을 모바일에서 이어하기 (가장 실용적!)

이미 대화 중인 Claude Code 세션 안에서 /remote-control을 입력하면, 현재 대화 이력이 그대로 유지된 채 모바일에서 접속할 수 있습니다.

/remote-control

→ QR코드가 표시됨 → 스마트폰 Claude 앱으로 스캔 → 같은 세션을 모바일에서 계속

새 세션으로 시작할 경우 (터미널에서):

claude remote-control claude remote-control --name "My Project"

새 세션 vs 기존 세션

명령어	동작
`/remote-control`	기존 세션 유지 — 대화 이력 보존, 가장 실용적
`claude remote-control`	새 세션 생성 (서버 모드)
`claude --remote-control`	새 세션 + 로컬 입력도 가능

접속 방법

1
QR코드 스캔 — 스페이스바를 누르면 QR코드가 표시됨 → Claude 모바일 앱으로 스캔
2
claude.ai/code — 브라우저에서 접속하여 세션 이름으로 연결
3
Claude 모바일 앱 — 세션 목록에서 자동으로 표시됨

핵심 장점

✓
SSH 불필요 — 포트 개방이나 키 설정 없이 HTTPS로 연결
✓
로컬 환경 유지 — MCP 서버, 프로젝트 파일, 커스텀 도구 모두 사용 가능
✓
멀티 디바이스 — 터미널, 브라우저, 스마트폰에서 동시에 메시지 전송 가능
✓
자동 재연결 — 네트워크가 끊겨도 자동으로 재연결

서버 모드 옵션

claude remote-control \
  --name "My Project" \
  --spawn worktree \
  --capacity 32 \
  --verbose

--name 세션 이름 지정
--spawn worktree Git worktree로 격리 실행
--capacity N 최대 동시 세션 수 (기본 32)

요구 사항 및 주의사항

⚠ Claude Code v2.1.51 이상 필요 (claude --version으로 확인)
⚠ Pro, Max, Team, Enterprise 구독 필요
⚠ 로컬 터미널을 닫으면 세션 종료됨 — 터미널은 열어두어야 함
⚠ 네트워크 끊김 약 10분 후 세션 타임아웃

방법 2: SSH 직접 접속 (대안)

Remote Control을 사용할 수 없는 환경이라면 SSH로 직접 접속하는 방법도 있습니다.

플랫폼	추천 앱	특징
Android	Termux	풀 리눅스 환경, F-Droid에서 설치 권장
iOS	Blink Shell	Mosh 지원, 키보드 커스터마이징 (유료)
iOS	Termius	멀티 디바이스 동기화, 깔끔한 UI

ssh user@서버IP tmux new -s work && claude

tmux 사용 시 연결이 끊겨도 tmux attach -t work로 복원 가능

비교: Remote Control vs SSH

항목	Remote Control	SSH
설정 난이도	매우 쉬움 (명령어 1개)	SSH 키 설정 필요
모바일 앱	Claude 공식 앱	Termux, Blink 등
코드 실행 위치	로컬 PC	원격 서버
PC 전원	켜져 있어야 함	서버만 켜져 있으면 됨

사용 방법

1

기존 세션에서 /remote-control 입력 → 대화 이력 유지한 채 모바일에서 접속 가능

2

새 세션: 터미널에서 claude remote-control 실행

3

QR코드를 Claude 모바일 앱으로 스캔하거나, claude.ai/code에서 세션 이름으로 접속

4

로컬 PC의 MCP 서버, 파일, 도구 모두 그대로 사용 가능

Source

Anthropic Docs