GitHub Copilot 接入指南:本地 BYOK 与企业自定义模型
核对 GitHub Copilot 本地 BYOK、VS Code Custom Endpoint 和企业 BYOK 的权限差异,说明支持协议、账号要求与功能范围,避免把自定义模型当作全平台替换。
内容复核中 官方配置已核对;本站接入未实测。 图解为本站原创示意,不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例,不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
先区分本地和企业 BYOK
GitHub 官方把 BYOK 分为本地客户端配置与企业服务端配置。本地 Key 只由客户端处理,企业 BYOK 则通过 Copilot API 提供模型,使用者仍需 Copilot 许可证和联网。 不同入口的账号要求不能互换。
本篇采用 VS Code 当前文档中的本地 Custom Endpoint 路径。该路径的聊天与辅助任务可使用自有模型,不要求 GitHub 登录或 Copilot 套餐;部分语义检索、代码补全等功能仍要求 GitHub 账号。 这不是绕过订阅,也不代表所有 Copilot 功能都换用了自定义端点。
在 VS Code 添加端点
执行 Chat: Manage Language Models,选择 Add Models,再选择 Custom Endpoint,设置分组、显示名、Key 和 API 类型。随后按客户端生成的 chatLanguageModels.json 完成模型字段。 旧的 OpenAI Compatible 设置已被当前入口替代,先核对版本,不照搬历史配置。
下面是原创字段示意;地址和凭证全为占位,并无真实接口,不代表本站已有 API:
| 字段 | 示例 |
|---|---|
| vendor | customendpoint |
| apiType | chat-completions |
| 模型 url | https://80321.cn/v1/chat/completions |
| 模型 id | YOUR_MODEL_ID |
| API Key 输入 | YOUR_API_KEY |
官方还支持 Responses 与 Messages。明确填写完整路径可减少自动补齐版本和接口后缀的歧义。
企业入口有哪些限制
企业自定义模型处于公开预览,官方支持的 Provider 列表包含 OpenAI-compatible providers,但这不等于任意协议都可接入。 管理者需要在企业 AI controls 的 Copilot 页面配置自定义模型,并控制向哪些组织开放。
本地 BYOK 也可能被 Business 或 Enterprise 管理策略关闭。 团队部署前应分别确认本地策略、企业模型启用状态和用户许可证,不要把个人客户端的测试结果当作企业批准。本文未核验特定账号的管理页面。
模型不出现时先看功能范围
Agent 聊天要求模型支持工具调用,否则可能不会进入可选列表;保存后仍未出现时,官方建议重启 VS Code。 不应仅为显示模型就虚报工具能力。连接失败时核对 API 类型、最终路径、模型权限和代理网络,再比较客户端脱敏日志。
代码补全没变化并不必然意味着接入失败,先确认测试的是聊天而非独立的补全链路。
凭证和代码流向分别审查
真实 Key 使用客户端安全输入机制,不提交原始值到配置仓库;官方推荐通过输入变量引用安全保存的 Key。 本地与企业方式的凭证处理边界不同,均须核对外部模型的数据政策、日志保留和组织代码外发要求。 首次只用脱敏文件验证,不导出账号 Token,更不能借他人订阅替代授权。