配置
自带密钥（BYOK）
在 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。
支持的提供商
- Anthropic
- OpenAI
- OpenRouter
添加 API 密钥
打开模型配置
前往 设置 → 模型 → 配置模型。
开始添加密钥
点击右上角的 Add API Key +。
选择提供商和模型
选择一个提供商，并选择你想启用的模型。
输入凭据
添加你的 API 密钥。
保存并验证
点击 Save。Verdent 会自动验证该密钥。
验证结果
- 如果验证成功，密钥会被保存，所选模型将变为可用。
- 如果验证失败，Verdent 会显示错误，便于你更新密钥后重试。
管理已有的 API 密钥
在 设置 → 模型 → 配置模型 下，你可以：
- 启用或禁用某个提供商的所有模型
- 启用或禁用单个模型
- 编辑已有的 API 密钥
- 删除 API 密钥
BYOK 模型出现的位置
添加有效密钥后，BYOK 模型会出现在：
- 聊天模型选择器
- 预设模型配置
- 子智能体设置
- 审查器设置
启用后，BYOK 模型的行为与内置模型一致。
限制
- 智能建议（Smart Suggestions）等内置功能不支持 BYOK API 密钥。
- 自动压缩不支持 BYOK API 密钥。