# 설치 (/ko/docs/verdent-manager/getting-started/installation)

> Verdent 설치 및 설정을 위한 단계별 가이드



이 가이드는 Verdent를 다운로드하고, 플랫폼별 설치를 완료한 뒤, Verdent 계정으로 인증하는 과정을 안내합니다.

***

## 요구 사항 [#요구-사항]

Verdent를 설치하기 전에 시스템이 다음 사전 요구 사항을 충족하는지 확인합니다.

### 시스템 요구 사항 [#시스템-요구-사항]

* **운영 체제**: macOS 11 이상 또는 Windows 10 이상(64비트). 전체 호환성 정보는 [지원되는 운영 체제](/docs/verdent-manager/getting-started/supported-operating-systems)를 참고하세요.
* **Git**: 버전 2.20 이상. Verdent는 워크스페이스 격리를 위해 Git worktree를 사용합니다. 프로젝트 폴더가 Git 저장소일 필요는 없지만, 일부 기능에는 Git가 필요하며, 필요한 경우 Verdent가 저장소 초기화를 안내할 수 있습니다.
  * **macOS:** Git는 Xcode Command Line Tools에 포함되어 제공됩니다. `xcode-select --install`로 설치하거나 Homebrew를 사용합니다: `brew install git`.
  * **Windows:** [git-scm.com/download/win](https://git-scm.com/download/win)에서 공식 설치 프로그램을 다운로드하고 기본 옵션을 그대로 사용합니다.
  * 터미널에서 `git --version`로 확인합니다.
* **인터넷 연결**: AI 서비스와 통신하려면 활성 인터넷 연결이 필요합니다.

### 선택 사항이지만 권장 [#선택-사항이지만-권장]

* **디스크 공간**: 최소 2GB의 여유 공간(대형 저장소, worktree, 캐싱을 위해서는 더 많은 공간 권장)

***

## 다운로드 [#다운로드]

공식 웹사이트에서 Verdent를 다운로드합니다.

**[verdent.ai/download](https://verdent.ai/download)**

운영 체제를 선택해 알맞은 설치 프로그램을 다운로드합니다.

***

## macOS 설치 [#macos-설치]

<Steps>
  <Step title="다운로드">
    [verdent.ai/download](https://verdent.ai/download)에서 `.dmg` 파일을 다운로드합니다.
  </Step>

  <Step title="DMG 열기">
    다운로드한 `.dmg` 파일을 두 번 선택해 마운트합니다.
  </Step>

  <Step title="설치">
    Verdent 아이콘을 Applications 폴더로 드래그합니다.
  </Step>

  <Step title="실행">
    Applications를 열고 Verdent를 두 번 선택합니다.
  </Step>

  <Step title="보안 승인">
    메시지가 표시되면 **System Settings → Privacy & Security**(macOS 13 이상) 또는 **System Preferences → Security & Privacy**(이전 macOS)를 열고 **Open Anyway**를 선택합니다.
  </Step>
</Steps>

**지원되는 macOS 버전:**

* macOS 11(Big Sur) 이상
* Intel 및 Apple Silicon 지원

***

## Windows 설치 [#windows-설치]

<Steps>
  <Step title="다운로드">
    [verdent.ai/download](https://verdent.ai/download)에서 `.exe` 설치 프로그램을 다운로드합니다.
  </Step>

  <Step title="설치 프로그램 실행">
    다운로드한 `.exe` 파일을 두 번 선택합니다.
  </Step>

  <Step title="UAC 프롬프트">
    사용자 계정 컨트롤 메시지가 표시되면 **Yes**를 선택합니다.
  </Step>

  <Step title="설치 옵션">
    설치 프로그램의 안내를 따릅니다. 일부 빌드에서는 사용자 지정 설치 디렉터리를 제공하지 않을 수 있습니다.
  </Step>

  <Step title="완료">
    **Install**을 선택하고 완료될 때까지 기다립니다.
  </Step>

  <Step title="실행">
    **Finish**를 선택해 Verdent를 실행하거나 시작 메뉴에서 찾습니다.
  </Step>
</Steps>

**지원되는 Windows 버전:**

* Windows 10
* Windows 11
* 64비트 전용

***

## 인증 및 설정 [#인증-및-설정]

설치 후 애플리케이션 사용을 시작하려면 Verdent 계정으로 인증해야 합니다.

### 초기 인증 [#초기-인증]

<Steps>
  <Step title="Verdent 실행">
    Applications(macOS) 또는 시작 메뉴(Windows)에서 Verdent를 엽니다. 시작 화면이 표시됩니다.
  </Step>

  <Step title="로그인">
    **Sign In**을 선택합니다. 브라우저가 Verdent 인증 페이지를 엽니다.
  </Step>

  <Step title="브라우저 인증">
    Verdent 계정 자격 증명(이메일/비밀번호 또는 Google, GitHub 등의 OAuth 제공자)으로 로그인합니다.
  </Step>

  <Step title="앱으로 돌아가기">
    인증이 완료되면 Verdent로 돌아갑니다. 기본 인터페이스가 표시됩니다.
  </Step>

  <Step title="프로젝트 열기">
    디렉터리를 선택하려면 **Open Project**를 선택하고, 기존 프로젝트로 돌아가려면 **Recent Projects**를 선택합니다.
  </Step>
</Steps>

***

## 설치 확인 [#설치-확인]

다음 간단한 확인을 통해 설치가 올바르게 작동하는지 확인합니다.

### 시각적 확인 [#시각적-확인]

1. **애플리케이션 아이콘** - Verdent가 Applications(macOS) 또는 시작 메뉴(Windows)에 표시됩니다.
2. **로그인됨** - 인증 후 앱에서 계정 상태(예: 아바타/이메일)를 확인할 수 있습니다.

### 기능 확인 [#기능-확인]

<Steps>
  <Step title="프로젝트 열기">
    Verdent에서 디렉터리를 엽니다.
  </Step>

  <Step title="테스트 프롬프트 보내기">
    입력 상자에 "이 프로젝트에 무엇이 들어 있는지 설명해 줘" 같은 간단한 요청을 시도합니다.
  </Step>

  <Step title="응답 받기">
    Verdent가 프로젝트를 분석하고 곧 응답을 제공해야 합니다.
  </Step>
</Steps>

**성공 지표:**

* Verdent가 오류 없이 실행됨
* 계정 인증 성공
* 프롬프트를 보내고 응답을 받을 수 있음

<Warning>
  Verdent의 AI 기능을 사용하려면 활성 인터넷 연결이 필요합니다. 프롬프트가 응답하지 않으면 네트워크 연결을 확인하고 방화벽이 Verdent의 API 엔드포인트로 나가는 HTTPS 연결을 허용하는지 확인합니다.
</Warning>

***

## 설치 문제 해결 [#설치-문제-해결]

<Tabs>
  <Tab title="macOS 보안">
    **문제:** "Verdent cannot be opened because it is from an unidentified developer"

    **해결 방법:**

    1. **System Settings → Privacy & Security**(macOS 13 이상) 또는 **System Preferences → Security & Privacy**(이전 macOS)를 엽니다.
    2. Verdent 경고 메시지를 찾습니다.
    3. **Open Anyway**를 선택합니다.
    4. **Open**을 선택해 확인합니다.
  </Tab>

  <Tab title="Windows Defender">
    **문제:** Windows Defender가 설치를 차단함

    **해결 방법:**

    1. SmartScreen 팝업에서 **More info**를 선택합니다.
    2. 공식 웹사이트에서 Verdent를 다운로드했고 출처를 신뢰한다면 **Run anyway**를 선택합니다.
    3. 설치를 계속합니다.
  </Tab>
</Tabs>

***

## FAQ [#faq]

<AccordionGroup>
  <Accordion title="Verdent를 VS Code 확장과 함께 설치할 수 있나요?">
    예. Verdent와 VS Code 확장은 독립적인 애플리케이션입니다. 둘 다 사용할 수 있으며, 동일한 크레딧 풀과 계정을 공유합니다.
  </Accordion>

  <Accordion title="Verdent를 어떻게 업데이트하나요?">
    Verdent는 실행 시 업데이트를 자동으로 확인합니다. 업데이트가 있으면:

    1. 알림이 표시됩니다.
    2. **Update**를 선택해 다운로드하고 설치합니다.
    3. 애플리케이션을 다시 시작합니다.

    앱 메뉴에서도 수동으로 확인할 수 있습니다(예: **Help → Check for Updates**).
  </Accordion>

  <Accordion title="Verdent를 어떻게 제거하나요?">
    **macOS:** Applications에서 Verdent를 Trash로 드래그합니다.

    **Windows:** **Settings → Apps → Verdent → Uninstall** 또는 **Control Panel → Programs and Features**를 사용합니다.
  </Accordion>
</AccordionGroup>

***

## 다음 단계 [#다음-단계]

<CardGroup cols="2">
  <Card title="빠른 시작" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    첫 프로젝트를 추가하고 작업을 할당합니다.
  </Card>

  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    Manager가 작업을 계획, 배정, 추적하는 방식을 알아봅니다.
  </Card>
</CardGroup>