Claude Code接入DeepSeek的保姆级教程

Claude Code 好用，但 Claude API 太贵。一个月干下来 200 刀就没了。换 DeepSeek 之后，我上个月只花了 9 块 7。功能基本没差别。

先说为什么

Claude Code 是我用过的 AI 编程工具里最聪明的。它不像 Copilot 那样只做补全，也不像 Cursor 那样在编辑器里聊天。它是一个能在终端里跟你对话、读写你的文件、帮你跑命令的 AI 程序员。

但有个问题——贵。

Anthropic 的 API 按 token 计费。如果你重度使用，一个月 200 美元轻松花完。对于个人开发者来说，这笔钱够买好几个域名加一台服务器了。

DeepSeek 的 API 价格大概是 Claude 的 1/20。而且从 V4 开始，DeepSeek 提供了 Anthropic 兼容接口——也就是说，你改几个环境变量的值，Claude Code 就直接跑在 DeepSeek 上了，体验完全一样。

这事操作起来比我预想的简单得多。

准备工作

你需要的东西：

• Claude Code 已安装（npm install -g @anthropic-ai/claude-code）
• DeepSeek API Key 一个，去 platform.deepseek.com 注册就有
• Node.js 18+

没了。

DeepSeek 的 API 是预充值模式。先充个 50 块钱够用一两个月，用完了再充。不像 Claude，月底收到账单才发现花超了。

方法一：设置环境变量（最简单）

这是最直接的方式。打开终端，执行这几行：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的deepseek-api-key"
unset ANTHROPIC_API_KEY
export ANTHROPIC_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"

然后直接跑 claude 就行。

如果你不想每次开终端都设一遍，把这堆 export 加到你的 ~/.bashrc 或 ~/.bash_profile 里。

Windows 用户用 set 代替 export，或者在 PowerShell 里用 $env:ANTHROPIC_BASE_URL="..." 这种写法。

为什么要把三个模型都设成同一个？

Claude Code 内部对不同任务会调用不同的模型（Sonnet 写代码、Haiku 做简单任务）。DeepSeek 目前只有一个主要模型，所以全部指向 deepseek-v4-pro。把 Haiku 指向 deepseek-v4-flash 可以省点钱——简单任务用便宜模型，没必要上 Pro。

方法二：配置文件法（更可靠）

环境变量法有个问题——如果你同时用 Anthropic 官方 API 和其他第三方服务，环境变量会冲突。配置文件法把配置隔离起来，互不干扰。

创建一个 JSON 文件，比如 ~/.config/claude-deepseek.json：

{
  "env": {
    "CLAUDE_CODE_USE_VERTEX": "",
    "ANTHROPIC_VERTEX_PROJECT_ID": "",
    "CLOUD_ML_REGION": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的deepseek-api-key",
    "ANTHROPIC_API_KEY": "sk-你的deepseek-api-key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "API_TIMEOUT_MS": "3000000"
  },
  "model": "deepseek-v4-pro"
}

运行的时候加两个参数：

claude --bare --settings ~/.config/claude-deepseek.json --model sonnet "你的需求"

--bare 的作用是跳过 OAuth 登录和 keychain 检测，避免认证冲突。--model sonnet 传的是 Claude Code 能识别的模型名，到了 DeepSeek 服务端会自动映射成 V4 模型。

你也可以给这条命令设个别名：

alias deepclaude='claude --bare --settings ~/.config/claude-deepseek.json --model sonnet'

之后用 deepclaude "帮我写个爬虫" 就行。

方法三：claudeep 一键安装

不想手写配置？社区有人做了自动化工具。

npm install -g claudeep@latest

安装完后：

claudeep setup "sk-你的deepseek-api-key"

这条命令会自动帮你设好所有环境变量。它还带一个 doctor 命令：

claudeep doctor

可以检查你的配置是不是有问题，有问题会自动修复。

怎么验证配置成功了？

跑个简单的命令试试：

claude "输出 hello world，用 Python"

如果 DeepSeek 正常响应，你会看到它写出代码、创建文件、然后运行给你看。

你再检查下终端输出，看它用的模型名是不是 deepseek-v4-pro。如果是，说明配置生效了。

如果想确认计费正常，去 DeepSeek 控制台看 API 调用记录。成功请求会显示在那里。

避坑指南

以下是我踩过的坑，直接说结论。

1. 首次使用需要跳过 Onboarding

第一次用 Claude Code 的时候，它会让你登录 Anthropic 账号做 onboarding。因为咱们用的是第三方 API，登录会失败。

解决方法：创建 ~/.claude.json（Windows 路径 C:\Users\你的用户名\.claude.json），写入：

{
  "hasCompletedOnboarding": true
}

2.--bare不是可选的

如果你之前用过 Claude Code 官方 API，或者配置过 AWS Bedrock / GCP Vertex，Claude Code 会自动检测这些认证方式并覆盖环境变量设置。--bare 参数的作用就是跳过所有这些检测。

如果你用方法一（环境变量），但还是遇到认证错误，换成方法二的配置文件方式试试。

3. 模型名不能直接传

Claude Code 内部有模型名校验白名单。你直接传 --model deepseek-v4-pro 会报错说模型名不合法。所以传 --model sonnet，DeepSeek 服务端会做映射。

4. DeepSeek 不支持图片

Claude Code 有个功能是读取截图和设计稿给出代码。DeepSeek V4 是纯文本模型，传图片会报错。如果你经常用视觉功能，得留着 Anthropic 的 key 做备用。

5. WebSearch 和 WebFetch 可能不能用

DeepSeek 的 reasoning 模型不支持某些 tool_choice 参数。Claude Code 的搜索网页功能（WebSearch / WebFetch）可能会返回 400 错误。目前没找到好的解决方案，如果你重度依赖这些功能，建议继续用 Claude 官方 API。

费用对比

我统计了一下自己上个月的实际开销：

当然，DeepSeek 在某些复杂任务上确实不如 Claude 聪明——主要是超长上下文的处理能力和多步骤推理的稳定性。但 90% 的日常开发场景完全够用。

我的用法是：日常开发用 DeepSeek，遇到复杂问题切回 Claude。这样两者的优势都能利用。

最后

把 Claude Code 接到 DeepSeek 上，本质上就是改几个环境变量的事。操作不复杂，效果立竿见影——以前每个月肉疼的 API 费用现在基本可以忽略。

如果你之前因为 Claude Code 的价格犹豫，现在可以试试了。省下来的钱，买排骨不香吗。

本文基于 DeepSeek V4 和 Claude Code 2.1.x 版本。API 接口和配置方式可能随版本更新变化，如果遇到问题，以官方文档为准。

以上就是Claude Code接入DeepSeek的保姆级教程的详细内容，更多关于Claude Code接入DeepSeek的资料请关注脚本之家其它相关文章！

最新评论