Claude Code Remote Control

4 weeks ago 10

로컬 개발 세션을 다른 기기에서 이어서 사용할 수 있는 기능으로, Claude Code가 실행 중인 컴퓨터에 원격으로 접속해 작업을 지속할 수 있음
claude.ai/code 웹 인터페이스나 Claude 모바일 앱(iOS·Android) 을 통해 접속하며, 로컬 환경이 그대로 유지되어 파일시스템·도구·프로젝트 설정을 그대로 활용 가능
Pro 및 Max 요금제 사용자에게 연구 미리보기 형태로 제공되며, Team·Enterprise 요금제에서는 지원되지 않음
모든 통신은 Anthropic API를 통한 TLS 암호화 연결로 이루어지며, 세션은 로컬에서 실행되어 클라우드로 데이터가 이동하지 않음
로컬 개발 환경을 유지하면서도 기기 간 연속 작업이 가능한 구조로, 원격 협업과 이동 중 개발 효율을 높이는 기능임

Remote Control 개요

Remote Control은 로컬 Claude Code 세션을 다른 기기에서 이어서 사용할 수 있게 하는 기능
- 휴대폰, 태블릿, 다른 브라우저 등에서 동일한 세션을 이어서 작업 가능
- claude.ai/code 또는 Claude 모바일 앱을 통해 접속 지원
Pro·Max 요금제 사용자만 이용 가능, Team·Enterprise 요금제에서는 제공되지 않음
세션은 로컬에서 계속 실행되며, 클라우드로 전송되지 않음
주요 기능
- 로컬 환경 원격 사용: 파일시스템, MCP 서버, 도구, 프로젝트 설정 유지
- 기기 간 동기화: 터미널·브라우저·모바일 간 대화 동기화
- 자동 재연결: 네트워크 끊김이나 절전 후 자동 복구

요구사항 (Requirements)

Pro 또는 Max 구독 플랜 필요, API 키는 지원되지 않음
claude 명령어 실행 후 /login으로 claude.ai 인증 필요
프로젝트 디렉터리에서 claude를 한 번 실행해 워크스페이스 신뢰 설정 수락 필요

Remote Control 세션 시작

새 세션 생성 또는 기존 세션을 원격으로 연결 가능
프로젝트 디렉터리에서 다음 명령 실행 claude remote-control
- 터미널에서 세션 URL 표시, 스페이스바로 QR 코드 표시 가능
- --verbose, --sandbox, --no-sandbox 플래그 지원
기존 Claude Code 세션에서 /remote-control 또는 /rc 명령으로 원격 제어 시작 가능
- 현재 대화 기록을 유지하며 세션 URL과 QR 코드 제공
- /rename 명령으로 세션 이름 지정 가능

다른 기기에서 연결

세션 URL을 브라우저에서 열기 또는 QR 코드 스캔으로 접속
claude.ai/code나 Claude 앱에서 세션 목록을 통해 접속 가능
- 온라인 상태일 경우 컴퓨터 아이콘과 녹색 점 표시
세션 이름은 마지막 메시지, /rename 값, 또는 기본 “Remote Control session”으로 표시
/mobile 명령으로 iOS·Android 앱 다운로드 QR 코드 표시 가능

모든 세션에 Remote Control 활성화

/config 명령에서 Enable Remote Control for all sessions 옵션을 true로 설정
각 Claude Code 인스턴스는 한 번에 하나의 원격 세션만 지원

연결 및 보안

로컬 세션은 아웃바운드 HTTPS 요청만 수행, 인바운드 포트는 열리지 않음
Remote Control 시작 시 Anthropic API에 등록 후 작업을 폴링
다른 기기에서 연결 시, 서버가 메시지를 스트리밍 방식으로 중계
모든 트래픽은 TLS 암호화를 사용하며, 단기 자격 증명으로 세분화된 접근 제어 수행

Claude Code on the web과의 차이

두 기능 모두 claude.ai/code 인터페이스를 사용하지만,
- Remote Control은 로컬 머신에서 실행되어 MCP 서버·도구·설정 사용 가능
- Claude Code on the web은 Anthropic 클라우드 인프라에서 실행
로컬 작업을 이어가려면 Remote Control,
클론되지 않은 저장소나 병렬 작업에는 Claude Code on the web 사용

제한 사항

한 번에 하나의 원격 세션만 지원
터미널이 열려 있어야 함, claude 프로세스 종료 시 세션 종료
10분 이상 네트워크 불가 상태 시 세션 타임아웃 후 종료

관련 자료

[Claude Code on the web] – 클라우드 기반 세션 실행
[Authentication] – /login 설정 및 인증 관리
[CLI reference] – claude remote-control 명령 전체 목록
[Security] – Remote Control 보안 모델 설명
[Data usage] – Anthropic API를 통한 데이터 흐름 설명

Read Entire Article