在 GitHub Copilot CLI 中使用您自己的 LLM 模型

您可以将 Copilot CLI 配置为使用您自己的 LLM 提供商（也称为 BYOK，即自带密钥），而不是 GitHub 托管的模型。这使您能够连接到兼容 OpenAI 的端点、Azure OpenAI 或 Anthropic，包括本地运行的模型，如 Ollama。

先决条件

• 已安装 Copilot CLI。请参阅 安装 GitHub Copilot CLI。
• 您拥有来自受支持的 LLM 提供商的 API 密钥，或正在运行本地模型（例如 Ollama）。

支持的提供商

Copilot CLI 支持三种提供商类型

提供商类型	兼容的服务
openai	OpenAI、Ollama、vLLM、Foundry Local 以及任何其他兼容 OpenAI Chat Completions API 的端点。这是默认的提供商类型。
azure	Azure OpenAI 服务。
anthropic	Anthropic（Claude 模型）。

若需更多示例，请在终端中运行 copilot help providers。

模型要求

模型必须支持 工具调用（亦称函数调用）和 流式输出。如果模型不支持任一功能，Copilot CLI 将返回错误。为获得最佳效果，建议使用上下文窗口至少为 128k 令牌的模型。

配置您的提供商

您可以在启动 Copilot CLI 前通过设置环境变量来配置模型提供商。

环境变量	是否必填	描述
COPILOT_PROVIDER_BASE_URL	是	您的模型提供商 API 端点的基础 URL。
COPILOT_PROVIDER_TYPE	否	提供商类型：openai（默认）、azure 或 anthropic。
COPILOT_PROVIDER_API_KEY	否	您的提供商 API 密钥。对于不使用身份验证的提供商（例如本地 Ollama 实例），无需此密钥。
COPILOT_MODEL	是	使用的模型标识符。您也可以通过 --model 命令行标志进行设置。

连接到兼容 OpenAI 的端点

如果您连接的是 OpenAI、Ollama、vLLM、Foundry Local 或任何其他兼容 OpenAI Chat Completions API 的端点，请使用以下步骤。

1. 为您的提供商设置环境变量。例如，对于本地 Ollama 实例

   export COPILOT_PROVIDER_BASE_URL=https://:11434
   export COPILOT_MODEL=YOUR-MODEL-NAME
   

   将 YOUR-MODEL-NAME 替换为您在 Ollama 中拉取的模型名称（例如 llama3.2）。

2. 对于远程 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）。

3. 启动 Copilot CLI。

copilot

连接到 Azure OpenAI

1. 为 Azure OpenAI 设置环境变量。

   export COPILOT_PROVIDER_BASE_URL=https://YOUR-RESOURCE-NAME.openai.azure.com/openai/deployments/YOUR-DEPLOYMENT-NAME
   export COPILOT_PROVIDER_TYPE=azure
   export COPILOT_PROVIDER_API_KEY=YOUR-AZURE-API-KEY
   export COPILOT_MODEL=YOUR-DEPLOYMENT-NAME
   

   替换以下占位符

   • YOUR-RESOURCE-NAME：您的 Azure OpenAI 资源名称
   • YOUR-DEPLOYMENT-NAME：您的模型部署名称
   • YOUR-AZURE-API-KEY：您的 Azure OpenAI API 密钥

2. 启动 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 模型（例如 claude-opus-4-5）。

2. 启动 Copilot CLI。

copilot

离线模式运行

您可以在离线模式下运行 Copilot CLI，以防止其联系 GitHub 服务器。此模式旨在用于 CLI 只能与本地或内部部署模型提供商通信的隔离环境。

1. 如“配置您的提供商”章节所述，配置您的提供商环境变量。

2. 设置离线模式环境变量

   export COPILOT_OFFLINE=true
   

3. 启动 Copilot CLI。

copilot