Claude Code Remote Control

무엇이 바뀌었나?

Claude Code에 Remote Control 기능이 추가되었습니다. 로컬 머신에서 실행 중인 Claude Code 세션을 claude.ai/code 또는 Claude 모바일 앱(iOS/Android)에서 이어서 사용할 수 있습니다.

핵심은 세션이 로컬에서 계속 실행된다는 점입니다. 파일 시스템, MCP 서버, 프로젝트 설정이 그대로 유지되며, 웹/모바일은 그 세션의 원격 창 역할을 합니다.

어떻게 사용하나?

서버 모드 (전용)

claude remote-control

터미널이 서버 모드로 대기하며, 세션 URL과 QR 코드가 표시됩니다.

인터랙티브 세션 + 원격

claude --remote-control

터미널에서 직접 입력하면서 동시에 원격으로도 제어할 수 있습니다.

진행 중인 세션에서 활성화

Claude Code 세션 내에서 슬래시 명령으로 활성화:

/remote-control

현재 대화 이력을 유지한 채 원격 접속 URL이 생성됩니다.

주요 특징

• 로컬 환경 그대로 사용 — 파일 시스템, MCP 서버, 도구, 프로젝트 설정이 모두 유지
• 양방향 동기화 — 터미널, 브라우저, 모바일에서 번갈아가며 메시지 전송 가능
• 자동 재연결 — 노트북이 절전 모드에 들어가거나 네트워크가 끊겨도 복구 시 자동 재연결
• 보안 — 아웃바운드 HTTPS 요청만 사용, 인바운드 포트를 열지 않음. 모든 트래픽은 TLS로 암호화

Claude Code on the web과의 차이

	Remote Control	Claude Code on the web
실행 위치	내 로컬 머신	Anthropic 클라우드
로컬 환경	MCP, 도구, 프로젝트 설정 사용 가능	사용 불가
적합한 상황	진행 중인 로컬 작업을 다른 기기에서 이어갈 때	로컬 설정 없이 바로 시작하거나 병렬 작업할 때

알아두면 좋은 점

• Claude Code v2.1.51 이상 필요
• Pro, Max, Team, Enterprise 플랜에서 사용 가능 (API 키는 미지원)
• Team/Enterprise에서는 관리자가 먼저 Remote Control 토글을 활성화해야 함
• 터미널을 닫으면 세션이 종료됨 (로컬 프로세스 기반)
• 네트워크가 약 10분 이상 끊기면 세션 타임아웃