Claude Code 원격 제어(Remote Control)가 안 되는 원인은 대부분 세 가지입니다. 로그인 방식 문제, Anthropic이 아닌 곳으로 연결되는 설정, 그리고 Mac에서 세션이 멈춘 경우입니다.
화면에 뜬 오류 메시지를 아래에서 찾아보세요. 모두 Anthropic 공식 문서를 바탕으로 한 해결 방법입니다.
| 오류 또는 증상 | 원인 | 해결 방법 |
|---|---|---|
| "Remote Control requires a claude.ai subscription" | claude.ai로 로그인하지 않음 | claude auth login |
| "Remote Control requires claude.ai subscription auth" | API 키나 토큰이 설정됨 | 해당 환경 변수 삭제 |
| "Remote Control requires a full-scope login token" | claude setup-token 토큰 사용 | claude auth login |
| "Remote Control isn't enabled for this account" | 예전 요금제 정보가 남아 있음 | 로그아웃 후 다시 로그인 |
| "Couldn't verify Remote Control eligibility" | 오프라인이거나 프록시가 차단 | 다시 시도 후 claude doctor |
| "Remote Control is only available when using Claude via api.anthropic.com" | Bedrock, Google Cloud, Foundry 또는 ANTHROPIC_BASE_URL | 해당 환경 변수 해제 |
| "Remote Control is disabled by your organization's policy" | Team 또는 Enterprise에서 꺼져 있음 | /status 확인 후 Owner에게 요청 |
| "could not reach the Remote Control server for about 30 minutes" | 오랫동안 서버와 연결이 끊김 | /remote-control 실행 |
| 앱에 세션이 안 보임 | 원격 제어를 시작하지 않음 | /rc 실행 |
| 세션이 오프라인이 됨 | claude 프로세스가 멈춤 | claude remote-control --continue |
| 데스크톱 앱 세션이 안 보임 | 알려진 버그 #92306 | 터미널에서 시작 |
| 포크한 세션이 안 보임 | 알려진 버그 #94396 | 그 세션에서 /remote-control |
/remote-control 실행 후 아무 표시 없음 | 보고 #96591 | claude remote-control 사용 |
| 몇 시간 뒤 세션이 사라짐 | 보고 #98879 | 메시지 전송 또는 /remote-control |
| "Couldn't reconnect to your Remote Control session" | 앱 종료, 재실행 또는 업데이트 | 다시 시도 후 새 세션 시작 |
“Remote Control requires a claude.ai subscription”
Claude Code가 claude.ai 계정으로 로그인되어 있지 않을 때 나오는 오류입니다. claude remote-control로 실행하면 "You must be logged in to use Remote Control."라고 나옵니다.
원격 제어는 Pro, Max, Team, Enterprise 요금제에서 쓸 수 있습니다. API 키로는 쓸 수 없습니다. claude.ai 계정으로 로그인하세요.
claude auth login“Remote Control requires claude.ai subscription auth”
로그인은 되어 있지만 API 키나 토큰이 우선 적용되고 있습니다. 메시지에 원인이 적혀 있습니다. 예를 들면 "ANTHROPIC_API_KEY is set, so this session is using API-key auth"입니다.
해당 환경 변수를 셸 설정 파일과 Claude 설정 파일의 env 항목에서 지우세요. 그다음 Claude를 다시 실행합니다.
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN
claude --remote-control메시지에 apiKeyHelper가 나오면 그 설정을 지우세요.
“Remote Control requires a full-scope login token”
claude setup-token이나 CLAUDE_CODE_OAUTH_TOKEN의 장기 토큰으로 로그인한 상태입니다. 이 토큰은 모델 요청에만 쓸 수 있습니다. 일반 방식으로 다시 로그인하세요.
claude auth login“Remote Control isn't enabled for this account”
계정을 확인한 결과가 꺼짐으로 나왔습니다. 보통 요금제를 바꾼 뒤 예전 계정 정보가 남아 있을 때 생깁니다. 예전 버전에서는 "Remote Control is not yet enabled for your account"로 나왔습니다.
로그아웃했다가 다시 로그인하고 Claude Code를 업데이트하세요. 어떤 확인에서 실패했는지는 claude doctor로 볼 수 있습니다.
claude auth logout
claude auth login
claude doctor“Couldn't verify Remote Control eligibility”
계정을 확인하는 서비스에 연결하지 못했습니다. 오프라인이거나 프록시가 요청을 막고 있습니다. 정상적인 네트워크에서 다시 시도하거나 claude doctor로 자세히 확인하세요.
“Remote Control is only available when using Claude via api.anthropic.com”
가장 자주 검색되는 오류 중 하나입니다. 원격 제어는 Claude Code가 Anthropic API와 직접 통신해야 합니다. Amazon Bedrock, Google Cloud, Microsoft Foundry에서는 쓸 수 없습니다. ANTHROPIC_BASE_URL이 프록시나 LLM 게이트웨이를 가리켜도 안 됩니다. claude.ai로 로그인했어도 마찬가지입니다.
메시지에 원인이 적혀 있습니다. 예를 들면 CLAUDE_CODE_USE_BEDROCK이나 직접 설정한 ANTHROPIC_BASE_URL입니다. 이것을 해제하고 설정 파일의 env에서도 지운 뒤 세션을 다시 시작하세요.
env | grep -i -e ANTHROPIC -e CLAUDE_CODE_USE
unset ANTHROPIC_BASE_URL
claude --remote-control“Remote Control is disabled by your organization's policy”
Team과 Enterprise 요금제에서는 원격 제어가 처음에 꺼져 있습니다. Owner가 Claude Code 관리자 설정에서 켜야 합니다. Pro나 Max를 쓰는데 이 오류가 나면, 예전 Team 조직 로그인이 남아 있을 수 있습니다.
/status로 요금제와 조직을 확인하세요. 다른 조직이 보이면 claude auth logout 후 claude auth login을 실행합니다. 메시지에 disableRemoteControl이 있으면 IT 관리자가 이 기기에서 꺼 둔 것입니다.
“could not reach the Remote Control server for about 30 minutes”
세션이 오랫동안 Anthropic 서버와 연결되지 못했습니다. 세션 안에서 다음을 실행하면 다시 연결됩니다.
/remote-controlClaude 앱에 세션이 보이지 않을 때
원격 제어는 직접 시작해야만 켜집니다. 세션 안에서 /rc를 실행하거나 claude --remote-control로 시작하세요. Claude 앱에서는 Code를 누르면 세션 목록이 나옵니다. 두 기기 모두 같은 계정을 써야 합니다.
모든 세션을 자동으로 연결하려면 /config에서 Enable Remote Control for all sessions를 켜세요. 데스크톱 앱에서는 설정 > Claude Code > Connect new sessions to Remote Control입니다.
세션이 오프라인이 되었을 때
원격 제어는 Mac의 claude 프로세스 안에서 돌아갑니다. 터미널을 닫거나 앱을 종료하면 세션이 오프라인이 됩니다.
서버 모드로 시작했다면 약 4시간 안에 다음 명령으로 되살릴 수 있습니다.
claude remote-control --continue--remote-control이나 /rc로 시작한 세션은 claude --continue를 실행한 뒤 /rc를 입력하세요. 긴 작업은 tmux 안에서 돌리면 창을 닫아도 멈추지 않습니다.
Mac이 잠자기에 들어가면 멈출 때
Mac이 잠자는 동안에는 작업이 멈춥니다. Mac이 깨어나면 Claude Code가 자동으로 다시 연결합니다.
작업하는 동안 Mac을 깨워 두려면 caffeinate로 Claude를 실행하세요.
caffeinate -i claude --remote-control대부분의 MacBook은 외부 디스플레이와 전원을 연결하지 않으면 덮개를 닫을 때 잠자기에 들어갑니다.
휴대폰에 세션이 안 보이거나 사라질 때
모두 GitHub에 보고된 알려진 버그입니다. 2026년 10월 기준으로 대부분 아직 해결되지 않았습니다. 경우별 원인과 지금 할 수 있는 방법을 정리했습니다.
Claude 데스크톱 앱 세션이 보이지 않음
macOS 데스크톱 앱에서 연 대화형 Code 세션은 자동 연결을 켜 두어도 원격 제어에 등록되지 않을 수 있습니다. 같은 앱의 예약 작업은 휴대폰에 정상적으로 보입니다. 이슈 #92306에 보고되었고 아직 해결되지 않았습니다.
공식 수정은 아직 없습니다. 보고에 따르면 따로 설치한 CLI는 이 버그의 영향을 받지 않습니다. 터미널에서 claude --remote-control로 시작하면 피할 수 있을 가능성이 있습니다.
포크한 세션이 보이지 않음
다른 세션에서 포크한 세션은 원격 제어 대상이 되지 않습니다. 그래서 휴대폰의 Code 탭에 나오지 않습니다. 이슈 #94396에 보고되었고 아직 해결되지 않았습니다.
보고자가 제시한 우회 방법은 그 세션에서 /remote-control을 직접 실행하는 것입니다. 먼저 메시지를 한 번 보내세요. 그렇지 않으면 "Remote Control requires an active session. Send a message first."가 표시됩니다.
/remote-control을 실행해도 아무것도 나오지 않음
/remote-control을 실행해도 링크나 확인 메시지가 나오지 않는 경우가 있습니다. 다시 실행하면 "Remote Control disconnected."가 표시됩니다. 이슈 #96591에 보고되었고 계획 없음으로 닫혔습니다.
먼저 claude doctor로 로그인과 네트워크를 확인하세요. 그다음 서버 모드인 claude remote-control을 써 보세요. 세션 URL과 QR 코드가 표시되어 바로 열 수 있습니다.
메시지 없이 몇 시간 지나면 세션이 사라짐
Android에서 메시지가 없는 상태로 약 8시간이 지나자 Code 목록에서 세션이 사라졌다는 보고가 있습니다. 컴퓨터는 켜져 있었습니다. 데스크톱 앱을 다시 사용하자 세션이 나타났습니다. 이슈 #98879에 보고되었고 아직 해결되지 않았습니다.
아직 수정은 없습니다. Mac에서 메시지를 보내거나 /remote-control로 다시 연결하세요.
"Couldn't reconnect to your Remote Control session"
데스크톱 앱을 종료하거나 다시 실행하거나 자동 업데이트하면 세션이 멈추고 원격 제어가 다시 켜지지 않습니다. 다시 켜려고 하면 "Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume."가 표시될 수 있습니다. 이슈 #98504에 보고되었고 아직 해결되지 않았습니다.
메시지대로 한 번 다시 시도하세요. 안 되면 새 세션을 시작하세요. 멈춘 세션은 Mac에서 한 번 대화를 주고받아야 원격 제어를 다시 켤 수 있습니다.
커뮤니티 우회 방법으로, 데스크톱 앱 밖에서 tmux 안에 claude를 실행하는 방법이 있습니다. 앱이 다시 시작되어도 멈추지 않습니다.
Claude 세션 말고 다른 작업도 필요할 때
원격 제어는 Claude Code와 대화할 때 정말 편리합니다. 하지만 Mac의 다른 작업도 해야 할 때가 있습니다. Macky는 Mac의 터미널과 화면을 그대로 iPhone에서 열어 줍니다.
- API 키, Bedrock, 프록시를 써도 동작합니다. 내 셸 그대로라서 지금 설정을 바꿀 필요가 없습니다.
- Claude Code와 Codex 전용 모드가 있고, git이나 Docker에 쓸 일반 터미널도 있습니다.
- Esc, Tab, Ctrl 키 바가 있습니다. y와 Enter로 승인할 수 있습니다.
- SSH 키는 Mac에만 있습니다.
ssh my-vps만 입력하면 서버에 접속됩니다. - Pro에서는 MacBook 덮개를 닫은 채로 쓸 수 있고, 백그라운드에서도 연결이 유지됩니다.
Mac과 iPhone에 Macky를 설치하고 양쪽에서 로그인한 뒤 연결하면 끝입니다. 5분 세션은 무료이고, Pro는 ₩49,000 한 번 결제입니다. App Store에서 받기
원격 제어 설정 방법은 Claude Code 원격 제어 설정 가이드에서 볼 수 있습니다. 두 방식의 차이는 Macky vs Claude Code Remote Control 비교를 참고하세요.
자주 묻는 질문
Claude Code 원격 제어가 안 되는 이유는 무엇인가요?
대부분 로그인 방식, API 키나 ANTHROPIC_BASE_URL 설정, 또는 Mac에서 claude 프로세스가 멈춘 것이 원인입니다. 오류 메시지를 보면 어느 쪽인지 알 수 있습니다.
"Remote Control is only available when using Claude via api.anthropic.com"는 어떻게 해결하나요?
메시지에 나온 ANTHROPIC_BASE_URL이나 Bedrock 같은 환경 변수를 해제하고, claude.ai로 로그인한 상태에서 Claude Code를 다시 시작하세요.
API 키로 원격 제어를 쓸 수 있나요?
쓸 수 없습니다. Pro, Max, Team, Enterprise 요금제의 claude.ai 로그인이 필요합니다.
Claude 앱에 세션이 안 보이는 이유는 무엇인가요?
/rc나 claude --remote-control을 실행해야 시작됩니다. /config에서 자동 연결을 켤 수도 있습니다. 두 기기 모두 같은 계정을 써야 합니다.
Mac이 잠자기에 들어가면 어떻게 되나요?
작업이 멈춥니다. Mac이 깨어나면 Claude Code가 자동으로 다시 연결합니다.
원격 제어 없이 휴대폰에서 Claude Code를 쓸 수 있나요?
네. Macky는 Mac의 터미널을 iPhone에서 그대로 열기 때문에 API 키를 포함한 어떤 로그인 방식에서도 Claude Code를 쓸 수 있습니다.