Desktop 앱 빠른 시작 (공식)
기준일: 2026-07-26
공식 기준: Get started with the desktop app
개요
데스크톱 앱은 여러 세션을 나란히 돌리도록 설계된 GUI의 Claude Code입니다. 사이드바로 병렬 작업 관리, 드래그 앤 드롭 레이아웃, 통합 터미널·파일 에디터, visual diff, live app preview, GitHub PR 모니터링·auto-merge, scheduled tasks를 제공합니다. 터미널이 필수는 아닙니다.
다운로드:
- macOS — Intel·Apple Silicon universal
- Windows x64
- Windows ARM64
- Linux (beta): Claude Desktop on Linux — apt 또는 .deb
Claude Code에는 Pro, Max, Team, 또는 Enterprise 구독이 필요합니다.
이미 설치했다면 전체 레퍼런스 Use Claude Code Desktop을 보세요. 이 페이지는 설치와 첫 세션에 초점을 둡니다.
핵심 개념
| 탭 | 역할 |
|---|---|
| Chat | 파일 접근 없는 일반 대화 (claude.ai와 유사) |
| Cowork | 샌드박스 VM에서 독립 실행되는 자율 백그라운드 에이전트 (on-device 또는 Anthropic 관리 원격 VM) |
| Code | 로컬 파일에 직접 접근하는 인터랙티브 코딩 어시스턴트. 변경을 실시간 검토·승인 |
Chat·Cowork는 Claude Help Center, 데스크톱 설치·배치는 Claude Desktop support. 이 페이지는 Code 탭 중심입니다.
상세
설치
- 설치 및 로그인 — macOS·Windows는 위 링크로 설치. Linux는 desktop-linux. Applications/Start/런처에서 Claude 실행 후 Anthropic 계정 로그인.
- Code 탭 열기 — 상단 중앙 Code. 업그레이드 요청이면 유료 플랜. 온라인 로그인 요청이면 완료 후 앱 재시작. 403이면 인증 트러블슈팅.
데스크톱 앱에 Claude Code가 포함됩니다. Node.js·CLI 별도 설치는 필요 없습니다. 터미널에서 claude를 쓰려면 CLI를 별도 설치: CLI 빠른 시작.
첫 세션
환경과 폴더
- Local — 머신에서 파일을 직접 사용. Select folder로 프로젝트 선택. Windows 로컬 세션에는 Git 필요. 대부분의 Mac은 Git 기본 포함. 잘 아는 작은 프로젝트로 시작하는 것이 가장 빠릅니다.
- Cloud — Anthropic 클라우드에서 실행, 앱을 닫아도 계속. Claude Code on the web과 동일 인프라.
- SSH — 원격 머신(서버, 클라우드 VM, devcontainer 등). 첫 연결 시 Desktop이 원격에 Claude Code를 자동 설치.
- WSL (Windows) — WSL 2 배포판 안에서 세션. Claude Code·도구·git이 Linux 네이티브 경로로 실행.
모델
전송 버튼 옆 드롭다운에서 모델 선택. 비교는 models. 이후 같은 드롭다운에서 변경 가능.
할 일 지시 예
Find a TODO comment and fix itAdd tests for the main functionCreate a CLAUDE.md with instructions for this codebase
세션은 코드에 대한 대화 단위입니다. 컨텍스트·변경이 세션별로 분리되어 여러 작업을 간섭 없이 진행할 수 있습니다.
변경 검토·수락
기본은 Manual mode: Claude가 변경을 제안하고 적용 전 승인을 기다립니다.
- diff view로 파일별 변경 확인
- Accept/Reject
- 요청 진행에 따른 실시간 업데이트
거부하면 Claude가 다른 진행 방법을 묻습니다. Accept 전까지 파일은 수정되지 않습니다.
다음에 해볼 것
- 중단·조정 — stop 버튼으로 즉시 중단, 또는 실행 중 보정 텍스트를 Enter로 전송
- 컨텍스트 —
@filename, 첨부 버튼으로 이미지·PDF, 드래그 앤 드롭. Add files and context - 스킬 —
/또는 + → Slash commands로 내장 명령·custom skills·플러그인 스킬 - 커밋 전 검토 —
+12 -1표시 클릭 → diff, 줄 단위 코멘트. Review code로 Claude가 자체 인라인 제안 - 권한 모드 — Manual / Accept edits / Plan (permission modes)
- 플러그인 — + → Plugins
- 워크스페이스 배치 — chat/diff/terminal/file/browser 패널 드래그. 터미널 Ctrl+`
- 앱 미리보기 — dev 서버 실행 시 Browser pane. Preview your app
- PR 추적 — CI 실패 자동 수정·체크 통과 후 merge. Monitor pull request status
- 스케줄 — scheduled tasks
- 확장 — 병렬 세션·worktree, tasks pane, side chat, cloud 장기 작업, web/IDE 이어하기, GitHub·Slack·Linear 등 커넥터
CLI에서 온 경우
Desktop은 CLI와 같은 엔진에 GUI를 얹습니다. 같은 프로젝트에서 동시 사용 가능하고 CLAUDE.md, MCP, hooks, skills, settings를 공유합니다. 기능·플래그 대응·Desktop 미지원 항목: CLI comparison.
체크리스트
- Pro/Max/Team/Enterprise 구독으로 로그인했다
- Code 탭이 열리고 403이 없다
- Local(또는 Cloud/SSH/WSL) 환경과 프로젝트 폴더를 골랐다
- Manual mode에서 첫 변경을 Accept/Reject로 검토했다
- 터미널 CLI가 필요하면 별도 설치 경로를 인지했다
다음 단계
기준일
- 문서 작성·동기화 기준일: 2026-07-26
- 원문: https://code.claude.com/docs/en/desktop-quickstart