从零开始配置 Claude Code + cc-switch + DeepSeek

Claude Code 是什么？

Claude Code 是 Anthropic 公司推出的命令行 AI 编程助手。它不是一个网页应用，而是一个运行在你电脑终端里的程序——可以读你的代码、写代码、搜索文件、执行命令，还能帮你管理知识库！

和网页版 Claude 的关键区别：

	网页版Claude	Claude Code
运行位置	浏览器	本地终端
操作文件	不支持	支持
执行命令	不支持	支持
使用方式	手动粘贴代码	直接在项目中工作

简单说：网页版是你跟它聊代码，Claude Code 是它帮你干活。

为什么用 DeepSeek V4 ？

当你把 Claude Code 的模型切到 DeepSeek V4 时：

• 成本：DeepSeek API 价格远低于 Claude（大约便宜 10-50 倍）

• 能力：DeepSeek V4 是国产顶级模型，代码能力优秀

• 限制：部分高级特性（如 extended thinking、工具调用细节）可能与原生 Claude 有差异

• 网络：国内直连，无需代理

搞清原理

---

环境准备 🛠️

安装 Node.js

Claude Code 基于 Node.js 运行，所以第一步是安装 Node.js。

推荐方式：nvm-windows（Node 版本管理器）

1. 打开浏览器，访问 https://nvm.uihtm.com/doc/download-nvm.html

2. 下载最新版的安装包

3. 双击安装，一路点 “下一步” 即可

4. 安装完毕后，打开 PowerShell（按 Win+R，输入 powershell，回车）

# 验证 nvm 安装成功（如果显示版本数字，则安装成功）

nvm version

# 安装 Node.js LTS 版本（推荐 20.x 或以上）

nvm install 20

# 使用刚安装的版本

nvm use 20

# 验证 Node.js 和 npm （显示版本数字则安装成功）

node --version

npm --version

---

配置 npm 国内镜像源

这一步非常重要，否则 npm install 会非常慢甚至失败。

设置为淘宝镜像源（推荐）

npm config set registry https://registry.npmmirror.com

验证设置成功

npm config get registry

应该输出：https://registry.npmmirror.com

💡 如果将来需要恢复默认源：npm config set registry https://registry.npmjs.org

---

安装 Claude Code 🛠️

安装命令

打开你选择的终端，输入：

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

验证安装 ✅

claude --version

输出类似 v1.0.x 就说明安装成功了。

3.3 首次启动会遇到的状况

如果你此时直接输入 claude 启动，会遇到以下问题：

1. 登录页面 — Claude Code 会尝试在浏览器中打开 Anthropic 的登录页，需要海外账号

2. 网络超时 — 即使有账号，国内直接访问 Anthropic API 也会超时

别担心，第 4-5 步会用 cc-switch 绕过这些问题。

---

获取 DeepSeek API Key 🛠️

注册 DeepSeek 开放平台

1. 浏览器打开 https://platform.deepseek.com

2. 点击右上角 “注册” / “Sign Up”，注册完成后登录

获取 API Key

1. 登录后，点击左侧菜单 “API Keys”

2. 点击 “创建 API Key” 按钮

3. 给 Key 起个名字（例如 claude-code）

4. 立即复制并保存！ 这个 Key 只显示一次，关闭页面后无法再次查看

5. 推荐做法：先粘贴到记事本里暂存
   

充值（DeepSeek 是预付费）

1. 点击左侧菜单 “充值” / “Billing”

2. 首次建议充值 10-20 元即可（DeepSeek 价格很低，能用很久）

---

cc-switch 安装与配置 🛠️

cc-switch 的作用是在 Claude Code 和 DeepSeek API 之间做翻译，让 Claude Code “以为” 自己在和 Anthropic 服务器通信，实际上请求被转发到了 DeepSeek。

安装 cc-switch

https://pan.baidu.com/s/1EQtAN9ic-IkO_P-3QIB2Vw?pwd=6h37 提取码: 6h37

下载后双击安装，一路点“下一步”即可

配置API KEY

1. 打开 cc-switch 后点击右上角黄色加号，在“预设供应商”处选择“deepseek”。
2. 下滑找到 API KEY输入框，填写刚刚复制的API KEY。
   
3. 继续下滑找到模型映射，可全部填写deepseek-v4-flash
   
4. 点击右下角添加
5. 在 cc-switch 主界面找到刚刚新建的DeepSeek，点击“启用”按钮！！！这步很重要。
   

验证连接 ✅

配置完成后，在终端中输入命令：claude

如果一切正常，Claude Code 会启动并显示对话界面。输入：

你好，请简单介绍一下你自己

如果正常回复 ，说明配置成功！