Remote Control은 모든 요금제에서 사용할 수 있습니다. Team 및 Enterprise 관리자는 먼저 관리자 설정에서 Claude Code를 활성화해야 합니다.
- 전체 로컬 환경을 원격으로 사용: 파일 시스템, MCP servers, 도구 및 프로젝트 구성이 모두 사용 가능하게 유지됩니다.
- 두 개의 표면에서 동시에 작업: 대화가 모든 연결된 기기에서 동기화되므로 터미널, 브라우저 및 휴대폰에서 메시지를 교환 가능하게 보낼 수 있습니다.
- 중단 극복: 노트북이 절전 모드로 전환되거나 네트워크가 끊어지면 컴퓨터가 다시 온라인 상태가 될 때 세션이 자동으로 다시 연결됩니다.
Remote Control에는 Claude Code v2.1.51 이상이 필요합니다.
claude --version으로 버전을 확인하세요.요구 사항
Remote Control을 사용하기 전에 환경이 다음 조건을 충족하는지 확인하세요.- 구독: Pro, Max, Team 및 Enterprise 요금제에서 사용 가능합니다. Team 및 Enterprise 관리자는 먼저 관리자 설정에서 Claude Code를 활성화해야 합니다. API 키는 지원되지 않습니다.
- 인증:
claude를 실행하고 아직 로그인하지 않았다면/login을 사용하여 claude.ai를 통해 로그인하세요. - 작업 공간 신뢰: 작업 공간 신뢰 대화를 수락하려면 프로젝트 디렉토리에서 최소한 한 번
claude를 실행하세요.
Remote Control 세션 시작
새 세션을 Remote Control에서 직접 시작하거나 이미 실행 중인 세션에 연결할 수 있습니다.- 새 세션
- 기존 세션에서
프로젝트 디렉토리로 이동하여 다음을 실행하세요.프로세스는 터미널에서 계속 실행되며 원격 연결을 기다립니다. 다른 기기에서 연결하는 데 사용할 수 있는 세션 URL을 표시하며, 스페이스바를 눌러 휴대폰에서 빠른 액세스를 위한 QR 코드를 표시할 수 있습니다. 원격 세션이 활성화되어 있는 동안 터미널은 연결 상태 및 도구 활동을 표시합니다.이 명령은 다음 플래그를 지원합니다.
--name "My Project": claude.ai/code의 세션 목록에 표시되는 사용자 정의 세션 제목을 설정합니다. 이름을 위치 인수로 전달할 수도 있습니다.claude remote-control "My Project"--verbose: 자세한 연결 및 세션 로그를 표시합니다.--sandbox/--no-sandbox: 세션 중 파일 시스템 및 네트워크 격리를 위해 sandboxing을 활성화하거나 비활성화합니다. 기본적으로 Sandboxing은 꺼져 있습니다.
다른 기기에서 연결
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 servers, 도구 및 프로젝트 구성이 사용 가능하게 유지됩니다. 웹의 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를 통해 흐르는 데이터입니다.