27. 데스크톱 앱 시작하기
Desktop 앱 설치·첫 세션·변경사항 검토 등 빠른 시작 가이드
데스크톱 앱 시작하기
Claude Code를 데스크톱에 설치하고 첫 번째 코딩 세션을 시작하세요
데스크톱 앱은 그래픽 인터페이스를 갖춘 Claude Code를 제공합니다: 시각적 diff 리뷰, 실시간 앱 미리보기, 자동 병합이 가능한 GitHub PR 모니터링, Git worktree 격리를 통한 병렬 세션, 예약 작업, 그리고 원격으로 작업을 실행하는 기능이 포함되어 있습니다. 터미널이 필요 없습니다.
이 페이지에서는 앱 설치와 첫 번째 세션 시작 과정을 안내합니다. 이미 설정을 완료하셨다면, 전체 레퍼런스는 Claude Code Desktop 사용하기를 참고하세요.
데스크톱 앱에는 세 개의 탭이 있습니다:
- Chat: 파일 접근 없이 일반적인 대화를 할 수 있으며, claude.ai와 유사합니다.
- Cowork: 자체 환경이 갖춰진 클라우드 VM에서 작업을 수행하는 자율적인 백그라운드 에이전트입니다. 사용자가 다른 작업을 하는 동안에도 독립적으로 실행될 수 있습니다.
- Code: 로컬 파일에 직접 접근하는 대화형 코딩 어시스턴트입니다. 각 변경 사항을 실시간으로 검토하고 승인합니다.
Chat과 Cowork는 Claude Desktop 지원 문서에서 다루고 있습니다. 이 페이지에서는 Code 탭을 중점적으로 설명합니다.
참고: Claude Code를 사용하려면 Pro, Max, Teams 또는 Enterprise 구독이 필요합니다.
설치
Step 1: 앱 다운로드
사용 중인 플랫폼에 맞는 Claude를 다운로드하세요.
Windows ARM64의 경우, 여기에서 다운로드하세요.
Linux는 현재 지원되지 않습니다.
Step 2: 로그인
macOS에서는 응용 프로그램 폴더, Windows에서는 시작 메뉴에서 Claude를 실행하세요. Anthropic 계정으로 로그인합니다.
Step 3: Code 탭 열기
상단 중앙의 Code 탭을 클릭하세요. Code를 클릭했을 때 업그레이드 안내가 나타나면, 먼저 유료 플랜에 구독해야 합니다. 온라인 로그인 안내가 나타나면, 로그인을 완료하고 앱을 재시작하세요. 403 오류가 표시되면, 인증 문제 해결을 참고하세요.
데스크톱 앱에는 Claude Code가 포함되어 있습니다. Node.js나 CLI를 별도로 설치할 필요가 없습니다. 터미널에서 claude를 사용하려면, CLI를 별도로 설치하세요. CLI 시작하기를 참고하세요.
첫 번째 세션 시작하기
Code 탭을 연 상태에서, 프로젝트를 선택하고 Claude에게 할 일을 지시하세요.
Step 1: 환경 및 폴더 선택
로컬 파일을 직접 사용하여 내 컴퓨터에서 Claude를 실행하려면 Local을 선택하세요. Select folder를 클릭하고 프로젝트 디렉토리를 선택합니다.
팁: 잘 알고 있는 소규모 프로젝트로 시작하세요. Claude Code가 무엇을 할 수 있는지 가장 빠르게 확인하는 방법입니다. Windows에서는 로컬 세션이 동작하려면 Git이 설치되어 있어야 합니다. 대부분의 Mac에는 Git이 기본으로 포함되어 있습니다.
다음 옵션도 선택할 수 있습니다:
- Remote: 앱을 닫아도 계속 실행되는 Anthropic 클라우드 인프라에서 세션을 실행합니다. Remote 세션은 웹의 Claude Code와 동일한 인프라를 사용합니다.
- SSH: SSH를 통해 원격 머신(자체 서버, 클라우드 VM 또는 dev container)에 연결합니다. 원격 머신에 Claude Code가 설치되어 있어야 합니다.
Step 2: 모델 선택
전송 버튼 옆의 드롭다운에서 모델을 선택하세요. Opus, Sonnet, Haiku의 비교는 모델을 참고하세요. 세션이 시작된 후에는 모델을 변경할 수 없습니다.
Step 3: Claude에게 할 일 지시하기
Claude에게 원하는 작업을 입력하세요:
Find a TODO comment and fix itAdd tests for the main functionCreate a CLAUDE.md with instructions for this codebase
세션은 코드에 대한 Claude와의 대화입니다. 각 세션은 자체 컨텍스트와 변경 사항을 추적하므로, 여러 작업을 서로 간섭 없이 진행할 수 있습니다.
Step 4: 변경 사항 검토 및 수락
기본적으로 Code 탭은 Ask permissions 모드로 시작되며, Claude가 변경 사항을 제안하고 적용 전에 승인을 기다립니다. 다음 내용이 표시됩니다:
- 각 파일에서 정확히 무엇이 변경되는지 보여주는 diff 뷰
- 각 변경 사항을 승인하거나 거부하는 Accept/Reject 버튼
- Claude가 요청을 처리하는 과정의 실시간 업데이트
변경 사항을 거부하면, Claude가 어떻게 다르게 진행할지 물어봅니다. 승인하기 전까지 파일은 수정되지 않습니다.
다음 단계
첫 번째 편집을 완료했습니다. Desktop이 할 수 있는 모든 기능에 대한 전체 레퍼런스는 Claude Code Desktop 사용하기를 참고하세요. 다음으로 시도해 볼 만한 것들을 소개합니다.
중간에 개입하여 방향을 조정하세요. 언제든 Claude를 중단할 수 있습니다. 잘못된 방향으로 가고 있다면, 중지 버튼을 클릭하거나 수정 사항을 입력하고 Enter를 누르세요. Claude는 현재 작업을 중단하고 입력에 따라 조정합니다. 완료를 기다리거나 처음부터 다시 시작할 필요가 없습니다.
Claude에게 더 많은 컨텍스트를 제공하세요. 프롬프트 박스에 @filename을 입력하여 특정 파일을 대화에 포함시키고, 첨부 버튼을 사용하여 이미지와 PDF를 첨부하거나, 파일을 프롬프트에 직접 드래그 앤 드롭할 수 있습니다. Claude에게 더 많은 컨텍스트를 제공할수록 더 나은 결과를 얻을 수 있습니다. 파일 및 컨텍스트 추가를 참고하세요.
반복 작업에는 스킬을 사용하세요. /를 입력하거나 + → Slash commands를 클릭하여 내장 명령어, 커스텀 스킬, 플러그인 스킬을 탐색하세요. 스킬은 코드 리뷰 체크리스트나 배포 절차처럼 필요할 때마다 호출할 수 있는 재사용 가능한 프롬프트입니다.
커밋 전에 변경 사항을 검토하세요. Claude가 파일을 편집한 후 +12 -1 표시가 나타납니다. 이를 클릭하여 diff 뷰를 열고, 파일별로 수정 사항을 검토하며, 특정 줄에 코멘트를 남길 수 있습니다. Claude는 코멘트를 읽고 수정합니다. Review code를 클릭하면 Claude가 직접 diff를 평가하고 인라인 제안을 남깁니다.
제어 수준을 조정하세요. 권한 모드로 제어 수준의 균형을 맞출 수 있습니다. Ask permissions(기본값)는 매 편집 전에 승인을 요구합니다. Auto accept edits는 파일 편집을 자동으로 수락하여 더 빠른 반복 작업이 가능합니다. Plan mode는 파일을 건드리지 않고 Claude가 접근 방식을 설계하게 하며, 대규모 리팩토링 전에 유용합니다.
플러그인으로 더 많은 기능을 추가하세요. 프롬프트 박스 옆의 + 버튼을 클릭하고 Plugins를 선택하여 스킬, 에이전트, MCP 서버 등을 추가하는 플러그인을 탐색하고 설치하세요.
앱을 미리보기하세요. Preview 드롭다운을 클릭하여 데스크톱에서 직접 개발 서버를 실행하세요. Claude가 실행 중인 앱을 확인하고, 엔드포인트를 테스트하며, 로그를 검사하고, 보이는 내용을 기반으로 반복 작업할 수 있습니다. 앱 미리보기를 참고하세요.
Pull Request를 추적하세요. PR을 열면, Claude Code가 CI 체크 결과를 모니터링하고 실패를 자동으로 수정하거나 모든 체크가 통과하면 PR을 자동 병합할 수 있습니다. Pull Request 상태 모니터링을 참고하세요.
Claude에게 스케줄을 설정하세요. 예약 작업을 설정하여 Claude를 정기적으로 자동 실행하세요: 매일 아침 코드 리뷰, 주간 의존성 감사, 또는 연결된 도구에서 정보를 가져오는 브리핑 등을 설정할 수 있습니다.
준비가 되면 확장하세요. 사이드바에서 병렬 세션을 열어 각각 고유한 Git worktree에서 여러 작업을 동시에 진행하세요. 장시간 실행 작업을 클라우드로 보내 앱을 닫아도 계속 실행되게 하거나, 작업이 예상보다 오래 걸리면 웹이나 IDE에서 세션을 이어서 진행할 수 있습니다. GitHub, Slack, Linear 같은 외부 도구를 연결하여 워크플로우를 통합하세요.
CLI에서 전환하시나요?
Desktop은 CLI와 동일한 엔진을 그래픽 인터페이스로 실행합니다. 같은 프로젝트에서 두 가지를 동시에 실행할 수 있으며, 설정(CLAUDE.md 파일, MCP 서버, 훅, 스킬, 설정)을 공유합니다. 기능 비교, 플래그 대응표, Desktop에서 사용할 수 없는 기능에 대한 전체 비교는 CLI 비교를 참고하세요.
다음으로 볼 내용
- Claude Code Desktop 사용하기: 권한 모드, 병렬 세션, diff 뷰, 커넥터, 엔터프라이즈 설정
- 문제 해결: 일반적인 오류 및 설정 문제에 대한 해결 방법
- 모범 사례: 효과적인 프롬프트 작성 및 Claude Code 활용 극대화 팁
- 일반적인 워크플로우: 디버깅, 리팩토링, 테스트 등에 대한 튜토리얼