한눈에 보기
- 이 글에서 내 PC 에서 도는 클로드 코드 대화를 휴대폰 Claude 앱이나 다른 컴퓨터 브라우저에서 이어 보고 시키는 Remote Control 을 켜는 명령 셋, 요금제, 휴대폰에서 되는 것과 안 되는 것, 누가 볼 수 있는지와 끄는 법을 공식 문서대로 옮겼어요.
- 결론 이미 켜 둔 대화라면 /remote-control 한 줄이면 돼요. 그다음 휴대폰 Claude 앱의 Code 탭에서 그 대화를 고르면 이어져요.
- 주의 일은 계속 내 PC 가 해요. PC 를 끄거나 터미널을 닫으면 휴대폰 쪽도 멈춰요. Pro·Max·Team·Enterprise 요금제 로그인만 되고 API 키로는 안 돼요.
- 읽는 법 “처음이라면” 세 절이면 휴대폰에서 붙을 수 있어요. “익숙해졌다면”은 늘 켜기와 알림, “더 깊이”는 서버 모드와 신뢰 기기예요.
이 글 순서
퇴근 전에 클로드 코드에게 폴더 속 엑셀 파일 수십 개를 정리하라고 시켰다고 해 볼게요. 한참 돌다가 “이 파일을 지워도 될까요?” 하고 권한 확인 창이 뜨면, 누가 답할 때까지 일이 멈춰요. 지하철에서 휴대폰으로 그 창에 “예”를 누를 수 있다면 집에 도착했을 때 일이 끝나 있겠죠. Remote Control 이 바로 그 기능이에요. 텔레비전 리모컨과 비슷해요. 방송은 텔레비전(내 PC)에서 나오고, 리모컨(휴대폰)은 버튼만 눌러요.
이 글은 클로드 코드 공식 문서 “모든 기기에서 로컬 세션 계속하기(Remote Control)”, “모바일에서 Claude Code”, “클라우드에서 Claude Code 사용하기”, “모든 설정”, “CLI 참조”, “Desktop 애플리케이션”과 변경 기록을 2026년 10월 10일에 한국어 문서와 영어 문서로 같이 읽고 옮긴 거예요. 캡처는 한국어 문서로 했어요. 비교하려고 OpenAI 코덱스 문서 “Codex on mobile”·”Remote connections”와 안티그래비티 문서 “Remote Control”도 같은 날 읽었어요. 터미널 그림은 이 PC 에 따로 만든 테스트 폴더에서 로그인 없이 돌려 본 것만 옮겼어요.

원격 제어가 뭔가요
단어 몇 개만 먼저 풀게요. 터미널은 글자로 컴퓨터에 명령을 내리는 검은 창이에요. 클로드 코드는 이 터미널에서 클로드와 대화하며 내 PC 의 파일을 읽고 고치게 하는 프로그램이고요. 세션은 클로드 코드를 한 번 켜서 주고받는 대화 한 묶음이에요. 문서에서 “로컬”은 내 컴퓨터를 뜻해요.
Remote Control 은 내 PC 에서 이미 돌고 있는 세션에 휴대폰의 Claude 앱이나 다른 컴퓨터 브라우저(claude.ai/code)로 창을 하나 더 내는 기능이에요. 문서 말로는 웹과 모바일 화면이 “로컬 세션으로 들어가는 창”이에요. 그래서 이런 게 돼요.
- 내 PC 의 파일, 클로드 코드에 붙여 둔 MCP 서버(클로드가 바깥 도구를 쓰게 이어 주는 연결), 프로젝트 설정을 휴대폰에서도 그대로 써요. @ 를 치면 내 PC 프로젝트의 파일 이름이 자동으로 나와요.
- 터미널, 브라우저, 휴대폰 어디서 보내든 같은 대화로 들어가요. 서브에이전트(클로드가 일을 나눠 맡기는 작은 작업자)가 하는 일도 모든 기기에 같이 보여요.
- 휴대폰에서 사진이나 파일을 붙여 보낼 수 있어요. 사진은 클로드가 바로 보고, 다른 파일은 내 PC 로 다운로드해 @ 파일로 넘겨요.
- 노트북이 잠들거나 인터넷이 끊겨도 PC 가 다시 깨어나면 자동으로 다시 붙어요.
헷갈리기 쉬운 이웃 기능이 클라우드 세션이에요. 클라우드 세션은 Anthropic 이 관리하는 컴퓨터에서 클로드 코드가 도는 거라 내 PC 를 꺼도 계속 돌아요. Remote Control 은 일하는 곳이 내 PC 라서, PC 가 켜져 있고 claude 프로그램이 계속 돌고 있어야 해요. 둘의 차이는 아래 “클라우드 세션과 비교하기” 절에 표로 있어요.
한국에서, 무슨 요금제
| 질문 | 답 |
|---|---|
| 한국에서 되나 | 됨(Anthropic 지원 국가에 South Korea) |
| 요금제 | Pro·Max·Team·Enterprise |
| Team·Enterprise | Owner 가 관리자 설정에서 먼저 켜야 함 |
| 안 되는 로그인 | API 키, Bedrock 같은 다른 회사 클라우드 |
| 휴대폰 앱 | Claude 앱(iOS·Android), 따로 앱 없음 |
출처: anthropic.com 지원 국가 목록, 클로드 코드 문서 “Remote Control”의 요구 사항, “모바일에서 Claude Code”. 10월 10일 확인. 무료(Free) 요금제는 목록에 없어요. Team·Enterprise 는 처음엔 꺼져 있어서 조직의 Owner(관리자)가 claude.ai 관리자 설정의 Remote Control 토글을 켜야 해요. 휴대폰 쪽은 클로드 코드 전용 앱이 따로 있는 게 아니라 늘 쓰는 Claude 앱의 Code 탭이에요.

그림 아래쪽 줄들은 회사에서 쓰는 분이 자주 걸리는 곳이에요. 환경 변수(프로그램이 켜질 때 읽는 이름 붙은 값) 가운데 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 이나 DISABLE_GROWTHBOOK 을 켜 두면 Remote Control 을 못 써요. DISABLE_TELEMETRY 나 DO_NOT_TRACK 만 켠 경우는 2.1.283 부터 쓸 수 있게 됐어요. 회사 프록시나 LLM 게이트웨이(회사가 AI 요청을 한곳에 모아 내보내는 중간 서버)로 ANTHROPIC_BASE_URL 을 바꿔 둔 경우도 안 돼요. 아직 클로드 코드를 깔지 않았다면 클로드 코드 설치 윈도우 초보용부터 보고 오세요.
처음이라면: 준비물
- 클로드 코드와 로그인: 클로드 코드를 켜고 /login 으로 claude.ai 계정에 로그인해 둬요. 로그인은 한 번만 하면 남아요.
- 휴대폰의 Claude 앱: 앱이 없으면 클로드 코드 안에서 /mobile 을 쳐요. claude.ai/mobile 로 가는 QR 코드가 떠서, 휴대폰으로 찍으면 내 휴대폰에 맞는 앱 스토어가 열려요. 앱에는 클로드 코드에 쓰는 것과 같은 계정, 같은 조직으로 로그인해요.
- 일할 폴더: 사용자 폴더(C:\Users\내이름) 바로 말고 일할 폴더를 하나 만들어 그 안에서 켜요. 처음 여는 폴더면 “이 폴더를 믿을까요(Trust)”를 묻는데, 문서에 따르면 사용자 폴더에서는 이 답이 저장되지 않아 켤 때마다 다시 물어요.
폴더를 만들고 그 안에서 클로드 코드를 켜는 순서는 클로드 코드 사용법 처음부터에 화면과 같이 있어요.
처음이라면: 켜기
켜는 방법이 셋 있어요. 처음이라면 첫째 줄, 이미 하던 대화에서 켜는 쪽이 가장 쉬워요.
| 언제 | 치는 것 | 특징 |
|---|---|---|
| 대화 중에 | /remote-control | 지금까지 대화가 그대로 넘어감 |
| 새로 켜면서 | claude --remote-control | 터미널에서도 그대로 칠 수 있음 |
| PC 를 맡겨 둘 때 | claude remote-control | 서버 모드, 터미널에선 못 침 |
출처: 클로드 코드 문서 “Remote Control”의 Remote Control 세션 시작, “CLI 참조”. 10월 10일 확인. /remote-control 은 줄여서 /rc, --remote-control 은 --rc 로 쳐도 돼요. 데스크톱 앱 코드 탭과 VS Code 확장에서도 입력 칸에 /remote-control 을 치면 돼요. 이 글에서는 첫째 방법으로 따라 해 볼게요.
- 일할 폴더에서 클로드 코드를 켜고 평소처럼 대화를 시작해요.
- 입력 칸에 /remote-control 을 치고 Enter 를 눌러요. 이름을 붙이고 싶으면 /remote-control 엑셀정리 처럼 뒤에 적어요. 이 이름이 휴대폰 목록에 나와요.
- 처음 한 번은 무엇을 하는 기능인지 알려 주는 확인 창이 떠요. Enable Remote Control 을 고르면 연결돼요. Never mind 나 Esc 를 누르면 켜지지 않고, 다음에 다시 물어요.
- 연결되면 터미널에 /rc active 표시가 생겨요. 터미널 창이 좁으면 이 표시가 숨기도 해요.
- /remote-control 을 한 번 더 치면 상태 창이 열려요. 여기서 세션 주소와 QR 코드를 보고, 연결만 끊을 수도 있어요. 연결을 끊어도 내 PC 쪽 대화는 계속돼요.
claude --remote-control "엑셀 정리"
둘째 방법은 클로드 코드를 켤 때부터 연결해 두는 줄이에요. 따옴표 안은 세션 이름이고, 빼도 돼요. 이렇게 켜도 터미널에서 평소처럼 대화할 수 있어요.

그림은 이 PC 에 따로 만든 테스트 폴더에서 로그인 없이 claude --version, claude --help, claude remote-control --help 를 돌려 이 글에 쓰는 줄만 남긴 거예요. 버전은 2.1.292 였어요. 도움말에 --remote-control [name] 줄이 보여요. 로그인하지 않은 이 테스트 폴더에서는 아래 Commands 목록에 remote-control 이 없었고, claude remote-control --help 는 도움말 대신 “로그인해야 쓸 수 있다”는 오류를 냈어요. 문서도 이 명령은 도움말을 보여 주기 전에 쓸 수 있는 계정인지부터 확인한다고 적었어요. 그러니 이 줄이 나오면 아래 “막힐 때”의 첫 줄대로 로그인부터 해요.
처음이라면: 휴대폰에서 붙기
내 PC 에서 연결이 켜졌으면 휴대폰이나 다른 컴퓨터에서 들어가는 방법은 셋이에요.
- QR 코드 찍기: 상태 창의 QR 코드를 휴대폰 카메라로 찍으면 Claude 앱에서 그 세션이 바로 열려요.
- 앱에서 고르기: Claude 앱 아래쪽 메뉴에서 Code 를 누르면 세션 목록이 나와요. 내 PC 세션은 컴퓨터 그림에 초록 점이 붙어 있으면 연결된 거예요.
- 주소 열기: 세션 주소를 다른 컴퓨터 브라우저에 붙여 넣으면 claude.ai/code 의 그 세션으로 가요. 같은 claude.ai 계정으로 로그인돼 있어야 해요.
목록에 나오는 이름은 이 순서로 정해져요. 켤 때 준 이름, /rename 으로 바꾼 이름, 지난 대화의 마지막 말, 그것도 없으면 “PC이름-graceful-unicorn” 같은 자동 이름이에요. 자동 이름 앞에는 내 PC 이름이 붙으니, 화면을 남에게 보일 일이 있으면 이름을 직접 주는 게 깔끔해요. 휴대폰에서 이름을 바꾸면 내 PC 의 claude --resume 목록 이름도 같이 바뀌어요. 이름 붙이기는 클로드 코드 이전 대화 이어 하기에 자세히 있어요.
휴대폰에서 되는 것
휴대폰 화면은 터미널 대화를 그대로 따라 보여 줘요. 문서에 적힌 되는 것부터 볼게요.
- 메시지 보내기, 클로드가 띄우는 권한 확인 창과 질문에 답하기. 권한 확인 창과 질문은 답할 때까지 열려 있어요.
- 사진과 파일 붙여 보내기. 파일 하나가 다운로드되지 않으면 “[1 of 3 attachments did not arrive]” 같은 메모가 붙고 나머지는 그대로 가요.
- 바뀐 내용 보기. 폴더가 깃 저장소(파일이 바뀐 기록을 남기는 폴더)면 휴대폰의 바뀐 내용 칸에 고친 줄이 나와요.
- 모델과 effort(생각을 얼마나 깊게 할지) 바꾸기. 휴대폰에서 고른 모델은 그 세션에만 적용돼요. 내 PC 클로드 코드가 2.1.238 이상이어야 해요.
- 백그라운드로 도는 서브에이전트와 작업 보기, 멈추기. 휴대폰에서 멈추면 내 PC 에서도 멈춰요.
- 권한 모드 고르기. 문서 “모바일에서 Claude Code”는 Manual, Accept edits, Plan, Auto 를 고를 수 있고 Bypass permissions 는 앱에서 못 고른다고 적었어요.

| 휴대폰에서 | 명령 |
|---|---|
| 그대로 됨 | /compact /clear /context /usage /exit /recap |
| 값을 붙이면 됨 | /model sonnet, /effort high, /rename 이름 |
| 다르게 동작 | /mcp 는 글 요약, /config 는 키=값 |
| 안 됨 | /plugin, /resume, /claude-api |
출처: 클로드 코드 문서 “Remote Control”의 제한 사항. 10월 10일 확인. 터미널에선 /model 을 치면 고르는 목록이 뜨지만 휴대폰에선 목록 대신 /model sonnet 처럼 값을 붙여 쳐야 해요. /resume 으로 다른 대화로 바꾸는 일은 내 PC 터미널에서만 돼요. 터미널에서 /resume 으로 다른 대화로 옮기면 휴대폰에는 그 대화의 지난 내용과 제목이 넘어오지 않고, 새로 오가는 말만 따라가요. /clear 를 치면 휴대폰 화면도 같이 비워져요. 사용량 보는 법은 클로드 코드 사용량 확인하는 법, 모델 바꾸기는 클로드 코드 모델 바꾸는 법에 있어요.
누가 볼 수 있나
내 claude.ai 계정으로 로그인한 내 기기에서만 보여요. 문서는 자동 연결 설명에서 “내 계정의 Claude 앱에만 나타나고 다른 누구에게도 접근 권한을 주지 않는다”고 적었어요. 남에게 대화를 보여 주는 공유 기능과는 다른 거예요. 공유는 클로드 코드 대화 내보내기에 따로 적었어요.

- 문을 열지 않아요: 내 PC 는 밖으로 나가는 HTTPS 요청(인터넷 주소가 https 로 시작하는 암호화된 연결)만 하고, 바깥에서 들어오는 문(포트)은 열지 않아요. Anthropic 서버가 휴대폰과 내 PC 사이에서 말을 옮겨 줘요.
- 키가 짧게 살아요: 연결에는 한 가지 일에만 쓰고 따로따로 끝나는 짧은 자격 증명 여러 개를 써요.
- 기록은 서버에도 남아요: 연결된 동안 내 메시지, 클로드의 답, 도구 사용 기록이 Anthropic 서버에 저장되고 데이터 사용 정책에 따라 보관돼요. 기기끼리 대화를 맞추고 끊겼다 다시 붙기 위해서래요. 파일을 고치고 명령을 돌리는 일은 내 PC 에서만 일어나요.
그러니 회사 규칙으로 대화 기록을 밖에 남기면 안 되는 일이라면 켜지 않는 게 맞아요. 문서에 따르면 Zero Data Retention(기록을 남기지 않는 계약)이나 HIPAA 설정이 걸린 조직은 아예 켤 수 없어요.
끄는 법
| 끄는 범위 | 방법 |
|---|---|
| 이 대화만 | /remote-control 다시 → 상태 창에서 끊기 |
| 서버 모드 | 그 터미널에서 Ctrl+C |
| 늘 켜기만 | /config 에서 자동 연결을 false |
| 데스크톱 앱 | 세션의 Remote Control 스위치 |
| 이 PC 전부 | settings.json 에 disableRemoteControl |
출처: 클로드 코드 문서 “Remote Control”, “Desktop 애플리케이션”의 다른 기기에 표시되는 세션 제어, “모든 설정”. 10월 10일 확인. 이 PC 에서 아예 못 쓰게 하려면 사용자 폴더의 .claude\settings.json(클로드 코드 설정 파일)에 이 줄을 넣어요.
{
"disableRemoteControl": true
}
이걸 넣으면 claude remote-control, --remote-control, 자동 연결, 대화 안의 켜기가 모두 거절되고 “조직 정책으로 꺼졌다”는 말이 나와요. 다만 데스크톱 문서는 파일을 저장할 때 이미 연결돼 있던 세션은 그 세션에서 끌 때까지 연결된 채로 남는다고 적었어요. 저장한 뒤 열려 있는 세션도 하나씩 꺼 주세요. 설정 파일 다루는 법은 클로드 코드 settings.json 설정하는 법에 있어요.
PC 가 꺼지면
| 이럴 때 | 어떻게 되나 |
|---|---|
| 노트북이 잠듦 | 깨어나면 자동으로 다시 붙음 |
| 터미널·앱을 닫음 | 다시 살릴 때까지 오프라인 |
| 인터넷 끊김(대화형) | 계속 다시 시도, 돌아오면 붙음 |
| 인터넷 끊김(서버 모드) | 약 10분 뒤 포기하고 꺼짐 |
출처: 클로드 코드 문서 “Remote Control”의 제한 사항, “모바일에서 Claude Code”. 10월 10일 확인. 휴대폰으로 붙어 있는 동안 PC 를 꺼 버리면 그 대화는 휴대폰에서 더 진행되지 않아요. 노트북을 덮어 가방에 넣을 일이라면 Remote Control 이 아니라 클라우드 세션이 맞아요.
다시 살리는 법은 켠 방법에 따라 달라요. /remote-control 이나 --remote-control 로 켠 대화는 claude --continue 나 claude --resume 으로 그 대화를 다시 열면 기록된 원격 세션에 다시 붙어요. 서버 모드(claude remote-control)는 Ctrl+C 로 멈춘 뒤 약 4시간 안에 같은 폴더에서 claude remote-control 을 다시 치면 그동안 맡던 세션이 모두 돌아와요. 하나만 살리려면 --continue 나 --session-id 를 붙이고, 이 둘은 2.1.200 이상이 필요해요.
그 밖에 문서에 적힌 끊김이 둘 있어요. VPN 을 켜거나 끈 뒤처럼 중간에서 HTTP 403(거절) 답이 오면 3분까지 다시 시도하다가 끊고 무엇이 거절했는지 알려 줘요. 서버에 30분쯤 연결되지 못해 끊겼다는 말이 나오면 /remote-control 로 다시 붙어요.
익숙해졌다면: 늘 켜기
대화를 켤 때마다 /remote-control 을 치기 번거로우면 자동 연결을 켜요. 클로드 코드 안에서 /config 를 치고 Enable Remote Control for all sessions 를 true 로 바꾸면, 대화형 세션을 켤 때마다 자동으로 연결돼요. 값은 셋이에요.
- true: 켤 때마다 자동 연결.
- false: 자동 연결 끔. 내 사용자 설정에 저장돼요.
- default: 내 선택을 지우고 조직 관리자 기본값이나 클로드 코드 기본값을 따름.
설정 파일로 하려면 사용자 설정에 “remoteControlAtStartup”: true 를 넣어요. 재미있는 점은 프로젝트 폴더의 .claude\settings.json 에서는 false 만 듣고 true 는 무시한다는 거예요. 저장소에 올린 파일 하나로 그 저장소를 여는 모든 사람의 원격 제어를 켜 버리는 일을 막으려는 거예요. 자동 연결로 켠 클로드 코드는 창 하나마다 원격 세션을 하나씩 만들어요. 데스크톱 앱은 설정 > Claude Code > Connect new sessions to Remote Control, VS Code 확장은 명령 메뉴의 Settings 묶음에 같은 스위치가 있어요.
익숙해졌다면: 휴대폰 알림
Remote Control 이 켜져 있으면 클로드가 휴대폰으로 알림을 보낼 수 있어요. 보통 오래 걸린 일이 끝났을 때나 계속하려면 내 결정이 필요할 때 보내요. 요청에 “notify me when the tests finish”(시험이 끝나면 알려 줘)처럼 직접 적어도 돼요.
- 휴대폰에 Claude 앱을 깔고 클로드 코드와 같은 계정, 같은 조직으로 로그인해요.
- 휴대폰이 알림을 허락할지 물으면 허락해요.
- 터미널에서 /config 를 치고 Push when Claude decides(클로드가 정할 때), Push when actions required(허락·질문이 필요할 때) 가운데 원하는 것을 켜요. 둘 다 켜도 돼요.
알림이 안 오면 /config 에 No mobile registered 가 보이는지 봐요. 그렇다면 휴대폰에서 Claude 앱을 한 번 열면 다음 연결 때 풀려요. 아이폰은 집중 모드와 알림 요약이, 안드로이드는 배터리를 아끼는 설정이 알림을 늦출 수 있어서 그 설정에서 Claude 앱을 빼 두라고 문서에 적혀 있어요. 내가 터미널에 글을 치고 있을 때는 알림을 건너뛰어요.
더 깊이: 서버 모드
여기부터는 PC 를 켜 두고 밖에서 여러 일을 맡길 분을 위한 내용이에요. claude remote-control 은 터미널에서 대화하는 창이 아니라 바깥 연결을 기다리는 “서버”로 떠 있어요. 처음 켜면 Enable Remote Control? (y/n) 을 묻고, y 를 누르면 세션 주소가 나와요. 스페이스바를 누르면 QR 코드가 보였다 숨었다 해요. 휴대폰에서 새 세션을 여러 개 열 수도 있어요.
claude remote-control --name "집 PC" --spawn worktree
목록에 “집 PC”로 보이게 하고, 휴대폰에서 새로 여는 세션마다 따로 워크트리를 만들어 주는 줄이에요. 뒤에 붙이는 옵션은 이래요.
| 옵션 | 하는 일 |
|---|---|
| --name “이름” | 목록에 보이는 세션 이름 |
| --spawn same-dir | 모든 세션이 같은 폴더(기본) |
| --spawn worktree | 세션마다 따로 워크트리, 깃 필요 |
| --spawn session | 세션 하나만 받음 |
| --capacity N | 동시에 받는 세션 수(기본 32) |
| --permission-mode | 시작 권한 모드, 예 acceptEdits |
출처: 클로드 코드 문서 “Remote Control”의 서버 모드 옵션 표. 10월 10일 확인. same-dir 는 세션들이 같은 파일을 고치다 부딪힐 수 있어서 worktree 가 생긴 거예요. 서버가 떠 있는 동안 w 키로 둘 사이를 바꿀 수 있어요. worktree 는 클로드 코드 worktree 사용법, 권한 모드는 클로드 코드 권한 설정에 있어요.
알아 둘 것이 셋 더 있어요. claude 와 remote-control 사이에 --settings 같은 다른 옵션을 끼우면, 서버가 만드는 세션에 넘어가지 않는 옵션이라 시작을 거절하고 그 옵션 이름을 알려 줘요(--verbose·--model 처럼 빠져도 괜찮은 것만 통과). 서버가 띄운 세션을 샌드박스(정해진 곳 밖을 못 건드리게 가두는 장치)에 넣으려면 설정 파일에서 샌드박스를 켜요. 서버 모드에서 세션 하나가 충돌해 꺼지면 휴대폰에서 메시지를 하나 보내면 다시 살아나요(2.1.238 이상).
더 깊이: 신뢰 기기
휴대폰을 잃어버렸을 때가 걱정이라면 Trusted Devices(신뢰 기기)가 있어요. 아직 베타이고 기본으로 꺼져 있어요. 켜면 등록한 기기에서만, 그리고 로그인한 지 18시간이 안 된 때만 Remote Control 세션을 보고 조종할 수 있어요.
- 켜는 곳: Pro·Max 는 내 설정의 Cowork 나 Account 쪽에서 Require trusted devices 를 직접 켜요. Team·Enterprise 는 Owner 가 조직 설정 > Capabilities > Remote sessions 에서 켜요.
- 매일 쓸 때: 18시간이 지나면 다시 로그인하는 대신 Face ID, Touch ID, Windows Hello, 패스키로 한 번 확인해요. 문서는 Anthropic 이 지문이나 얼굴 정보를 받거나 저장하지 않는다고 적었어요.
- 기기 빼기: claude.ai/settings/account 의 Trusted devices 칸에서 등록된 기기를 지우면 바로 막혀요. 잃어버린 휴대폰은 여기서 빼요.
클로드 코드를 돌리는 내 PC 는 CLI 에 로그인할 때 자동으로 자기 증명을 받아서 터미널에서 따로 등록할 일은 없어요. 이 설정은 터미널에서 쓰는 클로드 코드나 일반 Claude 대화에는 영향이 없고 Remote Control 에만 걸려요.
막힐 때
- You must be logged in to use Remote Control / requires a claude.ai subscription: claude.ai 로그인이 없거나 다른 키가 앞서고 있어요. claude auth login 으로 claude.ai 쪽을 골라 로그인해요. 메시지에 ANTHROPIC_API_KEY 나 ANTHROPIC_AUTH_TOKEN 이 나오면 그 환경 변수를 지워요.
- requires a full-scope login token: claude setup-token 으로 만든 오래 쓰는 토큰은 모델 요청만 할 수 있어요. claude auth login 으로 다시 로그인해요.
- requires feature-flag evaluation: 위 요금제 절의 환경 변수(CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 등)를 지워요.
- only available when using Claude via api.anthropic.com: Bedrock 같은 다른 회사 클라우드나 바꾼 ANTHROPIC_BASE_URL 을 쓰는 중이에요. 그 변수를 지우고 다시 켜요.
- disabled by your organization’s policy: Team·Enterprise 면 Owner 가 아직 안 켠 거예요. Pro·Max 인데 이 말이 나오면 예전 회사 계정 로그인이 남은 거라, /status 로 확인하고 로그아웃 뒤 다시 로그인해요.
- Remote Control isn’t enabled for this account: 요금제를 바꾼 뒤 옛 정보가 남은 경우가 많아요. claude auth logout 뒤 claude auth login, 그리고 클로드 코드를 최신으로 올려요. claude doctor 를 돌리면 어느 확인에서 걸렸는지 나와요.
- Workspace not trusted: 처음 여는 폴더인데 신뢰 확인 창을 띄울 수 없었던 거예요. 보통 터미널 창에서 직접 claude remote-control 을 치고 y 로 답해요.
- 휴대폰에 Code 탭이 안 보여요: 요금제나 조직 설정에 이 기능이 없을 수 있어요. 같은 계정, 같은 조직으로 로그인했는지도 봐요.
메시지 원문과 고치는 법은 문서 “Remote Control”의 문제 해결에 더 있어요. 그 밖의 오류는 클로드 코드 오류 해결에 모아 두었어요.
클라우드 세션과 비교하기
둘 다 claude.ai/code 화면을 쓰지만 일하는 곳이 달라요.
| 항목 | Remote Control | 클라우드 세션 |
|---|---|---|
| 일하는 곳 | 내 PC | Anthropic 서버 |
| PC 를 끄면 | 멈춤 | 계속 실행됨 |
| 내 파일 | 그대로 씀 | 깃허브에서 받음 |
| 시작 | /rc | claude --cloud |
출처: 클로드 코드 문서 “Remote Control”의 Remote Control 대 클라우드 세션, “클라우드에서 Claude Code 사용하기”. 10월 10일 확인. 클라우드 세션은 기본으로 Anthropic 이 관리하는 컴퓨터에서 돌고, 요금제는 Pro·Max·Team 과 Enterprise 일부 좌석이에요. 시작은 claude --cloud “할 일” 이나 claude.ai/code 에서 해요. 문서는 하던 로컬 작업을 다른 기기에서 이어 가고 싶으면 Remote Control, 내 PC 준비 없이 일을 시작하거나 받아 두지 않은 저장소를 다루거나 여러 일을 동시에 돌리려면 클라우드 세션을 쓰라고 해요. 클라우드 세션은 요금제 사용량에서 같이 빠지고 클라우드 컴퓨터 값을 따로 받지 않는다고 적혀 있어요.

이름이 비슷해서 헷갈리는 옵션이 있어요. claude --cloud 의 옛 이름이 --remote 라서, 문서는 --remote-control 은 이것과 상관없다고 따로 적어 두었어요. 그리고 터미널(CLI)에서 하던 대화를 클라우드로 밀어 보내는 명령은 없고, 반대로 클라우드 세션을 터미널로 끌어오는 --teleport 가 있어요. 데스크톱 앱에서는 Open in 메뉴로 클라우드에 보낼 수 있다고 문서에 적혀 있어요(클로드 코드 클라우드 세션 사용법). 표의 Dispatch 는 휴대폰 Claude 앱에서 일을 메시지로 보내면 데스크톱 앱이 받아 처리하는 기능인데 Pro·Max 에서만 되고, 9월 16일에 고친 도움말에는 새 사용자는 켤 수 없다고 적혀 있어요(클로드 Dispatch 사용법). 데스크톱 앱 쓰는 법은 클로드 코드 데스크톱 앱 코드 탭 쓰는 법, 정해진 때에 자동으로 돌리는 일은 클로드 코드 예약 작업 하는 법에 있어요.
코덱스·안티그래비티는
OpenAI 코덱스와 구글 안티그래비티에도 휴대폰이나 브라우저에서 내 PC 작업을 이어 보는 기능이 있어요. 2026년 6월 18일부터 개인 구글 계정은 제미나이 CLI 대신 안티그래비티 CLI 를 쓰게 돼서 안티그래비티로 비교했어요. 이 사정은 안티그래비티 CLI 설치에 있어요.
| 항목 | 클로드 코드 | 코덱스 | 안티그래비티 |
|---|---|---|---|
| 내 PC 쪽 | CLI·앱·VS Code | 챗GPT 앱(PC) | CLI·2.0 앱 |
| CLI 에서 | /rc | 안 됨 | /remote-control |
| 보는 곳 | Claude 앱·웹 | 챗GPT 앱 | 브라우저 |
| 늘 켜기 | 터미널 창 유지 | 늘 켜 둔 PC | 상주 서비스 |
출처: 클로드 코드 문서 “Remote Control”, OpenAI 코덱스 문서 “Codex on mobile”·”Remote connections”, 안티그래비티 문서 “Remote Control”. 10월 10일 확인. 기능 이름은 클로드 코드와 안티그래비티가 Remote Control, 코덱스가 Codex on mobile(원격 연결)이에요. 표의 안티그래비티는 안티그래비티 CLI 기준이고, 상주 서비스는 PC 가 켜져 있는 동안 늘 돌며 연결을 기다리는 프로그램이에요. 요금제는 코덱스·안티그래비티 둘 다 공식 안내가 없어요. 코덱스 문서는 “차례로 여는 중이고 워크스페이스 설정에 따른다”고만, 안티그래비티 문서는 오류 설명에 “계정 요금제가 Remote Control 을 지원하는지 확인하라”고만 적었어요. 클로드 코드의 서버 모드는 터미널 창을 켜 둔 동안만 돌고, 안티그래비티의 백그라운드 서비스는 운영체제에 등록돼 터미널 없이 돌고 PC 를 다시 켜도 다시 떠요(윈도우는 관리자 창에서 등록하면 부팅 때부터, 아니면 로그인할 때). 둘은 같은 것이 아니에요.

코덱스는 내 PC 쪽에서 챗GPT 데스크톱 앱(맥·윈도우)을 켜 두는 방식이에요. 데스크톱 앱의 Settings > Connections > Control this Mac or PC 에서 Set up 을 누르고 휴대폰으로 QR 코드를 찍어 짝을 지어요. “Remote connections” 문서는 이 설정을 코덱스 CLI 나 IDE 확장에서는 할 수 없다고 적었어요. 그러니 터미널에서 돌리는 코덱스 CLI 대화를 휴대폰으로 이어 보는 방법은 문서에 없어요. 휴대폰 쪽은 “Codex on mobile” 문서가 아이폰 챗GPT 앱의 Codex 를 열라고 적었고, “Remote connections” 문서는 iOS 와 안드로이드 챗GPT 앱 모두에서 조종할 수 있다고 적었어요. 내 PC 대신 SSH(다른 컴퓨터에 터미널로 접속하는 방법)로 붙인 원격 컴퓨터의 프로젝트를 쓰게 할 수도 있어요. 코덱스 CLI 쓰는 법은 코덱스 CLI 사용법 처음부터에 있어요.

안티그래비티 CLI 는 클로드 코드와 방식이 가장 닮았어요. 대화 중에 /remote-control 을 치면 다른 기기에서 열 주소가 나오고, /remote-control off 로 끊어요. agy --remote-control 로 켤 때부터 연결할 수도 있어요. 다른 점은 휴대폰 앱이 아니라 브라우저에서 antigravity.google.com 으로 들어간다는 거예요. 문서는 휴대폰에서 이 웹 앱을 홈 화면에 깔면 일이 끝났을 때 알림을 받을 수 있다고 적었어요. 브라우저 화면에서는 설정을 바꿀 수 없고 설정은 CLI 에서 바꿔야 해요. PC 를 늘 열어 두려면 agy remote-control start 로 윈도우 예약 작업에 등록하는 백그라운드 서비스를 띄우는데, 부팅할 때부터 돌게 하려면 관리자 권한 창에서 쳐야 해요. 이 글을 쓰면서 이 서비스 명령은 돌려 보지 않았어요. 안티그래비티 CLI 쓰는 법은 안티그래비티 CLI 사용법 처음부터에 있어요.
제미나이 CLI 는 명령 목록과 문서 목록에서 이런 기능을 찾지 못해 “공식 안내 없음”이에요. 세 도구를 다른 기능까지 비교한 글은 클로드 코드·코덱스·제미나이 CLI 비교예요.
누구에게 어느 방법
여기서부터는 제 생각이에요. 클로드 코드를 막 쓰기 시작한 분이라면 늘 켜기보다 필요한 대화에서만 /remote-control 을 치는 쪽을 권해요. 어떤 대화가 휴대폰에 열려 있는지 내가 알 수 있고, 끝나면 상태 창에서 바로 끊을 수 있어서요. 권한 확인 창 때문에 일이 멈추는 게 싫다면 휴대폰 알림의 Push when actions required 하나만 켜 두는 것도 좋아요.
PC 를 집이나 사무실에 켜 두고 밖에서 일을 여러 개 맡길 분은 서버 모드에 --spawn worktree 를 붙이는 쪽이 맞아요. 반대로 노트북 하나로 다니며 덮어 두는 일이 잦다면 처음부터 클라우드 세션이 편해요. 회사 코드라 대화 기록이 밖에 남으면 안 되는 일이면 켜지 말고, 꼭 써야 하면 신뢰 기기를 켜 두세요. 세 회사 요금제와 한도는 AI 비교 2026에 한 표로 모아 두었어요.
다시 확인할 날짜
- 10월 24일: 클로드 코드 Remote Control 문서의 휴대폰에서 되는 명령 목록과 권한 모드, 신뢰 기기가 베타를 벗어났는지.
- 11월 10일: 코덱스 휴대폰 연결의 요금제 안내와 안드로이드 쪽 메뉴 이름, 안티그래비티 Remote Control 요금제 조건.
이 글의 내용은 2026년 10월 10일 공식 문서 기준이에요. 클로드 코드는 버전이 자주 올라가서 명령과 메뉴 이름이 바뀔 수 있어요. 글과 다르게 보이면 공식 문서의 지금 내용을 먼저 보세요.
같이 보면 좋은 글: 클로드 코드 이전 대화 이어 하기: claude -c·-r·/resume 쓰는 법, 이름 붙이기와 30일 삭제
같이 보면 좋은 글: 클로드 코드 대화 내보내기: /export 로 파일·클립보드에, 남에게 보여 주기 전 지울 것
같이 보면 좋은 글: 클로드 코드 agent view 사용법: claude agents 로 백그라운드 세션 여러 개 맡기기
같이 보면 좋은 글: 클로드 코드 데스크톱 앱 코드 탭 쓰는 법: 터미널 없이 폴더 고르기부터 worktree 까지
같이 보면 좋은 글: AI 비교 2026: 클로드·챗GPT·제미나이 요금제·한도·기능 표
이 글이 들어간 총정리: 클로드 코드에 일 맡기는 법
참고한 자료
2026년 10월 10일에 확인했어요.
- 모든 기기에서 로컬 세션 계속하기 (Remote Control) (클로드 코드 공식 한국어 문서, 요구 사항·연결 및 보안·제한 사항)
- Continue local sessions from any device with Remote Control (클로드 코드 공식 영어 문서, 서버 모드 옵션·Trusted Devices·Troubleshooting)
- 모바일에서 Claude Code (클로드 코드 공식 한국어 문서, Code 탭·권한 모드)
- 클라우드에서 Claude Code 사용하기 (클로드 코드 공식 한국어 문서, 요금제·--cloud·--teleport)
- All settings (클로드 코드 공식 문서, disableRemoteControl·remoteControlAtStartup)
- CLI 참조 (클로드 코드 공식 한국어 문서, claude remote-control·--remote-control·--rc)
- Desktop (클로드 코드 공식 문서, Control which sessions appear on your other devices·Dispatch)
- Changelog (클로드 코드 변경 기록, Remote Control 항목들)
- Supported countries and regions (Anthropic, South Korea)
- Codex on mobile (OpenAI 코덱스 공식 문서)
- Remote connections (OpenAI 코덱스 공식 문서, 데스크톱 앱만·SSH)
- Remote Control (안티그래비티 공식 문서, /remote-control·agy remote-control start)
광고 · 쿠팡 추천 상품
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.


