一、为什么要这样做？

Claude Code 是目前最流行的终端 AI 编程助手之一，但原版依赖 Anthropic API，存在两个主要痛点：

• 费用高：Claude Opus 等模型的 API 价格不菲，重度使用的话账单压力不小；

• 门槛高：需要海外电话卡、信用卡，还要能打开海外网站，并且随时面临封号风险。

DeepSeek 提供了 Anthropic API 兼容层，这意味着 Claude Code 可以直接对接 DeepSeek 的模型，不需要任何第三方适配层。配置起来也极其简单——改几行环境变量就能搞定。

本文写作时使用的是 DeepSeek V4 系列模型。DeepSeek API 已支持 deepseek-v4-pro 与 deepseek-v4-flash，支持 OpenAI ChatCompletions 接口与 Anthropic 接口。旧有的 API 接口的两个模型名 deepseek-chat 与 deepseek-reasoner 将于 2026 年 7 月 24 日停止使用，当前阶段内这两个模型名分别指向 deepseek-v4-flash 的非思考模式与思考模式。

想直接操作的读者可以跳到第八节（作者复盘）。

二、准备工作

2.1 安装 Node.js

Claude Code 需要 Node.js 18.0 或更高版本。打开终端执行：

node --version

如果版本低于 18.0，请前往 Node.js 官网 下载安装。

2.2 安装 Claude Code

使用 npm 全局安装：

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

安装完成后验证：

claude

此时运行 claude 应提示无法连接 API（因为没有配置密钥），这表示安装成功。

三、获取 DeepSeek API Key

1. 访问 DeepSeek 开放平台，注册/登录你的账号。

2. 进入 API Keys 页面，点击 创建 API key（也可在控制台的“API 密钥”菜单下找到）。

3. 输入一个便于识别的名称，点击创建。

4. 立即复制并保存 API Key——后续页面不会再显示完整密钥。

💡 关于额度：建议充几块钱，保证测试可用。

四、配置 Claude Code 接入 DeepSeek

Claude Code 的配置文件位于：

操作系统	配置文件路径
macOS / Linux	~/.claude/settings.json
Windows	%USERPROFILE%\.claude\settings.json

方法一：手动编辑配置文件（推荐）

打开终端，执行以下命令编辑配置文件（若文件不存在则自动创建）：

macOS / Linux：

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

Windows（PowerShell）：

New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude
notepad $env:USERPROFILE\.claude\settings.json

将以下内容写入配置文件（请务必将 your_deepseek_api_key 替换为你的真实 API Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_deepseek_api_key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "API_TIMEOUT_MS": 3000000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

各字段说明：

字段	说明
ANTHROPIC_AUTH_TOKEN	DeepSeek API Key，用于身份鉴权
ANTHROPIC_BASE_URL	DeepSeek 的 Anthropic 兼容端点
ANTHROPIC_MODEL	使用的模型名称，可选 deepseek-v4-pro 或 deepseek-v4-flash
API_TIMEOUT_MS	API 超时时间（毫秒），建议设为 3 分钟以上用于处理长时间推理
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	禁用非必要流量，提升稳定性

⚠️ 注意：配置时 URL 末尾不要有斜杠，否则可能出现 400 错误。ANTHROPIC_MODEL 必须使用 deepseek-v4-pro 或 deepseek-v4-flash（全小写）。

方法二：使用 CC Switch（可视化切换，可选）

如果需要在 DeepSeek、Claude 等多个模型之间灵活切换，可以试试 CC Switch 工具（非官方，请自行评估安全性）。

1. 从 GitHub releases 下载 CC Switch；

2. 启动 CC Switch，点击右上角 "+" 号；

3. 选择 自定义供应商，填写以下信息：

   • Base URL：https://api.deepseek.com/anthropic

   • API Key：你的 DeepSeek API Key

   • 模型名称：填 deepseek-v4-pro（或 deepseek-v4-flash）

4. 点击右下角 添加，然后 启用 该配置。

五、验证配置是否生效

进入你的项目目录，启动 Claude Code：

cd /path/to/your/project
claude

首次启动需要选择信任当前文件夹。进入交互界面后，可以使用以下方式验证：

方法一：输入 /status 查看当前使用的模型，确认显示为 deepseek-v4-pro。

方法二：直接提问 "你是什么模型？"，正常情况下模型会回答 "我是 DeepSeek V4 Pro 模型"。

如果看到以下现象，说明配置成功：

• 启动时不再提示需要登录 Anthropic 账号；

• 能够正常执行 /help 命令；

• 可以正常接收和返回消息。

六、模型选择与分工建议

DeepSeek 提供了两种模型，建议根据任务类型合理分配：

模型	适用场景	配置方法
deepseek-v4-pro	复杂代码推理、架构设计、深度分析等重量级任务	ANTHROPIC_MODEL: "deepseek-v4-pro"
deepseek-v4-flash	轻量任务（快速问答、文件读写、工具调用等）	ANTHROPIC_MODEL: "deepseek-v4-flash"

如果想实现更精细的分工（复杂任务走 Pro、轻量任务自动走 Flash），可以扩展配置文件（以下变量部分为 Claude Code 特定版本支持，不一定全部生效）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_deepseek_api_key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "API_TIMEOUT_MS": 3000000,
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
    "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-pro"
  }
}

七、附录：常用命令与常见问题

7.1 常用命令

命令	说明
claude	在当前目录启动 Claude Code
/status	查看当前使用的模型
/context	查看当前对话使用了多少 token
/compact	压缩当前对话上下文（压缩次数越多，模型对历史记忆越模糊）
/resume	恢复之前的对话上下文

7.2 常见问题

Q：一直要求登录 Anthropic？

A：环境变量未生效。检查 ~/.claude/settings.json 中的字段名是否正确（注意 ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY）以及文件路径是否正确。

Q：请求被拒绝（403）或 API Key 无效？

A：API Key 可能已过期或无效，请重新生成一个新的 Key。另外确认账户是否有足够余额。

Q：响应速度很慢？

A：可以尝试使用 deepseek-v4-flash 模型，它专门针对轻量任务优化，响应更快。

Q：400 Bad Request 错误？

A：检查 ANTHROPIC_BASE_URL 是否包含了多余的反斜杠（如末尾的 / 或 \），务必删除。同时确认 ANTHROPIC_MODEL 使用的是正确的模型名（deepseek-v4-pro 或 deepseek-v4-flash），不要填入带引号或空格的值。

Q：claude: command not found 报错？

A：检查 npm 全局 bin 路径是否在 $PATH 中，或者重新安装 Claude Code。

Q：旧模型名称还能用吗？

A：deepseek-chat 和 deepseek-reasoner 将于 2026 年 7 月 24 日停止使用。当前阶段内这两个模型名分别指向 deepseek-v4-flash 的非思考模式与思考模式。建议尽快迁移到新模型名称。

八、作者复盘

在 Windows 11 上安装了 Node.js 的前提下，操作如下：

8.1 安装 Claude Code

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

8.2 验证（也可以先跳过）

claude

8.3 修改 settings.json

settings.json 的位置一般在：

C:\Users\<你的用户名>\.claude

如果第二步验证没有做，可能没有 .claude 文件夹，手动创建一个也行。settings.json（没有的话也自己创建）可先按如下配置进行测试：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_deepseek_api_key",
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
        "ANTHROPIC_MODEL": "deepseek-v4-pro",
        "API_TIMEOUT_MS": 3000000,
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    }
}

我现在用的配置如下（实现了轻量任务使用 deepseek-v4-flash 以节省费用，并设置了中文界面）：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_deepseek_api_key",
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
        "ANTHROPIC_MODEL": "deepseek-v4-pro",
        "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
        "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_EFFORT_LEVEL": "max",
        "API_TIMEOUT_MS": 3000000,
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    },
    "theme": "auto",
    "language": "简体中文"
}

两种配置的区别在于：测试配置中如果未指定轻量模型，某些任务可能会尝试调用 Claude 内置模型；而我的配置明确指定了轻量任务使用 deepseek-v4-flash，避免轻量任务浪费 deepseek-v4-pro 的配额，降低费用。另外设定了语言为 简体中文（默认是 English）。

8.4 使用

在项目目录下打开命令行窗口执行：

claude

进入 Claude Code 之后执行：

/init

此时进入初始化阶段，Claude Code 安装及配置完成。

参考资料

• DeepSeek API 更新日志

• DeepSeek V4+Claude Code 一手实战！夯爆了还是拉完了？

读者须知

• 部分内容由 AI 生成，请读者注意甄别。

• 如有错误，欢迎指正。