---
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="點擊安裝">
        在 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 Mode（自動核准安全操作）
- **模型預設**：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 需要有效的網路連線。如果提示詞沒有回應，請確認你的網路連線狀況，以及防火牆設定允許對外連往 Verdent API 端點的 HTTPS 流量。
</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>