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	O (베타, apt 설치)

설정 공유

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 세션만)
Linux (베타): Anthropic apt 저장소 등록 후 sudo apt update && sudo apt install claude-desktop (Ubuntu 22.04+/Debian 12+, x86_64·arm64). Chat·Cowork·Code 탭 모두 사용 가능하나 Computer Use와 음성 입력은 아직 미지원. .deb 직접 설치도 가능하지만 자동 업데이트는 apt 저장소 등록 시에만 제공

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

2. 세션 시작 전 설정

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

설정	설명
환경	Local(내 PC), Remote(클라우드), SSH(원격 서버), WSL(Windows의 WSL 2 배포판)
프로젝트 폴더	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는 가장 정밀한 도구부터 시도합니다:

Connector (Slack, Calendar 등 전용 연동)
Bash (셸 명령)
Claude in Chrome (브라우저 작업)
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
    }
  ]
}

인앱 브라우저 (외부 사이트 탐색)

앱 프리뷰에 쓰이는 Browser 패널은 탭 브라우저이기도 합니다. 실행 중인 앱 옆에 문서, 이슈 트래커 같은 외부 사이트를 나란히 열 수 있습니다:

열기: Cmd+Shift+B(macOS) / Ctrl+Shift+B(Windows) 또는 Views 메뉴
채팅의 외부 링크 클릭 시 Open in app(Browser 패널) / Default browser(내 브라우저) 선택 가능
Claude가 외부 페이지를 읽고 조작할 수 있음 — 단, 클릭·입력 같은 쓰기 동작은 권한 모드와 무관하게 안전 분류기가 검토하고, 사이트마다 첫 조작 시 승인 프롬프트(Allow once / Always allow / Deny)가 표시됨
Browser 패널은 개인 브라우저와 분리된 깨끗한 프로필을 사용. 로그인된 내 계정으로 작업하려면 Claude in Chrome 확장을 사용

비주얼 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
WSL	Windows에서 WSL 2 배포판 내부에서 세션 실행 (아래 참조)

WSL 세션 (Windows)

Windows에서는 환경 피커의 WSL 섹션에서 설치된 WSL 2 배포판을 선택해 세션을 시작할 수 있습니다. Claude Code 프로세스, 도구, git이 모두 배포판 내부에서 Linux 경로(/home/you/project)로 실행됩니다. 리포지토리가 배포판 파일시스템 안에 있다면 WSL 세션을 사용하세요 — Windows 쪽에서 접근하면 네트워크 파일시스템을 거쳐 느리고 파일 감시가 깨집니다.

요구사항: Windows 10/11 + WSL 2 (WSL 1 미지원), 설치된 배포판 1개 이상, 배포판 내부에 git 설치
폴더 신뢰(trust)는 배포판·폴더 단위로 별도 부여 — 같은 경로라도 다른 배포판이나 Windows 쪽에는 적용되지 않음
병렬 세션, 사이드 챗, 비주얼 diff 리뷰, 브랜치/PR 상태, Worktree 모두 배포판 내부 git 기반으로 동작

WSL 세션 미지원 기능

통합 터미널, Connectors·플러그인, 세션 포크, 파일 브라우저 패널, @ 파일 자동완성은 아직 WSL 세션에서 사용할 수 없습니다.

Connectors

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

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

슬래시 커맨드와 플러그인

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

다른 환경으로 전환

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

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

이 페이지에 오류가 있나요? 오류 제보하기 →

CLI vs Desktop​

시작하기​

1. 설치​

2. 세션 시작 전 설정​

3. 프롬프트 입력​

Desktop 앱의 3개 탭​

Cowork Dispatch​

Computer Use (Research Preview)​

핵심 기능 (Code 탭)​

앱 프리뷰​

인앱 브라우저 (외부 사이트 탐색)​

비주얼 Diff 리뷰​

PR 모니터링​

병렬 세션​

예약 작업 (Scheduled Tasks)​

환경별 특징​

WSL 세션 (Windows)​

Connectors​

슬래시 커맨드와 플러그인​

다른 환경으로 전환​