零基础教你claude code 接入 deepseek V4

偶像佳沛2026-04-27 9:52

省钱利器：Claude Code + DeepSeek V4，月花费不到100元的AI编程神器

本文手把手教你用 DeepSeek V4 API 接入 Claude Code CLI，实现一个低成本、高质量的 AI 编程助手。全程可复刻，踩坑经验全收录。

前言：为什么我要折腾这个？

作为一名追求性价比的开发者，日常工作离不开 AI 编程助手。

但市面上主流的 AI 编程工具要么订阅费不便宜，要么需要海外信用卡充值，对国内开发者来说多少有点门槛。

于是我开始寻找替代方案，目标很明确：

  • 便宜，最好月花费控制在 100 元以内
  • 好用，代码补全、Bug 分析、架构设计都能搞定
  • 门槛低，国内手机号注册，支付宝充值，不需要折腾虚拟信用卡

研究了一圈之后，我发现了一个黄金组合：Claude Code CLI + DeepSeek V4 API。

Claude Code 是 Anthropic 出品的命令行 AI 编程工具，本身需要 Anthropic 的 API Key（海外信用卡才能充值）。但 DeepSeek 提供了一个与 Anthropic API 完全兼容 的接口，只需要改一下配置文件，Claude Code 就能无缝使用 DeepSeek 的模型------而 DeepSeek 支持国内手机号注册 + 支付宝充值，价格还便宜到离谱。

折腾了一晚上，踩了不少坑，最终跑通了。这篇文章就是我的完整记录，希望能帮到和我一样追求性价比的开发者。

费用对比：到底能省多少钱？

先上大家最关心的------钱。

主流方案 vs Claude Code + DeepSeek V4

对比项 主流AI编程工具（订阅制） Claude Code + DeepSeek V4
月费用 $100~200 / 月（订阅制） ￥50 ~ 200 / 月（按量付费）
注册门槛 通常需要海外账号 国内手机号即可
充值方式 虚拟信用卡 支付宝直接充
模型能力 强 较强（DeepSeek V4 还不错）
使用场景 IDE 内集成 命令行交互，灵活度更高

DeepSeek V4 最新定价（2026年4月）

模型 输入价格 输出价格 适用场景
V4-Flash ¥1/百万token（缓存命中¥0.2） ¥2/百万token 日常编码、简单问答
V4-Pro ¥4/百万token（缓存命中¥1） ¥24/百万token 复杂推理、架构设计

说真的，这个价格对追求性价比的开发者太友好了。日常写代码一天大概消耗几万 token，算下来一天也就几毛钱。即使重度使用，一个月也很难超过 50 块。

前置环境准备

在开始之前，确保你的电脑满足以下条件：

项目 版本要求 说明
操作系统 Windows 10/11 其他系统理论兼容
Shell PowerShell 注意： 不支持 &&，用分号 ; 分隔命令
Node.js ≥ 18.18（推荐 v24.x） 这个版本要求很重要，后面会讲坑
npm 随 Node.js 安装即可 不需要单独装

验证环境

powershell 复制代码 
node --version
# 期望输出: v24.14.0 或更高

npm --version
# 期望输出: 11.9.0 或更高

如果没装 Node.js，去官网下载 LTS 版本：nodejs.org

踩坑记录一：Node.js 版本问题（重要！）

这是我踩的第一个大坑，必须提前说。

Claude Code 要求 Node.js 版本 ≥ 18.18，低于这个版本会直接启动失败。

但问题来了------你手头的项目很可能用的是 Node.js 14.x 或 16.x，直接升级 Node 版本可能会导致现有项目跑不起来。

解决方案：用 nvm 管理多版本 Node.js

powershell 复制代码 
# 安装高版本 Node.js
nvm install 24.14.0

# 需要用 Claude Code 时切换到高版本
nvm use 24.14.0

# 回去写其他项目时切换回低版本
nvm use 14.21.3

小技巧：可以开两个终端，一个用高版本跑 Claude Code，另一个用低版本跑其他项目，互不影响。

注意： nvm 切换 Node 版本后，之前版本安装的全局 npm 包不会自动继承。所以切换到新版本后需要重新 npm install -g @anthropic-ai/claude-code。

第一步：安装 Claude Code CLI

环境没问题之后，一行命令搞定安装：

powershell 复制代码 
npm install -g @anthropic-ai/claude-code

验证安装是否成功：

powershell 复制代码 
claude --version
# 输出类似: 2.1.119 (Claude Code) 即为成功

第二步：获取 DeepSeek API Key

2.1 注册账号

  1. 打开 DeepSeek 开放平台：platform.deepseek.com
  2. 使用国内手机号注册（无需任何海外账号）

2.2 充值余额

  1. 登录后进入控制台
  2. 选择支付宝充值（先充个 10 块钱足够用很久了）

2.3 创建 API Key

  1. 进入 API Keys 页面
  2. 点击 创建 API Key
  3. 复制生成的 Key，格式为：sk-xxxxxxxxxxxx

API Key 只在创建时显示一次！ 请立即复制保存到安全的地方，丢失了只能重新创建。

第三步：配置 Claude Code 接入 DeepSeek

这是最核心的一步。

3.1 原理简述

DeepSeek 提供了一个与 Anthropic API 完全兼容的接口地址：

arduino 复制代码 
https://api.deepseek.com/anthropic

我们只需要修改 Claude Code 的配置文件，把 API 请求地址指向 DeepSeek，Claude Code 就会"以为"自己在调用 Anthropic 的 API，实际上请求都发到了 DeepSeek。

  • 不需要任何中间代理或适配层
  • 完整支持流式输出、函数调用等核心特性

3.2 创建配置目录

powershell 复制代码 
if (-not (Test-Path "$env:USERPROFILE\.claude")) { New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude" -Force }

3.3 写入配置文件

请将 sk-你的DeepSeek API Key 替换为你在上一步获取的真实 API Key！

powershell 复制代码 
$content = @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek API Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}
'@
Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Value $content -Encoding UTF8

3.4 验证配置写入成功

powershell 复制代码 
Get-Content "$env:USERPROFILE\.claude\settings.json"

确认输出内容包含你的 API Key 和 DeepSeek 的 Base URL 即可。

配置参数详解

这里解释一下每个参数的作用，方便你根据自己的需求调整：

参数 值 说明
ANTHROPIC_AUTH_TOKEN sk-你的Key DeepSeek API Key，身份认证用
ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic 关键！ DeepSeek 的 Anthropic 兼容接口
ANTHROPIC_MODEL deepseek-v4-pro 默认使用的模型
ANTHROPIC_DEFAULT_OPUS_MODEL deepseek-v4-pro Opus 级别任务的模型
ANTHROPIC_DEFAULT_SONNET_MODEL deepseek-v4-pro Sonnet 级别任务的模型（主力模型）
ANTHROPIC_DEFAULT_HAIKU_MODEL deepseek-v4-flash Haiku 级别任务的模型（轻量快速）
CLAUDE_CODE_SUBAGENT_MODEL deepseek-v4-flash 子代理使用的模型
CLAUDE_CODE_MAX_OUTPUT_TOKENS 32000 单次回复最大 Token 数

踩坑记录二：模型路由机制（必看！）

这个坑我研究了很久才搞明白。

Claude Code 内部有一个模型路由机制：它会根据任务复杂度自动选择使用 Opus、Sonnet 还是 Haiku 级别的模型。

关键发现：大约 90% 的任务都走 Sonnet 级别，Opus 几乎不会自动触发。

这意味着什么？你配在 ANTHROPIC_DEFAULT_SONNET_MODEL 的模型才是真正的主力模型！

所以我的策略是：

  • Sonnet 位 → deepseek-v4-pro：主力模型，承担绝大部分编码任务
  • Opus 位 → deepseek-v4-pro：少数复杂任务也用 Pro，保证质量
  • Haiku 位 → deepseek-v4-flash：简单任务用 Flash，省钱

踩坑记录三：模型名称变更（别踩旧坑！）

如果你在网上搜到的教程还在用 deepseek-chat 和 deepseek-reasoner，注意了，这些是旧模型名！

旧名称（即将下线） 新名称（推荐使用） 下线时间
deepseek-chat deepseek-v4-pro / deepseek-v4-flash 2026年7月24日
deepseek-reasoner deepseek-v4-pro 2026年7月24日

注意： 旧模型名将在 2026年7月24日 正式下线，之后使用旧名称会直接报错。建议现在就用新名称，避免到时候突然不能用。

踩坑记录四：Windows PowerShell 的 && 问题

这个坑比较小但很烦人。

如果你习惯在 Linux/Mac 上用 && 连接命令，在 Windows PowerShell 里会直接报错：

powershell 复制代码 
# 这样会报错
cd C:\my-project && claude

# 正确写法：用分号分隔
cd C:\my-project; claude

第四步：启动 Claude Code

配置完成，激动人心的时刻到了！

powershell 复制代码 
claude

首次启动引导

首次启动会出现几个引导步骤：

  1. 选择主题 → 推荐选择 Dark mode（程序员标配）
  2. 信任工作目录 → 选择 Yes, I trust this folder
  3. 完成后进入交互式命令行界面

验证接入成功

在交互界面中随便输入一个问题：

复制代码 
你好，请介绍一下你自己

如果能正常回复，恭喜你，DeepSeek API 已成功接入！

如果报错，排查清单：

  1. API Key 是否正确粘贴（注意有没有多余空格）
  2. DeepSeek 账户余额是否充足
  3. 网络是否正常（试试 ping api.deepseek.com）
  4. 配置文件路径是否正确：$env:USERPROFILE\.claude\settings.json

安全提醒

配置文件里包含了你的 API Key，千万不要上传到公开的 Git 仓库！

在项目的 .gitignore 中加上：

复制代码 
.claude/

完整命令速查表

如果你不想看前面的解释，直接按下面的命令一步步执行就行：

powershell 复制代码 
# 1. 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 2. 验证安装
claude --version

# 3. 创建配置目录
if (-not (Test-Path "$env:USERPROFILE\.claude")) { New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude" -Force }

# 4. 写入配置文件（替换 sk-你的DeepSeek API Key 为真实 Key）
$content = @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek API Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}
'@
Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Value $content -Encoding UTF8

# 5. 验证配置
Get-Content "$env:USERPROFILE\.claude\settings.json"

# 6. 启动
claude

总结

优点 缺点
月花费极低 命令行交互，没有 GUI（习惯就好）
国内手机号注册，支付宝充值 需要一点配置门槛
DeepSeek V4 模型能力够强 偶尔响应速度不如原生 API
按量付费，不用不花钱 需要 Node.js ≥ 18.18
配置一次，永久使用

对于追求性价比的开发者来说，这个方案真的是目前最优解。DeepSeek V4 的代码能力不弱，日常写业务代码、Debug、甚至做架构分析都完全够用。

相关推荐
redreamSo1 小时前
HeyGen 开源了一个"用 HTML 写视频"的框架，我研究了一下，发现事情没那么简单
前端·开源·音视频开发
GISer_Jing2 小时前
前端视角：AI正在重构B端产品，传统配置化开发终将被取代？
前端·人工智能
月月大王的3D日记2 小时前
告别“死视角”——手把手给你的 3D 世界装上灵活相机
javascript
We་ct2 小时前
LeetCode 63. 不同路径 II：动态规划解题详解
前端·算法·leetcode·typescript·动态规划
布局呆星2 小时前
Vue3+TS封装Axios请求全攻略
前端·javascript·ajax·typescript
kyriewen2 小时前
React Diff算法：3个“神级假设”让虚拟DOM快得像闪电
前端·react.js·面试
小小前端_我自坚强2 小时前
React 技术笔记梳理
前端·react.js
小小前端_我自坚强2 小时前
React 核心技术深度笔记
前端·javascript·react.js
Pkmer2 小时前
古法编程: SPA的路由浅思考
前端
热门推荐
01GitHub 镜像站点02近期有什么ai的新消息，新动态？ 2026.4月032026年4月AI大事件深度解读：大模型竞争进入“深水区“042026年AI前瞻：量子AI、具身智能与科学发现的新纪元052026年4月技术前沿：AI大模型爆发、智能体革命与量子安全新纪元06codex app每次打开重连5次Reconnecting问题解决072026年AI编程工具终极横评：Cursor vs Claude Code vs Copilot08AI Weekly | 2026年4月第二周 · GitHub热门项目与AI发展趋势深度解析09DeepSeek V4 全面解析：测评、对比、案例及实操指南10在 OpenCode 中快速启用 DeepSeek V4 模型