// Claude Code · Remote Control · macOS · pmset · networkoversleep · 원격제어
Claude Code를 밖에서 쓰고 싶은데 연결이 계속 끊긴다면 — 공식 기능 소개부터 맥미니 네트워크 설정까지
집에 두고 나왔는데 Claude Code가 하던 작업을 계속 보고 싶다
Claude Code로 작업을 돌려놓고 밖에 나갔다. 폰으로 확인하거나 승인을 눌러주고 싶은데 연결이 안 된다. 아니면 더 간단하게, 맥미니를 집에 두고 카페에서 원격으로 쓰고 싶은데 모니터가 꺼지면 Wi-Fi가 끊겨버린다.
이 글은 두 가지를 다룬다. 첫 번째는 Anthropic이 공식으로 출시한 Remote Control 기능 사용법, 두 번째는 그 기능을 쓰기 위해 맥미니가 잠들지 않도록 설정하는 방법이다. Remote Control이 아무리 좋아도 맥미니가 꺼져버리면 소용없기 때문이다.
이 글의 환경
하드웨어 : Mac Mini M2, 16GB
Claude Code : v2.1.52 이상 (Remote Control 지원 버전)
플랜 : Pro 또는 Max (Remote Control 사용 조건)
문제 상황 : 외부 네트워크에서 원격 접속 시 연결 끊김
1. Claude Code Remote Control — 공식 기능 소개
2026년 2월, Anthropic이 Remote Control을 출시했다. tmux + SSH + Tailscale 조합으로 어떻게든 원격 접속하던 개발자들이 쓰던 방법을 공식 기능으로 대체한 것이다.
Remote Control은 클라우드에서 코드를 실행하는 게 아니다. 내 로컬 머신(맥미니)에서 Claude Code가 실행되고, 폰이나 브라우저는 그 세션을 들여다보는 창에 불과하다.
연결 구조
로컬 머신
맥미니
Claude Code 실행 중
Anthropic API
메시지 라우팅
TLS 암호화
✅ 로컬 머신은 아웃바운드 HTTPS 요청만 — 인바운드 포트 열기 없음, 포트포워딩 불필요
✅ 파일과 MCP 서버는 로컬 머신에 그대로 — Anthropic 서버로 전송되지 않음
✅ 단기 인증서(short-lived credentials)로 TLS 암호화
| 플랜 |
Remote Control |
비고 |
| Max ($100~200/월) |
✅ 지원 |
Research Preview로 먼저 출시 |
| Pro ($20/월) |
순차 지원 예정 |
Anthropic 공식 발표 |
| Team / Enterprise |
초기 미포함 |
개인 워크플로 검증 후 확대 예정 |
| API Key |
미지원 |
— |
2. Remote Control 시작 방법
먼저 Claude Code를 최신 버전으로 업데이트해야 한다. Remote Control은 v2.1.52 이상에서 지원된다.
# Claude Code 업데이트
$ npm install -g @anthropic-ai/claude-code
# 버전 확인
$ claude --version
# 2.1.52 이상이어야 Remote Control 사용 가능
STEP 1
Remote Control 세션 시작
두 가지 방법이 있다.
# 방법 1: 프로젝트 디렉토리에서 직접 시작
$ cd ~/myproject
$ claude remote-control
# 방법 2: 이미 세션 중이라면 슬래시 명령어
> /rc
# /remote-control 도 동일
STEP 2
URL 또는 QR코드로 원격 접속
세션이 시작되면 터미널에 URL과 QR코드가 출력된다. 세 가지 방법으로 원격 접속 가능하다.
방법 A│터미널에 표시된 세션 URL을 브라우저에서 열기
방법 B│QR코드를 폰 카메라로 스캔 → Claude 모바일 앱으로 연결
⚠️
알려진 제한 사항 (공식 문서)
세션당 원격 연결은 1개만 지원
터미널을 닫으면 세션도 종료됨 — Remote Control은 로컬에서 실행되므로
네트워크 단절이 약 10분 이상 지속되면 세션 타임아웃 → 재시작 필요
3. 막히는 지점 — 모니터 꺼지면 연결이 끊긴다
Remote Control 세션을 열어놓고 밖에 나갔는데 얼마 지나지 않아 연결이 끊긴다. 원인은 macOS의 네트워크 절전 기능이다.
증상 패턴
✅같은 Wi-Fi에서는 잘 됨
❌외부 네트워크(5G, 다른 Wi-Fi)에서 "연결 재시도" 반복
❌특히 맥미니 모니터가 꺼진 상태에서 증상 발생
❌Remote Control 세션 10분도 안 돼서 타임아웃
🔍
원인
macOS는 기본적으로 디스플레이가 꺼지면 네트워크도 절전 모드로 전환한다. 같은 Wi-Fi 내부에서는 Bonjour/mDNS로 빠르게 재연결되지만, 외부 네트워크에서는 연결이 완전히 끊어진다. 핵심 설정값은 networkoversleep이다. 기본값 0 = 디스플레이 꺼지면 네트워크 비활성화.
4. 해결 — 맥미니 네트워크 유지 설정
Remote Control 세션이 끊기지 않으려면 맥미니가 모니터를 꺼도 네트워크는 유지해야 한다. 4단계로 설정한다.
출력에서 아래 항목들을 확인한다.
| 항목 |
권장값 |
설명 |
| networkoversleep |
1 |
디스플레이 꺼져도 네트워크 유지 ← 핵심 |
| sleep |
0 |
시스템 잠자기 비활성화 |
| displaysleep |
10 |
디스플레이만 10분 후 꺼짐 (절전) |
| womp |
1 |
Wake on LAN 활성화 |
| tcpkeepalive |
1 |
TCP 연결 유지 |
# 디스플레이 꺼져도 네트워크 유지 — 이 한 줄이 핵심
$ sudo pmset -c networkoversleep 1
# -c = 전원 어댑터 연결 시 설정 / 비밀번호 입력 필요
# 시스템 잠자기 비활성화
$ sudo pmset -c sleep 0
# 디스플레이는 절전 유지 (10분 후 꺼짐)
$ sudo pmset -c displaysleep 10
caffeinate는 macOS 내장 명령어로 시스템이 잠들지 않도록 강제한다.
# 백그라운드에서 실행
$ caffeinate -s &
| 옵션 |
의미 |
| -s | 전원 연결 시 시스템 잠자기 방지 |
| -d | 디스플레이 잠자기도 방지 |
| -i | 유휴 상태 잠자기 방지 |
| & | 백그라운드 실행 |
⚠️
주의 — caffeinate는 터미널 세션이 종료되면 함께 종료된다. 재부팅 후에는 다시 실행해야 한다.
재부팅 후에도 자동 실행 — LaunchAgent 등록
매번 수동으로 실행하기 귀찮다면 LaunchAgent로 등록하면 된다.
# plist 파일 생성
cat << 'EOF' > ~/Library/LaunchAgents/com.user.caffeinate.plist
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.user.caffeinate</string>
<key>ProgramArguments</key>
<array>
<string>/usr/bin/caffeinate</string>
<string>-s</string>
</array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
</dict>
</plist>
EOF
# 등록
$ launchctl load ~/Library/LaunchAgents/com.user.caffeinate.plist
5. 전체 설정 한 번에 실행
복사해서 한 번에 실행하면 된다.
# 디스플레이 꺼져도 네트워크 유지 ← 핵심
$ sudo pmset -c networkoversleep 1
# 시스템 잠자기 비활성화
$ sudo pmset -c sleep 0
# 디스플레이는 10분 후 꺼짐 (절전)
$ sudo pmset -c displaysleep 10
# 시스템 깨어있기 유지
$ caffeinate -s &
sleep 0
displaysleep 10
networkoversleep 1 ← 이게 핵심
womp 1
tcpkeepalive 1
6. 추가 팁 — 원격 접속 앱 선택
Remote Control 외에도 SSH로 직접 맥미니에 접속하는 방법이 있다. 외부에서 접속할 때는 중계 서버를 사용하는 앱이 필요하다. 공유기 NAT/방화벽이 직접 접속을 막기 때문이다.
| 앱 |
특징 |
비용 |
| Tailscale |
VPN 터널 — 어디서든 같은 네트워크처럼 연결, 개발자 추천 |
무료 |
| Chrome Remote Desktop |
Google 계정만 있으면 됨, 간단 |
무료 |
| AnyDesk |
가볍고 빠름 |
무료 (개인) |
| TeamViewer |
가장 대중적, 기능 풍부 |
무료 (개인) |
💡
왜 같은 Wi-Fi에서는 되고 외부에서는 안 될까?
같은 Wi-Fi에서는 기기끼리 내부 IP(192.168.x.x)로 직접 통신이 가능하다. 외부(5G, 다른 Wi-Fi)에서는 공유기의 NAT/방화벽이 외부 접근을 차단한다. Tailscale 같은 중계 서버 방식은 양쪽 기기가 서버에 접속하는 구조라 NAT 영향을 받지 않는다.
// 정리
Remote Control 켜기 → claude remote-control
연결 끊기는 문제 → sudo pmset -c networkoversleep 1
이 두 가지면 카페에서도 맥미니를 마음대로 쓸 수 있다.
Tags:
#ClaudeCode
#RemoteControl
#macOS원격제어
#networkoversleep
#pmset
#MacMini
#caffeinate
#Tailscale