1. 项目背景与核心痛点：当免费午餐不再

最近圈子里的朋友都在聊一个事儿：用得好好的 Max 20 账号，说没就没了。我自己也未能幸免，两个精心维护的账号接连被封，那种感觉就像你刚装修好的房子，还没住热乎，房东就通知你明天搬走。Max 20 的免费额度确实香，对于日常的代码补全、文档生成、简单问答，它几乎是我在 VSCode 里的“第二大脑”。但免费往往意味着不稳定，账号风控的收紧让这种依赖变得岌岌可危。

被封之后，我面临一个很现实的问题：工作流不能断。我的日常重度依赖 AI 辅助编程，从写函数注释、重构代码块，到解释复杂逻辑、生成测试用例，没有它效率直接腰斩。重新注册账号？且不说手机号验证的麻烦，谁又能保证下一个账号能活多久？付费订阅？对于我这种偶尔需要“大力出奇迹”但更多是轻量使用的场景，性价比并不高。

于是，寻找一个稳定、可控、且成本合理的替代方案，就成了当务之急。我的核心诉求很明确：第一，必须能无缝集成到 VSCode 这个主战场；第二，模型能力要足够强，至少不能比 Max 20 差太多；第三，成本可控，最好是按需付费，用多少算多少；第四，也是最重要的一点，整个流程要足够“丝滑”，不能为了用个 AI 而把开发环境搞得复杂无比。

经过一番调研和折腾，我把目光锁定在了 Claude Code 和 DeepSeek 这个组合上。Claude Code 是一个开源的 VSCode 扩展，它本身不提供模型，而是作为一个“桥梁”，允许你接入各种后端 AI 服务。而 DeepSeek 则是近期表现非常亮眼的一个开源模型系列，尤其是 DeepSeek-V4 Flash，在代码和推理能力上口碑不错，并且提供了公开、透明的 API 服务。这个组合听起来完美：用 Claude Code 保住我熟悉的 VSCode 操作界面和交互习惯，用 DeepSeek 的 API 作为稳定、付费可控的“大脑”。实际搭建下来，除了一个关键短板——Claude Code 默认不支持多模态识图——其他方面确实称得上“一切丝滑”。别急，这个短板我们后面有绝招搞定。

2. 方案选型与工具解析：为什么是 Claude Code + DeepSeek？

面对琳琅满目的 AI 工具和模型，选择 Claude Code 搭配 DeepSeek API，并非一时冲动，而是基于几个维度的深度考量。我们来拆解一下这个组合背后的逻辑。

2.1 为什么选择 Claude Code 作为前端？

首先，Claude Code 是一个完全开源、免费的 VSCode 扩展。这意味着几点核心优势：

  1. 无厂商锁定风险 ：它不像某些商业扩展，一旦服务商调整策略或收费，你就束手无策。开源赋予了它极高的自主权。
  2. 高度可定制 ：它的配置完全开放，你可以指定任意的 API 端点、模型名称、调整各种参数，以适应不同的后端服务。
  3. 轻量且专注 ：它的功能聚焦于代码补全、聊天和编辑，没有花里胡哨的附加功能，这反而让它运行更稳定，与 VSCode 的集成更深入。
  4. 熟悉的交互 ：如果你用过其他 AI 编程助手，切换到 Claude Code 几乎零成本。快捷键、右键菜单、内联聊天框，这些交互模式都被很好地保留了下来。

注意 ：市面上叫“Claude Code”的扩展可能不止一个，请认准 GitHub 上由 claude-code 组织维护的版本。安装时务必从 VSCode 扩展市场搜索并确认发布者，避免安装到仿冒或带有恶意代码的版本。

2.2 为什么选择 DeepSeek 作为后端模型？

后端模型的选择更多是基于能力、成本和稳定性的权衡。

  1. 能力过硬 ：DeepSeek-V4 Flash 在多项基准测试中，特别是在代码和数学推理上，表现已经接近甚至超越了一些闭源的顶级模型。对于编程辅助这个核心场景，它的代码生成质量、逻辑理解能力和上下文长度（128K）完全够用，甚至绰绰有余。
  2. API 透明且稳定 ：DeepSeek 官方提供了清晰的 API 文档和定价。相比某些服务商模糊的计费策略或频繁的接口变动，这种透明性让人安心。按 token 用量计费，用多少付多少，非常适合我这种波动较大的使用模式。
  3. 成本可控 ：以 DeepSeek-V4 Flash 为例，其输入 token 价格极具竞争力。对于日常的代码补全和问答，一个月的开销可能远低于一杯咖啡。这种“用即付费”的模式，避免了订阅制下“不用就亏”的心理负担。
  4. 规避政策风险 ：使用官方 API，意味着你是在合规地使用服务，无需担心因使用非正规渠道的“共享账号”或“破解服务”而导致的数据安全或法律风险。

2.3 组合优势与潜在挑战

将两者结合，就构建了一个 “开源前端 + 商用后端” 的混合架构。前端可控，后端专业。你获得了商业级模型的能力，同时又保留了对客户端工具的所有控制权。如果未来 DeepSeek 的 API 涨价或不合适了，你可以非常方便地将 Claude Code 的后端切换到另一个提供兼容接口的模型服务上，比如 OpenAI、Anthropic（如果能接入的话）或者其他开源模型的部署端点。

当然，这个组合并非完美。最大的挑战，也就是标题里提到的，是 “不识图” 。Claude Code 默认的配置和交互界面，并不支持上传图片或处理多模态输入。这对于需要分析图表、截图报错信息、或者基于 UI 设计稿生成代码的场景来说，是个硬伤。不过，好消息是，这个问题有解，而且解法相当巧妙，我们会在第五部分详细拆解。

3. 环境准备与基础配置：从零开始的丝滑搭建

理论说再多，不如动手做一遍。这部分我会带你完成从安装到基础对话的全流程，确保每一步你都能跟上。整个过程就像搭乐高，步骤清晰，照着做就行。

3.1 第一步：安装 Claude Code 扩展

打开你的 VSCode，按下 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac) 打开命令面板，输入 Extensions: Install Extensions 。 在扩展市场的搜索框中，输入 Claude Code 。你应该能看到一个由 claude-code 发布的扩展。点击“安装”按钮。 安装完成后，你会在 VSCode 侧边栏看到一个狐狸头像的图标，这就代表 Claude Code 已经就绪了。但先别急，现在点开它还没法用，因为我们还没有给它配置“大脑”（API）。

3.2 第二步：获取 DeepSeek API Key

DeepSeek 的 API 服务需要认证，所以我们需要一个密钥。

  1. 访问 DeepSeek 的官方平台。你需要注册一个账号。
  2. 登录后，通常在个人中心或开发者设置页面，你可以找到“创建 API Key”或类似选项。
  3. 创建一个新的 Key。创建时，系统可能会让你为这个 Key 命名，比如 VSCode-ClaudeCode ，方便你后续管理。
  4. 关键一步 ：创建成功后，页面会显示你的 API Key。 请立即复制并妥善保存 ，因为它通常只显示一次，关闭页面后就无法再次查看完整 Key 了。建议将其保存在本地的密码管理器或一个安全的临时文档中。

重要安全提示 ：API Key 相当于你的支付密码，任何人获得它都可以用你的账户额度发起请求。切勿将 Key 提交到公开的代码仓库（如 GitHub）、或在前端代码中硬编码。我们接下来会将其安全地配置在本地。

3.3 第三步：配置 Claude Code 连接 DeepSeek

这是核心步骤，告诉 Claude Code 去哪里、用什么身份调用 AI 服务。

  1. 在 VSCode 中，再次按下 Ctrl+Shift+P ，输入 Preferences: Open User Settings (JSON) 并回车。这会打开你的用户设置 JSON 文件。
  2. 我们需要在这个 JSON 文件中添加 Claude Code 的配置。找到文件的末尾（确保 JSON 格式正确，最后一个配置项后如果没有逗号，需要先加一个逗号），添加如下配置块：
"claude-code.apiKey": "你的-DeepSeek-API-Key",
"claude-code.apiHost": "https://api.deepseek.com",
"claude-code.model": "deepseek-chat",
"claude-code.enabled": true

配置参数详解：

  • claude-code.apiKey ：将 你的-DeepSeek-API-Key 替换为你刚才复制的真实 Key。注意，Key 通常以 sk- 开头。
  • claude-code.apiHost ：这是 DeepSeek API 的服务地址。务必确认是 https://api.deepseek.com ，这是官方通用端点。
  • claude-code.model ：这里填写模型名称。根据 DeepSeek 的文档，对话模型通常使用 deepseek-chat 。对于代码补全等任务，它也能很好胜任。如果你想使用最新的 deepseek-v4-flash ，可以尝试将此项改为 deepseek-v4-flash ，但请以 API 文档支持列表为准。
  • claude-code.enabled ：设置为 true 以启用扩展。
  1. 保存这个 settings.json 文件。VSCode 会自动加载新配置。

3.4 第四步：验证与首次对话

配置保存后，点击侧边栏的 Claude Code 狐狸图标，或者按 Ctrl+Shift+P 输入 Claude Code: Open Chat 打开聊天面板。 如果一切配置正确，你应该能看到聊天界面正常加载。在底部的输入框里，尝试输入一个简单的问题，比如：“用 Python 写一个快速排序函数。” 按下回车发送请求。你会看到界面显示“思考中...”或类似的提示。稍等片刻，如果 DeepSeek 模型成功响应，你就会看到生成的代码和解释。

恭喜！至此，最基础的文本对话功能已经配置成功。 你现在拥有了一个由 DeepSeek 驱动的、运行在你自己 VSCode 里的 AI 编程助手。它的响应速度、代码质量，你应该能立刻感受到与之前免费服务的差异。

4. 高级配置与性能调优：让助手更懂你

基础配置只能保证“能用”，但要想“好用”，还得进行一些精细化调整。Claude Code 提供了丰富的设置项，我们可以根据 DeepSeek API 的特性和个人习惯来优化。

4.1 模型参数调优：控制生成质量

除了基本的模型名称，我们还可以通过配置调整生成文本的“性格”和质量。在 settings.json 中，我们可以添加更多参数：

"claude-code.requestParams": {
    "temperature": 0.2,
    "max_tokens": 2048,
    "stream": true
}
  • temperature (温度) ：这个值控制生成的随机性。范围通常在 0 到 2 之间。值越低（如 0.1-0.3），输出越确定、保守，适合需要精准代码、事实回答的场景。值越高，输出越有创意、越多样，但也可能更不稳定。 对于编程辅助，我强烈建议设置在 0.1 到 0.3 之间 ，这能确保生成的代码结构稳定，减少“胡言乱语”。
  • max_tokens (最大生成长度) ：限制模型单次响应最多生成多少 token。DeepSeek 模型上下文很长，但为了避免生成过于冗长的无关内容（消耗你的 token），可以设置一个上限。2048 或 4096 对于大多数代码片段和解释已经足够。
  • stream (流式传输) ：设置为 true 可以启用流式响应。你会在聊天界面中看到答案一个字一个字地“打”出来，体验更流畅，对于长回答也能更快看到开头部分。

4.2 上下文与记忆管理

Claude Code 默认会保留当前聊天会话的历史记录作为上下文。这对于多轮对话理解你的意图至关重要。但需要注意：

  • 上下文长度限制 ：虽然 DeepSeek 支持长上下文，但 Claude Code 扩展或 API 调用本身可能有长度限制。过长的历史记录可能导致最开始的对话被“遗忘”。
  • 手动清空 ：如果对话变得混乱或你想开始一个全新话题，可以在聊天界面找到清空上下文的选项（通常是一个垃圾桶图标或 /clear 命令）。
  • 项目级上下文 ：一些高级用法中，Claude Code 可以读取当前打开的文件或项目结构来增强理解。确保相关设置已开启，让 AI 更能“理解”你正在工作的代码库。

4.3 网络与代理配置（如需要）

如果你的网络环境访问 api.deepseek.com 不稳定或无法直连，你可能需要配置代理。Claude Code 扩展本身通常遵循系统的网络设置。你可以在 settings.json 中尝试添加系统代理配置，但更通用的做法是：

  1. 确保你的操作系统或网络工具已正确配置代理。
  2. 在 VSCode 的设置中（非 JSON 模式），搜索 Proxy ，填写代理服务器地址。这会影响 VSCode 及其扩展的所有网络请求。

实操心得 ：在配置完成后，如果遇到 API Error: 400 或连接失败，首先检查 apiHost 和 model 名称是否拼写完全正确。DeepSeek 的模型名可能更新，最稳妥的方式是查阅其最新的官方 API 文档。其次，检查 API Key 是否有余额或是否已启用。最后，考虑网络问题，尝试在浏览器中直接访问 https://api.deepseek.com 看是否能通。

5. 攻克核心短板：让 Claude Code + DeepSeek “识图”的终极方案

前面提到，Claude Code 默认不支持图片上传，这是它结合 DeepSeek 使用时的最大短板。DeepSeek 模型本身是支持多模态输入的，但我们需要一个方法把图片“喂”给它。这里分享我亲测有效的一招，无需修改扩展源码，利用“中间人”思路轻松搞定。

5.1 核心思路：将图片转换为文本描述

既然 Claude Code 的输入框只接受文本，而 DeepSeek 能理解图片，那么矛盾点就在于“如何把图片变成 Claude Code 能发送的文本”。解决方案是： 先用一个免费的、能识图的 AI 模型，把图片内容描述出来，再将这段描述文本粘贴给 Claude Code + DeepSeek 。

听起来有点绕？其实操作起来非常简单。我们不需要另一个复杂的软件，利用好现有的免费工具就行。

5.2 方案选择与实操步骤

我推荐两个高成功率且免费的工具链：

方案一：使用 ChatGPT（网页版或App）的“识图”功能

  1. 准备图片 ：将你需要分析的截图、图表、错误日志图片等保存到本地，或者直接复制到剪贴板。
  2. 上传并获取描述 ：打开 ChatGPT（免费版即可），在输入框旁找到上传文件的按钮（通常是个回形针或图片图标），上传你的图片。然后，在输入框中输入提示词：“请详细描述这张图片中的全部文字、代码、图表数据、UI元素和布局。描述要尽可能详细和准确，以便我能根据你的描述来复现或解决问题。”
  3. 复制文本结果 ：ChatGPT 会生成一段非常详细的文字描述。全选并复制这段文本。
  4. 粘贴到 Claude Code ：回到 VSCode，打开 Claude Code 聊天框，将复制好的图片描述文本粘贴进去。然后，你可以在后面追加你的具体问题，例如：“根据上面的描述，这个报错信息是什么意思？我应该如何修复？” 或者 “根据描述的 UI 布局，用 React 和 Tailwind CSS 写出大致的代码结构。”

方案二：使用 Google Gemini（网页版）

  1. 访问 Gemini 官网。
  2. 同样的操作，上传图片，并给出类似的提示词要求其生成详细描述。
  3. 复制描述文本，粘贴到 Claude Code 中进行后续提问。

这个方法的精髓在于， 第一个 AI（如 ChatGPT）充当了“眼睛”和“翻译官” ，它将视觉信息转化为精准的文本描述。 第二个 AI（DeepSeek via Claude Code）则充当了“大脑” ，基于这份高质量的文本描述，运用其强大的代码和推理能力来解决问题。两者分工合作，完美弥补了 Claude Code 前端的不足。

5.3 进阶技巧与自动化可能

如果你觉得每次手动操作两个工具太麻烦，可以考虑一些半自动化的方法：

  • 使用快捷指令（Mac）或 Power Automate（Windows） ：可以创建一个小流程，将截图动作与调用 ChatGPT API 描述图片、再将结果发送到指定文本编辑器或剪贴板串联起来。但这需要一定的脚本编写能力。
  • 本地多模态模型 ：如果你有较强的显卡，可以在本地部署一个轻量级的开源多模态模型（如 LLaVA），并编写一个简单的脚本，自动将剪贴板中的图片发送给本地模型获取描述，再填充到 Claude Code。这属于高阶玩法。

对于绝大多数用户，我建议先从 “手动上传 ChatGPT -> 复制描述 -> 粘贴提问” 这个流程开始。它虽然多了一两步，但稳定、免费、且效果极佳。实测中，只要图片描述得足够详细，DeepSeek 基于此给出的代码建议或问题分析，准确率非常高。

避坑指南 ：在使用“图片转描述”时，给第一个 AI 的提示词至关重要。不要只说“描述这张图”，要明确要求它关注“所有文字”、“代码片段”、“错误代码”、“数字”、“按钮文字”、“布局位置”等关键细节。一份模糊的描述会导致 DeepSeek 的推理基础不牢，输出质量大打折扣。

6. 实战场景与效率提升：不止于代码补全

配置好了，短板也补上了，这个组合到底能在日常开发中做什么？它的能力远超简单的行内代码补全。下面我结合几个高频场景，展示如何用它大幅提升效率。

6.1 场景一：复杂代码重构与解释

当你接手一段晦涩难懂的遗留代码时，可以直接将其复制到 Claude Code 聊天框中，并提问： “请解释以下代码的功能。如果可能，指出其中可以优化的部分，并提供重构后的代码示例。” DeepSeek 会逐段分析代码逻辑，解释每个模块的作用，并经常能指出潜在的性能瓶颈、冗余逻辑或更现代的语言特性写法。它不仅能给出优化后的代码，还会附上修改理由，这是一个非常好的学习过程。

6.2 场景二：基于错误信息的精准调试

这是“识图”方案大显身手的场景。当你在命令行、浏览器控制台或 IDE 中遇到一段冗长的红色报错信息时：

  1. 直接截图。
  2. 按第五部分的方法，用 ChatGPT 等工具将截图转为详细文本描述。
  3. 将描述粘贴到 Claude Code，提问：“我遇到了这个错误，可能的原因是什么？请提供具体的排查步骤和修复建议。” DeepSeek 能够精准定位错误类型（如特定的库版本冲突、未定义的变量、语法错误），并给出一步步的排查指令，甚至直接给出修复代码。这比在搜索引擎里大海捞针要高效得多。

6.3 场景三：从需求描述到代码草稿

产品经理给了一段模糊的需求描述，或者你自己在笔记中写了一个功能点子。你可以把这个自然语言描述扔给 Claude Code。 例如：“我需要一个 Python 函数，它接收一个包含字典的列表，根据字典中某个字段的值进行排序，同时过滤掉另一个字段为空的项，最后将结果以 JSON 格式保存到文件。” DeepSeek 不仅能生成功能完整的函数代码，还会考虑到异常处理、文件操作的安全性，并附上清晰的使用示例。这极大地加速了从想法到原型的过程。

6.4 场景四：文档生成与知识问答

对着一个复杂的第三方库 API 发愁？选中你导入的库名或函数名，右键选择 Claude Code 的上下文菜单（如果有集成），或直接输入：“解释一下 axios.interceptors 是如何工作的，并给我两个常用的请求和响应拦截器示例。” 它会生成结构清晰、带有示例代码的迷你文档。同样，你也可以让它为你刚写完的函数生成详细的 JSDoc 或 Python docstring 注释。

效率提升的关键 在于，你要学会向 AI 提出“好问题”。问题越具体、上下文越清晰，得到的答案就越精准。不要问“怎么写代码？”，要问“用 React Hooks 如何实现一个在窗口滚动时淡入的组件？”。

7. 常见问题与故障排查实录

在实际使用中，你难免会遇到一些问题。下面是我和朋友们踩过的一些坑以及解决方案，希望能帮你快速排雷。

7.1 API 连接与认证错误

错误现象 可能原因 排查与解决步骤
API Error: 401 Unauthorized API Key 错误、过期或未启用。 1. 检查 settings.json 中的 claude-code.apiKey 是否完整、正确复制，注意开头结尾不要有空格。
2. 登录 DeepSeek 平台，确认该 API Key 状态为“启用”。
3. 确认你的账户有足够的余额或该 Key 有调用权限。
API Error: 400 ‘type‘ must be in [“enabled“, “disabled“, “auto“] 请求参数格式错误，或传递了不被支持的参数。 1. 检查 claude-code.requestParams 或其他自定义参数，确保其值符合 DeepSeek API 文档的要求。
2. 最直接的解决方法是，暂时删除或注释掉 claude-code.requestParams 配置，使用默认参数测试。 确认连通后，再逐一添加参数测试。
Unable to connect to API (ECONNRESET) 或长时间无响应 网络连接问题，或 API 服务端暂时故障。 1. 检查本地网络，尝试访问 https://api.deepseek.com 看是否通畅。
2. 如果使用了代理，检查代理规则是否正确，尝试关闭代理直连测试。
3. 等待几分钟后重试，可能是服务端临时波动。
API Error: 400 This model‘s maximum context length is ... 发送的请求（历史对话+当前问题）总 token 数超过了模型限制。 1. 在 Claude Code 聊天界面清空当前对话历史（使用 /clear 或清空按钮）。
2. 将复杂问题拆分成多个小问题依次提问。
3. 在 requestParams 中适当调低 max_tokens ，但主要需控制输入长度。

7.2 扩展功能异常

错误现象 可能原因 排查与解决步骤
侧边栏 Claude Code 图标不显示或点击无反应 扩展安装不完整或与其他扩展冲突。 1. 在 VSCode 扩展面板中，找到 Claude Code，尝试禁用再重新启用。
2. 重启 VSCode。
3. 卸载后重新从市场安装。
代码补全（Inline Suggest）不工作 相关功能未启用，或触发方式不对。 1. 在 settings.json 中确认 “claude-code.enabled“: true 。
2. 检查 VSCode 设置中关于内联建议的配置是否被关闭。
3. 在代码编辑器中，尝试输入一段注释或函数名开头，然后按 Ctrl+I (Windows/Linux) 或 Cmd+I (Mac) 手动触发建议。
右键菜单中没有 Claude Code 选项 扩展的上下文菜单集成未生效。 1. 同样尝试重启 VSCode 或重装扩展。
2. 某些文件类型或视图可能不支持该菜单。

7.3 模型响应质量问题

错误现象 可能原因 排查与解决步骤
回答偏离主题或“胡言乱语” temperature 参数设置过高，或上下文历史混乱。 1. 将 temperature 调低至 0.2 或 0.3。
2. 开启新对话，确保上下文干净。
3. 在问题中提供更明确的指令，如“请只输出代码，不要解释”。
生成的代码有语法错误或逻辑问题 模型本身存在局限性，或问题描述不够清晰。 1. 永远要审查 AI 生成的代码 ，不要直接复制粘贴到生产环境。
2. 将错误信息反馈给 AI，让它自我修正。例如：“你刚才生成的代码在第 X 行有语法错误，请检查并修正。”
3. 更详细地描述边界条件和约束。
响应速度慢 网络延迟，或请求的 token 数过多（生成长文本）。 1. 检查网络状况。
2. 在 requestParams 中设置合理的 max_tokens ，避免生成过于冗长的回答。
3. 对于代码生成，可以要求它“分步骤给出代码”，先给框架再填充细节。

最后的心得 ：遇到问题，首先看错误信息。Claude Code 和 DeepSeek API 的错误提示通常比较明确。按照错误信息去核对配置、查阅官方文档，90%的问题都能自行解决。保持耐心，把配置过程当作一次学习，你会对这个工具链有更深的掌控感。

Logo
亚马逊云科技技术品牌专区

更多推荐

cover

原来AI、画图、导航都在用向量！

avatar 亚马逊云科技技术品牌专区
cover

害虫检测和识别3：基于深度学习YOLO26神经网络实现害虫检测和识别(含训练代码、数据集和GUI交互界面）

avatar 亚马逊云科技技术品牌专区
cover

大 硬 仗14小时：用2009年的上古亮机卡跑完深度学习，CPU满载但代码没崩

avatar 亚马逊云科技技术品牌专区