VS Code 自定义端点模型
VS Code 官方文档提供 Bring Your Own Key(BYOK)和 Custom Endpoint 能力:你可以在 Language Models 编辑器中添加自定义模型端点,并在 Chat 模型选择器中使用。Modelink 可以按兼容协议作为自定义端点接入 VS Code Chat。
信息
Custom Endpoint 用于 VS Code Chat、Agent 会话和部分工具任务。语义搜索、内联补全、嵌入等依赖 GitHub Copilot 服务的能力,仍可能需要 GitHub 账号、Copilot 计划或对应组织策略。
适用范围
VS Code 的 Custom Endpoint provider 支持三种 API 类型,可按模型和端点能力选择:
| API 类型 | 适用场景 | Modelink 接入点 |
|---|---|---|
| Chat Completions | 兼容 OpenAI Chat Completions 的模型 | 中国大陆 https://api.qnaigc.com/v1/chat/completions,海外 https://api.modelink.ai/v1/chat/completions |
| Responses | 兼容 OpenAI Responses API 的模型 | 中国大陆 https://api.qnaigc.com/v1/responses,海外 https://api.modelink.ai/v1/responses |
| Messages | 兼容 Anthropic Messages API 的模型 | 以 Modelink 控制台或接入点文档展示的完整 Messages URL 为准 |
添加 Modelink 自定义端点
按 VS Code 官方流程操作:
- 在 Chat 模型选择器中点击齿轮图标,选择 Manage Language Models;也可以在 Command Palette 运行 Chat: Manage Language Models。
- 选择 Add Models。
- 选择 Custom Endpoint。
- 输入分组名称,例如
Modelink。 - 输入端点显示名称和 Modelink API Key。
- 选择 API 类型:Chat Completions、Responses 或 Messages。选择前确认目标模型支持该 API 类型。
- VS Code 会打开
chatLanguageModels.json,在其中补充模型 ID、显示名称、完整 URL 和模型能力。 - 保存文件后,在 Chat 模型选择器中选择刚添加的 Modelink 模型。
如果模型没有立即出现在选择器中,重启 VS Code。
chatLanguageModels.json 示例
下面示例使用 Responses API。请把 <model-id> 替换为 Modelink 控制台中的模型 ID,并根据实际模型能力调整 toolCalling、vision、maxInputTokens 和 maxOutputTokens。
[
{
"name": "Modelink",
"vendor": "customendpoint",
"apiKey": "YOUR_MODELINK_API_KEY",
"apiType": "responses",
"models": [
{
"id": "<model-id>",
"name": "Modelink Model",
"url": "https://api.qnaigc.com/v1/responses",
"toolCalling": true,
"vision": false,
"maxInputTokens": 128000,
"maxOutputTokens": 8192
}
]
}
]海外接入点请把 url 改为:
https://api.modelink.ai/v1/responses如果选择 Chat Completions API,将 apiType 改为 chat-completions,并把 url 改为对应区域的 /v1/chat/completions 完整地址。
与 GitHub Copilot 的关系
Custom Endpoint 是 VS Code 的 BYOK 模型接入方式,不等同于把 GitHub Copilot 官方服务的后端替换为 Modelink。
- 你可以在 VS Code Chat 中选择 Modelink 自定义端点模型。
- 如果使用 Copilot Business 或 Enterprise,组织管理员可能需要启用 BYOK 相关策略。
- 内联补全、语义搜索、嵌入等能力是否可用,取决于 VS Code / Copilot 当前功能范围和账号策略。
排障建议
- 模型不显示:确认已保存
chatLanguageModels.json,并重启 VS Code。 - Agent 模式不显示模型:确认该模型配置了
toolCalling: true,且模型实际支持工具调用。 - 认证失败:检查 API Key 是否有效,是否复制了空格或换行。
- 请求 404:确认
url是完整接口地址,而不是仅填写 Base URL。 - 协议不匹配:确认
apiType与 URL 对应,例如responses应对应/v1/responses。 - 组织策略限制:Copilot Business / Enterprise 用户需要确认组织已允许 BYOK。