相关工具放到夸克网盘了 链接:https://pan.quark.cn/s/b5aa93adebba
DeepSeek + cc-switch + Claude Code 全套配置教程
用 DeepSeek(国产、便宜、效果好)驱动 Claude Code 等 AI 编程工具,
再用 cc-switch 一键切换多个模型服务商。
本教程基于 Windows 实测整理,Linux / macOS 路径大同小异。
一、这套方案是什么
| 组件 | 作用 | 花费 |
|---|---|---|
| DeepSeek | 提供大模型 API(写代码的主力) | 按量付费,极便宜(约 ¥1-8 / 百万 token) |
| cc-switch | 图形化管理多个 AI 客户端的模型配置,一键切换 | 免费开源 |
| Claude Code | Anthropic 出品的终端 AI 编程助手 | 工具本身免费用,模型走你的 DeepSeek |
一句话:用 Claude Code 的交互体验 + DeepSeek 的价格,一套配置,随时切换。
二、准备清单
- 一台 Windows / macOS / Linux 电脑
- Node.js 18+(Claude Code 需要)→ Node.js — Run JavaScript Everywhere
- 手机号(注册 DeepSeek 用)
- 阿里云账号(可选,仅用 cc-switch 的部分功能)
三、第一步:注册 DeepSeek 拿 API Key
- 打开 DeepSeek,手机号注册
- 进入「API Keys」→ 点击「创建 API Key」
- 复制生成的 key,格式类似:
sk-xxxxxxxxxxxxxxxx - 右上角「充值」——充值 ¥10 够跑很久,按量扣费
- 记下 API 地址:
- 标准 OpenAI 格式:https://api.deepseek.com/v1
- Anthropic 兼容格式(给 Claude Code 用):https://api.deepseek.com/anthropic
⚠️ 安全提醒:API Key 等于你的钱包,别发群里、别传网盘公开分享、别提交到 git。
泄露后到控制台立刻删除重建。
四、第二步:安装 Claude Code
npm install -g @anthropic-ai/claude-code验证:
claude --version五、第三步:配置 Claude Code 用 DeepSeek
编辑配置文件~/.claude/settings.json(Windows 为C:\Users\你的用户名\.claude\settings.json):
{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥", "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat", "CLAUDE_CODE_ATTRIBUTION_HEADER": "0" } }说明:
-ANTHROPIC_BASE_URL指向 DeepSeek 的 Anthropic 兼容接口,Claude Code 就能直接调 DeepSeek
- 模型名用 DeepSeek 的模型 ID(deepseek-chat/deepseek-reasoner)
- 各_DEFAULT_*_MODEL让 Claude Code 无论要 Opus 还是 Haiku 都走 DeepSeek
重启终端后输入claude,能正常对话即配置成功。
六、第四步:安装 cc-switch 管理多套配置
- 下载 cc-switch(Windows 绿色版):Releases · farion1231/cc-switch · GitHub
- 解压运行,托盘区出现图标
- 打开设置,勾选需要管理的应用(Claude Code / Cursor / Codex / opencode 等)
添加服务商配置
在 cc-switch 里新建 provider,填入:
- 名称:`DeepSeek`
- Base URL:`https://api.deepseek.com/anthropic`(Claude 系)或 `https://api.deepseek.com/v1`(OpenAI 系)
- API Key:你的 DeepSeek key
- 模型:`deepseek-chat` 等
之后在 cc-switch 里一键切换官方 Anthropic / DeepSeek / 其他中转,不用手改配置文件。
七、第五步:接入其他 AI 客户端(可选)
opencode
配置~/.config/opencode/opencode.json:
{ "provider": { "deepseek": { "models": { "deepseek-chat": { "name": "DeepSeek Chat" }, "deepseek-reasoner": { "name": "DeepSeek Reasoner" } }, "npm": "@ai-sdk/openai-compatible", "options": { "apiKey": "sk-你的DeepSeek密钥", "baseURL": "https://api.deepseek.com/v1" } } } }Cursor / Codex
在对应软件的 provider 配置中填 Base URL + Key 即可,原理相同。
八、常见问题
| 问题 | 解决 |
|---|---|
| claude 报 401 / auth error | API Key 填错或已过期,重新生成;确认ANTHROPIC_BASE_URL拼写 |
| 429 / 余额不足 | 去 DeepSeek 控制台充值,或换deepseek-chat更便宜的模型 |
| 速度慢 | 高峰期正常现象;可换deepseek-chat(非 reasoning)提速 |
| 切了 cc-switch 没生效 | 重启 Claude Code / 终端 |
| 想切回官方 Claude | cc-switch 里切换到官方 provider 即可 |
九、macOS / Linux 使用方法
本教程主体按 Windows 编写,macOS / Linux 的配置原理完全相同,差异只在以下几步:
- 安装 Claude Code:同样用
npm install -g @anthropic-ai/claude-code(需先装 Node.js) - 配置文件路径:
~/.claude/settings.json(即/Users/你的用户名/.claude/settings.json或/home/你的用户名/.claude/settings.json),内容与 Windows 版完全一致 - cc-switch:macOS 下载 DMG 版,Linux 需从源码构建(或跳过 cc-switch,直接手改配置文件)
- 一键检查脚本:交付包
脚本工具/下提供了两个脚本,按系统选择:setup-check-windows.bat(Windows,双击运行)setup-check-mac.sh(macOS / Linux)
记得先编辑脚本,把bash setup-check-mac.shsk-REPLACE_WITH_YOUR_DEEPSEEK_KEY换成你的真实 API Key
注意:macOS 上如果
command not found: claude,可能是 npm 全局 bin 目录不在 PATH 中,执行echo $PATH检查,或把$(npm prefix -g)/bin加入 PATH。
免责声明:本教程为技术学习用途。API Key 为各自平台的付费服务,请遵守对应平台服务条款。