집 데스크탑에서 띄운 Claude Code 세션을 폰·태블릿·다른 브라우저에서 그대로 이어 받는 기능입니다. Claude는 여전히 내 컴퓨터에서 실행되고, 웹·모바일 화면은 그 로컬 세션을 조작하는 인터페이스입니다.
기존에 Claude App 을 사용하시던 분들은 아시겠지만, Cloud Session이 존재했습니다. 하지만 해당 클라우드 세션은 Cluade 내부의 공간이었고, 여러 로컬 머신에서 거기에 붙어서 작업하는 방식이었습니다.
이와는 다르게 Remote Control은 집 데스크탑(A)에서 띄운 세션을 폰·태블릿에서 이어 받아서 작업을 계속 할 수 있는 기능입니다. 세션이 실행주체는 데스크탑(A) 이고 그 세션을 다른 머신에서도 조작 가능하다고 이해하시면 편할 것 같습니다.
세션은 내 컴퓨터에서
Remote Control을 켜도 Claude는 처음부터 끝까지 내 컴퓨터에서 실행됩니다. 다른 원격 도구처럼 작업이 클라우드로 옮겨 가지 않고, 폰·웹 화면은 입력을 보내고 결과를 받는 클라이언트 역할만 합니다.
폰에서 입력해도 로컬 환경이 그대로 유지됩니다. 파일 시스템, MCP servers, 도구, 프로젝트 구성에 그대로 접근할 수 있고, @ 만 치면 로컬 프로젝트의 파일 경로가 자동 완성됩니다. 책상에서 작업하다가 자리를 옮겨 폰에서 메시지를 추가해도 같은 세션이 그대로 이어집니다.
웹의 Claude Code는 반대입니다. 같은 claude.ai/code 인터페이스를 쓰지만, 웹 쪽은 Anthropic 클라우드에서 세션이 실행되므로 로컬 설정 없이 바로 시작할 수 있는 대신 내 머신의 MCP servers·도구·파일은 사용할 수 없습니다. 두 기능은 Claude가 어디서 실행되는가 한 가지에서 갈립니다.
Remote Control 활성화
세션을 시작하는 방법은 CLI 세 가지와 VS Code 한 가지입니다. 어느 쪽이든 같은 원격 세션이 만들어지지만 시작 방법이 다르니, 상황에 맞춰 고르면 됩니다.
가장 본격적인 방식은 서버 모드(claude remote-control)입니다. 터미널이 서버로 유지되면서 원격 연결을 기다리고, 스페이스바를 누르면 폰에서 스캔할 QR 코드가 화면에 표시됩니다. --spawn worktree 를 붙이면 들어오는 세션마다 자체 git worktree가 할당되어 같은 파일을 동시에 편집하는 충돌을 피할 수 있습니다. --capacity 로 최대 동시 세션 수(기본 32)를 조절할 수 있고, 런타임에 w 한 글자로 same-dir 과 worktree 사이를 전환할 수도 있습니다.
평소 쓰던 방식을 그대로 두고 추가로 원격을 켜고 싶을 땐 claude --remote-control(축약 --rc)이 어울립니다. 일반 대화형 세션과 동일하게 동작하면서 원격에서도 함께 접속할 수 있어서, 로컬 터미널에서 메시지를 직접 입력하면서 폰에서도 같은 대화를 이어갈 수 있습니다.
이미 세션 안에서 작업하다가 자리를 옮기고 싶을 땐 슬래시 명령 /remote-control(/rc)을 입력하면 됩니다. 지금까지의 대화 기록이 그대로 따라오니 하던 작업을 멈추지 않아도 됩니다 — 개인적으로 이 명령이 제일 자주 쓰일 것 같습니다.
VS Code 확장에서도 같은 슬래시 명령으로 호출합니다. 프롬프트 상자 위에 연결 상태 배너가 표시되고, 브라우저에서 열기 를 누르면 바로 해당 세션으로 이동합니다. CLI와 달리 이름 인수나 QR 코드 표시는 빠져 있습니다.
외부 기기로 접속하는 법
세션이 실행 중이면 다른 기기에서 연결하는 방법은 세 가지입니다.
- 세션 URL — 어느 브라우저든 URL을 열면 claude.ai/code의 해당 세션으로 이동합니다.
- QR 코드 — URL 옆에 표시되는 코드를 스캔하면 Claude 모바일 앱이 해당 세션을 엽니다. 서버 모드에서는 스페이스바로 표시를 토글할 수 있습니다.
- 세션 목록 — claude.ai/code 또는 모바일 앱의 코드 탭에 등록된 세션이 이름으로 나열됩니다. 온라인 상태인 Remote Control 세션 옆에 녹색 점이 박힌 컴퓨터 아이콘 이 표시되어, 어느 세션이 내 노트북에서 실행 중인지 바로 확인할 수 있습니다.
세션 이름은 --name 이나 /remote-control 에 넘긴 인수가 우선입니다. 따로 지정하지 않으면 myhost-graceful-unicorn 처럼 호스트명에 형용사+명사 가 붙어 자동 생성됩니다. 메시지를 한 번 보내면 첫 프롬프트를 반영해 제목이 갱신됩니다.
기본은 명시적으로 원격 명령을 실행할 때만 켜집니다. /config 에서 모든 세션에 대해 Remote Control 활성화 를 true 로 두면 모든 대화형 세션이 자동으로 원격을 등록합니다.
인바운드 포트를 열지 않는 보안 모델
"내 노트북에 원격으로 접속한다"는 말을 처음 들었을 때 방화벽 어디를 어떻게 열어야 하나, 보안적으로 위험한 거 아닌가 싶었는데, 문서를 읽고 안심했습니다. 로컬 컴퓨터가 받는 트래픽은 없습니다. Remote Control이 실행 중이어도 컴퓨터는 Anthropic API로 나가는 HTTPS 요청 만 보냅니다 — 작업이 있는지 폴링하는 용도입니다. 인바운드 포트는 열리지 않습니다.
폰이나 브라우저에서 메시지를 보내면 Anthropic 서버가 그 메시지를 스트리밍 연결로 로컬 세션에 라우팅합니다. 모든 트래픽은 TLS 로 Anthropic API를 거치고, 일반 Claude Code 세션과 동일한 전송 보안입니다. 연결마다 단일 목적으로 범위가 좁혀진 단기 자격 증명 이 발급되고 각자 만료됩니다.
방화벽 규칙을 따로 손대지 않아도 외부에서 자기 세션에 접속할 수 있는 구조입니다. 외부에서 들어오는 포트를 열지 않고, 컴퓨터가 보내는 아웃바운드 요청만으로 양방향 통신이 이루어집니다.
Claude가 결정하는 푸시 알림
푸시 알림이 의외였습니다. 보통 알림 기능에는 "이런 이벤트면 보내고, 저런 이벤트는 끄고" 식의 설정 화면이 있는데, Remote Control에는 그런 게 없습니다. Claude가 자동으로 언제 푸시할지 결정합니다.
오래 걸리는 빌드·테스트가 끝났거나 다음 결정을 내리려면 사용자 입력이 필요한 상황에서 알림이 옵니다. 프롬프트에 "테스트가 끝나면 알려 줘" 처럼 부탁해 둘 수도 있지만, 그 외에 사용자가 조정할 수 있는 옵션은 없습니다 — 켜기/끄기 토글뿐. 알림 빈도의 적절성이 모델 판단에 맡겨졌다는 점이 재밌습니다.
설정은 단순합니다. 모바일 앱을 설치하고 같은 계정으로 로그인한 뒤, 터미널에서 /config → Claude가 결정할 때 푸시 를 켜면 됩니다. 알림이 안 오면 /config 에 등록된 모바일 없음 이 표시되어 있는지 확인하고, 폰의 Claude 앱을 열어 푸시 토큰을 새로 고치면 됩니다(v2.1.110 이상).
원격 세션이 끊기는 조건
원격이 실행 중이어도 로컬 프로세스에 묶여 있는 기능이라, 몇 가지 끊김 조건이 있습니다.
- 인스턴스당 원격 세션은 하나. 서버 모드 외에는 Claude Code 프로세스 하나가 한 번에 원격 세션을 하나만 띄울 수 있습니다. 동시에 여러 개를 실행하려면 서버 모드(
claude remote-control)를 사용해야 합니다. - 로컬 프로세스를 종료하면 끝. 터미널을 닫거나 VS Code를 종료하면 세션도 함께 종료됩니다. 컴퓨터가 켜져 있어도 네트워크에 약 10분 이상 닿지 못하면 세션이 시간 초과로 종료됩니다.
- Ultraplan을 실행하면 끊긴다. ultraplan 세션을 시작하면 활성 Remote Control 세션의 연결이 해제됩니다. 둘 다 claude.ai/code 인터페이스를 점유하는데 한 번에 하나만 연결될 수 있기 때문입니다.
- 로컬 전용 명령이 있다.
/mcp·/plugin·/resume처럼 터미널의 대화형 선택기를 여는 명령은 로컬 CLI에서만 동작합니다./compact·/clear·/context·/usage같이 텍스트 출력만 하는 명령은 모바일·웹에서도 동작합니다.
Remote Control과 웹의 Claude Code
Remote Control은 노트북을 가지고 다니지 않으면서도 그 노트북에 원격 접속할 수 있게 해주는 기능입니다. 이미 구성해 둔 MCP servers·도구·프로젝트 설정을 다시 만들 필요가 없고, 폰·태블릿에서도 책상의 환경 그대로 작업을 이어갈 수 있습니다. 대신 그 노트북이 켜져 있고 네트워크에 연결되어 있어야 한다는 조건이 붙습니다.
출장 가서 로컬 설정 없이 바로 시작하고 싶을 땐 웹의 Claude Code가 어울리고, 책상에서 구성한 환경을 폰에서 그대로 이어가고 싶을 땐 Remote Control이 어울립니다. 같은 인터페이스를 쓰는 두 기능이 Claude의 실행 위치 한 가지로 갈립니다.
참고 자료
- 원문: 모든 기기에서 로컬 세션 계속하기 — Claude Code 문서 (ko)
- 관련: 웹의 Claude Code — 클라우드에서 실행되는 다른 방식
