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

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



이 가이드는 Visual Studio Code Marketplace에서 Verdent for VS Code을 설치하고 초기 인증을 완료하는 과정을 안내합니다.

***

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

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

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

* **Visual Studio Code**: 버전 1.90.0 이상
* **운영 체제**: macOS 11+, Windows 10+, 또는 Linux(Ubuntu 20.04+, Debian 10+, RHEL 8+)
* **인터넷 연결**: AI 서비스 통신을 위해 활성 연결 필요

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

* **Git**: 버전 관리 연동 및 코드 변경 추적용

자세한 호환성 정보는 [시스템 요구 사항](/docs/verdent-for-vscode/getting-started/system-requirements)을 참고하세요.

***

## 확장 프로그램 설치 [#확장-프로그램-설치]

Verdent for VS Code은 Visual Studio Code Marketplace를 통해 배포됩니다.

<Tabs>
  <Tab title="VS Code Marketplace">
    <Steps>
      <Step title="Marketplace 방문">
        브라우저에서 [Verdent 확장 프로그램 페이지](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent)로 이동합니다.
      </Step>

      <Step title="Install 선택">
        Marketplace 페이지에서 **Install** 버튼을 선택합니다.
      </Step>

      <Step title="VS Code에서 열기">
        VS Code이 자동으로 열리고 설치 프로세스가 시작됩니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="확장 프로그램 패널">
    <Steps>
      <Step title="VS Code 열기">
        컴퓨터에서 Visual Studio Code을 실행합니다.
      </Step>

      <Step title="확장 프로그램 열기">
        왼쪽 사이드바에서 확장 프로그램 아이콘(네 개의 사각형 아이콘)을 선택하거나 다음을 누릅니다.

        * **macOS**: `Cmd+Shift+X`
        * **Windows/Linux**: `Ctrl+Shift+X`
      </Step>

      <Step title="Verdent 검색">
        확장 프로그램 패널 상단의 검색 상자에 "Verdent"을 입력합니다. 결과에서 Verdent AI의 "Verdent"을 찾습니다.
      </Step>

      <Step title="설치">
        Verdent 확장 프로그램 옆의 **Install** 버튼을 선택합니다. 설치는 보통 몇 초 정도 걸립니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="명령줄">
    ```bash
    code --install-extension verdentai.verdent
    ```

    이 방법은 다음 경우에 유용합니다.

    * 자동화된 설정 스크립트
    * SSH를 통한 원격 서버 설치
    * CI/CD 환경 구성
    * 여러 머신에 빠르게 설치
  </Tab>
</Tabs>

<Tip>
  VS Code Settings Sync를 사용하면 확장 프로그램 목록을 동기화할 때 새 머신에 Verdent이 자동으로 설치됩니다.
</Tip>

***

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

설치 후 확장 프로그램을 사용하려면 Verdent 계정으로 인증해야 합니다.

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

<Steps>
  <Step title="Verdent 열기">
    설치 후 VS Code 사이드바에서 Verdent 아이콘을 선택합니다. Sign In / Sign Up 옵션이 표시됩니다.
  </Step>

  <Step title="로그인">
    **Sign In**을 선택합니다. VS Code에 "Do you want Code to open the external website?"라고 묻는 팝업이 표시됩니다. **Open**을 선택합니다.
  </Step>

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

  <Step title="VS Code 승인">
    메시지가 표시되면 VS Code이 Verdent 계정에 접근하도록 허용합니다.
  </Step>

  <Step title="VS Code로 돌아가기">
    인증이 완료되면 VS Code로 돌아갑니다. 이제 Verdent 패널에 입력 인터페이스가 표시됩니다.
  </Step>
</Steps>

**총 소요 시간:** 전체 설치와 설정에 2\~3분.

### 초기 구성(선택 사항) [#초기-구성선택-사항]

Verdent for VS Code은 인증 후 별도 구성을 거의 하지 않고 바로 사용할 수 있도록 설계되었습니다.

**기본 설정:**

* **권한 모드**: Auto-Run Mode(안전한 작업은 자동 승인)
* **모델 프리셋**: Balance(성능과 비용의 최적 균형)
* **컨텍스트 관리**: 자동

**선택적 사용자 지정:**

나중에 Verdent 패널에서 다음 설정을 조정할 수 있습니다.

* **권한 모드** - Manual Accept, Auto-Run, Plan Mode, 또는 Skip Permissions 선택
* **모델 선택** - Performance, Balance, Efficiency 프리셋 또는 특정 모델 선택
* **워크스페이스 설정** - 프로젝트별 기본 설정 구성

<Note>
  대부분의 사용자는 로그인 후 추가 구성 없이 바로 Verdent을 사용할 수 있습니다. 고급 설정은 필요에 따라 조정할 수 있습니다.
</Note>

***

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

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

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

1. **사이드바 아이콘** - VS Code 사이드바(왼쪽)에서 Verdent 아이콘을 찾습니다.
2. **확장 프로그램 목록** - 확장 프로그램 패널(`Cmd+Shift+X` / `Ctrl+Shift+X`)을 열고 "Verdent"이 체크 표시와 함께 설치됨으로 표시되는지 확인합니다.

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

<Steps>
  <Step title="Verdent 패널 열기">
    사이드바에서 Verdent 아이콘을 선택하거나 `Cmd+L`(macOS) / `Ctrl+L`(Windows/Linux)을 누릅니다.
  </Step>

  <Step title="테스트 프롬프트 보내기">
    입력 상자에 "이 워크스페이스에 무엇이 있는지 설명해 주세요" 같은 간단한 요청을 입력해 봅니다.
  </Step>

  <Step title="응답 받기">
    Verdent이 워크스페이스를 분석하고 몇 초 안에 응답을 제공해야 합니다.
  </Step>
</Steps>

**성공 지표:**

* 사이드바에 Verdent 아이콘 표시
* 계정 인증 성공
* 프롬프트를 보내고 응답을 받을 수 있음

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

확인에 실패하면 다음 해결 방법을 시도하세요.

| 문제               | 해결 방법                                 |
| ---------------- | ------------------------------------- |
| 사이드바 아이콘이 없음     | VS Code을 다시 시작하거나 확장 프로그램 업데이트를 확인합니다 |
| 프롬프트가 응답하지 않음    | 인터넷 연결과 방화벽 설정을 확인합니다                 |
| 확장 프로그램을 찾을 수 없음 | VS Code 버전이 1.90.0 이상인지 확인합니다         |

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

***

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

<CardGroup cols="2">
  <Card title="빠른 시작" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    5분 안에 Verdent으로 첫 작업을 완료하세요.
  </Card>

  <Card title="핵심 개념" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    서브에이전트, 실행 모드, 멀티 에이전트 아키텍처를 이해합니다.
  </Card>
</CardGroup>