当前位置： 首页 > news >正文

零基础保姆级教程：用 CC-Switch + Claude Code 接入 DeepSeek-V4-Pro

news 2026/6/30 11:11:51

🚀 零基础保姆级教程：用 CC-Switch + Claude Code 接入 DeepSeek-V4-Pro

适合人群：完全没有基础的小白 |预计耗时：30~60 分钟
目标：让你在终端里用 Claude Code 的强大工具链，调用 DeepSeek-V4-Pro 的顶级能力，低成本享受 AI 编程助手

📋 教程目录

  1. 整体介绍：我们在做什么？
  2. 准备工作：申请 DeepSeek API Key
  3. 第一步：安装 Node.js
  4. 第二步：安装 Claude Code
  5. 第三步：下载并安装 CC-Switch
  6. 第四步：在 CC-Switch 中配置 DeepSeek
  7. 第五步：启动 Claude Code 并验证
  8. 常见问题与解决方案
  9. 手动配置备用方案

1. 整体介绍：我们在做什么？

关键名词解释

名词是什么用来做什么
Claude CodeAnthropic 出品的 AI 编程命令行工具在终端里让 AI 帮你写代码、改 Bug、分析项目
DeepSeek-V4-Pro深度求索最新旗舰模型性能比肩 Claude Opus 4.6，但 API 价格便宜了两个数量级
CC-Switch开源的图形化配置管理工具帮你一键切换 Claude Code 背后使用的模型，不用手动改配置文件
Anthropic 兼容接口DeepSeek 提供的 API 兼容层让 Claude Code 可以直接"认识"DeepSeek，无需额外适配

为什么要这样做？

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

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

关于[1m]的重要说明 ⚠️

在配置 DeepSeek 模型名称时，必须写成deepseek-v4-pro[1m]，而不是deepseek-v4-pro。

原因：加上[1m]才能开启100 万 Token 的超长上下文。不加的话，只有默认的较短上下文，对于大型项目分析会有明显限制。这是一个非常容易漏掉的关键细节！

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

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

步骤：

  1. 打开浏览器，访问 DeepSeek 开放平台：https://platform.deepseek.com/api_keys

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

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

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

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

    Key 的格式类似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

  6. 账号里要有余额才能使用。新用户一般有免费额度，不够可以充值（10元可用很久）

3. 第一步：安装 Node.js

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

Windows 用户

  1. 打开浏览器，访问 Node.js 官网：https://nodejs.org/

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

  3. 下载完成后，双击.msi安装包，一路点 Next，注意勾选以下两个选项：

    • ✅Add to PATH（把 Node.js 加入系统环境变量）
    • ✅Automatically install the necessary tools（自动安装必要工具）

  4. 安装完成后，打开 PowerShell 或命令提示符（CMD），输入以下命令验证：

    node-vnpm-v

    如果看到类似v22.x.x和10.x.x的版本号，说明安装成功！

Mac 用户

Mac 推荐使用 Homebrew 安装（如果没有 Homebrew，先看下面的提示）：

# 安装 Homebrew（如果已有可跳过）/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 安装 Node.jsbrewinstallnode

也可以直接去官网下载.pkg安装包，步骤和 Windows 类似。

验证安装：

node-vnpm-v

Linux 用户（Ubuntu/Debian）

# 安装 nvm（Node 版本管理器）curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bash# 重启终端后，安装 Node.js LTSnvminstall--ltsnvm use--lts# 验证node-vnpm-v

4. 第二步：安装 Claude Code

Node.js 安装好之后，通过 npm 全局安装 Claude Code。

打开终端（Windows 用 PowerShell 或 CMD，Mac/Linux 用 Terminal），输入：

npminstall-g@anthropic-ai/claude-code

等待安装完成（需要几十秒到几分钟，取决于网络情况）。

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

claude--version

如果显示版本号（如1.x.x），安装成功！


📌提示图片位置：【在此插入 claude --version 命令执行结果截图】

⚠️Windows 用户常见问题：如果提示"无法加载文件，因为在此系统上禁止运行脚本"，请以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser

然后重新安装。

5. 第三步：下载并安装 CC-Switch

CC-Switch 是一个图形界面工具，帮助你管理和切换 Claude Code 使用的 AI 模型。

下载 CC-Switch

访问 CC-Switch 的 GitHub Releases 页面：

👉 https://github.com/farion1231/cc-switch/releases

根据你的操作系统选择对应的安装包：

操作系统选择的文件
Windowscc-switch_x.x.x_x64-setup.exe
Mac (Intel 芯片)cc-switch_x.x.x_x64.dmg
Mac (Apple M 芯片)cc-switch_x.x.x_aarch64.dmg
Linuxcc-switch_x.x.x_amd64.AppImage

Windows 安装注意事项

Windows 用户安装前，需要先确认系统是否安装了Microsoft Edge WebView2 Runtime。

检查方法：打开"控制面板" → “程序” → “程序和功能”，查找是否有Microsoft Edge WebView2 Runtime。

如果没有：访问以下地址下载安装：
https://developer.microsoft.com/en-us/microsoft-edge/webview2/

下载后双击安装，安装过程是自动的（静默模式），装完重启一下即可。

📌提示图片位置：【在此插入 WebView2 下载页面截图】

Mac 安装注意事项

Mac 用户也可以通过 Homebrew 安装（推荐）：

# 添加 tap 并安装brew tap farion1231/ccswitch brewinstall--caskcc-switch

如果是手动下载的.dmg，打开后把CC-Switch.app拖入「应用程序」文件夹即可。

首次打开时 Mac 可能提示"无法验证开发者"，解决方法：
打开「系统设置」→「隐私与安全性」→ 找到 CC-Switch，点击「仍要打开」。

安装完成

安装成功后，打开 CC-Switch，系统托盘（任务栏右下角/菜单栏）会出现 CC-Switch 的图标，主界面如下所示。

6. 第四步：在 CC-Switch 中配置 DeepSeek

这是最关键的步骤！

打开 CC-Switch 主界面

启动 CC-Switch，你会看到主界面顶部有应用切换栏（Claude Code / Codex / Gemini CLI 等），确保当前选中的是Claude Code。

添加 DeepSeek Provider

  1. 点击右上角的「+」按钮，进入添加供应商页面


  1. 你会看到一些内置预设（DeepSeek、Kimi、智谱等）。如果列表里有 DeepSeek 预设，直接选择即可；如果没有，选择「自定义」或「Custom」，手动填写以下信息：

    字段名填写内容
    名称（Name）DeepSeek V4 Pro（随意起名，方便识别）
    Base URLhttps://api.deepseek.com/anthropic
    API Key你在第2步申请的 DeepSeek API Key
    认证类型（Auth Type）ANTHROPIC_AUTH_TOKEN
    API 格式Anthropic

  2. 接下来配置模型名称（⚠️这一步极其重要！）

    模型配置项填写内容说明
    主模型（Model）deepseek-v4-pro[1m]必须加[1m]，开启 100 万 Token 上下文！
    Opus 模型deepseek-v4-pro[1m]复杂任务使用
    Sonnet 模型deepseek-v4-pro[1m]默认任务使用
    Haiku 模型deepseek-v4-flash快速/简单任务，更省钱
    子代理模型deepseek-v4-flash后台子任务

    ⚠️再次强调：模型名称deepseek-v4-pro[1m]中的[1m]千万不能省略！这是 DeepSeek API 的特殊语法，用来激活 100 万 Token 的超长上下文窗口。如果只写deepseek-v4-pro，上下文会大幅缩短，处理大型项目时会有问题。

    📌提示图片位置：【在此插入模型名称配置截图，重点标注 [1m] 部分】

  3. 其他可选配置（建议开启）：

    • 将CLAUDE_CODE_EFFORT_LEVEL设置为max（让模型以满血状态运行，充分调用思考能力）
    • 将API_TIMEOUT_MS设置为3000000（防止长任务超时，DeepSeek 处理复杂请求有时需要较长时间）

  4. 确认所有信息填写无误后，点击「保存」或「添加」

启用 DeepSeek Provider

配置保存后，在供应商列表中找到刚才添加的DeepSeek V4 Pro，点击「启用」。

CC-Switch 会自动将配置写入 Claude Code 的配置文件（~/.claude/settings.json），无需手动操作。

📌提示图片位置：【在此插入供应商列表截图，显示 DeepSeek 已启用（绿色状态）】

健康检查（验证配置是否正确）

启用后，点击 Provider 旁的「健康检查」按钮，CC-Switch 会发送一个测试请求验证 API Key 和网络连通性。

  • ✅显示"成功"或绿色状态：配置正确，可以使用！
  • ❌显示错误：请检查 API Key 是否正确、是否有余额

7. 第五步：启动 Claude Code 并验证

启动 Claude Code

打开终端（PowerShell / CMD / Terminal），进入你的项目目录，然后输入：

cd你的项目文件夹路径 claude

例如：

cd~/Desktop/my-project claude

如果是第一次运行，Claude Code 会有一个简短的初始化流程，直接按提示操作即可（无需登录 Anthropic 账号！使用 DeepSeek API 不需要 Claude 账号）。

确认模型是否正确

进入 Claude Code 界面后，输入以下命令查看当前状态：

/status

你会看到类似这样的输出：

Model: deepseek-v4-pro[1m] API Base URL: https://api.deepseek.com/anthropic ...

如果Model一行显示的是deepseek-v4-pro[1m]，说明接入成功！🎉

测试一下！

试着让 Claude Code 做一件简单的事：

你好！请介绍一下你自己，你现在使用的是什么模型？

或者让它帮你写一段代码：

帮我写一个 Python 函数，输入一个列表，返回列表中所有偶数的平方和

如果 Claude Code 正常响应并给出答案，恭喜你，整个配置已经完成！

8. 常见问题与解决方案

❓ Q1：启动 claude 后提示 “Not logged in, please run /login”

原因：认证类型选择了ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN。

解决方案：
回到 CC-Switch，编辑 DeepSeek Provider 的配置，将认证类型改为ANTHROPIC_AUTH_TOKEN，保存后重新启用。

❓ Q2：提示 400 错误 / Bad Request

可能原因 1：模型名称填错了。检查是否正确填写了deepseek-v4-pro[1m]（注意中括号和 1m）。

可能原因 2：API 格式选择有误，确保选择的是Anthropic兼容格式，而不是OpenAI chat completions。

可能原因 3：Base URL 末尾多了或少了斜杠，正确格式为https://api.deepseek.com/anthropic（结尾无斜杠）。

❓ Q3：模型名称不显示 1M 上下文

原因：模型名称没有加[1m]后缀。

解决方案：在 CC-Switch 中，将所有需要长上下文的模型字段（Opus、Sonnet、主模型）都改为deepseek-v4-pro[1m]，保存并重新启用。

❓ Q4：Windows 下 CC-Switch 安装失败，提示缺少 WebView2

解决方案：参考第5步，先安装 Microsoft Edge WebView2 Runtime，然后重新安装 CC-Switch。

❓ Q5：npm install 报错，提示网络超时

解决方案（Windows）：尝试切换 npm 镜像源到国内镜像：

npmconfigsetregistry https://registry.npmmirror.comnpminstall-g@anthropic-ai/claude-code

解决方案（Mac/Linux）：同上，或者使用代理工具后再安装。

❓ Q6：健康检查失败，提示余额不足

解决方案：登录 https://platform.deepseek.com/ 充值账户余额。DeepSeek V4-Pro 的价格非常实惠，10元可以使用很长时间。

❓ Q7：响应速度慢，感觉在等待

原因：DeepSeek-V4-Pro 使用了思维链推理，复杂任务确实需要思考时间，这是正常现象。

解决方案：确保API_TIMEOUT_MS设置为足够大的值（如3000000），防止超时中断。

9. 手动配置备用方案（可选）

如果 CC-Switch 图形界面遇到问题，也可以直接手动配置环境变量，效果完全一样。

Mac / Linux 用户（终端）

将以下内容添加到你的 Shell 配置文件（~/.zshrc或~/.bashrc）：

exportANTHROPIC_BASE_URL=https://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKEN=你的DeepSeek_API_KeyexportANTHROPIC_MODEL=deepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flashexportCLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flashexportCLAUDE_CODE_EFFORT_LEVEL=maxexportCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1exportAPI_TIMEOUT_MS=3000000

保存后执行source ~/.zshrc（或重启终端），然后运行claude即可。

Windows 用户（PowerShell）

在 PowerShell 中执行（每次重启终端需要重新执行，建议加入 PowerShell Profile）：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"$env:ANTHROPIC_AUTH_TOKEN="你的DeepSeek_API_Key"$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"$env:CLAUDE_CODE_EFFORT_LEVEL="max"$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"$env:API_TIMEOUT_MS="3000000"

直接写入 Claude Code 配置文件

也可以直接编辑~/.claude/settings.json，在env字段中添加：

{"env":{"ANTHROPIC_AUTH_TOKEN":"你的DeepSeek_API_Key","ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-v4-flash","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-v4-flash","CLAUDE_CODE_EFFORT_LEVEL":"max","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":"1","API_TIMEOUT_MS":"3000000"},"hasCompletedOnboarding":true}

保存后直接运行claude即可生效，无需重启终端。

✅ 配置完成检查清单

完成教程后，逐一确认以下项目：

  • DeepSeek API Key 已申请并保存
  • Node.js 已安装，node -v能显示版本号
  • Claude Code 已安装，claude --version能显示版本号
  • CC-Switch 已安装并能正常打开
  • CC-Switch 中已添加 DeepSeek Provider，Base URL 和 API Key 填写正确
  • 模型名称填写的是deepseek-v4-pro[1m]（包含[1m]）
  • 认证类型选择的是ANTHROPIC_AUTH_TOKEN
  • 健康检查通过（绿色状态）
  • 运行claude后，/status显示 Model 为deepseek-v4-pro[1m]

全部打勾，代表你已经成功配置好 Claude Code + DeepSeek-V4-Pro，可以开始享受低成本的顶级 AI 编程体验了！🎉

📚 参考资源

  • DeepSeek 官方接入文档：https://api-docs.deepseek.com/guides/coding_agents
  • CC-Switch 开源项目：https://github.com/farion1231/cc-switch
  • DeepSeek API Key 申请：https://platform.deepseek.com/api_keys
  • Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code
http://www.cnnetsun.cn/news/2194346.html

相关文章：

  • 观察 API 密钥的审计日志如何帮助排查未授权的模型调用
  • LeetCode 70爬楼梯：除了动态规划，C++程序员还能用这几种骚操作解题？
  • ESP固件烧录终极指南：5分钟快速掌握esptool完整用法
  • 如何通过 TaoToken CLI 一键安装包并配置多模型环境
  • 在模型广场中根据任务需求与预算筛选合适大模型的实用思路
  • SNOW-V算法C语言实现
  • 当ChatGPT遇上主动学习：用大模型‘智能提问’，让小模型‘精准成长’
  • 学Simulink——基于Simulink的功能安全（ISO 26262）故障注入与验证​
  • AI工具集合项目解析：从筛选到实践的全流程指南
  • 猫抓浏览器资源嗅探扩展：专业级网页媒体下载解决方案
  • 基于Raycast与OpenAI的智能翻译插件开发实战
  • 基于MongoDB与MCP协议构建AI智能体持久化记忆层
  • 别再只抓包了！手把手教你用OpenSSL验证‘挑战-响应’身份鉴别的签名（附完整数据包分析）
  • Python大模型微调不是调参，是系统工程：我们实测了12种量化+微调组合，最终锁定BF16+NF4+GA=2的最优性价比方案
  • 从逆波兰表达式到自制脚本引擎：用C++实现eval()的踩坑与优化实录
  • 终极GlosSI使用指南：让Steam控制器在任何游戏中都能工作
  • 文档重排技术演进与jina-reranker-v3架构解析
  • 别再只测电压了！手把手教你用LTC2944库仑计给锂电池做精准电量监控（附完整Arduino代码）
  • 开箱即用的Docker开发环境：lean-ctx镜像深度解析与实战指南
  • 电感Q值详解：影响谐振电路性能的关键因素
  • 5个简单步骤掌握GlosSI：解锁全平台游戏控制器配置终极指南
  • 5步构建RE引擎游戏Mod：从零开始掌握REFramework开发
  • Appium MCP Server：用自然语言驱动移动端自动化测试
  • 从医学影像到AI模型：我是如何用LIDC-IDRI数据集构建肺癌分类项目第一阶段的
  • taotoken为独立开发者提供稳定可靠的大模型api服务
  • 终极风扇控制方案：FanControl让Windows散热管理如此简单
  • 从数学证明到数据可视化：用Manim CE 0.7制作‘会讲故事’的技术视频
  • CentOS7服务器运维：用yum源管理多版本Golang（稳定版与RC版）实战
  • YimMenu终极指南：如何打造GTA5最强防护与游戏增强体验
  • 从《原神》模型到Unity特效：手把手教你拆解‘消融为灰’的两种ShaderGraph实现方案