DeepSeek V4 接入 Claude Code 完整教程（CC Switch 篇）

一、方案概述

通过 CC Switch 桌面工具，将 DeepSeek V4 替代 Anthropic 官方模型接入 Claude Code，实现模型层的平替。DeepSeek V4 完全兼容 Anthropic Messages API 协议，工具调用、子代理、上下文缓存等特性均可正常使用。

核心优势：成本降至官方的约 1/50，日常编码一天约花费 ¥3~¥8。

架构示意：

Claude Code（AI 编程 CLI）      │      ▼ CC Switch（模型路由/切换 GUI）      │      ▼ DeepSeek API（https://api.deepseek.com/anthropic）      │      ▼ deepseek-v4-pro / deepseek-v4-flash

二、前置准备

组件	要求	说明
操作系统	Windows 10/11 或 macOS	本教程以 Windows 为主
Node.js	≥ v18（推荐 v20 LTS 或 v22）	Claude Code 运行环境
Git	需安装	Claude Code 依赖
DeepSeek 账号	注册并充值 ≥ ¥5	免费额度不可用于 V4 系列
Claude Code	最新版	npm install -g @anthropic-ai/claude-code

三、安装 Claude Code

3.1 安装 Node.js（如已安装可跳过）

前往 nodejs.org 下载 LTS 版本（推荐 v20 或 v22），双击安装，全部默认即可。

验证安装：

node --version    # 应显示 v20.x.x 或 v22.x.x npm --version

3.2 安装 Claude Code

# npm 全局安装（推荐） npm install -g @anthropic-ai/claude-code # 或者使用 winget（Windows） winget install Anthropic.ClaudeCode # 验证安装 claude --version

注意：如果 claude 命令找不到，检查 npm 全局路径是否在系统 PATH 中。
运行 npm config get prefix 查看全局安装路径，将其加入环境变量 PATH。

四、获取 DeepSeek API Key

4.1 注册并充值

1. 访问 DeepSeek API 开放平台

2. 注册账号（支持手机号/邮箱）

3. 充值至少 ¥5（重要：免费体验金不可用于 V4 系列模型）

4. 新用户通常赠送 ¥10 体验金，可用于测试

4.2 创建 API Key

1. 登录后进入 API Keys 管理页面

2. 点击 创建 API Key，填写名称（如 claude-code）

3. 复制生成的 sk- 开头的密钥，妥善保存，只显示一次

五、安装 CC Switch（重点）

5.1 下载安装

CC Switch 是由社区开发的开源桌面 GUI 工具，用于为 Claude Code 等 AI CLI 工具一键切换后端模型供应商。

• **GitHub 仓库**：https://github.com/farion1231/cc-switch

• **当前稳定版**：v3.14.1

完整地址：https://github.com/farion1231/cc-switch/releases

安装步骤：

1. 打开 CC Switch Releases 页面

2. 下载对应系统的安装包：

• Windows → `cc-switch-v3.14.1.msi`（或最新版本）

• macOS → `cc-switch-v3.14.1.dmg`

3. Windows 用户双击 .msi 文件，一路 Next 完成安装

4. 安装完成后，桌面会出现 CC Switch 图标，双击启动

5.2 添加 DeepSeek 供应商

启动 CC Switch 后，按以下步骤配置：

步骤 1：新建供应商

点击 "添加供应商" 或 "+" 按钮，选择 DeepSeek。

步骤 2：填写配置参数

配置项	填写值	说明
供应商名称	DeepSeek	自定义，方便识别
Base URL	https://api.deepseek.com/anthropic	DeepSeek 的 Anthropic 兼容端点
认证类型	ANTHROPIC_AUTH_TOKEN	⚠️ 务必选此项，不是 API_KEY
API Key	sk-xxxxxxxx	第四步获取的密钥
API 格式	Anthropic Messages（原生）	DeepSeek 原生支持 Anthropic 格式

步骤 3：模型映射

模型槽	映射模型	说明
主模型 (Default)	deepseek-v4-pro[1m]	1M 超大上下文，主力推理模型
Opus	deepseek-v4-pro[1m]	对应 Claude Code 的 Opus 模型请求
Sonnet	deepseek-v4-pro[1m]	对应 Claude Code 的 Sonnet 模型请求
Haiku	deepseek-v4-flash	轻量快速模型，适合作子代理
子代理模型 (Sub-agent)	deepseek-v4-flash	子任务执行，节省 token

步骤 4：保存并启用

点击 保存，然后勾选启用 DeepSeek 供应商。

5.3 模型映射策略解释

Claude Code 内部模型槽          →    DeepSeek 实际模型 ───────────────────────────────────────────────────────── Opus（默认，重量级推理）         →    deepseek-v4-pro (1M 上下文) Sonnet（中等复杂度）              →    deepseek-v4-pro (1M 上下文) Haiku（轻量级，快速响应）         →    deepseek-v4-flash (低延迟) Sub-agent（子代理子任务）         →    deepseek-v4-flash (高性价比)

为什么 Opus 和 Sonnet 都映射到 v4-pro？
因为 DeepSeek V4 的主力模型就是 deepseek-v4-pro，它足以胜任 Claude Code 中 Opus 和 Sonnet 的全部场景。日常编码用 v4-pro，高频轻量操作用 v4-flash，兼顾能力和成本。

六、关键配置详解

6.1 `[1m]` 后缀说明

[1m] 是 Claude Code 的 1M（100 万）上下文窗口标记：

情况	模型名	实际上下文
带 [1m]	deepseek-v4-pro[1m]	100 万 token
不带 [1m]	deepseek-v4-pro	约 20 万 token

推荐：直连模式下（非 CC Switch 代理模式）务必加上 [1m]，充分利用大上下文优势。

6.2 CC Switch 本地路由模式的陷阱（⚠️ 重要）

如果你开启了 CC Switch 的本地路由/代理模式，则模型中 不要加 `[1m]` 后缀。

原因：代理模式下 CC Switch 会把 deepseek-v4-pro[1m] 当作完整模型名原样转发给 DeepSeek API，而 DeepSeek 不认识带 [1m] 的模型名，会静默回退到 `deepseek-v4-flash`，导致能力大幅下降。

解决办法（代理模式）：

{  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro",  "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",  "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro" }

主模型/ANTHROPIC_MODEL/Default model 留空，让 Claude Code 自己负责 1M 上下文逻辑。

6.3 开启深度思考（Thinking）

如果需要更强的推理能力，可以在模型名后追加 [thinking]：

deepseek-v4-pro[1m][thinking]

启动 Claude Code 后，可以使用 /think 命令切换深度思考模式。

七、验证配置

7.1 启动 Claude Code

# 在项目目录中启动 cd your-project claude

7.2 确认模型切换成功

启动后终端会显示当前使用的模型：

Powered by deepseek-v4-pro · API Usage Billing

如果看到 deepseek-v4-pro 而非 claude-sonnet-4-6，说明配置成功。

7.3 常用命令检查

/model          # 查看当前使用的模型 /status         # 查看当前会话状态 /think          # 切换深度思考模式 /fast           # 切换快速模式 /effort max     # 设置最高推理等级

7.4 简单功能测试

# 在 Claude Code 对话中输入 > 写一个 Python 函数，计算斐波那契数列前 N 项，并添加类型注解

如果能正常返回带类型注解的代码，说明接入成功。

八、手动配置方案（备选）

如果不想使用 CC Switch GUI，也可以直接通过环境变量或配置文件接入。

8.1 环境变量方式（临时生效）

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥" $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:API_TIMEOUT_MS="3000000" $env:CLAUDE_CODE_EFFORT_LEVEL="max"

macOS / Linux：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的密钥 export ANTHROPIC_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export API_TIMEOUT_MS=3000000 export CLAUDE_CODE_EFFORT_LEVEL=max

8.2 settings.json 方式（持久生效）

编辑 %USERPROFILE%\.claude\settings.local.json（Windows）或 ~/.claude/settings.json（macOS/Linux）：

{  "env": {    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",    "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",    "API_TIMEOUT_MS": "3000000",    "CLAUDE_CODE_EFFORT_LEVEL": "max"  },  "model": "deepseek-v4-pro" }

两种方案对比：

>

| | CC Switch GUI | 手动环境变量/settings.json |
|---|---|---|
| 操作难度 | 低（图形化界面） | 中（需编辑配置文件） |
| 多供应商切换 | 一键切换 | 需手动修改配置 |
| 健康检查 | 内置 | 需手动 curl 测试 |
| 适用场景 | 经常切换模型的用户 | 固定使用 DeepSeek 的用户 |

九、成本分析

9.1 DeepSeek V4 官方定价（2026 年 5 月）

计费项	价格
输入（缓存命中）	¥0.02 / 百万 tokens
输入（缓存未命中）	¥1~12 / 百万 tokens（有限时折扣）
输出	¥2~24 / 百万 tokens（有限时折扣）

9.2 与 Anthropic 官方对比

使用强度	Anthropic Max 方案	DeepSeek V4	节省比例
轻度（10 天/月）	$200/月（封顶）	~¥140/月（约 $20）	~90%
重度（25 天/月）	$200/月（封顶）	~¥350/月（约 $50）	~75%
自动化循环	$200/月（封顶）	~¥560/月（约 $80）	~60%

9.3 省钱技巧

• **上下文缓存**：DeepSeek 支持自动上下文缓存，首次请求后系统提示和文件上下文被缓存，后续轮次成本降低约 120 倍

• **子代理用 Flash**：将 `CLAUDE_CODE_SUBAGENT_MODEL` 设为 `deepseek-v4-flash`，子任务成本极低

• **会话管理**：定期清理历史上下文，避免无效 token 消耗

十、常见问题排查

问题	可能原因	解决方案
claude 命令找不到	npm 全局路径不在 PATH 中	npm config get prefix 查看路径，加入系统 PATH
401 Unauthorized	API Key 错误或余额不足	检查 Key 是否正确；确认账户已充值 ≥ ¥5
响应极慢/超时	推理任务复杂，默认超时不够	设置 API_TIMEOUT_MS=3000000（约 50 分钟）
模型退化到 Flash	CC Switch 代理模式下带了 [1m] 后缀	去掉模型名中的 [1m] 后缀
图片无法识别	DeepSeek V4 当前不支持视觉输入	图片任务临时切回 Anthropic 原生 API
thinking 模式报错	模型名后缀格式不正确	使用 deepseek-v4-pro[1m][thinking] 格式
CC Switch 无法启动	被杀毒软件拦截	添加信任白名单；或以管理员身份运行

十一、重要限制与注意事项

11.1 不支持图片/视觉输入（最大限制）

DeepSeek V4 当前是纯文本模型，不支持图片、截图、UI 设计稿等视觉输入。在 Claude Code 中发送图片时，模型只会收到 [Image #1] 占位符，无法解析任何图像内容。

影响范围：

• 截图报错分析

• UI 设计稿转代码

• 终端截图排查

• 报表渲染结果诊断

解决方案：需要图片交互时，在 CC Switch 中临时切换回 Anthropic 官方供应商。

11.2 其他注意事项

• **超长任务**：建议分阶段执行，避免单一会话上下文过载

• **专业任务**：使用 `/effort max` 保证推理深度

• **认证类型**：务必选 `ANTHROPIC_AUTH_TOKEN`，不是 `API_KEY`（最常见配置错误）

十二、快速检查清单

配置完成后，逐项确认：

☐ Node.js ≥ v18 已安装

☐ Claude Code 已安装且 `claude --version` 正常

☐ DeepSeek API Key 已获取，账户余额 ≥ ¥5

☐ CC Switch 已安装并启动

☐ Base URL 填写 `https://api.deepseek.com/anthropic`

☐ 认证类型选择 `ANTHROPIC_AUTH_TOKEN`

☐ API 格式选择 `Anthropic Messages（原生）`

☐ 模型映射已正确配置（pro 用于 Opus/Sonnet，flash 用于 Haiku/子代理）

☐ CC Switch 中已勾选启用 DeepSeek 供应商

☐ 启动 `claude` 后终端显示 `deepseek-v4-pro`

☐ 简单对话测试通过

参考资源

• [CC Switch GitHub 仓库](https://github.com/farion1231/cc-switch)

• [DeepSeek API 官方文档 - 接入 Agent 工具](https://api-docs.deepseek.com/zh-cn/guides/coding_agents)

• [DeepSeek API 开放平台](https://platform.deepseek.com)

• [Claude Code 官方文档](https://docs.anthropic.com/en/docs/claude-code)