클로드 코드 핸드폰으로 쓰는 법｜Remote Control 설정·팀 플랜·연결 오류 해결

컴퓨터에서 클로드 코드에 작업을 맡겨 놓고 자리를 비웠는데, 진행 상황이 궁금해 다시 책상으로 돌아온 적이 있나요? 작은 수정 하나를 지시하려고 노트북을 꺼내는 것도 제법 번거롭습니다.

 

이럴 때 활용할 수 있는 기능이 Claude Code Remote Control입니다. 휴대폰이나 다른 브라우저를 통해 내 컴퓨터의 작업 세션에 이어서 접속하는 방식입니다. 2026년 10월 5일 기준 공식 문서를 바탕으로 설정 방법과 팀 플랜 조건, 사용량 확인까지 정리했습니다.

휴대폰에서 코드를 실행하는 건가요?

Remote Control은 iOS·Android용 Claude 앱과 웹에서 로컬 Claude Code 세션에 연결하는 기능입니다. 파일 접근과 터미널 명령 실행은 원래 작업하던 컴퓨터에서 이루어집니다. 휴대폰 자체에 개발 환경을 옮기는 방식은 아닙니다.

 

이때 ‘로컬’은 파일과 명령을 처리하는 위치를 뜻합니다. AI 모델까지 인터넷 없이 내 PC에서 실행된다는 뜻으로 이해하면 안 됩니다.

예를 들어 PC에서 테스트를 실행해 둔 뒤 휴대폰으로 결과를 확인하고, 실패한 테스트만 분석해 달라고 요청하는 식으로 활용할 수 있습니다. 작은 화면에서는 코드 전체를 읽기보다 범위를 좁힌 지시를 보내는 쪽이 편하겠습니다.

Pro·Max·Team·Enterprise에서 이용 가능

공식 문서는 Pro, Max, Team, Enterprise 구독을 지원하며 API 키 인증은 지원하지 않는다고 안내합니다. Team과 Enterprise에서는 조직 소유자, 즉 Owner가 관리자 설정에서 Remote Control을 먼저 활성화해야 합니다.

 

따라서 팀 플랜인데 연결이 안 된다면 무조건 설치 오류부터 의심할 필요는 없습니다. 본인에게 Claude Code 사용 권한이 있는지와 조직에서 원격 연결을 허용했는지를 각각 확인하세요.

 

회사 프로젝트에 쓰려면 기능 사용 가능 여부뿐 아니라 회사의 소스코드 취급 정책도 확인하는 것이 좋습니다. 개인 휴대폰에서 접근할 수 있다는 사실이 회사 자료를 자유롭게 다뤄도 된다는 뜻은 아니니까요.

먼저 업데이트와 설치 상태를 점검하세요

이미 Claude Code를 설치한 사용자라면 오래된 버전을 계속 쓰고 있지 않은지 확인합니다. 네이티브 설치에서 수동 업데이트할 때는 터미널에서 다음 명령을 사용할 수 있습니다.

claude update

Homebrew로 설치했다면 설치한 패키지에 맞춰 업데이트합니다. 일반 claude-code 패키지는 아래 명령을 사용하고, claude-code@latest로 설치했다면 패키지 이름도 그에 맞춰야 합니다.

brew upgrade claude-code

설치 상태와 업데이트 관련 문제를 살펴볼 때는 다음 진단 명령이 도움이 됩니다.

claude doctor

아직 설치하지 않았다면 글 하단의 공식 설치 문서부터 확인하세요. 서로 다른 설치 방식을 여러 번 겹쳐 적용하기보다는 현재 어떤 방식으로 관리되는지 파악하는 것이 먼저입니다.

PC에서 시작하고 휴대폰으로 연결하는 방법

새 작업을 시작할 때

터미널에서 작업할 프로젝트 폴더로 이동한 다음 실행합니다. 아래 경로는 예시이므로 본인의 프로젝트 경로로 바꿔야 합니다.

cd ~/projects/my-app
claude --remote-control

이미 대화 중인 작업을 이어갈 때

Claude Code 대화 입력창에서 다음 명령을 실행합니다. 일반 셸에 입력하는 명령과 구분하세요.

/remote-control

안내되는 활성화 확인을 마친 뒤 세션 URL이나 QR 코드로 연결합니다. 휴대폰의 Claude 앱 또는 웹에서는 해당 계정의 Code 세션 목록에서도 찾을 수 있습니다.

 

이름이 비슷한 claude remote-control은 원격 연결을 기다리는 서버 모드입니다. PC에서도 대화하며 진행하려면 위의 claude --remote-control 방식이 이해하기 쉽습니다.

노트북을 닫고 외출해도 계속 되나요?

Remote Control에서는 작업 컴퓨터와 Claude 프로세스가 계속 실행되어야 합니다. 절전 상태이거나 인터넷 연결이 끊기면 그동안 정상적인 작업 진행을 기대할 수 없습니다. 다시 온라인이 되면 재연결을 시도합니다.

 

반면 Claude Code의 클라우드 세션은 클라우드 환경에서 작업하므로 로컬 노트북을 닫아도 유지됩니다. 두 방식은 실행 위치가 다르며, Remote Control을 켰다고 작업이 자동으로 클라우드로 옮겨지는 것은 아닙니다.

 

내 컴퓨터의 파일과 개발 환경을 그대로 이어 쓰고 싶은지, 컴퓨터를 끈 상태에서도 원격 환경에서 작업하고 싶은지부터 정하면 선택이 쉬워집니다. 후자라면 클라우드 세션의 저장소와 실행 환경 구성을 별도로 살펴보세요.

 

휴대폰에서는 작업을 지시했는데 PC는 깊은 잠에 빠져 있는 상황을 피하려면, 처음에는 가까운 자리에서 연결과 재접속을 시험해 보는 것을 권합니다.

연결되지 않을 때는 원인을 나누어 보세요

구독이 필요하다는 오류라면 /login으로 로그인한 계정을 확인합니다. 조직 정책으로 차단됐다는 안내라면 Owner에게 허용 여부를 확인해야 합니다. 회사의 정책을 우회하기 위해 설정을 임의로 해제하는 것은 해결 방법으로 삼지 않는 것이 좋습니다.

 

그 외 문제는 PC의 인터넷 연결, 프로세스 실행 상태, 설치 상태부터 순서대로 점검하세요. 오류를 문의할 때에는 화면 전체 대신 오류 문구와 설치 방식, 사용 중인 환경을 정리하면 원인을 설명하기 쉽습니다.

 

공유용 화면에는 세션 연결 정보나 프로젝트 경로가 들어갈 수 있으니 공개 게시 전 가려 주세요. 특히 고객명이나 비공개 저장소 이름이 보이는지 함께 살펴보는 것이 좋겠습니다.

휴대폰으로 쓰면 사용량이 따로 생기나요?

Remote Control은 작업 세션에 접속하는 방법입니다. 기기를 바꾸었다는 이유로 별도의 무료 사용 한도가 생긴다고 기대하지 마세요. 사용량은 본인이 이용 중인 구독과 계정 조건을 기준으로 확인해야 합니다.

Claude Code에서 사용량을 확인할 때는 다음 명령을 사용할 수 있습니다.

/usage

공식 문서는 Pro·Max·Team·Enterprise 요금제에서 사용량과 한도 관련 정보를 확인할 수 있다고 설명합니다. Team에서는 개인에게 적용되는 조직의 사용량 크레딧 지출 한도도 영향을 줄 수 있습니다.

화면에 표시된 추정 토큰 비용과 실제 청구액은 같은 개념이 아닐 수 있으므로, 구독 사용량과 크레딧 지출을 구분해서 보세요. 원격 연결을 성공시키는 것만큼 ‘어떤 한도로 작업하고 있는가’를 아는 것도 중요합니다.

작은 화면에서는 작업 범위를 좁혀 지시하세요

휴대폰에서는 “전부 고쳐줘”보다 결과를 빠르게 확인할 수 있는 요청이 좋습니다. 예를 들면 다음과 같습니다.

방금 실행한 테스트에서 실패한 항목만 정리해줘.
원인을 먼저 설명하고, 파일을 수정하기 전 변경 계획을 보여줘.
배포나 데이터 삭제는 진행하지 마.

이 문구는 작업 범위를 전달하기 위한 예시이지, 실제 권한 제한을 대신하는 보안 장치는 아닙니다. Claude Code의 권한 모드와 프로젝트별 권한을 함께 점검해야 합니다.

 

공식 보안 문서는 민감한 저장소의 권한 설정과 변경 사항 검토를 권장합니다. /permissions로 설정을 확인하고, 배포나 데이터 삭제처럼 영향이 큰 작업은 작은 화면에서 무심코 승인하지 않는 편이 좋습니다.

 

클로드 코드 모바일 활용의 장점은 어디서든 모든 개발을 끝내는 데 있다기보다, 책상을 떠난 뒤에도 작업을 확인하고 방향을 조정할 수 있다는 데 있습니다. 처음에는 테스트 결과 확인과 작은 후속 지시부터 시작해 보세요. 주머니에 개발 PC를 넣는 대신, 필요한 순간에 작업에 다시 연결하는 방식입니다.

출처 및 참고자료

확인 기준일: 2026년 10월 5일. 명령과 지원 범위는 공식 문서 기준이며, 실제 이용 가능 여부는 설치 버전·계정·조직 정책에 따라 확인해야 합니다.

• Claude Code 공식 문서 — Remote Control: 지원 플랜, 시작 명령, 모바일 연결, 실행 조건과 오류 안내.
• Claude Code 공식 문서 — 설치 및 고급 설정: 설치 방식별 업데이트와 진단 명령.
• Claude Code 공식 문서 — 클라우드에서 사용하기: 로컬 원격 연결과 클라우드 실행의 차이.
• Claude Code 공식 문서 — 비용과 사용량 관리: /usage, 구독 한도와 조직의 크레딧 지출 확인.
• Claude Code 공식 문서 — 보안: 권한 설정과 변경 검토, 민감한 저장소 사용 원칙.
• Claude Code CLI 참조 · 대화창 명령 참조: 서버·대화형 시작 명령, 로그인과 세션 내 명령 구분.