如何在 Claude Code 中使用 DeepSeek API:實際選項
如果你正在研究如何在 Claude Code 中使用 DeepSeek API,首先要知道的是 Claude Code 會連接到 Anthropic 風格的端點,而此服務使用 OpenAI 格式。小型轉譯代理程式可彌合差距,本頁說明如何設定。
更新於
重點摘要
- Claude Code 預期使用 Anthropic Messages API;此服務提供 OpenAI 相容的 /v1/chat/completions。
- 本機代理程式(如 LiteLLM)可在兩種格式之間進行轉譯。
- Aider、Continue 和 Cline 可直接接受 OpenAI 相容的 Base URL,無需代理程式。
- 這不是 DeepSeek 的官方 API:它是 ID 為
uncensored的單一獨立開放權重模型。

從可行與不可行的事項開始
兩項說明可節省一小時的困惑。首先,此服務並非官方的 DeepSeek API,也不是 DeepSeek 或其他供應商的轉發器。它託管一個開放權重模型,由獨立供應商運行,模型 ID 為 uncensored。如果你需要 DeepSeek 自己的模型,請直接前往 DeepSeek。其次,Claude Code 是基於 Anthropic 的 Messages API 建構的。你可以更改請求發送的位置,但它發送的仍然是 Anthropic 格式的 JSON。
此服務以 OpenAI 格式暴露 POST /v1/chat/completions 和 GET /v1/models。直接將 Claude Code 指向它將無法運作,因為路徑和有效負載不同。解決方法是加入轉譯層。您在本地機器上執行小型代理程式,接受來自 Claude Code 的 Anthropic 格式呼叫,並將其轉發為 OpenAI 格式呼叫至 https://api.getdeepseekapi.com/v1。已有現成工具可達成此目的,下一節將設定其中一個。
在開始之前,先確認預期。Claude Code 高度依賴函式呼叫來讀取檔案、編輯檔案和執行命令。此 API 支援函式呼叫,包括串流輸出的 tool_calls,但特定模型驅動長期代理程式迴圈的效果如何,應在您自己的儲存庫中測試,而非假設。
取得金鑰並確認端點
使用 Google 或電子郵件與密碼建立帳戶,然後開啟 API 金鑰頁面。新用戶可一鍵領取 $0.50 的免費試用額度。有效期為 7 天,無需付款資訊,足以測試以下所有內容。注意,試用金鑰允許 2 個並行請求和每分鐘 60 個請求,這對同時觸發多個呼叫的代理工具很重要。
export UNCENSORED_API_KEY="paste-your-key-here"
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
如果返回完成結果,則上游端已完成。其餘工作都是將代理程式連接至它。
選項 1:Claude Code 前方的 LiteLLM 代理
LiteLLM 是一個開源專案,其代理伺服器可提供 Anthropic 相容的端點並路由至 OpenAI 相容的後端。請查看其文件以了解目前的功能集,因為該生態系統的這部分發展迅速。
安裝與設定
pip install 'litellm[proxy]'
cat > litellm-config.yaml <<'EOF'
model_list:
- model_name: uncensored
litellm_params:
model: openai/uncensored
api_base: https://api.getdeepseekapi.com/v1
api_key: os.environ/UNCENSORED_API_KEY
EOF
litellm --config litellm-config.yaml --port 4000
openai/ 前綴會告知 LiteLLM 使用 OpenAI 相容的配接器;其後的名稱會作為模型向上游傳送。保持終端機執行中。
將 Claude Code 指向代理程式
Claude Code 從環境變數讀取其端點和憑證。在第二個終端機中:
export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="any-local-string"
export ANTHROPIC_MODEL="uncensored"
export ANTHROPIC_SMALL_FAST_MODEL="uncensored"
claude
此處的驗證權杖僅是本地代理程式所需的;實際金鑰仍保留在代理程式的環境中。設定小型快速模型也很重要,因為 Claude Code 使用第二個模型處理輕量背景任務。如果未設定,它可能會嘗試呼叫代理程式不認識的 Anthropic 模型名稱。較新版本可能以不同名稱命名此設定,因此如果變數似乎被忽略,請執行 claude --help 或閱讀目前的 Claude Code 設定文件。
選項 2:直接接受 OpenAI base URL 的工具
如果您的目標是 AI 程式設計助手而非 Claude Code 本身,則有幾種工具可跳過代理,因為它們已經支援 OpenAI 格式。每種工具都允許您設定自訂 base URL 和模型名稱。
- Aider 是一個終端機配對程式。它讀取
OPENAI_API_BASE和OPENAI_API_KEY,並在模型前加上openai/前綴。 - Continue 是一個編輯器擴充功能,模型條目可包含
apiBase和 OpenAI 風格的提供者。 - Cline 在其設定中提供 OpenAI Compatible 提供者,包含 base URL、金鑰和模型 ID 欄位。
使用 Aider,整個設定只需三行:
export OPENAI_API_BASE="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="$UNCENSORED_API_KEY"
aider --model openai/uncensored
這些工具經常更改選單,因此請將上述欄位名稱視為指南,並遵循每個專案的目前文件。您需要的值永不改變:base URL https://api.getdeepseekapi.com/v1、您的金鑰和模型 ID uncensored。
編寫自己的輕量代理程式迴圈
當完整的程式設計助手過於龐大時,帶有函式呼叫的短腳本可涵蓋廣泛領域。此腳本讓模型請求讀取檔案,然後將檔案作為 role: "tool" 訊息傳回。
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Read a text file from the project",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "What does main.py do? Read it first."}]
for _ in range(5):
r = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = r.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"]) as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
5 次的迴圈上限可防止混淆的模型無限期執行。在實際工具中,您還應驗證路徑,以防止模型讀取專案範圍外的檔案。
速率限制、成本與修復 429 錯誤
Agent 工具會發出大量請求。單一任務可觸發數十個請求,每個請求都重新發送不斷增長的上下文。使用完整金鑰,您可取得 8 個並行請求和每分鐘 300 個請求。帶有 concurrency 的 429 表示重疊呼叫過多,帶有 rate_limited 的 429 表示每分鐘請求過多。在短暫超載期間,您將看到帶有 Retry-After: 5 的 429。如果您新增重試設定,LiteLLM 可自動重試;請查看其文件。
成本適中,因為定價為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50。假設代理程式會話進行 40 次呼叫,每次發送 30,000 token 的上下文並返回 600 token。輸入為 1,200,000 token,成本為 1.2 x $0.15 = $0.18。輸出為 24,000 token,成本為 0.024 x $0.50 = $0.012。整個會話總計 $0.192。上下文視窗為 100,000 token,因此請保持載入的檔案內容集中。
當試用額度耗盡時,你可以透過加密貨幣(TRC20 上的 USDT、Base 上的 USDC)儲值任意整數金額,範圍從 $20 到 $500。額外獎勵為:$50 起 +5%,$100 起 +10%,$200 起 +15%。詳情請見 定價頁面 和 文件。
代理程式設定故障排除
| 症狀 | 原因 | 嘗試事項 |
|---|---|---|
| Claude Code 報告未知模型 | 後台模型名稱未映射 | 將小型快速模型變數也設定為 uncensored |
| 連線被拒絕 | 代理程式未執行或埠號不同 | 啟動 LiteLLM 並在 ANTHROPIC_BASE_URL 中匹配埠號 |
| 上游返回 401 | 代理程式環境中的金鑰錯誤 | 重新匯出 UNCENSORED_API_KEY 並重新啟動代理程式 |
| 工具呼叫失敗或進入無窮迴圈 | 模型難以處理代理程式格式 | 降低溫度、縮短提示詞,或使用 Aider |
| 頻繁出現 429 | 試用金鑰的並行請求數為 2 | 為完整金鑰儲值,擁有 8 個並行槽位 |
兩個習慣可確保設定安全。僅在 localhost 上執行代理程式,這樣網路上的其他人就無法消耗你的額度;並將真正的金鑰保留在代理程式的環境變數中,而不是放在最終會進入版本控制系統的專案檔案裡。另外,在第一次長時間工作階段期間,請注意 X-Balance-USD 回應標頭,因為代理程式迴圈可能會消耗比你預期的更多 token。如果餘額下降速度快於上述預估,請縮短輸入的檔案長度或限制步驟數量。
失敗的請求不會計費,因此實驗成本很低。提示詞不會用於訓練。若要與其他閘道器比較,請閱讀 我們的 API 金鑰概覽。
更多指南
問答
Claude Code 可以直接連接到此 API 嗎?
不行。Claude Code 使用 Anthropic 的 Messages 格式,而此 API 使用 OpenAI 的聊天補全格式。在兩者之間放置轉譯代理程式(如 LiteLLM)。
這是官方的 DeepSeek API 嗎?
不是。它託管一個 ID 為 uncensored 的獨立開放權重模型,與 DeepSeek 或其他供應商無關。
哪些工具不需要代理程式即可運作?
具有 OpenAI 相容提供者設定的工具,例如 Aider、Continue 和 Cline。設定 Base URL、金鑰與模型 ID uncensored。
函式呼叫可以運作嗎?
可以,包括串流輸出的 tool_calls 以及以 role tool 訊息形式傳回的結果。測試你自己的代理程式工作流程,看看模型如何處理。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改Base URL。這就是整個設定過程。