
ゲートウェイ経由でGitHub Copilot ChatとClaudeを使う:Custom Endpointの設定、エージェントモード、問題の解決方法
VS Codeのチャットは、自分で用意したモデルで実行できます。組み込みのAnthropicプロバイダーはAPIキーのみを受け付け、別のアドレスを指定するフィールドがないため、ゲートウェイはカスタムエンドポイントプロバイダーを通じて追加します。APIの種類としてMessagesを選択し、モデルを次のファイルに列挙します chatLanguageModels.json。この機能はバージョン1.122からVS Codeの安定版に含まれています。
自分のキーで利用できる機能
| 機能 | 自分のモデルを使用する場合 |
|---|---|
| チャット、質問、計画 | はい |
| エージェントモード、組み込みツール、MCPサーバー | はい。モデルに次の指定がある場合 toolCalling: true |
| インライン候補(コード補完)と次の編集候補 | いいえ。これらは引き続きGitHub Copilotが提供します |
| セマンティック検索およびその他の埋め込みベースの機能 | いいえ。これらには引き続きGitHubアカウントが必要です |
VS Code 1.122以降、これらのモデルはGitHubへのサインインもCopilotプランも不要で利用できます。Copilot BusinessとEnterpriseでは、BYOKがデフォルトで有効になっており、管理者は**独自の言語モデルキーの使用**ポリシーで無効にできます。
ゲートウェイをカスタムエンドポイントとして追加する
- チャットビューを開き、モデル選択メニューから**言語モデルの管理**を選ぶか、コマンドパレットから**チャット:言語モデルの管理**を実行します。
- **モデルの追加**を選び、次に**カスタムエンドポイント**プロバイダーを選択します。
- 表示名とゲートウェイのAPIキーを入力します。
- APIタイプとして**Messages**を選択します。続いてVS Codeが開く
chatLanguageModels.jsonでモデル一覧を設定します。
chatLanguageModels.json
[
{
"name": "AI Prime Tech",
"vendor": "customendpoint",
"apiKey": "${input:aiprimeApiKey}",
"apiType": "messages",
"models": [
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-haiku-4-5",
"name": "Claude Haiku 4.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 168000,
"maxOutputTokens": 32000
}
]
}
]| 項目 | 理由 |
|---|---|
id | ゲートウェイに送信するモデルID |
url | 完全なエンドポイント。VS Codeは、末尾が次の文字列で終わるURLを /messages そのまま使用します。推測に頼らないよう、完全なパスを指定してください |
toolCalling: true | エージェントモードに必須です。この設定がないモデルはエージェント用として表示されません |
maxInputTokens + maxOutputTokens | 両者の合計は、モデルのコンテキストウィンドウを超えてはいけません |
apiKey: ${input:...} | VS Codeはキーの入力を一度だけ求めて保存するため、キーはファイルに書き込まれません |
Messagesタイプでは、VS Codeはキーを次のヘッダーで送信します: x-api-key ヘッダーはゲートウェイが想定する形式です。モデルIDはゲートウェイのIDと完全に一致する必要があります。
同じキーでGPTモデルを使用する
Custom EndpointプロバイダーはOpenAI形式にも対応しています。ゲートウェイのCodexグループに属するキーでGPTモデルを追加するには、次の設定で別のプロバイダーを追加します: "apiType": "chat-completions" モデルのURLには次を指定します: https://aiprimetech.io/v1/chat/completions。キーでアクセスできるのは、そのキーが属するグループのモデルだけです。そのため、ClaudeとGPTには通常、それぞれ別のキーを使用した別のエントリが必要です。
従来の github.copilot.chat.customOAIModels 設定と**OpenAI Compatible**プロバイダーは、Custom Endpointへの移行に伴い非推奨になっています。既存のエントリを次に移してください: chatLanguageModels.json.
トラブルシューティング
| 表示される内容 | 原因 | 対処方法 |
|---|---|---|
| モデルが選択リストに表示されない | 再読み込みが必要、または toolCalling がfalse、またはワークスペースが制限モードになっている | VS Codeを再起動し、次を設定します: toolCalling: true、ワークスペースを信頼する設定にします |
| プロバイダー一覧にCustom Endpointがない | VS Codeが1.122より古い、または組織によってBYOKが無効にされている | VS Codeを更新し、BYOKポリシーについて管理者に確認してください |
401 / 無効なAPIキー | 保存されたキーが正しくない、または別のエンドポイントに属している | プロバイダーの横にある歯車アイコンをクリックし、**APIキーを更新**を選択します |
| モデルがサポートされていない | この id がゲートウェイのモデルIDと一致していない | 以下の表にあるIDを使用してください |
| コンテキストまたはトークンのエラー | maxInputTokens および maxOutputTokens がコンテキストウィンドウを超えている | 減らす項目: maxInputTokens |
Concurrency limit exceeded | 同じキーで複数のエージェントまたはウィンドウが同時に動作している | 並列実行数を減らしてください |
詳細を確認するには、**開発者: ログ レベルの設定**を実行して**トレース**を選択し、**出力**を開いて**GitHub Copilot Chat**を選択します。チャットのデバッグビューには、実際のリクエストが表示されます。ポリシーで許可されていないためBYOKプロバイダーの登録が解除されたというログ行がある場合、組織のポリシーが原因です。
| モデルID | 用途 |
|---|---|
claude-sonnet-5 | コーディングとエージェント作業の標準モデル:高速、高性能、中程度の価格。 |
claude-opus-5-5 | より難しい推論、大規模なリファクタリング、長時間のエージェント実行。 |
claude-fable-5-1 | 最も高性能で最も高価。最も難しいタスクに絞って使いましょう。 |
claude-haiku-4-5 | 低価格で高速:タイトル、要約、分類、小さな処理。 |
ターミナルを使いたい場合は、同じキーで次を実行できます: VS CodeでのClaude Code 専用の拡張機能を通じて利用できます。
よくある質問
GitHub Copilotで自分のClaude APIキーを使用できますか?
CopilotでAnthropicのベースURLを変更できますか?
BYOKモデルはCopilotのエージェントモードで動作しますか?
自分のモデルを使用するにはCopilotのサブスクリプションが必要ですか?
APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。
APIキーを取得AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。