설치
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: 버전 관리 연동 및 코드 변경 추적용
자세한 호환성 정보는 시스템 요구 사항을 참고하세요.
확장 프로그램 설치
Verdent for VS Code은 Visual Studio Code Marketplace를 통해 배포됩니다.
Marketplace 방문
브라우저에서 Verdent 확장 프로그램 페이지로 이동합니다.
Install 선택
Marketplace 페이지에서 Install 버튼을 선택합니다.
VS Code에서 열기
VS Code이 자동으로 열리고 설치 프로세스가 시작됩니다.
VS Code 열기
컴퓨터에서 Visual Studio Code을 실행합니다.
확장 프로그램 열기
왼쪽 사이드바에서 확장 프로그램 아이콘(네 개의 사각형 아이콘)을 선택하거나 다음을 누릅니다.
- macOS:
Cmd+Shift+X - Windows/Linux:
Ctrl+Shift+X
Verdent 검색
확장 프로그램 패널 상단의 검색 상자에 "Verdent"을 입력합니다. 결과에서 Verdent AI의 "Verdent"을 찾습니다.
설치
Verdent 확장 프로그램 옆의 Install 버튼을 선택합니다. 설치는 보통 몇 초 정도 걸립니다.
code --install-extension verdentai.verdent이 방법은 다음 경우에 유용합니다.
- 자동화된 설정 스크립트
- SSH를 통한 원격 서버 설치
- CI/CD 환경 구성
- 여러 머신에 빠르게 설치
VS Code Settings Sync를 사용하면 확장 프로그램 목록을 동기화할 때 새 머신에 Verdent이 자동으로 설치됩니다.
인증 및 설정
설치 후 확장 프로그램을 사용하려면 Verdent 계정으로 인증해야 합니다.
초기 인증
Verdent 열기
설치 후 VS Code 사이드바에서 Verdent 아이콘을 선택합니다. Sign In / Sign Up 옵션이 표시됩니다.
로그인
Sign In을 선택합니다. VS Code에 "Do you want Code to open the external website?"라고 묻는 팝업이 표시됩니다. Open을 선택합니다.
브라우저 인증
브라우저가 Verdent 인증 페이지를 엽니다. Verdent 계정 자격 증명(이메일/비밀번호 또는 Google, GitHub 등 OAuth 제공자)으로 로그인합니다.
VS Code 승인
메시지가 표시되면 VS Code이 Verdent 계정에 접근하도록 허용합니다.
VS Code로 돌아가기
인증이 완료되면 VS Code로 돌아갑니다. 이제 Verdent 패널에 입력 인터페이스가 표시됩니다.
총 소요 시간: 전체 설치와 설정에 2~3분.
초기 구성(선택 사항)
Verdent for VS Code은 인증 후 별도 구성을 거의 하지 않고 바로 사용할 수 있도록 설계되었습니다.
기본 설정:
- 권한 모드: Auto-Run Mode(안전한 작업은 자동 승인)
- 모델 프리셋: Balance(성능과 비용의 최적 균형)
- 컨텍스트 관리: 자동
선택적 사용자 지정:
나중에 Verdent 패널에서 다음 설정을 조정할 수 있습니다.
- 권한 모드 - Manual Accept, Auto-Run, Plan Mode, 또는 Skip Permissions 선택
- 모델 선택 - Performance, Balance, Efficiency 프리셋 또는 특정 모델 선택
- 워크스페이스 설정 - 프로젝트별 기본 설정 구성
대부분의 사용자는 로그인 후 추가 구성 없이 바로 Verdent을 사용할 수 있습니다. 고급 설정은 필요에 따라 조정할 수 있습니다.
설치 확인
다음 간단한 확인으로 설치가 올바르게 작동하는지 확인합니다.
시각적 확인
- 사이드바 아이콘 - VS Code 사이드바(왼쪽)에서 Verdent 아이콘을 찾습니다.
- 확장 프로그램 목록 - 확장 프로그램 패널(
Cmd+Shift+X/Ctrl+Shift+X)을 열고 "Verdent"이 체크 표시와 함께 설치됨으로 표시되는지 확인합니다.
기능 확인
Verdent 패널 열기
사이드바에서 Verdent 아이콘을 선택하거나 Cmd+L(macOS) / Ctrl+L(Windows/Linux)을 누릅니다.
테스트 프롬프트 보내기
입력 상자에 "이 워크스페이스에 무엇이 있는지 설명해 주세요" 같은 간단한 요청을 입력해 봅니다.
응답 받기
Verdent이 워크스페이스를 분석하고 몇 초 안에 응답을 제공해야 합니다.
성공 지표:
- 사이드바에 Verdent 아이콘 표시
- 계정 인증 성공
- 프롬프트를 보내고 응답을 받을 수 있음
문제 해결
확인에 실패하면 다음 해결 방법을 시도하세요.
| 문제 | 해결 방법 |
|---|---|
| 사이드바 아이콘이 없음 | VS Code을 다시 시작하거나 확장 프로그램 업데이트를 확인합니다 |
| 프롬프트가 응답하지 않음 | 인터넷 연결과 방화벽 설정을 확인합니다 |
| 확장 프로그램을 찾을 수 없음 | VS Code 버전이 1.90.0 이상인지 확인합니다 |
Verdent에는 활성 인터넷 연결이 필요합니다. 프롬프트가 응답하지 않으면 네트워크 연결을 확인하고, 방화벽 구성이 Verdent의 API 엔드포인트로 나가는 HTTPS 연결을 허용하는지 확인하세요.