Bring Your Own Agent (BYOA)

BYOA とは？

BYOA（Bring Your Own Agent）を使うと、Manager の Worker を動かす Agent ランタイムを選択できます。Verdent のデフォルト Agent だけでなく、Manager がディスパッチする Worker タスクを、すでに使用している Agent やライセンスを持つ Agent 上で実行できます。

Verdent の組み込みエージェントで独自のプロバイダー API キーを使いたい場合は、BYOK を参照してください。

サポートされる 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 は 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 が利用可能なモデルを自動的に検出します。使用したいモデルを選択します。

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 キー
Base URL： https://api.anthropic.com
モデル： Opus / Sonnet / Haiku
キー： platform.claude.com/settings/keys

OpenRouter

複数のモデルプロバイダーへの統合 API アクセス。

認証： トークン
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 Plan）

Base URL： https://token-plan-cn.xiaomimimo.com/anthropic
モデル： MiMo V2 Pro
キー： platform.xiaomimimo.com
ドキュメント： platform.xiaomimimo.com/docs

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）

ほとんどのユーザーはこれらを変更する必要はありません。デフォルトのままで問題なく動作します。