데스크톱 앱 시작하기

데스크톱에 Claude Code를 설치하고 첫 번째 코딩 세션을 시작합니다

데스크톱 앱은 여러 세션을 나란히 실행하도록 구축된 그래픽 인터페이스를 갖춘 Claude Code를 제공합니다: 병렬 작업을 관리하기 위한 사이드바, 통합 터미널 및 파일 편집기가 있는 드래그 앤 드롭 레이아웃, 시각적 diff 검토, 라이브 앱 미리보기, GitHub PR 모니터링 및 자동 병합, 그리고 예약된 작업입니다. 터미널이 필요하지 않습니다.

Windows ARM64의 경우 ARM64 설치 프로그램을 다운로드하십시오. Linux에서는 apt로 설치하십시오. Linux의 Claude Desktop을 참조하십시오.

이 페이지는 앱 설치 및 첫 번째 세션 시작을 안내합니다. 이미 설정되어 있다면 전체 참조는 Claude Code Desktop 사용을 참조하세요.

데스크톱 앱에는 세 개의 탭이 있습니다:

• Chat: 파일 접근이 없는 일반 대화로, claude.ai와 유사합니다.
• Cowork: 자신의 환경을 가진 샌드박스 가상 머신에서 작업을 수행하는 자율 백그라운드 에이전트입니다. 사용자가 다른 작업을 하는 동안 독립적으로 실행됩니다. 온디바이스 Cowork 세션은 컴퓨터에서 VM을 실행하고, 원격 Cowork 세션은 대신 Anthropic 관리 VM에서 실행됩니다.
• Code: 로컬 파일에 직접 접근할 수 있는 대화형 코딩 어시스턴트입니다. 실시간으로 각 변경 사항을 검토하고 승인합니다.

Chat과 Cowork는 Claude 도움말 센터에서 다룹니다. 데스크톱 앱 설치 및 배포는 Claude Desktop 지원 문서에서 다룹니다. 이 페이지는 Code 탭에 중점을 둡니다.

설치

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

첫 번째 세션 시작하기

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

이제 어떻게 할까요?

첫 번째 편집을 완료했습니다. Claude Code Desktop이 할 수 있는 모든 기능에 대한 전체 참고 자료는 Claude Code Desktop 사용을 참조하세요. 다음에 시도해 볼 수 있는 몇 가지 사항입니다.

중단 및 방향 조정. 언제든지 Claude를 리디렉션할 수 있습니다. 중지 버튼을 클릭하여 즉시 중단하거나, 수정 사항을 입력하고 Enter를 눌러 실행 중인 작업을 중지하지 않고 전송할 수 있습니다. 어느 쪽이든 완료될 때까지 기다리거나 다시 시작할 필요가 없습니다.

Claude에 더 많은 컨텍스트 제공. 프롬프트 상자에 @filename을 입력하여 특정 파일을 대화에 가져오거나, 첨부 버튼을 사용하여 이미지 및 PDF를 첨부하거나, 파일을 프롬프트에 직접 드래그 앤 드롭할 수 있습니다. Claude가 더 많은 컨텍스트를 가질수록 결과가 더 좋습니다. 파일 및 컨텍스트 추가를 참조하세요.

반복 가능한 작업에 스킬 사용. /를 입력하거나 + → Slash commands를 클릭하여 기본 제공 명령어, 사용자 정의 스킬 및 플러그인 스킬을 찾아봅니다. 스킬은 코드 검토 체크리스트 또는 배포 단계와 같이 필요할 때마다 호출할 수 있는 재사용 가능한 프롬프트입니다.

커밋하기 전에 변경 사항 검토. Claude가 파일을 편집한 후 +12 -1 표시기가 나타납니다. 이를 클릭하여 diff 보기를 열고, 파일별로 수정 사항을 검토하고, 특정 줄에 대해 댓글을 달 수 있습니다. Claude는 사용자의 댓글을 읽고 수정합니다. Review code를 클릭하여 Claude가 diff를 직접 평가하고 인라인 제안을 남기도록 할 수 있습니다.

제어 수준 조정. 권한 모드는 Claude가 승인을 요청하지 않고 수행할 수 있는 작업의 양을 설정합니다:

• Auto: 분류기가 백그라운드에서 작업을 검토하고 사용자에게 묻는 대신 위험한 작업을 차단합니다.
• Manual: Claude는 파일을 편집하거나 명령어를 실행하기 전에 요청합니다.
• Accept edits: Claude는 더 빠른 반복을 위해 파일 편집을 자동으로 수락합니다.
• Plan: Claude는 파일을 편집하지 않고 접근 방식을 제안하며, 이는 대규모 리팩토링 전에 유용합니다.

더 많은 기능을 위해 플러그인 추가. 프롬프트 상자 옆의 + 버튼을 클릭하고 Plugins를 선택하여 스킬, 에이전트, MCP 서버 등을 추가하는 플러그인을 찾아보고 설치합니다.

작업 공간 정렬. 채팅, diff, 터미널, 파일 및 브라우저 창을 원하는 레이아웃으로 드래그합니다. **Ctrl+`**를 사용하여 터미널을 열어 세션과 함께 명령어를 실행하거나, 파일 경로를 클릭하여 파일 창에서 열 수 있습니다. 작업 공간 정렬을 참조하세요.

앱 미리보기. 데스크톱에서 개발 서버를 실행하면 앱이 브라우저 창에서 열리며, 이는 외부 사이트를 열 수도 있습니다. Claude는 실행 중인 앱을 보고, 엔드포인트를 테스트하고, 로그를 검사하고, 보는 것에 대해 반복할 수 있습니다. 앱 미리보기를 참조하세요.

풀 요청 추적. PR을 연 후 Claude Code는 CI 확인 결과를 모니터링하고 실패를 자동으로 수정하거나 모든 확인이 통과되면 PR을 병합할 수 있습니다. 풀 요청 상태 모니터링을 참조하세요.

Claude를 일정에 따라 실행. 예약된 작업을 설정하여 Claude를 정기적으로 자동으로 실행합니다: 매일 아침 일일 코드 검토, 주간 종속성 감사 또는 연결된 도구에서 정보를 가져오는 브리핑입니다.

준비가 되면 확장. 사이드바에서 병렬 세션을 열어 여러 작업을 동시에 수행하고, 각각 자체 Git worktree에서 실행하고, 작업 창을 열어 세션이 실행 중인 서브에이전트 및 백그라운드 명령어를 봅니다. 사이드 채팅을 열어 메인 스레드를 방해하지 않고 질문을 할 수 있습니다. 장기 실행 작업을 클라우드로 전송하여 앱을 닫아도 계속 실행되도록 하거나, 작업이 예상보다 오래 걸리면 웹 또는 IDE에서 세션을 계속할 수 있습니다. GitHub, Slack 및 Linear와 같은 외부 도구를 연결하여 워크플로우를 통합합니다.

다음 단계

• Claude Code Desktop 사용하기: 권한 모드, 병렬 세션, diff 보기, 커넥터 및 엔터프라이즈 구성
• CLI에서 전환하시나요?: Desktop과 CLI를 동일한 프로젝트에서 실행하고, 기능, 플래그 동등물 및 Desktop에서 사용할 수 없는 기능을 비교합니다
• 문제 해결: 일반적인 오류 및 설정 문제에 대한 해결책
• 모범 사례: 효과적인 프롬프트 작성 및 Claude Code를 최대한 활용하기 위한 팁
• 일반적인 워크플로우: 디버깅, 리팩토링, 테스트 등에 대한 튜토리얼