# 自帶代理（BYOA） (/zh-Hant/docs/verdent-manager/configuration/byoa)
> 在你自己的代理執行環境（例如 Codex 或 Claude Code）上執行 Manager 的 Worker 任務
## 什麼是 BYOA？ [#什麼是-byoa]
BYOA（Bring Your Own Agent，自帶代理）讓你選擇由哪個代理執行環境驅動 Manager 的 Worker。除了使用 Verdent 的預設代理之外，Manager 派發的 Worker 任務也可以在你已經使用或已取得授權的代理上執行。
想改用你自己的供應商 API 金鑰搭配 Verdent 內建代理嗎？請參閱 [BYOK](/docs/verdent-manager/configuration/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]
Codex 是 OpenAI 的程式設計代理 CLI。與 Claude Code 不同，Codex 在 Verdent 中不需要 API 金鑰——它使用你本機 Codex 環境中已設定好的驗證。
### 先決條件 [#先決條件]
* 已安裝 Codex CLI（`codex` 必須存在於你的 `PATH` 中）
* Codex CLI 已完成驗證並可在終端機中使用
### 設定步驟 [#設定步驟]
前往 **Settings → Models → CLI Agents**。
若看不到 Codex 卡片，請點擊 **Add CLI Agent**。Verdent 會掃描你系統的 `PATH` 以尋找 `codex` 指令。
開啟 **Codex** 切換開關。
Verdent 會自動偵測可用的模型。選取你想使用的模型。
### 模型探索 [#模型探索]
Codex 模型是動態探索的。啟動 Codex 後，Verdent 會透過其 `/models` API 取得可用的模型。若 Codex 端新增了模型，點擊 **Refresh Models** 即可更新清單。
### 驗證 [#驗證]
Verdent 不管理 Codex 的驗證。Codex 依賴你本機的 shell 環境（通常是 `OPENAI_API_KEY` 或其內建的登入流程）。只要 `codex` 能在你的終端機中運作，這項整合就能運作。
## Claude Code [#claude-code]
Claude Code 是 BYOA 中功能最豐富的代理，並支援多種供應商。你可以連接 Anthropic、OpenRouter、Zhipu GLM 等，並在模型選擇器中切換。
### 先決條件 [#先決條件-1]
* 已安裝 Node.js（僅需 `npx`）
Verdent 透過以下方式啟動 Claude Code：
```bash
npx -y @agentclientprotocol/claude-agent-acp
```
不需要全域安裝。
### 設定步驟 [#設定步驟-1]
前往 **Settings → Models → CLI Agents**。
若看不到 Claude Code 卡片，請點擊 **Add CLI Agent**。Verdent 會偵測 `npx`。
開啟 **Claude Code** 切換開關。
點擊 **Add provider** 並選擇一個供應商（例如 Anthropic）。
輸入 API 金鑰。預設值會自動填入。
可選擇性點擊 **Test Connection**，然後點擊 **Save**。
儲存後，該供應商底下的模型會出現在模型清單中。已啟用的模型預設為選取，但可以手動切換。
### 支援的供應商 [#支援的供應商]
Claude Code 支援多種供應商。你可以同時設定多個，所有模型都會出現在選擇器中。
#### Anthropic [#anthropic]
用於 Claude 模型的官方 Anthropic API。
* **驗證方式：** API Key
* **Base URL：** `https://api.anthropic.com`
* **模型：** Opus / Sonnet / Haiku
* **金鑰：** [platform.claude.com/settings/keys](https://platform.claude.com/settings/keys)
#### OpenRouter [#openrouter]
統一存取多家模型供應商的 API。
* **驗證方式：** Token
* **Base URL：** `https://openrouter.ai/api`
* **模型：** Opus / Sonnet / Haiku
* **金鑰：** [openrouter.ai/workspaces/default/keys](https://openrouter.ai/workspaces/default/keys)
你可以覆寫 Role Models，將請求路由到其他 OpenRouter 模型（例如 `google/gemini-2.5-pro`）。
#### Zhipu GLM（中國） [#zhipu-glm中國]
* **Base URL：** `https://open.bigmodel.cn/api/anthropic`
* **模型：** GLM-5
* **金鑰：** [bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
* **文件：** [docs.bigmodel.cn](https://docs.bigmodel.cn)
#### Zhipu GLM（全球） [#zhipu-glm全球]
* **Base URL：** `https://api.z.ai/api/anthropic`
* **模型：** GLM-5
* **金鑰：** [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)
* **文件：** [docs.z.ai](https://docs.z.ai)
#### Kimi [#kimi]
* **Base URL：** `https://api.kimi.com/coding/`
* **模型：** Kimi K2.5
* **金鑰：** [kimi.com/code/console](https://kimi.com/code/console)
* **文件：** [kimi.com/code/docs](https://kimi.com/code/docs)
#### Moonshot [#moonshot]
* **Base URL：** `https://api.moonshot.cn/anthropic`
* **模型：** Kimi K2.5
* **金鑰：** [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)
* **文件：** [platform.moonshot.cn/docs](https://platform.moonshot.cn/docs)
Kimi 與 Moonshot 都提供 Kimi K2.5，但使用不同的端點與驗證方式。請依你的金鑰來源選擇。
#### MiniMax（中國） [#minimax中國]
* **Base URL：** `https://api.minimaxi.com/anthropic`
* **模型：** MiniMax-M2.7
* **金鑰：** [platform.minimaxi.com](https://platform.minimaxi.com)
* **文件：** [platform.minimaxi.com/docs](https://platform.minimaxi.com/docs)
#### MiniMax（全球） [#minimax全球]
* **Base URL：** `https://api.minimax.io/anthropic`
* **模型：** MiniMax-M2.7
* **金鑰：** [platform.minimax.io](https://platform.minimax.io)
* **文件：** [platform.minimax.io/docs](https://platform.minimax.io/docs)
#### Xiaomi MiMo [#xiaomi-mimo]
* **Base URL：** `https://api.xiaomimimo.com/anthropic`
* **模型：** MiMo V2 Pro
* **金鑰：** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **文件：** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Xiaomi MiMo（Token 方案） [#xiaomi-mimotoken-方案]
* **Base URL：** `https://token-plan-cn.xiaomimimo.com/anthropic`
* **模型：** MiMo V2 Pro
* **金鑰：** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **文件：** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Anthropic 相容（自訂端點） [#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`）
大多數使用者不需要修改這些設定——預設值即可開箱即用。
## 在 Manager 中使用 BYOA 模型 [#在-manager-中使用-byoa-模型]
設定完成後：
在對話輸入框中關閉 **Auto** 模式。
開啟 **Task Model** 下拉選單。
挑選任何已啟用的 BYOA 模型。Worker 任務將使用該模型執行。
模型會顯示為：
* `GPT-5.4 Codex-CLI`（來自 Codex）
* `Claude-Opus-4.7 ClaudeCode-CLI`（來自 Claude Code）
將滑鼠停留在上方會顯示詳細資訊，例如 CLI 來源、模型名稱與供應商。
## 安全性與隱私 [#安全性與隱私]
* **僅本機儲存：** API 金鑰僅儲存於本機，絕不會上傳。
* **Claude Code 金鑰：** 安全儲存，不會寫入純文字設定檔。
* **Codex 驗證：** 完全由你的本機環境管理；Verdent 不會存取 OpenAI 金鑰。
## 常見問題 [#常見問題]
### 偵測不到 CLI Agent？ [#偵測不到-cli-agent]
請確認指令存在於 `PATH` 中：
* Claude Code 需要 `npx`（已安裝 Node.js）
* Codex 需要已安裝 `codex` CLI
執行：
```bash
which npx
which codex
```
### Test Connection 失敗？ [#test-connection-失敗]
* 確認 API 金鑰
* 檢查 base URL
* 確保可連線至 API 端點
* 若有使用代理伺服器，請檢查代理設定
### 已加入供應商但看不到模型？ [#已加入供應商但看不到模型]
* 確認 Claude Code 已啟用
* 確認供應商的模型已開啟
* 必要時重新啟動 Verdent