데스크탑 앱 시작하기

Claude Code 데스크탑 앱을 설치하고 첫 번째 코딩 세션을 시작하세요.

데스크탑 앱은 그래픽 인터페이스와 함께 Claude Code를 제공합니다: 시각적 diff 검토, 라이브 앱 미리보기, GitHub PR 모니터링, Git worktree 격리를 통한 병렬 세션, 원격으로 작업 실행 기능. 터미널이 필요 없습니다.

데스크탑 앱에는 세 가지 탭이 있습니다:

Chat: 파일 접근 없이 일반 대화 (claude.ai와 유사)
Cowork: 독립적으로 작동하는 클라우드 VM의 자율 백그라운드 에이전트
Code: 로컬 파일에 직접 접근하는 인터랙티브 코딩 어시스턴트

참고: Claude Code는 Pro, Max, Teams 또는 Enterprise 구독이 필요합니다.

설치

1단계: 앱 다운로드

플랫폼에 맞는 Claude를 다운로드하세요:

macOS: Intel 및 Apple Silicon 범용 빌드
Windows: x64 프로세서용

Linux는 현재 지원되지 않습니다.

2단계: 로그인

macOS는 응용 프로그램 폴더에서, Windows는 시작 메뉴에서 Claude를 실행하세요. Anthropic 계정으로 로그인합니다.

3단계: Code 탭 열기

상단 중앙의 Code 탭을 클릭합니다. 업그레이드를 요청하면 유료 플랜에 먼저 구독해야 합니다.

데스크탑 앱에는 Claude Code가 포함됩니다. Node.js나 CLI를 별도로 설치할 필요가 없습니다.

첫 번째 세션 시작하기

Code 탭을 열면 프로젝트를 선택하고 Claude에게 작업을 지시합니다.

1. 환경 및 폴더 선택

Local을 선택하면 로컬 머신에서 파일에 직접 접근하여 Claude가 실행됩니다. Select folder를 클릭하고 프로젝트 디렉토리를 선택합니다.

팁: 잘 알고 있는 소규모 프로젝트로 시작하세요. Claude Code가 무엇을 할 수 있는지 가장 빠르게 확인할 수 있습니다. Windows에서는 로컬 세션 작동을 위해 Git이 설치되어야 합니다.

다른 환경 옵션:

Remote: Anthropic의 클라우드 인프라에서 실행 (앱을 닫아도 계속 진행)
SSH: SSH를 통해 원격 머신에 연결

2. 모델 선택

전송 버튼 옆 드롭다운에서 모델을 선택합니다. Opus, Sonnet, Haiku 비교는 모델 설정을 참조하세요. 세션이 시작된 후에는 모델을 변경할 수 없습니다.

3. Claude에게 지시하기

원하는 것을 입력하세요:

TODO 댓글을 찾아서 수정해줘
main 함수에 테스트를 추가해줘
이 코드베이스를 위한 지시가 담긴 CLAUDE.md를 만들어줘

세션은 코드에 대한 Claude와의 대화입니다. 각 세션은 자체 컨텍스트와 변경 사항을 추적하므로 여러 작업을 서로 간섭 없이 작업할 수 있습니다.

4. 변경 사항 검토 및 수락

기본적으로 Code 탭은 Ask permissions 모드로 시작하며, Claude는 변경 사항을 제안하고 적용 전에 승인을 기다립니다:

각 파일에서 변경될 내용을 보여주는 diff 뷰
각 변경을 승인하거나 거부하는 Accept/Reject 버튼
Claude가 요청을 처리하는 동안의 실시간 업데이트

변경을 거부하면 Claude가 다르게 진행하는 방법을 묻습니다. 수락하기 전까지 파일이 수정되지 않습니다.

다음에 시도할 것들

중단 및 방향 전환. 언제든지 Claude를 중단할 수 있습니다. 잘못된 방향으로 가고 있다면 중지 버튼을 클릭하거나 수정 사항을 입력하고 Enter를 누르세요.

더 많은 컨텍스트 제공. 프롬프트 박스에 @파일명을 입력해 특정 파일을 대화에 포함하거나, 첨부 버튼으로 이미지와 PDF를 첨부하거나, 파일을 직접 드래그 앤 드롭하세요.

반복 가능한 작업에 스킬 사용. /를 입력하거나 + → Slash commands를 클릭해 내장 명령, 커스텀 스킬, 플러그인 스킬을 검색하세요.

커밋 전 변경 사항 검토. Claude가 파일을 편집한 후 +12 -1 표시가 나타납니다. 클릭해서 diff 뷰를 열고 파일별로 수정 사항을 검토합니다.

제어 수준 조정. 권한 모드로 균형을 조절합니다:

Ask permissions (기본): 모든 편집 전에 승인 필요
Auto accept edits: 더 빠른 반복을 위해 파일 편집 자동 수락
Plan mode: 파일을 건드리지 않고 접근 방식을 계획

앱 미리보기. Preview 드롭다운을 클릭해 데스크탑 내에서 직접 개발 서버를 실행합니다.

PR 추적. PR을 열고 나면 Claude Code가 CI 체크 결과를 모니터링하고 자동으로 실패를 수정하거나 모든 체크가 통과되면 PR을 병합할 수 있습니다.

병렬 세션. 사이드바에서 병렬 세션을 열어 각각 자체 Git worktree에서 여러 작업을 동시에 진행합니다.

CLI에서 오신 분들을 위해

데스크탑은 CLI와 동일한 엔진을 그래픽 인터페이스와 함께 실행합니다. 동일한 프로젝트에서 둘 다 동시에 실행할 수 있으며 설정을 공유합니다 (CLAUDE.md 파일, MCP 서버, 훅, 스킬, 설정).

다음 단계

Claude Code 데스크탑 사용하기 - 권한 모드, 병렬 세션, diff 뷰, 커넥터, 엔터프라이즈 설정
문제 해결 - 일반적인 오류 및 설정 문제 해결
모범 사례 - 효과적인 프롬프트 작성 팁
일반적인 워크플로우 - 디버깅, 리팩토링, 테스트 튜토리얼