# 自带密钥（BYOK） (/zh-CN/docs/verdent-manager/configuration/byok)

> 在 Verdent Desktop 中使用你自己的提供商 API 密钥，并了解 BYOK 模型可在何处使用



## 概述 [#概述]

BYOK（自带密钥）让你可以接入自己的提供商 API 密钥，并直接在 Verdent 内置的智能体中使用这些模型。

### BYOK 与 BYOA 的区别 [#byok-与-byoa-的区别]

Verdent 提供两条“自带”路径——不要混淆：

|              | BYOK                        | BYOA                                                       |
| ------------ | --------------------------- | ---------------------------------------------------------- |
| **你带来什么**    | 提供商 API 密钥                  | 一个 Agent 运行时（Codex / Claude Code）                          |
| **由谁运行你的任务** | Verdent 的内置智能体，使用你密钥背后的提供商  | 你机器上的外部 CLI 智能体                                            |
| **典型使用场景**   | 在你自己的计费下访问某个模型，或使用默认未捆绑的提供商 | 保留你现有的 Codex / Claude Code 工作流，同时让 Manager 将 Worker 任务派发给它 |
| **配置位置**     | 设置 → 模型 → 配置模型              | 设置 → 模型 → CLI 智能体                                          |

关于在外部 Agent 运行时上运行 Worker 任务，参见 [BYOA](/docs/verdent-manager/configuration/byoa)。

## 支持的提供商 [#支持的提供商]

* Anthropic
* OpenAI
* OpenRouter

## 添加 API 密钥 [#添加-api-密钥]

<Steps>
  <Step title="打开模型配置">
    前往 **设置 → 模型 → 配置模型**。
  </Step>

  <Step title="开始添加密钥">
    点击右上角的 &#x2A;*Add API Key +**。
  </Step>

  <Step title="选择提供商和模型">
    选择一个提供商，并选择你想启用的模型。
  </Step>

  <Step title="输入凭据">
    添加你的 API 密钥。
  </Step>

  <Step title="保存并验证">
    点击 **Save**。Verdent 会自动验证该密钥。
  </Step>
</Steps>

### 验证结果 [#验证结果]

* 如果验证成功，密钥会被保存，所选模型将变为可用。
* 如果验证失败，Verdent 会显示错误，便于你更新密钥后重试。

## 管理已有的 API 密钥 [#管理已有的-api-密钥]

在 **设置 → 模型 → 配置模型** 下，你可以：

* 启用或禁用某个提供商的所有模型
* 启用或禁用单个模型
* 编辑已有的 API 密钥
* 删除 API 密钥

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

添加有效密钥后，BYOK 模型会出现在：

* 聊天模型选择器
* 预设模型配置
* 子智能体设置
* 审查器设置

启用后，BYOK 模型的行为与内置模型一致。

## 限制 [#限制]

* 智能建议（Smart Suggestions）等内置功能不支持 BYOK API 密钥。
* 自动压缩不支持 BYOK API 密钥。