Claude Code Remote Control 사용법: 폰에서 이어받고 VPS에서 돌리기
claude code remote control 한 줄 요약
2026년 4월 18일 기준,
claude code remote control은 내 컴퓨터에서 돌고 있는 Claude Code 세션을claude.ai/code나 Claude iOS·Android 앱에서 이어받는 기능이에요. 폰에서 상태를 보고 승인하거나 짧게 지시하는 용도로는 꽤 편한데, 진짜 CI(continuous integration, 자동 빌드·테스트 파이프라인)처럼 무인 실행을 하려면claude -p와 Agent SDK 쪽이 더 맞아요. Windowsnode.exe: bad option: --sdk-url오류와 장시간 조용한 끊김은 아직 먼저 알고 들어가는 게 나아요.
회의 들어가기 5분 전에 리팩터링을 던져놨는데, 자리로 못 돌아오는 날이 있죠. 저도 그때 폰으로 상태만 보려고 SSH(원격 셸 접속)까지 열었다가 더 번거로워졌어요. 그래서 claude code remote control을 며칠 붙들고 써봤는데, 컨셉은 확실히 편해요. 노트북에서 돌던 세션을 claude.ai/code나 Claude 모바일 앱에서 그대로 이어받을 수 있거든요.
근데 여기서 끝이면 글 안 써요. Windows에서는 node.exe: bad option: --sdk-url에 바로 걸릴 수 있고, 길게 돌려두면 조용히 멈춘 것처럼 보일 때도 있었어요. 그래서 이 글은 예쁜 소개보다 실전 기준만 남겼어요. 내 플랜에서 되는지, /rc로 3분 안에 붙는지, VPS(가상 서버)+tmux(터미널 세션 유지 도구) 조합으로 어디까지 “CI 비슷하게” 굴릴 수 있는지 순서대로 보면 돼요. claude code remote control과 Claude Code on the Web 사용법: 브라우저에서 돌리는 AI 코딩 에이전트 차이도 같이 잡아둘게요.
claude code remote control이 뭐고 어디서 쓰나
Claude Code Remote Control은 내 머신에서 이미 돌아가는 세션을 다른 기기에서 조종하는 기능이에요. 어디서 세션을 시작하고, 어디서 이어받는지 먼저 구분해야 덜 헷갈려요.
이름만 보면 웹판 Claude Code랑 같은 줄 알기 쉽지 않나요?
Anthropic 공식 Remote Control 문서를 기준으로 보면 시작 지점은 CLI와 VS Code 쪽이고, 연결 지점은 웹과 모바일이에요. 세션 본체는 계속 내 컴퓨터에서 돌아가고, 파일 시스템과 MCP(Model Context Protocol, 외부 도구 연결 규약) 서버도 그대로 남아요. 그래서 로컬 맥락을 유지한 채 자리만 바꾸고 싶을 때 잘 맞죠.
반대로 Claude Code 전체 사용 환경은 더 넓어요. Remote Control만 보고 있으면 다른 사용 환경이랑 자꾸 섞여요. 그 차이는 Claude Code on the Web 사용법: 브라우저에서 돌리는 AI 코딩 에이전트 글도 같이 보면 바로 정리돼요.
claude code remote control 사용 환경별 역할 한눈에
| 사용 환경 | 지금 글과의 관계 | 메모 |
|---|---|---|
| CLI | Remote Control 시작점 | claude remote-control, claude --remote-control, /rc를 여기서 써요 |
| VS Code 확장 | Remote Control 시작점 | 확장 안에서도 /remote-control 또는 /rc 가능해요. v2.1.79+ 필요 |
Web claude.ai/code |
Remote Control 연결점 | 다른 PC 브라우저에서 이어받을 때 여기로 들어가요 |
| Claude iOS 앱 | Remote Control 연결점 | 승인, 짧은 지시, 진행 확인에 편해요 |
| Claude Android 앱 | Remote Control 연결점 | iOS랑 같은 역할이에요 |
| Desktop 앱 | 별도 Claude Code 사용 환경 | 자체 세션 UI가 중심이라 이 글 핵심 기능과는 결이 달라요 |
| JetBrains 플러그인 | 별도 IDE 사용 환경 | IDE 연동이 중심이에요 |
| Chrome 확장 | 별도 브라우저 통합 | 브라우저 자동화와 콘솔 점검 쪽이에요 |
| Slack | 별도 협업 통합 | 채널에서 Claude 작업을 던지는 흐름이 중심이에요 |
| CI/CD | 별도 자동화 사용 환경 | 진짜 자동 실행은 claude -p와 Agent SDK 쪽이 맞아요 |
내 플랜과 환경에서 바로 되나
Remote Control은 계정 조건과 로컬 환경 조건이 둘 다 맞아야 붙어요. 플랜만 맞고 로그인 방식이 틀리면 그대로 막히거든요.
설마 Pro 결제만 했다고 바로 되는 줄 알고 있던 건 아니죠?
공식 문서 기준으로 Remote Control은 Free가 아니라 Pro, Max, Team, Enterprise에서 쓸 수 있어요. API 키만 들고 있는 Console 계정은 안 되고, claude.ai 구독 로그인으로 들어와야 해요. Team과 Enterprise는 관리자 토글도 먼저 켜야 하고요. Claude Code가 처음이면 Claude Code 사용법: 설치부터 첫 실행까지 5분 가이드부터 보고 로그인 흐름을 먼저 맞추는 쪽이 빨라요.
| 플랜 | 2026-04-18 기준 공식 가격 | Remote Control | 체크 포인트 |
|---|---|---|---|
| Free | $0 | 안 됨 | Claude Code 자체는 제외예요 |
| Pro | 연간 월 $17, 월간 $20 | 됨 | 개인 개발자 시작점 |
| Max 5x | 월 $100 | 됨 | 병렬 세션이 자주 필요할 때 |
| Max 20x | 월 $200 | 됨 | 하루 종일 무겁게 쓰는 쪽 |
| Team Standard | 연간 좌석당 월 $20, 월간 $25 | 됨 | 관리자 토글 필요 |
| Team Premium | 연간 좌석당 월 $100, 월간 $125 | 됨 | 관리자 토글 필요 |
| Enterprise | 좌석당 $20 + 사용량 과금 | 됨 | 관리자 토글 필요 |
| API 키만 사용하는 Console 계정 | 사용량 기반 | 안 됨 | claude.ai 구독 로그인으로 바꿔야 해요 |
붙기 전에 이 순서로 보면 돼요.
# 버전과 로그인 상태 확인
claude --version
claude auth status
# API 키가 먼저 잡혀 있으면 구독 로그인으로 다시 전환
unset ANTHROPIC_API_KEY
claude auth login
체크리스트는 짧아요.
- Claude Code 버전이
v2.1.51+인지 본다 - 푸시 알림까지 쓸 거면
v2.1.110+인지 본다 - VS Code에서
/rc를 쓸 거면 확장 버전이v2.1.79+인지 본다 - Team, Enterprise면 관리자 설정에서 Remote Control 토글이 켜졌는지 본다
ANTHROPIC_API_KEY,CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEX,CLAUDE_CODE_USE_FOUNDRY같은 환경변수 충돌이 없는지 본다
3분 안에 /rc로 폰에서 이어받기
claude code remote control을 가장 덜 헷갈리게 켜는 시작점은 기존 세션 안에서 /rc를 치는 거예요. 이미 하던 대화와 작업 맥락을 그대로 들고 가니까 실패 지점이 적어요.
새 세션부터 다시 파서 붙이는 것보다, 지금 돌던 세션을 그냥 이어받는 게 낫지 않나요?
제가 제일 자주 쓰는 흐름은 이거예요. 터미널에서 Claude를 켜고, 세션 안에서 /rc 한 번 치고, 폰에서 QR을 찍는 방식이죠. 이때 앱이 없다면 /mobile로 다운로드 QR도 바로 띄울 수 있어요.
# 프로젝트 디렉터리에서 Claude 세션 시작
claude
/rc blog-review-session
예상 흐름은 대략 이래요.
Remote Control enabled
Session name: blog-review-session
Open in browser: https://claude.ai/code/...
QR code: visible in terminal
순서는 4단계면 끝나요.
- 노트북에서
claude를 연다 - 세션 안에서
/rc 세션이름을 입력한다 - 폰에서 Claude 앱으로 QR을 스캔하거나
claude.ai/code에 들어간다 - 같은 세션이 열리면 승인, 중단, 짧은 추가 지시를 바로 넣는다
푸시 알림도 같이 켜두면 꽤 편해요. /config에서 Push when Claude decides를 켜면 작업이 끝났을 때나 판단이 필요할 때 알림이 와요. 근데 iPhone은 포커스 모드가, Android는 배터리 최적화가 알림을 막을 수 있더라고요. 알림이 늦으면 설정부터 다시 봐야 해요. 로컬 세션과 웹 세션의 역할 차이는 Claude Code on the Web 사용법: 브라우저에서 돌리는 AI 코딩 에이전트 쪽이 더 선명해요.
Windows 오류와 조용한 끊김은 어떻게 피하나
claude code remote control을 실제로 며칠 쓰다 보면 2026년 4월 기준으로 제일 많이 부딪히는 건 Windows 시작 오류와 장시간 세션 끊김이에요. 둘 다 “내가 뭘 잘못했나?” 싶게 조용히 와서 더 피곤해요.
모바일로 보려고 켰는데 40분 뒤에 멈춰 있으면, 이거 누구 잘못인지부터 헷갈리지 않겠어요?
Windows 쪽은 claude remote-control을 바로 실행했을 때 node.exe: bad option: --sdk-url로 터지는 보고가 계속 있어요. GitHub 이슈 #29693은 중복으로 닫혔지만, 증상 자체는 계속 묶여 올라오고 있죠. 지금 제일 현실적인 우회는 새 명령 대신 기존 대화형 세션을 열고 그 안에서 /rc를 쓰는 거예요.
장시간 세션은 더 성가셔요. 공식 설명은 자동 재연결 쪽인데, 2026-03-14에 열린 GitHub 이슈 #34255는 iOS와 macOS 조합에서 15분에서 60분 사이 조용히 끊기고 자동 복구가 안 된다고 적고 있어요. 그래서 자리를 오래 비울 때는 “모바일에서 계속 붙어 있겠지”라고 믿기보다, 중간 확인 한 번을 넣는 쪽이 나아요. 장시간 백그라운드 작업 자체가 목적이면 Claude Code 루틴 실전 가이드: PR 리뷰·배포 검증을 노트북 꺼도 돌리는 법도 같이 보는 게 좋아요.
| 증상 | 지금 보이는 상태 | 현실적인 대응 |
|---|---|---|
node.exe: bad option: --sdk-url |
Windows에서 시작부터 실패 | claude 세션 안에서 /rc로 우회 |
| 15~60분 뒤 조용한 끊김 | 모바일 화면은 살아 있는데 입력이 안 먹음 | 새로고침, 세션 재연결, 장시간 작업 전 중간 확인 |
| rate limit 뒤 재연결 실패 | 한도 리셋 뒤에도 세션이 안 붙음 | 세션 재시작을 먼저 본다 |
| 구독 인식 오류 | Pro인데도 Remote Control이 막힘 | claude auth login 재인증, 환경변수 정리 |
Windows에서 덜 막히는 흐름만 적으면 이 정도예요.
# PowerShell에서 Claude 세션 먼저 시작
claude
# 세션 안에서 Remote Control 활성화
/rc win-session
VPS에서 tmux로 돌려 CI처럼 쓰는 법
결론부터 말하면, claude code remote control은 진짜 CI용이 아니에요. GitHub Actions 같은 자동 파이프라인은 claude -p와 Agent SDK가 맞고, Remote Control은 대화형 터미널 세션을 오래 살려 두는 쪽에 더 가까워요.
설마 GitHub Actions에 claude remote-control만 넣고 끝내려던 건 아니죠?
공식 문서도 스크립트와 CI/CD는 claude -p 쪽을 권해요. Remote Control은 로컬 프로세스가 계속 살아 있어야 하고, 헤드리스 서버에서 TTY(대화형 터미널) 없이 데몬처럼 띄우는 건 아직 깔끔하지 않아요. 그래서 VPS에서 쓸 때는 tmux로 세션을 묶고, Remote Control은 그 세션을 웹이나 폰에서 이어받는 용도로 생각하면 돼요. 자동화 자체를 더 길게 보고 싶다면 Claude Code 루틴 실전 가이드: PR 리뷰·배포 검증을 노트북 꺼도 돌리는 법으로 이어서 보면 흐름이 맞아요.
실전 세팅은 이 순서예요.
# VPS 접속
ssh dev@my-vps
# 세션 유지용 tmux 시작
tmux new -s claude-rc
# Claude Code 시작
claude
# 기존 세션 안에서 Remote Control 활성화
/rc vps-review-session
# tmux 분리
# Ctrl+B D
병렬로 나눠서 돌릴 거면 서버 모드도 쓸 만해요.
# worktree를 써서 병렬 세션 대기 서버 시작
claude remote-control --spawn worktree --capacity 3 --name "review-hub"
여기서 --capacity 기본값은 32예요. 숫자를 크게 잡을수록 좋을 것 같지만, 실제로는 2~5개만 열어도 사람이 보기엔 충분한 편이죠.
진짜 CI/CD 파이프라인은 이쪽이 맞아요.
# 비대화형 검증용 예시
claude --bare -p "Run the test command, summarize failures, and suggest the next fix." \
--allowedTools "Read,Bash"
SSH+tmux와 Remote Control, 뭘 고르면 되나
claude code remote control과 SSH+tmux 중 하나가 무조건 이긴다고 보면 실수해요. 승인 버튼 누르기, 진행 상태 보기, 짧은 추가 지시는 Remote Control이 편하고, 오래 살아 있는 서버 세션과 끊김 대응은 SSH+tmux가 아직 더 안정적인 편이에요.
그럼 굳이 Remote Control을 왜 쓰냐고요?
터미널에 익숙한 사람은 SSH+tmux로도 대부분 해결해요. 근데 폰에서 승인만 눌러야 할 때, 회의 중에 상태만 봐야 할 때, 다른 브라우저에서 같은 세션을 바로 열어야 할 때는 Remote Control이 확실히 가볍죠. 반대로 헤드리스 서버, systemd 서비스, 완전 무인 자동화까지 기대하면 실망하기 쉬워요. 클라우드에서 아예 새 세션을 병렬로 던지고 싶다면 Claude Code on the Web 사용법: 브라우저에서 돌리는 AI 코딩 에이전트가 더 맞아요.
| 기준 | Remote Control | SSH+tmux |
|---|---|---|
| 시작 난도 | 낮음 | 중간 |
| 모바일 승인·짧은 지시 | 편함 | 터미널 앱 적응 필요 |
| 로컬 파일과 도구 유지 | 좋음 | 좋음 |
| 장시간 안정성 | 버그 영향 받음 | 비교적 예측 가능 |
| 헤드리스 서버 적합성 | 아쉬움 | 좋음 |
| 팀원에게 설명하기 | 쉬움 | 셸 지식이 좀 필요 |
| “CI처럼” 오래 돌리기 | 보조용 | 기반 역할에 더 적합 |
짧게 고르면 이렇게 보면 돼요.
- 폰에서 승인하고 진행만 볼 거다: Remote Control
- 서버 세션을 오래 살려둘 거다: SSH+tmux
- 완전 자동화가 목적이다:
claude -p또는 Agent SDK - 둘 다 필요하다: VPS는
tmux, 바깥 조종은 Remote Control로 섞는다
자주 묻는 질문
웹에서 새 세션을 던지는 흐름이 궁금하면 Claude Code on the Web 사용법: 브라우저에서 돌리는 AI 코딩 에이전트도 같이 보면 덜 헷갈려요. 여기서는 Remote Control 기준 질문만 추렸어요.
Q1. Pro 플랜에서도 Claude Code Remote Control을 쓸 수 있나요?
A. 네, 돼요. 2026-04-18 기준 공식 문서는 Pro, Max, Team, Enterprise를 지원 대상으로 적고 있어요. Free와 API 키 단독 인증은 안 돼요.
Q2. Windows에서 node.exe: bad option: --sdk-url가 뜨면 뭘 먼저 해야 하나요?
A. 새 터미널에서 claude remote-control을 반복하기보다 claude 세션을 먼저 연 뒤 /rc를 쳐보세요. 지금 시점에선 그게 제일 덜 막혀요.
Q3. 연결이 자꾸 조용히 끊기는데 자동 재연결 안 되나요?
A. 공식 설명은 재연결 쪽인데, 2026-04-18 기준 GitHub 이슈 #34255는 장시간 세션에서 자동 복구가 안 된다고 열려 있어요. 오래 비울 땐 중간 확인이나 알림 설정을 같이 거는 쪽이 안전해요.
Q4. Remote Control로 GitHub Actions 같은 CI를 대체할 수 있나요?
A. 아니요. Remote Control은 대화형 세션을 다른 기기에서 이어받는 기능이고, 진짜 CI는 claude -p와 Agent SDK가 맞아요.
Q5. VPS에서 systemd 서비스처럼 완전 백그라운드로 띄울 수 있나요?
A. 아직은 깔끔하지 않아요. 지금은 tmux나 비슷한 세션 유지 도구를 같이 쓰는 구성이 현실적이에요.
다음 단계
지금은 claude --version과 claude auth status부터 보고, 바로 /rc 한 번 켜보세요. 서버에 오래 묶어 둘 생각이면 다음은 Claude Code 루틴 실전 가이드: PR 리뷰·배포 검증을 노트북 꺼도 돌리는 법으로 넘어가면 돼요.
