# 系统要求与兼容性 (/zh-CN/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 版本 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 等编辑器。

***

## 硬件要求 [#硬件要求]

### 最低要求 [#最低要求]

| 组件       | 规格                                       |
| -------- | ---------------------------------------- |
| **内存**   | 1 GB（较大项目推荐 4 GB 以上）                     |
| **磁盘空间** | Visual Studio Code + Verdent 扩展小于 500 MB |
| **CPU**  | 任何能够运行 Visual Studio Code 的处理器           |

### 推荐配置 [#推荐配置]

为获得最佳性能，尤其是在处理大型代码库或多智能体工作流时：

* **内存**：8 GB 或更多
* **CPU**：多核处理器，用于并发执行子智能体
* **磁盘空间**：1 GB 以上，用于缓存和索引（如果启用）

<Tip>
  性能随硬件能力提升而提升。多智能体工作流和大规模重构会从更多的内存和处理能力中受益。
</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>