自帶代理（BYOA）

什麼是 BYOA？

BYOA（Bring Your Own Agent，自帶代理）讓你選擇由哪個代理執行環境驅動 Manager 的 Worker。除了使用 Verdent 的預設代理之外，Manager 派發的 Worker 任務也可以在你已經使用或已取得授權的代理上執行。

想改用你自己的供應商 API 金鑰搭配 Verdent 內建代理嗎？請參閱 BYOK。

支援的代理類型

代理	說明	先決條件
Built-in Agent	Verdent 提供的預設代理	無
Claude Code	Anthropic 的 Claude Code CLI	已安裝 Node.js（用於 `npx`）
Codex	OpenAI Codex CLI	已安裝 Codex CLI 並完成 OpenAI 環境設定

使用情境

存取特定模型 — 透過模型選擇器，使用 Verdent 預設集合中未包含的模型版本。
團隊標準化 — 使用共用的企業授權，讓團隊用量集中計費。
熟悉的工作流程 — 保留你既有的 Claude Code 或 Codex 體驗，同時讓 Manager 將 Worker 任務派發給它。

快速存取

BYOA 設定：Settings → Models → CLI Agents
在 Manager 對話中選擇模型：在輸入框中關閉 Auto 模式以挑選 Task Model
在 BYOA 中設定的 API 金鑰僅儲存於本機，絕不會上傳至 Verdent 伺服器

Codex

Codex 是 OpenAI 的程式設計代理 CLI。與 Claude Code 不同，Codex 在 Verdent 中不需要 API 金鑰——它使用你本機 Codex 環境中已設定好的驗證。

先決條件

已安裝 Codex CLI（codex 必須存在於你的 PATH 中）
Codex CLI 已完成驗證並可在終端機中使用

設定步驟

開啟 CLI Agents 設定

前往 Settings → Models → CLI Agents。

若缺少 Codex 則加入

若看不到 Codex 卡片，請點擊 Add CLI Agent。Verdent 會掃描你系統的 PATH 以尋找 codex 指令。

啟用 Codex

開啟 Codex 切換開關。

選擇模型

Verdent 會自動偵測可用的模型。選取你想使用的模型。

模型探索

Codex 模型是動態探索的。啟動 Codex 後，Verdent 會透過其 /models API 取得可用的模型。若 Codex 端新增了模型，點擊 Refresh Models 即可更新清單。

驗證

Verdent 不管理 Codex 的驗證。Codex 依賴你本機的 shell 環境（通常是 OPENAI_API_KEY 或其內建的登入流程）。只要 codex 能在你的終端機中運作，這項整合就能運作。

Claude Code

Claude Code 是 BYOA 中功能最豐富的代理，並支援多種供應商。你可以連接 Anthropic、OpenRouter、Zhipu GLM 等，並在模型選擇器中切換。

先決條件

已安裝 Node.js（僅需 npx）

Verdent 透過以下方式啟動 Claude Code：

npx -y @agentclientprotocol/claude-agent-acp

不需要全域安裝。

設定步驟

開啟 CLI Agents 設定

前往 Settings → Models → CLI Agents。

若缺少 Claude Code 則加入

若看不到 Claude Code 卡片，請點擊 Add CLI Agent。Verdent 會偵測 npx。

啟用 Claude Code

開啟 Claude Code 切換開關。

加入供應商

點擊 Add provider 並選擇一個供應商（例如 Anthropic）。

輸入憑證

輸入 API 金鑰。預設值會自動填入。

測試並儲存

可選擇性點擊 Test Connection，然後點擊 Save。

儲存後，該供應商底下的模型會出現在模型清單中。已啟用的模型預設為選取，但可以手動切換。

支援的供應商

Claude Code 支援多種供應商。你可以同時設定多個，所有模型都會出現在選擇器中。

Anthropic

用於 Claude 模型的官方 Anthropic API。

驗證方式： API Key
Base URL： https://api.anthropic.com
模型： Opus / Sonnet / Haiku
金鑰： platform.claude.com/settings/keys

OpenRouter

統一存取多家模型供應商的 API。

驗證方式： Token
Base URL： https://openrouter.ai/api
模型： Opus / Sonnet / Haiku
金鑰： openrouter.ai/workspaces/default/keys

你可以覆寫 Role Models，將請求路由到其他 OpenRouter 模型（例如 google/gemini-2.5-pro）。

Zhipu GLM（中國）

Base URL： https://open.bigmodel.cn/api/anthropic
模型： GLM-5
金鑰： bigmodel.cn/usercenter/proj-mgmt/apikeys
文件： docs.bigmodel.cn

Zhipu GLM（全球）

Base URL： https://api.z.ai/api/anthropic
模型： GLM-5
金鑰： z.ai/manage-apikey/apikey-list
文件： docs.z.ai

Kimi

Base URL： https://api.kimi.com/coding/
模型： Kimi K2.5
金鑰： kimi.com/code/console
文件： kimi.com/code/docs

Moonshot

Base URL： https://api.moonshot.cn/anthropic
模型： Kimi K2.5
金鑰： platform.moonshot.cn/console/api-keys
文件： platform.moonshot.cn/docs

Kimi 與 Moonshot 都提供 Kimi K2.5，但使用不同的端點與驗證方式。請依你的金鑰來源選擇。

MiniMax（中國）

Base URL： https://api.minimaxi.com/anthropic
模型： MiniMax-M2.7
金鑰： platform.minimaxi.com
文件： platform.minimaxi.com/docs

MiniMax（全球）

Base URL： https://api.minimax.io/anthropic
模型： MiniMax-M2.7
金鑰： platform.minimax.io
文件： platform.minimax.io/docs

Xiaomi MiMo

Base URL： https://api.xiaomimimo.com/anthropic
模型： MiMo V2 Pro
金鑰： platform.xiaomimimo.com
文件： platform.xiaomimimo.com/docs

Xiaomi MiMo（Token 方案）

Base URL： https://token-plan-cn.xiaomimimo.com/anthropic
模型： MiMo V2 Pro
金鑰： platform.xiaomimimo.com
文件： platform.xiaomimimo.com/docs

Anthropic 相容（自訂端點）

適用於任何與 Anthropic API 格式相容的服務。

驗證方式： API Key 或 Token（可切換）
Base URL： 手動設定
模型： 手動指定

若你的供應商未列出但支援 Anthropic 相容的 API，請使用此選項。

進階選項

在供應商設定面板中，展開 Advanced Options 以存取 JSON 編輯器：

Role Models 對應：
- ANTHROPIC_DEFAULT_OPUS_MODEL
- ANTHROPIC_DEFAULT_SONNET_MODEL
- ANTHROPIC_DEFAULT_HAIKU_MODEL
- CLAUDE_CODE_SUBAGENT_MODEL
自訂環境變數（例如 API_TIMEOUT_MS）

大多數使用者不需要修改這些設定——預設值即可開箱即用。