扩展接入自定义 API
学习目标
- 了解通过 VS Code 扩展为 Copilot 接入第三方模型的基本原理。
- 掌握使用单模型扩展（如 DeepSeek V4 for Copilot Chat）在 Copilot 中切换模型。
- 掌握使用多模型聚合扩展（如 GCMP）接入多家国内模型提供商。
- 掌握通用的 OpenAI / Anthropic 兼容协议配置方法。
- 了解 API Key 的安全管理策略。
前置条件
- 已完成 Copilot 内置扩展激活与登录（参考 00_copilot基础与订阅说明）。
- 拥有至少一个第三方 API Key（如 DeepSeek、OpenAI、 Anthropic 或国内厂商）。
- 了解基本的 VS Code 设置（settings.json）编辑。
为什么需要自定义 API
GitHub Copilot 自带的模型（GPT 系列）能满足大部分场景，但在以下情况下你可能需要接入其他模型：
| 场景 | 说明 |
|---|---|
| 使用其他模型 | 想用 DeepSeek V4、Claude、Gemini 或国产模型（GLM、Qwen 等） |
| 成本控制 | DeepSeek 等模型价格更低，适合高频使用 |
| 私有化部署 | 企业数据不出网，接入内部部署的模型 |
| 模型自由切换 | 在同一 Copilot 界面中快速切换不同模型以对比效果 |
| 国内直连 | 直接使用国内厂商的 API，延迟更低、网络更稳定 |
核心思路：扩展直接嵌入 Copilot
与安装一套全新的 AI 编程助手（如 Continue）不同，本教程介绍的扩展采用另一种架构：直接在 Copilot Chat 的模型选择器中添加新的模型选项。
┌─────────────────────────────────────┐
│ VS Code Copilot Chat │
│ ┌─────────────────────────────────┐ │
│ │ 模型选择器 ▼ │ │
│ │ ├─ GPT-4o (内置) │ │
│ │ ├─ Claude Sonnet (内置) │ │
│ │ ├─ DeepSeek V4 Pro (扩展注入) │ │ ← 扩展添加的
│ │ └─ GLM-5.2 (扩展注入) │ │ ← 扩展添加的
│ └─────────────────────────────────┘ │
│ Agent 模式 / 工具调用 / 指令 │
│ 全部保留，仅更换底层模型 │
└─────────────────────────────────────┘
这样做的好处是：
- 无需学习新界面 — 仍然使用 Copilot Chat 的同一套 UI。
- 完整保留 Copilot 能力 — Agent 模式、工具调用（文件编辑、终端命令）、MCP、Skill、指令文件，全部正常工作。
- 切换零成本 — 在模型选择器中点一下即可切换，对话历史不丢失。
方案一：单模型扩展（以 DeepSeek V4 for Copilot Chat 为例）
DeepSeek V4 for Copilot Chat 是一个典型的单模型扩展，它将 DeepSeek V4 Pro 和 Flash 两个模型注入到 Copilot Chat 的选择器中。
第 1 步：安装扩展
- 在 VS Code 中按
Ctrl+Shift+X打开扩展面板。 - 搜索
DeepSeek V4 for Copilot Chat（扩展 ID:Vizards.deepseek-v4-for-copilot）。 - 点击 安装。
第 2 步：配置 API Key
- 按
Ctrl+Shift+P打开命令面板。 - 执行 DeepSeek: Set API Key。
- 粘贴你的 DeepSeek API Key（在 platform.deepseek.com 获取）。
- Key 会安全存储在操作系统的密钥链（Keychain / Credential Manager）中，不会写入
settings.json或磁盘文件。
第 3 步：在 Copilot 中使用
- 打开 Copilot Chat 面板。
- 点击输入框上方的模型选择器下拉菜单。
- 你会看到新增的 DeepSeek V4 Pro 和 DeepSeek V4 Flash 两个选项。
- 选中即可开始对话，Agent 模式、工具调用等功能全部保留。
高级设置
该扩展支持通过 settings.json 自定义配置：
{
// 自定义 API 端点（用于自托管或代理部署）
"deepseek-copilot.baseUrl": "https://api.deepseek.com",
// 最大输出 Token（0 表示不限制）
"deepseek-copilot.maxTokens": 4096,
// 模型 ID 映射（用于兼容第三方 API 的不同模型名）
"deepseek-copilot.modelIdOverrides": {
"deepseek-v4-flash": "your-flash-model-id",
"deepseek-v4-pro": "your-pro-model-id"
},
// 视觉代理：用于给 DeepSeek（纯文本模型）描述图片
"deepseek-copilot.visionModel": "gpt-4o"
}思考力度（Thinking Effort）可直接在 Copilot Chat 的模型选择器菜单中调整，支持
none/high（默认） /max三档。
方案二：多模型聚合扩展（以 GCMP 为例）
AI Chat Models (GCMP) 是一个聚合多模型提供商的扩展，内置了数十家国内外模型厂商的支持，只需输入对应的 API Key 即可使用。
第 1 步：安装扩展
- 在扩展面板中搜索
GCMP（扩展 ID:vicanent.gcmp）。 - 点击 安装。
第 2 步：添加模型提供商
- 打开 Copilot Chat 面板。
- 在模型选择器底部点击 管理模型。
- 从弹出的提供商列表中选择一家：
| 提供商 | 需要配置 | 特点 |
|---|---|---|
| DeepSeek | DeepSeek API Key | DeepSeek V4 Flash / Pro |
| 智谱AI | 智谱 API Key | GLM-5.2 / GLM-4.7 等 |
| 阿里云百炼 | 阿里云 API Key | Qwen3.7-Max / Qwen3-Coder 等 |
| 火山方舟 | 火山引擎 API Key | 豆包系列 / DeepSeek / GLM 等 |
| MoonshotAI | Moonshot API Key | Kimi K2.5 / K2.6 / K2.7 |
| 腾讯云 | 腾讯云 API Key | 混元 / GLM / DeepSeek 等 |
| MiniMax | MiniMax API Key | MiniMax M3 等 |
| OpenAI | OpenAI API Key | GPT-4o / GPT-4 等 |
| Anthropic | Anthropic API Key | Claude Sonnet / Opus 等 |
- 如果是首次使用该提供商，按提示输入 API Key。
- 返回模型选择器，勾选要启用的模型。
第 3 步：开始对话
选中模型后即可在 Copilot Chat 中正常使用。所有 Copilot 功能（Agent 模式、工具调用等）均可正常工作。
GCMP 还提供 Token 消耗统计、Commit 消息生成、视觉分析、API Key 跨设备同步等附加功能，可在扩展详情页了解。
若需接入预置列表之外的模型，见下文 方案三（Compatible Provider）。
方案三：通用 OpenAI / Anthropic 兼容协议
如果你使用的模型服务商不在上述扩展的预置列表中，只要它提供 OpenAI 或 Anthropic 兼容的 API，就可以通过通用兼容模式接入。
使用 GCMP 的 Compatible Provider
GCMP 内置了 Compatible Provider，支持完全自定义：
- 执行命令面板中的 GCMP: Compatible Provider 设置。
- 按向导输入：
- 名称：任意标识（如 “我的自定义模型”）
- 协议类型：OpenAI Compatible 或 Anthropic Compatible
- Base URL：API 端点地址（如
https://api.example.com/v1） - 模型 ID：模型名称（如
gpt-5.6-terra） - API Key：认证密钥（如不需要可留空）
- 额外参数：Temperature、Max Tokens 等
向导输入的 API Key 会存入 GCMP 的 secret（密钥存储），不会写入
settings.json。
配置示例（接入第三方 GPT 兼容服务，Key 通过 GCMP 命令另行录入 secret）：
{
"gcmp.compatibleModels": [
{
"id": "GPT-5.6-terra",
"name": "GPT-5.6 Terra",
"provider": "ww",
"baseUrl": "https://direct-api.example.com/v1",
"model": "gpt-5.6-terra",
"sdkMode": "openai-responses",
"maxInputTokens": 272000,
"maxOutputTokens": 128000,
"reasoningEffort": ["low", "medium", "high", "xhigh"],
"capabilities": {
"toolCalling": true,
"imageInput": true
}
}
]
}各字段含义如下表；Key 通过 GCMP 命令存入 secret，不会出现在 settings.json。
常见字段说明：
| 字段 | 说明 | 示例值 |
|---|---|---|
id / name | 模型唯一标识与显示名称 | GPT-5.6-terra / GPT-5.6 Terra |
provider | 提供商标识（自定义值） | ww、openai、anthropic |
baseUrl | API 端点基地址 | https://direct-api.example.com/v1 |
model | 实际请求的模型名 | gpt-5.6-terra |
sdkMode | 协议模式 | openai-chat / openai-responses / anthropic |
maxInputTokens / maxOutputTokens | 输入 / 输出 Token 上限 | 272000 / 128000 |
reasoningEffort | 支持的思考力度档位（数组） | ["low","medium","high","xhigh"] |
capabilities | 能力开关：toolCalling（工具调用）、imageInput（图片输入） | {"toolCalling": true, "imageInput": true} |
配置完模型后，还需通过 GCMP 的 Set API Key / 模型管理 命令为对应 provider 录入 Key。Key 会存入系统密钥存储（secret），不会出现在
settings.json或提交到仓库。
方案对比
| 对比维度 | DeepSeek V4 for Copilot Chat | GCMP (AI Chat Models) | Compatible Provider |
|---|---|---|---|
| 定位 | 单模型深度集成 | 多模型聚合平台 | 通用兼容接入 |
| 预置提供商 | DeepSeek 一家 | 15+ 家国内厂商 + OpenAI/Anthropic | 无，需手动配置 |
| 自定义模型 | 支持（修改 modelIdOverrides） | 支持（Compatible Provider） | 完全自定义 |
| API Key 存储 | OS 密钥链 | GCMP secret（密钥存储）/ Gist 同步 | secret / 环境变量 |
| 额外功能 | 视觉代理、思考力度控制 | Token 统计、Commit 生成、视觉分析、API 同步 | 无 |
API Key 安全管理
API Key 安全提示
API Key 等同于密码，切勿硬编码到公开仓库或分享给他人。
推荐做法
- 使用扩展原生的安全存储：DeepSeek V4 for Copilot Chat 将 Key 存在 OS 密钥链中，不落盘；GCMP 同样把 Key 存入 secret（密钥存储），
settings.json里只保留模型定义、不含 Key。 - 优先用扩展命令录入 Key：GCMP 通过 Set API Key / 模型管理 命令录入 Key，存入 secret 后即可被对应 provider 使用，无需手写进配置文件。
- 不要将 Key 提交到 Git：由于 Key 已存入 secret，
settings.json中的gcmp.compatibleModels本身不含密钥，可放心纳入版本控制；但切勿把任何明文 Key（如环境变量值、备份文件）提交到仓库。
模型选择策略
| 需求 | 推荐方案 | 理由 |
|---|---|---|
| 日常编码辅助 | DeepSeek V4 Flash | 速度快、成本低 |
| 复杂重构 / Agent | DeepSeek V4 Pro / GLM-5.2 | 推理能力强 |
| 需要多模型切换 | GCMP（同时配置多家） | 一个扩展、多个选择 |
| 国内低延迟访问 | GCMP + 国内厂商（智谱/阿里/火山） | 国内节点，延迟低 |
| 私有化部署 | Compatible Provider | 接入内部部署的模型服务 |
| 预算敏感 | DeepSeek / 开源模型 | 性价比极高 |
扩展阅读
- DeepSeek V4 for Copilot Chat - Marketplace
- AI Chat Models (GCMP) - Marketplace
- DeepSeek API 文档
- VS Code 扩展市场 - AI 分类
常见问题
Q：安装这些扩展后，原来的 Copilot 模型（GPT 系列）还在吗？
A：在。扩展只是在模型选择器中新增选项，不会覆盖或移除原有的模型。你随时可以切回 GPT-4o 等内置模型。
Q：这些扩展是否影响 Copilot 的代码自动补全（Tab 补全）？
A：不影响。自动补全仍然由 Copilot 内置服务处理。扩展只影响 Chat 对话和 Agent 模式。
Q：API Key 配置后如何更换？
A：DeepSeek V4 扩展可通过命令面板重新执行 Set API Key；GCMP 可在模型管理界面重新输入 Key。
Q：免费用户可以使用这些扩展吗？
A：可以。Copilot Free 用户同样可以在模型选择器中看到并使用扩展添加的模型。但需要注意，第三方模型的 API 调用费用由你自己承担（直接支付给模型提供商）。
Q：扩展是否支持 VS Code Remote SSH / Dev Containers？
A：支持。在远程环境中安装对应扩展即可。API Key 需要在远程环境中重新配置。
Q：GCMP 支持哪些协议的自定义模型？
A：支持 OpenAI Compatible 和 Anthropic Compatible 两种协议。基本上所有主流模型服务商都至少兼容其中一种。