Claude Code對(duì)接DeepSeek的完整使用教程(2026 最新版)
一、概述
Claude Code 是 Anthropic 推出的終端級(jí) AI 編程代理,以命令行形式運(yùn)行在項(xiàng)目目錄中。它不僅能回答問題,還能直接讀寫文件、執(zhí)行命令、運(yùn)行測(cè)試,像一個(gè)真正理解代碼庫的協(xié)作者參與開發(fā)。
DeepSeek 提供了 Anthropic API 兼容接口,因此只需修改幾個(gè)環(huán)境變量,就能將 Claude Code 的底層模型從 Anthropic 切換到 DeepSeek,享受 DeepSeek V4 系列模型的編程能力。
核心優(yōu)勢(shì)
| 能力 | 說明 |
|---|---|
| 代碼理解與生成 | 讀取、編寫、重構(gòu)代碼,跨文件追蹤依賴 |
| 命令執(zhí)行與集成 | 直接執(zhí)行 Shell 命令,運(yùn)行測(cè)試,操作 Git |
| 項(xiàng)目研究與規(guī)劃 | 快速理解陌生代碼庫,分析架構(gòu),制定實(shí)施計(jì)劃 |
| Web Search | DeepSeek 原生支持 Claude Code 的 Web Search 功能 |
二、準(zhǔn)備工作
在開始之前,確認(rèn)以下條件:
- 操作系統(tǒng):Windows 10 2004+ / Windows 11(64 位)、macOS、Linux
- Node.js 18+:npm 安裝 Claude Code 時(shí)需要
- DeepSeek API Key:在 DeepSeek 開放平臺(tái) 創(chuàng)建
- 終端環(huán)境:
- Windows:PowerShell(推薦)、Windows Terminal、Git Bash、WSL
- macOS / Linux:Bash、Zsh、Fish
- 網(wǎng)絡(luò):能訪問外網(wǎng)或配置代理
如果你已經(jīng)安裝了 Claude Code,可以跳過第三、四節(jié),直接看「五、配置 DeepSeek」。
三、安裝 Node.js
Claude Code 的 npm 安裝方式依賴 Node.js 18+。當(dāng)前 Node.js 最新 LTS 版本為 v24.17.0(代號(hào) Krypton),Current 版本為 v25.x。推薦安裝 LTS 版本以獲得更好的穩(wěn)定性。
方法一:官方安裝包(最簡單)
適合大多數(shù)用戶,開箱即用。
- 訪問 Node.js 官網(wǎng)下載頁
- 下載 LTS 版本對(duì)應(yīng)的安裝包:
- Windows:
.msi安裝包 - macOS:
.pkg安裝包
- Windows:
- 雙擊運(yùn)行安裝程序,一路 Next 使用默認(rèn)選項(xiàng)
- 驗(yàn)證安裝:
node -v # 應(yīng)顯示 v24.17.0 或更高 npm -v # 應(yīng)顯示 11.13.0 或更高
方法二:nvm(Node Version Manager)—— 推薦
nvm 允許在同一臺(tái)機(jī)器上安裝和切換多個(gè) Node.js 版本,是開發(fā)者最常用的方式。
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 # 驗(yàn)證 node -v npm -v
Windows:nvm-windows
nvm-windows 是 nvm 的 Windows 移植版。
- 訪問 nvm-windows GitHub Releases
- 下載最新的
nvm-setup.exe - 雙擊安裝(注意:安裝路徑不要包含中文或空格)
- 安裝完成后重啟終端,執(zhí)行:
nvm list available # 查看可用版本 nvm install 24.17.0 # 安裝指定版本 nvm use 24.17.0 # 切換版本 node -v # 驗(yàn)證
方法三:fnm(Fast Node Manager)—— 新一代推薦
fnm 是用 Rust 編寫的現(xiàn)代化 Node.js 版本管理器,比 nvm 更快,跨平臺(tái)支持更好。
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 # 設(shè)為默認(rèn)版本 node -v # 驗(yàn)證
fnm vs nvm 對(duì)比:fnm 啟動(dòng)速度更快(Rust 實(shí)現(xiàn)),跨平臺(tái)體驗(yàn)一致,配置更簡單。如果你是新用戶,推薦直接使用 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
配置國內(nèi)鏡像源(可選,加速下載)
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
安裝后驗(yàn)證:
claude --version claude doctor # 檢查安裝狀態(tài)和環(huán)境
方法二:npm 安裝
如果你已經(jīng)安裝了 Node.js 18+:
npm install -g @anthropic-ai/claude-code
如果遇到網(wǎng)絡(luò)問題,使用國內(nèi)鏡像:
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
驗(yàn)證:
claude --version
注意:不建議使用 sudo npm install -g,否則后續(xù)自動(dòng)更新和權(quán)限管理會(huì)比較麻煩。
方法三:winget 安裝(Windows)
winget install Anthropic.ClaudeCode
安裝后重啟終端再驗(yàn)證。
五、配置 DeepSeek
DeepSeek 提供了 Anthropic API 兼容地址,核心配置就是將 Claude Code 的 API 地址、Token 和模型名改為 DeepSeek。
5.1 獲取 DeepSeek API Key
- 訪問 DeepSeek 開放平臺(tái)
- 注冊(cè) / 登錄賬號(hào)
- 創(chuàng)建 API Key,復(fù)制保存(形如
sk-xxxxxxxx)
5.2 臨時(shí)配置(當(dāng)前終端窗口生效)
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(當(dāng)前用戶永久生效):
[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")
設(shè)置后重啟終端生效。
方式二:使用 Claude Code 的 settings.json(推薦)
這種方式只影響 Claude Code,不會(huì)污染系統(tǒng)環(huán)境變量,更加干凈。
編輯或創(chuàng)建 ~/.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 字段,不要覆蓋整個(gè)文件。
5.4 環(huán)境變量說明
| 變量名 | 說明 | 推薦值 |
|---|---|---|
ANTHROPIC_BASE_URL | API 基礎(chǔ)地址 | https://api.deepseek.com/anthropic |
ANTHROPIC_AUTH_TOKEN | API 密鑰 | 你的 DeepSeek API Key |
ANTHROPIC_MODEL | 主模型 | deepseek-v4-pro[1m] |
ANTHROPIC_DEFAULT_OPUS_MODEL | Opus 級(jí)別模型 | deepseek-v4-pro[1m] |
ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet 級(jí)別模型 | deepseek-v4-pro[1m] |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku 級(jí)別模型(輕量任務(wù)) | deepseek-v4-flash |
CLAUDE_CODE_SUBAGENT_MODEL | 子代理模型 | deepseek-v4-flash |
CLAUDE_CODE_EFFORT_LEVEL | 推理努力程度 | max |
模型映射說明:DeepSeek 會(huì)將 claude-opus 開頭的模型映射到 deepseek-v4-pro,將 claude-haiku、claude-sonnet 開頭的模型映射到 deepseek-v4-flash。
六、驗(yàn)證是否生效
6.1 啟動(dòng) Claude Code
進(jìn)入你的項(xiàng)目目錄:
cd /path/to/my-project claude
6.2 基本測(cè)試
啟動(dòng)后問一個(gè)簡單問題:
請(qǐng)用一句話說明當(dāng)前項(xiàng)目的技術(shù)棧。
如果 Claude Code 能正常返回,并且 DeepSeek 控制臺(tái) 出現(xiàn)了 API 調(diào)用記錄,說明接入成功。
6.3 檢查配置狀態(tài)
在 Claude Code 內(nèi)執(zhí)行:
/status
查看當(dāng)前配置來源,確認(rèn)環(huán)境變量是否被正確讀取。
七、常見問題
1. 提示 API Key 無效
- 確認(rèn)
ANTHROPIC_AUTH_TOKEN填的是 DeepSeek API Key(sk-開頭),不是 Anthropic 的 Key - 不要把尖括號(hào)一起填進(jìn)去:
# 錯(cuò)誤 export ANTHROPIC_AUTH_TOKEN=<sk-xxxxxxxx> # 正確 export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxx
2. 請(qǐng)求超時(shí)
長任務(wù)或大文件分析可能觸發(fā)超時(shí),可以增加超時(shí)時(shí)間:
export API_TIMEOUT_MS=600000 # 10 分鐘
3. 模型名報(bào)錯(cuò)
DeepSeek 的模型名可能隨平臺(tái)更新變化。如果 deepseek-v4-pro[1m] 不可用,可先換成通用模型:
export ANTHROPIC_MODEL=deepseek-chat export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat
實(shí)際可用模型以 DeepSeek 官方文檔 為準(zhǔn)。
4. npm 安裝 Claude Code 失敗
檢查 Node.js 版本:
node -v # 需要 >= 18 npm -v
版本太低則先升級(jí) Node.js,再重新安裝。如果網(wǎng)絡(luò)問題,使用國內(nèi)鏡像:
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
5. Windows 下claude命令找不到
- 確認(rèn)安裝路徑已加入系統(tǒng) PATH
- 官方腳本安裝路徑:
C:\Users\<用戶名>\.local\bin - npm 安裝路徑:
C:\Users\<用戶名>\AppData\Roaming\npm - 添加 PATH 后重啟終端
到此這篇關(guān)于Claude Code對(duì)接DeepSeek的完整使用教程(2026 最新版)的文章就介紹到這了,更多相關(guān)Claude Code對(duì)接DeepSeek內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Claude Code配置本地Ollama模型或別的模型(Deepseek等)的實(shí)踐指南
本文詳細(xì)介紹了如何使用Claude Code Router將Ollama或DeepSeek等非Anthropic模型接入Claude Code,包括安裝、配置步驟及常見問題排查,通過協(xié)議轉(zhuǎn)換網(wǎng)關(guān),需要的朋友可以參考2026-06-26
VSCode+ClaudeCode+Deepseek的配置與聯(lián)動(dòng)搭建
,本文詳細(xì)介紹了在VSCode中配置ClaudeCode插件并集成Deepseek AI模型的方法,該方案實(shí)現(xiàn)了編輯器與AI助手的無縫協(xié)同,適用于開發(fā)調(diào)試、文檔編寫等場(chǎng)景,感興趣的可以了解一下2026-06-26
Claude Code接入DeepSeek的保姆級(jí)教程
本文詳細(xì)介紹了將Claudede切換至DeepSeek的的優(yōu)勢(shì)與操作方法,包括費(fèi)用對(duì)比、配置步驟及避坑指南,幫助DeepSeek為更經(jīng)濟(jì)高效的AI編程工具,需要的朋友可以參考下2026-06-10
Claude Code接入DeepSeek V4的兩種方法完整配置指南(2026最新)
Claude Code 是目前最好用的 AI 編程 Agent,但它默認(rèn)只用 Anthropic 的模型,價(jià)格不便宜,本文主要介紹了Claude Code接入DeepSeek V4的兩種方法,有需要的小伙伴可以了解2026-06-03
在Windows系統(tǒng)上配置Claude Code使用DeepSeek API的操作指南
在Windows系統(tǒng)上配置Claude使用使用DeepSeekAPI,需安裝Node.js、配置ClaD環(huán)境及設(shè)置DeepSeekAPI環(huán)境變量,本文詳細(xì)介紹了安裝步驟、配置方法及常用命令,助你快速上手,需要的2026-05-28
VS Code+Claude Code+Deepseek的使用小結(jié)
本文詳細(xì)介紹了在VSCode中配置ClaudeCode插件并集成Deepseek AI模型的方法,文中通過圖文示例介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下2026-05-26
在Claude Code中配置DeepSeek從報(bào)錯(cuò)到成功調(diào)用的全流程
本文記錄了在 Claude Code 中配置 DeepSeek 的完整流程,從連接錯(cuò)誤到成功調(diào)用,分三階段詳解配置方法,并提供 V4 模型適配方案及多家國產(chǎn)大模型對(duì)接指南,需要的朋友可以參2026-05-13
VScode如何使用Claude Code接入Deepseek
本文介紹了VScode如何使用Claude Code接入Deepseek,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)2026-05-08
在Claude Code中接入DeepSeek-V4的完整指南
Claude Code的價(jià)值,在于把代碼理解、修改、執(zhí)行和驗(yàn)證整合進(jìn)同一條工作鏈路,如果你已經(jīng)在使用Claude Code,又希望把底層模型切換到DeepSeek-V4,這篇文章可以直接幫你完2026-05-06
Claude Code接入DeepSeek兼容端點(diǎn)的配置教程
文章介紹了如何通過環(huán)境變量配置將ClaudeCode的API后端切換為DeepSeek提供的Anthropic兼容端點(diǎn),詳細(xì)說明了在Windows和Linux/macOS上的配置步驟,并提供了完整的配置示例,還2026-05-01











