Claude Code接入DeepSeek的保姆级教程

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

先说为什么

在目前市面上的 AI 编程工具里，Claude Code 确实属于第一梯队。它跟 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"

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

claudeep doctor

可以检查配置是否有问题，如果发现问题会自动修复。

怎么验证配置成功了？

跑一个简单的命令试试看：

claude "输出 hello world，用 Python"

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

你还可以检查一下终端的输出，看它调用的模型名是不是 deepseek-v4-pro。如果是，说明配置已经生效。

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

避坑指南

以下是已经验证过的避坑要点，直接进入正题。

1. 首次使用需要跳过 Onboarding

第一次使用 Claude Code 时，它会让你登录 Anthropic 账号进行初始化。由于我们用的是第三方 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。

费用对比

实际使用下来，统计了一下上个月的开销：

项目	Claude API	DeepSeek
日常工作（每天约 4 小时重度使用）	~$200	~$9.7
跑自动化脚本	额外 $50-80	不到 $5
每月总花销	$200-280	$10-15

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

推荐的策略是：

。这样两边的好处都能享受到。

最后

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

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

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