零基础教你 claude code 接入 deepseek V4

零基础教你 claude code 接入 deepseek V4
省钱利器：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 安装即可 不需要单独装
验证环境
bash
运行
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
bash
运行

安装高版本 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
环境没问题之后，一行命令搞定安装：
bash
运行
npm install -g @anthropic-ai/claude-code
验证安装是否成功：
bash
运行
claude --version

输出类似: 2.1.119 (Claude Code) 即为成功

第二步：获取 DeepSeek API Key
2.1 注册账号
打开 DeepSeek 开放平台：platform.deepseek.com
使用国内手机号注册（无需任何海外账号）
2.2 充值余额
登录后进入控制台
选择支付宝充值（先充个 10 块钱足够用很久了）
2.3 创建 API Key
进入 API Keys 页面
点击 创建 API Key
复制生成的 Key，格式为：sk-xxxxxxxxxxxx
API Key 只在创建时显示一次！ 请立即复制保存到安全的地方，丢失了只能重新创建。
第三步：配置 Claude Code 接入 DeepSeek
这是最核心的一步。
3.1 原理简述
DeepSeek 提供了一个与 Anthropic API 完全兼容的接口地址：
plaintext
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
配置完成，激动人心的时刻到了！
bash
运行
claude
首次启动引导
首次启动会出现几个引导步骤：
选择主题 → 推荐选择 Dark mode（程序员标配）
信任工作目录 → 选择 Yes, I trust this folder
完成后进入交互式命令行界面
验证接入成功
在交互界面中随便输入一个问题：
plaintext
你好，请介绍一下你自己
如果能正常回复，恭喜你，DeepSeek API 已成功接入！
如果报错，排查清单：
API Key 是否正确粘贴（注意有没有多余空格）
DeepSeek 账户余额是否充足
网络是否正常（试试 ping api.deepseek.com）
配置文件路径是否正确：$env:USERPROFILE.claude\settings.json
安全提醒
配置文件里包含了你的 API Key，千万不要上传到公开的 Git 仓库！
在项目的 .gitignore 中加上：
plaintext
.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、甚至做架构分析都完全够用。
Koala 使用推荐
想要进一步压低 AI 编程调用成本、不用逐个适配多模型接口，直接用 Koala 就很合适。它兼容 Claude Code 接口协议，一键替换配置地址即可无缝接入，整合了 DeepSeek、Claude 等多款大模型，价格更有优势，个人开发者和小团队日常编程调用、批量开发都能省心又省钱。