Claude Code Remote Control 사용법? 휴대폰 원격 제어, 공식 제한 사항 및 대안 (2026)

가장 빠른 공식 방법: Claude Code를 현재 버전으로 업그레이드하고, 프로젝트 디렉터리에서 claude remote-control을 실행한 다음, 휴대폰의 Claude App 또는 브라우저에서 claude.ai/code를 열면 컴퓨터에서 계속 실행 중인 세션을 시작하고 제어할 수 있습니다. 세션이 이미 열려 있다면 /remote-control을 입력하세요. 로컬 터미널에서도 계속 조작하려면 claude --remote-control을 사용하세요.

공식 Claude Code와 Claude.ai 구독만 사용한다면 공식 Remote Control을 우선 사용하세요. API Key, Bedrock, Vertex, 사용자 정의 ANTHROPIC_BASE_URL을 사용하거나, 동일한 인터페이스에서 Codex, PandaCode, DeepSeek harness 및 여러 대의 개발 머신을 원격 제어하려면 PandaNpc를 고려하세요. 이 글에서는 두 가지 방법을 모두 명확히 설명하므로, 어느 것이 적합한지 미리 추측할 필요가 없습니다.

자료와 명령은 Anthropic Remote Control 공식 문서 기준으로 2026년 8월 30일에 확인했습니다. Claude Code 업데이트가 빠르므로 실제로 사용 가능한 명령은 로컬 claude --help와 /help를 기준으로 하세요.

Claude Code Remote Control 세 가지 시작 방법

세 명령은 동의어가 아니라, 어디서 시작할지에 따라 다릅니다.

공식 Remote Control의 실행은 여전히 로컬에서 이루어집니다. 프로젝트 파일, MCP, 도구 및 구성이 새 클라우드 컨테이너로 옮겨지지 않습니다. 휴대폰과 브라우저는 원격 제어 인터페이스일 뿐입니다. 이는 Anthropic이 관리하는 클라우드 환경에서 실행되는 Claude Code on the web과 다릅니다.

공식 Remote Control 사용: 확인부터 성공적인 연결까지

1단계: 버전, 로그인 및 작업 영역 확인

먼저 개발 머신에서 실행합니다:

claude --version

공식 문서는 Claude Code v2.1.51 이상을 요구합니다. 그런 다음 대상 프로젝트 디렉터리에서 claude를 정상적으로 한 번 시작하여 /login 및 작업 영역 신뢰 확인을 완료합니다. Remote Control은 Claude.ai ID를 사용합니다. 공식 문서에는 현재 API Key가 지원되지 않는다고 명시되어 있습니다. Team 또는 Enterprise 조직에서 항목이 보이지 않으면 관리자가 Claude Code 관리 설정에서 Remote Control을 활성화해야 합니다.

2단계: 시작 모드 선택

휴대폰에서 디렉터리를 선택하고 새 세션을 시작하려면 다음을 실행합니다:

cd /path/to/project
claude remote-control --name "My Project"

개발 머신 터미널에서 계속 입력하면서 휴대폰이 인계받도록 허용하려면 다음을 실행합니다:

cd /path/to/project
claude --remote-control "My Project"

이미 실행 중인 세션이 있다면 다음을 입력합니다:

/remote-control My Project

터미널에 세션 URL이 표시됩니다. claude remote-control 모드에서 스페이스바를 누르면 QR 코드도 표시할 수 있습니다.

3단계: 휴대폰 또는 브라우저에서 연결

동일한 Claude 계정을 사용합니다:

• 브라우저에서 https://claude.ai/code를 열고 세션 목록에서 컴퓨터 아이콘이 있는 세션을 선택합니다.
• iOS 또는 Android에서 Claude App을 열고 Code 탭으로 이동합니다.
• 또는 터미널에서 제공된 URL을 열거나 QR 코드를 스캔합니다.

처음 연결한 후에는 파일 쓰기를 즉시 승인하지 말고 먼저 읽기 전용 검증 프롬프트를 보내세요:

현재 작업 디렉터리를 출력하고 git status --short를 표시하세요. 아무 것도 수정하지 마세요.

경로가 올바르고, Git 상태가 예상과 일치하며, 권한 확인이 휴대폰이나 브라우저에 표시되어야 실제로 연결된 것입니다.

공식 Remote Control, Claude Code Web 및 PandaNpc 선택 방법

따라서 선택은 간단합니다. 공식 기능으로 충분하면 공식을 사용하세요. PandaNpc의 가치는 동일한 공식 명령을 다시 포장하는 것이 아니라, 크로스 엔진, API/사용자 정의 모델, 다중 머신 통합 관리 및 장치 사설망과 같은 시나리오를 보완하는 데 있습니다.

공식 방법이 적합하지 않을 때: PandaNpc로 로컬 Agent 원격 제어

PandaNpc의 PandaPaw는 개발 머신 옆에서 실행되며, 로컬의 Claude Code, Codex 등의 엔진을 원격 연결로 등록합니다. 모델 호출은 여전히 해당 엔진 자체의 계정 및 제공자 구성을 따릅니다. 원격 측은 명령 전송, 결과 표시 및 승인 처리만 담당합니다.

1단계: 개발 머신에 PandaPaw 설치 및 로그인

macOS / Linux:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows 관리자 PowerShell:

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

설치 프로그램이 브라우저 인증 페이지를 엽니다. 승인한 후 확인합니다:

pandapaw status

2단계: Agent 페이지에서 호스트 및 프로젝트 선택

브라우저에서 PandaNpc Agent를 열고 대상 머신이 녹색 온라인 상태인지 확인한 후, Claude Code와 올바른 프로젝트 디렉터리를 선택하고 앞서 언급한 읽기 전용 검증 프롬프트를 보냅니다. 휴대폰과 데스크톱 클라이언트는 동일한 연결 목록을 사용합니다.

iPhone의 권한 카드, 질문 카드 및 Live Activity만 관심이 있다면 휴대폰에서 Claude Code 연결하는 iOS 워크플로를 계속 읽어보세요.

여러 대의 머신과 여러 Agent: 머신별 포트 매핑을 하지 마세요

개발 머신이 한 대뿐이라면 원격 세션 하나로 충분합니다. Claude Code, Codex 및 기타 Agent가 데스크톱, 노트북, NAS, 클라우드 서버 또는 개발 컨테이너에 분산되어 있을 때 진짜 문제는 호스트 검색과 안전한 상호 연결이 됩니다.

PandaNpc의 기기 연결은 계정 아래의 머신을 암호화된 사설망에 추가하고, 각 머신에 안정적인 사설 IP를 할당하며, 실행 가능한 Agent를 자동으로 등록합니다. 기기는 지점 간 연결을 우선하며, 홀 펀칭이 불가능하면 중계로 폴백합니다. 전체 과정에 공용 IP나 라우터 포트 매핑이 필요하지 않습니다. 따라서 휴대폰은 '어떤 머신, 어떤 Agent, 어떤 프로젝트'만 선택하면 되고, 일련의 SSH 포트, 동적 DNS 및 장기 키를 저장할 필요가 없습니다.

이러한 기기 네트워킹은 'Agent가 서로 안전하게 도달할 수 있는지'를 해결합니다. 작업 분할, 컨텍스트 공유 및 결과 집계는 여전히 다중 Agent 오케스트레이션 계층에 속하므로 이 둘을 혼동해서는 안 됩니다.

자주 묻는 질문 및 문제 해결

`claude remote-control` 또는 `/remote-control`이 존재하지 않음

먼저 claude --version을 확인하세요. 기본 명령은 최소 v2.1.51이 필요하며, VS Code 지원에는 더 높은 버전이 필요합니다. 업그레이드한 후 터미널과 세션을 다시 엽니다. 그래도 없으면 /help를 실행하여 조직 정책이 Remote Control을 비활성화하지 않았는지 확인하세요.

휴대폰에서 컴퓨터 또는 세션을 찾을 수 없음

휴대폰, 브라우저 및 CLI가 동일한 Claude 계정과 조직으로 로그인되어 있는지 확인하고, 개발 머신에서 claude remote-control 프로세스가 여전히 실행 중인지 확인하세요. 휴대폰에서는 일반 채팅 목록이 아닌 Code 탭으로 들어가세요.

API Key, Bedrock, Vertex 또는 사용자 정의 게이트웨이를 사용할 때 활성화할 수 없음

공식 Remote Control은 현재 Claude.ai 로그인을 요구하며 API Key를 명시적으로 지원하지 않습니다. 먼저 이것이 유지해야 하는 인증 방식인지 확인하세요. 구독 로그인으로 전환할 수 있다면 공식을 사용하고, 전환할 수 없다면 PandaNpc와 같이 로컬 CLI에 연결할 수 있는 방안을 사용하세요. 원격 제어를 위해 프로덕션 환경의 게이트웨이나 ID 정책을 조용히 바꾸지 마세요.

컴퓨터를 종료하거나 덮개를 닫을 수 있나요

안 됩니다. 화면은 꺼도 되지만, Agent를 실행하는 호스트는 계속 켜져 있어야 하고, Claude/PandaPaw 프로세스는 살아 있어야 하며 네트워크에 연결되어야 합니다. 공식 Remote Control은 호스트가 복구되면 자동으로 다시 연결됩니다. 잦은 절전, 네트워크 전환 또는 '온라인인데 더 이상 메시지가 나오지 않는' 현상이 발생하면 Claude Code 원격 연결 끊김 문제 해결 체크리스트를 항목별로 확인하세요.

여러 원격 세션이 동일한 파일을 수정할 수 있나요

충돌 위험이 있습니다. 공식 server mode는 기본적으로 동일한 디렉터리에서 여러 세션을 만들 수 있습니다. 병렬 수정이 필요하면 claude remote-control --spawn worktree를 사용하여 세션이 독립적인 Git worktree를 얻도록 하세요. PandaNpc에서도 병렬 Agent에 대해 서로 다른 작업 영역이나 worktree를 선택하고, 두 개의 쓰기 세션이 동일한 체크아웃을 동시에 조작하지 않도록 하세요.

PandaNpc가 머신 오프라인으로 표시됨

호스트에서 pandapaw status를 실행하여 계정 권한, 백그라운드 서비스, 아웃바운드 HTTPS/WebSocket 및 해당 엔진 로그인을 순서대로 확인하세요. 공용 인바운드 포트를 여는 것은 회사 프록시가 차단한 아웃바운드 연결을 수정할 수 없습니다.

보안 경계: 코드가 로컬에 있어도 네트워크를 전혀 거치지 않는 것은 아님

공식 Remote Control은 로컬에서 아웃바운드 HTTPS 연결을 능동적으로 생성하며 라우터에 인바운드 포트를 열지 않습니다. 메시지는 Anthropic API의 TLS 연결을 통해 원격 인터페이스와 로컬 세션 간에 전달됩니다. 프로젝트 파일과 도구 실행은 호스트에 남아 있지만, 대화를 표시하고 명령을 처리하기 위해 세션 데이터는 여전히 공식 서비스를 거쳐야 합니다.

PandaNpc도 마찬가지로 호스트가 인증 중계에 능동적으로 연결하게 하며, 실행은 호스트에 남습니다. 원격에서 표시할 메시지, 상태, Diff 및 승인은 중계를 거칩니다. 어떤 방법을 사용하든 다음 사항을 준수해야 합니다:

• 호스트와 작업 디렉터리를 먼저 확인한 후 파일 쓰기 또는 명령 실행을 승인하세요.
• 원격 연결을 신뢰할 수 없는 사람과 공유하지 마세요.
• 민감한 프로젝트에서는 기본 승인 또는 편집 전용 모드를 우선 사용하세요.
• 회사 장치는 회사가 승인한 VPN, VDI, ID 및 감사 요구 사항을 준수하세요.

FAQ

Claude Code Remote Control이란 무엇인가요?

Claude App 또는 claude.ai/code가 컴퓨터에서 계속 실행 중인 Claude Code를 제어할 수 있게 해줍니다. 휴대폰과 브라우저는 원격 인터페이스이며, 로컬 파일, MCP, 도구 및 프로젝트 구성은 개발 머신에 계속 남아 있습니다.

휴대폰에서 Claude Code를 어떻게 사용하나요?

개발 머신에서 claude remote-control, claude --remote-control을 실행하거나 이미 실행 중인 세션에 /remote-control을 입력하세요. 그런 다음 동일한 계정으로 Claude App의 Code 탭 또는 claude.ai/code를 엽니다. Codex, 사용자 정의 모델 또는 여러 호스트를 추가로 제어해야 한다면 PandaNpc의 Agent 페이지를 사용할 수 있습니다.

Claude Code Remote Control은 브라우저를 지원하나요?

지원합니다. 공식 진입점은 claude.ai/code이며, PandaNpc도 브라우저, iOS 및 데스크톱 클라이언트를 제공합니다. 둘 다 전체 프로젝트를 현재 브라우저로 복사하는 것이 아니라 Agent가 호스트에서 실행되도록 합니다.

Claude Code Remote Control은 API Key를 지원하나요?

공식 문서에는 현재 API Key 미지원이 명시되어 있으며 Claude.ai 로그인이 필요합니다. Claude Code가 API, Bedrock, Vertex 또는 사용자 정의 ANTHROPIC_BASE_URL을 반드시 사용해야 한다면 기존 인증을 유지하고 로컬 CLI에 연결할 수 있는 원격 방안을 선택하세요.

휴대폰이 네트워크에서 끊기면 Claude Code가 중지되나요?

개발 머신과 Agent 프로세스가 계속 온라인 상태라면, 휴대폰의 네트워크가 끊기거나 페이지를 닫아도 호스트 세션이 중지되는 것은 아닙니다. 다시 연결하면 계속 볼 수 있습니다. 그러나 개발 머신이 절전, 종료 또는 장시간 네트워크 단절 상태라면 새 작업을 실행할 수 없습니다.

공식 Remote Control이 Codex 또는 여러 Agent를 제어할 수 있나요?

불가능합니다. 이는 Claude Code 기능입니다. 동일한 인터페이스에서 Claude Code, Codex, PandaCode, DeepSeek harness, Pi 및 여러 호스트를 관리하려면 추가적인 다중 엔진 연결 계층이 필요합니다. PandaNpc의 PandaPaw와 기기 연결이 바로 이 시나리오를 위해 설계되었습니다.

결론

휴대폰이나 브라우저에서 공식 Claude Code 세션 하나를 계속하고 싶다면 claude remote-control을 실행하세요. 공식 방법이 가장 짧고 직접적입니다. API/사용자 정의 모델, Codex 등 다른 엔진, 다중 호스트 또는 사설 장치 네트워킹이 필요하다면 로컬 Agent 구성을 유지하고 PandaPaw를 통해 연결을 PandaNpc에 통합하세요.

어떤 방법을 선택하든 성공 기준은 '페이지가 온라인으로 표시되는 것'이 아니라, 원격에서 올바른 작업 디렉터리를 읽고, 실제 Git 상태를 확인하며, 권한 확인을 수신하고, 연결이 끊겼다가 다시 연결된 후에도 동일한 로컬 세션을 계속하는 것입니다.