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 为准

按 VS Code 官方流程操作:

  1. 在 Chat 模型选择器中点击齿轮图标,选择 Manage Language Models;也可以在 Command Palette 运行 Chat: Manage Language Models
  2. 选择 Add Models
  3. 选择 Custom Endpoint
  4. 输入分组名称,例如 Modelink
  5. 输入端点显示名称和 Modelink API Key。
  6. 选择 API 类型:Chat CompletionsResponsesMessages。选择前确认目标模型支持该 API 类型。
  7. VS Code 会打开 chatLanguageModels.json,在其中补充模型 ID、显示名称、完整 URL 和模型能力。
  8. 保存文件后,在 Chat 模型选择器中选择刚添加的 Modelink 模型。

如果模型没有立即出现在选择器中,重启 VS Code。

chatLanguageModels.json 示例

下面示例使用 Responses API。请把 <model-id> 替换为 Modelink 控制台中的模型 ID,并根据实际模型能力调整 toolCallingvisionmaxInputTokensmaxOutputTokens

[
  {
    "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。

参考