在 Claude Code 中使用 DeepSeek V4 Flash 與 Pro:設定與模型切換
使用 APIMaster 在 Claude Code 中設定 DeepSeek。在 Windows、macOS 與 Linux 上設定 settings.json,啟動 claude,以 /model 選擇模型並開始對話。
在 settings.json 中設定 APIMaster,執行 claude,然後在對話中輸入 /model MODEL_ID 即可使用 DeepSeek。 本文涵蓋的可用 ID 為 deepseek-v4-flash、deepseek-v4-pro。Claude Code 是客戶端;DeepSeek 是提供回答的模型。
開始之前
請先完成環境檢查與 Claude Code 設定。取得具有足夠餘額且可存取所選模型的 APIMaster API 金鑰。
claude --version
閘道 Base URL 為 https://apimaster.ai,不含 /v1。Claude Code 會自行附加 /v1/messages。
1. 開啟設定目錄
Windows
按下 Win + R,輸入以下路徑並按 Enter:
%USERPROFILE%\.claude
如有需要,請先建立該資料夾。開啟或建立 settings.json。請確認檔名不是 settings.json.txt。
macOS / Linux
在 macOS 上,於 Finder 中按下 Command + Shift + G 並輸入:
~/.claude
在 Linux 上,使用您的檔案管理員或編輯器開啟相同目錄。如有需要,請先建立:
mkdir -p ~/.claude
在該目錄中開啟或建立 settings.json。如果您設定了自訂的 Claude Code 設定目錄,請改用該目錄。
2. 編輯 settings.json
Windows、macOS 與 Linux 使用相同的設定。將 YOUR_APIMASTER_API_KEY 替換為您的 APIMaster 金鑰:
{
"model": "deepseek-v4-flash",
"env": {
"ANTHROPIC_BASE_URL": "https://apimaster.ai",
"ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}
如果該檔案已存在,請先備份,再將這些欄位合併到現有的 JSON 物件與 env 物件中。保留您需要的其他設定。不要附加第二個 JSON 物件或重複 env 鍵。JSON 不允許註解或尾隨逗號。
一般 Claude Code 指南採用權杖(token)認證。本指南使用的是我們整合測試中驗證過的 API 金鑰認證。使用 ANTHROPIC_API_KEY 時請保持 ANTHROPIC_AUTH_TOKEN 為空,並從其他設定或您的終端機中移除衝突的憑證。此閘道請使用 APIMaster 金鑰。
model 欄位設定啟動時的模型。啟動後您可以選擇其他模型。請將此使用者設定檔保密;不要將真實金鑰提交到共用儲存庫。儲存檔案並重新啟動 Claude Code 以載入新設定。
3. 啟動 Claude Code
在專案目錄中開啟終端機,執行:
claude
完成所有正常的首次執行提示,並檢視專案信任提示。啟動模型應為 deepseek-v4-flash。這是一個普通的互動工作階段,具備常用的工具與專案設定。
4. 選擇模型並開始對話
在 Claude Code 對話中,輸入以下其中一個指令並按 Enter:
/model deepseek-v4-flash
/model deepseek-v4-pro
一次執行一行,選擇您想要的模型。Claude Code 確認切換後,傳送一則簡短訊息:
Reply with exactly OK.
收到正常的文字回覆即確認基本連線正常。接著您可以繼續對話,或請它處理您的專案。若要在同一對話中再次切換,請輸入另一個 /model MODEL_ID 指令。
單獨輸入 /model 會開啟模型選擇器。自訂閘道 ID 可能不會出現在其預設清單中。 請改為輸入如上所示的完整 ID。斜線指令屬於 Claude Code 內部,而非 PowerShell 或 Bash。這些模型名稱指的是 DeepSeek 模型,而非 Claude Sonnet 或 Opus。
您也可以在從 終端機 啟動時選擇模型。一次執行一個指令:
claude --model deepseek-v4-flash
claude --model deepseek-v4-pro
若要明確設定未來工作階段的預設值,請編輯 settings.json 中的 model。啟動旗標、ANTHROPIC_MODEL 環境變數或專案/受管理設定都可能影響所選模型;如果啟動模型與您儲存的值不同,請檢查這些項目。
疑難排解
| 症狀 | 檢查項目 |
|---|---|
| 401 / 出現意外的登入提示 | 檢查 APIMaster 金鑰、Base URL 與衝突的認證變數;編輯設定後重新啟動 CLI。 |
| 404 | 請使用 https://apimaster.ai,不含 /v1 或 /v1/messages。 |
| 設定未生效 | 檢查檔案位置、JSON 是否有效,以及來自終端機、專案或受管理設定的覆蓋。 |
| 選擇器中找不到模型 | 使用確切的 ID 輸入 /model MODEL_ID,或以 claude --model MODEL_ID 啟動。 |
| 模型不可用 / 403 | 檢查拼字、金鑰允許的模型、帳戶餘額與目前路徑的可用性。 |
unrecognized_model |
在我們的測試中,使用自訂 ID 時曾觀察到此錯誤。請檢查實際回答與工具結果;內建的 Claude 能力預設值未針對 DeepSeek 驗證。 |
| 檔案或指令權限被拒 | 透過一般的權限提示檢視並核准預期的操作。 |
| 429 / 5xx / 回覆中斷 | 保留錯誤訊息、模型 ID、CLI 版本、UTC 時間與請求 ID(如有的話)以供支援使用。 |
驗證與選用的診斷
記錄的整合測試:2026-09-07 UTC、Claude Code 2.1.239、Linux。本文列出的所有模型皆回傳預期文字,並透過工具讀取了本機檔案。複雜的編碼任務不在該測試範圍內。Windows 與 macOS 不在那些記錄的執行範圍內。
先前的自動化檢查使用裸模式(bare mode)來隔離設定。日常正常使用請遵循上述 settings.json 與互動步驟。 裸模式與 --setting-sources "" 會跳過正常整合或已儲存的設定,因此不應加入本指南的日常啟動指令中。
若要使用您已儲存的設定進行快速的非互動檢查:
claude --model deepseek-v4-flash -p "Reply with exactly OK."
若要進行工具檢查,請建立內容為 FILE_PROBE_739182 的 probe.txt,在該目錄中啟動 Claude Code,並要求它使用工具讀取該檔案並回傳其確切內容。請確認工具確實執行。
這些是有限範圍的整合檢查,並不保證每一項 Claude Code 功能、長時間工作階段行為或最大上下文。Anthropic 的閘道文件並未正式支援將 Claude Code 路由至非 Claude 模型;本指南描述的是 APIMaster 的整合方式。
常見問題
我的 Claude 訂閱是否支付這些請求的費用?
否。使用此 APIMaster 設定時,請求會使用您的 APIMaster 金鑰與餘額。
切換模型後可以繼續對話嗎?
可以,在開啟的對話中使用模型切換指令,並等待確認後再傳送下一則訊息。若要在模型之間進行乾淨的比較,請以 claude --model MODEL_ID 開啟一個獨立的工作階段。
