# 시스템 요구 사항 및 호환성 (/ko/docs/verdent-for-vscode/getting-started/system-requirements)

> 지원 플랫폼, 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           |

<Note>
  **지원 종료 플랫폼**: 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월)부터 더 이상 지원되지 않습니다.
</Note>

### Linux 요구 사항 [#linux-요구-사항]

Linux 시스템에서는 배포판이 다음 요구 사항을 충족하는지 확인합니다.

* **glibc 2.28 이상**(Visual Studio Code 1.86.1 기준, 2024년 1월)
* **GLIBCXX 버전 3.4.25 이상**

***

## 필요한 IDE/에디터 버전 [#필요한-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 이상

<Tip>
  성능은 하드웨어 성능에 따라 달라집니다. 멀티 에이전트 워크플로와 대규모 리팩터링은 추가 RAM과 처리 성능이 있을 때 더 효과적입니다.
</Tip>

<Warning>
  권장 사양은 일반적인 가이드라인입니다. Verdent 전용 기능(멀티 에이전트 워크플로, 캐싱, 인덱싱)에 대한 공식 하드웨어 권장 사항은 Verdent 팀에서 아직 제공되지 않았습니다.
</Warning>

***

## 네트워크 요구 사항 [#네트워크-요구-사항]

Verdent for VS Code이 작동하려면 **항상 활성 인터넷 연결**이 필요합니다.

### 연결 요구 사항 [#연결-요구-사항]

* **연결 유형**: 안정적인 광대역 인터넷 연결
* **프로토콜**: Verdent의 API 엔드포인트로 나가는 HTTPS 연결
* **대역폭**: 코드 컨텍스트 전송 및 AI 응답 스트리밍에 충분한 대역폭

### 방화벽 및 프록시 고려 사항 [#방화벽-및-프록시-고려-사항]

기업 환경이거나 방화벽 뒤에서 사용하는 경우:

**필수 접근 권한:**

* Verdent의 API 도메인으로 나가는 HTTPS 트래픽
* Verdent이 여러 모델 제공자(Claude, GPT-5, Gemini, MiniMax 등)로의 라우팅을 처리합니다.
* 인바운드 방화벽 규칙이나 포트 포워딩은 필요하지 않습니다.

**엔터프라이즈 설정:**

* 기업 방화벽은 Verdent 서비스 엔드포인트로 나가는 HTTPS를 허용해야 합니다.
* 프록시 서버는 API 요청을 통과시켜야 합니다.
* SSL/TLS 검사는 Verdent 엔드포인트에 대한 예외가 필요할 수 있습니다.

<Warning>
  인터넷 연결이 없으면 Verdent for VS Code은 요청을 처리하거나 AI 지원 기능을 제공할 수 없습니다. 이 확장은 오프라인에서 작동하지 않습니다.
</Warning>

***

## FAQ [#faq]

<Accordion title="내 Visual Studio Code 버전은 어떻게 확인하나요?">
  Visual Studio Code을 열고 **Help** → **About**으로 이동합니다(macOS에서는 **Code** → **About Visual Studio Code**). 대화 상자에 버전 번호가 표시됩니다. Verdent에는 Visual Studio Code 버전 1.90.0 이상이 필요합니다.

  명령줄에서도 확인할 수 있습니다.

  ```bash
  code --version
  ```
</Accordion>

<Accordion title="내 Linux 시스템이 요구 사항을 충족하는지 어떻게 확인하나요?">
  다음 명령으로 glibc 및 GLIBCXX 버전을 확인합니다.

  ```bash
  # 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 배포판으로 업그레이드해야 할 수 있습니다.
</Accordion>

<Accordion title="방화벽 또는 연결 문제는 어떻게 해결하나요?">
  Verdent이 AI 서비스에 연결할 수 없다면 다음과 같은 일반적인 문제를 확인합니다.

  **기본 연결 테스트:**

  * 인터넷에 정상적으로 연결되어 있는지 확인합니다.
  * 다른 HTTPS 서비스에 접속해 나가는 연결이 작동하는지 확인합니다.

  **기업/엔터프라이즈 환경:**

  * 네트워크 관리자에게 Verdent의 API 엔드포인트를 허용 목록에 추가해 달라고 요청합니다.
  * 방화벽에서 나가는 HTTPS 트래픽이 허용되는지 확인합니다.
  * 프록시 서버가 API 요청을 통과하도록 올바르게 구성되어 있는지 확인합니다.
  * SSL/TLS 검사는 Verdent 엔드포인트에 대한 예외가 필요할 수 있습니다.

  **일반적인 증상:**

  * 확장이 멈춘 것처럼 보이거나 시간 초과가 발생합니다.
  * 올바른 자격 증명을 사용해도 인증에 실패합니다.

  방화벽을 구성한 뒤에도 문제가 계속되면 허용 목록에 추가할 구체적인 엔드포인트 정보를 위해 Verdent 지원팀에 문의하세요.
</Accordion>

***

## 함께 보기 [#함께-보기]

<CardGroup cols="2">
  <Card title="설치" icon="download" href="/docs/verdent-for-vscode/getting-started/installation">
    시스템 요구 사항을 확인한 뒤 Verdent을 설치합니다.
  </Card>

  <Card title="문제 해결" icon="wrench" href="/docs/verdent-for-vscode/help-support/common-issues">
    일반적인 설치 및 연결 문제를 해결합니다.
  </Card>
</CardGroup>