告别 API 高价，用 DeepSeek 驱动 Claude Code

Claude Code 是目前公认最强的 AI 编程工具之一，但原版强制绑定 Anthropic API，费用不菲——以 Opus 4.6 为例，输入价格高达 $15/百万 tokens，对重度使用者来说账单压力不小。

DeepSeek 在 2026 年 4 月发布的 V4 系列模型，不仅提供了兼容 Anthropic 协议的 API 端点，还拥有百万字超长上下文，在 Agent 能力、世界知识和推理性能上均达到国内与开源领域的领先水平。这意味着，只需改几行配置，就能用 DeepSeek 的超低价格驱动 Claude Code 的全部能力。

本文将带你从零开始，完成 Claude Code 的安装和 DeepSeek API 的配置。

第一步：安装 Node.js

Claude Code 基于 Node.js 运行，需要 v18.0 或更高版本。

在终端中检查是否已安装：

1
node -v

如果未安装，前往 Node.js 官网 下载安装。建议选择 LTS 版本，更稳定。

第二步：安装 Claude Code

Node.js 环境准备好后，执行下面这条命令全局安装 Claude Code：

1
npm install -g @anthropic-ai/claude-code

安装完成后，验证一下：

1
claude --version

有版本号输出就说明安装成功了。

如果安装失败，通常是官方源下载缓慢或网络波动导致。可以改用国内 npm 镜像源重新安装：

1
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

npmmirror.com 是国内的 npm 镜像，同步频率高、速度快，能有效解决安装超时或中断的问题。

第三步：获取 DeepSeek API Key

在正式配置之前，需要先去 DeepSeek 开放平台创建一个 API Key。

  1. 访问 DeepSeek 开放平台，注册并登录账号。
  2. 在左侧导航栏中找到 API Keys，点击创建新的 API Key。
  3. 输入一个名称（如 “claude-code”），点击创建。
  4. 立刻复制并保存这个 API Key——它只会在创建时展示一次，关闭对话框后就再也看不到了。

第四步：配置 Claude Code 使用 DeepSeek

根据 DeepSeek 的官方 API 文档，它提供了 OpenAI 格式和 Anthropic 格式两种接口：Anthropic 接口的 base_url 为 https://api.deepseek.com/anthropic，可用模型包括 deepseek-v4-pro[1m] 和 deepseek-v4-flash。[1m] 后缀代表启用百万字超长上下文模式。Claude Code 使用的就是这层 Anthropic 兼容接口。

我准备了两种配置方式，推荐使用配置文件持久化，一劳永逸。

方式一：直接环境变量配置

在终端中设置环境变量并启动 Claude Code：

macOS / Linux：

1
2
3
4
5
6
7
8
9
10
11
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"

claude

Windows PowerShell：

1
2
3
4
5
6
7
8
9
10
11
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_SMALL_FAST_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

claude

这里的逻辑很清晰：重量级任务（复杂代码、深度推理）走 deepseek-v4-pro[1m]，轻量任务（工具调用、文件读写、快速问答）走 deepseek-v4-flash，既能保住能力上限，又能控制成本。

方式二：通过配置文件持久化（推荐）

如果不想每次启动都手动 export，可以写入配置文件，一劳永逸。

macOS / Linux：
创建或编辑 ~/.claude/settings.json（~ 代表用户主目录）：

1
2
mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows：
目录为 C:\Users\你的用户名\.claude\settings.json。在文件资源管理器地址栏输入 %USERPROFILE% 回车进入用户主目录，然后找到（或新建）.claude 文件夹，在里面创建 settings.json 文件。

⚠️ 注意文件名：Windows 下默认隐藏文件扩展名，请务必在资源管理器「查看」菜单中勾选「文件扩展名」，确保文件名是 settings.json 而不是 settings.json.txt。这是最常见的踩坑点之一。

文件内容如下（务必填写你自己的 Key）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "API_TIMEOUT_MS": "3000000"
  }
}

保存时请使用 UTF-8 无 BOM 编码（Windows 用户推荐使用 VS Code 或 Notepad++ 编辑，避免记事本造成格式问题）。

保存后，还需要执行一步——跳过 Claude Code 的官方账号验证：

macOS / Linux：

1
echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

Windows PowerShell：

1
Set-Content -Path "$env:USERPROFILE\.claude.json" -Value '{"hasCompletedOnboarding":true}'

完成之后，进入项目目录，直接输入 claude 即可启动。

第五步：验证配置

启动成功后，Claude Code 的界面上会显示当前使用的模型名和 API 用量计费信息。你可以试着问它一句：

你是什么模型？

如果回答 “我是 DeepSeek V4 Pro 模型”，说明配置成功，可以开始写代码了。

如果你看到 Not logged in · Please run /login，大概率是以下几种情况：

  • 文件名写错：Windows 下最常见的坑，settings.json 被存成了 settings.json.txt，或者写成了settings.josn 请在资源管理器中开启「文件扩展名」显示来确认。
  • 路径不对：settings.json 必须放在 %USERPROFILE%\.claude\ 目录下，而不是直接放在用户目录或其他位置。
  • 环境变量未生效：如果用方式二，请确保没有在终端中重复 export 了空值覆盖掉配置。
  • 未跳过 onboarding：检查 .claude.json 是否存在于用户目录下，且内容为 {"hasCompletedOnboarding":true}。

可以用 claude config show 命令查看当前加载的配置，快速定位问题。

故障排查

遇到问题可以按以下顺序排查：

  1. 检查 Node.js 版本：确保 Node.js 版本 ≥ 18.0，node -v 确认。
  2. 检查 API Key 是否正确：登录 DeepSeek 开放平台 确认 Key 没有过期或遗失。
  3. 检查网络连通性：DeepSeek API 在国内可以直接访问，不需要代理。
  4. **查看 .claude.json**：确保已完成 onboarding 跳过步骤，文件内容为 {"hasCompletedOnboarding": true}。
  5. 检查 settings.json 文件名和路径：Windows 用户尤其要注意文件名不能是 settings.json.txt，且路径必须为 %USERPROFILE%\.claude\settings.json。
  6. 用 claude config show 诊断：直接查看当前生效的配置，确认模型名、端点是否正确。
  7. 检查超时设置：如果处理大项目时频繁超时，可以在环境变量中调大 API_TIMEOUT_MS 的值。

其他接入方式

除了直接配置，还有两种方式值得了解：

  • OpenClaude CN：一个开源的 Claude Code 第三方工具，支持 DeepSeek、通义千问、智谱 GLM 等国产模型，提供了中文配置向导，安装之后跟着提示选模型、填 Key 就能用。
  • LiteLLM：如果你同时使用多个模型供应商，可以用 LiteLLM 作为中间代理层来做统一路由和格式转换，适合对模型切换有较高要求的团队。

这两种方式都需要额外安装，对于绝大多数个人开发者来说，上面介绍的直接配置已经完全够用。

更多参考

以上就是完整的安装和配置流程。用 DeepSeek 驱动 Claude Code，保留了 Claude Code 完整的工具链和编程体验，同时享受极低的 API 成本。如果你在配置过程中遇到任何问题，欢迎在评论区留言交流。不过好像咋这里没有评论区哈哈哈