Claude Code 接入 DeepSeek 怎麼配：10 月 17 日起 Claude Code、Codex、Harness 三種用法

部落格 / 開發工具

Claude Code 接入 DeepSeek 怎麼配：10 月 17 日起 Claude Code、Codex、Harness 三種用法

cdnping 編輯部約 3 分鐘讀完

Claude Code 接入 DeepSeek 不需要改工具本身：設定 ANTHROPIC_BASE_URL 指向 https://api.deepseek.com/anthropic，再把 ANTHROPIC_AUTH_TOKEN 換成 DeepSeek 的 API Key 即可。Codex 則從 2026 年 8 月 13 日起可以透過 Responses API 直接連 DeepSeek。10 月 17 日，DeepSeek 釋出 DeepSeek-V4.1-Flash-1017，並建議使用 DeepSeek Harness 0.2.1-rc.1 或更高版本。

以下內容截至 2026 年 10 月 17 日，均來自 DeepSeek 官方文件，配置項以官方頁面為準。

10 月 17 日 DeepSeek 釋出了什麼？

根據 官方更新日誌 和 10 月 17 日公告：

  • 釋出 DeepSeek-V4.1-Flash-1017，公告稱已在網站、App 和 API 上線，並針對 DeepSeek Harness 等工具做了最佳化。
  • Search 與 Fetch API 對所有人開放，公告寫明每個介面每 1000 次呼叫 0.75 美元。
  • 透過 DeepSeek Harness、Claude Code、Codex 的服務端工具發起的搜尋呼叫，目前對 DeepSeek API 使用者免費；公告寫明從 2026 年 10 月 31 日 16:00 UTC 開始計費，換算成北京時間是 11 月 1 日 0 點。
  • 官方建議升級到 DeepSeek Harness 0.2.1-rc.1 或更高版本。

Codex 的適配更早：8 月 13 日的更新寫明 DeepSeek API 原生支援 OpenAI Responses API 格式，並專門適配了 Codex。

Claude Code 怎麼接 DeepSeek？

首頁 列出兩個入口：OpenAI 格式用 https://api.deepseek.com，Anthropic 格式用 https://api.deepseek.com/anthropic。Claude Code 走後者。

按 官方 Claude Code 指南，已裝好 Claude Code 的人只需設定環境變數（Linux/macOS）：

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

然後 cd 到專案目錄執行 claude。Windows PowerShell 的寫法在官方頁面上有對應版本。幾點說明：

  • API Key 在 DeepSeek 開放平臺 建立。
  • 官方頁面寫明：模型名以 claude-opus 開頭的會對映到 deepseek-v4-pro，按 Pro 價格計費；以 claude-haiku 或 claude-sonnet 開頭的對映到 deepseek-flash。
  • 想固定用哪個模型，就明確設定上面幾個模型變數，不要依賴預設值。
  • Claude Code 可以呼叫 DeepSeek 的聯網搜尋，這會額外產生模型 token 費用，搜尋請求按 Search API 定價。

自定義介面地址在不同版本下的許可權和上下文行為有差異，可以參考 Claude Code 接自定義介面地址 和 自定義 API 與 Codex、OpenCode 介面地址配置。

Codex 怎麼用 DeepSeek？

官方 Codex 指南 提供兩種方式：

  1. 指令碼方式：官方提供 macOS/Linux 和 Windows 的配置指令碼，指令碼會把原有 config.toml 備份到 ~/.codex/backup-deepseek/，選單裡可以選模型，也可以恢復原配置。執行網路上的指令碼前，建議先下載下來看一遍內容。
  2. 手動方式：建立 ~/.codex/models.json（內容從官方頁面複製），再編輯 ~/.codex/config.toml。核心部分如下：
model = "deepseek-flash"
model_provider = "deepseek"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<你的 DeepSeek API Key>"

官方完整示例還包含 model_catalog_json、preferred_auth_method 等設定，請以頁面為準。如果你的配置檔案裡已經有 [desktop] 段，只追加官方示例裡的那一行，重複段會讓檔案失效。啟動後，橫幅裡應顯示 model: deepseek-flash。

注意 experimental_bearer_token 是把 Key 明文寫進配置檔案，不要把這個檔案提交到倉庫或發給別人。官方頁面還提到，示例預設關閉聯網搜尋（web_search = "disabled"），Codex 的聯網搜尋需要 deepseek-v4-pro，且按 Search API 計費。

DeepSeek Harness 是什麼？

官方公告沒有給出定義。從 Harness 快速入門頁 能確認的是：它有 Web UI，啟動命令是 dsh，程序會把啟動目錄作為預設工作目錄；在 Settings → Models 填入 DeepSeek API Key 後無需重啟生效；選好工作區後，agent 可以讀寫檔案、執行命令、委派任務並維護計劃，受限操作會先請求批准。文件還提到 CLI、Python SDK 和外掛開發指南。安裝方式見專案 README，本文不展開。

怎麼檢查是否接通了？

現象先查什麼
Claude Code 提示認證失敗ANTHROPIC_AUTH_TOKEN 是否是 DeepSeek 的 Key，同一終端是否殘留原來的 Anthropic 相關變數
Codex 仍顯示舊模型修改後是否重啟，橫幅是否為 model: deepseek-flash
請求超時或很慢先排除網路，再看服務端
搜尋產生費用11 月 1 日（北京時間）前官方說明免費，之後按 Search API 計費

排查網路時，可以先開啟 cdnping 首頁 測 DeepSeek 的首次連線（含 DNS 與 TLS）和往返延遲，再看 DeepSeek API 狀態 判斷是不是服務端問題。國內延遲的判斷思路見 國內使用 AI API 指南 和 AI API 延遲。

價格方面，DeepSeek 有高峰和錯峰兩檔，錯峰為高峰的一半，計算方式見 高峰和錯峰價格怎麼算；搜尋介面的呼叫方式見 Search & Fetch API 怎麼收費。

思考強度該選哪一檔？

Codex 指南里的 models.json 宣告的檔位是 low、high、max。Claude Code 指南里預設示例是 CLAUDE_CODE_EFFORT_LEVEL=max，Codex 示例裡是 model_reasoning_effort = "high"。我沒有看到官方給出按任務選檔的建議，可以自己用同一個任務各跑一次，對比耗時和 token 用量，不要憑感覺定。

同樣只改介面地址的其他方式

如果你的需求是在一份訂閱裡切換多個模型，同樣是改一個介面地址的思路也適用於 AGI Plan。AGI Plan 是 cdnping 的商業合作方，不是官方授權渠道，具體可用模型以 agiplan.dev/models 為準。這與直連 DeepSeek 是兩條獨立的路線，按自己的付費和合規需求選擇即可。

參考來源

相關文章

繼續閱讀