一、前言
GitHub Copilot 是集成在 VS Code 中的 AI 编程助手,可以帮助我们解释代码、修改项目、排查错误以及执行 Agent 任务。
如果想在 Copilot Chat 中使用 DeepSeek,过去通常需要手动配置 API 地址、模型名称和各种参数。现在借助DeepSeek V4 for Copilot Chat插件,只需要安装插件并填写 DeepSeek API Key,就能直接把 DeepSeek V4 添加到 Copilot Chat 的模型列表中。
本文使用的插件是:
DeepSeek V4 for Copilot Chat发布者为:
Vizards扩展 ID 为:
Vizards.deepseek-v4-for-copilot插件地址:
DeepSeek V4 for Copilot Chat
二、这款插件有什么作用?
这款插件不会创建一个新的聊天窗口,而是直接把 DeepSeek V4 接入原有的 GitHub Copilot Chat。
安装完成后,可以在 Copilot Chat 的模型列表中直接选择:
DeepSeek V4 Flash DeepSeek V4 Pro也就是说,我们仍然使用熟悉的 Copilot 界面,只是把实际回答和执行任务的模型切换为 DeepSeek。
插件支持:
- Copilot Chat 对话;
- Agent 模式;
- 项目文件读取与修改;
- 终端命令调用;
- 工作区代码搜索;
- Git 和测试工具;
- MCP 工具;
-项目指令和 Skills; - DeepSeek思考模式;
- 图片代理识别;
- DeepSeek API 用量统计。
与手动配置 Custom Endpoint 相比,这种方式对初学者更加友好,不需要修改复杂的 JSON 文件,也不需要安装 Python、Docker或本地代理服务器。
三、准备工作
安装插件前,需要准备:
- VS Code 1.116 或更高版本;
- GitHub Copilot Chat;
- 可用的 GitHub Copilot 账户;
- DeepSeek API Key;
- DeepSeek API 账户余额。
GitHub Copilot Free、Pro 和 Enterprise 均可以使用该插件。
如果使用的是 VS Code 1.118.0,则已经满足插件最低版本要求。
四、安装插件
打开 VS Code,点击左侧的“扩展”按钮,或者使用快捷键:
Ctrl + Shift + X在扩展商店中搜索:
DeepSeek V4 for Copilot Chat搜索结果中可能出现多个名称相似的 DeepSeek 插件,因此需要确认以下信息:
插件名称:DeepSeek V4 for Copilot Chat 发布者:Vizards 扩展 ID:Vizards.deepseek-v4-for-copilot确认无误后,点击“安装”。
五、申请 DeepSeek API Key
安装该插件前,它会让我们提供DeepSeek API
打开 DeepSeek API 平台:
DeepSeek API Key 管理页面
登录账户后,创建一个新的 API Key。DeepSeek 官方 API Key 通常以以下内容开头:
sk-例如:
sk-xxxxxxxxxxxxxxxxxxxxxxxx需要注意:
- API Key 通常只会完整显示一次;
- 不要把自己的 API Key 发给别人;
- 不要将 API Key 上传到 GitHub;
- DeepSeek API 和 DeepSeek 网页版不是同一个额度;
- 使用插件调用 DeepSeek 时,费用由 DeepSeek API 账户承担。
插件会把 API Key 存入 VS Code 的 SecretStorage,也就是操作系统的凭据存储区域,而不是直接写入settings.json。
六、在插件中填写 API Key
插件安装完成后,按下:
Ctrl + Shift + P打开 VS Code 命令面板。
搜索并运行:
DeepSeek: Set API Key随后,VS Code 会在顶部弹出输入框。
将刚刚申请的 DeepSeek API Key 粘贴进去,然后按下:
Enter到这里,DeepSeek API 就已经配置完成。
整个过程不需要手动填写 Base URL,也不需要手动设置模型 ID。插件默认使用:
https://api.deepseek.com七、在 Copilot Chat 中选择 DeepSeek
打开 GitHub Copilot Chat,点击聊天输入框下方的模型名称。
在模型列表中应该可以看到:
DeepSeek V4 Flash DeepSeek V4 Pro选择其中一个模型,就可以开始使用。
如果没有看到 DeepSeek 模型,可以按下:
Ctrl + Shift + P运行:
Developer: Reload Window重新加载 VS Code 窗口,然后再次打开 Copilot Chat。
八、V4 Flash 和 V4 Pro 应该怎么选?
插件提供两种 DeepSeek V4 模型。
| 模型 | 主要特点 | 适用场景 |
|---|---|---|
| DeepSeek V4 Flash | 速度快、费用低 | 日常问答、解释代码、小范围修改 |
| DeepSeek V4 Pro | 推理能力更强 | 复杂调试、多文件修改、Agent 任务 |
对于大部分日常编程任务,可以优先选择:
DeepSeek V4 Flash例如:
请解释当前代码的主要作用。请给这个函数补充中文注释。请检查这段代码是否存在语法错误。当任务涉及整个项目或者需要连续修改多个文件时,可以选择:
DeepSeek V4 Pro例如:
请分析当前项目的目录结构,找到模型定义、数据加载和训练入口文件。请检查整个项目中是否存在训练集和验证集数据泄漏。请修改模型结构,并运行测试确认修改后能够正常工作。九、如何选择思考强度?
DeepSeek V4 Flash 和 V4 Pro 都支持思考强度设置。
在 Copilot Chat 的模型选择器中,将鼠标移动到 DeepSeek 模型上,可以选择:
| 思考强度 | 含义 | 适用任务 |
none | 关闭深度思考 | 简单问答和快速修改 |
low | 少量思考 | 普通代码解释 |
high | 平衡速度与推理 | 一般复杂任务,默认推荐 |
max | 最大思考强度 | 复杂调试和多步骤 Agent 任务 |
日常使用建议选择:
high面对复杂的项目分析、模型结构修改或者难以定位的程序错误时,再切换到:
max思考强度越高,模型通常会消耗更多 Token,响应时间和 API 费用也可能随之增加。
十、这个插件能让 DeepSeek识别图片吗?
DeepSeek V4 本身是文本模型,不能直接理解图片。
但是,DeepSeek V4 for Copilot Chat 提供了Vision Proxy,也就是图片代理功能。
当我们把图片上传到 Copilot Chat 后,插件会先调用另一个支持图像识别的 Copilot 模型分析图片,再把生成的文字描述交给 DeepSeek。
实际流程为:
用户上传图片 → 视觉模型识别图片 → 生成图片文字描述 → DeepSeek读取描述 → DeepSeek分析并回答因此,这并不是 DeepSeek直接看到了原图,而是通过另一个视觉模型完成中转。
配置方法如下:
- 按下
Ctrl + Shift + P; - 搜索并运行:
DeepSeek: Configure Vision Proxy- 选择一个支持图像输入的 Copilot 模型;
- 打开 Copilot Chat;
- 将图片拖入聊天框;
- 输入需要分析的问题。
例如:
请分析这张深度学习模型结构图,检查编码器、解码器、跳跃连接和张量尺寸是否合理。需要注意,图片代理过程中可能会损失部分细节。科研模型图中的小字号、复杂箭头、公式和密集模块可能被视觉模型遗漏。
十一、如何限制 API 消耗?
插件默认的最大输出 Token 设置为:
0这里的0表示不额外设置插件侧的输出上限,并不代表不消耗 Token。
如果担心 Agent 模式消耗过多,可以在 VS Code 设置中搜索:
deepseek-copilot.maxTokens例如将其设置为:
16000这样可以限制单次回答的最大输出长度。
还可以通过以下方式减少费用:
- 日常任务优先使用 V4 Flash;
- 简单问题使用
none或low; - 复杂任务再使用
high或max; - 不要一次性要求读取整个大型项目;
- 新任务尽量新建对话;
- 执行修改前先让模型给出方案。
对于初学者,推荐使用这样的提示词:
请先分析问题并说明修改方案,暂时不要修改文件,等我确认后再操作。这样可以避免模型直接大范围修改代码。
十二、常见问题
1. 找不到“DeepSeek: Set API Key”
可能原因:
- 插件没有安装成功;
- 插件被禁用;
- VS Code 版本低于 1.116;
- 安装后没有重新加载窗口。
可以尝试:
Developer: Reload Window如果仍然没有出现,检查扩展页面中的插件状态是否为“已启用”。
2. Copilot Chat 中没有 DeepSeek 模型
检查以下内容:
- 是否安装并启用了 GitHub Copilot Chat;
- GitHub账户是否已登录;
- 是否拥有可用的 Copilot 计划;
- 是否已经成功保存 DeepSeek API Key;
- 插件和 VS Code 是否为最新版本。
3. 出现 401 错误
401 Unauthorized通常表示 API Key 不正确。
检查:
- API Key 是否复制完整;
- 前后是否存在空格;
- API Key 是否已经被删除;
- 是否使用了 DeepSeek 网页登录密码代替 API Key。
4. 提示余额不足
DeepSeek API 单独计费。即使 DeepSeek 网页版可以正常使用,也可能出现 API 余额不足。
需要进入 DeepSeek API 平台检查余额和使用记录。
5. 出现 429 错误
429通常表示请求过于频繁或者触发了速率限制。
可以等待一段时间后重试,也可以减少同时进行的 Agent 任务。
6. 更新 VS Code 后插件突然失效
根据插件说明,它使用了部分非公开的 Copilot Chat 接口,因此 VS Code 或 Copilot Chat 大版本更新后,可能出现暂时的兼容问题。
遇到这种情况可以:
- 更新插件;
- 重新加载 VS Code;
- 查看插件的更新日志;
- 前往插件 GitHub 仓库查看 Issue。
插件项目地址:
Vizards/deepseek-v4-for-copilot
十三、插件接入和普通 DeepSeek 插件有什么区别?
VS Code 扩展商店中还有一些名称为“DeepSeek”或“DeepSeek R1”的插件,但它们不一定接入 GitHub Copilot Chat。
两类插件的区别如下:
| 插件类型 | 使用界面 | Copilot Agent | Copilot 工具 |
| 普通 DeepSeek聊天插件 | 单独的侧边栏 | 通常不支持 | 通常不支持 |
| DeepSeek V4 for Copilot Chat | 原生 Copilot Chat | 支持 | 支持 |
本文介绍的插件最大特点是:
它不是在 VS Code 中另外创建一个 DeepSeek聊天窗口,而是直接把 DeepSeek V4 添加到 Copilot Chat 的模型选择器中。
因此,我们可以继续使用 Copilot 原有的 Agent、工具调用、项目指令和工作区上下文能力。
十四、总结
使用DeepSeek V4 for Copilot Chat接入 DeepSeek非常简单,整个流程可以概括为:
安装 Vizards 发布的插件 → 申请 DeepSeek API Key → 运行 DeepSeek: Set API Key → 打开 Copilot Chat → 选择 DeepSeek V4 Flash 或 V4 Pro日常编程推荐:
DeepSeek V4 Flash + high复杂项目分析和 Agent 任务推荐:
DeepSeek V4 Pro + max这款插件省去了手动配置 API 地址、模型参数和 JSON 文件的过程,很适合希望在 Copilot 原生界面中使用 DeepSeek 的用户。
不过,无论使用哪种 AI 编程模型,都不能完全相信自动生成的代码。在真正运行、提交或部署之前,仍然需要检查代码逻辑、文件修改范围和安全性。
参考资料:
- DeepSeek V4 for Copilot Chat 插件页面
- 插件开源仓库
- DeepSeek API Key 管理页面