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

一、概述

程序员圈子里，终端级AI编程工具又多了一个重磅选手——Claude Code。这是Anthropic推出的终端级AI编程袋里，直接跑在项目目录的命令行里。它不是那种只能陪你聊天的玩具，而是能读懂代码库、直接读写文件、执行shell命令、运行测试、操作Git的那个协作者。 事情的有趣之处在于，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 - npm安装Claude Code时必需 - 在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版本，开发者最常用的方式。 ``` # 安装 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 ``` nvm-windows是nvm的Windows移植版。 1. 访问nvm-windows GitHub Releases 2. 下载最新的nvm-setup.exe 3. 双击安装（注意安装路径不要含中文或空格） 4. 安装完成后重启终端，执行： ``` nvm list a vailable # 查看可用版本 nvm install 24.17.0 # 安装指定版本 nvm use 24.17.0 # 切换版本 node -v # 验证 ```

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

fnm是用Rust写的现代版Node.js版本管理器，比nvm更快，跨平台支持也更好。 ``` winget install Schniz.fnm ``` ``` # macOS (Homebrew) brew install fnm # 或使用安装脚本 curl -fsSL https://fnm.vercel.app/install | bash ``` ``` fnm install --lts # 安装最新 LTS fnm use 24 # 使用 Node.js 24 fnm default 24 # 设为默认版本 node -v # 验证 ``` 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。 ``` curl -fsSL https://claude.ai/install.sh | bash ``` ``` 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 临时配置（当前终端窗口生效）

``` 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 ``` ``` $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 持久化配置

macOS/Linux（Zsh）：nano ~/.zshrc macOS/Linux（Bash）：nano ~/.bashrc 在文件末尾追加环境变量设置（内容同上），保存后重新加载： ``` 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，不污染系统环境变量，更干净。 编辑或创建~/.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<用户名>.localin` - npm安装路径：`C:Users<用户名>AppDataRoaming pm` - 添加PATH后重启终端