Claude Code 对接 DeepSeek 完整使用教程（2026 最新版）

本教程基于 DeepSeek 官方文档和社区经验整理，涵盖从零安装 Node.js、Claude Code 到配置 DeepSeek 模型的全流程。最后更新：2026 年 6 月。

一、概述
二、准备工作
[三、安装 Node.js](#三、安装 Node.js "#%E4%B8%89%E5%AE%89%E8%A3%85-nodejs")
[四、安装 Claude Code](#四、安装 Claude Code "#%E5%9B%9B%E5%AE%89%E8%A3%85-claude-code")
[五、配置 DeepSeek](#五、配置 DeepSeek "#%E4%BA%94%E9%85%8D%E7%BD%AE-deepseek")
六、验证是否生效
七、常见问题
八、参考文档

一、概述

Claude Code 是 Anthropic 推出的终端级 AI 编程代理，以命令行形式运行在项目目录中。它不仅能回答问题，还能直接读写文件、执行命令、运行测试，像一个真正理解代码库的协作者参与开发。

DeepSeek 提供了 Anthropic API 兼容接口，因此只需修改几个环境变量，就能将 Claude Code 的底层模型从 Anthropic 切换到 DeepSeek，享受 DeepSeek V4 系列模型的编程能力。

核心优势

能力	说明
代码理解与生成	读取、编写、重构代码，跨文件追踪依赖
命令执行与集成	直接执行 Shell 命令，运行测试，操作 Git
项目研究与规划	快速理解陌生代码库，分析架构，制定实施计划
Web Search	DeepSeek 原生支持 Claude Code 的 Web Search 功能

二、准备工作

在开始之前，确认以下条件：

操作系统：Windows 10 2004+ / Windows 11（64 位）、macOS、Linux
Node.js 18+：npm 安装 Claude Code 时需要
DeepSeek API Key ：在 DeepSeek 开放平台创建
终端环境 ：
- Windows：PowerShell（推荐）、Windows Terminal、Git Bash、WSL
- macOS / Linux：Bash、Zsh、Fish
网络：能访问外网或配置代理

如果你已经安装了 Claude Code，可以跳过第三、四节，直接看「五、配置 DeepSeek」。

三、安装 Node.js

Claude Code 的 npm 安装方式依赖 Node.js 18+。当前 Node.js 最新 LTS 版本为 v24.17.0 （代号 Krypton），Current 版本为 v25.x。推荐安装 LTS 版本以获得更好的稳定性。

方法一：官方安装包（最简单）

适合大多数用户，开箱即用。

访问 Node.js 官网下载页
下载 LTS 版本对应的安装包：
- Windows：.msi 安装包
- macOS：.pkg 安装包
双击运行安装程序，一路 Next 使用默认选项
验证安装：

bash 复制代码

node -v    # 应显示 v24.17.0 或更高
npm -v     # 应显示 11.13.0 或更高

方法二：nvm（Node Version Manager）------ 推荐

nvm 允许在同一台机器上安装和切换多个 Node.js 版本，是开发者最常用的方式。

macOS / Linux

bash 复制代码

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc    # Bash 用户
source ~/.zshrc     # Zsh 用户

# 安装最新 LTS 版本
nvm install --lts

# 验证
node -v
npm -v

Windows：nvm-windows

nvm-windows 是 nvm 的 Windows 移植版。

访问 nvm-windows GitHub Releases
下载最新的 nvm-setup.exe
双击安装（注意：安装路径不要包含中文或空格）
安装完成后重启终端，执行：

powershell 复制代码

nvm list available        # 查看可用版本
nvm install 24.17.0      # 安装指定版本
nvm use 24.17.0          # 切换版本
node -v                  # 验证

方法三：fnm（Fast Node Manager）------ 新一代推荐

fnm 是用 Rust 编写的现代化 Node.js 版本管理器，比 nvm 更快，跨平台支持更好。

Windows 安装（使用 Winget）

powershell 复制代码

winget install Schniz.fnm

macOS / Linux 安装

bash 复制代码

# macOS (Homebrew)
brew install fnm

# 或使用安装脚本
curl -fsSL https://fnm.vercel.app/install | bash

使用 fnm

bash 复制代码

fnm install --lts          # 安装最新 LTS
fnm use 24                 # 使用 Node.js 24
fnm default 24             # 设为默认版本
node -v                    # 验证

fnm vs nvm 对比：fnm 启动速度更快（Rust 实现），跨平台体验一致，配置更简单。如果你是新用户，推荐直接使用 fnm。

方法四：包管理器一键安装

powershell 复制代码

# Windows (Scoop)
scoop install nodejs-lts

# macOS (Homebrew)
brew install node@24

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

配置国内镜像源（可选，加速下载）

bash 复制代码

npm config set registry https://registry.npmmirror.com

四、安装 Claude Code

方法一：官方安装脚本（推荐，无需 Node.js）

这是 Anthropic 官方提供的原生安装方式，不依赖 Node.js。

macOS / Linux / WSL

bash 复制代码

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

powershell 复制代码

irm https://claude.ai/install.ps1 | iex

安装后验证：

bash 复制代码

claude --version
claude doctor      # 检查安装状态和环境

注意：claude.ai 在中国大陆可能无法直接访问。如果安装失败，请配置代理：
powershell 复制代码
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
irm https://claude.ai/install.ps1 | iex
或者使用 --force 参数强制安装：
powershell 复制代码
Invoke-WebRequest -Uri "https://claude.ai/install.ps1" -OutFile "install-claude.ps1"
.\install-claude.ps1 --force

方法二：npm 安装

如果你已经安装了 Node.js 18+：

bash 复制代码

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

如果遇到网络问题，使用国内镜像：

bash 复制代码

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

验证：

bash 复制代码

claude --version

注意：不建议使用 sudo npm install -g，否则后续自动更新和权限管理会比较麻烦。

方法三：winget 安装（Windows）

powershell 复制代码

winget install Anthropic.ClaudeCode

安装后重启终端再验证。

五、配置 DeepSeek

DeepSeek 提供了 Anthropic API 兼容地址，核心配置就是将 Claude Code 的 API 地址、Token 和模型名改为 DeepSeek。

5.1 获取 DeepSeek API Key

访问 DeepSeek 开放平台
注册 / 登录账号
创建 API Key，复制保存（形如 sk-xxxxxxxx）

5.2 临时配置（当前终端窗口生效）

macOS / Linux

bash 复制代码

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_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Windows PowerShell

powershell 复制代码

$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_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

5.3 持久化配置

方式一：写入 Shell 配置文件

macOS / Linux（Zsh）：

bash 复制代码

nano ~/.zshrc

macOS / Linux（Bash）：

bash 复制代码

nano ~/.bashrc

在文件末尾追加：

bash 复制代码

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_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

保存后重新加载：

bash 复制代码

source ~/.zshrc    # 或 source ~/.bashrc

Windows PowerShell（当前用户永久生效）：

powershell 复制代码

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<你的 DeepSeek API Key>", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro[1m]", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-flash", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")

设置后重启终端生效。

方式二：使用 Claude Code 的 settings.json（推荐）

这种方式只影响 Claude Code，不会污染系统环境变量，更加干净。

编辑或创建 ~/.claude/settings.json：

json 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

如果文件已存在，只需合并其中的 env 字段，不要覆盖整个文件。

5.4 环境变量说明

变量名	说明	推荐值
`ANTHROPIC_BASE_URL`	API 基础地址	`https://api.deepseek.com/anthropic`
`ANTHROPIC_AUTH_TOKEN`	API 密钥	你的 DeepSeek API Key
`ANTHROPIC_MODEL`	主模型	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 级别模型	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 级别模型	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 级别模型（轻量任务）	`deepseek-v4-flash`
`CLAUDE_CODE_SUBAGENT_MODEL`	子代理模型	`deepseek-v4-flash`
`CLAUDE_CODE_EFFORT_LEVEL`	推理努力程度	`max`

模型映射说明 ：DeepSeek 会将 claude-opus 开头的模型映射到 deepseek-v4-pro，将 claude-haiku、claude-sonnet 开头的模型映射到 deepseek-v4-flash。

六、验证是否生效

6.1 启动 Claude Code

进入你的项目目录：

bash 复制代码

cd /path/to/my-project
claude

6.2 基本测试

启动后问一个简单问题：

复制代码

请用一句话说明当前项目的技术栈。

如果 Claude Code 能正常返回，并且 DeepSeek 控制台出现了 API 调用记录，说明接入成功。

6.3 检查配置状态

在 Claude Code 内执行：

bash 复制代码

/status

查看当前配置来源，确认环境变量是否被正确读取。

七、常见问题

1. 提示 API Key 无效

确认 ANTHROPIC_AUTH_TOKEN 填的是 DeepSeek API Key （sk- 开头），不是 Anthropic 的 Key
不要把尖括号一起填进去：

bash 复制代码

# 错误
export ANTHROPIC_AUTH_TOKEN=<sk-xxxxxxxx>

# 正确
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxx

2. 请求超时

长任务或大文件分析可能触发超时，可以增加超时时间：

bash 复制代码

export API_TIMEOUT_MS=600000    # 10 分钟

3. 模型名报错

DeepSeek 的模型名可能随平台更新变化。如果 deepseek-v4-pro[1m] 不可用，可先换成通用模型：

bash 复制代码

export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat

实际可用模型以 DeepSeek 官方文档为准。

4. npm 安装 Claude Code 失败

检查 Node.js 版本：

bash 复制代码

node -v    # 需要 >= 18
npm -v

版本太低则先升级 Node.js，再重新安装。如果网络问题，使用国内镜像：

bash 复制代码

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

5. Windows 下 `claude` 命令找不到

确认安装路径已加入系统 PATH
官方脚本安装路径：C:\Users\<用户名>\.local\bin
npm 安装路径：C:\Users\<用户名>\AppData\Roaming\npm
添加 PATH 后重启终端

6. 中国大陆无法访问 claude.ai

claude.ai 在中国大陆被屏蔽，直连会返回 403。解决方案：

配置代理（推荐）：

powershell 复制代码

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

使用 --force 参数强制安装
改用 npm 或 winget 安装方式

Claude Code 对接 DeepSeek 完整使用教程（2026 最新版）