모바일에서 Claude Code
기준일: 2026-07-26
공식 기준: Claude Code on mobile
개요
Claude 앱(iOS, Android)은 코드가 실행되는 장소가 아니라 Claude Code 세션 클라이언트입니다. 폰에서 다음 중 하나에 연결합니다.
| 기능 | 연결 대상 | 언제 쓰나 |
|---|---|---|
| Claude Code on the web | Anthropic 관리 클라우드 세션 | 저장소가 GitHub에 있고 폰을 내려놓아도 작업이 계속 돌아가야 할 때. 설정은 web quickstart |
| Remote Control | 내 컴퓨터의 Claude Code 세션 | 로컬 파일시스템·도구·MCP가 필요할 때 |
| Dispatch | 데스크톱 앱 | 작업을 메시지로 맡기고 Dispatch가 실행 방식을 고르게 할 때. Pro/Max 필요 |
별도 “모바일 전용 Claude Code 앱”은 없습니다. 클라우드 세션과 Remote Control은 앱의 Code 탭에 있고, Dispatch는 앱에서 작업으로 보내는 메시지입니다.
앱 받기
- Claude 앱 설치 — iOS 또는 Android. iPad도 동일 iOS 앱. 세션에서
/mobile(또는/ios,/android)을 실행하면 다운로드 QR을 표시할 수 있습니다. - 로그인 — Claude Code와 같은 claude.ai 계정·조직. 클라우드 세션과 Remote Control은 claude.ai 계정이 필요하며, Anthropic Console API 키나 Amazon Bedrock 등 서드파티 제공자만으로는 도달할 수 없습니다.
- Code 탭 — 앱 하단 Code로 세션 목록에 들어가거나, 폰에서 claude.ai/code/new로 새 Code 세션을 시작합니다. Code 탭이 보이지 않으면 플랜/조직에서 해당 기능이 없을 수 있습니다. feature availability를 확인하세요.
폰에서 작업하기
클라우드 세션 시작·모니터링
Claude Code on the web는 Anthropic 관리 인프라에서 돌아가 폰을 치워도 세션이 이어집니다. Code 탭에서 저장소·브랜치를 고르고 작업을 제출합니다. 세션은 기기 간에 유지됩니다(노트북에서 시작한 작업을 폰에서 검토 가능).
세션을 열어 진행 확인, 질문에 답, 방향 전환을 할 수 있습니다. PR을 지켜보고 CI 실패·리뷰 코멘트를 고치라고 지시할 수도 있습니다. GitHub 연결·환경 생성은 web quickstart, 전체 기능은 Claude Code on the web를 보세요.
Remote Control로 로컬 세션 이어하기
Remote Control은 폰 앱을 내 머신에서 도는 Claude Code 세션에 붙입니다. 실행·파일 접근은 로컬, 조종은 폰입니다.
- 컴퓨터에서
claude remote-control또는 이미 열린 세션에서/remote-control - 터미널 QR을 스캔하거나, 앱 Code 탭에서 세션 선택
앱에서 추가한 첨부 파일도 로컬 세션으로 내려가 @ 파일 참조로 Claude에 전달됩니다. 상세·트러블슈팅은 Remote Control을 보세요.
컴퓨터가 꺼져 있으면 클라우드 세션을 쓰세요. Remote Control·Dispatch는 로컬 머신(Claude Code 또는 Desktop)이 켜져 있어야 합니다. 슬립 후 Remote Control은 다시 온라인 되면 재연결됩니다.
푸시 알림
Remote Control이 활성일 때 긴 작업 완료·결정 요청 시 폰으로 푸시를 보낼 수 있습니다. 프롬프트에 notify me when the tests finish처럼 요청해도 됩니다. /config 토글과 전달 문제는 mobile push notifications을 보세요.
Dispatch가 띄운 Code 세션이 끝나거나 승인이 필요하면 Dispatch 자체 알림이 옵니다.
제한 사항
- 로컬 전용 명령:
/plugin,/resume등 터미널 UI에만 있는 명령은 앱에서 동작하지 않습니다. 모바일에서 되는 명령 목록은 Remote Control limitations을 참고하세요. - 권한 모드: 클라우드 세션은 Accept edits / Plan / Auto, Remote Control은 Manual / Accept edits / Plan. 앱에서는 Bypass permissions를 고를 수 없고, Remote Control에서는 Auto도 선택할 수 없습니다.
- Dispatch 플랜: Pro 또는 Max. Team/Enterprise에서는 불가.
관련 문서
- Platforms and integrations
- Claude Code on the web
- Remote Control
- Sessions from Dispatch
- Channels
- Claude Code in Slack
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스