DeepSeek 推出自己的 Claude Code：開源免費的 Harness，安裝、換模型、叫 Claude Code 當子代理

DeepSeek 推出了自己的 Claude Code，叫 DeepSeek Harness，官方開源、MIT 授權，軟體本身免費。我最有興趣的是它的設計：模型、工具、紀錄，連代理迴圈都是外掛，都能換；還能把 Claude Code 和 Codex 叫來當子代理。這篇是 Reels 裡 HARNESS 那段的完整版：它是什麼、怎麼用 npx 或桌面版開起來、怎麼填 API key 換模型、怎麼開子代理，還有幾個一定要先知道的限制。

01它是什麼，你會拿到什麼

DeepSeek Harness（指令叫 dsh）是 DeepSeek 官方開源的 AI 代理工具，定位像 Claude Code 這一類。你給它一個專案資料夾，它能讀檔、改檔、跑指令、列計畫；碰到需要確認的操作，會先問你。授權是 MIT，軟體本身免費。

DeepSeek 官方頁面和它的桌面 App 視窗，右邊蓋著紅色「開源・免費」標籤，下方是橘色小方塊吉祥物 — Reels 開頭：官方頁面裡的 App 視窗，就是你開起來會看到的樣子。

它是 DeepSeek 自己的官方專案，不是第三方改的。GitHub 上我們在 2026/10/20 查到約 25.5 萬顆星；Reels 拍的時候是 253,520，數字天天在漲。

GitHub 頁面放大到 Star 按鈕，旁邊一個計數器顯示 253,520，吉祥物在右下角 — Reels 裡的 GitHub 畫面：拍片當天 253,520 顆星。

先說清楚：這篇是我照官方 README 和文件整理的，我們沒有自己安裝實測。每一步我都標了官方出處，介面和版本可能已經變了，以官方為準。下面的圖有兩種：橘色小方塊吉祥物的是我們 Reels 的畫面，其餘是我們 2026/10/19 擷取的官方頁面。

用一行 npx 指令，或下載桌面版，把它開起來。
在 Settings → Models 填 API key。DeepSeek、Anthropic、OpenAI 等都可以。
搞懂「一切皆外掛」是什麼意思，哪些東西可以換。
把 Claude Code、Codex 叫來當子代理。
先看完官方列出的限制和安全提醒，再決定要不要用。

02開始前要準備的 3 樣東西

Node.js 22.19 以上。官方 repo 的 package.json 寫 22.19.0 以上（或 24 以上）。終端機輸入下面那行，看到的版本要夠新。
一組 API key。DeepSeek 的 key 最直接；用 Anthropic（Claude）或 OpenAI 也行。軟體免費，但模型用量是你的 API 供應商在計費。
一個「弄壞也不心痛」的資料夾。它能改檔、跑指令，第一次先拿測試用的專案或複製一份，不要直接對重要資料夾開。

終端機：檢查 Node.js 版本

node -v

03方法一：用 npx 開網頁版（5 步）

開終端機，貼上下面這行。第一次會下載套件，要等一下。
它預設在 http://127.0.0.1:3080 開網頁版，並自動用你的預設瀏覽器打開。不想自動開，就在指令後面加 --no-open。
到 Settings → Models，在 DeepSeek 那張卡片填 API key，按 Apply 儲存。
按 Choose workspace，選你要它工作的專案資料夾。官方說沒選資料夾前，輸入框不能用。
送出第一個任務，看它怎麼回。

終端機：開網頁版

npx @deepseek-ai/dsh web

官方 README 的截圖：Developer preview 警告，下面是 Run from npm 和 npx @deepseek-ai/dsh web 這行指令 — 官方 README（2026/10/19 擷取）：先裝 Node.js，再跑這一行。

官方文件的截圖：Settings 裡的 Models 頁，DeepSeek 卡片有一個 API key 欄位和 Apply 按鈕，下面是 Add model provider — 官方文件裡的 Models 頁：填 key、按 Apply。

官方說 key 是「只寫入」的：存好之後頁面只會看到遮住的版本，不會再顯示原文。key 存在你電腦的 $DSH_HOME/.credentials.yaml。換模型設定後，下一次請求就生效，不用重開伺服器。

第一個任務（官方指南的範例，我加了中文版）

請摘要這個專案，並列出主要的程式套件。
（官方原文：Summarize this repository and identify its main packages.）

04方法二：下載桌面版

打開官方頁面 deepseek.com/harness，按 Download Desktop。
選你的系統。官方頁面目前只列兩個：macOS（Apple 晶片）和 Windows（64 位元）。Intel Mac 不在清單上。
安裝後打開。畫面左邊有 New Session、Plugins、Automation 和 Workspace。
填 API key 的地方，官方網頁版教學寫在 Settings → Models。桌面版沒有官方的逐步說明，找不到就以 App 裡的設定為準。

官方頁面的「Download for Windows」按鈕被黃色圈圈起來，吉祥物站在旁邊 — Reels 裡標出官方頁面的下載按鈕。

05一切皆外掛：哪些東西能換

官方架構文件寫得很直接：產品的每一個部分都是外掛，包括模型轉接器、工具、紀錄（session log），連代理迴圈本身，所以每一個都能從設定換掉。這就是 Reels 裡「連代理迴圈都能換」的出處。

一個寫著「寫死」的灰色鐵盒，旁邊的釘板上掛著模型、工具、紀錄、代理迴圈四個彩色積木外掛 — 多數工具是寫死的鐵盒；它是一塊塊能拔、能插的積木。

官方 architecture.md 頁面，其中 Every part of the product is a plugin 那段被黃色螢光筆標出 — 官方 architecture.md：這句話是整個設計的核心。

打開 Settings → Models，按 Add model provider。
預設會停在 Third-party model provider。從清單挑一家，官方文件列的 id 例如 anthropic、openai、moonshotai（Kimi）、zai（GLM）。
填那一家的 API key，儲存。端點和模型清單由它內建的目錄提供。
回到對話輸入框旁的模型選單，選你要用的模型。選了之後它就是新對話的預設。

一台復古遊戲機，卡匣上寫著 GPT，旁邊的招牌寫 LAB，吉祥物在右下 — 卡匣換成 Claude、GPT：換的是模型，工具和迴圈不變。

清單裡沒有的模型，用「Custom model API」。官方寫它適合中轉站、公司內部閘道或自己架的伺服器。要填的欄位如下。注意：這代表你得先有一個能回應的服務，不是它自己就能離線跑模型。

Custom model API 要填的欄位（把［］換成你的）

Provider ID：［小寫英文，例如 my-gateway］
Base URL：［你的服務網址，例如 https://gateway.example/v1］
API protocol：［OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三選一］
API key：［你的 key］
Model：［至少一個模型 id］

06最狂的：叫 Claude Code 和 Codex 來當子代理

官方有兩個內建的外部子代理套件：subagent-claude-code 和 subagent-codex。開啟後，Harness 的主代理可以把一個獨立任務丟給它們，各自在你的專案資料夾裡開一個全新的 Claude Code 或 Codex 工作階段去做。

GitHub 的 packages/subagent 資料夾清單，兩個子代理套件被標亮，桌子兩側是橘色 Claude Code 和黑色 Codex 小幫手 — Reels 裡用官方的 packages/subagent 資料夾做背景；兩個小幫手是我們的示意畫。

在網頁版或桌面版打開 Plugins 頁。
找到「Claude Code subagent」，開啟。要用 Codex 的話，再開「Codex subagent」。
如果安裝程式說需要重新啟動，就重開一次。開啟後，主代理會多一個 subagent_claude_code（或 subagent_codex）工具可以呼叫。
在對話裡用下面這種句子，請主代理把任務分出去。

分工 prompt（範例，是我自己寫的，不是官方範本；把［］換成你的任務）

請把下面兩個任務分給子代理同時做：
1. 交給 Claude Code 子代理：［任務 A，例如：讀 src 資料夾，列出可能有 bug 的地方］
2. 交給 Codex 子代理：［任務 B，例如：為 utils 資料夾補上測試］
兩個都做完後，把它們回報的結果整理成一份清單給我。

官方文件說，不管是本機的還是外部的子代理，做完都會自動把最後的文字結果、狀態和診斷回報給主代理。Reels 裡「分工做完，自動回報」講的就是這個。

07要注意

黃黑警示膠帶橫跨畫面，寫著「預覽版」，後面是官方 README 的 Developer preview 警告 — 官方 README：THERE WILL BE COMPATIBILITY-BREAKING CHANGES。

這是開發者預覽版。官方 README 寫會一直有不相容的改動，所以今天照著做行得通，下個月不一定。我們 2026/10/20 查到的最新版是 0.2.1-rc.2（2026/10/17 發布，標示為預覽版）。
先看官方的 SAFETY.md。它寫得很明白：實驗性軟體，沒有做過安全稽核，不能當成安全或可上線的東西。它可以執行模型產生的程式碼和指令，也能存取你給它的檔案和憑證，可能改壞或刪掉檔案、洩漏資料。
官方建議的做法：用最小的權限、最好在一次性的虛擬機或容器裡跑、替它能碰到的檔案做備份、不要放你不願承擔風險的憑證，外掛、設定和它提議的指令都要先看過再放行。
「免費」只指軟體。模型用量走你自己的 API key，由供應商計費。
只裝來源清楚的外掛。官方也提醒第三方外掛是風險來源。
只從官方網址取得：github.com/deepseek-ai/deepseek-harness 和 deepseek.com/harness。名字這麼紅，小心長得像的假頁面。
Claude Code、Codex 子代理是用你自己的帳號和額度在跑，用之前先想好要它做什麼。
這篇的步驟沒有經過我們實測。星數、版本、按鈕名稱都可能變，卡住時以官方文件為準。