DeepSeek接入Claude Code教學：環境變量配置、模型映射與常見問題

適用於誰

• 搜「deepseek 接入 claude code」「deepseek接入claude」，想用 DeepSeek 的 API 驅動 Claude Code 這個終端編程工具的開發者；
• 已經照着舊教學配過，但模型名對不上或報錯的人。

本文根據 DeepSeek 官方「接入 Claude Code」文檔整理，資料核對於 2026-10-11。這是 DeepSeek 一側提供的兼容接口用法，Claude Code 本身的功能說明見《Claude Code 入門》。

結論先說

1. 原理是把 Claude Code 的請求地址換成 DeepSeek 的 Anthropic 兼容接口 https://api.deepseek.com/anthropic，用 DeepSeek 的 API Key 認證。
2. 只需要設定幾個環境變量，不用改 Claude Code 的任何文件。
3. 費用走 DeepSeek 開放平台的餘額，按 token 計費，和 Claude 訂閱無關。
4. 效果取決於模型：換成 DeepSeek 後，寫代碼的水平是 DeepSeek 模型的水平，工具本身的權限、命令、插件機制不變。

步驟

1. 準備：Key 和 Claude Code

• 在 DeepSeek 開放平台創建 API Key 並保證有餘額，見《DeepSeek API Key 怎麼獲取》；
• 還沒裝 Claude Code 的話，官方文檔的裝法是：先裝 Node.js 18 及以上（Windows 還需要 Git for Windows），然後執行

bash
npm install -g @anthropic-ai/claude-code
claude --version      # 能顯示版本號就是裝好了

2. 配置環境變量

macOS / Linux（在終端裏執行，或寫進 ~/.zshrc、~/.bashrc）：

bash
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

Windows PowerShell：

powershell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

這些變量各自的作用：

• ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN：請求發到哪裏、用哪個 Key；
• ANTHROPIC_MODEL 和三個 DEFAULT_*_MODEL：Claude Code 內部會按任務輕重選不同檔位的模型，這裏把每個檔位都指到 DeepSeek 的模型上。模型名後的 [1m] 是官方文檔給的寫法，對應 1M 上下文；
• CLAUDE_CODE_SUBAGENT_MODEL：子代理用的模型；
• CLAUDE_CODE_EFFORT_LEVEL：思考強度；
• CLAUDE_CODE_AUTO_COMPACT_WINDOW：對話多長時自動壓縮上下文。

在 PowerShell 裏用 $env: 設定的變量只對當前窗口有效，關掉窗口就沒了；想長期生效，可以寫進 PowerShell 的配置文件或系統的用戶環境變量。

3. 進入項目目錄啟動

bash
cd /path/to/my-project
claude

啟動後先問一個簡單問題（比如「這個項目是做什麼的」）確認能正常返回，再開始真正的任務。

4. 了解模型名映射

官方文檔說明，使用 Claude Code 或 Claude Desktop App 時，DeepSeek 會對傳入的 Claude 模型名做映射：

• claude-opus 開頭的模型名 → deepseek-v4-pro，按 V4 Pro 的價格計費；
• claude-haiku、claude-sonnet 開頭的模型名 → deepseek-flash。

所以如果你沒有像上面那樣把各檔位都顯式指到 deepseek-flash，在工具裏切到 Opus 檔時，實際用的是價格更高的 deepseek-v4-pro。想控制成本，就按第 2 步把變量配全。

5. Web Search 會額外計費

官方文檔說明，DeepSeek API 原生支持 Claude Code 裏的 Web Search：模型判斷需要搜尋時會調用搜索工具，並通過 DeepSeek 提供的接口完成搜尋。搜尋結果需要再用模型總結，因此會產生額外的 token 費用。不想花這部分錢，就在提問時說明「不要聯網搜尋」，或者在權限設定裏不允許該工具。

常見問題

Q：啟動後提示認證失敗（401）？

Key 寫錯或沒生效。用 echo $ANTHROPIC_AUTH_TOKEN（PowerShell 用 echo $env:ANTHROPIC_AUTH_TOKEN）確認變量存在；檢查有沒有把尖括號一起寫進去。

Q：提示餘額不足（402）？

DeepSeek 開放平台餘額用完了，充值後重試。Agent 類工具消耗 token 很快，建議定期在平台的用量頁面查看。

Q：怎麼省錢？

三個辦法：各檔位都指向 deepseek-flash；把批量任務放到空閒時段（官方定價裏空閒時段是高峰價格的一半）；讓上下文盡量複用——緩存命中的輸入價格遠低於未命中。

Q：怎麼切回原來的 Claude 帳號？

刪掉這些環境變量（unset ANTHROPIC_BASE_URL 等，或開一個沒有設定過的新終端）再啟動即可。

Q：Claude Code 的功能在 DeepSeek 下都能用嗎？

DeepSeek 的 Anthropic 兼容接口文檔列出了支持和不支持的字段，並非全部一致（例如部分服務端工具類型不支持）。常規的讀寫文件、執行命令、工具調用可以用，個別依賴 Anthropic 專有能力的功能以實際表現和官方兼容性表為準。

Q：除了 Claude Code 還能接哪些工具？

DeepSeek 文檔的「接入 Agent 工具」一欄還列了 Codex、OpenCode、OpenClaw、Hermes、Qoder 等，各有單獨的接入頁面。

參考資料

• DeepSeek API 文檔：接入 Claude Code — https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
• DeepSeek API 文檔：Anthropic API 兼容說明 — https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
• DeepSeek API 文檔：模型與價格 — https://api-docs.deepseek.com/zh-cn/quick_start/pricing
• DeepSeek API 文檔：錯誤碼 — https://api-docs.deepseek.com/zh-cn/quick_start/error_codes