디스패치 (Dispatch)
공식 문서: https://code.claude.com/docs/ko/desktop (Sessions from Dispatch 섹션)
디스패치란?
디스패치(Dispatch)는 Claude 모바일 앱의 Cowork 탭에서 작업을 요청하면, Claude가 자동으로 적절한 방식(Code 세션 또는 Cowork)으로 라우팅(Routing, 작업을 알맞은 곳으로 보내는 것)하는 기능입니다.
쉽게 말해, 스마트폰에서 작업을 지시하면 데스크탑의 Claude가 알아서 처리합니다. 코딩 작업이면 데스크탑의 Code 모드로, 리서치 작업이면 Cowork 모드로 자동 분배됩니다.
핵심 포인트: 디스패치는 하나의 **지속적인 대화(Persistent Conversation)**를 유지합니다. 스마트폰에서 시작한 대화를 데스크탑에서 이어갈 수 있고, 전체 컨텍스트가 유지됩니다.
Dispatch 작업 흐름
작업 요청
코딩/리서치 분류
Git 워크트리 격리
분석, 번역
푸시 알림 수신
⚠️ 디스패치 세션의 앱 승인(Computer Use 등)은 30분 후 자동 만료 | Pro / Max 플랜 전용
왜 필요한가?
- 외출 중에도 스마트폰으로 개발 작업을 지시
- Claude가 코딩 작업인지 리서치 작업인지 자동 판단
- 코드 세션은 자동으로 **Git 워크트리(Worktree, 독립된 작업 디렉토리)**로 격리
- 작업 완료나 승인 필요 시 푸시 알림(Push Notification) 수신
- 내 데스크탑의 환경(커넥터, 플러그인, 파일 설정)을 그대로 활용
요구사항
| 항목 | 요구사항 |
|---|---|
| Claude Desktop | 최신 버전 (macOS 또는 Windows x64) |
| Claude 모바일 앱 | 최신 버전 (iOS 또는 Android) |
| 플랜 | Pro 또는 Max (Team/Enterprise에서는 사용 불가) |
| 네트워크 | 양쪽 기기 모두 인터넷 연결 |
| 데스크탑 상태 | 앱이 실행 중이고 컴퓨터가 깨어 있어야 함 |
데스크탑이 절전 모드이거나 앱이 닫혀 있으면 디스패치가 작동하지 않습니다. 컴퓨터를 켜 둘 수 없다면 클라우드 세션을 사용하세요.
설정 방법
- Claude Desktop 앱과 Claude 모바일 앱을 최신 버전으로 업데이트
- 모바일 또는 데스크탑에서 Cowork 탭 열기
- 왼쪽 사이드바에서 "Dispatch" 클릭
- "Get started" 클릭
- 파일 접근 권한과 컴퓨터 깨우기 설정 토글
- 설정 완료
Desktop 앱에서의 디스패치 세션
디스패치를 통해 생성된 Code 세션은 Desktop 앱의 사이드바에 Dispatch 배지와 함께 표시됩니다.
📋 사이드바
├── 💬 일반 대화
├── 💻 Code: 로그인 기능 구현
├── 🏷️ [Dispatch] 버그 수정: null 포인터 ← Dispatch 배지
├── 🏷️ [Dispatch] PR #42 리뷰 ← Dispatch 배지
└── ⚙️ 설정
Dispatch 세션의 특징:
- 사이드바에서 Dispatch 아이콘/배지로 구분됩니다
- 클릭하면 세션의 진행 상황을 실시간으로 확인할 수 있습니다
- Desktop에서 직접 세션에 개입하여 추가 지시를 내릴 수 있습니다
- 승인이 필요한 작업은 Desktop 알림과 모바일 푸시 알림 모두 표시됩니다
작업 라우팅
디스패치는 요청 내용에 따라 자동으로 적절한 모드를 선택합니다.
자동 라우팅 판단 기준
Claude는 다음 기준으로 요청을 Code 세션과 Cowork 중 하나로 분류합니다:
| 판단 신호 | Code 세션으로 라우팅 | Cowork으로 유지 |
|---|---|---|
| 키워드 | 코드, 버그, PR, 테스트, 빌드, 배포, 커밋 | 리서치, 분석, 요약, 작문, 번역 |
| 파일 언급 | .ts, .py, .java 등 코드 파일 | .md, .doc, 스프레드시트 |
| 도구 필요성 | Git, npm, 컴파일러, 린터 필요 | 웹 검색, 문서 편집 |
| 작업 성격 | 파일 시스템 변경이 필요 | 대화로 해결 가능 |
| 명시적 지시 | "코드를 수정해줘", "PR 만들어줘" | "알려줘", "설명해줘", "정리해줘" |
자동 라우팅이 잘못 판단하는 경우, 명시적으로 지시할 수 있습니다:
- Code로 보내기: "Claude Code 세션을 열고 ~해줘"
- Cowork에서 처리: "이건 코드 작업이 아니라 리서치야"
Code 세션으로 라우팅되는 작업
개발 관련 작업은 데스크탑의 Code 세션에서 실행됩니다:
- 버그 수정
- 의존성 업데이트
- 테스트 실행
- Pull Request 생성
- 코드 리뷰
Cowork으로 유지되는 작업
코딩이 아닌 작업은 Cowork 모드에서 처리됩니다:
- 리서치
- 문서 편집
- 스프레드시트 작업
- 작문 및 분석
디스패치 세션의 특성
| 항목 | 일반 Code 세션 | 디스패치 Code 세션 |
|---|---|---|
| 생성 방식 | 수동으로 시작 | 자동 생성 |
| 표시 | 일반 탭 | Dispatch 배지 표시 |
| 앱 승인 유효기간 | 세션 전체 | 30분 후 만료 |
| 알림 | 없음 | 푸시 알림 |
| 모니터링 | 터미널에서 직접 | 모바일에서 원격 |
| 컴퓨터 사용 | 설정에 따름 | 활성화 시 사용 가능 (30분 승인) |
세션 라이프사이클
📱 모바일에서 작업 요청
│
▼
🧠 디스패치 라우팅 엔진
│
├─ 코딩 작업으로 판단 ─────────────────────────┐
│ │
│ ┌───────────────────────────────────────┐ │
│ │ 💻 Code 세션 자동 생성 │ │
│ │ ├─ Git 워크트리 생성 (격리) │ │
│ │ ├─ 프로젝트 환경 로딩 │ │
│ │ └─ 작업 시작 │ │
│ └──────────┬────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────┐ │
│ │ ⚡ 작업 실행 중 │ │
│ │ ├─ 승인 필요? → 📱 푸시 알림 │ │
│ │ ├─ 에러 발생? → 📱 푸시 알림 │ │
│ │ └─ 완료? → 📱 완료 알림 │ │
│ └──────────┬────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────┐ │
│ │ ✅ 결과 반환 │ │
│ │ ├─ 모바일에서 결과 확인 │ │
│ │ └─ Desktop에서 세션 계속 가능 │ │
│ └───────────────────────────────────────┘ │
│ │
└─ 리서치 작업으로 판단 ──→ 🤝 Cowork에서 처리 │
Cowork에서 Code로의 전환
Dispatch가 작업을 Code 세션으로 라우팅하면:
- Cowork에서의 대화 컨텍스트는 Code 세션에 전달되지 않음
- Code 세션은 새로운 세션으로 시작됨
- Dispatch가 원래 요청 내용을 Code 세션의 초기 프롬프트로 전달
Code 세션이 잘못 생성되었거나 Cowork으로 처리해야 할 작업이 라우팅된 경우, 세션을 아카이브하고 Dispatch에서 다시 요청하세요. "이건 코드 작업이 아니라 리서치야"라고 명시하면 Cowork으로 처리됩니다.
승인 흐름
디스패치 세션에서 승인이 필요한 작업의 흐름입니다:
💻 Code 세션에서 작업 중
│
▼
🔒 위험한 동작 감지 (예: git push, 파일 삭제, MCP 도구 실행)
│
├─ 허용된 도구? → ✅ 자동 승인, 계속 진행
│
└─ 승인 필요? ──────────────────────────┐
│ │
▼ │
📱 모바일 푸시 알림 │
"버그 수정 세션에서 승인이 필요합니다" │
│ │
├─ 승인 → ✅ 작업 계속 │
├─ 거부 → ❌ 해당 동작 건너뛰기 │
└─ 무응답 (30분) → ⏰ 타임아웃 │
디스패치 세션의 앱 승인(Computer Use 등)은 30분 후 자동 만료됩니다. 장시간 작업은 Desktop에서 직접 세션을 열어 일반 세션으로 전환하세요.
사용 흐름
📱 스마트폰에서 작업 요청
│
▼
🧠 디스패치가 요청 분석
├─ 코딩 작업? → 💻 데스크탑에 Code 세션 자동 생성
└─ 리서치? → 🤝 Cowork 모드에서 처리
│
▼
⚙️ 데스크탑에서 작업 실행
│
▼
📱 완료 시 푸시 알림 → 결과 확인
팀 사용 시 고려사항
| 항목 | 설명 |
|---|---|
| 플랜 제한 | Dispatch는 Pro/Max 플랜 전용. Team/Enterprise에서는 사용 불가 |
| 개인 디바이스 | Dispatch는 개인 계정의 모바일-데스크탑 연결. 팀원 간 공유 불가 |
| 프로젝트 설정 공유 | .mcp.json, .claude/skills/ 등은 Git으로 공유하여 팀원 모두 동일한 환경 |
| 워크트리 격리 | Dispatch Code 세션은 별도 워크트리에서 실행되어 다른 팀원 작업과 충돌 없음 |
| 보안 | Dispatch 세션은 내 데스크탑에서 실행되므로 코드가 외부로 나가지 않음 |
| 대안 | 팀 전체 자동화가 필요하면 클라우드 세션 또는 CI/CD 연동 권장 |
- 긴급 대응: 개인이 외출 중 긴급 버그를 Dispatch로 처리
- 코드 리뷰: 이동 중 PR 리뷰를 Dispatch로 위임
- 모니터링: 각 팀원이 자신의 Desktop에서 스케줄 + Dispatch 조합 사용
- 공유 설정:
.mcp.json과 스킬을 Git으로 관리하여 팀 전체 일관성 유지
다른 원격 기능과 비교
| 기능 | 디스패치 | 원격 제어 | 클라우드 세션 |
|---|---|---|---|
| 트리거 | 모바일 앱 작업 요청 | 실행 중인 세션 제어 | 웹/터미널에서 시작 |
| 실행 위치 | 내 컴퓨터 (Desktop) | 내 컴퓨터 | 클라우드 |
| 로컬 파일 | ✅ 접근 가능 | ✅ 접근 가능 | ❌ Git 클론만 |
| 자동 생성 | ✅ | ❌ | ❌ |
| 컴퓨터 필요 | ✅ (깨어 있어야) | ✅ | ❌ |
| 플랜 | Pro, Max만 | Pro, Max, Team, Enterprise | Pro, Max, Team, Enterprise |
| 적합한 상황 | 외출 중 작업 위임 | 진행 중 작업 제어 | 로컬 환경 불필요 |
실전 활용 예시
외출 중 버그 수정 요청
"users API에서 null 포인터 에러가 발생하고 있어.
에러 로그를 확인하고 수정한 후 테스트를 실행해줘."
이동 중 PR 생성
"feature/user-profile 브랜치의 변경 사항을
main 브랜치로 PR 만들어줘. 설명도 작성해줘."
데이터 추출 및 정리
"이메일에서 이번 주 고객 피드백을 정리하고,
Slack에서 관련 논의를 찾아서 요약해줘."
로컬 파일 정리
"Downloads 폴더를 정리하고, 30일 이상 된
파일들을 날짜별 폴더로 분류해줘."
실전 예시: 출장 중 긴급 버그 수정
출장 중 프로덕션에서 긴급 버그가 발생했을 때 모바일에서 핫픽스를 처리하는 시나리오입니다.
1단계: 모바일에서 상황 파악 및 지시
프로덕션에서 결제 API가 500 에러를 반환하고 있어.
Sentry에서 최근 에러를 확인하고, 원인을 분석해서 수정해줘.
수정 후 테스트를 실행하고, 통과하면 hotfix/payment-500 브랜치로
PR을 만들어줘. PR 설명에 근본 원인과 수정 내용을 포함해줘.
2단계: Desktop에서 자동 실행
Claude가 자동으로:
- Sentry MCP로 에러 스택트레이스 확인
- 관련 코드 파일 분석
- 버그 원인 식별 및 수정
- 테스트 실행
- hotfix 브랜치 생성 및 PR 작성
3단계: 모바일 푸시 알림 수신
🔔 "결제 API 버그 수정 완료"
- 원인: PaymentService.processRefund()에서 null 체크 누락
- 수정: null guard 추가 + 에러 핸들링 개선
- PR #156 생성 완료
- 테스트 23/23 통과 ✅
4단계: 모바일에서 PR 확인 및 머지 지시
PR #156을 확인했어. 좋아 보여. 머지해줘.
실전 예시: 코드 리뷰 위임
이동 중 동료가 올린 PR의 코드 리뷰를 Dispatch로 위임하는 시나리오입니다.
모바일에서:
PR #89를 리뷰해줘. 다음 관점에서 검토해줘:
1. 보안 취약점 (SQL 인젝션, XSS 등)
2. 성능 문제 (N+1 쿼리, 불필요한 렌더링)
3. 우리 팀 코딩 컨벤션 준수 여부
4. 테스트 커버리지
심각한 문제가 있으면 Request Changes로,
사소한 것만 있으면 Approve로 리뷰해줘.
리뷰 코멘트는 한국어로 작성해줘.
결과 푸시 알림:
🔔 "PR #89 리뷰 완료 - Approve"
- 보안: 이슈 없음 ✅
- 성능: 1건 코멘트 (캐싱 제안)
- 컨벤션: 2건 코멘트 (네이밍)
- 테스트: 커버리지 85% (양호)
- GitHub에 리뷰 코멘트 3건 작성 완료
문제 해결
| 문제 | 원인 | 해결 |
|---|---|---|
| 작업을 보냈는데 아무 반응 없음 | Desktop 앱이 꺼져 있거나 절전 모드 | 앱 실행 확인, 절전 방지 설정 |
| Code 세션이 생성되지 않음 | Dispatch가 코딩 작업으로 인식 못 함 | "Claude Code 세션을 열고 ~해줘"로 명시 요청 |
| 세션이 파일을 찾지 못함 | 프로젝트 폴더 미설정 | Desktop에서 기본 프로젝트 폴더 설정 |
| 앱 승인이 30분 후 만료됨 | Dispatch 세션 보안 정책 | Desktop에서 세션을 직접 열어 일반 세션으로 작업 계속 |
| 푸시 알림이 안 옴 | 모바일 알림 설정 | 핸드폰 설정에서 Claude 앱 알림 허용 |
| Intel Mac에서 Dispatch 안 됨 | Cowork 탭은 Apple Silicon 전용 | Windows 사용 또는 Apple Silicon Mac 필요 |
| Cowork으로 가야 할 작업이 Code로 감 | 자동 라우팅 오판 | "이건 리서치 작업이야"로 명시하거나 세션 아카이브 후 재요청 |
| Desktop Dispatch 배지가 안 보임 | 앱 버전이 오래됨 | Claude Desktop 최신 버전으로 업데이트 |
Dispatch vs 원격 접근 기능 비교
모두 "다른 기기에서 Claude를 사용"하는 기능이지만, 각각 다른 상황에 최적화되어 있습니다.
| 기능 | 사용 시점 | 작업 유형 | 컴퓨터 필요 | 결과 확인 |
|---|---|---|---|---|
| Dispatch | 외출 중 작업 위임 | 코딩/리서치 모두 | 켜져 있어야 함 | 폰에서 결과 확인 |
| Remote Control | 기존 세션 이어보기 | 진행 중인 작업 확인 | 켜져 있어야 함 | 브라우저에서 실시간 |
| Cloud Sessions | 컴퓨터 없이 코딩 | 코딩 전용 (Git) | 불필요 | 웹에서 확인 |
Dispatch는 '비서에게 업무 지시'. Remote Control은 '원격 데스크탑으로 내 화면 보기'. Cloud Sessions는 '클라우드 컴퓨터 빌려쓰기'. 새 작업을 시킬 때는 Dispatch를, 진행 중인 작업을 보고 싶을 때는 Remote Control을, 컴퓨터를 아예 켜지 않고 싶을 때는 Cloud Sessions를 선택하세요.
연계 기능
장점, 단점과 한계점
장점
- 모바일에서 즉시 작업 위임: 스마트폰에서 한 줄 메시지로 버그 수정, PR 생성 등 개발 작업을 데스크탑에 위임할 수 있습니다
- 자동 Code/Cowork 라우팅: Claude가 요청 내용을 분석하여 코딩 작업은 Code 세션으로, 리서치 작업은 Cowork으로 자동 분배합니다
- 데스크탑 환경 그대로 활용: 로컬 파일, MCP 서버, 플러그인 등 데스크탑에 설정된 환경을 그대로 사용하므로 별도 설정이 불필요합니다
- 결과 알림: 작업 완료, 승인 필요, 에러 발생 시 모바일 푸시 알림을 받아 즉시 확인할 수 있습니다
단점과 한계점
- Pro/Max 플랜 전용: Team/Enterprise 플랜에서는 사용할 수 없어 팀 전체 활용이 어렵습니다
- 복잡한 작업 정확도 낮음: 여러 단계가 포함된 복잡한 작업은 자동 라우팅이 잘못 판단하거나 중간에 실패할 수 있습니다
- 승인 대기 시 중단: 위험한 동작(git push, 파일 삭제 등)에서 승인을 기다리며 세션이 멈추고, 30분 무응답 시 타임아웃됩니다
- 세션 시간 제한: 디스패치 세션의 앱 승인(Computer Use 등)은 30분 후 자동 만료되어 장시간 작업이 불편합니다
- 디버깅 어려움: 모바일에서 시작한 작업의 중간 과정을 상세히 추적하기 어렵고, 문제 발생 시 Desktop에서 직접 확인해야 합니다
자동 라우팅이 잘못 판단하면 "Claude Code 세션을 열고 ~해줘"처럼 명시적으로 지시하세요. 장시간 작업은 Desktop에서 세션을 직접 열어 일반 세션으로 전환하면 30분 승인 제한을 피할 수 있습니다.
다음 단계
네트워크 요구사항
Dispatch는 인터넷 연결이 필요합니다. 문제가 발생하면 다음을 확인하세요:
문제 진단:
# 환경 진단
claude doctor
# 지연시간 측정
ping -c 5 claude.ai # macOS/Linux
ping -n 5 claude.ai # Windows
네트워크 문제 해결:
- Wi-Fi → 유선 네트워크로 전환
- VPN 사용 시 VPN을 통한 라우팅 확인
- 방화벽 설정에서 Claude 앱 확인
세션 관리
세션 결과 확인
완료된 Dispatch 세션의 결과는 Desktop 앱의 사이드바에서 확인할 수 있습니다:
결과 확인:
- Desktop 앱의 사이드바에서 Dispatch 배지 확인
- 세션 클릭하여 전체 대화 내용 확인
- 생성된 커밋/파일 확인