繁中 ▾
取得 API 金鑰

getdeepseekapi.com指南

如何在 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 的單一獨立開放權重模型。
兩個不匹配的連接器透過發光的適配器連接,顯示代理程式在 API 格式之間進行轉譯

從可行與不可行的事項開始

兩項說明可節省一小時的困惑。首先,此服務並非官方的 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。這就是整個設定過程。

取得 API 金鑰