Copilot Model Bridge

把 OpenAI 兼容模型接入 GitHub Copilot Chat 的 VS Code 扩展。

English

Copilot Model Bridge 会把你自己的模型服务注册到 GitHub Copilot Chat 的模型选择器中，让 Ollama、LM Studio、vLLM、NVIDIA NIM、Groq、OpenRouter、Together AI、DeepSeek、Gemini 兼容网关、Anthropic Messages 兼容服务等模型像内置模型一样使用。

[!IMPORTANT] 这个扩展依赖 VS Code 的语言模型 Provider 能力。请使用 VS Code 1.99.0 或更高版本，并确保当前 VS Code / GitHub Copilot 环境允许第三方语言模型 Provider。

适合谁

• 想在 Copilot Chat 里使用本地模型、私有网关或自建 OpenAI 兼容服务的开发者
• 想集中管理多个模型服务、多个模型和不同上下文长度配置的用户
• 想测试支持工具调用、视觉输入、reasoning / thinking 输出的模型能力
• 想在 Copilot Chat 体验中复用 BYOK 或内网模型资源的团队

核心功能

• 多 Provider 管理：为每个服务配置独立的名称、Base URL、API Key 和模型列表
• Chat Completions 模式：支持 OpenAI 兼容的流式对话服务
• Responses 模式：可为支持 Responses 风格的服务切换请求模式
• Anthropic Messages 模式：支持 Claude / Anthropic 兼容 /messages 协议、工具调用、图片和文档输入
• Gemini 兼容增强：优化 Gemini 兼容服务的地址识别、工具声明、思考内容和多轮工具调用体验
• Reasoning 展示：支持 reasoning / thinking 内容的流式展示与最终摘要
• 工具调用能力：按模型声明工具调用、编辑工具偏好和 Agent 模式提示能力
• 多模态开关：按模型声明图片、视频、文件输入能力；不支持的输入会给出清晰错误
• 可视化配置管理器：通过 Webview 管理 Provider 和模型，也支持命令面板向导
• 模型元数据：配置上下文长度、输出上限、倍率标签、模型家族、分类和状态图标

v1.1.1 更新重点

• 新增 anthropic 请求模式，支持 Anthropic Messages API
• 支持 Anthropic 文本、图片、PDF、文本文件、工具调用、工具结果和 thinking 流式事件
• 支持 Anthropic tool_choice、disable_parallel_tool_use、文档引用和 redacted thinking 往返
• Anthropic 临时故障会按 SDK 风格重试，并保留上游错误类型与 request id
• Anthropic extended thinking 默认只对 Claude 模型 ID 自动发送，兼容网关可用 anthropicThinkingMode 显式控制
• 保留 chat / responses 请求模式选择
• 优化 Gemini 兼容服务的工具调用、思考内容和签名续传体验
• 优化 reasoning 内容在 Copilot Chat 中的展示
• 模型请求输出上限优先使用用户配置值
• 非 Anthropic 临时上游故障提示更友好，避免暴露底层服务内部信息
• 失败请求不再默认写入本地诊断文件，降低敏感内容残留风险

要求

[!NOTE] 不同模型服务对工具调用、reasoning、图片输入和 Responses 模式的支持程度不同。建议先用一个基础文本模型验证连通性，再逐步开启高级能力。

快速开始

1. 安装扩展，或通过 VSIX 手动安装。
2. 打开命令面板，运行 Copilot Model Bridge: Open Config Manager。
3. 新增 Provider，填写 Provider ID、显示名称、Base URL、API Key。
4. 选择请求模式：
   • chat：适用于常见 OpenAI 兼容 Chat Completions 服务
   • responses：适用于支持 Responses 风格请求和流式事件的服务
   • anthropic：适用于 Anthropic Messages API 或兼容网关
5. 在该 Provider 下新增模型，填写模型 ID、显示名称、输入/输出 token 上限和能力开关。
6. 打开 Copilot Chat，在模型选择器中选择刚添加的模型。

模型会以 <模型名> (<Provider 名>) 的形式显示，例如：

Kimi K2.5 (NVIDIA NIM)

配置示例

推荐使用配置管理器编辑。需要手写配置时，可在 VS Code Settings JSON 中配置 copilot-model-bridge.providers。

本地 Ollama

{
  "copilot-model-bridge.providers": [
    {
      "id": "ollama-local",
      "displayName": "Ollama",
      "baseUrl": "http://localhost:11434/v1",
      "apiKey": "",
      "apiStyle": "chat",
      "models": [
        {
          "id": "llama3.2",
          "name": "Llama 3.2",
          "maxInputTokens": 32000,
          "maxOutputTokens": 4096,
          "supportsToolCalling": false,
          "supportsVision": false,
          "supportsReasoning": false
        }
      ]
    }
  ]
}

支持 reasoning 的模型

{
  "id": "reasoning-provider",
  "displayName": "Reasoning Gateway",
  "baseUrl": "https://example.com/v1",
  "apiKey": "YOUR_API_KEY",
  "apiStyle": "chat",
  "models": [
    {
      "id": "reasoning-model",
      "name": "Reasoning Model",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCalling": true,
      "supportsReasoning": true,
      "supportedReasoningLevels": ["low", "medium", "high"],
      "defaultReasoningLevel": "medium"
    }
  ]
}

Anthropic Messages / Claude

{
  "id": "anthropic",
  "displayName": "Anthropic",
  "baseUrl": "https://api.anthropic.com/v1",
  "apiKey": "YOUR_API_KEY",
  "apiStyle": "anthropic",
  "models": [
    {
      "id": "claude-sonnet-4-5",
      "name": "Claude Sonnet 4.5",
      "maxInputTokens": 200000,
      "maxOutputTokens": 4096,
      "supportsToolCalling": true,
      "supportsVision": true,
      "supportsReasoning": true,
      "defaultReasoningLevel": "medium",
      "anthropicThinkingDisplay": "summarized"
    }
  ]
}

MiniMax Anthropic 兼容接口

{
  "id": "minimax",
  "displayName": "MiniMax",
  "baseUrl": "https://api.minimax.io/anthropic",
  "apiKey": "YOUR_API_KEY",
  "apiStyle": "anthropic",
  "models": [
    {
      "id": "MiniMax-M3",
      "name": "MiniMax-M3",
      "maxInputTokens": 1000000,
      "maxOutputTokens": 4096,
      "supportsToolCalling": true,
      "supportsVision": true,
      "supportsReasoning": true,
      "anthropicThinkingMode": "enabled"
    }
  ]
}

常用 Base URL

模型能力字段

常用命令

手动安装 VSIX

如果你拿到的是 .vsix 文件：

1. 打开 VS Code Extensions 视图。
2. 点击右上角 ...。
3. 选择 Install from VSIX...。
4. 选择 cmb-copilot-model-bridge-1.1.1.vsix。

也可以使用命令行：

code --install-extension cmb-copilot-model-bridge-1.1.1.vsix

排查建议

本地开发

npm install
npm run compile
npm test

在 VS Code 中打开仓库后按 F5，即可启动 Extension Development Host 调试扩展。

常用脚本：