接入软件
VS Code · GitHub Copilot 自带 Key
用 Copilot 的「Custom Endpoint」把聊天模型换成我们的接入地址。
约 7 分钟适合:在 VS Code 里用 GitHub Copilot Chat 的开发者
开始之前
- VS Code 已安装 GitHub Copilot 扩展并登录,有可用的 Copilot 套餐
- 一把 Key,以及从模型广场复制的模型名(要支持工具调用才能在 Agent 模式里用)
步骤 1 · STEP 0x01
打开模型管理,添加 Custom Endpoint
Chat 视图 → 模型选择器 → Manage Language Models
1
Manage Language Models(齿轮)
2
Add Models
3
Provider
Custom Endpoint
在 Chat 视图的模型选择器里点齿轮进入 Manage Language Models(也可以用命令面板的「Chat: Manage Language Models」),点 Add Models,选 Custom Endpoint。它是官方的通用提供方,支持 Chat Completions、Responses 和 Anthropic Messages 三种接口,取代了旧的「OpenAI Compatible」。
步骤 2 · STEP 0x02
在 chatLanguageModels.json 里填提供方和模型
chatLanguageModels.json(由模型管理编辑器打开)
1
vendor
customendpoint
2
name
随便取,例如 My relay
3
apiKey
<你的 Key>(或用输入变量在首次使用时提示输入)
4
apiType
chat-completions
5
url
https://api.suanlimao.shop/v1/chat/completions
6
models[].id / name
<模型名>
7
models[].toolCalling
true
- 按编辑器给出的模板填:提供方级别写
vendor、name、apiKey、apiType、url,models数组里每个模型写id、name,按需加toolCalling、vision、maxInputTokens、maxOutputTokens。 url官方建议写含 API 路径的完整地址https://api.suanlimao.shop/v1/chat/completions,避免歧义;只写https://api.suanlimao.shop/v1时 VS Code 会按 apiType 自动补路径。- 要用 Claude 系列模型,可以把
apiType改成messages,url填https://api.suanlimao.shop/v1/messages。 - 模型要在 Agent 模式里出现,必须支持工具调用(
toolCalling: true,且模型本身支持)。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
在模型选择器里选它
Chat 视图
1
模型选择器
<模型名>(你的提供方名下)
2
输入框
你好
- 回到 Chat 视图,在模型选择器里找到你的提供方名下的模型,发一句话。
- 官方提示:新模型没出现时重启 VS Code。
官方限制:自带 Key 只作用于聊天和辅助任务;内联代码补全、语义搜索、嵌入仍走 GitHub,不能换。Copilot Business / Enterprise 的管理员可以在 GitHub 的策略里关闭自带 Key。
✓ 怎么确认成功了
- Chat 里选你的模型能得到回答。
- 控制台「用量」页出现这次请求。
常见问题
模型选择器里看不到我加的模型?
先重启 VS Code;仍没有,看它是不是只在 Ask 模式出现——Agent 模式要求模型支持工具调用并设置了 toolCalling: true。
我没有 Copilot 套餐能用吗?
官方说明:没有套餐时自带 Key 只能在已废弃的本地模式里使用,且该模式将被移除。建议改用 Cline、Continue 或 Claude Code。
`github.copilot.chat.customOAIModels` 设置还能用吗?
官方已标为废弃,改用 Custom Endpoint 和 chatLanguageModels.json。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。