# Bring Your Own Agent (BYOA) (/ja/docs/verdent-manager/configuration/byoa)
> Manager の Worker タスクを Codex や Claude Code など、独自の Agent ランタイムで実行する
## BYOA とは？ [#byoa-とは]
BYOA（Bring Your Own Agent）を使うと、Manager の Worker を動かす Agent ランタイムを選択できます。Verdent のデフォルト Agent だけでなく、Manager がディスパッチする Worker タスクを、すでに使用している Agent やライセンスを持つ Agent 上で実行できます。
Verdent の組み込みエージェントで独自のプロバイダー API キーを使いたい場合は、[BYOK](/docs/verdent-manager/configuration/byok) を参照してください。
## サポートされる Agent タイプ [#サポートされる-agent-タイプ]
| Agent | 説明 | 前提条件 |
| -------------- | --------------------------- | ----------------------------------- |
| Built-in Agent | Verdent が提供するデフォルトの Agent | なし |
| 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 はローカルのシェル環境（通常は `OPENAI_API_KEY`、またはその組み込みログインフロー）に依存します。ターミナルで `codex` が動作している限り、この連携も機能します。
## Claude Code [#claude-code]
Claude Code は BYOA で最も機能が豊富な Agent で、複数のプロバイダーをサポートします。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 キー
* **Base URL：** `https://api.anthropic.com`
* **モデル：** Opus / Sonnet / Haiku
* **キー：** [platform.claude.com/settings/keys](https://platform.claude.com/settings/keys)
#### OpenRouter [#openrouter]
複数のモデルプロバイダーへの統合 API アクセス。
* **認証：** トークン
* **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 Plan） [#xiaomi-mimotoken-plan]
* **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 キーまたはトークン（切り替え可能）
* **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 キーにアクセスしません。
## FAQ [#faq]
### 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 を再起動する