GitHub Copilot 接入第三方 OpenAI 兼容模型指南
注意: 官方已明确正式版不再支持直接接入第三方 OpenAI 兼容模型。目前体验该功能需使用 VS Code Insider 版本,或通过手动打包扩展实现。
背景与需求
原生 Copilot 在模型选择、支付渠道及系统提示词限制上存在不少门槛。为了突破这些限制,我们需要实现两个目标:
- 让 Copilot Chat 能接入自定义的 OpenAI 兼容模型。
- 修改系统提示词,解除非编程问题的回答限制。
得益于 Copilot Chat 的部分开源,社区已有开发者实现了相关功能,但微软尚未发布正式 Release 版本,因此我们需要自行构建扩展包。
构建步骤
1. 克隆源码
请确保克隆的是包含功能的分支,而非主分支。
git clone -b feat-ui https://github.com/relic-yuexi/vscode-copilot-chat.git
2. 修改提示词配置
我们需要修改底层的安全规则和身份定义文件。
移除安全限制
找到 src\extension\prompts\node\base\safetyRules.tsx。这是控制安全规则的核心文件。默认情况下,询问非编程问题会触发拒绝回复。将相关的拒绝字符串替换为你想要的任意内容即可。
修改身份标识
接着打开 src\extension\prompts\node\base\copilotIdentity.tsx。这里强制定义了模型身份为 "github copilot"。如果你不喜欢这个设定,可以将其替换为空格或其他名称。
3. 编译与打包
确保本地已安装 Node.js 和 npm。在项目根目录打开终端执行以下命令:
npm install
*注:若遇到 sqlite3 编译失败,可能需要安装 Visual Studio 的 C++ 环境。
构建项目:
npx tsx .esbuild.ts
安装打包工具 vsce:
npm install -g vsce
生成 VSIX 安装包:
vsce package
完成后,根目录下会出现 .vsix 文件。
4. 安装扩展
在 VS Code 中按 Ctrl+Shift+P,输入 Extensions: Install from VSIX,选择生成的文件。或者通过插件市场右上角菜单进行安装。
配置模型
扩展安装成功后,即可添加第三方模型。
- 打开模型选择器,点击
manage models。 - 点击新增按钮(通常位于红框区域),此时应能看到自定义选项。
- 输入模型名称并回车。
- 填入对应的
base_url(参考供应商文档)。 - 保存后,右下角会提示成功。
- 再次进入选择器,即可看到新添加的模型。
点击模型后,输入正确的 API Key 和 Model ID。测试时,由于我们移除了安全规则,可以直接询问非编程类问题,验证模型是否正常工作。
总结
通过上述步骤,你可以绕过官方限制,灵活使用各类 OpenAI 兼容模型。虽然需要手动构建,但这提供了更高的自由度和控制权。


