VSCode官方AI功能接入DeepSeek教程

背景

VSCode（Visual Studio Code）是微软推出的一款开源、轻量级的代码编辑器，凭借丰富的扩展生态和强大的内置功能，已成为开发者中最主流的 IDE 之一。近年来，各大厂商纷纷在编辑器中集成 AI 辅助编程能力，例如 GitHub Copilot、Cursor 等。VSCode 官方也在最新版本中加入了原生 AI 聊天功能，允许用户通过 "Bring Your Own Key"（BYOK）模式接入第三方模型服务。DeepSeek 作为国内优质的大语言模型提供商，提供了高性价比的 API 接口。本文档来自 LINUX DO 论坛的一篇帖子，旨在向所有用户（尤其是小白）提供一份将 VSCode 官方 AI 功能与 DeepSeek 模型对接的详细教程，降低 AI 编程工具的使用门槛。

核心内容

原文是一份面向小白的教程，主要分为六个步骤，引导用户在 VSCode 中启用官方 AI 聊天功能并配置 DeepSeek 模型。

1. 更新 VSCode 到最新版本
   用户需要确保使用的 VSCode 版本支持原生 AI 聊天界面。通常右上角会有更新按钮，或直接前往官网下载最新版（Download Visual Studio Code - Free AI Code Editor for Mac, Linux, Windows）。

2. 打开 AI 聊天界面
   点击 VSCode 右上角的 AI 聊天图标（通常是一个对话气泡），即可进入聊天面板。

3. 管理模型与配置 API
   在 AI 聊天面板中，点击“管理模型”或类似按钮，进入配置界面。选择 "Custom Endpoint"（自定义端点），然后填写以下信息：

   • 名称：任意输入，用于标识配置。
   • Key：填入真实的 API Key。DeepSeek 的 API Key 可以在 DeepSeek 开放平台官网申请。注意：切勿将 Key 发送给任何人，也不要明文保存在本地文档中。
   • 类型：一般 DeepSeek 官方建议选择 "messages" 类型；如果是通过中转站（第三方代理服务）接入，则可按需要选择 "chat" 等类型，该选项后续可以修改。

4. 具体填写内容
   在模型配置的 JSON 字段中，按照以下格式填写（可直接粘贴）：

   "models": [
       {
           "id": "deepseek-v4-pro",
           "name": "Deepseek V4 Pro",
           "url": "https://api.deepseek.com/anthropic",
           "toolCalling": true,
           "vision": false,
           "maxInputTokens": 500000,
           "maxOutputTokens": 128000
       }
   ]
   

   字段解释：

   • id：模型标识符（如 deepseek-v4-pro），也可以是 flash、gpt、opus 等，取决于接入的模型或中转站支持。
   • name：显示名称，可任意填写。
   • url：API 端点 URL。DeepSeek 官方路径为 https://api.deepseek.com/anthropic（需配合 apiType 为 messages 使用）。不同中转站路径不同。
   • vision：是否支持视觉（图像识别）。当前 DeepSeek V4 不支持，设为 false；若使用 GPT-5.5、Opus 等支持视觉的模型，可设为 true。
   • maxInputTokens：最大上下文长度。DeepSeek 官方支持 100 万 tokens，但教程建议设为 50 万，因为过大可能导致性能下降。
   • maxOutputTokens：最大输出长度。
   • toolCalling：是否支持工具调用（Function Calling）。DeepSeek 支持，设为 true。

5. 使用模型
   完成配置后即可在聊天界面中使用模型。第一次使用时可能会卡顿片刻，之后便可正常进行 AI 辅助编程。

6. （可选）优化显示
   用户可以将配置的模型“固定”到聊天界面，同时隐藏 VSCode 自带的模型分组，以便更清晰地使用自己配置的模型。

补充说明：

• 如果使用中转站（第三方 API 代理），步骤 3 中的“类型”选择和步骤 4 中的 URL 需要对应调整。
• VSCode 的 BYOK 模式默认没有内置网络搜索技能（如联网检索），如需此功能可能需要额外安装扩展。
• 更高级用法（如安装 Skills 等）可参考其他文章或直接让 AI 辅助完成。

关键要点

• 教程面向所有用户，尤其适合对 IDE 不熟悉的新手，强调 VSCode 比 Claude Code 等命令行工具更易上手。
• 必须使用最新版 VSCode 才能获得原生 AI 聊天功能。
• 配置核心是“Custom Endpoint”方式，需提供 API Key（注意保密）和正确的端点 URL。
• 模型配置 JSON 中的字段（id、url、vision、maxInputTokens 等）需根据实际模型和中转站情况填写，官方 DeepSeek 建议使用 https://api.deepseek.com/anthropic。
• 上下文长度建议设为 50 万 tokens（官方支持 100 万），以平衡性能与容量。
• 首次使用可能偶有卡顿，属于正常现象。
• 可选操作：固定自定义模型并隐藏默认分组，提升使用体验。
• 若使用第三方中转站，配置方式需相应调整。
• BYOK 模式缺少网络搜索技能，需要额外安装扩展才能联网查询。

意义与影响

这份教程降低了大型语言模型接入主流代码编辑器的技术门槛。过去，开发者若要使用类似 Copilot 的 AI 辅助功能，往往需要订阅付费服务或配置复杂的代理。VSCode 官方开放 BYOK 模式后，用户能够灵活选择廉价甚至免费的模型（如 DeepSeek），同时保留 VSCode 熟悉的编辑体验。对于 DeepSeek 等国产模型厂商而言，这拓宽了其在实际开发场景中的应用渠道。此外，教程中强调的安全注意事项（如保护 API Key）和性能调优建议（如限制上下文长度）也有利于用户安全、高效地使用 AI 工具。整体上，该教程推动了 AI 编程辅助的普及化，让更多个体开发者能以较低成本享受 AI 带来的效率提升。