設定
自帶金鑰（BYOK）
在 Verdent Desktop 中使用你自己的供應商 API 金鑰，並了解 BYOK 模型的可用範圍
概覽
BYOK（自帶金鑰）讓你連接自己的供應商 API 金鑰，並直接在 Verdent 的內建代理中使用這些模型。
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。
支援的供應商
- Anthropic
- OpenAI
- OpenRouter
新增 API 金鑰
開啟模型設定
前往 Settings → Models → Configure Models。
開始新增金鑰
點擊右上角的 Add API Key +。
選擇供應商與模型
選擇供應商並挑選你想啟用的模型。
輸入憑證
新增你的 API 金鑰。
儲存並驗證
點擊 Save。Verdent 會自動驗證金鑰。
驗證結果
- 若驗證成功，金鑰會被儲存，所選的模型隨即可用。
- 若驗證失敗，Verdent 會顯示錯誤，讓你更新金鑰後再試一次。
管理既有的 API 金鑰
在 Settings → Models → Configure Models 下，你可以：
- 啟用或停用某供應商的所有模型
- 啟用或停用個別模型
- 編輯既有的 API 金鑰
- 刪除 API 金鑰
BYOK 模型出現的位置
新增有效金鑰後，BYOK 模型會出現在：
- 聊天模型選擇器
- 預設模型設定
- 子代理設定
- 審查者設定
啟用後，BYOK 模型的行為與內建模型相同。
限制
- Smart Suggestions 等內建功能不支援 BYOK API 金鑰。
- 自動壓縮不支援 BYOK API 金鑰。