Claude Code

关注公众号 jb51net

关闭
AI > Claude Code >

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

MingXin

一、概述

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

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

核心优势

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

二、准备工作

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

如果你已经安装了 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 无效

# 错误
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命令找不到

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