Claude Code 사용법: Remote Control로 모바일에서 작업 이어가기

이미 열려 있는 세션이라면 /remote-control로 시작합니다. 터미널에서 새 대화를 시작하려면 claude --remote-control을, 원격 작업을 기다리는 서버를 띄우려면 claude remote-control을 사용합니다. 시작 방식은 다르지만, 작업을 로컬에서 실행한다는 점은 같습니다. 세 가지 방식 모두 Anthropic의 Remote Control 가이드에 설명되어 있습니다.

Claude Code Remote Control은 누가 사용할 수 있나요?

공식 문서의 이용 조건은 **“Pro, Max, Team, Enterprise 요금제에서 사용할 수 있습니다. API 키는 지원하지 않습니다.”**입니다. Team과 Enterprise에서는 Claude Code 관리자 설정에서 “Owner가 먼저 Remote Control 토글을 켜야 합니다.” 이 조직 설정은 기본적으로 꺼져 있습니다. 출처: 이용 조건.

시작하기 전에 Claude 계정으로 로그인합니다. claude를 실행한 뒤 /login을 입력하면 됩니다. API 사용료를 내는 것만으로는 이 조건을 충족하지 못합니다. 구독 계정으로 로그인해 둔 상태라도, 별도로 설정한 인증 정보가 우선 적용될 수 있습니다. 이 차이는 아래 문제 해결 부분에서 다룹니다.

Remote Control은 Anthropic API에 직접 연결해야 합니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry는 지원하지 않습니다. ANTHROPIC_BASE_URL을 api.anthropic.com 이외의 주소로 지정한 경우나 기업용 Claude 앱 게이트웨이를 통해 로그인한 경우도 지원하지 않습니다. 출처: 연결 조건.

요금제 비용은 Claude Code 요금 안내를 참고하면 됩니다. 원격 접속으로 달라지는 것은 작업을 확인하고 지시하는 위치입니다. 실제 실행은 기존에 사용하던 컴퓨터에서 계속 이루어집니다.

Claude Code 사용법: 상황에 맞는 Remote Control 시작 방식

가장 빠른 설정 방법은 새 작업을 시작하는지, 진행 중인 작업을 이어 가는지에 따라 달라집니다.

표의 앞 세 행은 CLI의 세 가지 실행 방식입니다. VS Code와 Desktop에서는 각 앱의 진입점을 이용합니다. 출처: 시작 방식.

프로젝트 디렉터리에서 서버 시작하기

작업할 프로젝트가 있는 디렉터리에서 다음 명령을 실행합니다.

claude remote-control

Remote Control을 처음 사용할 때 확인 메시지가 나타나면 승인합니다. 그러면 프로세스가 세션 URL을 출력하고 연결을 기다립니다. 스페이스바를 누르면 QR 코드가 표시됩니다. 이 터미널은 계속 실행해 두어야 합니다.

서버 모드에서는 연결 상태와 툴 실행 내역을 확인할 수 있습니다. 같은 터미널에서 프롬프트도 입력하려면 아래의 대화형 모드를 선택합니다. 원격 세션 목록에서 쉽게 알아볼 이름을 붙이려면 remote-control 뒤에 --name "My Project"를 추가합니다. 출처: 서버 시작.

새 대화형 세션 시작하기

claude --remote-control 또는 축약형인 claude --rc를 사용합니다. 로컬에서 계속 입력하면서 스마트폰이나 브라우저로도 같은 세션에 접속할 수 있습니다. claude --remote-control "My Project"처럼 플래그 뒤에 이름을 붙일 수도 있습니다.

책상에서 작업을 시작한 뒤 중간에 자리를 비우는 개발자라면 이 방식이 유용합니다. 출처: 대화형 세션 시작.

진행 중인 대화에 연결하기

세션 안에서 /remote-control 또는 /rc를 입력합니다. 처음 연결한다면 기능 활성화 대화상자에서 승인합니다. 기존 대화 기록은 그대로 이어집니다. CLI에서는 /remote-control My Project로 세션 이름도 지정할 수 있습니다.

연결되면 터미널에 /rc active 표시가 나타날 수 있습니다. /remote-control을 다시 실행하면 URL, QR 코드, 연결 해제 기능이 있는 상태 패널이 열립니다. 여기서 원격 연결을 끊어도 로컬 대화는 계속 실행됩니다. 터미널 폭이 좁으면 연결 표시가 보이지 않을 수 있습니다. 출처: 연결 상태.

VS Code 또는 Desktop에서 시작하기

Claude Code VS Code 확장에서는 프롬프트 입력란에 /remote-control 또는 /rc를 입력합니다. 하단의 연결 표시를 누르면 연결된 세션이 열리며, 대화에도 세션 URL이 표시됩니다. VS Code에서는 이 명령에 세션 이름 인수를 붙일 수 없고 QR 코드도 표시되지 않습니다. 명령을 다시 실행하면 연결이 해제됩니다.

Claude Desktop에서는 Code 탭의 로컬 세션에서 같은 명령을 사용합니다. 연결된 세션은 claude.ai/code에서 찾을 수 있으며, 명령을 반복하면 연결이 해제됩니다. Desktop에는 세션별 Remote Control 스위치도 있습니다. 출처: 앱에서 시작하기, Desktop 제어 기능.

작업용 컴퓨터에서 작업 공간 신뢰 승인하기

작업 공간 신뢰 승인은 로그인이나 조직의 Remote Control 사용 허용과 별개입니다. Claude Code가 사용하려는 디렉터리를 신뢰할지 결정하는 절차입니다.

서버 모드에서 아직 신뢰하지 않은 디렉터리를 만나면, 해당 디렉터리를 신뢰할 때 무엇이 허용되는지 설명하고 확인을 요청합니다. 승인하면 선택이 저장됩니다. 단, 홈 디렉터리에서는 실행할 때마다 다시 확인합니다.

이 확인 절차에는 실제 터미널이 필요합니다. 표준 입력이나 출력을 리디렉션한 상태에서는 Claude Code가 확인을 요청할 수 없어 작업 공간 신뢰 오류와 함께 종료됩니다. 공식 문서가 안내하는 해결 방법은 해당 디렉터리에서 먼저 claude를 실행해 신뢰를 승인하거나, 터미널에서 claude remote-control을 직접 실행하고 확인 메시지에 응답하는 것입니다. 출처: 작업 공간 신뢰 오류.

스마트폰이나 다른 브라우저에서 접속하기

세션 URL을 열면 브라우저에서 바로 접속할 수 있습니다. 또는 claude.ai/code에서 이름으로 세션을 선택합니다.

스마트폰에서는 iOS 또는 Android용 공식 Claude 앱에 Claude 계정으로 로그인합니다. Code를 누르면 세션 목록이 나옵니다. 온라인 상태인 Remote Control 세션에는 컴퓨터 아이콘과 초록색 상태 점이 표시됩니다. 세션 QR 코드를 스캔해 앱에서 열 수도 있습니다. 출처: 기기 연결.

처음에는 작업용 컴퓨터 앞에서 스마트폰으로 짧은 후속 메시지를 보내 보는 것이 좋습니다. 자리를 비우기 전에 원하는 대화에 제대로 연결되었는지 확인할 수 있습니다.

프롬프트는 어느 쪽에서든 보낼 수 있습니다. 연결된 기기에는 세션 안에서 보조 작업을 수행하는 서브에이전트와 백그라운드 워크플로도 표시됩니다. 원격으로 이 중 하나를 중지하면 작업용 컴퓨터에서도 해당 작업이 멈춥니다. 출처: 연결 기기의 동작.

무엇이 로컬에 남고, 무엇이 Anthropic을 거치나요?

실제 작업장은 여전히 내 컴퓨터입니다. 스마트폰과 브라우저는 그 작업장을 제어하는 또 다른 창구가 됩니다.

로컬 파일 시스템, 툴, 프로젝트 설정, MCP 서버를 그대로 사용할 수 있습니다. MCP 서버는 Claude가 추가 툴이나 데이터에 접근하도록 연결해 주는 역할을 합니다. 원격으로 세션을 이어 가기 위해 기존 로컬 환경을 별도의 클라우드에 다시 구성할 필요가 없습니다. 출처: 로컬 환경.

로컬에서 실행한다고 해서 모든 세션 데이터가 로컬에만 남는 것은 아닙니다. Anthropic은 기기 간 동기화와 재연결을 위해 사용자의 메시지, Claude의 응답, 툴 실행 내역을 포함한 대화 기록을 저장합니다. 연결에는 TLS 기반 아웃바운드 HTTPS와 유효기간이 짧은 인증 정보를 사용하며, 컴퓨터에 인바운드 포트를 열지 않습니다. 출처: 연결과 보안.

Zero Data Retention 또는 HIPAA 구성을 사용하는 조직은 Remote Control을 활성화할 수 없습니다. disableRemoteControl 설정으로도 기능을 차단할 수 있습니다. 출처: 접근 제한.

작업 공간 신뢰와 Trusted Devices는 어떻게 다른가요?

작업 공간 신뢰는 코드를 실행하는 컴퓨터의 디렉터리를 승인하는 절차입니다. Trusted Devices는 세션을 보거나 제어하는 기기에 적용할 수 있는 선택 사항으로, 베타 단계의 접근 요건입니다.

이 요건을 켜면 각 기기를 등록해야 하며, 기기 인증 후 18시간이 지나지 않아야 합니다. 생체 인증이나 패스키 확인으로 접근 권한을 갱신할 수 있습니다. Team과 Enterprise에서는 Owner가 Organization settings > Capabilities > Remote sessions에서 이 요건을 별도로 활성화합니다. Remote Control 자체를 켜는 토글과는 다른 설정입니다. 출처: Trusted Devices.

원격 접속과 알림을 매번 편하게 사용하도록 설정하기

자주 사용한다면 세션마다 명령을 입력하는 대신 자동 연결을 켤 수 있습니다.

• CLI: /config를 열고 Enable Remote Control for all sessions를 켭니다.
• VS Code: 명령 메뉴의 Settings 영역에서 같은 설정을 찾습니다.
• Desktop: Settings > Claude Code > Connect new sessions to Remote Control을 사용합니다.

이에 대응하는 remoteControlAtStartup 설정은 사용자 설정이나 관리형 설정에서 자동 연결을 켤 수 있게 합니다. 저장소의 프로젝트 설정이나 로컬 설정에서는 자동 연결을 끌 수 있지만, 그 저장소를 여는 모든 사용자에게 자동 연결을 켜 줄 수는 없습니다. 자동 연결에는 본인 계정이 사용됩니다. 출처: 시작 설정, VS Code 설정, Desktop 설정.

스마트폰 알림을 받으려면 Claude 앱을 설치하고, 터미널과 같은 계정 및 조직으로 접속한 뒤 운영체제의 알림 권한을 허용합니다. 터미널의 /config에서 Push when Claude decides, Push when actions required 중 하나 또는 둘 다 켭니다. 능동적인 푸시 알림을 보낼 시점은 Claude가 판단합니다. 작업이 끝나면 알려 달라고 요청할 수는 있지만, 이벤트별로 알림을 설정하는 기능은 없습니다. 출처: 모바일 알림.

오류 메시지에 맞춰 원인 해결하기

먼저 Claude Code가 출력한 실패 원인을 확인합니다. 대화형 세션은 Remote Control 연결에 실패해도 로컬에서 계속 작동할 수 있습니다. 따라서 터미널이 정상 작동한다는 사실만으로 원격 접속까지 활성화되었다고 볼 수는 없습니다.

이용 조건에 맞는 로그인이 없거나 다른 인증 정보가 우선 적용될 때

claude auth login을 실행하고 claude.ai 로그인 옵션을 선택합니다. 오류 메시지에 ANTHROPIC_API_KEY 또는 ANTHROPIC_AUTH_TOKEN이 명시되어 있다면, 셸 환경이나 설정 파일의 env 블록 등 해당 인증 정보를 설정한 모든 위치에서 제거합니다. apiKeyHelper가 명시되어 있다면 그 설정을 제거합니다.

claude setup-token으로 발급한 토큰이나 CLAUDE_CODE_OAUTH_TOKEN도 Remote Control 연결에 사용할 수 없습니다. 이 토큰들은 모델 요청에만 쓸 수 있습니다. 필요한 로그인 권한 범위를 확보하려면 claude auth login을 사용합니다. 출처: 인증 실패, 토큰의 제한 사항.

이용 조건에 맞는 로그인 정보가 없으면 claude remote-control은 종료됩니다. 반면 claude --remote-control은 로컬 대화형 세션을 시작한 뒤 원격 접속 실패 알림을 표시합니다. 출처: 로그인 조건.

환경 변수가 기능 플래그 확인을 막을 때

기능 플래그는 Claude Code가 해당 기능을 실행할 수 있는지 판단하는 데 사용하는 가용성 확인 수단입니다. 해결 방법은 오류에 표시된 환경 변수에 따라 달라집니다.

마지막 행의 버전 조건은 해당 텔레메트리 환경 변수 구성에만 적용됩니다. Remote Control 전체의 최소 지원 버전을 뜻하지 않습니다. 출처: 기능 플래그 문제 해결.

게이트웨이나 다른 API 엔드포인트를 사용 중일 때

Remote Control에서는 기업용 Claude 앱 게이트웨이를 통한 로그인을 지원하지 않습니다. 앞에서 나열한 외부 API 제공업체도 지원하지 않습니다.

이용 조건을 충족하는 claude.ai 세션인데도 사용자 지정 ANTHROPIC_BASE_URL처럼 연결 대상을 Anthropic 이외의 곳으로 바꾸는 변수가 오류에 표시될 수 있습니다. 공식 문서는 해당 변수를 해제하고, 설정의 env에도 들어 있다면 제거한 뒤 세션을 다시 시작하도록 안내합니다. 출처: 엔드포인트 조건과 오류.

조직 또는 계정 확인에 실패할 때

조직 정책으로 차단되었다면 Owner가 Remote Control을 활성화했는지 확인합니다. disableRemoteControl을 사용하는 기기 정책도 별개의 원인일 수 있습니다. Pro 또는 Max로 변경했는데 Claude Code가 이전 조직의 로그인 정보를 계속 사용한다면, /status에서 요금제와 조직을 확인합니다. claude auth logout에 이어 claude auth login을 실행하면 로그인 정보를 갱신할 수 있습니다.

요금제 변경 뒤에도 이전 이용 자격이 적용되는 경우, 공식 문서는 로그아웃 후 재로그인, 오래된 Claude Code 버전 업데이트, claude doctor를 통한 실패 항목 확인도 안내합니다. 정책을 가져오지 못했다면 네트워크 연결을 복구하고 다시 시도합니다. 문제가 계속되면 doctor의 조직 정책 진단 결과에서 원인을 확인할 수 있습니다. 출처: 계정 및 정책 문제 해결.

원격 인증 정보를 가져오지 못할 때

공식 문서에 나온 서버 진단 명령을 사용합니다.

claude remote-control --verbose

문서가 제시하는 원인은 claude.ai 인증 누락, 443 포트로 나가는 Anthropic API 요청을 막는 네트워크 또는 프록시, 앞선 세션 생성 단계의 실패입니다. 마지막 경우에는 구독이 활성 상태인지 확인합니다. 세션 안에서 사용하는 /remote-control 명령에는 --verbose를 붙일 수 없습니다. 출처: 인증 정보 가져오기 실패 해결.

컴퓨터를 켜 두고 재연결 방법 알아 두기

터미널을 닫거나 Desktop 또는 VS Code를 종료하거나 Claude Code 프로세스를 중지하면 해당 세션에 원격으로 접속할 수 없습니다. 짧은 절전 상태나 네트워크 중단 뒤에는 컴퓨터가 복귀하면 다시 연결될 수 있습니다. 다만 네트워크 장애가 길어질 때의 동작은 모드마다 다릅니다.

• 서버 모드: 네트워크에 연결되지 않은 상태가 약 10분 지속되면 서버가 종료됩니다. claude remote-control을 다시 실행합니다.
• 대화형 모드: Claude Code가 연결을 재시도하는 동안에도 로컬 작업은 계속할 수 있으며, 네트워크가 복구되면 다시 연결됩니다.

/plugin, /resume 등 일부 명령은 여전히 로컬 CLI에서 실행해야 합니다. 원격 접속으로 터미널의 모든 조작을 대신할 수는 없습니다. 출처: 제한 사항.

서버를 정상 종료했다면, 같은 디렉터리에서 다시 시작해 약 네 시간 이내에 기존 세션을 복구할 수 있습니다. 이는 해당 디렉터리에서 다른 서버를 실행하고 있지 않았고 --no-create-session-in-dir을 사용하지 않았다는 전제하에 가능합니다. 이 시간이 지나면 새 세션을 시작합니다.

대화형 세션의 대화를 이어 가려면 claude --continue 또는 claude --resume을 사용합니다. 원격 재연결에 실패하면 해당 세션 안에서 /remote-control을 실행합니다. 출처: 세션 재개.

Remote Control과 클라우드 세션 중 무엇을 선택할까요?

작업용 컴퓨터에 이미 갖춰 둔 환경을 활용하는 것이 중요하다면 Remote Control을 선택합니다. 클라우드 인프라에서 실행하고 싶다면 클라우드 세션을 선택합니다.

두 종류의 세션 모두 claude.ai/code에 나타날 수 있으므로, 이 주소만으로는 작업이 어디에서 실행되는지 알 수 없습니다. 출처: 공식 비교, 클라우드 세션.

대화형 Claude Code 프로세스 하나당 원격 세션 하나를 지원합니다. 서버 모드에서는 여러 로컬 세션을 처리할 수 있습니다. 기본값인 same-dir 모드는 작업 디렉터리를 공유하므로 수정 내용이 충돌할 위험이 있습니다. --spawn worktree를 사용하면 필요에 따라 생성되는 세션에 각각 별도의 Git worktree가 제공됩니다. Git worktree는 한 저장소 안에서 사용하는 독립된 작업 사본입니다. 처음 생성된 세션은 여전히 현재 디렉터리를 사용합니다. 출처: 서버 옵션.

Dispatch는 모바일에서 Desktop으로 작업을 위임하는 별도 기능입니다. 이 가이드는 Claude Code 세션을 이어 가는 방법을 다룹니다. 외부 원격 제어 툴까지 포함한 폭넓은 비교는 모바일 원격 제어를 지원하는 AI 코딩 에이전트를 참고하면 됩니다.

실제로 활용해 볼 만한 다섯 가지 작업 방식

공식 문서에 설명된 제어 기능을 바탕으로 제안하는 활용법입니다. 개발자가 진행 중인 작업을 이어 가는 데 얼마나 직접적으로 도움이 되는지를 기준으로 정리했습니다.

1. 수정 작업 도중 자리를 비우는 개발자: /rc를 켜고, 대화를 다시 시작하지 않은 채 스마트폰으로 다음 질문에 답합니다.
2. 테스트가 끝나기를 기다리는 창업자: 완료 알림을 요청하고, 모바일 세션에서 결과를 검토한 뒤 다음 작업을 정합니다.
3. 로컬 MCP 툴을 사용하는 개발자: 다른 환경에 툴 연결을 다시 구성하지 않고 같은 프로젝트를 원격으로 이어 갑니다.
4. 다른 컴퓨터에서 작업을 검토하는 개발자: 그 컴퓨터의 브라우저에서 세션 URL을 열고, 작업용 컴퓨터에서 실행 중인 세션에 피드백을 보냅니다.
5. 화면에 보이는 문제를 전달하는 창업자: 스마트폰에서 사진이나 파일을 첨부해 기존 세션에 추가 맥락을 제공합니다.

얻을 수 있는 이점은 실행 중인 작업과 다음 판단 사이의 끊김이 줄어든다는 것입니다. 절약 시간을 임의의 수치로 제시할 필요는 없습니다. 먼저 확인할 것은 책상으로 돌아가지 않고 실제 작업 인계 한 번을 마칠 수 있는지입니다. 기반이 되는 동기화, 첨부 파일, 로컬 툴의 동작은 Remote Control 문서에 설명되어 있습니다.

다음 업무일에는 기존 프로젝트 하나에서 /remote-control로 연결한 뒤, 아직 책상 앞에 있을 때 스마트폰으로 세션을 열고 후속 메시지를 보내 봅니다. 정상 작동을 확인한 다음 자동 연결과 알림이 평소 작업 방식에 맞는지 결정하면 됩니다. 로컬 작업 환경을 익히는 단계라면 Claude Code 사용 가이드부터 시작합니다.

코딩 에이전트를 안정적인 팀 워크플로에 도입하는 데 도움이 필요하다면 AI 프로덕션 시스템을 살펴보면 됩니다.