Desktop 앱

CLI가 익숙하지 않거나 시각적인 작업 환경을 선호한다면, Claude Code Desktop 앱을 사용할 수 있습니다. CLI와 동일한 엔진을 GUI로 감싼 것으로, 비주얼 diff, 앱 프리뷰, 병렬 세션 같은 추가 기능을 제공합니다.

CLI vs Desktop

기능	CLI	Desktop
파일 수정/명령 실행	O	O
CLAUDE.md, MCP, Hooks, Skills	O	O (공유)
비주얼 diff 리뷰	-	O
앱 프리뷰 (내장 브라우저)	-	O
이미지/PDF 첨부	-	O
병렬 세션 (자동 Worktree)	수동	O (자동)
예약 작업 (Scheduled Tasks)	cron/CI	O (GUI)
Connectors (Slack, Linear 등)	-	O
@파일 자동완성	-	O
Cowork + Dispatch (모바일→데스크톱)	-	O
헤드리스/자동화	O	-
Agent Teams	O (CLI/SDK)	-
Bedrock/Vertex/Foundry	O	-
Linux	O	-

설정 공유

Desktop과 CLI는 CLAUDE.md, MCP 서버(~/.claude.json, .mcp.json), Hooks, Skills, settings를 공유합니다. 어느 쪽에서 설정해도 양쪽에 적용됩니다. 단, claude_desktop_config.json(Chat 앱용)은 별도입니다.

시작하기

1. 설치

Claude Desktop 앱에서 Code 탭으로 접근합니다:

• macOS: claude.ai/download에서 다운로드 (Intel + Apple Silicon 모두 지원, 단 Cowork 탭은 Apple Silicon 전용)
• Windows: 같은 링크에서 다운로드 (x64 완전 지원, ARM64는 Remote 세션만)

Pro, Max, Team, Enterprise 플랜이 필요합니다.

2. 세션 시작 전 설정

세션을 시작하기 전에 4가지를 설정합니다:

설정	설명
환경	Local(내 PC), Remote(클라우드), SSH(원격 서버)
프로젝트 폴더	Claude가 작업할 디렉토리 또는 리포지토리
모델	Sonnet, Opus, Haiku 중 선택 (세션 시작 후 변경 불가)
권한 모드	Claude의 자율성 수준 (세션 중 변경 가능)

3. 프롬프트 입력

• 프롬프트 박스에 작업을 입력하고 Enter
• @파일명으로 파일을 컨텍스트에 추가 (자동완성 지원)
• 이미지, PDF를 드래그&드롭 또는 첨부 버튼으로 추가
• 작업 중 언제든 중단 버튼이나 수정 입력으로 방향 전환

Desktop 앱의 3개 탭

탭	역할
Chat	일반 대화 (claude.ai와 동일, 파일 접근 없음)
Cowork	자율적으로 백그라운드 작업하는 에이전트. Dispatch 기능으로 모바일에서 작업 할당 가능
Code	로컬 파일에 직접 접근하여 실시간으로 코드 수정. 변경사항을 리뷰하고 승인

Cowork Dispatch

모바일 앱에서 작업을 보내면 데스크톱 PC의 Claude가 처리하는 기능입니다:

• 설정: Cowork 탭 → 좌측 패널의 Dispatch → Get started → 파일 접근 권한/절전 설정 구성
• 활용 예시: 로컬 스프레드시트 데이터 추출, Slack/이메일 검색 후 브리핑 작성, Google Drive 파일로 프레젠테이션 생성
• 제한: 데스크톱이 켜져 있어야 작동, 단일 스레드만 사용, 작업 완료 알림 없음

Cowork 탭 제한

• macOS: Apple Silicon(M1 이상)에서만 사용 가능. Intel Mac은 Chat/Code만 지원
• Windows: 모든 하드웨어에서 사용 가능
• Pro 또는 Max 플랜 필요

Computer Use (Research Preview)

Claude가 마우스, 키보드, 화면을 직접 조작하여 앱을 열고, 클릭하고, 입력하는 기능입니다. Connector나 Bash로 처리할 수 없는 GUI 전용 작업에 사용합니다.

macOS 전용

Computer Use는 현재 macOS에서만 사용 가능합니다. Windows는 향후 지원 예정입니다. Pro 또는 Max 플랜 필요.

Desktop에서 활성화: Settings > Desktop app > General > Computer use 토글 → macOS 권한 2개 부여 (접근성 + 화면 기록)

CLI에서 활성화 (v2.1.85+): /mcp → computer-use 서버 선택 → Enable. Desktop 없이 터미널에서도 동일한 화면 조작이 가능합니다.

	Desktop	CLI
플랫폼	macOS, Windows	macOS만
활성화	Settings 토글	/mcp에서 Enable
Denied apps	설정 가능	미지원
Dispatch 연동	가능	불가

도구 우선순위 — Claude는 가장 정밀한 도구부터 시도합니다:

1. Connector (Slack, Calendar 등 전용 연동)
2. Bash (셸 명령)
3. Claude in Chrome (브라우저 작업)
4. Computer Use (위 방법이 없을 때 최후 수단)

앱별 권한 티어:

티어	가능한 조작	대상
View only	스크린샷만	브라우저, 트레이딩 플랫폼
Click only	클릭, 스크롤 (타이핑 불가)	터미널, IDE
Full control	클릭, 타이핑, 드래그, 단축키	기타 모든 앱

• 처음 접근하는 앱마다 승인 프롬프트가 나타납니다
• Dispatch로 생성된 세션의 앱 승인은 30분 후 만료됩니다
• Settings > Desktop app > General > Denied apps에서 특정 앱을 사전 차단할 수 있습니다

이 플레이북에서 다루는 내용은 주로 Code 탭입니다.

핵심 기능 (Code 탭)

앱 프리뷰

Desktop은 dev 서버를 자동으로 시작하고 내장 브라우저로 결과를 보여줍니다:

• Auto-verify(기본 활성): Claude가 코드를 수정하면 자동으로 변경 확인 (스크린샷, DOM 검사, 클릭, 폼 입력). .claude/launch.json에서 "autoVerify": false로 비활성화 가능
• 쿠키와 localStorage가 재시작 후에도 유지 (Persist sessions 옵션)
• Preview 드롭다운에서 서버 설정 편집 가능

프리뷰 서버 설정은 .claude/launch.json에 저장합니다:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

비주얼 Diff 리뷰

코드 변경사항을 파일별로 시각적으로 검토합니다:

• 특정 줄을 클릭하여 인라인 코멘트 추가
• Cmd+Enter(macOS) / Ctrl+Enter(Windows)로 코멘트 일괄 제출
• Review code 버튼으로 Claude에게 변경사항 평가 요청 (컴파일 에러, 로직 에러, 보안 취약점, 명백한 버그에 집중)

PR 모니터링

PR을 열면 CI 상태 바가 나타납니다:

• Auto-fix: CI 체크 실패 시 Claude가 자동 수정
• Auto-merge: 모든 체크 통과 시 자동 머지

GitHub CLI(gh)가 설치되고 인증되어 있어야 합니다.

병렬 세션

+ New session으로 여러 작업을 동시에 진행합니다. Git 리포지토리에서는 각 세션이 자동으로 Worktree로 격리되어 서로 영향을 주지 않습니다.

예약 작업 (Scheduled Tasks)

사이드바의 Schedule에서 반복 작업을 설정합니다:

• Manual: 수동 실행 전용 (프롬프트 저장)
• Hourly / Daily / Weekdays / Weekly: 시간과 빈도 선택
• 앱이 열려 있고 컴퓨터가 깨어 있어야 실행됨
• 놓친 실행은 7일 이내라면 앱 시작 시 1회 보충 실행
• 각 작업에 독립적인 권한 모드 설정 가능

일간 코드 리뷰, 의존성 업데이트 점검, 아침 브리핑 등에 활용합니다.

환경별 특징

환경	특징
Local	셸 환경변수 상속, Extended Thinking 기본 활성
Remote	앱 닫아도 백그라운드 실행, 구독에 포함 (추가 비용 없음). 멀티 리포지토리 지원
SSH	원격 머신에서 실행, Claude Code가 원격에 설치되어 있어야 함. 연결 설정: 환경 드롭다운 → + Add SSH connection

Connectors

프롬프트 박스의 + → Connectors에서 외부 도구를 연결합니다:

• GitHub, Slack, Linear, Notion, Google Calendar 등
• Remote 세션에서는 사용 불가

슬래시 커맨드와 플러그인

• /를 입력하면 빌트인 커맨드, 커스텀 Skills, 플러그인 Skills 표시
• + → Plugins에서 플러그인 설치/관리

다른 환경으로 전환

툴바 오른쪽 하단의 Continue in 메뉴에서:

• Claude Code on the Web으로 이동
• 지원되는 IDE에서 열기