Claude Code 接入 DeepSeek 教程(CC Switch)
本文介绍如何通过 CC Switch 工具,让 Claude Code 桌面端接入 DeepSeek API,实现低成本、高效率的 AI 编程体验。
# 一、前置:安装 Git
官网下载 Git:https://git-scm.com/install/windows (opens new window)
若官网下载较慢,可在 AI 交流群群文件获取安装包。
# 二、安装 Claude Code(桌面端 / CLI)
Claude Code 提供两种使用方式:桌面端(GUI)和 CLI 端(命令行)。根据需求选择其一即可。
# 方式一:桌面端安装
官网下载:https://code.claude.com/docs/zh-CN/desktop (opens new window)
Windows 用户按提示完成安装。
# 方式二:CLI 端安装
CLI 端适合习惯命令行操作的开发者,轻量且灵活。
macOS / Linux(推荐使用 Homebrew):
brew install claude
或通过 npm 全局安装(跨平台):
npm install -g @anthropic-ai/claude-code
安装完成后,终端运行:
claude
首次启动会引导你登录或配置 API Key。
提示
CLI 端同样可以通过 CC Switch 接入 DeepSeek,配置方法与桌面端相同(见下文)。
# 三、开启开发者模式
打开 Claude Code,依次点击:
Help → Troubleshooting → Enable Developer Mode
# 四、安装 CC Switch 并配置 DeepSeek
# 1. 下载安装 CC Switch
GitHub 下载:https://github.com/farion1231/cc-switch/releases/tag/v3.16.1 (opens new window)
# 2. 添加 Claude Code 桌面端供应商
打开 CC Switch 主页面,选择 Claude Code 桌面端配置,点击 添加供应商。
在预设列表中选择 DeepSeek。
# 3. 填写 API Key
填入你的 DeepSeek API Key,请求地址已预设,无需改动。
| 项目 | 说明 |
|---|---|
| Key 申请入口 | https://platform.deepseek.com/api_keys (opens new window) |
| 注意事项 | 提前充值,余额不足会导致请求报错 |
# 4. 配置模型映射
模型可按下图设置:
deepseek-v4-flashdeepseek-v4-pro
勾选 1M 上下文,然后点击 添加。
# 5. 开启本地路由
点击 设置 → 路由 页,打开 本地路由,并勾选 CLAUDE(让 Claude Code 请求走本地路由转发)。
返回 CC Switch 首页,确认 本地路由 开关已开启(显示为运行中)。
# 6. 启用 DeepSeek 供应商
在首页对 DeepSeek 供应商点击 启用。
# 五、重启 Claude Code 验证
完全退出 Claude Code 桌面端后重新打开。默认模型应已切换为 DeepSeek V4。
发一句「你好」测试,能正常收到回复,说明配置成功。
# 六、可选:配置中文汉化
若希望界面显示中文,可使用第三方汉化插件:
https://github.com/javaht/claude-desktop-zh-cn (opens new window)
运行后选择 1(第三方 API 登录方式) 即可。
注意
使用 CC Switch 接入 DeepSeek 时,汉化插件务必选 选项 1(第三方 API 登录方式),不要选官方账号登录方式。
# 常见问题
# Q1:CC Switch 里 DeepSeek 已启用,Claude Code 仍显示旧模型?
- 确认首页 本地路由 开关已打开,且 CLAUDE 路由项已勾选
- 完全退出 Claude Code 进程后再从桌面重新打开
- 在 CC Switch 中重新 启用 DeepSeek 供应商
# Q2:请求报错 / 无响应?
- 检查 DeepSeek API Key 是否有效、账户是否已充值
- 确认 CC Switch 中 DeepSeek 供应商状态为运行中,本地路由总开关已开启
# Q3:Claude Code 无法启动或一直加载?
- 确认已开启 开发者模式(Help → Troubleshooting → Enable Developer Mode)
- 检查 CC Switch 本地路由是否正常运行
# Q4:GitHub / 官网下载太慢?
可进 AI 交流群群文件下载安装包。
# 总结
通过 CC Switch,可以轻松将 Claude Code 桌面端接入 DeepSeek,享受更低成本的 AI 编程体验。整个配置过程简单,核心步骤:
- 安装 Claude Code 并开启开发者模式
- 安装 CC Switch 并添加 DeepSeek 供应商
- 填写 API Key,配置模型映射
- 开启本地路由并启用供应商
- 重启验证
有问题欢迎交流讨论!