설치
Verdent 설치 및 설정을 위한 단계별 가이드
이 가이드는 Verdent를 다운로드하고, 플랫폼별 설치를 완료한 뒤, Verdent 계정으로 인증하는 과정을 안내합니다.
요구 사항
Verdent를 설치하기 전에 시스템이 다음 사전 요구 사항을 충족하는지 확인합니다.
시스템 요구 사항
- 운영 체제: macOS 11 이상 또는 Windows 10 이상(64비트). 전체 호환성 정보는 지원되는 운영 체제를 참고하세요.
- 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에서 공식 설치 프로그램을 다운로드하고 기본 옵션을 그대로 사용합니다.
- 터미널에서
git --version로 확인합니다.
- macOS: Git는 Xcode Command Line Tools에 포함되어 제공됩니다.
- 인터넷 연결: AI 서비스와 통신하려면 활성 인터넷 연결이 필요합니다.
선택 사항이지만 권장
- 디스크 공간: 최소 2GB의 여유 공간(대형 저장소, worktree, 캐싱을 위해서는 더 많은 공간 권장)
다운로드
공식 웹사이트에서 Verdent를 다운로드합니다.
운영 체제를 선택해 알맞은 설치 프로그램을 다운로드합니다.
macOS 설치
다운로드
verdent.ai/download에서 .dmg 파일을 다운로드합니다.
DMG 열기
다운로드한 .dmg 파일을 두 번 선택해 마운트합니다.
설치
Verdent 아이콘을 Applications 폴더로 드래그합니다.
실행
Applications를 열고 Verdent를 두 번 선택합니다.
보안 승인
메시지가 표시되면 System Settings → Privacy & Security(macOS 13 이상) 또는 System Preferences → Security & Privacy(이전 macOS)를 열고 Open Anyway를 선택합니다.
지원되는 macOS 버전:
- macOS 11(Big Sur) 이상
- Intel 및 Apple Silicon 지원
Windows 설치
다운로드
verdent.ai/download에서 .exe 설치 프로그램을 다운로드합니다.
설치 프로그램 실행
다운로드한 .exe 파일을 두 번 선택합니다.
UAC 프롬프트
사용자 계정 컨트롤 메시지가 표시되면 Yes를 선택합니다.
설치 옵션
설치 프로그램의 안내를 따릅니다. 일부 빌드에서는 사용자 지정 설치 디렉터리를 제공하지 않을 수 있습니다.
완료
Install을 선택하고 완료될 때까지 기다립니다.
실행
Finish를 선택해 Verdent를 실행하거나 시작 메뉴에서 찾습니다.
지원되는 Windows 버전:
- Windows 10
- Windows 11
- 64비트 전용
인증 및 설정
설치 후 애플리케이션 사용을 시작하려면 Verdent 계정으로 인증해야 합니다.
초기 인증
Verdent 실행
Applications(macOS) 또는 시작 메뉴(Windows)에서 Verdent를 엽니다. 시작 화면이 표시됩니다.
로그인
Sign In을 선택합니다. 브라우저가 Verdent 인증 페이지를 엽니다.
브라우저 인증
Verdent 계정 자격 증명(이메일/비밀번호 또는 Google, GitHub 등의 OAuth 제공자)으로 로그인합니다.
앱으로 돌아가기
인증이 완료되면 Verdent로 돌아갑니다. 기본 인터페이스가 표시됩니다.
프로젝트 열기
디렉터리를 선택하려면 Open Project를 선택하고, 기존 프로젝트로 돌아가려면 Recent Projects를 선택합니다.
설치 확인
다음 간단한 확인을 통해 설치가 올바르게 작동하는지 확인합니다.
시각적 확인
- 애플리케이션 아이콘 - Verdent가 Applications(macOS) 또는 시작 메뉴(Windows)에 표시됩니다.
- 로그인됨 - 인증 후 앱에서 계정 상태(예: 아바타/이메일)를 확인할 수 있습니다.
기능 확인
프로젝트 열기
Verdent에서 디렉터리를 엽니다.
테스트 프롬프트 보내기
입력 상자에 "이 프로젝트에 무엇이 들어 있는지 설명해 줘" 같은 간단한 요청을 시도합니다.
응답 받기
Verdent가 프로젝트를 분석하고 곧 응답을 제공해야 합니다.
성공 지표:
- Verdent가 오류 없이 실행됨
- 계정 인증 성공
- 프롬프트를 보내고 응답을 받을 수 있음
Verdent의 AI 기능을 사용하려면 활성 인터넷 연결이 필요합니다. 프롬프트가 응답하지 않으면 네트워크 연결을 확인하고 방화벽이 Verdent의 API 엔드포인트로 나가는 HTTPS 연결을 허용하는지 확인합니다.
설치 문제 해결
문제: "Verdent cannot be opened because it is from an unidentified developer"
해결 방법:
- System Settings → Privacy & Security(macOS 13 이상) 또는 System Preferences → Security & Privacy(이전 macOS)를 엽니다.
- Verdent 경고 메시지를 찾습니다.
- Open Anyway를 선택합니다.
- Open을 선택해 확인합니다.
문제: Windows Defender가 설치를 차단함
해결 방법:
- SmartScreen 팝업에서 More info를 선택합니다.
- 공식 웹사이트에서 Verdent를 다운로드했고 출처를 신뢰한다면 Run anyway를 선택합니다.
- 설치를 계속합니다.
FAQ
Verdent를 VS Code 확장과 함께 설치할 수 있나요?
예. Verdent와 VS Code 확장은 독립적인 애플리케이션입니다. 둘 다 사용할 수 있으며, 동일한 크레딧 풀과 계정을 공유합니다.
Verdent를 어떻게 업데이트하나요?
Verdent는 실행 시 업데이트를 자동으로 확인합니다. 업데이트가 있으면:
- 알림이 표시됩니다.
- Update를 선택해 다운로드하고 설치합니다.
- 애플리케이션을 다시 시작합니다.
앱 메뉴에서도 수동으로 확인할 수 있습니다(예: Help → Check for Updates).
Verdent를 어떻게 제거하나요?
macOS: Applications에서 Verdent를 Trash로 드래그합니다.
Windows: Settings → Apps → Verdent → Uninstall 또는 Control Panel → Programs and Features를 사용합니다.