最終更新

Codex の GitHub Copilot — Codex Router で Copilot モデルを使う

Codex で GitHub Copilot を使うとは、アカウントですでに見えている Copilot モデルを、モデル一覧をハードコードせずに通常の Codex モデルピッカーへルーティングすることを意味します。github-copilot プロバイダーはカタログ専用です:内蔵モデルを同梱せず、代わりにプランと組織ポリシーが GitHub 自身のカタログ経由で公開するものをキュレーションします。

GitHub CopilotGitHub Copilotaccount catalogPAT

どの Copilot モデルがルーティングされるか

github-copilot は、次の 3 要件をすべて公開しているアカウント可視モデルのみを受け入れます:

要件重要な理由
Responses APICodex は Responses プロトコルを話す。他のサーフェスには別のアダプターが必要
ストリーミング生成されるトークンをターンごとにストリーム配信する
ツール呼び出しCodex はすべてのターンをツール呼び出しで進める

可用性はプランと組織ポリシーに依存するため、Copilot のモデル ID は一切チェックインされていません。カタログは、キュレーション時に GitHub があなたのアカウント向けに報告するものです。

fine-grained トークンを作成する

従来の ghp_ トークンはサポートされていません。GitHub personal access tokensCopilot Requests 権限を持つ fine-grained な GitHub PAT を作成します。

  1. パーソナルアクセストークン作成ページを開き、fine-grained トークンを選択します。
  2. Copilot Requests 権限を付与します。
  3. 生成された github_pat_ の値をコピーし、非公開で保管します。

トークンをチャット、コマンド引数、追跡対象ファイルに貼り付けないでください。非表示プロンプトがルーターの保護された状態に保存します。

GitHub Copilot を有効化する

非表示プロンプトでトークンを保存し、ライブカタログをキュレーションします:

./bin/model-router codex provider-key github-copilot set
./bin/curate-models github-copilot

Windows では同じコマンドで ./model-router.ps1 codex を使います。フォアグラウンドプロセスの場合、ルーターは次の順で環境変数にもフォールバックします:COPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN

その後 Codex を完全終了し、再起動して新規タスクを作成し、モデルピッカーを開きます。

トークンの検証方法

リクエスト時に、トークンは GitHub の Copilot アカウントエンドポイントで検証されます。そのエンドポイントは推論ホストも選択し、ルーターはホストが GitHub 所有である場合にのみ受け入れます。ルーターは公式 Copilot CLI の認証情報ストアを読み取りもコピーもしません。

この連携は GitHub.com を対象としています。GitHub Enterprise Cloud のデータレジデンシーホストはルーターでは設定されません。

利用枠とクォータ

リクエストはユーザーの Copilot 利用枠を消費します。GitHub がユーザー単位のメーターを公開している場合、トレイは AI クレジットまたはレガシークォータを表示します。シート単位のクォータを公開しない組織管理プランでは、代わりにルーターが観測したトラフィックにフォールバックします。

連携を検証する

./bin/model-router codex doctor
./bin/model-router codex providers

github-copilotSHOWready を報告する必要があります。1 モデルのリアルタイム(クォータ消費)チェックには:

./bin/test-model 'github-copilot/MODEL_ID' --live --yes

何も表示されない場合は、モデルがピッカーに表示されないを参照してください。

プランとポリシーの注意点

Copilot カタログはプランとポリシーに依存し、GitHub の推論インターフェースは進化を続ける可能性があります。リクエストはあなた自身の Copilot 利用枠を消費するため、GitHub Copilot の利用規約と許容使用ポリシーの範囲内で使用してください。サードパーティルーター経由で Copilot をルーティングするのは自己責任です。依存する前に GitHub の規約を確認してください。

FAQ

Codex で GitHub Copilot モデルを使えますか? はい。Codex Router の github-copilot プロバイダーは、アカウントで見える Copilot モデルを通常の Codex ピッカーへルーティングします。ただし、それらのモデルが Responses API、ストリーミング、ツール呼び出しを公開している場合に限ります。

従来の ghp_ GitHub トークンは Codex Router で使えますか? いいえ。Copilot には Copilot Requests 権限を持つ fine-grained な github_pat_ トークンが必要です。従来の ghp_ トークンはサポートされていません。

Codex Router は Copilot CLI の認証情報ストアを読み取りますか? いいえ。ルーターは入力した PAT を独自の保護状態に保存し、リクエスト時に GitHub の Copilot アカウントエンドポイントで検証します。公式 Copilot CLI の認証情報ストアを読み取りもコピーもしません。

関連:モデル概要カスタムモデルインストールトラブルシューティング