GITHUB COPILOT CLI への LLM モデルの追加

独自の API キーを指定して、 Copilot で選択した外部プロバイダーのモデルを使用します。

この記事で

Copilot CLI を構成して、GitHub でホストされるモデルに加えて、BYOK (Bring Your Own Key) を使用して、任意の LLM プロバイダーのモデルを含めることができます。 これにより、OpenAI と互換性のあるエンドポイント、Azure OpenAI、または Anthropic (Ollama などのローカルで実行されるモデルを含む) に接続できます。

メモ

この記事は、ローカル コンピューターで独自の LLM プロバイダー API キーを構成するユーザーを対象にしています。 企業内のユーザーのカスタム モデルを設定するには、 エンタープライズでのGitHub Copilotのカスタム モデルの有効化 を参照してください。

前提条件

  • Copilot CLI がインストールされています。 「GitHub Copilot CLI のインストール」を参照してください。
  • サポートされている LLM プロバイダーの API キーを持っているか、ローカル モデル (Ollama など) を実行している。

サポートされているプロバイダー

Copilot CLI では、次の 3 種類のプロバイダーがサポートされています。

プロバイダーの種類互換性のあるサービス
openaiOpenAI、Ollama、vLLM、Foundry Local、およびその他の OpenAI Chat Completions API 互換エンドポイント。 これは既定のプロバイダーの種類です。
azureAzure OpenAI Service。
anthropicアントロピック (クロード モデル)。

その他の例については、ターミナルで copilot help providers を実行します。

モデルの要件

モデルでは、 ツール呼び出し (関数呼び出し とも呼ばれます) と ストリーミングをサポートする必要があります。 モデルがどちらの機能もサポートしていない場合、 Copilot CLI はエラーを返します。 最良の結果を得るには、少なくとも 128,000 個のトークンのコンテキスト ウィンドウを持つモデルを使用します。

プロバイダーの構成

モデル プロバイダーを構成するには、 Copilot CLIを開始する前に環境変数を設定します。

環境変数必須説明
COPILOT_PROVIDER_BASE_URLはいモデル プロバイダーの API エンドポイントのベース URL。
COPILOT_PROVIDER_TYPEいいえプロバイダーの種類: openai (既定)、 azure、または anthropic。
COPILOT_PROVIDER_API_KEYいいえプロバイダーの API キー。 ローカルの Ollama インスタンスなど、認証を使用しないプロバイダーには必要ありません。
COPILOT_PROVIDER_BEARER_TOKENいいえAPI キー認証が使用されていない場合にプロバイダー認証に使用されるベアラー トークン。
COPILOT_PROVIDER_WIRE_APIいいえプロバイダーと通信するときに使用する API プロトコルを指定します。
COPILOT_PROVIDER_AZURE_API_VERSIONAzure のみ要求に使用される Azure OpenAI API バージョン。
COPILOT_PROVIDER_MODEL_IDいいえモデルの機能とトークンの制限を識別するために使用される既知のモデル名。
COPILOT_PROVIDER_WIRE_MODELいいえ推論のためにプロバイダー API に送信されるモデル名。 Azure OpenAI では、デプロイ名を使用します。
COPILOT_PROVIDER_MAX_PROMPT_TOKENSいいえ要求で許可されるプロンプト トークンの最大数。
COPILOT_PROVIDER_MAX_OUTPUT_TOKENSいいえ応答で生成されるトークンの最大数。
COPILOT_MODELはい使用するモデル識別子。
--modelコマンド ライン フラグを使用して設定することもできます。

OpenAI と互換性のあるエンドポイントへの接続

OpenAI、Ollama、vLLM、Foundry Local、または OpenAI Chat Completions API と互換性のある他のエンドポイントに接続する場合は、次の手順を使用します。

  1. プロバイダーの環境変数を設定します。 たとえば、ローカルの Ollama インスタンスの場合:

    export COPILOT_PROVIDER_BASE_URL=http://localhost:11434
export COPILOT_MODEL=YOUR-MODEL-NAME

YOUR-MODEL-NAMEを、Ollama でプルしたモデルの名前 (たとえば、llama3.2) に置き換えます。

  1. リモートの OpenAI エンドポイントの場合は、API キーも設定します。

    export COPILOT_PROVIDER_BASE_URL=https://api.openai.com/v1
export COPILOT_PROVIDER_API_KEY=YOUR-OPENAI-API-KEY
export COPILOT_MODEL=YOUR-MODEL-NAME

YOUR-OPENAI-API-KEYを OpenAI API キーに置き換え、YOUR-MODEL-NAMEを使用したいモデル（例:gpt-4o）に置き換えます。

  1. Copilot CLI を起動します。
copilot

Azure OpenAI への接続

  1. Azure OpenAI の環境変数を設定します。

    export COPILOT_PROVIDER_BASE_URL=https://YOUR-RESOURCE-NAME.openai.azure.com
export COPILOT_PROVIDER_TYPE=azure
export COPILOT_PROVIDER_API_KEY=YOUR-AZURE-API-KEY
export COPILOT_PROVIDER_AZURE_API_VERSION=YOUR-AZURE-API-VERSION
export COPILOT_PROVIDER_MODEL_ID=YOUR-MODEL-NAME
export COPILOT_PROVIDER_WIRE_MODEL=YOUR-DEPLOYMENT-NAME
export COPILOT_MODEL=YOUR-DEPLOYMENT-NAME

    次のプレースホルダーを置き換えてください。

    • YOUR-RESOURCE-NAME: Azure OpenAI リソース名
    • YOUR-DEPLOYMENT-NAME: リクエストを受信するデプロイ名
    • YOUR-MODEL-NAME: デプロイに関連付けられている基になるモデル (たとえば、 gpt-4o)
    • YOUR-AZURE-API-VERSION: Azure OpenAI API のバージョン
    • YOUR-AZURE-API-KEY: Azure OpenAI API キー

Azure固有の環境変数

Variable説明
COPILOT_PROVIDER_MODEL_IDよく知られたモデル名。
Copilot CLI では、この値を使用してモデルの機能とトークンの制限を識別します。
COPILOT_PROVIDER_WIRE_MODELAzure OpenAI のデプロイ名。 Azure OpenAI は、モデル名を直接使用するのではなく、デプロイを通じて要求をルーティングします。
  1. Copilot CLI を起動します。
copilot

Anthropic への接続

  1. Anthropic の環境変数を設定します。

    export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://api.anthropic.com
export COPILOT_PROVIDER_API_KEY=YOUR-ANTHROPIC-API-KEY
export COPILOT_MODEL=YOUR-MODEL-NAME

YOUR-ANTHROPIC-API-KEYをあなたのAnthropic APIキーに、そしてYOUR-MODEL-NAMEを使用したいクロードモデル（例：claude-opus-4-5）に置き換えてください。

  1. Copilot CLI を起動します。
copilot

オフライン モードでの実行

オフライン モードで Copilot CLI を実行すると、 GitHubのサーバーに接続できなくなります。 これは、CLI がローカルまたはオンプレミスのモデル プロバイダーとのみ通信する分離環境向けに設計されています。

重要

オフライン モードでは、プロバイダーもローカルまたは同じ分離環境内にある場合にのみ、完全なネットワーク分離が保証されます。 COPILOT_PROVIDER_BASE_URLがリモート エンドポイントを指している場合、プロンプトとコード コンテキストは引き続きネットワーク経由でそのプロバイダーに送信されます。

  1. 「プロバイダーの構成」の説明に従って、プロバイダー環境変数を構成します。

  2. オフライン モード環境変数を設定します。

    export COPILOT_OFFLINE=true
    1. Copilot CLI を起動します。
copilot