在 Claude Code 中使用 DeepSeek：V4 Flash / Pro 設定指南

透過 APIMaster 在 Claude Code 中執行 DeepSeek V4 Flash 和 Pro。設定閘道和 API 金鑰、切換模型、驗證檔案讀取工具並修正設定錯誤。

Claude Code 可以使用 DeepSeek 嗎？我們使用 Claude Code 2.1.239 進行的測試，透過 APIMaster 的 Messages 端點成功使用了 deepseek-v4-flash 和 deepseek-v4-pro。 將 ANTHROPIC_BASE_URL 設定為 https://apimaster.ai，提供 APIMaster 金鑰並明確選擇模型。此設定可執行 DeepSeek，即使客戶端名為 Claude Code。

最後測試時間：2026-09-07，Claude Code 2.1.239，Linux。兩個模型均回傳預期文字並完成檔案讀取工具的往返測試。所有執行均以代碼 0 退出。CLI 列印了 unrecognized_model，但測試的請求均成功。這些檢查並不代表支援所有 Claude Code 功能、長時間工作階段或未來版本。包含 Windows / macOS 設定指令；記錄的測試在 Linux 上執行。

1. 準備 CLI 和 API 金鑰

請依照環境指南和 Claude Code 設定指南進行安裝。檢查您的版本：

claude --version

取得一個 APIMaster API 金鑰，該金鑰需能存取所選的 DeepSeek 模型並具有足夠的配額。請使用以下工作階段設定進行本教學；無需覆寫您平常的 settings.json。

2. 設定閘道和金鑰

開啟一個新的終端機，將這些設定與您平常的 CLI 工作階段分開。

macOS / Linux：

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

此處使用網站來源，不要加上 /v1：Claude Code 會附加 /v1/messages。API 金鑰必須來自 APIMaster。這些指令僅影響此終端機及其子程序，不會影響您儲存的登入檔案。請勿將真實金鑰放入共用的設定檔或儲存庫中。

3. 傳送最小測試請求

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

預期結果：is_error 為 false，result 為 DEEPSEEK_TEST_OK，且程序以代碼 0 退出。將 --model 變更為 deepseek-v4-pro 並再次執行。

測試版本的 --bare 模式使用明確的 API 金鑰驗證，並略過正常的背景整合。--setting-sources "" 排除已儲存的設定來源，而 --tools "" 在此單一文字測試中停用工具。這些是刻意使用的診斷設定，並非正常使用時停用工具的要求。較舊的 CLI 版本可能不接受所有這些旗標。

4. 驗證檔案讀取工具

在目前目錄中建立 probe.txt，內容如下：

TOOL_PROBE_739182

執行：

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

預期結果：CLI 讀取檔案並回傳 TOOL_PROBE_739182。使用 deepseek-v4-pro 重複執行。這會檢查模型是否能請求工具、接收結果並回應。此測試僅啟用 Read 工具。

對於使用相同終端機設定的普通互動式工作：

claude --bare --setting-sources "" --model deepseek-v4-flash

若要使用 Pro 啟動：

claude --bare --setting-sources "" --model deepseek-v4-pro

互動式指令省略了 --tools ""，因此預設工具可用。請照常檢視權限提示。--bare 會略過鉤子和自動專案說明等便利功能；在最小設定成功後，請刻意啟用您的正常設定，並檢查它們不會覆寫閘道或模型。完成後關閉此終端機，以清除此工作階段的環境。

疑難排解

症狀	檢查項目
`unrecognized_model`	在 2.1.239 中，兩個 DeepSeek ID 均觀察到此訊息。它並未阻止我們的請求完成。請檢查最終結果，而非僅將警告視為失敗。
401 或意外的登入提示	確認已設定 `ANTHROPIC_API_KEY`，在此終端機中移除衝突的 `ANTHROPIC_AUTH_TOKEN`，並重試 bare 模式。
404	`ANTHROPIC_BASE_URL` 應為 `https://apimaster.ai`，而非完整的 `/v1/messages` 端點或以 `/v1` 結尾的基礎 URL。
未知的 `--bare` 選項	將您的版本與測試的 2.1.239 進行比對。如有需要，請使用一般安裝指南進行更新。
無法讀取 `probe.txt`	請在檔案所在目錄中執行。對於工具測試，請啟用 Read 而非使用 `--tools ""`。
選取了不同的模型	使用 `--model` 傳遞完整的模型 ID，並在啟用已儲存的設定或模型別名覆寫前檢查它們。
速率限制、配額不足或上游錯誤	閱讀錯誤內容，檢查配額和模型權限，並記錄時間戳記以供支援。

常見問題

這與使用 Claude 模型相同嗎？

不同。這裡的客戶端是 Claude Code；所選模型是 DeepSeek。依賴特定 Claude 模型的功能不會自動由此設定涵蓋。

為什麼基礎 URL 與 Python SDK 範例不同？

Python OpenAI SDK 使用 https://apimaster.ai/v1 並附加 /chat/completions。Claude Code 使用 https://apimaster.ai 並附加 /v1/messages。請使用每個客戶端文件記載的基礎格式。

我可以使用 DeepSeek 官方金鑰搭配此閘道嗎？

本教學需要 APIMaster 發行的金鑰。金鑰是特定於發行它的提供者；僅變更端點不會轉移憑證或配額。

是否測試了實際的工具使用，還是僅測試了文字回覆？

兩者都針對兩個模型進行了測試。工具測試讀取了本機檔案並回傳其內容。這並不代表所有工具、背景代理或長時間編碼任務都受支援。