[Claude] Claude Code Remote Control - 폰에서 클로드 코드(Claude Code) 실행하기

터미널에서 돌리던 Claude Code를 핸드폰에서 그대로 이어서 쓸 수 있다는 거 알고 계셨나요? 

GeekNews에서 흥미로운 글을 봤다. https://news.hada.io/topic?id=26977

 

공식문서 바로가기

Claude Code의 Remote Control 기능을 사용하면 맥에서 돌리고 있는 Claude Code 세션을 폰이나 다른 브라우저에서 원격으로 제어할 수 있다. 

 

아래는 실제로 연결해 본 과정을 정리해 봤다.

---

연결에 들어가기에 앞서 간단하게 Remote Control 기능에 대해 설명하자면, 

Remote Control은 내 맥의 Claude Code를 폰에서 리모컨처럼 조작하는 기능이다.

• 폰: 입력 및 결과 확인
• 맥: 실행 환경(파일 시스템, MCP 서버, 프로젝트 설정)

클라우드가 아니라 내 로컬 환경에서 실행된다.

 

기본 세팅

아래 3가지 모두 충족되어있어야 한다.

구독 플랜	Pro 또는 Max (Team/Enterprise는 미지원)
인증	Claude Code에서 /login으로 로그인 완료
Claude Code	최신 버전 설치 (중요!!! 이유는 맨 아래 "참고하세요" 섹션 확인)

 

연결 방법

1. 세션 생성하기

[ 새로 시작하는 경우 ]

원격으로 제어할 프로젝트로 들어간 후 claude remote-control 명령어를 입력하여 세션에 한다.

cd 프로젝트 폴더
claude remote-control

세션 URL과 함께 QR 코드도 된다. (스페이스바로 QR코드 토글 가능)

 

[ 이미 Claude Code를 실행 중인 경우 ]

실행 중인 세션에서 아래의 명령어로 기존 대화 히스토리를 이어서 계속 대화를 할 수 있다.

/remote-control
# 또는 단축 명령어
/rc

이때도 위의 경우와 마찬가지로 세션 URL과 QR이 표시된다.

 

2. 폰에서 접속하기

방법 1) QR 코드 스캔 (가장 간편하다)

• 폰 카메라로 터미널에 표시된 QR 코드를 스캔
• Claude 앱이 깔려있으면 자동으로 앱으로 연결
  → 이 부분에서 앱에서는 remote control이 작동을 안 해서 앱을 지우니 사파리로 연결되어 그렇게 진행했다!

방법 2) claude.ai/code 접속

• 폰 브라우저에서 claude.ai/code 접속
• 세션 목록에서 컴퓨터 아이콘 + 초록 점이 있는 세션 클릭

방법 3) 세션 URL 직접 열기

• 터미널에 표시된 URL을 복사해서 브라우저에서 열기

 

3. 폰에서 메시지 입력하기

연결이 완료되면 빈 채팅방이 나타난다. 여기에 메시지를 입력하면 맥의 Claude Code가 처리하고 결과를 보내준다.

 

 

간단하게 자바 계산기를 만들기 위해 계획모드로 변경해서 요청하니 아래와 같이 플랜을 선택할 수 있었고 선택한 내용으로 구현이 되었다.

 

 

[ 알아두기 (by 공식문서) ]

• 터미널은 계속 열어둬야 한다. 터미널을 닫으면 세션이 끝난다.
• 네트워크가 10분 이상 끊기면 세션이 타임아웃되어 다시 claude remote-control을 실행하면 된다.
• 노트북이 잠자기 모드에서 깨어나면 자동으로 다시 연결된다.
• Claude Code 인스턴스 하나당 리모트 세션 하나만 된다. 여러 프로젝트를 동시에 원격 제어하려면 인스턴스를 여러 개 띄우면 된다.
• /config에서 "Enable Remote Control for all sessions"를 `true`로 설정하면 매번 명령어 없이 모든 세션에서 자동 활성화된다.
• 로컬 실행: 모든 코드는 내 맥에서 실행되어 파일 시스템, MCP 서버, Hooks 등 로컬 환경을 그대로 사용할 수 있다.
  → 만들어둔 로컬 커스텀 스킬 및 훅 처리도 작동이 잘 된다! (해당 설정은 아래 관련 포스팅 참고)
  

정리

1. `claude remote-control`또는 `/rc`로 세션 시작

2. 폰으로 해당 세션 접속해서 대화(코딩) 하기

 

클로드 코드 리모트 컨트롤을 사용하면 데스크톱에서 시작한 코딩 작업을 폰에서 자연스럽게 이어갈 수 있다. 특히 간단한 수정이나 코드 리뷰는 이제 누워서 폰으로 할 수 있다 ㅎㅎ

 

! 참고하세요 !

[ Session failed: bad option: --sdk-url 에러 ]

 

처음에 claude remote-control을 실행했을 때 아래와 같은 에러가 떴다.

Session failed: /opt/homebrew/Cellar/node/23.10.0_1/bin/node: bad option: --sdk-url

 

해결) Claude Code를 최신 버전으로 업데이트하니 해결되었다. (Remote Control은 새로운 기능이라 구버전에서는 호환 문제가 있다.)

npm update -g @anthropic-ai/claude-code

 

[ 세션 이름 수정 ]

/rc 실행 전에 /rename 세션이름으로 이름을 지정해 두면 나중에 claude.ai/code 세션 목록에서 찾기 훨씬 편하다.

이름을 따로 지정하지 않으면 "Remote Control session"으로 자동 지정되어 세션을 여러 개 등록하는 경우 찾기가 어려웠다.

 

 

관련 포스팅

• [Claude] Claude Code(클로드 코드) 고급 사용법 - Skills, MCP, Hooks, Subagents