Remote Control로 어떤 기기에서든 로컬 세션 이어서 작업하기

Remote Control을 사용하면 휴대폰, 태블릿 또는 모든 브라우저에서 로컬 Claude Code 세션을 이어서 작업할 수 있습니다. claude.ai/code 및 Claude 모바일 앱과 함께 작동합니다.

참고: Remote Control은 모든 플랜에서 사용할 수 있습니다. Team 및 Enterprise 관리자는 먼저 관리자 설정에서 Claude Code를 활성화해야 합니다.

Remote Control은 claude.ai/code 또는 iOS 및 Android용 Claude 앱을 사용자의 컴퓨터에서 실행 중인 Claude Code 세션에 연결합니다. 책상에서 작업을 시작한 후, 소파에서 휴대폰으로 또는 다른 컴퓨터의 브라우저에서 이어서 작업할 수 있습니다.

컴퓨터에서 Remote Control 세션을 시작하면, Claude는 전체 시간 동안 로컬에서 계속 실행되므로 아무것도 클라우드로 이동하지 않습니다. Remote Control을 사용하면 다음과 같은 일을 할 수 있습니다:

• 원격에서 전체 로컬 환경 사용: 파일 시스템, MCP 서버, 도구, 프로젝트 설정이 모두 그대로 유지됩니다
• 여러 환경에서 동시에 작업: 대화가 연결된 모든 기기에서 동기화되어, 터미널, 브라우저, 휴대폰에서 번갈아 메시지를 보낼 수 있습니다
• 중단에도 유지: 노트북이 절전 모드에 들어가거나 네트워크가 끊어져도, 컴퓨터가 다시 온라인이 되면 세션이 자동으로 재연결됩니다

클라우드 인프라에서 실행되는 웹 기반 Claude Code와 달리, Remote Control 세션은 사용자의 컴퓨터에서 직접 실행되며 로컬 파일 시스템과 상호작용합니다. 웹 및 모바일 인터페이스는 그 로컬 세션을 보여주는 창에 불과합니다.

이 페이지에서는 설정 방법, 세션을 시작하고 연결하는 방법, 그리고 Remote Control과 웹 기반 Claude Code의 비교를 다룹니다.

요구 사항

Remote Control을 사용하기 전에, 환경이 다음 조건을 충족하는지 확인하세요:

• 구독: Pro, Max, Team, Enterprise 플랜에서 사용 가능합니다. Team 및 Enterprise 관리자는 먼저 관리자 설정에서 Claude Code를 활성화해야 합니다. API 키는 지원되지 않습니다.
• 인증: claude를 실행하고 아직 로그인하지 않았다면 /login을 사용하여 claude.ai를 통해 로그인하세요.
• 워크스페이스 신뢰: 프로젝트 디렉토리에서 최소 한 번 claude를 실행하여 워크스페이스 신뢰 대화 상자를 수락하세요.

Remote Control 세션 시작하기

새 세션을 Remote Control에서 직접 시작하거나, 이미 실행 중인 세션에 연결할 수 있습니다.

새 세션

프로젝트 디렉토리로 이동하여 다음을 실행합니다:

claude remote-control

프로세스가 터미널에서 계속 실행되며 원격 연결을 기다립니다. 다른 기기에서 연결하는 데 사용할 수 있는 세션 URL이 표시되며, 스페이스바를 눌러 휴대폰에서 빠르게 접속할 수 있는 QR 코드를 표시할 수 있습니다. 원격 세션이 활성화되어 있는 동안 터미널에는 연결 상태와 도구 활동이 표시됩니다.

이 명령어는 다음 플래그를 지원합니다:

• --name "My Project": claude.ai/code의 세션 목록에 표시되는 사용자 지정 세션 제목을 설정합니다. 위치 인자로도 이름을 전달할 수 있습니다: claude remote-control "My Project"
• --verbose: 상세한 연결 및 세션 로그를 표시합니다
• --sandbox / --no-sandbox: 세션 중 파일 시스템 및 네트워크 격리를 위한 샌드박싱을 활성화 또는 비활성화합니다. 기본적으로 샌드박싱은 꺼져 있습니다.

기존 세션에서

이미 Claude Code 세션에 있는 상태에서 원격으로 이어서 작업하려면, /remote-control (또는 /rc) 명령어를 사용하세요:

/remote-control

인자로 이름을 전달하여 사용자 지정 세션 제목을 설정할 수 있습니다:

/remote-control My Project

이 명령어는 현재 대화 기록을 유지하면서 Remote Control 세션을 시작하고, 다른 기기에서 연결하는 데 사용할 수 있는 세션 URL과 QR 코드를 표시합니다. 이 명령어에서는 --verbose, --sandbox, --no-sandbox 플래그를 사용할 수 없습니다.

다른 기기에서 연결하기

Remote Control 세션이 활성화되면, 다른 기기에서 연결하는 몇 가지 방법이 있습니다:

• 세션 URL 열기: 아무 브라우저에서 세션 URL을 열면 claude.ai/code에서 해당 세션으로 직접 이동합니다. claude remote-control과 /remote-control 모두 터미널에 이 URL을 표시합니다.
• QR 코드 스캔: 세션 URL과 함께 표시되는 QR 코드를 스캔하면 Claude 앱에서 직접 열 수 있습니다. claude remote-control에서는 스페이스바를 눌러 QR 코드 표시를 전환할 수 있습니다.
• claude.ai/code 또는 Claude 앱 열기: 세션 목록에서 이름으로 세션을 찾습니다. Remote Control 세션은 온라인 상태일 때 녹색 상태 점이 있는 컴퓨터 아이콘으로 표시됩니다.

원격 세션의 이름은 --name 인자(또는 /remote-control에 전달된 이름), 마지막 메시지, /rename 값, 또는 대화 기록이 없는 경우 "Remote Control session"에서 가져옵니다. 환경에 이미 활성 세션이 있는 경우, 기존 세션을 계속할 것인지 새 세션을 시작할 것인지 묻습니다.

Claude 앱이 아직 없다면, Claude Code 내에서 /mobile 명령어를 사용하여 iOS 또는 Android용 다운로드 QR 코드를 표시할 수 있습니다.

모든 세션에 대해 Remote Control 활성화하기

기본적으로 Remote Control은 claude remote-control 또는 /remote-control을 명시적으로 실행할 때만 활성화됩니다. 모든 세션에서 자동으로 활성화하려면, Claude Code 내에서 /config를 실행하고 Enable Remote Control for all sessions를 true로 설정하세요. 비활성화하려면 다시 false로 설정하세요.

각 Claude Code 인스턴스는 한 번에 하나의 원격 세션을 지원합니다. 여러 인스턴스를 실행하면, 각각 고유한 환경과 세션을 갖게 됩니다.

연결 및 보안

로컬 Claude Code 세션은 아웃바운드 HTTPS 요청만 수행하며, 컴퓨터에서 인바운드 포트를 열지 않습니다. Remote Control을 시작하면, Anthropic API에 등록하고 작업을 폴링합니다. 다른 기기에서 연결하면, 서버가 스트리밍 연결을 통해 웹 또는 모바일 클라이언트와 로컬 세션 사이에서 메시지를 라우팅합니다.

모든 트래픽은 TLS를 통해 Anthropic API를 거쳐 전송되며, 이는 일반 Claude Code 세션과 동일한 전송 보안입니다. 연결에는 단일 목적에 한정되고 독립적으로 만료되는 여러 개의 단기 자격 증명이 사용됩니다.

Remote Control vs 웹 기반 Claude Code

Remote Control과 웹 기반 Claude Code는 모두 claude.ai/code 인터페이스를 사용합니다. 핵심 차이점은 세션이 실행되는 위치입니다: Remote Control은 사용자의 컴퓨터에서 실행되므로 로컬 MCP 서버, 도구, 프로젝트 설정이 그대로 유지됩니다. 웹 기반 Claude Code는 Anthropic이 관리하는 클라우드 인프라에서 실행됩니다.

로컬 작업 중에 다른 기기에서 계속 작업하고 싶을 때는 Remote Control을 사용하세요. 로컬 설정 없이 작업을 시작하거나, 클론하지 않은 저장소에서 작업하거나, 여러 작업을 병렬로 실행하고 싶을 때는 웹 기반 Claude Code를 사용하세요.

제한 사항

• 한 번에 하나의 원격 세션: 각 Claude Code 세션은 하나의 원격 연결을 지원합니다.
• 터미널이 열려 있어야 함: Remote Control은 로컬 프로세스로 실행됩니다. 터미널을 닫거나 claude 프로세스를 중지하면 세션이 종료됩니다. 새 세션을 시작하려면 claude remote-control을 다시 실행하세요.
• 장시간 네트워크 중단: 컴퓨터가 켜져 있지만 약 10분 이상 네트워크에 연결할 수 없으면, 세션이 타임아웃되고 프로세스가 종료됩니다. 새 세션을 시작하려면 claude remote-control을 다시 실행하세요.

관련 리소스

• 웹 기반 Claude Code: 사용자 컴퓨터 대신 Anthropic이 관리하는 클라우드 환경에서 세션을 실행합니다
• 인증: /login을 설정하고 claude.ai 자격 증명을 관리합니다
• CLI 참조: claude remote-control을 포함한 전체 플래그 및 명령어 목록
• 보안: Remote Control 세션이 Claude Code 보안 모델에 어떻게 부합하는지
• 데이터 사용: 로컬 및 원격 세션 동안 Anthropic API를 통해 전송되는 데이터