最終更新日:2026年8月23日

読了時間:約10分


自分のOpenAIやAnthropicのAPIキーをGitHub Copilotに接続することで、モデル選択の自由度が上がり、コスト構造も大きく変わります。この記事では、BYOK設定の手順・料金への影響・よくある失敗を具体的に解説します。

この記事で分かること:

  • ✔ GitHub Copilot BYOKが自分の用途に合うか判断できる
  • ✔ APIキーを持ち込む具体的な設定手順が分かる
  • ✔ BYOKによって料金がどう変わるかが分かる

30秒で選ぶなら: → GitHubの既存プランで使えるモデルで十分なら設定不要、GPT-4oやClaude Opus等を指定したい・コストを自社クラウドで一元管理したいなら BYOK 一択です。


目次

  1. GitHub Copilot BYOKとは何か
  2. 必要なツールと選び方
  3. 設定手順
  4. よくある失敗と対処法
  5. よくある質問(FAQ)
  6. まとめ

GitHub Copilot BYOKとは何か

GitHub Copilot BYOK(Bring Your Own Key)は、ユーザーが自分で取得したLLMプロバイダーのAPIキーをCopilotに接続し、使用するモデルとAPIコストの管理を自分側で行う機能です。

通常のGitHub Copilotは、GitHub社が管理するモデルエンドポイントを通じてコード補完・チャット機能を提供します。BYOKを使うと、OpenAI・Anthropic・Azure OpenAIなど自社契約のAPIキーを紐付け、モデルを直接指定できます。

できることは大きく3つです。GitHubが標準提供しないモデルバージョンの利用、APIコストの自社アカウントへの集約(請求の一元管理)、そして組織のセキュリティポリシーに沿ったデータフロー制御です。


必要なツールと選び方

最初は何から始めればいいか分からない人がほとんどです。まず接続先のLLMプロバイダーと、Copilotのどのレイヤー(VS Code拡張・GitHub.com・GitHub Copilot Extensions)でBYOKを使うかを決めることが先決です。

対応プロバイダーと主な特徴比較(2026年8月時点)

プロバイダー対応モデル例課金単位日本語サポート向いている用途
OpenAIGPT-4o, o3-miniトークン(入力/出力別)あり汎用コード生成・説明
AnthropicClaude Opus 5, Sonnet 5トークン(入力/出力別)あり長文コンテキスト・設計相談
Azure OpenAIGPT-4o(Azureデプロイ)トークン+インフラ費あり社内データ統制・コンプライアンス
Google Vertex AIGemini 2.5 Proトークン(入力/出力別)ありマルチモーダル・コード+画像

※料金は為替レートにより変動します。最新料金は各プロバイダーの公式サイトをご確認ください。

選び方の基準は「コンテキストウィンドウの長さ」と「既存の社内契約」の2点で決めるのが最速です。

すでにAzureのエンタープライズ契約がある組織はAzure OpenAIを選ぶと請求管理が最もシンプルになります。個人または小規模チームでモデルの最新版を試したい場合はOpenAIかAnthropicのAPIキーを直接取得するほうが設定が少なくて済みます。


GitHub Copilot BYOK設定の手順

ステップ1:LLMプロバイダーのAPIキーを取得する

OpenAIの場合、platform.openai.com にログインし、右上のアカウントメニューから「API keys」→「Create new secret key」を選択します。キーは生成直後しか全文表示されないため、この画面を閉じる前に必ずコピーしてパスワードマネージャーに保存してください。

Anthropicの場合は console.anthropic.com の「API Keys」セクションで同様の手順を行います。

この手順を省くと後で必ず詰まります。特にキーの保存を後回しにして「再発行すればいい」と思っていると、既存のシステムとの連携を全部やり直す羽目になります。

ステップ2:GitHub CopilotのBYOK設定画面を開く

  1. github.com にログインし、右上のアイコンから「Settings」を開く
  2. 左メニューの「Copilot」→「Models」または「BYOK」セクションへ移動
  3. 「Add API key」または「Bring your own key」ボタンをクリック

組織アカウントの場合は、個人設定ではなく Organization Settings → Copilot → Models から設定します。個人設定から触っても反映されないので注意が必要です。

ステップ3:APIキーとエンドポイントを登録する

登録フォームに以下の情報を入力します。

  1. Provider:OpenAI / Anthropic / Azure OpenAI / Vertex AI から選択
  2. API Key:ステップ1でコピーしたキーを貼り付け
  3. Model ID:使用したいモデルの正確なID(例:claude-opus-5gpt-4o-2025-XX-XX
  4. Base URL(Azure OpenAIの場合のみ):自社のAzureエンドポイントURL

Model IDはプロバイダーのAPIリファレンスで必ず確認してください。 画面上の表示名とAPI上のIDが異なるケースがあり、ここを誤ると接続テストで400エラーが返ります。

ステップ4:接続テストを実施する

設定画面内の「Test connection」ボタンを押し、Connected successfully の表示を確認します。エラーが出た場合は後述の「よくある失敗と対処法」を参照してください。

ステップ5:VS Code拡張でモデルを有効化する

  1. VS Codeを開き、GitHub Copilot拡張の設定(歯車アイコン)を開く
  2. 「Copilot: Model」の項目でBYOKで登録したモデルを選択
  3. チャットウィンドウで短いコード生成を1件試して動作確認する

個人的には、このステップ5が一番重要だと思っています。接続テストが成功していてもVS Code側のキャッシュが古いまま残っていることがあり、IDE再起動後に再度モデル選択を確認することを強くお勧めします。


よくある失敗と対処法

失敗1:APIキーのスコープ不足で認証エラーになる

OpenAIのAPIキーには「プロジェクト単位のキー」と「全体スコープのキー」があります。プロジェクト単位のキーで登録すると、該当プロジェクト外のモデルへのリクエストが拒否されます。

対処法: OpenAIの管理画面で「Default project」に属するキー、またはOrganization全体のキーを使用します。キー生成時に「Permissions」でモデルアクセス権限がすべて有効になっているか確認してください。

プロジェクトキーを使っているのにOrganizationレベルの設定を触っても確実に失敗します。この混同が最も多いエラーの原因です。

失敗2:CopilotプランのバージョンがbYOKに非対応

GitHub Copilot IndividualプランではBYOKが利用できないケースがあります(2026年8月時点)。BYOKはCopilot BusinessまたはCopilot Enterpriseプランの機能として段階的に展開されています。

対処法: github.com/settings/copilot にアクセスし、現在のプランを確認します。Individualの場合はBusinessへのアップグレードが必要です。料金は執筆時点でBusiness $19/月・Enterprise $39/月(1ドル=約145円換算で約2,755円・約5,655円、為替レートにより変動します)。

失敗3:Azure OpenAIのエンドポイントURLのフォーマット誤り

Azure OpenAIのBase URLは https://{リソース名}.openai.azure.com/openai/deployments/{デプロイ名}/ の形式ですが、末尾のスラッシュ有無や deployments パスの有無で接続が失敗します。

対処法: AzureポータルのOpenAIリソース → 「Keys and Endpoints」からURLをコピーし、末尾に /openai/deployments/{デプロイ名}/ を手動で追加します。これが意外と盲点になりやすく、コピーしたURLをそのまま貼ると高確率で404が返ります。


よくある質問(FAQ)

Q. BYOKを使うとGitHub Copilotの月額料金はどうなりますか?

A. GitHubへのサブスクリプション料金(Business/Enterprise)は従来通り発生します。BYOKで使ったAPIのトークン費用は、接続したプロバイダー(OpenAI・Anthropicなど)に対して別途発生します。GitHubへの請求とプロバイダーへの請求は完全に別々です。

Q. BYOKで接続したモデルのデータはGitHubに渡りますか?

A. GitHubの公式ドキュメントによると、BYOKを使用した場合のリクエストデータはGitHubのサーバーを通過せず、直接プロバイダーのAPIエンドポイントに送信されます。ただし、組織のデータポリシーとプロバイダーの利用規約を照合した上で導入判断することを推奨します。

Q. 個人開発者がBYOKを使うメリットはありますか?

A. 「GitHubが標準提供しない最新モデルをすぐに試したい」「APIコストを他のプロジェクトと一元管理したい」場合にメリットがあります。標準モデルで十分な用途であればBYOKの設定コストのほうが高くつく可能性が高く、通常プランを継続するほうが合理的です。


まとめ

GitHub Copilot BYOKは「使いたいモデルが標準提供されていない」「APIコストを自社で管理したい」という明確な理由がある場合にのみ導入する機能です。

標準Copilotで十分な個人開発者にとっては設定の複雑さがコストになります。一方、AnthropicのClaude Opus 5やGoogleのGemini 2.5 Proを特定のコードベースで試したいチームには、BYOKが唯一の選択肢になります。

正直なところ、BYOK設定でつまずくポイントのほぼすべては「APIキーのスコープ確認」と「Model IDの正確な入力」の2点に集中しています。この2点を丁寧に確認するだけで、大半のエラーは事前に回避できます。

次のアクションとして、まず自分が使いたいモデルがGitHub標準のモデル一覧に含まれているかを確認し、含まれていない場合のみBYOKの設定に進むことをお勧めします。


最終更新日:2026年8月23日

関連記事