設定
Bring Your Own Key (BYOK)
Verdent Desktop で自分のプロバイダーの API キーを使用し、BYOK モデルが利用できる場所を理解する
概要
BYOK（Bring Your Own Key）を使うと、自分のプロバイダーの API キーを接続し、それらのモデルを Verdent の組み込みエージェント内で直接使用できます。
BYOK と BYOA の違い
Verdent には「自分のものを持ち込む」2つの方法があります。混同しないようにしてください。
| BYOK | BYOA | |
|---|---|---|
| 持ち込むもの | プロバイダーの API キー | Agent ランタイム（Codex / Claude Code） |
| タスクを実行するもの | Verdent の組み込みエージェント（キーの背後にあるプロバイダーを使用） | お使いのマシン上の外部 CLI エージェント |
| 代表的なユースケース | 自分の請求でモデルにアクセスする、またはデフォルトでバンドルされていないプロバイダーを使用する | 既存の Codex / Claude Code のワークフローを維持しつつ、Manager が Worker タスクをそこへ振り分けられるようにする |
| 設定場所 | Settings → Models → Configure Models | Settings → Models → CLI Agents |
外部 Agent ランタイムで 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 キーをサポートしていません。