VS Code 集成 claude-code 教程：告别海外限制，无缝对接国内大模型

引言

claude-code 是一款强大的终端智能开发工具，能在 VS Code 中为我们提供实时的代码辅助、问题解答和逻辑优化能力。但官方默认对接 Anthropic 的 Claude 模型，存在网络访问、账号注册、付费等诸多门槛。本文将手把手教你完成 claude-code 的安装、VS Code 插件配置，并重点讲解如何通过 cc-switch 对接国内 DeepSeek 大模型，享受更便宜、更快速的本地化智能开发体验。

一、前置准备

在开始操作前，请确保你的环境满足以下条件：

1. 已安装 Node.js（建议 v16+），可通过 node -v 命令验证；
2. 已安装 VS Code（任意最新版本均可）；
3. 网络可正常访问 npm 仓库（若访问慢可切换淘宝镜像：npm config set registry https://registry.npm.taobao.org）。

二、第一步：全局安装 claude-code

claude-code 是核心工具，需先通过 npm 全局安装：

1. 打开终端（Windows 用 cmd/PowerShell，Mac/Linux 用 Terminal）；

2. 执行安装命令：

   npm i @anthropic-ai/claude-code -g

3. 验证安装：执行 claude，若输出如下即安装成功

三、第二步：安装 VS Code 插件

为了在 VS Code 中便捷使用 claude-code，需安装对应的插件：

1. 打开 VS Code，点击左侧「扩展」图标（快捷键 Ctrl+Shift+X）；
2. 在搜索框输入 `Claude Code for VS Code；
3. 找到插件后点击「安装」，安装完成后会显示「已安装」状态；
4. 可选：重启 VS Code 确保插件生效。

安装成功后 点击文档 右侧会出现 对应标志

四、第三步：解决核心痛点 ------ 对接国内大模型（DeepSeek）

官方默认的 Anthropic Claude 模型存在诸多限制，我们通过 cc-switch 工具替换为国内 DeepSeek 模型，步骤如下：

4.1 安装 cc-switch 工具

1. 访问 cc-switch 官方发布页：github.com/farion1231/...；
2. 根据你的系统（Windows/Mac/Linux）下载对应的安装包（如 Windows 下载 .exe，Mac 下载 .dmg）；
3. 双击安装包完成安装，过程中按提示确认即可。

4.2 注册 DeepSeek API 密钥

1. 访问 DeepSeek 官网：platform.deepseek.com/；
2. 点击「注册 / 登录」，完成账号注册（支持手机号 / 邮箱）；
3. 登录后进入「API 密钥」页面，点击「创建密钥」，复制生成的密钥（务必保存好，不要泄露）。

4.3 配置 cc-switch 对接 DeepSeek

1. 打开终端，执行 cc-switch 命令启动配置工具；
2. 按照提示选择「切换模型为 DeepSeek」；
3. 输入你复制的 DeepSeek API 密钥，确认后保存配置；
4. 验证配置：执行 cc-switch test，若提示「连接成功」则说明配置生效。

五、在 VS Code 中使用 claude-code

配置完成后，即可在 VS Code 中体验 claude-code 的功能：

点击打开 claude对话

注意此处可以点击切换模式 ，优先使用 plan模式，

输入斜杠 / 回调出快捷键 注意使用

总结

通过以上步骤，你已完成 claude-code 在 VS Code 中的安装、配置，并成功对接国内 DeepSeek 模型，摆脱了海外服务的限制。claude-code 结合国内大模型，既能享受智能代码辅助的便利，又能获得更快的响应速度和更低的使用成本，是提升开发效率的优质工具。