在 VS Code 里使用 AI 编程助手的小白教程
适合人群：想在 VS Code 中使用 Claude Code，并通过 CC Switch 接入 DeepSeek 大模型的新手用户。本文以 macOS 截图为主，Windows 用户在对应步骤选择 Windows 安装包即可。
发布前重要提醒：截图中所有 API Key 必须打码。API Key 相当于账户密码，公开后可能被他人调用并消耗余额。
本文最终可以实现什么？
完成本文配置后，你可以在 VS Code 里打开项目，通过 Claude Code 读取项目文件、分析代码结构、排查报错、生成代码、修改页面，并让 Claude Code 通过 CC Switch 调用 DeepSeek 模型。
简单理解这套组合：
- Claude Code：负责在终端或 VS Code 中执行 AI 编程任务。
- DeepSeek：负责提供大模型能力。
- CC Switch：负责管理模型供应商、API Key 和模型切换。
- VS Code：负责作为日常写代码和打开项目的编辑器。
目录
一、前置环境安装配置
正式安装 Claude Code 之前，需要先准备好 Node.js、npm 和 Git。Mac 用户通常只需要安装 Node.js；Windows 用户还需要额外安装 Git for Windows。
1. 安装 Node.js
打开 Node.js 官网，选择适合自己电脑系统的版本进行安装。Mac 用户选择 macOS 版本，Windows 用户选择 Windows 版本。
安装完成后，打开终端，分别输入下面两个命令检查是否安装成功：
node -v
npm -v如果终端返回版本号，例如 v24.x.x 和 11.x.x，就说明 Node.js 和 npm 已经安装成功。
# 示例输出
$ node -v
v24.5.0
$ npm -v
11.2.12. Windows 用户额外安装 Git
Windows 用户需要额外安装 Git for Windows。进入 Git 官网后，根据电脑架构选择对应安装包，一般常见电脑选择 Windows x64 Setup。
下载完成后正常安装即可。如果不确定选哪个版本，优先选择 Git for Windows/x64 Setup。
安装完成后验证：
git --version
# 示例输出: git version 2.48.03. 安装 Claude Code
当前置环境准备好后，打开终端，输入下面这行命令安装 Claude Code：
npm install -g @anthropic-ai/claude-code安装完成后，继续输入：
claude --version如果返回版本号，就代表 Claude Code 安装成功。
# 示例输出
$ claude --version
1.0.0注意命令是 claude --version，中间没有多余空格，claude 也不需要大写。
二、接入 DeepSeek V4 Pro
前置环境部署完成后，就可以正式接入 DeepSeek。这里推荐使用 CC Switch，因为它可以用图形化界面管理 DeepSeek、Claude Official 等供应商，不需要每次手动修改环境变量。
1. 下载并安装 CC Switch
打开 GitHub，搜索 cc switch，找到 farion1231/cc-switch 项目。
进入项目页面后，点击右侧 Releases 查看发布版本。
在 Releases 页面选择最新版安装包即可。Mac 用户选择 macOS.dmg，Windows 用户选择 Windows.msi。下载后按提示安装即可。
2. 进入 DeepSeek 开放平台并充值
打开 DeepSeek 开放平台，先确认账户余额。如果没有余额，需要先充值，否则后面测试 API 时可能会失败。
3. 创建 DeepSeek API Key
在 DeepSeek 开放平台左侧菜单中点击 API keys，然后点击 创建 API key。
注意：API Key 只会完整显示一次。创建后请马上复制保存。不要把真实 Key 发给别人，也不要放进公开博客、视频、截图或 GitHub 仓库。
4. 在 CC Switch 中添加 DeepSeek
打开 CC Switch，选择 Claude Code 相关配置入口，然后点击右上角的加号添加供应商。
进入添加供应商页面后，在预设供应商列表里选择 DeepSeek。
5. 填写 API Key 和请求地址
在 DeepSeek 配置页面中填写供应商名称、官网链接、API Key 和请求地址。
| 字段 | 填写内容 |
|---|---|
| 供应商名称 | DeepSeek |
| 官网链接 | https://platform.deepseek.com |
| API Key | 粘贴刚刚创建的 DeepSeek API Key |
| 请求地址 | https://api.deepseek.com/anthropic |
请求地址一定要填写为：
https://api.deepseek.com/anthropic这个地址是 DeepSeek 提供的 Anthropic API 兼容地址，用于让 Claude Code 通过 Anthropic 格式调用 DeepSeek。
6. 配置 DeepSeek 模型
打开 DeepSeek 官方文档，进入 接入 Agent 工具 → Claude Code，可以看到官方推荐的 Claude Code 模型配置。
在 CC Switch 的模型映射区域，可以按下面方式填写：
主模型： deepseek-v4-pro[1m]
Sonnet 默认模型： deepseek-v4-pro[1m]
Opus 默认模型： deepseek-v4-pro[1m]
Haiku 默认模型： deepseek-v4-flash
Sonnet 模型： deepseek-v4-flash
思考等级： max
如果页面里有「最大强度思考」选项，可以勾选。填写完成后点击添加或保存。
7. 测试 DeepSeek 是否连接成功
保存配置后返回 CC Switch 主页面，找到 DeepSeek 这一项，点击测试或启用。如果出现”DeepSeek 运行正常”，就说明连接成功。
到这里，Claude Code 已经可以通过 CC Switch 调用 DeepSeek 模型了。
三、安装并配置 VS Code
DeepSeek 配置完成后，接下来安装 VS Code。VS Code 是日常打开项目、编辑代码和运行终端的地方。
1. 下载 VS Code
进入 VS Code 官网，选择适合自己系统的安装包。Mac 用户点击 Download for macOS，Windows 用户点击 Download for Windows。
2. 安装简体中文语言包
如果你想把 VS Code 界面改成中文，可以先安装中文语言包。打开 VS Code 后，点击左侧扩展按钮，搜索 Chinese。
选择 Chinese (Simplified) Language Pack for Visual Studio Code，点击安装。安装完成后重启 VS Code，界面就会变成中文。
3. 安装 Claude Code 插件
在 VS Code 左侧扩展商店搜索 Claude Code，选择带有 Anthropic 标识的官方插件并安装。
安装完成后，VS Code 里会出现 Claude Code 的入口。
四、在 VS Code 中开始使用
打开你的项目文件夹。如果右上角出现 Claude Code 图标，说明插件已经安装成功，可以开始使用。
你可以直接点击右上角 Claude Code 图标，或者使用 VS Code 的集成终端运行 Claude Code。
方式一：点击 Claude Code 图标
打开项目后，点击右上角 Claude Code 图标，就可以进入 Claude Code 的界面。第一次使用时，可以先让它只分析项目，不要直接修改文件。
请先分析这个项目结构，不要修改文件，告诉我主要入口文件在哪里。请帮我检查这个项目是否有明显问题，先只给建议，不要直接改代码。请帮我检查这个页面为什么样式没有生效，先分析原因，不要直接修改文件。方式二：使用 VS Code 集成终端
也可以在 VS Code 顶部菜单选择 终端 → 新建终端，然后输入：
claude进入 Claude Code 后，就可以让它读取项目、分析代码、修改页面或排查报错。
请帮我分析当前项目的文件结构，并告诉我首页入口文件在哪里。这个报错是什么意思？请帮我定位原因并给出修复方案。请在 src/components 下新建一个 UserCard 组件，包含头像、用户名和邮箱。一些常用提示词参考
# 项目概览
请先通读这个项目，然后总结：技术栈、项目结构、主要入口文件、
路由配置在哪，以及依赖了哪些核心第三方库。
# 添加功能前先分析
我想在用户列表页添加搜索和分页功能。请先分析现有的数据获取方式
和组件结构，告诉我需要改哪些文件，再等我确认后开始写代码。
# 排查样式问题
这个页面有几个元素的样式没有生效，帮我检查 CSS 是否有冲突、
选择器权重是否够高、是否有被覆盖的情况。先分析不要直接改。
# 代码重构
帮我把 utils/helpers.js 里的工具函数拆分成独立文件，放到 utils/
下的子目录里，确保所有引用路径同步更新。五、常见问题
1. 输入 node -v 没反应怎么办？
一般是 Node.js 没安装成功，或者安装完成后没有重新打开终端。可以重新安装 Node.js，然后关闭终端重新打开，再输入 node -v 和 npm -v 检查。
# 关闭终端重新打开后再次检查
node -v
npm -v2. 输入 claude --version 提示 command not found 怎么办？
说明 Claude Code 没有安装成功，重新执行下面命令：
npm install -g @anthropic-ai/claude-code安装后关闭终端重新打开，再输入：
claude --version3. Windows 为什么要安装 Git？
Windows 安装 Git 后，可以让 Claude Code 更好地使用 Git、Bash 和相关命令工具。DeepSeek 的 Claude Code 接入文档中也提示 Windows 用户需要安装 Git for Windows。
4. DeepSeek 测试失败怎么办？
可以按下面顺序检查：
- DeepSeek 账户是否已经充值。
- API Key 是否复制完整。
- 请求地址是否填写为
https://api.deepseek.com/anthropic。 - 模型名称是否写错，建议直接复制官方文档里的模型名。
- CC Switch 是否已经保存并启用 DeepSeek。
5. VS Code 里看不到 Claude Code 图标怎么办？
可以先重启 VS Code，或者在命令面板中搜索 Claude Code。Mac 使用 Cmd + Shift + P，Windows 使用 Ctrl + Shift + P。如果仍然没有显示，检查插件是否安装成功。
6. API Key 可以分享给别人吗？
不可以。API Key 相当于你的账户密码，别人拿到后可以调用你的账户余额。正式发布教程时，所有涉及 API Key 的截图都要打码。
正确示例：sk-************
错误示例：完整展示 sk- 开头的真实 Key六、总结
到这里，我们已经完成了从零搭建 VS Code + Claude Code + CC Switch + DeepSeek 的完整流程。
- 安装 Node.js 和 npm。
- Windows 用户额外安装 Git。
- 安装 Claude Code。
- 下载并安装 CC Switch。
- 创建 DeepSeek API Key。
- 在 CC Switch 中添加 DeepSeek。
- 配置
deepseek-v4-pro[1m]模型。 - 测试 DeepSeek 连接成功。
- 安装 VS Code 和 Claude Code 插件。
- 在 VS Code 中开始使用 AI 编程助手。
这套方案的好处是不用每次手动修改复杂配置。以后想切换模型时，只需要打开 CC Switch，选择对应供应商即可。对于刚开始接触 AI 编程的新手来说，推荐先用 VS Code + Claude Code + CC Switch + DeepSeek 这套组合，配置简单，也方便后续扩展。
整个工作流程如下：
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ VS Code │────▶│ Claude Code │────▶│ CC Switch │
│ (编辑器) │ │ (AI 引擎) │ │ (模型路由) │
└──────────────┘ └──────────────┘ └──────┬───────┘
│
▼
┌──────────────┐
│ DeepSeek │
│ V4 Pro[1m] │
└──────────────┘完成后，就可以真正开始 Vibe Coding：让 AI 帮你分析项目、修改代码、排查问题、生成页面，提高开发效率。
参考资料
- DeepSeek Claude Code 接入文档：https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code
- CC Switch GitHub：https://github.com/farion1231/cc-switch
- Claude Code VS Code 文档：https://code.claude.com/docs/en/vs-code
- Claude Code VS Code 插件：https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code
- Node.js 下载：https://nodejs.org/zh-cn/download
- Git for Windows：https://git-scm.com/downloads/win
- VS Code 下载：https://code.visualstudio.com/
