APIMaster.ai

在 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 開啟一個獨立的工作階段。

相關指南與來源