시스템 요구 사항 및 호환성
지원 플랫폼, IDE 버전, 네트워크 요구 사항
Verdent for VS Code은 운영 체제별로 별도 설치나 구성이 필요 없이 Visual Studio Code의 크로스 플랫폼 호환성을 그대로 활용하는 네이티브 Visual Studio Code 확장입니다.
지원 운영 체제
Verdent for VS Code은 Visual Studio Code을 사용할 수 있는 모든 운영 체제를 지원합니다.
| 운영 체제 | 지원 버전 | 아키텍처 |
|---|---|---|
| macOS | macOS 11(Big Sur) 이상 | Intel 및 Apple Silicon |
| Windows | Windows 10(버전 1607 이상), Windows 11, Windows Server 2016 이상 | 64비트만 지원 |
| Linux | Ubuntu 20.04 이상, Debian 10 이상, Red Hat Enterprise Linux 8 이상, Fedora, CentOS 8 이상, openSUSE Leap 15.2 이상 | x64 및 ARM64 |
지원 종료 플랫폼: macOS 10.15(Catalina) 지원은 Visual Studio Code 1.98(2025년 2월)에서 종료되었습니다. Windows 7 및 8/8.1은 Visual Studio Code 1.70(2022년 7월)부터 더 이상 지원되지 않습니다. Windows 32비트 시스템은 Visual Studio Code 1.83(2023년 9월)부터 더 이상 지원되지 않습니다.
Linux 요구 사항
Linux 시스템에서는 배포판이 다음 요구 사항을 충족하는지 확인합니다.
- glibc 2.28 이상(Visual Studio Code 1.86.1 기준, 2024년 1월)
- GLIBCXX 버전 3.4.25 이상
필요한 IDE/에디터 버전
Visual Studio Code:
- 버전 1.90.0 이상 필요
- 최상의 호환성을 위해 최신 안정 버전 권장
Verdent for VS Code은 Visual Studio Code 및 Visual Studio Code 기반 에디터(Cursor, VSCodium)와 함께 사용할 수 있습니다. JetBrains IDE, Sublime Text, Vim과 같은 에디터는 지원하지 않습니다.
하드웨어 요구 사항
최소 요구 사항
| 구성 요소 | 사양 |
|---|---|
| RAM | 1GB(대규모 프로젝트에는 4GB 이상 권장) |
| 디스크 공간 | Visual Studio Code + Verdent 확장에 500MB 미만 |
| CPU | Visual Studio Code을 실행할 수 있는 모든 프로세서 |
권장 사양
대규모 코드베이스나 멀티 에이전트 워크플로를 사용할 때 최적의 성능을 내려면 다음 사양을 권장합니다.
- RAM: 8GB 이상
- CPU: 동시 서브에이전트 실행을 위한 멀티코어 프로세서
- 디스크 공간: 캐싱 및 인덱싱 사용 시 1GB 이상
성능은 하드웨어 성능에 따라 달라집니다. 멀티 에이전트 워크플로와 대규모 리팩터링은 추가 RAM과 처리 성능이 있을 때 더 효과적입니다.
권장 사양은 일반적인 가이드라인입니다. Verdent 전용 기능(멀티 에이전트 워크플로, 캐싱, 인덱싱)에 대한 공식 하드웨어 권장 사항은 Verdent 팀에서 아직 제공되지 않았습니다.
네트워크 요구 사항
Verdent for VS Code이 작동하려면 항상 활성 인터넷 연결이 필요합니다.
연결 요구 사항
- 연결 유형: 안정적인 광대역 인터넷 연결
- 프로토콜: Verdent의 API 엔드포인트로 나가는 HTTPS 연결
- 대역폭: 코드 컨텍스트 전송 및 AI 응답 스트리밍에 충분한 대역폭
방화벽 및 프록시 고려 사항
기업 환경이거나 방화벽 뒤에서 사용하는 경우:
필수 접근 권한:
- Verdent의 API 도메인으로 나가는 HTTPS 트래픽
- Verdent이 여러 모델 제공자(Claude, GPT-5, Gemini, MiniMax 등)로의 라우팅을 처리합니다.
- 인바운드 방화벽 규칙이나 포트 포워딩은 필요하지 않습니다.
엔터프라이즈 설정:
- 기업 방화벽은 Verdent 서비스 엔드포인트로 나가는 HTTPS를 허용해야 합니다.
- 프록시 서버는 API 요청을 통과시켜야 합니다.
- SSL/TLS 검사는 Verdent 엔드포인트에 대한 예외가 필요할 수 있습니다.
인터넷 연결이 없으면 Verdent for VS Code은 요청을 처리하거나 AI 지원 기능을 제공할 수 없습니다. 이 확장은 오프라인에서 작동하지 않습니다.
FAQ
내 Visual Studio Code 버전은 어떻게 확인하나요?
Visual Studio Code을 열고 Help → About으로 이동합니다(macOS에서는 Code → About Visual Studio Code). 대화 상자에 버전 번호가 표시됩니다. Verdent에는 Visual Studio Code 버전 1.90.0 이상이 필요합니다.
명령줄에서도 확인할 수 있습니다.
code --version내 Linux 시스템이 요구 사항을 충족하는지 어떻게 확인하나요?
다음 명령으로 glibc 및 GLIBCXX 버전을 확인합니다.
# Check glibc version (need 2.28 or later)
ldd --version
# Check GLIBCXX version (need 3.4.25 or later)
strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX사용 중인 배포판이 이 요구 사항을 충족하지 않는다면 더 최신 버전의 Linux 배포판으로 업그레이드해야 할 수 있습니다.
방화벽 또는 연결 문제는 어떻게 해결하나요?
Verdent이 AI 서비스에 연결할 수 없다면 다음과 같은 일반적인 문제를 확인합니다.
기본 연결 테스트:
- 인터넷에 정상적으로 연결되어 있는지 확인합니다.
- 다른 HTTPS 서비스에 접속해 나가는 연결이 작동하는지 확인합니다.
기업/엔터프라이즈 환경:
- 네트워크 관리자에게 Verdent의 API 엔드포인트를 허용 목록에 추가해 달라고 요청합니다.
- 방화벽에서 나가는 HTTPS 트래픽이 허용되는지 확인합니다.
- 프록시 서버가 API 요청을 통과하도록 올바르게 구성되어 있는지 확인합니다.
- SSL/TLS 검사는 Verdent 엔드포인트에 대한 예외가 필요할 수 있습니다.
일반적인 증상:
- 확장이 멈춘 것처럼 보이거나 시간 초과가 발생합니다.
- 올바른 자격 증명을 사용해도 인증에 실패합니다.
방화벽을 구성한 뒤에도 문제가 계속되면 허용 목록에 추가할 구체적인 엔드포인트 정보를 위해 Verdent 지원팀에 문의하세요.