用 cc-switch 让 Claude Code 用上 DeepSeek，10 分钟搞定。

前置准备

  • Windows 10+（Mac / Linux 也行，下文标注差异）
  • Node.js 18+
  • Git for Windows（Windows 必装）
  • DeepSeek 账号
  • 能访问 GitHub

1. 装 Node.js

下载 nodejs.org LTS 版，默认安装。

新开终端验证：

Shell
node -v
npm -v

2. 装 Git for Windows

下载 git-scm.com，默认安装。

Shell
git --version

3. 装 Claude Code

Shell
npm install -g @anthropic-ai/claude-code
claude --version

首次启动若引导登录 Anthropic 官方账号，按 Esc 跳过。

4. 拿 DeepSeek API Key

  1. 打开 platform.deepseek.com/api_keys 登录
  2. 「API Keys」→「创建 API Key」
  3. 创建后立刻复制保存（只显示一次，关页就没了）

5. 装 cc-switch

官网 ccswitch.io，源码 farion1231/cc-switch，完全免费，任何收费的"cc-switch"都是假冒。

到 Releases 下载：

  • Windows：.msi（推荐）或 Portable.zip
  • macOS：.dmg（或 brew install --cask cc-switch）
  • Linux：.deb / .rpm / .AppImage

双击安装。v3.19 起更新走镜像，GitHub 不通也能升级。

6. 添加 DeepSeek 供应商

  1. 打开 cc-switch，左侧选 Claude Code
  2. 点右上角 +
  3. 预设下拉框选 DeepSeek
  4. 粘贴 API Key，点「添加」

预设已填好请求地址 https://api.deepseek.com/anthropic。若预设里没有 DeepSeek，选「自定义」，配置填：

JSON
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "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_AUTO_COMPACT_WINDOW": "786432"
  }
}

认证字段用 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 都行。API 格式选「Anthropic Messages（原生）」。

7. 启用供应商

在供应商列表点 DeepSeek 卡片的「启用」。

若 Claude Code 还弹登录引导：cc-switch「设置 → 通用」勾选「跳过 Claude Code 初次安装确认」，重启 Claude Code。

8. 验证

新开终端：

Shell
cd 你的项目目录
claude

随便问一句，正常回复就通了。输入 /status 可确认端点是 api.deepseek.com。

以后切换

  • 主界面点其他供应商卡片「启用」
  • 或右键托盘 cc-switch 图标，菜单里直接选

切换后关掉 claude 重开才生效（已启动的会话不重读配置）。

常见问题

claude 命令找不到：新开终端；还不行重装 Node。

一启动就弹登录界面：勾「跳过 Claude Code 初次安装确认」，重启。

401 / 403：检查 API Key——粘贴不完整、末尾带空格换行、余额用完、填错字段。

连接失败：请求地址必须写成 https://api.deepseek.com/anthropic，末尾别加斜杠，别用 https://api.deepseek.com 或 /v1。

切换没生效：关掉 claude 重跑一次。

Mac / Linux 差异：配置文件在 ~/.claude/settings.json，其余步骤一致。VSCode Extension 用户把设置项 claudeCode.disableLoginPrompt 勾上。

阅读进度 0%