터미널에서 작업을 시작한 뒤 휴대폰이나 다른 컴퓨터의 브라우저에서 계속 지시를 내리고 싶다고 가정해 보겠습니다. Anthropic은 이를 위한 두 가지 방법을 문서화하고 있으며, 둘의 실질적인 차이는 작업이 어디에서 실행되느냐입니다. Remote Control은 claude.ai/code 또는 iOS·Android용 Claude 앱을 내 컴퓨터에서 실행 중인 Claude Code 세션에 연결합니다. 코드 실행, 파일, MCP 서버(Claude Code가 연결하는 도구 통합), 프로젝트 설정은 모두 로컬에 그대로 남습니다. 휴대폰이나 브라우저는 그 세션을 들여다보는 창일 뿐이므로 컴퓨터는 켜져 있어야 하고 claude 프로세스도 계속 실행되어야 합니다. 반면 클라우드 세션은 클라우드 인프라(기본값은 Anthropic 관리 인프라)에서 실행되며 노트북을 닫은 뒤에도 계속 진행됩니다. 다만 이는 별개의 세션입니다. CLI에서는 기존 터미널 대화를 클라우드로 올려 보낼 수 없습니다. Anthropic이 제시하는 기준은 이미 진행 중인 로컬 작업을 이어갈 때 Remote Control을 쓰라는 것입니다. 로컬 환경이 준비되어 있지 않거나, 저장소를 클론하지 않았거나, 여러 작업을 병렬로 돌리고 싶다면 클라우드 세션을 쓰면 됩니다.
Remote Control과 클라우드 세션: 세션은 어디서 실행되는가
두 기능은 같은 claude.ai/code 인터페이스를 사용하기 때문에 휴대폰에서는 비슷해 보일 수 있습니다. 문서에 따르면 핵심 차이는 세션이 실행되는 위치입니다. Remote Control은 내 컴퓨터에서 실행되므로 로컬 MCP 서버, 도구, 프로젝트 구성을 그대로 쓸 수 있습니다. 클라우드 세션은 새로운 클라우드 환경에서 시작하며, 코드는 GitHub에서 가져오거나 업로드된 저장소 번들에서 받습니다.
두 기능 모두 CLI에서 기존 터미널 대화를 클라우드로 옮겨 주지는 않습니다. Remote Control에서는 같은 세션이 내 컴퓨터에서 계속 실행됩니다. claude --cloud는 푸시된 브랜치로부터 새롭고 독립된 클라우드 세션을 시작합니다. CLI에서 핸드오프는 한 방향으로만 가능합니다. claude --teleport로 클라우드 세션을 터미널로 끌어올 수 있을 뿐입니다. 로컬 세션을 클라우드로 보내는 방법으로, 클라우드 세션 문서는 Claude Desktop 앱의 Continue in 메뉴를 안내합니다.
플래그 이름이 헷갈리기 쉽습니다. 클라우드 세션 문서에 따르면 --cloud는 클라우드 세션을 만들고, --remote는 그 이전 표기로 현재는 사용 중단(deprecated)된 별칭입니다. --remote-control은 전혀 다른 기능으로, 로컬 세션을 모니터링하고 조종할 수 있게 해 줍니다.
문서화된 차이점. Anthropic의 Remote Control 및 클라우드 세션 페이지 기준(2026년 9월 27일 확인)
| | Remote Control | 클라우드 세션 |
| — | — | — |
| 실행 위치 | 내 컴퓨터(CLI, Desktop 앱 또는 VS Code) | 클라우드 인프라(기본값은 Anthropic 관리) |
| 계속 켜 두어야 하는 것 | 컴퓨터와 claude 프로세스 | 로컬에서는 없음. 노트북을 닫아도 계속 진행 |
| 터미널에서 시작 | claude remote-control, claude --remote-control, 또는 세션 안에서 /remote-control | claude --cloud "task"(새 세션 시작) |
| 명시된 플랜 | Pro, Max, Team, Enterprise. API 키는 지원하지 않음 | Pro, Max, Team. premium 또는 Chat + Claude Code 시트를 가진 Enterprise 사용자 |
| Team/Enterprise 관리자 단계 | Owner가 claude.ai/admin-settings/claude-code에서 Remote Control 토글을 켬 | 조직의 allow_remote_sessions 정책이 켜져 있어야 함. Owner가 claude.ai/admin-settings/claude-code에서 활성화 |
| Zero Data Retention 조직 | 활성화할 수 없음 | 클라우드 세션 기능을 사용할 수 없음 |
Remote Control 요구 사항부터 확인하세요
Anthropic이 명시한 조건은 아래와 같습니다. 일부 조건을 충족하지 못하면 Claude Code가 구체적인 오류 메시지를 표시하며, 해당 메시지와 문서화된 해결책은 마지막 문제 해결 섹션에 정리해 두었습니다.
- claude.ai 계정으로 로그인하세요.
claude를 실행한 뒤/login을 입력합니다.claude setup-token이나CLAUDE_CODE_OAUTH_TOKEN으로 발급한 장기 토큰은 모델 요청만 할 수 있어 Remote Control 세션을 열 수 없습니다. 이 경우claude auth login을 실행하세요. - Anthropic API에 직접 연결해야 합니다. Remote Control은 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry에서는 사용할 수 없습니다.
ANTHROPIC_BASE_URL이 게이트웨이나 프록시를 가리키거나, 엔터프라이즈 Claude apps gateway를 통해 로그인한 경우에도 작동하지 않습니다. - 환경 변수를 확인하세요.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이나DISABLE_GROWTHBOOK이 설정되어 있으면 Remote Control을 쓸 수 없습니다.DISABLE_TELEMETRY나DO_NOT_TRACK만 설정되어 있다면 Claude Code v2.1.283 이상이 필요하며, 조직이 Trusted Devices를 요구하는 경우에는 이 변수들을 해제해야 합니다. - 워크스페이스 신뢰를 수락하세요. 프로젝트 디렉터리에서
claude를 한 번 실행하고 신뢰 대화상자를 수락합니다. 홈 디렉터리에 대한 신뢰는 저장되지 않으므로 프로젝트 폴더에서 시작해야 합니다. - 포트 443으로 Anthropic API에 대한 아웃바운드 접속을 허용하세요. 회사 방화벽이나 프록시 뒤에 있다면 특히 중요합니다.
- Team과 Enterprise에서는 Owner가 먼저 claude.ai/admin-settings/claude-code에서 Remote Control 토글을 켜야 합니다. 건강 데이터를 다루기 위한 컴플라이언스 구성인 HIPAA 구성을 사용하는 조직은 차단됩니다. 이런 조직에서는
/status의 Compliance 행에 HIPAA가 표시되고 관리자 토글이 회색으로 비활성화되며, 문서는 Anthropic 지원팀에 문의하라고 안내합니다.
1단계: 세 가지 CLI 모드 중 하나로 Remote Control 시작하기
인터랙티브 모드(claude --remote-control 또는 --rc)는 원격으로도 조종할 수 있는 일반 터미널 세션을 시작하므로, 양쪽 어디에서든 입력할 수 있습니다.
이미 대화 중이라면 /remote-control(또는 /rc)이 그 세션을 연결하고 대화 기록을 그대로 가져갑니다. “이 대화를 휴대폰으로 옮기고 싶다”는 요구에 대한 가장 직접적인 답입니다.
터미널 밖에서는 VS Code 확장의 프롬프트 입력창이나 Desktop 앱 Code 탭의 로컬 세션에서 /remote-control을 입력합니다. VS Code에서는 입력창 하단에 표시기가 나타나고 세션 URL이 채팅에 게시되지만, 이 명령은 이름 인수를 받지 않고 QR 코드도 보여 주지 않습니다. 두 앱 모두 명령을 다시 실행하면 연결이 끊깁니다.
서버 모드(claude remote-control)는 전용 호스트로 동작합니다. 처음 실행하면 이 모드가 무엇을 하는지 설명하고 y/n으로 확인을 요청합니다. 거절하면 종료되고 다음 실행 때 다시 묻습니다. 수락하면 세션 URL을 출력하고 연결을 기다립니다. 로컬에서 직접 입력할 수는 없지만, 스페이스바를 누르면 휴대폰용 QR 코드가 표시됩니다.
서버 모드 플래그는 remote-control 뒤에 붙이세요. 서브커맨드 앞에 놓인 전역 claude 플래그는 래퍼 스크립트가 추가한 것까지 포함해 서버가 만드는 세션으로 전달되지 않습니다. --verbose, --model처럼 빠져도 세션이 할 수 있는 일에 영향이 없는 몇몇 플래그는 Claude Code가 통과시킵니다. 그 밖의 플래그(예: --settings)를 그 위치에 두면 시작을 거부하며, 오류 메시지가 제거해야 할 플래그를 알려 줍니다. 주요 서버 모드 플래그는 다음과 같습니다.
--spawn same-dir(기본값): 모든 세션이 현재 디렉터리를 공유하므로 같은 파일을 편집하면 충돌할 수 있습니다.--spawn worktree: 필요할 때 생성되는 각 세션이 저장소의 별도 체크아웃인 자체 git worktree를 받습니다.--spawn session: 정확히 하나의 세션만 제공하고 추가 연결은 거부합니다.--capacity <N>: 동시 세션의 최대 개수이며 기본값은 32입니다.--name,--permission-mode,--sandbox/--no-sandbox: 세션 제목, 시작 권한 모드, 샌드박싱을 설정합니다.
# 서버 모드: 원격 연결을 기다림. 스페이스바를 누르면 QR 코드 표시
claude remote-control
# 로컬에서도 입력할 수 있는 인터랙티브 세션(이름은 선택 사항)
claude --remote-control "My Project"
# 실행 중인 세션 안에서: 현재 대화 기록 유지
/remote-control2단계: 휴대폰이나 브라우저에서 연결하기
접속 방법은 세 가지입니다. 아무 브라우저에서나 세션 URL을 열거나, Claude 앱으로 QR 코드를 스캔하거나, claude.ai/code 또는 앱의 Code 탭에서 이름으로 세션을 찾으면 됩니다. 온라인 상태인 세션에는 초록색 점이 붙은 컴퓨터 아이콘이 표시됩니다. 아직 앱이 없다면 /mobile이 해당 앱 스토어로 연결되는 QR 코드를 보여 줍니다.
휴대폰이나 브라우저에서 메시지를 보내고 파일을 첨부할 수 있습니다. 사진은 Claude가 직접 봅니다. 그 밖의 파일은 내 컴퓨터로 다운로드된 뒤 @ 파일 참조로 Claude에 전달됩니다. 서브에이전트와 워크플로의 진행 상황도 동기화되며, 휴대폰에서 작업을 중지하면 컴퓨터에서도 중지됩니다. 연결되어 있는 동안 터미널에는 /rc active 표시기가 나타납니다. /remote-control을 다시 실행하면 URL, QR 코드, 그리고 로컬 세션은 그대로 둔 채 연결만 끊는 옵션이 담긴 패널이 열립니다.
모든 명령이 원격에서 작동하는 것은 아닙니다. /plugin, /resume 같은 터미널 전용 명령은 로컬 CLI에서만 실행됩니다. /compact, /clear, /context, /usage처럼 텍스트를 출력하는 명령은 휴대폰에서도 작동합니다. 보통 선택 화면을 여는 명령은 대신 인수를 받습니다. 예를 들어 /model sonnet이나 /effort high처럼 입력합니다.
모든 세션이 자동으로 연결되게 하려면 /config에서 “Enable Remote Control for all sessions”를 켜거나 사용자 설정에 remoteControlAtStartup을 지정하세요. 저장소에 커밋된 설정 파일은 자동 연결을 끌 수는 있지만 켤 수는 없습니다.
푸시 알림을 받으려면 터미널에서 쓰는 것과 같은 계정·조직으로 앱에 로그인하고 알림을 허용하세요. 그런 다음 /config에서 “Push when Claude decides”, “Push when actions required” 중 하나 또는 둘 다 켜면 됩니다.
제한 사항, 재연결, 데이터 처리
서버 모드가 아닌 경우 Claude Code 인스턴스 하나는 한 번에 하나의 원격 세션만 지원합니다. 터미널을 닫거나 VS Code 또는 Desktop 앱을 종료하거나 claude를 중지하면 세션은 오프라인이 됩니다. 원격 머신에서는 SSH 연결이 끊겨도 세션이 유지되도록 tmux나 screen 안에서 시작하라고 문서는 권장합니다.
Ctrl+C로 서버 모드를 중지한 뒤 같은 디렉터리에서 claude remote-control, claude remote-control --continue, claude remote-control --session-id <id>를 실행하면 세션을 되살릴 수 있습니다. 이 방법은 약 4시간 동안 유효합니다. --remote-control이나 /remote-control로 시작한 세션은 claude --continue 또는 claude --resume으로 되돌아옵니다.
네트워크 문제의 처리 방식은 모드에 따라 다릅니다. 연결된 인터랙티브 세션은 VPN 변경 후 발생할 수 있는 HTTP 403 거부에 대해 최대 3분 동안 재시도합니다. 장애가 더 길어지면 인터랙티브 모드는 네트워크가 복구될 때까지 계속 재시도합니다. 서버 모드는 약 10분 뒤 포기하고 종료합니다.
휴대폰으로 전달된 권한 확인 요청과 질문은 답할 때까지 열려 있습니다. 그 밖의 전달된 대화상자는 기본적으로 5분 뒤 닫히며, dialogExpiry 설정으로 이를 바꿀 수 있습니다.
보안 측면에서, 문서에 따르면 로컬 세션은 아웃바운드 HTTPS 요청만 보내고 인바운드 포트는 열지 않습니다. 트래픽은 TLS로 Anthropic API를 거치며, 각각 단일 용도로만 쓰이는 수명이 짧은 자격 증명을 사용합니다. 주의할 점이 하나 있습니다. 연결되어 있는 동안 트랜스크립트(내 메시지, Claude의 응답, 도구 활동)가 Data usage 정책에 따라 Anthropic 서버에 저장됩니다.
disableRemoteControl 설정을 사용하면 기능을 완전히 끌 수 있습니다. Anthropic이 보관하는 데이터를 제한하는 Zero Data Retention 같은 컴플라이언스 요건이 있는 조직은 Remote Control을 아예 활성화할 수 없습니다. 현재 베타이며 기본적으로 꺼져 있는 Trusted Devices는 두 가지 확인을 추가합니다. 기기가 등록되어 있어야 하고, 로그인한 지 18시간이 넘지 않아야 합니다.
변경 로그에는 버전이나 날짜 없이 관련 추가 사항이 하나 기재되어 있습니다. --remote-control이나 /remote-control로 시작한 세션을 Claude 앱에서 포크할 수 있으며, 포크된 세션은 내 컴퓨터에서 백그라운드 세션으로 실행됩니다.
claude –cloud를 대신 써야 할 때와 시작하는 방법
클라우드 세션은 claude.ai/code(Claude Code on the web이라고도 합니다), 모바일 앱의 Code 탭, Desktop 앱(Local 대신 Cloud 선택), 또는 터미널의 claude --cloud로 시작할 수 있습니다. GitHub에서 클론하려면 저장소 접근 권한이 필요하며, Claude GitHub App을 쓰거나 로컬 gh 토큰을 보내는 /web-setup을 사용합니다. Team과 Enterprise 플랜에서는 Owner가 Quick web setup을 켜기 전까지 /web-setup이 숨겨져 있습니다. 조직의 allow_remote_sessions 정책도 켜져 있어야 하며, Owner가 claude.ai/admin-settings/claude-code에서 활성화합니다.
claude --cloud를 호출할 때마다 새 세션이 시작됩니다. 로컬 체크아웃이 아니라 현재 브랜치 기준의 GitHub 원격 저장소를 클론하므로, 문서는 로컬 커밋을 먼저 푸시하라고 안내합니다. 현재 터미널 대화는 옮겨지지 않고 로컬에 남습니다. 호출 한 번은 저장소 하나를 대상으로 하며, 호출마다 별도의 세션이 생기므로 이것이 곧 작업을 병렬로 돌리는 방법입니다.
두 가지 경우에는 Claude Code가 클론 대신 저장소를 번들로 자동 업로드합니다. 저장소에 git 원격이 전혀 없을 때, 그리고 Claude GitHub App이 설치되지 않은 github.com 저장소일 때입니다. GitLab, Bitbucket 등 GitHub가 아닌 원격은 자동으로 번들되지 않습니다. CCR_FORCE_BUNDLE=1을 설정해야 하며, 이렇게 만든 세션은 결과를 해당 원격으로 푸시할 수 없습니다.
번들에는 모든 브랜치의 전체 기록과 추적 중인 파일의 커밋되지 않은 변경 사항이 포함됩니다. 추적되지 않는 파일은 빠지므로 세션에 필요한 파일은 git add 해 두세요. macOS, Linux, WSL에서는 .env나 *.pem처럼 자격 증명으로 보이는 파일의 커밋되지 않은 변경도 제외됩니다. 저장소에는 커밋이 하나 이상 있어야 하고 번들은 100MB 미만이어야 합니다. 더 큰 저장소는 먼저 현재 브랜치만 번들하고, 그다음 작업 트리를 하나로 합친(squash) 스냅샷으로 대체하며, 그 스냅샷마저 너무 클 때만 업로드가 실패합니다.
클라우드 세션을 터미널로 가져오려면 claude --teleport를 사용합니다. 깨끗한 git 상태, 같은 저장소의 체크아웃, 원격에 푸시된 세션 브랜치, 같은 claude.ai 계정이 필요합니다. 텔레포트한 뒤의 새 작업은 로컬에 머무르므로, 여전히 휴대폰에서 조종하고 싶다면 /remote-control을 실행하세요.
다음과 같은 문서화된 제약을 고려해 계획을 세우세요. 클라우드 세션은 일정 시간 활동이 없으면 멈추고 VM이 회수됩니다. 다시 열면 대화는 복원되지만 실행 중이던 백그라운드 작업은 복원되지 않습니다. 클라우드 세션은 다른 Claude 사용량과 사용량 한도(rate limit)를 공유하며, Anthropic은 VM에 대한 별도 컴퓨팅 요금은 없다고 밝히고 있습니다. 조직이 IP 허용 목록을 사용한다면, Anthropic 지원팀이 예외를 적용해 주기 전까지 Anthropic 호스팅 클라우드 세션은 모두 인증 오류로 실패합니다. /clear는 클라우드 세션에서 작동하지 않으니 사이드바에서 새 세션을 시작하세요.
git push # --cloud는 로컬 체크아웃이 아니라 푸시된 브랜치를 클론함
claude --cloud "Fix the flaky test in auth.spec.ts"
# GitLab, Bitbucket 등 GitHub가 아닌 원격: 번들 업로드 강제
CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"
# 실행 중인 클라우드 세션에 후속 메시지를 넣고 종료
claude -p "your message" --cloud <session-id>
# 클라우드 세션을 이 터미널로 가져오기(선택 화면이 열림)
claude --teleportRemote Control 오류 메시지와 문서화된 해결책
이 가운데 여러 메시지는 문제를 일으킨 변수나 자격 증명을 직접 알려 줍니다. Anthropic의 문제 해결 가이드는 각 메시지를 다음 해결책과 연결합니다.
- “Requires a claude.ai subscription”:
claude auth login을 실행하고 claude.ai를 선택하세요. 메시지에ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKEN,apiKeyHelper가 언급되면 해당 항목을 제거합니다. - “Requires a full-scope login token”: setup-token으로 로그인한 상태입니다.
claude auth login을 실행하세요. - “Isn’t enabled for this account”: 로그아웃 후 다시 로그인하고, Claude Code를 업데이트한 다음,
claude doctor를 실행해 어떤 검사가 실패했는지 확인하세요. - “Requires feature-flag evaluation”: 메시지가 원인 변수를 알려 줍니다.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC이나DISABLE_GROWTHBOOK이면 해제하세요.DISABLE_TELEMETRY나DO_NOT_TRACK이면 v2.1.283 이상으로 업데이트하고, 조직이 Trusted Devices를 요구한다면 변수를 해제하세요. - “Only available when using Claude via api.anthropic.com”: 메시지에 언급된 프로바이더 변수나
ANTHROPIC_BASE_URL을 해제한 뒤 다시 시작하세요. - “Disabled by your organization’s policy”:
disableRemoteControl설정, Pro 또는 Max 플랜인데 예전 Team·Enterprise 로그인이 남아 있는 경우(/status실행), HIPAA 구성, Owner 토글이 꺼져 있는 경우를 확인하세요. - “Remote credentials fetch failed”:
claude remote-control --verbose로 다시 실행한 뒤 로그인 상태와 포트 443 접근을 확인하세요.
- 프로젝트 폴더에서
claude를 한 번 실행하고 신뢰 대화상자를 수락합니다. 그런 다음 API 키나 setup-token이 아닌 claude.ai 계정으로/login을 실행합니다. Team 또는 Enterprise라면 먼저 Owner에게 Remote Control 토글을 켜 달라고 요청하세요. 2. 이미 대화 중이라면/remote-control을 입력해 그 대화를 이어갑니다. 새로 시작한다면, 로컬에서도 입력하고 싶을 때는claude --remote-control을, 여러 세션을 제공하는 호스트가 필요할 때는claude remote-control을 사용합니다. 3. 휴대폰에서 QR 코드를 스캔하거나, Claude 앱의 Code 탭을 열고 초록색 점이 있는 세션을 선택합니다. 4. 컴퓨터가 절전 상태에 들어가지 않게 하고 프로세스를 계속 실행해 둡니다. SSH로 접속했다면 tmux나 screen 안에서 시작하세요. 5. 노트북을 닫아야 하거나 작업이 로컬 도구에 의존하지 않는다면 브랜치를 푸시하고claude --cloud "task"를 실행합니다. 이 명령은 푸시된 브랜치에서 별도의 클라우드 세션을 시작하며, 현재 터미널 대화는 로컬에 그대로 남고 옮겨지지 않습니다.