把服務供應商、API協定與模型ID分開看，從下載桌面版開始，整理第一次串接需要注意的地方。

我看AI工具時，會特別留意一件事：它能不能接著處理手邊的檔案，而不是每次都要我把內容貼進對話框。

DeepSeek Harness讓我感興趣的地方，就是它把模型與工作環境放在一起。模型決定下一步，Harness提供讀取檔案、執行工具、儲存工作狀態的能力。至於能操作到哪裡，還是要看工作區與權限設定。

這篇先不深入外掛架構。我想從桌面版的設定畫面，整理兩個很容易混淆的問題：拿到API金鑰後要填在哪裡，以及同一個模型為什麼會出現在不同的供應商底下。

先下載桌面版，讓設定有個起點

到DeepSeek Harness官網選擇桌面版下載。Windows使用者選Windows版；macOS則要確認晶片架構，目前官網提供Apple晶片版本。

下載後開啟安裝檔，依提示完成安裝，再啟動軟體。這篇以2026年10月的Windows桌面版畫面說明，官網仍標示為預覽版。

我會把桌面安裝和網路上常見的命令列啟動教學分開看，避免做到一半才發現自己跟的是另一條流程。

第一次啟動若出現官方API金鑰輸入頁，這裡先選「稍后配置」，進入主畫面後再從同一個模型設定頁選擇接入方式。

兩個入口，其實是在分誰負責接入設定

從左下角帳號選單開啟設定，進入模型頁，再選「添加模型提供商」。

裡面有「第三方模型提供商」和「自定义模型API」。

我的判斷方式是：服務已經在內建清單裡，就先用清單提供的設定；服務商另外給了專用網址，就考慮自訂API。

前者的端點、協定與模型目錄由內建設定提供，我只需要準備該服務要求的憑證。後面以DeepSeek官方API說明這條路徑。

後者要自己填入網址、協定、金鑰與模型，適合相容API閘道、自架服務等情境。

使用內建服務：以官方API為例

若使用DeepSeek官方API，先登入官方開放平台，到API keys頁面建立金鑰。複製完整金鑰，回到Harness的「設定→模型」，編輯DeepSeek卡片並貼上儲存，再到新對話選擇該群組的模型。

其他內建服務則從「第三方模型提供商」選擇對應項目，填入該服務的金鑰或依畫面完成授權，儲存後在新對話選擇該供應商的模型。

這裡我會另外確認API帳戶的可用額度。能登入聊天帳號，和API能否呼叫，是不同的事情。

自訂API：先準備金鑰，再回來填欄位

這一節只說明自訂API。已用內建服務完成設定並選好模型的人，可以直接看「下一步，我會拿一份熟悉的資料開始」。選自訂方式的人，則以Crazyrouter為例準備金鑰與接入資訊。

需要帳號時，可到Crazyrouter註冊頁，填寫使用者名稱、密碼與電子郵件，依頁面完成人機驗證及信箱驗證。已有帳號就直接登入。

依官方快速入門說明，登入後進入金鑰管理入口，建立供模型API使用的Token，複製完整金鑰。

我會替金鑰取一個能辨認用途的名稱，例如「Harness練習」。若有設定有效期限、額度或模型限制，也要一併記下，之後排查問題比較有依據。

複製金鑰後回到Harness，依序開啟「設定→模型→添加模型提供商→自定义模型API」。

Provider ID可以填小寫的crazyrouter，前提是沒有重名；它是設定的識別碼，不適合建立後任意更名。顯示名稱則可填Crazyrouter，方便在選單辨認。

API網址依這份設定填入https://crazyrouter.com/v1，API協定選OpenAI Chat Completions，金鑰貼上剛才建立的那一把。

我覺得最值得釐清的是協定。這裡出現OpenAI，描述的是請求格式；後面仍然可以選擇服務端支援的DeepSeek模型。網址、金鑰和協定必須配套，不能只看模型品牌來決定。

接著從模型廣場複製ID，完成自訂設定

填完服務資訊後，可以取得可用模型清單，也可以用ID新增。這裡我選擇從模型廣場複製ID，再回來新增，不需要將同一個模型重複加入。

我會打開模型廣場，在供應商篩選選DeepSeek，找到需要的模型，再按卡片右上角的複製圖示。

從瀏覽器回到Harness剛才的自訂API表單，選「添加模型」，把複製內容貼到模型ID。顯示名稱可以取好記的，ID則保留服務商提供的原值；截圖中的價格與數量不當作目前的固定資訊。

這樣能減少拼字錯誤，但還是要確認金鑰權限、帳戶額度與協定是否支援該模型。

儲存後開一個新對話，在模型選單找到crazyrouter群組，再選模型。

這張圖是我認為很值得保留的提醒：DeepSeek帳號、官方API和自訂供應商可以同時出現。只認模型名稱，還不足以判斷這次走哪個服務。

下一步，我會拿一份熟悉的資料開始

先選一個練習用資料夾作為工作區，放入專案說明或會議紀錄，新對話選標準模式。

我會先請它整理待辦事項，標出缺少的資訊，暫時不要改動原始檔案。例如原文沒有寫負責人，就應該列為待確認，不能自行補上一個名字。

內容確認後，再請它存成待辦清單，實際開啟檔案確認。對我來說，這才有辦法判斷它是否適合手邊工作，而不只是看回覆是否流暢。

如果沒有收到正常回應，我會依序看金鑰是否有效、網址和協定是否配對、模型ID與權限是否正確，最後確認新對話選的是哪個群組。取得模型清單失敗，不必立刻重裝軟體；它和模型請求本身是不同環節。

整理這些設定後，我比較在意的是每次調整能否說清楚原因。知道自己改的是服務入口、模型還是工作權限，後續排查才有方向。

參考：Harness模型設定文件、DeepSeek官方開放平台，以及Crazyrouter官網提供的快速入門資料。資料核對日期：2026年10月19日。