Claude Code接入DeepSeek V4的兩種方法完整配置指南(2026最新)
Claude Code 是目前最好用的 AI 編程 Agent,但它默認只用 Anthropic 的模型,價格不便宜——Claude Max 5x 是 $100/月,Max 20x 是 $200/月。DeepSeek V4 發(fā)布當天就官方支持了 Claude Code,V4-Pro 在 SWE-bench 上和 Claude Opus 4.6 差 0.2%,但價格是后者的約 1/7。有人用 V4-Pro 跑了一整天的 Agent 任務(412 次工具調(diào)用),花了不到 $7。
這篇把兩種接入方法寫清楚:一種是新的桌面端 GUI 方式,一種是之前就有的終端環(huán)境變量方式——兩種都完整可用,各有適合的場景。

背景:DeepSeek 為什么能接入 Claude Code
DeepSeek-V4 在發(fā)布當天就與 Claude Code 實現(xiàn)了無縫集成,DeepSeek 自己內(nèi)部的 Agentic 編程也在用 V4。
能接入的根本原因是:DeepSeek 提供了 Anthropic 兼容的 API 端點。不是用代理層轉(zhuǎn)換——DeepSeek 的 /anthropic 端點接受原生 Anthropic SDK 請求格式,返回原生 Anthropic SDK 響應格式。Claude Code 根本不知道自己在和誰說話。
價格差距有多大?
# 成本對比(輸出 Token,官方標價)
prices = {
"Claude Opus 4.6": 25.00, # $25/M 輸出 token
"DeepSeek V4-Pro": 3.48, # $3.48/M 輸出 token ← ~7× 更便宜
"DeepSeek V4-Flash": 0.28, # $0.28/M 輸出 token ← ~89× 更便宜
}
# 一天重度 Agent 使用(實際案例)
# Claude Opus 4.6:頻繁觸發(fā) rate limit,三位數(shù)費用
# DeepSeek V4-Pro:412 次工具調(diào)用,$6.84(來源:FindSkill.ai 用戶測試)
方法一:桌面端 GUI(2026.04.14 新方式)

桌面端是什么
2026 年 4 月 14 日,Anthropic 發(fā)布了完全重新設計的 Claude Code 桌面端,包含管理多個并行 Session 的側(cè)邊欄、拖拽布局、集成終端和文件編輯器。
桌面端運行的是和 CLI 相同的底層引擎,但提供圖形界面。你可以同時在兩臺設備上運行,甚至針對同一個項目。它們通過 CLAUDE.md 文件共享配置和項目記憶。如果想把 CLI session 遷移到桌面端,在終端里運行 /desktop,Claude 會保存當前 session 并在桌面應用里打開它。
安裝桌面端
# macOS # 從 Claude 官網(wǎng)下載 Claude Desktop App # 或者: brew install --cask claude # Windows # 下載 .exe 或 MSIX 安裝包 # 地址:claude.ai/download # 安裝后,打開 Claude Desktop App # 點擊左上角 Chat 圖標旁邊的切換,找到 Code Tab(代碼標簽) # 首次在 Windows 上打開,需要先安裝 Git for Windows,安裝后重啟 App
桌面端配置 DeepSeek
桌面端和 CLI 共享同一套配置——通過環(huán)境變量或 ~/.claude/settings.json 配置好之后,桌面端會自動使用。
方式一:通過環(huán)境變量(推薦,啟動前設置)
# macOS / Linux:在 ~/.zshrc 或 ~/.bashrc 里加上 # DeepSeek API 配置 export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxx # 你的 DeepSeek API Key # 模型映射(Opus→Pro,Sonnet/Haiku→Flash) export ANTHROPIC_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash # 推理模式(對應 Claude 的 thinking) export CLAUDE_CODE_EFFORT_LEVEL=max # none / low / high / max # 保存后刷新配置 source ~/.zshrc # 然后啟動桌面 App,Code Tab 里就會用 DeepSeek V4
Windows PowerShell(持久化方式):
# 在 PowerShell 里運行(永久添加到用戶環(huán)境變量)
[System.Environment]::SetEnvironmentVariable(
"ANTHROPIC_BASE_URL",
"https://api.deepseek.com/anthropic",
"User"
)
[System.Environment]::SetEnvironmentVariable(
"ANTHROPIC_AUTH_TOKEN",
"sk-你的DeepSeekKey",
"User"
)
[System.Environment]::SetEnvironmentVariable(
"ANTHROPIC_MODEL",
"deepseek-v4-pro",
"User"
)
[System.Environment]::SetEnvironmentVariable(
"ANTHROPIC_DEFAULT_OPUS_MODEL",
"deepseek-v4-pro",
"User"
)
[System.Environment]::SetEnvironmentVariable(
"ANTHROPIC_DEFAULT_HAIKU_MODEL",
"deepseek-v4-flash",
"User"
)
[System.Environment]::SetEnvironmentVariable(
"CLAUDE_CODE_SUBAGENT_MODEL",
"deepseek-v4-flash",
"User"
)
# 設置完重啟 Claude Desktop App
桌面端的核心功能
配置好之后,桌面端里的 Claude Code 就在用 DeepSeek V4,同時可以用到這些 GUI 功能:
側(cè)邊欄 Session 管理: → 多個項目同時跑 Agent,一個視圖里切換 → 按狀態(tài)/項目/環(huán)境篩選和分組 并排面板(拖拽布局): → 聊天 + diff + 終端 + 文件編輯器 同時可見 → 拖拽調(diào)整布局,適配你的工作方式 集成終端: → 直接在 App 里跑測試和構(gòu)建命令 → 不需要切換到外部終端窗口 Side Chat(Cmd+;): → Agent 跑任務時,側(cè)問一個問題 → 知道主線程上下文,但不打斷主任務 → 對應的是之前講的 /btw 命令 內(nèi)置 diff 視圖: → 在 App 里審查 Agent 的改動 → 直接 approve / reject,不用開 git
從 CLI Session 遷移到桌面端
# 在終端里的 Claude Code session 里輸入: /desktop # 效果: # → Claude 保存當前 session # → 自動在桌面 App 里打開該 session # → 終端里的 CLI 退出 # → 繼續(xù)在 GUI 里工作,完整保留上下文
方法二:終端環(huán)境變量(經(jīng)典方式)
這是更早就有的方法,直接修改環(huán)境變量,靈活、輕量,適合不需要 GUI 的場景(服務器、SSH、習慣終端的開發(fā)者)。
快速配置(3 步)
# Step 1:安裝 Claude Code(如果還沒裝) npm install -g @anthropic-ai/claude-code # Step 2:獲取 DeepSeek API Key # 訪問 platform.deepseek.com → API Keys → Create new # Step 3:配置環(huán)境變量(Linux / macOS) export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeekKey export ANTHROPIC_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVEL=max # 啟動 claude
推薦:Shell 函數(shù),隨時切換
把多個模型提供商封裝成 Shell 函數(shù),一個命令就能切換:
# 加到 ~/.zshrc 或 ~/.bashrc
# ── DeepSeek V4(性價比首選)──
deepseek() {
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="${DEEPSEEK_API_KEY}"
export ANTHROPIC_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"
echo "?? 已切換到 DeepSeek V4(Pro + Flash 路由)"
claude "$@"
}
# ── 回到 Anthropic 官方模型(精確任務用)──
anthropic_claude() {
unset ANTHROPIC_BASE_URL
export ANTHROPIC_AUTH_TOKEN="${ANTHROPIC_API_KEY}"
unset ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL
echo "?? 已切換到 Anthropic Claude(官方 Opus)"
claude "$@"
}
# ── 只用 Flash(最省錢,簡單任務)──
deepseek_flash() {
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="${DEEPSEEK_API_KEY}"
export ANTHROPIC_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
echo "? 已切換到 DeepSeek V4-Flash(全Flash,最?。?
claude "$@"
}
保存后:
source ~/.zshrc # 用法 deepseek # 用 DeepSeek V4 啟動 Claude Code deepseek -p "幫我重構(gòu)這個函數(shù)" # 帶 prompt 直接啟動 anthropic_claude # 切回 Anthropic 官方
關(guān)鍵配置參數(shù)詳解
# 1. ANTHROPIC_BASE_URL # → 把 API 請求發(fā)到哪里 # → DeepSeek Anthropic 兼容端點:https://api.deepseek.com/anthropic # → 注意:末尾不加 /v1,DeepSeek 的兼容層路徑不同 # 2. ANTHROPIC_AUTH_TOKEN # → API Key(不是 Anthropic 的 Key,是 DeepSeek 的) # → 格式:sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 3. ANTHROPIC_MODEL # → Claude Code 主模型 # → deepseek-v4-pro(旗艦,復雜任務) # → deepseek-v4-flash(快速,簡單任務) # 4. ANTHROPIC_DEFAULT_OPUS_MODEL / SONNET / HAIKU # → 分別對應 Claude 的三個檔位 # → Haiku 是 Claude Code 內(nèi)部頻繁調(diào)用的"輕量工具" # → 把 Haiku → Flash,讓所有內(nèi)部小調(diào)用走最便宜的模型 # → 這里省的錢往往比 Opus 還多(調(diào)用次數(shù)多) # 5. CLAUDE_CODE_SUBAGENT_MODEL # → Sub-agent 使用的模型 # → 多 Agent 并發(fā)任務時生效 # → 推薦 Flash(子 Agent 用便宜的) # 6. CLAUDE_CODE_EFFORT_LEVEL # → 推理強度:none / low / high / max # → max = DeepSeek 的 Think Max 模式 # → 復雜任務用 max,簡單問答用 none
模型名稱注意事項(2026.04 最新)
最新正確的模型名(V4 發(fā)布后)
- ANTHROPIC_MODEL=deepseek-v4-pro # 旗艦
- ANTHROPIC_MODEL=deepseek-v4-flash # 快速版
舊名稱(2026.07.24 后停止支持)
- deepseek-chat → 等同于 deepseek-v4-flash non-thinking
- deepseek-reasoner → 等同于 deepseek-v4-flash thinking
[1m] 后綴(某些教程里有)
- deepseek-v4-pro[1m] → 明確指定 1M 上下文窗口版本
- 不加后綴默認也是 1M,加了更明確
兩種方法對比
| 桌面端 GUI | 終端環(huán)境變量 | |
|---|---|---|
| 配置方式 | 環(huán)境變量 + 啟動 App | 直接 export + 運行 |
| 適合場景 | 多項目并行、可視化審查 | 服務器、SSH、腳本集成 |
| 并行 Session | ? 側(cè)邊欄管理 | ? 需要多開終端 |
| diff 審查 | ? 內(nèi)置可視化 | ? 純文本 |
| CLI 遷移 | ? /desktop 命令 | 本體 |
| 切換模型 | 重新設置環(huán)境變量重啟 | 一行命令切換 |
| 系統(tǒng)資源 | 稍高(GUI 開銷) | 低 |
| SSH 遠程 | ? 支持 | ? 支持 |
成本優(yōu)化建議
Sub-agent 和 Haiku 路由是省錢關(guān)鍵
把 ANTHROPIC_DEFAULT_HAIKU_MODEL 設為 deepseek-v4-flash 意味著 Claude Code 進行的每一次輕量內(nèi)部調(diào)用(讀文件、概括函數(shù)等)都會路由到 V4-Flash,輸入價格約 $0.14/M token。這些小調(diào)用的累計才是真正的費用大頭。
# 省錢最大化配置 export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash # 輕量調(diào)用→Flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash # 子 Agent→Flash export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro # 核心推理→Pro # 結(jié)果:大量的文件讀取、函數(shù)分析、工具調(diào)用走 Flash(超便宜) # 只有核心決策和復雜推理才走 Pro(依然便宜)
按任務選推理強度
# 簡單任務(寫注釋、格式化、文檔) export CLAUDE_CODE_EFFORT_LEVEL=none # 或 low,速度快,省 token # 中等任務(功能實現(xiàn)、bug 修復) export CLAUDE_CODE_EFFORT_LEVEL=high # 復雜任務(架構(gòu)設計、多文件重構(gòu)、安全審查) export CLAUDE_CODE_EFFORT_LEVEL=max # 開啟 Think Max
踩坑記錄
# 坑1:模型名寫錯,報 404
# 癥狀:claude 啟動后立刻報 "model not found"
# 排查:
echo $ANTHROPIC_MODEL # 檢查是否設置正確
# 正確:deepseek-v4-pro 或 deepseek-v4-flash(注意沒有 deepseek- 前綴的老名字已停用)
# 坑2:ANTHROPIC_BASE_URL 末尾多了 /v1
# ? 錯誤:https://api.deepseek.com/anthropic/v1
# ? 正確:https://api.deepseek.com/anthropic
# DeepSeek 的 Anthropic 兼容層路徑不同于 OpenAI 兼容層
# 坑3:桌面端設置了環(huán)境變量但沒生效
# 原因:macOS 的 GUI 應用不讀取 Shell 的環(huán)境變量
# 解決方案A:在 /etc/launchd.conf 里設置(系統(tǒng)級)
# 解決方案B:通過 ~/.claude/settings.json 配置(推薦)
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "deepseek-v4-pro",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
}
}
EOF
# 解決方案C:用 launchctl 設置(macOS)
launchctl setenv ANTHROPIC_BASE_URL "https://api.deepseek.com/anthropic"
launchctl setenv ANTHROPIC_AUTH_TOKEN "sk-你的Key"
# 然后重啟 Claude Desktop App
# 坑4:Claude Code 報 "authentication error"
# 原因:ANTHROPIC_AUTH_TOKEN 里的 Key 是 Anthropic 的,不是 DeepSeek 的
# 兩個是不同賬戶的 Key!
# Anthropic Key:從 console.anthropic.com 獲?。╯k-ant- 開頭)
# DeepSeek Key:從 platform.deepseek.com 獲?。╯k- 開頭)
# 坑5:Think 模式響應里有 <think>...</think> 標簽
# 癥狀:V4 開了推理模式,回復里有大段思考過程
# Claude Code 通常會過濾,但有時會顯示出來
# 不影響功能,只是視覺上有點亂
總結(jié)
兩種方法選哪個:
→ 習慣終端 / 遠程服務器 / 需要快速切換模型
- 用:環(huán)境變量方式(方法二)
- 一行命令:deepseek 啟動,anthropic_claude 切回
→ 日常開發(fā) / 需要可視化 / 多項目并行
- 用:桌面端 GUI(方法一)
- 配置一次,在 settings.json 里寫死,App 里享受 GUI
關(guān)鍵配置(兩種方法通用): ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic ANTHROPIC_AUTH_TOKEN=你的DeepSeek API Key ANTHROPIC_MODEL=deepseek-v4-pro ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash ← 省錢關(guān)鍵 CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
成本參考:
- 一天重度 Agent 使用(400+ 工具調(diào)用):約 $7
- VS Claude Max 5x($100/月):同等工作量可能觸發(fā) rate limit
- 年度節(jié)?。簭?$1200/年 到 ~$60/年(來自實測數(shù)據(jù))
以上就是Claude Code接入DeepSeek V4的兩種方法完整配置指南(2026最新)的詳細內(nèi)容,更多關(guān)于Claude Code接入DeepSeek V4的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章

在Windows系統(tǒng)上配置Claude Code使用DeepSeek API的操作指南
在Windows系統(tǒng)上配置Claude使用使用DeepSeekAPI,需安裝Node.js、配置ClaD環(huán)境及設置DeepSeekAPI環(huán)境變量,本文詳細介紹了安裝步驟、配置方法及常用命令,助你快速上手,需要的2026-05-28
VS Code+Claude Code+Deepseek的使用小結(jié)
本文詳細介紹了在VSCode中配置ClaudeCode插件并集成Deepseek AI模型的方法,文中通過圖文示例介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下2026-05-26
在Claude Code中配置DeepSeek從報錯到成功調(diào)用的全流程
本文記錄了在 Claude Code 中配置 DeepSeek 的完整流程,從連接錯誤到成功調(diào)用,分三階段詳解配置方法,并提供 V4 模型適配方案及多家國產(chǎn)大模型對接指南,需要的朋友可以參2026-05-13
VScode如何使用Claude Code接入Deepseek
本文介紹了VScode如何使用Claude Code接入Deepseek,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習2026-05-08
在Claude Code中接入DeepSeek-V4的完整指南
Claude Code的價值,在于把代碼理解、修改、執(zhí)行和驗證整合進同一條工作鏈路,如果你已經(jīng)在使用Claude Code,又希望把底層模型切換到DeepSeek-V4,這篇文章可以直接幫你完2026-05-06
Claude Code接入DeepSeek兼容端點的配置教程
文章介紹了如何通過環(huán)境變量配置將ClaudeCode的API后端切換為DeepSeek提供的Anthropic兼容端點,詳細說明了在Windows和Linux/macOS上的配置步驟,并提供了完整的配置示例,還2026-05-01
Claude Code零改動接入DeepSeek V4的詳細過程
文章介紹了cc-use工具,作為ClaudeCodeDe的啟動器,解決了在不同不同Anthropop提供者之間切換時環(huán)境變量沖突的問題,文章詳細描述了如何使用cc-use工具接通DeepSeekV4端點,需2026-04-28








