클로드 코드 Remote Control 사용법: 휴대폰에서 로컬 작업 이어가는 팁

TL;DR

오늘의 AI 사용 팁

Claude Code Remote Control은 터미널이나 VS Code에서 실행 중인 로컬 Claude Code 세션을 휴대폰, 태블릿, 브라우저에서 이어서 조작하는 기능입니다.

Anthropic 공식 문서 기준으로 Remote Control은 연구 미리보기 기능이며, 세션은 클라우드로 옮겨가는 것이 아니라 사용자의 로컬 머신에서 계속 실행됩니다.

이 기능은 외출 중 새 작업을 시작하는 도구라기보다, 이미 내 컴퓨터에서 돌아가는 작업의 진행 상황을 확인하고 다음 지시나 승인 여부를 빠르게 처리하는 용도로 쓰는 편이 안전합니다.

핵심 3줄 요약

• 핵심 1
  Claude Code Remote Control은 로컬 파일, MCP 서버, 도구 설정, 프로젝트 구성을 유지한 채 다른 기기에서 같은 세션을 이어 쓰게 해줍니다.
• 핵심 2
  시작 전에는 Claude Code 버전, 로그인 상태, 작업 폴더 신뢰 설정, 조직의 Remote Control 허용 여부를 확인해야 합니다.
• 핵심 3
  휴대폰에서 승인 요청을 누를 수 있다는 점이 편리하지만, 파일 수정과 명령 실행은 여전히 내 로컬 환경에서 일어나므로 권한과 보안 확인이 더 중요합니다.

이 글에서 다룰 내용

Claude Code Remote Control이란?

Claude Code Remote Control은 Claude Code를 실행 중인 내 컴퓨터와 Claude 웹 또는 Claude 모바일 앱을 연결해, 다른 기기에서도 같은 로컬 세션을 이어서 볼 수 있게 하는 기능입니다.

중요한 차이는 어디에서 실행되는가입니다. Anthropic 문서는 Remote Control 세션이 사용자의 머신에서 실행되며, 웹과 모바일 인터페이스는 그 세션을 바라보는 창 역할을 한다고 설명합니다. 즉, Claude Code on the web처럼 Anthropic이 관리하는 클라우드 환경에서 새로 실행되는 방식과 다릅니다.

한 문장 정의: 클로드 코드 Remote Control은 내 컴퓨터에서 실행 중인 Claude Code 작업을 휴대폰이나 브라우저에서 이어 조작하는 원격 연결 기능입니다.

마케터나 기획자에게도 의미가 있습니다. 개발자만 쓰는 기능처럼 보이지만, 실제로는 문서 수정, 랜딩 페이지 문구 정리, 데이터 파일 정리, 반복 리포트 자동화처럼 로컬 프로젝트 폴더가 있는 업무에서 “작업은 컴퓨터에서 계속 돌리고, 확인은 다른 기기에서 하는” 흐름을 만들 수 있습니다.

누가 쓰면 좋은가?

첫째, Claude Code를 이미 터미널, VS Code, 데스크톱 앱에서 쓰는 사람에게 좋습니다. Remote Control은 Claude Code 자체를 처음 배우는 기능이라기보다, 이미 열린 작업을 이어 보는 기능에 가깝습니다.

둘째, 긴 작업을 맡긴 뒤 자리를 자주 옮기는 사람에게 유용합니다. 예를 들어 테스트 실행, 여러 파일 검토, 문서 정리, 릴리즈 노트 초안 작성처럼 시간이 걸리는 작업을 시작해 두고 회의실, 소파, 이동 중에 결과만 확인할 수 있습니다.

셋째, 로컬 파일과 도구 구성이 중요한 사람에게 맞습니다. 공식 문서 기준으로 Remote Control은 로컬 파일 시스템, MCP 서버, 도구, 프로젝트 설정을 그대로 사용할 수 있습니다. 회사 프로젝트처럼 로컬 설정이 복잡한 환경에서는 웹 클라우드 세션보다 자연스러운 경우가 있습니다.

넷째, 감자나라ai님처럼 콘텐츠 운영이나 자동화 작업을 반복하는 경우에도 쓸모가 있습니다. 예를 들어 블로그 원고 변환, 상태 파일 확인, 로컬 스크립트 실행, 테스트 결과 요약 같은 작업을 컴퓨터에서 돌려 두고 휴대폰으로 “끝나면 알려줘”, “실패 원인만 정리해줘”처럼 확인할 수 있습니다.

언제 쓰면 좋은가?

Remote Control은 아래 상황에 잘 맞습니다.

1. 컴퓨터에서 Claude Code 작업을 시작해 두고 잠시 자리를 비워야 할 때
2. 테스트, 빌드, 긴 분석처럼 결과가 나오기까지 시간이 걸릴 때
3. 로컬 파일과 MCP 서버를 그대로 써야 해서 클라우드 세션으로 옮기기 애매할 때
4. 휴대폰에서 진행 상황을 확인하고 다음 지시만 짧게 내려야 할 때
5. Claude Code on the web보다 로컬 환경 재현성이 더 중요할 때

반대로 아래 상황에서는 신중해야 합니다.

• 처음 쓰는 저장소에서 권한 구조를 아직 이해하지 못했을 때
• 결제, 고객 정보, 인증 파일처럼 민감한 데이터가 있는 작업
• 휴대폰 화면에서 변경 내용을 충분히 검토하기 어려운 대규모 수정
• 터미널을 닫아도 계속 돌아가는 완전한 클라우드 자동화를 기대하는 경우
• 조직 계정에서 관리자가 Remote Control을 꺼 둔 경우

한 줄 정리

Remote Control은 “밖에서 새 일을 마구 시키는 기능”이 아니라 “내 컴퓨터에서 이미 시작한 일을 안전하게 이어 확인하는 기능”으로 쓰는 편이 좋습니다.

시작 전 확인해야 할 조건

Anthropic 공식 문서 기준으로 Remote Control을 쓰기 전에는 몇 가지 조건을 확인해야 합니다.

첫째, Claude Code 버전입니다. 문서는 Remote Control에 Claude Code 2.1.51 이상이 필요하다고 안내합니다. VS Code에서 쓰는 Remote Control 명령은 더 높은 버전을 요구할 수 있으므로 최신 상태를 유지하는 편이 안전합니다.

둘째, 구독과 조직 설정입니다. 공식 문서는 Remote Control이 연구 미리보기이며 Pro, Max, Team, Enterprise 플랜에서 사용할 수 있다고 안내합니다. Team과 Enterprise에서는 관리자가 설정에서 Remote Control 토글을 켜야 할 수 있습니다. API 키 방식은 지원되지 않습니다.

셋째, 로그인 상태입니다. Claude Code에서 Claude 계정으로 로그인되어 있어야 합니다. 처음 쓰는 환경이라면 Claude Code를 실행한 뒤 로그인 과정을 마쳐야 합니다.

넷째, 작업 폴더 신뢰 설정입니다. 프로젝트 폴더에서 Claude Code를 한 번 실행해 신뢰 확인을 마쳐야 합니다. 로컬 파일을 다루는 기능이므로, 어느 폴더에서 실행하는지가 중요합니다.

다섯째, 네트워크 상태입니다. Remote Control은 로컬 프로세스가 Anthropic API와 연결을 유지하는 방식입니다. 공식 문서에 따르면 장시간 네트워크가 끊기면 세션이 종료될 수 있습니다.

주의

Remote Control을 켠다고 해서 내 컴퓨터가 꺼진 상태에서도 작업이 계속되는 것은 아닙니다. 로컬 Claude Code 프로세스가 실행 중이어야 하며, 터미널이나 VS Code를 닫으면 세션도 끝날 수 있습니다.

휴대폰에서 로컬 작업을 이어가는 순서

1단계: 프로젝트 폴더에서 Claude Code를 엽니다

먼저 실제 작업할 프로젝트 폴더에서 Claude Code를 엽니다. 이때 아무 폴더에서나 실행하지 말고, 수정해도 되는 작업 폴더에서 시작하는 것이 중요합니다. Claude Code는 작업 폴더를 기준으로 파일을 읽고 수정하기 때문입니다.

처음 실행하는 프로젝트라면 신뢰 확인 메시지가 나올 수 있습니다. 이 단계는 귀찮아 보여도 건너뛰면 안 됩니다. Remote Control은 다른 기기에서 같은 세션을 이어 쓰는 기능이므로, 시작 폴더를 잘못 고르면 휴대폰에서도 잘못된 범위를 보게 됩니다.

2단계: 버전과 로그인 상태를 확인합니다

Claude Code 버전이 Remote Control 요구 조건을 만족하는지 확인합니다. 공식 문서에서는 2.1.51 이상을 요구합니다. 휴대폰 알림까지 쓰려면 더 높은 버전이 필요할 수 있으므로 가능하면 최신 버전을 유지하세요.

로그인도 확인합니다. Remote Control은 Claude 앱이나 Claude 웹과 연결되기 때문에 같은 Claude Code 계정으로 로그인되어 있어야 합니다. 조직 계정이라면 관리자 설정도 영향을 줄 수 있습니다.

3단계: Remote Control 세션을 시작합니다

공식 문서 기준으로 Remote Control은 여러 방식으로 시작할 수 있습니다. 터미널에서는 서버 모드로 시작하거나, 기존 대화형 세션에 Remote Control을 붙일 수 있습니다. VS Code에서는 명령 입력창에서 Remote Control 명령을 실행할 수 있습니다.

초보자에게는 “이미 작업을 시작한 세션에서 원격 연결을 켠다”는 방식이 이해하기 쉽습니다. 먼저 Claude Code에게 작은 작업을 맡기고, 진행 중인 세션에서 Remote Control을 켠 뒤 휴대폰이나 브라우저로 연결해 보는 식입니다.

4단계: 휴대폰 또는 브라우저에서 세션을 엽니다

Remote Control 세션이 활성화되면 세션 URL이나 QR 코드, Claude 앱의 Code 영역을 통해 다른 기기에서 연결할 수 있습니다. 공식 문서는 iOS와 Android Claude 앱, 그리고 claude.ai/code 브라우저 인터페이스를 연결 경로로 안내합니다.

처음에는 큰 수정 작업보다 읽기 중심 작업으로 테스트하세요. 예를 들어 “현재 작업 상태를 요약해줘”, “어떤 파일을 보고 있는지 알려줘”, “다음에 승인해야 할 일이 있으면 설명해줘”처럼 확인 위주의 요청이 좋습니다.

5단계: 진행 상황과 승인 요청을 확인합니다

Remote Control의 장점은 이동 중에도 작업 상태를 확인할 수 있다는 점입니다. 특히 긴 테스트나 파일 검토가 끝났을 때, Claude가 다음 승인을 기다리고 있으면 휴대폰에서 빠르게 확인할 수 있습니다.

다만 승인 버튼을 누르기 전에는 어떤 파일을 바꾸는지, 어떤 명령을 실행하는지, 되돌릴 수 있는지 확인해야 합니다. 휴대폰 화면은 좁기 때문에 긴 diff를 꼼꼼히 보기 어렵습니다. 큰 변경은 컴퓨터 앞에서 최종 확인하는 편이 안전합니다.

6단계: 필요하면 모바일 알림을 켭니다

공식 문서는 Remote Control 활성 상태에서 Claude가 휴대폰 푸시 알림을 보낼 수 있다고 안내합니다. 긴 작업이 끝났거나 사용자의 결정이 필요할 때 알림을 받을 수 있습니다.

실전에서는 “테스트가 끝나면 알려줘”, “승인이 필요하면 알림을 보내줘”처럼 요청하면 좋습니다. 다만 알림은 운영체제의 집중 모드, 배터리 최적화, Claude 앱 상태에 따라 늦거나 보이지 않을 수 있으므로 중요한 작업은 직접 세션을 확인하는 습관을 유지하세요.

바로 붙여 쓸 수 있는 요청 문장

작업 시작 요청

아래 프로젝트에서 먼저 읽기 중심으로 상태를 파악해줘. 파일을 수정하지 말고, 어떤 파일을 봐야 하는지와 예상 작업 순서만 정리해줘.

진행 상황 확인 요청

현재 Remote Control 세션에서 진행 중인 작업 상태를 5줄로 요약해줘. 끝난 일, 기다리는 일, 내가 승인해야 할 일, 실패 가능성이 있는 일을 나눠서 알려줘.

승인 전 확인 요청

지금 요청하는 승인 작업이 어떤 파일과 명령에 영향을 주는지 설명해줘. 되돌리는 방법과 실패했을 때 확인할 로그도 함께 알려줘.

휴대폰용 짧은 보고 요청

휴대폰 화면에서 보기 좋게 현재 결과를 짧게 정리해줘. 바뀐 파일, 실행한 확인, 남은 위험, 다음 선택지만 알려줘.

작업 종료 전 점검 요청

세션을 끝내기 전에 변경 파일, 실행한 테스트, 실패한 명령, 아직 확인하지 못한 부분을 체크리스트로 정리해줘.

실전 팁: 처음에는 읽기 전용 점검으로 연습하세요

Remote Control을 처음 켤 때는 파일 수정이나 명령 실행을 바로 맡기지 않는 편이 좋습니다. 먼저 읽기 전용 점검으로 시작하세요.

예를 들어 “현재 폴더 구조를 보고 이 프로젝트가 무엇인지 설명해줘”, “최근 변경 파일을 읽고 위험한 부분을 찾아줘”, “실행하면 좋을 테스트 후보만 추천해줘”처럼 시키면 됩니다. 이 과정에서 Claude Code가 어떤 파일을 읽고, 어떤 방식으로 상태를 설명하는지 익힐 수 있습니다.

그다음 작은 수정으로 넘어가세요. 문구 수정, README 정리, 설정 설명 추가처럼 되돌리기 쉬운 작업이 좋습니다. 큰 코드 변경, 배포, 데이터 삭제, 인증 파일 수정은 Remote Control에 익숙해진 뒤에도 컴퓨터 앞에서 확인하는 편이 안전합니다.

핵심 인사이트

Remote Control의 생산성은 “원격으로 더 많이 시키는 것”보다 “기다리는 시간을 줄이고 승인 대기를 빠르게 처리하는 것”에서 나옵니다.

주의할 점: 로컬에서 실행된다는 뜻을 정확히 이해하세요

Remote Control은 편하지만, 이름 때문에 클라우드 작업처럼 오해하기 쉽습니다. 공식 문서 기준으로 Remote Control은 로컬 머신에서 실행 중인 Claude Code 세션을 웹이나 모바일로 바라보는 방식입니다.

이 말은 두 가지 의미가 있습니다.

첫째, 로컬 설정을 그대로 쓸 수 있습니다. 파일 시스템, MCP 서버, 프로젝트 설정, 개발 도구가 계속 유지됩니다. 복잡한 프로젝트에서는 큰 장점입니다.

둘째, 책임도 로컬에 남습니다. Claude가 파일을 수정하거나 명령을 실행하면 내 컴퓨터에서 일어납니다. 승인 요청을 휴대폰에서 처리하더라도 영향 범위는 로컬 프로젝트입니다.

따라서 민감한 저장소에서는 권한 설정을 보수적으로 유지하세요. Anthropic 보안 문서는 Claude Code가 기본적으로 읽기 전용 권한을 엄격히 사용하고, 파일 수정이나 명령 실행에는 명시적 승인을 요구한다고 설명합니다. 이 원칙을 흐리지 않는 것이 중요합니다.

주의

휴대폰에서 승인할 때는 “어차피 Claude가 알아서 하겠지”라고 넘기지 마세요. 파일 수정, 네트워크 요청, 삭제, 이동, 인증 관련 작업은 작은 화면에서 승인하지 말고 가능한 한 컴퓨터 앞에서 확인하세요.

Remote Control과 Claude Code on the web은 어떻게 다른가?

둘 다 claude.ai/code 화면을 사용할 수 있지만 실행 위치가 다릅니다.

Remote Control은 내 컴퓨터에서 실행됩니다. 로컬 프로젝트, MCP 서버, 도구, 설정이 그대로 필요할 때 적합합니다. 이미 터미널에서 하던 일을 휴대폰에서 이어 보는 느낌에 가깝습니다.

Claude Code on the web은 Anthropic이 관리하는 클라우드 인프라에서 실행됩니다. 로컬 설정 없이 새 작업을 시작하거나, 로컬에 없는 저장소 작업을 맡기거나, 여러 작업을 병렬로 돌리고 싶을 때 더 적합할 수 있습니다.

초보자는 이렇게 구분하면 쉽습니다.

• 내 컴퓨터에서 이미 시작한 작업을 이어 보기: Remote Control
• 클라우드에서 새 작업을 시작하고 나중에 확인하기: Claude Code on the web
• 로컬 파일과 도구 구성이 중요한 작업: Remote Control
• 로컬 환경 없이 GitHub 기반 작업을 시작하는 경우: Claude Code on the web

한 줄 정리

Remote Control은 “로컬 세션을 원격 화면으로 이어 쓰는 방식”이고, Claude Code on the web은 “클라우드에서 별도 세션을 실행하는 방식”입니다.

자주 묻는 질문

Q1. Claude Code Remote Control은 무료 플랜에서도 쓸 수 있나요?

공식 문서 기준으로 Remote Control은 Pro, Max, Team, Enterprise 플랜에서 사용할 수 있습니다. Team과 Enterprise에서는 관리자가 Remote Control을 켜야 할 수 있고, API 키 방식은 지원되지 않는다고 안내되어 있습니다. 계정 화면과 조직 설정을 함께 확인해야 합니다.

Q2. 휴대폰에서 Claude Code가 내 컴퓨터 파일을 직접 바꾸나요?

정확히는 휴대폰이 파일을 바꾸는 것이 아니라, 휴대폰 화면을 통해 내 컴퓨터에서 실행 중인 Claude Code 세션에 지시를 보내는 방식입니다. 파일 수정과 명령 실행은 로컬 머신에서 일어납니다.

Q3. 터미널을 닫아도 계속 돌아가나요?

아닙니다. 공식 문서는 Remote Control이 로컬 프로세스로 실행되며, 터미널이나 VS Code 또는 Claude 프로세스를 닫으면 세션이 끝날 수 있다고 안내합니다. 컴퓨터가 켜져 있고 프로세스가 실행 중이어야 합니다.

Q4. Claude Code on the web과 어떤 것을 써야 하나요?

이미 로컬에서 작업 중이고 로컬 파일, MCP 서버, 프로젝트 설정이 중요하면 Remote Control이 맞습니다. 로컬 환경 없이 클라우드에서 새 작업을 시작하거나 여러 작업을 병렬로 돌리고 싶다면 Claude Code on the web이 더 맞을 수 있습니다.

Q5. 승인 요청은 휴대폰에서 눌러도 안전한가요?

작은 읽기 작업이나 명확한 수정은 가능하지만, 중요한 명령 실행과 대규모 파일 변경은 컴퓨터 앞에서 확인하는 편이 안전합니다. 승인 전에는 바뀌는 파일, 실행 명령, 되돌리는 방법, 실패 시 확인할 로그를 Claude에게 먼저 설명하게 하세요.

Q6. 모바일 알림은 꼭 켜야 하나요?

필수는 아닙니다. 다만 긴 작업이 끝났거나 Claude가 결정을 기다릴 때 알림을 받을 수 있어 편리합니다. 공식 문서 기준으로 모바일 푸시 알림은 별도 버전 조건과 앱 설정, 운영체제 알림 권한의 영향을 받습니다.

출처

마무리

클로드 코드 Remote Control 사용법의 핵심은 휴대폰에서 모든 일을 새로 시작하는 것이 아니라, 내 컴퓨터에서 이미 돌아가는 Claude Code 세션을 이어 확인하는 것입니다. 그래서 생산성의 중심은 “원격 실행”보다 “대기 시간 줄이기, 승인 지연 줄이기, 긴 작업 결과 빨리 확인하기”에 있습니다.

처음에는 작은 프로젝트에서 읽기 전용 점검으로 시작하세요. 그다음 문서 수정, 테스트 결과 요약, 변경 파일 설명처럼 되돌리기 쉬운 작업으로 넓히면 됩니다. Remote Control을 로컬 실행 방식으로 정확히 이해하면, Claude Code를 책상 앞에서만 쓰는 도구가 아니라 이동 중에도 이어 확인할 수 있는 업무 보조 흐름으로 만들 수 있습니다.