使用 CC-Switch 将 DeepSeek V4 接入 Claude Code 的保姆级教程

使用 CC-Switch 将 DeepSeek V4 接入 Claude Code 的安装、配置与验证教程。

使用 CC-Switch 将 DeepSeek V4 接入 Claude Code 的保姆级教程

本文档适用于 Windows 环境，说明如何使用 CC-Switch 将 DeepSeek V4 接入 Claude Code，并完成 API Key 准备、Node.js 与 Claude Code 安装、Provider 配置和连通性验证。整体目标是让没有命令行基础的用户也能按步骤完成部署。

1. 方案概览

这套方案的核心思路是：保留 Claude Code 的命令行工作流和工具调用能力，通过 DeepSeek 提供的 Anthropic 兼容接口，把 DeepSeek V4 接入 Claude Code。这样可以在不改变主要使用方式的前提下，获得更低的使用成本和更长的上下文能力。

组成作用
Claude CodeAnthropic 提供的 AI 编程命令行工具，可在终端中执行代码生成、修改、分析与项目操作
DeepSeek V4DeepSeek 当前旗舰模型系列，可通过兼容接口接入 Claude Code；如需高复杂度任务能力，推荐使用 deepseek-v4-pro，并在 CC-Switch 中为 Sonnet / Opus 勾选 1M
CC-Switch开源图形化配置工具，用于管理 Claude Code 背后的模型与接口配置
Anthropic 兼容接口DeepSeek 提供的兼容层，让 Claude Code 可以直接向 DeepSeek 发送请求

2. 准备工作：申请 DeepSeek API Key

开始安装前，先在 DeepSeek 开放平台申请 API Key，并确认账户内有可用余额。

  1. 打开 DeepSeek API Keys 页面
  2. 注册或登录账号
  3. 进入 API Keys 页面后点击创建
  4. 为 Key 命名，例如 claude-code
  5. 创建后立即复制并妥善保存，API Key 通常只显示一次
  6. 如无可用额度，可在平台中充值
图 1：在 DeepSeek 平台创建并保存 API Key
图 1：在 DeepSeek 平台创建并保存 API Key

3. 安装 Node.js

Claude Code 基于 Node.js 运行，因此需要先安装 Node.js。

打开 Node.js 官网，下载左侧 LTS 版本。安装时建议勾选加入 PATH，并允许安装必要工具。

图 2：在 Node.js 官网下载 LTS 版本
图 2：在 Node.js 官网下载 LTS 版本

安装完成后，在 PowerShell 或 CMD 中执行以下命令验证。

node -v
npm -v
图 3：通过 node -v 与 npm -v 验证安装结果
图 3：通过 node -v 与 npm -v 验证安装结果

4. 安装 Claude Code

Node.js 就绪后，可通过 npm 全局安装 Claude Code。

npm install -g @anthropic-ai/claude-code
claude --version
图 4：使用 claude --version 验证 Claude Code 安装结果
图 4：使用 claude --version 验证 Claude Code 安装结果

Windows 常见问题：如果 PowerShell 提示禁止运行脚本，可在管理员 PowerShell 中执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，然后重新安装。

5. 下载并安装 CC-Switch

截至 2026-05-25，本文步骤基于当前最新可获取版本：CC Switch v3.15.0 与 Claude Code v2.1.150。Windows 用户通常会看到 CC-Switch-v3.15.0-Windows.msi 和 CC-Switch-v3.15.0-Windows-Portable.zip 两种形式，推荐优先使用安装版 .msi。下载页：CC-Switch Releases

图 5：Releases 页面中的 Windows.msi 与 Windows-Portable.zip
图 5：Releases 页面中的 Windows.msi 与 Windows-Portable.zip

5.1 运行安装程序

双击下载得到的 .msi 后，会进入标准安装向导。第一步是欢迎页，直接点击 Next 即可。

图 6：CC-Switch 安装向导欢迎页
图 6：CC-Switch 安装向导欢迎页

随后会进入安装目录确认页面。默认目录通常已经可以直接使用，如无特殊要求不需要修改。

图 7：确认安装目录并继续下一步
图 7：确认安装目录并继续下一步

在 Ready to install 页面点击 Install 开始安装。

图 8：确认安装并开始写入文件
图 8：确认安装并开始写入文件

安装完成后，建议保留 Launch CC Switch 选项并点击 Finish，方便直接进入配置流程。

图 9：安装完成后可直接启动 CC-Switch
图 9：安装完成后可直接启动 CC-Switch

6. 在 CC-Switch 中配置 DeepSeek V4

下面按当前界面顺序完成配置。

6.1 首次打开时先处理旧环境变量冲突

如果你的系统之前用过手动环境变量方式接入 Claude Code，CC-Switch 可能会在顶部直接提示 检测到系统环境变量冲突。这类变量会覆盖 CC-Switch 写入的配置，导致后续切换不生效。

图 10：顶部提示检测到环境变量冲突
图 10：顶部提示检测到环境变量冲突

点开详情后，建议删除这些旧变量，避免在后续使用中造成冲突。

图 11：展开冲突详情并删除旧的 ANTHROPIC 环境变量
图 11：展开冲突详情并删除旧的 ANTHROPIC 环境变量

6.2 新增 DeepSeek 供应商

回到主界面后，确认顶部当前选中的是 Claude Code，然后点击右上角橙色 + 按钮新增供应商。

图 12：在 Claude Code 视图中点击右上角加号
图 12：在 Claude Code 视图中点击右上角加号

新增页面默认停留在 Claude 供应商 标签。直接选择内置的 DeepSeek 预设即可。

图 13：在预设供应商列表中找到 DeepSeek
图 13：在预设供应商列表中找到 DeepSeek

选中 DeepSeek 后点击右下角 添加。这一步只是把预设加入列表，后续仍需要补充 API Key 和模型映射。

图 14：选中 DeepSeek 并添加到供应商列表
图 14：选中 DeepSeek 并添加到供应商列表

如果在尚未填写 API Key 的情况下直接尝试保存，程序会弹出“配置存在以下问题”的提示。这说明还需要回到编辑页补全 API Key。

图 15：未填写 API Key 时会弹出配置问题提示
图 15：未填写 API Key 时会弹出配置问题提示

6.3 填写 API Key 并检查自动生成配置

回到供应商列表后，点击 DeepSeek 右侧的铅笔按钮进入编辑页面。

图 16：通过编辑按钮进入 DeepSeek 配置页
图 16：通过编辑按钮进入 DeepSeek 配置页

当前界面已经把很多字段自动化了。对大多数用户来说，真正需要手工填写的核心内容只有 API Key。截图中的提示也明确写着“只需要填这里，下方配置会自动填充”。

图 17：在编辑页中填写 DeepSeek API Key
图 17：在编辑页中填写 DeepSeek API Key

6.4 配置模型映射与 1M 选项

在当前界面中，显示名称 和 实际请求模型 直接填写 deepseek-v4-pro 即可；1M 上下文能力通过右侧的 1M 勾选项声明。

图 18：通过 1M 勾选项声明 Sonnet 与 Opus 的超长上下文能力
图 18：通过 1M 勾选项声明 Sonnet 与 Opus 的超长上下文能力

推荐把 Sonnet 和 Opus 都映射到 deepseek-v4-pro 并勾选 1M；Haiku 映射到 deepseek-v4-flash 即可。底部 默认兜底模型 一般保留为 deepseek-v4-pro。

6.5 保存并启用 DeepSeek

确认 API Key、模型映射和 1M 勾选都无误后点击 保存。如需核对写入结果，可以向下查看配置 JSON。

图 19：下方 JSON 会随上方配置自动生成
图 19：下方 JSON 会随上方配置自动生成
回到供应商列表后，再点击 启用 让 DeepSeek 成为当前 Claude Code 使用的供应商。
图 20：保存后在列表中启用 DeepSeek
图 20：保存后在列表中启用 DeepSeek

启用后，CC-Switch 会把兼容 Anthropic 接口所需的配置写入 Claude Code。后续如果只是在同一套配置下日常使用 Claude Code，不需要一直开着 CC-Switch；只有切换供应商、修改 API Key 或重新调整模型映射时，才需要再打开。

7. 启动 Claude Code

配置完成后，建议先进入具体项目目录，再启动 Claude Code，避免长期在 C:\Users\用户名 这类主目录直接运行。

cd 你的项目目录
claude
图 21：Claude Code 启动后的欢迎界面
图 21：Claude Code 启动后的欢迎界面

8. 基本操作

第一次使用时，先掌握三项：/model 切模型，/effort 调强度，Shift+Tab 切权限模式。

8.1 先记住这几个命令

命令作用什么时候最常用
/help查看当前可用命令第一次上手或忘记命令时
/model切换当前模型在不同任务复杂度之间切换时
/effort调整当前会话的思考强度需要在速度、成本和推理深度之间取舍时
/permissions查看当前权限设置确认为什么会频繁弹确认框时
/clear清空当前会话历史想重新开始一个干净会话时
/compact压缩当前对话上下文长会话后减少上下文占用时

完整命令列表见 Claude Code 官方文档：Commands。

8.2 /effort：最常用的强度调节命令

/effort 用于调整当前会话的思考强度，只影响当前会话。可直接输入 /effort low、/effort medium、/effort high、/effort xhigh、/effort max，也可输入 /effort auto 恢复默认；不带参数时会打开交互式滑杆。相关说明见 Commands 与 Model configuration。

图 22：在 Claude Code 中打开 /effort 交互式滑杆
图 22：在 Claude Code 中打开 /effort 交互式滑杆

新手可以先这样理解：

档位建议理解
low / medium更快、更省，适合轻量任务
high日常开发默认起点
xhigh / max更重推理，适合复杂调试、复杂重构、长链任务

如果你接入的是 DeepSeek V4，界面中虽然仍显示 Claude Code 的五档 /effort，但 DeepSeek 侧实际只有 high 和 max 两档。根据 DeepSeek 官方 Thinking Mode 文档，映射关系可以简化理解为：

Claude Code 中选择的 /effortDeepSeek 侧实际档位
low / medium / highhigh
xhigh / maxmax

新人建议
日常开发任务通常从 /effort high 开始即可；当任务明显更难、需要多步工具调用或长链推理时，再切到 xhigh 或 max。

/effort 被锁定时怎么处理

如果界面中出现类似 CLAUDE_CODE_EFFORT_LEVEL=max overrides this session — clear it and high takes over 的提示，说明当前会话的 /effort 被环境变量或配置文件强制覆盖了。此时先清理覆盖源，再重新设置。

图 23：CLAUDE_CODE_EFFORT_LEVEL 覆盖当前会话时的提示
图 23：CLAUDE_CODE_EFFORT_LEVEL 覆盖当前会话时的提示
  1. 在 PowerShell 中执行 echo $env:CLAUDE_CODE_EFFORT_LEVEL
  2. 如果有输出，先清掉当前 shell 变量：Remove-Item Env:CLAUDE_CODE_EFFORT_LEVEL -ErrorAction SilentlyContinue
  3. 同时删除 Windows 中持久化的同名环境变量。可在“系统属性 → 高级 → 环境变量”中删除，也可用 PowerShell 执行：[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", $null, "User")
  4. 如果 echo 没有输出，但 Claude Code 仍提示 override，则继续检查 %USERPROFILE%\.claude\settings.json
  5. 如果文件中的 env 段包含 CLAUDE_CODE_EFFORT_LEVEL，将这一项删除后保存
  6. 完全退出并重新启动 Claude Code
  7. 重新执行 /effort 验证是否已经恢复可调

8.3 Shift+Tab 切换权限模式

按 Shift+Tab 可循环切换权限模式。第一次上手先记住这三档即可：

模式适合场景
default新手上手、敏感项目、希望逐步确认时
acceptEdits已经明确任务方向，希望加快改代码节奏时
plan只想先让 Claude 分析和列方案时

熟悉之后，再去了解 auto 和 bypassPermissions。相关说明见官方文档：Permission Modes、交互模式。

8.4 关于 claude --dangerously-skip-permissions

如果确实需要让 Claude 在启动后直接进入更高自主权模式，可以在命令行中使用：

claude --dangerously-skip-permissions

这个命令会直接以 Bypass permissions 方式启动，适合可回滚、无敏感文件、且你能准确评估任务影响范围的工作目录。

风险提醒

它会跳过大部分人工确认，只建议在你能把控任务边界与改动后果时使用。

9. 参考资源

本文档允许非商业转载与分享，但需注明来源并保留作者署名。

来源：https://docs.20020519.xyz/books/cc-switch-deepseek-v4-claude-code
作者：zhiangxu1093@gmail.com