把 Router One 的模型接进 VS Code 的 GitHub Copilot Chat

先确认 VS Code 版本和 Copilot 套餐

Custom Endpoint provider 取代了旧的 OpenAI Compatible provider 及其 github.copilot.chat.customOAIModels 设置：1.121 先在 Insiders 预览，1.122（发布说明日期 2026 年 5 月 28 日）进入 Stable。如果 Add Models 列表里只有旧 provider，先升级 VS Code。BYOK 不要求 Copilot 套餐，聊天也不要求登录 GitHub，一把 Router One Key 就够。Copilot Business 或 Enterprise 用户受组织策略「Bring Your Own Language Model Key in VS Code」约束：GitHub 2026 年 4 月的更新日志写明该策略默认开启、管理员可以关闭；如果 Add Models 里找不到 Custom Endpoint，先问管理员，再排查配置。BYOK 模型的用量由你配置的供应商计费——这里就是你的 Router One 钱包——不计入 Copilot 的请求额度。

把 GitHub Copilot 配置到 Router One base URL

在命令面板运行 Chat: Manage Language Models（或点聊天模型选择器里的齿轮图标），选 Add Models → Custom Endpoint，输入分组名（如 Router One），再输入显示名称和你的 Router One Key，API 类型选 Chat Completions。VS Code 会打开 chatLanguageModels.json，把其中的 models 数组改成下面的条目。url 填完整的 /v1/chat/completions 地址：官方文档建议填完整路径以避免二义，VS Code 会原样使用。apiKey 保持输入变量形式，不要把明文 Key 写进文件；之后可在 Language Models editor 里用 Update API Key 轮换。toolCalling 必须为 true，在聊天里使用 agent 时模型才会被列出，所以要选详情页标注支持工具调用的模型；vision 按模型的输入模态填写；maxInputTokens 与 maxOutputTokens 之和不能超过模型页显示的上下文窗口，因为 VS Code 把两者之和当作总上下文窗口：

[
  {
    "name": "Router One",
    "vendor": "customendpoint",
    "apiKey": "${input:routerOneApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "<model-id-from-/models>",
        "name": "<label shown in the model picker>",
        "url": "https://api.router.one/v1/chat/completions",
        "toolCalling": true,
        "vision": <true if the model page lists image input>,
        "maxInputTokens": <context window minus maxOutputTokens>,
        "maxOutputTokens": <output tokens you allow per reply>
      }
    ]
  }
]

哪些功能走 Router One Key，哪些仍留在 Copilot

BYOK 覆盖 Chat 视图里的聊天体验——聊天与 agent 工作流——以及可选开启的后台辅助任务。其余功能继续使用 GitHub 的服务，需要登录账号并持有 Copilot 套餐。两个辅助任务设置都指向 Router One 之后，每次后台调用也会出现在 Dashboard → Logs 的同一把 Key 下；给 VS Code 单独建一把 Key 并设置 maxSpend，长时间的 agent 会话或频繁的辅助调用就会停在你设定的上限。

GitHub Copilot 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 GitHub Copilot 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个工具单独建 API Key，并设置 maxSpend 消费上限。

GitHub Copilot 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在 trace 里验证 GitHub Copilot 的调用

先在 GitHub Copilot 发出一次简单文本请求，再到 Dashboard → Logs 按时间、模型和 request_id 核对 trace：tokens、花费、延迟和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，先查客户端配置和网络，不能仅凭客户端报错认定是网关或上游故障。

常见问题