폰으로 내 PC의 클로드를 켭니다 — 공식 기능인데 문턱이 다섯 개였습니다

클로드 코드 뉴스레터가 8월 29일에 이렇게 알렸습니다.

Any machine running claude rc shows up as a device card at the top of the Code tab.
Tap it, pick a directory, and it starts on that machine.

한 줄이면 되는 것처럼 읽힙니다. 그런데 실제로 켜보니 통과할 게 다섯 가지였습니다. 저희는 그중 두 개에서 막혔고, 하나는 원인을 찾는 데 30분이 걸렸습니다.

이 글은 켜는 순서와 막힌 곳을 그대로 적은 기록입니다. 공식 문서가 적어둔 조건, 그리고 문서에도 없는 함정까지 같이 넣었습니다.

먼저, 이게 왜 반가웠냐면

과거에는 우리가 폰 원격 우회로를 직접 만들었고, 지금은 공식 기능이 되었다는 타임라인 — 우회로가 공식이 된 순간

저희는 이걸 직접 만들어 쓰고 있었습니다. 폰으로 PC의 클로드를 조종하는 스킬을 만들었고, 그 제작기를 릴스로 올려 2,112회가 나왔습니다. 그만큼 아쉬웠던 자리라는 뜻이겠죠.

이제 안 만들어도 됩니다. 저희가 만든 게 쓸모없어졌다는 게 이 글의 좋은 소식입니다.

이런 소식, 남들보다 먼저 받으실 분?
직접 돌려보고 되는 것만 골라 매주 보내드립니다. 광고성 하이프는 거릅니다.

📮 뉴스레터 신청

클라우드 코딩과 갈리는 지점

비슷해 보이는 것들이 있어서 먼저 구분해야 합니다. 이건 클라우드에서 도는 게 아닙니다.

Remote Control은 내 PC에서 돌고, 클라우드 코딩은 원격 컨테이너에서 돈다는 비교 — 세션은 내 컴퓨터에서 돌고, 폰은 그걸 들여다보는 창입니다

공식 문서의 표현을 그대로 옮기면 이렇습니다.

Unlike Claude Code on the web, which runs on cloud infrastructure, Remote Control sessions run directly on your machine and interact with your local filesystem. The web and mobile interfaces are a window into that local session.

그래서 내 파일·MCP 서버·스킬·권한 규칙이 그대로 붙습니다. 폰에서 @를 치면 내 프로젝트의 파일 경로가 자동완성되고요. 환경을 새로 맞출 필요가 없다는 게 이 기능의 핵심입니다.

켜는 법 — 네 줄

결론부터 적습니다. 이 순서대로 하면 됩니다.

# 1. 최신으로 (기능이 없는 게 아니라 버전이 낡은 경우가 많습니다)
claude update

# 2. claude.ai 계정으로 로그인 — API 키로는 안 됩니다
claude auth login

# 3. 그 폴더에서 한 번 띄워 워크스페이스 신뢰 승인
cd 프로젝트폴더 && claude

# 4. 켜기
claude rc --permission-mode acceptEdits

rc는 remote-control의 별칭입니다. 참고로 claude --help 목록에는 안 나옵니다 — 숨어 있는 셈이라 문서를 안 보면 모릅니다.

띄워두면 터미널이 서버 모드로 대기하면서 세션 URL을 보여줍니다. 스페이스바를 누르면 QR 코드가 나와서 폰으로 바로 잡을 수 있습니다.

공식 문서의 모바일 푸시 알림 안내 — 긴 작업이 끝나면 폰으로 알림이 온다는 부분에 형광펜 — 공식 문서 · 긴 작업이 끝나면 폰으로 알려줍니다

폰으로 쓰는 실제 쓸모는 여기 있습니다. 긴 작업이 끝나거나 결정이 필요할 때 클로드가 알아서 푸시를 보냅니다. 프롬프트에 "테스트 끝나면 알려줘"라고 넣어둘 수도 있고요. /config에서 켜면 됩니다.

폰 앱은 필수가 아닙니다

claude doctor가 이렇게 말합니다 — "Control this session from claude.ai/code or the Claude mobile app". 폰 브라우저로 claude.ai/code에 들어가도 됩니다. 앱은 기기 카드와 푸시 알림 쪽이 편한 정도입니다.

공식 문서가 적어둔 조건 다섯 가지

여기서부터가 이 글을 쓴 이유입니다. 문서의 Requirements 절에 조건이 다섯 종류로 적혀 있습니다.

조건	내용
① 구독	Pro·Max·Team·Enterprise. API 키는 지원 안 함. Team·Enterprise는 Owner가 토글을 먼저 켜야 함
② 로그인	claude.ai 계정으로 `/login`. `user:profile` 스코프가 필요
③ API 엔드포인트	Bedrock·Google Cloud·Microsoft Foundry, 커스텀 `ANTHROPIC_BASE_URL`, 기업 게이트웨이면 불가
④ 환경변수	`DISABLE_TELEMETRY` 등 4종이 켜져 있으면 기능이 꺼짐
⑤ 워크스페이스 신뢰	그 폴더에서 `claude`를 한 번 띄워 승인

이 중 ④번이 제일 조용합니다.

공식 문서 요구사항 — DISABLE_TELEMETRY 등 환경변수가 기능을 끈다는 부분에 형광펜 — 공식 문서 · 이 변수들이 켜져 있으면 원격 제어가 꺼집니다

추적을 끄려고 넣어둔 변수가 이 기능까지 같이 끕니다. 넷 다 확인해보세요.

echo $DISABLE_TELEMETRY $DO_NOT_TRACK \
     $CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC $DISABLE_GROWTHBOOK

# 셸 환경변수만이 아닙니다 — settings.json 의 env 블록도 봅니다

에러가 "기능이 없다"고 나오지 않고 그냥 안 됩니다. 이유를 짐작하기 어려운 종류의 막힘입니다.

저희가 실제로 밟은 것들

① 버전이 한 달 넘게 낡아 있었습니다

claude doctor를 돌려보고 알았습니다.

Auto-updates: disabled (set by env: DISABLE_AUTOUPDATER)
Last update attempt: success → 2.1.220 (2026-07-26)

자동 업데이트가 꺼져 있어서 7월 말 버전에 머물러 있었습니다. 기능이 없는 게 아니라 내 버전이 낡은 것이었죠. 참고로 뉴스레터가 소개한 최신은 2.1.248인데 실제로는 2.1.251이 나와 있었습니다.

② 데스크톱 앱과 CLI는 로그인을 공유하지 않습니다

claude rc 실행 시 로그인 필요 에러와 claude doctor의 세 줄 진단 — 로그인 전 실행 결과. `doctor`가 이유를 세 줄로 쪼개줍니다

클로드 코드를 매일 쓰는 PC인데 CLI는 loggedIn: false였습니다. 세션이 데스크톱 앱에서 돌고 있었기 때문입니다. 데스크톱 앱을 쓰신다면 CLI는 따로 로그인해야 합니다.

doctor의 마지막 줄도 눈여겨볼 만합니다 — Sign-in is missing the user:profile scope. 이미 다른 방식으로 로그인해 둔 사람도 다시 로그인해야 할 수 있다는 뜻입니다.

③ 업데이트가 설치 위치를 바꿉니다

claude update가 네이티브 설치로 옮기면서 경고 세 개를 띄웠습니다.

Warning: Native installation exists but ~/.local/bin is not in your PATH
Warning: Running native installation but config install method is 'unknown'
Warning: claude command at ~/.local/bin/claude.exe missing or broken

사용자 PATH에 ~/.local/bin을 넣고 claude install로 설정을 정리하니 경고가 사라졌습니다(No installation issues found). 이걸 안 하면 터미널에서 claude가 아예 안 잡힙니다.

④ 슬래시 방향 때문에 신뢰를 두 번 물어봅니다

여기서 30분을 썼습니다. 이미 승인한 폴더인데 이렇게 나왔습니다.

같은 폴더가 역슬래시와 슬래시로 두 항목으로 갈라져 신뢰 값이 다른 상태 — 같은 폴더인데 두 항목으로 갈라져 있었습니다

~/.claude.json을 열어보니 경로가 문자열로 비교되고 있었습니다. 데스크톱 앱은 역슬래시로, 네이티브 CLI는 슬래시로 같은 폴더를 적어서 서로 다른 폴더로 세고 있었던 겁니다.

같은 증상이면 ~/.claude.json의 projects에서 그 폴더가 두 번 나오는지 보세요. 해결은 간단합니다 — 그 폴더에서 claude를 한 번 띄워 승인하면 됩니다.

문서에도 적혀 있지만 놓치기 쉬운 것

공식 문서 Limitations — 터미널을 닫으면 세션이 오프라인이 된다는 부분에 형광펜 — 공식 문서 · 터미널을 닫으면 세션이 꺼집니다

로컬 프로세스가 살아 있어야 합니다. 터미널을 닫거나 VS Code를 끄면 세션이 오프라인이 되고, 폰 목록에서도 몇 초 안에 사라집니다. 그래서 실무에서는 터미널 하나를 계속 열어두게 됩니다.

SSH로 원격 기계에 붙어 쓰는 경우라면 문서가 직접 권합니다 — tmux나 screen 안에서 띄우라고요. 접속을 끊어도 세션이 남습니다.

그 밖에 알아둘 것들입니다.

서버 모드는 네트워크가 끊기면 약 10분 뒤 종료됩니다. 대화형 세션은 끊긴 동안 계속 재시도하고 복구되면 스스로 붙습니다.
일부 명령은 로컬 전용입니다. /plugin·/resume는 폰에서 안 됩니다. /model·/effort는 인자로 넘겨야 하고요(/model sonnet).
Trusted Devices(베타)를 Team·Enterprise에서 켜두면 기기 등록까지 요구합니다.

폰에서 쓸 권한 모드

실제로 정해야 하는 값은 --permission-mode 하나입니다. 폰에서는 승인 팝업을 계속 누를 수 없으니까요.

모드	동작	폰에서
`plan`	계획만 세우고 실행 안 함	가장 안전 — 이동 중 생각만 시킬 때
`acceptEdits`	파일 편집 자동 승인, 명령 실행은 확인	실무 기본값
`auto`	분류기가 판단	`/permissions`의 규칙을 먼저 손봐야
`default`	매번 확인	계속 막힘
`dontAsk` · `bypassPermissions`	안 물어봄	화면을 못 볼 때 임의 실행 — 권하지 않음

--spawn worktree는 조심하세요. 격리라서 안전해 보이지만, git에 안 올라간 파일이 많은 저장소에서는 거의 빈 폴더에서 작업하게 됩니다. 기본값 same-dir이 대부분 맞습니다.

이 글을 다른 PC의 클로드에게 그대로 붙여봤습니다

여기까지 쓰고 나서 실험을 하나 했습니다. 이 글의 본문을 통째로 복사해서 다른 PC의 클로드 코드에 붙여넣었습니다. 사람이 명령을 하나씩 옮겨 치지 않고, 글 자체를 시켜본 겁니다.

결과는 이랬습니다.

1. claude 명령이 PATH에 없습니다  →  설치 위치를 찾아봅니다
2. CLI가 아예 설치돼 있지 않습니다 →  이 세션은 데스크톱 앱으로 돌고 있습니다
3. node·npm 확인 후 CLI 설치       →  2.1.251 (글에서 말한 최신)
4. 차단 환경변수 4종 확인          →  전부 미설정
5. claude doctor                   →  남은 건 로그인 하나

   여기서부터는 직접 하셔야 합니다
   claude auth login  — 브라우저 인증이라 제가 손대지 않는 영역입니다

글에서 짚은 함정을 순서대로 밟으면서 스스로 해결했습니다. PATH에 없는 것도, 데스크톱 앱과 CLI가 별개인 것도요. 그리고 로그인과 신뢰 승인에서는 정확히 멈춰서 사람에게 넘겼습니다.

재미있는 건 글에 없던 상황도 처리했다는 점입니다. 그 PC에는 CLI가 아예 안 깔려 있었는데(저희 글은 "업데이트하라"고만 적었죠), 알아서 npm으로 설치했습니다.

그리고 로그인·신뢰 승인을 마치니 이렇게 됐습니다.

폰의 클로드 앱에서 원격 세션이 잡힌 화면 — RC 세션이 떴습니다, 모델과 권한 모드를 폰에서 바꿀 수 있다 — 폰에서 그 PC의 세션을 그대로 잇고 있습니다. 모델(Opus 5)과 권한 모드도 폰에서 바뀝니다

됩니다. 폰에서 세션이 잡히고, 그 PC에서 명령이 실제로 돕니다. 터미널 창을 닫으면 연결이 끊긴다는 것도 그대로였고요.

이 글을 쓰면서 하나 배웠습니다. 설치 안내문은 사람이 읽는 글이면서 동시에 AI에게 주는 명령문이기도 합니다. 명령이 순서대로 다 있고, 안 될 때의 분기가 글 안에 있고, 사람만 할 수 있는 곳이 표시돼 있으면 — 복사해서 붙이는 것만으로 끝납니다.

한 가지는 저희 글이 빠뜨렸습니다

CLI가 아예 없는 경우를 안 적었습니다. 데스크톱 앱만 쓰던 사람은 claude update가 아니라 설치부터 해야 합니다.

npm i -g @anthropic-ai/claude-code

그리고 그 PC에도 DISABLE_AUTOUPDATER=1이 걸려 있었습니다. 저희 PC와 같았어요. 이 값이 있으면 앞으로도 자동 갱신이 안 되니 가끔 위 명령으로 직접 올려야 합니다.

가져가실 것

── 켜는 순서 ────────────────────────────
claude update                    # 버전이 낡아 기능이 없어 보이는 경우가 많다
claude auth login                # claude.ai 계정 · API 키 불가
cd 프로젝트폴더 && claude          # 워크스페이스 신뢰 승인
claude rc --permission-mode acceptEdits

── 안 되면 여기부터 ─────────────────────
claude doctor                    # Remote Control 절이 이유를 줄별로 알려준다
echo $DISABLE_TELEMETRY $DO_NOT_TRACK \
     $CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC $DISABLE_GROWTHBOOK
echo $ANTHROPIC_BASE_URL         # api.anthropic.com 이 아니면 불가
~/.claude.json 의 projects       # 같은 폴더가 두 번 있는지 (슬래시 방향)

── 알아둘 것 ────────────────────────────
· 세션은 내 PC에서 돈다 — 파일·MCP·스킬 그대로
· 터미널을 닫으면 꺼진다. 원격이면 tmux/screen 안에서
· 폰 앱은 필수 아님 — claude.ai/code 도 된다
· 긴 작업 알림은 /config 에서 켠다

클로드 코드를 어떻게 쓰고 있는지는 자주 쓰는 명령 5개에, 저희가 만들어 쓰던 폰 원격 우회로는 폰 원격 스킬 제작기에 적어뒀습니다.