# Bring Your Own Key (BYOK) (/ja/docs/verdent-manager/configuration/byok)

> Verdent Desktop で自分のプロバイダーの API キーを使用し、BYOK モデルが利用できる場所を理解する



## 概要 [#概要]

BYOK（Bring Your Own Key）を使うと、自分のプロバイダーの API キーを接続し、それらのモデルを Verdent の組み込みエージェント内で直接使用できます。

### BYOK と BYOA の違い [#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](/docs/verdent-manager/configuration/byoa) を参照してください。

## サポートされているプロバイダー [#サポートされているプロバイダー]

* Anthropic
* OpenAI
* OpenRouter

## API キーを追加する [#api-キーを追加する]

<Steps>
  <Step title="モデル設定を開く">
    **Settings → Models → Configure Models** を開きます。
  </Step>

  <Step title="キーの追加を開始する">
    右上の &#x2A;*Add API Key +** を選択します。
  </Step>

  <Step title="プロバイダーとモデルを選択する">
    プロバイダーを選択し、有効にしたいモデルを選びます。
  </Step>

  <Step title="認証情報を入力する">
    API キーを追加します。
  </Step>

  <Step title="保存して検証する">
    **Save** を選択します。Verdent が自動的にキーを検証します。
  </Step>
</Steps>

### 検証結果 [#検証結果]

* 検証に成功すると、キーが保存され、選択したモデルが利用可能になります。
* 検証に失敗すると、Verdent がエラーを表示するので、キーを更新して再試行できます。

## 既存の API キーを管理する [#既存の-api-キーを管理する]

**Settings → Models → Configure Models** では、次の操作ができます。

* プロバイダーのすべてのモデルを有効化または無効化する
* 個別のモデルを有効化または無効化する
* 既存の API キーを編集する
* API キーを削除する

## BYOK モデルが表示される場所 [#byok-モデルが表示される場所]

有効なキーを追加すると、BYOK モデルは次の場所に表示されます。

* チャットのモデルセレクター
* プリセットのモデル設定
* サブエージェントの設定
* レビュアーの設定

BYOK モデルは、有効化されると組み込みモデルと同じように動作します。

## 制限事項 [#制限事項]

* Smart Suggestions などの組み込み機能は BYOK API キーをサポートしていません。
* 自動圧縮は BYOK API キーをサポートしていません。
