휴대폰에서 Claude Code 사용하기: 되는 것과 안 되는 것

01"휴대폰에서 Claude Code"의 의미

Claude Code는 커맨드 라인 도구예요. Mac, Windows, Linux의 terminal이나 Anthropic 클라우드에서 실행돼요. iPhone이나 Android 휴대폰에서 CLI 자체를 실행할 방법은 없어요. 대신 다른 곳에서 실행 중인 세션에 접속할 수는 있어요. 아래 방법들은 Claude가 어디서 실행되는지, 세션을 얼마나 볼 수 있는지가 서로 달라요.

02방법 1: Remote Control (Anthropic)

Remote Control은 iOS·Android용 Claude 앱이나 브라우저의 claude.ai/code를 내 컴퓨터에서 실행 중인 Claude Code 세션에 연결해 줘요. 파일, 도구, MCP 서버는 컴퓨터에 그대로 있어요. 휴대폰은 그 세션을 보는 창 역할을 하고, terminal과 계속 동기화돼요.

시작하는 방법은 세 가지예요:

claude remote-control          # server mode: waits for connections, can show a QR code
claude --remote-control        # a normal interactive session, also reachable remotely

또는 이미 열려 있는 세션에서 /remote-control(또는 /rc)을 입력하세요. VS Code 확장과 Claude Desktop 앱에서도 쓸 수 있어요.

Anthropic 문서에 나온 참고 사항:

• Pro, Max, Ultra, Team, Enterprise 플랜에서 사용할 수 있어요. Team과 Enterprise에서는 Owner가 먼저 기능을 켜야 해요.
• claude.ai 로그인이 필요해요. API 키는 지원되지 않으며, Amazon Bedrock, Google Cloud, Microsoft Foundry, 커스텀 ANTHROPIC_BASE_URL로는 사용할 수 없어요.
• 컴퓨터가 켜져 있어야 하고 claude 프로세스가 계속 실행 중이어야 해요. terminal을 닫으면 세션이 오프라인이 돼요.
• 연결되어 있는 동안에는 기기 간 동기화를 위해 세션 기록이 Anthropic 서버에 저장돼요.
• Claude 앱으로 push 알림을 보낼 수 있어요. /config에서 Push when Claude decides나 Push when actions required(권한 prompt와 질문용), 또는 둘 다 켜세요.

휴대폰에서 대화 내용을 읽고 메시지를 직접 입력하고 싶다면 Remote Control이 가장 완전한 방법이에요.

03방법 2: 클라우드 세션 (Anthropic)

클라우드 세션은 Claude Code를 내 컴퓨터 대신 Anthropic이 관리하는 인프라에서 실행해요. claude.ai/code, Claude 모바일 앱의 Code 탭, 또는 terminal에서 시작할 수 있어요:

claude --cloud "Fix the flaky test in auth.spec.ts"

노트북을 닫아도 세션은 계속 실행되고, 어떤 기기에서든 상태를 확인하거나 방향을 조정할 수 있어요. 나중에 claude --teleport로 terminal로 가져올 수도 있어요.

Anthropic 문서 기준:

• Pro, Max, Ultra, Team 플랜과 일부 Enterprise 시트에서 사용할 수 있어요.
• VM이 GitHub에서 코드를 clone하기 때문에 먼저 GitHub를 연결해야 해요. 다른 호스트는 제약이 있어요.
• 로컬 머신의 도구, 파일, MCP 서버는 쓸 수 없고, 클라우드 환경이 제공하는 것만 쓸 수 있어요.

집에서 아무것도 실행하지 않은 상태로 휴대폰에서 새 작업을 시작하고 싶다면 클라우드 세션이 가장 잘 맞아요.

04방법 3: 휴대폰에서 SSH 접속

iPhone이나 Android의 SSH 클라이언트라면 무엇이든 컴퓨터나 서버의 terminal을 열 수 있어요. 연결이 끊겨도 세션이 유지되도록 Claude Code를 tmux나 screen 안에서 실행한 다음, 휴대폰에서 다시 attach하면 돼요.

책상에서 쓰던 terminal을 그대로 쓸 수 있어요. 다만 데스크톱 terminal을 휴대폰 키보드로 다뤄야 해서, 잠깐 확인하는 정도는 괜찮지만 오래 쓰기엔 피곤해요. 또 Claude가 입력을 기다릴 때 알려 주지 않으니 직접 들여다봐야 해요. detach된 세션에서 알림을 받는 방법은 tmux나 screen에서 Claude Code 사용하기를 참고하세요.

05방법 4: hook 기반 알림과 응답

Claude Code는 정해진 시점에 hook을 실행해요. 턴이 끝날 때(Stop), 권한이 필요할 때(PermissionRequest), 도구가 실행되기 전(PreToolUse) 등이에요. hook은 휴대폰으로 push를 보낼 수 있고, 일부 이벤트에서는 사용자의 응답을 Claude Code에 돌려줄 수도 있어요. 세션을 지켜볼 필요 없이, 확인이 필요할 때 휴대폰이 울리면 탭 한 번으로 응답하면 돼요.

ntfy 같은 push 서비스로 직접 구성할 수도 있고(ntfy로 Claude Code push 알림 받기 참고), 이미 만들어진 도구를 써도 돼요.

Claude Code Notifier

Claude Code Notifier는 Anthropic이 아닌 TouchTap Ltd가 만든 독립 도구예요. Mac, Windows, Linux용 무료 커맨드라인 도구 ccn과 iPhone, Android용 앱으로 구성돼 있어요. ccn은 Claude Code가 hook을 통해 실행하는 작은 바이너리 하나예요. 이벤트가 생기면 몇 밀리초 동안 실행된 뒤 바로 종료되고, 백그라운드에서 도는 건 없어요.

휴대폰을 페어링하면 다음 기능을 쓸 수 있어요.

• 턴이 끝나면 "Claude 작업 완료" push를 받아요.
• 권한 요청을 한 번만 허용, 세션 동안 허용, 또는 거부할 수 있어요.
• 옵션을 골라 질문에 답할 수 있어요.
• Claude가 작업을 마친 직후 후속 지시를 보낼 수 있어요.

Remote Control을 켤 필요가 없고, IDE terminal이나 SSH 세션을 포함해 어떤 terminal에서든 작동해요. Remote Control보다 기능 범위는 좁아서 휴대폰에서 전체 대화를 읽을 수는 없어요. 대신 Claude가 하염없이 기다리게 될 순간을 위해 만들어졌어요.

휴대폰을 Claude Code에 연결하기에 나온 대로 설치하고 페어링하면 1분이면 끝나요. 앱은 무료로 다운로드할 수 있고, 사용하려면 구독이나 평생 이용권 구매가 필요해요. 요금을 확인하세요.

06한눈에 비교

07잘 안 되는 것들

• 휴대폰에서 CLI를 직접 실행하기. Claude Code는 Mac, Windows, Linux 머신이나 Anthropic 클라우드가 필요해요.
• SSH로 휴대폰 키보드로 길게 입력하기. 할 수는 있지만 쾌적한 경우는 드물어요.
• 노트북을 절전 모드로 두기. 컴퓨터에서 실행되는 건 절전 모드에 들어가면 모두 멈춰요. 깨어 있게 유지하는 방법은 Claude Code를 실행해 두고 자리 비우기를 참고하세요.

08어떤 걸 골라야 할까요

• 소파에서 전체 대화를 읽고 방향을 잡고 싶다면: Remote Control.
• 컴퓨터를 끈 채로 새 작업을 시작하고 싶다면: 클라우드 세션.
• 가끔 평소 쓰던 terminal 그대로 쓰고 싶다면: SSH.
• 자리를 비우고 Claude가 결정을 필요로 할 때만 알림을 받고 싶다면: Claude Code Notifier 같은 hook 기반 도구가 맞아요.

이 방법들은 서로 배타적이지 않아요. 여러 개를 함께 쓰는 사람도 많아요. terminal 벨이나 채팅 webhook을 포함한 모든 알림 방식은 Claude Code 알림을 받는 모든 방법 비교를 참고하세요.

09FAQ