# 自帶金鑰（BYOK） (/zh-Hant/docs/verdent-manager/configuration/byok)

> 在 Verdent Desktop 中使用你自己的供應商 API 金鑰，並了解 BYOK 模型的可用範圍



## 概覽 [#概覽]

BYOK（自帶金鑰）讓你連接自己的供應商 API 金鑰，並直接在 Verdent 的內建代理中使用這些模型。

### BYOK 與 BYOA [#byok-與-byoa]

Verdent 提供兩種「自帶」路徑，請勿混淆：

|              | BYOK                                 | BYOA                                                       |
| ------------ | ------------------------------------ | ---------------------------------------------------------- |
| **你帶來的東西**   | 供應商 API 金鑰                           | 代理執行環境（Codex / Claude Code）                                |
| **執行你任務的對象** | Verdent 的內建代理，透過你金鑰背後的供應商運作          | 你機器上的外部 CLI 代理                                             |
| **典型使用情境**   | 在你自己的帳務下存取模型，或使用預設未內建的供應商            | 保留既有的 Codex / Claude Code 工作流程，同時讓 Manager 將 Worker 任務分派給它 |
| **設定位置**     | Settings → Models → Configure Models | Settings → Models → CLI Agents                             |

關於在外部代理執行環境上執行 Worker 任務，請參閱 [BYOA](/docs/verdent-manager/configuration/byoa)。

## 支援的供應商 [#支援的供應商]

* Anthropic
* OpenAI
* OpenRouter

## 新增 API 金鑰 [#新增-api-金鑰]

<Steps>
  <Step title="開啟模型設定">
    前往 **Settings → Models → Configure Models**。
  </Step>

  <Step title="開始新增金鑰">
    點擊右上角的 &#x2A;*Add API Key +**。
  </Step>

  <Step title="選擇供應商與模型">
    選擇供應商並挑選你想啟用的模型。
  </Step>

  <Step title="輸入憑證">
    新增你的 API 金鑰。
  </Step>

  <Step title="儲存並驗證">
    點擊 **Save**。Verdent 會自動驗證金鑰。
  </Step>
</Steps>

### 驗證結果 [#驗證結果]

* 若驗證成功，金鑰會被儲存，所選的模型隨即可用。
* 若驗證失敗，Verdent 會顯示錯誤，讓你更新金鑰後再試一次。

## 管理既有的 API 金鑰 [#管理既有的-api-金鑰]

在 **Settings → Models → Configure Models** 下，你可以：

* 啟用或停用某供應商的所有模型
* 啟用或停用個別模型
* 編輯既有的 API 金鑰
* 刪除 API 金鑰

## BYOK 模型出現的位置 [#byok-模型出現的位置]

新增有效金鑰後，BYOK 模型會出現在：

* 聊天模型選擇器
* 預設模型設定
* 子代理設定
* 審查者設定

啟用後，BYOK 模型的行為與內建模型相同。

## 限制 [#限制]

* Smart Suggestions 等內建功能不支援 BYOK API 金鑰。
* 自動壓縮不支援 BYOK API 金鑰。