Claude Code对接DeepSeek的完整使用教程:2026 最新版
一、概述
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安装包
- Windows：
- 双击运行安装程序，一路 Next 使用默认选项
- 验证安装：
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 移植版。
- 访问 nvm-windows GitHub Releases
- 下载最新的
nvm-setup.exe - 双击安装（注意：安装路径不要包含中文或空格）
- 安装完成后重启终端，执行：
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
- 访问 DeepSeek 开放平台
- 注册 / 登录账号
- 创建 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_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
进入你的项目目录：
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= # 正确 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<用户名>.localbin - npm 安装路径：
C:Users<用户名>AppDataRoamingnpm - 添加 PATH 后重启终端
相关文章
-
教程上新丨16GB 笔记本跑出接近 26B MoE 性能：Gemma 4 12B 基于创新架构统一处理文本 / 图像 / 声音三种模态
游戏攻略 2026-07-03
-
Gemini 3.5 Live Translate - 谷歌打造的实时语音翻译与跨语言沟通模型
游戏攻略 2026-07-03
-
《王者荣耀世界》定云除厄记完成方法
游戏攻略 2026-07-03
-
LongCat-Video-Avatar 1.5开源：具备全领域泛化能力的音频驱动视频生成模型；AI Student Impact Dataset 5 万量级多
游戏攻略 2026-07-03
-
什么是 RAG？为什么仅靠大模型的记忆力远远不够
游戏攻略 2026-07-03
-
Agent 开发：你当真需要框架吗？
游戏攻略 2026-07-03
