---
title: "安装"
description: "安装并设置 Verdent 的分步指南"
---

本指南将引导你从 Visual Studio Code Marketplace 安装 Verdent for VS Code，并完成初始身份验证。

---

## 系统要求

在安装 Verdent 之前，请确保你的系统满足以下前提条件：

### 系统要求

- **Visual Studio Code**：版本 1.90.0 或更高
- **操作系统**：macOS 11+、Windows 10+ 或 Linux（Ubuntu 20.04+、Debian 10+、RHEL 8+）
- **网络连接**：与 AI 服务通信需要有效的网络连接

### 可选但推荐

- **Git**：用于版本控制集成并追踪代码变更

详细的兼容性信息请参阅[系统要求](/docs/verdent-for-vscode/getting-started/system-requirements)。

---

## 安装扩展

Verdent for VS Code 通过 Visual Studio Code Marketplace 分发。

<Tabs>
  <Tab title="VS Code Marketplace">
    <Steps>
      <Step title="访问 Marketplace">
        在浏览器中打开 [Verdent 扩展页面](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent)。
      </Step>
      <Step title="点击 Install">
        在 Marketplace 页面点击 **Install** 按钮。
      </Step>
      <Step title="在 VS Code 中打开">
        VS Code 将自动打开并开始安装流程。
      </Step>
    </Steps>
  </Tab>
  <Tab title="扩展面板">
    <Steps>
      <Step title="打开 VS Code">
        在你的电脑上启动 Visual Studio Code。
      </Step>
      <Step title="进入扩展面板">
        点击左侧边栏中的扩展图标（四个方块的图标），或按：

        - **macOS**：`Cmd+Shift+X`
        - **Windows/Linux**：`Ctrl+Shift+X`
      </Step>
      <Step title="搜索 Verdent">
        在扩展面板顶部的搜索框中输入 “Verdent”。在结果中查找由 Verdent AI 发布的 “Verdent”。
      </Step>
      <Step title="安装">
        点击 Verdent 扩展旁边的 **Install** 按钮。安装通常只需几秒钟。
      </Step>
    </Steps>
  </Tab>
  <Tab title="命令行">
    ```bash
    code --install-extension verdentai.verdent
    ```

    此方法适用于：

    - 自动化安装脚本
    - 通过 SSH 在远程服务器上安装
    - CI/CD 环境配置
    - 快速在多台机器上安装
  </Tab>
</Tabs>

<Tip>
  如果你使用 VS Code 设置同步（Settings Sync），当你同步扩展列表时，Verdent 会自动安装到新机器上。
</Tip>

---

## 身份验证与设置

安装完成后，你需要使用 Verdent 账户进行身份验证，才能开始使用扩展。

### 初始身份验证

<Steps>
  <Step title="打开 Verdent">
    安装完成后，点击 VS Code 边栏中的 Verdent 图标。你将看到登录 / 注册选项。
  </Step>
  <Step title="登录">
    点击 **Sign In**。VS Code 会弹出提示 “Do you want Code to open the external website?” —— 点击 **Open**。
  </Step>
  <Step title="浏览器身份验证">
    你的浏览器将打开 Verdent 身份验证页面。使用你的 Verdent 账户凭据登录（邮箱/密码，或 Google、GitHub 等 OAuth 提供商）。
  </Step>
  <Step title="授权 VS Code">
    在提示时，授予 VS Code 访问你的 Verdent 账户的权限。
  </Step>
  <Step title="返回 VS Code">
    身份验证完成后返回 VS Code。Verdent 面板此时将显示输入界面。
  </Step>
</Steps>

**总耗时：** 完整的安装和设置约需 2-3 分钟。

### 初始配置（可选）

Verdent for VS Code 设计为在身份验证后即可立即使用，所需配置极少。

**默认设置：**

- **权限模式**：Auto-Run 模式（自动批准安全操作）
- **模型预设**：Balance（性能/成本的最佳平衡）
- **上下文管理**：自动

**可选自定义：**

你可以稍后通过 Verdent 面板调整这些设置：

- **权限模式** —— 选择 Manual Accept、Auto-Run、Plan Mode 或 Skip Permissions
- **模型选择** —— 选择 Performance、Balance、Efficiency 预设或特定模型
- **工作区设置** —— 配置项目专属偏好

<Note>
  大多数用户在登录后无需任何额外配置即可立即开始使用 Verdent。高级设置可按需调整。
</Note>

---

## 验证安装

通过以下简单检查确认你的安装是否正常工作：

### 可视化验证

1. **边栏图标** —— 在 VS Code 边栏（左侧）中查找 Verdent 图标
2. **扩展列表** —— 打开扩展面板（`Cmd+Shift+X` / `Ctrl+Shift+X`），确认 “Verdent” 显示为已安装并带有勾选标记

### 功能验证

<Steps>
  <Step title="打开 Verdent 面板">
    点击边栏中的 Verdent 图标，或按 `Cmd+L`（macOS）/ `Ctrl+L`（Windows/Linux）。
  </Step>
  <Step title="发送测试提示词">
    在输入框中尝试一个简单请求，例如 “Explain what this workspace contains”。
  </Step>
  <Step title="接收响应">
    Verdent 应在几秒内分析你的工作区并给出响应。
  </Step>
</Steps>

**成功标志：**

- 边栏中可见 Verdent 图标
- 账户身份验证成功
- 能够发送提示词并接收响应

### 故障排查

如果验证失败，请尝试以下解决方案：

| 问题                 | 解决方案                                        |
| --------------------- | ----------------------------------------------- |
| 边栏图标缺失  | 重启 VS Code 或检查扩展更新  |
| 提示词无响应 | 检查网络连接和防火墙设置 |
| 找不到扩展   | 确保 VS Code 版本为 1.90.0 或更高      |

<Warning>
  Verdent 需要有效的网络连接。如果提示词没有响应，请确认你的网络连通性和防火墙配置允许出站 HTTPS 访问 Verdent 的 API 端点。
</Warning>

---

## 后续步骤

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    在 5 分钟内用 Verdent 完成你的第一个任务
  </Card>
  <Card title="核心概念" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    了解子智能体、执行模式和多智能体架构
  </Card>
</CardGroup>