Continue local sessions from any device with Remote Control
핵심 포인트
- 1Remote Control은 사용자의 로컬 머신에서 실행되는 Claude Code 세션을 휴대폰, 태블릿 또는 다른 브라우저를 통해 원격으로 제어하여 작업을 이어서 할 수 있도록 돕는 기능입니다.
- 2이 기능은 `claude remote-control` 또는 `/remote-control` 명령어를 통해 세션을 시작한 후 제공되는 URL이나 QR 코드를 사용하여 다른 기기에서 연결할 수 있으며, Pro 또는 Max 요금제와 인증이 필요합니다.
- 3Remote Control은 로컬 파일 시스템, MCP 서버 및 도구를 원격으로 활용할 수 있게 하고, 모든 연결된 장치 간에 대화가 실시간으로 동기화되며, 연결이 끊겨도 자동으로 재연결되는 이점을 제공합니다.
Remote Control은 사용자가 로컬 Claude Code 세션을 phone, tablet, 또는 다른 browser 등 모든 장치에서 계속할 수 있도록 지원하는 기능입니다. 이는 claude.ai/code 또는 Claude mobile app을 통해 이루어지며, 작업 흐름의 유연성과 연속성을 제공합니다.
Remote Control의 핵심적인 작동 방식은 Claude Code 세션 자체가 사용자의 머신에서 로컬로 실행된다는 점입니다. 즉, 모든 컴퓨팅 작업과 데이터 처리는 로컬 환경에서 이루어지며, 어떠한 정보도 클라우드로 이동하지 않습니다. web 및 mobile interface는 단지 이 로컬 세션에 대한 "창(window)" 역할을 하여, 사용자 입력과 Claude Code의 출력을 로컬 세션과 원격 장치 간에 동기화합니다.
기술적으로, Remote Control 세션은 로컬 claude 프로세스가 Anthropic API에 대해 outbound HTTPS 요청만을 수행하며, 사용자 머신에 inbound port를 전혀 열지 않습니다. Remote Control이 시작되면, 로컬 프로세스는 Anthropic API에 등록하고 지속적으로 work를 polling합니다. 사용자가 다른 장치에서 연결할 때, Anthropic API는 streaming connection을 통해 web 또는 mobile client와 로컬 세션 간에 메시지를 라우팅하는 intermediary 역할을 합니다. 모든 traffic은 TLS를 통해 Anthropic API를 경유하여 전송되며, connection은 단일 목적에 국한되고 독립적으로 만료되는 여러 short-lived credentials를 사용하여 보안이 강화됩니다. 이로 인해 사용자의 filesystem, MCP servers, tools, 그리고 프로젝트 configuration과 같은 로컬 환경의 모든 요소가 원격으로도 완전히 활용 가능합니다.
Remote Control을 사용하기 위한 필수 조건은 Pro 또는 Max plan subscription이며, API key는 지원되지 않습니다. 또한, claude를 실행하여 /login을 통해 인증하고, project directory에서 최소 한 번 claude를 실행하여 workspace trust dialog를 수락해야 합니다.
새 Remote Control 세션은 project directory에서 claude remote-control 명령어를 실행하여 시작할 수 있으며, 이 명령어는 verbose 또는 sandbox 관련 flag를 지원합니다. 이미 진행 중인 Claude Code 세션을 원격으로 전환하려면 /remote-control 또는 /rc 명령어를 사용할 수 있습니다. 세션이 활성화되면, 터미널에 세션 URL이 표시되며, spacebar를 눌러 QR code를 확인할 수 있습니다. 원격 장치에서는 이 URL을 열거나 QR code를 스캔하거나 claude.ai/code 또는 Claude app에서 세션 목록을 통해 연결할 수 있습니다. Remote Control 세션은 온라인 상태일 때 컴퓨터 아이콘과 녹색 status dot으로 표시됩니다. 모든 세션에 대해 Remote Control을 자동으로 활성화하려면 /config에서 "Enable Remote Control for all sessions" 설정을 true로 변경할 수 있습니다.
Remote Control은 Claude Code on the web과 달리 세션이 사용자 머신에서 실행되어 low latency로 로컬 리소스에 접근하고 high throughput으로 데이터를 처리할 수 있다는 점에서 차이가 있습니다. Claude Code on the web은 Anthropic-managed cloud infrastructure에서 실행됩니다.
제한 사항으로는 한 번에 하나의 원격 세션만 지원하며, terminal이 계속 열려 있어야 하고 claude 프로세스가 중단되면 세션이 종료됩니다. 또한, 머신이 깨어 있지만 약 10분 이상 네트워크에 연결할 수 없는 경우 세션이 timeout되어 프로세스가 종료될 수 있습니다.
관련 리소스로는 Claude Code on the web, Authentication, CLI reference, Security, Data usage 등이 있습니다.