DeepSeek + cc-switch + Claude Code 全套配置教程
2026/8/11 5:56:47 网站建设 项目流程

相关工具放到夸克网盘了 链接: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 CodeAnthropic 出品的终端 AI 编程助手工具本身免费用,模型走你的 DeepSeek

一句话:用 Claude Code 的交互体验 + DeepSeek 的价格,一套配置,随时切换。


二、准备清单

  1. 一台 Windows / macOS / Linux 电脑
  2. Node.js 18+(Claude Code 需要)→ Node.js — Run JavaScript Everywhere
  3. 手机号(注册 DeepSeek 用)
  4. 阿里云账号(可选,仅用 cc-switch 的部分功能)

三、第一步:注册 DeepSeek 拿 API Key

  1. 打开 DeepSeek,手机号注册
  2. 进入「API Keys」→ 点击「创建 API Key」
  3. 复制生成的 key,格式类似:sk-xxxxxxxxxxxxxxxx
  4. 右上角「充值」——充值 ¥10 够跑很久,按量扣费
  5. 记下 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 管理多套配置

  1. 下载 cc-switch(Windows 绿色版):Releases · farion1231/cc-switch · GitHub
  2. 解压运行,托盘区出现图标
  3. 打开设置,勾选需要管理的应用(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 errorAPI Key 填错或已过期,重新生成;确认ANTHROPIC_BASE_URL拼写
429 / 余额不足去 DeepSeek 控制台充值,或换deepseek-chat更便宜的模型
速度慢高峰期正常现象;可换deepseek-chat(非 reasoning)提速
切了 cc-switch 没生效重启 Claude Code / 终端
想切回官方 Claudecc-switch 里切换到官方 provider 即可

九、macOS / Linux 使用方法

本教程主体按 Windows 编写,macOS / Linux 的配置原理完全相同,差异只在以下几步:

  1. 安装 Claude Code:同样用npm install -g @anthropic-ai/claude-code(需先装 Node.js)
  2. 配置文件路径~/.claude/settings.json(即/Users/你的用户名/.claude/settings.json/home/你的用户名/.claude/settings.json),内容与 Windows 版完全一致
  3. cc-switch:macOS 下载 DMG 版,Linux 需从源码构建(或跳过 cc-switch,直接手改配置文件)
  4. 一键检查脚本:交付包脚本工具/下提供了两个脚本,按系统选择:
    • setup-check-windows.bat(Windows,双击运行)
    • setup-check-mac.sh(macOS / Linux)
      bash setup-check-mac.sh
      记得先编辑脚本,把sk-REPLACE_WITH_YOUR_DEEPSEEK_KEY换成你的真实 API Key

注意:macOS 上如果command not found: claude,可能是 npm 全局 bin 目录不在 PATH 中,执行echo $PATH检查,或把$(npm prefix -g)/bin加入 PATH。


免责声明:本教程为技术学习用途。API Key 为各自平台的付费服务,请遵守对应平台服务条款。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询