アダプターとモデルを管理
このガイドでは、モデルプロバイダーを接続し、エージェントが何で実行されるかを選ぶ方法を説明します。
ここで扱う内容はすべて 1 つのページにあります: 設定 → サーバー → モデルプロバイダー。サブサイドバーの項目は「モデルプロバイダー」、ページの見出しは「アダプター」です。
アダプターとは
「アダプターとは」というセクションアダプターとは、エージェントの 1 ターンを実行する_ランナー_です。2 つだけであり、この一覧は固定です。3 つ目を追加することはできません。
| アダプター | CLI | トランスポート |
|---|---|---|
| Control Center (built-in) | なし | インプロセスのエージェントループで、プロバイダーとは HTTP で通信する |
| Claude Code | claude |
claude -p --output-format stream-json |
Cursor、Codex、Anthropic、OpenAI などは、別個の CLI ではなく、組み込みアダプター上のプロバイダーです。追加_できる_のは別のプロバイダー、つまり OpenAI または Anthropic 互換の任意のエンドポイントです。それは次のセクションで扱います。
モデルプロバイダーを接続
「モデルプロバイダーを接続」というセクション組み込みアダプターは、実行する前に少なくとも 1 つの接続済みプロバイダーが必要です。カタログには 14 個が同梱されています。
- 設定 → サーバー → モデルプロバイダーに移動します
- プロバイダーとモデルまでスクロールします
- 使うプロバイダーを見つけて接続します:
| プロバイダー | 接続方法 |
|---|---|
| Anthropic | API キー。Claude Pro/Max サブスクリプションは Anthropic API のログインではないため、そのプランでは Claude Code アダプターを使用してください |
| OpenAI、Codex、Cursor | ブラウザーでの OAuth ログイン、または API キー。Codex は CLI の起動ではなく、Codex Responses バックエンド経由の ChatGPT Plus/Pro です |
| Kimi Code | ブラウザー OAuth のみ（デバイスコードフロー）。定額プランなので、トークン単位の料金はありません |
| OpenRouter、Google Gemini、DeepSeek、Mistral、xAI、z.ai、z.ai GLM Coding Plan、Moonshot (Kimi API) | API キー |
確認ポイント: 行のバッジが接続済みに変わり、展開するとそのプロバイダーが提供するモデルが一覧されます。各モデルには 100 万トークンあたりの料金とコンテキストウィンドウが表示されます。
OAuth トークンはサーバー自身の資格情報ストアに保存され、期限切れになる前に更新されます。プロバイダーの資格情報はホストグローバルであり、1 つのワークスペースに限定されず、インストール上のすべてのワークスペースで共有されます。
カスタムプロバイダーを追加
「カスタムプロバイダーを追加」というセクションOllama、LM Studio、vLLM、またはプライベートデプロイメントに使用します。
- プロバイダーとモデルのカスタムプロバイダーで、プロバイダーを追加を押します
- 名前を入力し、API の種類（OpenAI 互換または Anthropic 互換）を選び、ベース URL を指定します（例:
http://localhost:11434/v1） - エンドポイントに必要な場合は API キーを追加し、プロバイダーを追加を押します
カスタムプロバイダーは同じ一覧に表示され、組み込みの兄弟にはない削除ボタンが付きます。
エージェントで使うモデルを選ぶ
「エージェントで使うモデルを選ぶ」というセクション- 設定 → ワークスペース → エージェントに移動し、エージェントを選択します
- 設定タブでアダプターを選びます
- その隣のドロップダウンからモデルを選びます
組み込みアダプターでは、ドロップダウンは接続済みの各プロバイダー自身のカタログからリアルタイムに組み立てられます。資格情報が保存されていないプロバイダーはモデルを 1 つも提供しないため、ドロップダウンが空のときはほぼ常に「利用可能なものがない」ではなく「まだ何も接続していない」という意味になります。
組み込みアダプターのモデル ID は provider/model という修飾形式で、| で区切られたフォールバックチェーンを持てます。フォールバック時は、要求したモデルではなく、実際にそのターンを処理したモデルに対してコストが計算されます。
ランナー CLI をインストール
「ランナー CLI をインストール」というセクション組み込みアダプターにはインストールは不要です。Claude Code の場合は、そのツール自身のパッケージマネージャーで CLI をサーバーホストにインストールします。例:
npm install -g @anthropic-ai/claude-codeその後、ページ上部の更新を押します。検出された各行には、解決されたバージョンとパス、および JSON モードとモデル選択に対応しているかどうかを示すチップが表示されます。
外部 CLI は、サーバーホスト上の自身の設定に、自身の資格情報を保持します。Control Center はそれらを管理しません。
ワークスペースが使用できるプロバイダーを制限
「ワークスペースが使用できるプロバイダーを制限」というセクションプロバイダーのガバナンスはワークスペース単位で、最後に一致したものが勝つ方式で評価されます。
- プロバイダーとモデルで、プロバイダーの行の許可スイッチをオフにします
これにより、アクティブなワークスペースにそのプロバイダーの deny ステートメントが書き込まれ、そのワークスペースのカタログからそのモデルが外れます。スイッチを再びオンにすると、ステートメントが削除されます。
トラブルシューティング
「トラブルシューティング」というセクションランナーが見つからないと表示される
「ランナーが見つからないと表示される」というセクション- CLI が自分のマシンだけでなくサーバーホストの
PATHにあることを確認します - GUI から起動したデスクトップアプリは最小限の
PATHでサーバーを起動するため、シェル専用のパスにインストールされた CLI はそれから見えないことがあります - インストール後に更新を押します
モデルのドロップダウンが空である
「モデルのドロップダウンが空である」というセクション- アダプターが組み込みのもので、プロバイダーが 1 つも接続されていない — プロバイダーとモデルで接続します
- または、プロバイダーは接続済みだが、このワークスペースのガバナンススイッチで拒否されている
モデルは実行されるが料金が不明と表示される
「モデルは実行されるが料金が不明と表示される」というセクションライブのモデル一覧には ID が含まれます。料金とコンテキストは models.dev から取得します。まったく新しいモデルやカスタムプロバイダーのモデルには、まだカタログのエントリがありません。