# 系統需求與相容性 (/zh-Hant/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 (version 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 version 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**  | 1 GB（較大型專案建議 4 GB 以上）                        |
| **磁碟空間** | Visual Studio Code + Verdent 擴充功能需 \< 500 MB |
| **CPU**  | 任何能執行 Visual Studio Code 的處理器                |

### 建議規格 [#建議規格]

為獲得最佳效能，尤其是在處理大型程式碼庫或多代理工作流程時：

* **RAM**：8 GB 或以上
* **CPU**：多核心處理器以支援並行的子代理執行
* **磁碟空間**：1 GB 以上用於快取與索引（如有啟用）

<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>

***

## 常見問題 [#常見問題]

<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>