# 빠른 시작 가이드 (/ko/docs/verdent-for-vscode/getting-started/quick-start)

> Verdent을 몇 분 만에 시작하기



이 빠른 시작 가이드는 15분 안에 Verdent의 Plan-Verify-Code 워크플로를 사용할 수 있도록 안내합니다. 확장 프로그램을 설치하고, 첫 작업을 완료하며, Verdent for VS Code로 작업할 때의 핵심 워크플로를 이해하게 됩니다.

### 배울 내용 [#배울-내용]

* 마켓플레이스에서 Verdent for VS Code 설치하기
* 인증하고 설정 확인하기
* 첫 AI 지원 작업 완료하기
* 실행 모드 이해하기(Manual Accept, Auto-Run, Plan Mode)
* 일상적인 코딩에 필요한 핵심 기능 사용하기

### 사전 준비 [#사전-준비]

시작하기 전에 다음을 준비하세요.

* 시스템에 Visual Studio Code 설치
* 활성 인터넷 연결
* Verdent 구독 계정(또는 7일 무료 체험으로 시작)

***

## 1단계: Verdent 설치 [#1단계-verdent-설치]

<Tabs>
  <Tab title="Visual Studio Code 마켓플레이스">
    [Verdent 확장 프로그램 페이지](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent)를 방문하고 **Install**을 선택합니다.
  </Tab>

  <Tab title="확장 프로그램 패널">
    1. Visual Studio Code을 엽니다
    2. `Ctrl+Shift+X`를 누릅니다(macOS에서는 `Cmd+Shift+X`)
    3. "Verdent"을 검색합니다
    4. **Install**을 선택합니다
  </Tab>

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

***

## 2단계: Verdent 사용 시작 [#2단계-verdent-사용-시작]

<Steps>
  <Step title="Visual Studio Code 열기">
    프로젝트 폴더에서 Visual Studio Code을 엽니다.
  </Step>

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

  <Step title="로그인">
    메시지가 표시되면 Verdent 계정으로 인증하기 위해 로그인합니다.
  </Step>
</Steps>

***

## 3단계: 첫 작업 [#3단계-첫-작업]

워크스페이스를 Verdent이 어떻게 이해하는지 보여주는 간단하고 비파괴적인 작업부터 시작해 보겠습니다.

**VS Code에서 프로젝트를 연 다음**, Verdent 입력 상자에 다음 프롬프트 중 하나를 입력해 보세요.

```
What kind of project is this?
```

Verdent이 워크스페이스 구조를 분석하고, 핵심 파일을 읽고, 어떤 유형의 애플리케이션을 작업 중인지 설명합니다. 변경 없이 컨텍스트 인식을 확인할 수 있습니다.

**다음이 표시됩니다.**

* Verdent이 워크스페이스의 파일을 분석함
* 프로젝트 유형, 기술, 구조에 대한 요약
* 파일 수정 없음(읽기 전용 분석)

**다음 후속 프롬프트도 시도해 보세요.**

```
Explain what this project does
```

```
What dependencies does this project have?
```

```
Show me the main entry point of this application
```

각 프롬프트는 Verdent이 워크스페이스에 접근할 수 있고 코드베이스를 이해한다는 점을 확인하는 데 도움이 됩니다.

<Tip>
  이러한 탐색형 프롬프트는 낯선 코드베이스를 이해할 때 매우 유용합니다. Verdent은 사용자가 컨텍스트를 수동으로 추가하지 않아도 필요에 따라 파일을 읽습니다.
</Tip>

***

## 4단계: 첫 코드 변경 만들기 [#4단계-첫-코드-변경-만들기]

이제 Verdent이 무언가를 만들도록 해보겠습니다. 다음 간단한 작업을 시도하세요.

```
Create a hello_world.txt file with a greeting message
```

**진행 방식:**

1. **Verdent이 변경을 제안합니다**
   생성할 파일과 그 내용을 보여주는 미리보기가 표시됩니다
2. **권한 요청**  기본값인 Auto Run Mode에서는 Verdent이 파일을 만들 때 자동 승인합니다
3. **사용자가 승인합니다** "Accept"를 선택하거나 변경을 승인합니다
4. **파일 생성**
   Verdent이 파일을 생성하고 완료를 확인합니다

**권한 이해하기:**

Manual Accept Mode은 사용자의 승인 없이 원치 않는 수정이 발생하지 않도록 합니다. 다음 작업에 대해 권한 프롬프트가 표시됩니다.

* 파일 수정 및 생성
* 명령 실행
* 도구 사용(각 도구 유형의 첫 사용)

이를 통해 전체 제어권을 유지할 수 있고, Verdent이 다양한 작업에서 어떤 동작을 수행하는지 배울 수 있습니다.

<Note>
  Manual Accept Mode은 신규 사용자에게 권장되는 시작점입니다. 익숙해지면 다른 워크플로에 맞게 Auto-Run Mode 또는 Plan Mode로 전환할 수 있습니다.
</Note>

***

## 5단계: 복잡한 작업에 Plan Mode 사용하기 [#5단계-복잡한-작업에-plan-mode-사용하기]

Plan Mode은 실행 전에 접근 방식을 검토할 수 있는 Verdent의 읽기 전용 계획 모드입니다. 한번 사용해 보겠습니다.

**Plan Mode로 전환하기:**

입력 상자에서 **Switch Mode** 버튼을 선택하고 **Plan Mode**을 선택합니다

**계획 작업 시도하기:**

```
Suggest ways to build a website for my project
```

**진행 방식:**

1. **Verdent이 프로젝트를 분석합니다**
   파일을 읽고 프로젝트 구조와 요구사항을 이해합니다
2. **상세한 플랜을 만듭니다**
   사용할 기술, 만들 페이지, 웹사이트 구조화 방식을 보여줍니다
3. **수정 없음**
   Plan Mode은 읽기 전용입니다. 사용자가 명시적으로 승인하기 전까지 Verdent은 파일을 수정할 수 없습니다
4. **대화형 확인**
   Verdent은 플랜을 확정하기 전에 디자인 선호도, 대상 사용자, 기능에 대해 질문할 수 있습니다

**Plan Mode을 사용하는 이유:**

* **안전한 탐색** - 실수로 변경하지 않고 낯선 코드베이스를 이해합니다
* **코드 리뷰** - 수정하기 전에 품질과 아키텍처를 분석합니다
* **전략적 계획** - 복잡한 작업을 검토 가능한 단계로 나눕니다
* **불확실성 감소** - Verdent이 모호함을 줄이기 위해 확인 질문을 합니다

<Tip>
  실행에 들어가기 전에 접근 방식을 검토하고 싶은 모든 작업에 Plan Mode을 사용하세요. Verdent이 코드베이스를 어떻게 이해하는지 배우는 데 특히 유용합니다.
</Tip>

**플랜 실행하기:**

플랜을 검토한 뒤 Verdent은 두 가지 옵션을 제시합니다.

* 수정을 요청하거나 확인 질문을 하려면 **Edit**을 선택합니다
* Agent Mode로 전환해 실행을 시작하려면 **Start Building**을 선택합니다

***

## 6단계: 실행 모드 이해하기 [#6단계-실행-모드-이해하기]

Verdent은 다양한 워크플로에 맞출 수 있도록 여러 실행 모드를 제공합니다.

**권한 모드:**

| 모드                   | 설명                                                        | 사용 시점                       |
| -------------------- | --------------------------------------------------------- | --------------------------- |
| **Manual Accept**    | 각 도구를 처음 사용할 때 권한을 요청합니다                                  | 최대 제어권으로 학습하거나 일반 개발을 할 때   |
| **Auto-Run**(기본값)    | 안전한 작업(파일 읽기, 웹 검색)은 자동으로 승인합니다. 파일 수정과 명령은 여전히 승인이 필요합니다 | 신뢰할 수 있는 프로젝트와 빠른 프로토타이핑    |
| **Plan Mode**        | 파일 수정 없이 분석과 계획을 수행하는 읽기 전용 모드                            | 복잡한 작업과 코드 리뷰               |
| **Skip Permissions** | 모든 프롬프트를 건너뛰는 완전 자율 실행                                    | 자동화 테스트나 샌드박스처럼 격리되고 안전한 환경 |

**추가 모드:**

* **Think Hard Mode** - 복잡한 추론과 아키텍처 결정을 위한 최대 사고 예산

<Warning>
  Skip Permissions Mode은 모든 안전 확인을 제거합니다. 실수의 영향이 없는 격리된 일회성 환경에서만 사용하세요.
</Warning>

***

## 핵심 작업 [#핵심-작업]

Verdent for VS Code에서 매일 사용하게 될 주요 작업은 다음과 같습니다.

| 작업         | 접근 방법                             | 설명                                        |
| ---------- | --------------------------------- | ----------------------------------------- |
| Verdent 열기 | `Cmd+L` / `Ctrl+L` 또는 사이드바 아이콘 선택 | Verdent 패널을 엽니다                           |
| 새 세션       | 상단 바에서 "New Session" 선택           | 깨끗한 컨텍스트로 새 대화를 시작합니다                     |
| 컨텍스트 추가    | "Add Context" 버튼 선택               | @-멘션으로 파일을 참조합니다                          |
| 이미지 추가     | "Add Images or Files" 버튼 선택       | 스크린샷, 목업, 다이어그램을 업로드합니다                   |
| 모드 전환      | "Switch Mode" 버튼 선택               | Agent/Plan/Chat 모드를 전환합니다                 |
| 모델 변경      | 모델 선택기 선택                         | Performance/Balance/Efficiency 프리셋을 선택합니다 |
| 깊게 생각하기    | "Think Hard Mode" 버튼 선택           | 복잡한 작업을 위해 확장 추론을 활성화합니다                  |
| 권한 전환      | "Switch Permission" 버튼 선택         | 권한 모드를 변경합니다                              |
| 기록 보기      | 상단 바에서 "Project History" 선택       | 이전 세션을 탐색합니다                              |
| 사용자 센터     | 상단 바에서 "User Center" 선택           | 크레딧 잔액과 계정 정보를 확인합니다                      |
| 설정         | 상단 바에서 "Settings" 선택              | MCP 서버, 서브에이전트, 규칙을 설정합니다                 |

***

## 초보자를 위한 팁 [#초보자를-위한-팁]

<Accordion title="탐색형 프롬프트로 시작하기">
  변경하기 전에 Verdent이 코드베이스를 이해하도록 합니다.

  ```
  Analyze the database schema
  ```

  ```
  Explain the authentication flow
  ```

  이렇게 하면 Verdent이 프로젝트에 대한 컨텍스트를 쌓고 더 나은 제안을 할 수 있습니다.
</Accordion>

<Accordion title="요청을 구체적으로 작성하기">
  다음처럼 쓰기보다: "버그를 고쳐줘"

  다음처럼 시도하세요: "사용자가 잘못된 자격 증명을 입력한 뒤 빈 화면을 보는 `LoginForm.tsx`의 로그인 버그를 고쳐줘"

  구체적인 프롬프트는 더 정확한 해결책과 더 적은 반복으로 이어집니다.
</Accordion>

<Accordion title="낯선 코드에는 Plan Mode 사용하기">
  완전히 이해하지 못한 코드를 다룰 때는 먼저 Plan Mode을 사용하세요.

  ```
  Refactor the authentication module to use async/await instead of callbacks
  ```

  플랜을 검토하고, 확인 질문을 하거나 다듬으려면 **Edit**을 선택한 다음, 확신이 들면 **Start Building**을 선택합니다.
</Accordion>

<Accordion title="복잡한 작업을 단계로 나누기">
  여러 단계로 이루어진 기능은 점진적으로 작업하세요.

  ```
  1. Create a new database table for user profiles
  ```

  완료 후에는 다음을 진행합니다.

  ```
  2. Create an API endpoint to get and update profiles
  ```

  이렇게 하면 명확성을 유지하고 각 단계를 검증할 수 있습니다.
</Accordion>

<Accordion title="컨텍스트에 @-멘션 활용하기">
  필요할 때 파일을 명시적으로 참조하세요.

  ```
  @components/UserProfile.tsx refactor this component to use hooks
  ```

  이렇게 하면 Verdent이 작업에 맞는 올바른 컨텍스트에 집중할 수 있습니다.
</Accordion>

<Accordion title="전문 작업에 서브에이전트 사용하기">
  Verdent에는 세 가지 기본 제공 서브에이전트가 포함되어 있습니다.

  * `@Explorer` - 빠른 코드베이스 탐색과 파일 찾기
  * `@Verifier` - 빠른 코드 검증과 확인
  * `@Code-reviewer` - 종합적인 보안 및 품질 리뷰

  예시:

  ```
  @Explorer find all API endpoints in this project
  ```
</Accordion>

***

## 자주 발생하는 문제 [#자주-발생하는-문제]

<Tabs>
  <Tab title="사이드바에 확장 프로그램이 보이지 않음">
    **해결 방법:** VS Code을 다시 시작합니다. 여전히 보이지 않으면 확장 프로그램 패널(`Cmd+Shift+X` / `Ctrl+Shift+X`)에서 설치 상태를 확인하고 목록에 "Verdent"이 표시되는지 확인합니다.
  </Tab>

  <Tab title="프롬프트에 응답이 오지 않음">
    **해결 방법:**

    1. 인터넷 연결이 활성 상태인지 확인합니다
    2. 방화벽/프록시 설정에서 Verdent 서비스로의 HTTPS 연결을 허용하는지 확인합니다
    3. User Center에 남은 크레딧이 있는지 확인합니다
    4. 연결을 테스트하기 위해 더 간단한 프롬프트를 시도합니다
  </Tab>

  <Tab title="권한 프롬프트가 너무 자주 표시됨">
    **해결 방법:** "Switch Permission" 버튼을 사용해 Auto-Run Mode로 전환합니다. 이 모드는 안전한 읽기 작업을 자동으로 승인하면서도 파일 수정과 명령에는 계속 승인을 요청합니다.
  </Tab>
</Tabs>

***

## 도움받기 [#도움받기]

* **Discord 커뮤니티**: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - 실시간 지원을 제공하는 활발한 커뮤니티
* **문서**: 이 문서의 다른 가이드를 살펴보세요
* **피드백**: 문제를 보고하거나 개선을 제안하려면 Verdent 상단 바의 Feedback 버튼을 사용하세요

***

## FAQ [#faq]

<Accordion title="현재 어떤 실행 모드에 있는지 어떻게 알 수 있나요?">
  Verdent 패널 하단의 입력 상자를 확인하세요. "Switch Permission" 버튼이 현재 모드(예: "Manual", "Auto", "Plan")를 표시합니다. 이 버튼을 선택해 모드를 전환할 수 있습니다.
</Accordion>

<Accordion title="크레딧을 모두 사용하면 어떻게 되나요?">
  표준 크레딧 기반 요청은 잔액이 0이 되면 중단됩니다. 계속하려면 다음 청구 주기 갱신을 기다리거나 일회성 크레딧 충전을 구매하세요.
</Accordion>

<Accordion title="Verdent을 여러 프로젝트에서 동시에 사용할 수 있나요?">
  네, 각 VS Code 창은 독립적으로 작동합니다. 여러 프로젝트에서 Verdent을 열 수 있으며, 각 프로젝트는 별도의 대화 컨텍스트를 유지합니다.
</Accordion>

<Accordion title="깨끗한 컨텍스트로 새 대화를 시작하려면 어떻게 하나요?">
  상단 바에서 "New Session" 버튼을 선택합니다. 그러면 현재 대화 기록이 지워지고, 다음 작업을 위해 Verdent에 새로운 컨텍스트 창이 제공됩니다.
</Accordion>

***

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

Verdent을 설치하고, 첫 작업을 완료했으며, 핵심 워크플로를 배웠습니다. 다음으로 이어서 살펴볼 내용은 다음과 같습니다.

<CardGroup cols="2">
  <Card title="핵심 개념" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    서브에이전트, 멀티 에이전트 아키텍처, 컨텍스트 관리를 이해합니다
  </Card>

  <Card title="일반 워크플로" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    여러 단계 작업, 대규모 코드베이스, 버전 관리를 위한 단계별 가이드
  </Card>
</CardGroup>