클로드 코드 원격 제어: 어느 기기에서나 로컬 세션 계속하기

Claude Code 원격 제어는 claude.ai/code 또는 Claude 모바일 앱을 사용자의 컴퓨터에서 로컬로 실행 중인 Claude Code 세션에 연결합니다. 책상에서 작업을 시작한 후 휴대폰이나 다른 컴퓨터에서 이어서 작업할 수 있으며, Claude는 전체 시간 동안 로컬에서 계속 실행됩니다—클라우드로 아무것도 이동하지 않습니다.

주요 기능

원격 제어를 사용하면 다음과 같은 작업을 할 수 있습니다:

• 원격에서 전체 로컬 환경 사용: 파일 시스템, MCP 서버, 도구 및 프로젝트 구성이 모두 계속 사용 가능합니다
• 두 인터페이스에서 동시 작업: 대화가 연결된 모든 기기에서 동기화되므로 터미널, 브라우저 및 휴대폰에서 메시지를 교대로 보낼 수 있습니다
• 중단 상황에서도 계속: 노트북이 절전 모드로 전환되거나 네트워크 연결이 끊어져도, 컴퓨터가 다시 온라인 상태가 되면 세션이 자동으로 재연결됩니다

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

요구 사항

원격 제어를 사용하기 전에 사용자 환경이 다음 조건을 충족하는지 확인하세요:

• 구독: Pro 또는 Max 플랜이 필요합니다. API 키는 지원되지 않습니다. 원격 제어는 Team 또는 Enterprise 플랜에서는 사용할 수 없습니다.
• 인증: 아직 로그인하지 않았다면 claude를 실행하고 /login을 사용하여 claude.ai를 통해 로그인하세요
• 작업 공간 신뢰: 프로젝트 디렉터리에서 claude를 최소 한 번 실행하여 작업 공간 신뢰 대화 상자를 수락하세요

원격 제어 세션 시작하기

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

새 세션의 경우 프로젝트 디렉터리로 이동하여 다음을 실행하세요:

claude remote-control

이 프로세스는 터미널에서 계속 실행되며 원격 연결을 기다립니다. 다른 기기에서 연결하는 데 사용할 수 있는 세션 URL을 표시하며, 휴대폰에서 빠르게 접근하기 위한 QR 코드를 표시하려면 스페이스바를 누르세요. 원격 세션이 활성화된 동안 터미널은 연결 상태 및 도구 활동을 표시합니다.

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

• --verbose: 자세한 연결 및 세션 로그 표시
• --sandbox / --no-sandbox: 세션 중 파일 시스템 및 네트워크 격리를 위한 샌드박싱 활성화 또는 비활성화. 샌드박싱은 기본적으로 비활성화되어 있습니다.

이미 Claude Code 세션에 있고 이를 원격으로 계속하려면 /remote-control(또는 /rc) 명령을 사용하세요:

/remote-control

이렇게 하면 현재 대화 기록을 유지하는 원격 제어 세션이 시작되며, 다른 기기에서 연결하는 데 사용할 수 있는 세션 URL과 QR 코드가 표시됩니다. --verbose, --sandbox 및 --no-sandbox 플래그는 이 명령과 함께 사용할 수 없습니다.

/remote-control을 실행하기 전에 /rename을 사용하여 세션에 설명적인 이름을 지정하세요. 이렇게 하면 기기 간 세션 목록에서 더 쉽게 찾을 수 있습니다.

다른 기기에서 연결하기

원격 제어 세션이 활성화되면 다른 기기에서 연결하는 몇 가지 방법이 있습니다:

• 세션 URL을 모든 브라우저에서 열어 claude.ai/code에서 세션으로 직접 이동
• 세션 URL과 함께 표시된 QR 코드를 스캔하여 Claude 앱에서 직접 열기
• claude.ai/code 또는 Claude 앱을 열고 세션 목록에서 이름으로 세션 찾기

원격 제어 세션은 온라인 상태일 때 컴퓨터 아이콘과 녹색 상태 점으로 표시됩니다. 원격 세션의 이름은 마지막 메시지, /rename 값 또는 대화 기록이 없는 경우 "원격 제어 세션"에서 가져옵니다.

환경에 이미 활성 세션이 있는 경우, 이를 계속할지 새로 시작할지 묻는 메시지가 표시됩니다.