Claude Code Remote Control: 2026년에 QR 코드로 휴대폰에서 코딩하는 방법

자세한 안내는 Ailoot 문서에서도 확인할 수 있습니다.

Remote Control이란 무엇이며, 왜 휴대폰에서 코딩할까요?#

Anthropic은 2026년 2월 24일 Remote Control을 출시했습니다. Anthropic은 이를 어떤 기기에서든 로컬 세션을 이어 갈 수 있는 방법이라고 설명합니다.

쉽게 말해, 평소처럼 터미널에서 세션을 시작합니다. Remote Control을 켭니다. 휴대폰에서 Claude 앱 → Code 탭을 열면 초록색 점이 표시된 세션이 보입니다. 탭해서 읽고 답하면 됩니다. 노트북, 휴대폰, 브라우저 어디에서든 원하는 조합으로 입력할 수 있으며 모두 동기화됩니다.

공식 Remote Control 문서는 로컬 실행과 네트워크 전송을 구분합니다. 명령과 파일시스템 작업은 내 컴퓨터에서 실행되지만 대화는 Anthropic을 통해 동기화됩니다.

이 점이 세션이 Anthropic 클라우드 VM에서 실행되는 Claude Code 웹 버전과의 핵심 차이입니다. 여기서는 모든 Git 저장소, 환경 변수, 데이터베이스 키가 있는 내 하드웨어에서 Claude가 계속 실행됩니다. 휴대폰은 Claude와 대화하는 데 쓰는 화면일 뿐입니다.

바이브 코딩을 하는 사람에게 유용한 이유

저자가 매주 사용한 실용적인 상황 세 가지입니다.

1. 밤새 진행하는 긴 리팩터링. 새 API에 맞춰 파일 40개를 업데이트하는 작업을 Claude에 맡깁니다. 노트북을 떠나세요. 아침에 소파에 누워 휴대폰으로 diff를 검토하고 “처음 12개는 승인하고 나머지는 따로 보여 줘”라고 말하면 됩니다. 노트북을 열 필요가 없습니다.
2. 출근길에 단계 승인하기. 지하철에 있을 때 Claude가 “스키마 마이그레이션에 대한 결정이 필요합니다”라는 푸시 알림을 보냅니다. 알림을 열고 두 가지 대안을 읽은 뒤 “첫 번째 안으로 진행해. 테스트는 건드리지 마”라고 입력합니다. 이동하는 동안 세션은 계속 진행됩니다.
3. 라이브 방송이나 회의 중. Zoom 회의 중에 휴대폰으로 두 번째 Claude 세션이 테스트 빌드를 만들었는지 확인할 수 있습니다. 영상 통화에서 다른 창으로 전환할 필요가 없습니다.

Remote Control 실행에 필요한 것#

전체 요구 사항 표:

다음 명령으로 버전을 확인하세요.

claude --version

2.1.51보다 낮으면 업데이트하세요.

npm install -g @anthropic-ai/claude-code@latest

환경에 ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN 또는 apiKeyHelper가 설정되어 있으면 Remote Control이 시작되지 않습니다. v2.1.139(2026년 5월 11일)부터 Anthropic은 이러한 변수가 있으면 해당 기능을 명시적으로 차단합니다. unset ANTHROPIC_API_KEY를 실행하고 /login으로 다시 로그인하세요.

Remote Control을 시작하는 3가지 방법: 2분이면 충분#

방법 1. 서버 모드—원격 세션 전용 서버

1. 프로젝트 폴더에서 터미널 열기

   작업할 디렉터리로 이동하려면 cd를 한 번 실행합니다. 새 폴더라면 평소처럼 claude를 실행해 Workspace Trust 대화상자를 완료하세요.

2. 서버 시작

   claude remote-control
   

   터미널은 계속 실행 상태로 유지됩니다. 아래쪽에 세션 URL과 “QR 코드를 표시하려면 스페이스를 누르세요”라는 안내가 표시됩니다. 서버가 연결을 기다립니다.

3. 휴대폰에서 연결

   Space를 누르면 QR 코드가 나타납니다. Claude 앱이나 iPhone 카메라로 스캔해 세션을 여세요.

선택 사항: 세션 이름과 매개변수를 설정할 수 있습니다.

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name — 휴대폰의 세션 목록에 표시될 이름입니다.
• --spawn worktree — 새 세션마다 자체 Git worktree를 열어 병렬 세션끼리 서로 방해하지 않도록 합니다.
• --capacity 4 — 서버에서 동시에 실행할 수 있는 원격 세션의 최대 개수는 4개입니다. 기본값은 32입니다.

방법 2. 대화형 모드—Remote Control이 추가된 내 세션

claude --remote-control
# or shorter:
claude --rc

Remote Control이 활성화된 일반 대화형 세션이 터미널에서 시작됩니다. 노트북과 휴대폰 양쪽에서 Claude에게 입력할 수 있으며, 대화는 하나의 동기화된 세션입니다.

서버 모드와 달리 세션은 하나입니다. 주로 컴퓨터에서 작업하고 잠시 자리를 비울 때 휴대폰을 예비 수단으로 사용하려는 경우에 유용합니다.

방법 3. 활성 세션에서 /rc 실행

이미 Claude Code에서 작업 중인가요? 세션을 종료하지 마세요. 다음을 입력하면 됩니다.

/remote-control

또는 더 짧게:

/rc

세션이 원격 세션으로 전환됩니다. 기존 컨텍스트는 유지됩니다. 작업 도중 자리를 비워야 한다는 걸 깨달았을 때 유용합니다.

QR 코드: 10초 만에 휴대폰 연결하기#

1. Claude 앱 설치

   아직 앱이 없다면 Claude Code에서 /mobile을 입력하세요. App Store 또는 Google Play에서 앱을 다운로드할 수 있는 QR 코드가 표시됩니다. 직접 검색하는 것보다 빠릅니다.

2. 터미널에서 세션 QR 코드 표시

   claude --rc 또는 claude remote-control을 실행한 뒤 Space를 누르세요. QR 코드가 터미널에 바로 표시됩니다.

3. 휴대폰으로 스캔

   Claude 앱 → 카메라를 열거나 기본 iPhone 카메라를 사용하세요(Android 카메라도 스캔할 수 있습니다). 작동하지 않으면 터미널 창을 넓히거나 iTerm2 또는 Windows Terminal로 바꾸세요. 또는 QR 코드 위의 URL을 복사해 브라우저에 직접 붙여 넣으세요.

4. 푸시 알림 활성화

   세션에서 /config를 입력하고 “Claude가 결정하면 푸시 알림 보내기”를 활성화하세요. Claude Code 버전 2.1.110 이상이 필요합니다.

휴대폰에 표시되는 내용

Claude 앱에서 Code 탭이 열립니다. 세션은 컴퓨터 아이콘과 초록색 점(온라인)이 표시된 목록에 나타납니다. 탭해서 들어가세요.

이후에는 claude.ai/code처럼 사용할 수 있습니다. Claude의 메시지와 파일 diff를 보고, 승인하거나 거부하거나 수정 요청을 할 수 있습니다. 새 요청을 입력할 수도 있습니다. 모든 내용은 내 컴퓨터로 전달되어 로컬 Claude가 처리한 뒤 응답을 돌려줍니다.

푸시 알림으로 Claude가 할 수 있는 일

Claude는 필요하다고 판단할 때 푸시 알림을 보냅니다. 기본적으로 긴 작업이 끝났거나 Claude가 결정을 기다릴 때 알림이 전송됩니다. “테스트가 통과하면 알려 줘”라고 직접 요청할 수도 있으며, 그러면 알림을 하나 보냅니다.

푸시 알림이 오지 않는 경우:

• iOS에서는 설정 → 알림 → Claude를 확인하세요. 집중 모드가 알림을 무음 처리할 수 있습니다.
• Android에서는 Claude 앱의 배터리 최적화를 끄세요.
• /config에 “등록된 모바일 기기 없음”이라고 표시되면, 푸시 토큰을 업데이트할 수 있도록 Claude 앱을 한 번 이상 여세요.

소파에서 작업하기: 유용한 상황 5가지#

상황 1. 소파에서 검토하기—밤새 실행한 작업 확인

잠들기 전에 Claude에 “새 lint 규칙으로 저장소 전체를 검사하고 중요하지 않은 문제는 모두 수정해. 나머지는 TODO로 표시해”와 같은 작업을 맡기세요. claude --rc를 실행하고 터미널을 켜 둡니다.

아침에 휴대폰을 들고 소파에 누우세요. Claude 앱을 열고 → 초록색 점이 있는 세션을 찾으면 → diff 형태의 커밋 87개가 표시됩니다. 훑어본 뒤 의심스러운 부분에는 “이 변경은 되돌려. 직접 수정할게”라고 쓰고, 괜찮은 부분에는 “모두 승인해”라고 입력하세요. 오전 7시에 “노트북까지 가야” 할 필요가 없습니다.

상황 2. 출퇴근길에 승인하기—지하철에서 단계 승인

아침에 긴 데이터베이스 스키마 마이그레이션을 시작합니다. 9시 30분, 지하철에서 “마이그레이션 대안 두 가지를 찾았습니다. 결정이 필요합니다”라는 푸시 알림이 옵니다. 탭해서 내용을 읽고 하나를 선택한 다음, “전체 테스트 실행이 끝날 때까지 기존 테이블을 삭제하지 마”라고 덧붙이세요. Claude가 계속 진행합니다.

Remote Control이 없다면 Claude는 그 지점에서 멈춰 말없이 기다릴 것입니다. 도착해서 노트북을 열면 40분을 허비합니다.

상황 3. 자리를 비우기—점심시간에 긴 작업 진행

점심 전에 Claude에게 “모든 엔드포인트의 문서를 업데이트해”라고 요청하세요. 카페에 갑니다. 25분 뒤 “완료했습니다. 확인해 보세요”라는 푸시 알림이 옵니다. “승인”을 한 번 누르고 수프를 계속 먹으면 됩니다. Remote Control이 없다면 25분 동안 경비원처럼 노트북 앞에 앉아 있거나, 돌아와서 Claude가 결정이 필요한 지점에서 멈춘 탓에 아무것도 하지 않은 것을 발견하게 됩니다.

중요한 점입니다. Remote Control은 Claude를 더 자율적으로 만들지 않습니다. 어디서든 접속할 수 있게 해 줄 뿐입니다. Claude가 마주치는 결정 지점이 적을수록 푸시 알림도 줄어듭니다. 따라서 작업 지침을 더 구체적으로 작성하세요. “이렇게 해. 이런 경우에는 저렇게 해. 정말 불분명하면 멈추고 푸시 알림을 보내.”

상황 4. 카페에서 아키텍처 결정하기

리팩터링 도중 Claude가 두 가지 마이그레이션 경로를 찾아 선택을 요청합니다. 컴퓨터에서 떨어져 있다면 휴대폰으로 제안된 diff를 열고 한 가지를 선택한 뒤 “하지만 user_settings 테이블은 건드리지 마. 다음 주에 내가 삭제할 거야”라는 의견을 덧붙이세요. 세션은 계속 진행됩니다.

이 방식은 worktree 모드(--spawn worktree)에서 특히 잘 작동합니다. 각 병렬 작업이 별도의 브랜치에 있으므로 서로 간섭하지 않습니다. 휴대폰에서는 채팅처럼 세션 사이를 전환할 수 있습니다.

상황 5. 여러 worktree 세션을 한 번에 실행하기

서버 모드와 여러 worktree를 함께 사용하는 방법도 효과적입니다. 노트북에서 다음을 시작하세요.

claude remote-control --spawn worktree --capacity 4

휴대폰에서 서로 다른 브랜치에 세션을 시작하세요. 하나는 기능을 만들고, 다른 하나는 목록의 버그를 수정하고, 세 번째는 회귀 테스트를 실행합니다. 모두 노트북에서 병렬로 실행되며 서로를 막지 않습니다.

보안: 컴퓨터에 남는 것과 전송되는 것#

민감한 프로젝트를 연결하기 전에 프롬프트와 도구 출력에 어떤 내용이 들어가도 되는지 정하세요. 운영 비밀 정보는 에이전트가 접근할 수 없는 환경에 두세요. 전송 경로 표만으로 특정 세션이 이를 유출할 수 없다고 입증되지는 않습니다.

일상적인 표현으로 말하면 노트북이 Anthropic에 “내게 온 메시지가 있나요?”라고 묻고, 응답을 받은 뒤 로컬에서 처리합니다. 외부에서 내 컴퓨터의 인바운드 포트를 여는 일은 없습니다. 기업 방화벽도 특별한 설정 없이 이 연결을 허용합니다.

Anthropic에 실제로 전송되는 데이터

Remote Control은 동기화된 인터페이스를 추가하며 오프라인 추론 모드가 아닙니다. Anthropic은 데이터 사용 정책에 따라 메시지, 응답, 도구 활동을 포함한 연결 세션 기록을 저장합니다. 모델에 보내는 데이터와 연결된 기기의 접근을 모두 검토하세요.

자격 증명에 관한 참고 사항

다시 말해, 하나의 장기 토큰 대신 수명이 짧은 토큰 묶음이 노트북, Anthropic, 휴대폰 사이를 오갑니다. 그중 하나가 유출되어도 나머지 토큰에 모두 접근할 수 있는 것은 아닙니다.

중요한 제한이 하나 더 있습니다. --dangerously-skip-permissions는 Remote Control에서 작동하지 않습니다. 모든 도구 호출(Bash, Write, Edit)은 여전히 승인을 기다립니다. 이는 휴대폰 기능이 “감독 없이 자동 조종되는 노트북”으로 변하지 않도록 의도적으로 설계된 것입니다.

Remote Control을 시작했다면? 이제 Claude가 10분마다 방해하지 않도록 설정하세요#

/rc는 세션을 휴대폰으로 가져오는 편리한 방법입니다. 하지만 Claude가 10분마다 “무엇을 해야 할지 모르겠습니다”라고 쓴다면 문제는 휴대폰이 아니라 컨텍스트 엔지니어링, 즉 시작할 때 규칙을 얼마나 명확하게 정했는지에 있습니다.

처음 실행할 때 흔히 겪는 문제 6가지와 해결 방법#

문제 1. “이 계정에서는 Remote Control 환경을 사용할 수 없습니다”

anthropics/claude-code 저장소에서 가장 흔히 접수되는 불만입니다(issue #29449 및 중복 보고 12건 이상). “Remote Control을 활성화할까요?”라는 질문에 y라고 답했지만 CLI가 오류를 반환했고, 다시 시도하라는 안내도 표시하지 않습니다.

원인은 거의 항상 같습니다. 환경에 ANTHROPIC_API_KEY 또는 CLAUDE_CODE_OAUTH_TOKEN이 설정되어 있습니다. Remote Control은 키가 아니라 /login을 통한 완전한 OAuth로만 작동합니다.

해결 방법:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# check that the environment is clean:
env | grep -i anthropic
env | grep -i claude

# sign in again:
claude
/logout
/login

브라우저에서 /login으로 로그인한 뒤에는 Remote Control이 시작되어야 합니다.

문제 2. 휴대폰으로 QR 코드를 스캔할 수 없음

휴대폰 카메라를 코드에 비춰도 반응이 없거나 “읽을 수 없습니다”라고 표시됩니다.

원인: 터미널에서 QR 코드가 너무 작게 표시되거나 대비가 부족합니다.

해결 방법:

1. 터미널 창을 전체 화면으로 확대합니다.
2. Apple Terminal을 사용한다면 iTerm2(또는 Warp)로 바꾸세요. Windows를 사용한다면 CMD 대신 Windows Terminal을 사용하세요.
3. 터미널 글꼴 크기를 1~2포인트 줄여 QR 코드가 더 크게 보이도록 합니다.
4. 그래도 해결되지 않으면 QR 코드 위의 URL을 복사해 휴대폰 브라우저에서 여세요.

문제 3. 방화벽이 포트 443을 차단함

가로채기 프록시(Zscaler 또는 MITM을 사용하는 기업 VPN)가 있는 회사 컴퓨터에서 주로 발생합니다.

해결 방법: 상세 로그를 켜고 구체적인 오류를 기록하는 것부터 시작하세요.

claude remote-control --verbose

“인증서 확인 실패”가 표시되면 MITM 가로채기가 발생한 것이므로 네트워크 관리자에게 문의해야 합니다. “연결 거부됨” 또는 “시간 초과”가 표시되면 관리자에게 *.anthropic.com:443으로 나가는 연결을 허용해 달라고 요청하세요.

문제 4. Claude Code 버전이 너무 오래됨

확인하세요.

claude --version

2.1.51보다 낮으면 업데이트하세요.

npm install -g @anthropic-ai/claude-code@latest

VS Code 확장은 최소 v2.1.79가 필요합니다. 푸시 알림에는 v2.1.110이 필요합니다.

문제 5. 푸시 알림이 오지 않음

상황: Remote Control은 작동하지만 Claude가 긴 작업을 마쳐도 휴대폰에 알림이 오지 않습니다.

확인 목록:

1. 세션에서 /config를 실행하세요. “등록된 모바일 기기 없음”이라고 나오면 푸시 토큰을 업데이트할 수 있도록 휴대폰에서 Claude 앱을 한 번 이상 여세요.
2. iOS: 설정 → 알림 → Claude에서 알림이 활성화되어 있고 집중 모드로 인해 무음 처리되지 않았는지 확인하세요.
3. Android: 배터리 설정을 열고 배터리 최적화 대상에서 Claude를 제외하세요.
4. iOS 알림 요약이 켜져 있으면 푸시 알림이 도착해도 시간별 요약에 표시될 수 있습니다. Claude의 요약을 끄세요.

문제 6. Claude Desktop에서 /remote-control이 작동하지 않음

Claude Desktop 앱 안에서 /remote-control을 실행하면 “Remote Control requires a full-scope login token” 오류가 표시됩니다(GitHub issue #48378).

원인: Claude Desktop이 권한이 제한된 OAuth 토큰(추론 전용)을 주입합니다.

해결 방법: Claude Desktop에 내장된 터미널이 아니라 일반 시스템 터미널에서 Claude Code를 실행하세요. 알려진 제한 사항이며 Anthropic이 해결책을 마련하고 있습니다.

보너스. 긴 세션에서 자동 재연결이 조용히 끊김

증상: Remote Control 세션이 30~60분 동안 실행된 뒤 아무런 표시 없이 휴대폰 연결이 끊깁니다(issue #34255). 수동으로 해결하려면 /remote-control → 연결 해제 → 다시 시작을 실행하세요. 이상적이지는 않지만 이 기능은 아직 연구 미리보기 단계입니다.

Anthropic은 2026년 5월 한 달에만 Remote Control 전용 수정 사항 여덟 가지를 출시했습니다. 이 기능은 활발히 개선되고 있습니다. 불만을 제기할 수도 있지만, 대부분의 문제는 몇 달 안에 사라질 것으로 기대하는 편이 합리적입니다.

Remote Control, Telegram 봇, SSH+tmux 비교#

비교표

각 옵션을 선택할 때

• Remote Control — “노트북을 떠나서도 계속 작업을 지시”하기 위한 기본 설정입니다. 전체 UI, 기기 간 동기화, 타사 서비스가 필요 없습니다.
• Channels (Telegram 봇) — CI 실패, 새로운 고객 불만 또는 채팅 메시지에 Claude가 자동으로 조사하도록 요청하고 싶을 때 사용합니다. “내가 휴대폰으로 Claude를 지시한다”가 아니라 “이벤트 → Claude가 반응한다”는 방식입니다. Telegram과 Claude Code 가이드에서 자세히 알아보세요.
• SSH + tmux — 배포, 로그 확인, 서비스 재시작 같은 명령을 직접 실행하기 위해 휴대폰에서 임의의 셸이 필요할 때 사용합니다. Claude Code 바깥에서 쓰는 범용 셸입니다. 일회성 작업에는 Termux/Blink로 사용할 수 있습니다.
• 다른 코딩 에이전트 — Anthropic Remote Control은 Claude Code 전용입니다. Claude와 대안을 비교하려면 Cursor vs Claude Code를 참고하세요.

따라서 Anthropic의 공식 문서는 사용 사례를 기준으로 두 기능을 구분합니다. Remote Control은 제어용이고 Channels는 반응용입니다.

2026년 5월부터 2026년 6월까지 Remote Control의 변경 사항#

전체 수정 타임라인:

한 달 동안 Remote Control 전용 수정 사항 여덟 가지가 출시된 것은 연구 미리보기 기능에서 흔한 일입니다. Anthropic은 피드백에 대응하고 예외 상황을 해결하고 있습니다.

기능이 이상하게 작동한다면 먼저 버전을 확인하고 업데이트하세요. 이미 해결된 버그일 가능성이 있습니다.

체크리스트: 5분 만에 설정하고 작동시키기#

1. Claude Code 버전 확인

   claude --version을 실행하세요. 버전은 2.1.51 이상이어야 합니다. 그렇지 않으면 npm install -g @anthropic-ai/claude-code@latest를 실행하세요.

2. 환경에서 API 키 제거

   unset ANTHROPIC_API_KEY와 unset CLAUDE_CODE_OAUTH_TOKEN을 실행하세요. 그런 다음 브라우저를 통해 /logout → /login을 실행하세요.

3. 휴대폰에 Claude 앱 설치

   Claude Code 세션에서 /mobile을 실행하면 App Store / Google Play 다운로드용 QR 코드가 표시됩니다.

4. Remote Control 시작

   claude --rc를 실행하거나 세션 안에서 /rc를 실행하세요. URL과 “QR 코드를 표시하려면 스페이스를 누르세요”라는 안내가 나타납니다.

5. 휴대폰으로 QR 코드 스캔

   터미널에서 Space를 누른 다음 카메라 또는 Claude 앱을 사용하세요. 스캔되지 않으면 터미널 창을 넓히세요.

6. 푸시 알림 활성화

   /config → “Claude가 결정하면 푸시 알림 보내기”를 선택하세요. “등록된 모바일 기기 없음”이라고 나오면 Claude 앱을 한 번 이상 여세요.

7. 긴 작업을 시작하고 자리 비우기

   프롬프트를 구체적으로 작성하세요. “이렇게 해. 이런 경우에는 저렇게 해. 의심스러운 경우에는 푸시 알림을 보내.” 그런 다음 푸시 알림을 이용해 휴대폰에서 작업하세요.

한 실제 사례에서는 처음 시작한 뒤 소파에서 첫 대화를 나누기까지 3~5분이 걸렸습니다.

준비가 되면 Ailoot을 알아보세요.