一、介绍

Claude Code 是 Anthropic 出品的 AI 编程命令行工具，能在终端里让 AI 帮你写代码、改 Bug、分析项目。但它本身需要订阅 Claude，在国内使用有一定门槛。

而 DeepSeek 提供了一个与 Anthropic API 完全兼容的接口，只需要将 Claude Code 的请求地址换成 DeepSeek 的地址，就能无缝使用 DeepSeek 的模型——保留 Claude Code 强大的工具链和执行力，换上 DeepSeek 高性价比的模型。

CC-Switch 则是一个开源的图形化配置管理工具，帮你一键切换 Claude Code 背后使用的模型，不用手动改配置文件。

二、准备工作：申请 DeepSeek API Key

在开始安装任何软件之前，先去申请 DeepSeek 的 API Key。

步骤：

1. 打开浏览器，访问 DeepSeek 开放平台：DeepSeek

2. 注册/登录账号（支持微信扫码、手机号）

3. 进入控制台后，点击左侧菜单的「API Keys」

4. 点击「创建 API Key」，给它起个名字（比如 claude-code），然后点确认

立刻复制并保存好这个 Key！它只显示一次，关闭就看不到了！ 

三、第一步：安装 Node.js

Claude Code 基于 Node.js 运行，必须先安装。

Windows 用户

1. 打开浏览器，访问 Node.js 官网：Node.js — Run JavaScript Everywhere

2. 选择左边的 LTS（长期支持版） 下载，比如 v22.x.x LTS

3. 下载完成后，双击 .msi 安装包，一路点 Next

4. 注意勾选以下两个选项：

   • ✅ Add to PATH（把 Node.js 加入系统环境变量）

安装完成后，打开 PowerShell 或 CMD，输入以下命令验证是否安装成功：

powershell

node -v
npm -v

如果能正常显示版本号，说明安装成功。

四、第二步：安装 Claude Code

打开终端（Windows 用户可以用 PowerShell 或 CMD），执行以下命令全局安装 Claude Code：

powershell

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

如果遇到 PowerShell 执行策略错误（如 cannot be loaded because running scripts is disabled on this system），请运行以下命令修改当前用户的执行策略：

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认后，重新打开 PowerShell 。

安装完成后，验证是否安装成功：

powershell

claude --version

如果能正常显示版本号，说明 Claude Code 安装成功。

五、第三步：配置 DeepSeek API

方式一：使用 CC-Switch（推荐，有图形界面）

CC-Switch 让整个配置过程变得非常简单，有图形界面，不需要手动改 JSON 文件。

1. 安装 CC-Switch（全局安装）：

   powershell

   npm install -g cc-switch

2. 启动 CC-Switch：

   powershell

   cc-switch

3. 在图形界面中：

   • 选择你要切换到的模型提供商（DeepSeek）

   • 填入你之前申请的 DeepSeek API Key

   • 模型名称必须写成 deepseek-v4-pro

重要说明：在配置DeepSeek模型名称时，必须写成 deepseek-v4-pro[1m]，这样才能开启 100 万 Token 的超长上下文。不加的话，只有默认的较短上下文，对于大型项目分析会有明显限制。

1. 点击保存/应用，CC-Switch 会自动帮你完成配置。

2. 有测速按钮，可以试试，绿色就正常了。

方式二：使用 Claude Desktop 配置文件

如果你使用的是 Claude Desktop，可以在配置文件中添加 DeepSeek 配置：

找到 claude_desktop_config.json 文件，添加相应配置。具体路径因操作系统而异。

---

六、第四步：验证与使用

配置完成后，在终端中进入你的项目目录，执行：

powershell

claude

如果能正常启动，并且能看到 AI 的响应，说明配置成功！你现在可以在终端里让 Claude Code 调用 DeepSeek 模型帮你写代码、改 Bug、分析项目了。

快速测试

八、总结

整个配置流程可以概括为三步：

1. 申请 DeepSeek API Key → 访问 DeepSeek 开放平台，注册并创建 Key

2. 安装 Node.js 和 Claude Code → 下载安装 Node.js，然后 npm install -g @anthropic-ai/claude-code

3. 配置 DeepSeek 模型 → 使用 CC-Switch 或手动配置环境变量，记得模型名写成 deepseek-v4-pro[1M]

其他小tips：Claude Code 提供了多种权限模式，就像档位一样，可以控制它执行操作时是否需要你点头。最推荐的做法是，在会话中按 Shift + Tab 快捷键循环切换。下面是几种常用模式：

• acceptEdits（自动接受编辑）：这是日常开发的最佳选择。它会自动批准文件编辑，只在执行 Shell 命令（如 npm install）时才问你。这样既省去了大量点“确认”的麻烦，又保留了对关键操作的控制权。

• auto（自动模式）：一个更智能的“中间档”。Claude 会先自己判断操作是否安全（比如会不会批量删文件），安全的操作就直接执行，只有遇到高风险操作才会停下来问你。这是目前平衡效率和安全性的优选方案。

  • 如何开启：需要用 --enable-auto-mode 参数启动，例如 claude --enable-auto-mode。

• bypassPermissions（绕过权限 / YOLO 模式）：完全跳过所有确认，Claude 想干啥就干啥。这个模式非常危险（官方名称都带着“dangerously”），只建议在完全隔离的环境（如 Docker 容器）或 CI/CD 流水线中使用，绝对不推荐在日常开发中开启