Claude Code Remote Control 소개
최근 소프트웨어 개발 생태계에서는 AI 코딩 어시스턴트가 개발자들의 필수적인 도구로 자리 잡고 있습니다. 대부분의 AI 코딩 도구는 로컬 환경에 직접 설치되어 실행되거나, 완전히 클라우드 기반의 웹 서비스 형태로 제공되는 방식으로 양분되어 왔습니다. 로컬 환경에서 실행되는 도구는 개발자의 파일 시스템과 직접 상호작용할 수 있다는 장점이 있지만, 작업하던 컴퓨터 앞을 떠나면 접근할 수 없다는 물리적인 한계가 존재했습니다. 반면 클라우드 기반 도구는 어디서나 접근이 가능하지만, 로컬 컴퓨터에 구성해 둔 복잡한 개발 환경이나 비공개 파일 시스템에 접근하기 어렵다는 단점이 있었습니다. 이러한 두 환경의 장점을 결합하고 단점을 보완하기 위해 Anthropic은 최근 클로드 코드(Claude Code)의 새로운 기능인 원격 제어(Remote Control) 를 선보였습니다.
클로드 코드 원격 제어(Claude Code Remote Control)는 개발자가 자신의 로컬 컴퓨터(데스크톱이나 노트북)에서 실행 중인 Claude Code 세션을 스마트폰, 태블릿, 또는 다른 컴퓨터의 웹 브라우저 등 모든 기기에서 매끄럽게 이어서 진행할 수 있도록 해주는 기능입니다. 이 기능을 사용하면 claude.ai/code 웹사이트나 iOS 및 Android용 Claude 모바일 앱을 로컬 머신에서 구동 중인 터미널 세션과 직접 연결할 수 있습니다.
즉, 책상에 앉아 복잡한 코드 리팩토링이나 빌드 작업을 시작해 둔 뒤, 자리를 이동하여 소파에 앉아 스마트폰으로 해당 작업의 진행 상황을 확인하고 추가적인 프롬프트를 입력하는 것이 가능해집니다. 무엇보다 이 원격 세션이 진행되는 동안 Claude는 클라우드가 아닌 개발자의 로컬 터미널 환경에서 계속 실행되므로 소스 코드나 로컬 파일이 클라우드로 임의로 이전되지 않습니다. 사용자는 이 기능을 통해 언제 어디서나 자신의 강력한 로컬 개발 환경을 손끝에서 제어할 수 있게 됩니다.
이러한 원격 제어 기능은 로컬 환경의 보안성과 완벽한 권한을 철저하게 유지하면서도 무한한 이동성을 부여한다는 장점이 있습니다. 원격 제어를 사용하면 사용자의 로컬 파일 시스템은 물론이고 로컬에 구축된 MCP(Model Context Protocol) 서버, 각종 CLI 도구, 그리고 특정 프로젝트의 구성 파일(Configuration)까지 모두 원격 기기에서 그대로 사용할 수 있습니다.
또한, 터미널, 브라우저, 모바일 폰 사이의 대화 기록이 실시간으로 완벽하게 동기화되므로 여러 기기를 번갈아 가며 작업해도 흐름이 끊기지 않습니다. 노트북이 일시적으로 절전 모드에 들어가거나 네트워크 연결이 끊어지더라도, 컴퓨터가 다시 온라인 상태가 되면 세션이 자동으로 재연결되어 중단 없는 작업 연속성을 보장합니다. 결과적으로 이 기능은 바쁜 현대 개발자들의 작업 유연성을 극대화하고 물리적인 공간의 제약을 없애주는 강력한 워크플로우 도구로 기능합니다.
원격 제어 기능 vs. Claude Code on the web 비교
원격 제어 기능과 웹 환경의 Claude Code 모두 동일한 claude.ai/code 사용자 인터페이스를 사용하지만, 코드 세션이 실제로 어디에서 실행되는지에 따라 명확한 차이가 존재합니다. 기존에 출시된 Claude Code on the web은 세션의 실행이 Anthropic이 직접 관리하는 클라우드 인프라 내에서 이루어집니다. 이 방식은 복잡한 로컬 개발 환경 설정 없이 즉시 작업을 시작하고 싶거나, 로컬 컴퓨터에 클론(clone)하지 않은 원격 저장소에서 작업해야 할 때, 혹은 여러 작업을 병렬로 동시에 실행해야 할 때 유리합니다.
이에 비해, 이번에 새로 출시된 Claude Code Remote Control (원격 제어) 기능은 세션의 실제 실행이 전적으로 사용자의 로컬 컴퓨터에서 이루어집니다. 따라서 로컬 파일 시스템, 로컬에 연결된 MCP 서버, 다양한 커맨드라인 도구 및 프로젝트 환경 구성이 그대로 유지되고 접근 가능합니다. 진행 중인 로컬 워크플로우를 기기만 바꾸어 계속 이어나가고 싶을 때 사용하는 것이 가장 적합합니다. 웹이나 모바일 인터페이스는 단순히 이 로컬 세션을 원격에서 들여다보고 조작하는 창문의 역할만 수행합니다.
Claude Code의 원격 제어(Remote Control) 사용 가이드
사용을 위한 기본 요구 사항 (Requirements)
Claude Code의 원격 제어 기능을 사용하기 위해서는 사용자의 개발 환경이 다음의 필수 조건을 충족해야 합니다.
-
구독(Subscription): 현재 Pro 또는 Max 플랜 구독자만 이 기능을 사용할 수 있으며, 일반 API 키 방식은 지원되지 않습니다.
-
인증(Authentication): 아직 인증 절차를 거치지 않았다면 로컬 터미널에서
claude명령어를 실행하고/login을 입력하여claude.ai를 통해 시스템에 로그인해야 합니다. -
작업 공간 신뢰(Workspace trust): 보안을 위해 최소한 한 번 이상 프로젝트 디렉토리 내에서
claude를 실행하여 작업 공간을 신뢰한다는 확인 대화상자에 동의해야 합니다.
원격 제어 세션 시작하기 (Start a Remote Control session)
사용자는 새로운 세션을 원격 제어 모드로 바로 시작하거나, 이미 진행 중인 기존 세션을 원격으로 연결할 수 있습니다.
새로운 세션으로 시작할 경우에는 작업하고자 하는 프로젝트 디렉토리로 이동한 후 터미널에 다음 명령어를 입력합니다:
claude remote-control
위와 같이 명령어를 실행하면 프로세스가 터미널에 켜진 상태로 유지되며 외부의 원격 연결을 대기하게 됩니다. 화면에는 다른 기기에서 접속할 수 있는 전용 세션 URL이 출력되며, 키보드의 스페이스바를 누르면 스마트폰 카메라로 즉시 스캔할 수 있는 QR 코드가 화면에 나타납니다. 원격 세션이 활성화된 동안 로컬 터미널 화면을 통해 현재의 연결 상태와 도구(Tool)들의 활동 내역을 모니터링할 수 있습니다.
추가로 --verbose 플래그를 사용하여 상세한 로그를 보거나, --sandbox 및 --no-sandbox 플래그를 통해 세션 동안 파일 시스템 및 네트워크 격리를 위한 샌드박싱 기능을 켜고 끌 수 있습니다(샌드박싱은 기본적으로 꺼져 있습니다).
기존 세션에서 연결할 경우에는 이미 로컬에서 Claude Code 세션을 열고 대화를 나누던 중이라면, 프롬프트 창에 다음 명령어를 입력하기만 하면 됩니다:
/remote-control
# 또는 단축 명령어 `/rc` 사용 가능
이 방식을 사용하면 현재까지 진행된 대화의 컨텍스트와 히스토리가 그대로 유지된 채로 원격 제어 세션이 시작됩니다. 명령어 입력 후에는 앞서 설명한 것과 동일하게 접속용 URL과 QR 코드가 터미널에 표시됩니다.
단, 이 방식에서는 --verbose나 --sandbox 같은 시작 플래그를 적용할 수 없습니다. 팁으로, /remote-control을 실행하기 전에 /rename 명령어를 사용하여 현재 세션에 직관적인 이름을 지어두면, 나중에 다른 기기에서 세션 목록을 볼 때 자신이 작업하던 세션을 훨씬 쉽게 식별할 수 있습니다.
다른 기기에서 세션에 접속하기 (Connect from another device)
로컬 터미널에서 원격 제어 세션이 대기 상태가 되면, 다음과 같은 여러 가지 방법으로 다른 기기에서 손쉽게 연결할 수 있습니다:
-
어떤 기기에서든 웹 브라우저를 열고 터미널에 표시된 세션 URL을 직접 입력하면
claude.ai/code의 해당 세션 화면으로 바로 이동합니다. -
터미널 화면에서 스페이스바를 눌러 QR 코드를 띄우고, 이를 스마트폰으로 스캔하면 Claude 모바일 앱에서 해당 세션이 즉각적으로 열립니다. (만약 모바일 앱이 아직 설치되어 있지 않다면, Claude Code 내에서
/mobile명령어를 입력하여 iOS 또는 Android 앱 다운로드용 QR 코드를 제공받을 수 있습니다.) -
다른 기기에서
claude.ai/code또는 Claude 앱을 직접 실행한 뒤, 좌측 세션 목록에서 이름으로 해당 세션을 찾아 클릭할 수도 있습니다. 원격 제어 세션은 온라인 상태일 경우 초록색 상태 표시점이 붙은 컴퓨터 아이콘으로 명확하게 구분되어 표시됩니다. 만약 해당 환경에 이미 활성화된 세션이 있다면, 이를 계속 이어나갈지 아니면 새로운 세션을 시작할지 묻는 메시지가 나타납니다.
모든 세션에 대해 원격 제어 자동 활성화 (Enable Remote Control for all sessions)
기본 설정상 원격 제어 기능은 사용자가 명령어를 명시적으로 입력할 때만 켜지도록 되어 있습니다. 모든 세션에서 자동으로 원격 제어가 활성화되도록 기본값을 변경하려면, Claude Code 프롬프트 내부에서 /config 명령어를 실행한 뒤, 설정 항목 중 Enable Remote Control for all sessions의 값을 true로 변경합니다.
참고로 하나의 Claude Code 인스턴스는 한 번에 단 하나의 원격 세션만 지원하며, 여러 개의 인스턴스를 동시에 실행할 경우 각각의 인스턴스는 서로 독립적인 세션을 별도로 부여받게 됩니다.
연결 방식과 데이터 보안 (Connection and security)
로컬 머신에서 실행 중인 Claude Code 세션은 외부 서버를 향해 나가는(Outbound) HTTPS 요청만을 수행하며, 어떠한 경우에도 사용자의 로컬 머신에 외부에서 들어오는(Inbound) 포트를 임의로 개방하지 않습니다. 원격 제어를 시작하면 프로그램이 Anthropic API에 자신을 등록하고 수행할 작업이 있는지 주기적으로 확인합니다.
이후, 사용자가 다른 기기에서 연결을 시도하면 중앙 서버가 웹 또는 모바일 클라이언트와 로컬 세션 간의 메시지를 스트리밍 방식으로 중계합니다. 이 과정에서 발생하는 모든 트래픽은 일반적인 Claude Code 세션과 동일하게 Anthropic API를 통해 TLS로 강력하게 암호화되어 전송됩니다.
또한, 연결 과정에서 부여되는 인증 자격 증명들은 단일 목적에만 사용되도록 권한이 좁게 설정되어 있으며, 독립적으로 짧은 시간 안에 만료되도록 설계되었습니다.
시스템 한계 및 제한 사항 (Limitations)
원격 제어 기능은 매우 유용하지만 현재 아키텍처 상 몇 가지 주의사항을 가지고 있습니다.
-
동시 접속의 제한: 각각의 Claude Code 세션은 한 번에 단 하나의 원격 연결만을 지원합니다.
-
터미널 유지의 필요성: 원격 제어 기능은 로컬 컴퓨터의 프로세스에 접근하는 것이므로, 로컬 터미널 창을 닫거나
claude프로세스를 강제로 중지하면 원격 세션 역시 즉시 종료됩니다. 이 경우 다시 세션을 만들어야 합니다. -
네트워크 중단에 따른 시간 초과: 로컬 머신이 켜져 있더라도 대략 10분 이상 네트워크 연결이 불안정하여 오프라인 상태가 지속되면, 시스템 보호를 위해 해당 세션은 시간 초과(timeout) 처리되며 프로세스가 자동으로 종료됩니다.
Claude Code 공식 홈페이지
Claude Code Remote Control 소개 문서
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 