DeepSeek V4 for Copilot Chat：把 DeepSeek V4 装进 VS Code Copilot 模型选择器安装与使用指南

项目背景

GitHub Copilot 是无数开发者最熟悉的 VS Code AI 编程入口，但它默认绑定的是闭源模型；而 DeepSeek V4 以极高的性价比和强悍的推理能力著称。很多人既想要 Copilot 成熟的 Agent 模式、文件编辑、终端调用、代码搜索、Git、测试工具链，又想让背后真正干活的模型换成便宜又好用的 DeepSeek V4。

过去要做到这一点，往往得在本地搭一个 LiteLLM 之类的代理服务器，手动折腾 API 地址、模型名和各种参数，门槛很高。DeepSeek V4 for Copilot Chat 由 Vizards 团队开源，彻底改变了这个局面：它不新建侧边栏、不重做聊天界面，只是在 Copilot Chat 原有的模型选择器里"加一个选项"——你照样用熟悉的 Copilot 界面，只是把回答问题、执行工具的大模型切换成了 DeepSeek V4。

该项目在 GitHub 上已收获 1.5k Star，并被 DeepSeek 官方 API 文档收录为推荐的 Copilot 接入方式。它完全免费、BYOK（自带 Key），你的 API 密钥、账单、限流都直接走 DeepSeek 官方账户。

核心特性

• 不替换 Copilot，只是给它换引擎：不增加新的侧边栏或聊天 UI，只是在你已经习惯的模型选择器里多一个 DeepSeek 选项。
• Agent 模式全家桶保留：Copilot 的 Agent 模式、工具调用、指令文件（.instructions.md / AGENTS.md）、Skills、MCP 全部照常工作，只是底层换成 DeepSeek。
• 双路图片理解：V4.1 Flash 与 Flash Vision Exp 原生接收图片附件；V4 Flash / Pro 通过可配置的 Vision Proxy 把图片转成文字描述后再交给主模型。
• 思考模式与推理强度：支持 DeepSeek 的 reasoning_content，可选 none / low / high（默认）/ max。
• BYOK 密钥安全存储：API Key 存放在 VS Code 的 SecretStorage（操作系统钥匙串），绝不写入 settings.json，也不会进入 Git 历史。
• 零运行时依赖：纯 VS Code API + Node.js 内置模块，不需要 Python、Docker，也不需要维护任何本地代理进程。
• 上下文缓存命中率可见：在输出通道里实时打印 DeepSeek prompt 缓存命中率，省钱效果一目了然。

环境要求

• VS Code：1.116 或更高版本（依赖 Copilot Chat 非公开 API）。
• GitHub Copilot：已安装并登录 Copilot Chat，Free / Pro / Enterprise 订阅均可（免费版也能用）。
• DeepSeek API Key：从 platform.deepseek.com 获取，以 sk- 开头。
• 操作系统：Windows / macOS / Linux 均可。

详细部署步骤

第一步：升级 VS Code 并确认 Copilot 已激活

打开 VS Code，菜单 帮助 → 关于 确认版本 ≥ 1.116；若版本过低，先到 官网升级。然后确认已经安装并登录了 GitHub Copilot 与 GitHub Copilot Chat 扩展（在扩展面板搜索 Copilot，确保两个都是已启用状态）。

第二步：安装扩展

方式一（推荐）：在 VS Code 左侧扩展面板（快捷键 Ctrl+Shift+X）搜索 DeepSeek V4 for Copilot Chat，发布者为 Vizards，点击安装。

方式二：从命令行一键安装：

code --install-extension Vizards.deepseek-v4-for-copilot

方式三：Open VSX 系编辑器（如 VSCodium）从 Open VSX 搜索同名扩展安装。

第三步：配置 DeepSeek API Key

安装后无需手写配置文件，全程图形化：

1. 按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）打开命令面板。
2. 输入并选择 DeepSeek: Set API Key。
3. 在顶部弹出的输入框中粘贴你的 DeepSeek API Key（sk-...），回车确认。

密钥会被安全地存进操作系统钥匙串，不会明文落盘。

第四步：在 Copilot Chat 中选择 DeepSeek 模型

1. 打开 Copilot Chat（快捷键 Ctrl+Alt+I 或 Cmd+Alt+I）。
2. 点击聊天输入框下方的模型选择器。
3. 在列表中选择 DeepSeek V4.1 Flash（推荐日常用，快且便宜）或 DeepSeek V4 Pro（复杂重构、深度推理）。
4. 在模型上悬停即可选择思考强度（Thinking Effort）：none / low / high / max。

看到模型列表里出现 DeepSeek 选项、并能正常对话，即说明部署成功。

第五步（可选）：接入第三方兼容网关

如果你用的是自建代理或企业 LLM 网关，打开设置（Ctrl+,）搜索 deepseek-copilot，可修改 baseUrl、maxTokens、modelIdOverrides 等。示例：

{
  "deepseek-copilot.baseUrl": "https://your-proxy.example.com/v1",
  "deepseek-copilot.modelIdOverrides": {
    "deepseek-flash": "your-v4.1-flash-model-id",
    "deepseek-v4-pro": "your-pro-model-id"
  },
  "deepseek-copilot.maxTokens": 8192
}

常见坑与解决办法

• 模型选择器里看不到 DeepSeek：先确认扩展已启用、VS Code 版本 ≥ 1.116；再执行命令面板 Developer: Reload Window 重载窗口。
• 提示需要 API Key：说明还没执行 DeepSeek: Set API Key，重新执行一次并粘贴 Key。
• 401 / 403：Key 错误或失效，回平台重新生成。
• 402：DeepSeek 账户余额不足，需充值（注意：Copilot 订阅和 DeepSeek API 是两个独立账单）。
• VS Code 升级后插件失效：该扩展依赖 Copilot 非公开 API，遇到新版 VS Code 不兼容时去 GitHub 提 Issue 或等待扩展更新。

使用方法示例

配置完成后，在 Copilot Chat 里直接用自然语言下达 Agent 任务即可，例如：

请分析当前项目的目录结构，找到模型定义、数据加载和训练入口文件，
然后帮我修复训练集中验证集数据泄漏的问题。

切换到 Agent 模式后，DeepSeek 会自动完成读文件、搜索、编辑、跑终端命令、跑测试等多步操作，全过程流式显示思考过程与工具调用。日常小任务选 V4.1 Flash + high，跨文件重构选 V4 Pro + max 即可。

常见问题 FAQ

Q1：需要同时付费给 GitHub 和 DeepSeek 吗？
A：是的。Copilot Chat 需要有效的 Copilot 订阅（免费版也可），而模型调用费用走你的 DeepSeek API 账户，两者独立计费。

Q2：API Key 安全吗？
A：存放在 VS Code SecretStorage（macOS 钥匙串 / Windows 凭据管理器 / Linux libsecret），不会写入 settings.json，不会进 Git。

Q3：能识别截图吗？
A：V4.1 Flash / Flash Vision Exp 原生识图；V4 Flash / Pro 通过 Vision Proxy 把图片转描述后再分析。

Q4：和本地搭 LiteLLM 代理相比有什么优势？
A：无需额外常驻进程、一键安装、Key 进钥匙串、原生支持视觉与思考模式，维护成本最低。

Q5：支持 MCP 和 Skills 吗？
A：完整继承 Copilot 的 MCP、Skills、.instructions.md、AGENTS.md 能力，配置方式与原生 Copilot 完全一致。

跳转链接

• GitHub 仓库：https://github.com/Vizards/deepseek-v4-for-copilot
• VS Code Marketplace：https://marketplace.visualstudio.com/items?itemName=Vizards.deepseek-v4-for-copilot
• DeepSeek 官方接入文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/github_copilot/
• API Key 申请：https://platform.deepseek.com/api_keys