Claude Code Remote Control(클로드 코드 리모트 컨트롤)

한 줄 정의

Claude Code Remote Control은 Claude Code를 켜 둔 머신은 그대로 두고, claude.ai/code나 Claude 모바일 앱에서 같은 세션을 이어서 조작하게 해 주는 원격 제어 기능이야. 새 Claude 모델이 아니라, 로컬 CLI 세션을 웹과 모바일 화면에 연결하는 사용 방식으로 보는 게 맞아. 공식 문서 기준 현재 상태는 research preview라서, 팀 운영 규칙에 넣을 때는 변경 가능성도 같이 봐야 해.

핵심은 실행 위치야. Claude Code on the web은 Anthropic 쪽 클라우드 인프라에서 세션을 실행하지만, 이 기능은 사용자의 머신에서 돌아가는 프로세스를 원격 화면으로 조작해. 그래서 로컬 파일시스템, MCP 서버, 프로젝트 설정, 설치된 도구가 그대로 의미를 갖는다.

실제로 무엇을 하나

시작 경로는 세 가지야.

• claude remote-control: 새 서버를 띄우고 원격 연결을 기다린다. 로컬 터미널에서 대화하는 세션은 열리지 않아.
• claude --remote-control 또는 claude --rc: 기존처럼 터미널에서 대화하면서 웹이나 모바일에서도 같은 세션을 조작한다.
• /remote-control 또는 /rc: 이미 Claude Code 안에 들어와 있을 때 현재 대화 기록을 이어서 원격 세션을 만든다. VS Code 확장에서도 /remote-control 명령을 쓴다.

서버 모드는 한 프로세스가 여러 원격 세션을 받을 때 쓴다. 기본 --capacity는 동시에 열 수 있는 세션 32개이고, --spawn 기본값은 same-dir이야. 이 기본값은 요청이 들어올 때 만들어지는 모든 세션이 같은 작업 디렉터리를 공유한다는 뜻이라, 같은 파일을 여러 세션에서 고치면 충돌이 날 수 있어. git 저장소라면 --spawn worktree로 각 세션을 별도 worktree에 만들 수 있고, 한 세션만 받을 때는 --spawn session을 쓴다.

연결은 URL, QR 코드, 세션 목록으로 들어간다. claude remote-control은 터미널에 세션 URL을 보여 주고, 스페이스바로 QR 코드를 띄울 수 있어. 다른 브라우저에서 URL을 열거나 Claude 앱의 Code 화면에서 세션을 고르면, 터미널·브라우저·모바일에서 같은 대화가 동기화된다.

왜 중요한가

이 기능이 중요한 이유는 “자리 비우기”와 “로컬 권한 유지”를 같이 다루기 때문이야. 긴 테스트, 리팩터링, 로그 분석처럼 몇 분씩 걸리는 작업을 시켜 놓고 노트북 앞에 붙어 있지 않아도 된다. 그런데 작업은 여전히 로컬 머신에서 돈다. 사내 저장소, 로컬 MCP 서버, 셸 도구, 프로젝트별 설정이 필요한 개발 흐름에서는 이 차이가 꽤 커.

모바일 푸시도 이 흐름에 붙는다. 공식 문서 기준 모바일 푸시는 Claude Code v2.1.110 이상이 필요하고, Claude가 긴 작업을 끝냈거나 사람 결정이 필요하다고 판단할 때 보낼 수 있어. 프롬프트에 notify me when the tests finish처럼 요청할 수도 있지만, 이벤트별 세밀한 규칙을 사용자가 직접 짜는 방식은 아니야.

보안 판단도 여기서 갈려. 원격 제어 연결은 사용자 머신에 들어오는 포트를 열지 않고, 바깥으로 나가는 HTTPS 요청으로 Anthropic API에 붙는다. 연결에는 짧은 수명의 인증값이 쓰이고, data usage 문서는 이 세션이 로컬 Claude Code와 같은 데이터 흐름을 따른다고 설명해. 동시에 프롬프트와 모델 출력은 네트워크로 나가며 TLS 1.2+로 전송된다. “코드 실행은 로컬”과 “Anthropic API 연결은 필요”를 같이 봐야 헷갈리지 않아.

주의해서 볼 점

• 인증 조건이 API key와 달라. 이 기능은 claude.ai 계정으로 로그인한 OAuth 흐름을 요구하고, API key나 Console account 인증만으로는 동작하지 않아. Bedrock, Vertex AI, Foundry 같은 제3자 제공자 경로로 Claude 모델을 쓰는 것과 원격 제어를 여는 것은 다른 문제야.
• 조직 정책이 실제 사용 가능 여부를 가른다. Pro와 Max 같은 개인 플랜에서는 계정 조건을 보면 되지만, Team과 Enterprise에서는 관리자가 Claude Code admin settings에서 전용 설정을 켜야 해. 조직의 보존 정책이나 컴플라이언스 설정이 맞지 않으면 설정이 막힐 수 있고, 관리 설정의 disableRemoteControl 정책도 별도로 걸릴 수 있어.
• 로컬 프로세스가 계속 살아 있어야 한다. 터미널을 닫거나 VS Code를 종료하면 세션도 끝난다. 머신이 잠깐 잠들거나 네트워크가 끊기면 돌아온 뒤 재연결될 수 있지만, 머신이 깨어 있는데 네트워크가 약 10분 넘게 닿지 않으면 세션이 만료될 수 있어.
• 모든 CLI 명령이 원격 화면에서 똑같이 동작하는 건 아니야. /compact, /clear, /context, /usage처럼 텍스트로 끝나는 명령은 웹·모바일에서도 쓸 수 있지만, /mcp, /plugin, /resume처럼 로컬 터미널의 선택 화면을 여는 명령은 로컬 전용으로 남는다. 원격 제어라고 해서 로컬 터미널을 완전히 대체한다고 보면 금방 답답해져.

언제 쓰나 / 언제 보류하나

이 원격 제어 방식은 이미 로컬 Claude Code 작업 흐름이 있고, 긴 작업 중간에 휴대폰이나 다른 브라우저에서 방향을 잡고 싶은 사람에게 맞아. 예를 들어 테스트를 돌려 놓고 이동하면서 실패 로그를 확인하거나, 사내 MCP 서버를 쓰는 리팩터링 세션을 웹 화면에서 이어 보는 식이야. 같은 로컬 환경을 유지해야 하는 작업일수록 Claude Code on the web보다 이 기능 쪽이 자연스럽다.

반대로 새 작업을 클라우드에서 병렬로 여러 개 던지고 싶다면 이 기능보다 Claude Code on the web이나 다른 Agent Runtime을 봐야 해. 여기서는 이미 떠 있는 로컬 세션을 조작하는 일이 중심이고, 로컬 머신의 전원·네트워크·인증 상태에 묶인다. “어디서 실행되나”를 먼저 물으면 판단이 덜 흐려져.