算力猫
← 返回教程列表

接入软件

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」。

去创建 Key →

步骤 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)。