빠른 시작 가이드

이 빠른 시작 가이드는 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 설치

Verdent 확장 프로그램 페이지를 방문하고 Install을 선택합니다.

Visual Studio Code을 엽니다
Ctrl+Shift+X를 누릅니다(macOS에서는 Cmd+Shift+X)
"Verdent"을 검색합니다
Install을 선택합니다

code --install-extension verdentai.verdent

2단계: Verdent 사용 시작

Visual Studio Code 열기

프로젝트 폴더에서 Visual Studio Code을 엽니다.

Verdent에 접근하기

사이드바에서 Verdent 아이콘을 선택하거나 Ctrl+L(Windows/Linux) / Cmd+L(macOS)를 누릅니다.

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이 워크스페이스에 접근할 수 있고 코드베이스를 이해한다는 점을 확인하는 데 도움이 됩니다.

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

4단계: 첫 코드 변경 만들기

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

Create a hello_world.txt file with a greeting message

진행 방식:

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

권한 이해하기:

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

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

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

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

5단계: 복잡한 작업에 Plan Mode 사용하기

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

Plan Mode로 전환하기:

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

계획 작업 시도하기:

Suggest ways to build a website for my project

진행 방식:

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

Plan Mode을 사용하는 이유:

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

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

플랜 실행하기:

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

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

6단계: 실행 모드 이해하기

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

권한 모드:

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

추가 모드:

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

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

핵심 작업

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 서버, 서브에이전트, 규칙을 설정합니다

초보자를 위한 팁

탐색형 프롬프트로 시작하기

변경하기 전에 Verdent이 코드베이스를 이해하도록 합니다.

Analyze the database schema

Explain the authentication flow

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

요청을 구체적으로 작성하기

다음처럼 쓰기보다: "버그를 고쳐줘"

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

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

낯선 코드에는 Plan Mode 사용하기

완전히 이해하지 못한 코드를 다룰 때는 먼저 Plan Mode을 사용하세요.

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

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

복잡한 작업을 단계로 나누기

여러 단계로 이루어진 기능은 점진적으로 작업하세요.

1. Create a new database table for user profiles

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

2. Create an API endpoint to get and update profiles

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

컨텍스트에 @-멘션 활용하기

필요할 때 파일을 명시적으로 참조하세요.

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

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

전문 작업에 서브에이전트 사용하기

Verdent에는 세 가지 기본 제공 서브에이전트가 포함되어 있습니다.

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

예시:

@Explorer find all API endpoints in this project

자주 발생하는 문제

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

해결 방법:

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

해결 방법: "Switch Permission" 버튼을 사용해 Auto-Run Mode로 전환합니다. 이 모드는 안전한 읽기 작업을 자동으로 승인하면서도 파일 수정과 명령에는 계속 승인을 요청합니다.

도움받기

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

FAQ

현재 어떤 실행 모드에 있는지 어떻게 알 수 있나요?

Verdent 패널 하단의 입력 상자를 확인하세요. "Switch Permission" 버튼이 현재 모드(예: "Manual", "Auto", "Plan")를 표시합니다. 이 버튼을 선택해 모드를 전환할 수 있습니다.

크레딧을 모두 사용하면 어떻게 되나요?

표준 크레딧 기반 요청은 잔액이 0이 되면 중단됩니다. 계속하려면 다음 청구 주기 갱신을 기다리거나 일회성 크레딧 충전을 구매하세요.

Verdent을 여러 프로젝트에서 동시에 사용할 수 있나요?

네, 각 VS Code 창은 독립적으로 작동합니다. 여러 프로젝트에서 Verdent을 열 수 있으며, 각 프로젝트는 별도의 대화 컨텍스트를 유지합니다.

깨끗한 컨텍스트로 새 대화를 시작하려면 어떻게 하나요?

상단 바에서 "New Session" 버튼을 선택합니다. 그러면 현재 대화 기록이 지워지고, 다음 작업을 위해 Verdent에 새로운 컨텍스트 창이 제공됩니다.