跳到正文
funcoding.ai
← GitHub Copilot

GitHub Copilot · 自定义模型

GitHub Copilot 配置自定义模型：VS Code BYOK 与 Copilot CLI

在 VS Code 里通过 Manage Language Models 添加自己的模型 Key 或本地 Ollama 模型，以及用环境变量让 Copilot CLI 连接自定义模型。

1 分钟读完

Copilot 在两个地方支持自定义模型（BYOK，Bring Your Own Key）：VS Code 的对话功能，以及 Copilot CLI。

一、VS Code 中添加自己的模型

添加步骤

  1. 打开 Chat 视图，点模型选择器旁的齿轮 Manage Language Models；或者在命令面板运行 Chat: Manage Language Models
  2. 点 Add Models，选择提供方
  3. 按提示填入 API Key，勾选要显示在选择器里的模型

内置支持的提供方包括 Anthropic、Azure、Google（Gemini）、Hugging Face、OpenAI、OpenRouter，以及本地运行的 Ollama、Foundry Local 等。对于其他服务，可以使用 OpenAI Compatible 提供方填写任意兼容 OpenAI 接口的地址（部分版本中该功能可能仅在 VS Code Insiders 提供）。

需要知道的限制

  • 自定义模型只用于对话和部分辅助任务
  • 行内补全，以及依赖向量的功能（如语义搜索），仍然需要 Copilot 套餐
  • 只用自己 Key 的对话功能，不登录 GitHub、没有 Copilot 套餐也能用；配合本地模型可以完全离线

二、Copilot CLI 连接自定义模型

Copilot CLI 通过环境变量配置自定义模型：

环境变量 必填 说明
COPILOT_PROVIDER_BASE_URL 是 接口地址
COPILOT_MODEL 是 模型名
COPILOT_PROVIDER_TYPE 否 openai（默认）、azure 或 anthropic
COPILOT_PROVIDER_API_KEY 否 API Key
COPILOT_PROVIDER_WIRE_MODEL 否 实际发给提供方的模型名，如 Azure 部署名

openai 类型适用于 OpenAI，以及 Ollama、vLLM、Foundry Local 等任何兼容 OpenAI Chat Completions 接口的服务。

连接本地 Ollama：

Terminal window
export COPILOT_PROVIDER_BASE_URL=http://localhost:11434
export COPILOT_MODEL=llama3.2
copilot

连接 Azure OpenAI：

Terminal window
export COPILOT_PROVIDER_TYPE=azure
export COPILOT_PROVIDER_BASE_URL=https://YOUR-RESOURCE-NAME.openai.azure.com
export COPILOT_PROVIDER_WIRE_MODEL=YOUR-DEPLOYMENT-NAME
copilot

如果不希望 CLI 连接 GitHub 服务器，可以设置 COPILOT_OFFLINE=true。

模型要求

  • 必须支持工具调用（function calling）和流式输出
  • 建议上下文窗口不小于 128k tokens，否则智能体在大项目里容易丢失上下文