Skip to main content

Remote Control

컴퓨터에서 시작한 Claude Code 세션을 스마트폰이나 태블릿에서 그대로 이어서 작업할 수 있습니다. 코드 실행은 여전히 로컬 머신에서 이루어지고, 모바일은 그 세션의 "리모컨" 역할만 합니다.

작동 원리​

[로컬 PC]                    [Anthropic 릴레이]              [모바일/브라우저]
  Claude Code  ──HTTPS──▶  api.anthropic.com  ◀──HTTPS──  claude.ai/code
  (코드 실행)               (메시지 중계)                    (입력/표시)

핵심 포인트:

  • 로컬 실행: 파일, MCP 서버, SSH 키, 프로젝트 설정 모두 내 컴퓨터에 유지
  • 아웃바운드 전용: 인바운드 포트를 열지 않음 (VPN/포트포워딩 불필요)
  • TLS 암호화: 모든 통신은 HTTPS/TLS로 보호
  • 자동 재연결: 노트북이 잠자기/깨어나도 세션 유지

사용 방법​

방법 1: 새 세션 시작​

# Remote Control 전용 세션 시작
claude remote-control

터미널에 세션 URL과 QR 코드(스페이스바로 토글)가 표시됩니다.

# 상세 로그 보기
claude remote-control --verbose

# 샌드박스 모드 (파일시스템/네트워크 격리)
claude remote-control --sandbox

방법 2: 기존 세션에서 전환​

이미 Claude Code를 사용 중이라면:

> /remote-control
# 또는 줄여서
> /rc
# 또는 모바일에 최적화된
> /mobile

기존 대화 기록이 그대로 유지된 채 Remote Control이 활성화됩니다. /mobile은 /rc와 동일하지만, 모바일 친화적인 UI를 제공합니다.

세션 이름 지정

/rc 전에 /rename 결제모듈-리팩토링으로 이름을 지정하면 모바일에서 세션을 찾기 쉽습니다. 세션 이름은 영문·숫자·하이픈만 사용하세요 — 특수문자는 URL 인코딩 문제를 일으킬 수 있습니다.

방법 3: 모든 세션에 자동 활성화​

> /config
# → "Enable Remote Control for all sessions" → true

모바일에서 접속​

  1. QR 코드 스캔: 터미널의 QR 코드를 스마트폰 카메라로 스캔
  2. URL 직접 접속: 표시된 세션 URL을 브라우저에서 열기
  3. Claude 앱: claude.ai/code 또는 Claude 모바일 앱에서 세션 목록 확인 (초록색 점 = 온라인)
Workspace Trust 필요

Remote Control을 처음 활성화하면 해당 프로젝트 디렉토리에 대한 Workspace Trust 확인이 필요할 수 있습니다. 신뢰할 수 있는 프로젝트에서만 활성화하세요.

사용 시나리오​

대규모 작업 모니터링​

# 터미널에서 큰 작업 시작
claude remote-control
> 전체 API 엔드포인트에 에러 핸들링 추가하고 테스트 작성해줘

이후 자리를 비워도 스마트폰에서 진행 상황을 확인하고, 추가 지시를 내릴 수 있습니다.

듀얼 디바이스 작업​

터미널과 모바일 양쪽에서 번갈아 입력할 수 있습니다. 대화가 실시간으로 동기화됩니다.

MCP 서버 원격 활용​

Remote Control은 로컬 MCP 서버에 접근할 수 있습니다. 웹 기반 Claude Code(클라우드 VM)와의 핵심 차이점입니다:

Remote ControlClaude Code on the Web
코드 실행 위치내 컴퓨터Anthropic 클라우드 VM
로컬 MCP 서버사용 가능사용 불가
로컬 파일/설정접근 가능접근 불가
병렬 작업CLI 인스턴스당 1개여러 개 동시 가능

보안 고려사항​

안전한 설계​

  • 인바운드 포트를 열지 않으므로 네트워크 공격 표면 최소화
  • 짧은 수명의 스코프 제한 인증 토큰 사용 (세션/릴레이/인증 각각 분리)
  • --dangerously-skip-permissions 플래그 사용 불가 — 모든 액션에 수동 승인 필요

주의할 점​

세션 URL 보안

세션 URL은 Bearer 토큰 역할을 합니다. URL을 아는 사람은 누구나 세션에 접속할 수 있으므로:

  • Slack/메신저에 URL을 공유하지 마세요
  • 화면 공유 시 URL이 노출되지 않도록 주의하세요
  • QR 코드를 어깨 너머로 촬영당하지 않도록 조심하세요

제한사항​

제한설명
동시 연결 1개CLI 인스턴스당 하나의 원격 연결만 지원
터미널 유지 필수로컬 터미널을 닫으면 세션 종료
네트워크 타임아웃~10분간 네트워크 연결 불가 시 세션 종료
인증 방식claude.ai 로그인 필수 (API 키 인증 미지원)

이용 가능 플랜​

플랜상태
Max사용 가능 (리서치 프리뷰)
Pro곧 지원 예정
Team / Enterprise미지원
네트워크 끊김 대응

노트북이 잠자기에 들어가거나 네트워크가 잠시 끊어져도 자동으로 재연결됩니다. 만약 세션이 타임아웃되었다면 claude remote-control --resume으로 대화를 이어서 재시작할 수 있습니다.

다음 챕터: Claude Code on the Web →

Last updated on