脚本之家 服务器常用软件
快捷导航
您的位置：主页 > AI > Claude Code > Claude Code对接DeepSeek

Claude Code对接DeepSeek的完整使用教程(2026 最新版)

  发布时间：2026-06-26 15:45:58   作者：MingXin   我要评论
Claude Code 是 Anthropic 推出的终端级 AI 编程代理，本教程为大家详细介绍了如何使用ClaudeCode对接DeepSeek,涵盖安装Node.js、ClaudeCode及配置DeepSeek模型的全流程,帮助开发者轻松升级AI编程助手

一、概述

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

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

核心优势

能力说明
代码理解与生成读取、编写、重构代码，跨文件追踪依赖
命令执行与集成直接执行 Shell 命令，运行测试，操作 Git
项目研究与规划快速理解陌生代码库，分析架构，制定实施计划
Web SearchDeepSeek 原生支持 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 版本以获得更好的稳定性。

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

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

  1. 访问 Node.js 官网下载页
  2. 下载 LTS 版本对应的安装包：
    • Windows：.msi 安装包
    • macOS：.pkg 安装包
  3. 双击运行安装程序，一路 Next 使用默认选项
  4. 验证安装：
node -v    # 应显示 v24.17.0 或更高
npm -v     # 应显示 11.13.0 或更高

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

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

macOS / Linux

# 安装 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 移植版。

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

winget install Schniz.fnm

macOS / Linux 安装

# macOS (Homebrew)
brew install fnm

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

使用 fnm

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

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

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

# 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

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

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

四、安装 Claude Code

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

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

macOS / Linux / WSL

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

Windows PowerShell

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

安装后验证：

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

方法二：npm 安装

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

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

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

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

验证：

claude --version

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

方法三：winget 安装（Windows）

winget install Anthropic.ClaudeCode

安装后重启终端再验证。

五、配置 DeepSeek

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

5.1 获取 DeepSeek API Key

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

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

macOS / Linux

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

$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）：

nano ~/.zshrc

macOS / Linux（Bash）：

nano ~/.bashrc

在文件末尾追加：

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

保存后重新加载：

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

Windows 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：

{
  "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_URLAPI 基础地址https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKENAPI 密钥你的 DeepSeek API Key
ANTHROPIC_MODEL主模型deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_OPUS_MODELOpus 级别模型deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_SONNET_MODELSonnet 级别模型deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODELHaiku 级别模型（轻量任务）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

进入你的项目目录：

cd /path/to/my-project
claude

6.2 基本测试

启动后问一个简单问题：

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

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

6.3 检查配置状态

在 Claude Code 内执行：

/status

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

七、常见问题

1. 提示 API Key 无效

  • 确认 ANTHROPIC_AUTH_TOKEN 填的是 DeepSeek API Key（sk- 开头），不是 Anthropic 的 Key
  • 不要把尖括号一起填进去：
# 错误
export ANTHROPIC_AUTH_TOKEN=<sk-xxxxxxxx>

# 正确
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxx

2. 请求超时

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

export API_TIMEOUT_MS=600000    # 10 分钟

3. 模型名报错

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

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

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

4. npm 安装 Claude Code 失败

检查 Node.js 版本：

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

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

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 后重启终端

到此这篇关于Claude Code对接DeepSeek的完整使用教程(2026 最新版)的文章就介绍到这了,更多相关Claude Code对接DeepSeek内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

相关文章

  • Claude Code配置本地Ollama模型或别的模型(Deepseek等)的实践指南

    本文详细介绍了如何使用Claude Code Router将Ollama或DeepSeek等非Anthropic模型接入Claude Code,包括安装、配置步骤及常见问题排查,通过协议转换网关,需要的朋友可以参考
    2026-06-26

  • VSCode+ClaudeCode+Deepseek的配置与联动搭建

    ,本文详细介绍了在VSCode中配置ClaudeCode插件并集成Deepseek AI模型的方法,该方案实现了编辑器与AI助手的无缝协同，适用于开发调试、文档编写等场景,感兴趣的可以了解一下
    2026-06-26

  • Claude Code接入DeepSeek的保姆级教程

    本文详细介绍了将Claudede切换至DeepSeek的的优势与操作方法,包括费用对比、配置步骤及避坑指南,帮助DeepSeek为更经济高效的AI编程工具,需要的朋友可以参考下
    2026-06-10

  • Claude Code接入DeepSeek V4的两种方法完整配置指南(2026最新)

    Claude Code 是目前最好用的 AI 编程 Agent，但它默认只用 Anthropic 的模型，价格不便宜，本文主要介绍了Claude Code接入DeepSeek V4的两种方法，有需要的小伙伴可以了解
    2026-06-03

  • 在Windows系统上配置Claude Code使用DeepSeek API的操作指南

    在Windows系统上配置Claude使用使用DeepSeekAPI,需安装Node.js、配置ClaD环境及设置DeepSeekAPI环境变量,本文详细介绍了安装步骤、配置方法及常用命令,助你快速上手,需要的
    2026-05-28

  • VS Code+Claude Code+Deepseek的使用小结

    本文详细介绍了在VSCode中配置ClaudeCode插件并集成Deepseek AI模型的方法,文中通过图文示例介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下
    2026-05-26

  • 在Claude Code中配置DeepSeek从报错到成功调用的全流程

    本文记录了在 Claude Code 中配置 DeepSeek 的完整流程，从连接错误到成功调用，分三阶段详解配置方法，并提供 V4 模型适配方案及多家国产大模型对接指南,需要的朋友可以参
    2026-05-13

  • VScode如何使用Claude Code接入Deepseek

    本文介绍了VScode如何使用Claude Code接入Deepseek，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习
    2026-05-08

  • 在Claude Code中接入DeepSeek-V4的完整指南

    Claude Code的价值，在于把代码理解、修改、执行和验证整合进同一条工作链路，如果你已经在使用Claude Code，又希望把底层模型切换到DeepSeek-V4，这篇文章可以直接帮你完
    2026-05-06

  • Claude Code接入DeepSeek兼容端点的配置教程

    文章介绍了如何通过环境变量配置将ClaudeCode的API后端切换为DeepSeek提供的Anthropic兼容端点,详细说明了在Windows和Linux/macOS上的配置步骤,并提供了完整的配置示例,还
    2026-05-01

最新评论

关注微信公众号

扫一扫