Claude Code를 원격 Mac에서 24시간 돌릴 수 있나? 2026 배포 가이드

최신 상태

2026년 9월에도 「원격 24/7」을 검색하는 이유

Claude Code가 갑자기 클라우드로 이사해서가 아니다. 공식 문서가 Remote Control을 정식 기능으로 쓰면서 「자리를 비워도 이어서 본다」와 「덮개를 닫아도 작업이 계속된다」가 같은 검색어로 섞였다. 실제 경계는 반대다. 세션은 이미 Claude Code를 켠 머신에서 계속 돈다. 노트북이 잠들면 실행이 멈추고, 깨어난 뒤에야 다시 붙는다. 자세한 내용은 Claude Code Remote Control 공식 문서를 보면 된다.

두 번째는 한 세션이 길어진 점이다. 함수 몇 줄로 끝나지 않고 테스트, 리팩터, MCP, 하위 에이전트가 십몇 분을 먹는다. 지하철을 타려고 덮개를 닫는 것은 그 긴 작업을 직접 끊는 일이다. 세 번째는 iOS / macOS 작업이 여전히 실제 애플 하드웨어에 묶여 있다는 점이다. Linux VPS에 CLI는 올라가지만 Xcode, 시뮬레이터, 서명은 올라가지 않는다.

그래서 지금 검색은 「Claude Code가 무엇인가」가 아니라 원격으로 보기, 원격으로 실행하기, 정말 전원을 끄지 않기를 가르는 일이다. 다음 맥북 디자인을 기다릴 필요는 없다. 들고 다니는 노트북과 24/7 노드는 역할을 나누는 편이 낫다. 폼팩터를 고민 중이라면 2026 다이내믹 아일랜드 맥북은 기다릴 가치가 있을까요? 개발자는 지금 구매할까요, 먼저 과도기를 거칠까요에서 휴대 기기를 정리하고, 상시 가동 호스트는 그와 분리해서 고르면 덜 헷갈린다.

다섯 가지 돌리는 법: 로컬, Remote Control, 직접 산 mini, 원격 Mac, CI

제품 설명부터 시작하지 마라. 아픈 지점으로 경로를 고른다. 아래 다섯은 모두 Claude Code를 돌리지만, 덮개를 닫은 뒤에도 살아남을 가능성이 있는 것은 뒤의 셋뿐이다.

경로 1: 로컬 노트북을 켜 두기.가장 쉽고, 24/7로 가장 자주 착각하는 배포다. 덮개를 열고 macOS를 재우지 않으면 밤새 돌릴 수 있다. 문제는 그 한 대가 모니터이자 키보드이자 출장 짐이라는 점이다. 덮개를 닫거나, 지하철에 들어가거나, 자동 절전이 걸리면 작업은 멈춘다. 「오늘 오후에 이 세션을 끝낸다」에는 맞고, 「내일 아침에 차이를 본다」에는 안 맞는다.

경로 2: 로컬에 Remote Control을 붙이기.공식이 준비한 것은 「사람은 키보드에서 떠나지만 머신은 책상 위」인 배포다. 폰과 브라우저는 창이고, MCP, 저장소, 인증서는 로컬에 남는다. 해결하는 것은 「점심때 권한을 한 번 승인하는 것」이지 「노트북을 가방에 넣는 것」이 아니다. Team / Enterprise는 관리자가 스위치를 켜야 한다. API 키로는 쓸 수 없다.

경로 3: 직접 산 Mac mini를 자리나 집에 두기.개인이 24/7에 가장 가까운 자체 배포다. 전원을 켜 두고 SSH나 화면 공유로 들어간다. 대가는 공인 노출, 유동 IP, 정전, 디스크를 직접 지는 것이다. 원격 로그인을 열 때는 Apple 「다른 컴퓨터가 Mac에 접근하도록 허용」 안내를 따라 필요한 계정만 열고, 관리자 비밀번호를 인터넷에 그대로 두지 마라.

경로 4: 원격 Mac / 클라우드 Mac.경로 3과의 차이는 「Claude Code가 도느냐」가 아니라 전기, 회선, 디스크, 계정 회수를 직접 쥘지다. 덮개를 닫고 나가고, 밤에 에이전트에게 테스트를 이어 맡기고, 동료와 같은 고정 Xcode에 붙어야 할 때 비로소 월정액을 검색할 이유가 생긴다. 상시 가동 노드는 「다음에 살 맥북」과 역할이 다르다. 휴대 기기는 위 글로 정리하고, 여기서는 호스트가 잠들지 않는지만 조건으로 삼아라.

경로 5: CI에 맡기기.Xcode Cloud나 GitHub macOS 러너는 패키징과 테스트에 맞다. 세션 안에서 프롬프트를 주고받는 작업에는 안 맞다. 「CI는 24/7로 줄을 세울 수 있다」를 「Claude Code 대화 세션이 24/7이다」로 읽지 마라.

Remote Control과 SSH + tmux는 다른 도구다

같은 검색 결과에 자주 붙지만 고치는 통증이 다르다. Remote Control은 로그인한 claude.ai나 Claude 앱을 이미 돌아가는 로컬 프로세스에 붙인다. SSH는 다른 macOS에 들어가 그쪽에서 프로세스를 켠다. 24/7이 원하는 것은 후자의 「프로세스 주인을 바꾸는 것」이지, 전자의 「화면을 하나 더하는 것」이 아니다.

공식 제한은 단호하다. 터미널을 닫거나, VS Code를 종료하거나, claude 프로세스를 멈추면 원격 세션은 몇 초 안에 오프라인으로 보인다. SSH가 끊긴 뒤에도 돌리려면 세션을 tmux나 screen에 넣어야 한다. 서버 모드는 네트워크가 대략 10분 끊기면 스스로 종료하고, claude remote-control을 다시 실행해야 한다. 커뮤니티 소문이 아니라 같은 Remote Control 문서의 Limitations다.

로그인 방식도 나눠 봐라. claude setup-token과 CLAUDE_CODE_OAUTH_TOKEN은 CI와 스크립트에 맞고 유효 기간이 길지만 모델 요청만 가능하고 Remote Control은 열지 못한다. 폰에서 이어서 보려면 API 키가 아니라 claude.ai 전체 로그인이 필요하다. Claude Code 인증 안내를 먼저 읽고, GUI 없는 상자에 토큰만 뿌린 뒤 claude remote-control이 “full-scope login token”을 내는 이유를 나중에 찾지 마라.

이름이 비슷한 함정이 하나 더 있다. Claude Code on the web이다. 화면은 claude.ai/code를 Remote Control과 공유하지만 세션은 클라우드 인프라에서 돌고, 그 원격 Mac의 인증서, DerivedData, 로컬 MCP는 쓰지 않는다. iOS 서명, 키체인, 사내 MCP가 필요하면 프로세스는 실제 macOS에 두어야 한다.

시작 전에 준비할 것

환경을 한 번에 적어 두지 않으면 이후 단계는 로그인 화면에서 멈춘다.

• 자동 절전하지 않는 macOS 호스트. 로컬이 아닌 mini, 또는 원격 Mac.
• 「원격 로그인」이 열려 있고, 내 노트북에서 SSH로 들어갈 수 있을 것.
• Claude Code CLI는 그 호스트에 설치한다. 로컬에서 마운트 너머로 돌리지 마라.
• 호스트에 tmux나 screen. 로그인 후 첫 명령은 세션으로 들어가는 것이다.
• Remote Control을 쓸 거면 Pro / Max / Team / Enterprise와 claude.ai 로그인. Team / Enterprise는 관리자 스위치도 필요하다.
• 프로젝트 디렉터리에서 claude를 한 번 성공시키고 워크스페이스 신뢰를 받은 상태. Remote Control은 홈 디렉터리를 신뢰된 것으로 기억하지 않는다.
• 환경의 유일한 로그인을 ANTHROPIC_API_KEY로 두지 마라. 커스텀 ANTHROPIC_BASE_URL에 Remote Control을 기대하지 마라.

메모리는 「공식 최소 기동」으로 고르지 마라. CLI와 중소 규모 저장소만 돌리면 16GB면 되는 경우가 많다. Xcode, 시뮬레이터, 에이전트를 둘 이상 같이 열면 24GB가 피크에서 스왑으로 밀릴 가능성이 낮다. 용량 계획이지, 대조 실험 점수가 아니다.

원격 Mac에서 세션을 붙들어 두기

이미 SSH로 대상 Mac에 들어갈 수 있다고 가정한다. 목표는 「들어가서 대화하는 것」이 아니라 「끊긴 뒤에도 프로세스가 남는 것」이다.

1. 먼저 절전을 끈다

시스템 설정 → 배터리 / 전원 어댑터: 자동 잠자기를 막고, 필요하면 디스플레이만 끄고 시스템은 깨워 둔다. 호스트가 잠들면 tmux로도 진행 중인 모델 요청은 살리지 못한다.

2. 원격 로그인을 열고 통과를 확인한다

시스템 설정 → 일반 → 공유 → 원격 로그인. 필요한 사용자만 허용한다. 로컬에서 실행한다.

ssh user@mac-host.local
uname -m
sw_vers

아키텍처와 시스템 버전이 보이면 다음으로 간다. 안 되면 방화벽, 회사 VPN, 「같은 iCloud 사용자만」 같은 제한을 먼저 보고 Claude Code를 설치하지 마라.

3. 로그인하면 바로 tmux로

tmux new -A -s claude
# 그다음 Claude Code를 설치하거나 켠다
# 떠날 때: Ctrl-b 다음 d
# 다음번: tmux attach -t claude

공식 취지는 한 문장으로 줄일 수 있다. SSH가 끊겨도 세션을 남기려면 tmux나 screen에 넣어라. 이 한 단계가 없으면 이후 Remote Control 기법은 SSH와 함께 죽는 프로세스를 화장하는 일이다.

4. 호스트에서 로그인하고 켠다

tmux 안에서 프로젝트로 들어가 claude를 실행하고 /login으로 claude.ai를 쓴다. 브라우저가 없는 상자라면 GUI 있는 머신에서 먼저 claude setup-token을 끝내고, 토큰은 스크립트나 CI에만 쓴다. 폰으로도 원격 조작하려면 돌아와서 전체 로그인을 보태라. 일상 24/7 대화 세션이라면 아래가 다루기 쉽다.

cd ~/Projects/ios-app
claude --remote-control "night-agent"

이렇게 하면 터미널에 칠 수 있는 대화 세션이 남고, 동시에 claude.ai / Claude 앱에서도 붙을 수 있다. 이 머신을 서버로만 두고 입력은 전부 폰에서 하려면 claude remote-control이다. 두 모드 모두 이 프로세스를 종료하지 않는 것이 조건이다.

5. 한 번 끊어서 검수한다

「아마 남아 있겠지」를 믿지 마라. 이 목록을 한 번 통과한다.

• tmux에서 detach하고 로컬 SSH 창을 닫는다.
• 다시 SSH한 뒤 tmux attach -t claude. 세션과 스크롤 기록이 남아 있다.
• Remote Control을 켰다면 로컬 SSH를 닫은 뒤에도 폰에서 온라인이 보인다.
• 호스트를 2분 재운 뒤 깨운다. 세션은 잠시 멈춘 뒤 복구하고, 「한 번도 안 끊겼다」고 가장하지 않는다.
• tmux ls를 본다. server가 없다고 나오면 지난번은 tmux 밖에서 켠 것이다.

끊김, 절전, 로그인 실패를 가르는 법

세션이 안 보인다.먼저 tmux ls다. server가 없으면 「잃어버린 것」이 아니라 안 올려 둔 것이다. 습관으로 만들어라. 로그인 후 첫 명령은 항상 tmux new -A -s claude다.

Remote Control이 전체 로그인을 요구한다.setup-token이나 CLAUDE_CODE_OAUTH_TOKEN을 썼을 가능성이 크다. 환경 변수를 빼고 claude auth login을 실행한 뒤 claude.ai를 고른다. 환경에 ANTHROPIC_API_KEY가 남아 있으면 지우고 로그인한다.

덮개를 닫으니 폰이 오프라인이거나 멈춘다.예상된 동작이지 설정 오류가 아니다. Remote Control은 호스트가 돌아온 뒤에 다시 붙는다. 잠든 노트북 위에서 파일을 계속 고치지 않는다. 나가려면 프로세스를 잠들지 않는 다른 Mac으로 옮겨라.

서버 모드가 스스로 끝난다.호스트는 깨어 있어도 네트워크가 대략 10분 끊기면 claude remote-control은 포기한다. 대화 모드는 로컬에서 재시도를 이어 간다. SSH로 tmux에 다시 들어가 서버 모드를 한 번 더 켜면 된다.

커스텀 게이트웨이거나 Bedrock.Remote Control은 api.anthropic.com을 통해야 한다. ANTHROPIC_BASE_URL, Bedrock, Vertex, 기업 게이트웨이를 쓰면 이 기능은 없는 것으로 보고 SSH + tmux 순수 터미널 배포로 바꿔라.

권한 팝업을 누를 사람이 없다.Remote Control은 일부 확인을 폰으로 넘길 수 있지만 모든 대화 상자가 전달되지는 않는다. 오래 비울 때는 자동 승인 범위를 감수할 수 있는 곳까지 조이고, 어딘가에서 사람이 다시 본다는 전제를 남겨 둬라.

누구에게 맞나, 누구에게 안 맞나

자주 묻는 질문