---
title: 自带密钥（BYOK）
description: "在 Verdent Desktop 中使用你自己的提供商 API 密钥，并了解 BYOK 模型可在何处使用"
---

## 概述

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

### 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 密钥

<Steps>
  <Step title="打开模型配置">
    前往 **设置 → 模型 → 配置模型**。
  </Step>
  <Step title="开始添加密钥">
    点击右上角的 **Add API Key +**。
  </Step>
  <Step title="选择提供商和模型">
    选择一个提供商，并选择你想启用的模型。
  </Step>
  <Step title="输入凭据">
    添加你的 API 密钥。
  </Step>
  <Step title="保存并验证">
    点击 **Save**。Verdent 会自动验证该密钥。
  </Step>
</Steps>

### 验证结果

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

## 管理已有的 API 密钥

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

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

## BYOK 模型出现的位置

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

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

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

## 限制

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