쓸모 쓸모연구소 · 실전 노트
제 825 호이번 주 새 글 49 편2026 · 11 · 14
클로드 코드
Claude

클로드 코드 리모트 컨트롤 사용법, 터미널⁠·데스크톱⁠·폰을 한 세션으로 쓰기

클로드 코드 리모트 컨트롤(Remote Control)은 내 컴퓨터 터미널에서 돌고 있는 클로드 코드 세션을 폰, 브라우저, 다른 기기에서 이어 쓰게 해 주는 기능입니다. 새 세션을 만드는 것이 아니라 하나의 세션을 여러 화면이 같이 보는 방식입니다. 준비물과 켜는 명령, 폰에서 이어 쓰는 순서, 끄는 법과 막힐 때 확인할 점을 정리했습니다. 기준은 2026년 11월 공식 문서입니다.

클로드 코드 리모트 컨트롤 사용법, 터미널·데스크톱·폰을 한 세션으로 쓰기 삽화
삽화 · 쓸모연구소

리모트 컨트롤이 하는 일과 준비물

리모트 컨트롤을 켜면 claude.ai/code 웹 페이지나 클로드 모바일 앱(iOS, 안드로이드)이 내 컴퓨터에서 실행 중인 클로드 코드 세션에 붙습니다. 클로드는 계속 내 컴퓨터에서 돌아서 파일 접근과 코드 실행은 그 컴퓨터 안에서 일어나고, 웹과 폰은 그 세션을 들여다보는 창 역할을 합니다. 터미널, 브라우저, 폰 어디서 메시지를 보내도 대화가 같이 맞춰집니다. 노트북이 잠들거나 네트워크가 끊겨도 컴퓨터가 다시 연결되면 자동으로 이어집니다.

준비물은 다음과 같습니다.

  • 터미널에서 쓰는 클로드 코드. claude를 실행해 /login으로 claude.ai 계정에 로그인한 상태여야 합니다.
  • Pro, Max, Ultra, Team, Enterprise 요금제. API 키 로그인은 지원하지 않습니다. Team과 Enterprise는 소유자가 관리 설정에서 리모트 컨트롤을 먼저 켜야 합니다.
  • 폰의 클로드 앱. 아직 없으면 클로드 코드 안에서 /mobile을 입력하면 앱 설치용 QR 코드가 나옵니다.
  • 리모트 컨트롤이 도는 동안 켜져 있는 컴퓨터. 컴퓨터를 끄거나 claude 프로세스를 닫으면 폰에서도 세션이 끊깁니다.

Amazon Bedrock 같은 클라우드 사업자 경로, 다른 주소로 보내는 ANTHROPIC_BASE_URL 설정, 일부 기업용 게이트웨이 환경에서는 쓸 수 없습니다.

터미널에서 켜고 데스크톱⁠·폰에서 이어 쓰기

  1. 터미널에서 프로젝트 폴더로 이동해 클로드 코드를 실행합니다. 확인: 클로드 코드 입력창이 열립니다.
  2. 확인용으로 "하이"라고 입력합니다. 확인: 이 세션에 대화가 하나 생깁니다. 다른 화면에서 이 대화가 그대로 보이게 하는 것이 목표입니다.
  3. 리모트 컨트롤 명령을 입력합니다. 이름은 뒤에 붙여도 되고 생략해도 됩니다. 확인: 상태 표시 /rc active가 보이고 세션 주소가 나옵니다. 처음 켤 때는 한 번 동의 창이 뜨니 "Enable Remote Control"을 고릅니다.
프롬프트
/remote-control 안녕테스트

/remote-control 대신 짧은 이름 /rc도 됩니다. 이미 진행 중인 대화가 있으면 그 대화 내용이 그대로 넘어갑니다.

  1. 데스크톱에서 이어 가려면 claude.ai/code를 브라우저로 열거나, 클로드 데스크톱 앱의 세션 목록에서 같은 이름의 세션을 찾습니다. 확인: 터미널과 같은 대화가 보입니다. 공식 문서가 확실하게 안내하는 곳은 claude.ai/code와 모바일 앱이고, 데스크톱 앱 목록에 보이는지는 앱 버전에 따라 다를 수 있습니다.
  2. 데스크톱에서 메시지를 입력하고 엔터를 칩니다. 확인: 터미널에도 같은 메시지가 나타납니다.
  3. 폰의 클로드 앱에서 탐색 메뉴의 Code를 눌러 세션 목록을 엽니다. 켜진 세션에는 컴퓨터 아이콘과 초록색 점이 붙습니다. 이름이 안녕테스트인 세션을 엽니다. 확인: 같은 세션 대화가 열립니다. 세션 주소의 QR 코드를 폰으로 찍어 바로 열어도 됩니다.
  4. 폰에서 메시지를 보냅니다. 확인: 메시지가 전송됩니다.
  5. 터미널과 데스크톱에도 같은 메시지가 들어왔는지 봅니다. 확인: 세 곳에 같은 대화가 뜹니다.

앞에서 이름을 생략하면 컴퓨터 이름에 무작위 단어가 붙은 이름(myhost-graceful-unicorn 같은 형태)으로 만들어집니다. 폰에서 찾기 쉽도록 이름을 붙이는 편이 낫습니다. 이름은 /remote-control 뒤에 쓰거나 /rename으로 정한 제목이 쓰입니다.

시작하는 방법 세 가지

  • 이미 쓰던 세션에서 켜기: 위에서 쓴 /remote-control(또는 /rc).
  • 처음부터 켜서 시작하기: claude --remote-control "내 프로젝트" (줄여서 --rc). 터미널에서 직접 입력하면서 폰에서도 보는 일반 세션입니다.
  • 서버 모드: claude remote-control. 터미널은 연결만 지키고 여러 세션을 폰과 웹에서 여는 방식입니다. 스페이스바를 누르면 QR 코드가 나오고, --name으로 세션 이름, --spawn worktree로 세션마다 별도 작업 폴더를 줄 수 있습니다.

모든 세션을 자동으로 연결하려면 /config에서 "Enable Remote Control for all sessions"를 켭니다. 켜 두면 클로드 코드를 실행할 때마다 세션이 하나씩 등록되니 필요할 때만 쓰는 편이 안전합니다.

폰에서 할 수 있는 것

  • 사진이나 파일을 붙여 보낼 수 있습니다. 사진은 클로드가 직접 보고, 다른 파일은 컴퓨터로 내려받아 @ 파일 참조로 전달됩니다.
  • 모델을 폰에서 바꿀 수 있습니다(클로드 코드 v2.1.238 이상). 같은 화면의 에포트 선택이나 /effort로 추론 단계도 정할 수 있습니다.
  • 진행 중인 서브 에이전트와 워크플로의 상태도 같이 보이고, 폰에서 멈추면 컴퓨터에서도 멈춥니다.

연결 끄기와 다시 붙이기

  • 연결만 끊기: 켜진 세션에서 /remote-control을 다시 입력하면 상태 패널이 열리고, 여기서 연결을 끊을 수 있습니다. 로컬 세션은 계속 돕니다.
  • 서버 모드 끄기: 터미널에서 Ctrl+C를 누릅니다. 약 4시간 안에는 같은 폴더에서 claude remote-control --continue로 세션을 되살릴 수 있습니다.
  • 기능 자체를 막기: 설정의 disableRemoteControl을 사용합니다.

보안과 막힐 때

내 컴퓨터는 바깥으로 나가는 HTTPS 요청만 보내고 외부에서 들어오는 포트를 열지 않습니다. 대신 연결된 동안 대화 내용(메시지, 응답, 도구 사용 기록)이 앤트로픽 서버에 저장됩니다. 보존 기간은 앤트로픽의 데이터 이용 정책을 따르고, 제로 데이터 보존이나 HIPAA 설정을 쓰는 조직에서는 켤 수 없습니다.

  • 폰에 세션이 안 보인다: 같은 claude.ai 계정으로 로그인했는지, 터미널에서 /rc active가 떠 있는지 확인합니다.
  • Remote Control is disabled by your organization's policy가 나온다: Team이나 Enterprise 관리자가 기능을 꺼 둔 것입니다.
  • 연결이 끊겼다: 터미널에서 /remote-control을 다시 입력합니다.
  • 환경 변수 DISABLE_GROWTHBOOK이나 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC가 설정돼 있으면 리모트 컨트롤을 쓸 수 없습니다. 해제하고 다시 시도합니다.

자주 묻는 질문

리모트 컨트롤은 클라우드 세션과 어떻게 다른가요?

리모트 컨트롤은 내 컴퓨터에서 클로드가 계속 돌고 웹과 폰은 그 화면을 보는 창입니다. 클라우드 세션은 앤트로픽의 클라우드에서 작업이 돌아가 내 컴퓨터가 꺼져 있어도 진행됩니다. 내 컴퓨터의 파일과 도구를 그대로 쓰려면 리모트 컨트롤이 맞습니다.

폰에서 보낸 메시지가 터미널에도 들어가나요?

들어갑니다. 터미널, 브라우저, 폰 어디서 보내도 같은 세션에 쌓여 모든 화면에서 같이 보입니다. 여러 화면을 번갈아 써도 대화는 하나로 이어집니다.

리모트 컨트롤을 쓰려면 컴퓨터를 계속 켜 둬야 하나요?

네. 클로드는 내 컴퓨터에서 도는 것이어서 컴퓨터가 꺼지거나 claude 프로세스를 닫으면 폰에서도 세션이 끊깁니다. 잠자기 상태에서 깨어나면 자동으로 다시 연결됩니다.

API 키로 쓰는 클로드 코드에서도 되나요?

되지 않습니다. 리모트 컨트롤은 claude.ai 구독 로그인이 필요하고 API 키는 지원하지 않습니다. /login으로 구독 계정에 로그인한 상태에서 켜야 합니다.

이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.

원본 영상 보러가기 ↗