Claude Code Remote Control: 모바일 이어받기를 worktree로 안전하게 여는 법 | DAKER 커뮤니티

Claude Code Remote Control: 모바일 이어받기를 worktree로 안전하게 여는 법

Claude Code Remote Control이란, 로컬에서 실행 중인 Claude Code 세션을 claude.ai/code나 모바일 앱에서 이어 조작하는 기능입니다. 2026년 6월 25일 기준 공식 문서는 Remote Control을 research preview로 설명하며, 팀 사용자는 관리자 설정과 worktree 격리를 함께 확인해야 합니다.

클로드 코드 Remote Control 모바일 worktree 세션 대표 카드

_클로드 코드 Remote Control을 켜고 모바일, 브라우저, 로컬 터미널이 같은 세션을 이어받는 흐름._

Claude Code Remote Control은 언제 쓰면 좋나요?

한 줄 요약: 빌드와 파일 접근은 내 컴퓨터에 두고, 입력 화면만 브라우저나 휴대폰으로 옮기고 싶을 때 씁니다.

긴 테스트를 돌려 놓고 자리를 옮기거나, PR 리뷰 중 이동하면서 다음 지시만 보내야 할 때 유용합니다. 공식 문서 기준 Remote Control 세션은 cloud 환경으로 프로젝트를 복사하는 방식이 아니라 로컬 세션을 원격 화면에서 조작하는 방식입니다. 그래서 filesystem, MCP 서버, 프로젝트 설정은 로컬에 남고, 원격 화면은 그 세션을 보는 창에 가깝습니다.

DAKER의 worktree 병렬 세션 안전 가이드는 여러 작업을 분리하는 기준을 다뤘고, auto mode git 안전장치는 자동 실행 중 로컬 변경을 지키는 법을 정리했습니다. 이번 글은 같은 원칙을 Remote Control에 적용합니다.

same-dir와 worktree 중 무엇을 골라야 하나요?

Remote Control 서버 모드는 새 원격 세션을 만들 때 same-dir, worktree, session 중 하나로 동작할 수 있습니다. 핵심 질문은 "여러 원격 입력이 같은 작업 디렉터리를 동시에 만져도 되는가"입니다.

선택지	맞는 상황	주의할 점
`same-dir`	한 사람이 한 작업을 이어받는 단순 세션	여러 세션이 같은 파일을 바꾸면 충돌이 날 수 있음
`worktree`	원격에서 여러 작업을 병렬로 열 가능성이 있음	git 저장소가 필요하고 정리 규칙이 필요함
`session`	정확히 하나의 세션만 열고 싶음	추가 연결을 거절하므로 팀 대기열에는 맞지 않음

팀에서는 기본값을 편하다고 그대로 쓰기보다, 병렬 가능성이 있으면 --spawn worktree를 먼저 검토하세요. 모바일에서 "간단히 하나만 고치기"라고 시작한 작업도 테스트 실패, 문서 수정, 핫픽스 검토로 갈라질 수 있습니다.

단계별 사용법: 모바일에서 안전하게 이어받으려면?

로컬 프로젝트에서 claude --version을 확인합니다. Remote Control은 공식 문서 기준 v2.1.51 이상이 필요합니다.
claude를 한 번 실행해 로그인과 workspace trust를 완료합니다.
Team 또는 Enterprise 환경이면 관리자가 Remote Control 토글을 켰는지 확인합니다.
단일 세션이면 claude --remote-control "프로젝트명"으로 시작합니다.
여러 원격 세션을 열 수 있다면 claude remote-control --spawn worktree --name "프로젝트명"처럼 서버 모드를 검토합니다.
세션 URL이나 QR 코드로 claude.ai/code 또는 모바일 앱에서 접속합니다.
작업 전 git status --short와 현재 branch/worktree 이름을 먼저 확인하게 합니다.
완료 후 테스트 결과, 변경 파일, 남은 위험을 세션 마지막 메시지에 남깁니다.

클로드 코드 Remote Control worktree 충돌 방지 체크리스트

_Remote Control 서버 모드에서 same-dir와 worktree를 나누고 세션 충돌을 줄이는 운영 체크리스트._

짧은 예시: 원격 세션 시작 문구는 어떻게 쓰나요?

이 Remote Control 세션은 모바일에서 이어받을 수 있다.

작업 전 확인:
- 현재 branch와 worktree 이름
- git status --short
- 진행 중인 테스트나 서버 프로세스
- 같은 파일을 만질 다른 세션이 있는지

파일 수정 전에는 계획을 한 번 요약하고, 완료 후에는 실행한 검증과 남은 리스크를 마지막에 적어줘.

이 문구는 모바일 화면에서 긴 설명을 줄이는 데도 도움이 됩니다. 원격 입력은 짧아질 수밖에 없으므로, 세션 시작 시 안전 규칙을 먼저 박아 두는 편이 낫습니다.

팀 적용 체크리스트는 무엇인가요?

Pro, Max, Team, Enterprise 등 지원 플랜과 로그인 방식을 확인했는가
Team/Enterprise에서는 관리자 Remote Control 토글을 확인했는가
원격 세션 이름 규칙을 정했는가
같은 디렉터리를 공유하는 same-dir 위험을 문서화했는가
병렬 가능성이 있으면 --spawn worktree를 기본 후보로 검토했는가
모바일 입력으로 위험 명령을 보내지 않도록 sandbox와 permission mode를 함께 점검했는가
세션 종료 전 테스트 증거와 다음 행동을 남기는가

공식 출처는 어디에서 확인했나요?

2026년 6월 25일 기준 Claude Code Remote Control documentation, VS Code integration documentation, worktrees documentation을 확인했습니다. 공개 본문에는 DAKER 운영 정책에 맞춰 DAKER 내부 링크만 연결했습니다.

FAQ

Remote Control은 Claude Code on the web과 같은 기능인가요?

아닙니다. Remote Control은 로컬 머신에서 실행 중인 세션을 원격 화면으로 조작합니다. Claude Code on the web은 Anthropic 관리 클라우드 환경에서 실행되는 흐름과 구분해야 합니다.

모바일에서 실행하면 코드가 휴대폰으로 복사되나요?

공식 문서 기준 Remote Control은 로컬 세션을 조작하는 방식입니다. 프로젝트 파일과 도구는 로컬 머신에 남고, 브라우저나 모바일 앱은 연결된 세션을 보는 창으로 동작합니다.

왜 worktree가 필요한가요?

여러 세션이 같은 디렉터리에서 동시에 파일을 수정하면 충돌과 덮어쓰기가 생길 수 있습니다. --spawn worktree는 원격 세션별 작업 경계를 분리하는 데 유용합니다.

Remote Control을 켜면 자동 실행이 안전해지나요?

아닙니다. Remote Control은 접속 표면이고, 실행 안전은 permission mode, sandbox, git 상태 점검, 팀 승인 규칙으로 따로 관리해야 합니다.

다음에 이동 중 코딩 세션을 이어받을 때는 먼저 same-dir로 충분한지, 아니면 worktree로 분리해야 하는지부터 정해 보세요.