プロバイダーの選択

対応プロバイダー

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 は次の候補を試します。

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