Claude Code 원격 제어(Remote Control)를 쓰면 Mac에서 돌아가는 Claude Code 세션을 휴대폰, 태블릿, 브라우저에서 그대로 이어서 쓸 수 있습니다. Claude는 계속 Mac에서 실행되고, 조작은 Claude 앱이나 claude.ai/code에서 합니다.
Anthropic이 Claude Code에 넣은 기능 중에서도 특히 유용한 기능입니다. 이 글에서는 설정 방법, 할 수 없는 것, 자주 나오는 오류 해결법을 정리합니다.
Claude Code 원격 제어 시작하는 법
켜는 방법은 세 가지입니다. 작업 방식에 맞는 것을 고르세요.
1. 서버 모드
claude remote-control프로젝트 폴더에서 실행합니다. 연결을 기다리면서 세션 URL을 보여줍니다. 스페이스바를 누르면 QR 코드가 나옵니다. --spawn worktree를 붙이면 새 세션마다 별도의 git worktree가 생기고, --capacity로 동시에 실행할 세션 수를 제한할 수 있습니다.
2. 평소 세션을 원격으로도 조작하기
claude --remote-control "My Project"터미널에서 평소와 같은 Claude Code 세션이 열립니다. Mac과 휴대폰 양쪽에서 입력할 수 있습니다. 짧게 --rc로 써도 됩니다.
3. 이미 실행 중인 세션에서 켜기
/remote-controlClaude Code 프롬프트에 /remote-control 또는 /rc를 입력합니다. Claude 데스크톱 앱과 VS Code 확장에서도 됩니다.
모든 세션을 자동으로 연결하고 싶다면 /config에서 모든 세션에 원격 제어를 켜세요.
아이폰이나 안드로이드에서 연결하기
- QR 코드를 스캔하면 Claude 앱에서 세션이 열립니다.
- 또는 Claude 앱에서 Code를 누르고 목록에서 세션을 고릅니다.
- 세션 URL을 아무 컴퓨터의 브라우저에서 열어도 됩니다.
아직 Claude 앱이 없다면 Claude Code에서 /mobile을 실행하세요. 휴대폰에 맞는 앱스토어로 가는 QR 코드가 나옵니다.
Claude가 기다릴 때 알림 받기
/config에서 Push when actions required를 켜세요. Claude가 권한 승인을 기다리거나 질문할 때 휴대폰으로 알림이 옵니다. 자리를 비울 때 원격 제어를 제대로 쓰려면 이 설정이 가장 중요합니다.
필요한 것
- Claude Pro, Max, Team, Enterprise 중 하나의 요금제.
/login으로 claude.ai에 로그인한 상태. API 키로는 쓸 수 없습니다.- Team과 Enterprise는 먼저 소유자(Owner)가 Claude Code 관리자 설정에서 원격 제어를 켜야 합니다.
- 컴퓨터가 켜져 있고
claude프로세스가 계속 실행 중이어야 합니다.
안전한가요?
Mac은 바깥으로 나가는 HTTPS 요청만 보내고, 들어오는 포트는 열지 않습니다. 코드와 파일은 Mac에 그대로 있고, 휴대폰은 세션에 메시지만 보냅니다. Pro와 Max 사용자는 Trusted Devices를 켜서 인증된 기기만 세션을 조작하게 할 수도 있습니다.
Claude Code 원격 제어로 할 수 없는 것
원격 제어는 Claude Code와의 대화를 위한 기능입니다. 대화 밖의 작업에는 터미널이 필요합니다. Mac 전체를 휴대폰으로 가져오는 Macky와 비교하면 이렇습니다.
| Claude 원격 제어 | Macky | |
|---|---|---|
| Claude Code와 대화 | 가능 | 가능 (Claude Code 모드) |
| git, npm, docker 직접 실행 | Claude에게 부탁하는 방식만 | 가능 (zsh, bash 그대로) |
| Codex 등 다른 에이전트 | 불가 | 가능 (Codex 모드) |
| 내 서버에 SSH 접속 | 불가 | 가능 (Mac의 키 사용) |
| Mac 화면 보고 조작 | 불가 | 가능 |
| API 키나 Bedrock으로 사용 | 불가 | 가능 (내 터미널이니까) |
| 가격 | Claude 요금제에 포함 | 무료, Pro는 1회 결제 ₩49,000 |
하나 더 알아둘 점이 있습니다. MacBook이 잠자기에 들어가면 세션이 멈추고, Mac이 깨어나면 다시 연결됩니다. 덮개를 닫으면 보통 잠자기에 들어가므로, 긴 작업 중에는 caffeinate로 깨어 있게 하세요.
자주 나오는 오류와 해결법
"Remote Control requires a claude.ai subscription"
로그아웃 상태이거나, 해당 요금제가 없는 계정으로 로그인했습니다. /login을 실행해서 claude.ai 계정으로 로그인하세요.
"ANTHROPIC_API_KEY is set, so this session is using API-key auth"
API 키가 claude.ai 로그인보다 우선 적용되고 있습니다. unset ANTHROPIC_API_KEY를 실행하고, 셸 설정 파일에서도 지운 뒤 Claude Code를 다시 시작하세요.
"Remote Control is only available when using Claude via api.anthropic.com"
Amazon Bedrock, Google Cloud, Microsoft Foundry를 거쳐 쓰고 있거나, ANTHROPIC_BASE_URL이 다른 호스트를 가리키고 있습니다. 이 변수를 해제하세요. 회사 정책상 그 제공업체를 써야 한다면 원격 제어는 쓸 수 없습니다.
"Remote Control isn't enabled for this account"
요금제를 바꾼 직후에 자주 생깁니다. claude auth logout 후 claude auth login을 실행해서 계정 정보를 새로 고치세요.
"세션이 오프라인이 됨"
claude 프로세스가 멈춘 상태입니다. 멈춘 지 약 4시간 이내라면 claude remote-control --continue로 세션을 되살릴 수 있습니다.
그래도 안 된다면 Claude Code 원격 제어가 안 될 때 해결법에서 연결 끊김과 잠자기 문제를 자세히 다룹니다.
Claude 말고 다른 작업도 해야 할 때
원격 제어와 Macky는 함께 쓸 수 있습니다. Claude와의 대화는 원격 제어가 잘하고, Mac의 나머지는 Macky가 맡습니다.
Macky는 Mac의 진짜 터미널과 전체 화면을 아이폰이나 아이패드에서 여는 앱입니다. Claude Code와 Codex는 각각 전용 모드가 있습니다. 키 바에는 Esc, Tab, Ctrl이 있고, 에이전트가 승인을 요청하면 y와 Enter를 바로 누를 수 있습니다.
- 서버도 그대로 쓸 수 있습니다.
ssh my-vps만 입력하면 접속됩니다. Mac에 있는 키와 설정을 쓰기 때문에 휴대폰에는 아무것도 복사하지 않습니다. - 덮개를 닫은 채로. Pro에서는 MacBook을 닫아 책상에 둔 채로도 쓸 수 있습니다.
- 백그라운드 연결. Pro에서는 휴대폰을 잠가도 세션이 계속 연결되어 있습니다.
- 기본부터 안전하게. 포트를 열 필요가 없고 연결은 종단간 암호화됩니다. 새 기기는 Mac에서 승인해야 하고, 터미널은 마스터 비밀번호로 보호됩니다.
Macky는 5분 세션까지 무료로 써볼 수 있습니다. Pro는 1회 결제 ₩49,000입니다. App Store에서 받기.
무엇을 써야 할까요?
- Pro나 Max에서 Claude Code만 쓴다면: 원격 제어로 충분합니다. 푸시 알림도 켜세요.
- API 키나 Bedrock으로 Claude Code를 쓴다면: 원격 제어는 작동하지 않습니다. Claude가 실행되는 터미널에 Macky로 접속하세요.
- Claude와 함께 git, Docker, Codex, 서버도 쓴다면: Macky를 추천합니다. 원격 제어와 같이 써도 됩니다.
- Mac 화면을 봐야 한다면: Macky를 쓰세요.
나란히 비교해 보고 싶다면 Macky와 Claude Code 원격 제어 비교를, 휴대폰에서 Claude Code를 쓰는 모든 방법은 아이폰에서 Claude Code 쓰는 법을 보세요.
자주 묻는 질문
Claude Code 원격 제어란 무엇인가요?
컴퓨터에서 실행 중인 Claude Code 세션을 Claude 앱이나 claude.ai/code에서 이어서 쓰게 해주는 기능입니다. 코드는 계속 컴퓨터에서 실행됩니다.
어떻게 시작하나요?
프로젝트에서 claude remote-control을 실행하거나, claude --remote-control로 시작하거나, 세션 중에 /rc를 입력하면 됩니다.
무료인가요?
Claude Pro, Max, Team, Enterprise 요금제에 포함되어 있습니다. API 키로는 쓸 수 없습니다.
Mac이 잠자기 상태여도 되나요?
안 됩니다. 세션이 멈추고, Mac이 깨어나면 다시 연결됩니다.
Bedrock이나 API 키로 쓸 수 있나요?
쓸 수 없습니다. claude.ai 로그인과 Anthropic API가 필요합니다. 이 경우에도 Macky 같은 터미널 앱으로는 휴대폰에서 Claude Code를 조작할 수 있습니다.
Claude 말고 다른 명령도 실행할 수 있나요?
원격 제어로는 안 됩니다. git, Docker, Codex, SSH를 쓰려면 Macky 같은 진짜 터미널을 쓰세요.