Claude Code
휴대폰으로 Claude Code 원격 제어하는 법
휴대폰으로 Claude Code를 원격 제어하려면 Claude 앱을 씁니다. 별도의 모바일 앱은 없습니다. Remote Control에는 깨어 있는 맥이 필요하고, Keep Mac Awake는 덮개를 닫아도 맥을 깨어 있게 합니다.
요약: Claude Code(클로드 코드)에는 별도의 모바일 앱이 없습니다. iOS나 Android용 Claude 앱으로 원격 제어합니다. 앱의 Code 탭은 Remote Control로 맥의 세션을 조작하고, Dispatch는 Claude 데스크톱 앱에 작업을 보내며, 클라우드 세션은 Anthropic의 서버에서 실행됩니다. Remote Control과 Dispatch는 맥이 켜져 있고 깨어 있으며 Claude가 실행 중일 때만 작동하는데, 맥북은 덮개를 닫으면 잠자기 상태가 됩니다. 덮개를 닫은 채 휴대폰으로 Claude Code를 제어하려면 첫 번째 선택은 Keep Mac Awake 세션입니다. 다른 선택지로는 전원, 키보드, 마우스를 연결한 외장 모니터, 또는 맥의 로컬 파일과 도구 없이 실행되는 클라우드 세션이 있습니다.
맥용 다운로드3일간 무료, 카드 등록 없이. 이후 9 USD 한 번 결제.
Claude Code 모바일 앱이 있나요?
없습니다. 2026년 10월 기준, Anthropic 문서는 이렇게 설명합니다. “Claude Code에는 별도의 모바일 앱이 없습니다. 클라우드 세션과 Remote Control은 모두 Claude 앱의 Code 탭에 있고, Dispatch는 앱에서 메시지로 보내는 작업입니다”(Claude Code on mobile).
iPhone, iPad, Android용 Claude 앱은 “코드가 실행되는 곳이 아니라 Claude Code 세션의 클라이언트”입니다. Claude Code에서 쓰는 것과 같은 claude.ai 계정으로 로그인하세요. Anthropic Console의 API 키나 Amazon Bedrock 같은 제공업체로는 클라우드 세션과 Remote Control을 쓸 수 없습니다. Claude Code에서 /mobile 명령을 실행하면 알맞은 앱 스토어를 여는 QR 코드가 표시됩니다.
휴대폰으로 Claude Code를 원격 제어하는 방법에는 어떤 것이 있나요?
Anthropic은 휴대폰으로 작업하는 네 가지 방법을 안내하며, 방법마다 작업이 실행되는 곳이 다릅니다(Claude Code on mobile, 플랫폼, 2026년 10월 기준).
| 방법 | Claude가 실행되는 곳 | 깨어 있는 맥 필요 | 적합한 용도 |
|---|---|---|---|
| Remote Control | 맥(CLI, Desktop 또는 VS Code) | 예 | 파일, 도구, MCP 서버가 있는 로컬 세션 조작 |
| Dispatch | 맥(Claude 데스크톱 앱) | 예 | 작업을 메시지로 보내고 실행 방법은 Dispatch에 맡기기(Pro 또는 Max) |
| Channels | 맥(CLI) | 예 | Telegram, Discord, iMessage에서 실행 중인 세션과 대화 |
| 클라우드 세션과 프로젝트 | Anthropic 클라우드 | 아니요 | 노트북을 닫은 뒤에도 계속되어야 하는 GitHub 저장소 작업 |
Anthropic이 직접 제시하는 기준은 이렇습니다. “컴퓨터를 꺼 둘 거라면 클라우드 세션이나 프로젝트를 사용하세요. 클라우드에서 실행되므로 노트북을 닫아도 계속됩니다. Remote Control과 Dispatch는 직접 쓰는 컴퓨터를 조작하므로, 컴퓨터가 Claude Code나 Desktop 앱이 실행 중인 상태로 켜져 있어야 합니다.”
Claude의 기능이 전혀 필요 없는 다섯 번째 방법도 있습니다. 휴대폰의 SSH 앱, Tailscale, tmux를 쓰는 방법이며 덮개를 닫은 맥북에 SSH로 접속하기에서 다룹니다.
휴대폰으로 맥의 Claude Code 세션을 제어하려면 어떻게 하나요?
Remote Control을 쓰세요. Pro, Max, Team 또는 Enterprise 플랜과 claude.ai 로그인이 필요하고, API 키는 지원되지 않으며, Team과 Enterprise에서는 먼저 Owner가 기능을 켜야 합니다(Remote Control).
- 맥의 프로젝트에서
claude remote-control명령을 실행하거나, 이미 열려 있는 세션에서/remote-control(/rc) 명령을 실행하세요. Claude 데스크톱 앱과 VS Code 확장 프로그램의 세션도 포함됩니다. - 스페이스 바를 눌러 QR 코드를 표시하고 스캔하거나, 휴대폰에서 Claude 앱을 열고 “Code”를 탭한 뒤 세션을 고르세요.
- 맥에서든 휴대폰에서든 입력하세요. 대화는 터미널, 브라우저, 휴대폰 사이에서 동기화됩니다.
명령을 입력하지 않고 모든 대화형 세션을 연결하려면 /config 명령을 실행하고 “Enable Remote Control for all sessions”를 켜세요. 휴대폰에서 첨부한 사진과 파일도 맥에 전달됩니다. /plugin, /resume처럼 터미널에서만 쓰는 몇몇 명령은 앱에서 작동하지 않습니다.
휴대폰에서 Claude Code의 권한 프롬프트를 승인할 수 있나요?
예. /config에서 권한 프롬프트와 질문에는 “Push when actions required”를, 오래 걸리는 작업이 끝났을 때 같은 다른 알림에는 “Push when Claude decides”를 켜세요. 휴대폰에서 알림 허용 요청이 나오면 허용하세요. /config에 “No mobile registered”가 표시되면 Claude 앱을 한 번 열어 푸시 토큰을 새로 고치게 하세요(Remote Control).
Claude Code는 직접 답할 때까지 권한 프롬프트를 열어 두므로, 승인이 필요한 작업은 실패하지 않고 기다립니다. 앱에서는 Remote Control 세션에 Manual, Accept edits, Plan, Auto를 고를 수 있지만 Bypass permissions는 고를 수 없습니다(Claude Code on mobile).
덮개를 닫으면 Claude Code가 왜 휴대폰에 응답하지 않나요?
맥이 잠자기 상태이기 때문입니다. Apple은 맥을 잠자기 상태로 만드는 방법으로 “Mac 랩탑에서 디스플레이를 닫으십시오.”를 안내하며(Apple 지원), 잠자기 상태인 맥은 claude 프로세스를 실행하거나 앱에 응답할 수 없습니다.
Anthropic은 휴대폰을 로컬 세션을 들여다보는 창으로 설명하며, “따라서 컴퓨터가 켜져 있어야 하고 claude 프로세스가 계속 실행되어야 합니다”라고 말합니다. 노트북이 잠자기 상태가 되면 “컴퓨터가 다시 온라인 상태가 될 때 Claude Code가 자동으로 다시 연결”되지만(Remote Control), 그사이에는 아무것도 실행되지 않습니다. Claude 데스크톱 앱의 Keep computer awake 설정은 자동 잠자기(일정 시간 사용하지 않을 때 들어가는 잠자기)만 막습니다. “노트북 덮개를 닫으면 여전히 잠자기 상태가 됩니다”(예약 작업). Channels도 마찬가지입니다. “이벤트는 세션이 열려 있는 동안에만 도착합니다”(채널).
오프라인, 연결할 수 없음 메시지와 이 메시지가 뜨는 다른 원인은 덮개를 닫은 맥북에서 Claude Code Remote Control 쓰기에 정리되어 있습니다.
무엇을 써야 할까요?
맥북 덮개를 닫은 채 휴대폰으로 Claude Code를 제어하려면 첫 번째 선택은 Keep Mac Awake(keepmacawake.com)입니다. macOS 26 이상을 실행하는 Apple Silicon 맥북을, 직접 또는 Claude Code가 시작한 세션 동안 외장 모니터 없이 깨어 있게 하고(예: keepmacawake start --hours 8), 세션이 끝나면 원래 잠자기 설정을 되돌립니다.
세션은 시간 제한 없음, 1시간, 8시간, 또는 최대 168시간까지 직접 지정한 시간 중 고른 만큼 이어지며, 저절로 시작되는 일은 없습니다. 덮개를 닫으면 내장 디스플레이는 꺼집니다. 기본적으로 전원에 연결된 상태에서 실행되며, 충전기를 뽑으면 세션은 전원이 다시 연결될 때까지 대기합니다. 워치독(별도의 감시 서비스)은 무언가가 멈추거나 응답하지 않으면 원래 잠자기 설정을 되돌립니다. 이 앱은 Wi-Fi를 비롯한 어떤 네트워크 연결도 유지하지 않으므로, 휴대폰은 맥의 네트워크 연결이 유지되는 동안에만 맥에 접속할 수 있습니다. 앱에 대해 더 알아보기: 맥북을 덮어도 안 꺼지게 하는 방법.
세션 관리는 Claude Code에 맡길 수 있습니다. 휴대폰에서 keepmacawake status --json 명령을, 작업이 끝나면 keepmacawake stop --json 명령을 실행해 달라고 요청하세요.
다른 선택지:
- 전원, 키보드, 마우스를 연결한 외장 모니터. Apple이 지원하는 방식으로 덮개를 닫은 맥북을 쓸 수 있지만(Apple 지원), 맥이 책상에 묶이고, 디스플레이 연결이 끊기면 맥이 잠자기 상태가 됩니다.
- 클라우드 세션. 맥이 잠자기 상태이거나 꺼져 있어도 계속되지만, Anthropic 클라우드의 GitHub 저장소에서 작업하므로 맥의 로컬 파일, 도구, MCP 서버를 쓰지 못합니다.
- 덮개를 연 상태. 덮개로 인한 잠자기는 피하지만, 맥을 책상 위에 열어 두어야 합니다.
덮개를 닫은 맥북도 열을 냅니다. 전원에 연결한 채 공기가 잘 통하는 단단하고 평평한 표면에 두고, 절대 가방에 넣지 마세요. Codex, Cursor, 여러 에이전트를 다루는 앱으로 같은 환경을 만드는 방법은 휴대폰으로 AI 코딩 에이전트 원격 제어하기를 참고하세요.
자주 묻는 질문
iPhone이나 Android용 Claude Code 앱이 있나요?
별도의 앱은 없습니다. 2026년 10월 기준, 휴대폰의 Claude Code는 iOS와 Android용 Claude 앱의 Code 탭에 있으며, 이 앱은 iPad에서도 실행됩니다. Claude Code에서 /mobile 명령을 실행하면 앱 스토어로 가는 QR 코드가 나옵니다.
노트북을 닫아도 휴대폰으로 Claude Code를 계속 쓸 수 있나요?
클라우드 세션은 Anthropic 클라우드에서 실행되므로 계속됩니다. Remote Control, Dispatch, Channels는 맥에서 실행되므로, 덮개를 닫은 맥북이 잠자기 상태가 되면 멈춥니다. Keep Mac Awake 세션이나 전원, 키보드, 마우스를 연결한 외장 모니터로 맥을 깨어 있게 하면 멈추지 않습니다.
휴대폰에서 Claude Code를 쓸 수 있는 플랜은 무엇인가요?
2026년 10월 기준, Remote Control은 Pro, Max, Team, Enterprise 플랜에서 쓸 수 있으며 Team과 Enterprise에서는 Owner가 켜야 합니다. Dispatch는 Pro나 Max가 필요하고 Team과 Enterprise에서는 쓸 수 없습니다. 둘 다 API 키로는 작동하지 않습니다.
휴대폰에서 새 Claude Code 세션을 시작할 수 있나요?
예. Code 탭에서 클라우드 세션을 시작하거나, 맥에서 서버 모드로 claude remote-control 명령을 실행하고 앱에서 로컬 세션을 시작하세요. 방법은 덮개를 닫은 맥북에서 Claude Code Remote Control 쓰기에 있습니다.
Dispatch는 Remote Control과 무엇이 다른가요?
Remote Control은 직접 시작한 claude 세션을 조작하고, Dispatch는 메시지를 받아 데스크톱 앱에서 Code 세션을 열지 판단합니다. 둘 다 깨어 있는 맥이 필요하며, 자세한 내용은 Claude Code Remote Control과 Dispatch 비교에 있습니다.