Ai
☘ 主页 > Ai >

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

2026-06-27 | 佚名 | 点击：次

一、概述

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 版本以获得更好的稳定性。

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

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

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

1

2

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

npm -v     # 应显示 11.13.0 或更高

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

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

macOS / Linux

1

2

3

4

5

6

7

8

9

10

11

12

13

# 安装 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. 安装完成后重启终端，执行：

1

2

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）

1

winget install Schniz.fnm

macOS / Linux 安装

1

2

3

4

5

# macOS (Homebrew)

brew install fnm

 

# 或使用安装脚本

curl -fsSL https://fnm.vercel.app/install | bash

使用 fnm

1

2

3

4

fnm install --lts          # 安装最新 LTS

fnm use 24                 # 使用 Node.js 24

fnm default 24             # 设为默认版本

node -v                    # 验证

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

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

1

2

3

4

5

6

7

8

9

# 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

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

1

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

四、安装 Claude Code

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

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

macOS / Linux / WSL

1

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

Windows PowerShell

1

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

安装后验证：

1

2

claude --version

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

方法二：npm 安装

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

1

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

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

1

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

验证：

1

claude --version

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

方法三：winget 安装（Windows）

1

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

1

2

3

4

5

6

7

8

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

1

2

3

4

5

6

7

8

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

1

nano ~/.zshrc

macOS / Linux（Bash）：

1

nano ~/.bashrc

在文件末尾追加：

1

2

3

4

5

6

7

8

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

保存后重新加载：

1

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

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

1

2

3

4

5

6

7

8

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

1

2

3

4

5

6

7

8

9

10

11

12

{

  "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

进入你的项目目录：

1

2

cd /path/to/my-project

claude

6.2 基本测试

启动后问一个简单问题：

1

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

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

6.3 检查配置状态

在 Claude Code 内执行：

1

/status

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

七、常见问题

1. 提示 API Key 无效

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

1

2

3

4

5

# 错误

export ANTHROPIC_AUTH_TOKEN=<sk-xxxxxxxx>

 

# 正确

export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxx

2. 请求超时

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

1

export API_TIMEOUT_MS=600000    # 10 分钟

3. 模型名报错

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

1

2

export ANTHROPIC_MODEL=deepseek-chat

export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat

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

4. npm 安装 Claude Code 失败

检查 Node.js 版本：

1

2

node -v    # 需要 >= 18

npm -v

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

1

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 后重启终端
原文链接：
相关文章
最新更新