데스크톱 앱 시작하기

데스크톱 앱은 그래픽 인터페이스를 갖춘 Claude Code를 제공합니다: 시각적 diff 검토, 라이브 앱 미리보기, GitHub PR 모니터링 및 자동 병합, Git worktree 격리를 통한 병렬 세션, 예약된 작업, 그리고 작업을 원격으로 실행할 수 있는 기능입니다. 터미널이 필요하지 않습니다. 이 페이지는 앱 설치 및 첫 번째 세션 시작을 안내합니다. 이미 설정되어 있다면 전체 참조는 Claude Code Desktop 사용을 참조하세요. 데스크톱 앱에는 세 개의 탭이 있습니다:

• Chat: 파일 접근이 없는 일반 대화로, claude.ai와 유사합니다.
• Cowork: 자신의 환경을 가진 클라우드 VM에서 작업을 수행하는 자율 백그라운드 에이전트입니다. 사용자가 다른 작업을 하는 동안 독립적으로 실행될 수 있습니다.
• Code: 로컬 파일에 직접 접근할 수 있는 대화형 코딩 어시스턴트입니다. 실시간으로 각 변경 사항을 검토하고 승인합니다.

Chat과 Cowork는 Claude Desktop 지원 문서에서 다룹니다. 이 페이지는 Code 탭에 중점을 둡니다.

​

설치

데스크톱 앱에는 Claude Code가 포함되어 있습니다. Node.js나 CLI를 별도로 설치할 필요가 없습니다. 터미널에서 claude를 사용하려면 CLI를 별도로 설치하세요. CLI 시작하기를 참조하세요.

​

첫 번째 세션 시작

Code 탭이 열려 있으면 프로젝트를 선택하고 Claude에게 할 일을 지시합니다.

​

이제 뭘 할까요?

첫 번째 편집을 완료했습니다. Desktop이 할 수 있는 모든 것에 대한 전체 참조는 Claude Code Desktop 사용을 참조하세요. 다음으로 시도할 수 있는 몇 가지 사항입니다. 중단 및 조정. 언제든지 Claude를 중단할 수 있습니다. 잘못된 방향으로 가고 있다면 중지 버튼을 클릭하거나 수정 사항을 입력하고 Enter를 누릅니다. Claude는 작업을 중단하고 입력에 따라 조정합니다. 완료될 때까지 기다리거나 다시 시작할 필요가 없습니다. Claude에게 더 많은 컨텍스트 제공. 프롬프트 상자에 @filename을 입력하여 특정 파일을 대화에 가져오거나, 첨부 버튼을 사용하여 이미지 및 PDF를 첨부하거나, 파일을 프롬프트에 직접 드래그 앤 드롭합니다. Claude가 더 많은 컨텍스트를 가질수록 결과가 더 좋습니다. 파일 및 컨텍스트 추가를 참조하세요. 반복 가능한 작업에 skills 사용. /를 입력하거나 + → Slash commands를 클릭하여 내장 명령, 사용자 정의 skills, 플러그인 skills를 찾아봅니다. Skills는 코드 검토 체크리스트나 배포 단계와 같이 필요할 때마다 호출할 수 있는 재사용 가능한 프롬프트입니다. 커밋하기 전에 변경 사항 검토. Claude가 파일을 편집한 후 +12 -1 표시기가 나타납니다. 이를 클릭하여 diff 보기를 열고, 파일별로 수정 사항을 검토하고, 특정 줄에 대해 댓글을 달 수 있습니다. Claude는 댓글을 읽고 수정합니다. Review code를 클릭하여 Claude가 diff를 평가하고 인라인 제안을 남기도록 합니다. 제어 수준 조정. 권한 모드는 균형을 제어합니다. Ask permissions(기본값)는 모든 편집 전에 승인이 필요합니다. Auto accept edits는 파일 편집을 자동으로 수락하여 더 빠른 반복을 가능하게 합니다. Plan mode는 Claude가 파일을 건드리지 않고 접근 방식을 계획하도록 하며, 이는 큰 리팩토링 전에 유용합니다. 더 많은 기능을 위해 플러그인 추가. 프롬프트 상자 옆의 + 버튼을 클릭하고 Plugins를 선택하여 skills, 에이전트, MCP servers 등을 추가하는 플러그인을 찾아보고 설치합니다. 앱 미리보기. Preview 드롭다운을 클릭하여 dev 서버를 데스크톱에서 직접 실행합니다. Claude는 실행 중인 앱을 보고, 엔드포인트를 테스트하고, 로그를 검사하고, 보는 것에 대해 반복할 수 있습니다. 앱 미리보기를 참조하세요. pull request 추적. PR을 연 후 Claude Code는 CI 확인 결과를 모니터링하고 실패를 자동으로 수정하거나 모든 확인이 통과되면 PR을 자동으로 병합할 수 있습니다. pull request 상태 모니터링을 참조하세요. Claude를 일정에 따라 실행. 예약된 작업을 설정하여 Claude를 정기적으로 자동으로 실행합니다: 매일 아침 일일 코드 검토, 주간 종속성 감사, 또는 연결된 도구에서 정보를 가져오는 브리핑입니다. 준비가 되면 확장. 사이드바에서 병렬 세션을 열어 여러 작업을 동시에 수행하며, 각각 자신의 Git worktree에서 실행합니다. 장기 실행 작업을 클라우드로 보내 앱을 닫아도 계속되도록 하거나, 작업이 예상보다 오래 걸리면 웹 또는 IDE에서 세션을 계속합니다. GitHub, Slack, Linear와 같은 외부 도구를 연결하여 워크플로우를 통합합니다.

​

CLI에서 오셨나요?

Desktop은 그래픽 인터페이스를 갖춘 CLI와 동일한 엔진을 실행합니다. 동일한 프로젝트에서 둘 다 동시에 실행할 수 있으며, 구성(CLAUDE.md 파일, MCP servers, hooks, skills, 설정)을 공유합니다. 기능, 플래그 동등물, Desktop에서 사용할 수 없는 것의 전체 비교는 CLI 비교를 참조하세요.

​

다음 단계

• Claude Code Desktop 사용: 권한 모드, 병렬 세션, diff 보기, 커넥터, 엔터프라이즈 구성
• 문제 해결: 일반적인 오류 및 설정 문제에 대한 해결책
• 모범 사례: 효과적인 프롬프트 작성 및 Claude Code 활용을 위한 팁
• 일반적인 워크플로우: 디버깅, 리팩토링, 테스트 등에 대한 튜토리얼