한 줄 정의
claude remote-control은 Claude Code에서 원격 제어 서버를 띄우는 CLI 명령이야. 하이픈을 빼고 claude remote control이라고도 적지만, 공식 CLI 표기는 claude remote-control이고, 역할은 claude.ai/code나 Claude 모바일 앱이 로컬에서 실행 중인 Claude Code 세션을 조작하게 하는 일이야.
그러니까 이 항목은 새 Claude 모델이 아니야. 더 넓은 기능 이름은 Claude Code Remote Control이고, claude remote-control은 그 기능을 서버 모드로 켜는 시작 명령에 가깝다. 공식 문서 기준 Remote Control은 research preview라서, 팀 규칙에 바로 고정하기 전에 요구 조건과 제한을 같이 봐야 해.
실제로 무엇을 하나
이 명령을 실행하면 로컬 터미널에 서버 모드 프로세스가 뜨고, 원격 연결을 기다린다. 터미널 안에서 바로 대화하는 일반 세션은 열리지 않아. 대신 세션 URL이 표시되고, 스페이스바로 QR 코드를 띄워서 휴대폰의 Claude 앱이나 다른 브라우저에서 들어갈 수 있어.
비슷해 보이는 시작 경로가 몇 개 있어서 구분이 필요해.
claude remote-control: 서버 모드야. 한 프로세스가 원격 세션을 기다리고, 로컬 interactive prompt는 열지 않아.claude --remote-control또는claude --rc: 터미널 interactive session을 열면서 웹·모바일에서도 같은 세션을 조작하게 해./remote-control또는/rc: 이미 Claude Code 안에 들어와 있을 때 현재 대화 기록을 이어서 원격 세션을 만든다. VS Code 확장에서는 Claude Code v2.1.79 이상이 필요해.
서버 모드는 여러 원격 세션을 받을 수 있다는 점도 달라. 기본 --capacity는 32개 동시 세션이고, --spawn 기본값은 same-dir이야. 이 기본값은 요청이 들어올 때 만들어지는 세션들이 같은 작업 디렉터리를 쓴다는 뜻이라, 같은 파일을 여러 세션에서 고치면 충돌이 날 수 있어. git 저장소라면 --spawn worktree로 각 세션을 별도 worktree에서 만들 수 있고, 한 세션만 받을 때는 --spawn session을 쓴다.
왜 중요한가
중요한 기준은 “어디서 실행되나”야. 이 서버 명령으로 연 세션은 Claude Code on the web처럼 Anthropic 관리 클라우드 VM에서 도는 게 아니라, 내 머신에서 실행 중인 Claude Code 프로세스를 원격 화면으로 조작해. 그래서 로컬 파일시스템, MCP 서버, 셸 도구, 프로젝트 설정이 그대로 살아 있어.
실무에서는 긴 작업 중간에 차이가 난다. 테스트를 돌려 놓고 이동하면서 실패 로그를 확인하거나, 사내 MCP 서버가 필요한 리팩터링 세션을 휴대폰에서 이어 보는 식이야. 작업은 로컬에서 돌고, 화면만 웹이나 모바일로 바뀌는 구조라서 “클라우드에 새 작업을 맡긴다”와는 다르게 봐야 해.
이 흐름에서는 모바일 푸시 알림도 받을 수 있어. 공식 문서 기준 Claude Code v2.1.110 이상이면, Remote Control이 켜진 상태에서 Claude가 긴 작업을 끝냈거나 사람 판단이 필요하다고 판단할 때 휴대폰 알림을 보낼 수 있어. 프롬프트에 notify me when the tests finish처럼 요청할 수도 있지만, 이벤트별 세밀한 알림 규칙을 사용자가 직접 짜는 기능은 아니야.
보안 판단도 여기서 갈려. 연결은 사용자 머신에 들어오는 포트를 열지 않고, 바깥으로 나가는 HTTPS 요청으로 Anthropic API에 등록한 뒤 작업 요청을 주기적으로 확인하는 방식이야. Data usage 문서는 Remote Control 세션이 로컬 Claude Code와 같은 데이터 흐름을 따른다고 설명하고, 프롬프트와 모델 출력은 TLS 1.2+로 전송된다고 적어. 코드 실행은 로컬이지만, 네트워크로 나가는 데이터가 없다는 뜻은 아니야.
주의해서 볼 점
첫째, 인증 조건이 일반 API key와 달라. 이 서버 모드 명령은 claude.ai 계정으로 로그인한 OAuth 흐름을 요구해. ANTHROPIC_API_KEY를 넣어 쓰는 Console account, Bedrock, Vertex AI, Foundry 같은 제3자 제공자 경로로 Claude 모델을 쓰는 것과 Remote Control을 여는 것은 다른 문제야.
둘째, 조직 정책이 실제 사용 가능 여부를 갈라. Pro와 Max 같은 개인 플랜에서는 계정 조건을 먼저 보면 되지만, Team과 Enterprise에서는 관리자가 Claude Code admin settings에서 Remote Control toggle을 켜야 해. 조직의 데이터 보존이나 컴플라이언스 설정이 맞지 않으면 toggle이 막힐 수 있고, 관리 설정의 disableRemoteControl 정책도 별도로 걸릴 수 있어.
셋째, 로컬 프로세스가 계속 살아 있어야 해. 터미널을 닫거나 VS Code를 종료하면 세션도 끝난다. 머신이 잠깐 잠들거나 네트워크가 끊기면 돌아온 뒤 재연결될 수 있지만, 머신이 깨어 있는데 네트워크가 약 10분 넘게 닿지 않으면 세션이 만료될 수 있어.
넷째, 원격 화면이 로컬 터미널을 완전히 대체하지는 않아. /compact, /clear, /context, /usage처럼 텍스트 출력으로 끝나는 명령은 웹·모바일에서도 쓸 수 있지만, /mcp, /plugin, /resume처럼 로컬 터미널의 선택 화면을 여는 명령은 로컬 전용으로 남는다. 급할 거 없어. 원격 제어는 터미널을 없애는 기능이 아니라, 이미 돌아가는 로컬 세션을 다른 화면에서 이어 보는 기능에 더 가까워.
언제 쓰나 / 언제 보류하나
서버 모드 명령은 로컬 Claude Code 환경이 이미 준비돼 있고, 여러 원격 세션을 열 가능성이 있을 때 잘 맞아. 예를 들어 사내 저장소와 로컬 MCP 서버를 쓰는 작업을 켜 두고, 다른 브라우저나 휴대폰에서 상태를 보며 방향을 잡고 싶을 때야. 같은 작업 디렉터리를 공유하면 위험한 팀이라면 시작부터 --spawn worktree를 같이 검토하는 게 좋아.
반대로 새 작업을 클라우드에서 바로 시작하거나, 로컬 머신이 꺼져 있어도 병렬 작업이 계속 돌게 하고 싶다면 이 명령은 맞지 않아. 그때는 Claude Code on the web이나 다른 Agent Runtime을 검토하는 게 더 맞아. 이 명령의 핵심은 클라우드 실행이 아니라 로컬 세션 조작이야.