Deepseek ArtifactsDeepseek Artifacts
API 配置 · 11 个步骤

在 Claude Code 中使用 DeepSeek：Anthropic API 配置指南

把 Claude Code 指向 DeepSeek 的 Anthropic 兼容端点——一段环境变量把 Opus、Sonnet 和 Haiku 映射到 deepseek-v4-pro 或 flash，每个请求都按 DeepSeek API 价格计费。

开始配置跳到 FAQ

太长不看版

  • DeepSeek 提供 Anthropic 兼容端点，Claude Code 可以直连——不需要任何代理工具。
  • 整个切换就是一段环境变量：ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN，再加每个模型的映射。
  • 有意识地分配别名模型：Opus 和 Sonnet 槽位给 deepseek-v4-pro，Haiku 和子代理槽位给 deepseek-v4-flash。
  • 计费转到 DeepSeek 按量付费的 API——演示那场会话搭好并测完一个完整应用只花了几美分，花销在平台仪表盘里看得清清楚楚。

DeepSeek v4 Pro on Claude Code - Full Setup Tutorial

频道：Prince does AI8:08

在 YouTube 上观看

Use Claude Code with ANY AI Model GPT, Gemini, DeepSeek

频道：AyyazTech17:00

在 YouTube 上观看

Anthropic-compatible API — official DeepSeek documentation

文档：api-docs.deepseek.com

在 YouTube 上观看

截图来自 Prince does AI 的配置实操——干净的全屏录屏。router 对比参考了 AyyazTech 的任意模型演示，端点信息来自 DeepSeek 官方 API 文档。

视频帧画面归各创作者所有，此处标注出处并附深链直达对应时刻；文字部分为本站撰写。

从 npm 安装到在 DeepSeek 上跑起一个应用

第 1 部分 · 安装与配置

  1. 1

    安装 Claude Code 并验证

    用 npm 装好 CLI，然后运行 claude --version——演示里打印出了 2.1.89。唯一的前置要求是 Node.js，同样的安装在 macOS、Linux 和 Windows 上都适用。

    PowerShell printing Claude Code version 2.1.89 after the npm install, confirming the CLI is ready before pointing it at DeepSeek
    版本检查确认装好了 Claude Code 2.1.89。在 0:46 观看
  2. 2

    拿到 DeepSeek API 密钥

    登录 platform.deepseek.com，在 Billing 页面充一小笔钱，然后打开侧边栏的 API keys 新建一个密钥。立刻复制——平台只显示这一次。

    DeepSeek platform console with the Usage overview showing balance and spend charts plus the API keys entry in the left navigation
    DeepSeek 平台控制台，侧边栏里是 API keys。在 0:49 观看
  3. 3

    设置环境变量块

    在 PowerShell 里把 ANTHROPIC_BASE_URL 设为 DeepSeek 的 Anthropic 端点、ANTHROPIC_AUTH_TOKEN 设为你的密钥，然后映射模型槽位：ANTHROPIC_MODEL 和 OPUS、SONNET 的默认值指向 deepseek-v4-pro，HAIKU 默认值和 CLAUDE_CODE_SUBAGENT_MODEL 指向 deepseek-v4-flash。整块一起粘贴，回车。

    Notepad listing the PowerShell environment block that points Claude Code at the DeepSeek Anthropic endpoint with ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN and per-model mappings
    环境变量块：端点、令牌和模型映射。在 1:35 观看

第 2 部分 · 在 DeepSeek 上启动

  1. 4

    启动 Claude Code

    在同一个 PowerShell 窗口里输入 claude，接受文件夹信任提示。带 env 前缀设置的环境变量只活在这个窗口——之后再启动就得重新粘贴，除非你把它写进 profile 持久化。

    Claude Code v2.1.89 welcome screen showing the API Usage Billing badge that appears when the DeepSeek endpoint is active instead of a Claude subscription
    从配置好的 PowerShell 窗口启动 Claude Code。在 2:05 观看
  2. 5

    确认 API 计费徽标

    欢迎屏显示 API Usage Billing 徽标而不是套餐名——这就是 DeepSeek 端点已生效的信号。模型行可能写着 Opus 1M 上下文：那只是映射后的名字，实际答题的是 deepseek-v4-pro。

    Claude Code welcome screen showing Opus 4.6 with 1M context as the mapped model name while requests are actually served by deepseek-v4-pro
    欢迎屏显示 Opus 4.6 和 API Usage Billing。在 2:25 观看
  3. 6

    跑第一条提示词

    演示为了流程不中断，启动时跳过了权限确认；不加那个参数，Claude Code 会照常在每次改动前询问。先用一道推理题试试管道通不通。

    PowerShell launching Claude Code with claude --dangerously-skip-permissions for an uninterrupted DeepSeek-powered demo session
    为演示会话跳过权限启动。在 2:50 观看
  4. 7

    先验一验答案

    演示问了一道小逻辑题——去洗车店该走路还是开车——得到带推理过程的正确答案。在这里花十秒，能省下之后十分钟的调试。

    Claude Code answering a car wash logic question through DeepSeek with a doctor settings reminder visible in the session footer
    洗车店测试通过 DeepSeek 答对了。在 3:18 观看

第 3 部分 · 让它证明自己

  1. 8

    给它一个真正的构建任务

    来点有分量的——演示直接要一个惊艳的 Electron 应用，并让模型先出计划。先规划后构建的流程在 DeepSeek 上一模一样：批准计划，看步骤一项项划掉。

    Claude Code updating its plan to build ClipMaster, a smart clipboard manager Electron app, while running on deepseek-v4-pro
    模型在规划 ClipMaster，一个剪贴板管理应用。在 4:22 观看
  2. 9

    等它做完，打开应用

    Claude Code 搭好脚手架、写完代码并启动成品——演示里的 ClipMaster 能监听剪贴板、保留历史、注册全局快捷键。计划-批准-构建的循环，产出的就是该有的样子。

    ClipMaster clipboard manager built by Claude Code on DeepSeek with its feature list covering history, pinning and global shortcuts
    完成的 ClipMaster 应用和它的功能清单。在 5:25 观看
  3. 10

    像用户一样测试产出

    在系统任意位置复制几段内容，看着它们出现在生成应用的历史里。实测胜过信任——演示特意从第二块显示器复制，证明捕获是真的。

    ClipMaster window capturing copied items in real time during the Claude Code DeepSeek session to prove the generated app works
    复制的内容实时落入 ClipMaster 的历史列表。在 5:55 观看
  4. 11

    看看花了多少钱

    回到 DeepSeek 平台，Usage 页面显示这场会话的请求数、token 和花销。作者的结论：约 200 万 token 花了 8 美分。你的数字也会近乎实时地落进同一个仪表盘。

    DeepSeek platform usage dashboard showing session spend and request counts after building and testing an app with Claude Code
    完整的构建加测试会话之后的用量仪表盘。在 7:00 观看

直连端点还是 claude-code-router？

在 DeepSeek 上跑 Claude Code 有两条路。本教程走直连的 Anthropic 兼容端点；router 工具是另一条路。

  • 1直连端点（本教程）：零额外工具——只靠环境变量，Claude Code 直接对话 api.deepseek.com。
  • 2claude-code-router：一个本地代理，支持会话中途切换模型和多供应商路由，代价是多装多配一个服务。
  • 3DeepSeek 是日常主力就选直连；要在多家供应商之间轮换、按任务切模型，就选 router。
  • 4两种方式的 Claude Code 体验完全一样——计划、工具和权限行为一致，变的只是计费和别名背后的模型。

我们的 Claude Code router 教程会一步步讲代理路线，包括它自己的 DeepSeek 配置。

配置不听话的时候

这里几乎所有的故障都是环境变量或陈旧窗口的锅。动其他任何东西之前，先把这份清单过一遍。

  • 1还在按 Claude 套餐计费：欢迎屏显示套餐名而不是 API Usage Billing——环境变量块设在了另一个终端窗口。在你启动 claude 的那个窗口里重新跑一遍。
  • 2鉴权报错：粘贴令牌时带了引号或空白，或者密钥余额不足。新建一个密钥、充值，再重新设置 ANTHROPIC_AUTH_TOKEN。
  • 3报错提到工具调用：较旧的 DeepSeek 快照对某些工具调用处理不佳——按第 3 步那样，主槽位保持 deepseek-v4-pro，子代理用 flash。
  • 4感觉答话的模型不对：记住别名这回事。界面写着 Opus 或 Sonnet，真正的模型由你的映射决定——先查 ANTHROPIC_MODEL，别看标签。
  • 5设置跨会话丢失：PowerShell 的环境变量随窗口失效。把变量块持久化进 shell profile，或者包成一个写码前运行的小脚本。

想回到 Anthropic 计费：清掉这些变量——在同一个窗口里 remove-env ANTHROPIC_BASE_URL 及其同伴——然后重启 Claude Code。

DeepSeek 接入 Claude Code 常见问题

相关 DeepSeek 教程

Claude Code 桌面版DeepSeek Harness 安装攻略:免费的 Claude Code 替代Claude Code Router 教程在 Cursor 里用 DeepSeek在 Claude Code 里用 Kimi K3DeepSeek V4 Flash 使用指南