---
title: 系统要求与兼容性
description: 支持的平台、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 系统，请确保你的发行版满足以下要求：

* **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 等编辑器。

---

## 硬件要求

### 最低要求

| 组件 | 规格 |
|-----------|---------------|
| **内存** | 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>