<div id="readability-page-1" class="page"><div data-pagefind-body="">    <blockquote>
<p>Claude Code 2.1.278, 2026-09-19 기준으로 홈서버(Linux)와 맥 데스크톱 앱, 폰 Claude 앱에서 확인했습니다. 원격 제어는 업데이트가 잦은 기능이라 버전이 다르면 동작도 다를 수 있습니다.</p>
</blockquote>
<p>저는 집에 둔 서버에서 Claude Code를 띄워 놓고 씁니다. 책상 앞에서는 터미널로 붙으면 되지만, 밖에서 생각난 일을 폰으로 바로 맡기고 싶을 때가 많았습니다. 이미 켜 둔 세션을 이어보는 것이 아니라, 폰에서 서버에 <strong>새 세션</strong>을 여는 방법이 필요했거든요.</p><p>답은 홈서버의 tmux 안에 <strong><code>claude remote-control</code> 서버 모드를 띄워 두는 것</strong>이었습니다. 서버 모드가 도는 머신은 Claude 앱 코드 탭에 기기로 나타나고, 거기서 폴더를 고르면 그 머신에서 새 세션이 시작됩니다.</p>
<p>다만 <strong>서버를 끄고 켜는 부분은 아직 불안정합니다.</strong> 원격 제어는 2026년 2월 research preview로 나와 <a href="https://code.claude.com/docs/en/whats-new/2026-w34" rel="nofollow noopener noreferrer" target="_blank">8월 셋째 주에야 preview를 벗어난</a> 기능입니다. 저도 한 시간 남짓 사이에 몇 번 재시작했을 뿐인데 시작 거부, 첫 세션 등록 실패, 기기 목록에 같은 환경이 두 개 뜨는 문제를 모두 겪었습니다. 이 글은 서버 모드를 고른 이유와 운용 설정, 그리고 그 불안정한 부분을 어떻게 넘겼는지를 정리한 것입니다.</p>
<section><h2 id="rc와-서버-모드는-목적이-다릅니다">/rc와 서버 모드는 목적이 다릅니다<a href="#rc와-서버-모드는-목적이-다릅니다"><span data-pagefind-ignore="">#</span></a></h2><p>Claude Code의 <a href="https://code.claude.com/docs/en/remote-control" rel="nofollow noopener noreferrer" target="_blank">원격 제어(Remote Control)</a>는 두 가지로 쓸 수 있습니다. 대화 중에 <code>/rc</code>를 입력하면 <strong>지금 이 세션 하나</strong>를 폰과 브라우저에서 이어볼 수 있게 되고, <code>claude remote-control</code>로 띄운 서버 모드는 앱에서 요청할 때마다 <strong>새 세션을 만들어 줍니다</strong>.</p>


































<table><thead><tr><th></th><th><code>/rc</code></th><th><code>claude remote-control</code> (서버 모드)</th></tr></thead><tbody><tr><td>원격이 되는 것</td><td>지금 대화 하나</td><td>서버가 만드는 세션들</td></tr><tr><td>세션 수</td><td>프로세스당 1개</td><td>서버당 최대 32개 (<code>--capacity</code>)</td></tr><tr><td>새 세션을 여는 곳</td><td>터미널에서 <code>claude</code></td><td>앱·브라우저의 새 세션 버튼</td></tr><tr><td>터미널에서 타이핑</td><td>됨</td><td>안 됨 (주소와 세션 수만 표시)</td></tr><tr><td>네트워크가 오래 끊기면</td><td>계속 재시도</td><td>약 10분 뒤 서버 종료</td></tr></tbody></table><p>이미 켜 둔 세션을 폰으로 이어보는 것이 목적이라면 서버 모드는 필요 없습니다. 저는 홈서버의 <code>~/.claude/settings.json</code>에 <a href="https://code.claude.com/docs/en/remote-control#enable-remote-control-for-all-sessions" rel="nofollow noopener noreferrer" target="_blank"><code>remoteControlAtStartup</code></a>을 <code>true</code>로 넣어 두어서 <code>claude</code>를 띄우기만 해도 <code>/rc</code> 상태가 됩니다. 서버 모드가 필요한 경우는 폰이나 맥 앱에서 세션을 새로 시작하고 싶을 때뿐입니다.</p></section>
<section><h2 id="서버-모드-띄우기">서버 모드 띄우기<a href="#서버-모드-띄우기"><span data-pagefind-ignore="">#</span></a></h2><p>서버 모드는 작업할 저장소 폴더에서 한 번 띄워 두면 됩니다. 저는 홈서버의 tmux 세션 안에서 아래처럼 실행합니다. tmux에 두는 이유는 SSH가 끊겨도 서버가 살아 있어야 해서입니다.</p><div><figure><pre data-language="bash"><code><div><p><span>cd</span><span> </span><span>~/dev/my-project</span></p></div><div><p><span>claude</span><span> </span><span>remote-control</span><span> </span><span>\</span></p></div><div><p><span>  </span><span>--name</span><span> </span><span>home-main</span><span> </span><span>\</span></p></div><div><p><span>  </span><span>--remote-control-session-name-prefix</span><span> </span><span>home</span><span> </span><span>\</span></p></div><div><p><span>  </span><span>--spawn</span><span> </span><span>same-dir</span></p></div></code></pre></figure></div><p><code>--name</code>은 서버가 시작할 때 미리 만드는 첫 세션에만 붙는 이름입니다. 앱에서 새로 만든 세션은 <code>--remote-control-session-name-prefix</code>로 정한 접두어에 임의의 단어가 붙은 이름(<code>home-happy-cocke</code> 같은)으로 시작하고, 첫 메시지를 보내면 대화 내용으로 제목이 바뀝니다.</p><p><code>--spawn</code>은 새 세션이 일할 폴더를 정합니다. <code>same-dir</code>(기본값)은 모든 세션이 같은 체크아웃을 쓰고, <code>worktree</code>는 세션마다 git worktree를 새로 만듭니다. 이 저장소에는 gitignore된 데이터와 <code>.env</code>가 있는데 worktree 사본에는 그 파일들이 없어서, 세션끼리 같은 파일을 동시에 고칠 위험을 감수하고 <code>same-dir</code>을 골랐습니다. 작업마다 PR 브랜치를 따는 저장소라면 <code>worktree</code>가 더 맞습니다.</p><p>서버가 뜨면 터미널에는 세션 주소와 <code>Capacity: 1/32</code> 같은 현재 세션 수만 보입니다. 이 화면은 키 입력을 받는다는 점을 조심해야 합니다. 스페이스를 누르면 QR 코드가 뜨고 <code>w</code>를 누르면 <code>--spawn</code> 방식이 바뀝니다. 그래서 tmux 창에 명령을 치기 전에 서버가 떠 있는지 <code>ps</code>로 먼저 확인합니다.</p></section>
<section><h2 id="폰에서-새-세션-시작하기">폰에서 새 세션 시작하기<a href="#폰에서-새-세션-시작하기"><span data-pagefind-ignore="">#</span></a></h2><p>폰에서 세션을 시작하는 기능은 원격 제어가 preview를 벗어난 같은 주에 나왔습니다. ClaudeDevs 계정은 2026년 8월 22일(한국 시간) <a href="https://x.com/ClaudeDevs/status/2090933155847143498" rel="nofollow noopener noreferrer" target="_blank">“지난달 여러분이 가장 고쳐 달라고 한 것이 Remote Control이었다”</a>는 말로 안정성 개선 스레드를 시작했고, 이 기능은 그 두 번째 글입니다.</p><div data-tweet-id="2090933157243863142"><p lang="en">You can now start a Claude Code session directly from your phone.

Any machine running claude remote-control shows up as a device card at the top of the Code tab. Tap it, pick a directory, and it starts on that machine.</p></div><p>맥 데스크톱 앱에서도 같은 기기가 보입니다. 새 세션을 만들 때마다 터미널의 <code>Capacity</code> 숫자가 하나씩 올라가는 것으로 서버 쪽에서 세션이 생겼는지 확인할 수 있습니다.</p></section><section><h2 id="서버를-끄고-켤-때는-아직-불안정합니다">서버를 끄고 켤 때는 아직 불안정합니다<a href="#서버를-끄고-켤-때는-아직-불안정합니다"><span data-pagefind-ignore="">#</span></a></h2><p><code>claude remote-control</code> 서버 모드는 띄워 둔 동안은 문제없이 돌지만, 껐다가 다시 켤 때 문제가 몰립니다. <a href="https://code.claude.com/docs/en/changelog" rel="nofollow noopener noreferrer" target="_blank">CHANGELOG</a>를 보면 8월 한 달에만 원격 제어 관련 수정이 수십 건 들어갔고, 그중에는 서버가 도중에 꺼져 연결된 세션이 버려지는 문제도 있었습니다.</p><p>제 경우에도 설정을 바꾸느라 몇 번 재시작했을 뿐인데 아래 문제가 연달아 나왔고, 에러 메시지만으로는 원인을 알 수 없었습니다. <strong>서버는 자주 껐다 켜지 말고, 꺼야 하면 몇 분 기다렸다가 켜는 것</strong>이 지금으로서는 가장 확실한 대응입니다.</p><section><h3 id="끄고-바로-켜면-already-served로-막힙니다">끄고 바로 켜면 already served로 막힙니다<a href="#끄고-바로-켜면-already-served로-막힙니다"><span data-pagefind-ignore="">#</span></a></h3><p>짧은 간격으로 두 번 껐다 켰더니, 세 번째 시작이 아래 메시지로 거부됐습니다. 서버에는 해당 프로세스가 없었는데도 약 8분 동안 같은 메시지가 계속 나왔고, 그 뒤에는 저절로 풀렸습니다.</p><div><figure><pre data-language="text"><code><div><p><span>This folder is already served by a terminal claude remote-control on this device</span></p></div></code></pre></figure></div><p>이 사이 앱의 기기 목록에는 같은 폴더의 환경이 두 개 보였습니다. 진짜는 터미널의 <code>Capacity</code>와 세션 수가 같은 쪽이었습니다.</p></section><section><h3 id="첫-세션-등록이-404로-실패합니다">첫 세션 등록이 404로 실패합니다<a href="#첫-세션-등록이-404로-실패합니다"><span data-pagefind-ignore="">#</span></a></h3><p>차단이 풀린 뒤에는 서버가 뜨긴 했지만, 시작할 때마다 아래 에러가 나왔습니다. 첫 세션이 만들어지지 않아 <code>Capacity 0/32</code>로 떴고 <code>--name</code>도 적용되지 않았습니다.</p><div><figure><pre data-language="text"><code><div><p><span>CCR v2 worker registration failed for session cse_… 404</span></p></div></code></pre></figure></div><p>제 경우에는 서버를 끄고 몇 분 기다린 뒤, 첫 세션 정보가 기록된 <code>~/.claude/projects/&lt;폴더&gt;/bridge-pointer.json</code>을 다른 이름으로 옮기고 다시 켜니 풀렸습니다. 404 없이 첫 세션이 생기고 <code>Capacity 1/32</code>로 떴습니다.</p></section><section><h3 id="ctrlc로-꺼도-세션-목록에-남습니다">Ctrl+C로 꺼도 세션 목록에 남습니다<a href="#ctrlc로-꺼도-세션-목록에-남습니다"><span data-pagefind-ignore="">#</span></a></h3><p>서버를 Ctrl+C로 꺼도 앱의 목록에서 세션이 사라지지 않습니다. <a href="https://code.claude.com/docs/en/remote-control#resume-sessions-after-stopping-the-server" rel="nofollow noopener noreferrer" target="_blank">문서에 적힌 동작</a>으로, 약 4시간 안에 <code>claude remote-control --continue</code>로 다시 켜면 그 세션을 되살릴 수 있게 남겨 두는 것입니다. 목록에서 치우려면 앱에서 세션을 보관하거나 삭제해야 하고, 등록을 지우는 CLI 명령은 없습니다.</p></section><section><h3 id="originhead가-없으면-생성된-브랜치에서-일합니다">origin/HEAD가 없으면 생성된 브랜치에서 일합니다<a href="#originhead가-없으면-생성된-브랜치에서-일합니다"><span data-pagefind-ignore="">#</span></a></h3><p>시작할 때 아래 경고가 함께 나왔습니다.</p><div><figure><pre data-language="text"><code><div><p><span>[bridge] no session-anchored default-branch evidence — … the remote session will work on a generated branch instead</span></p></div></code></pre></figure></div><p>체크아웃에 <code>refs/remotes/origin/HEAD</code>가 없어서 기본 브랜치를 알아내지 못한 것이었습니다. <code>git remote set-head origin -a</code>로 한 번 설정하면 사라집니다. 다른 저장소에서 서버 모드를 띄울 때도 먼저 확인할 부분입니다.</p></section><section><h3 id="앱에서-만든-세션이-매번-권한-승인을-요청합니다">앱에서 만든 세션이 매번 권한 승인을 요청합니다<a href="#앱에서-만든-세션이-매번-권한-승인을-요청합니다"><span data-pagefind-ignore="">#</span></a></h3><p>처음에는 앱에서 만든 세션이 도구를 쓸 때마다 승인을 요청했습니다. 앱의 모드 메뉴에는 Auto, Manual, Accept edits, Plan만 있고 bypass가 없어서, 앱 쪽에서는 이것을 끌 수 없습니다.</p><p>서버가 만드는 세션의 시작 모드는 <code>claude remote-control --permission-mode &lt;mode&gt;</code>로 정합니다. 저는 개인 서버라서 전역 <code>~/.claude/settings.json</code>에 <code>permissions.defaultMode</code>를 <code>bypassPermissions</code>로 넣어 두었고, 지금은 새 세션이 승인 요청 없이 뜹니다. 이미 떠 있던 세션에는 적용되지 않으니, 그런 세션은 모드 메뉴에서 Auto를 고르는 것이 최선이었습니다.</p></section></section>  </div></div>

Monologg Blog

Claude Code 2.1.278, 2026-09-19 기준으로 홈서버(Linux)와 맥 데스크톱 앱, 폰 Claude 앱에서 확인했습니다. 원격 제어는 업데이트가 잦은 기능이라 버전이 다르면 동작도 다를 수 있습니다.
저는 집에 둔 서버에서 Claude Code를 띄워 놓고 씁니다. 책상 앞에서는 터미널로 붙으면 되지만, 밖에서 생각난 일을 폰으로 바로 맡기고 싶을 때가 많았습니다. 이미 켜 둔 세션을 이어보는 것이 아니라, 폰에서 서버에 새 세션을 여는 방법이 필요했거든요.
답은 홈서버의 tmux 안에 claude remote-control 서버 모드를 띄워 두는 것이었습니다. 서버 모드가 도는 머신은 Claude 앱 코드 탭에 기기로 나타나고, 거기서 폴더를 고르면 그 머신에서 새 세션이 시작됩니다.
다만 서버를 끄고 켜는 부분은 아직 불안정합니다. 원격 제어는 2026년 2월 research preview로 나와 8월 셋째 주에야 preview를 벗어난 기능입니다. 저도 한 시간 남짓 사이에 몇 번 재시작했을 뿐인데 시작 거부, 첫 세션 등록 실패, 기기 목록에 같은 환경이 두 개 뜨는 문제를 모두 겪었습니다. 이 글은 서버 모드를 고른 이유와 운용 설정, 그리고 그 불안정한 부분을 어떻게 넘겼는지를 정리한 것입니다.
/rc와 서버 모드는 목적이 다릅니다
Claude Code의 원격 제어(Remote Control)는 두 가지로 쓸 수 있습니다. 대화 중에 /rc를 입력하면 지금 이 세션 하나를 폰과 브라우저에서 이어볼 수 있게 되고, claude remote-control로 띄운 서버 모드는 앱에서 요청할 때마다 새 세션을 만들어 줍니다.
/rc
claude remote-control (서버 모드)
원격이 되는 것
지금 대화 하나
서버가 만드는 세션들
세션 수
프로세스당 1개
서버당 최대 32개 (--capacity)
새 세션을 여는 곳
터미널에서 claude
앱·브라우저의 새 세션 버튼
터미널에서 타이핑
됨
안 됨 (주소와 세션 수만 표시)
네트워크가 오래 끊기면
계속 재시도
약 10분 뒤 서버 종료
이미 켜 둔 세션을 폰으로 이어보는 것이 목적이라면 서버 모드는 필요 없습니다. 저는 홈서버의 ~/.claude/settings.json에 remoteControlAtStartup을 true로 넣어 두어서 claude를 띄우기만 해도 /rc 상태가 됩니다. 서버 모드가 필요한 경우는 폰이나 맥 앱에서 세션을 새로 시작하고 싶을 때뿐입니다.
서버 모드 띄우기
서버 모드는 작업할 저장소 폴더에서 한 번 띄워 두면 됩니다. 저는 홈서버의 tmux 세션 안에서 아래처럼 실행합니다. tmux에 두는 이유는 SSH가 끊겨도 서버가 살아 있어야 해서입니다.
cd ~/dev/my-project
claude remote-control \
  --name home-main \
  --remote-control-session-name-prefix home \
  --spawn same-dir
--name은 서버가 시작할 때 미리 만드는 첫 세션에만 붙는 이름입니다. 앱에서 새로 만든 세션은 --remote-control-session-name-prefix로 정한 접두어에 임의의 단어가 붙은 이름(home-happy-cocke 같은)으로 시작하고, 첫 메시지를 보내면 대화 내용으로 제목이 바뀝니다.
--spawn은 새 세션이 일할 폴더를 정합니다. same-dir(기본값)은 모든 세션이 같은 체크아웃을 쓰고, worktree는 세션마다 git worktree를 새로 만듭니다. 이 저장소에는 gitignore된 데이터와 .env가 있는데 worktree 사본에는 그 파일들이 없어서, 세션끼리 같은 파일을 동시에 고칠 위험을 감수하고 same-dir을 골랐습니다. 작업마다 PR 브랜치를 따는 저장소라면 worktree가 더 맞습니다.
서버가 뜨면 터미널에는 세션 주소와 Capacity: 1/32 같은 현재 세션 수만 보입니다. 이 화면은 키 입력을 받는다는 점을 조심해야 합니다. 스페이스를 누르면 QR 코드가 뜨고 w를 누르면 --spawn 방식이 바뀝니다. 그래서 tmux 창에 명령을 치기 전에 서버가 떠 있는지 ps로 먼저 확인합니다.
폰에서 새 세션 시작하기
폰에서 세션을 시작하는 기능은 원격 제어가 preview를 벗어난 같은 주에 나왔습니다. ClaudeDevs 계정은 2026년 8월 22일(한국 시간) "지난달 여러분이 가장 고쳐 달라고 한 것이 Remote Control이었다"는 말로 안정성 개선 스레드를 시작했고, 이 기능은 그 두 번째 글입니다.
X 게시물 보기
맥 데스크톱 앱에서도 같은 기기가 보입니다. 새 세션을 만들 때마다 터미널의 Capacity 숫자가 하나씩 올라가는 것으로 서버 쪽에서 세션이 생겼는지 확인할 수 있습니다.
서버를 끄고 켤 때는 아직 불안정합니다
claude remote-control 서버 모드는 띄워 둔 동안은 문제없이 돌지만, 껐다가 다시 켤 때 문제가 몰립니다. CHANGELOG를 보면 8월 한 달에만 원격 제어 관련 수정이 수십 건 들어갔고, 그중에는 서버가 도중에 꺼져 연결된 세션이 버려지는 문제도 있었습니다.
제 경우에도 설정을 바꾸느라 몇 번 재시작했을 뿐인데 아래 문제가 연달아 나왔고, 에러 메시지만으로는 원인을 알 수 없었습니다. 서버는 자주 껐다 켜지 말고, 꺼야 하면 몇 분 기다렸다가 켜는 것이 지금으로서는 가장 확실한 대응입니다.
끄고 바로 켜면 already served로 막힙니다
짧은 간격으로 두 번 껐다 켰더니, 세 번째 시작이 아래 메시지로 거부됐습니다. 서버에는 해당 프로세스가 없었는데도 약 8분 동안 같은 메시지가 계속 나왔고, 그 뒤에는 저절로 풀렸습니다.
This folder is already served by a terminal claude remote-control on this device
이 사이 앱의 기기 목록에는 같은 폴더의 환경이 두 개 보였습니다. 진짜는 터미널의 Capacity와 세션 수가 같은 쪽이었습니다.
첫 세션 등록이 404로 실패합니다
차단이 풀린 뒤에는 서버가 뜨긴 했지만, 시작할 때마다 아래 에러가 나왔습니다. 첫 세션이 만들어지지 않아 Capacity 0/32로 떴고 --name도 적용되지 않았습니다.
CCR v2 worker registration failed for session cse_… 404
제 경우에는 서버를 끄고 몇 분 기다린 뒤, 첫 세션 정보가 기록된 ~/.claude/projects/<폴더>/bridge-pointer.json을 다른 이름으로 옮기고 다시 켜니 풀렸습니다. 404 없이 첫 세션이 생기고 Capacity 1/32로 떴습니다.
Ctrl+C로 꺼도 세션 목록에 남습니다
서버를 Ctrl+C로 꺼도 앱의 목록에서 세션이 사라지지 않습니다. 문서에 적힌 동작으로, 약 4시간 안에 claude remote-control --continue로 다시 켜면 그 세션을 되살릴 수 있게 남겨 두는 것입니다. 목록에서 치우려면 앱에서 세션을 보관하거나 삭제해야 하고, 등록을 지우는 CLI 명령은 없습니다.
origin/HEAD가 없으면 생성된 브랜치에서 일합니다
시작할 때 아래 경고가 함께 나왔습니다.
[bridge] no session-anchored default-branch evidence — … the remote session will work on a generated branch instead
체크아웃에 refs/remotes/origin/HEAD가 없어서 기본 브랜치를 알아내지 못한 것이었습니다. git remote set-head origin -a로 한 번 설정하면 사라집니다. 다른 저장소에서 서버 모드를 띄울 때도 먼저 확인할 부분입니다.
앱에서 만든 세션이 매번 권한 승인을 요청합니다
처음에는 앱에서 만든 세션이 도구를 쓸 때마다 승인을 요청했습니다. 앱의 모드 메뉴에는 Auto, Manual, Accept edits, Plan만 있고 bypass가 없어서, 앱 쪽에서는 이것을 끌 수 없습니다.
서버가 만드는 세션의 시작 모드는 claude remote-control --permission-mode <mode>로 정합니다. 저는 개인 서버라서 전역 ~/.claude/settings.json에 permissions.defaultMode를 bypassPermissions로 넣어 두었고, 지금은 새 세션이 승인 요청 없이 뜹니다. 이미 떠 있던 세션에는 적용되지 않으니, 그런 세션은 모드 메뉴에서 Auto를 고르는 것이 최선이었습니다.

폰에서 Claude Code 세션 띄우기, 원격 제어 서버 모드로 내 서버에

댓글