Claude Code 상세 사용법 22: Remote Control로 모바일에서 이어받기 | DAKER 커뮤니티

Claude Code 상세 사용법 22: Remote Control로 모바일에서 이어받기

Claude Code 공식 Remote Control 문서는 로컬에서 실행 중인 세션을 Claude 웹 코드 화면이나 Claude 모바일 앱으로 이어받는 research preview 기능으로 설명한다. 중요한 점은 실행 위치다. 세션은 내 컴퓨터에서 계속 돌고, 웹/모바일은 그 세션을 조작하는 창이 된다.

1. 요구 조건을 먼저 확인한다

공식 문서 기준 Remote Control은 Claude Code 2.1.51 이상이 필요하고 Pro, Max, Team, Enterprise 플랜에서 사용할 수 있다. Team과 Enterprise에서는 관리자가 기능을 켜야 한다. API key 인증은 지원하지 않으므로 Claude 계정 로그인 상태를 확인한다.

claude --version
claude auth login

프로젝트에서 처음 실행한다면 workspace trust 대화도 한 번 수락해야 한다. 원격에서 @로 파일을 부를 때도 로컬 프로젝트의 파일 경로가 기준이 된다.

2. 세 가지 시작 방식을 구분한다

4. 운영 실패 모드

터미널을 닫거나 노트북이 오래 네트워크를 잃으면 원격 세션은 끊긴다. Team/Enterprise에서 “disabled by policy”가 나오면 /status로 로그인 방식과 조직 정책을 확인한다. ANTHROPIC_API_KEY만 설정된 환경, Bedrock/Vertex/Foundry 경로, 제한된 OAuth 토큰은 Remote Control에 맞지 않는다. 모바일 알림은 Claude 앱 설치, 같은 계정 로그인, OS 알림 허용, /config의 push 설정이 맞아야 온다.

Senior takeaway: Remote Control은 “클라우드로 작업을 올리는 기능”이 아니라 로컬 개발 세션을 다른 화면에서 계속 다루는 기능이다. 긴 테스트를 돌려두고 이동하거나, 권한 질문이 오면 모바일에서 답하거나, 로컬 MCP가 필요한 agentic coding 작업을 놓치지 않는 데 개발 생산성 효과가 크다.

상시 대기 서버를 열려면 저장소 루트에서 실행한다.

claude remote-control --name "daker-web"

터미널 대화도 계속 쓰면서 웹/모바일 연결을 열려면 다음이 더 자연스럽다.

claude --remote-control "frontend-fix"

이미 작업 중인 대화를 이동 중에 이어받으려면 세션 안에서 실행한다.

/remote-control

서버 모드의 --spawn worktree는 원격에서 새 세션을 만들 때 git worktree를 나눠 충돌을 줄인다. 반대로 same-dir은 빠르지만 같은 파일을 여러 세션이 만질 수 있으니 작은 작업에만 쓴다.

3. 웹 세션과 혼동하지 않는다

Claude Code on the web은 Anthropic 클라우드 환경에서 실행된다. Remote Control은 로컬 프로세스가 계속 살아 있어야 하고, 로컬 MCP 서버, 파일시스템, 프로젝트 설정을 그대로 쓴다. 로컬 도구와 비밀값 접근이 필요한 작업은 Remote Control, 로컬 클론 없이 시작하는 위임 작업은 웹 세션이 맞다.