如何在Claude Code中接入DeepSeek V4模型：详细配置指南（省50%以上的API费用）

如何在Claude Code中接入DeepSeek V4模型：详细配置指南（省50%以上的API费用）

Claude Code 默认用 Anthropic 自家的 Claude 模型，能力强但价格不菲。DeepSeek V4 是国产最强开源模型之一，API 价格仅为 Claude Sonnet 的十分之一。本文教你如何把 DeepSeek V4 “塞进” Claude Code，日常编程用便宜的，复杂任务才用贵的，综合成本暴降 50%-90%！

一、为什么要接入 DeepSeek V4？

价格对比（一目了然）

模型	输入价格 (每百万token)	输出价格 (每百万token)	每天用10万token的输出成本
Claude Opus 4	$15	$75	$7.5
Claude Sonnet 4	$3	$15	$1.5
Claude Haiku 4	$0.80	$4	$0.4
DeepSeek V4	约 ¥1 (≈$0.14)	约 ¥4 (≈$0.55)	≈¥0.4 (≈$0.055)

注意：价格可能更新，请以各平台官网最新定价为准。

也就是说，同样每天产出 10 万 token 代码，用 DeepSeek V4 的成本是 Claude Sonnet 的 1/30！

DeepSeek V4 的能力如何？

• ✅ 代码生成能力接近 Claude Sonnet 4 和 GPT-4.1
• ✅ 中文理解非常强（国产模型的天然优势）
• ✅ 支持超长上下文（128K-1M token）
• ⚠️ 在极复杂的架构设计、代码审查方面略逊于 Claude Opus 4
• ⚠️ 推理速度可能比 Claude 稍慢（取决于服务器负载）

结论：日常编程用 DeepSeek V4 完全够用，遇到复杂任务再切回 Claude。

---

二、获取 DeepSeek API Key

步骤 1：注册 DeepSeek 开放平台

打开 https://platform.deepseek.com

点击右上角”注册”（用手机号或邮箱都可以）

完成实名认证（国内平台要求，一般几分钟搞定）

步骤 2：充值并获取 API Key

登录后进入控制台 → “API Keys”

点击 “创建 API Key”

⚠️ 立即复制保存！ 格式类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

在”概览”页面充值（建议先充 10-50 元试试水，非常耐用）

DeepSeek 的费用参考

• 最低充值：一般是 1-10 元
• 普通用户一个月编程：约 10-50 元
• 重度用户（全日代码生成）：可能 50-200 元/月

DeepSeek 新用户经常有免费额度赠送，注册时留意活动公告。

---

三、在 Claude Code 中配置自定义模型提供商

这是本文的核心。Claude Code 支持通过环境变量来配置第三方模型提供商。

方法一：通过 settings.json 配置（推荐，Claude Code v1.0+）

Claude Code 从某个版本开始支持在 settings.json 中配置自定义 provider。

1. 找到 Claude Code 的配置文件位置：

# 在终端中运行，查看配置路径
claude --config-path

一般位置：

• Windows: C:\Users\你的用户名\.claude\settings.json
• Mac/Linux: ~/.claude/settings.json

2. 编辑 settings.json，添加 DeepSeek provider：

{
  "modelProviders": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com/v1",
      "apiKey": "sk-你的DeepSeek密钥",
      "models": [
        {
          "id": "deepseek-chat",
          "name": "DeepSeek V4",
          "contextWindow": 128000,
          "maxOutputTokens": 8192
        }
      ]
    }
  }
}

3. 在 Claude Code 中使用：

# 指定使用 DeepSeek 模型启动
claude --model deepseek/deepseek-chat

或者启动后在对话中输入：

/model deepseek/deepseek-chat

方法二：通过环境变量配置（兼容所有版本）

如果 settings.json 方式不生效，使用环境变量方式更可靠：

Windows (PowerShell)：

# 设置自定义 API 地址和 Key
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
$env:ANTHROPIC_API_KEY="sk-你的DeepSeek密钥"

然后启动
claude

Mac/Linux：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-你的DeepSeek密钥"
claude

永久配置（Windows）：

Win+R → sysdm.cpl → 高级 → 环境变量

新建：ANTHROPIC_BASE_URL = https://api.deepseek.com/v1

修改 ANTHROPIC_API_KEY 为你的 DeepSeek Key

重启终端

永久配置（Mac/Linux）：

echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-你的DeepSeek密钥"' >> ~/.zshrc
source ~/.zshrc

⚠️ 注意：这种方式会覆盖默认的 Anthropic API 地址，所以 Claude Code 的所有请求都会走 DeepSeek。如果你想同时保留两个模型，建议用方法一（settings.json）。

方法三：使用 LiteLLM 代理（最灵活，进阶推荐）

LiteLLM 是一个开源代理，能让你同时接入多个模型提供商，随时切换。

1. 安装 LiteLLM：

pip install litellm

2. 创建配置文件 litellm_config.yaml：

model_list:
  - model_name: deepseek-v4
    litellm_params:
      model: deepseek/deepseek-chat
      api_key: sk-你的DeepSeek密钥
  - model_name: claude-sonnet
    litellm_params:
      model: claude-sonnet-4-20250514
      api_key: sk-ant-你的Anthropic密钥

3. 启动代理：

litellm --config litellm_config.yaml --port 4000

4. 在 Claude Code 中指向代理：

export ANTHROPIC_BASE_URL="http://localhost:4000"
claude --model deepseek-v4

这样你就能同时使用 DeepSeek 和 Claude，随时切换，互不干扰。

---

四、验证配置是否生效

启动 Claude Code 后，可以这样验证：

方法 1：直接问 AI

你现在用的是什么模型？

如果返回提到 “DeepSeek”，说明配置成功。

方法 2：检查控制台

在 DeepSeek 开放平台的”用量监控”页面，如果看到有 API 调用记录，说明请求确实到了 DeepSeek。

方法 3：测试代码生成

帮我写一个冒泡排序的 Python 函数，加详细注释

如果正常生成代码，说明配置完全正常。

---

五、最佳实践：双模型搭配策略

接入 DeepSeek 后，最高效的方式是根据任务类型切换模型：

用 DeepSeek V4 处理的任务（日常主力）

• ✅ 写常规业务代码（CRUD、API 接口等）
• ✅ 代码格式化和重构
• ✅ 生成注释和文档
• ✅ 写单元测试
• ✅ 解释代码逻辑
• ✅ 翻译和技术问答
• ✅ 生成 SQL 查询
• ✅ 写脚本和自动化工具

用 Claude Sonnet/Opus 处理的任务（关键时刻）

• 🔑 复杂的系统架构设计
• 🔑 多文件大型重构
• 🔑 难以定位的 bug 排查
• 🔑 安全审查和性能优化
• 🔑 需要极强逻辑推理的任务

切换模型快捷命令

# 启动时指定模型
claude --model deepseek/deepseek-chat    # 日常用 DeepSeek
claude --model claude-sonnet-4            # 复杂任务用 Sonnet

对话中切换（在 Claude Code 界面内）
/model deepseek/deepseek-chat
/model claude-sonnet-4

---

六、常见问题与排查

Q1: 配置后 Claude Code 报 “Invalid API Key” ？

原因：Claude Code 默认连接 Anthropic 服务器验证 Key，你用 DeepSeek Key 当然无效。

解决：确保设置了 ANTHROPIC_BASE_URL 指向 https://api.deepseek.com/v1（或用 settings.json 的 modelProviders 方式）。

Q2: DeepSeek 返回错误 “model not found” ？

检查以下几点：

模型名称是否正确：目前应该是 deepseek-chat（对应 V4）

你的 DeepSeek 账号是否有该模型的访问权限

API endpoint URL 是否正确：https://api.deepseek.com/v1（注意有 /v1）

Q3: DeepSeek 的回复质量不如 Claude？

这是正常的。DeepSeek V4 在大多数场景接近 Sonnet 水平，但在部分复杂推理任务上确有差距。建议：

• 把问题描述得更详细具体
• 给更多上下文信息
• 复杂任务直接切到 Claude Sonnet/Opus

Q4: 能不能同时配置多个 DeepSeek Key 做负载均衡？

可以。用 LiteLLM 方案（方法三），在 litellm_config.yaml 里配置多个相同的模型指向不同 Key，LiteLLM 会自动轮询。

Q5: 环境变量和 settings.json 哪个优先级更高？

settings.json 中的 modelProviders 配置优先级更高。但环境变量 ANTHROPIC_BASE_URL 如果直接指向 DeepSeek，会绕开 modelProviders，所有流量都走 DeepSeek。

Q6: DeepSeek API 稳定吗？

目前 DeepSeek API 服务整体稳定，但高峰期可能有延迟。如果遇到 429（限流）或 503（服务不可用）错误，等几分钟重试即可。

---

七、总结

接入 DeepSeek V4 后，你的 AI 编程成本结构会变成：

之前：100% Claude = 贵
之后：80% DeepSeek + 20% Claude = 省 80%+

关键配置参数速查：

• API 地址: https://api.deepseek.com/v1
• 模型名称: deepseek-chat
• 配置文件: ~/.claude/settings.json 或环境变量

下一步可以做什么：

• 📖 学习 Claude Code Effort 设置（控制生成质量和成本）
• 🔄 了解如何在 Codex 中也接入 DeepSeek
• ⚖️ 对比 Claude Code vs Codex，选择最适合你的工具

有什么问题评论区留言，我们一起研究！

---

免责声明：本文基于 2025 年 6 月的信息撰写，API 价格、功能可能变化。DeepSeek 平台的定价和政策请以 platform.deepseek.com 为准。本文由作者实测验证后撰写，AI 辅助编辑。