---
locale: ja
title: プロバイダーの選択
description: モデルプロバイダーを接続し、q のネイティブロールにモデルを割り当てます。
sectionLabel: ガイド
toc:
  - id: 対応プロバイダー
    label: 対応プロバイダー
  - id: gatewayを設定
    label: Gateway を設定
  - id: モデルロールを割り当て
    label: モデルロールを割り当て
  - id: 埋め込みを設定
    label: 埋め込みを設定
  - id: フォールバックグループ
    label: フォールバックグループ
---

## 対応プロバイダー

q の管理対象 Gateway は次をサポートします。

- ローカルサーバーを含む OpenAI 互換 HTTP API
- OpenRouter
- xAI と Grok
- Anthropic ネイティブ Messages API
- 現在の Codex ログインを使うローカル Codex App Server

## Gatewayを設定

q 内で `/gateway` を開き、プロバイダーとリスナー設定を追加します。通常の q セッションは一時的なループバックポート上の専用 Gateway 子プロセスを監督します。

プロバイダー変更は、置き換え用プロセスの起動に成功してから有効化されます。起動できない場合は、動作中の設定を維持します。

認証情報には可能な限り環境変数参照を使ってください。グローバルなプロバイダー定義は `~/.q/providers.json` に保存されます。

## モデルロールを割り当て

`/model` でメインチャットと `griller`、`scout`、`planner`、`executor`、`coder`、`commit`、`thinker`、`librarian` などの専門ロールにモデルを割り当てます。

割り当て表で `a` を押すと再利用可能なカスタムロールを作成できます。カスタムサブエージェントは自身のツールと委任許可を保ったまま、そのロールを選択できます。

ワークスペース上書きは `.q/model.json`、グローバル割り当ては `~/.q/config.yaml` に保存されます。

## 埋め込みを設定

モデル割り当て画面にはグローバルな `embedding` ターゲットもあります。埋め込み対応モデルを選び、そのモデルが要求するベクトル次元を入力します。q は 1 から 4096 の次元を受け付けます。

Workspace Memory と Library が共有の派生インデックスを維持するため、埋め込み設定はグローバルで、ワークスペースごとの上書きはできません。モデルの割り当てや変更により、再構築可能な HNSW プロジェクションを再設定し、アクティブな Agent Skills を新しいモデルでバックフィルします。ターゲットをクリアするとスキルと履歴の検索は BM25 のみになります。

設定したプロバイダーは埋め込みリクエストに対応し、次元数は選択モデルと一致する必要があります。設定エラーが起きても元の JSON レコードは利用できます。

## フォールバックグループ

ロールは順序付きモデルグループを参照できます。候補がタイムアウトするか一時的な HTTP 5xx を返すと、q は次の候補を試します。

ユーザーキャンセル、ツール失敗、検証エラーではフォールバックしません。その場合は別モデルではなく依頼、ツール状態、設定を変更する必要があります。