SpyBara
Go Premium

desktop-quickstart.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 55 additions and 69 deletions.

2026
Thu 1 23:59 Sun 4 23:58 Tue 6 23:59 Tue 13 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57 Fri 30 23:01

데스크톱 앱 시작하기

Claude 데스크톱 앱을 설치하고, 코드 탭을 열고, 컴퓨터의 프로젝트 폴더에서 첫 번째 Claude Code 세션을 시작합니다.

데스크톱 앱은 Claude Code를 그래픽 인터페이스와 함께 제공하므로, 컴퓨터의 폴더에 있는 코드에 대해 Claude에 작업을 요청하고 터미널을 사용하지 않고도 변경 사항을 검토할 수 있습니다. 이 페이지에서는 앱을 설치하고 코드 탭에서 첫 번째 세션을 시작하는 방법을 안내합니다. Claude Code는 Pro, Max, Team 또는 Enterprise 구독이 필요합니다.

macOS용 다운로드

Intel 및 Apple Silicon용 범용 빌드

Windows용 다운로드

x64 프로세서용

Linux용 Claude 다운로드(베타)

Ubuntu 및 Debian용 apt 또는 .deb

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

[!NOTE]

다음 경우는 다른 페이지에서 다룹니다:

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

  • Chat: 파일 접근 권한이 없는 일반 대화로, claude.ai와 유사합니다.
  • Cowork: 사용자가 다른 작업을 하는 동안 독립적으로 작업을 수행하는 자율 백그라운드 에이전트입니다.
  • Code: 로컬 파일에 직접 접근할 수 있는 대화형 코딩 어시스턴트입니다. 권한 모드에 따라 Claude가 제안하는 각 변경 사항을 승인하거나 Claude가 변경 사항을 만든 후 검토합니다.

Chat과 Cowork는 Claude 도움말 센터에서 다루고 있으며, 데스크톱 앱 설치 및 배포는 Claude 데스크톱 지원 문서에서 다룹니다. 이 페이지는 코드 탭에 중점을 둡니다.

설치

1. 설치 및 로그인

macOS와 Windows에서는 위의 링크에서 설치 프로그램을 다운로드하고 실행합니다. Linux에서는 Linux의 Claude Desktop에서 설치 단계를 따릅니다. macOS의 Applications 폴더, Windows의 Start 메뉴 또는 Linux의 애플리케이션 런처에서 Claude를 실행한 다음 Anthropic 계정으로 로그인합니다.

2. Code 탭 열기

상단 중앙의 Code 탭을 클릭합니다. Code를 클릭할 때 업그레이드를 요청하는 메시지가 나타나면 먼저 유료 요금제를 구독해야 합니다. 온라인 로그인을 요청하는 메시지가 나타나면 로그인을 완료하고 앱을 다시 시작합니다. 403 오류가 표시되면 인증 문제 해결을 참조하세요.

데스크톱 앱에는 Claude Code가 포함되어 있으므로 Code 탭을 사용하기 위해 Node.js나 CLI를 설치할 필요가 없습니다.

첫 번째 세션 시작하기

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

1. 환경 및 폴더 선택

프롬프트 상자 아래의 행에서 첫 번째 컨트롤인 환경 선택기를 클릭하고 Local 그룹의 맨 위 항목을 선택합니다. 그런 다음 환경 선택기 옆의 프로젝트 폴더 컨트롤을 클릭하고 **Open folder…**를 선택한 후 프로젝트 디렉토리를 선택합니다.

프롬프트 상자 아래에 환경 선택기가 표시되지 않으면 이전 레이아웃을 사용하고 있는 것입니다. 사용 중인 레이아웃 확인을 참조하십시오.

[!TIP]

잘 알고 있는 작은 프로젝트부터 시작하십시오. Claude Code가 무엇을 할 수 있는지 가장 빠르게 확인할 수 있는 방법입니다.

다음을 선택할 수도 있습니다:

  • Cloud: 앱을 닫아도 계속되는 클라우드에서 세션을 실행합니다. 클라우드 세션이 어떻게 작동하는지는 웹의 Claude Code를 참조하십시오.
  • SSH: SSH를 통해 원격 머신(예: 자신의 서버, 클라우드 VM 또는 개발 컨테이너)에 연결합니다. 먼저 연결을 추가하십시오. Desktop은 처음 연결할 때 원격 머신에 Claude Code를 자동으로 설치합니다. 실행 중인 작업은 Desktop 연결이 끊어진 동안에도 계속 진행될 수 있지만, Claude 계정을 사용하는 경우 로그인이 만료되면 중지될 수 있습니다.
  • WSL (Windows): WSL 2 배포판 내에서 세션을 실행합니다. Claude Code, 도구 및 git은 Linux 측에서 기본 경로로 실행됩니다.

2. 모델 선택

프롬프트 상자 아래 행의 오른쪽 끝 부근에 있는 모델 선택기에서 모델을 선택합니다. 사용 가능한 모델의 비교는 models를 참조하십시오. 나중에 모델 선택기에서 모델을 변경할 수 있습니다.

3. Claude에게 작업 지시

Claude가 수행할 작업을 입력합니다:

  • Find a TODO comment and fix it
  • Add tests for the main function
  • Create a CLAUDE.md with instructions for this codebase

session은 코드에 대한 Claude와의 대화입니다. 각 세션은 자신의 컨텍스트와 변경 사항을 추적합니다.

4. 변경 사항 검토 및 수락

프롬프트 상자 아래 행에서 permission mode를 확인하여 Claude가 승인을 기다리는지 확인합니다:

  • Auto or Accept edits: Claude가 파일 변경 사항을 적용하고 +12 -1과 같은 표시기가 나타나므로 diff 보기에서 검토할 수 있습니다.
  • Manual: Claude는 각 변경 사항을 제안하고 적용하기 전에 승인을 기다립니다.

Manual 모드에서는 다음을 볼 수 있습니다:

  1. 각 파일에서 정확히 무엇이 변경될지 보여주는 diff view
  2. 각 변경 사항을 승인하거나 거부하는 Accept/Reject 버튼
  3. Claude가 요청을 처리하는 동안 실시간 업데이트

이제 어떻게 할까요?

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

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

Claude에 더 많은 컨텍스트 제공. 프롬프트 상자에 @filename을 입력하여 특정 파일을 대화에 가져옵니다. Claude가 더 많은 컨텍스트를 가질수록 결과가 더 좋습니다. 파일 및 컨텍스트 추가를 참조하세요.

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

커밋하기 전에 변경 사항 검토. Claude가 파일을 편집한 후 +12 -1 표시기가 나타납니다. 이를 클릭하여 diff 보기를 열고, 파일별로 수정 사항을 검토하고, 특정 줄에 대해 댓글을 달 수 있습니다. Claude는 사용자의 댓글을 읽고 수정합니다. Claude가 변경 사항을 직접 리뷰하도록 하려면 프롬프트 상자에 /code-review를 입력하세요.

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

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

더 많은 기능을 위해 플러그인 추가. 스킬, 에이전트, MCP 서버 등을 추가하는 플러그인을 설치합니다.

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

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

풀 리퀘스트 추적. PR을 연 후 Claude Code는 CI 확인 결과를 모니터링하고 실패를 자동으로 수정할 수 있습니다. 풀 리퀘스트 상태 모니터링을 참조하세요.

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

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

다음 단계